hatch3r 2.1.0 → 2.2.0

package/dist/content/rules/hatch3r-tool-currency.mdc

@@ -56,7 +56,7 @@ Adding a new tool to `src/cliTools/registry.ts::AVAILABLE_CLI_TOOLS` MUST satisf
 7. **Capability matrix** — `src/adapters/canonical.ts` renders the skill to all 3 adapter outputs (cursor, claude, copilot); the per-adapter render path is tested in `src/__tests__/adapters/{name}.test.ts`.
 8. **Alternative-tool comparison** — the PR body lists at least 2 named alternatives considered (with rejection rationale citing measurable trade-offs); avoids tool-duplication per `rules/hatch3r-anti-duplication.md`.
 9. **Probe binary registration** — the `probe` field on the registry entry names the binary used by `detectInstalled()`; the probe MUST be the exact executable name printed by the install command output (e.g. `rg` for ripgrep, `fd` for fd, `jq` for jq).
-10. **Iteration-summary entry** — the addition emits one row in `rules/hatch3r-iteration-summary.md` §Changes Made with the registry-entry diff link, per the iteration-summary template.
+10. **Iteration-summary entry** — the addition emits one line in the recap-contract Iteration Summary citing the registry-entry diff link, per `rules/hatch3r-iteration-summary.md`.
 
 ## Removing or Demoting a Tool
 

package/dist/content/skills/hatch3r-adhoc-orchestrate/SKILL.md

@@ -85,7 +85,7 @@ Fan-out scales with task decomposition, not token budget (P8 B2 dominates P7): N
 
 ## Step 4: Emit the End-of-Turn Delegation Attestation Template
 
-Every turn that mutated files at Tier >= 2 emits the attestation block immediately BEFORE the Iteration Summary (beside it, not inside it — the iteration-summary contract stays verbatim), per `rules/hatch3r-agent-orchestration.md` -> End-of-Turn Delegation Attestation:
+Every turn that mutated files at Tier >= 2 emits the attestation block immediately BEFORE the Iteration Summary (beside it, not inside it — the recap contract stays verbatim), per `rules/hatch3r-agent-orchestration.md` -> End-of-Turn Delegation Attestation:
 
 ```
 [hatch3r-delegation-attestation]

package/dist/content/skills/hatch3r-design-system-detect/SKILL.md

@@ -153,6 +153,8 @@ Verdict: <reuse|extend|create-with-justification>
 
 ## Cross-references
 
+Consumer: `commands/hatch3r-design-system-create.md` — creation-side orchestrator; invokes this skill as its mandatory Step 1 and routes on the inventory verdict (reuse → halt, extend → gap-scoped, create → full generation).
+
 Rules consumed by this skill:
 
 - `rules/hatch3r-design-system-detection.md` — rule version of this guidance (mandate + scope)

package/dist/content/skills/hatch3r-handoff-prepare/SKILL.md

@@ -57,13 +57,13 @@ Populate the 8 required sections in the order defined by the README schema:
 - {decision with one-line rationale}
 
 ## Work Done
-- {bullet from the most recent Iteration Summary block's Done section}
+- {bullet from the most recent Iteration Summary recap's outcome + files facet}
 
 ## Work Remaining
-- {bullet from the Iteration Summary block's Not Done / Deferred / Unverified section}
+- {bullet per the recap's `Not done:` item; absent line ⇒ write "None — full scope completed"}
 
 ## Blockers
-- {bullet from the Iteration Summary block's Open Questions / Blockers section, or "None"}
+- {bullet per the recap's `Blockers:` item; absent line ⇒ write "None"}
 
 ## Next Steps
 1. {ordered, actionable}
@@ -83,7 +83,7 @@ Populate the 8 required sections in the order defined by the README schema:
 --- END USER-TIER CONTENT: handoff ---
 ```
 
