peaks-loop 4.0.53 → 4.1.0

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

@@ -40,23 +40,23 @@
  * pre-run gate and the brief-section guard; the CLI only
  * translates flags into the service payload.
  */
-import { existsSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { openStateDb } from "../../services/skillhub/sqlite-store.js";
-import { CrystallizationService, CrystallizationIntegrityError, BriefSectionError, safeRenderRecommendationPayload, CRYSTALLIZATION_TRIGGERS, parseEvidenceBrief, } from "../../services/crystallization/index.js";
-import { LoopReleaseSchema, } from "../../services/loop/loop-release-types.js";
-import { insertLoopRelease, } from "../../services/loop/loop-release-store.js";
-import { insertLoopBeeRelation, } from "../../services/loop/loop-bee-relation-store.js";
-import { LoopBeeRelationSchema, } from "../../services/loop/loop-bee-relation-types.js";
-import { findProjectRoot } from "../../services/config/config-safety.js";
-import { addJsonOption, getErrorMessage, printResult } from "../cli-helpers.js";
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { openStateDb } from '../../services/skillhub/sqlite-store.js';
+import { CrystallizationService, CrystallizationIntegrityError, BriefSectionError, safeRenderRecommendationPayload, CRYSTALLIZATION_TRIGGERS, parseEvidenceBrief } from '../../services/crystallization/index.js';
+import { LoopReleaseSchema } from '../../services/loop/loop-release-types.js';
+import { insertLoopRelease } from '../../services/loop/loop-release-store.js';
+import { insertLoopBeeRelation } from '../../services/loop/loop-bee-relation-store.js';
+import { LoopBeeRelationSchema } from '../../services/loop/loop-bee-relation-types.js';
+import { findProjectRoot } from '../../services/config/config-safety.js';
+import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 function collectRepeatable(value, previous) {
     if (Array.isArray(previous))
         return [...previous, value];
     return [value];
 }
-const DISPOSE_MODES = ["trace_only", "retain", "destroy"];
+const DISPOSE_MODES = ['trace_only', 'retain', 'destroy'];
 function parseTriggerFlag(raw) {
     return CRYSTALLIZATION_TRIGGERS.includes(raw)
         ? raw
@@ -66,44 +66,47 @@ export function registerAssetCommands(program, io) {
     // Reuse the existing `asset` parent if one is registered; the
     // add-a-new-subcommand-check-for-existing-top-level-first rule
     // requires this guard.
-    const existing = program.commands.find((c) => c.name() === "asset");
-    const asset = existing ?? program.command("asset").description("M5: cross-asset crystallization surface (crystallize / dispose / status — spec §5 / §7.4)");
+    const existing = program.commands.find((c) => c.name() === 'asset');
+    const asset = existing ??
+        program
+            .command('asset')
+            .description('M5: cross-asset crystallization surface (crystallize / dispose / status — spec §5 / §7.4)');
     // ---------- peaks asset crystallize ----------
     addJsonOption(asset
-        .command("crystallize")
-        .description("M5: persist a new loop_release + main_bee_release + loop_bee_relation + crystallization_event in a single transaction. Enforces the pre-run gate (task_status=completed AND gates_passed=true AND evidence_collected=true; AC-4 / RL-2) and the brief-section guard (all 4 sections required; AC-15 / RL-7).")
-        .requiredOption("--from-task <id>", "the candidate task id (must be 'completed' with gates_passed + evidence_collected)")
-        .requiredOption("--loop-id <id>", "kebab-case loop id, e.g. loop-onboarding-research")
-        .requiredOption("--loop-name <name>", "NL display name")
-        .requiredOption("--loop-scenario <text>", "long-form scenario text (what real problem the loop solves)")
-        .requiredOption("--loop-trigger-policy <text>", "trigger policy (NL intent match)")
-        .requiredOption("--loop-interaction-policy <text>", "interaction policy (Human-NL-Choice-Only is the default)")
-        .requiredOption("--loop-feedback-policy <text>", "feedback policy (what feedback enters long-term memory)")
-        .requiredOption("--loop-evolution-policy <text>", "evolution policy (Darwin-style ratchet rules)")
-        .requiredOption("--loop-success-criterion <text>", "declarative success criterion (repeatable)", collectRepeatable, [])
-        .requiredOption("--loop-evaluator-policy <text>", "evaluator policy line (repeatable)", collectRepeatable, [])
-        .requiredOption("--loop-version <semver>", "loop version (e.g. 0.1.0)")
-        .requiredOption("--bee-name <name>", "main bee name (kebab-case)")
-        .requiredOption("--bee-version <semver>", "bee version (e.g. 0.1.0)")
-        .requiredOption("--bee-description <text>", "main bee description (manifest-level)")
-        .requiredOption("--bee-relation-reason <text>", "NL reason for the main bee relation")
-        .requiredOption("--brief-what-happened <text>", "brief section: what_happened (1-2 sentence factual account)")
-        .requiredOption("--brief-why-it-matters <text>", "brief section: why_it_matters (1-2 sentence explanation)")
-        .requiredOption("--brief-what-learned <text>", "brief section: what_learned (1-2 sentence learning)")
-        .requiredOption("--brief-what-action <text>", "brief section: what_action (1 sentence recommended action)")
-        .option("--brief-bullet <bullet>", "structured bullet supporting the brief (repeatable)", collectRepeatable, [])
-        .option("--source-trace <id>", "workflow trace id backing the brief (repeatable)", collectRepeatable, [])
-        .option("--evaluator-summary <text>", "evaluator one-liner (independent scorers)", "")
-        .option("--user-decision-summary <text>", "user decision summary (NL)", "")
-        .option("--bee-intent-raw <text>", "optional bee user_intent_raw")
-        .option("--bee-parent-version <semver>", "optional parent_version")
-        .option("--bee-changelog <text>", "optional changelog")
-        .option("--trigger <name>", `crystallization trigger (one of: ${CRYSTALLIZATION_TRIGGERS.join("|")})`, "user_explicit")
-        .option("--project <path>", "project root (default: cwd)")).action((options) => {
+        .command('crystallize')
+        .description('M5: persist a new loop_release + main_bee_release + loop_bee_relation + crystallization_event in a single transaction. Enforces the pre-run gate (task_status=completed AND gates_passed=true AND evidence_collected=true; AC-4 / RL-2) and the brief-section guard (all 4 sections required; AC-15 / RL-7).')
+        .requiredOption('--from-task <id>', "the candidate task id (must be 'completed' with gates_passed + evidence_collected)")
+        .requiredOption('--loop-id <id>', 'kebab-case loop id, e.g. loop-onboarding-research')
+        .requiredOption('--loop-name <name>', 'NL display name')
+        .requiredOption('--loop-scenario <text>', 'long-form scenario text (what real problem the loop solves)')
+        .requiredOption('--loop-trigger-policy <text>', 'trigger policy (NL intent match)')
+        .requiredOption('--loop-interaction-policy <text>', 'interaction policy (Human-NL-Choice-Only is the default)')
+        .requiredOption('--loop-feedback-policy <text>', 'feedback policy (what feedback enters long-term memory)')
+        .requiredOption('--loop-evolution-policy <text>', 'evolution policy (Darwin-style ratchet rules)')
+        .requiredOption('--loop-success-criterion <text>', 'declarative success criterion (repeatable)', collectRepeatable, [])
+        .requiredOption('--loop-evaluator-policy <text>', 'evaluator policy line (repeatable)', collectRepeatable, [])
+        .requiredOption('--loop-version <semver>', 'loop version (e.g. 0.1.0)')
+        .requiredOption('--bee-name <name>', 'main bee name (kebab-case)')
+        .requiredOption('--bee-version <semver>', 'bee version (e.g. 0.1.0)')
+        .requiredOption('--bee-description <text>', 'main bee description (manifest-level)')
+        .requiredOption('--bee-relation-reason <text>', 'NL reason for the main bee relation')
+        .requiredOption('--brief-what-happened <text>', 'brief section: what_happened (1-2 sentence factual account)')
+        .requiredOption('--brief-why-it-matters <text>', 'brief section: why_it_matters (1-2 sentence explanation)')
+        .requiredOption('--brief-what-learned <text>', 'brief section: what_learned (1-2 sentence learning)')
+        .requiredOption('--brief-what-action <text>', 'brief section: what_action (1 sentence recommended action)')
+        .option('--brief-bullet <bullet>', 'structured bullet supporting the brief (repeatable)', collectRepeatable, [])
+        .option('--source-trace <id>', 'workflow trace id backing the brief (repeatable)', collectRepeatable, [])
+        .option('--evaluator-summary <text>', 'evaluator one-liner (independent scorers)', '')
+        .option('--user-decision-summary <text>', 'user decision summary (NL)', '')
+        .option('--bee-intent-raw <text>', 'optional bee user_intent_raw')
+        .option('--bee-parent-version <semver>', 'optional parent_version')
+        .option('--bee-changelog <text>', 'optional changelog')
+        .option('--trigger <name>', `crystallization trigger (one of: ${CRYSTALLIZATION_TRIGGERS.join('|')})`, 'user_explicit')
+        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
         try {
             const trigger = parseTriggerFlag(options.trigger);
             if (!trigger) {
-                printResult(io, fail("asset.crystallize", "ASSET_INVALID_TRIGGER", `--trigger must be one of: ${CRYSTALLIZATION_TRIGGERS.join("|")}`, { trigger: options.trigger }, ["Pass a valid --trigger value."]), options.json);
+                printResult(io, fail('asset.crystallize', 'ASSET_INVALID_TRIGGER', `--trigger must be one of: ${CRYSTALLIZATION_TRIGGERS.join('|')}`, { trigger: options.trigger }, ['Pass a valid --trigger value.']), options.json);
                 process.exitCode = 1;
                 return;
             }
@@ -114,7 +117,7 @@ export function registerAssetCommands(program, io) {
                 what_happened: options.briefWhatHappened,
                 why_it_matters: options.briefWhyItMatters,
                 what_learned: options.briefWhatLearned,
-                what_action: options.briefWhatAction,
+                what_action: options.briefWhatAction
             };
             let brief;
             try {
@@ -123,9 +126,9 @@ export function registerAssetCommands(program, io) {
             catch (err) {
                 if (err instanceof BriefSectionError) {
                     const briefErr = err;
-                    printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", briefErr.message, { findings: [...briefErr.findings], flagsProvided: Object.keys(candidateBrief) }, [
-                        "Pass ALL FOUR brief sections via --brief-what-happened / --brief-why-it-matters / --brief-what-learned / --brief-what-action.",
-                        "The CLI refuses to render a recommendation without a complete 4-section brief (spec §4.7 / RL-7).",
+                    printResult(io, fail('asset.crystallize', 'MISSING_BRIEF_SECTION', briefErr.message, { findings: [...briefErr.findings], flagsProvided: Object.keys(candidateBrief) }, [
+                        'Pass ALL FOUR brief sections via --brief-what-happened / --brief-why-it-matters / --brief-what-learned / --brief-what-action.',
+                        'The CLI refuses to render a recommendation without a complete 4-section brief (spec §4.7 / RL-7).'
                     ]), options.json);
                     process.exitCode = 1;
                     return;
@@ -140,36 +143,36 @@ export function registerAssetCommands(program, io) {
                 bullets: options.briefBullet ?? [],
                 source_trace_pointers: options.sourceTrace ?? [],
                 evaluator_summary: {
-                    one_liner: options.evaluatorSummary ?? "",
-                    risk_tags: [],
-                },
+                    one_liner: options.evaluatorSummary ?? '',
+                    risk_tags: []
+                }
             });
             if (!recommendation.ok) {
-                printResult(io, fail("asset.crystallize", recommendation.code ?? "MISSING_BRIEF_SECTION", "recommendation envelope rejected — brief is missing one of its 4 sections", { findings: recommendation.findings, briefProvided: candidateBrief }, [
-                    "Pass ALL FOUR brief sections via the matching CLI flags.",
-                    "Counts in --brief-bullet may support the brief; they do NOT replace it (spec §4.7 / RL-7).",
+                printResult(io, fail('asset.crystallize', recommendation.code ?? 'MISSING_BRIEF_SECTION', 'recommendation envelope rejected — brief is missing one of its 4 sections', { findings: recommendation.findings, briefProvided: candidateBrief }, [
+                    'Pass ALL FOUR brief sections via the matching CLI flags.',
+                    'Counts in --brief-bullet may support the brief; they do NOT replace it (spec §4.7 / RL-7).'
                 ]), options.json);
                 process.exitCode = 1;
                 return;
             }
             const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-            if (!existsSync(join(projectRoot, ".peaks"))) {
-                mkdirSync(join(projectRoot, ".peaks"), { recursive: true });
+            if (!existsSync(join(projectRoot, '.peaks'))) {
+                mkdirSync(join(projectRoot, '.peaks'), { recursive: true });
             }
-            const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
+            const db = openStateDb(join(projectRoot, '.peaks', 'state.db'));
             try {
                 const svc = new CrystallizationService(db, {
                     loopReleaseSchema: LoopReleaseSchema,
                     loopBeeRelationSchema: LoopBeeRelationSchema,
                     insertLoopRelease: insertLoopRelease,
-                    insertLoopBeeRelation: insertLoopBeeRelation,
+                    insertLoopBeeRelation: insertLoopBeeRelation
                 });
                 const result = svc.crystallize({
                     task: {
                         task_id: options.fromTask,
-                        task_status: "completed",
+                        task_status: 'completed',
                         gates_passed: true,
-                        evidence_collected: true,
+                        evidence_collected: true
                     },
                     loop_input: {
                         id: options.loopId,
@@ -184,39 +187,47 @@ export function registerAssetCommands(program, io) {
                         linked_bees: [],
                         run_history: [],
                         crystallization_evidence: [],
-                        lifecycle_status: "candidate",
-                        version: options.loopVersion,
+                        lifecycle_status: 'candidate',
+                        version: options.loopVersion
                     },
                     bee_input: {
                         bee_name: options.beeName,
                         version: options.beeVersion,
                         description: options.beeDescription,
-                        ...(options.beeIntentRaw !== undefined ? { user_intent_raw: options.beeIntentRaw } : {}),
-                        ...(options.beeParentVersion !== undefined ? { parent_version: options.beeParentVersion } : {}),
-                        ...(options.beeChangelog !== undefined ? { changelog: options.beeChangelog } : {}),
+                        ...(options.beeIntentRaw !== undefined
+                            ? { user_intent_raw: options.beeIntentRaw }
+                            : {}),
+                        ...(options.beeParentVersion !== undefined
+                            ? { parent_version: options.beeParentVersion }
+                            : {}),
+                        ...(options.beeChangelog !== undefined ? { changelog: options.beeChangelog } : {})
                     },
                     bee_relation_reason: options.beeRelationReason,
                     evidence_brief: brief,
                     evidence_bullets: options.briefBullet ?? [],
                     source_trace_pointers: options.sourceTrace ?? [],
-                    ...(options.evaluatorSummary !== undefined ? { evaluator_summary: options.evaluatorSummary } : {}),
-                    ...(options.userDecisionSummary !== undefined ? { user_decision_summary: options.userDecisionSummary } : {}),
-                    trigger,
+                    ...(options.evaluatorSummary !== undefined
+                        ? { evaluator_summary: options.evaluatorSummary }
+                        : {}),
+                    ...(options.userDecisionSummary !== undefined
+                        ? { user_decision_summary: options.userDecisionSummary }
+                        : {}),
+                    trigger
                 });
-                printResult(io, ok("asset.crystallize", {
+                printResult(io, ok('asset.crystallize', {
                     recommendation: {
                         brief: recommendation.payload.brief,
                         bullets: recommendation.payload.bullets,
                         source_trace_pointers: recommendation.payload.source_trace_pointers,
-                        evaluator_summary: recommendation.payload.evaluator_summary,
+                        evaluator_summary: recommendation.payload.evaluator_summary
                     },
                     result,
                     nextActions: [
                         `Run \`peaks loop show --loop ${result.loop_release_id}\` to inspect the new loop_release.`,
-                        `Run \`peaks asset dispose --crystallization-event ${result.crystallization_event_id} --mode trace_only\` to retire the event without touching the asset.`,
-                    ],
+                        `Run \`peaks asset dispose --crystallization-event ${result.crystallization_event_id} --mode trace_only\` to retire the event without touching the asset.`
+                    ]
                 }, [], [
-                    "The CLI has surfaced a complete 4-section brief; the LLM should now drive the user through AskUserQuestion picks (spec §5.3).",
+                    'The CLI has surfaced a complete 4-section brief; the LLM should now drive the user through AskUserQuestion picks (spec §5.3).'
                 ]), options.json);
             }
             finally {
@@ -226,19 +237,19 @@ export function registerAssetCommands(program, io) {
         catch (err) {
             if (err instanceof CrystallizationIntegrityError) {
                 const integrityErr = err;
-                printResult(io, fail("asset.crystallize", integrityErr.code, integrityErr.message, { findings: [...integrityErr.findings] }, [
-                    integrityErr.code === "CRYSTALLIZATION_PRE_RUN"
-                        ? "Re-shape the candidate task so task_status=completed AND gates_passed=true AND evidence_collected=true (spec §5 / RL-2)."
-                        : integrityErr.code === "MISSING_BRIEF_SECTION"
-                            ? "Pass ALL FOUR brief sections (RL-7); the CLI refuses to render a recommendation without them."
-                            : "Inspect the failure findings and re-shape the payload.",
+                printResult(io, fail('asset.crystallize', integrityErr.code, integrityErr.message, { findings: [...integrityErr.findings] }, [
+                    integrityErr.code === 'CRYSTALLIZATION_PRE_RUN'
+                        ? 'Re-shape the candidate task so task_status=completed AND gates_passed=true AND evidence_collected=true (spec §5 / RL-2).'
+                        : integrityErr.code === 'MISSING_BRIEF_SECTION'
+                            ? 'Pass ALL FOUR brief sections (RL-7); the CLI refuses to render a recommendation without them.'
+                            : 'Inspect the failure findings and re-shape the payload.'
                 ]), options.json);
                 process.exitCode = 1;
                 return;
             }
             if (err instanceof BriefSectionError) {
                 const briefErr = err;
-                printResult(io, fail("asset.crystallize", "MISSING_BRIEF_SECTION", briefErr.message, { findings: [...briefErr.findings] }, ["Pass all 4 brief sections (RL-7)."]), options.json);
+                printResult(io, fail('asset.crystallize', 'MISSING_BRIEF_SECTION', briefErr.message, { findings: [...briefErr.findings] }, ['Pass all 4 brief sections (RL-7).']), options.json);
                 process.exitCode = 1;
                 return;
             }
@@ -247,33 +258,33 @@ export function registerAssetCommands(program, io) {
     });
     // ---------- peaks asset dispose ----------
     addJsonOption(asset
-        .command("dispose")
-        .description("M5: dispose a crystallization event. mode=trace_only retires the event but keeps the trace; mode=retain keeps both; mode=destroy retires the event and marks the created/updated assets retired.")
-        .requiredOption("--crystallization-event <id>", "the crystallization event id (returned by `peaks asset crystallize`)")
-        .requiredOption(`--mode <mode>`, `dispose mode (one of: ${DISPOSE_MODES.join("|")}; default: trace_only)`, "trace_only")
-        .option("--project <path>", "project root (default: cwd)")).action((options) => {
+        .command('dispose')
+        .description('M5: dispose a crystallization event. mode=trace_only retires the event but keeps the trace; mode=retain keeps both; mode=destroy retires the event and marks the created/updated assets retired.')
+        .requiredOption('--crystallization-event <id>', 'the crystallization event id (returned by `peaks asset crystallize`)')
+        .requiredOption(`--mode <mode>`, `dispose mode (one of: ${DISPOSE_MODES.join('|')}; default: trace_only)`, 'trace_only')
+        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
         try {
             if (!DISPOSE_MODES.includes(options.mode)) {
-                printResult(io, fail("asset.dispose", "ASSET_INVALID_MODE", `--mode must be one of: ${DISPOSE_MODES.join("|")}`, { mode: options.mode }, ["Pass --mode trace_only / retain / destroy."]), options.json);
+                printResult(io, fail('asset.dispose', 'ASSET_INVALID_MODE', `--mode must be one of: ${DISPOSE_MODES.join('|')}`, { mode: options.mode }, ['Pass --mode trace_only / retain / destroy.']), options.json);
                 process.exitCode = 1;
                 return;
             }
             const mode = options.mode;
             const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-            if (!existsSync(join(projectRoot, ".peaks"))) {
-                mkdirSync(join(projectRoot, ".peaks"), { recursive: true });
+            if (!existsSync(join(projectRoot, '.peaks'))) {
+                mkdirSync(join(projectRoot, '.peaks'), { recursive: true });
             }
-            const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
+            const db = openStateDb(join(projectRoot, '.peaks', 'state.db'));
             try {
                 const svc = new CrystallizationService(db, {
                     loopReleaseSchema: LoopReleaseSchema,
                     loopBeeRelationSchema: LoopBeeRelationSchema,
                     insertLoopRelease: insertLoopRelease,
-                    insertLoopBeeRelation: insertLoopBeeRelation,
+                    insertLoopBeeRelation: insertLoopBeeRelation
                 });
                 const existing = svc.read(options.crystallizationEvent);
                 if (!existing) {
-                    printResult(io, fail("asset.dispose", "ASSET_EVENT_NOT_FOUND", `crystallization event '${options.crystallizationEvent}' not found`, { eventId: options.crystallizationEvent }, ["Verify the event id."]), options.json);
+                    printResult(io, fail('asset.dispose', 'ASSET_EVENT_NOT_FOUND', `crystallization event '${options.crystallizationEvent}' not found`, { eventId: options.crystallizationEvent }, ['Verify the event id.']), options.json);
                     process.exitCode = 1;
                     return;
                 }
@@ -283,39 +294,37 @@ export function registerAssetCommands(program, io) {
                 // as historical evidence.
                 // destroy → retire the event + retire the created/updated
                 // assets (no asset delete; retirement only).
-                if (mode === "retain") {
-                    printResult(io, ok("asset.dispose", {
+                if (mode === 'retain') {
+                    printResult(io, ok('asset.dispose', {
                         crystallization_event_id: existing.id,
                         mode,
                         lifecycle_status: existing.lifecycle_status,
-                        note: "no DB change; event retained as-is",
+                        note: 'no DB change; event retained as-is'
                     }, [], [
-                        "Run `peaks asset status --loop <id>` to inspect the lifecycle state of the linked assets.",
+                        'Run `peaks asset status --loop <id>` to inspect the lifecycle state of the linked assets.'
                     ]), options.json);
                     return;
                 }
-                const updated = svc.updateStatus(existing.id, "retired");
-                if (mode === "destroy" && updated) {
+                const updated = svc.updateStatus(existing.id, 'retired');
+                if (mode === 'destroy' && updated) {
                     // Retire the created/updated loop_release rows as well.
                     // We do NOT delete rows — retirement is a status flip
                     // (spec §5.6).
                     const retireLoop = db.prepare("UPDATE loop_release SET lifecycle_status = 'retired' WHERE id IN (?, ?)");
                     const ids = [
                         updated.created_loop_release_id ?? null,
-                        updated.updated_loop_release_id ?? null,
+                        updated.updated_loop_release_id ?? null
                     ].filter((x) => x !== null);
                     for (const id of ids) {
                         retireLoop.run(id, id);
                     }
                 }
-                printResult(io, ok("asset.dispose", {
+                printResult(io, ok('asset.dispose', {
                     crystallization_event_id: existing.id,
                     mode,
-                    lifecycle_status: updated?.lifecycle_status ?? "retired",
-                    retired_assets: mode === "destroy" ? "loop_release retired (no rows deleted)" : "none",
-                    nextActions: [
-                        "Run `peaks asset status` to confirm the lifecycle transition.",
-                    ],
+                    lifecycle_status: updated?.lifecycle_status ?? 'retired',
+                    retired_assets: mode === 'destroy' ? 'loop_release retired (no rows deleted)' : 'none',
+                    nextActions: ['Run `peaks asset status` to confirm the lifecycle transition.']
                 }, [], []), options.json);
             }
             finally {
@@ -323,42 +332,40 @@ export function registerAssetCommands(program, io) {
             }
         }
         catch (err) {
-            printResult(io, fail("asset.dispose", "ASSET_DISPOSE_FAILED", getErrorMessage(err), { eventId: options.crystallizationEvent }, [
-                "Verify the event id and --mode flag.",
-            ]), options.json);
+            printResult(io, fail('asset.dispose', 'ASSET_DISPOSE_FAILED', getErrorMessage(err), { eventId: options.crystallizationEvent }, ['Verify the event id and --mode flag.']), options.json);
             process.exitCode = 1;
         }
     });
     // ---------- peaks asset status ----------
     addJsonOption(asset
-        .command("status")
-        .description("M5: list loop + bee lifecycle state. With --loop, returns the loop + all linked bee_releases + all crystallization events referencing them.")
-        .option("--loop <id>", "filter by loop_release id")
-        .option("--bee <name>", "filter by bee_name")
-        .option("--project <path>", "project root (default: cwd)")).action((options) => {
+        .command('status')
+        .description('M5: list loop + bee lifecycle state. With --loop, returns the loop + all linked bee_releases + all crystallization events referencing them.')
+        .option('--loop <id>', 'filter by loop_release id')
+        .option('--bee <name>', 'filter by bee_name')
+        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
         try {
             const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-            if (!existsSync(join(projectRoot, ".peaks"))) {
-                mkdirSync(join(projectRoot, ".peaks"), { recursive: true });
+            if (!existsSync(join(projectRoot, '.peaks'))) {
+                mkdirSync(join(projectRoot, '.peaks'), { recursive: true });
             }
-            const db = openStateDb(join(projectRoot, ".peaks", "state.db"));
+            const db = openStateDb(join(projectRoot, '.peaks', 'state.db'));
             try {
                 const svc = new CrystallizationService(db, {
                     loopReleaseSchema: LoopReleaseSchema,
                     loopBeeRelationSchema: LoopBeeRelationSchema,
                     insertLoopRelease: insertLoopRelease,
-                    insertLoopBeeRelation: insertLoopBeeRelation,
+                    insertLoopBeeRelation: insertLoopBeeRelation
                 });
                 let events = [];
                 if (options.loop) {
                     events = [
                         ...svc.list({ created_loop_release_id: options.loop }),
-                        ...svc.list({ updated_loop_release_id: options.loop }),
+                        ...svc.list({ updated_loop_release_id: options.loop })
                     ];
                     // Deduplicate by id.
                     const seen = new Set();
                     events = events.filter((e) => {
-                        const key = e?.id ?? "";
+                        const key = e?.id ?? '';
                         if (!key || seen.has(key))
                             return false;
                         seen.add(key);
@@ -372,20 +379,18 @@ export function registerAssetCommands(program, io) {
                 // counts. We compute from the DB so the CLI is the single
                 // source of truth.
                 const loopCounts = db
-                    .prepare("SELECT lifecycle_status, COUNT(*) AS n FROM loop_release GROUP BY lifecycle_status")
-                    .all()
-                    .reduce((acc, r) => {
+                    .prepare('SELECT lifecycle_status, COUNT(*) AS n FROM loop_release GROUP BY lifecycle_status')
+                    .all().reduce((acc, r) => {
                     acc[r.lifecycle_status] = r.n;
                     return acc;
                 }, {});
                 const beeCounts = db
-                    .prepare("SELECT bee_name, COUNT(*) AS n FROM bee_release GROUP BY bee_name ORDER BY bee_name ASC")
-                    .all()
-                    .filter((r) => options.bee === undefined || r.bee_name === options.bee);
-                printResult(io, ok("asset.status", {
+                    .prepare('SELECT bee_name, COUNT(*) AS n FROM bee_release GROUP BY bee_name ORDER BY bee_name ASC')
+                    .all().filter((r) => options.bee === undefined || r.bee_name === options.bee);
+                printResult(io, ok('asset.status', {
                     filters: {
                         ...(options.loop !== undefined ? { loop: options.loop } : {}),
-                        ...(options.bee !== undefined ? { bee: options.bee } : {}),
+                        ...(options.bee !== undefined ? { bee: options.bee } : {})
                     },
                     crystallization_events: events.length,
                     events: events.map((e) => ({
@@ -396,15 +401,15 @@ export function registerAssetCommands(program, io) {
                         created_bee_release_id: e?.created_bee_release_id,
                         updated_loop_release_id: e?.updated_loop_release_id,
                         updated_bee_release_id: e?.updated_bee_release_id,
-                        created_at: e?.created_at,
+                        created_at: e?.created_at
                     })),
                     loop_release_counts_by_lifecycle: loopCounts,
                     bee_release_counts_by_name: beeCounts,
                     nextActions: [
                         options.loop
                             ? `Run \`peaks loop show --loop ${options.loop}\` for the loop detail view.`
-                            : "Pass --loop <id> to drill into a specific loop's crystallization history.",
-                    ],
+                            : "Pass --loop <id> to drill into a specific loop's crystallization history."
+                    ]
                 }, [], []), options.json);
             }
             finally {
@@ -412,9 +417,7 @@ export function registerAssetCommands(program, io) {
             }
         }
         catch (err) {
-            printResult(io, fail("asset.status", "ASSET_STATUS_FAILED", getErrorMessage(err), { loop: options.loop, bee: options.bee }, [
-                "Verify the loop / bee identifiers.",
-            ]), options.json);
+            printResult(io, fail('asset.status', 'ASSET_STATUS_FAILED', getErrorMessage(err), { loop: options.loop, bee: options.bee }, ['Verify the loop / bee identifiers.']), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -7,7 +7,7 @@
  * we verified that no `peaks audit` top-level exists; this is the only
  * file that owns the registration.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type AgentShieldState } from '../../services/audit/static-service.js';
 import { type ProgramIO } from '../cli-helpers.js';
 import type { AuditGoalOutput } from '../../services/audit/audit-goal-types.js';