peaks-loop 4.0.53 → 4.1.0

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

@@ -34,7 +34,7 @@ import { playwrightProfilePaths } from '../../services/worktree/playwright-profi
 import { loadPreferences } from '../../services/preferences/preferences-service.js';
 import { DEFAULT_PREFERENCES } from '../../services/preferences/preferences-types.js';
 import { writeLogEntry } from '../../services/log/logger.js';
-import { PROMPT_LIMIT_BYTES, RECOMMENDED_ROLES, validateRole } from './sub-agent-shared.js';
+import { PROMPT_LIMIT_BYTES, RECOMMENDED_ROLES, deprecatedReviewerWarnings, validateRole } from './sub-agent-shared.js';
 import { runDispatchFromDag } from './dispatch-from-dag.js';
 import { TEST_TOOL_DETECTION_BLOCK } from '../../services/dispatch/test-tool-detection.js';
 import { MemoryPreflightService, deriveMemoryQuery } from '../../services/context/memory-preflight-service.js';
@@ -42,7 +42,7 @@ import { buildDispatchSystemPrompt } from '../../services/context/build-dispatch
 import { readSessionCapsule } from '../../services/dispatch/session-capsule.js';
 import { computeUiLibraryDispatchBlock } from '../../services/standards/ui-library-dispatch-block.js';
 import { readFreshContextBlock } from '../../services/fresh-context/fresh-context-block.js';
-import { createDispatchProvenanceToken, DISPATCH_PROVENANCE_ENV, writeDispatchProvenance, } from '../../services/worktree/dispatch-provenance.js';
+import { createDispatchProvenanceToken, DISPATCH_PROVENANCE_ENV, writeDispatchProvenance } from '../../services/worktree/dispatch-provenance.js';
 import { spawnWorktreeLease, spawnContainerLease } from '../../services/dispatch/isolation-lease.js';
 import { runGitLsFiles } from '../../services/dispatch/dispatch-sub-agent.js';
 export function registerDispatchCommand(parent, io) {
@@ -123,9 +123,11 @@ export function registerDispatchCommand(parent, io) {
                     project: projectRoot,
                     json: asJson,
                     ...(options.noThrottle === true ? { noThrottle: true } : {}),
-                    ...(typeof maxConcurrent === 'number' && Number.isInteger(maxConcurrent) && maxConcurrent > 0
+                    ...(typeof maxConcurrent === 'number' &&
+                        Number.isInteger(maxConcurrent) &&
+                        maxConcurrent > 0
                         ? { maxConcurrent }
-                        : {}),
+                        : {})
                 });
                 // The handler's `ok` is the launch outcome (a vendor CLI that is not
                 // installed is a failure, not a footnote) — the caller must not