-**Provenance constraint:** `Work Done`, `Work Remaining`, and `Blockers` are copied **verbatim** from the session's most recent Iteration Summary block (per `rules/hatch3r-iteration-summary.md`). Do not paraphrase — the contract is exact reuse so loaders can correlate handoff state with prior turn output.
+**Provenance constraint:** `Work Done`, `Work Remaining`, and `Blockers` derive from the session's most recent Iteration Summary per the Handoff Mapping in `rules/hatch3r-iteration-summary.md`: Work Done ← recap outcome + files facet; Work Remaining ← `Not done:` line, absent ⇒ `None — full scope completed`; Blockers ← `Blockers:` line, absent ⇒ `None`. Present lines are copied **verbatim** — do not paraphrase; the contract is exact reuse so loaders can correlate handoff state with prior turn output. The Work Remaining `Open findings` bullet is composed from the active run's findings-ledger fold (last line per `finding_id` wins; `rules/hatch3r-findings-ledger.md`), authoritative at composition time, in the recap grammar `Open findings: <finding_id> <sev> — <disposition>; …`: when the last recap's line agrees with the fold, copy it verbatim; when it is absent or disagrees (stale recap, mid-session interrupt), the fold wins and the bullet notes `(fold-derived; last recap stale or absent)`; zero open rows ⇒ no bullet.
 
 **Hard cap:** body ≤ 51,200 bytes (50 KB). If exceeded:
 

package/dist/content/skills/hatch3r-report/SKILL.md

@@ -167,4 +167,4 @@ Each fired record: `{id, severity, turns:[n,...], evidence, suggestion}`. Consol
 - **Mask obvious secret patterns** (`sk-`, `ghp_`, `xoxb-`, `AIza`, `Bearer `) in any rendered tool_use input — substitute `{REDACTED-{prefix}}`. The transcript may contain ephemeral tokens from user pastes.
 - **Never write outside `.hatch3r/reports/`.** The `--save` target is fixed; do not honor flags or env vars that redirect output to other paths.
 - **Never abort on a malformed record.** Skip-and-count is the contract; aborting would hide the rest of the session from the operator (Silent Failure Contract — surface the skip count rather than swallowing it).
-- **Honor the iteration summary contract** (`rules/hatch3r-iteration-summary.md`) at the end of the parent assistant turn that invoked this skill. The report content is not a substitute for the canonical Status / Outcome / Done block.
+- **Honor the iteration summary contract** (`rules/hatch3r-iteration-summary.md`) at the end of the parent assistant turn that invoked this skill. The report content is not a substitute for the canonical recap (status + outcome + telemetry facets).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hatch3r",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Agentic coding setup framework audited each release across 24 governance domains. One command to hatch your agent stack -- agents, skills, rules, commands, and MCP for Claude Code, Cursor, and GitHub Copilot.",
   "type": "module",
   "bin": {
@@ -19,7 +19,7 @@
     "inventory": "tsx scripts/inventory.ts",
     "inventory:check-docs": "tsx scripts/inventory.ts --check-docs",
     "validate:rule-parity": "tsx scripts/validate-rule-parity.ts && tsx scripts/validate-rule-pillar-currency.ts",
-    "validate:efficiency": "tsx scripts/validate-efficiency-invariants.ts && tsx scripts/validate-bridge-budget.ts && tsx scripts/validate-fanout-emission.ts && tsx scripts/validate-tag-order.ts && tsx scripts/validate-modes-parity.ts && tsx scripts/validate-governance-currency.ts && tsx scripts/validate-traceability-matrix.ts && tsx scripts/validate-decision-id-consistency.ts && tsx scripts/validate-repo-token-adoption.ts && tsx scripts/validate-verify-gate-literals.ts && tsx scripts/validate-customize-doc-examples.ts && tsx scripts/validate-archive-path-currency.ts && tsx scripts/validate-references-currency.ts && tsx scripts/validate-pricing-currency.ts && tsx scripts/validate-subagent-casing.ts && tsx scripts/validate-governance-total.ts",
+    "validate:efficiency": "tsx scripts/validate-efficiency-invariants.ts && tsx scripts/validate-bridge-budget.ts && tsx scripts/validate-fanout-emission.ts && tsx scripts/validate-tag-order.ts && tsx scripts/validate-modes-parity.ts && tsx scripts/validate-governance-currency.ts && tsx scripts/validate-traceability-matrix.ts && tsx scripts/validate-decision-id-consistency.ts && tsx scripts/validate-repo-token-adoption.ts && tsx scripts/validate-verify-gate-literals.ts && tsx scripts/validate-customize-doc-examples.ts && tsx scripts/validate-archive-path-currency.ts && tsx scripts/validate-references-currency.ts && tsx scripts/validate-pricing-currency.ts && tsx scripts/validate-subagent-casing.ts && tsx scripts/validate-governance-total.ts && tsx scripts/validate-lean-threshold-currency.ts",
     "validate:subagent-casing": "tsx scripts/validate-subagent-casing.ts",
     "validate:references-currency": "tsx scripts/validate-references-currency.ts",
     "validate:pricing-currency": "tsx scripts/validate-pricing-currency.ts",