peaks-loop 3.1.2 → 4.0.0-beta.2

package/dist/src/services/upgrade/upgrade-service.d.ts

@@ -1,3 +1,30 @@
+/**
+ * Pluggable executor for sub-step command spawns. Production
+ * callers omit `executor` on `UpgradeInput`; the default
+ * (`defaultSubstepExecutor`) wraps `node:child_process` `spawnSync`.
+ * Tests pass a synchronous fake executor to avoid the spawn cost.
+ *
+ * Contract:
+ *  - Return `status: 0` for success, non-zero for failure, `null`
+ *    for synchronous spawn errors (binary not found, EACCES, …).
+ *  - `stdout` / `stderr` are captured as UTF-8 strings.
+ *  - `durationMs` is the wall-clock duration of the spawn
+ *    (caller-facing field on `SubStepResult`).
+ */
+export type SubstepExecutor = (command: string, args: readonly string[], timeoutMs: number) => {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+};
+/**
+ * Default substep executor — wraps `spawnSync` with the same
+ * stdio / encoding / timeout config the umbrella has used since
+ * v1. Exported for test coverage: the seam-preservation test
+ * imports this directly to verify the normalized return shape
+ * on a spawn failure (e.g. a non-existent command).
+ */
+export declare const defaultSubstepExecutor: SubstepExecutor;
 export interface UpgradeInput {
     readonly projectRoot: string;
     /**
@@ -14,6 +41,13 @@ export interface UpgradeInput {
      * install hint in `nextActions` instead.
      */
     readonly peaksBin?: string;
+    /**
+     * Optional injectable executor for sub-step command execution.
+     * When omitted, the umbrella uses `defaultSubstepExecutor`
+     * (real `spawnSync`). Tests pass a synchronous fake to avoid
+     * the per-sub-step `node peaks.js …` spawn cost.
+     */
+    readonly executor?: SubstepExecutor;
 }
 export interface SubStepResult {
     readonly name: string;

package/dist/src/services/upgrade/upgrade-service.js

@@ -33,6 +33,38 @@ import { fileURLToPath } from 'node:url';
 import { runRedLinesAudit } from '../audit/red-lines-service.js';
 import { savePreferences } from '../preferences/preferences-service.js';
 import { migrateGitignoreFile } from './gitignore-migrate-service.js';
+/**
+ * Default substep executor — wraps `spawnSync` with the same
+ * stdio / encoding / timeout config the umbrella has used since
+ * v1. Exported for test coverage: the seam-preservation test
+ * imports this directly to verify the normalized return shape
+ * on a spawn failure (e.g. a non-existent command).
+ */
+export const defaultSubstepExecutor = (command, args, timeoutMs) => {
+    const start = Date.now();
+    try {
+        const result = spawnSync(command, args, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: timeoutMs,
+        });
+        return {
+            status: result.status,
+            stdout: result.stdout ?? '',
+            stderr: result.stderr ?? '',
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            status: null,
+            stdout: '',
+            stderr: message,
+            durationMs: Date.now() - start,
+        };
+    }
+};
 const STEPS = [
     { name: 'config-migrate', args: (p) => ['config', 'migrate', '--project', p, '--apply', '--json'] },
     { name: 'standards-migrate', args: (p) => ['standards', 'migrate', '--from-claude-rules', '--project', p, '--apply', '--json'] },
@@ -145,8 +177,7 @@ function read1xVersion(cwd) {
     }
     return null;
 }
