peaks-loop 4.0.53 → 4.1.0

package/dist/cli/commands/core/binding-commands.js

@@ -10,13 +10,15 @@ import { fail, ok } from 'peaks-loop-shared/result';
 // field in the JSON envelope, so downstream automation can act on it
 // without parsing CLI prose.
 export function registerBindingCommands(program, io) {
-    const binding = program.command('binding').description('Inspect and manage the project-level binding store (v2.18.2)');
+    const binding = program
+        .command('binding')
+        .description('Inspect and manage the project-level binding store (v2.18.2)');
     addJsonOption(binding
         .command('status')
         .description('Print the current binding-store contents (sids, callerIds, pids, lastHeartbeat, roles). Read-only.')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')
         .option('--format <format>', 'output format: table (default for non-TTY) | json', 'table')).action((options) => {
-        const projectRoot = options.project ?? (findProjectRoot(process.cwd()) ?? process.cwd());
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
         const view = loadBindingStatus(projectRoot);
         // Mode resolution priority: --json flag beats --format. The
         // double-flag form is intentional: `--json` keeps back-compat
@@ -28,15 +30,16 @@ export function registerBindingCommands(program, io) {
         if (useJson) {
             const payload = formatJson(view);
             const result = view.binding === null
-                ? ok('binding.status', { ...payload, note: 'no binding found; run `peaks workspace init --project <repo>` to create one' })
+                ? ok('binding.status', {
+                    ...payload,
+                    note: 'no binding found; run `peaks workspace init --project <repo>` to create one'
+                })
                 : ok('binding.status', payload);
             printResult(io, result, true);
         }
         else {
             if (view.binding === null) {
-                const result = fail('binding.status', 'NO_BINDING', 'no binding found for the project', { projectRoot }, [
-                    `Run \`peaks workspace init --project <repo>\` to create one`
-                ]);
+                const result = fail('binding.status', 'NO_BINDING', 'no binding found for the project', { projectRoot }, [`Run \`peaks workspace init --project <repo>\` to create one`]);
                 printResult(io, result, false);
                 process.exitCode = 1;
                 return;

package/dist/cli/commands/core/doctor-command.js

@@ -47,7 +47,9 @@ function statusLineAlreadyInstalledForScope(scope, projectRoot) {
  * kept verbatim. ≤ 2 KB by construction.
  */
 export function buildDoctorSummary(data) {
-    const checks = Array.isArray(data.checks) ? data.checks : [];
+    const checks = Array.isArray(data.checks)
+        ? data.checks
+        : [];
     const label = (c) => {
         const id = typeof c.id === 'string' ? c.id : 'unknown';
         if (c.ok === true)
@@ -62,14 +64,14 @@ export function buildDoctorSummary(data) {
         view: 'summary',
         summary: data.summary,
         checks: boundedNames(checks.map(label)),
-        failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`)),
+        failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`))
     };
     if (stale !== null) {
         view.staleBinding = {
             ttlMs: stale.ttlMs,
             staleCount: stale.staleCount,
             droppedCount: stale.droppedCount,
-            droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : []),
+            droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : [])
         };
     }
     if (data.logs !== undefined)
@@ -85,7 +87,8 @@ function doctorStatusLineInstalledProbe() {
             return 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)
         /* fall through to global */
     }
     try {

package/dist/cli/commands/core/memory-command.js

@@ -1,4 +1,4 @@
-import { describeMemoryBlockDrops, executeProjectMemoryBackup, executeProjectMemoryExtract, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult, VALID_PROJECT_MEMORY_KINDS } from '../../../services/memory/project-memory-service.js';
+import { describeMemoryBlockDrops, executeProjectMemoryBackup, executeProjectMemoryExtract, SENSITIVE_MEMORY_CHECKS, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult, UnsafeMemoryError, VALID_PROJECT_MEMORY_KINDS } from '../../../services/memory/project-memory-service.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
 /** Derived from the canonical kind vocabulary — never hand-maintain a list here. */
@@ -18,7 +18,11 @@ export function registerMemoryCommand(program, io) {
             return;
         }
         try {
-            const result = executeProjectMemoryExtract({ projectRoot: options.project, artifactPaths: options.artifact, apply: options.apply === true });
+            const result = executeProjectMemoryExtract({
+                projectRoot: options.project,
+                artifactPaths: options.artifact,
+                apply: options.apply === true
+            });
             // A block that was found but not extracted must not vanish silently: the
             // parser's rejection reasons ride the envelope's existing `warnings`
             // channel (JSON: `warnings[]`; human: `warning: …` on stderr). `data` is
@@ -26,7 +30,13 @@ export function registerMemoryCommand(program, io) {
             printResult(io, ok('memory.extract', summarizeProjectMemoryExtractResult(result), describeMemoryBlockDrops(result.droppedBlocks)), options.json);
         }
         catch (error) {
-            printResult(io, fail('memory.extract', 'MEMORY_EXTRACT_FAILED', getErrorMessage(error), {}, ['Check artifact paths and remove secrets before extracting memory']), options.json);
+            const refusal = error instanceof UnsafeMemoryError ? error : null;
+            printResult(io, fail('memory.extract', 'MEMORY_EXTRACT_FAILED', getErrorMessage(error), 
+            // The check and the term are facts about the failure, so they ride
+            // the envelope's data — not just its prose. `fail()` redacts
+            // `message` (see `UnsafeMemoryError`), so the term would otherwise
+            // reach the reader as `[redacted]`; `data` is passed through.
+            refusal === null ? {} : { check: refusal.check, matchedTerm: refusal.matchedTerm }, memoryExtractNextActions(refusal)), options.json);
             process.exitCode = 1;
         }
     });
@@ -43,11 +53,17 @@ export function registerMemoryCommand(program, io) {
             return;
         }
         try {
-            const result = executeProjectMemoryBackup({ projectRoot: options.project, artifactWorkspacePath: options.workspace, apply: options.apply === true });
+            const result = executeProjectMemoryBackup({
+                projectRoot: options.project,
+                artifactWorkspacePath: options.workspace,
+                apply: options.apply === true
+            });
             printResult(io, ok('memory.sync', summarizeProjectMemoryBackupResult(result)), options.json);
         }
         catch (error) {
-            printResult(io, fail('memory.sync', 'MEMORY_SYNC_FAILED', getErrorMessage(error), {}, ['Use an artifact workspace outside the project root']), options.json);
+            printResult(io, fail('memory.sync', 'MEMORY_SYNC_FAILED', getErrorMessage(error), {}, [
+                'Use an artifact workspace outside the project root'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -59,21 +75,27 @@ export function registerMemoryCommand(program, io) {
         .option('--fzf-bin <path>', 'override fzf binary path (default: fzf on PATH)', 'fzf')
         .option('--summary', 'emit counts + names-of-first-N only (≤ 2 KB) instead of the full entry array; the default envelope is unchanged')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
-        void import('../memory-commands.js').then(({ runMemoryList }) => {
+        void import('../memory-commands.js')
+            .then(({ runMemoryList }) => {
             void runMemoryList(io, {
                 ...(options.kind !== undefined ? { kind: options.kind } : {}),
                 ...(options.pick === true ? { pick: true } : {}),
                 ...(options.fzfBin ? { fzfBin: options.fzfBin } : {}),
                 ...(options.project !== undefined ? { project: options.project } : {}),
                 ...(options.summary === true ? { summary: true } : {}),
-                ...(options.json !== undefined ? { json: options.json } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {})
             });
-        }).catch((error) => {
+        })
+            .catch((error) => {
             const msg = /brew install fzf|apt-get install fzf|older than required/.test(getErrorMessage(error))
                 ? 'fzf binary not found or too old. Install with: brew install fzf (or apt: apt-get install fzf). peaks memory list --pick requires fzf >= 0.38.'
                 : getErrorMessage(error);
-            const code = /brew install fzf|apt-get install fzf|older than required/.test(msg) ? 'FZF_UNAVAILABLE' : 'MEMORY_LIST_BOOTSTRAP_FAILED';
-            printResult(io, fail('memory.list', code, msg, {}, ['Install fzf or run without --pick to list entries as JSON']), options.json);
+            const code = /brew install fzf|apt-get install fzf|older than required/.test(msg)
+                ? 'FZF_UNAVAILABLE'
+                : 'MEMORY_LIST_BOOTSTRAP_FAILED';
+            printResult(io, fail('memory.list', code, msg, {}, [
+                'Install fzf or run without --pick to list entries as JSON'
+            ]), options.json);
             if (code === 'FZF_UNAVAILABLE')
                 process.exitCode = 127;
             else
@@ -87,15 +109,17 @@ export function registerMemoryCommand(program, io) {
         .option('--dry-run', 'report drift without writing (default)')
         .option('--apply', 'rebuild index.json and regenerate MEMORY.md')
         .option('--summary', 'emit drift counts + names-of-first-N only (≤ 2 KB) instead of the full arrays; the default envelope is unchanged')).action((options) => {
-        void import('../memory-commands.js').then(({ runMemoryReindex }) => {
+        void import('../memory-commands.js')
+            .then(({ runMemoryReindex }) => {
             void runMemoryReindex(io, {
                 ...(options.project !== undefined ? { project: options.project } : {}),
                 ...(options.dryRun === true ? { dryRun: true } : {}),
                 ...(options.apply === true ? { apply: true } : {}),
                 ...(options.summary === true ? { summary: true } : {}),
-                ...(options.json !== undefined ? { json: options.json } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {})
             });
-        }).catch((error) => {
+        })
+            .catch((error) => {
             printResult(io, fail('memory.reindex', 'MEMORY_REINDEX_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
             process.exitCode = 1;
         });
@@ -107,15 +131,17 @@ export function registerMemoryCommand(program, io) {
         .option('--source-dir <path>', 'override the IDE-side memory directory')
         .option('--dry-run', 'preview imports without writing (default)')
         .option('--apply', 'write normalized memories into .peaks/memory')).action((options) => {
-        void import('../memory-commands.js').then(({ runMemoryIngest }) => {
+        void import('../memory-commands.js')
+            .then(({ runMemoryIngest }) => {
             void runMemoryIngest(io, {
                 ...(options.project !== undefined ? { project: options.project } : {}),
                 ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
                 ...(options.dryRun === true ? { dryRun: true } : {}),
                 ...(options.apply === true ? { apply: true } : {}),
-                ...(options.json !== undefined ? { json: options.json } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {})
             });
-        }).catch((error) => {
+        })
+            .catch((error) => {
             printResult(io, fail('memory.ingest', 'MEMORY_INGEST_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
             process.exitCode = 1;
         });
@@ -126,14 +152,16 @@ export function registerMemoryCommand(program, io) {
         .option('--project <path>', 'target project root (defaults to git root or cwd)')
         .option('--dry-run', 'report the rotation plan without moving anything (default)')
         .option('--apply', 'move tier-C candidates into .peaks/memory/archived/')).action((options) => {
-        void import('../memory-commands.js').then(({ runMemoryRotate }) => {
+        void import('../memory-commands.js')
+            .then(({ runMemoryRotate }) => {
             void runMemoryRotate(io, {
                 ...(options.project !== undefined ? { project: options.project } : {}),
                 ...(options.dryRun === true ? { dryRun: true } : {}),
                 ...(options.apply === true ? { apply: true } : {}),
-                ...(options.json !== undefined ? { json: options.json } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {})
             });
-        }).catch((error) => {
+        })
+            .catch((error) => {
             printResult(io, fail('memory.rotate', 'MEMORY_ROTATE_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
             process.exitCode = 1;
         });
@@ -146,17 +174,48 @@ export function registerMemoryCommand(program, io) {
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((query, options) => {
         // Lazy import avoids a top-of-file import cycle (memory-commands.ts
         // imports services that the rest of this file may also touch).
-        void import('../memory-commands.js').then(({ runMemorySearch }) => {
+        void import('../memory-commands.js')
+            .then(({ runMemorySearch }) => {
             void runMemorySearch(io, {
                 query,
                 ...(options.kind !== undefined ? { kind: options.kind } : {}),
                 ...(options.limit !== undefined ? { limit: options.limit } : {}),
                 ...(options.project !== undefined ? { project: options.project } : {}),
-                ...(options.json !== undefined ? { json: options.json } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {})
             });
-        }).catch((error) => {
+        })
+            .catch((error) => {
             printResult(io, fail('memory.search', 'MEMORY_SEARCH_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
             process.exitCode = 1;
         });
     });
 }
+/**
+ * The remedy for a failed `memory extract`, chosen by the check that refused
+ * the write — the same `SENSITIVE_MEMORY_CHECKS` values the refusal message
+ * and envelope data are built from, so the message, the data and the advice
+ * cannot drift apart.
+ *
+ * WHY IT IS NOT ONE STATIC STRING. Every failure used to get "Check artifact
+ * paths and remove secrets before extracting memory" — including a refusal
+ * raised only because a memory TITLE contained a word like `authority`
+ * (slice C0). There was no secret anywhere in that memory, so the one thing
+ * the hint told the user to do was the one thing that could not help: it sent
+ * them looking for a credential that did not exist. A remedy has to answer the
+ * check that actually failed.
+ *
+ * `null` (a failure that is not a safety refusal — a path escape, a missing
+ * artifact) keeps the pre-C0 hint, which is about paths and secrets rather
+ * than about a check.
+ */
+function memoryExtractNextActions(refusal) {
+    if (refusal === null) {
+        return ['Check artifact paths and remove secrets before extracting memory'];
+    }
+    if (refusal.check === SENSITIVE_MEMORY_CHECKS.title) {
+        return [
+            'Retitle the memory so it is not named after a credential term, then re-run memory extract'
+        ];
+    }
+    return ['Remove the credential value from the memory content, then re-run memory extract'];
+}

package/dist/cli/commands/core/proxy-command.js

@@ -19,7 +19,9 @@ export function registerProxyCommand(program, io) {
             printResult(io, ok('proxy.test', plan), options.json);
         }
         catch (error) {
-            printResult(io, fail('proxy.test', 'INVALID_PROXY', getErrorMessage(error), {}, ['Use a proxy URL starting with http:// or https://']), options.json);
+            printResult(io, fail('proxy.test', 'INVALID_PROXY', getErrorMessage(error), {}, [
+                'Use a proxy URL starting with http:// or https://'
+            ]), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -26,9 +26,7 @@ import { registerSession24hModeCommand } from '../session-24h-mode.js';
 import { registerSpillDemoCommand } from '../spill-demo-command.js';
 export function registerSessionCommand(program, io) {
     const session = program.command('session').description('Manage Peaks session directories');
-    addJsonOption(session
-        .command('list')
-        .description('List all session directories with titles and metadata')).action((options) => {
+    addJsonOption(session.command('list').description('List all session directories with titles and metadata')).action((options) => {
         const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
         const metas = listSessionMetas(projectRoot);
         printResult(io, ok('session.list', { sessions: metas, total: metas.length }), options.json);
@@ -64,7 +62,10 @@ export function registerSessionCommand(program, io) {
             catch (error) {
                 if (error instanceof CallerIdError) {
                     const code = error.code === 'EX_USAGE' ? 64 : 65;
-                    printResult(io, fail('session.info', 'CALLER_ID_INVALID', error.message, { source: error.source }, [`Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$`, 'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)']), options.json);
+                    printResult(io, fail('session.info', 'CALLER_ID_INVALID', error.message, { source: error.source }, [
+                        `Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$`,
+                        'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)'
+                    ]), options.json);
                     process.exitCode = code;
                     return;
                 }
@@ -93,7 +94,10 @@ export function registerSessionCommand(program, io) {
                 }), options.json);
                 return;
             }
-            printResult(io, ok('session.info', { callerId, note: '--caller-id resolved; pass --active to also look up the bound peak session' }), options.json);
+            printResult(io, ok('session.info', {
+                callerId,
+                note: '--caller-id resolved; pass --active to also look up the bound peak session'
+            }), options.json);
             return;
         }
         // Slice 007 + slice 021 — sub-agent session sharing. A sub-agent that
@@ -147,7 +151,9 @@ export function registerSessionCommand(program, io) {
             // contract). `warnings` is a top-level envelope field, not a
             // data field, so it goes through ok()'s 3rd positional arg.
             const legacyWarnings = bindingSource === 'legacy'
-                ? ['Read from legacy back-compat path .peaks/.session.json. Run `peaks workspace reconcile --apply` to migrate to the canonical home (.peaks/_runtime/session.json).']
+                ? [
+                    'Read from legacy back-compat path .peaks/.session.json. Run `peaks workspace reconcile --apply` to migrate to the canonical home (.peaks/_runtime/session.json).'
+                ]
                 : [];
             printResult(io, ok('session.info', {
                 active: true,
@@ -182,7 +188,9 @@ export function registerSessionCommand(program, io) {
             printResult(io, ok('session.title', meta), options.json);
         }
         catch (error) {
-            printResult(io, fail('session.title', 'SESSION_TITLE_FAILED', getErrorMessage(error), { sessionId }, ['Verify the sessionId exists under .peaks/']), options.json);
+            printResult(io, fail('session.title', 'SESSION_TITLE_FAILED', getErrorMessage(error), { sessionId }, [
+                'Verify the sessionId exists under .peaks/'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -210,7 +218,7 @@ export function registerSessionCommand(program, io) {
         .command('rotate')
         .description('Drop the project-level session binding so the next peaks call auto-generates a fresh session id. The on-disk session directory is left intact — only .peaks/.session.json is removed.')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--reason <text>', 'human-readable reason for the rotation, recorded in the response data')).action(async (options) => {
+        .option('--reason <text>', 'human-readable reason for the rotation, recorded in the response data')).action((options) => {
         try {
             // Canonicalise the project root before touching the binding.
             // `peaks workspace init` writes the binding with the

package/dist/cli/commands/core/skill-command.js

@@ -153,7 +153,10 @@ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.j
 import { registerSkillSearchCommand } from '../skill-search-commands.js';
 export function registerSkillCommand(program, io) {
     const skill = program.command('skill').description('Manage Peaks skills');
-    addJsonOption(skill.command('list').description('List skills derived from skills/*/SKILL.md').option('--include-internal', 'include skills with visibility: internal (default: hide them)')).action(async (options) => {
+    addJsonOption(skill
+        .command('list')
+        .description('List skills derived from skills/*/SKILL.md')
+        .option('--include-internal', 'include skills with visibility: internal (default: hide them)')).action(async (options) => {
         let skills = await listSkills();
         if (options.includeInternal !== true) {
             skills = skills.filter((s) => s.visibility !== 'internal');
@@ -227,14 +230,14 @@ export function registerSkillCommand(program, io) {
                 projectRoot,
                 ...(platforms !== undefined ? { platforms } : {}),
                 ...(options.dryRun === true ? { dryRun: true } : {}),
-                ...(options.reconcileJunctions === true ? { reconcileJunctions: true } : {}),
+                ...(options.reconcileJunctions === true ? { reconcileJunctions: true } : {})
             });
             const envelope = ok('skill.sync', result, [], [
                 `syncedCount: ${result.syncedCount}/${result.perPlatform.length} platforms`,
                 `totalInstalled: ${result.totalInstalled} skill symlinks`,
                 result.failedCount > 0
                     ? `failedCount: ${result.failedCount} (run \`peaks skill status\` for details)`
-                    : 'no failures',
+                    : 'no failures'
             ]);
             printResult(io, envelope, options.json);
             if (result.failedCount > 0) {
@@ -257,7 +260,9 @@ export function registerSkillCommand(program, io) {
                 : fail('skill.runbook', inspection.hasRunbook ? 'SKILL_RUNBOOK_APPLY_UNGATED' : 'SKILL_RUNBOOK_MISSING', inspection.hasRunbook
                     ? `Skill ${inspection.name} has ${inspection.destructiveApplyLines.length} destructive --apply command(s) without an authorization/dry-run note`
                     : `Skill ${inspection.name} is missing a ## Default runbook section`, inspection, inspection.hasRunbook
-                    ? ['Add an authorization or --dry-run note next to destructive --apply lines in the runbook section']
+                    ? [
+                        'Add an authorization or --dry-run note next to destructive --apply lines in the runbook section'
+                    ]
                     : ['Add a `## Default runbook` section to the skill SKILL.md']);
             printResult(io, result, options.json);
             if (!inspection.ok) {
@@ -304,7 +309,12 @@ export function registerSkillCommand(program, io) {
             }, generatedConfig.warnings, verdict.nextActions), options.json);
             return;
         }
-        printResult(io, ok('skill.presence', { active: true, ...presence, ...(verdict.context !== null ? { context: verdict.context } : {}), ...generatedConfig.field }, generatedConfig.warnings, verdict.nextActions), options.json);
+        printResult(io, ok('skill.presence', {
+            active: true,
+            ...presence,
+            ...(verdict.context !== null ? { context: verdict.context } : {}),
+            ...generatedConfig.field
+        }, generatedConfig.warnings, verdict.nextActions), options.json);
     });
     addJsonOption(skill
         .command('presence:set <name>')
@@ -328,7 +338,9 @@ export function registerSkillCommand(program, io) {
         // production CLI traffic must go through this gate.
         const boundSessionId = getSessionId(projectRoot);
         if (boundSessionId === null) {
-            printResult(io, fail('skill.presence:set', 'PEAKS_SESSION_NOT_BOUND', 'No canonical peaks session is bound for this project (RD §3 D1).', { projectRoot, name }, ['Run `peaks workspace init --project <p>` first, then re-run `peaks skill presence:set`.']), options.json);
+            printResult(io, fail('skill.presence:set', 'PEAKS_SESSION_NOT_BOUND', 'No canonical peaks session is bound for this project (RD §3 D1).', { projectRoot, name }, [
+                'Run `peaks workspace init --project <p>` first, then re-run `peaks skill presence:set`.'
+            ]), options.json);
             process.exitCode = 1;
             return;
         }
@@ -337,8 +349,10 @@ export function registerSkillCommand(program, io) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            printResult(io, fail('skill.presence:set', 'PEAKS_CALLER_NOT_RESOLVED', `Active IDE adapter could not resolve a callerId (RD §3 D1): ${message}`, { projectRoot, name }, ['Ensure the active IDE is detected by `peaks` and the IDE session variable is set.',
-                'Or set PEAKS_CALLER_ID=<id> in the environment for scripted usage.']), options.json);
+            printResult(io, fail('skill.presence:set', 'PEAKS_CALLER_NOT_RESOLVED', `Active IDE adapter could not resolve a callerId (RD §3 D1): ${message}`, { projectRoot, name }, [
+                'Ensure the active IDE is detected by `peaks` and the IDE session variable is set.',
+                'Or set PEAKS_CALLER_ID=<id> in the environment for scripted usage.'
+            ]), options.json);
             process.exitCode = 1;
             return;
         }
@@ -376,7 +390,8 @@ export function registerSkillCommand(program, io) {
         try {
             await generateProjectContext(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)
             // non-fatal: context update failure should not block presence clear
         }
         // Report the state the project is actually in, not the state this command
@@ -435,7 +450,7 @@ export function registerSkillCommand(program, io) {
             const result = await gcStalePresenceLeases({
                 projectRoot,
                 ...(options.now !== undefined ? { now: options.now } : {}),
-                trigger: 'manual',
+                trigger: 'manual'
             });
             printResult(io, ok('skill.lease.gc', {
                 envelopeVersion: '4.0.8',
@@ -444,14 +459,16 @@ export function registerSkillCommand(program, io) {
                 trigger: result.trigger,
                 inFlightBatch: result.inFlightBatch,
                 warnings: result.warnings,
-                errors: result.errors,
+                errors: result.errors
             }, result.warnings.map((w) => `${w.code}: ${w.message}`), [
                 'GC predicate: now - lastHeartbeat > 1h AND now - startedAt > 24h (RD §3 D2 + D3).',
-                'Re-run `peaks workspace init` or `peaks skill presence:set` to sweep the same project on the bound trigger.',
+                'Re-run `peaks workspace init` or `peaks skill presence:set` to sweep the same project on the bound trigger.'
             ]), options.json);
         }
         catch (err) {
-            printResult(io, fail('skill.lease.gc', 'PEAKS_LEASE_GC_FAILED', getErrorMessage(err), { projectRoot }, ['Re-run with a valid --project and ensure the session is bound.']), options.json);
+            printResult(io, fail('skill.lease.gc', 'PEAKS_LEASE_GC_FAILED', getErrorMessage(err), { projectRoot }, [
+                'Re-run with a valid --project and ensure the session is bound.'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -495,9 +512,7 @@ export function registerSkillCommand(program, io) {
         };
         printResult(io, ok('skill.presence:check-stale', data), options.json);
     });
-    addJsonOption(skill
-        .command('heartbeat')
-        .description('Show the heartbeat status of the active Peaks skill')).action((options) => {
+    addJsonOption(skill.command('heartbeat').description('Show the heartbeat status of the active Peaks skill')).action((options) => {
         const presence = getSkillPresence();
         if (presence === null) {
             printResult(io, ok('skill.heartbeat', { active: false, heartbeat: 'none' }), options.json);

package/dist/cli/commands/core/standards-command.js

@@ -20,14 +20,22 @@ export const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = '.peaks/standards/loop-
 export function runLoopEngineeringLint(projectRoot) {
     const root = resolve(projectRoot);
     const guidelinePath = join(root, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH);
-    const data = { category: LOOP_ENGINEERING_CATEGORY, path: guidelinePath, redLineCount: 0, redLineIds: [], findings: [] };
+    const data = {
+        category: LOOP_ENGINEERING_CATEGORY,
+        path: guidelinePath,
+        redLineCount: 0,
+        redLineIds: [],
+        findings: []
+    };
     if (!existsSync(guidelinePath)) {
         return {
             ok: false,
             code: 'LINT_FILE_NOT_FOUND',
             message: `no ${LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH} under ${root}`,
             data,
-            nextActions: [`Pass --project pointing at a peaks-loop checkout (the lint reads its own guideline file).`],
+            nextActions: [
+                `Pass --project pointing at a peaks-loop checkout (the lint reads its own guideline file).`
+            ]
         };
     }
     const result = lintLoopEngineeringGuidelines(readFileSync(guidelinePath, 'utf-8'));
@@ -39,7 +47,7 @@ export function runLoopEngineeringLint(projectRoot) {
             code: 'STANDARDS_LINT_OK',
             message: `${redLineIds.length} red line(s) present with all 4 sections (expected: ${EXPECTED_RED_LINE_IDS.join(', ')})`,
             data: fullData,
-            nextActions: ['Any new red line must use the 4-section form or this lint will reject it.'],
+            nextActions: ['Any new red line must use the 4-section form or this lint will reject it.']
         };
     }
     return {
@@ -49,12 +57,14 @@ export function runLoopEngineeringLint(projectRoot) {
         data: { ...fullData, findings: result.findings },
         nextActions: [
             'Address every finding in data.findings, then re-run the lint.',
-            'Each red line must be a `## RL-N — <title>` heading with the 4 sections: Failure modes / Rewrite / Self-check / Out-of-scope.',
-        ],
+            'Each red line must be a `## RL-N — <title>` heading with the 4 sections: Failure modes / Rewrite / Self-check / Out-of-scope.'
+        ]
     };
 }
 export function registerStandardsCommand(program, io) {
-    const standards = program.command('standards').description('Manage project-local coding standards');
+    const standards = program
+        .command('standards')
+        .description('Manage project-local coding standards');
     addJsonOption(standards
         .command('init')
         .description('Initialize project-local coding standards for Peaks skill preflight')
@@ -69,11 +79,22 @@ export function registerStandardsCommand(program, io) {
             return;
         }
         try {
-            const result = executeProjectStandardsInitIdeAware({ projectRoot: options.project, ...(options.language !== undefined ? { language: options.language } : {}), ...(options.ide !== undefined ? { ideId: options.ide } : {}), apply: options.apply === true });
+            const result = executeProjectStandardsInitIdeAware({
+                projectRoot: options.project,
+                ...(options.language !== undefined ? { language: options.language } : {}),
+                ...(options.ide !== undefined
+                    ? {
+                        ideId: options.ide
+                    }
+                    : {}),
+                apply: options.apply === true
+            });
             printResult(io, ok('standards.init', summarizeProjectStandardsInitResult(result)), options.json);
         }
         catch (error) {
-            printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, ['Check the project path and existing .claude/rules directory before retrying']), options.json);
+            printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, [
+                'Check the project path and existing .claude/rules directory before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -86,12 +107,23 @@ export function registerStandardsCommand(program, io) {
         .option('--dry-run', 'preview writes without changing files')
         .option('--apply', 'append managed metadata to the target project')).action((options) => {
         if (options.dryRun === true && options.apply === true) {
-            printResult(io, fail('standards.update', 'INVALID_STANDARDS_UPDATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview writes, or omit --dry-run when applying standards updates']), options.json);
+            printResult(io, fail('standards.update', 'INVALID_STANDARDS_UPDATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, [
+                'Run without --apply to preview writes, or omit --dry-run when applying standards updates'
+            ]), options.json);
             process.exitCode = 1;
             return;
         }
         try {
-            const result = executeProjectStandardsUpdateIdeAware({ projectRoot: options.project, ...(options.language !== undefined ? { language: options.language } : {}), ...(options.ide !== undefined ? { ideId: options.ide } : {}), apply: options.apply === true });
+            const result = executeProjectStandardsUpdateIdeAware({
+                projectRoot: options.project,
+                ...(options.language !== undefined ? { language: options.language } : {}),
+                ...(options.ide !== undefined
+                    ? {
+                        ideId: options.ide
+                    }
+                    : {}),
+                apply: options.apply === true
+            });
             const summary = summarizeProjectStandardsUpdateResult(result);
             const response = summary.reviewSuggestions.length > 0
                 ? fail('standards.update', 'STANDARDS_UPDATE_REVIEW_REQUIRED', 'Standards update requires manual review', summary, summary.reviewSuggestions)
@@ -102,7 +134,9 @@ export function registerStandardsCommand(program, io) {
             }
         }
         catch (error) {
-            printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, ['Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying']), options.json);
+            printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, [
+                'Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -126,7 +160,7 @@ export function registerStandardsCommand(program, io) {
                     preservedFiles: [],
                     wouldChange: false,
                     applied: false,
-                    nextActions: [],
+                    nextActions: []
                 }, [getErrorMessage(error)]), options.json);
                 process.exitCode = 1;
             }
@@ -137,7 +171,15 @@ export function registerStandardsCommand(program, io) {
             printResult(io, ok('standards.migrate', result.data, [], result.data.nextActions), options.json);
         }
         catch (error) {
-            printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), { file: null, foundOldBlock: false, wouldChange: false, applied: false, before: null, after: null, nextActions: [] }, [getErrorMessage(error)]), options.json);
+            printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), {
+                file: null,
+                foundOldBlock: false,
+                wouldChange: false,
+                applied: false,
+                before: null,
+                after: null,
+                nextActions: []
+            }, [getErrorMessage(error)]), options.json);
             process.exitCode = 1;
         }
     });