@bli-cockpit/cli 0.2.86 → 0.2.88

package/dist/commands/local-args-collector-status.js

@@ -170,9 +170,25 @@ export function parseAgentRulesArgs(args) {
  */
 export function parseMemoryArgs(args) {
     const values = parseNamedArgs(args, {
-        allowedFlags: ["--home", "--dashboard-url", "--dry-run", "--json"],
-        valueFlags: ["--home", "--dashboard-url"],
+        allowedFlags: ["--home", "--dashboard-url", "--dry-run", "--json", "--store", "--reason-stdin"],
+        valueFlags: ["--home", "--dashboard-url", "--store"],
     });
+    if (values.positionals[0] === "log") {
+        const [, verdict, reason = ""] = values.positionals;
+        const store = values.flags.get("--store");
+        const reasonStdin = values.booleans.has("--reason-stdin");
+        if (values.booleans.has("--dry-run") || values.positionals.length > 3 || (reasonStdin && reason))
+            throw new Error("memory log takes one reason or --reason-stdin, never --dry-run");
+        if (verdict !== "win" && verdict !== "loss" && verdict !== "noise")
+            throw new Error("memory log needs win|loss|noise");
+        if (store !== "bli" && store !== "supermemory" && store !== "both")
+            throw new Error("memory log needs --store bli|supermemory|both");
+        if (!reasonStdin && !reason.trim())
+            throw new Error("memory log needs a reason");
+        return { kind: "memory-log", verdict, store, reason, reasonStdin, homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")), json: values.booleans.has("--json") };
+    }
+    if (values.flags.has("--store") || values.booleans.has("--reason-stdin"))
+        throw new Error("--store and --reason-stdin require memory log");
     if (values.positionals.length > 1) {
         throw new Error("memory accepts at most one action (install|status).");
     }

package/dist/commands/local-help-commands.js

@@ -526,7 +526,7 @@ export function localSubcommandHelp(command) {
         [
             "memory",
             [
-                "Usage: cockpit memory [install|status] [--dashboard-url <url>] [--dry-run] [--json]",
+                "Usage: cockpit memory [install|status|log <win|loss|noise> --store <bli|supermemory|both> \"<reason>\"] [--dashboard-url <url>] [--dry-run] [--json]",
                 "",
                 "Registers BLI Memory on this machine: the `bli-memory` MCP server plus the",
                 "recall/save hooks, for Claude Code (~/.claude.json, ~/.claude/settings.json)",
@@ -535,6 +535,11 @@ export function localSubcommandHelp(command) {
                 "entries, and reads the stored config back before reporting success.",
                 "`do-everything` runs it, and the sync tick re-runs it at most once a day.",
                 "Action defaults to `install`. See docs/runbooks/bli-memory-install.md.",
+                "log appends an opinion to ~/.codex/AGENT-EXPERIENCE.md and posts it to Tower.",
+                "Use --reason-stdin instead of a quoted reason; --json reports shipped status.",
+                "Reasons: one line, max 500 characters; no prompts, memory bodies or secrets.",
+                "Markers: [bli] = BLI Memory, ◪ = Supermemory, [bli]+◪ = both.",
+                "Offline entries stay queued; the next collector sync retries with the same ID.",
             ],
         ],
         [

package/dist/commands/local-help.js

@@ -86,7 +86,7 @@ export function localCommandHelp(command) {
         "  cockpit serve [--port <port>] [--workspace <path>]",
         "  cockpit autostart [install|uninstall|status] [--workspace <path>] [--dashboard-url <url>] [--interval-seconds <n>] [--json]",
         "  cockpit agent-rules [install|uninstall|status] [--host codex|claude|all] [--workspace <path>] [--json]",
-        "  cockpit memory [install|status] [--dashboard-url <url>] [--dry-run] [--json]",
+        "  cockpit memory [install|status|log <win|loss|noise> --store <bli|supermemory|both> \"<reason>\"] [--dashboard-url <url>] [--dry-run] [--json]",
         "  cockpit clean [--dry-run] [--all-committed] [--reconcile] [--dashboard-url <url>] [--json]",
         "  cockpit docs [list|tree|read <id|slug>|create --title <t>|update <id>] [--parent <id>|root|--clear-parent] [--query <text>] [--limit <n>] [--visibility org|private] [--file <path>|--body-stdin] [--allow-empty] [--dashboard-url <url>] [--json]",
         "  cockpit msg [channels|create <name>|dm <email>|read <channel>|send <channel>|thread <id> --channel <channel>] [--private] [--members a@x,b@y] [--description <text>] [--thread <id>] [--limit <n>] [--dashboard-url <url>] [--json]",

package/dist/commands/local.js

@@ -30,6 +30,7 @@ import { runNotes } from "./notes.js";
 import { runServe } from "./serve.js";
 import { runAutostart } from "./autostart-command.js";
 import { runAgentRules } from "./agent-rules-command.js";
+import { runMemoryLog } from "./memory-log.js";
 import { runMemoryInstall } from "./memory-install.js";
 import { runClean } from "./clean.js";
 import { runDocs } from "./docs.js";
@@ -141,6 +142,8 @@ export async function runLocalCockpitCli(argv, io = defaultIo()) {
                 return await runAutostart(command, io);
             case "agent-rules":
                 return await runAgentRules(command, io);
+            case "memory-log":
+                return await runMemoryLog(command, io);
             case "memory":
                 return await runMemoryInstall(command, io);
             case "clean":

package/dist/commands/memory-hook-counts.js

@@ -54,6 +54,7 @@ export function readMemoryHookCounts(options) {
                 }
                 : {}),
             hook_skipped_trivial_24h: window.skippedTrivial,
+            hook_billing_exhausted_24h: window.billingExhausted,
         },
         reason: "ok",
     };

package/dist/commands/memory-log.js

@@ -0,0 +1,28 @@
+import path from "node:path";
+import { appendExperience, drainExperiences, shipExperience, validateExperience } from "@bli-cockpit/telemetry-core/memory-experience";
+import { readPipedText, writeLine } from "./cli-io.js";
+import { callTower, openTower } from "./tower-command.js";
+function sender(command, io) {
+    return async (entry) => {
+        const tower = await openTower("memory log", command, io);
+        const result = await callTower(tower, { path: "/api/memory/experience", method: "POST", body: entry, label: "memory experience", timeoutMs: 5000 });
+        return result.ok ? { ok: result.body?.ok === true, reason: "experience_not_acknowledged" } : result;
+    };
+}
+export async function runMemoryLog(command, io) {
+    const reason = command.reasonStdin ? (await readPipedText(io.stdin, { maxChars: 1002 })).trim() : command.reason;
+    validateExperience(command.store, command.verdict, reason);
+    const entry = await appendExperience({ store: command.store, verdict: command.verdict, reason }, {
+        homeDir: command.homeDir, agent: "cockpit", project: path.basename(process.cwd()),
+    });
+    const delivery = await shipExperience(entry, sender(command, io), command.homeDir);
+    const receipt = { ok: true, id: entry.id, local: true, ...delivery };
+    writeLine(io.stderr, `[memory experience] recorded ${JSON.stringify(receipt)}`);
+    writeLine(io.stdout, command.json ? JSON.stringify(receipt) : `Experience appended; shipped: ${delivery.shipped} (${delivery.reason}).`);
+    return 0;
+}
+export async function runMemoryExperienceAfterSync(command, io) {
+    const result = await drainExperiences(sender(command, io), command.homeDir);
+    if (result.reason !== "empty")
+        writeLine(io.stderr, `[memory experience] sync ${JSON.stringify(result)}`);
+}

package/dist/commands/ops-render-memory.js

@@ -96,11 +96,14 @@ export function renderMemoryHooks(hooks, dim) {
         const rightKnown = typeof right.runs === "number" ? 0 : 1;
         if (leftKnown !== rightKnown)
             return leftKnown - rightKnown;
-        return (right.timeouts ?? 0) - (left.timeouts ?? 0);
+        // BLI-3891: a billing refusal ranks beside a missed deadline. Both are a
+        // recall the person did not get; only the fix differs.
+        return ((right.timeouts ?? 0) + (right.billingExhausted ?? 0)
+            - ((left.timeouts ?? 0) + (left.billingExhausted ?? 0)));
     });
     for (const device of ranked) {
         const line = `  ${device.line ?? `${device.displayName ?? "?"}: (no line)`}`;
-        lines.push((device.timeouts ?? 0) > 0 ? line : dim(line));
+        lines.push((device.timeouts ?? 0) > 0 || (device.billingExhausted ?? 0) > 0 ? line : dim(line));
         if (device.performanceLine)
             lines.push(`    ${device.performanceLine}`);
         // BLI-3884. Written on the server (`lib/ops/memory-hook-misses.ts`) and

package/dist/commands/ops-render-spend.js

@@ -0,0 +1,36 @@
+/**
+ * `cockpit ops` — WHAT TODAY COST, by model (BLI-3909).
+ *
+ * Split out of `ops-render.ts` the way `ops-render-memory.ts` and
+ * `ops-render-coverage.ts` were, when that file crossed the repo's 500-line
+ * readability floor.
+ *
+ * Same rule as the rest of that family: every sentence here was written on the
+ * SERVER (`lib/ops/model-spend-today.ts`) and is printed VERBATIM. This module
+ * decides order, indentation and column widths and nothing else — a terminal
+ * that composed its own total from the same fields would eventually disagree
+ * with the page about what a $25 day means, and the one that is wrong is
+ * always the one somebody is reading.
+ *
+ * A CLI too old to know this section simply does not print it. Nothing is lost
+ * by that: the section rides the ordinary `/api/ops/status` response, so
+ * `cockpit ops --json` carries it on every version.
+ */
+/** `$18.65`, `$0.0031`, `—` when the server sent no number at all. */
+function usdColumn(usd) {
+    if (typeof usd !== "number")
+        return "—";
+    return `$${usd.toFixed(usd < 0.01 ? 4 : 2)}`;
+}
+/**
+ * The SPEND block: the server's one line, then one row per model. `$314 of a
+ * $357 month on one model` is the thing this exists to make visible before the
+ * invoice does.
+ */
+export function renderSpend(spend, dim) {
+    const lines = ["", `SPEND  ${spend.summary ?? "(no summary)"}`];
+    for (const row of spend.models ?? []) {
+        lines.push(dim(`  ${usdColumn(row.usd).padStart(9)}  ${row.model ?? "?"} · ${row.calls ?? 0} call(s) · ${(row.bases ?? []).join("+") || "?"} · ${(row.sources ?? []).join(",") || "?"}`));
+    }
+    return lines;
+}

package/dist/commands/ops-render.js

@@ -13,6 +13,10 @@
  * somebody is about to conclude something from it.
  */
 import { renderCoverageBuckets, } from "./ops-render-coverage.js";
+// BLI-3909: today's spend by model, its own renderer for the same reason the
+// coverage table has one — this file is at the repo's readability floor.
+import { renderSpend } from "./ops-render-spend.js";
+export { renderSpend } from "./ops-render-spend.js";
 export { renderMemoryHooks, renderMemoryUsage } from "./ops-render-memory.js";
 export { renderCoverageBuckets };
 /** The word a person reads. Short, fixed width, and never a bare colour. */
@@ -124,6 +128,8 @@ options = {}) {
             lines.push(...renderCoverageBuckets(payload.coverage.buckets, dim));
         }
     }
+    if (payload.spend)
+        lines.push(...renderSpend(payload.spend, dim));
     const slack = payload.skips?.slack;
     const external = payload.skips?.external;
     if (slack || external) {

package/dist/commands/ops.js

@@ -88,7 +88,7 @@ async function runOpsStatus(command, io, tower) {
         // BLI-3762: a job that ran and wrote less than it owed is not healthy.
         row.verdict === "degraded");
     if (command.json) {
-        writeLine(io.stdout, JSON.stringify(memory ? { ...payload, memory: memory.section, hooks: memory.hooks } : payload));
+        writeLine(io.stdout, JSON.stringify(memory ? { ...payload, memory: memory.section, hooks: memory.hooks, experience: memory.experience } : payload));
     }
     else {
         const styled = colorEnabled(io);
@@ -111,6 +111,11 @@ async function runOpsStatus(command, io, tower) {
                 writeLine(io.stdout, line);
             }
         }
+        if (memory?.experience) {
+            writeLine(io.stdout, `\nEXPERIENCE  ${memory.experience.summary}`);
+            for (const line of memory.experience.lines)
+                writeLine(io.stdout, `  ${line}`);
+        }
         if (memory && !memory.section) {
             // Never a silent gap where a section was asked for: the reason the gauge
             // could not be read is printed where the gauge would have been.
@@ -147,6 +152,9 @@ async function runOpsStatus(command, io, tower) {
         // BLI-3881: runs the hook declined to search for. A SUBSET of runs, so
         // `runs - skipped_trivial` is how many turns actually asked the door.
         memory_hook_skipped_trivial_24h: memory?.hooks?.totals?.skippedTrivial ?? null,
+        // BLI-3891: null means the fleet reported none of these at all, which is
+        // "not measured" on a machine older than the count — never "no refusals".
+        memory_hook_billing_exhausted_24h: memory?.hooks?.totals?.billingExhausted ?? null,
         memory_hook_devices_reporting: memory?.hooks?.reporting ?? null,
         // BLI-3884: which route answered them, fleet-wide. Null while no machine
         // names one — a rollout fact, not a count of zero.
@@ -177,15 +185,15 @@ async function readMemoryUsage(command, io, tower) {
             reason: result.reason,
             http_status: result.httpStatus ?? null,
         })}`);
-        return { section: null, hooks: null, reason: result.reason };
+        return { section: null, hooks: null, experience: null, reason: result.reason };
     }
     const body = asRecord(result.body);
     // BLI-3788: the hook counts ride the same answer, and their absence is a
     // fact about the SERVER's version rather than about this fleet — an older
     // dashboard sends no `hooks` key, and printing nothing is right there.
     if (!body.memory)
-        return { section: null, hooks: body.hooks ?? null, reason: "memory_section_absent" };
-    return { section: body.memory, hooks: body.hooks ?? null, reason: "ok" };
+        return { section: null, hooks: body.hooks ?? null, experience: body.experience ?? null, reason: "memory_section_absent" };
+    return { section: body.memory, hooks: body.hooks ?? null, experience: body.experience ?? null, reason: "ok" };
 }
 async function runOpsRecompile(command, io, tower) {
     const person = command.person ?? "";

package/dist/commands/public-root.js

@@ -15,7 +15,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.86");
+    writeLine(io?.stdout ?? process.stdout, "0.2.88");
     return 0;
   }
 

package/dist/commands/sync.js

@@ -1,3 +1,4 @@
+import { runMemoryExperienceAfterSync } from "./memory-log.js";
 import { writeLine } from "./cli-io.js";
 import { attributedSyncRunStatus, cursorStatusLine, displayTicketId, rawEvidenceSyncLine, shortSha, worktreeSyncRow, writeAgentSessionSummary, } from "./collection-report.js";
 import { collectionRootConsentAliases } from "./collection-roots.js";
@@ -52,6 +53,7 @@ export async function runSync(command, io) {
         // BLI-3580: BLI Memory's registration converges the same way — after
         // collection, at most once a day, its own receipt either way.
         await runMemoryInstallAfterSync(command, io, dashboardUrl);
+        await runMemoryExperienceAfterSync({ ...command, dashboardUrl }, io);
         // BLI-3619: and the disk stops growing without bound — same daily cadence,
         // same rule that a follow-up never blocks or fails collection.
         await runStagingPruneAfterSync(command, io, dashboardUrl);
@@ -86,6 +88,7 @@ export async function runSync(command, io) {
         // BLI-3580: BLI Memory's registration converges the same way — after
         // collection, at most once a day, its own receipt either way.
         await runMemoryInstallAfterSync(command, io, dashboardUrl);
+        await runMemoryExperienceAfterSync({ ...command, dashboardUrl }, io);
         throw error;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.86",
+  "version": "0.2.88",
   "private": false,
   "type": "module",
   "bin": {
@@ -27,8 +27,8 @@
     "test": "node dist/cli.js --help && node ../../scripts/assert-public-cli-routing.mjs && node ../../scripts/assert-public-cli-verb-help.mjs && node ../../scripts/assert-public-cli-runtime-files.mjs && node ../../scripts/assert-public-cli-no-fleet-posts.mjs && node ../../scripts/assert-public-package-pack.mjs --workspace=@bli-cockpit/cli"
   },
   "dependencies": {
-    "@bli-cockpit/memory-mcp": "0.1.18",
-    "@bli-cockpit/mcp": "0.1.19",
-    "@bli-cockpit/telemetry-core": "0.1.35"
+    "@bli-cockpit/memory-mcp": "0.1.20",
+    "@bli-cockpit/mcp": "0.1.21",
+    "@bli-cockpit/telemetry-core": "0.1.37"
   }
 }