@aperant/framework 0.19.0 → 0.20.0

package/dist/cli/gate/gates/index.mjs

@@ -17,6 +17,7 @@ import './verify-approved.mjs';
 import './review-clean.mjs';
 import './followups-adjudicated.mjs';
 import './gitignore-in-sync.mjs';
+import './features-reconciled.mjs';
 import './consistency-check.mjs';
 import './tdd-iron-law.mjs';
 import './r-persona-alignment.mjs';

package/dist/cli/gate/gates/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/index.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,yBAAyB,CAAA;AAChC,OAAO,6BAA6B,CAAA;AACpC,OAAO,mBAAmB,CAAA;AAC1B,OAAO,6BAA6B,CAAA;AACpC,OAAO,uBAAuB,CAAA;AAC9B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,6BAA6B,CAAA;AACpC,OAAO,yBAAyB,CAAA;AAChC,OAAO,yBAAyB,CAAA;AAChC,OAAO,oBAAoB,CAAA;AAC3B,OAAO,2BAA2B,CAAA"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/index.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,yBAAyB,CAAA;AAChC,OAAO,6BAA6B,CAAA;AACpC,OAAO,mBAAmB,CAAA;AAC1B,OAAO,6BAA6B,CAAA;AACpC,OAAO,uBAAuB,CAAA;AAC9B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,6BAA6B,CAAA;AACpC,OAAO,yBAAyB,CAAA;AAChC,OAAO,2BAA2B,CAAA;AAClC,OAAO,yBAAyB,CAAA;AAChC,OAAO,oBAAoB,CAAA;AAC3B,OAAO,2BAA2B,CAAA"}

package/dist/cli/help.mjs

@@ -36,7 +36,7 @@ Commands:
   task close-merged <dir> [--task <id>] [--narrate-only] [--dry-run]   Sweep shipped-pending-merge tasks for confirmed merges (--narrate-only returns pending_narration[] entries read-only without closing).
   task narration-drain <dir> --task <task-id>     Remove a row from state.pending_narration[] under withFileLock (called by /apt:close-task --narrate-only after a successful narrator spawn)
   task complete-subtask <dir> --task-id <id> --subtask-id <sid|a+b+c> [--commit <sha>] [--notes <text>]  Atomic plan ↔ build-progress sync
-  features-audit <dir> [--task-id <id>] [--no-worktree-redirect] [--diff-files <csv>|--since <ref>] [--apply-stubs] [--format json|md]  Audit features registry for unregistered feature-qualifying files (BUG-025b: --task-id redirects writes to active task's worktree)
+  features-reconcile <dir> (--draft|--write|--check|--gc) [--task-id <id>] [--subtask-id <id>] [--base <ref>] [--dry-run] [--warn-only] [--max-age-days <n>] [--no-worktree-redirect]  Feature-registry delta ledger: --draft scaffolds a per-writer delta from the base..HEAD diff, --write materializes deltas into area JSONs + a receipt, --check verifies coverage/schema/integrity/orphans, --gc prunes merged receipts (BUG-025b: --task-id redirects writes to active task's worktree)
   docs-audit <dir> [--diff-files <csv>|--since <ref>|--dry-run] [--policy <path>] [--format json|md]  Audit documented surfaces for docs-drift
 
   lock claim <dir> --subtask <id>       Claim exclusive lock on a subtask

package/dist/cli/release-notes/ship-autodraft.mjs

@@ -6,8 +6,8 @@
  * should grow a `Release note: …` line OR ship should block.
  *
  * This module is intentionally pure — the apt-ship SKILL.md body shells
- * `apt-tools features-audit . --diff-since <base> --json` and feeds the
- * envelope here. Keeping the decision pure makes TD-4 trivial: fixture in,
+ * `apt-tools features-reconcile . --draft --dry-run --base "$base"` and feeds
+ * the envelope here. Keeping the decision pure makes TD-4 trivial: fixture in,
  * decision out, no I/O.
  */
 import { buildPersonaTierMap, classifyFragment } from './persona-filter.mjs';

package/dist/cli/variant/gallery.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"gallery.d.mts","sourceRoot":"","sources":["../../../src/cli/variant/gallery.mjs"],"names":[],"mappings":"AA8CA;;;;;GAKG;AACH,qCAHW,YAAY,GACV,MAAM,CAkFlB;AAID;;;;;;;;;GASG;AACH,uDAJW,MAAM,EAAE,kBACR,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,GAClE;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyB7D;6BArJY;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;2BAC1E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE"}
+{"version":3,"file":"gallery.d.mts","sourceRoot":"","sources":["../../../src/cli/variant/gallery.mjs"],"names":[],"mappings":"AAkDA;;;;;GAKG;AACH,qCAHW,YAAY,GACV,MAAM,CAkFlB;AAID;;;;;;;;;GASG;AACH,uDAJW,MAAM,EAAE,kBACR,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,GAClE;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyB7D;6BArJY;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;2BAC1E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE"}

package/dist/cli/variant/gallery.mjs

@@ -12,6 +12,10 @@
  *     no privilege for that).  Picking happens by running a terminal
  *     command — the gallery's job is to make the letter obvious and the
  *     command copy-pasteable.
