@orchestrator-claude/definitions 3.40.0 → 3.42.1

package/manifest.json

@@ -1,8 +1,8 @@
 {
   "schema": "orchestrator-definitions/v1",
   "namespace": "orchestrator",
-  "version": "3.40.0",
-  "generatedAt": "2026-09-25T13:12:10.970Z",
+  "version": "3.42.1",
+  "generatedAt": "2026-09-30T15:23:10.072Z",
   "definitions": {
     "agents": [
       {
@@ -25,7 +25,7 @@
         "slug": "api-extractor",
         "file": "agents/api-extractor.md",
         "version": "1.0.0",
-        "checksum": "sha256:f3f71e93097fd2db1d45c4026b207c9b05ae2f43a731c51eb967dc50a4296108",
+        "checksum": "sha256:50cb809495b73d736385306b341c04e99b0d8af4366504c3adbf821dc65dac36",
         "supersedes": null,
         "metadata": {}
       },
@@ -41,7 +41,7 @@
         "slug": "azure-devops-engineer",
         "file": "agents/azure-devops-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:3086263402a7c6bf05e1d300a698a65a75fd5bc55f3ae1a2fc316872596963f7",
+        "checksum": "sha256:de957a69407222d0c72be8edd508cdf5217a0f62367f37102bccff33ae733f0e",
         "supersedes": null,
         "metadata": {}
       },
@@ -57,7 +57,7 @@
         "slug": "business-rule-miner",
         "file": "agents/business-rule-miner.md",
         "version": "1.0.0",
-        "checksum": "sha256:3d32899ae60014f0d2b29594c20f638dea2a30a4e923e2fe7458e0317c05358b",
+        "checksum": "sha256:2a94865af8945aba661034c30164f61a32e14226629c8bf85c7319f61a857639",
         "supersedes": null,
         "metadata": {}
       },
@@ -65,7 +65,7 @@
         "slug": "cicd-platform-engineer",
         "file": "agents/cicd-platform-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:ae9a48d5392b641eaf033497fac7d6e992e9ad47b31c97f77123112cc9475821",
+        "checksum": "sha256:b5117a81037a2fc1b19f9e26326f87b4d3377ae60114298b97d1f5da72f2e2d0",
         "supersedes": null,
         "metadata": {}
       },
@@ -81,7 +81,7 @@
         "slug": "code-archaeologist",
         "file": "agents/code-archaeologist.md",
         "version": "1.0.0",
-        "checksum": "sha256:1c7d32874c8da6a46ce5c5692edaa1dadc81d044b7fa59b44bca2822fc3db263",
+        "checksum": "sha256:67a0d1255047595a81cac8124fbc7a57f917a91d2d137f3b5162a5833d2b8eba",
         "supersedes": null,
         "metadata": {}
       },
@@ -121,7 +121,7 @@
         "slug": "docs-guardian",
         "file": "agents/docs-guardian.md",
         "version": "1.0.0",
-        "checksum": "sha256:fdefcdac038e9312c1eb65e5c4d65eae2cabb8bd80769b963ff0c05ae3656e3e",
+        "checksum": "sha256:26e93730ba830853567676b3ee27cf25688f8c2d7b06c43d8d2bb5289741bbb3",
         "supersedes": null,
         "metadata": {}
       },
@@ -137,7 +137,7 @@
         "slug": "frontend-engineer",
         "file": "agents/frontend-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:19f7d49ee83ffc6a5563194236ba25f300711bb063b2013e40ab62d1ddc65c72",
+        "checksum": "sha256:e04841221fba44748191d0de0f4d6f91e7600d0882ea032d67f80f82e3a5e1a4",
         "supersedes": null,
         "metadata": {}
       },
@@ -161,7 +161,7 @@
         "slug": "implementer",
         "file": "agents/implementer.md",
         "version": "1.0.0",
