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

package/dist/src/cli/commands/workflow-commands.js

@@ -1,6 +1,6 @@
 import { createRdSwarmPlan } from '../../services/rd/rd-service.js';
 import { createTechPlan, getTechStatus } from '../../services/tech/tech-service.js';
-import { createWorkflowRouterPlan, isSoloMode, isWorkflowMode } from '../../services/workflow/workflow-router-service.js';
+import { createWorkflowRouterPlan, isCodeMode, isWorkflowMode } from '../../services/workflow/workflow-router-service.js';
 import { createAutonomousWorkflowPlan } from '../../services/workflow/workflow-autonomous-service.js';
 import { writeAutonomousResumeArtifacts } from '../../services/workflow/autonomous-resume-writer.js';
 import { createRecommendationPlan } from '../../services/recommendations/recommendation-service.js';
@@ -87,21 +87,21 @@ function validatePlanningInput(goal) {
         throw new Error('Goal must be non-empty');
     }
 }
-function parseSoloMode(io, command, mode, soloMode, asJson) {
-    if (mode !== 'solo' && soloMode) {
-        printResult(io, fail(command, 'SOLO_MODE_REQUIRES_SOLO_WORKFLOW', '--solo-mode can only be used with --mode solo', {}, ['Remove --solo-mode or use --mode solo']), asJson);
+function parseCodeMode(io, command, mode, codeMode, asJson) {
+    if (mode !== 'code' && codeMode) {
+        printResult(io, fail(command, 'CODE_MODE_REQUIRES_CODE_WORKFLOW', '--code-mode can only be used with --mode code', {}, ['Remove --code-mode or use --mode code']), asJson);
         process.exitCode = 1;
         return null;
     }
-    if (mode !== 'solo' || !soloMode) {
+    if (mode !== 'code' || !codeMode) {
         return undefined;
     }
-    if (!isSoloMode(soloMode)) {
-        printResult(io, fail(command, 'UNSUPPORTED_SOLO_MODE', `Unsupported solo mode ${soloMode}`, {}, ['Use --solo-mode full-auto, guided, or rnd']), asJson);
+    if (!isCodeMode(codeMode)) {
+        printResult(io, fail(command, 'UNSUPPORTED_CODE_MODE', `Unsupported code mode ${codeMode}`, {}, ['Use --code-mode full-auto, guided, or rnd']), asJson);
         process.exitCode = 1;
         return null;
     }
-    return soloMode;
+    return codeMode;
 }
 function runTechPlan(io, options) {
     if (options.dryRun === false) {
@@ -145,15 +145,15 @@ function runWorkflowRoute(io, options) {
         return;
     }
     if (!isWorkflowMode(options.mode)) {
-        printResult(io, fail('workflow.route', 'UNSUPPORTED_WORKFLOW_MODE', `Unsupported workflow mode ${options.mode}`, {}, ['Use --mode solo or --mode team']), options.json);
+        printResult(io, fail('workflow.route', 'UNSUPPORTED_WORKFLOW_MODE', `Unsupported workflow mode ${options.mode}`, {}, ['Use --mode code or --mode team']), options.json);
         process.exitCode = 1;
         return;
     }
     const maxWorkers = parseMaxWorkers(io, 'workflow.route', options.maxWorkers, options.json);
     if (maxWorkers === null)
         return;
-    const soloMode = parseSoloMode(io, 'workflow.route', options.mode, options.soloMode, options.json);
-    if (soloMode === null)
+    const codeMode = parseCodeMode(io, 'workflow.route', options.mode, options.codeMode, options.json);
+    if (codeMode === null)
         return;
     try {
         validatePlanningInput(options.goal);
@@ -162,7 +162,7 @@ function runWorkflowRoute(io, options) {
             sessionId: '',
             goal: options.goal,
             mode: options.mode,
-            ...(soloMode ? { soloMode } : {}),
+            ...(codeMode ? { codeMode } : {}),
             maxWorkers,
             dryRun: true,
             config: readConfig(),
@@ -181,15 +181,15 @@ function runAutonomousWorkflow(io, options) {
         return;
     }
     if (!isWorkflowMode(options.mode)) {
-        printResult(io, fail('workflow.autonomous', 'UNSUPPORTED_WORKFLOW_MODE', `Unsupported workflow mode ${options.mode}`, {}, ['Use --mode solo or --mode team']), options.json);
+        printResult(io, fail('workflow.autonomous', 'UNSUPPORTED_WORKFLOW_MODE', `Unsupported workflow mode ${options.mode}`, {}, ['Use --mode code or --mode team']), options.json);
         process.exitCode = 1;
         return;
     }
     const maxWorkers = parseMaxWorkers(io, 'workflow.autonomous', options.maxWorkers, options.json);
     if (maxWorkers === null)
         return;
-    const soloMode = parseSoloMode(io, 'workflow.autonomous', options.mode, options.soloMode, options.json);
-    if (soloMode === null)
+    const codeMode = parseCodeMode(io, 'workflow.autonomous', options.mode, options.codeMode, options.json);
+    if (codeMode === null)
         return;
     try {
         validatePlanningInput(options.goal);
@@ -198,7 +198,7 @@ function runAutonomousWorkflow(io, options) {
             sessionId: '',
             goal: options.goal,
             mode: options.mode,
-            ...(soloMode ? { soloMode } : {}),
+            ...(codeMode ? { codeMode } : {}),
             maxWorkers,
             dryRun: true,
             config: readConfig(),
@@ -300,9 +300,9 @@ function addTechStatusOptions(command) {
 function addWorkflowRouteOptions(command, description) {
     return addJsonOption(command
         .description(description)
-        .requiredOption('--mode <mode>', 'workflow mode: solo or team')
+        .requiredOption('--mode <mode>', 'workflow mode: code or team')
         .requiredOption('--goal <goal>', 'planning goal')
-        .option('--solo-mode <mode>', 'solo mode: full-auto, guided, or rnd')
+        .option('--code-mode <mode>', 'code mode: full-auto, guided, or rnd')
         .option('--max-workers <count>', 'maximum worker count', '40')
         .option('--dry-run', 'preview without writing files', true)
         .option('--no-dry-run', 'unsupported: do not execute workflow planning from this CLI'));
@@ -330,7 +330,7 @@ function addAutonomousResumeInitOptions(command) {
 export function registerWorkflowCommands(program, io) {
     const refactor = program.command('refactor').description('Plan a Peaks refactor run without modifying code');
     addJsonOption(refactor
-        .option('--solo', 'use peaks-code orchestration mode')
+        .option('--code', 'use peaks-code orchestration mode')
         .option('--rd', 'use peaks-rd direct mode')
         .option('--dry-run', 'print gates and required artifacts', true)
         .option('--no-dry-run', 'unsupported: do not modify code from this command')).action((options) => {
@@ -338,12 +338,12 @@ export function registerWorkflowCommands(program, io) {
             failUnsupportedNonDryRun(io, 'refactor', options.json);
             return;
         }
-        if (options.solo && options.rd) {
-            printResult(io, fail('refactor', 'CONFLICTING_REFACTOR_MODE', 'Choose either --solo or --rd, not both', {}, ['Run peaks refactor --solo --dry-run']), options.json);
+        if (options.code && options.rd) {
+            printResult(io, fail('refactor', 'CONFLICTING_REFACTOR_MODE', 'Choose either --code or --rd, not both', {}, ['Run peaks refactor --code --dry-run']), options.json);
             process.exitCode = 1;
             return;
         }
-        const mode = options.rd ? 'rd' : 'solo';
+        const mode = options.rd ? 'rd' : 'code';
         printResult(io, ok('refactor', createRefactorDryRun(mode), [], ['This dry run never edits code']), options.json);
     });
     const tech = program.command('tech').description('Plan and inspect technical dry-run gates');

package/dist/src/cli/program.js

@@ -52,8 +52,12 @@ import { registerClassifyCommands } from './commands/classify-classify-commands.
 import { registerContextCommands } from './commands/context-commands.js';
 import { registerContractCommands } from './commands/contract-commands.js';
 import { registerSkillConformanceCommands } from './commands/skill-conformance-commands.js';
+import { registerSkillLoopEngineeringReadinessCommands } from './commands/skill-loop-engineering-readiness-commands.js';
 import { registerLoopCommands } from './commands/loop-commands.js';
 import { registerWorkflowEvalCommands } from './commands/loop-eval-commands.js';
+import { registerEvolutionCommands } from './commands/evolution-commands.js';
+import { registerAssetCommands } from './commands/asset-commands.js';
+import { registerBeeCommands } from './commands/bee-commands.js';
 import { registerAgentCommands } from './commands/agent-commands.js';
 import { registerUpgradeCommands } from './commands/upgrade-commands.js';
 import { registerCodeReviewCommands } from './commands/code-review-commands.js';
@@ -64,7 +68,7 @@ import { registerLogCommands } from './commands/log-commands.js';
 import { registerQaCommands } from './commands/qa-commands.js';
 import { registerTestCommands } from './commands/test-commands.js';
 import { registerPlaywrightCommands } from './commands/playwright-commands.js';
-import { registerSoloCommands } from './commands/solo-commands.js';
+import { registerCodeCommands } from './commands/code-commands.js';
 import { registerMutCommands } from './commands/mut-commands.js';
 import { registerFixtureCommands } from './commands/fixture-commands.js';
 import { registerReviewerCommands } from './commands/reviewer-commands.js';
@@ -289,16 +293,29 @@ Run peaks (no arguments) for a quickstart. You likely want one of:
     registerContextCommands(program, io);
     // Slice #12: peaks skills:audit-conformance — skill family alignment pass.
     registerSkillConformanceCommands(program, io);
+    // M6 (2026-07-07 spec §7.5 / §8.4): peaks skill lint --category
+    // loop-engineering-readiness — readiness gate for any new peaks-*
+    // skill that participates in Loop Engineering.
+    registerSkillLoopEngineeringReadinessCommands(program, io);
     // Slice #13: peaks swarm * — additional subcommands (pipeline /
     // dispatch / verify / loop) are added inline in workflow-commands.ts
     // alongside the existing swarm.plan. This avoids the duplicate top-level
     // command conflict (peaks-loop-when-adding-a-new-subcommand-check-for-existing-top-level-first).
     // Slice #14: peaks loop * + peaks goal compose — L4 Agent Loop sub-features.
     registerLoopCommands(program, io);
-    // Slice v3.0.0 loop-eng-native-solo-a-b: peaks workflow run|plan|lint
+    // Slice v3.0.0 loop-eng-native-code-a-b: peaks workflow run|plan|lint
     // + peaks loop eval. Wraps the existing workflow + loop groups so the
     // add-a-new-subcommand-check-for-existing-top-level-first rule is honoured.
     registerWorkflowEvalCommands(program, io);
+    // M4 (2026-07-07 spec): `peaks evolution propose|evaluate|revert|status|mark-keep`
+    // — Darwin-style ratchet CLI surface.
+    registerEvolutionCommands(program, io);
+    // M5 (2026-07-07 spec): `peaks asset crystallize|dispose|status` —
+    // umbrella cross-asset crystallization surface.
+    registerAssetCommands(program, io);
+    // M7 (2026-07-07 spec §7A.2 / §10 RL-9): `peaks bee export|import`
+    // — cross-user share surface for bee_release rows.
+    registerBeeCommands(program, io);
     // Slice: ECC 64 agents soft-optional (per spec §7.2 line 818).
     registerAgentCommands(program, io);
     // Slice: 1.x → 2.0 umbrella (per "one-key completion" + "minimal-user-operation" tenets).
@@ -321,10 +338,10 @@ Run peaks (no arguments) for a quickstart. You likely want one of:
     // Slice 2026-06-17-2.5.0-sub-fix-C: `peaks playwright start|ls|stop`
     // (multi-terminal Playwright MCP lifecycle).
     registerPlaywrightCommands(program, io);
-    // Slice 2 (peaks-code fast mode): `peaks solo plan [--fast] <change-id>`
-    // v2.11.0 Group F (D5 + D7): also registers `peaks solo should-pause` and
-    // `peaks solo post-compact-detect` for runtime-friction probes.
-    registerSoloCommands(program, io);
+    // Slice 2 (peaks-code fast mode): `peaks code plan [--fast] <change-id>`
+    // v2.11.0 Group F (D5 + D7): also registers `peaks code should-pause` and
+    // `peaks code post-compact-detect` for runtime-friction probes.
+    registerCodeCommands(program, io);
     // Plan 2 / Task 6: `peaks mut run|mutants|asserts|report` — mutation
     // testing + assertion validity scan (spec §4.2 / §7). The
     // production Stryker invoker is wired here; tests use the

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-code / 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-code / 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-code / 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-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/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,7 +20,7 @@ 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-code body) runs in the main-session Claude Code window and
      * wants to compress *its* context. Sub-agent shells pass

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\`.`
     };
 }
 /**
@@ -146,7 +146,7 @@ function appendAutoDecisionLog(input) {
     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

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

@@ -20,7 +20,7 @@
  *    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/`:
+ * 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.

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

@@ -20,7 +20,7 @@
  *    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/`:
+ * 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.

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,7 +42,7 @@ 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
+ * 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
@@ -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
@@ -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;

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

@@ -19,7 +19,7 @@
  * Re-uses `SkillPresenceMode` from `skill-presence-service.ts` so the
  * 4 mode values stay in lockstep with the rest of the runtime.
  */
-export const SOLO_MODES = [
+export const CODE_MODES = [
     'full-auto',
     'assisted',
     'swarm',
@@ -47,8 +47,8 @@ export const GATED_STEPS = [
     'step-0.75-checkpoint-resume',
     'standards-preflight'
 ];
-export function isSoloMode(value) {
-    return SOLO_MODES.includes(value);
+export function isCodeMode(value) {
+    return CODE_MODES.includes(value);
 }
 export function isHardFloorCategory(value) {
     return HARD_FLOOR_CATEGORIES.includes(value);
@@ -75,7 +75,7 @@ export function isCommitBoundaryAction(value) {
  * Hard-pause steps: these pause regardless of mode. They are the gates
  * whose decision *creates* or *recreates* the mode/state under which
  * later gates run. Auto-proceeding on them would silently fix the mode
- * without user consent (defect #1: new Solo session skipped Step 1
+ * without user consent (defect #1: new Code session skipped Step 1
  * AskUserQuestion because `full-auto` mode triggered `shouldAutoProceed`
  * on `step-1-mode-select` itself).
  *
@@ -115,7 +115,7 @@ export function shouldPauseAtGate(opts) {
             gateKind: 'hard-floor'
         };
     }
-    // Slice 2026-06-28-solo-mode-bypass-fix: hard-pause steps that
+    // Slice 2026-06-28-code-mode-bypass-fix: hard-pause steps that
     // determine the active mode or session context MUST prompt the
     // user. Otherwise full-auto silently locks in `mode=full-auto` on
     // the first tool call, skipping the AskUserQuestion Step 1 mandates.

package/dist/src/services/{solo → code}/post-compact-detector.d.ts

@@ -7,7 +7,7 @@
  *   1. `.peaks/_runtime/<sessionId>/` is bound
  *   2. Latest checkpoint mtime is from today (UTC date)
  *   3. Latest checkpoint has a parseable `mode` field
- *   4. The peak-solo skill is the active skill
+ *   4. The peak-code skill is the active skill
  *   5. Exactly one session has a today's checkpoint (no ambiguity)
  *
  * On a hit, the LLM MUST auto-resume (D7.b override of "never silently
@@ -22,13 +22,13 @@
  * No writes (caller logs the decision via the auto-decisions channel).
  */
 import type { SkillPresenceMode } from '../skills/skill-presence-service.js';
-import { type SoloMode } from './mode-gate.js';
+import { type CodeMode } from './mode-gate.js';
 export type PostCompactResumeReason = 'post-compact-match' | 'sid-unbound' | 'runtime-dir-missing' | 'no-checkpoint-today' | 'no-mode-field' | 'stale-checkpoint' | 'multiple-checkpoints-ambiguous' | 'active-skill-mismatch' | 'checkpoint-read-failed';
 export declare const POST_COMPACT_RESUME_REASONS: readonly PostCompactResumeReason[];
 export interface PostCompactResumeProbe {
     readonly shouldAutoResume: boolean;
     readonly reason: PostCompactResumeReason;
-    readonly mode?: SoloMode;
+    readonly mode?: CodeMode;
     readonly checkpointPath?: string;
     readonly checkpointMtime?: string;
     readonly task?: string;