peaks-loop 3.1.2 → 4.0.0-beta.2

package/dist/src/services/adapter/adapter.d.ts

@@ -0,0 +1,27 @@
+export interface AdapterSegment {
+    name: string;
+    skillMd: string;
+    scripts: {
+        name: string;
+        content: string;
+    }[];
+}
+export interface AdapterEnvelope {
+    preamble: string;
+    refs: {
+        path: string;
+        kind: "file" | "dir" | "script";
+    }[];
+}
+export interface Adapter {
+    readonly name: "claude" | "codex" | "copilot" | "auto";
+    resolveScratchDir(beeName: string): Promise<string>;
+    materialize(beeName: string, env: AdapterEnvelope, segments: AdapterSegment[]): Promise<string>;
+    publish(scratchDir: string): Promise<string>;
+    activate(scratchDir: string): Promise<void>;
+    cleanup(scratchDir: string): Promise<void>;
+    detect(): Promise<boolean>;
+}
+export declare class ADAPTER_NOT_IMPLEMENTED extends Error {
+    constructor(adapter: string, method: string);
+}

package/dist/src/services/adapter/adapter.js

@@ -0,0 +1,5 @@
+export class ADAPTER_NOT_IMPLEMENTED extends Error {
+    constructor(adapter, method) {
+        super(`ADAPTER_NOT_IMPLEMENTED: ${adapter}.${method} — stub until later slice`);
+    }
+}

package/dist/src/services/adapter/auto-adapter.d.ts

@@ -0,0 +1,11 @@
+import { Adapter } from "./adapter.js";
+type Detectable = Pick<Adapter, "name" | "detect">;
+export declare class AutoAdapter {
+    private readonly _o;
+    private readonly _adapters;
+    constructor(_o: {
+        home: string;
+    }, _adapters: Detectable[]);
+    detectAndPick(): Promise<Detectable>;
+}
+export {};

package/dist/src/services/adapter/auto-adapter.js

@@ -0,0 +1,15 @@
+export class AutoAdapter {
+    _o;
+    _adapters;
+    constructor(_o, _adapters) {
+        this._o = _o;
+        this._adapters = _adapters;
+    }
+    async detectAndPick() {
+        for (const a of this._adapters) {
+            if (await a.detect())
+                return a;
+        }
+        throw new Error("No adapter detected. Use `peaks skill adapter set-active <name>` to force one.");
+    }
+}

package/dist/src/services/adapter/claude-adapter.d.ts

@@ -0,0 +1,14 @@
+import { Adapter, AdapterEnvelope, AdapterSegment } from "./adapter.js";
+export declare class ClaudeAdapter implements Adapter {
+    private readonly opts;
+    readonly name: "claude";
+    constructor(opts: {
+        home: string;
+    });
+    detect(): Promise<boolean>;
+    resolveScratchDir(beeName: string): Promise<string>;
+    materialize(beeName: string, env: AdapterEnvelope, segments: AdapterSegment[]): Promise<string>;
+    publish(scratchDir: string): Promise<string>;
+    activate(_scratchDir: string): Promise<void>;
+    cleanup(scratchDir: string): Promise<void>;
+}

package/dist/src/services/adapter/claude-adapter.js

@@ -0,0 +1,40 @@
+import { writeFileSync, mkdirSync, rmSync, existsSync } from "node:fs";
+import { join } from "node:path";
+export class ClaudeAdapter {
+    opts;
+    name = "claude";
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async detect() {
+        return true; /* Claude is the default; ship this slice first */
+    }
+    async resolveScratchDir(beeName) {
+        return join(this.opts.home, ".claude", "skills", `peaks-bee-${beeName}.peaks-generated`);
+    }
+    async materialize(beeName, env, segments) {
+        const dir = await this.resolveScratchDir(beeName);
+        if (existsSync(dir))
+            rmSync(dir, { recursive: true, force: true });
+        mkdirSync(dir, { recursive: true });
+        const frontmatter = `---\nname: peaks-bee-${beeName}\ndescription: peaks-loop generated bee ${beeName} — see local SkillHub for source\n---\n\n`;
+        const body = `${env.preamble}\n\n` + segments.map((s) => s.skillMd).join("\n\n");
+        writeFileSync(join(dir, "SKILL.md"), frontmatter + body);
+        mkdirSync(join(dir, "scripts"), { recursive: true });
+        for (const s of segments) {
+            for (const sc of s.scripts)
+                writeFileSync(join(dir, "scripts", sc.name), sc.content);
+        }
+        return dir;
+    }
+    async publish(scratchDir) {
+        return scratchDir;
+    }
+    async activate(_scratchDir) {
+        /* no-op; runtime picks up by convention */
+    }
+    async cleanup(scratchDir) {
+        if (existsSync(scratchDir))
+            rmSync(scratchDir, { recursive: true, force: true });
+    }
+}