-        "checksum": "sha256:7b9eda703f4dc2c18bec8729ae26836c60f4045f1bf4eccafb27ffa11ce4985b",
+        "checksum": "sha256:2e78742505746028a15fa044c93bdb33a7b738bc2fddc8e55c264d06f6f082af",
         "supersedes": null,
         "metadata": {}
       },
@@ -185,7 +185,7 @@
         "slug": "legacy-synthesizer",
         "file": "agents/legacy-synthesizer.md",
         "version": "1.0.0",
-        "checksum": "sha256:fe488535188a2405f0f74c5503542adce5a7d63a8b28e0595a785afeb9c1a3f5",
+        "checksum": "sha256:041855d9fc48993a09ed5a998c1f2d653e8a0405d2a8d8e55ab2270dbf6b337f",
         "supersedes": null,
         "metadata": {}
       },
@@ -193,7 +193,7 @@
         "slug": "methodology-researcher",
         "file": "agents/methodology-researcher.md",
         "version": "1.0.0",
-        "checksum": "sha256:4f375cc980233bdc4ae1c32d047c6a1cbb53fce720c0b33e607e216b3d4a5b8b",
+        "checksum": "sha256:d2dc3a4f2eb40737cb9f31016c7208f4e638aa6a0f8a92997b75e4de19190d93",
         "supersedes": null,
         "metadata": {}
       },
@@ -201,7 +201,7 @@
         "slug": "operational-artifact-builder",
         "file": "agents/operational-artifact-builder.md",
         "version": "1.0.0",
-        "checksum": "sha256:05c07e734abcc5f67bee32ff1ac9c0471bc810626e493e4a50f424f103a97fee",
+        "checksum": "sha256:d3f8394d40d33b50a969f790c8e8b432ac1072c5b71bf671c0274bf48e28e738",
         "supersedes": null,
         "metadata": {}
       },
@@ -217,7 +217,7 @@
         "slug": "planner",
         "file": "agents/planner.md",
         "version": "1.0.0",
-        "checksum": "sha256:9984226243c6057da1a9444ec89bb4fce6918a7426816e357c2dc33806411c15",
+        "checksum": "sha256:418ad82445fdbc734f61a567307eadf3dea03006a89b478ab0d2c7bc46e29dc9",
         "supersedes": null,
         "metadata": {}
       },
@@ -225,7 +225,7 @@
         "slug": "presentation-engineer",
         "file": "agents/presentation-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:315304c540811affd7af0e03ac3175be0ed3b0496e2d1262558f2156d01f90fd",
+        "checksum": "sha256:7e16c4a8bd9a5a3e37e07b76c1d6d9cd81fea155e6977231b507114edb8304ce",
         "supersedes": null,
         "metadata": {}
       },
@@ -233,7 +233,7 @@
         "slug": "python-data-engineer",
         "file": "agents/python-data-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:20fff6c198c822afbca09017b6f81f2d89b8f50fe289da31aa4355a0dfdc7a5c",
+        "checksum": "sha256:634d88365218cd13d6b4b0724a969b5b8ec71562e96899eabda3ed739a6b5922",
         "supersedes": null,
         "metadata": {}
       },
@@ -241,7 +241,7 @@
         "slug": "researcher",
         "file": "agents/researcher.md",
         "version": "1.0.0",
-        "checksum": "sha256:d6939ea09a5982b34a581994334409e210295bd4d1f3a3597b162e323f8550f7",
+        "checksum": "sha256:5d36e948fa968684db917fd653dc264c45458fa476a1001305da745c1aebef54",
         "supersedes": null,
         "metadata": {}
       },
@@ -249,7 +249,7 @@
         "slug": "reviewer",
         "file": "agents/reviewer.md",
         "version": "1.0.0",
-        "checksum": "sha256:2f79f7b8c48741b811457530f1181d8daf6da187d4961b51ebb840e609556522",
+        "checksum": "sha256:46755a9f2aecdd4ad9ac0ac45a35f0b9b947aac4f120b58ac9edffc89da6899a",
         "supersedes": null,
         "metadata": {}
       },
