@orchestrator-claude/definitions 3.41.0 → 3.42.1

package/manifest.json

@@ -1,8 +1,8 @@
 {
   "schema": "orchestrator-definitions/v1",
   "namespace": "orchestrator",
-  "version": "3.41.0",
-  "generatedAt": "2026-09-28T13:57:42.842Z",
+  "version": "3.42.1",
+  "generatedAt": "2026-09-30T15:23:10.072Z",
   "definitions": {
     "agents": [
       {
@@ -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": {}
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/definitions",
-  "version": "3.41.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 ""