package/dist/src/services/adapter/codex-adapter.d.ts

@@ -0,0 +1,14 @@
+import { Adapter } from "./adapter.js";
+export declare class CodexAdapter implements Pick<Adapter, "name"> {
+    private readonly _o;
+    readonly name: "codex";
+    constructor(_o: {
+        home: string;
+    });
+    detect(): Promise<boolean>;
+    resolveScratchDir(): Promise<void>;
+    materialize(): Promise<void>;
+    publish(): Promise<void>;
+    activate(): Promise<void>;
+    cleanup(): Promise<void>;
+}

package/dist/src/services/adapter/codex-adapter.js

@@ -0,0 +1,14 @@
+import { ADAPTER_NOT_IMPLEMENTED } from "./adapter.js";
+export class CodexAdapter {
+    _o;
+    name = "codex";
+    constructor(_o) {
+        this._o = _o;
+    }
+    async detect() { return false; }
+    async resolveScratchDir() { throw new ADAPTER_NOT_IMPLEMENTED("codex", "resolveScratchDir"); }
+    async materialize() { throw new ADAPTER_NOT_IMPLEMENTED("codex", "materialize"); }
+    async publish() { throw new ADAPTER_NOT_IMPLEMENTED("codex", "publish"); }
+    async activate() { throw new ADAPTER_NOT_IMPLEMENTED("codex", "activate"); }
+    async cleanup() { throw new ADAPTER_NOT_IMPLEMENTED("codex", "cleanup"); }
+}

package/dist/src/services/adapter/copilot-adapter.d.ts

@@ -0,0 +1,14 @@
+import { Adapter } from "./adapter.js";
+export declare class CopilotAdapter implements Pick<Adapter, "name"> {
+    private readonly _o;
+    readonly name: "copilot";
+    constructor(_o: {
+        home: string;
+    });
+    detect(): Promise<boolean>;
+    resolveScratchDir(): Promise<void>;
+    materialize(): Promise<void>;
+    publish(): Promise<void>;
+    activate(): Promise<void>;
+    cleanup(): Promise<void>;
+}

package/dist/src/services/adapter/copilot-adapter.js

@@ -0,0 +1,14 @@
+import { ADAPTER_NOT_IMPLEMENTED } from "./adapter.js";
+export class CopilotAdapter {
+    _o;
+    name = "copilot";
+    constructor(_o) {
+        this._o = _o;
+    }
+    async detect() { return false; }
+    async resolveScratchDir() { throw new ADAPTER_NOT_IMPLEMENTED("copilot", "resolveScratchDir"); }
+    async materialize() { throw new ADAPTER_NOT_IMPLEMENTED("copilot", "materialize"); }
+    async publish() { throw new ADAPTER_NOT_IMPLEMENTED("copilot", "publish"); }
+    async activate() { throw new ADAPTER_NOT_IMPLEMENTED("copilot", "activate"); }
+    async cleanup() { throw new ADAPTER_NOT_IMPLEMENTED("copilot", "cleanup"); }
+}

package/dist/src/services/artifacts/repair-cycle-service.js

@@ -1,6 +1,6 @@
 import { showRequestArtifact } from './request-artifact-service.js';
 const DEFAULT_MAX_CYCLES = 3;
-// Matches transition notes Solo writes during repair routing.
+// Matches transition notes Code writes during repair routing.
 // Format example:
 //   - transition note (2026-05-25T08:00:00.000Z): QA return-to-rd cycle 1: failing acceptance items A, B
 //   - transition note (2026-05-25T09:00:00.000Z): QA cycle 2: regression in module X

package/dist/src/services/audit/enforcers/active-skill-resolver.d.ts

@@ -2,7 +2,7 @@
  * active-skill-resolver — utility for hook enforcers.
  *
  * Resolves the active peak skill name for the current session, so hook