@@ -257,7 +257,7 @@
         "slug": "schema-extractor",
         "file": "agents/schema-extractor.md",
         "version": "1.0.0",
-        "checksum": "sha256:f62bb48f46fd5e94890fd6699f190c4e61458d38609ac6ff890dbb8fbe9e88f5",
+        "checksum": "sha256:1472a8453c8a7513f297195ed4647758fce20af7093ae9482c6557732d1bf6b4",
         "supersedes": null,
         "metadata": {}
       },
@@ -273,7 +273,7 @@
         "slug": "specifier",
         "file": "agents/specifier.md",
         "version": "1.0.0",
-        "checksum": "sha256:8bbab71d75ba96cc2638fd4dca6611b790ba8fd124f344507c5b12dd5aa348e9",
+        "checksum": "sha256:2944d4ae1f707e18ad62addb2f97226b268b6f589514db1e8072a107976d97cd",
         "supersedes": null,
         "metadata": {}
       },
@@ -281,7 +281,7 @@
         "slug": "task-generator",
         "file": "agents/task-generator.md",
         "version": "1.0.0",
-        "checksum": "sha256:a2d1082d8839f91f6eb6ee5a8b1071aced3c739c12dee5b5c6a8e48562c11ca1",
+        "checksum": "sha256:a61e37e96017f0ed94810010efa440d992390cef1bf2a1cc421a009a7c75e2c4",
         "supersedes": null,
         "metadata": {}
       },
@@ -289,7 +289,7 @@
         "slug": "test-sidecar",
         "file": "agents/test-sidecar.md",
         "version": "1.0.0",
-        "checksum": "sha256:84ad7fc7236f030857e7b06be9bd1557469615838aaa5d8f77d0e4118c28dd45",
+        "checksum": "sha256:7789b0e53d319f0a43c945482195d4c933a2a6127073e193a405ed1accfa7384",
         "supersedes": null,
         "metadata": {}
       }
@@ -355,7 +355,7 @@
         "slug": "brainstorm-formalize",
         "file": "skills/brainstorm-formalize/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:7a9866557b8290a75d194c048614957f62203ef735cb0d3a51517d9899bba51a",
+        "checksum": "sha256:951aaf2b460a1a3c54c0c7db84d3701eec381c72341970619ed1252e1532c834",
         "supersedes": null,
         "metadata": {}
       },
@@ -403,7 +403,7 @@
         "slug": "design-system-validated-loop",
         "file": "skills/design-system-validated-loop/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:1d49a4ce637898ca456d7cfdcc946d2df4d9f09443d1e189fbe8ce20757d01ec",
+        "checksum": "sha256:19c566f3d55f897d49890cc593832e493b383a1f0e5df09401cbcb7041147182",
         "supersedes": null,
         "metadata": {}
       },
@@ -605,7 +605,7 @@
         "slug": "dangling-guard",
         "file": "hooks/dangling-guard.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:5180636d41b477c7d7823fc782329e9c828af96aa81caa966882ebd92d86edfe",
+        "checksum": "sha256:c432e643e3e8cb608e2c425e52b2c5727169675ca8feffb3983126b8c853a37a",
         "supersedes": null,
         "metadata": {}
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/definitions",
-  "version": "3.40.0",
+  "version": "3.42.1",
   "description": "Built-in definitions (agents, skills, hooks, workflows, KB seeds) for the Orchestrator ecosystem",
   "type": "module",
   "main": "dist/index.js",

package/skills/brainstorm-formalize/SKILL.md

@@ -43,7 +43,7 @@ Wait for user selection before proceeding.
 Before creating any document, check the last used ID:
 - For RFC: Read `project-guidelines/rfcs/index.md`, find the highest `RFC-NNN` in the table, increment by 1
 - For ADR: Read `project-guidelines/adrs/index.md`, find the highest `ADR-NNN` in the Operational ADRs table, increment by 1
