@aperant/framework 0.7.3 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,72 @@ All notable changes to `@aperant/framework` are documented here. See
 
 ## [Unreleased]
 
+## 0.8.0 — 2026-05-20 — cross-task fan-out + 5 framework defects (BUG-033..038)
+
+Minor release. Ships the new `/apt:fan-out` skill (cross-task parallelization from a single conductor terminal) and closes five framework defects surfaced during real `/apt:run` pipelines. Includes one behavioral default change (`task_isolation.from_branch` now defaults to `main`, not `current`).
+
+### New capability: `/apt:fan-out`
+
+Cross-task parallelization from one conductor terminal. The host CLI's main thread spawns N `apt-executor` sub-agents via Task tool `run_in_background: true`, each pinned to its own task-level worktree. Accepts `--tasks <id-list>` (canonical), `--phases <m/p>` (policy front), `--unblocked` (auto-pick from roadmap ready-state). Default concurrency cap `parallelization.max_tasks: 4`.
+
+Built on the **generalized wave engine**: `wave.mjs` + `wfrun/dag.mjs` now accept `unit_kind: "subtask" | "task"` so task-level fan-out reuses the same primitives (`apt-tools lock`, JSONL event log, `max_agents` quota) as the existing subtask wave-parallel mode. Subtask path is bit-equivalent (locked by snapshot test).
+
+ADRs documenting the locked decisions:
+- ADR-0001 worker subagent topology (host CLI Task tool background spawn)
+- ADR-0002 paired skill surface (mechanism + policy split)
+- ADR-0003 conductor identity (host CLI main thread; never daemon)
+
+### Defects fixed
+
+- **FRAMEWORK-BUG-033** — cross-task fan-out gap (the umbrella above) bundled the four lifecycle/identity sub-defects:
+  - Phase auto-completion sibling-guard bug in `lifecycle.mjs` (16-task phase flipping to `completed` on first close)
+  - Durable `assigned_to` field on task records
+  - `APT_AGENT_ID=fanout-${batch_id}-${task_id}` export from `apt-executor` for stable per-worker identity
+  - Wave engine generalization to accept either subtask or task as `unit_id`
+- **FRAMEWORK-BUG-034** — `validate-evidence` parser self-reference. Stamper inserted `- **Validation Status**: ...` using the same `- **...**:` field-form shape its own regex matched; on subsequent passes the parser dismissed 88% of LLM-validated findings as `evidence_not_literal` by reading its own stamped text as the cited evidence. Fix: writer emits trailing `### Validation Metadata` section; reader strips legacy field-form Status/Note before evidence extraction. Dual-shape reader for back-compat.
+- **FRAMEWORK-BUG-035** — `pr-review-audit-fixer` parser only matched `### {ID}` finding headers, not the canonical `## Fix N` shape per FRAMEWORK-BUG-030. Returned `<none parsed>` + false-positive `hallucinated` verdict despite real commits. Fix: new `parseFixNEntries` with finding-ID extraction via priority chain `**Finding ID**:` → `**Fix**:` → `**ID**:` → synthetic.
+- **FRAMEWORK-BUG-036** — lifecycle phase didn't auto-advance through `apt:execute` / `apt:verify` / `apt:review` SKILL.md success-paths. Only `/apt:ship` flipped the phase (and only from `reviewing`, which never happened). Fix: each skill adds ONE `task update --lifecycle-phase` call at success-end, advancing `executing` → `verifying` → `reviewing`. `/apt:ship` atomic `reviewing → shipped-pending-merge` flip now fires reliably.
+- **FRAMEWORK-BUG-037** — `task_isolation.from_branch: "current"` default silently chained WIP commits into new task PRs. **Behavioral default change**: now `"main"` with main-detection chain (`origin/HEAD` → `origin/main` → `origin/master` → local `main` / `master`). Explicit `--from-branch current` / `--from-branch HEAD` preserved for power users who want chaining. Projects with explicit `from_branch` in their own `.aperant/config.json` are unaffected.
+- **FRAMEWORK-BUG-038** — `/apt:spar` Round-1 `verdict=cede` terminated unilaterally, collapsing every multi-round session to one round. Two SKILL.md edits: partner prompt template now requires `NEXT_WEAKEST_POINT`; Step 8 splits cede semantics — `--rounds 1` explicit terminates, `--rounds >= 2` (default) emits `next-round` regardless and requires two consecutive same-disposition rounds for convergence. No new flags, no new skills.
+
+### Version
+
+- `packages/framework/package.json`: 0.7.4 → 0.8.0
+- `cli-baseline-version.txt` + `cli-baseline-help.txt` fixtures bumped
+
+### Commits
+
+- feat(framework): cross-task fan-out + 4 lifecycle/identity fixes (#208) — bd099c8f
+- fix(framework): apt:spar Round-1 collapse (#210) — 567a63d0
+- fix(framework): validate-evidence + audit-fixer parsers (#211) — 0f28a1af
+- fix(framework): lifecycle auto-advance + from-branch default (#214) — b1abcb65
+- (this one) — chore(framework): 0.8.0 — cross-task fan-out + 5 framework defects (BUG-033..038)
+
+## 0.7.4 — 2026-05-18 — apt-pr-review context-budget skip prohibition
+
+Docs-only patch release hardening the `apt-pr-review` "Fix Everything" contract against a live failure pattern where an orchestrator dropped confirmed minor findings mid-Phase-6 because its own context window felt heavy ("my orchestrator window was getting heavy after 6 specialist rounds + Round 1 work"). Pre-existing rule 5 in §Context Budget Rules already forbade skipping *phases*; this release closes the per-finding gap inside Phase 6.
+
+### apt-pr-review SKILL.md
+
+Three reading depths now carry the prohibition:
+
+- **§Principle: Fix Everything (Phase 6)** — new "Hard rule" paragraph. Orchestrator context pressure, "many fixes already done," and marginal-value judgment are explicitly NOT valid skip reasons. Reminds the orchestrator that fix work runs in fixer windows, so orchestrator pressure does not justify cutting fixer inputs.
+- **§Key Principles → 2. Fix Everything Found** — invalid-reason list extended to include "my context window is heavy" / "I've already done a lot this run."
+- **§Common Mistakes → new 7a (Dropping Findings Because Orchestrator Context Feels Heavy)** — names the failure pattern verbatim, labels it an unauthorized policy deviation, prescribes spawning fixers in smallest batches possible (and filing a framework bug) rather than shipping a partial fix.
+
+Only valid skip authorities remain the three in Key Principle #2: `fixable: false`, critical finding without user approval, file assigned to another fixer.
+
+### Version
+
+- `packages/framework/package.json`: 0.7.3 → 0.7.4
+- `cli-baseline-version.txt` fixture bumped
+
+### Commits
+
+- chore(framework): forbid context-budget skips in apt-pr-review (a1eb033d)
+- docs(framework): changelog entry for pr-review context-budget skip fix (43c98286)
+- (this one) — chore(framework): 0.7.4 — apt-pr-review context-budget skip prohibition
+
 ## 0.7.3 — 2026-05-17 — C56 roadmap reconciliation + operator-blocked notes
 
 Docs-only patch release reconciling the roadmap with reality. No code changes.

package/agents/apt-executor.md

@@ -46,6 +46,18 @@ node packages/framework/bin/apt-tools.mjs gate check . --task-id {task-id} --ski
 
 If `status == "fail"`, STOP. Report the failed gates verbatim and exit — do NOT auto-apply `--force`. Forcing is a human decision; the user can re-invoke with `--force --reason "<explanation>"` to bypass (the override is logged to `.aperant/events/{today}.jsonl`).
 
+## 0a. Fan-out worker identity (FRAMEWORK-BUG-033 defect 3)
+
+If your spawn prompt contains both `batch_id` and `task_id` (i.e. you are a fan-out worker subagent dispatched by `/apt:fan-out`), export `APT_AGENT_ID` in EVERY `Bash` invocation that runs `apt-tools ...`:
+
+```bash
+APT_AGENT_ID=fanout-${batch_id}-${task_id} node packages/framework/bin/apt-tools.mjs <command> ...
+```
+
+This pins your `team-status/{agentId}.json` file across short-lived CLI invocations. Without it, each `apt-tools` call gets a fresh `hostname-pid` agentId (per `agent-identity.mjs:86`), the previous pid dies, and `listTeamStatus({ includeStale: false })` filters healthy workers out between invocations — the team-status dashboard flickers into emptiness instead of showing 4 stable fan-out workers.
+
+Non-fan-out invocations of this agent receive no `batch_id` and skip this export — the legacy `hostname-pid` path remains correct for single-task work.
+
 ## 1. Load Context
 
 1. Read `CLAUDE.md` and `AGENTS.md` if they exist

package/agents/apt-team-docs-narrator.md

@@ -72,6 +72,17 @@ If the parent spawned you without a mode you recognize, write an error line to `
    rendered table. If present, REPLACE the content between anchors (never
    append — this is how re-runs stay idempotent).
 7. Call `apt-tools roadmap sync . --reason 'narrator:phase-ship:<phase_id>'`.
+8. **Slice 5 / AC14 / ADR-0006 dual-write.** Write the rendered prose
+   block to a temp file (e.g. `mktemp -t narrator-prose-XXXXXX.md`), then
+   run
+   `apt-tools roadmap convex-mirror . --scope <scope> --phase <phase_id> --anchor-id phase-ship:<phase_id> --prose-path <tempfile>`
+   (add `--merged-pr <pr-number>` when known). The markdown write from
+   step 7 is canonical (ADR-0006); this step is the Convex mirror.
+   Fail-soft contract:
+   - exit 0 with `status:ok` or `status:queued` → continue normally
+   - exit non-zero with `status:error` → append the error message to
+     `.aperant/digests/errors.log` and continue (do NOT block on Convex
+     failures; the in-process cron drainer reconciles within 5 min)
 
 ## Mode 2: `decision-merge` — merge a recorded decision into the roadmap
 

package/dist/cli/ci-watch/stop-matrix.d.mts

@@ -1,8 +1,13 @@
 /**
  * @typedef {Object} CheckRow
  * @property {string} [name]
- * @property {string} [conclusion] e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
- * @property {string} [state]
+ * @property {string} [state] Primary per-check status (gh-CLI uppercase enum):
+ *   'SUCCESS' | 'FAILURE' | 'CANCELLED' | 'TIMED_OUT' | 'SKIPPED' |
+ *   'IN_PROGRESS' | 'QUEUED' | 'PENDING' | 'NEUTRAL'.
+ * @property {string} [conclusion] Legacy lowercase per-check field
+ *   (deprecated — gh dropped it from `pr checks --json` schema circa 2.65).
+ *   Retained only as a soft fallback for in-memory test fixtures
+ *   (FRAMEWORK-BUG-016).
  * @property {string} [bucket]
  * @property {string} [failure_class] — optional pre-classified hint (test-only seam)
  * @property {string} [log_fingerprint] — optional digest for identical-log detection
@@ -25,10 +30,18 @@ export function isFailing(check: any): boolean;
 export type CheckRow = {
     name?: string | undefined;
     /**
-     * e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
+     * Primary per-check status (gh-CLI uppercase enum):
+     * 'SUCCESS' | 'FAILURE' | 'CANCELLED' | 'TIMED_OUT' | 'SKIPPED' |
+     * 'IN_PROGRESS' | 'QUEUED' | 'PENDING' | 'NEUTRAL'.
      */
-    conclusion?: string | undefined;
     state?: string | undefined;
+    /**
+     * Legacy lowercase per-check field
+     * (deprecated — gh dropped it from `pr checks --json` schema circa 2.65).
+     * Retained only as a soft fallback for in-memory test fixtures
+     * (FRAMEWORK-BUG-016).
+     */
+    conclusion?: string | undefined;
     bucket?: string | undefined;
     /**
      * — optional pre-classified hint (test-only seam)

package/dist/cli/ci-watch/stop-matrix.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-matrix.d.mts","sourceRoot":"","sources":["../../../src/cli/ci-watch/stop-matrix.mjs"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wDAHW,aAAa,GACX,cAAc,CA8I1B;AAED,+CAGC;;;;;;;;;;;;;;;;;;;YA7Ja,QAAQ,EAAE;;;;WACV,MAAM;;;;gBACN,MAAM;;;YAGN,MAAM;0BACN,OAAO;YACP,MAAM"}
+{"version":3,"file":"stop-matrix.d.mts","sourceRoot":"","sources":["../../../src/cli/ci-watch/stop-matrix.mjs"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wDAHW,aAAa,GACX,cAAc,CAuJ1B;AAED,+CAuBC;;;;;;;;;;;;;;;;;;;;;;;;;;;YA1La,QAAQ,EAAE;;;;WACV,MAAM;;;;gBACN,MAAM;;;YAGN,MAAM;0BACN,OAAO;YACP,MAAM"}

package/dist/cli/ci-watch/stop-matrix.mjs

@@ -5,11 +5,17 @@
  *   { action, counts_toward_budget, reason }
  *
  * No I/O, no fs, no gh CLI shell-outs — caller pre-fetches `checks` (the
- * payload from `gh pr checks --json name,bucket,state,conclusion,detailsUrl`)
+ * payload from `gh pr checks --json name,bucket,state,link,workflow,completedAt`)
  * and `prMetadata` (`gh pr view --json state,reviewDecision`) and passes them
  * in. The orchestrator in commands/ci-watch.mjs handles the side effects
  * implied by the action.
  *
+ * Primary per-check signal is `state` (uppercase per gh-CLI: SUCCESS,
+ * FAILURE, CANCELLED, TIMED_OUT, SKIPPED, IN_PROGRESS, QUEUED, PENDING,
+ * NEUTRAL). The legacy lowercase per-check field that gh dropped circa
+ * 2.65 is kept as a soft fallback for in-memory test fixtures only —
+ * production gh payloads no longer expose it (FRAMEWORK-BUG-016).
+ *
  * Predicate order matters — short-circuits go first (merged/closed/green/cap
  * fire before any per-check inspection). See spec.md §9 table for the full
  * ordering.
@@ -28,8 +34,13 @@ const INFRA_FAILURE_CLASSES = new Set(['runner-oom', 'runner-cancelled', 'gh-5xx
 /**
  * @typedef {Object} CheckRow
  * @property {string} [name]
- * @property {string} [conclusion] e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
- * @property {string} [state]
+ * @property {string} [state] Primary per-check status (gh-CLI uppercase enum):
+ *   'SUCCESS' | 'FAILURE' | 'CANCELLED' | 'TIMED_OUT' | 'SKIPPED' |
+ *   'IN_PROGRESS' | 'QUEUED' | 'PENDING' | 'NEUTRAL'.
+ * @property {string} [conclusion] Legacy lowercase per-check field
+ *   (deprecated — gh dropped it from `pr checks --json` schema circa 2.65).
+ *   Retained only as a soft fallback for in-memory test fixtures
+ *   (FRAMEWORK-BUG-016).
  * @property {string} [bucket]
  * @property {string} [failure_class] — optional pre-classified hint (test-only seam)
  * @property {string} [log_fingerprint] — optional digest for identical-log detection
@@ -60,7 +71,15 @@ export function classify({ checks, state, prMetadata }) {
         return { action: 'closed', counts_toward_budget: false, reason: 'pr is closed unmerged' };
     }
     const failed = rows.filter((c) => isFailing(c));
-    const allGreen = rows.length > 0 && rows.every((c) => c.conclusion === 'success');
+    // FRAMEWORK-BUG-016: `state` is gh-CLI's primary per-check field post-2.65.
+    // SKIPPED rows (workflow `if:` guards that didn't trip) are
+    // success-equivalent — they intentionally did not run and that is OK.
+    // Soft fallback to the legacy lowercase field keeps the in-memory test
+    // fixtures green (production gh payloads never hit it).
+    const isGreenRow = (c) => c.state === 'SUCCESS' ||
+        c.state === 'SKIPPED' ||
+        (c.state == null && c.conclusion === 'success');
+    const allGreen = rows.length > 0 && rows.every(isGreenRow);
     // 3. All checks green.
     if (allGreen) {
         return { action: 'green', counts_toward_budget: false, reason: 'all checks succeeded' };
@@ -174,6 +193,24 @@ export function classify({ checks, state, prMetadata }) {
     };
 }
 export function isFailing(check) {
+    // FRAMEWORK-BUG-016 / BUG-025: prefer the uppercase `state` field that gh
+    // 2.65+ exposes. SKIPPED / NEUTRAL / IN_PROGRESS / QUEUED / PENDING /
+    // SUCCESS are explicitly NOT red — SKIPPED in particular must never
+    // burn a fix attempt (workflow `if:` guards routinely skip jobs on PRs
+    // that don't trip them). The legacy lowercase field is a soft fallback
+    // for in-memory test fixtures only.
+    const s = check.state;
+    if (s === 'SUCCESS' ||
+        s === 'SKIPPED' ||
+        s === 'NEUTRAL' ||
+        s === 'IN_PROGRESS' ||
+        s === 'QUEUED' ||
+        s === 'PENDING') {
+        return false;
+    }
+    if (s === 'FAILURE' || s === 'CANCELLED' || s === 'TIMED_OUT') {
+        return true;
+    }
     const c = check.conclusion;
     return c === 'failure' || c === 'cancelled' || c === 'timed_out' || c === 'action_required';
 }

package/dist/cli/ci-watch/stop-matrix.mjs.map

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

package/dist/cli/commands/fan-out.d.mts

@@ -0,0 +1,2 @@
+export function cmdFanOut(subcommand: any, projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=fan-out.d.mts.map

package/dist/cli/commands/fan-out.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/fan-out.mjs"],"names":[],"mappings":"AAmEA,wHA6DC"}

package/dist/cli/commands/fan-out.mjs

@@ -0,0 +1,123 @@
+/**
+ * commands/fan-out.mjs — FRAMEWORK-BUG-033 capability gap (ID-04 / ID-05).
+ *
+ * Single resolver helper for the `/apt:fan-out` SKILL body. Three input
+ * forms accepted (`--tasks`, `--phases`, `--unblocked`); all resolve to
+ * the canonical `{task_ids, source, batch_id}` shape. The actual
+ * orchestration loop (worktree create, worker spawn, polling) lives in
+ * the SKILL body — this CLI just materializes the batch.
+ *
+ * Subcommands: `resolve`.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parseFlags } from '../util/args.mjs';
+import { err, ok } from '../util/result.mjs';
+const ID_PATTERN = /^[a-z0-9_-]+$/i;
+function generateBatchId() {
+    const d = new Date();
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(d.getUTCDate()).padStart(2, '0');
+    const hex = Math.random().toString(16).slice(2, 8);
+    return `fanout-${yyyy}${mm}${dd}-${hex}`;
+}
+function parseIdList(raw) {
+    if (typeof raw !== 'string')
+        return [];
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function readState(targetDir) {
+    const statePath = join(targetDir, '.aperant', 'state.json');
+    if (!existsSync(statePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function resolveFromPhases(state, phases) {
+    const wanted = new Set(phases);
+    const ids = [];
+    for (const [id, task] of Object.entries(state?.active_tasks || {})) {
+        if (!task)
+            continue;
+        const key = `${task.milestone_id ?? ''}/${task.phase_id ?? ''}`;
+        if (wanted.has(key) && task.lifecycle_phase !== 'closed') {
+            ids.push(id);
+        }
+    }
+    return ids;
+}
+function resolveUnblocked(state) {
+    const ids = [];
+    for (const [id, task] of Object.entries(state?.active_tasks || {})) {
+        if (task?.lifecycle_phase === 'ready-for-agent')
+            ids.push(id);
+    }
+    return ids;
+}
+export function cmdFanOut(subcommand, projectDir, extraArgs) {
+    if (!subcommand) {
+        return err('Usage: apt-tools fan-out <resolve> <project-dir> [--tasks <ids> | --phases <m/p,m/p> | --unblocked]');
+    }
+    switch (subcommand) {
+        case 'resolve': {
+            if (!projectDir) {
+                return err('Usage: apt-tools fan-out resolve <project-dir> [--tasks <ids> | --phases <m/p,m/p> | --unblocked]');
+            }
+            const targetDir = resolve(projectDir);
+            const flags = parseFlags(extraArgs);
+            const hasTasks = flags.has('tasks');
+            const hasPhases = flags.has('phases');
+            const hasUnblocked = flags.has('unblocked');
+            const inputForms = [hasTasks, hasPhases, hasUnblocked].filter(Boolean).length;
+            if (inputForms === 0) {
+                return err('One of --tasks, --phases, or --unblocked is required');
+            }
+            if (inputForms > 1) {
+                return err('Only one of --tasks, --phases, or --unblocked may be passed at a time');
+            }
+            let taskIds = [];
+            let source = '';
+            if (hasTasks) {
+                taskIds = parseIdList(flags.get('tasks'));
+                source = 'tasks';
+                for (const id of taskIds) {
+                    if (!ID_PATTERN.test(id)) {
+                        return err(`Invalid task id in --tasks: "${id}" (must match /^[a-z0-9_-]+$/i)`);
+                    }
+                }
+            }
+            else if (hasPhases) {
+                const state = readState(targetDir);
+                if (!state)
+                    return err('No state.json found — cannot resolve --phases');
+                taskIds = resolveFromPhases(state, parseIdList(flags.get('phases')));
+                source = 'phases';
+            }
+            else {
+                const state = readState(targetDir);
+                if (!state)
+                    return err('No state.json found — cannot resolve --unblocked');
+                taskIds = resolveUnblocked(state);
+                source = 'unblocked';
+            }
+            return ok({
+                status: 'ok',
+                command: 'fan-out-resolve',
+                source,
+                task_ids: taskIds,
+                batch_id: generateBatchId(),
+            });
+        }
+        default:
+            return err(`Unknown fan-out subcommand: ${subcommand}. Available: resolve`);
+    }
+}
+//# sourceMappingURL=fan-out.mjs.map

package/dist/cli/commands/fan-out.mjs.map

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

package/dist/cli/commands/modes.d.mts

@@ -10,4 +10,26 @@
  * tree is also scanned when present.
  */
 export function cmdModes(subcommand: any, projectDir: any, _extraArgs: any): import("../util/result.mjs").CommandResult;
+/**
+ * Hardcoded skill→config-paths map. Maintained inline so adding a new
+ * config-dependent skill is a one-line change.
+ *
+ * Per AC12, this is the mapping `modes list` consumes to enumerate
+ * which config keys a skill cares about. Skills that don't touch
+ * config are omitted (their config_keys is `[]`).
+ *
+ * AUDIT-001 (0.7.2): all dotted paths below resolve against the MERGED
+ * config (`loadMergedProjectConfig()` — shared `config.json` + local
+ * `config.local.json` overlay). The five per-device fields enumerated by
+ * `AUDIT_001_LOCAL_FIELDS` in `cli/config/load.mjs` (currently
+ * `verification.open_report`, `multi_model.cross_verification.tools`,
+ * `preferences.{date_format,time_format,quick_task_post_verify}`)
+ * physically live in `config.local.json`; the wildcard `'*'` surface for
+ * `apt:setup` covers both files. Consumers MUST go through the merged
+ * loader — never raw `JSON.parse(readFileSync('.aperant/config.json'))` —
+ * to honor per-device overrides correctly.
+ *
+ * @type {Record<string, string[]>}
+ */
+export const SKILL_CONFIG_KEYS: Record<string, string[]>;
 //# sourceMappingURL=modes.d.mts.map

package/dist/cli/commands/modes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"modes.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/modes.mjs"],"names":[],"mappings":"AAwKA;;;;;;;;;;GAUG;AACH,wHA+CC"}
+{"version":3,"file":"modes.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/modes.mjs"],"names":[],"mappings":"AA2KA;;;;;;;;;;GAUG;AACH,wHA+CC;AAlMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,gCAFU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAoBjC"}

package/dist/cli/commands/modes.mjs

@@ -51,7 +51,7 @@ const FRONTMATTER_RE = /^---\s*([\s\S]*?)\s*---/;
  *
  * @type {Record<string, string[]>}
  */
-const SKILL_CONFIG_KEYS = {
+export const SKILL_CONFIG_KEYS = {
     'apt:execute': ['coding.tdd_default', 'tdd.iron_law'],
     'apt:triage': [
         'task_tracking.backend',
@@ -66,6 +66,9 @@ const SKILL_CONFIG_KEYS = {
     'apt:ship': ['pipeline.auto_branch', 'pipeline.branch_prefix'],
     'apt:setup': ['*'], // setup edits config — wildcard surface
     'apt:run': ['parallelization.enabled', 'parallelization.max_agents'],
+    // FRAMEWORK-BUG-033 capability gap (AC10) — fan-out concurrency cap.
+    // Consumed by the /apt:fan-out SKILL body via cli/config/parallelization.mjs.
+    'apt:fan-out': ['parallelization.max_tasks', 'parallelization.max_agents'],
 };
 /**
  * Parse the `argument-hint` frontmatter field for `--flag` tokens.

package/dist/cli/commands/modes.mjs.map

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

package/dist/cli/commands/pr-review-audit-fixer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-review-audit-fixer.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/pr-review-audit-fixer.mjs"],"names":[],"mappings":"AA+EA;;;;;GAKG;AACH;;;;;SAgBC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;;;;;;;;;;EAeC;AA6TD;;;;;;;;;GASG;AACH;;;EAoBC;AAED;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6JC;AAED;;;;;;;;;;;;EAiCC;AAmDD;;GAEG;AACH,mHAmOC"}
+{"version":3,"file":"pr-review-audit-fixer.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/pr-review-audit-fixer.mjs"],"names":[],"mappings":"AA+EA;;;;;GAKG;AACH;;;;;SAgBC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;;;;;;;;;;EA0BC;AA8XD;;;;;;;;;GASG;AACH;;;EAoBC;AAED;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6JC;AAED;;;;;;;;;;;;EAiCC;AAmDD;;GAEG;AACH,mHAmOC"}

package/dist/cli/commands/pr-review-audit-fixer.mjs

@@ -143,13 +143,28 @@ export function parseFixesAppliedMarkdown(md) {
     const fixesSection = extractTopLevelSection(md, 'Fixes Applied');
     const selfReviewerSection = extractTopLevelSection(md, 'Fixes Applied by Self-Reviewer');
     const skippedSection = extractTopLevelSection(md, 'Skipped');
-    const fixes = [
-        ...parseFixEntries(fixesSection),
-        ...parseSelfReviewerFixEntries(selfReviewerSection),
-    ];
+    const legacyFixerEntries = parseFixEntries(fixesSection);
+    const selfReviewerEntries = parseSelfReviewerFixEntries(selfReviewerSection);
+    // FRAMEWORK-BUG-035: additive `## Fix N` parser path. Scans the whole
+    // document — NOT a `## Fixes Applied` body — so it catches fixer reports
+    // shaped as numbered top-level blocks. Union, not substitution, per spec
+    // ID-03 so legacy `### {ID}` reports keep parsing unchanged.
+    const fixNEntries = parseFixNEntries(md);
+    const fixes = [...legacyFixerEntries, ...selfReviewerEntries, ...fixNEntries];
     const skipped = parseSkippedEntries(skippedSection);
-    // Detect which heading was present; fixer takes precedence when both appear.
-    const schema = fixesSection ? 'fixer' : 'self-reviewer';
+    // Schema discriminator: when the ONLY entries came from the `## Fix N`
+    // parser path, label it `'fix-n'` so downstream code / debugging can
+    // tell which shape was on disk. Fall back to existing fixer / self-
+    // reviewer labels when those sections were present.
+    let schema;
+    if (fixesSection)
+        schema = 'fixer';
+    else if (selfReviewerSection)
+        schema = 'self-reviewer';
+    else if (fixNEntries.length > 0)
+        schema = 'fix-n';
+    else
+        schema = 'fixer';
     return { exists: true, fixes, skipped, schema };
 }
 /**
@@ -231,6 +246,71 @@ function parseFixEntries(section) {
     }
     return entries;
 }
+/**
+ * FRAMEWORK-BUG-035 — parse `## Fix N` top-level blocks into entries shaped
+ * like `parseFixEntries` output. The bug narrative documents `## Fix N`
+ * as the canonical shape going forward for fixes-applied-fixer-N.md, but
+ * the legacy `### {ID} — title` parser silently dropped every entry on
+ * those reports, surfacing `<none parsed>` and false-positive flipping
+ * the gate to `hallucinated`.
+ *
+ * This parser scans the WHOLE document (not a `## Fixes Applied` body)
+ * because the new shape uses `## Fix N` directly as top-level headers.
+ * Finding-ID extraction priority chain (per spec ID-04):
+ *   1. `- **Finding ID**:` field line
+ *   2. `- **Fix**:`        field line
+ *   3. `- **ID**:`         field line
+ *   4. synthetic `fix-N`   fallback (matches `parseSelfReviewerFixEntries`'s
+ *      `self-reviewer-fix-N` convention; the diff-intersect step in
+ *      `decideVerdict` is the real check, not the id)
+ *
+ * Returns the same `{id, title, file, files, verification}` shape as
+ * `parseFixEntries` so downstream consumers see a uniform array.
+ */
+function parseFixNEntries(markdown) {
+    if (!markdown)
+        return [];
+    const entries = [];
+    // `^## Fix N$` — top-level heading with the literal word "Fix" + a
+    // number. No trailing description in the header (the canonical shape
+    // per the BUG-034 narrative puts the description inside the body).
+    const headerRx = /^##\s+Fix\s+(\d+)\s*$/gm;
+    const matches = [...markdown.matchAll(headerRx)];
+    for (let i = 0; i < matches.length; i++) {
+        const m = matches[i];
+        const start = m.index + m[0].length;
+        // Terminate at the next top-level `## ` heading OR EOF. Mirrors
+        // `extractTopLevelSection`'s body slicing.
+        const rest = markdown.slice(start);
+        const nextTopRx = /\n##\s+/m;
+        const nxt = nextTopRx.exec(rest);
+        const body = (nxt ? rest.slice(0, nxt.index) : rest).trim();
+        const findingId = extractFindingIdField(body) ?? `fix-${m[1]}`;
+        const files = extractFileFields(body);
+        entries.push({
+            id: findingId,
+            title: null,
+            file: files[0] ?? null,
+            files,
+            verification: extractVerificationField(body),
+        });
+    }
+    return entries;
+}
+/**
+ * Extract the finding ID from a `## Fix N` block body via the priority
+ * chain documented in `parseFixNEntries`. Returns `null` if no field
+ * matched — caller falls back to the synthetic `fix-N` id.
+ */
+function extractFindingIdField(body) {
+    for (const key of ['Finding ID', 'Fix', 'ID']) {
+        const rx = new RegExp(`-\\s*\\*\\*${key}\\*\\*:\\s*([^\\n]+)`, 'i');
+        const m = rx.exec(body);
+        if (m)
+            return m[1].trim();
+    }
+    return null;
+}
 function parseSkippedEntries(section) {
     if (!section)
         return [];