peaks-loop 4.0.54 → 4.1.1

package/dist/cli/commands/sop-commands.js

@@ -40,7 +40,9 @@ export function registerSopCommands(program, io) {
             printResult(io, ok('sop.init', result, [], nextActions), options.json);
         }
         catch (error) {
-            printResult(io, fail('sop.init', 'SOP_INIT_FAILED', getErrorMessage(error), { id: options.id }, ['Check the SOP id before retrying']), options.json);
+            printResult(io, fail('sop.init', 'SOP_INIT_FAILED', getErrorMessage(error), { id: options.id }, [
+                'Check the SOP id before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -72,7 +74,9 @@ export function registerSopCommands(program, io) {
             }
         }
         catch (error) {
-            printResult(io, fail('sop.lint', 'SOP_LINT_ERROR', getErrorMessage(error), { id: options.id }, ['Check the SOP id before retrying']), options.json);
+            printResult(io, fail('sop.lint', 'SOP_LINT_ERROR', getErrorMessage(error), { id: options.id }, [
+                'Check the SOP id before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -99,7 +103,9 @@ export function registerSopCommands(program, io) {
         }
         catch (error) {
             const code = error instanceof SopRegisterError ? error.code : 'SOP_REGISTER_FAILED';
-            printResult(io, fail('sop.register', code, getErrorMessage(error), { id: options.id }, ['Run peaks sop lint to see why the SOP is not registrable']), options.json);
+            printResult(io, fail('sop.register', code, getErrorMessage(error), { id: options.id }, [
+                'Run peaks sop lint to see why the SOP is not registrable'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -112,7 +118,9 @@ export function registerSopCommands(program, io) {
             printResult(io, ok('sop.registry', registry), options.json);
         }
         catch (error) {
-            printResult(io, fail('sop.registry', 'SOP_REGISTRY_FAILED', getErrorMessage(error), {}, ['The global registry may be corrupted; inspect ~/.peaks/sops/registry.json']), options.json);
+            printResult(io, fail('sop.registry', 'SOP_REGISTRY_FAILED', getErrorMessage(error), {}, [
+                'The global registry may be corrupted; inspect ~/.peaks/sops/registry.json'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -124,7 +132,11 @@ export function registerSopCommands(program, io) {
         .option('--project <path>', 'project the gate evaluates against (default: current directory)', '.')
         .option('--allow-commands', 'permit evaluating command-type gates')).action(async (options) => {
         try {
-            const checkOptions = { projectRoot: options.project, id: options.id, gateId: options.gate };
+            const checkOptions = {
+                projectRoot: options.project,
+                id: options.id,
+                gateId: options.gate
+            };
             if (options.allowCommands === true) {
                 checkOptions.allowCommands = true;
             }
@@ -133,7 +145,9 @@ export function registerSopCommands(program, io) {
         }
         catch (error) {
             const code = error instanceof SopCheckError ? error.code : 'SOP_CHECK_FAILED';
-            printResult(io, fail('sop.check', code, getErrorMessage(error), { id: options.id, gateId: options.gate }, ['Verify the SOP id and gate id with peaks sop lint']), options.json);
+            printResult(io, fail('sop.check', code, getErrorMessage(error), { id: options.id, gateId: options.gate }, [
+                'Verify the SOP id and gate id with peaks sop lint'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -153,7 +167,8 @@ export function registerSopCommands(program, io) {
             // Bypass policy mirrors `request transition`: a bypass needs a reason, and
             // in assisted/strict mode (resolved from the target project) it needs an
             // explicit --confirm and counts against the per-SOP bypass cap.
-            if (options.allowIncomplete === true && (options.reason === undefined || options.reason.trim().length === 0)) {
+            if (options.allowIncomplete === true &&
+                (options.reason === undefined || options.reason.trim().length === 0)) {
                 printResult(io, fail('sop.advance', 'BYPASS_REASON_REQUIRED', '--allow-incomplete requires --reason explaining why the gates are skipped', { id: options.id, to: options.to }, ['Add --reason "<short justification>" or satisfy the gates']), options.json);
                 process.exitCode = 1;
                 return;
@@ -184,7 +199,11 @@ export function registerSopCommands(program, io) {
                     }
                 }
             }
-            const advanceOptions = { projectRoot: options.project, id: options.id, toPhase: options.to };
+            const advanceOptions = {
+                projectRoot: options.project,
+                id: options.id,
+                toPhase: options.to
+            };
             if (options.allowCommands === true)
                 advanceOptions.allowCommands = true;
             if (options.allowIncomplete === true)
@@ -203,12 +222,21 @@ export function registerSopCommands(program, io) {
                 return;
             }
             if (error instanceof SopPhaseSkipError) {
-                printResult(io, fail('sop.advance', error.code, error.message, { id: options.id, to: options.to, fromPhase: error.fromPhase, expectedNext: error.expectedNext }, [`Advance to "${error.expectedNext}" first, or bypass with --allow-incomplete --reason "<why>"`]), options.json);
+                printResult(io, fail('sop.advance', error.code, error.message, {
+                    id: options.id,
+                    to: options.to,
+                    fromPhase: error.fromPhase,
+                    expectedNext: error.expectedNext
+                }, [
+                    `Advance to "${error.expectedNext}" first, or bypass with --allow-incomplete --reason "<why>"`
+                ]), options.json);
                 process.exitCode = 1;
                 return;
             }
             const code = error instanceof SopAdvanceError ? error.code : 'SOP_ADVANCE_FAILED';
-            printResult(io, fail('sop.advance', code, getErrorMessage(error), { id: options.id, to: options.to }, ['Verify the SOP id and phase with peaks sop lint']), options.json);
+            printResult(io, fail('sop.advance', code, getErrorMessage(error), { id: options.id, to: options.to }, [
+                'Verify the SOP id and phase with peaks sop lint'
+            ]), options.json);
             process.exitCode = 1;
         }
     });

package/dist/cli/commands/statusline-commands.d.ts

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 type RenderOptions = {
     project?: string;

package/dist/cli/commands/statusline-commands.js

@@ -2,12 +2,12 @@ import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult, getErrorMessage } from '../cli-helpers.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { buildStatusLineModel, parseStatusLineStdin } from '../../services/skills/skill-statusline-service.js';
-import { renderStatusLine, resolveStatusLineCapability, } from '../../services/skills/skill-statusline-renderer.js';
+import { renderStatusLine, resolveStatusLineCapability } from '../../services/skills/skill-statusline-renderer.js';
 import { applyStatusLineInstall, planStatusLineInstall, removeStatusLineInstall } from '../../services/skills/statusline-settings-service.js';
 import { readHookStatus as readSettingsStatus } from '../../services/skills/hooks-settings-service.js';
 import { detectIdeFromContext } from '../../services/ide/hook-translator.js';
 import { resolveIdeOptionHelp } from '../../services/ide/ide-registry.js';
-import { decideCompactStatusline, renderCompactStatusline, } from '../../services/compact-statusline/compact-statusline-service.js';
+import { decideCompactStatusline, renderCompactStatusline } from '../../services/compact-statusline/compact-statusline-service.js';
 import { getSessionIdCanonical } from '../../services/session/session-manager.js';
 import { writeHarnessWitness } from '../../services/context/harness-context-witness.js';
 const STDIN_READ_TIMEOUT_MS = 250;
@@ -82,7 +82,11 @@ function resolveIdeForCommand(options, projectRoot) {
     if (options.ide !== undefined && options.ide.length > 0) {
         return options.ide;
     }
-    return detectIdeFromContext({ env: process.env, cwd: projectRoot ?? process.cwd(), parsedStdin: null });
+    return detectIdeFromContext({
+        env: process.env,
+        cwd: projectRoot ?? process.cwd(),
+        parsedStdin: null
+    });
 }
 /**
  * Default-statusline render body. Reused by both the top-level default
@@ -120,11 +124,11 @@ export async function runDefaultStatuslineRender(options, io) {
         projectRoot: model.projectRoot,
         sessionId: model.sessionId,
         stdin,
-        nowMs: now,
+        nowMs: now
     });
     const capability = resolveStatusLineCapability({
         env: process.env,
-        isTTY: Boolean(process.stdout.isTTY),
+        isTTY: Boolean(process.stdout.isTTY)
     });
     const text = renderStatusLine(model, { capability }, process.env);
     if (options.json === true) {
@@ -188,14 +192,21 @@ export function registerStatusLineCommands(program, io) {
             if (options.dryRun) {
                 const plan = planStatusLineInstall(scope, projectRoot, { ide });
                 const warnings = plan.conflict
-                    ? [`An existing statusLine command is set: ${plan.conflictCommand}. Rerun with --force to overwrite.`]
+                    ? [
+                        `An existing statusLine command is set: ${plan.conflictCommand}. Rerun with --force to overwrite.`
+                    ]
                     : [];
                 printResult(io, ok('statusline.install', { ...plan, ide, applied: false, dryRun: true }, warnings), options.json);
                 return;
             }
-            const result = applyStatusLineInstall(scope, projectRoot, { force: options.force === true, ide });
+            const result = applyStatusLineInstall(scope, projectRoot, {
+                force: options.force === true,
+                ide
+            });
             const warnings = result.conflict && !result.applied
-                ? [`An existing statusLine command is set: ${result.conflictCommand}. Rerun with --force to overwrite.`]
+                ? [
+                    `An existing statusLine command is set: ${result.conflictCommand}. Rerun with --force to overwrite.`
+                ]
                 : [];
             const nextActions = result.applied
                 ? ['Restart the IDE (or reload the workspace) so the status line takes effect']
@@ -285,7 +296,7 @@ export function registerStatusLineCommands(program, io) {
         // `compact --json emits the documented envelope` integration test.
         const merged = {
             ...options,
-            ...command.optsWithGlobals?.(),
+            ...command.optsWithGlobals?.()
         };
         try {
             const projectRoot = merged.project !== undefined
@@ -300,7 +311,7 @@ export function registerStatusLineCommands(program, io) {
             const state = decideCompactStatusline({
                 projectRoot,
                 sessionId: sid,
-                now,
+                now
             });
             const label = renderCompactStatusline(state);
             // For non-JSON mode we print the LABEL DIRECTLY to stdout

package/dist/cli/commands/sub-agent/detached.js

@@ -50,12 +50,12 @@ export async function dispatch(f) {
         sid,
         rid: f.requestId,
         role: f.role,
-        vendor: (f.vendor ?? 'claude'),
+        vendor: f.vendor ?? 'claude',
         userTask: f.prompt,
         files: [],
         refs: [],
         runtimeDir: `.peaks/_runtime/${sid}/detached`,
-        subAgentsDir: `.peaks/_sub_agents/${sid}`,
+        subAgentsDir: `.peaks/_sub_agents/${sid}`
     });
     // The launch outcome is the envelope's `ok`, not a footnote. A vendor CLI
     // that is not installed is an expected environment, and the dispatch record
@@ -84,7 +84,7 @@ export async function dispatch(f) {
                     spawnError: { code: spawnError.code, message: spawnError.message },
                     orchestratorVisibleHint: `❌ Could not launch detached sub-agent via ${f.vendor ?? 'claude'}: rid=${f.requestId} (${spawnError.code})`
                 }),
-            expectedCompletionSeconds: 60,
+            expectedCompletionSeconds: 60
         },
         warnings,
         nextActions: spawnError === null

package/dist/cli/commands/sub-agent-dispatch-guard.d.ts

@@ -20,7 +20,7 @@
  * The `peaks hooks install` command reads `IdeAdapter.promptSizeAware`
  * to decide whether to register this hook for a given IDE.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ContextGuardDecision } from '../../services/context/context-guard.js';
 export declare const HOOK_GUARD_RESULT_TYPE: "peaks-hook-guard/v1";
 export interface HookGuardResult {

package/dist/cli/commands/sub-agent-shared.js

@@ -51,7 +51,7 @@ export function validateRole(role) {
     }
     for (let i = 0; i < role.length; i += 1) {
         const code = role.charCodeAt(i);
-        if (code <= 0x20 || code === 0x7F) {
+        if (code <= 0x20 || code === 0x7f) {
             return 'role must not contain whitespace or control characters';
         }
     }

package/dist/cli/commands/sub-agent-shutdown-commands.js

@@ -44,8 +44,10 @@ export function registerSubAgentShutdownCommands(program, io) {
     // to a standalone `peaks sub-agent-shutdown` parent if the parent
     // is not yet registered (e.g. when this file is loaded in isolation).
     const existing = program.commands.find((c) => c.name() === 'sub-agent');
-    const root = existing ?? program.command('sub-agent-shutdown')
-        .description('Sub-agent shutdown registration (forensic hook)');
+    const root = existing ??
+        program
+            .command('sub-agent-shutdown')
+            .description('Sub-agent shutdown registration (forensic hook)');
     const shutdown = root
         .command('shutdown')
         .description('Register local services for the parent to kill before merge-back');
@@ -62,19 +64,21 @@ export function registerSubAgentShutdownCommands(program, io) {
             const file = registrationsPath({
                 projectRoot: sessionRoot,
                 sessionId: sid,
-                dispatchId: resolveDispatchId(options),
+                dispatchId: resolveDispatchId(options)
             });
             const all = readAll(file);
             const reg = {
                 pid: Number(options.pid),
                 name: options.name,
-                ...(options.url !== undefined ? { url: options.url } : {}),
+                ...(options.url !== undefined ? { url: options.url } : {})
             };
             writeAll(file, [...all, reg]);
             printResult(io, ok('sub-agent.shutdown.register', { file, reg }), options.json);
         }
         catch (error) {
-            printResult(io, fail('sub-agent.shutdown.register', 'REGISTER_FAILED', getErrorMessage(error), {}, [getErrorMessage(error)]), options.json);
+            printResult(io, fail('sub-agent.shutdown.register', 'REGISTER_FAILED', getErrorMessage(error), {}, [
+                getErrorMessage(error)
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -88,14 +92,16 @@ export function registerSubAgentShutdownCommands(program, io) {
             const file = registrationsPath({
                 projectRoot: sessionRoot,
                 sessionId: sid,
-                dispatchId: resolveDispatchId(options),
+                dispatchId: resolveDispatchId(options)
             });
             const filtered = readAll(file).filter((r) => r.pid !== Number(options.pid));
             writeAll(file, filtered);
             printResult(io, ok('sub-agent.shutdown.unregister', { file, removed: options.pid }), options.json);
         }
         catch (error) {
-            printResult(io, fail('sub-agent.shutdown.unregister', 'UNREGISTER_FAILED', getErrorMessage(error), {}, [getErrorMessage(error)]), options.json);
+            printResult(io, fail('sub-agent.shutdown.unregister', 'UNREGISTER_FAILED', getErrorMessage(error), {}, [
+                getErrorMessage(error)
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -109,12 +115,14 @@ export function registerSubAgentShutdownCommands(program, io) {
             const file = registrationsPath({
                 projectRoot: sessionRoot,
                 sessionId: sid,
-                dispatchId: resolveDispatchId(options),
+                dispatchId: resolveDispatchId(options)
             });
             printResult(io, ok('sub-agent.shutdown.list', { file, registrations: readAll(file) }), options.json);
         }
         catch (error) {
-            printResult(io, fail('sub-agent.shutdown.list', 'LIST_FAILED', getErrorMessage(error), {}, [getErrorMessage(error)]), options.json);
+            printResult(io, fail('sub-agent.shutdown.list', 'LIST_FAILED', getErrorMessage(error), {}, [
+                getErrorMessage(error)
+            ]), options.json);
             process.exitCode = 1;
         }
     });

package/dist/cli/commands/swarm-commands.d.ts

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export type SwarmPlanOptions = {
     skill?: string;

package/dist/cli/commands/swarm-commands.js

@@ -10,22 +10,29 @@ function projectContext() {
     const workspace = getWorkspaceConfigForPath(projectRoot);
     return {
         workspaceRoot: workspace ? getLocalArtifactPath(workspace) : projectRoot,
-        ...(workspace ? { workspace } : {}),
+        ...(workspace ? { workspace } : {})
     };
 }
 export async function runSwarmPlan(io, options) {
     if ((options.skill ?? 'rd') !== 'rd') {
-        printResult(io, fail('swarm.plan', 'UNSUPPORTED_SWARM_SKILL', `Unsupported skill ${options.skill}`, {}, ['Use --skill rd']), options.json);
+        printResult(io, fail('swarm.plan', 'UNSUPPORTED_SWARM_SKILL', `Unsupported skill ${options.skill}`, {}, [
+            'Use --skill rd'
+        ]), options.json);
         process.exitCode = 1;
         return;
     }
     if (options.dryRun === false) {
-        printResult(io, fail('swarm.plan', 'UNSUPPORTED_NON_DRY_RUN', 'Only dry-run planning is supported', {}, ['Rerun with --dry-run or omit --no-dry-run']), options.json);
+        printResult(io, fail('swarm.plan', 'UNSUPPORTED_NON_DRY_RUN', 'Only dry-run planning is supported', {}, [
+            'Rerun with --dry-run or omit --no-dry-run'
+        ]), options.json);
         process.exitCode = 1;
         return;
     }
-    if (options.codeMode !== undefined && !['full-auto', 'guided', 'rnd'].includes(options.codeMode)) {
-        printResult(io, fail('swarm.plan', 'UNSUPPORTED_CODE_MODE', `Unsupported code mode ${options.codeMode}`, {}, ['Use --code-mode full-auto, guided, or rnd']), options.json);
+    if (options.codeMode !== undefined &&
+        !['full-auto', 'guided', 'rnd'].includes(options.codeMode)) {
+        printResult(io, fail('swarm.plan', 'UNSUPPORTED_CODE_MODE', `Unsupported code mode ${options.codeMode}`, {}, [
+            'Use --code-mode full-auto, guided, or rnd'
+        ]), options.json);
         process.exitCode = 1;
         return;
     }
@@ -41,7 +48,7 @@ export async function runSwarmPlan(io, options) {
             dryRun: true,
             workspaceRoot: context.workspaceRoot,
             ...(context.workspace ? { workspace: context.workspace } : {}),
-            requiresTechApproval: false,
+            requiresTechApproval: false
         };
         const plan = planRdSwarmGraph(request);
         if (!plan.available) {

package/dist/cli/commands/tech-commands-helpers.d.ts

@@ -0,0 +1,37 @@
+import type { WorkspaceConfig } from '../../services/config/config-types.js';
+import type { TechChangeArtifacts, TechChangeStatus } from '../../services/tech/tech-change-id-service.js';
+export interface TechChangeIdPlanOptions {
+    changeId: string;
+    goal: string;
+    swarm?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+}
+export interface TechChangeIdStatusOptions {
+    changeId: string;
+    json?: boolean;
+}
+export type TechChangeIdPlanResult = {
+    available: true;
+    changeId: string;
+    goal: string;
+    swarm: boolean;
+    dryRun: true;
+    artifactRoot: string;
+    artifacts: {
+        taskGraph: string;
+        waveManifests: string[];
+        reviewChecklist: string;
+        approvalTemplate: string;
+    };
+    blockedReasons: string[];
+    nextActions: string[];
+};
+export type TechChangeIdStatusResult = TechChangeStatus;
+export interface ChangeIdWorkspaceContext {
+    projectRoot?: string;
+    workspace?: WorkspaceConfig;
+    artifactWorkspacePath?: string;
+}
+export declare function resolveChangeIdWorkspaceContext(): ChangeIdWorkspaceContext;
+export declare function flattenArtifacts(value: TechChangeArtifacts): TechChangeIdPlanResult['artifacts'];

package/dist/cli/commands/tech-commands-helpers.js

@@ -0,0 +1,24 @@
+/**
+ * Support types + pure helpers extracted verbatim from `tech-commands.ts`
+ * (file-size cap campaign). Mechanical move only: the change-id option/result
+ * declarations, the workspace-context resolver and the artifact-path
+ * flattener. `tech-commands.ts` re-exports the public types from here.
+ */
+import { findProjectRoot } from '../../services/config/config-safety.js';
+export function resolveChangeIdWorkspaceContext() {
+    try {
+        const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
+        return { projectRoot };
+    }
+    catch {
+        return {};
+    }
+}
+export function flattenArtifacts(value) {
+    return {
+        taskGraph: value.taskGraph.jsonSafeRelativePath,
+        waveManifests: value.waveManifests.map((w) => w.jsonSafeRelativePath),
+        reviewChecklist: value.reviewChecklist.jsonSafeRelativePath,
+        approvalTemplate: value.approvalTemplate.jsonSafeRelativePath
+    };
+}

package/dist/cli/commands/tech-commands.d.ts

@@ -20,36 +20,9 @@
 import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 import type { WorkspaceConfig } from '../../services/config/config-types.js';
-import { type TechChangeStatus, type WorkspaceConfig as _WorkspaceConfig } from '../../services/tech/tech-change-id-service.js';
+import { type WorkspaceConfig as _WorkspaceConfig } from '../../services/tech/tech-change-id-service.js';
 export type { WorkspaceConfig };
-export interface TechChangeIdPlanOptions {
-    changeId: string;
-    goal: string;
-    swarm?: boolean;
-    dryRun?: boolean;
-    json?: boolean;
-}
-export interface TechChangeIdStatusOptions {
-    changeId: string;
-    json?: boolean;
-}
-export type TechChangeIdPlanResult = {
-    available: true;
-    changeId: string;
-    goal: string;
-    swarm: boolean;
-    dryRun: true;
-    artifactRoot: string;
-    artifacts: {
-        taskGraph: string;
-        waveManifests: string[];
-        reviewChecklist: string;
-        approvalTemplate: string;
-    };
-    blockedReasons: string[];
-    nextActions: string[];
-};
-export type TechChangeIdStatusResult = TechChangeStatus;
+export type { TechChangeIdPlanOptions, TechChangeIdStatusOptions, TechChangeIdPlanResult, TechChangeIdStatusResult } from './tech-commands-helpers.js';
 export declare function addTechChangeIdPlanOptions(command: Command): Command;
 export declare function addTechChangeIdStatusOptions(command: Command): Command;
 /**

package/dist/cli/commands/tech-commands.js

@@ -20,17 +20,8 @@
 import { addJsonOption, failUnsupportedNonDryRun, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { mapServiceError } from './_cli-error-envelope.js';
-import { findProjectRoot } from '../../services/config/config-safety.js';
-import { buildTechWorkspaceUnavailable, planTechArtifactPath, validateTechChangeId, } from '../../services/tech/tech-change-id-service.js';
-function resolveChangeIdWorkspaceContext() {
-    try {
-        const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
-        return { projectRoot };
-    }
-    catch {
-        return {};
-    }
-}
+import { buildTechWorkspaceUnavailable, planTechArtifactPath, validateTechChangeId } from '../../services/tech/tech-change-id-service.js';
+import { flattenArtifacts, resolveChangeIdWorkspaceContext } from './tech-commands-helpers.js';
 // --- Handlers -------------------------------------------------------------
 function runTechChangeIdPlan(io, options) {
     if (options.dryRun === false) {
@@ -64,13 +55,13 @@ function runTechChangeIdPlan(io, options) {
                         `${validation.value.changeId}/architecture/waves/wave-1-scan.json`,
                         `${validation.value.changeId}/architecture/waves/wave-2-document.json`,
                         `${validation.value.changeId}/architecture/waves/wave-3-review.json`,
-                        `${validation.value.changeId}/architecture/waves/wave-4-reducer.json`,
+                        `${validation.value.changeId}/architecture/waves/wave-4-reducer.json`
                     ],
                     reviewChecklist: `${validation.value.changeId}/architecture/tech-review-checklist.md`,
-                    approvalTemplate: `${validation.value.changeId}/architecture/tech-approval-record.template.md`,
+                    approvalTemplate: `${validation.value.changeId}/architecture/tech-approval-record.template.md`
                 },
                 blockedReasons: [unavailable.reason],
-                nextActions: [...unavailable.nextActions],
+                nextActions: [...unavailable.nextActions]
             };
             printResult(io, ok('tech.plan.change-id', previewData), options.json);
             return;
@@ -80,7 +71,7 @@ function runTechChangeIdPlan(io, options) {
         const planResult = planTechArtifactPath({
             changeId: validation.value.changeId,
             workspaceRoot: artifactWorkspacePath,
-            requestId: 'change-id',
+            requestId: 'change-id'
         });
         if (!planResult.ok) {
             printResult(io, fail('tech.plan.change-id', 'INVALID_CHANGE_ID', planResult.error.message, { code: planResult.error.code }, ['Use a change-id matching [A-Za-z0-9][A-Za-z0-9._-]*']), options.json);
@@ -96,24 +87,18 @@ function runTechChangeIdPlan(io, options) {
             artifactRoot: `${validation.value.changeId}/architecture`,
             artifacts: flattenArtifacts(planResult.value),
             blockedReasons: [],
-            nextActions: [],
+            nextActions: []
         };
         printResult(io, ok('tech.plan.change-id', data), options.json);
     }
     catch (error) {
         const mapping = mapServiceError(error);
-        printResult(io, fail('tech.plan.change-id', mapping.code, getErrorMessage(error), {}, [...mapping.nextActions]), options.json);
+        printResult(io, fail('tech.plan.change-id', mapping.code, getErrorMessage(error), {}, [
+            ...mapping.nextActions
+        ]), options.json);
         process.exitCode = 1;
     }
 }
-function flattenArtifacts(value) {
-    return {
-        taskGraph: value.taskGraph.jsonSafeRelativePath,
-        waveManifests: value.waveManifests.map((w) => w.jsonSafeRelativePath),
-        reviewChecklist: value.reviewChecklist.jsonSafeRelativePath,
-        approvalTemplate: value.approvalTemplate.jsonSafeRelativePath,
-    };
-}
 function runTechChangeIdStatus(io, options) {
     // Validate change-id first — reject before any fs read.
     const validation = validateTechChangeId(options.changeId);
@@ -134,7 +119,7 @@ function runTechChangeIdStatus(io, options) {
                 missingArtifacts: [],
                 approvalRecord: null,
                 blockedReasons: [unavailable.reason],
-                nextActions: [...unavailable.nextActions],
+                nextActions: [...unavailable.nextActions]
             };
             printResult(io, ok('tech.status.change-id', status), options.json);
             return;
@@ -148,12 +133,14 @@ function runTechChangeIdStatus(io, options) {
             missingArtifacts: [],
             approvalRecord: `${validation.value.changeId}/architecture/tech-approval-record.md`,
             blockedReasons: [],
-            nextActions: [],
+            nextActions: []
         };
         printResult(io, ok('tech.status.change-id', status), options.json);
     }
     catch (error) {
-        printResult(io, fail('tech.status.change-id', 'TECH_STATUS_FAILED', getErrorMessage(error), {}, ['Verify the project setup']), options.json);
+        printResult(io, fail('tech.status.change-id', 'TECH_STATUS_FAILED', getErrorMessage(error), {}, [
+            'Verify the project setup'
+        ]), options.json);
         process.exitCode = 1;
     }
 }

package/dist/cli/commands/test-commands.js

@@ -169,16 +169,32 @@ export function resolveRunner(framework, argv, projectRoot, deps = {}) {
     searched.push(pkgJsonPath);
     const entry = exists(pkgJsonPath) ? readBinEntry(pkgJsonPath, framework, read) : null;
     if (entry !== null && exists(entry)) {
-        return { ok: true, command: nodeExec, args: [entry, ...argv], via: `local ${entry}`, fromPath: false };
+        return {
+            ok: true,
+            command: nodeExec,
+            args: [entry, ...argv],
+            via: `local ${entry}`,
+            fromPath: false
+        };
     }
     if (shim !== null) {
-        return { ok: true, ...toSpawnable(shim, argv, platform, env), via: `local ${shim}`, fromPath: false };
+        return {
+            ok: true,
+            ...toSpawnable(shim, argv, platform, env),
+            via: `local ${shim}`,
+            fromPath: false
+        };
     }
     // 3. PATH — last resort.
     const onPath = resolveFromPath(framework, platform, env, exists);
     searched.push(`PATH lookup for "${framework}"`);
     if (onPath !== null) {
-        return { ok: true, ...toSpawnable(onPath, argv, platform, env), via: `PATH: ${onPath}`, fromPath: true };
+        return {
+            ok: true,
+            ...toSpawnable(onPath, argv, platform, env),
+            via: `PATH: ${onPath}`,
+            fromPath: true
+        };
     }
     return { ok: false, searched };
 }
@@ -208,8 +224,12 @@ export function runRunner(framework, argv, projectRoot, deps = {}) {
         });
         let stdout = '';
         let stderr = '';
-        proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
-        proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+        proc.stdout.on('data', (chunk) => {
+            stdout += chunk.toString('utf8');
+        });
+        proc.stderr.on('data', (chunk) => {
+            stderr += chunk.toString('utf8');
+        });
         proc.on('error', (err) => reject(err));
         proc.on('close', (code) => {
             resolveRun({ code: code ?? 0, stdout, stderr, notice });
@@ -219,7 +239,7 @@ export function runRunner(framework, argv, projectRoot, deps = {}) {
 export function registerTestCommands(program, _io) {
     const test = program
         .command('test')
-        .description('Wrap the consumer project\'s test framework (jest/vitest/mocha) ' +
+        .description("Wrap the consumer project's test framework (jest/vitest/mocha) " +
         'with a per-test fingerprint cache. Default args: <pattern...> ' +
         'runs jest|vitest|mocha <pattern> --cache. Exit 0 on all-pass / ' +
         'all-skip, exit 1 on any failure. (slice 2.5.0 sub-fix B)')
@@ -229,7 +249,7 @@ export function registerTestCommands(program, _io) {
         .option('--clear-cache', 'empty the fingerprint cache at .peaks/_runtime/test-cache/ and exit 0')
         .option('--no-cache-result', 'bypass the per-test fingerprint cache (always re-run)')
         .option('--no-cache', 'pass --no-cache to the underlying framework (overrides peaks default)')
-        .option('--passthrough', 'do NOT override the consumer\'s argv; pass patterns through verbatim')
+        .option('--passthrough', "do NOT override the consumer's argv; pass patterns through verbatim")
         .option('--framework <name>', `force a specific framework: ${FRAMEWORKS.join(', ')}`)
         .option('--project <path>', 'project root (defaults to current directory)', process.cwd())
         .option('--json', 'emit a JSON envelope { ok, data } to stdout')