@aperant/framework 0.7.4 → 0.8.1

package/CHANGELOG.md

@@ -5,6 +5,71 @@ All notable changes to `@aperant/framework` are documented here. See
 
 ## [Unreleased]
 
+## 0.8.1 — 2026-05-20 — Pi runtime + idempotent re-init repair
+
+Patch release making `apt-tools init` safe to rerun on another machine after
+pulling a current `.aperant/config.json`.
+
+### Fixed
+
+- Current-schema `init` no longer returns `up_to_date` when explicit runtime
+  flags were passed or when suggested runtime roots are missing
+  `apt-file-manifest.json`; it reruns the runtime installer for those roots.
+- True no-op behavior is preserved when no runtime roots are suggested and no
+  explicit runtime flags are passed.
+
+### Added
+
+- Pi is now an installable runtime via `--pi`, with files written under
+  `.pi/skills/` and `.pi/prompts/`.
+- `cliToInstallRoot('pi')` now resolves to `.pi`.
+
+### Version
+
+- `packages/framework/package.json`: 0.8.0 → 0.8.1
+- CLI golden fixtures refreshed
+
+## 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.

package/README.md

@@ -11,6 +11,12 @@
 npx @aperant/framework init .
 ```
 
+For non-interactive install or re-init across common runtimes:
+
+```bash
+npx @aperant/framework init . --claude --codex --pi --yes
+```
+
 ## Usage
 
 Just type `/apt` and describe what you want in natural language. The router classifies your input and dispatches to the right skill.
@@ -25,6 +31,12 @@ Just type `/apt` and describe what you want in natural language. The router clas
 
 You can also call any skill directly (e.g. `/apt:plan ...`, `/apt:debug ...`).
 
+Runtime command surfaces differ slightly:
+
+- Claude: `/apt:plan`
+- Codex: `/apt-plan`
+- Pi: `/apt`, `/apt:plan` via `.pi/prompts/`
+
 ## Available commands
 
 | Stage | Command | Purpose |

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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,UAAU,GAAG,gBAAgB,CAAA;AAEnC,SAAS,eAAe;IACvB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAA;IACpB,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,CAAA;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACvD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAClD,OAAO,UAAU,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,GAAG,EAAE,CAAA;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,GAAG;IACvB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,GAAG;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,SAAS;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;IAC3D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAK,EAAE,MAAM;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAA;QAC/D,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACb,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAK;IAC9B,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,IAAI,EAAE,eAAe,KAAK,iBAAiB;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS;IAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,GAAG,CACT,qGAAqG,CACrG,CAAA;IACF,CAAC;IACD,QAAQ,UAAU,EAAE,CAAC;QACpB,KAAK,SAAS,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,GAAG,CACT,mGAAmG,CACnG,CAAA;YACF,CAAC;YACD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;YAEnC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACnC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACrC,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YAE3C,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;YAC7E,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,GAAG,CAAC,sDAAsD,CAAC,CAAA;YACnE,CAAC;YACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,GAAG,CAAC,uEAAuE,CAAC,CAAA;YACpF,CAAC;YAED,IAAI,OAAO,GAAG,EAAE,CAAA;YAChB,IAAI,MAAM,GAAG,EAAE,CAAA;YACf,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;gBACzC,MAAM,GAAG,OAAO,CAAA;gBAChB,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;oBAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;wBAC1B,OAAO,GAAG,CAAC,gCAAgC,EAAE,iCAAiC,CAAC,CAAA;oBAChF,CAAC;gBACF,CAAC;YACF,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,+CAA+C,CAAC,CAAA;gBACvE,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBACpE,MAAM,GAAG,QAAQ,CAAA;YAClB,CAAC;iBAAM,CAAC;gBACP,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,kDAAkD,CAAC,CAAA;gBAC1E,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;gBACjC,MAAM,GAAG,WAAW,CAAA;YACrB,CAAC;YAED,OAAO,EAAE,CAAC;gBACT,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,iBAAiB;gBAC1B,MAAM;gBACN,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,eAAe,EAAE;aAC3B,CAAC,CAAA;QACH,CAAC;QACD;YACC,OAAO,GAAG,CAAC,+BAA+B,UAAU,sBAAsB,CAAC,CAAA;IAC7E,CAAC;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/init.mjs"],"names":[],"mappings":"AA0EA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wCAHW,MAAM,EAAE,GACN;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAmE1S;AA+wBD;;;;;;;GAOG;AACH,8CAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,WACnB,cAAc,0BAoDxB;AAoED;;;;;;GAMG;AACH,oCAJW,MAAM,cACN,MAAM,EAAE,GACN,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgM3D;;;;;cA9kCa,MAAM,EAAE;;;;qBACR,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC;;;;gBACP,MAAM,GAAC,MAAM;;;;4BACb,MAAM,EAAE;;;;aACR,OAAO;;;;mBACP,OAAO;eACP,OAAO,0BAA0B,EAAE,eAAe;;;;;;;;;aAErC,MAAM;eAAS,OAAO;cAAQ,MAAM;iBAAW,MAAM;;;;;;aAErD,MAAM;eAAS,OAAO;gBAAU,MAAM;;;;;;kBAEvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAAoB,OAAO,EAAE;2BAAqB,OAAO,EAAE;oBAAc,OAAO,EAAE"}
+{"version":3,"file":"init.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/init.mjs"],"names":[],"mappings":"AA4EA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wCAHW,MAAM,EAAE,GACN;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAmE1S;AAwzBD;;;;;;;GAOG;AACH,8CAHW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,WACnB,cAAc,0BAoDxB;AAoED;;;;;;GAMG;AACH,oCAJW,MAAM,cACN,MAAM,EAAE,GACN,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4L3D;;;;;cAnnCa,MAAM,EAAE;;;;qBACR,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC;;;;gBACP,MAAM,GAAC,MAAM;;;;4BACb,MAAM,EAAE;;;;aACR,OAAO;;;;mBACP,OAAO;eACP,OAAO,0BAA0B,EAAE,eAAe;;;;;;;;;aAErC,MAAM;eAAS,OAAO;cAAQ,MAAM;iBAAW,MAAM;;;;;;aAErD,MAAM;eAAS,OAAO;gBAAU,MAAM;;;;;;kBAEvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0BAAoB,OAAO,EAAE;2BAAqB,OAAO,EAAE;oBAAc,OAAO,EAAE"}

package/dist/cli/commands/init.mjs

@@ -3,8 +3,9 @@
  * rewrite, 2026-04).
  *
  * Replaces the previous Claude-only `cp -r` installer with the per-runtime
- * transform pipeline (src/cli/install/pipeline.mjs). All 14 runtime targets
- * supported via `--<runtime>` flags or `--all`. Default with no flags in
+ * transform pipeline (src/cli/install/pipeline.mjs). Registered runtime
+ * targets are supported via `--<runtime>` flags or `--all`. Default with no
+ * flags in
  * non-TTY mode → `--claude` (backward compat — existing skills invoke
  * `apt-tools init <dir>` with no flags). Default in TTY → interactive prompt
  * with auto-detection markers.
@@ -28,8 +29,9 @@ import { buildAperantGitignoreTemplate } from '../config/upgrade-gitignore.mjs';
 import { detectPublicRemote } from '../git/remote.mjs';
 import { detectArchetype } from '../install/archetype.mjs';
 import { installKernel } from '../install/install-kernel.mjs';
+import { MANIFEST_FILENAME } from '../install/manifest.mjs';
 import { discoverCanonicalFiles, runInstall, writeLastInstallSummary, } from '../install/pipeline.mjs';
-import { RUNTIMES, suggestRuntimes } from '../install/runtime-detect.mjs';
+import { getRuntime, RUNTIMES, suggestRuntimes } from '../install/runtime-detect.mjs';
 import { runLegacyCleanup } from '../install/runtime-migrate.mjs';
 import { CLASS_A_SETTINGS, CLASS_B_SETTINGS, findClassDescriptor, parseClassFlags, } from '../install/setting-class.mjs';
 import { detectAgentRuntime } from '../util/agent-runtime.mjs';
@@ -350,6 +352,44 @@ function selectRuntimes(targetDir, parsedFlags) {
     }
     return [...suggested];
 }
+/**
+ * Return the runtime ids that should be installed during a no-schema-drift
+ * init. A current config is not enough to prove runtime files exist on this
+ * machine: team repos often carry `.aperant/config.json` but not local
+ * runtime roots/manifests.
+ *
+ * @param {string} targetDir
+ * @param {string[]} runtimeIds
+ * @returns {string[]}
+ */
+function runtimesMissingManifest(targetDir, runtimeIds) {
+    const missing = [];
+    for (const id of runtimeIds) {
+        const runtime = getRuntime(id);
+        if (!runtime)
+            continue;
+        const manifestPath = join(targetDir, runtime.installRoot, MANIFEST_FILENAME);
+        if (!existsSync(manifestPath))
+            missing.push(id);
+    }
+    return missing;
+}
+/**
+ * Current-schema init should still run the runtime installer when the user
+ * explicitly requested runtimes, when --force-runtimes is present, or when
+ * local runtime roots are suggested but have no apt manifest.
+ *
+ * @param {string} targetDir
+ * @param {ReturnType<typeof parseInstallFlags>} parsedFlags
+ * @returns {string[]}
+ */
+function selectNoDriftRuntimeInstallIds(targetDir, parsedFlags) {
+    if (parsedFlags.forceRuntimes)
+        return selectRuntimes(targetDir, parsedFlags);
+    if (parsedFlags.runtimes_explicit)
+        return parsedFlags.runtimes;
+    return runtimesMissingManifest(targetDir, suggestRuntimes(targetDir));
+}
 /**
  * Non-TTY / scripted path — derive answers from flags + sensible defaults,
  * gated by the Class A/B classifier (spec R2 + R3).
@@ -600,11 +640,16 @@ async function interactiveInterview(targetDir, version, canonicalRoot, archetype
             migration.applied_defaults.length === 0 &&
             migration.auto_added.length === 0;
         if (noDrift) {
-            // 0.6.7 (Bug 2 fix) — `--force-runtimes` bypasses the TTY
-            // "Nothing to do." outro so the runtime walker re-stamps every
-            // manifest; cmdInit's force-runtimes synthesis path takes over.
-            if (parsedFlags.forceRuntimes) {
-                return { upgrade_noop: true, skipBootstrap, migration };
+            const runtimeInstallIds = selectNoDriftRuntimeInstallIds(targetDir, parsedFlags);
+            // Runtime repair bypasses the TTY "Nothing to do." outro so the
+            // runtime walker can re-stamp missing manifests first.
+            if (runtimeInstallIds.length > 0) {
+                return {
+                    upgrade_noop: true,
+                    skipBootstrap,
+                    migration,
+                    runtime_reinstall_runtimes: runtimeInstallIds,
+                };
             }
             process.stdout.write(`\n${aperantBanner(version)}\n\n`);
             clack.intro('install');
@@ -1058,20 +1103,19 @@ export async function cmdInit(projectDir, extraArgs = []) {
                 rerun_with: answers.rerun_with,
             }, 2);
         }
-        // Upgrade no-drift — short-circuit before installRuntimes.
-        // /apt:update is the right surface for refreshing skills on a
-        // no-drift run; init's job here is to confirm the schema is current.
+        const noDriftRuntimeInstallIds = answers?.upgrade_noop
+            ? (answers.runtime_reinstall_runtimes ??
+                selectNoDriftRuntimeInstallIds(installTarget, parsedFlags))
+            : [];
+        // Upgrade no-drift with no runtime work — short-circuit before
+        // installRuntimes. /apt:update remains the right surface for refreshing
+        // already-manifested skills; init only repairs selected or suggested
+        // runtime roots that lack manifests.
         // The bootstrap auto-chain still runs (it's deterministic and
         // idempotent — preserves PROJECT.md, refreshes sidecar from it).
         // In TTY mode clack already rendered "Nothing to do." to stdout,
         // so suppress the JSON envelope (matches the cancelled path).
-        //
-        // 0.6.7 (Bug 2 fix) — `--force-runtimes` bypasses this short-circuit
-        // so `/apt:update` can re-stamp every runtime manifest even when
-        // `.aperant/config.json` is at the current schema. We synthesize a
-        // real InstallAnswers shape from the existing config so
-        // installRuntimes + finishInit run their normal upgrade path.
-        if (answers?.upgrade_noop && !parsedFlags.forceRuntimes) {
+        if (answers?.upgrade_noop && noDriftRuntimeInstallIds.length === 0) {
             if (interactiveTty)
                 return rawText('', 0);
             const bootstrap = answers.skipBootstrap
@@ -1087,18 +1131,14 @@ export async function cmdInit(projectDir, extraArgs = []) {
                 message: `Already up to date — v${version}`,
             });
         }
-        // 0.6.7 (Bug 2 fix) — when forceRuntimes is set on a no-drift run,
-        // synthesize a real InstallAnswers shape from the existing config so
-        // the runtime walker re-stamps every manifest. Visibility/autonomy/
-        // cross-verification are read from answers.migration.migrated (already
-        // in memory from nonInteractiveAnswers — avoids a second config read);
-        // runtimes resolved via selectRuntimes helper shared with the upgrade path.
+        // Current-schema runtime install — synthesize a real InstallAnswers
+        // shape from the existing config so installRuntimes + finishInit run
+        // their normal upgrade path.
         let effectiveAnswers = answers;
-        if (answers?.upgrade_noop && parsedFlags.forceRuntimes) {
+        if (answers?.upgrade_noop && noDriftRuntimeInstallIds.length > 0) {
             const existing = answers.migration?.migrated || {};
-            const runtimes = selectRuntimes(installTarget, parsedFlags);
             effectiveAnswers = {
-                runtimes,
+                runtimes: noDriftRuntimeInstallIds,
                 autonomyDefault: existing?.autonomy?.default ?? 1,
                 visibility: existing?.share?.visibility === 'team' ? 'team' : 'solo',
                 crossVerificationTools: existing?.multi_model?.cross_verification?.tools ?? [],