- * enforcers (e.g. solo-code-ban) can decide whether to fire.
+ * enforcers (e.g. code-ban) can decide whether to fire.
  *
  * Per `src/services/session/caller-id-types.ts`: the active-skill file is
  * at `.peaks/_runtime/<peakSessionId>/active-skill-<callerId>.json`.

package/dist/src/services/audit/enforcers/active-skill-resolver.js

@@ -2,7 +2,7 @@
  * active-skill-resolver — utility for hook enforcers.
  *
  * Resolves the active peak skill name for the current session, so hook
- * enforcers (e.g. solo-code-ban) can decide whether to fire.
+ * enforcers (e.g. code-ban) can decide whether to fire.
  *
  * Per `src/services/session/caller-id-types.ts`: the active-skill file is
  * at `.peaks/_runtime/<peakSessionId>/active-skill-<callerId>.json`.

package/dist/src/services/audit/enforcers/{solo-code-ban.d.ts → code-ban.d.ts}

@@ -1,8 +1,8 @@
 /**
- * Solo-code-ban enforcer — PreToolUse Bash guard.
+ * Code-commit-ban enforcer — PreToolUse Bash guard.
  *
  * Per L2 redesign §5.4. Deny `git commit` or `git apply` invocations from
- * a peaks-* skill. The Solo Code-Change Red Line says peaks-solo / peaks-rd
+ * a peaks-* skill. The Code Commit Ban Red Line says peaks-code / peaks-rd
  * are orchestrators, not implementers; the actual `git commit` step must
  * go through `peaks request transition`, which itself enforces spec-locked
  * + tech-doc-presence.
@@ -11,13 +11,13 @@
  * manifest read fails, the hook must fail-OPEN (warn + allow). The LLM is
  * never bricked by a peaks bug.
  */
