peaks-loop 4.0.54 → 4.1.0

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

@@ -24,21 +24,21 @@
  * `{ ok, error?, data? }` envelope so program.ts can render the result
  * as JSON via peaks-cli's existing printResult primitive.
  */
-import { writeFileSync, mkdirSync, readFileSync, existsSync, readdirSync, rmSync } from "node:fs";
-import { join, basename } from "node:path";
-import { SYSTEM_PATH_FORBIDDEN, assertNotSystemPath, resolveSegmentsDir, resolveStateDbPath, resolveBlobsDir, resolveUserBeesDir, resolveUserBeeDir, } from "../../services/sediment/pool-paths.js";
-import { peaksHome } from "../../services/sop/sop-paths.js";
-import { writeBeeManifest } from "../../services/sediment/pool-write.js";
-import { readPool } from "../../services/sediment/pool-read.js";
-import { rebuildIndexFromFs } from "../../services/sediment/pool-rebuild-index.js";
-import { evaluateGate } from "../../services/sediment/promotion-gate.js";
-import { printCliEnvelope } from "../cli-helpers.js";
-import { openStateDb } from "../../services/skillhub/sqlite-store.js";
-import { retainRelease } from "../../services/skillhub/release-retain.js";
-import { releaseDiff } from "../../services/skillhub/release-diff.js";
-import { exportRelease } from "../../services/skillhub/release-export.js";
-import { importRelease } from "../../services/skillhub/release-import.js";
-import { gcBlobs } from "../../services/skillhub/release-gc-blobs.js";
+import { writeFileSync, mkdirSync, readFileSync, existsSync, readdirSync, rmSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { SYSTEM_PATH_FORBIDDEN, assertNotSystemPath, resolveSegmentsDir, resolveStateDbPath, resolveBlobsDir, resolveUserBeesDir, resolveUserBeeDir } from '../../services/sediment/pool-paths.js';
+import { peaksHome } from '../../services/sop/sop-paths.js';
+import { writeBeeManifest } from '../../services/sediment/pool-write.js';
+import { readPool } from '../../services/sediment/pool-read.js';
+import { rebuildIndexFromFs } from '../../services/sediment/pool-rebuild-index.js';
+import { evaluateGate } from '../../services/sediment/promotion-gate.js';
+import { printCliEnvelope } from '../cli-helpers.js';
+import { openStateDb } from '../../services/skillhub/sqlite-store.js';
+import { retainRelease } from '../../services/skillhub/release-retain.js';
+import { releaseDiff } from '../../services/skillhub/release-diff.js';
+import { exportRelease } from '../../services/skillhub/release-export.js';
+import { importRelease } from '../../services/skillhub/release-import.js';
+import { gcBlobs } from '../../services/skillhub/release-gc-blobs.js';
 /** Typed accessor over the flag map produced by `parseFlags`.
  *
  * `parseFlags` internally stores every flag with at least one value as a
@@ -118,10 +118,10 @@ export function parseFlags(argv) {
     const rawFlags = {};
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
-        if (a.startsWith("--")) {
+        if (a.startsWith('--')) {
             const k = a.slice(2);
             const v = argv[i + 1];
-            if (v === undefined || v.startsWith("--")) {
+            if (v === undefined || v.startsWith('--')) {
                 rawFlags[k] = true;
             }
             else {
@@ -131,7 +131,7 @@ export function parseFlags(argv) {
                 while (i < argv.length &&
                     argv[i] === `--${k}` &&
                     i + 1 < argv.length &&
-                    !argv[i + 1].startsWith("--")) {
+                    !argv[i + 1].startsWith('--')) {
                     values.push(argv[i + 1]);
                     i += 2;
                 }
@@ -159,50 +159,50 @@ export async function runSediment(argv, { home }) {
     const verb = positional[0];
     try {
         switch (verb) {
-            case "add-segment": {
+            case 'add-segment': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: name" };
-                const description = flags.maybeString("describe") ?? "";
+                    return { ok: false, error: 'MISSING_ARG: name' };
+                const description = flags.maybeString('describe') ?? '';
                 const segDir = join(resolveSegmentsDir({ home }), name);
                 // Soft-protection guard: refuse to write under any `.system` path
                 // segment. Mirrors the same guard in writeBeeManifest.
                 assertNotSystemPath(segDir);
                 mkdirSync(segDir, { recursive: true });
-                writeFileSync(join(segDir, "SKILL.md"), `---\nname: ${name}\ndescription: ${description}\n---\n`);
+                writeFileSync(join(segDir, 'SKILL.md'), `---\nname: ${name}\ndescription: ${description}\n---\n`);
                 rebuildIndexFromFs({ home });
                 return { ok: true };
             }
-            case "add-bee": {
+            case 'add-bee': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: name" };
+                    return { ok: false, error: 'MISSING_ARG: name' };
                 // Collect --segment values; the brief uses repeatable --segment
                 // flags (one token per segment). parseFlags now returns a
                 // 1-element array for a single occurrence and a longer array
                 // for repeated keys, so .list() returns a uniform string[].
-                const segList = flags.list("segment");
-                const description = flags.maybeString("description") ?? "";
+                const segList = flags.list('segment');
+                const description = flags.maybeString('description') ?? '';
                 const m = {
-                    schemaVersion: "peaks.bee/1",
+                    schemaVersion: 'peaks.bee/1',
                     name,
-                    source: "user",
-                    promotion_status: "candidate",
+                    source: 'user',
+                    promotion_status: 'candidate',
                     description,
                     segments: segList.map((s) => ({
                         name: s,
                         inputs: [],
                         outputs: [],
-                        sideEffects: [],
+                        sideEffects: []
                     })),
                     entrypoint: { preamble: `## ${name}`, refs: [] },
                     promotion: {
                         minCycles: 1,
                         requiresHumanApproval: true,
-                        requiresSmokeTest: true,
+                        requiresSmokeTest: true
                     },
-                    createdBy: "llm",
-                    lastTouchedAt: new Date().toISOString(),
+                    createdBy: 'llm',
+                    lastTouchedAt: new Date().toISOString()
                 };
                 // writeBeeManifest runs zod validation + SYSTEM_PATH_FORBIDDEN
                 // guard internally.
@@ -210,103 +210,106 @@ export async function runSediment(argv, { home }) {
                 rebuildIndexFromFs({ home });
                 return { ok: true };
             }
-            case "list": {
+            case 'list': {
                 const idx = readPool({ home });
                 return { ok: true, data: idx.entries };
             }
-            case "rebuild-index": {
+            case 'rebuild-index': {
                 const idx = rebuildIndexFromFs({ home });
                 return { ok: true, data: idx };
             }
             // --- Task 15b verbs ---
-            case "refine-bee": {
+            case 'refine-bee': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: refine-bee requires <name>" };
-                const patch = flags.maybeString("patch") ?? "";
+                    return { ok: false, error: 'MISSING_ARG: refine-bee requires <name>' };
+                const patch = flags.maybeString('patch') ?? '';
                 if (!patch)
-                    return { ok: false, error: "MISSING_ARG: refine-bee requires --patch" };
-                const manifestPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                    return { ok: false, error: 'MISSING_ARG: refine-bee requires --patch' };
+                const manifestPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(manifestPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
-                const m = JSON.parse(readFileSync(manifestPath, "utf-8"));
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
+                const m = JSON.parse(readFileSync(manifestPath, 'utf-8'));
                 // Append patch note to description, preserving prior content. Cap at
                 // 1000 chars to avoid unbounded growth.
                 const ts = new Date().toISOString();
                 const note = `[refine ${ts}] ${patch}`;
-                m.description = (m.description + (m.description ? "\n" : "") + note).slice(0, 1000);
+                m.description = (m.description + (m.description ? '\n' : '') + note).slice(0, 1000);
                 m.lastTouchedAt = ts;
                 // promotion_status is preserved (do not touch it here).
                 writeBeeManifest({ home }, m);
                 rebuildIndexFromFs({ home });
                 return { ok: true };
             }
-            case "clone-bee": {
+            case 'clone-bee': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: clone-bee requires <name>" };
-                const asName = flags.maybeString("as") ?? "";
+                    return { ok: false, error: 'MISSING_ARG: clone-bee requires <name>' };
+                const asName = flags.maybeString('as') ?? '';
                 if (!asName)
-                    return { ok: false, error: "MISSING_ARG: clone-bee requires --as <new-name>" };
-                const srcPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                    return { ok: false, error: 'MISSING_ARG: clone-bee requires --as <new-name>' };
+                const srcPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(srcPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
-                const src = JSON.parse(readFileSync(srcPath, "utf-8"));
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
+                const src = JSON.parse(readFileSync(srcPath, 'utf-8'));
                 // Fresh id, reset promotion_status to candidate, rename. The source
                 // manifest is unchanged on disk.
                 const clone = {
                     ...src,
                     name: asName,
-                    promotion_status: "candidate",
-                    lastTouchedAt: new Date().toISOString(),
+                    promotion_status: 'candidate',
+                    lastTouchedAt: new Date().toISOString()
                 };
                 writeBeeManifest({ home }, clone);
                 rebuildIndexFromFs({ home });
                 return { ok: true };
             }
-            case "promote": {
+            case 'promote': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: promote requires <name>" };
-                const manifestPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                    return { ok: false, error: 'MISSING_ARG: promote requires <name>' };
+                const manifestPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(manifestPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
-                const m = JSON.parse(readFileSync(manifestPath, "utf-8"));
-                if (m.source === "system")
-                    return { ok: false, error: "PROMOTION_SYSTEM_REFUSED" };
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
+                const m = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+                if (m.source === 'system')
+                    return { ok: false, error: 'PROMOTION_SYSTEM_REFUSED' };
                 // Evaluate the PromotionGate (Task 5). The CLI is a thin shim; the
                 // humanApproved / smokeTestPresent inputs default to "true" here
                 // because the LLM-driven peaks-maker workflow has already obtained
                 // those approvals before calling promote.
-                const gate = evaluateGate({ home }, m, { humanApproved: true, smokeTestPresent: m.promotion.requiresSmokeTest });
+                const gate = evaluateGate({ home }, m, {
+                    humanApproved: true,
+                    smokeTestPresent: m.promotion.requiresSmokeTest
+                });
                 if (!gate.ok) {
                     return {
                         ok: false,
-                        error: `PROMOTION_GATE_FAILED: ${gate.failedSubconditions.join(",")}`,
+                        error: `PROMOTION_GATE_FAILED: ${gate.failedSubconditions.join(',')}`
                     };
                 }
-                m.promotion_status = "stable";
+                m.promotion_status = 'stable';
                 m.lastTouchedAt = new Date().toISOString();
                 writeBeeManifest({ home }, m);
                 rebuildIndexFromFs({ home });
                 return { ok: true };
             }
-            case "retire": {
+            case 'retire': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: retire requires <name>" };
-                const reason = flags.maybeString("reason") ?? "";
-                const manifestPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                    return { ok: false, error: 'MISSING_ARG: retire requires <name>' };
+                const reason = flags.maybeString('reason') ?? '';
+                const manifestPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(manifestPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
-                const m = JSON.parse(readFileSync(manifestPath, "utf-8"));
-                if (m.source === "system")
-                    return { ok: false, error: "RETIRE_SYSTEM_REFUSED" };
-                m.promotion_status = "retired";
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
+                const m = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+                if (m.source === 'system')
+                    return { ok: false, error: 'RETIRE_SYSTEM_REFUSED' };
+                m.promotion_status = 'retired';
                 if (reason) {
                     const ts = new Date().toISOString();
                     const note = `[retire ${ts}] ${reason}`;
-                    m.description = (m.description + (m.description ? "\n" : "") + note).slice(0, 1000);
+                    m.description = (m.description + (m.description ? '\n' : '') + note).slice(0, 1000);
                 }
                 m.lastTouchedAt = new Date().toISOString();
                 writeBeeManifest({ home }, m);
@@ -314,39 +317,39 @@ export async function runSediment(argv, { home }) {
                 return { ok: true };
             }
             // --- Task 15c verbs ---
-            case "dispose": {
+            case 'dispose': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: dispose requires <name>" };
-                const decision = flags.maybeString("decision") ?? "";
-                if (decision !== "destroy" && decision !== "retain") {
-                    return { ok: false, error: "MISSING_ARG: dispose requires --decision destroy|retain" };
+                    return { ok: false, error: 'MISSING_ARG: dispose requires <name>' };
+                const decision = flags.maybeString('decision') ?? '';
+                if (decision !== 'destroy' && decision !== 'retain') {
+                    return { ok: false, error: 'MISSING_ARG: dispose requires --decision destroy|retain' };
                 }
-                const manifestPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                const manifestPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(manifestPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
-                const m = JSON.parse(readFileSync(manifestPath, "utf-8"));
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
+                const m = JSON.parse(readFileSync(manifestPath, 'utf-8'));
                 // System bees: silently destroy; refuse retain (Task 9 contract).
-                if (m.source === "system") {
-                    if (decision === "retain")
-                        return { ok: false, error: "RETAIN_SYSTEM_REFUSED" };
+                if (m.source === 'system') {
+                    if (decision === 'retain')
+                        return { ok: false, error: 'RETAIN_SYSTEM_REFUSED' };
                     return { ok: true, data: { systemDestroyed: true } };
                 }
                 // User bee destroy: remove the manifest dir from the pool. The
                 // scratch materialization is cleaned up by the dispatch flow
                 // (its concern), but the pool's bees/<name>/manifest.json entry
                 // is removed here so the index reflects reality on next read.
-                if (decision === "destroy") {
+                if (decision === 'destroy') {
                     const beeDir = resolveUserBeeDir({ home }, name);
                     rmSync(beeDir, { recursive: true, force: true });
                     rebuildIndexFromFs({ home });
                     return { ok: true, data: { userDestroyed: true, path: beeDir } };
                 }
                 // User bee retain: open state.db, call retainRelease.
-                const version = flags.maybeString("version") ?? "0.1.0";
-                const scratchDir = flags.maybeString("scratch") ?? join(home, "scratch");
+                const version = flags.maybeString('version') ?? '0.1.0';
+                const scratchDir = flags.maybeString('scratch') ?? join(home, 'scratch');
                 if (!existsSync(scratchDir))
-                    return { ok: false, error: "SCRATCH_NOT_FOUND" };
+                    return { ok: false, error: 'SCRATCH_NOT_FOUND' };
                 const stateDbPath = resolveStateDbPath({ home });
                 const blobsDir = resolveBlobsDir({ home });
                 mkdirSync(blobsDir, { recursive: true });
@@ -359,15 +362,15 @@ export async function runSediment(argv, { home }) {
                 }
                 return { ok: true, data: { retained: true, version } };
             }
-            case "releases": {
+            case 'releases': {
                 const beeName = positional[1];
                 if (!beeName)
-                    return { ok: false, error: "MISSING_ARG: releases requires <bee-name>" };
+                    return { ok: false, error: 'MISSING_ARG: releases requires <bee-name>' };
                 const stateDbPath = resolveStateDbPath({ home });
                 const db = openStateDb(stateDbPath);
                 try {
                     const rows = db
-                        .prepare("SELECT id, bee_name, version, source, archived_at, archived_by FROM bee_release WHERE bee_name = ? ORDER BY archived_at DESC")
+                        .prepare('SELECT id, bee_name, version, source, archived_at, archived_by FROM bee_release WHERE bee_name = ? ORDER BY archived_at DESC')
                         .all(beeName);
                     return { ok: true, data: rows };
                 }
@@ -375,11 +378,14 @@ export async function runSediment(argv, { home }) {
                     db.close();
                 }
             }
-            case "release-show": {
+            case 'release-show': {
                 const beeName = positional[1];
-                const version = flags.maybeString("version") ?? "";
+                const version = flags.maybeString('version') ?? '';
                 if (!beeName || !version) {
-                    return { ok: false, error: "MISSING_ARG: release-show requires <bee-name> and --version" };
+                    return {
+                        ok: false,
+                        error: 'MISSING_ARG: release-show requires <bee-name> and --version'
+                    };
                 }
                 const stateDbPath = resolveStateDbPath({ home });
                 const db = openStateDb(stateDbPath);
@@ -389,19 +395,17 @@ export async function runSediment(argv, { home }) {
                     // renderers) get a structural shape rather than
                     // Record<string, unknown>. Minor #12 fix.
                     const row = db
-                        .prepare("SELECT * FROM bee_release WHERE bee_name = ? AND version = ?")
+                        .prepare('SELECT * FROM bee_release WHERE bee_name = ? AND version = ?')
                         .get(beeName, version);
                     if (!row)
-                        return { ok: false, error: "VERSION_NOT_FOUND" };
+                        return { ok: false, error: 'VERSION_NOT_FOUND' };
                     const id = row.id;
-                    const manifest = db
-                        .prepare("SELECT * FROM bee_manifest WHERE release_id = ?")
-                        .get(id);
+                    const manifest = db.prepare('SELECT * FROM bee_manifest WHERE release_id = ?').get(id);
                     const segments = db
-                        .prepare("SELECT * FROM bee_segment_ref WHERE release_id = ?")
+                        .prepare('SELECT * FROM bee_segment_ref WHERE release_id = ?')
                         .all(id);
                     const files = db
-                        .prepare("SELECT * FROM bee_file WHERE release_id = ?")
+                        .prepare('SELECT * FROM bee_file WHERE release_id = ?')
                         .all(id);
                     return { ok: true, data: { release: row, manifest, segments, files } };
                 }
@@ -409,12 +413,15 @@ export async function runSediment(argv, { home }) {
                     db.close();
                 }
             }
-            case "release-diff": {
+            case 'release-diff': {
                 const beeName = positional[1];
-                const fromVersion = flags.maybeString("from") ?? "";
-                const toVersion = flags.maybeString("to") ?? "";
+                const fromVersion = flags.maybeString('from') ?? '';
+                const toVersion = flags.maybeString('to') ?? '';
                 if (!beeName || !fromVersion || !toVersion) {
-                    return { ok: false, error: "MISSING_ARG: release-diff requires <bee-name> and --from and --to" };
+                    return {
+                        ok: false,
+                        error: 'MISSING_ARG: release-diff requires <bee-name> and --from and --to'
+                    };
                 }
                 const stateDbPath = resolveStateDbPath({ home });
                 const db = openStateDb(stateDbPath);
@@ -431,12 +438,12 @@ export async function runSediment(argv, { home }) {
                 }
             }
             // --- Task 15d verbs ---
-            case "export": {
+            case 'export': {
                 const beeName = positional[1];
-                const version = flags.maybeString("version") ?? "";
-                const outPath = flags.maybeString("out") ?? "";
+                const version = flags.maybeString('version') ?? '';
+                const outPath = flags.maybeString('out') ?? '';
                 if (!beeName || !version || !outPath) {
-                    return { ok: false, error: "MISSING_ARG: export requires <bee-name>, --version, --out" };
+                    return { ok: false, error: 'MISSING_ARG: export requires <bee-name>, --version, --out' };
                 }
                 const stateDbPath = resolveStateDbPath({ home });
                 const blobsDir = resolveBlobsDir({ home });
@@ -458,14 +465,14 @@ export async function runSediment(argv, { home }) {
                 process.stderr.write("warning: 'peaks skill sediment export' is deprecated; use 'peaks loop export' or 'peaks bee export' (peaks.bundle/1, spec §7A.2)\n");
                 return { ok: true, data: { outPath } };
             }
-            case "import": {
+            case 'import': {
                 const bundlePath = positional[1];
-                const asNameRaw = flags.maybeString("as");
+                const asNameRaw = flags.maybeString('as');
                 const asName = asNameRaw && asNameRaw.length > 0 ? asNameRaw : undefined;
                 if (!bundlePath)
-                    return { ok: false, error: "MISSING_ARG: import requires <bundle-path>" };
+                    return { ok: false, error: 'MISSING_ARG: import requires <bundle-path>' };
                 if (!existsSync(bundlePath))
-                    return { ok: false, error: "BUNDLE_NOT_FOUND" };
+                    return { ok: false, error: 'BUNDLE_NOT_FOUND' };
                 const stateDbPath = resolveStateDbPath({ home });
                 const blobsDir = resolveBlobsDir({ home });
                 mkdirSync(blobsDir, { recursive: true });
@@ -491,8 +498,8 @@ export async function runSediment(argv, { home }) {
                 process.stderr.write("warning: 'peaks skill sediment import' is deprecated; use 'peaks loop import' or 'peaks bee import' (peaks.bundle/1, spec §7A.2)\n");
                 return { ok: true, data: { asName: asName ?? basename(bundlePath) } };
             }
-            case "gc-blobs": {
-                const dryRun = flags.bool("dry-run");
+            case 'gc-blobs': {
+                const dryRun = flags.bool('dry-run');
                 const stateDbPath = resolveStateDbPath({ home });
                 const blobsDir = resolveBlobsDir({ home });
                 const db = openStateDb(stateDbPath);
@@ -508,46 +515,46 @@ export async function runSediment(argv, { home }) {
                     db.close();
                 }
             }
-            case "search": {
-                const query = positional[1] ?? flags.maybeString("q") ?? "";
+            case 'search': {
+                const query = positional[1] ?? flags.maybeString('q') ?? '';
                 if (!query)
-                    return { ok: false, error: "MISSING_ARG: search requires <query>" };
+                    return { ok: false, error: 'MISSING_ARG: search requires <query>' };
                 const beesDir = resolveUserBeesDir({ home });
                 const matches = [];
                 const warnings = [];
                 if (existsSync(beesDir)) {
                     const q = query.toLowerCase();
                     for (const name of readdirSync(beesDir)) {
-                        const manifestPath = join(beesDir, name, "manifest.json");
+                        const manifestPath = join(beesDir, name, 'manifest.json');
                         if (!existsSync(manifestPath))
                             continue;
                         let m;
                         try {
-                            m = JSON.parse(readFileSync(manifestPath, "utf-8"));
+                            m = JSON.parse(readFileSync(manifestPath, 'utf-8'));
                         }
                         catch (e) {
                             const msg = e instanceof Error ? e.message : String(e);
                             warnings.push(`skipped ${name}: ${msg}`);
                             continue;
                         }
-                        const haystack = `${m.name ?? ""} ${m.description ?? ""}`.toLowerCase();
+                        const haystack = `${m.name ?? ''} ${m.description ?? ''}`.toLowerCase();
                         if (haystack.includes(q)) {
                             matches.push({
                                 name: m.name,
                                 description: m.description,
                                 source: m.source,
-                                promotion_status: m.promotion_status,
+                                promotion_status: m.promotion_status
                             });
                         }
                     }
                 }
                 return { ok: true, data: { matches, warnings } };
             }
-            case "recent": {
-                const sinceRaw = flags.maybeString("since") ?? "7d";
+            case 'recent': {
+                const sinceRaw = flags.maybeString('since') ?? '7d';
                 const m = sinceRaw.match(/^(\d+)d$/);
                 if (!m)
-                    return { ok: false, error: "MISSING_ARG: recent requires --since Nd (e.g. 7d)" };
+                    return { ok: false, error: 'MISSING_ARG: recent requires --since Nd (e.g. 7d)' };
                 const sinceDays = parseInt(m[1], 10);
                 const cutoff = new Date(Date.now() - sinceDays * 24 * 60 * 60 * 1000).toISOString();
                 const beesDir = resolveUserBeesDir({ home });
@@ -555,38 +562,38 @@ export async function runSediment(argv, { home }) {
                 const warnings = [];
                 if (existsSync(beesDir)) {
                     for (const name of readdirSync(beesDir)) {
-                        const manifestPath = join(beesDir, name, "manifest.json");
+                        const manifestPath = join(beesDir, name, 'manifest.json');
                         if (!existsSync(manifestPath))
                             continue;
                         let b;
                         try {
-                            b = JSON.parse(readFileSync(manifestPath, "utf-8"));
+                            b = JSON.parse(readFileSync(manifestPath, 'utf-8'));
                         }
                         catch (e) {
                             const msg = e instanceof Error ? e.message : String(e);
                             warnings.push(`skipped ${name}: ${msg}`);
                             continue;
                         }
-                        if (typeof b.lastTouchedAt === "string" && b.lastTouchedAt >= cutoff) {
+                        if (typeof b.lastTouchedAt === 'string' && b.lastTouchedAt >= cutoff) {
                             matches.push({
                                 name: b.name,
                                 lastTouchedAt: b.lastTouchedAt,
-                                promotion_status: b.promotion_status,
+                                promotion_status: b.promotion_status
                             });
                         }
                     }
                 }
                 return { ok: true, data: { matches, warnings } };
             }
-            case "show": {
+            case 'show': {
                 const name = positional[1];
                 if (!name)
-                    return { ok: false, error: "MISSING_ARG: show requires <name>" };
-                const manifestPath = join(resolveUserBeesDir({ home }), name, "manifest.json");
+                    return { ok: false, error: 'MISSING_ARG: show requires <name>' };
+                const manifestPath = join(resolveUserBeesDir({ home }), name, 'manifest.json');
                 if (!existsSync(manifestPath))
-                    return { ok: false, error: "BEE_NOT_FOUND" };
+                    return { ok: false, error: 'BEE_NOT_FOUND' };
                 try {
-                    return { ok: true, data: JSON.parse(readFileSync(manifestPath, "utf-8")) };
+                    return { ok: true, data: JSON.parse(readFileSync(manifestPath, 'utf-8')) };
                 }
                 catch (e) {
                     const msg = e instanceof Error ? e.message : String(e);
@@ -594,14 +601,14 @@ export async function runSediment(argv, { home }) {
                 }
             }
             default:
-                return { ok: false, error: `UNKNOWN_VERB: ${verb ?? ""}` };
+                return { ok: false, error: `UNKNOWN_VERB: ${verb ?? ''}` };
         }
     }
     catch (e) {
         if (e instanceof SYSTEM_PATH_FORBIDDEN) {
             return { ok: false, error: e.message };
         }
-        const msg = e instanceof Error ? e.message : typeof e === "string" ? e : String(e);
+        const msg = e instanceof Error ? e.message : typeof e === 'string' ? e : String(e);
         return { ok: false, error: msg };
     }
 }
@@ -618,10 +625,10 @@ export async function runSediment(argv, { home }) {
  *  exists, so the lazy lookup is safe.
  */
 function getOrCreateSkillCmd(program) {
-    const existing = program.commands.find((c) => c.name() === "skill");
+    const existing = program.commands.find((c) => c.name() === 'skill');
     if (existing !== undefined)
         return existing;
-    return program.command("skill").description("Manage Peaks skills");
+    return program.command('skill').description('Manage Peaks skills');
 }
 /** Register the `peaks skill sediment <verb>` subcommand group.
  *
@@ -634,8 +641,8 @@ function getOrCreateSkillCmd(program) {
 export function registerSedimentCommands(program, io) {
     const skill = getOrCreateSkillCmd(program);
     skill
-        .command("sediment <args...>")
-        .description("Sediment pool operations (LLM-coordinated; see peaks-maker skill)")
+        .command('sediment <args...>')
+        .description('Sediment pool operations (LLM-coordinated; see peaks-maker skill)')
         .action(async (args) => {
         // D-018: peaks-loop's `state.db` (loop engineering + bee sediment pool)
         // lives at PEAKS_HOME-based path, NOT under the project root. The

package/dist/cli/commands/session-24h-mode.js

@@ -20,7 +20,7 @@
 import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
 import { getErrorMessage } from '../cli-helpers.js';
 import { HANDOFF_EXIT_CONDITIONS, STATES, emptySnapshot, isHandoffExitCondition, isState, read24hState, write24hState } from '../../services/24h-mode/index.js';
-import { applyAutoEngagePresenceMode } from '../../services/24h-mode/auto-engage.js';
+import { applyAutoEngagePresenceMode, presenceModeAdvisory } from '../../services/24h-mode/auto-engage.js';
 function splitList(value) {
     if (!value)
         return [];
@@ -143,7 +143,20 @@ export function registerSession24hModeCommand(session, io) {
             const presenceMode = target === '24H_ACTIVE'
                 ? applyAutoEngagePresenceMode({ projectRoot, sessionId: sid })
                 : null;
-            printJson(io, { ok: true, data: { ...next, path: result.path, presenceMode } }, merged);
+            // Slice H3 (rid=h3-24h-threshold-not-wired): a failed stamp used
+            // to live only in `data.presenceMode`, where nothing read it.
+            // Surface it at the envelope level so the caller cannot report a
+            // 24h threshold shift that the mode layer never recorded.
+            const advisory = presenceMode === null
+                ? { warnings: [], nextActions: [] }
+                : presenceModeAdvisory(presenceMode);
+            printJson(io, {
+                ok: true,
+                command: 'session.24h-mode.transition',
+                data: { ...next, path: result.path, presenceMode },
+                warnings: [...advisory.warnings],
+                nextActions: [...advisory.nextActions]
+            }, merged);
         }
         catch (error) {
             printError(io, '24H_STATE_WRITE_FAILED', getErrorMessage(error), merged);