@bli-cockpit/cli 0.2.85 → 0.2.87

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-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.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.
@@ -177,15 +182,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.85");
+    writeLine(io?.stdout ?? process.stdout, "0.2.87");
     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.85",
+  "version": "0.2.87",
   "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.17",
-    "@bli-cockpit/mcp": "0.1.19",
-    "@bli-cockpit/telemetry-core": "0.1.35"
+    "@bli-cockpit/memory-mcp": "0.1.19",
+    "@bli-cockpit/mcp": "0.1.20",
+    "@bli-cockpit/telemetry-core": "0.1.36"
   }
 }