-export interface SoloCodeBanInput {
+export interface CodeBanInput {
     readonly skill: string;
     readonly command: string;
 }
-export interface SoloCodeBanResult {
+export interface CodeBanResult {
     readonly denied: boolean;
     readonly reason: string;
 }
-export declare function isSoloCodeCommit(skill: string, command: string): boolean;
-export declare function evaluateSoloCodeBan(input: SoloCodeBanInput): SoloCodeBanResult;
+export declare function isCodeCommit(skill: string, command: string): boolean;
+export declare function evaluateCodeBan(input: CodeBanInput): CodeBanResult;

package/dist/src/services/audit/enforcers/{solo-code-ban.js → code-ban.js}

@@ -1,8 +1,8 @@
 /**
- * Solo-code-ban enforcer — PreToolUse Bash guard.
+ * Code-commit-ban enforcer — PreToolUse Bash guard.
  *
  * Per L2 redesign §5.4. Deny `git commit` or `git apply` invocations from
- * a peaks-* skill. The Solo Code-Change Red Line says peaks-solo / peaks-rd
+ * a peaks-* skill. The Code Commit Ban Red Line says peaks-code / peaks-rd
  * are orchestrators, not implementers; the actual `git commit` step must
  * go through `peaks request transition`, which itself enforces spec-locked
  * + tech-doc-presence.
@@ -12,15 +12,15 @@
  * never bricked by a peaks bug.
  */
 const COMMIT_APPLY_PATTERN = /^\s*git\s+(commit|apply)\b/;
-const DENY_REASON = 'Solo Code-Change Red Line: peaks-* skills must go through peaks-solo / peaks-rd. ' +
+const DENY_REASON = 'Code Commit Ban Red Line: peaks-* skills must go through peaks-code / peaks-rd. ' +
     'Use `peaks request transition` instead of `git commit` / `git apply` directly.';
-export function isSoloCodeCommit(skill, command) {
+export function isCodeCommit(skill, command) {
     if (!skill.startsWith('peaks-'))
         return false;
     return COMMIT_APPLY_PATTERN.test(command);
 }
-export function evaluateSoloCodeBan(input) {
-    if (isSoloCodeCommit(input.skill, input.command)) {
+export function evaluateCodeBan(input) {
+    if (isCodeCommit(input.skill, input.command)) {
         return { denied: true, reason: DENY_REASON };
     }
     return { denied: false, reason: '' };

package/dist/src/services/audit/red-line-catalog.d.ts

@@ -7,7 +7,7 @@
  */
 import type { RedLineMarker } from './types.js';
 export interface RedLineCatalogEntry {
-    /** Stable id, e.g. "rl-solo-code-ban-001". */
+    /** Stable id, e.g. "rl-code-ban-001". */
     readonly id: string;
     readonly rule: string;
     /** Markers that, if found near the rule's text, identify this red line. */
@@ -26,7 +26,7 @@ export declare const RED_LINE_CATALOG: readonly RedLineCatalogEntry[];
  * the integration seam is missing. When the integration lands, the entry
  * is removed from this set in a single-line follow-up commit.
  *
- * L2.1 final state: Tasks 5 (solo-code-ban) + 6 (no-root-pollution) are
+ * L2.1 final state: Tasks 5 (code-ban) + 6 (no-root-pollution) are
  * wired into peaks hook handle (Tasks 1-4: framework + 3 enforcers also
  * integrated). Tasks 3 (tech-doc-presence) and 4 (mock-placement) are
  * deferred — their request-transition / slice-check integrations are

package/dist/src/services/audit/red-line-catalog.js

@@ -9,15 +9,15 @@ import { RED_LINE_CATALOG_P2_A } from './red-line-catalog-p2-a.js';
 import { RED_LINE_CATALOG_P2_B } from './red-line-catalog-p2-b.js';
 export const RED_LINE_CATALOG = [
     {
-        id: 'rl-solo-code-ban-001',
-        rule: 'Solo Code-Change Red Line',
+        id: 'rl-code-ban-001',
+        rule: 'Code Commit Ban',
         markers: ['BLOCKING', 'MANDATORY'],
         phrases: [
-            'peaks-solo',
+            'peaks-code',
             'orchestrator, NOT an implementer',
-            'solo',
+            'code',
         ],
-        enforcerRef: 'src/services/audit/enforcers/solo-code-ban.ts',
+        enforcerRef: 'src/services/audit/enforcers/code-ban.ts',
     },
     {
         id: 'rl-no-root-pollution-001',
@@ -146,7 +146,7 @@ export const RED_LINE_CATALOG = [
  * the integration seam is missing. When the integration lands, the entry
  * is removed from this set in a single-line follow-up commit.
  *
- * L2.1 final state: Tasks 5 (solo-code-ban) + 6 (no-root-pollution) are
+ * L2.1 final state: Tasks 5 (code-ban) + 6 (no-root-pollution) are
  * wired into peaks hook handle (Tasks 1-4: framework + 3 enforcers also
  * integrated). Tasks 3 (tech-doc-presence) and 4 (mock-placement) are
  * deferred — their request-transition / slice-check integrations are

package/dist/src/services/audit/scanners/skills-tree-scanner.js

@@ -39,6 +39,28 @@ export function scanSkillsTree(input) {
     for (const entry of entries) {
         if (!entry.isDirectory() || entry.name.startsWith('.'))
             continue;
+        // LLM-internal skills live under `skills/bee/<name>/` per spec 2026-07-05.
+        // Recurse one level into `bee/` to cover all 9 demoted role/audit skills.
+        if (entry.name === 'bee') {
+            let subEntries;
+            try {
+                subEntries = readdirSync(join(skillsRoot, 'bee'), { withFileTypes: true });
+            }
+            catch (error) {
+                warnings.push({
+                    file: 'skills/bee',
+                    message: `readdir failed: ${error instanceof Error ? error.message : String(error)}`,
+                });
+                continue;
+            }
+            for (const subEntry of subEntries) {
+                if (!subEntry.isDirectory() || subEntry.name.startsWith('.'))
+                    continue;
+                const skillMd = readSkillFile(input.projectRoot, join('bee', subEntry.name), 'SKILL.md');
+                lines.push(...skillMd);
+            }
+            continue;
+        }
         const skillMd = readSkillFile(input.projectRoot, entry.name, 'SKILL.md');
         lines.push(...skillMd);
     }

package/dist/src/services/audit/types.d.ts

@@ -21,9 +21,9 @@ export interface RedLineSource {
     readonly context: string;
 }
 export interface RedLineEntry {
-    /** Stable id, e.g. "rl-solo-code-ban-001". */
+    /** Stable id, e.g. "rl-code-ban-001". */
     readonly id: string;
-    /** Human-readable rule name, e.g. "Solo Code-Change Red Line". */
+    /** Human-readable rule name, e.g. "Code Commit Ban". */
     readonly rule: string;
     readonly source: RedLineSource;
     readonly backing: RedLineBacking;

package/dist/src/services/{solo → code}/auto-compact-orchestrator.d.ts

@@ -20,9 +20,9 @@ export interface AutoCompactInput {
     /** Injectable clock for mtime checks (test seam). */
     readonly now?: Date | undefined;
     /**
-     * Slice 2026-06-28-solo-mode-bypass-fix (defect #4): which session
+     * Slice 2026-06-28-code-mode-bypass-fix (defect #4): which session
      * the compact should target. Default `'main'` — the orchestrator
-     * (peaks-solo body) runs in the main-session Claude Code window and
+     * (peaks-code body) runs in the main-session Claude Code window and
      * wants to compress *its* context. Sub-agent shells pass
      * `'sub-agent'` to preserve the legacy shell-spawn behaviour.
      */

package/dist/src/services/{solo → code}/auto-compact-orchestrator.js

@@ -16,7 +16,7 @@
  *   3. If 0.85 ≤ ratio < 0.95 (pre-compact zone): peaks-loop prepares
  *      the convergence toolkit (checkpoint + auto-decisions log +
  *      IDE-dispatch handle) and surfaces it to the LLM. The LLM
- *      DECIDES when to fire `peaks solo auto-compact --execute`;
+ *      DECIDES when to fire `peaks code auto-compact --execute`;
  *      peaks-loop does NOT auto-fire. The toolkit is ready so the
  *      LLM doesn't lose context to a last-second `/compact` panic.
  *   4. If ratio < 0.85: skip — return a one-line info row.
@@ -64,7 +64,7 @@ export function evaluateCompactTrigger(ratio) {
         kind: 'pre-compact',
         ratio,
         toolkitReady: true,
-        message: `Context at ${(ratio * 100).toFixed(1)}% in pre-compact zone (0.85–0.95). Convergence toolkit is ready; LLM decides when to fire \`peaks solo auto-compact --execute\`.`
+        message: `Context at ${(ratio * 100).toFixed(1)}% in pre-compact zone (0.85–0.95). Convergence toolkit is ready; LLM decides when to fire \`peaks code auto-compact --execute\`.`
     };
 }
 /**
@@ -139,14 +139,14 @@ function appendAutoDecisionLog(input) {
         ''
     ].join('\n');
     if (!existsSync(logPath)) {
-        writeFileSync(logPath, `# peaks-solo auto-decisions log\n${row}`, 'utf8');
+        writeFileSync(logPath, `# peaks-code auto-decisions log\n${row}`, 'utf8');
         return;
     }
     const existing = readFileSync(logPath, 'utf8');
     writeFileSync(logPath, `${existing}${row}`, 'utf8');
 }
 /**
- * Slice 2026-06-28-solo-mode-bypass-fix (defect #4): write the
+ * Slice 2026-06-28-code-mode-bypass-fix (defect #4): write the
  * main-session compact intent so the main-session LLM picks it up on
  * its next turn and fires `/compact` in-band. Without this file the
  * orchestrator's "main-session compact" request is invisible to the
@@ -200,7 +200,7 @@ function writePreCompactCheckpoint(input) {
         recentDecisions: [],
         recentArtifactPaths: [],
         gitStatus: '',
-        skillsActive: ['peaks-solo'],
+        skillsActive: ['peaks-code'],
         todoState: []
     };
     writeFileSync(path, JSON.stringify(content, null, 2), 'utf8');

package/dist/src/services/{solo → code}/dag-orchestrator.d.ts

@@ -8,7 +8,7 @@
  * Design:
  *  - **Pure dispatcher contract**: the orchestrator never calls an LLM
  *    directly; it returns `DispatchSpec[]` per topological level and lets
- *    the caller (the CLI / peaks-solo LLM) execute the per-IDE tool calls.
+ *    the caller (the CLI / peaks-code LLM) execute the per-IDE tool calls.
  *    This keeps the orchestrator testable end-to-end with mock sub-agents.
  *  - **Join barrier**: between levels, the orchestrator awaits the
  *    results of all dispatched leaves and refuses to advance if any
@@ -20,8 +20,8 @@
  *    orchestrator writes its public contract to disk via `writeContract`,
  *    and the next dispatch's prompt is built with `formatContractInjection`.
  *
- * Why this lives in `services/solo/`:
- *  `peaks-solo` is the natural caller. The CLI surface (`peaks sub-agent
+ * Why this lives in `services/code/`:
+ *  `peaks-code` is the natural caller. The CLI surface (`peaks sub-agent
  *  dispatch --from-dag`) consumes the planner's output but the planner
  *  itself is a library.
  */
@@ -123,6 +123,6 @@ export declare function runDag(dag: SliceDag, opts: RunDagOptions): Promise<DagR
  *      cancels in-flight siblings and breaks the loop.
  *
  * Pure planner; same I/O contract as `runDag`. The caller (CLI /
- * peaks-solo LLM) executes the per-IDE tool calls.
+ * peaks-code LLM) executes the per-IDE tool calls.
  */
 export declare function runLayeredDag(dag: SliceDag, opts: RunDagOptions): Promise<DagRunResult>;

package/dist/src/services/{solo → code}/dag-orchestrator.js

@@ -8,7 +8,7 @@
  * Design:
  *  - **Pure dispatcher contract**: the orchestrator never calls an LLM
  *    directly; it returns `DispatchSpec[]` per topological level and lets
- *    the caller (the CLI / peaks-solo LLM) execute the per-IDE tool calls.
+ *    the caller (the CLI / peaks-code LLM) execute the per-IDE tool calls.
  *    This keeps the orchestrator testable end-to-end with mock sub-agents.
  *  - **Join barrier**: between levels, the orchestrator awaits the
  *    results of all dispatched leaves and refuses to advance if any
@@ -20,8 +20,8 @@
  *    orchestrator writes its public contract to disk via `writeContract`,
  *    and the next dispatch's prompt is built with `formatContractInjection`.
  *
- * Why this lives in `services/solo/`:
- *  `peaks-solo` is the natural caller. The CLI surface (`peaks sub-agent
+ * Why this lives in `services/code/`:
+ *  `peaks-code` is the natural caller. The CLI surface (`peaks sub-agent
  *  dispatch --from-dag`) consumes the planner's output but the planner
  *  itself is a library.
  */
@@ -110,7 +110,7 @@ export function buildDispatchSpec(dag, sliceId, contracts, defaultPrompt) {
         'Handoff protocol (REQUIRED — orchestrator depends on this):',
         '  1. Execute the slice to completion.',
         `  2. Write your public contract via \`peaks contract write --project <root> --session-id <sid> --slice-id ${sliceId} --exports <...> --types <...> --signatures <...>\`. The orchestrator will pick it up on the next dispatch run.`,
-        '  3. Do NOT re-invoke `peaks sub-agent dispatch --from-dag` yourself — the parent orchestrator (peaks-solo) drives level advancement.',
+        '  3. Do NOT re-invoke `peaks sub-agent dispatch --from-dag` yourself — the parent orchestrator (peaks-code) drives level advancement.',
         '',
         `After your contract is on disk, the orchestrator will auto-advance to the next topological level (if any) by re-invoking \`peaks sub-agent dispatch --from-dag\` with the same batch-id. Your slice will appear in its ancestors via \`formatContractInjection\`.${ancestorFragment}`
     ].join('\n');
@@ -214,7 +214,7 @@ export async function runDag(dag, opts) {
  *      cancels in-flight siblings and breaks the loop.
  *
  * Pure planner; same I/O contract as `runDag`. The caller (CLI /
- * peaks-solo LLM) executes the per-IDE tool calls.
+ * peaks-code LLM) executes the per-IDE tool calls.
  */
 export async function runLayeredDag(dag, opts) {
     try {

package/dist/src/services/{solo → code}/emit-handoff.d.ts

@@ -16,7 +16,7 @@
  *     --force-under-job                            → ALLOW (override path)
  *
  * Karpathy §2 (Simplicity First): ~70 lines, no LLM call, no regex.
- * Pure read + arithmetic. The CLI wrapper in solo-commands.ts
+ * Pure read + arithmetic. The CLI wrapper in code-commands.ts
  * translates the verdict into exit code + JSON envelope.
  */
 export declare const JOB_NOT_INITIALIZED: "JOB_NOT_INITIALIZED";

package/dist/src/services/{solo → code}/emit-handoff.js

@@ -16,7 +16,7 @@
  *     --force-under-job                            → ALLOW (override path)
  *
  * Karpathy §2 (Simplicity First): ~70 lines, no LLM call, no regex.
- * Pure read + arithmetic. The CLI wrapper in solo-commands.ts
+ * Pure read + arithmetic. The CLI wrapper in code-commands.ts
  * translates the verdict into exit code + JSON envelope.
  */
 import { existsSync, readFileSync } from 'node:fs';

package/dist/src/services/{solo → code}/job-shape-decision.d.ts

@@ -3,7 +3,7 @@
  *
  * The CLI is a *recorder and gate*, not a judge. The LLM makes the
  * semantic call ("is this a Job?") and writes the verdict via
- * `peaks solo detect-job`; this service persists the verdict to
+ * `peaks code detect-job`; this service persists the verdict to
  * `.peaks/_runtime/<sessionId>/job-shape.json` and refuses downstream
  * steps that need a decision when the file is missing.
  *

package/dist/src/services/{solo → code}/job-shape-decision.js

@@ -3,7 +3,7 @@
  *
  * The CLI is a *recorder and gate*, not a judge. The LLM makes the
  * semantic call ("is this a Job?") and writes the verdict via
- * `peaks solo detect-job`; this service persists the verdict to
+ * `peaks code detect-job`; this service persists the verdict to
  * `.peaks/_runtime/<sessionId>/job-shape.json` and refuses downstream
  * steps that need a decision when the file is missing.
  *
@@ -73,7 +73,7 @@ export function readJobShapeDecision(projectRoot, sessionId) {
     if (!existsSync(path)) {
         throw new JobShapeDecisionError({
             code: JOB_SHAPE_NOT_DECIDED,
-            message: `No Job-shape decision recorded for session ${sessionId}. Run \`peaks solo detect-job\` to record a decision.`,
+            message: `No Job-shape decision recorded for session ${sessionId}. Run \`peaks code detect-job\` to record a decision.`,
             details: { path }
         });
     }
@@ -84,7 +84,7 @@ export function readJobShapeDecision(projectRoot, sessionId) {
     catch (err) {
         throw new JobShapeDecisionError({
             code: JOB_SHAPE_NOT_DECIDED,
-            message: `Job-shape decision file is unreadable for session ${sessionId}. Run \`peaks solo detect-job\` to re-record.`,
+            message: `Job-shape decision file is unreadable for session ${sessionId}. Run \`peaks code detect-job\` to re-record.`,
             details: { path, cause: err instanceof Error ? err.message : String(err) }
         });
     }
@@ -95,7 +95,7 @@ export function readJobShapeDecision(projectRoot, sessionId) {
     catch (err) {
         throw new JobShapeDecisionError({
             code: JOB_SHAPE_NOT_DECIDED,
-            message: `Job-shape decision file is malformed JSON for session ${sessionId}. Run \`peaks solo detect-job --force\` to overwrite.`,
+            message: `Job-shape decision file is malformed JSON for session ${sessionId}. Run \`peaks code detect-job --force\` to overwrite.`,
             details: { path, cause: err instanceof Error ? err.message : String(err) }
         });
     }
@@ -105,7 +105,7 @@ export function readJobShapeDecision(projectRoot, sessionId) {
     catch (err) {
         throw new JobShapeDecisionError({
             code: JOB_SHAPE_NOT_DECIDED,
-            message: `Job-shape decision file is schema-invalid for session ${sessionId}. Run \`peaks solo detect-job --force\` to overwrite.`,
+            message: `Job-shape decision file is schema-invalid for session ${sessionId}. Run \`peaks code detect-job --force\` to overwrite.`,
             details: { path, cause: err instanceof Error ? err.message : String(err) }
         });
     }

package/dist/src/services/{solo → code}/mode-gate.d.ts

@@ -20,8 +20,8 @@
  * 4 mode values stay in lockstep with the rest of the runtime.
  */
 import type { SkillPresenceMode } from '../skills/skill-presence-service.js';
-export type SoloMode = SkillPresenceMode;
-export declare const SOLO_MODES: readonly SoloMode[];
+export type CodeMode = SkillPresenceMode;
+export declare const CODE_MODES: readonly CodeMode[];
 export type HardFloorCategory = 'irreversible-external-side-effect' | 'authentication-credential' | 'multi-day-investment'
 /**
  * v2.15.0 slice 002 AC-4: actions that are past the user's
@@ -42,8 +42,8 @@ export declare const HARD_FLOOR_CATEGORIES: readonly HardFloorCategory[];
 export type GatedStepId = 'step-0.5-openspec-opt-in' | 'step-0.6-audit-goal' | 'step-0.7-resume-detection' | 'step-0.55-1x-upgrade' | 'step-1-mode-select' | 'step-2.5-session-title' | 'phase-2-prd-confirm' | 'phase-3-swarm-gate-b' | 'phase-6-qa-gate-d' | 'phase-10-txt-memory-extract' | 'step-n+1-final-review' | 'frontend-only-mismatch' | 'step-0.75-checkpoint-resume' | 'standards-preflight';
 export declare const GATED_STEPS: readonly GatedStepId[];
 /**
- * Slice 2026-06-28-solo-mode-bypass-fix: the kind of gate that
- * produced this decision. The LLM-side caller (peaks-solo body) reads
+ * Slice 2026-06-28-code-mode-bypass-fix: the kind of gate that
+ * produced this decision. The LLM-side caller (peaks-code body) reads
  * this to distinguish "you paused because the user must choose the
  * mode" (`mode-selection-itself`) from "you paused because the mode
  * you already chose is assisted/strict" (`mode-driven`) from "you
@@ -63,23 +63,23 @@ export declare const GATED_STEPS: readonly GatedStepId[];
 export type GateKind = 'mode-selection-itself' | 'mode-driven' | 'hard-floor';
 export interface GateDecision {
     readonly shouldPause: boolean;
-    /** Human-readable rationale; surfaces in `peaks solo should-pause --json` */
+    /** Human-readable rationale; surfaces in `peaks code should-pause --json` */
     readonly reason: string;
     /** Hard-floor override applied? Surfaces in audit log when true */
     readonly hardFloorCategory?: HardFloorCategory;
-    /** Slice 2026-06-28-solo-mode-bypass-fix: kind of gate that produced
+    /** Slice 2026-06-28-code-mode-bypass-fix: kind of gate that produced
      * this decision. Always present; defaults to `'mode-driven'` for the
      * assisted/strict pause branch. */
     readonly gateKind: GateKind;
 }
-export declare function isSoloMode(value: string): value is SoloMode;
+export declare function isCodeMode(value: string): value is CodeMode;
 export declare function isHardFloorCategory(value: string): value is HardFloorCategory;
 /**
  * `true` when the current mode should auto-proceed (skip the
  * AskUserQuestion round-trip). Mirrors D5.a: "recommended = chosen
  * in full-auto / swarm; always log, never silently skip".
  */
-export declare function shouldAutoProceed(mode: SoloMode): boolean;
+export declare function shouldAutoProceed(mode: CodeMode): boolean;
 /**
  * Should the LLM emit an AskUserQuestion at `step` given `mode`?
  * Pure function: no IO, no LLM call. The LLM-side caller passes the
@@ -98,7 +98,7 @@ export declare function shouldAutoProceed(mode: SoloMode): boolean;
 /**
  * v2.15.0 slice 002 AC-4: the 5 action identifiers that qualify as
  * commit-boundary side effects. Matched by the LLM-side caller
- * (peaks-solo body / peaks-rd fork agent) when it is about to run a
+ * (peaks-code body / peaks-rd fork agent) when it is about to run a
  * Bash command that maps to one of these. Set `commitBoundaryAction:
  * true` on the `shouldPauseAtGate` call to trigger the hard-floor
  * override.
@@ -107,7 +107,7 @@ export type CommitBoundaryActionId = 'git-push' | 'git-tag' | 'npm-publish' | 'n
 export declare const COMMIT_BOUNDARY_ACTIONS: readonly CommitBoundaryActionId[];
 export declare function isCommitBoundaryAction(value: string): value is CommitBoundaryActionId;
 export declare function shouldPauseAtGate(opts: {
-    mode: SoloMode;
+    mode: CodeMode;
     step: GatedStepId;
     hardFloorCategory?: HardFloorCategory | undefined;
     /**
@@ -125,7 +125,7 @@ export declare function shouldPauseAtGate(opts: {
  * system. The CLI / LLM is responsible for appending.
  */
 export declare function formatAutoProceedLogLine(opts: {
-    mode: SoloMode;
+    mode: CodeMode;
     step: GatedStepId;
     recommendedOption: string;
     hardFloorCategory?: HardFloorCategory | undefined;