feat: multi-writer text index + agent guardrails — v2.4.3#21
Merged
Conversation
Bundles three improvements: 1. Multi-writer text-index support (via agentdb 2.3 + termlog 0.2). The parent Claude Code process and every spawned subagent / experimental agent-team member can now read + write to the same backlog data directory concurrently without the IndexLockedError crash that took down subagents on prior versions. Validated end-to-end with 3 concurrent writers — all see each other's tasks via attribute filters and BM25 search. Legacy single-writer text indexes auto-migrate to per-agent layout on first launch (one-time, in place, no manual step). 2. UUID verification guardrails. Every mutation tool's description (task_done, task_delete, task_start, task_stop, task_duplicate, task_modify, task_annotate, task_denotate, task_purge, task_doc_write, task_doc_delete) now appends a VERIFY_ID_NOTE directing the agent to confirm UUIDs against the live store via task_list / task_info before mutating. Skills (implement, handoff, refine) reinforce 'use UUIDs from the lookup, not memory'. 3. 500-char description guidance. task_add / task_log / task_modify field descriptions and the schema docstring explicitly call out the cap and direct agents to task_doc_write for longer content. skills/plan and agents/task-planner reinforce the one-line summary norm. Bumps @backloghq/agentdb from ^2.2.1 to ^2.3.0. Lockfile points at the local file: link for now; will resolve to the published 2.3.0 tarball once that's on npm.
- zod 4.3.6 → 4.4.3 - @types/node 25.5.2 → 25.9.1 - @vitest/coverage-v8 4.1.4 → 4.1.7 - eslint 10.2.0 → 10.4.1 - typescript ~6.0.2 → ^6.0.3 - typescript-eslint 8.58.1 → 8.60.0 - vitest 4.1.4 → 4.1.7 - npm audit fix resolves 7 transitive vulns (6 moderate, 1 high) across qs, postcss, brace-expansion, hono, fast-uri, etc. Build + lint + 193 tests all pass unchanged.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
IndexLockedErrorcrash on subagent startup is gone. Legacy single-writer indexes auto-migrate to per-agent layout on first launch — one-time, in place, no manual step.task_add/task_log/task_modifyfield docstrings, the schema docstring, and the planning skill/agent all explicitly call out the cap and direct longer content totask_doc_write.@backloghq/agentdbfrom^2.2.1to^2.3.0(which pulls in@backloghq/termlog ^0.2.0).Test plan
npm run build— cleannpm run lint— cleannpm test— 193/193 passRelease order
@backloghq/agentdb@2.3.0must be published to npm before this PR can merge. Once published, refresh the lockfile withnpm uninstall @backloghq/agentdb && npm install @backloghq/agentdb@^2.3.0so it resolves to the registry tarball rather than the localfile:link.