-- For TD: Check `project-guidelines/BACKLOG.md` for the highest `TD-NNN` in use
+- For TD: Check `project-guidelines/registry.yaml` (technical-debt entries) for the highest `TD-NNN` in use
 
 ### RFC Frontmatter Template
 
@@ -118,16 +118,57 @@ File location: `project-guidelines/adrs/ADR-NNN-TITLE-SLUG.md`
 
 ### TD Entry Template
 
-TD items live in `project-guidelines/BACKLOG.md`. Add a new entry in the appropriate priority section:
+TD items live in `project-guidelines/technical-debt/TD-NNN-*.md` (one file per TD), indexed by an entry in `project-guidelines/registry.yaml`. Create the file and add the matching registry entry:
+
+File `project-guidelines/technical-debt/TD-NNN-TITLE-SLUG.md`:
 
 ```markdown
-### TD-NNN — [Short Title] (MEDIUM|HIGH|LOW, Nh)
+---
+type: td
+id: TD-NNN
+title: "[Short Title]"
+status: proposed       # proposed | accepted | resolved | rejected
+severity: medium       # critical | high | medium | low
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+layers: []             # e.g. [definitions, skills]
+sub_layers: []         # e.g. [skill-content, stale-reference]
+related: []            # e.g. [TD-333]
+resolves: []
+depends_on: []
+health:
+  last_scan: YYYY-MM-DD
+  lims: []
+  score:
+---
+
+# TD-NNN — [Short Title]
+
 **Symptom:** [What is observed]
 **Root cause:** [Why it happens]
 **Fix:** [Proposed solution]
 **Origin:** Brainstorm `docs/superpowers/specs/YYYY-MM-DD-[slug].md`
 ```
 
+Matching entry under `documents:` in `project-guidelines/registry.yaml` — the registry, not the frontmatter, owns the status, so keep both `status` values equal:
+
+```yaml
+  - id: TD-NNN
+    type: td
+    title: "[Short Title]"
+    status: proposed
+    severity: medium
+    file: technical-debt/TD-NNN-TITLE-SLUG.md
+    related:
+      - TD-333
+    resolved_in: null
+    created: YYYY-MM-DD
+    verification: verified-SNNN
+    note: "[Origin, and what was measured vs. not measured]"
+```
+
+`related` is bidirectional: add `TD-NNN` to the `related` of every document it names, or the vault gate flags a one-way edge. Then run `npm run generate:td-index` (regenerates `technical-debt/index.md` from the registry) and `npm run validate:registry`.
+
 ### design.md Template
 
 If the user chooses to keep it informal:
@@ -178,7 +219,7 @@ The table has 4 columns: ADR | Título | Data | Status.
 
 ### TD / design.md
 
-No index entry needed — TDs live in BACKLOG.md directly, and design.md files are self-contained.
+No separate index.md needed for TDs — the registry.yaml entry (added above) serves that role; design.md files remain self-contained.
 
 ---
 

package/skills/design-system-validated-loop/SKILL.md

@@ -43,7 +43,7 @@ If working a feature_development workflow where DSVL applies and T-001 is not ca
 │                                     │    │    re-render + publish           │
 │                                     │    │ 5. Playwright autonomous validate│
 │                                     │    │ 6. Session closure (memorias +   │
-│                                     │    │    BACKLOG + commit)             │
+│                                     │    │    state + commit)               │
 └─────────────────────────────────────┘    └──────────────────────────────────┘
 ```
 
@@ -219,10 +219,10 @@ Per `dsvl_route_around_bolt_for_trivial_fixes` (S167) and `bolt_github_pull_requ
 
 1. Create memorias for session learnings (type=feedback, frontmatter complete with claude_session + orchestrator_session)
 2. Update `memory-index.yaml` (project override; NOT MEMORY.md which is read-only legacy per RFC-027 Sprint 3)