@@ -177,7 +179,12 @@ export function registerDispatchCommand(parent, io) {
         // so `peaks sub-agent dispatch agent --help` continues to
         // exit 0 with the help text — that is intentional, not a bug.
         if (role === 'agent') {
-            printResult(io, fail('sub-agent.dispatch', 'ROLE_REMOVED', 'The agent role was removed in Slice 3', { role, reason: 'role-removed-in-slice-3', toolCall: null, dispatchRecordPath: null }, []), asJson);
+            printResult(io, fail('sub-agent.dispatch', 'ROLE_REMOVED', 'The agent role was removed in Slice 3', {
+                role,
+                reason: 'role-removed-in-slice-3',
+                toolCall: null,
+                dispatchRecordPath: null
+            }, []), asJson);
             process.exitCode = 1;
             return;
         }
@@ -234,10 +241,10 @@ export function registerDispatchCommand(parent, io) {
             // of the `unknown-sid` fallback. The unknown-sid branch is preserved
             // as the last-resort so callers without a bound session (e.g. an
             // ad-hoc dispatch in a fresh tree) still get a deterministic path.
-            const sid = options.sessionId
-                ?? process.env.PEAKS_SESSION_ID
-                ?? getCurrentSessionId(projectRoot)
-                ?? 'unknown-sid';
+            const sid = options.sessionId ??
+                process.env.PEAKS_SESSION_ID ??
+                getCurrentSessionId(projectRoot) ??
+                'unknown-sid';
             const rid = options.requestId ?? 'unknown-rid';
             const batchId = options.batchId ?? randomUUID();
             // Slice 2026-07-29-worktree-l2-extended Part 2.C: --isolation worktree
@@ -251,12 +258,16 @@ export function registerDispatchCommand(parent, io) {
             let worktreePath = null;
             let worktreeBranch = null;
             if (typeof options.isolation === 'string' && options.isolation.length > 0) {
-                if (options.isolation !== 'worktree' && options.isolation !== 'container' && options.isolation !== 'vm') {
+                if (options.isolation !== 'worktree' &&
+                    options.isolation !== 'container' &&
+                    options.isolation !== 'vm') {
                     printResult(io, fail('sub-agent.dispatch', 'INVALID_ISOLATION', `--isolation only accepts "worktree" | "container" | "vm" (got "${options.isolation}")`, {
                         role,
                         toolCall: null,
                         dispatchRecordPath: null
-                    }, ['Drop --isolation or pass --isolation worktree / --isolation container / --isolation vm.']), asJson);
+                    }, [
+                        'Drop --isolation or pass --isolation worktree / --isolation container / --isolation vm.'
+                    ]), asJson);
                     process.exitCode = 1;
                     return;
                 }
@@ -367,7 +378,8 @@ export function registerDispatchCommand(parent, io) {
             try {
                 projectPrefs = loadPreferences(projectRoot);
             }
-            catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+            catch {
+                // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
                 // Keep default preferences.
             }
             const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
@@ -479,7 +491,9 @@ export function registerDispatchCommand(parent, io) {
                 ...(freshContextBlock !== undefined ? { freshContextBlock } : {}),
                 // §4: advisory session capsule pointer + precedence line.
                 ...(capsuleRef !== null
-                    ? { capsule: { batchId: capsuleRef.batchId, key: capsuleRef.key, bytes: capsuleRef.bytes } }
+                    ? {
+                        capsule: { batchId: capsuleRef.batchId, key: capsuleRef.key, bytes: capsuleRef.bytes }
+                    }
                     : {})
             });
             // Part 2.C: when --isolation worktree, prepend an isolation envelope
@@ -493,7 +507,15 @@ export function registerDispatchCommand(parent, io) {
                     `leaseId: ${leaseId}\n` +
                     `worktreePath: ${worktreePath}\n` +
                     `branch: ${worktreeBranch}\n` +
-                    `You MAY ` + '`git worktree add` ' + `and ` + '`git worktree remove` ' + `against this lease without a separate ` + '`peaks worktree auth grant` ' + `— the PreToolUse gate reads the lease file. Run ` + '`peaks worktree release --lease-id ${leaseId}` ' + `when done.\n`
+                    `You MAY ` +
+                    '`git worktree add` ' +
+                    `and ` +
+                    '`git worktree remove` ' +
+                    `against this lease without a separate ` +
+                    '`peaks worktree auth grant` ' +
+                    `— the PreToolUse gate reads the lease file. Run ` +
+                    '`peaks worktree release --lease-id ${leaseId}` ' +
+                    `when done.\n`
                 : '';
             // F5 follow-up: anti-fake-green gate. When `--must-ls-files <glob>`
             // is supplied, run `git ls-files <glob>` upfront, surface the
@@ -511,19 +533,27 @@ export function registerDispatchCommand(parent, io) {
                 const files = runGitLsFiles(projectRoot, glob);
                 const exists = files.length > 0;
                 mustLsFilesVerification = { path: glob, exists, files };
-                mustLsFilesBlock = `\n## must_ls_files enforcement (F5 anti-fake-green)\n` +
-                    `glob: ${glob}\n` +
-                    `verification: ${exists ? `EXISTS (${files.length} file${files.length === 1 ? '' : 's'} found)` : 'MISSING (no files matched the glob)'}\n` +
-                    (exists ? `first match: ${files[0] ?? ''}\n` : '') +
-                    `BEFORE any claim that work is "completed" or "PASS", you MUST run \`git ls-files ${glob}\` from the project root and ` +
-                    `confirm the file exists. Anti-fake-green rule (sediment 2026-08-11-rid-001-redo-fake-green-recovery-closure §Lesson 1): ` +
-                    `if the file does not exist, your verdict MUST be \`status: "blocked"\` with reason "must_ls_files_failed". Do NOT silently skip this step.\n`;
+                mustLsFilesBlock =
+                    `\n## must_ls_files enforcement (F5 anti-fake-green)\n` +
+                        `glob: ${glob}\n` +
+                        `verification: ${exists ? `EXISTS (${files.length} file${files.length === 1 ? '' : 's'} found)` : 'MISSING (no files matched the glob)'}\n` +
+                        (exists ? `first match: ${files[0] ?? ''}\n` : '') +
+                        `BEFORE any claim that work is "completed" or "PASS", you MUST run \`git ls-files ${glob}\` from the project root and ` +
+                        `confirm the file exists. Anti-fake-green rule (sediment 2026-08-11-rid-001-redo-fake-green-recovery-closure §Lesson 1): ` +
+                        `if the file does not exist, your verdict MUST be \`status: "blocked"\` with reason "must_ls_files_failed". Do NOT silently skip this step.\n`;
             }
             const effectivePrompt = `${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`;
-            const warnings = [...decision.warnings];
+            // Slice F2 (rid-f2-ac1-wiring): deprecated reviewer slots are accepted
+            // + rerouted here, never refused — rationale on the helper itself.
+            const warnings = [...decision.warnings, ...deprecatedReviewerWarnings(role)];
             let toolCall;
             try {
-                toolCall = adapter.subAgentDispatcher.buildToolCall({ role, prompt: effectivePrompt, requestId: rid, sessionId: sid });
+                toolCall = adapter.subAgentDispatcher.buildToolCall({
+                    role,
+                    prompt: effectivePrompt,
+                    requestId: rid,
+                    sessionId: sid
+                });
                 // Part 2.C: stamp the toolCall with `isolation` + a sub-agent
                 // env block so adapters that surface it (Claude Code's Task
                 // tool) propagate the lease id to the spawned process. The
@@ -534,7 +564,7 @@ export function registerDispatchCommand(parent, io) {
                     const provenanceToken = createDispatchProvenanceToken({
                         sessionId: sid,
                         requestId: rid,
-                        leaseId,
+                        leaseId
                     });
                     if (isolationMode === 'worktree') {
                         writeDispatchProvenance({
@@ -546,8 +576,8 @@ export function registerDispatchCommand(parent, io) {
                                 requestId: rid,
                                 leaseId,
                                 isolation: 'worktree',
-                                issuedAt: new Date().toISOString(),
-                            },
+                                issuedAt: new Date().toISOString()
+                            }
                         });
                     }
                     // Slice 2026-08-01-subagent-merge-and-e2e (Task 8): stamp the
@@ -560,7 +590,7 @@ export function registerDispatchCommand(parent, io) {
                     const profile = playwrightProfilePaths({
                         projectRoot,
                         sessionId: sid,
-                        dispatchId: rid,
+                        dispatchId: rid
                     });
                     toolCall = {
                         ...toolCall,
@@ -572,7 +602,9 @@ export function registerDispatchCommand(parent, io) {
                                 PEAKS_WORKTREE_LEASE_ID: leaseId,
                                 PEAKS_PLAYWRIGHT_USER_DATA_DIR: profile.userDataDir,
                                 PEAKS_PLAYWRIGHT_PROFILE_NAME: profile.profileName,
-                                ...(isolationMode === 'worktree' ? { [DISPATCH_PROVENANCE_ENV]: provenanceToken } : {}),
+                                ...(isolationMode === 'worktree'
+                                    ? { [DISPATCH_PROVENANCE_ENV]: provenanceToken }
+                                    : {})
                             }
                         }
                     };
@@ -586,7 +618,9 @@ export function registerDispatchCommand(parent, io) {
                 // roles like 'qa-business' would otherwise drop the event
                 // through schema rejection).
                 const KNOWN_ROLES = new Set(OBSERVABILITY_SUBAGENT_ROLES);
-                const knownRole = KNOWN_ROLES.has(role) ? role : null;
+                const knownRole = KNOWN_ROLES.has(role)
+                    ? role
+                    : null;
                 emitObservabilityEvent({
                     schemaVersion: 1,
                     ts: new Date().toISOString(),
@@ -602,9 +636,7 @@ export function registerDispatchCommand(parent, io) {
             }
             catch (error) {
                 if (error instanceof SubAgentNotSupportedError) {
-                    printResult(io, fail('sub-agent.dispatch', 'IDE_NOT_SUPPORTED', error.message, { role, toolCall: null, dispatchRecordPath: null }, [
-                        'Switch IDE or pick a role the current IDE supports.'
-                    ]), asJson);
+                    printResult(io, fail('sub-agent.dispatch', 'IDE_NOT_SUPPORTED', error.message, { role, toolCall: null, dispatchRecordPath: null }, ['Switch IDE or pick a role the current IDE supports.']), asJson);
                     process.exitCode = 1;
                     return;
                 }
@@ -695,7 +727,9 @@ export function registerDispatchCommand(parent, io) {
             });
             const nextActions = [
                 'Tool call is dry-run; LLM must execute the tool to actually dispatch the sub-agent.',
-                'After dispatching, the sub-agent should call `peaks sub-agent heartbeat --record ' + dispatchRecordPath + '` periodically.'
+                'After dispatching, the sub-agent should call `peaks sub-agent heartbeat --record ' +
+                    dispatchRecordPath +
+                    '` periodically.'
             ];
             if (counter.warning) {
                 nextActions.push(`Batch is over the RL-1 limit (${BATCH_LIMIT}); consider splitting into multiple batches.`);
@@ -769,7 +803,8 @@ export function registerDispatchCommand(parent, io) {
                     }
                 });
             }
-            catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+            catch {
+                // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
                 /* best-effort */
             }
         }

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

@@ -39,10 +39,10 @@ export async function runDispatchFromDag(role, options, asJson, io) {
     const projectRoot = options.project ?? process.cwd();
     // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
     // Auto-resolve sid from .peaks/_runtime/session.json before falling back.
-    const sid = options.sessionId
-        ?? process.env.PEAKS_SESSION_ID
-        ?? getCurrentSessionId(projectRoot)
-        ?? 'unknown-sid';
+    const sid = options.sessionId ??
+        process.env.PEAKS_SESSION_ID ??
+        getCurrentSessionId(projectRoot) ??
+        'unknown-sid';
     const rid = options.requestId ?? 'unknown-rid';
     const batchId = options.batchId ?? randomUUID();
     // Slice 9 (dispatch CLI latency): the --from-dag codepath loads three
@@ -87,7 +87,9 @@ export async function runDispatchFromDag(role, options, asJson, io) {
         const graphNodeId = node.graphNode;
         const candidate = typeof graphNodeId === 'string' && graphNodeId.length > 0 ? graphNodeId : node.id;
         if (typeof candidate !== 'string' || candidate.length === 0) {
-            printResult(io, fail('sub-agent.dispatch', 'PEAKS_GRAPH_NODE_REQUIRED', `DAG node ${node.id} has no graph-node mapping (RD §4 D4c)`, { role, toolCall: null, dispatchRecordPath: null, dagNodeId: node.id }, ['Annotate the DAG node with `graphNode: "<id>"` so each dispatch can bind a prepared graph node.']), asJson);
+            printResult(io, fail('sub-agent.dispatch', 'PEAKS_GRAPH_NODE_REQUIRED', `DAG node ${node.id} has no graph-node mapping (RD §4 D4c)`, { role, toolCall: null, dispatchRecordPath: null, dagNodeId: node.id }, [
+                'Annotate the DAG node with `graphNode: "<id>"` so each dispatch can bind a prepared graph node.'
+            ]), asJson);
             process.exitCode = 1;
             return;
         }
@@ -121,9 +123,7 @@ export async function runDispatchFromDag(role, options, asJson, io) {
     const adapter = getAdapter(ide);
     const dispatcher = adapter.subAgentDispatcher;
     if (!dispatcher.supportsRole(role)) {
-        printResult(io, fail('sub-agent.dispatch', 'IDE_NOT_SUPPORTED', `IDE ${ide} does not support role "${role}"`, { role, toolCall: null, dispatchRecordPath: null }, [
-            'Switch to a registered IDE (e.g. claude-code) or pick a role the current IDE supports.'
-        ]), asJson);
+        printResult(io, fail('sub-agent.dispatch', 'IDE_NOT_SUPPORTED', `IDE ${ide} does not support role "${role}"`, { role, toolCall: null, dispatchRecordPath: null }, ['Switch to a registered IDE (e.g. claude-code) or pick a role the current IDE supports.']), asJson);
         process.exitCode = 1;
         return;
     }
@@ -145,8 +145,7 @@ export async function runDispatchFromDag(role, options, asJson, io) {
         id,
         files: dag.nodes.find((n) => n.id === id)?.files ?? []
     }));
-    const firstLevelWaves = firstLevelDescriptors.length > 0
-        && firstLevelDescriptors.every((d) => d.files.length > 0)
+    const firstLevelWaves = firstLevelDescriptors.length > 0 && firstLevelDescriptors.every((d) => d.files.length > 0)
         ? planFileOverlapWaves(firstLevelDescriptors).waves
         : null;
     const emittedToolCalls = [];

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

@@ -34,9 +34,12 @@ export function registerDocCommands(program, io) {
                 const { writeFileSync, mkdirSync } = require('node:fs');
                 mkdirSync(resolvePath(opts.output, '..'), { recursive: true });
                 writeFileSync(resolvePath(opts.output), md, 'utf8');
-                printResult(io, ok('doc.generate-skill', { projectRoot, output: opts.output, sections: skill.sections.length, bytes: md.length }, [], [
-                    `Wrote ${md.length} bytes to ${opts.output}`
-                ]), opts.json ?? false);
+                printResult(io, ok('doc.generate-skill', {
+                    projectRoot,
+                    output: opts.output,
+                    sections: skill.sections.length,
+                    bytes: md.length
+                }, [], [`Wrote ${md.length} bytes to ${opts.output}`]), opts.json ?? false);
             }
             catch (err) {
                 printResult(io, fail('doc.generate-skill', 'WRITE_FAILED', err.message, { projectRoot }, []), opts.json ?? false);
@@ -44,9 +47,7 @@ export function registerDocCommands(program, io) {
             }
             return;
         }
-        printResult(io, ok('doc.generate-skill', { projectRoot, markdown: md, sections: skill.sections.length }, [], [
-            `Generated ${skill.sections.length} section(s). Pipe into a .md file or redirect.`
-        ]), opts.json ?? false);
+        printResult(io, ok('doc.generate-skill', { projectRoot, markdown: md, sections: skill.sections.length }, [], [`Generated ${skill.sections.length} section(s). Pipe into a .md file or redirect.`]), opts.json ?? false);
     });
     addJsonOption(doc
         .command('changelog-suggest')
@@ -58,8 +59,6 @@ export function registerDocCommands(program, io) {
         const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
         const entries = gitLogSince(projectRoot, opts.since);
         const md = suggestChangelog(entries);
-        printResult(io, ok('doc.changelog-suggest', { projectRoot, since: opts.since, entryCount: entries.length, markdown: md }, [], [
-            `Parsed ${entries.length} commit(s) since ${opts.since}.`
-        ]), opts.json ?? false);
+        printResult(io, ok('doc.changelog-suggest', { projectRoot, since: opts.since, entryCount: entries.length, markdown: md }, [], [`Parsed ${entries.length} commit(s) since ${opts.since}.`]), opts.json ?? false);
     });
 }

package/dist/cli/commands/doctor/invoke-from-code.js

@@ -27,7 +27,7 @@ export async function doctorInvokeFromCode(opts) {
         '## kind: <TBD>',
         '',
         'Real implementation: peaks-doctor LLM-driven analysis of',
-        '.peaks/_runtime/<sid>/txt/handoff.md + dispatch records.',
+        '.peaks/_runtime/<sid>/txt/handoff.md + dispatch records.'
     ].join('\n'));
     // Normalize to POSIX-style separators so callers (and tests) can rely
     // on a forward-slash contract regardless of host OS.

package/dist/cli/commands/e2e-verify-env.d.ts

@@ -0,0 +1,19 @@
+export type E2EVerifyInput = {
+    readonly projectRoot: string;
+    readonly slice: string;
+    readonly dispatchId?: string;
+};
+export type E2EVerifyResult = {
+    readonly outcome: 'pass' | 'fail' | 'skipped' | 'no-fixtures';
+    readonly passCount: number;
+    readonly failCount: number;
+    readonly skippedReason?: string;
+    /** When the real Playwright runner is used, the chromium-exit summary. */
+    readonly runner?: 'playwright' | 'stub';
+};
+export declare const PLAYWRIGHT_USER_DATA_DIR_ENV = "PEAKS_PLAYWRIGHT_USER_DATA_DIR";
+export declare const PLAYWRIGHT_PROFILE_NAME_ENV = "PEAKS_PLAYWRIGHT_PROFILE_NAME";
+export declare function resolvePlaywrightEnv(): {
+    readonly userDataDir: string;
+    readonly profileName: string;
+} | null;

package/dist/cli/commands/e2e-verify-env.js

@@ -0,0 +1,19 @@
+/**
+ * e2e-verify support surface — moved VERBATIM out of `e2e-verify.ts` for the
+ * 300-raw-line cap (slice `b1-filesplit-campaign`, wave 3C): the public
+ * input/result types, the two Playwright env-var names, and the env
+ * resolver. `e2e-verify.ts` re-exports the public types, so existing import
+ * paths keep working.
+ */
+import { existsSync } from 'node:fs';
+export const PLAYWRIGHT_USER_DATA_DIR_ENV = 'PEAKS_PLAYWRIGHT_USER_DATA_DIR';
+export const PLAYWRIGHT_PROFILE_NAME_ENV = 'PEAKS_PLAYWRIGHT_PROFILE_NAME';
+export function resolvePlaywrightEnv() {
+    const userDataDir = process.env[PLAYWRIGHT_USER_DATA_DIR_ENV];
+    const profileName = process.env[PLAYWRIGHT_PROFILE_NAME_ENV];
+    if (!userDataDir || !profileName)
+        return null;
+    if (!existsSync(userDataDir))
+        return null;
+    return { userDataDir, profileName };
+}

package/dist/cli/commands/e2e-verify.d.ts

@@ -28,20 +28,9 @@
  * never silently blocked from running the real runner — they can set
  * the env vars and re-run.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
-export type E2EVerifyInput = {
-    readonly projectRoot: string;
-    readonly slice: string;
-    readonly dispatchId?: string;
-};
-export type E2EVerifyResult = {
-    readonly outcome: 'pass' | 'fail' | 'skipped' | 'no-fixtures';
-    readonly passCount: number;
-    readonly failCount: number;
-    readonly skippedReason?: string;
-    /** When the real Playwright runner is used, the chromium-exit summary. */
-    readonly runner?: 'playwright' | 'stub';
-};
+import { type E2EVerifyInput, type E2EVerifyResult } from './e2e-verify-env.js';
+export type { E2EVerifyInput, E2EVerifyResult } from './e2e-verify-env.js';
 export declare function runE2EVerify(input: E2EVerifyInput): Promise<E2EVerifyResult>;
 export declare function registerE2EVerifyCommand(program: Command, io: ProgramIO): void;

package/dist/cli/commands/e2e-verify.js

@@ -1,11 +1,9 @@
 import { spawn as nodeSpawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { readE2EPlan } from '../../services/dispatch/e2e-fixtures.js';
 import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
-const PLAYWRIGHT_USER_DATA_DIR_ENV = 'PEAKS_PLAYWRIGHT_USER_DATA_DIR';
-const PLAYWRIGHT_PROFILE_NAME_ENV = 'PEAKS_PLAYWRIGHT_PROFILE_NAME';
+import { resolvePlaywrightEnv } from './e2e-verify-env.js';
 /**
  * Probe whether a Chromium binary is callable on this host. The probe
  * uses `process.platform` to pick the right finder (`where` on Windows,
@@ -13,18 +11,27 @@ const PLAYWRIGHT_PROFILE_NAME_ENV = 'PEAKS_PLAYWRIGHT_PROFILE_NAME';
  * least one match is found AND `--version` exits 0.
  */
 async function probeChromiumBinary() {
-    const candidates = process.platform === 'win32' ? ['chromium.exe', 'chrome.exe'] : ['chromium', 'chromium-browser', 'google-chrome'];
+    const candidates = process.platform === 'win32'
+        ? ['chromium.exe', 'chrome.exe']
+        : ['chromium', 'chromium-browser', 'google-chrome'];
     const finder = process.platform === 'win32' ? 'where' : 'which';
     for (const candidate of candidates) {
         try {
-            const result = nodeSpawn(finder, [candidate], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
+            const result = nodeSpawn(finder, [candidate], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true
+            });
             const stdout = await new Promise((resolve, reject) => {
                 let buf = '';
-                result.stdout.on('data', (chunk) => { buf += chunk.toString('utf8'); });
-                result.on('close', (code) => { if (code === 0)
-                    resolve(buf);
-                else
-                    reject(new Error(`exit ${code}`)); });
+                result.stdout.on('data', (chunk) => {
+                    buf += chunk.toString('utf8');
+                });
+                result.on('close', (code) => {
+                    if (code === 0)
+                        resolve(buf);
+                    else
+                        reject(new Error(`exit ${code}`));
+                });
                 result.on('error', reject);
             });
             if (stdout.trim().length === 0)
@@ -33,7 +40,10 @@ async function probeChromiumBinary() {
             const firstLine = stdout.split(/\r?\n/)[0]?.trim();
             if (!firstLine)
                 continue;
-            const probe = nodeSpawn(firstLine, ['--version'], { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
+            const probe = nodeSpawn(firstLine, ['--version'], {
+                stdio: ['ignore', 'pipe', 'ignore'],
+                windowsHide: true
+            });
             const exitCode = await new Promise((resolve) => {
                 probe.on('close', (code) => resolve(code ?? 1));
                 probe.on('error', () => resolve(1));
@@ -47,15 +57,6 @@ async function probeChromiumBinary() {
     }
     return false;
 }
-function resolvePlaywrightEnv() {
-    const userDataDir = process.env[PLAYWRIGHT_USER_DATA_DIR_ENV];
-    const profileName = process.env[PLAYWRIGHT_PROFILE_NAME_ENV];
-    if (!userDataDir || !profileName)
-        return null;
-    if (!existsSync(userDataDir))
-        return null;
-    return { userDataDir, profileName };
-}
 /**
  * Run a single fixture through the real Chromium-driven matcher.
  *
@@ -113,10 +114,12 @@ async function runOneFixtureWithPlaywright(fixture, env) {
                 `--user-data-dir=${env.userDataDir}`,
                 `--profile-directory=${env.profileName}`,
                 `--dump-dom`,
-                fixture.url,
+                fixture.url
             ], { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
             let html = '';
-            proc.stdout.on('data', (chunk) => { html += chunk.toString('utf8'); });
+            proc.stdout.on('data', (chunk) => {
+                html += chunk.toString('utf8');
+            });
             proc.on('error', () => settle({ pass: false, reason: 'chromium-spawn-failed' }));
             proc.on('close', (code) => {
                 if (code !== 0) {
@@ -128,8 +131,9 @@ async function runOneFixtureWithPlaywright(fixture, env) {
                     const looksLikeCss = matcher.startsWith('css:') || matcher.startsWith('#') || matcher.startsWith('.');
                     const needle = looksLikeCss ? matcher.replace(/^css:/, '').trim() : matcher;
                     const present = looksLikeCss
-                        ? new RegExp(`<[a-zA-Z][^>]*class=["'][^"']*\\b${needle.replace(/^\./, '').replace(/^#/, '')}\\b`).test(html)
-                            || (needle.startsWith('#') && new RegExp(`id=["']${needle.replace(/^#/, '')}["']`).test(html))
+                        ? new RegExp(`<[a-zA-Z][^>]*class=["'][^"']*\\b${needle.replace(/^\./, '').replace(/^#/, '')}\\b`).test(html) ||
+                            (needle.startsWith('#') &&
+                                new RegExp(`id=["']${needle.replace(/^#/, '')}["']`).test(html))
                         : html.includes(needle);
                     if (!present) {
                         settle({ pass: false, reason: `matcher-missing:${matcher}` });
@@ -150,7 +154,13 @@ export async function runE2EVerify(input) {
     if (plan.kind === 'empty')
         return { outcome: 'no-fixtures', passCount: 0, failCount: 0, runner: 'stub' };
     if (plan.kind === 'disabled') {
-        return { outcome: 'skipped', passCount: 0, failCount: 0, skippedReason: plan.reason, runner: 'stub' };
+        return {
+            outcome: 'skipped',
+            passCount: 0,
+            failCount: 0,
+            skippedReason: plan.reason,
+            runner: 'stub'
+        };
     }
     // Decide between the real Playwright runner and the deterministic
     // stub. Either env-var unset OR chromium missing → fallback. The
@@ -189,7 +199,7 @@ export async function runE2EVerify(input) {
         passCount,
         failCount,
         runner: 'playwright',
-        ...(chromiumReason !== null ? { skippedReason: chromiumReason } : {}),
+        ...(chromiumReason !== null ? { skippedReason: chromiumReason } : {})
     };
 }
 export function registerE2EVerifyCommand(program, io) {
@@ -200,11 +210,21 @@ export function registerE2EVerifyCommand(program, io) {
         .option('--project <path>', 'project root (default: cwd)', '.')
         .option('--dispatch-id <id>', 'optional dispatch id used in observability events')).action(async (options) => {
         try {
-            const result = await runE2EVerify({ projectRoot: options.project, slice: options.slice, ...(options.dispatchId !== undefined ? { dispatchId: options.dispatchId } : {}) });
-            printResult(io, ok('e2e.verify', { ...result, slice: options.slice, dispatchId: options.dispatchId ?? null }), options.json);
+            const result = await runE2EVerify({
+                projectRoot: options.project,
+                slice: options.slice,
+                ...(options.dispatchId !== undefined ? { dispatchId: options.dispatchId } : {})
+            });
+            printResult(io, ok('e2e.verify', {
+                ...result,
+                slice: options.slice,
+                dispatchId: options.dispatchId ?? null
+            }), options.json);
         }
         catch (error) {
-            printResult(io, fail('e2e.verify', 'E2E_VERIFY_FAILED', getErrorMessage(error), {}, [getErrorMessage(error)]), options.json);
+            printResult(io, fail('e2e.verify', 'E2E_VERIFY_FAILED', getErrorMessage(error), {}, [
+                getErrorMessage(error)
+            ]), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -25,6 +25,6 @@
  * Per the "Enhancement, not new AI CLI" tenet: this command is a
  * download + read-only access layer. There is no `peaks ecc run`.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerEccCommands(program: Command, io: ProgramIO): void;

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

@@ -1,4 +1,4 @@
-import { downloadToCache, listCachedAgents, readAgentSkill, readCacheManifest, } from 'peaks-loop-mut';
+import { downloadToCache, listCachedAgents, readAgentSkill, readCacheManifest } from 'peaks-loop-mut';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 export function registerEccCommands(program, io) {
@@ -16,7 +16,7 @@ export function registerEccCommands(program, io) {
                 `Cache landed at ~/.peaks/cache/ecc-${result.sha}/agents/`,
                 `Plugin-free copy materialized at ~/.peaks/agents/ecc/ (read it directly when the ECC plugin is absent)`,
                 `Inspect with: peaks ecc ls`,
-                `Consume one agent with: peaks ecc show <name>`,
+                `Consume one agent with: peaks ecc show <name>`
             ]);
             printResult(io, envelope, asJson);
         }
@@ -26,7 +26,7 @@ export function registerEccCommands(program, io) {
                 'Network failure during ECC download. Manual fallback:',
                 '  git clone https://github.com/affaan-m/ECC.git',
                 '  Copy <repo>/agents/*.md into ~/.peaks/cache/ecc-<sha>/agents/.',
-                '  Drop a minimal ecc-installed.json manifest into ~/.peaks/cache/.',
+                '  Drop a minimal ecc-installed.json manifest into ~/.peaks/cache/.'
             ]), asJson);
             process.exitCode = 1;
         }
@@ -41,19 +41,14 @@ export function registerEccCommands(program, io) {
             process.exitCode = 1;
             return;
         }
-        printResult(io, ok('ecc.status', manifest, [], [
-            `Inspect agents with: peaks ecc ls`,
-            `Print one agent with: peaks ecc show <name>`,
-        ]), asJson);
+        printResult(io, ok('ecc.status', manifest, [], [`Inspect agents with: peaks ecc ls`, `Print one agent with: peaks ecc show <name>`]), asJson);
     });
     addJsonOption(ecc
         .command('ls')
         .description('List cached agents from <cache>/agents/*.md with parsed frontmatter.')).action((options) => {
         const asJson = options.json === true;
         const agents = listCachedAgents();
-        printResult(io, ok('ecc.ls', { agents }, [], [
-            'Print one with: `peaks ecc show <name>`',
-        ]), asJson);
+        printResult(io, ok('ecc.ls', { agents }, [], ['Print one with: `peaks ecc show <name>`']), asJson);
     });
     addJsonOption(ecc
         .command('show <name>')
@@ -62,9 +57,7 @@ export function registerEccCommands(program, io) {
         .option('--max-lines <n>', 'cap stdout at N lines (default: unlimited)')).action((name, options) => {
         const asJson = options.json === true;
         if (!/^[a-z][a-z0-9-]*$/.test(name)) {
-            printResult(io, fail('ecc.show', 'INVALID_NAME', `agent name must match ^[a-z][a-z0-9-]*$ (got "${name}")`, { name }, [
-                'Run `peaks ecc ls` to see valid agent names.',
-            ]), asJson);
+            printResult(io, fail('ecc.show', 'INVALID_NAME', `agent name must match ^[a-z][a-z0-9-]*$ (got "${name}")`, { name }, ['Run `peaks ecc ls` to see valid agent names.']), asJson);
             process.exitCode = 1;
             return;
         }
@@ -72,7 +65,7 @@ export function registerEccCommands(program, io) {
         if (body === null) {
             printResult(io, fail('ecc.show', 'NOT_FOUND', `agent "${name}" is not in the cache`, { name }, [
                 'Run `peaks ecc ls` to see available agents.',
-                'Or run `peaks ecc install` to (re-)populate the cache.',
+                'Or run `peaks ecc install` to (re-)populate the cache.'
             ]), asJson);
             process.exitCode = 1;
             return;
@@ -83,9 +76,7 @@ export function registerEccCommands(program, io) {
             const lines = body.split(/\r?\n/);
             const startIdx = lines.findIndex((line) => new RegExp(`^#\\s+${escapeRegExp(heading)}\\s*$`).test(line));
             if (startIdx === -1) {
-                printResult(io, fail('ecc.show', 'SECTION_NOT_FOUND', `section "# ${heading}" not found in ${name}.md`, { name, section: heading }, [
-                    'Open the file directly to see section names.',
-                ]), asJson);
+                printResult(io, fail('ecc.show', 'SECTION_NOT_FOUND', `section "# ${heading}" not found in ${name}.md`, { name, section: heading }, ['Open the file directly to see section names.']), asJson);
                 process.exitCode = 1;
                 return;
             }