peaks-loop 4.0.0-beta → 4.0.0-beta.3

package/dist/src/cli/commands/{solo-commands.js → code-commands.js}

@@ -1,19 +1,19 @@
 /**
- * Slice 2 — `peaks solo [--fast] <change-id>` (peaks-code fast mode).
+ * Slice 2 — `peaks code [--fast] <change-id>` (peaks-code fast mode).
  *
  * The `peaks-code` SKILL orchestrates an LLM-side workflow:
  *   load-memory -> standards-preflight -> rd-cycle -> qa-cycle -> emit-txt
  *
- * The CLI surface here is intentionally narrow: it builds a SoloPlan and
- * runs it via `runSoloFast`. Fast mode skips memory full-load, standards
+ * The CLI surface here is intentionally narrow: it builds a CodePlan and
+ * runs it via `runCodeFast`. Fast mode skips memory full-load, standards
  * preflight, and the QA repair loop. Round-trip KPI: ≤ 30s.
  *
- * No new service layer — the orchestrator is the in-file `runSoloFast`
+ * No new service layer — the orchestrator is the in-file `runCodeFast`
  * function. Hooks are injected so tests can mock at the boundary.
  *
  * v2.11.0 Group F (Tier 9) — D5 / D7 additions:
- *   - `peaks solo should-pause --step <step> --mode <mode>` (D5)
- *   - `peaks solo post-compact-detect --project <path>` (D7)
+ *   - `peaks code should-pause --step <step> --mode <mode>` (D5)
+ *   - `peaks code post-compact-detect --project <path>` (D7)
  */
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -21,13 +21,13 @@ import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from '../../shared/result.js';
 import { emitObservabilityEvent } from '../../services/observability/observability-service.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
-import { GATED_STEPS, isHardFloorCategory, isSoloMode, isCommitBoundaryAction, shouldPauseAtGate, formatAutoProceedLogLine } from '../../services/solo/mode-gate.js';
+import { GATED_STEPS, isHardFloorCategory, isCodeMode, isCommitBoundaryAction, shouldPauseAtGate, formatAutoProceedLogLine } from '../../services/code/mode-gate.js';
 import { getSkillPresence, checkStalePresence } from '../../services/skills/skill-presence-service.js';