-function runStep(peaksBin, name, args, timeoutMs = 60_000) {
-    const start = Date.now();
+function runStep(peaksBin, name, args, timeoutMs = 60_000, executor = defaultSubstepExecutor) {
     // The global `peaks` shim is a `/bin/sh` symlink script (the
     // npm install postinstall creates `peaks` → `peaks.sh` on
     // Windows). cmd.exe (the default Windows shell) cannot run
@@ -168,32 +199,18 @@ function runStep(peaksBin, name, args, timeoutMs = 60_000) {
         command = peaksBin;
         spawnArgs = args;
     }
-    try {
-        const result = spawnSync(command, spawnArgs, {
-            encoding: 'utf8',
-            stdio: ['ignore', 'pipe', 'pipe'],
-            timeout: timeoutMs,
-        });
-        return {
-            name,
-            status: result.status === 0 ? 'pass' : 'fail',
-            exitCode: result.status,
-            stdout: result.stdout ?? '',
-            stderr: result.stderr ?? '',
-            durationMs: Date.now() - start,
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return {
-            name,
-            status: 'fail',
-            exitCode: null,
-            stdout: '',
-            stderr: message,
-            durationMs: Date.now() - start,
-        };
-    }
+    // The executor normalizes spawn errors to { status: null, stderr: ... }
+    // so no try/catch wrapper is needed here — the call always returns
+    // a shaped record. See defaultSubstepExecutor for the reference impl.
+    const result = executor(command, spawnArgs, timeoutMs);
+    return {
+        name,
+        status: result.status === 0 ? 'pass' : 'fail',
+        exitCode: result.status,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        durationMs: result.durationMs,
+    };
 }
 function writeUpgradeRecord(projectRoot, result) {
     try {
@@ -260,6 +277,11 @@ export function runUpgrade(input) {
         resolve(here, '..', '..', '..', '..', 'bin', 'peaks.js');
     const fallbackPeaks = 'peaks';
     const resolvedPeaksBin = existsSync(peaksBin) ? peaksBin : fallbackPeaks;
+    // Resolve the executor once at the top of runUpgrade so every
+    // sub-step call shares the same instance. Tests pass a fake
+    // executor via UpgradeInput.executor; production callers omit
+    // it and get the default spawnSync wrapper.
+    const executor = input.executor ?? defaultSubstepExecutor;
     const fromVersion = read1xVersion(input.projectRoot);
     const steps = [];
     const warnings = [];
@@ -325,7 +347,7 @@ export function runUpgrade(input) {
                 continue;
             }
             const args = ['memory', 'extract', '--project', input.projectRoot, '--artifact', ...artifacts, '--apply', '--json'];
-            const r = runStep(resolvedPeaksBin, 'memory-extract', args);
+            const r = runStep(resolvedPeaksBin, 'memory-extract', args, 60_000, executor);
             steps.push(r);
             if (r.status === 'fail') {
                 warnings.push(`memory-extract failed: ${r.stderr.slice(0, 200)}`);
@@ -333,7 +355,7 @@ export function runUpgrade(input) {
             continue;
         }
         const args = step.args(input.projectRoot);
-        const r = runStep(resolvedPeaksBin, step.name, args);
+        const r = runStep(resolvedPeaksBin, step.name, args, 60_000, executor);
         steps.push(r);
         if (r.status === 'fail') {
             warnings.push(`${step.name} failed: ${r.stderr.slice(0, 200)}`);

package/dist/src/services/verdict/verdict-aggregator.d.ts

@@ -1,5 +1,5 @@
 /**
- * peaks-solo multi-signal verdict aggregator (v2.13.1 Group A).
+ * peaks-code multi-signal verdict aggregator (v2.13.1 Group A).
  *
  * Implements the 4 aggregation rules documented in
  * `.peaks/project-scan/audit-output-schema.md:66-78` plus 3rd-party

package/dist/src/services/workflow/pipeline-verify-service.d.ts

@@ -63,7 +63,7 @@ export type PipelineVerification = {
      */
     gateH?: 'pass' | 'fail';
     /**
-     * Slice 2026-06-28-solo-mode-bypass-fix (defect #3): `true` when
+     * Slice 2026-06-28-code-mode-bypass-fix (defect #3): `true` when
      * every evidence file resolved on the canonical path
      * (`.peaks/_runtime/change/<sessionId>/...`). `false` when at least
      * one evidence file resolved via a legacy fallback (`.peaks/<sessionId>/...`

package/dist/src/services/workflow/pipeline-verify-service.js

@@ -26,7 +26,7 @@ async function findRequestFile(projectRoot, role, rid) {
     const artifact = await showRequestArtifact({ projectRoot, role: role, requestId: rid });
     if (artifact === null)
         return null;
-    // Slice 2026-06-28-solo-mode-bypass-fix (defect #3): the legacy
+    // Slice 2026-06-28-code-mode-bypass-fix (defect #3): the legacy
     // `showRequestArtifact` returns the FULL SCOPE (`_runtime/<sid>`)
     // as `sessionId`, not just the trailing id segment. The canonical
     // evidence lookup needs only the bare id (`.peaks/_runtime/change/<id>/`).
@@ -158,7 +158,7 @@ export async function verifyPipeline(options) {
     // preferred filesystem scope; falling through to `options.rid` would
     // make every missing-evidence path look like a per-rid scope dir.
     const rdEvidenceDir = resolvedChangeId || options.sessionId || getSessionIdCanonical(options.projectRoot) || options.rid;
-    // Slice 2026-06-28-solo-mode-bypass-fix (defect #3): track whether
+    // Slice 2026-06-28-code-mode-bypass-fix (defect #3): track whether
     // every resolved evidence file landed on the canonical path. Drives
     // the `usedCanonicalPath` envelope field. The flag stays `true` if
     // no evidence file was resolved at all (nothing to be non-canonical
@@ -410,7 +410,7 @@ export async function verifyPipeline(options) {
                 : 'suffixed';
     const gateC = allQaGatesPassed ? 'pass' : 'fail';
     const gateH = allFeedbackGatesPassed ? 'pass' : 'fail';
-    // Slice 2026-06-28-solo-mode-bypass-fix (defect #3): `true` when
+    // Slice 2026-06-28-code-mode-bypass-fix (defect #3): `true` when
     // every gate resolved on the canonical path; `false` when at least
     // one fell back to a legacy form. QA / TXT surface the value so the
     // user knows the legacy content must be moved into the canonical

package/dist/src/services/workflow/workflow-autonomous-service.d.ts

@@ -1,7 +1,7 @@
 import type { CapabilityItemType } from '../recommendations/recommendation-types.js';
 import type { ModelProviderConfig, WorkspaceConfig } from '../config/config-types.js';
 import { type RdPlanResult } from '../rd/rd-service.js';
-import { type SoloMode, type WorkflowMode, type WorkflowRouterPlan } from './workflow-router-service.js';
+import { type CodeMode, type WorkflowMode, type WorkflowRouterPlan } from './workflow-router-service.js';
 export { getResumeRequiredArtifacts, getResumeArtifactsStatus, createResumePlan } from './workflow-autonomous-resume-helpers.js';
 export type CapabilitySurface = 'skill' | 'mcp' | 'plugin' | 'expert';
 export type CapabilityPurpose = 'code-review' | 'security-review' | 'coding-standards' | 'docs-lookup' | 'browser-validation' | 'browser-debug' | 'design-context' | 'design-source' | 'code-search' | 'database-inspection' | 'browser-agent' | 'worker-guidance' | 'memory' | 'context-management' | 'ui-components' | 'spec-workflow' | 'repo-intelligence' | 'openspec' | 'workflow-methodology' | 'workflow-reference' | 'workflow-guidance' | 'product-guidance' | 'design-reference' | 'ui-reference' | 'engineering-guidance' | 'typescript-guidance' | 'quality-guidance' | 'skill-pack' | 'external-skill' | 'design-critique' | 'design-guidance' | 'cloud-skill-pack';
@@ -20,7 +20,7 @@ export type CapabilityCandidate = {
 };
 export type AutonomousWorkflowRequest = {
     readonly mode: WorkflowMode;
-    readonly soloMode?: SoloMode;
+    readonly codeMode?: CodeMode;
     readonly sessionId: string;
     readonly goal: string;
     readonly maxWorkers?: number;
@@ -68,7 +68,7 @@ export type AutonomousStoragePlan = {
 };
 export type AutonomousMvpPackage = {
     readonly mode: WorkflowMode;
-    readonly soloMode: SoloMode | undefined;
+    readonly codeMode: CodeMode | undefined;
     readonly executionMode: 'preview';
     readonly dryRun: true;
     readonly routePolicy: WorkflowRouterPlan['routePolicy'];

package/dist/src/services/workflow/workflow-autonomous-service.js

@@ -205,7 +205,7 @@ function createCapabilityPlan(request) {
 function createMvpPackage(request, routePlan, rdPlan, capabilityPlan, ready) {
     return {
         mode: request.mode,
-        soloMode: routePlan.soloMode,
+        codeMode: routePlan.codeMode,
         executionMode: 'preview',
         dryRun: true,
         routePolicy: routePlan.routePolicy,
@@ -240,7 +240,7 @@ export function createAutonomousWorkflowPlan(request) {
     const available = hasArtifactWorkspace(request, artifactWorkspacePath);
     const routePlan = createWorkflowRouterPlan({
         mode: request.mode,
-        ...(request.soloMode !== undefined ? { soloMode: request.soloMode } : {}),
+        ...(request.codeMode !== undefined ? { codeMode: request.codeMode } : {}),
         sessionId: request.sessionId,
         goal,
         maxWorkers,

package/dist/src/services/workflow/workflow-router-service.d.ts

@@ -1,18 +1,18 @@
 import { type ModelProviderConfig, type WorkspaceConfig } from '../config/config-types.js';
 import { type RdPlanResult } from '../rd/rd-service.js';
 import { type TechPlanResult, type TechStatus } from '../tech/tech-service.js';
-export type WorkflowMode = 'solo' | 'team';
-export type SoloMode = 'full-auto' | 'guided' | 'rnd';
+export type WorkflowMode = 'code' | 'team';
+export type CodeMode = 'full-auto' | 'guided' | 'rnd';
 export type ModelTier = 'top-tier' | 'mid-tier';
 export type ModelRole = 'strongest' | 'execution';
-export type WorkflowRoutePolicy = 'solo-broad-multi-model' | 'team-rd-limited-multi-model';
+export type WorkflowRoutePolicy = 'code-broad-multi-model' | 'team-rd-limited-multi-model';
 export type WorkflowStepStage = 'product-direction' | 'design-direction' | 'tech-direction' | 'tech-review' | 'rd-planning' | 'coding-execution' | 'unit-test-execution' | 'quality-review';
-export type WorkflowStepOwner = 'peaks-solo' | 'peaks-rd' | 'peaks-tech' | 'human';
+export type WorkflowStepOwner = 'peaks-code' | 'peaks-rd' | 'peaks-tech' | 'human';
 export type WorkflowRouterRequest = {
     sessionId: string;
     goal: string;
     mode: WorkflowMode;
-    soloMode?: SoloMode;
+    codeMode?: CodeMode;
     maxWorkers?: number;
     dryRun: true;
     artifactWorkspacePath?: string;
@@ -64,7 +64,7 @@ export type WorkflowRouterPlan = {
     readonly sessionId: string;
     readonly goal: string;
     readonly mode: WorkflowMode;
-    readonly soloMode?: SoloMode;
+    readonly codeMode?: CodeMode;
     readonly executionMode: 'autonomous';
     readonly decisionProfile: string;
     readonly dryRun: true;
@@ -81,5 +81,5 @@ export type WorkflowRouterPlan = {
     readonly constraints: readonly string[];
 };
 export declare function isWorkflowMode(mode: string): mode is WorkflowMode;
-export declare function isSoloMode(value: string): value is SoloMode;
+export declare function isCodeMode(value: string): value is CodeMode;
 export declare function createWorkflowRouterPlan(request: WorkflowRouterRequest): WorkflowRouterPlan;

package/dist/src/services/workflow/workflow-router-service.js

@@ -18,7 +18,7 @@ const EXECUTION_STAGES = ['coding-execution', 'unit-test-execution'];
 const GUIDED_DECISION_STAGES = ['product-direction', 'design-direction'];
 const GOVERNED_DECISION_STAGES = ['product-direction', 'design-direction', 'tech-direction', 'tech-review'];
 export function isWorkflowMode(mode) {
-    return mode === 'solo' || mode === 'team';
+    return mode === 'code' || mode === 'team';
 }
 function assertSupportedMode(mode) {
     if (!isWorkflowMode(mode)) {
@@ -32,9 +32,9 @@ function normalizeGoal(goal) {
     }
     return normalized;
 }
-function assertSoloModeAllowed(mode, soloMode) {
-    if (mode !== 'solo' && soloMode !== undefined) {
-        throw new Error('soloMode requires solo workflow mode');
+function assertCodeModeAllowed(mode, codeMode) {
+    if (mode !== 'code' && codeMode !== undefined) {
+        throw new Error('codeMode requires code workflow mode');
     }
 }
 function step(input, executionModelId) {
@@ -48,29 +48,29 @@ function step(input, executionModelId) {
         writesArtifacts: false
     };
 }
-export function isSoloMode(value) {
+export function isCodeMode(value) {
     return value === 'full-auto' || value === 'guided' || value === 'rnd';
 }
-function getDecisionProfileSummary(mode, soloMode) {
+function getDecisionProfileSummary(mode, codeMode) {
     if (mode === 'team') {
         return 'Team mode keeps product and design governance on a human-controlled path while RD execution follows recommended defaults.';
     }
-    if (soloMode === 'guided') {
+    if (codeMode === 'guided') {
         return 'Guided mode keeps the user in the decision loop for the early recommended defaults, while later execution remains bounded by the routing plan.';
     }
-    if (soloMode === 'rnd') {
+    if (codeMode === 'rnd') {
         return 'R&D mode asks for technical confirmation up front, then applies recommended defaults for implementation, testing, review, and safety checks.';
     }
     return 'Full-auto mode applies recommended defaults for product, design, and tech decisions, then runs the engineering pipeline end to end under routing gates.';
 }
-function annotateSteps(steps, soloMode) {
-    const decisionStages = soloMode === 'guided'
+function annotateSteps(steps, codeMode) {
+    const decisionStages = codeMode === 'guided'
         ? GUIDED_DECISION_STAGES
         : GOVERNED_DECISION_STAGES;
     return steps.map((currentStep) => {
         const isDecisionStage = decisionStages.includes(currentStep.stage);
         const reasonPrefix = isDecisionStage
-            ? `[${soloMode}] decision stage`
+            ? `[${codeMode}] decision stage`
             : '[routed] execution stage';
         return {
             ...currentStep,
@@ -80,18 +80,18 @@ function annotateSteps(steps, soloMode) {
 }
 function createSoloSteps(executionModelId) {
     return [
-        step({ id: 'solo-product-direction', stage: 'product-direction', owner: 'peaks-solo', modelTier: 'top-tier', reason: 'Product direction needs strong judgment before execution work is delegated.', dependsOn: [] }, executionModelId),
-        step({ id: 'solo-design-direction', stage: 'design-direction', owner: 'peaks-solo', modelTier: 'top-tier', reason: 'Design direction uses the recommended default before cheaper implementation work.', dependsOn: ['solo-product-direction'] }, executionModelId),
-        step({ id: 'solo-tech-direction', stage: 'tech-direction', owner: 'peaks-tech', modelTier: 'top-tier', reason: 'Technical boundaries and approval gates use the recommended default with high-confidence planning.', dependsOn: ['solo-design-direction'] }, executionModelId),
-        step({ id: 'solo-tech-review', stage: 'tech-review', owner: 'peaks-tech', modelTier: 'top-tier', reason: 'Tech artifacts and gate decisions require strong review and a recommended default path.', dependsOn: ['solo-tech-direction'] }, executionModelId),
-        step({ id: 'solo-rd-planning', stage: 'rd-planning', owner: 'peaks-rd', modelTier: 'top-tier', reason: 'RD task decomposition and acceptance criteria use the recommended default before execution delegation.', dependsOn: ['solo-tech-review'] }, executionModelId),
-        step({ id: 'solo-coding-execution', stage: 'coding-execution', owner: 'peaks-rd', modelTier: executionModelId === STRONGEST_MODEL_ID ? 'top-tier' : 'mid-tier', reason: `Coding and routine refactoring must use the configured execution worker model ${executionModelId}.`, dependsOn: ['solo-rd-planning'] }, executionModelId),
-        step({ id: 'solo-unit-test-execution', stage: 'unit-test-execution', owner: 'peaks-rd', modelTier: executionModelId === STRONGEST_MODEL_ID ? 'top-tier' : 'mid-tier', reason: `Unit test authoring and focused test runs must use the configured execution worker model ${executionModelId}.`, dependsOn: ['solo-coding-execution'] }, executionModelId),
-        step({ id: 'solo-quality-review', stage: 'quality-review', owner: 'peaks-solo', modelTier: 'top-tier', reason: 'Reducer and final quality gates need strong synthesis and risk review.', dependsOn: ['solo-unit-test-execution'] }, executionModelId)
+        step({ id: 'code-product-direction', stage: 'product-direction', owner: 'peaks-code', modelTier: 'top-tier', reason: 'Product direction needs strong judgment before execution work is delegated.', dependsOn: [] }, executionModelId),
+        step({ id: 'code-design-direction', stage: 'design-direction', owner: 'peaks-code', modelTier: 'top-tier', reason: 'Design direction uses the recommended default before cheaper implementation work.', dependsOn: ['code-product-direction'] }, executionModelId),
+        step({ id: 'code-tech-direction', stage: 'tech-direction', owner: 'peaks-tech', modelTier: 'top-tier', reason: 'Technical boundaries and approval gates use the recommended default with high-confidence planning.', dependsOn: ['code-design-direction'] }, executionModelId),
+        step({ id: 'code-tech-review', stage: 'tech-review', owner: 'peaks-tech', modelTier: 'top-tier', reason: 'Tech artifacts and gate decisions require strong review and a recommended default path.', dependsOn: ['code-tech-direction'] }, executionModelId),
+        step({ id: 'code-rd-planning', stage: 'rd-planning', owner: 'peaks-rd', modelTier: 'top-tier', reason: 'RD task decomposition and acceptance criteria use the recommended default before execution delegation.', dependsOn: ['code-tech-review'] }, executionModelId),
+        step({ id: 'code-coding-execution', stage: 'coding-execution', owner: 'peaks-rd', modelTier: executionModelId === STRONGEST_MODEL_ID ? 'top-tier' : 'mid-tier', reason: `Coding and routine refactoring must use the configured execution worker model ${executionModelId}.`, dependsOn: ['code-rd-planning'] }, executionModelId),
+        step({ id: 'code-unit-test-execution', stage: 'unit-test-execution', owner: 'peaks-rd', modelTier: executionModelId === STRONGEST_MODEL_ID ? 'top-tier' : 'mid-tier', reason: `Unit test authoring and focused test runs must use the configured execution worker model ${executionModelId}.`, dependsOn: ['code-coding-execution'] }, executionModelId),
+        step({ id: 'code-quality-review', stage: 'quality-review', owner: 'peaks-code', modelTier: 'top-tier', reason: 'Reducer and final quality gates need strong synthesis and risk review.', dependsOn: ['code-unit-test-execution'] }, executionModelId)
     ];
 }
-function createSoloStepsForMode(soloMode, executionModelId) {
-    return annotateSteps(createSoloSteps(executionModelId), soloMode);
+function createSoloStepsForMode(codeMode, executionModelId) {
+    return annotateSteps(createSoloSteps(executionModelId), codeMode);
 }
 function createTeamSteps(executionModelId) {
     return [
@@ -150,21 +150,21 @@ function createModeStatus(economyMode, swarmMode, executionModelId, executionMod
         summary: `${economySummary} ${swarmSummary}`
     };
 }
-function getSoloMode(mode, soloMode) {
-    if (mode !== 'solo') {
+function getCodeMode(mode, codeMode) {
+    if (mode !== 'code') {
         return undefined;
     }
-    if (soloMode === undefined) {
+    if (codeMode === undefined) {
         return 'full-auto';
     }
-    if (!isSoloMode(soloMode)) {
-        throw new Error('Unsupported solo mode');
+    if (!isCodeMode(codeMode)) {
+        throw new Error('Unsupported code mode');
     }
-    return soloMode;
+    return codeMode;
 }
 export function createWorkflowRouterPlan(request) {
     assertSupportedMode(request.mode);
-    assertSoloModeAllowed(request.mode, request.soloMode);
+    assertCodeModeAllowed(request.mode, request.codeMode);
     // Slice 2026-06-29-change-id-root-removal: change-id is metadata-only;
     // no structural validation gate fires here.
     const goal = normalizeGoal(request.goal);
@@ -185,8 +185,8 @@ export function createWorkflowRouterPlan(request) {
     const effectiveProviders = request.config?.providers ?? { minimax: { model: 'minimax-2.7' } };
     const executionModelId = economyMode !== false ? getConfiguredExecutionModelId(effectiveProviders) : STRONGEST_MODEL_ID;
     const modeStatus = createModeStatus(economyMode, swarmMode, executionModelId, economyMode ? 'config.providers' : 'planner-reviewer-strongest-model');
-    const soloMode = getSoloMode(request.mode, request.soloMode);
-    const decisionProfile = getDecisionProfileSummary(request.mode, soloMode);
+    const codeMode = getCodeMode(request.mode, request.codeMode);
+    const decisionProfile = getDecisionProfileSummary(request.mode, codeMode);
     const artifactWorkspacePath = request.artifactWorkspacePath ?? (request.workspace ? getLocalArtifactPath(request.workspace) : undefined);
     const sharedWorkspaceOptions = {
         ...(artifactWorkspacePath ? { artifactWorkspacePath } : {}),
@@ -195,7 +195,7 @@ export function createWorkflowRouterPlan(request) {
     const techStatus = getTechStatus({ sessionId: request.sessionId, ...sharedWorkspaceOptions });
     const techPlan = createTechPlan({ sessionId: request.sessionId, goal, swarm: swarmMode, dryRun: true, ...sharedWorkspaceOptions });
     const rdPlan = createRdSwarmPlan({ skill: 'rd', sessionId: request.sessionId, goal, maxWorkers, swarmMode, executionModelId, dryRun: true, ...sharedWorkspaceOptions });
-    const steps = soloMode ? createSoloStepsForMode(soloMode, executionModelId) : createTeamSteps(executionModelId);
+    const steps = codeMode ? createSoloStepsForMode(codeMode, executionModelId) : createTeamSteps(executionModelId);
     const blockedReasons = uniqueStrings([
         ...techStatus.blockedReasons,
         ...getTechPlanBlockedReasons(techPlan),
@@ -208,11 +208,11 @@ export function createWorkflowRouterPlan(request) {
         sessionId: request.sessionId,
         goal,
         mode: request.mode,
-        ...(soloMode ? { soloMode } : {}),
+        ...(codeMode ? { codeMode } : {}),
         executionMode: 'autonomous',
         decisionProfile,
         dryRun: true,
-        routePolicy: request.mode === 'solo' ? 'solo-broad-multi-model' : 'team-rd-limited-multi-model',
+        routePolicy: request.mode === 'code' ? 'code-broad-multi-model' : 'team-rd-limited-multi-model',
         modelRouting: createModelRouting(steps, executionModelId),
         modelAssignments: createModelAssignments(steps),
         modeStatus,

package/dist/src/services/workspace/claude-settings-template.d.ts

@@ -5,7 +5,7 @@
  * The template is a PreToolUse hook allow-list that bypasses the
  * Claude Code [Fact-Forcing Gate] for tool calls whose paths target
  * the peaks-managed `.peaks/` workspace. Without this bypass,
- * `peaks workspace init` (Step 0 of every peaks-solo session) is
+ * `peaks workspace init` (Step 0 of every peaks-code session) is
  * unrunnable in a consumer project because the gate blocks the very
  * first Write.
  *
@@ -51,7 +51,7 @@ export declare const CLAUDE_SETTINGS_LOCAL_FILENAME = ".claude/settings.local.js
  *           bypass is the only emit. Bash enforcement is owned by
  *           `peaks gate enforce` in `settings.json`.
  *   1.3.0 — added the v3.1.2 `Bash` PreToolUse matcher that runs
- *           `peaks solo gate-step-08 --project .` (Step 0.8 mechanical
+ *           `peaks code gate-step-08 --project .` (Step 0.8 mechanical
  *           gate). The existing Write|Edit|MultiEdit matcher is
  *           preserved. The new matcher's exit code is the load-bearing
  *           signal: 0 = allow, 2 = block (with stderr BLOCKED reason).

package/dist/src/services/workspace/claude-settings-template.js

@@ -5,7 +5,7 @@
  * The template is a PreToolUse hook allow-list that bypasses the
  * Claude Code [Fact-Forcing Gate] for tool calls whose paths target
  * the peaks-managed `.peaks/` workspace. Without this bypass,
- * `peaks workspace init` (Step 0 of every peaks-solo session) is
+ * `peaks workspace init` (Step 0 of every peaks-code session) is
  * unrunnable in a consumer project because the gate blocks the very
  * first Write.
  *
@@ -51,7 +51,7 @@ export const CLAUDE_SETTINGS_LOCAL_FILENAME = '.claude/settings.local.json';
  *           bypass is the only emit. Bash enforcement is owned by
  *           `peaks gate enforce` in `settings.json`.
  *   1.3.0 — added the v3.1.2 `Bash` PreToolUse matcher that runs
- *           `peaks solo gate-step-08 --project .` (Step 0.8 mechanical
+ *           `peaks code gate-step-08 --project .` (Step 0.8 mechanical
  *           gate). The existing Write|Edit|MultiEdit matcher is
  *           preserved. The new matcher's exit code is the load-bearing
  *           signal: 0 = allow, 2 = block (with stderr BLOCKED reason).
@@ -174,7 +174,7 @@ function wrapAsNodeOneLiner(js) {
  * subcommand allow-list. It does NOT silently allow arbitrary paths
  * under `.peaks/_runtime/<sessionId>/` — only those matching the documented
  * pattern. Future slice work can broaden the allow-list if the
- * peaks-solo workflow needs more paths.
+ * peaks-code workflow needs more paths.
  */
 function buildWriteHookCommand() {
     // Path-matching: allow when the path contains `.peaks/_runtime/`
@@ -216,7 +216,7 @@ export function buildClaudeSettingsLocalJson() {
                 },
                 {
                     // v3.1.2 Step 0.8 — Mechanical PreToolUse gate. Runs
-                    // `peaks solo gate-step-08 --project .` before every Bash
+                    // `peaks code gate-step-08 --project .` before every Bash
                     // tool call. Exit 0 = allow (with structured stdout
                     // describing the decision + optional `Next: slice #N+1 of
                     // M (<currentSlice>)` line when progress.json exists). Exit
@@ -235,7 +235,7 @@ export function buildClaudeSettingsLocalJson() {
     };
 }
 /**
- * v3.1.2: build the Bash matcher command that runs `peaks solo
+ * v3.1.2: build the Bash matcher command that runs `peaks code
  * gate-step-08`. We invoke the CLI directly (not via `node -e "..."`)
  * because the CLI is the only legitimate source of the structured
  * decision + Next: slice context. Exit code is the load-bearing
@@ -246,9 +246,9 @@ export function buildClaudeSettingsLocalJson() {
  */
 function buildBashGateStep08Command() {
     // The hook receives the tool call on stdin. We ignore stdin and
-    // delegate entirely to `peaks solo gate-step-08`, which reads
+    // delegate entirely to `peaks code gate-step-08`, which reads
     // .peaks/_runtime/<sessionId>/job-shape.json and last-prompt.txt.
     // `${CLAUDE_PROJECT_DIR}` resolves to the consumer project's root
     // (Claude Code's standard convention).
-    return 'peaks solo gate-step-08 --project "${CLAUDE_PROJECT_DIR}"';
+    return 'peaks code gate-step-08 --project "${CLAUDE_PROJECT_DIR}"';
 }

package/dist/src/services/workspace/workspace-claude-settings-materializer.d.ts

@@ -26,7 +26,7 @@
  * recovery path: copy the file contents into
  * `.claude/settings.local.json` manually. The recovery path is
  * documented in
- * `skills/peaks-solo/references/anchoring-and-session-info.md`.
+ * `skills/peaks-code/references/anchoring-and-session-info.md`.
  *
  * Slice 2026-06-13-selfheal-claude-settings-template: the offline copy
  * is now ALSO drift-checked (via `templateContentMatches`) so stale

package/dist/src/services/workspace/workspace-claude-settings-materializer.js

@@ -53,7 +53,7 @@ const PEAKS_GITIGNORE_SNIPPET = [
  * recovery path: copy the file contents into
  * `.claude/settings.local.json` manually. The recovery path is
  * documented in
- * `skills/peaks-solo/references/anchoring-and-session-info.md`.
+ * `skills/peaks-code/references/anchoring-and-session-info.md`.
  *
  * Slice 2026-06-13-selfheal-claude-settings-template: the offline copy
  * is now ALSO drift-checked (via `templateContentMatches`) so stale

package/dist/src/services/workspace/workspace-service.d.ts

@@ -19,7 +19,7 @@ export type WorkspaceInitOptions = {
      */
     noClaudeHooks?: boolean;
     /**
-     * Slice 2026-06-16-peaks-solo-auto-scaffold (RD#7): opt-in flag for
+     * Slice 2026-06-16-peaks-code-auto-scaffold (RD#7): opt-in flag for
      * auto-applying `peaks standards init` when the consumer project's
      * `.claude/rules/` is missing or empty. Default (`false`) only emits
      * the diagnostic; set to `true` to also scaffold the rules tree via
@@ -59,7 +59,7 @@ export type WorkspaceInitReport = {
      * taken on the offline `.peaks/.claude-settings-template.json` copy.
      * The offline copy is ALWAYS written/checked (regardless of
      * noClaudeHooks) because it is the manual-recovery anchor — see
-     * `skills/peaks-solo/references/anchoring-and-session-info.md`.
+     * `skills/peaks-code/references/anchoring-and-session-info.md`.
      *   - written:        the file did not exist; it was created
      *   - refreshed:      the file existed but its parsed hooks tree
      *                     diverged from the current `buildClaudeSettingsLocalJson()`;
@@ -75,7 +75,7 @@ export type WorkspaceInitReport = {
         };
     };
     /**
-     * Slice 2026-06-16-peaks-solo-auto-scaffold (RD#7): structured
+     * Slice 2026-06-16-peaks-code-auto-scaffold (RD#7): structured
      * diagnostic for missing or empty `.claude/rules/{common,<language>}/`.
      * Always present (the detector runs on every init); `missing: false`
      * means the project's rules tree is already populated and no action is
@@ -84,7 +84,7 @@ export type WorkspaceInitReport = {
      */
     standardsMissing: MissingProjectStandardsDiagnostic;
     /**
-     * Slice 2026-06-16-peaks-solo-auto-scaffold (RD#7): when the caller
+     * Slice 2026-06-16-peaks-code-auto-scaffold (RD#7): when the caller
      * passed `initStandards: true` AND the detector reported `missing:
      * true`, this field lists the files written by
      * `executeProjectStandardsInit({ projectRoot, apply: true })`.

package/dist/src/services/workspace/workspace-service.js

@@ -249,7 +249,7 @@ export async function initWorkspace(options) {
     // that takes an explicit --session-id, so it owns the binding to .session.json.
     // Without this write, downstream commands that fall through to
     // `ensureSession()` would auto-generate a *different* id and create a second
-    // session directory — the bug that confuses the LLM in peaks-solo.
+    // session directory — the bug that confuses the LLM in peaks-code.
     //
     // Conflict rule: if .session.json already points at a different session
     // whose directory is real (has session.json inside), the caller is starting
@@ -289,7 +289,7 @@ export async function initWorkspace(options) {
         setCurrentSessionBinding(options.projectRoot, options.sessionId);
         bound = true;
     }
-    // Slice 2026-06-16-peaks-solo-auto-scaffold (RD#7):
+    // Slice 2026-06-16-peaks-code-auto-scaffold (RD#7):
     //   - Always run the detector and surface the descriptor so the CLI can
     //     put it on stderr + into the JSON envelope's `data.standardsMissing`.
     //   - When `initStandards: true` AND the detector reports missing, run

package/dist/src/shared/paths.d.ts

@@ -2,5 +2,5 @@ export declare const repoRoot: string;
 export declare const skillsDir: string;
 export declare const schemasDir: string;
 export declare const templatesDir: string;
-export declare const requiredSkillNames: readonly ["peaks-solo", "peaks-prd", "peaks-ui", "peaks-rd", "peaks-qa", "peaks-sc", "peaks-txt", "peaks-sop"];
+export declare const requiredSkillNames: readonly ["peaks-code", "peaks-prd", "peaks-ui", "peaks-rd", "peaks-qa", "peaks-sc", "peaks-txt", "peaks-sop"];
 export declare const requiredSchemaFiles: readonly ["artifact-manifest.schema.json", "context-capsule.schema.json", "approval-record.schema.json", "change-impact.schema.json", "refactor-slice-spec.schema.json", "artifact-retention-report.schema.json", "capability-source.schema.json", "capability-item.schema.json", "capability-availability.schema.json", "recommendation-plan.schema.json", "artifact-workspace.schema.json", "mcp-server.schema.json", "mcp-install-spec.schema.json", "mcp-install-plan.schema.json", "mcp-apply-result.schema.json", "openspec-change-summary.schema.json", "openspec-render-request.schema.json", "openspec-validation-result.schema.json", "doctor-report.schema.json", "library-breaking-changes.schema.json"];

package/dist/src/shared/paths.js

@@ -17,7 +17,7 @@ export const skillsDir = resolve(repoRoot, 'skills');
 export const schemasDir = resolve(repoRoot, 'schemas');
 export const templatesDir = resolve(repoRoot, 'templates');
 export const requiredSkillNames = [
-    'peaks-solo',
+    'peaks-code',
     'peaks-prd',
     'peaks-ui',
     'peaks-rd',

package/dist/src/shared/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "3.1.2";
+export declare const CLI_VERSION = "4.0.0-beta.2";

package/dist/src/shared/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "3.1.2";
+export const CLI_VERSION = "4.0.0-beta.2";