-3. Update `BACKLOG.md` (bump version, update last_session, add closure paragraph, update tech-debt counters)
+3. Rotate `project-guidelines/project-state.yaml` (bump version, update lastTouched, archive prior sprint's summary/next_step, and recount the tech-debt counters in its `pending:` block from the TD entries of `project-guidelines/registry.yaml`)
 4. Commit orchestrator repo (do NOT push — human authorizes separately)
 
-**Gate 4:** working tree clean, memorias indexed, BACKLOG up-to-date, commit pending for human push.
+**Gate 4:** working tree clean, memorias indexed, project-state.yaml rotated, commit pending for human push.
 
 ## Token economics
 
@@ -261,7 +261,7 @@ Per `dsvl_route_around_bolt_for_trivial_fixes` (S167) and `bolt_github_pull_requ
 
 | Role | Responsibilities | Restrictions |
 |---|---|---|
-| Orchestrator | Canary write/iterate, markdown patches, pre-push verify, Playwright validate, closure (memorias + BACKLOG + local commit) | NO push external repos; NO prompt Bolt; NO unilateral palette/aesthetic decisions |
+| Orchestrator | Canary write/iterate, markdown patches, pre-push verify, Playwright validate, closure (memorias + project-state + local commit) | NO push external repos; NO prompt Bolt; NO unilateral palette/aesthetic decisions |
 | Human (CMAC) | Canary visual approval (Gate 1), push authorization (Gate 2 confirm + execute), Bolt sync prompt (Etapa 4), strategic audience-fit decisions | n/a — product owner + brand decisions |
 | Bolt/v0/Lovable | Ingest design-system markdown, render UI per spec, publish | NO self-validation; NO regeneration of existing code in re-ingest (additive caveat) |
 

package/skills/release/release.sh

@@ -6,11 +6,13 @@ set -euo pipefail
 # ============================================================================
 # Automates version bump and tag creation. CI/CD handles npm/Docker publish.
 #
-# Usage:
-#   ./scripts/release.sh patch    # 1.5.0 -> 1.5.1
-#   ./scripts/release.sh minor    # 1.5.0 -> 1.6.0
-#   ./scripts/release.sh major    # 1.5.0 -> 2.0.0
-#   ./scripts/release.sh 1.5.1    # Explicit version
+# Usage (from the repo root; the paths the script edits are relative to it):
+#   packages/definitions/skills/release/release.sh patch    # 1.5.0 -> 1.5.1
+#   packages/definitions/skills/release/release.sh minor    # 1.5.0 -> 1.6.0
+#   packages/definitions/skills/release/release.sh major    # 1.5.0 -> 2.0.0
+#   packages/definitions/skills/release/release.sh 1.5.1    # Explicit version
+#   npm run release -- patch    # same script, via the root package.json "release"
+# scripts/release.sh no longer exists (ADR-023; TD-222).
 #
 # Files updated:
 #   - package.json (root)
@@ -21,6 +23,9 @@ set -euo pipefail
 #   - packages/definitions/.claude-plugin/plugin.json (native plugin manifest — RFC-040 §18, TD-212)
 #   - packages/definitions/manifest.json (regenerated from bumped version — TD-193)
 #   - packages/project-root-resolver/package.json (published dep of mcp-server — S387)
+#   - packages/vault-projection/package.json (published dep of mcp-server — D-310)
+#   - packages/mcp-server/package.json dependency range on vault-projection
+#     (rewritten to the exact release version — D-310)
 #   - packages/cli/src/index.ts (CLI_VERSION constant)
 #   - src/infrastructure/templates/base/package.json.hbs (template versions)
 #
@@ -281,6 +286,39 @@ update_cli_version_constant() {
   log_info "Updated CLI_VERSION in: $file"
 }
 
+# Pin mcp-server's dependency on @orchestrator-claude/vault-projection to the exact
+# release version (D-310). Must run in the same bump as vault-projection's own
+# package.json: if only one of the two moves, npm ci cannot resolve the workspace
+# link and falls back to the registry (E404 for an unpublished version, S541).
+update_mcp_vault_projection_range() {
+  local version=$1
+  local file="packages/mcp-server/package.json"
+  local dep="@orchestrator-claude/vault-projection"
+
+  if [ ! -f "$file" ]; then
+    log_warning "File not found: $file"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] Would pin $dep to $version in: $file"
+    return
+  fi
+
+  node -e "
+    const fs = require('fs');
+    const pkg = JSON.parse(fs.readFileSync('$file', 'utf8'));
+    if (!pkg.dependencies || !pkg.dependencies['$dep']) {
+      console.error('$file has no dependency on $dep');
+      process.exit(1);
+    }
+    pkg.dependencies['$dep'] = '$version';
+    fs.writeFileSync('$file', JSON.stringify(pkg, null, 2) + '\n');
+  "
+
+  log_info "Pinned $dep to $version in: $file"
+}
+
 update_template_version() {
   local version=$1
   local file="src/infrastructure/templates/base/package.json.hbs"
@@ -315,6 +353,7 @@ update_all_versions() {
 
   # Update MCP server package
   update_package_version "packages/mcp-server/package.json" "$version"
+  update_mcp_vault_projection_range "$version"
 
   # Update SDK package
   update_package_version "packages/sdk/package.json" "$version"
@@ -331,6 +370,10 @@ update_all_versions() {
   # Update project-root-resolver package (published dependency of mcp-server — S387)
   update_package_version "packages/project-root-resolver/package.json" "$version"
 
+  # Update vault-projection package (published dependency of mcp-server — D-310).
+  # Moves together with update_mcp_vault_projection_range above.
+  update_package_version "packages/vault-projection/package.json" "$version"
+
   # Update CLI_VERSION constant
   update_cli_version_constant "$version"
 
@@ -467,6 +510,7 @@ commit_version_bump() {
     packages/definitions/.claude-plugin/plugin.json \
     packages/definitions/manifest.json \
     packages/project-root-resolver/package.json \
+    packages/vault-projection/package.json \
     packages/cli/src/index.ts \
     src/infrastructure/templates/base/package.json.hbs
 
@@ -475,12 +519,13 @@ commit_version_bump() {
 Updates:
 - package.json (root)
 - packages/cli/package.json
-- packages/mcp-server/package.json
+- packages/mcp-server/package.json (version + exact vault-projection range, D-310)
 - packages/sdk/package.json
 - packages/definitions/package.json
 - packages/definitions/.claude-plugin/plugin.json (native plugin manifest, RFC-040 §18)
 - packages/definitions/manifest.json (regenerated, TD-193)
 - packages/project-root-resolver/package.json (published dependency of mcp-server, S387)
+- packages/vault-projection/package.json (published dependency of mcp-server, D-310)
 - packages/cli/src/index.ts (CLI_VERSION)
 - src/infrastructure/templates/base/package.json.hbs (templates)
 
@@ -553,12 +598,13 @@ main() {
   echo "Files to update:"
   echo "  - package.json (root)"
   echo "  - packages/cli/package.json"
-  echo "  - packages/mcp-server/package.json"
+  echo "  - packages/mcp-server/package.json (version + exact vault-projection range, D-310)"
   echo "  - packages/sdk/package.json"
   echo "  - packages/definitions/package.json"
   echo "  - packages/definitions/.claude-plugin/plugin.json (native plugin manifest, RFC-040 §18)"
   echo "  - packages/definitions/manifest.json (regenerated from bumped version)"
   echo "  - packages/project-root-resolver/package.json (published dep of mcp-server, S387)"
+  echo "  - packages/vault-projection/package.json (published dep of mcp-server, D-310)"
   echo "  - packages/cli/src/index.ts (CLI_VERSION)"
   echo "  - src/infrastructure/templates/base/package.json.hbs (templates)"
   echo ""