peaks-loop 4.0.0-beta → 4.0.0-beta.11

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

@@ -1,132 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { detectPerfAudit, isPerfAuditEnvelope, runPerfAudit, } from '../../services/audit-independent/perf-audit-service.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-function resolveEnvelope(envelopePath) {
-    if (envelopePath === undefined || envelopePath === '-') {
-        // Read from stdin
-        return readStdinSync();
-    }
-    try {
-        const raw = readFileSync(envelopePath, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        throw new Error(`Failed to read envelope from ${envelopePath}: ${getErrorMessage(error)}`);
-    }
-}
-function readStdinSync() {
-    // Node 22: read stdin synchronously via fs.readFileSync(0, 'utf8').
-    // We use the file descriptor 0 convention.
-    try {
-        // Lazy import to avoid pulling readline at module load
-        const { readFileSync: rfs } = require('node:fs');
-        const raw = rfs(0, 'utf8');
-        if (raw.trim().length === 0) {
-            throw new Error('stdin was empty; expected JSON envelope on stdin or --envelope <path>');
-        }
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.startsWith('stdin was empty')) {
-            throw error;
-        }
-        throw new Error(`Failed to read envelope from stdin: ${getErrorMessage(error)}`);
-    }
-}
-export function registerPerfAuditCommands(program, io) {
-    const perfAudit = program
-        .command('perf-audit')
-        .description('Independent performance audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level perf-template.md, then writes a structured perf-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 3). See skills/bee/peaks-perf-audit/SKILL.md for the full workflow.');
-    addJsonOption(perfAudit
-        .command('detect')
-        .description('Read-only probe: returns the 5-state perf-audit runtime as a JSON envelope (ready / handoff-missing / template-missing / dispatch-failed / envelope-malformed). The peaks-perf-audit skill calls this first to decide whether to invoke `run`. Mirrors `peaks security-audit detect` semantics.')
-        .option('--rid <rid>', 'request id (e.g. 2026-06-27-v2-12-...)')
-        .option('--sid <sid>', 'session id (e.g. 2026-06-27-session-...)')
-        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
-        const projectRoot = options.project ?? process.cwd();
-        const sid = options.sid;
-        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);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const detect = detectPerfAudit({
-                projectRoot,
-                sessionId: sid,
-            });
-            const envelope = detect.state === 'ready'
-                ? ok('perf-audit.detect', detect, [...detect.warnings], [...detect.nextActions])
-                : fail('perf-audit.detect', detect.state.toUpperCase().replace(/-/g, '_'), `perf-audit is not ready: ${detect.state}`, detect, [...detect.nextActions]);
-            printResult(io, envelope, options.json);
-            if (detect.state !== 'ready') {
-                process.exitCode = 1;
-            }
-        }
-        catch (error) {
-            printResult(io, fail('perf-audit.detect', 'DETECT_PERF_AUDIT_FAILED', getErrorMessage(error), {
-                state: 'detection-failed',
-                handoffPresent: false,
-                templatePresent: false,
-                warnings: [],
-                nextActions: [],
-            }, ['Re-run with --project <path> pointing at a known-good project root.']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(perfAudit
-        .command('run')
-        .description('Run the full perf-audit pipeline: detect → read handoff + template → write audit artifact to `.peaks/_runtime/<sid>/audit/perf-<rid>.md`. Reads the envelope JSON from --envelope <path> or stdin. The peaks-perf-audit skill emits the envelope; this CLI validates the shape via isPerfAuditEnvelope and writes the artifact. Exits 0 on success, 1 on any failure mode (detection, validation, or write).')
-        .option('--rid <rid>', 'request id (e.g. 2026-06-27-v2-12-...)')
-        .option('--sid <sid>', 'session id (e.g. 2026-06-27-session-...)')
-        .option('--project <path>', 'project root (default: cwd)')
-        .option('--envelope <path>', 'path to envelope JSON file; "-" reads from stdin (default: stdin)')).action((options) => {
-        const projectRoot = options.project ?? process.cwd();
-        const sid = options.sid;
-        const rid = options.rid;
-        if (sid === undefined || sid.length === 0) {
-            printResult(io, fail('perf-audit.run', 'SID_REQUIRED', 'session id (--sid) is required for perf-audit.run', {}, ['Pass --sid <session-id> (e.g. 2026-06-27-session-...)']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        if (rid === undefined || rid.length === 0) {
-            printResult(io, fail('perf-audit.run', 'RID_REQUIRED', 'request id (--rid) is required for perf-audit.run', {}, ['Pass --rid <request-id> (e.g. 2026-06-27-v2-12-...)']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const envelopeValue = resolveEnvelope(options.envelope);
-            if (!isPerfAuditEnvelope(envelopeValue)) {
-                printResult(io, fail('perf-audit.run', 'ENVELOPE_MALFORMED', 'envelope failed isPerfAuditEnvelope validation (expected { verdict, violations, summary })', { receivedType: typeof envelopeValue }, [
-                    'Verify the peaks-perf-audit skill prompt matches the strict-shape contract.',
-                    'Re-emit the envelope; see skills/bee/peaks-perf-audit/references/audit-protocol.md.'
-                ]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            const result = runPerfAudit({
-                projectRoot,
-                sessionId: sid,
-                rid,
-                generatedAt: new Date().toISOString(),
-                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);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('perf-audit.run', {
-                detect: result.detect,
-                artifactPath: result.artifactPath,
-                violationsCount: result.violationsCount,
-                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);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/prd-commands.js

@@ -1,141 +0,0 @@
-/**
- * peaks prd handoff CLI — v2.11.0 (Tier 3 in
- * `v2-11-rd-techdoc-removal-and-runtime-friction`).
- *
- * Wires `services/prd/handoff-service.ts` to the command surface:
- *
- *   peaks prd handoff init   — produce + write a sha256-locked handoff
- *   peaks prd handoff verify — re-read + recompute hash; report
- *   peaks prd handoff show   — print the raw handoff markdown
- *
- * Help text MUST NOT reference the legacy `peaks prd write-handoff`
- * subcommand (AC-1 in the v2.11.0 PRD). The legacy service module at
- * `services/handoff/` is a separate slice-025 layout (different
- * schema) and is intentionally not exposed here.
- */
-import { readFile } from 'node:fs/promises';
-import { initHandoff, readHandoff, showHandoff, verifyHandoff, writeHandoff } from '../../services/prd/handoff-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-/** Split a comma-separated string into a trimmed, non-empty list.
- *  Empty / undefined input → empty array. */
-function splitCsv(raw) {
-    if (!raw)
-        return [];
-    return raw
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-}
-/** Resolve the `--body` argument: if it starts with `@`, read the
- *  referenced file as UTF-8; otherwise treat as a literal string. */
-async function resolveBody(bodyArg) {
-    if (bodyArg.startsWith('@')) {
-        const filePath = bodyArg.slice(1);
-        return readFile(filePath, 'utf8');
-    }
-    return bodyArg;
-}
-export function registerPrdCommands(program, io) {
-    const prd = program.command('prd').description('peaks-prd role: artifact + handoff primitives');
-    const handoff = prd.command('handoff').description('Write / verify / show the immutable PRD handoff (sha256-locked, schemaVersion: 2)');
-    // peaks prd handoff init
-    addJsonOption(handoff
-        .command('init')
-        .description('Initialize an immutable handoff: sha256(body) → frontmatter → write to .peaks/_runtime/<sid>/prd/handoff.md')
-        .requiredOption('--rid <request-id>', 'request id (e.g. 001-v2-11-cc-group-b)')
-        .requiredOption('--sid <session-id>', 'session id (e.g. 2026-06-26-session-a28d69)')
-        .requiredOption('--body <body>', 'handoff body markdown, or @<file> to read from disk')
-        .option('--goals <ids>', 'comma-separated goal ids (e.g. G1,G2,G3)')
-        .option('--ac <ids>', 'comma-separated acceptance-criteria ids (e.g. AC-1,AC-2)')
-        .option('--preserve <ids>', 'comma-separated preserved-behavior ids (e.g. P1,P12)')
-        .option('--project <path>', 'target project root (defaults to cwd)')
-        .option('--apply', 'actually write the file (default is dry-run preview)')).action(async (options) => {
-        try {
-            const body = await resolveBody(options.body);
-            const projectRoot = options.project ?? process.cwd();
-            const writtenAt = new Date().toISOString();
-            const handoff = initHandoff({
-                requestId: options.rid,
-                sessionId: options.sid,
-                body,
-                writtenAt,
-                goals: splitCsv(options.goals),
-                acceptanceCriteria: splitCsv(options.ac),
-                preservedBehavior: splitCsv(options.preserve),
-            });
-            if (options.apply !== true) {
-                printResult(io, ok('prd.handoff.init', {
-                    dryRun: true,
-                    requestId: handoff.frontmatter.requestId,
-                    sessionId: handoff.frontmatter.sessionId,
-                    schemaVersion: handoff.frontmatter.schemaVersion,
-                    handoffHash: handoff.frontmatter.handoffHash,
-                    handoffPath: handoff.frontmatter.handoffPath,
-                    bodyBytes: Buffer.byteLength(body, 'utf8'),
-                    goals: handoff.frontmatter.goals,
-                    acceptanceCriteria: handoff.frontmatter.acceptanceCriteria,
-                    preservedBehavior: handoff.frontmatter.preservedBehavior
-                }), options.json);
-                return;
-            }
-            const written = await writeHandoff(handoff, projectRoot);
-            printResult(io, ok('prd.handoff.init', {
-                applied: true,
-                path: written.path,
-                hash: written.hash,
-                requestId: handoff.frontmatter.requestId,
-                sessionId: handoff.frontmatter.sessionId
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.init', 'HANDOFF_INIT_FAILED', getErrorMessage(error), { rid: options.rid, sid: options.sid }, ['Check --body syntax (@<file> or literal) and re-run']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // peaks prd handoff verify
-    addJsonOption(handoff
-        .command('verify')
-        .description('Re-read a handoff file and re-compute the sha256; report ok or reason')
-        .requiredOption('--path <file>', 'absolute path to the handoff file')).action(async (options) => {
-        try {
-            const probe = await verifyHandoff(options.path);
-            if (!probe.ok) {
-                printResult(io, fail('prd.handoff.verify', 'HANDOFF_VERIFY_FAILED', probe.reason ?? 'unknown', probe, ['Re-init the handoff with `peaks prd handoff init --apply` to restore integrity']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('prd.handoff.verify', { ok: true, hash: probe.actualHash, path: options.path }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.verify', 'HANDOFF_VERIFY_FAILED', getErrorMessage(error), { path: options.path }, ['Check the path and ensure the file is readable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // peaks prd handoff show
-    addJsonOption(handoff
-        .command('show')
-        .description('Print the raw handoff markdown (frontmatter + body) for human display')
-        .requiredOption('--path <file>', 'absolute path to the handoff file')).action(async (options) => {
-        try {
-            const content = await showHandoff(options.path);
-            const handoff = await readHandoff(options.path);
-            if (options.json === true) {
-                printResult(io, ok('prd.handoff.show', {
-                    path: options.path,
-                    frontmatter: handoff.frontmatter,
-                    bodyBytes: Buffer.byteLength(content, 'utf8'),
-                    body: content
-                }), true);
-                return;
-            }
-            io.stdout(content);
-            if (!content.endsWith('\n'))
-                io.stdout('\n');
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.show', 'HANDOFF_SHOW_FAILED', getErrorMessage(error), { path: options.path }, ['Check the path and ensure the file is readable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/project-commands.js

@@ -1,248 +0,0 @@
-import { loadProjectDashboard } from '../../services/dashboard/project-dashboard-service.js';
-import { generateProjectContext, readProjectContext } from '../../services/memory/project-context-service.js';
-import { extractSessionMemories, readMemoryIndex, readProjectMemories, readProjectMemoryBody } from '../../services/memory/project-memory-service.js';
-import { readBusinessKnowledge } from '../../services/prd/project-scan-reader.js';
-import { applyStalePolicy, DEFAULT_STALE_DAYS } from '../../shared/stale-policy.js';
-import { formatMdCompact } from '../../shared/format-md-compact.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-export function registerProjectCommands(program, io) {
-    const project = program.command('project').description('Aggregate Peaks state for a target project (read-only)');
-    addJsonOption(project
-        .command('dashboard')
-        .description('One-call snapshot of doctor / MCP / OpenSpec / requests / Understand Anything / capabilities for a project')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--strict', 'ok follows the doctor aggregate (legacy semantics). Default: workspace-only (ok tracks the runbook health)', false)).action(async (options) => {
-        try {
-            const dashboard = await loadProjectDashboard({
-                projectRoot: options.project,
-                okPolicy: options.strict === true ? 'strict' : 'workspace-only'
-            });
-            if (!dashboard.runbookHealth.ok) {
-                const suggestions = [
-                    dashboard.runbookHealth.missingRunbook.length > 0
-                        ? `Add a ## Default runbook section to: ${dashboard.runbookHealth.missingRunbook.join(', ')}`
-                        : null,
-                    dashboard.runbookHealth.applyNoteFailed.length > 0
-                        ? `Add authorization/--dry-run notes next to destructive --apply lines in: ${dashboard.runbookHealth.applyNoteFailed.join(', ')}`
-                        : null
-                ].filter((line) => line !== null);
-                printResult(io, fail('project.dashboard', 'PROJECT_DASHBOARD_RUNBOOK_UNHEALTHY', `Skill runbook health failing: ${dashboard.runbookHealth.healthy}/${dashboard.runbookHealth.required} healthy`, dashboard, suggestions), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            if (dashboard.skillPresence.active && !dashboard.skillPresence.fresh) {
-                printResult(io, fail('project.dashboard', 'PROJECT_DASHBOARD_STALE_SKILL_PRESENCE', `Active Peaks skill presence ${dashboard.skillPresence.skill ?? '<unknown>'} is stale (set ${dashboard.skillPresence.setAt ?? '<unknown>'})`, dashboard, ['Run `peaks skill presence:clear` if the role has ended, or `peaks skill presence:set <skill>` to refresh it']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            if (!dashboard.doctor.ok && options.strict === true) {
-                printResult(io, fail('project.dashboard', 'PROJECT_DASHBOARD_DOCTOR_STRICT_FAIL', `Doctor reports ${dashboard.doctor.failed} failed check(s) (${dashboard.doctor.passed} passed) — --strict mode requires the doctor aggregate to pass`, dashboard, ['Run `peaks doctor --json` and resolve the failing checks, or drop --strict to use the workspace-only policy']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('project.dashboard', dashboard), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.dashboard', 'PROJECT_DASHBOARD_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(project
-        .command('context')
-        .description('Generate or read persistent project context for cross-session Peaks understanding')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--read', 'read existing PROJECT.md without regenerating')).action((options) => {
-        try {
-            if (options.read) {
-                const content = readProjectContext(options.project);
-                if (content === null) {
-                    printResult(io, ok('project.context', { exists: false, path: `${options.project}/.peaks/PROJECT.md` }), options.json);
-                    return;
-                }
-                printResult(io, ok('project.context', { exists: true, path: `${options.project}/.peaks/PROJECT.md`, content }), options.json);
-                return;
-            }
-            const result = generateProjectContext(options.project);
-            printResult(io, ok('project.context', {
-                path: result.path,
-                sessionCount: result.sessionCount,
-                content: result.content
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.context', 'PROJECT_CONTEXT_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .peaks directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // --- Extract memories from a session's artifacts into .peaks/memory ---
-    addJsonOption(project
-        .command('memories:extract')
-        .description('Scan a session artifact directory and extract <!-- peaks-memory:start --> blocks into .peaks/memory/')
-        .requiredOption('--session-id <id>', 'session id (e.g. 2026-05-29-session-89ff35)')
-        .requiredOption('--project <path>', 'target project root')
-        // Slice #015: drop the `--dry-run true` default. With the default
-        // set to true, `options.dryRun === true && options.apply === true`
-        // fired on every `--apply` call (because dryRun was true by
-        // default), permanently breaking `--apply`. `--dry-run` is now
-        // opt-in; the mutual-exclusion check below is correct without a
-        // special-case.
-        .option('--dry-run', 'preview writes without changing files')
-        .option('--apply', 'write extracted memories into .peaks/memory/')).action((options) => {
-        if (options.dryRun === true && options.apply === true) {
-            printResult(io, fail('project.memories:extract', 'INVALID_MEMORY_EXTRACT_FLAGS', 'Use either --dry-run or --apply, not both', { sessionId: options.sessionId, projectRoot: options.project }, ['Run without --apply to preview writes, or pass --apply to write memories']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const result = extractSessionMemories({
-                projectRoot: options.project,
-                sessionId: options.sessionId,
-                apply: options.apply === true
-            });
-            printResult(io, ok('project.memories:extract', {
-                scannedFiles: result.scannedFiles,
-                extractedCount: result.extractedCount,
-                writtenFiles: result.writtenFiles,
-                memoryDir: result.primaryMemoryDir,
-                indexUpdated: result.updatedIndex
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.memories:extract', 'MEMORY_EXTRACT_FAILED', getErrorMessage(error), { sessionId: options.sessionId, projectRoot: options.project }, ['Check the session-id and project path']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // --- Read memory index (lightweight, always-safe to load) ---
-    addJsonOption(project
-        .command('memory-index')
-        .description('Read the memory index — lightweight hot/warm分层 view of all project memories')
-        .requiredOption('--project <path>', 'target project root')).action((options) => {
-        try {
-            const index = readMemoryIndex(options.project);
-            if (!index) {
-                printResult(io, ok('project.memory-index', { exists: false, message: 'No memory index found. Run `peaks project memories:extract` first.' }), options.json);
-                return;
-            }
-            printResult(io, ok('project.memory-index', { exists: true, index }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.memory-index', 'MEMORY_INDEX_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .peaks/memory directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // --- Structured project memory (durable, LLM-authored, stored under .peaks/memory) ---
-    addJsonOption(project
-        .command('memories')
-        .description('Read durable project memories (decisions, conventions, modules, rules) from .peaks/memory for LLM consumption')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--kind <kind>', 'filter by kind: project, rule, decision, reference, feedback, convention, module, lesson')).action((options) => {
-        try {
-            const result = readProjectMemories(options.project);
-            if (options.kind) {
-                const memories = result.memories.filter((memory) => memory.kind === options.kind);
-                printResult(io, ok('project.memories', {
-                    memoryDir: result.memoryDir,
-                    kind: options.kind,
-                    total: memories.length,
-                    memories
-                }), options.json);
-                return;
-            }
-            printResult(io, ok('project.memories', {
-                memoryDir: result.memoryDir,
-                total: result.total,
-                byKind: result.byKind,
-                memories: result.memories
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.memories', 'PROJECT_MEMORIES_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .peaks/memory directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // --- Show one project memory's body (R3: default = compact) ---
-    addJsonOption(project
-        .command('memories:show <name>')
-        .description('Show one project memory body by name. Default format is `compact` (LLM-primary); pass --pretty for the disk verbatim. Stale entries (default ≥30 days) are excluded; pass --include-stale or --stale-days <N> to override.')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--pretty', 'return the on-disk body verbatim; overrides the compact default')
-        .option('--include-stale', 'include stale entries (the default excludes them)')
-        .option('--stale-days <n>', 'override the 30-day stale threshold (must be > 0)', (value) => Number(value))).action((name, options) => {
-        try {
-            const memory = readProjectMemoryBody(options.project, name);
-            if (memory === null) {
-                printResult(io, fail('project.memories:show', 'MEMORY_NOT_FOUND', `memory ${name} not found in .peaks/memory`, { name, projectRoot: options.project }, ['Run `peaks project memories --json` to see available names']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            // Compute the stale decision. R4: stale is computed at CLI load time
-            // only; the source `.md` file is never modified.
-            const updatedAt = memory.updatedAt;
-            const thresholdDays = options.staleDays !== undefined && Number.isFinite(options.staleDays) && options.staleDays > 0
-                ? options.staleDays
-                : DEFAULT_STALE_DAYS;
-            const policy = applyStalePolicy([{ name: memory.name, updatedAt }], {
-                thresholdDays,
-                includeStale: options.includeStale === true
-            });
-            if (policy.entries.length === 0) {
-                const ageDays = policy.entries.length === 0 && policy.droppedCount > 0
-                    ? applyStalePolicy([{ name: memory.name, updatedAt }], { thresholdDays, includeStale: true }).entries[0]?.ageDays ?? 0
-                    : 0;
-                printResult(io, fail('project.memories:show', 'MEMORY_STALE', `memory ${name} is stale (age ${ageDays} days > ${thresholdDays} day threshold); pass --include-stale to override`, { name, ageDays, thresholdDays }, ['Pass --include-stale to load stale memories; pass --stale-days <N> to override the threshold']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            const ageDays = policy.entries[0]?.ageDays ?? 0;
-            const isStale = policy.entries[0]?.stale ?? false;
-            const format = options.pretty === true ? 'pretty' : 'compact';
-            const body = format === 'pretty' ? memory.body : formatMdCompact(memory.body);
-            printResult(io, ok('project.memories:show', {
-                name: memory.name,
-                title: memory.title,
-                kind: memory.kind,
-                sourcePath: memory.filePath,
-                updatedAt,
-                ageDays,
-                stale: isStale,
-                body,
-                format,
-                bodyBytes: Buffer.byteLength(body, 'utf8')
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.memories:show', 'PROJECT_MEMORY_SHOW_FAILED', getErrorMessage(error), { name, projectRoot: options.project }, ['Check the project path and .peaks/memory directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // --- Read business-knowledge sediment (v2.11.0 Group B — D3) ---
-    addJsonOption(project
-        .command('knowledge')
-        .description('Read .peaks/project-scan/business-knowledge.md (the schema-sedimented concept table). LLM-consumable; use --filter for a concept substring.')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--filter <glob>', 'substring filter on the concept name (case-insensitive)')).action(async (options) => {
-        try {
-            const knowledge = await readBusinessKnowledge(options.project);
-            if (knowledge === null) {
-                printResult(io, ok('project.knowledge', { exists: false, projectRoot: options.project, path: `${options.project}/.peaks/project-scan/business-knowledge.md` }), options.json);
-                return;
-            }
-            const concepts = options.filter
-                ? knowledge.concepts.filter((c) => c.concept.toLowerCase().includes(options.filter.toLowerCase()))
-                : knowledge.concepts;
-            printResult(io, ok('project.knowledge', {
-                exists: true,
-                schemaVersion: knowledge.schemaVersion,
-                total: knowledge.concepts.length,
-                matched: concepts.length,
-                filter: options.filter ?? null,
-                concepts
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('project.knowledge', 'PROJECT_KNOWLEDGE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .peaks/project-scan directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}