Releases: NimbleBrainInc/upjack
Releases · NimbleBrainInc/upjack
v0.3.1
Fixed
create_entityno longer generates a filename ULID that differs from theidin the JSON content when data includes anidfield- Provided IDs are now respected when valid for the entity's prefix (enables deterministic seeding with cross-references)
- Duplicate ID detection —
create_entityraisesValueErrorif an entity with that ID already exists typefield in data no longer leaks into the record viaupdate()- Seed tool now passes
idthrough so seed data can use stable IDs
v0.3.0
Breaking Changes
- Parameter naming: CRUD tools use entity-specific parameter names (
contact_id,deal_id) instead of genericentity_id - Response envelopes:
list_*,search_*,query_*_by_relationship, andget_related_*tools return{entities: [...], count, ...}envelope instead of bare arrays
Added
- All entity-derived tools declare
outputSchemaand returnstructuredContent(MCP spec 2025-06-18) build_entity_output_schema()andbuild_list_output_schema()helpers inupjack.schema_wrap_list()internal helper for consistent envelope construction
Migration
- Replace
entity_idwith{entity_name}_idin all tool calls (e.g.,get_contact(entity_id=...)→get_contact(contact_id=...)) - List/search results are now
result["entities"]instead of the bare array; count available atresult["count"] - Programmatic consumers can use
structuredContentfor typed responses instead of parsingcontent[0].text
Skill skill-v0.3.1
What's Changed
- Pass entity JSON Schemas to MCP tool definitions by @mgoldsborough in #7
- Add schema evolution guardrails and add_field MCP tool by @mgoldsborough in #8
- Add relationship indexing, graph traversal, and activity tracking by @mgoldsborough in #15
- Update docs for relationship indexing and activity tracking by @mgoldsborough in #16
New Contributors
- @mgoldsborough made their first contribution in #7
Full Changelog: skill-v0.1.0...skill-v0.3.1
Skill skill-v0.3.0
What's Changed
- Pass entity JSON Schemas to MCP tool definitions by @mgoldsborough in #7
- Add schema evolution guardrails and add_field MCP tool by @mgoldsborough in #8
- Add relationship indexing, graph traversal, and activity tracking by @mgoldsborough in #15
- Update docs for relationship indexing and activity tracking by @mgoldsborough in #16
New Contributors
- @mgoldsborough made their first contribution in #7
Full Changelog: skill-v0.1.0...skill-v0.3.0
v0.2.0
Added
- Schema evolution: hydrate-on-read migration,
validate_schema_change()guard,add_fieldMCP tool, required-without-default warning - Relationship indexing: write-time reverse index at
_index/relations.json, auto-rebuild from entity files, atomic writes - Graph traversal methods on UpjackApp:
query_by_relationship,get_related,get_composite - Activity tracking: opt-in via
"activities": truein manifest,log_activityandget_activitiesmethods - Per-entity MCP tools:
query_{plural}_by_relationship,get_related_{name},get_{name}_composite - Global MCP tools:
rebuild_index,log_activity,get_activities(when activities enabled) - CRUD hooks:
on_relationships_changedcallback for automatic index maintenance
PyPI: https://pypi.org/project/upjack/0.2.0/
npm: https://www.npmjs.com/package/upjack/v/0.2.0
Skill skill-v0.2.0
What's Changed
- Pass entity JSON Schemas to MCP tool definitions by @mgoldsborough in #7
- Add schema evolution guardrails and add_field MCP tool by @mgoldsborough in #8
- Add relationship indexing, graph traversal, and activity tracking by @mgoldsborough in #15
- Update docs for relationship indexing and activity tracking by @mgoldsborough in #16
New Contributors
- @mgoldsborough made their first contribution in #7
Full Changelog: skill-v0.1.0...skill-v0.2.0