-import { detectPostCompactResume, formatPostCompactResumeLogLine } from '../../services/solo/post-compact-detector.js';
-import { runAutoCompact } from '../../services/solo/auto-compact-orchestrator.js';
-import { readJobShapeDecision, writeJobShapeDecision, JobShapeDecisionError, JOB_SHAPE_NOT_DECIDED, JOB_SHAPE_ALREADY_DECIDED } from '../../services/solo/job-shape-decision.js';
-import { evaluateStep08, STEP_08_BACKUP_REGEX } from '../../services/solo/step-08-gate.js';
-import { evaluateEmitHandoff, JOB_NOT_INITIALIZED, JOB_REMAINING_BLOCKED } from '../../services/solo/emit-handoff.js';
+import { detectPostCompactResume, formatPostCompactResumeLogLine } from '../../services/code/post-compact-detector.js';
+import { runAutoCompact } from '../../services/code/auto-compact-orchestrator.js';
+import { readJobShapeDecision, writeJobShapeDecision, JobShapeDecisionError, JOB_SHAPE_NOT_DECIDED, JOB_SHAPE_ALREADY_DECIDED } from '../../services/code/job-shape-decision.js';
+import { evaluateStep08, STEP_08_BACKUP_REGEX } from '../../services/code/step-08-gate.js';
+import { evaluateEmitHandoff, JOB_NOT_INITIALIZED, JOB_REMAINING_BLOCKED } from '../../services/code/emit-handoff.js';
 const STEP_ORDER = [
     'load-memory',
     'standards-preflight',
@@ -43,10 +43,10 @@ const STEP_KIND = {
     'emit-txt': 'emit'
 };
 /**
- * Build a SoloPlan. `fast=true` marks memory + preflight as skipped and
+ * Build a CodePlan. `fast=true` marks memory + preflight as skipped and
  * disables the QA repair loop. Step order is fixed; emit-txt always last.
  */
-export function buildSoloPlan(opts) {
+export function buildCodePlan(opts) {
     const steps = STEP_ORDER.map((id) => {
         const isSkippable = id === 'load-memory' || id === 'standards-preflight';
         const step = {
@@ -62,10 +62,10 @@ export function buildSoloPlan(opts) {
     return { sessionId: opts.sessionId, steps };
 }
 /**
- * Run the SoloPlan. Skipped steps do NOT invoke their hook; emit-txt is
+ * Run the CodePlan. Skipped steps do NOT invoke their hook; emit-txt is
  * always invoked last. Returns timing + skipped ids for KPI measurement.
  */
-export async function runSoloFast(opts) {
+export async function runCodeFast(opts) {
     const start = Date.now();
     const skipped = [];
     const { sessionId, plan, hooks } = opts;
@@ -101,23 +101,23 @@ export async function runSoloFast(opts) {
     };
 }
 /**
- * Register the `peaks solo [--fast] <change-id>` command. The actual
+ * Register the `peaks code [--fast] <change-id>` command. The actual
  * LLM-side orchestration is driven by the SKILL.md (LLM-side), so this
  * CLI command is a thin surface that builds the plan and emits a JSON
  * envelope for downstream tooling.
  */
-export function registerSoloCommands(program, io) {
-    const solo = program
-        .command('solo')
+export function registerCodeCommands(program, io) {
+    const code = program
+        .command('code')
         .description('peaks-code LLM-side workflow planner (slice 2 fast mode)');
-    solo
+    code
         .command('plan')
-        .description('Build and print a SoloPlan without executing it')
+        .description('Build and print a CodePlan without executing it')
         .argument('<change-id>', 'change id to plan against')
         .option('--fast', 'fast mode: skip memory full-load, standards preflight, and QA repair loop', false)
         .option('--json', 'emit JSON envelope')
         .action((sessionId, opts) => {
-        const plan = buildSoloPlan({ sessionId, fast: opts.fast === true });
+        const plan = buildCodePlan({ sessionId, fast: opts.fast === true });
         if (opts.json === true) {
             process.stdout.write(JSON.stringify({ ok: true, data: plan }) + '\n');
         }
@@ -130,7 +130,7 @@ export function registerSoloCommands(program, io) {
             }
         }
     });
-    addJsonOption(solo
+    addJsonOption(code
         .command('should-pause')
         .description('v2.11.0 D5: ask the mode-gate whether the LLM should pause for an AskUserQuestion at a given step. ' +
         'full-auto / swarm auto-proceed (recommended = chosen); assisted / strict pause. ' +
@@ -161,19 +161,19 @@ export function registerSoloCommands(program, io) {
             // to know the mode up front. The gate's hard-pause on
             // step-1-mode-select will still pause regardless.
             const mode = opts.mode ?? 'full-auto';
-            if (!isSoloMode(mode)) {
-                printResult(io, fail('solo.should-pause', 'INVALID_MODE', `mode must be one of full-auto, assisted, swarm, strict (got "${mode}")`, { provided: mode }, ['Pass --mode full-auto | assisted | swarm | strict']), opts.json);
+            if (!isCodeMode(mode)) {
+                printResult(io, fail('code.should-pause', 'INVALID_MODE', `mode must be one of full-auto, assisted, swarm, strict (got "${mode}")`, { provided: mode }, ['Pass --mode full-auto | assisted | swarm | strict']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             if (!GATED_STEPS.includes(opts.step)) {
-                printResult(io, fail('solo.should-pause', 'INVALID_STEP', `step must be one of the 14 GATED_STEPS (got "${opts.step}")`, { provided: opts.step, allowed: [...GATED_STEPS] }, ['Pass --step <one of the 14 GATED_STEPS>']), opts.json);
+                printResult(io, fail('code.should-pause', 'INVALID_STEP', `step must be one of the 14 GATED_STEPS (got "${opts.step}")`, { provided: opts.step, allowed: [...GATED_STEPS] }, ['Pass --step <one of the 14 GATED_STEPS>']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             const hardFloor = opts.hardFloor;
             if (hardFloor !== undefined && !isHardFloorCategory(hardFloor)) {
-                printResult(io, fail('solo.should-pause', 'INVALID_HARD_FLOOR', `hard-floor must be one of: irreversible-external-side-effect | authentication-credential | multi-day-investment | commit-boundary-side-effect (got "${hardFloor}")`, { provided: hardFloor }, ['Omit --hard-floor or pass a valid category']), opts.json);
+                printResult(io, fail('code.should-pause', 'INVALID_HARD_FLOOR', `hard-floor must be one of: irreversible-external-side-effect | authentication-credential | multi-day-investment | commit-boundary-side-effect (got "${hardFloor}")`, { provided: hardFloor }, ['Omit --hard-floor or pass a valid category']), opts.json);
                 process.exitCode = 1;
                 return;
             }
@@ -185,7 +185,7 @@ export function registerSoloCommands(program, io) {
             // (not silently ignored) so typos fail loud.
             const commitBoundaryActionId = opts.commitBoundaryAction;
             if (commitBoundaryActionId !== undefined && !isCommitBoundaryAction(commitBoundaryActionId)) {
-                printResult(io, fail('solo.should-pause', 'INVALID_COMMIT_BOUNDARY_ACTION', `--commit-boundary-action must be one of: git-push | git-tag | npm-publish | npm-install-global | peaks-global-install (got "${commitBoundaryActionId}")`, { provided: commitBoundaryActionId }, ['Omit --commit-boundary-action or pass a valid action id']), opts.json);
+                printResult(io, fail('code.should-pause', 'INVALID_COMMIT_BOUNDARY_ACTION', `--commit-boundary-action must be one of: git-push | git-tag | npm-publish | npm-install-global | peaks-global-install (got "${commitBoundaryActionId}")`, { provided: commitBoundaryActionId }, ['Omit --commit-boundary-action or pass a valid action id']), opts.json);
                 process.exitCode = 1;
                 return;
             }
@@ -194,7 +194,7 @@ export function registerSoloCommands(program, io) {
             // Step 1 AND the recorded presence is stale, OVERRIDE the
             // gate decision to PAUSE with reason='stale-presence'. The
             // hard-pause on step-1-mode-select (defect #1 fix from
-            // 2026-06-28-solo-mode-bypass-fix) is already in effect, so
+            // 2026-06-28-code-mode-bypass-fix) is already in effect, so
             // this only adds the structured `stale` reason + an
             // envelope-level `stalePresence` field so downstream tooling
             // (statusline, sub-agent dispatch) can act on it.
@@ -225,7 +225,7 @@ export function registerSoloCommands(program, io) {
                         }
                     }, { projectRoot: opts.project ?? process.cwd() });
                 }
-                printResult(io, ok('solo.should-pause', {
+                printResult(io, ok('code.should-pause', {
                     shouldPause: true,
                     reason: `stale-presence — re-ask Step 1 (${stalePresence.reason}; recorded outer session id does not match current)`,
                     gateKind: 'mode-selection-itself',
@@ -287,7 +287,7 @@ export function registerSoloCommands(program, io) {
             // action id in the envelope (when provided) so the LLM-side
             // caller can echo which boundary was checked. Null when no
             // --commit-boundary-action flag was passed.
-            ok('solo.should-pause', {
+            ok('code.should-pause', {
                 ...decision,
                 logLine,
                 ...(commitBoundaryActionId !== undefined ? { commitBoundaryAction: commitBoundaryActionId } : {})
@@ -298,11 +298,11 @@ export function registerSoloCommands(program, io) {
             ]), opts.json);
         }
         catch (err) {
-            printResult(io, fail('solo.should-pause', 'SHOULD_PAUSE_FAILED', getErrorMessage(err), null, ['Re-run with --json for envelope shape']), opts.json);
+            printResult(io, fail('code.should-pause', 'SHOULD_PAUSE_FAILED', getErrorMessage(err), null, ['Re-run with --json for envelope shape']), opts.json);
             process.exitCode = 1;
         }
     });
-    addJsonOption(solo
+    addJsonOption(code
         .command('post-compact-detect')
         .description('v2.11.0 D7: detect whether the current invocation is a same-day post-compact resume. ' +
         'Auto-resumes (no AskUserQuestion) when the most-recent checkpoint is from today, has a mode field, ' +
@@ -313,7 +313,7 @@ export function registerSoloCommands(program, io) {
         try {
             const sessionId = opts.sessionId ?? readActiveSid(opts.project);
             if (sessionId === null) {
-                printResult(io, fail('solo.post-compact-detect', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
+                printResult(io, fail('code.post-compact-detect', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
                 process.exitCode = 1;
                 return;
             }
@@ -323,18 +323,18 @@ export function registerSoloCommands(program, io) {
                 activeSkill: opts.activeSkill
             });
             const logLine = formatPostCompactResumeLogLine(probe);
-            printResult(io, ok('solo.post-compact-detect', { ...probe, logLine }, [...probe.warnings], [
+            printResult(io, ok('code.post-compact-detect', { ...probe, logLine }, [...probe.warnings], [
                 probe.shouldAutoResume
                     ? `Post-compact match → auto-resume mode=${probe.mode ?? '?'} checkpoint=${probe.checkpointPath ?? '?'}`
                     : `No auto-resume: ${probe.reason}`
             ]), opts.json);
         }
         catch (err) {
-            printResult(io, fail('solo.post-compact-detect', 'POST_COMPACT_DETECT_FAILED', getErrorMessage(err), null, ['Verify the project path and try again']), opts.json);
+            printResult(io, fail('code.post-compact-detect', 'POST_COMPACT_DETECT_FAILED', getErrorMessage(err), null, ['Verify the project path and try again']), opts.json);
             process.exitCode = 1;
         }
     });
-    addJsonOption(solo
+    addJsonOption(code
         .command('auto-compact')
         .description('v2.13.0 AC-4: zero-human-intervention auto-compact. Probes current ' +
         'context-fill % via the active IDE adapter; ≥ 0.85 writes a pre-compact ' +
@@ -366,20 +366,20 @@ export function registerSoloCommands(program, io) {
             const data = 'data' in result ? result.data : null;
             const nextActions = 'nextActions' in result ? result.nextActions : [];
             const envelope = result.ok
-                ? ok(`solo.auto-compact`, data ?? {}, [], [result.message, ...nextActions])
-                : fail(`solo.auto-compact`, code, result.message, data, [...nextActions]);
+                ? ok(`code.auto-compact`, data ?? {}, [], [result.message, ...nextActions])
+                : fail(`code.auto-compact`, code, result.message, data, [...nextActions]);
             printResult(io, envelope, opts.json);
             if (!exitOk)
                 process.exitCode = 1;
         }
         catch (err) {
-            printResult(io, fail('solo.auto-compact', 'AUTO_COMPACT_FAILED', getErrorMessage(err), null, [
+            printResult(io, fail('code.auto-compact', 'AUTO_COMPACT_FAILED', getErrorMessage(err), null, [
                 'Verify the project path + session id and try again'
             ]), opts.json);
             process.exitCode = 1;
         }
     });
-    addJsonOption(solo
+    addJsonOption(code
         .command('context-now')
         .description('v2.13.0 AC-1: read the active IDE adapter\'s context-fill % ' +
         'without requiring the LLM to pass --prompt-size <bytes> manually. ' +
@@ -444,7 +444,7 @@ export function registerSoloCommands(program, io) {
             const jobModeNotice = isJobMode
                 ? 'Job mode enforced: ≥0.85 is MANDATORY auto-compact (v3.1.2).'
                 : 'Advisory mode (single-rid): ≥0.85 is recommended, not mandatory.';
-            printResult(io, ok('solo.context-now', {
+            printResult(io, ok('code.context-now', {
                 ratio: probe.ratio,
                 ratioPct: `${ratioPct}%`,
                 verdict,
@@ -460,7 +460,7 @@ export function registerSoloCommands(program, io) {
                 action === 'red-line'
                     ? `RED LINE: ≥ 95%. Next: \`${next}\` (PreToolUse hook fires next turn).`
                     : action === 'auto-compact-now'
-                        ? `Job-mode MANDATORY auto-compact. Solo MUST call \`${next}\` WITHOUT confirmation.`
+                        ? `Job-mode MANDATORY auto-compact. Code MUST call \`${next}\` WITHOUT confirmation.`
                         : action === 'soft-warn'
                             ? isJobMode
                                 ? `Job mode soft-warn (50–85%). Continue working; the next \`peaks context now\` will re-check.`
@@ -470,7 +470,7 @@ export function registerSoloCommands(program, io) {
             ]), true);
         }
         catch (err) {
-            printResult(io, fail('solo.context-now', 'CONTEXT_NOW_FAILED', getErrorMessage(err), null, [
+            printResult(io, fail('code.context-now', 'CONTEXT_NOW_FAILED', getErrorMessage(err), null, [
                 'Verify the project path and try again'
             ]), opts.json);
             process.exitCode = 1;
@@ -481,11 +481,11 @@ export function registerSoloCommands(program, io) {
     // (--is-job, --rationale, --suggested-job-id, --suggested-strategy,
     // --confidence); the CLI validates the shape, stamps `decidedAt`
     // server-side, and writes to `.peaks/_runtime/<sessionId>/job-shape.json`.
-    addJsonOption(solo
+    addJsonOption(code
         .command('detect-job')
         .description('v3.1.1 Step 0.8: record the LLM\'s Job-shape judgement. CLI is a recorder, NOT a detector. ' +
         'Pass --is-job true|false, --rationale <text>, --suggested-job-id <slug>. ' +
-        'Downstream steps call `peaks solo read-job-shape` and refuse to proceed if missing.')
+        'Downstream steps call `peaks code read-job-shape` and refuse to proceed if missing.')
         .requiredOption('--is-job <bool>', 'true | false (the LLM\'s semantic verdict)')
         .requiredOption('--rationale <text>', '1-3 sentences the LLM writes explaining the call')
         .requiredOption('--suggested-job-id <jid>', 'LLM-chosen stable id, slug-safe (/^[a-z0-9][a-z0-9-]{2,40}$/)')
@@ -497,30 +497,30 @@ export function registerSoloCommands(program, io) {
         .option('--prompt <text>', 'override the prompt hashed into promptHash (default: read last-prompt.txt if present, else empty)')).action(async (opts) => {
         try {
             if (opts.isJob !== 'true' && opts.isJob !== 'false') {
-                printResult(io, fail('solo.detect-job', 'INVALID_FLAG', `--is-job must be true | false (got "${opts.isJob}")`, { provided: opts.isJob }, ['Pass --is-job true or --is-job false']), opts.json);
+                printResult(io, fail('code.detect-job', 'INVALID_FLAG', `--is-job must be true | false (got "${opts.isJob}")`, { provided: opts.isJob }, ['Pass --is-job true or --is-job false']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             if (opts.suggestedStrategy !== 'single' && opts.suggestedStrategy !== 'rotating') {
-                printResult(io, fail('solo.detect-job', 'INVALID_FLAG', `--suggested-strategy must be single | rotating (got "${opts.suggestedStrategy}")`, { provided: opts.suggestedStrategy }, ['Pass --suggested-strategy single or --suggested-strategy rotating']), opts.json);
+                printResult(io, fail('code.detect-job', 'INVALID_FLAG', `--suggested-strategy must be single | rotating (got "${opts.suggestedStrategy}")`, { provided: opts.suggestedStrategy }, ['Pass --suggested-strategy single or --suggested-strategy rotating']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             if (opts.confidence !== 'high' && opts.confidence !== 'medium' && opts.confidence !== 'low') {
-                printResult(io, fail('solo.detect-job', 'INVALID_FLAG', `--confidence must be high | medium | low (got "${opts.confidence}")`, { provided: opts.confidence }, ['Pass --confidence high | medium | low']), opts.json);
+                printResult(io, fail('code.detect-job', 'INVALID_FLAG', `--confidence must be high | medium | low (got "${opts.confidence}")`, { provided: opts.confidence }, ['Pass --confidence high | medium | low']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             const jidRe = /^[a-z0-9][a-z0-9-]{2,40}$/;
             if (!jidRe.test(opts.suggestedJobId)) {
-                printResult(io, fail('solo.detect-job', 'INVALID_FLAG', `--suggested-job-id must match /^[a-z0-9][a-z0-9-]{2,40}$/ (got "${opts.suggestedJobId}")`, { provided: opts.suggestedJobId }, ['Pass a slug-safe id (lowercase, digits, dashes; 3-41 chars)']), opts.json);
+                printResult(io, fail('code.detect-job', 'INVALID_FLAG', `--suggested-job-id must match /^[a-z0-9][a-z0-9-]{2,40}$/ (got "${opts.suggestedJobId}")`, { provided: opts.suggestedJobId }, ['Pass a slug-safe id (lowercase, digits, dashes; 3-41 chars)']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
             const sessionId = opts.sessionId ?? readActiveSid(projectRoot);
             if (sessionId === null) {
-                printResult(io, fail('solo.detect-job', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
+                printResult(io, fail('code.detect-job', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
                 process.exitCode = 1;
                 return;
             }
@@ -545,7 +545,7 @@ export function registerSoloCommands(program, io) {
                 confidence: opts.confidence,
                 prompt: promptText
             }, { force: opts.force === true });
-            printResult(io, ok('solo.detect-job', {
+            printResult(io, ok('code.detect-job', {
                 sessionId: record.sessionId,
                 promptHash: record.promptHash,
                 decision: record.decision,
@@ -558,7 +558,7 @@ export function registerSoloCommands(program, io) {
         catch (err) {
             if (err instanceof JobShapeDecisionError) {
                 const code = err.code === JOB_SHAPE_ALREADY_DECIDED ? JOB_SHAPE_ALREADY_DECIDED : err.code === JOB_SHAPE_NOT_DECIDED ? JOB_SHAPE_NOT_DECIDED : err.code;
-                printResult(io, fail('solo.detect-job', code, err.message, err.details ?? null, [
+                printResult(io, fail('code.detect-job', code, err.message, err.details ?? null, [
                     err.code === JOB_SHAPE_ALREADY_DECIDED
                         ? 'Re-run with --force to overwrite the existing decision.'
                         : 'Re-run with valid flags.'
@@ -566,13 +566,13 @@ export function registerSoloCommands(program, io) {
                 process.exitCode = 1;
                 return;
             }
-            printResult(io, fail('solo.detect-job', 'DETECT_JOB_FAILED', getErrorMessage(err), null, ['Verify the flags and try again']), opts.json);
+            printResult(io, fail('code.detect-job', 'DETECT_JOB_FAILED', getErrorMessage(err), null, ['Verify the flags and try again']), opts.json);
             process.exitCode = 1;
         }
     });
     // v3.1.1 Step 0.8 — read-only validator. Downstream steps call this
     // to refuse to proceed if the LLM has not yet recorded a decision.
-    addJsonOption(solo
+    addJsonOption(code
         .command('read-job-shape')
         .description('v3.1.1 Step 0.8: return the recorded Job-shape decision. ' +
         'Returns JOB_SHAPE_NOT_DECIDED when the LLM has not yet recorded a verdict.')
@@ -582,12 +582,12 @@ export function registerSoloCommands(program, io) {
             const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
             const sessionId = opts.sessionId ?? readActiveSid(projectRoot);
             if (sessionId === null) {
-                printResult(io, fail('solo.read-job-shape', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
+                printResult(io, fail('code.read-job-shape', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
                 process.exitCode = 1;
                 return;
             }
             const record = readJobShapeDecision(projectRoot, sessionId);
-            printResult(io, ok('solo.read-job-shape', {
+            printResult(io, ok('code.read-job-shape', {
                 sessionId: record.sessionId,
                 promptHash: record.promptHash,
                 decision: record.decision,
@@ -598,15 +598,15 @@ export function registerSoloCommands(program, io) {
         }
         catch (err) {
             if (err instanceof JobShapeDecisionError) {
-                printResult(io, fail('solo.read-job-shape', err.code, err.message, err.details ?? null, [
+                printResult(io, fail('code.read-job-shape', err.code, err.message, err.details ?? null, [
                     err.code === JOB_SHAPE_NOT_DECIDED
-                        ? 'Run `peaks solo detect-job` to record a decision.'
+                        ? 'Run `peaks code detect-job` to record a decision.'
                         : 'Investigate the decision file integrity.'
                 ]), opts.json);
                 process.exitCode = 1;
                 return;
             }
-            printResult(io, fail('solo.read-job-shape', 'READ_JOB_SHAPE_FAILED', getErrorMessage(err), null, ['Verify the project path and try again']), opts.json);
+            printResult(io, fail('code.read-job-shape', 'READ_JOB_SHAPE_FAILED', getErrorMessage(err), null, ['Verify the project path and try again']), opts.json);
             process.exitCode = 1;
         }
     });
@@ -615,7 +615,7 @@ export function registerSoloCommands(program, io) {
     // installer). Exit code is the load-bearing contract:
     //   exit 0 → allow (with structured stdout describing the decision)
     //   exit 2 → block (stderr contains the BLOCKED: ... reason)
-    addJsonOption(solo
+    addJsonOption(code
         .command('gate-step-08')
         .description('v3.1.2: PreToolUse gate for Step 0.8 — allow when job-shape.json exists; ' +
         'fail-closed backup regex when missing. Exit 0 = allow, exit 2 = block. ' +
@@ -630,7 +630,7 @@ export function registerSoloCommands(program, io) {
             if (sessionId === null) {
                 // No session binding — treat as allow (single-rid mode). The
                 // LLM has not yet anchored; we have nothing to gate against.
-                const envelope = ok('solo.gate-step-08', {
+                const envelope = ok('code.gate-step-08', {
                     allow: true,
                     mode: 'no-session',
                     decision: null,
@@ -650,7 +650,7 @@ export function registerSoloCommands(program, io) {
             const result = evaluateStep08(evalInput);
             const verdict = result.verdict;
             if (verdict.kind === 'allow-job') {
-                const envelope = ok('solo.gate-step-08', {
+                const envelope = ok('code.gate-step-08', {
                     allow: true,
                     mode: 'job',
                     decision: verdict.decision,
@@ -661,7 +661,7 @@ export function registerSoloCommands(program, io) {
                 return;
             }
             if (verdict.kind === 'allow-single') {
-                const envelope = ok('solo.gate-step-08', {
+                const envelope = ok('code.gate-step-08', {
                     allow: true,
                     mode: 'single',
                     decision: null,
@@ -676,12 +676,12 @@ export function registerSoloCommands(program, io) {
             if (verdict.promptHit) {
                 // Block: backup regex hit. Exit code 2 is the load-bearing
                 // signal for the PreToolUse hook.
-                const blockMessage = 'BLOCKED: prompt looks Job-shaped but peaks solo detect-job has not been called. Run `peaks solo detect-job --is-job true ...` to record your Job-shape verdict, then retry.';
-                const envelope = fail('solo.gate-step-08', 'STEP_08_BLOCKED', blockMessage, {
+                const blockMessage = 'BLOCKED: prompt looks Job-shaped but peaks code detect-job has not been called. Run `peaks code detect-job --is-job true ...` to record your Job-shape verdict, then retry.';
+                const envelope = fail('code.gate-step-08', 'STEP_08_BLOCKED', blockMessage, {
                     promptSource: verdict.promptSource,
                     backupRegex: STEP_08_BACKUP_REGEX.toString()
                 }, [
-                    'Run `peaks solo detect-job --is-job true --rationale <text> --suggested-job-id <slug>` to record the Job-shape verdict.',
+                    'Run `peaks code detect-job --is-job true --rationale <text> --suggested-job-id <slug>` to record the Job-shape verdict.',
                     'Then re-run the Bash tool call.'
                 ]);
                 io.stderr(`${blockMessage}\n`);
@@ -690,7 +690,7 @@ export function registerSoloCommands(program, io) {
                 return;
             }
             // No decision + no regex hit → allow.
-            const envelope = ok('solo.gate-step-08', {
+            const envelope = ok('code.gate-step-08', {
                 allow: true,
                 mode: 'undecided-no-regex-hit',
                 decision: null,
@@ -703,7 +703,7 @@ export function registerSoloCommands(program, io) {
             return;
         }
         catch (err) {
-            printResult(io, fail('solo.gate-step-08', 'GATE_STEP_08_FAILED', getErrorMessage(err), null, [
+            printResult(io, fail('code.gate-step-08', 'GATE_STEP_08_FAILED', getErrorMessage(err), null, [
                 'Verify the project path and try again'
             ]), opts.json);
             process.exitCode = 1;
@@ -711,7 +711,7 @@ export function registerSoloCommands(program, io) {
     });
     // v3.1.2 Step 11 / final handoff — Size-fear ban.
     // Refuses to emit a final handoff while a Job has remaining slices.
-    addJsonOption(solo
+    addJsonOption(code
         .command('emit-handoff')
         .description('v3.1.2 Step 11 size-fear ban: under Job mode, refuse to emit a final ' +
         'handoff while remaining > 0. Exit 0 = allow, exit 1 = block. Pass ' +
@@ -723,7 +723,7 @@ export function registerSoloCommands(program, io) {
         try {
             const sessionId = opts.sessionId ?? readActiveSid(opts.project);
             if (sessionId === null) {
-                const envelope = ok('solo.emit-handoff', { allow: true, mode: 'no-session' }, [], [
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'no-session' }, [], [
                     'No active session id; gate passes through (single-rid mode).'
                 ]);
                 printResult(io, envelope, opts.json);
@@ -739,35 +739,35 @@ export function registerSoloCommands(program, io) {
                 evalInput.forceUnderJob = true;
             const verdict = evaluateEmitHandoff(evalInput);
             if (verdict.kind === 'allow-not-job') {
-                const envelope = ok('solo.emit-handoff', { allow: true, mode: 'single' }, [], [
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'single' }, [], [
                     'job-shape.json says isJob=false (or absent); normal handoff allowed.'
                 ]);
                 printResult(io, envelope, opts.json);
                 return;
             }
             if (verdict.kind === 'allow-done') {
-                const envelope = ok('solo.emit-handoff', { allow: true, mode: 'job-done', remaining: verdict.remaining }, [], [
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'job-done', remaining: verdict.remaining }, [], [
                     `Job is complete (remaining=0); handoff allowed.`
                 ]);
                 printResult(io, envelope, opts.json);
                 return;
             }
             if (verdict.kind === 'allow-force-override') {
-                const envelope = ok('solo.emit-handoff', { allow: true, mode: 'job-force-override', remaining: verdict.remaining }, [], [
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'job-force-override', remaining: verdict.remaining }, [], [
                     `Job has ${verdict.remaining} remaining slices; --force-under-job override applied. Handoff allowed (explicit user approval).`
                 ]);
                 printResult(io, envelope, opts.json);
                 return;
             }
             if (verdict.kind === 'block-not-initialized') {
-                const envelope = fail('solo.emit-handoff', JOB_NOT_INITIALIZED, `Job ${verdict.jobId} has no state.json; peaks job init was skipped.`, { jobId: verdict.jobId }, [`Run \`peaks job init --job-id ${verdict.jobId} --slice-list <...>\` before emitting handoff.`]);
+                const envelope = fail('code.emit-handoff', JOB_NOT_INITIALIZED, `Job ${verdict.jobId} has no state.json; peaks job init was skipped.`, { jobId: verdict.jobId }, [`Run \`peaks job init --job-id ${verdict.jobId} --slice-list <...>\` before emitting handoff.`]);
                 printResult(io, envelope, opts.json);
                 process.exitCode = 1;
                 return;
             }
             // block-remaining
             const blockMessage = `BLOCKED: Job ${verdict.jobId} has ${verdict.remaining} remaining slices. Run \`peaks job status\`. Use --force-under-job only with explicit user approval.`;
-            const envelope = fail('solo.emit-handoff', JOB_REMAINING_BLOCKED, blockMessage, { jobId: verdict.jobId, remaining: verdict.remaining }, [
+            const envelope = fail('code.emit-handoff', JOB_REMAINING_BLOCKED, blockMessage, { jobId: verdict.jobId, remaining: verdict.remaining }, [
                 `Run \`peaks job status --job-id ${verdict.jobId}\` to see remaining slices.`,
                 'Resume Step 0.81 (per-slice checkpoint loop) and continue until remaining === 0.',
                 'Use --force-under-job only with explicit user approval (size-fear ban override).'
@@ -778,7 +778,7 @@ export function registerSoloCommands(program, io) {
             return;
         }
         catch (err) {
-            printResult(io, fail('solo.emit-handoff', 'EMIT_HANDOFF_FAILED', getErrorMessage(err), null, [
+            printResult(io, fail('code.emit-handoff', 'EMIT_HANDOFF_FAILED', getErrorMessage(err), null, [
                 'Verify the project path and try again'
             ]), opts.json);
             process.exitCode = 1;

package/dist/src/cli/commands/core/skill-command.js

@@ -193,7 +193,7 @@ export function registerSkillCommand(program, io) {
         printResult(io, ok('skill.presence:clear', { active: false, removed, projectContextUpdated: true }), options.json);
     });
     // Slice 002 (v2.15.0) — AC-1: presence staleness detector.
-    // peaks-code Step 1 (and `peaks solo should-pause --step
+    // peaks-code Step 1 (and `peaks code should-pause --step
     // step-1-mode-select`) calls this to decide whether the recorded
     // `mode` field can be trusted or whether the LLM must AskUserQuestion.
     addJsonOption(skill

package/dist/src/cli/commands/dispatch-from-dag.js

@@ -54,7 +54,7 @@ export async function runDispatchFromDag(role, options, asJson, io) {
     const [{ readFileSync }, sliceDagMod, dagOrchestratorMod, contractStoreMod] = await Promise.all([
         import('node:fs'),
         import('../../services/dispatch/slice-dag.js'),
-        import('../../services/solo/dag-orchestrator.js'),
+        import('../../services/code/dag-orchestrator.js'),
         import('../../services/dispatch/contract-store.js')
     ]);
     const { validateDag, topologicalLevels, isSliceComplexity } = sliceDagMod;

package/dist/src/cli/commands/evolution-commands.d.ts

@@ -0,0 +1,27 @@
+/**
+ * peaks evolution * CLI — M4 / spec §4.4 / §6 / §7.4
+ *
+ * Adds the Darwin-style ratchet CLI surface:
+ *
+ *   peaks evolution propose --target <kind:id> --dimension <name> \
+ *     --before-score <n> --after-score <n> [--delta-min <n>] \
+ *     --author <id> [--brief-pointer <path>] [--project <root>] [--json]
+ *   peaks evolution evaluate --proposal <id> \
+ *     --evaluator <id> --skeptic <id> \
+ *     --evaluator-score <n> [--refute-paragraph <text>] \
+ *     [--risk-tag <tag>]... [--brief-pointer <path>] [--project <root>] [--json]
+ *   peaks evolution revert --proposal <id> [--user-confirmation <ptr>] [--project <root>] [--json]
+ *   peaks evolution status [--target <kind:id>] [--project <root>] [--json]
+ *
+ * Each verb prints a structured JSON envelope (`printResult` with
+ * `asJson=true`). The CLI is a thin shim around EvolutionService +
+ * the two runner modules. Author / evaluator / skeptic identities
+ * are LLM-supplied; the user is NEVER asked to type them.
+ *
+ * Defense in depth: the EvolutionService enforces the ratchet
+ * rules (AC-8 / AC-10 / AC-11); the CLI only translates flags
+ * into the service payload.
+ */
+import { Command } from "commander";
+import { type ProgramIO } from "../cli-helpers.js";
+export declare function registerEvolutionCommands(program: Command, io: ProgramIO): void;