+ *   - Each card links to its variant file via a plain relative anchor
+ *     with target="_blank", so the user can open any variant full-size
+ *     in a new tab straight from the gallery (relative hrefs resolve
+ *     against the gallery's own file:// URL — no server needed).
  *   - Responsive grid: 1 column on narrow, 2 on medium, N on wide.
  *   - Each variant iframe is rendered at full device-width-feel, not a
  *     thumbnail, so the user can actually read the content.
@@ -74,11 +78,11 @@ export function renderGallery(input) {
             `              <div class="truncate text-xs text-slate-400">${description}</div>`,
             '            </div>',
             '          </div>',
-            `          <code class="shrink-0 rounded bg-slate-800 px-2 py-1 text-xs text-slate-300">${filename}</code>`,
+            `          <a href="${filename}" target="_blank" rel="noopener" title="Open variant ${letter} in a new tab" class="shrink-0 rounded bg-slate-800 px-2 py-1 text-xs text-slate-300 hover:bg-slate-700 hover:text-slate-100"><code>${filename}</code> ↗</a>`,
             '        </header>',
             `        <iframe src="${filename}" title="Variant ${letter}" loading="lazy" class="block h-[720px] w-full bg-white"></iframe>`,
             '        <footer class="flex items-center justify-between gap-3 border-t border-slate-800 px-4 py-3">',
-            `          <div class="text-xs text-slate-500">Pick this one:</div>`,
+            `          <a href="${filename}" target="_blank" rel="noopener" class="text-xs font-medium ${ACCENT} hover:underline">Open full size ↗</a>`,
             `          <code class="rounded bg-slate-800 px-2 py-1 text-xs text-slate-100">/apt:mockup --pick ${letter.toLowerCase()}</code>`,
             '        </footer>',
             '      </article>',
@@ -104,7 +108,7 @@ export function renderGallery(input) {
         '        <div>',
         `          <div class="text-xs uppercase tracking-[0.2em] text-slate-500">Variant gallery · iteration ${iterationEsc}</div>`,
         `          <h1 class="mt-1 text-2xl font-semibold text-slate-100">${featureEsc}</h1>`,
-        `          <p class="mt-1 text-sm text-slate-400">${variants.length} parallel generations. Open this page via <code>file://</code>, scan the iframes, pick the letter that lands.</p>`,
+        `          <p class="mt-1 text-sm text-slate-400">${variants.length} parallel generations. Open this page via <code>file://</code>, scan the iframes, click “Open full size” to view any variant in its own tab, then pick the letter that lands.</p>`,
         '        </div>',
         '        <div class="flex flex-col gap-2 text-xs text-slate-400 sm:items-end">',
         `          <div>Directory: <code class="text-slate-300">${taskDirEsc}/mockups/</code></div>`,

package/dist/cli/variant/gallery.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"gallery.mjs","sourceRoot":"","sources":["../../../src/cli/variant/gallery.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"gallery.mjs","sourceRoot":"","sources":["../../../src/cli/variant/gallery.mjs"],"names":[],"mappings":"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"}

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "aperant",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "AI coding framework — composable skills for planning, executing, verifying, and reviewing code with any LLM provider. Works as Claude Code commands, Codex tasks, or programmatically.",
   "author": {
     "name": "Mikalsen AI",

package/dist/plugin/agents/apt-executor.md

@@ -103,6 +103,12 @@ node packages/framework/bin/apt-tools.mjs commit "feat: {subtask.title}" --files
 ```
 Update `implementation_plan.json` status to `"completed"`. Write `build-progress.json`.
 
+**Delta-emit (feature registry).** After the commit, scaffold this subtask's registry delta and enrich it while the build context is still in your window:
+```bash
+node packages/framework/bin/apt-tools.mjs features-reconcile . --draft --task-id {task-id} --subtask-id {subtask.id}
+```
+Fill every `needs-disposition` entry (`upsert` / `remove` / `wiring-transition` / `no-semantic-change` — the last needs a one-line `reason`), assign any `area: null`, and replace draft upsert stubs with real `sub_features` carrying `wired`/`handler`/`test_hint`. Then stage the delta and amend it into the subtask commit: `git add .aperant/features/deltas/ && git commit --amend --no-edit`. Non-blocking: on a reconcile glitch, log and continue — the ship gate + CI check catch real gaps.
+
 ### 3f. Checkpoint State
 `build-progress.json` is written every subtask in 3e — that is the durable resume point. Do NOT self-estimate context. Do NOT voluntarily exit. Keep executing until the plan is complete or a risk gate stops you. If the harness auto-compacts mid-run, re-read `{task_dir}/implementation_plan.json` + `{task_dir}/build-progress.json` after compaction and continue from the next pending subtask — the checkpoint is authoritative, your in-memory state is not.
 

package/dist/plugin/agents/apt-planner.md

@@ -190,8 +190,9 @@ Two policy buckets, two behaviors:
   finding if you omit it.
 - **`auto-update`** (default for milestones.json, REGISTRY.md,
   project_index.json, .aperant/tasks/**): a doc subtask that invokes the
-  appropriate apt-tools subcommand (`features-audit --apply-stubs`,
-  `roadmap rollup`, etc.) so the internal state stays coherent.
+  appropriate apt-tools subcommand (`features-reconcile --draft` at the
+  executor's delta-emit step, `roadmap rollup`, etc.) so the internal
+  state stays coherent.
 
 Bias toward false positives — a no-op doc subtask costs nothing; a missed
 drift finding ships to the user. Full rules in

package/dist/plugin/skills/apt-close-task/SKILL.md

@@ -185,7 +185,7 @@ Flags:
 Per ledger entry `{ task_id, scope, phase_id, closed_at, pr_number }`:
 
 0. **Enumerate the ledger first.** Run `apt-tools task close-merged . --narrate-only [--task <id>]`. The envelope's `closed[]` is the read-only list of pending narration rows (each carries `narration_pending: true`); state.json is not mutated. When `closed[]` is empty, exit early with `{status: 'ok', narrated: [], skipped: [], remaining: 0}` — there is nothing to drain.
-1. Run `apt-tools features-audit . --apply-stubs --task <task_id>` so the feature registry catches whatever the closed task introduced. If the subprocess exits non-zero, skip the entry with `reason: 'features-audit-failed'` — never block narration on registry update.
+1. Run `apt-tools features-reconcile . --gc` to prune feature-registry receipts that are merged to origin/main and older than 30 days. Receipt GC is close-task's ONLY registry role — the registry WRITE happened at ship time (`/apt:ship` §0.0 materialize), so there is no post-merge registry write to drift main. If the subprocess exits non-zero, skip the entry with `reason: 'features-gc-failed'` — never block narration on registry GC.
 2. When `phase_id` is non-null, spawn `apt-team-docs-narrator` (background, fire-and-forget) using the same shape as §2.5: `subagent_type: apt-team-docs-narrator`, `run_in_background: true`, `description: Narrate shipped phase {phase_id}`, `prompt: Run in phase-ship mode with --phase {phase_id} --scope {scope}.`. When `phase_id` is null, skip the spawn with `reason: 'no-phase-id'` (quick tasks have no phase to narrate).
 3. On successful spawn (or successful no-phase skip), drain the row via `apt-tools task narration-drain . --task <task_id>` which acquires `withFileLock(state.json)` and removes the matching `pending_narration[]` entry. On spawn failure, leave the row in place with `reason: 'narrator-spawn-failed'` so the user can re-invoke.
 
@@ -198,7 +198,7 @@ Emit a summary envelope:
   "status": "ok",
   "command": "close-task-narrate-only",
   "narrated": [{ "task_id": "<id>", "phase_id": "<p|null>", "scope": "<s>" }],
-  "skipped": [{ "task_id": "<id>", "reason": "no-phase-id|features-audit-failed|narrator-spawn-failed" }],
+  "skipped": [{ "task_id": "<id>", "reason": "no-phase-id|features-gc-failed|narrator-spawn-failed" }],
   "remaining": <ledger.length>
 }
 ```

package/dist/plugin/skills/apt-debug/SKILL.md

@@ -291,6 +291,14 @@ Document the root cause clearly:
 cd {worktree_path} && node packages/framework/bin/apt-tools.mjs commit "fix: {concise description of fix}" --files {changed-files}
 ```
 
+After the commit, emit the registry delta (one non-blocking command):
+
+```bash
+node packages/framework/bin/apt-tools.mjs features-reconcile . --draft --task-id {task-id} || true
+```
+
+Stage `.aperant/features/deltas/` with the commit; fill any `needs-disposition` field (usually `no-semantic-change` + a one-line reason).
+
 ### 6c. Update Status
 
 ```markdown

package/dist/plugin/skills/apt-execute/SKILL.md

@@ -373,38 +373,47 @@ node packages/framework/bin/apt-tools.mjs audit pending-artifacts . --stage
 - **`unknown[]` non-empty** → HARD STOP. A path under `.aperant/` is not classified. Treat as a planner gap — the subtask touched state that the contract does not know about. Write the decision to `{task_dir}/execution-decisions.md` (decision class: `classification-gap`), then either extend `packages/framework/src/cli/artifacts/classification.mjs` inline (if the subtask already modifies framework code) or open a follow-up task (if the drift is orthogonal). Do NOT proceed to the next subtask until the envelope returns `clean`.
 - **Envelope status == `clean`** → proceed to 3e-features.
 
-### 3e-features. Features Registry Post-Step (C33)
+### 3e-features. Feature-Registry Delta Emit
 
-After the subtask commits, run `features-audit --apply-stubs` so any
-newly-added UI/core/hook/IPC file in the diff lands in
-`.aperant/features/<area>.json` automatically. The reviewer Pass 6 covers
-whatever the post-step missed; running it here closes the gap where
-executor commits introduce a new feature surface without registering it.
+After the subtask commits, emit this subtask's registry DELTA — semantic
+capture happens HERE, while the build context is still in your window.
+`/apt:ship` §0.0 materializes all pending deltas into the area JSONs +
+a receipt later; you only record what changed and what it means.
 
 ```bash
-node packages/framework/bin/apt-tools.mjs features-audit . \
-  --task-id "$TASK_ID" \
-  --diff-files "$(git diff --name-only HEAD^ HEAD | tr '\n' ',')" \
-  --apply-stubs
+node packages/framework/bin/apt-tools.mjs features-reconcile . \
+  --draft --task-id "$TASK_ID" --subtask-id "{subtask.id}"
 ```
 
+Then ENRICH the scaffold at `.aperant/features/deltas/{task-id}-{subtask.id}.json`:
+
+- Fill every `needs-disposition` files[] entry with a real disposition
+  (`upsert` | `remove` | `wiring-transition` | `no-semantic-change` — the
+  last REQUIRES a one-line `reason`). Added qualifying files MUST register
+  (added + no-semantic-change is a validation error).
+- Assign any `area: null` (the hooks/ipc/services junk drawers no longer
+  exist — pick the owning product area).
+- Replace draft upsert stubs with real feature groups: `sub_features[]`
+  entries carrying `wired` / `handler` / `test_hint` per
+  `FeatureRegistrySchema`.
+- A wired-state change is `disposition: "wiring-transition"` plus a
+  `patch-sub-feature` operation carrying `expected_from` (the prior
+  `wired` value).
+
+Stage the delta with the commit:
+`git add .aperant/features/deltas/ && git commit --amend --no-edit`.
+
 Notes:
-- `--task-id $TASK_ID` (BUG-025b) is mandatory when the executor runs
-  from the main-repo cwd instead of inside the worktree (the
-  orchestrator's common path). features-audit resolves the worktree's
-  `.aperant/features/` from the active task record and writes there,
-  preventing generated `*.json` from leaking into main. When invoked
-  from the worktree cwd directly, `--task-id` is a no-op (layer 1
-  detection short-circuits). Pass `--no-worktree-redirect` only when
-  you intentionally want to write to the invoking cwd.
-- `--apply-stubs` only runs when the matched surface's policy is
-  `auto-update` (the default for `.aperant/features/*.json`). Users who
-  opted out via `/apt:setup` Batch 7 get a no-op — the command still
-  succeeds.
-- Pre-existing flag-drift findings are never emitted here — they're the
-  reviewer's job. The post-step is append-only on internal state.
-- If the audit fails (exit code != 0), log the failure and continue; don't
-  block subtask completion on a features-registry glitch.
+- `--task-id "$TASK_ID"` (BUG-025b) redirects the delta write to the active
+  task's worktree `.aperant/features/deltas/` when you run from the
+  main-repo cwd; it is ALSO the per-writer delta filename, so it is always
+  required.
+- The write is skipped (`policy-opt-out`) when the user opted
+  `.aperant/features/*.json` out of `auto-update` via `/apt:setup` Batch 7.
+- Non-blocking: if the reconcile scaffold fails (exit code != 0), log the
+  failure and continue; don't block subtask completion on a registry
+  glitch. The ship-time `features-reconciled` gate + the always-on CI
+  check catch real gaps.
 
 ### 3e-gate. Per-Task Review Gate (R7)
 

package/dist/plugin/skills/apt-mockup/SKILL.md

@@ -58,7 +58,7 @@ Text-first design stays in `apt:design`. This skill never edits `DESIGN.md` or `
 **Writes:**
 - `{task_dir}/mockups/iteration-NNN.html` — One file per iteration, zero-padded 3-digit (`iteration-001.html`, `iteration-002.html`, ...). Promoted from a picked variant when the first render used `--variants`.
 - `{task_dir}/mockups/iteration-NNN-variant-<letter>.html` — One per variant in a `--variants` run (letters `a..e` for `N=2..5`)
-- `{task_dir}/mockups/iteration-NNN-gallery.html` — Generated by `apt-tools variant-gallery`; iframes the N variants side-by-side with the pick command spelled out.
+- `{task_dir}/mockups/iteration-NNN-gallery.html` — Generated by `apt-tools variant-gallery`; iframes the N variants side-by-side with the pick command spelled out, and each variant card links to its full HTML file (opens in a new tab).
 - `{task_dir}/mockups/iteration-NNN-archive/` — After `--pick <letter>`, the losing variants and the gallery move here (preserved, not deleted, so the user can review what was rejected).
 - `{task_dir}/mockups/mockup_final.html` — On `--accept`, a byte-identical copy of the latest `iteration-NNN.html` so iteration history is preserved.
 - `{task_dir}/mockups/mockup_log.md` — Append-only log: one entry per turn with iteration number, mode, user prompt, and (when relevant) variant style seeds.

package/dist/plugin/skills/apt-quick/SKILL.md

@@ -165,7 +165,7 @@ Show the affected files briefly before proceeding (5-second delay; user can inte
 Make the changes directly:
 - Follow existing code patterns and conventions
 - Keep changes minimal — solve the stated problem, nothing more
-- If touching code with tests, run the tests to make sure nothing breaks
+- If touching tested code, run those tests
 
 ## 5. Verify (Lightweight)
 
@@ -175,7 +175,7 @@ Run a quick sanity check appropriate to the change:
   pnpm typecheck 2>&1 | tail -20
   ```
 - **Config change:** Validate the config is syntactically correct
-- **Doc change:** No verification needed unless `--verify` flag is set
+- **Doc change:** none unless `--verify` is set
 - **Style change:** Run lint on changed files
 
 If visual verification is performed via MCP screenshots:
@@ -185,24 +185,26 @@ If visual verification is performed via MCP screenshots:
 If verification fails:
 - Fix the issue
 - Re-run verification
-- If stuck after 2 attempts, report the failure and let the user decide
+- If stuck after 2 attempts, report and let the user decide
 
 ## 6. Commit
 
-Create an atomic commit with a descriptive message:
+Create an atomic commit:
 
 ```bash
 git add {changed-files}
 git commit -m "{type}: {description}"
 ```
 
-Use appropriate conventional commit type:
-- `fix:` for bug fixes
-- `docs:` for documentation
-- `style:` for formatting/style
-- `chore:` for config, dependencies, maintenance
-- `refactor:` for code restructuring
-- `feat:` for small features (rare for quick tasks)
+Use a conventional commit type: `fix:` / `docs:` / `style:` / `chore:` / `refactor:` / `feat:` (rare for quick tasks).
+
+After the commit, emit the registry delta (one non-blocking command):
+
+```bash
+node packages/framework/bin/apt-tools.mjs features-reconcile . --draft --task-id {task-id} || true
+```
+
+Stage `.aperant/features/deltas/` with the commit; fill any `needs-disposition` field (usually `no-semantic-change` + a one-line reason).
 
 ## 7. Record Task
 

package/dist/plugin/skills/apt-review/SKILL.md

@@ -146,8 +146,8 @@ AGENTS.md, READMEs, docs/**). It is **inline** in the reviewer brief — a
 grep workload that does not justify a separate agent spawn.
 
 This pass drives two CLI verbs: `apt-tools docs-audit` (external +
-internal drift detection) and `apt-tools features-audit` (registry
-coverage). Both emit JSON; the reviewer buckets by policy.
+internal drift detection) and `apt-tools features-reconcile --check`
+(registry coverage). Both emit JSON; the reviewer buckets by policy.
 
 1. Run the docs-drift audit against the task's diff:
 
@@ -159,23 +159,26 @@ coverage). Both emit JSON; the reviewer buckets by policy.
    Capture the `findings[]` (for `flag-drift` surfaces) and `patch_plan[]`
    (for `auto-update` surfaces).
 
-2. Run the features-registry audit in report-only mode:
+2. Run the features-registry reconcile check in report-only mode:
 
    ```bash
-   node packages/framework/bin/apt-tools.mjs features-audit . \
-     --since <task-base-ref> --format json
+   node packages/framework/bin/apt-tools.mjs features-reconcile . \
+     --check --warn-only --base <task-base-ref>
    ```
 
-   The executor post-step in `/apt:execute` already applies stubs for
-   `auto-update` surfaces; this run catches anything the executor missed
-   (e.g. stubs were generated but the user's policy opted out, or the
-   executor skipped the post-step on a blocked subtask).
+   The executor's `/apt:execute` §3e-features delta-emit already recorded
+   this task's registry deltas; this run catches anything the executor
+   missed (an uncovered qualifying file, a stale fingerprint after a
+   re-edit, a delta still carrying `needs-disposition`). The repair the
+   reviewer surfaces is `features-reconcile . --draft --task-id <id>`
+   (then fill dispositions) — never a hand-authored area edit.
 
 3. **Policy split — critical:**
    - **auto-update findings** are FIXED inline via the fix-review loop. The
      reviewer applies the patch via the matching `apt-tools` subcommand
-     (`features-audit --apply-stubs`, `roadmap rollup`, registry rewriter).
-     These land in iterations 1–2 of the fix loop.
+     (`features-reconcile --draft` + fill dispositions + `--write`,
+     `roadmap rollup`, registry rewriter). These land in iterations 1–2 of
+     the fix loop.
    - **flag-drift findings** are SURFACED only. They appear in
      `review_findings.md` with category `docs-drift`, severity `warning`,
      and the full shape

package/dist/plugin/skills/apt-run/SKILL.md

@@ -30,7 +30,7 @@ Run the full Aperant pipeline: plan a task, execute all subtasks, verify the imp
 
 As of C32 the STANDARD and DEEP auto pipelines **terminate on review** (`plan → execute → verify → review`). Pass `--skip-review` to stop after verify; for trivial work the QUICK track still skips planning entirely.
 
-Pass `--full` to carry a SINGLE task all the way to **merged + green**: it extends the pipeline past review through **ship** (a PR that auto-merges to main on green — never a direct push) and **watch-CI** (arm the watcher with auto-merge so the change lands once CI passes). `--full` is a thin chain over the existing `/apt:ship` + `/apt:watch-ci` skills — it forces review ON and is hard-guarded by `autonomy.allow_yolo` plus a one-time confirm (§1a). A `/apt:run` invocation WITHOUT `--full` behaves exactly as today (terminates on review).
+Pass `--full` to carry a SINGLE task all the way to **merged + green**: it extends the pipeline past review through **ship** (a PR that auto-merges to main on green — never a direct push) and **watch-CI** (arm the watcher with auto-merge so the change lands once CI passes — the merge is performed by `/apt:watch-ci` alone, never a direct `gh pr merge`). `--full` is a thin chain over the existing `/apt:ship` + `/apt:watch-ci` skills — it forces review ON and is hard-guarded by `autonomy.allow_yolo` plus a one-time confirm (§1a). A `/apt:run` invocation WITHOUT `--full` behaves exactly as today (terminates on review).
 </objective>
 
 <your_environment>
@@ -399,7 +399,7 @@ Pipeline order note: the user's phrasing was *"review, verify"* but `/apt:run` r
 
 **Ship (Option A — PR that auto-merges to main on green; NEVER a direct push/merge):**
 
-Invoke `/apt:ship` inline. It runs its own hard-gate (verify-approved / review-clean / consistency / gitignore), opens the PR against the task's recorded `base_branch` (main for a task forked from main), and atomically flips `reviewing → shipped-pending-merge` via `task update --pr-url` — which also arms the post-ship watcher per `ci_watch.after_ship`. `--full` MUST NEVER `git push`/`git merge` directly to main (ID-02 Option B is rejected unconditionally): "ship to main" means **a PR that auto-merges to main on green**, not a force-push.
+Invoke `/apt:ship` inline. It runs its own hard-gate (verify-approved / review-clean / consistency / gitignore), opens the PR against the task's recorded `base_branch` (main for a task forked from main), and atomically flips `reviewing → shipped-pending-merge` via `task update --pr-url` — which also arms the post-ship watcher per `ci_watch.after_ship`. `--full` MUST NEVER `git push`/`git merge` directly to main (ID-02 Option B is rejected unconditionally): "ship to main" means **a PR that auto-merges to main on green**, not a force-push. The merge itself is performed EXCLUSIVELY by `/apt:watch-ci` (§6.2, ID-10) — `--full` MUST NEVER run `gh pr merge` (with or without `--auto`) nor enable GitHub native auto-merge.
 
 Capture the opened PR number `{N}` from the `/apt:ship` result for §6.2.
 
@@ -413,13 +413,19 @@ After the PR opens, force auto-merge for THIS run regardless of the config defau
 node packages/framework/bin/apt-tools.mjs ci-watch start . --pr {N} --task-id {task-id} --host {cli} --auto-merge-on-green
 ```
 
+> **ID-10 — `/apt:watch-ci` is the SOLE merge authority (hard guardrail).**
+> The auto-merge is performed EXCLUSIVELY by `/apt:watch-ci`: its §4 green branch runs a plain `gh pr merge {N} --squash` — NEVER `--auto` — only after its `allGreen` classifier confirms every check is terminal-green.
+> `--full` (and `/apt:ship`) MUST NEVER itself run `gh pr merge` — with or without `--auto`/`--squash` — nor enable GitHub native auto-merge.
+> Rationale: this repo has no required status checks, so `gh pr merge --auto` degrades to an immediate merge — it would land the PR before CI can turn it red (the exact bug this guardrail prevents).
+> After ship, the ONLY merge-capable dispatch is invoking `/apt:watch-ci --tick --pr {N}` (below) and letting the watcher decide; you do NOT merge here.
+
 **Branch on host cron capability.** Run host-detect and read `host_capabilities.cron`:
 
 ```bash
 node packages/framework/bin/apt-tools.mjs host-detect .
 ```
 
-- **cron-capable host** (e.g. Claude Code, `cron: true`): the watcher is armed with auto-merge ON; register the recurring tick via the host's `CronCreate` (per `/apt:watch-ci` §3). Then **EXIT — do NOT loop** (respect `/apt:watch-ci`'s single-execution-per-invocation contract). The cron beat drives the watcher to merged + green unattended. Report: watcher armed, auto-merge ON, and the deadline.
+- **cron-capable host** (e.g. Claude Code, `cron: true`): the watcher is armed with auto-merge ON; hand the merge to `/apt:watch-ci` — register a recurring `CronCreate` whose payload is `/apt:watch-ci --tick --pr {N}` (per `/apt:watch-ci` §3), then invoke `/apt:watch-ci --tick --pr {N}` once now to run the first (still-waiting) tick. Then **EXIT — do NOT loop** (respect `/apt:watch-ci`'s single-execution-per-invocation contract). The cron beat drives `/apt:watch-ci` to merged + green unattended, and its §4 green branch performs the green-gated squash-merge — you never merge from here. Report: watcher armed, auto-merge ON, and the deadline.
 - **non-cron host** (Codex / Gemini / OpenCode): truly-unattended watching is impossible. Arm the watch state + auto-merge (the `ci-watch start --auto-merge-on-green` above) but do NOT impersonate a scheduler — NEVER fake a `while` / `sleep` loop. Print the honest manual-tick instruction:
 
   ```

package/dist/plugin/skills/apt-ship/SKILL.md

@@ -24,6 +24,7 @@ gates:
   - consistency-check
   - r-persona-alignment
   - gitignore-in-sync
+  - features-reconciled
 config_keys:
   - pipeline.auto_branch
   - pipeline.branch_prefix
@@ -54,6 +55,27 @@ Create a pull request (or publish a package) with full traceability from decisio
 
 <process>
 
+## 0.0 Materialize feature-registry deltas
+
+BEFORE the hard-gate check runs (write-then-verify: the `features-reconciled` gate in Section 0 verifies what this step wrote), materialize any pending feature-registry deltas into the area JSONs + a durable receipt:
+
+```bash
+ship_cwd=$(node packages/framework/bin/apt-tools.mjs task get . --id {task-id} | jq -r '.task.worktree_path // empty')
+ship_cwd=${ship_cwd:-.}
+node packages/framework/bin/apt-tools.mjs features-reconcile "$ship_cwd" --write --task-id {task-id}
+```
+
+Handle the envelope:
+
+- **`status: "ok"` with writes** (`materialized > 0` or a non-empty `changed_paths`): the write already self-staged its committable outputs (areas + receipt + REGISTRY.md + deleted delta paths). Commit them in `ship_cwd`:
+  ```bash
+  git -C "$ship_cwd" commit -m "chore(aperant): materialize feature-registry deltas"
+  ```
+  (Skip the commit when nothing was staged — a zero-delta write only regenerates REGISTRY.md when it drifted.)
+- **`status: "skip"` (`reason: "policy-opt-out"`)**: proceed — the `features-reconciled` gate reports `skip` for the same reason.
+- **`status: "error"` with `kind: "hard-conflict"`**: STOP. Print the conflict report verbatim (it names BOTH writer delta files). The repair is `features-reconcile "$ship_cwd" --draft --task-id {task-id}` plus hand-fixing the conflicting operations — NEVER `--force` around this stop.
+- **`status: "error"` with `kind: "invalid-deltas"`**: STOP and report — a pending delta still carries `needs-disposition` (or another validation failure); fill the dispositions and re-run.
+
 ## 0. Hard Gate Check
 
 Before gathering context or building any PR artifacts, run the hard-gate check for the `ship` skill:
@@ -72,7 +94,7 @@ Parse the JSON envelope:
   ```
   Exit the skill. Do NOT auto-apply `--force` — force is an explicit human decision.
 
-The ship gate covers constitution-read, verify-approved (qa_signoff.json verdict), review-clean (no unresolved critical/warning findings), gitignore-in-sync (.aperant/.gitignore conformance), and consistency-check (G8 — cross-artifact consistency between spec.md, implementation_plan.json, review.json, qa_signoff.json, and build-progress.json). Because these gates run here, Sections 1–3 below no longer need to re-check the verify verdict or block on review findings — the gate already did it.
+The ship gate covers constitution-read, verify-approved (qa_signoff.json verdict), review-clean (no unresolved critical/warning findings), gitignore-in-sync (.aperant/.gitignore conformance), features-reconciled (feature-registry deltas materialized in Section 0.0 + coverage/schema/integrity verified — blocking on ALL profiles, QUICK/DEBUG included), and consistency-check (G8 — cross-artifact consistency between spec.md, implementation_plan.json, review.json, qa_signoff.json, and build-progress.json). Because these gates run here, Sections 1–3 below no longer need to re-check the verify verdict or block on review findings — the gate already did it.
 
 ### 0.1 Parse `profile` from the envelope
 
@@ -249,14 +271,14 @@ If `rn_enabled !== "true"`, jump to Section 3.
 
 ### 2.6.1 Compute the feature-registry diff
 
-The auto-draft needs to know which features the PR's commits touched. Use the same `features-audit` surface that `apt:execute` uses post-step:
+The auto-draft needs to know which features the PR's commits touched. Source the diff from a read-only reconcile draft (no file is written):
 
 ```bash
-base=$(node packages/framework/bin/apt-tools.mjs task get . --id {task-id} | jq -r '.base_branch // "main"')
-feature_diff=$(node packages/framework/bin/apt-tools.mjs features-audit . --diff-since "$base" --json)
+base=$(node packages/framework/bin/apt-tools.mjs task get . --id {task-id} | jq -r '.task.base_branch // "main"')
+feature_diff=$(node packages/framework/bin/apt-tools.mjs features-reconcile . --draft --dry-run --base "$base" --task-id {task-id})
 ```
 
-The envelope shape (see `packages/framework/src/cli/commands/features-audit.mjs`) returns the list of touched features with their declared `personas: []` field (when the registry's feature row carries one).
+The envelope's `delta.files[]` entries (see `packages/framework/src/cli/commands/features-reconcile.mjs`) carry each touched surface with its `area` — feed those areas to the helper below alongside the registry's declared `personas: []` fields (when the feature rows carry one).
 
 ### 2.6.2 Decide draft vs block via the helper
 

package/dist/plugin/skills/apt-watch-ci/SKILL.md

@@ -125,6 +125,8 @@ When `action === 'fix'` (or `diverged-rebased`/`diverged-bailed`):
 5. **Emit event.** `apt-tools event append . --type ci-watch.fix-pushed --data '{pr, attempts, commit_sha}'`.
 6. **Reschedule** per §3 step 4.
 
+When the failed check is `features-reconcile`, the fixer MAY run the deterministic repair directly instead of a free-form fix: `apt-tools features-reconcile . --draft --task-id {task-id}` in the worktree, fill the scaffold's dispositions, `apt-tools features-reconcile . --write --task-id {task-id}`, commit + push. Correctness never depends on this path — raw PRs (no active task / pr_url) repair via the red check's printed `--draft` command.
+
 For `diverged-rebased`: the cmd already returned the verb; the orchestrator runs `git -C {worktree} fetch && git rebase origin/{base}` BEFORE the fix step. On conflict the action becomes `diverged-bailed`.
 
 For `diverged-bailed`: default behavior is to exit with a PR comment summarizing the conflict. Self-heal is **opt-in** via `ci_watch.resolve_merge_conflicts` (default false) in `.aperant/config.json`. When enabled, instead of bailing, hand off to **`/apt:merge-conflict-resolution`** (`--base origin/{base}`) for the worktree; it resolves the rebase conflict inline and re-probes mergeability. On success, continue to the §5 fix-and-push step (`git push origin {branch}`) and reschedule per §3 — the watcher keeps running. On its non-convergence STOP (it aborts the rebase to a clean tree first), fall back to the bail-with-PR-comment path. The resolved branch still goes through CI; the watcher never auto-merges except via the existing config-gated green-branch `gh pr merge --squash` (§4).

package/dist/schemas/feature-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-registry.d.ts","sourceRoot":"","sources":["../../src/schemas/feature-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA0BvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAa3B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQhC,CAAA;AAGF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAGnE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;GAEpD;AAGD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAwC,CAAA"}
+{"version":3,"file":"feature-registry.d.ts","sourceRoot":"","sources":["../../src/schemas/feature-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA0BvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAa3B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAA;AAiBF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBhC,CAAA;AAGF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAGnE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;GAEpD;AAKD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4C,CAAA"}

package/dist/schemas/feature-registry.js

@@ -38,7 +38,7 @@ export const FeatureGroupSchema = z.object({
     component: ComponentRef.optional(),
     sub_features: z.array(SubFeatureSchema).default([]),
 });
-export const FeatureRegistrySchema = z.object({
+const FeatureRegistryBaseSchema = z.object({
     area: z.string().min(1),
     route: z.string().min(1),
     components: z.array(ComponentRef).default([]),
@@ -47,10 +47,41 @@ export const FeatureRegistrySchema = z.object({
     }),
     features: z.array(FeatureGroupSchema),
 });
+// Uniqueness refinement (features-reconcile AC17): feature ids must be unique
+// per area, and sub_feature ids unique per feature group. Mirrored by the
+// dependency-free twin validator `src/cli/features/area-shape.mjs` (the
+// bare-node CI check cannot import zod) — parity is locked by
+// `feature-registry-schema-parity.test.ts`.
+export const FeatureRegistrySchema = FeatureRegistryBaseSchema.superRefine((data, ctx) => {
+    const featureIds = new Set();
+    for (const [i, group] of data.features.entries()) {
+        if (featureIds.has(group.id)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['features', i, 'id'],
+                message: `duplicate feature id "${group.id}" in area`,
+            });
+        }
+        featureIds.add(group.id);
+        const subIds = new Set();
+        for (const [j, sub] of group.sub_features.entries()) {
+            if (subIds.has(sub.id)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['features', i, 'sub_features', j, 'id'],
+                    message: `duplicate sub_feature id "${sub.id}" in group`,
+                });
+            }
+            subIds.add(sub.id);
+        }
+    }
+});
 // Validator — thin wrapper returning zod's discriminated union { success: true, data } | { success: false, error }
 export function validateFeatureRegistry(data) {
     return FeatureRegistrySchema.safeParse(data);
 }
-// Pre-computed JSON Schema for use in LLM prompt injection
-export const featureRegistryJsonSchema = z.toJSONSchema(FeatureRegistrySchema);
+// Pre-computed JSON Schema for use in LLM prompt injection. Derived from the
+// BASE object schema — the uniqueness superRefine is not JSON-Schema
+// representable and would be dropped/rejected by z.toJSONSchema.
+export const featureRegistryJsonSchema = z.toJSONSchema(FeatureRegistryBaseSchema);
 //# sourceMappingURL=feature-registry.js.map

package/dist/schemas/feature-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-registry.js","sourceRoot":"","sources":["../../src/schemas/feature-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feature-registry.js","sourceRoot":"","sources":["../../src/schemas/feature-registry.ts"],"names":[],"mappings":"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"}

package/dist/types/config.d.ts

@@ -403,11 +403,14 @@ export interface CiWatchConfig {
      */
     after_ship?: 'auto' | 'ask' | 'never';
     /**
-     * On all-green CI, auto-merge the PR via `gh pr merge --auto --squash`.
-     * Default `false` — the watcher prints a merge hint and leaves the merge
-     * decision to the user (matches the user's stated rhythm). Flip to `true`
-     * once a calendar week of clean post-launch usage shows zero false-green
-     * merges (D-08 kill criteria).
+     * On all-green CI, `/apt:watch-ci` merges the PR with a plain
+     * `gh pr merge --squash` — NEVER `gh pr merge --auto` (in a repo without
+     * required status checks `--auto` degrades to an immediate merge; the
+     * watcher's `allGreen` classifier is the gate, not GitHub branch
+     * protection). Default `false` — the watcher prints a merge hint and leaves
+     * the merge decision to the user (matches the user's stated rhythm). Flip to
+     * `true` once a calendar week of clean post-launch usage shows zero
+     * false-green merges (D-08 kill criteria).
      */
     auto_merge_on_green?: boolean;
 }