peaks-loop 4.0.53 → 4.1.0

package/dist/cli/commands/session-checkpoint-command.js

@@ -5,7 +5,7 @@
  * `_runtime/<sessionId>/checkpoints/<iso>.json`. Designed for skill
  * invocation; the CLI is the muscle, the LLM decides the cadence.
  */
-import { CHECKPOINT_CONSTANTS, CHECKPOINT_REASONS, writeCheckpoint, } from '../../services/session/session-checkpoint-service.js';
+import { CHECKPOINT_CONSTANTS, CHECKPOINT_REASONS, writeCheckpoint } from '../../services/session/session-checkpoint-service.js';
 import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
 import { getErrorMessage } from '../cli-helpers.js';
 function splitList(value) {

package/dist/cli/commands/session-migrate-skill-name.js

@@ -18,7 +18,7 @@ export function registerSessionMigrateSkillNameCommand(session) {
                 projectRoot,
                 from: opts.from,
                 to: opts.to,
-                apply: opts.apply === true,
+                apply: opts.apply === true
             });
             if (opts.json === true) {
                 process.stdout.write(JSON.stringify(result, null, 2) + '\n');

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

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 /** Pinned upstream version — bump deliberately, never float on `latest`. */
 export declare const SHADCN_PACKAGE = "shadcn@4.21.0";

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

@@ -97,7 +97,9 @@ export function registerShadcnCommands(program, io) {
         const result = runShadcnInit({
             cwd: options.project,
             preset: options.preset,
-            ...(options.template !== undefined && options.template.length > 0 ? { template: options.template } : {}),
+            ...(options.template !== undefined && options.template.length > 0
+                ? { template: options.template }
+                : {}),
             ...(options.yes === true ? { yes: true } : {})
         });
         if (result.state === 'ok') {

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

@@ -24,7 +24,7 @@ export const FINALIZE_SELECTION_RULE = 'prefer status=queued; among those, newes
  * re-finalized, so the caller reports the survivors instead of touching one.
  */
 export function selectFinalizeTarget(candidates) {
-    const queued = candidates.filter(candidate => candidate.status === 'queued');
+    const queued = candidates.filter((candidate) => candidate.status === 'queued');
     if (queued.length === 0)
         return null;
     return [...queued].sort((a, b) => b.createdAt.localeCompare(a.createdAt) || b.recordPath.localeCompare(a.recordPath))[0];
@@ -52,9 +52,7 @@ export function registerShareCommand(parent, io) {
         .option('--project <path>', 'target project root (defaults to cwd)')).action((options) => {
         const asJson = options.json === true;
         if (!options.batch || !options.key || !options.value) {
-            printResult(io, fail('sub-agent.share', 'MISSING_ARG', '--batch, --key, and --value are required', { ok: false }, [
-                'Re-run with --batch <batchId> --key <key> --value <jsonObject>.'
-            ]), asJson);
+            printResult(io, fail('sub-agent.share', 'MISSING_ARG', '--batch, --key, and --value are required', { ok: false }, ['Re-run with --batch <batchId> --key <key> --value <jsonObject>.']), asJson);
             process.exitCode = 1;
             return;
         }
@@ -67,19 +65,17 @@ export function registerShareCommand(parent, io) {
             parsedValue = parsed;
         }
         catch (err) {
-            printResult(io, fail('sub-agent.share', 'INVALID_VALUE', `value must be a JSON object: ${getErrorMessage(err)}`, { ok: false }, [
-                'Pass --value as a JSON object literal, e.g. --value \'{"reason":"x"}\'.'
-            ]), asJson);
+            printResult(io, fail('sub-agent.share', 'INVALID_VALUE', `value must be a JSON object: ${getErrorMessage(err)}`, { ok: false }, ['Pass --value as a JSON object literal, e.g. --value \'{"reason":"x"}\'.']), asJson);
             process.exitCode = 1;
             return;
         }
         try {
             const projectRoot = options.project ?? process.cwd();
             // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-            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 from = options.from ?? 'unknown-role';
             const result = writeSharedEntry({
@@ -119,7 +115,9 @@ export function registerShareCommand(parent, io) {
                 lastWriteWins: result.lastWriteWins,
                 valueSize: result.entry.valueSize
             }, warnings, [
-                'Sub-agents in the same batch can read this entry via `peaks sub-agent shared-read --batch ' + options.batch + '`.'
+                'Sub-agents in the same batch can read this entry via `peaks sub-agent shared-read --batch ' +
+                    options.batch +
+                    '`.'
             ]), asJson);
             // Slice 2026-06-23-audit-4th #B1: structured log on success.
             try {
@@ -138,15 +136,14 @@ export function registerShareCommand(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 */
             }
         }
         catch (error) {
             const code = error.code ?? 'SHARE_ERROR';
-            printResult(io, fail('sub-agent.share', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [
-                shareErrorNextActions(code)
-            ]), asJson);
+            printResult(io, fail('sub-agent.share', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [shareErrorNextActions(code)]), asJson);
             process.exitCode = 1;
         }
     });
@@ -179,19 +176,17 @@ export function registerSharedReadCommand(parent, io) {
         .option('--project <path>', 'target project root (defaults to cwd)')).action((options) => {
         const asJson = options.json === true;
         if (!options.batch) {
-            printResult(io, fail('sub-agent.shared-read', 'MISSING_BATCH', '--batch is required', { ok: false }, [
-                'Re-run with --batch <batchId>.'
-            ]), asJson);
+            printResult(io, fail('sub-agent.shared-read', 'MISSING_BATCH', '--batch is required', { ok: false }, ['Re-run with --batch <batchId>.']), asJson);
             process.exitCode = 1;
             return;
         }
         try {
             const projectRoot = options.project ?? process.cwd();
             // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-            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 channel = readSharedChannel({
                 projectRoot,
@@ -216,9 +211,7 @@ export function registerSharedReadCommand(parent, io) {
         }
         catch (error) {
             const code = error.code ?? 'SHARED_READ_ERROR';
-            printResult(io, fail('sub-agent.shared-read', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [
-                sharedReadErrorNextActions(code)
-            ]), asJson);
+            printResult(io, fail('sub-agent.shared-read', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [sharedReadErrorNextActions(code)]), asJson);
             process.exitCode = 1;
         }
     });
@@ -252,9 +245,7 @@ export function registerAwaitCommand(parent, io) {
         if (typeof options.timeout === 'string' && options.timeout.length > 0) {
             const n = Number.parseInt(options.timeout, 10);
             if (!Number.isInteger(n) || n <= 0) {
-                printResult(io, fail('sub-agent.await', 'INVALID_TIMEOUT', `--timeout must be a positive integer ms (got ${options.timeout})`, { ok: false }, [
-                    'Pass an integer like --timeout 60000.'
-                ]), asJson);
+                printResult(io, fail('sub-agent.await', 'INVALID_TIMEOUT', `--timeout must be a positive integer ms (got ${options.timeout})`, { ok: false }, ['Pass an integer like --timeout 60000.']), asJson);
                 process.exitCode = 1;
                 return;
             }
@@ -262,10 +253,10 @@ export function registerAwaitCommand(parent, io) {
         }
         const projectRoot = options.project ?? process.cwd();
         // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-        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';
         // Lazy-import IDE modules so `peaks sub-agent share` and
         // `peaks sub-agent shared-read` (the high-frequency G8.4 path) do not
         // pay for adapter resolution at module-load time. Slice
@@ -326,7 +317,9 @@ export function registerAwaitCommand(parent, io) {
                 summary,
                 unreadableRecords: scan.unreadable
             }, scan.unreadable.length > 0
-                ? [`${scan.unreadable.length} unreadable dispatch record(s) in this session were skipped and are NOT part of the results: ${scan.unreadable.join(', ')}`]
+                ? [
+                    `${scan.unreadable.length} unreadable dispatch record(s) in this session were skipped and are NOT part of the results: ${scan.unreadable.join(', ')}`
+                ]
                 : [], [
                 // Slice 2026-09-15-s9: corrected. This used to tell users that the
                 // four non-Claude IDEs would report `awaitByLlm: <ide> 1.2 fallback`,
@@ -446,7 +439,7 @@ export function registerFinalizeCommand(parent, io) {
                 const outcomeMap = {
                     done: { status: 'done', outcome: 'success' },
                     failed: { status: 'failed', outcome: 'failed' },
-                    cancelled: { status: 'cancelled', outcome: 'cancelled' },
+                    cancelled: { status: 'cancelled', outcome: 'cancelled' }
                 };
                 const mapped = outcomeMap[outcome] ?? outcomeMap['done'];
                 const finalized = [];
@@ -478,7 +471,13 @@ export function registerFinalizeCommand(parent, io) {
                     }
                 };
                 const applyOutcome = (recordPath, rid) => {
-                    markCompleted({ recordPath, now: () => new Date(), status: mapped.status, outcome: mapped.outcome, projectRoot });
+                    markCompleted({
+                        recordPath,
+                        now: () => new Date(),
+                        status: mapped.status,
+                        outcome: mapped.outcome,
+                        projectRoot
+                    });
                     finalized.push({ recordPath, requestId: rid, status: mapped.status });
                 };
                 if (options.allStale) {
@@ -536,8 +535,8 @@ export function registerFinalizeCommand(parent, io) {
                         matched: candidates.length,
                         chosen: chosen?.recordPath ?? null,
                         rejected: candidates
-                            .filter(candidate => candidate !== chosen)
-                            .map(candidate => ({
+                            .filter((candidate) => candidate !== chosen)
+                            .map((candidate) => ({
                             recordPath: candidate.recordPath,
                             status: candidate.status,
                             reason: describeFinalizeRejection(candidate, chosen)
@@ -587,7 +586,7 @@ export function registerFinalizeCommand(parent, io) {
                     hints.push('Re-run after fixing; unreadable records are listed in errors[] and were skipped, not fatal.');
                 }
                 else if (finalized.length === 0 && skipped.length > 0) {
-                    hints.push('Nothing was finalized: every matching record had already left `queued`. See skipped[] for each record\'s status.');
+                    hints.push("Nothing was finalized: every matching record had already left `queued`. See skipped[] for each record's status.");
                 }
                 else {
                     hints.push('All targeted records transitioned out of queued.');

package/dist/cli/commands/skill-conformance-commands.d.ts

@@ -4,6 +4,6 @@
  * reports the 5 standard checks (frontmatter, CLI-back, loadStrategy,
  * 800-line cap, outputStyle).
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerSkillConformanceCommands(program: Command, io: ProgramIO): void;

package/dist/cli/commands/skill-conformance-commands.js

@@ -13,7 +13,7 @@ export function registerSkillConformanceCommands(program, io) {
         .description('Slice #12: audit all 12 peaks-* SKILL.md against the 5 alignment standards')
         .requiredOption('--project <path>', 'target project root')
         .option('--json', 'print machine-readable JSON envelope')
-        .action(async (options) => {
+        .action((options) => {
         try {
             const report = auditSkillConformance({ projectRoot: options.project });
             const nextActions = [];

package/dist/cli/commands/skill-loop-engineering-readiness-commands.js

@@ -34,7 +34,7 @@
  */
 import { readFileSync, existsSync, statSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { lintSkillLoopEngineeringReadiness, } from '../../services/standards/loop-engineering-readiness-lint.js';
+import { lintSkillLoopEngineeringReadiness } from '../../services/standards/loop-engineering-readiness-lint.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 export const LOOP_ENGINEERING_READINESS_CATEGORY = 'loop-engineering-readiness';
@@ -77,9 +77,7 @@ export function runReadinessLint(rawPath) {
             code: 'SKILL_FILE_NOT_FOUND',
             message: `could not resolve SKILL.md from --path ${rawPath}`,
             data: { path: rawPath, category: LOOP_ENGINEERING_READINESS_CATEGORY, findings: [] },
-            nextActions: [
-                'Pass a directory containing SKILL.md or a direct path to a SKILL.md file.',
-            ],
+            nextActions: ['Pass a directory containing SKILL.md or a direct path to a SKILL.md file.']
         };
     }
     const text = readFileSync(skillMdPath, 'utf-8');
@@ -92,11 +90,11 @@ export function runReadinessLint(rawPath) {
             data: {
                 path: skillMdPath,
                 category: LOOP_ENGINEERING_READINESS_CATEGORY,
-                findings: [],
+                findings: []
             },
             nextActions: [
-                'The skill is allowed to participate in Loop Engineering (crystallization / evolution).',
-            ],
+                'The skill is allowed to participate in Loop Engineering (crystallization / evolution).'
+            ]
         };
     }
     return {
@@ -106,20 +104,18 @@ export function runReadinessLint(rawPath) {
         data: {
             path: skillMdPath,
             category: LOOP_ENGINEERING_READINESS_CATEGORY,
-            findings: result.findings,
+            findings: result.findings
         },
         nextActions: [
             'Address every finding listed in data.findings, then re-run the lint.',
             'See src/services/standards/loop-engineering-readiness-lint.ts for the rule definitions.',
-            'See .peaks/standards/loop-engineering-guidelines.md for the red lines the lint enforces.',
-        ],
+            'See .peaks/standards/loop-engineering-guidelines.md for the red lines the lint enforces.'
+        ]
     };
 }
 function lintAction(options, io) {
     if (options.category !== LOOP_ENGINEERING_READINESS_CATEGORY) {
-        printResult(io, fail('skill.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_READINESS_CATEGORY} is implemented in M6`, { category: options.category ?? null }, [
-            `Pass --category ${LOOP_ENGINEERING_READINESS_CATEGORY}.`,
-        ]), options.json);
+        printResult(io, fail('skill.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_READINESS_CATEGORY} is implemented in M6`, { category: options.category ?? null }, [`Pass --category ${LOOP_ENGINEERING_READINESS_CATEGORY}.`]), options.json);
         process.exitCode = 1;
         return;
     }
@@ -138,7 +134,9 @@ function lintAction(options, io) {
         process.exitCode = 1;
     }
     catch (error) {
-        printResult(io, fail('skill.lint', 'SKILL_READINESS_ERROR', getErrorMessage(error), { path: options.path }, ['Verify the path is readable.']), options.json);
+        printResult(io, fail('skill.lint', 'SKILL_READINESS_ERROR', getErrorMessage(error), { path: options.path }, [
+            'Verify the path is readable.'
+        ]), options.json);
         process.exitCode = 1;
     }
 }
@@ -149,9 +147,10 @@ export function registerSkillLoopEngineeringReadinessCommands(program, io) {
     // the add-a-new-subcommand-check-for-existing-top-level-first rule,
     // we never re-create `skill` when it's already there.
     const existingSkill = program.commands.find((c) => c.name() === 'skill');
-    const skill = existingSkill ?? program
-        .command('skill')
-        .description('skill operations (M6: lint --category loop-engineering-readiness)');
+    const skill = existingSkill ??
+        program
+            .command('skill')
+            .description('skill operations (M6: lint --category loop-engineering-readiness)');
     addJsonOption(skill
         .command('lint')
         .description(`M6: lint a peaks-* SKILL.md against a category. Currently supports --category ${LOOP_ENGINEERING_READINESS_CATEGORY} (spec §7.5 / §8.4 / RL-8).`)

package/dist/cli/commands/skill-visibility.js

@@ -30,14 +30,14 @@ export function listSkillsVisibility(repoRoot) {
             return {
                 name: basename(entry),
                 userInvocable: true,
-                visibility: 'public',
+                visibility: 'public'
             };
         }
         const userInvocable = entry.userInvocable !== false;
         return {
             name: entry.name ?? '',
             userInvocable,
-            visibility: userInvocable ? 'public' : 'internal',
+            visibility: userInvocable ? 'public' : 'internal'
         };
     });
 }

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

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

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

@@ -21,7 +21,9 @@ const SLICE_LIST_SIZE_COL_WIDTH = 8;
 const SLICE_LIST_PICKED_COL_WIDTH = 6;
 const SLICE_LIST_SEPARATOR_WIDTH = 76;
 export function registerSliceCommands(program, io) {
-    const slice = program.command('slice').description('Slice lifecycle: check (boundary), decompose (PRD -> 6-stage algorithm), ' +
+    const slice = program
+        .command('slice')
+        .description('Slice lifecycle: check (boundary), decompose (PRD -> 6-stage algorithm), ' +
         'pick (fzf multi-select), plan (apply via peaks request init). ' +
         '`peaks slice check` is the post-micro-cycle boundary gate (4 stages). ' +
         '`decompose/pick/plan` form the new slice-decomposition pipeline.');
@@ -60,7 +62,9 @@ export function registerSliceCommands(program, io) {
             }
         }
         catch (error) {
-            printResult(io, fail('slice.check', 'SLICE_CHECK_FAILED', getErrorMessage(error), { projectRoot: options.project }, [`Verify the project path is a peaks repo and --rid names a slice (letters, digits, dots, underscores or dashes): ${options.rid ?? '(no --rid given)'}`]), options.json ?? false);
+            printResult(io, fail('slice.check', 'SLICE_CHECK_FAILED', getErrorMessage(error), { projectRoot: options.project }, [
+                `Verify the project path is a peaks repo and --rid names a slice (letters, digits, dots, underscores or dashes): ${options.rid ?? '(no --rid given)'}`
+            ]), options.json ?? false);
             process.exitCode = 1;
         }
     });
@@ -103,12 +107,21 @@ export function registerSliceCommands(program, io) {
                 if (page.some((r) => r.isStale)) {
                     nextActions.push('Some entries are stale (>30d). Use `peaks slice cleanup` to remove them.');
                 }
-                printResult(io, ok('slice.ls', { rids: page, truncated, totalBeforeFilter: filtered.length, totalScanned: all.length }, [], nextActions), true);
+                printResult(io, ok('slice.ls', {
+                    rids: page,
+                    truncated,
+                    totalBeforeFilter: filtered.length,
+                    totalScanned: all.length
+                }, [], nextActions), true);
                 return;
             }
             // Plaintext mode: header + table
             const lines = [];
-            lines.push('RID'.padEnd(SLICE_LIST_RID_COL_WIDTH) + 'MTIME'.padEnd(SLICE_LIST_MTIME_COL_WIDTH) + 'SIZE'.padEnd(SLICE_LIST_SIZE_COL_WIDTH) + 'PICKED'.padEnd(SLICE_LIST_PICKED_COL_WIDTH) + 'STALE');
+            lines.push('RID'.padEnd(SLICE_LIST_RID_COL_WIDTH) +
+                'MTIME'.padEnd(SLICE_LIST_MTIME_COL_WIDTH) +
+                'SIZE'.padEnd(SLICE_LIST_SIZE_COL_WIDTH) +
+                'PICKED'.padEnd(SLICE_LIST_PICKED_COL_WIDTH) +
+                'STALE');
             lines.push('-'.repeat(SLICE_LIST_SEPARATOR_WIDTH));
             for (const r of page) {
                 lines.push(r.rid.padEnd(SLICE_LIST_RID_COL_WIDTH) +
@@ -126,7 +139,9 @@ export function registerSliceCommands(program, io) {
             process.stdout.write(lines.join('\n') + '\n');
         }
         catch (error) {
-            printResult(io, fail('slice.ls', 'SLICE_LS_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path is a peaks repo and .peaks/sc/slice-decomposition/ exists or can be created']), options.json ?? false);
+            printResult(io, fail('slice.ls', 'SLICE_LS_FAILED', getErrorMessage(error), { projectRoot: options.project }, [
+                'Verify the project path is a peaks repo and .peaks/sc/slice-decomposition/ exists or can be created'
+            ]), options.json ?? false);
             process.exitCode = 1;
         }
     });
@@ -214,7 +229,9 @@ export function registerSliceCommands(program, io) {
             printResult(io, ok('slice.decompose', { ...result, outputPath: outPath, ...(benchmark !== null ? { benchmark } : {}) }, [], nextActions), options.json ?? false);
         }
         catch (error) {
-            printResult(io, fail('slice.decompose', 'SLICE_DECOMPOSE_FAILED', getErrorMessage(error), { rid, projectRoot: options.project }, ['Verify codegraph is initialised (npx codegraph init && npx codegraph index), the rid is correct, and the PRD body is non-empty']), options.json ?? false);
+            printResult(io, fail('slice.decompose', 'SLICE_DECOMPOSE_FAILED', getErrorMessage(error), { rid, projectRoot: options.project }, [
+                'Verify codegraph is initialised (npx codegraph init && npx codegraph index), the rid is correct, and the PRD body is non-empty'
+            ]), options.json ?? false);
             process.exitCode = 1;
         }
     });
@@ -261,7 +278,9 @@ export function registerSliceCommands(program, io) {
             else {
                 process.exitCode = 1;
             }
-            printResult(io, fail('slice.pick', 'SLICE_PICK_FAILED', msg, { rid, projectRoot: options.project }, ['Verify the decomposition file exists, fzf >= 0.38 is on PATH, and the rid is correct']), options.json ?? false);
+            printResult(io, fail('slice.pick', 'SLICE_PICK_FAILED', msg, { rid, projectRoot: options.project }, [
+                'Verify the decomposition file exists, fzf >= 0.38 is on PATH, and the rid is correct'
+            ]), options.json ?? false);
         }
     });
     // ---------- peaks slice plan (NEW) ----------
@@ -300,8 +319,12 @@ export function registerSliceCommands(program, io) {
             const msg = getErrorMessage(error);
             const isEnvelopeError = msg.startsWith('picked envelope at');
             printResult(io, fail('slice.plan', isEnvelopeError ? 'PICKED_ENVELOPE_INVALID' : 'SLICE_PLAN_FAILED', msg, { rid, projectRoot: options.project, pickedPath }, isEnvelopeError
-                ? ['Verify the -picked.json envelope matches the schema: { rid: string, picked: Array<{ rid, files: string[], label }> }']
-                : ['Verify the picked file exists, the rid is correct, and peaks request init is available']), options.json ?? false);
+                ? [
+                    'Verify the -picked.json envelope matches the schema: { rid: string, picked: Array<{ rid, files: string[], label }> }'
+                ]
+                : [
+                    'Verify the picked file exists, the rid is correct, and peaks request init is available'
+                ]), options.json ?? false);
             process.exitCode = 1;
         }
     });
@@ -321,7 +344,8 @@ function readPrdBody(rid, projectRoot) {
         try {
             entries = readdirSync(dir);
         }
-        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;
         }
         for (const entry of entries) {
@@ -396,7 +420,7 @@ function listDecompositions(projectRoot) {
         let rid;
         let isPicked;
         if (entry.endsWith('-picked.json')) {
-            rid = entry.slice(0, -('-picked.json'.length));
+            rid = entry.slice(0, -'-picked.json'.length);
             isPicked = true;
         }
         else {
@@ -433,7 +457,7 @@ function listDecompositions(projectRoot) {
             isStale: nowMs - st.mtime.getTime() > STALE_THRESHOLD_MS
         });
     }
-    return Array.from(byRid.values()).sort((a, b) => (a.mtime < b.mtime ? 1 : a.mtime > b.mtime ? -1 : 0));
+    return Array.from(byRid.values()).sort((a, b) => a.mtime < b.mtime ? 1 : a.mtime > b.mtime ? -1 : 0);
 }
 function writeBenchmarkArtifact(rid, benchmark, projectRoot) {
     // Reuse the current session binding if present; otherwise fall back to

package/dist/cli/commands/slice-integrate-commands.js

@@ -67,19 +67,18 @@ export function registerSliceIntegrateCommands(program, io) {
         .option('--project <path>', 'project root (default: cwd)')).action((opts) => {
         const projectRoot = opts.project ?? resolve(process.cwd());
         const sessionId = opts.sessionId ?? getCurrentSessionId(projectRoot) ?? 'unknown-sid';
-        const sliceIds = opts.slices.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+        const sliceIds = opts.slices
+            .split(',')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
         if (sliceIds.length < 2) {
-            printResult(io, fail('slice-integrate', 'TOO_FEW_SLICES', 'need at least 2 slice ids to verify integration', { projectRoot, sessionId, sliceIds }, [
-                'Pass --slices id1,id2,id3 (at least 2).'
-            ]), opts.json ?? false);
+            printResult(io, fail('slice-integrate', 'TOO_FEW_SLICES', 'need at least 2 slice ids to verify integration', { projectRoot, sessionId, sliceIds }, ['Pass --slices id1,id2,id3 (at least 2).']), opts.json ?? false);
             process.exitCode = 1;
             return;
         }
         const contracts = loadContractsForSlices(projectRoot, sessionId, sliceIds);
         if (contracts.length === 0) {
-            printResult(io, fail('slice-integrate', 'NO_CONTRACTS', `no contracts found for the given slice ids under session ${sessionId}`, { projectRoot, sessionId, sliceIds }, [
-                'Run `peaks contract write` first, or check --session-id.'
-            ]), opts.json ?? false);
+            printResult(io, fail('slice-integrate', 'NO_CONTRACTS', `no contracts found for the given slice ids under session ${sessionId}`, { projectRoot, sessionId, sliceIds }, ['Run `peaks contract write` first, or check --session-id.']), opts.json ?? false);
             process.exitCode = 1;
             return;
         }

package/dist/cli/commands/slice-review-commands-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Support constants + option schemas + hint renderers extracted verbatim from
+ * `slice-review-commands.ts` (file-size cap campaign). Mechanical move only:
+ * the four command descriptions, the score/reject action option schemas, and
+ * the pending/rejected checklist hint texts.
+ */
+export declare const SLICE_REVIEW_DESCRIPTION: string;
+export declare const SLICE_SCORE_DESCRIPTION: string;
+export declare const SLICE_ACCEPT_DESCRIPTION: string;
+export declare const SLICE_REJECT_DESCRIPTION: string;
+export interface SliceScoreOpts {
+    item: string;
+    score: string;
+    note?: string;
+    sessionId?: string;
+    project?: string;
+    json?: boolean;
+}
+export interface SliceRejectOpts {
+    reason: string;
+    sessionId?: string;
+    project?: string;
+    json?: boolean;
+}
+export declare const PENDING_SCORE_HINTS: string[];
+export declare function renderRejectionNotes(rejectionReason?: string): string[];

package/dist/cli/commands/slice-review-commands-helpers.js

@@ -0,0 +1,26 @@
+/**
+ * Support constants + option schemas + hint renderers extracted verbatim from
+ * `slice-review-commands.ts` (file-size cap campaign). Mechanical move only:
+ * the four command descriptions, the score/reject action option schemas, and
+ * the pending/rejected checklist hint texts.
+ */
+export const SLICE_REVIEW_DESCRIPTION = 'Show the 4-5 business review items for a slice (template; user scores 1-5). ' +
+    'If no review exists for the slice, a new one is created (pending state). ' +
+    'The 12 Gaps positioning memory: user reviews BUSINESS / PRODUCT, not technical.';
+export const SLICE_SCORE_DESCRIPTION = 'Record a single item score (1-5). 1 = P0 fail, 2-3 = needs work, 4-5 = OK. ' +
+    'The 12 Gaps threshold: avg >= 3 AND no item <= 2 → accepted; otherwise rejected.';
+export const SLICE_ACCEPT_DESCRIPTION = 'Mark the slice as accepted (user-approved). All 4-5 items must be ' +
+    'scored; the derived decision must be "accepted" (avg >= 3 AND ' +
+    'no item <= 2). Otherwise the accept is rejected by the gate.';
+export const SLICE_REJECT_DESCRIPTION = 'Mark the slice as rejected with a reason. The slice goes back to ' +
+    'peaks-rd repair-loop. The reason is persisted for the audit trail.';
+export const PENDING_SCORE_HINTS = [
+    `Score each item with: peaks slice score <slice-id> --item <id> --score <1-5>`,
+    `When all items are scored, run: peaks slice accept <slice-id>`
+];
+export function renderRejectionNotes(rejectionReason) {
+    return [
+        `Rejected: ${rejectionReason ?? '(no reason)'}`,
+        'Address the issue, then re-score and accept.'
+    ];
+}