peaks-loop 4.0.54 → 4.1.1

package/dist/cli/commands/observability-commands-queries.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Slice `b1-filesplit-campaign` (wave 3B) — verbatim extraction of the four
+ * read-only `peaks observability` query runners (`status` / `slices` /
+ * `fanout` / `repair-cycles`) and the two scope resolvers they share out of
+ * `./observability-commands.ts` (380 raw lines > the 300 cap) so that module
+ * clears the cap. No query, envelope key, warning string or exit-code path
+ * changed and no assertion moved: `observability-commands.ts` imports these
+ * six names from this path, so the commander tree and every importer are
+ * byte-equivalent in behaviour.
+ *
+ * `runReport` stayed behind on purpose: it carries a
+ * `max-lines-per-function` finding, and a NEW module in this campaign must be
+ * clean outright — hoisting it would move a finding into a brand-new file.
+ */
+import { type ProgramIO } from '../cli-helpers.js';
+export declare function resolveProjectRoot(optionProject: string | undefined): string;
+export declare function resolveSessionId(optionSession: string | undefined, projectRoot: string): string | undefined;
+export declare function runStatus(io: ProgramIO, options: {
+    project?: string;
+    session?: string;
+    json?: boolean;
+}): void;
+export declare function runSlices(io: ProgramIO, options: {
+    project?: string;
+    session?: string;
+    json?: boolean;
+}): void;
+export declare function runFanout(io: ProgramIO, options: {
+    project?: string;
+    session?: string;
+    json?: boolean;
+}): void;
+export declare function runRepairCycles(io: ProgramIO, options: {
+    project?: string;
+    session?: string;
+    json?: boolean;
+}): void;

package/dist/cli/commands/observability-commands-queries.js

@@ -0,0 +1,113 @@
+/**
+ * Slice `b1-filesplit-campaign` (wave 3B) — verbatim extraction of the four
+ * read-only `peaks observability` query runners (`status` / `slices` /
+ * `fanout` / `repair-cycles`) and the two scope resolvers they share out of
+ * `./observability-commands.ts` (380 raw lines > the 300 cap) so that module
+ * clears the cap. No query, envelope key, warning string or exit-code path
+ * changed and no assertion moved: `observability-commands.ts` imports these
+ * six names from this path, so the commander tree and every importer are
+ * byte-equivalent in behaviour.
+ *
+ * `runReport` stayed behind on purpose: it carries a
+ * `max-lines-per-function` finding, and a NEW module in this campaign must be
+ * clean outright — hoisting it would move a finding into a brand-new file.
+ */
+import { fail, ok } from 'peaks-loop-shared/result';
+import { findProjectRoot } from '../../services/config/config-safety.js';
+import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
+import { aggregateFanout, aggregateRepairCycles, aggregateSlices, aggregateStatus, readAllSessionEvents, readSessionEvents } from '../../services/observability/aggregation.js';
+import { getSessionIdCanonical } from '../../services/session/session-manager.js';
+import { getErrorMessage, printResult } from '../cli-helpers.js';
+export function resolveProjectRoot(optionProject) {
+    return optionProject !== undefined
+        ? resolveCanonicalProjectRoot(optionProject)
+        : (findProjectRoot(process.cwd()) ?? process.cwd());
+}
+export function resolveSessionId(optionSession, projectRoot) {
+    if (optionSession !== undefined)
+        return optionSession;
+    return getSessionIdCanonical(projectRoot) ?? undefined;
+}
+export function runStatus(io, options) {
+    const projectRoot = resolveProjectRoot(options.project);
+    const sessionId = resolveSessionId(options.session, projectRoot);
+    try {
+        const events = sessionId !== undefined
+            ? readSessionEvents(projectRoot, sessionId)
+            : readAllSessionEvents(projectRoot);
+        const status = aggregateStatus(events);
+        const warnings = sessionId === undefined && status.totalEvents === 0
+            ? [
+                'No observability events found in any session — emit a slice transition via `peaks request transition` to populate.'
+            ]
+            : [];
+        printResult(io, ok('observability.status', {
+            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
+            status
+        }, warnings), options.json);
+    }
+    catch (error) {
+        printResult(io, fail('observability.status', 'OBSERVABILITY_STATUS_FAILED', getErrorMessage(error), { projectRoot }, ['Run `peaks observability slices` for per-slice detail']), options.json);
+        process.exitCode = 1;
+    }
+}
+export function runSlices(io, options) {
+    const projectRoot = resolveProjectRoot(options.project);
+    const sessionId = resolveSessionId(options.session, projectRoot);
+    try {
+        const events = sessionId !== undefined
+            ? readSessionEvents(projectRoot, sessionId)
+            : readAllSessionEvents(projectRoot);
+        const slices = aggregateSlices(events);
+        printResult(io, ok('observability.slices', {
+            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
+            total: slices.length,
+            slices
+        }, []), options.json);
+    }
+    catch (error) {
+        printResult(io, fail('observability.slices', 'OBSERVABILITY_SLICES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
+        process.exitCode = 1;
+    }
+}
+export function runFanout(io, options) {
+    const projectRoot = resolveProjectRoot(options.project);
+    const sessionId = resolveSessionId(options.session, projectRoot);
+    try {
+        const events = sessionId !== undefined
+            ? readSessionEvents(projectRoot, sessionId)
+            : readAllSessionEvents(projectRoot);
+        const fanout = aggregateFanout(events);
+        const warnings = fanout.total === 0
+            ? [
+                'No dispatch events recorded yet — Slice C will wire `peaks sub-agent dispatch`; until then fanout is empty.'
+            ]
+            : [];
+        printResult(io, ok('observability.fanout', {
+            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
+            fanout
+        }, warnings), options.json);
+    }
+    catch (error) {
+        printResult(io, fail('observability.fanout', 'OBSERVABILITY_FANOUT_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
+        process.exitCode = 1;
+    }
+}
+export function runRepairCycles(io, options) {
+    const projectRoot = resolveProjectRoot(options.project);
+    const sessionId = resolveSessionId(options.session, projectRoot);
+    try {
+        const events = sessionId !== undefined
+            ? readSessionEvents(projectRoot, sessionId)
+            : readAllSessionEvents(projectRoot);
+        const cycles = aggregateRepairCycles(events);
+        printResult(io, ok('observability.repair-cycles', {
+            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
+            cycles
+        }, []), options.json);
+    }
+    catch (error) {
+        printResult(io, fail('observability.repair-cycles', 'OBSERVABILITY_REPAIR_CYCLES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
+        process.exitCode = 1;
+    }
+}

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

@@ -17,6 +17,6 @@
  * so each subcommand returns a meaningful empty result on a fresh
  * tree.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerObservabilityCommands(program: Command, io: ProgramIO): void;

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

@@ -17,102 +17,17 @@
  * so each subcommand returns a meaningful empty result on a fresh
  * tree.
  */
-import { findProjectRoot } from '../../services/config/config-safety.js';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
 import { fail, ok } from 'peaks-loop-shared/result';
-import { getSessionIdCanonical } from '../../services/session/session-manager.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { aggregateFanout, aggregateRepairCycles, aggregateSlices, aggregateStatus, filterByPeriod, periodStartIso, readAllSessionEvents, readSessionEvents } from '../../services/observability/aggregation.js';
 import { renderObservabilityReport } from '../../services/observability/report-formatter.js';
-function resolveProjectRoot(optionProject) {
-    return optionProject !== undefined
-        ? resolveCanonicalProjectRoot(optionProject)
-        : (findProjectRoot(process.cwd()) ?? process.cwd());
-}
-function resolveSessionId(optionSession, projectRoot) {
-    if (optionSession !== undefined)
-        return optionSession;
-    return getSessionIdCanonical(projectRoot) ?? undefined;
-}
-function runStatus(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const status = aggregateStatus(events);
-        const warnings = sessionId === undefined && status.totalEvents === 0
-            ? ['No observability events found in any session — emit a slice transition via `peaks request transition` to populate.']
-            : [];
-        printResult(io, ok('observability.status', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            status
-        }, warnings), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.status', 'OBSERVABILITY_STATUS_FAILED', getErrorMessage(error), { projectRoot }, ['Run `peaks observability slices` for per-slice detail']), options.json);
-        process.exitCode = 1;
-    }
-}
-function runSlices(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const slices = aggregateSlices(events);
-        printResult(io, ok('observability.slices', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            total: slices.length,
-            slices
-        }, []), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.slices', 'OBSERVABILITY_SLICES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-function runFanout(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const fanout = aggregateFanout(events);
-        const warnings = fanout.total === 0
-            ? ['No dispatch events recorded yet — Slice C will wire `peaks sub-agent dispatch`; until then fanout is empty.']
-            : [];
-        printResult(io, ok('observability.fanout', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            fanout
-        }, warnings), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.fanout', 'OBSERVABILITY_FANOUT_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-function runRepairCycles(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const cycles = aggregateRepairCycles(events);
-        printResult(io, ok('observability.repair-cycles', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            cycles
-        }, []), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.repair-cycles', 'OBSERVABILITY_REPAIR_CYCLES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
+// Slice `b1-filesplit-campaign` (wave 3B): the four read-only query runners
+// (`runStatus` / `runSlices` / `runFanout` / `runRepairCycles`) plus the two
+// scope resolvers they share moved VERBATIM to `./observability-commands-queries.ts`
+// so this file clears the 300 raw-line cap. What they do is unchanged;
+// `runReport` — the one function here carrying a finding — stayed behind, so no
+// finding moved into the new module.
+import { resolveProjectRoot, resolveSessionId, runFanout, runRepairCycles, runSlices, runStatus } from './observability-commands-queries.js';
 const VALID_PERIODS = ['day', 'week', 'month'];
 function runReport(io, options) {
     const projectRoot = resolveProjectRoot(options.project);

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

@@ -1,3 +1,3 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerOpenSpecCommands(program: Command, io: ProgramIO): void;

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

@@ -25,7 +25,9 @@ async function loadRenderRequest(requestPath) {
     return parsed;
 }
 export function registerOpenSpecCommands(program, io) {
-    const openspec = program.command('openspec').description('Inspect OpenSpec changes inside the target project');
+    const openspec = program
+        .command('openspec')
+        .description('Inspect OpenSpec changes inside the target project');
     addJsonOption(openspec
         .command('list')
         .description('List OpenSpec changes detected under <project>/openspec/changes')
@@ -35,7 +37,9 @@ export function registerOpenSpecCommands(program, io) {
             printResult(io, ok('openspec.list', report), options.json);
         }
         catch (error) {
-            printResult(io, fail('openspec.list', 'OPENSPEC_LIST_FAILED', getErrorMessage(error), {}, ['Check the project path and openspec/ layout before retrying']), options.json);
+            printResult(io, fail('openspec.list', 'OPENSPEC_LIST_FAILED', getErrorMessage(error), {}, [
+                'Check the project path and openspec/ layout before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -54,7 +58,9 @@ export function registerOpenSpecCommands(program, io) {
             printResult(io, ok('openspec.show', detail), options.json);
         }
         catch (error) {
-            printResult(io, fail('openspec.show', 'OPENSPEC_SHOW_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
+            printResult(io, fail('openspec.show', 'OPENSPEC_SHOW_FAILED', getErrorMessage(error), { changeId }, [
+                'Check the project path and openspec/ layout before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -73,7 +79,9 @@ export function registerOpenSpecCommands(program, io) {
             printResult(io, ok('openspec.to-rd', projection), options.json);
         }
         catch (error) {
-            printResult(io, fail('openspec.to-rd', 'OPENSPEC_TO_RD_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
+            printResult(io, fail('openspec.to-rd', 'OPENSPEC_TO_RD_FAILED', getErrorMessage(error), { changeId }, [
+                'Check the project path and openspec/ layout before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -131,7 +139,9 @@ export function registerOpenSpecCommands(program, io) {
                 process.exitCode = 1;
                 return;
             }
-            printResult(io, ok('openspec.validate', result, result.issues.filter((issue) => issue.level === 'warning').map((issue) => `${issue.rule}: ${issue.message}`)), options.json);
+            printResult(io, ok('openspec.validate', result, result.issues
+                .filter((issue) => issue.level === 'warning')
+                .map((issue) => `${issue.rule}: ${issue.message}`)), options.json);
         }
         catch (error) {
             printResult(io, fail('openspec.validate', 'OPENSPEC_VALIDATE_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
@@ -186,7 +196,9 @@ export function registerOpenSpecCommands(program, io) {
                 process.exitCode = 1;
                 return;
             }
-            printResult(io, fail('openspec.archive', 'OPENSPEC_ARCHIVE_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
+            printResult(io, fail('openspec.archive', 'OPENSPEC_ARCHIVE_FAILED', getErrorMessage(error), { changeId }, [
+                'Check the project path and openspec/ layout before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -242,12 +254,12 @@ export function registerOpenSpecCommands(program, io) {
                 id: finding.id,
                 rule: finding.rule ?? finding.id,
                 detail: finding.message,
-                severity: 'fail',
+                severity: 'fail'
             };
             const result = proposeFromDoctor({ projectRoot: options.project, finding: doctorFinding });
             printResult(io, ok('openspec.from-doctor', result, [], [
                 `draft proposal written to ${result.proposalPath}`,
-                'Review + edit the draft, then run `peaks openspec validate <id>`',
+                'Review + edit the draft, then run `peaks openspec validate <id>`'
             ]), options.json);
         }
         catch (error) {

package/dist/cli/commands/outer-cache-commands.js

@@ -53,7 +53,7 @@ function readCacheFile(cachePath) {
         if (parsed !== null &&
             typeof parsed === 'object' &&
             typeof parsed.outerSessionId === 'string' &&
-            (parsed.outerSessionId).length > 0 &&
+            parsed.outerSessionId.length > 0 &&
             typeof parsed.capturedAt === 'string') {
             return {
                 ok: true,
@@ -63,7 +63,8 @@ function readCacheFile(cachePath) {
         }
         return { ok: false, missing: true };
     }
-    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)
         return { ok: false, missing: true };
     }
 }
@@ -75,7 +76,7 @@ export function registerOuterCacheCommands(program, io) {
         .command('write')
         .description('Write the current outer-session-id (PEAKS_OUTER_SESSION_ID ?? CLAUDE_CODE_SESSION_ID) into the per-project cache file. Idempotent: re-runs overwrite. Exits 1 with OUTER_CACHE_NO_ENV when neither env var is set.')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
-        const projectRoot = options.project ?? (findProjectRoot(process.cwd()) ?? process.cwd());
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
         const cachePath = resolveCachePath(projectRoot);
         const outerSessionId = readEnvOuter();
         if (outerSessionId === undefined) {
@@ -106,20 +107,30 @@ export function registerOuterCacheCommands(program, io) {
             process.exitCode = 1;
             return;
         }
-        printResult(io, ok('outer-cache.write', { cachePath, written: true, projectRoot, outerSessionId, capturedAt }, [], [`Wrote ${cachePath}; getCurrentOuterSessionId() will resolve to "${outerSessionId}" until the next SessionStart fires.`]), options.json === true);
+        printResult(io, ok('outer-cache.write', { cachePath, written: true, projectRoot, outerSessionId, capturedAt }, [], [
+            `Wrote ${cachePath}; getCurrentOuterSessionId() will resolve to "${outerSessionId}" until the next SessionStart fires.`
+        ]), options.json === true);
     });
     addJsonOption(outerCache
         .command('read')
         .description('Read the current value of the per-project outer-session cache. Returns { missing: true, cachePath } when the file is absent / malformed / empty; never throws on IO error.')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
-        const projectRoot = options.project ?? (findProjectRoot(process.cwd()) ?? process.cwd());
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
         const cachePath = resolveCachePath(projectRoot);
         const result = readCacheFile(cachePath);
         if (result.ok) {
-            printResult(io, ok('outer-cache.read', { cachePath, missing: false, projectRoot, outerSessionId: result.outerSessionId, capturedAt: result.capturedAt }, [], [`outer-session-id resolved: ${result.outerSessionId} (captured ${result.capturedAt})`]), options.json === true);
+            printResult(io, ok('outer-cache.read', {
+                cachePath,
+                missing: false,
+                projectRoot,
+                outerSessionId: result.outerSessionId,
+                capturedAt: result.capturedAt
+            }, [], [`outer-session-id resolved: ${result.outerSessionId} (captured ${result.capturedAt})`]), options.json === true);
             return;
         }
-        printResult(io, ok('outer-cache.read', { cachePath, missing: true, projectRoot }, ['No outer-session cache present — getCurrentOuterSessionId() will return undefined for this project.'], [
+        printResult(io, ok('outer-cache.read', { cachePath, missing: true, projectRoot }, [
+            'No outer-session cache present — getCurrentOuterSessionId() will return undefined for this project.'
+        ], [
             'Re-run `peaks hooks install` to wire the SessionStart hook that writes this cache automatically',
             'Or set PEAKS_OUTER_SESSION_ID=<id> so env-first resolution wins without touching the cache'
         ]), options.json === true);

package/dist/cli/commands/perf-audit-commands.d.ts

@@ -17,6 +17,6 @@
  * This CLI is the I/O + validation shell, mirroring the ecc-bridge
  * pattern (slice 7 Group D).
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerPerfAuditCommands(program: Command, io: ProgramIO): void;

package/dist/cli/commands/perf-audit-commands.js

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { detectPerfAudit, isPerfAuditEnvelope, runPerfAudit, } from '../../services/audit-independent/index.js';
+import { detectPerfAudit, isPerfAuditEnvelope, runPerfAudit } from '../../services/audit-independent/index.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 function resolveEnvelope(envelopePath) {
@@ -48,7 +48,10 @@ export function registerPerfAuditCommands(program, io) {
         const sid = options.sid;
         const rid = options.rid;
         if (sid === undefined || sid.length === 0) {
-            printResult(io, fail('perf-audit.detect', 'SID_REQUIRED', 'session id (--sid) is required for perf-audit.detect', { state: 'sid-missing' }, ['Pass --sid <session-id> (e.g. 2026-06-27-session-...)', 'Run `peaks session info --active --json` to find the active sid.']), options.json);
+            printResult(io, fail('perf-audit.detect', 'SID_REQUIRED', 'session id (--sid) is required for perf-audit.detect', { state: 'sid-missing' }, [
+                'Pass --sid <session-id> (e.g. 2026-06-27-session-...)',
+                'Run `peaks session info --active --json` to find the active sid.'
+            ]), options.json);
             process.exitCode = 1;
             return;
         }
@@ -56,7 +59,7 @@ export function registerPerfAuditCommands(program, io) {
             const detect = detectPerfAudit({
                 projectRoot,
                 sessionId: sid,
-                ...(rid !== undefined ? { requestId: rid } : {}),
+                ...(rid !== undefined ? { requestId: rid } : {})
             });
             const envelope = detect.state === 'ready'
                 ? ok('perf-audit.detect', detect, [...detect.warnings], [...detect.nextActions])
@@ -72,7 +75,7 @@ export function registerPerfAuditCommands(program, io) {
                 handoffPresent: false,
                 templatePresent: false,
                 warnings: [],
-                nextActions: [],
+                nextActions: []
             }, ['Re-run with --project <path> pointing at a known-good project root.']), options.json);
             process.exitCode = 1;
         }
@@ -112,7 +115,7 @@ export function registerPerfAuditCommands(program, io) {
                 sessionId: sid,
                 rid,
                 generatedAt: new Date().toISOString(),
-                envelope: envelopeValue,
+                envelope: envelopeValue
             });
             if (result.detect.state !== 'ready' || result.artifactPath === null) {
                 printResult(io, fail('perf-audit.run', result.detect.state.toUpperCase().replace(/-/g, '_'), `perf-audit is not ready: ${result.detect.state}`, result, [...result.detect.nextActions]), options.json);
@@ -123,11 +126,13 @@ export function registerPerfAuditCommands(program, io) {
                 detect: result.detect,
                 artifactPath: result.artifactPath,
                 violationsCount: result.violationsCount,
-                verdict: result.verdict,
+                verdict: result.verdict
             }, [...result.detect.warnings], [...result.detect.nextActions]), options.json);
         }
         catch (error) {
-            printResult(io, fail('perf-audit.run', 'RUN_PERF_AUDIT_FAILED', getErrorMessage(error), {}, ['Verify the envelope JSON is well-formed and matches the strict-shape contract.']), options.json);
+            printResult(io, fail('perf-audit.run', 'RUN_PERF_AUDIT_FAILED', getErrorMessage(error), {}, [
+                'Verify the envelope JSON is well-formed and matches the strict-shape contract.'
+            ]), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -1,3 +1,3 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerPerfCommands(program: Command, io: ProgramIO): void;

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

@@ -2,17 +2,17 @@ import { executePerfBaselineInit, resolveProjectRootFromCwd } from '../../servic
 import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 export function registerPerfCommands(program, io) {
-    const perf = program.command('perf').description('Manage performance baseline scaffolding for the RD stage');
+    const perf = program
+        .command('perf')
+        .description('Manage performance baseline scaffolding for the RD stage');
     addJsonOption(perf
         .command('baseline')
-        .description('Scaffold .peaks/_runtime/<sid>/rd/perf-baseline.md so the RD can record the slice\'s perf numbers in a stable place that QA Gate A4 can diff against. Default dry-run; pass --apply to write.')
+        .description("Scaffold .peaks/_runtime/<sid>/rd/perf-baseline.md so the RD can record the slice's perf numbers in a stable place that QA Gate A4 can diff against. Default dry-run; pass --apply to write.")
         .option('--project <path>', 'target project root (defaults to git root or cwd)')
         .option('--apply', 'write the scaffold into the target project', false)
         .option('--reason <text>', 'human-readable reason for the baseline (recorded in the response data)')).action(async (options) => {
         try {
-            const projectRoot = options.project !== undefined
-                ? options.project
-                : resolveProjectRootFromCwd(process.cwd());
+            const projectRoot = options.project !== undefined ? options.project : resolveProjectRootFromCwd(process.cwd());
             const result = await executePerfBaselineInit({
                 projectRoot,
                 apply: options.apply === true,

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

@@ -34,7 +34,7 @@ import { type ProgramIO } from '../cli-helpers.js';
 export declare const DEFAULT_PORT = 8931;
 export declare const MAX_PORT = 8949;
 declare const BROWSERS: readonly ["chromium", "firefox", "webkit"];
-type Browser = typeof BROWSERS[number];
+type Browser = (typeof BROWSERS)[number];
 export interface PlaywrightSession {
     terminalId: string;
     port: number;

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

@@ -114,7 +114,8 @@ export function listSessions(projectRoot) {
             const session = JSON.parse(raw);
             out.push(session);
         }
-        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)
             // skip malformed session file
         }
     }
@@ -127,7 +128,8 @@ export function readSession(projectRoot, terminalId) {
     try {
         return JSON.parse(readFileSync(path, 'utf8'));
     }
-    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)
         return null;
     }
 }
@@ -152,7 +154,12 @@ export function removeSession(projectRoot, terminalId) {
  * session file can record it.
  */
 export function spawnPlaywrightMcp(port, browser, userDataDir, projectRoot) {
-    const child = spawn('npx', ['playwright-mcp@latest', `--port=${port}`, `--browser=${browser}`, `--user-data-dir=${userDataDir}`], {
+    const child = spawn('npx', [
+        'playwright-mcp@latest',
+        `--port=${port}`,
+        `--browser=${browser}`,
+        `--user-data-dir=${userDataDir}`
+    ], {
         cwd: projectRoot,
         env: process.env,
         stdio: 'ignore',
@@ -277,7 +284,7 @@ export function registerPlaywrightCommands(program, _io) {
         .description('List running Playwright MCP sessions from .peaks/_runtime/playwright-sessions/*.json')
         .option('--project <path>', 'project root (defaults to current directory)', process.cwd())
         .option('--json', 'emit a JSON envelope { ok, data: { sessions } }')
-        .action(async (opts) => {
+        .action((opts) => {
         try {
             const projectRoot = resolveCanonicalProjectRoot(opts.project ?? process.cwd());
             const sessions = listSessions(projectRoot);
@@ -306,10 +313,10 @@ export function registerPlaywrightCommands(program, _io) {
     playwright
         .command('stop')
         .description('Stop a running Playwright MCP session (best-effort kill + remove session file).')
-        .option('--terminal <id>', 'terminal id to stop (default: this shell\'s derived terminal id)')
+        .option('--terminal <id>', "terminal id to stop (default: this shell's derived terminal id)")
         .option('--project <path>', 'project root (defaults to current directory)', process.cwd())
         .option('--json', 'emit a JSON envelope { ok, data }')
-        .action(async (opts) => {
+        .action((opts) => {
         try {
             const projectRoot = resolveCanonicalProjectRoot(opts.project ?? process.cwd());
             const terminalId = opts.terminal ?? deriveTerminalId();
@@ -330,7 +337,8 @@ export function registerPlaywrightCommands(program, _io) {
                 try {
                     process.kill(session.pid, 'SIGTERM');
                 }
-                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)
                     /* process may have already exited */
                 }
             }
@@ -409,7 +417,11 @@ export function registerBrowserActionCommand(program) {
     });
 }
 function isSupportedIntent(value) {
-    return value === 'navigate' || value === 'click' || value === 'fill' || value === 'snapshot' || value === 'extract';
+    return (value === 'navigate' ||
+        value === 'click' ||
+        value === 'fill' ||
+        value === 'snapshot' ||
+        value === 'extract');
 }
 /**
  * Resolve and validate a caller-supplied `--user-data-dir`. The dir must