Skip to content

feat: v2.2.0 — agentdb v1.3 + persisted schema with agent context#16

Merged
mbocevski merged 1 commit into
mainfrom
feat/v2.2.0-agentdb-v1.3
Apr 18, 2026
Merged

feat: v2.2.0 — agentdb v1.3 + persisted schema with agent context#16
mbocevski merged 1 commit into
mainfrom
feat/v2.2.0-agentdb-v1.3

Conversation

@mbocevski
Copy link
Copy Markdown
Contributor

@mbocevski mbocevski commented Apr 18, 2026

Summary

Backlog v2.2.0 rides on agentdb v1.3. The main story: the tasks collection now carries agent-facing context (description, instructions, per-field descriptions) that auto-persists to meta/tasks.schema.json on first open. Any agent connecting to the backlog MCP server can call db_get_schema and discover the shape + usage semantics of the tasks collection without reading this repo's source.

What's new

Upgraded @backloghq/agentdb 1.2.1 → 1.3.0

Unlocks the v1.3 feature set for backlog's data directory:

  • Schema lifecycle tools (db_get_schema, db_set_schema, db_delete_schema, db_diff_schema, db_migrate, db_infer_schema)
  • $strLen filter operator (available in both JSON and compact syntax)
  • Schema bootstrap — operators can ship schemas/*.json files or use --schemas <glob>
  • Collection.iterate() streaming generator
  • Various correctness and concurrency fixes (two-phase migrate snapshot, unique tmp filenames, authenticated _agent audit stamp)

Enriched taskSchema

  • description — what the tasks collection is for, as seen by any connecting agent
  • instructions — status flow, how to use depends, date semantics, recurrence notes, has_doc meaning
  • version: 1 — tracked against the persisted file for future schema evolution
  • Per-field description on every schema-declared field (id, description, status, priority, project, dates, tags, depends, recur, agent, timestamps, parent, has_doc)

On first open after the upgrade, backlog auto-persists the task schema to <taskdataRoot>/<project>/meta/tasks.schema.json. No migration step required.

Plugin + marketplace version

Both .claude-plugin/plugin.json and .claude-plugin/marketplace.json bumped to 2.2.0. Descriptions rewritten to avoid hardcoded tool/skill counts.

Test plan

  • CI passes
  • Existing backlog data directories open cleanly on first run under v2.2.0 (schema file appears in meta/ after first tool call)

- Bump @backloghq/agentdb from 1.2.1 to 1.3.0, unlocking persisted
  schemas with agent context, the schema lifecycle toolset, the
  $strLen filter operator, and schema bootstrap.
- Enrich taskSchema with top-level description and instructions plus
  per-field description on every schema-declared field. Auto-persists
  to meta/tasks.schema.json on first open so any agent connecting to
  the backlog MCP server can call db_get_schema and discover the
  collection's shape + usage guidance without reading source.
- Declare schema version: 1 for future evolution tracking.
- Bump plugin.json + marketplace.json to 2.2.0 and strip hardcoded
  tool/skill counts from their descriptions.
- README: drop stale '24 tools' and '(189 tests)' counts — descriptive
  text only.
@mbocevski mbocevski merged commit 3f8edfa into main Apr 18, 2026
2 checks passed
@mbocevski mbocevski deleted the feat/v2.2.0-agentdb-v1.3 branch April 18, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant