@legioncodeinc/honeycomb 0.1.5 → 0.1.6

package/.claude-plugin/marketplace.json

@@ -5,13 +5,13 @@
   },
   "metadata": {
     "description": "Honeycomb — persistent memory daemon and thin harness clients for AI coding assistants",
-    "version": "0.1.5"
+    "version": "0.1.6"
   },
   "plugins": [
     {
       "name": "honeycomb",
       "description": "Honeycomb Claude Code plugin — captures session activity and provides cross-session memory through the local daemon",
-      "version": "0.1.5",
+      "version": "0.1.6",
       "source": "./harnesses/claude-code"
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "honeycomb",
   "description": "Honeycomb — a long-lived daemon plus thin clients for six coding harnesses, the unified honeycomb CLI, the MCP server, and the embed daemon",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "author": {
     "name": "Honeycomb"
   },

package/README.md

@@ -13,8 +13,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/legioncodeinc/honeycomb/actions"><img src="https://img.shields.io/github/actions/workflow/status/legioncodeinc/honeycomb/ci.yaml?branch=main&label=CI&style=flat-square" alt="CI"></a>
-  <img src="https://img.shields.io/badge/version-0.1.0-F7A823?style=flat-square" alt="Version 0.1.0">
+  <a href="https://www.npmjs.com/package/@legioncodeinc/honeycomb"><img src="https://img.shields.io/npm/v/@legioncodeinc/honeycomb?style=flat-square&color=F7A823&label=version" alt="npm version"></a>
   <img src="https://img.shields.io/badge/node-%E2%89%A522-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node ≥ 22">
   <a href="https://deeplake.ai"><img src="https://img.shields.io/badge/powered%20by-Deep%20Lake-ff5a1f?style=flat-square" alt="Powered by Deep Lake"></a>
   <a href="#license"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square" alt="AGPL-3.0"></a>
@@ -46,7 +45,7 @@ AI coding agents forget. They forget across sessions, and they forget across too
 <tr>
 <td width="50%" valign="top">
 
-#### 🛹 For vibe coders
+#### 🛹 For AI augmented devs
 Stop re-explaining your project to a fresh agent every morning. Honeycomb remembers your decisions, your conventions, and the fixes that worked, then primes your next session with them automatically. One install command, a friendly dashboard, no SQL, no config gauntlet.
 
 </td>
@@ -213,7 +212,7 @@ Four ways to reach the same daemon and the same shared memory:
 
 ## 📍 Status & roadmap
 
-Honeycomb is **v0.1.0, pre-release**. We document what's real and flag what's opt-in.
+Honeycomb is **pre-release (v0.1.x)**. We document what's real and flag what's opt-in.
 
 **Working today**
 - Capture-to-recall, proven end-to-end against live Deep Lake (`npm run smoke:golden-path` with credentials).

package/bundle/cli.js

@@ -17,6 +17,7 @@ var VERB_TABLE = Object.freeze([
   { verb: "maintenance", cls: "storage", summary: "run version-history compaction over version-bumped tables (030)" },
   { verb: "remember", cls: "storage", summary: "write a memory through the daemon (--type fact|convention|preference|decision|gotcha|reference)" },
   { verb: "recall", cls: "storage", summary: "recall memories through the daemon" },
+  { verb: "memory", cls: "storage", summary: "lifecycle: conflicts (list/resolve), stale-refs (list), inspect <id> --lifecycle (058d)" },
   { verb: "agent", cls: "storage", summary: "run an agent turn through the daemon" },
   { verb: "ontology", cls: "storage", summary: "inspect/propose ontology changes through the daemon" },
   { verb: "secret", cls: "storage", summary: "manage named secrets through the daemon" },
@@ -268,21 +269,21 @@ function renderSummary(body, out) {
   let totalReaped = 0;
   let totalSkipped = 0;
   let tablesCompacted = 0;
-  for (const s of summaries) {
-    const reaped = s.rowsReaped ?? 0;
-    const skipped = s.keysSkipped ?? 0;
+  for (const s2 of summaries) {
+    const reaped = s2.rowsReaped ?? 0;
+    const skipped = s2.keysSkipped ?? 0;
     totalReaped += reaped;
     totalSkipped += skipped;
     if (reaped > 0)
       tablesCompacted += 1;
   }
   out(`maintenance compact: ${tablesCompacted}/${summaries.length} table(s) reaped, ${totalReaped} row(s) reaped, ${totalSkipped} key(s) skipped.`);
-  for (const s of summaries) {
-    const table = s.table ?? "(unknown)";
-    const reaped = s.rowsReaped ?? 0;
-    const scanned = s.keysScanned ?? 0;
-    const skipped = s.keysSkipped ?? 0;
-    const errored = s.errored ?? 0;
+  for (const s2 of summaries) {
+    const table = s2.table ?? "(unknown)";
+    const reaped = s2.rowsReaped ?? 0;
+    const scanned = s2.keysScanned ?? 0;
+    const skipped = s2.keysSkipped ?? 0;
+    const errored = s2.errored ?? 0;
     const flap = skipped > 0 ? ` \u2014 ${skipped} key(s) SKIPPED (survivor not durable; re-run converges)` : "";
     const err = errored > 0 ? ` \u2014 ${errored} error(s) (fail-soft; re-run)` : "";
     out(`  ${table}: ${reaped} row(s) reaped over ${scanned} key(s)${flap}${err}.`);
@@ -316,6 +317,183 @@ async function runMaintenanceVerb(argv, deps) {
   return { exitCode: 0 };
 }
 
+// dist/src/commands/memory.js
+var MEMORY_CONFLICTS_LIST_ROUTE = "/api/memories/conflicts";
+var MEMORY_CONFLICTS_RESOLVE_ROUTE = "/api/memories/conflicts";
+var MEMORY_STALE_REFS_ROUTE = "/api/memories/stale-refs";
+var MEMORY_DETAIL_ROUTE = "/api/memories";
+var MEMORY_CONFLICT_VERDICTS = Object.freeze(["supersede", "review", "keep-both"]);
+function flagValue2(argv, flag) {
+  const idx = argv.indexOf(flag);
+  if (idx < 0)
+    return void 0;
+  const v = argv[idx + 1];
+  return v !== void 0 && !v.startsWith("--") ? v : void 0;
+}
+var MEMORY_VALUE_FLAGS = /* @__PURE__ */ new Set(["--status", "--verdict", "--winner", "--reason"]);
+function parseMemoryCliArgs(argv) {
+  const positionals = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    const tok = argv[i];
+    if (tok === void 0)
+      continue;
+    if (MEMORY_VALUE_FLAGS.has(tok)) {
+      i += 1;
+      continue;
+    }
+    if (tok.startsWith("--"))
+      continue;
+    positionals.push(tok);
+  }
+  return {
+    sub: positionals[0] ?? "",
+    arg: positionals[1] ?? "",
+    id: positionals[2] ?? "",
+    status: flagValue2(argv, "--status") ?? "open",
+    verdict: flagValue2(argv, "--verdict") ?? "",
+    winner: flagValue2(argv, "--winner") ?? "",
+    reason: flagValue2(argv, "--reason") ?? "",
+    lifecycle: argv.includes("--lifecycle")
+  };
+}
+function rowsOf(body, key) {
+  if (typeof body !== "object" || body === null)
+    return [];
+  const arr = body[key];
+  return Array.isArray(arr) ? arr : [];
+}
+function s(v) {
+  return v === void 0 || v === null ? "" : String(v);
+}
+function renderConflicts(res, json2, out) {
+  if (json2) {
+    out(JSON.stringify(res.body ?? {}, null, 2));
+    return;
+  }
+  const rows = rowsOf(res.body, "conflicts");
+  if (rows.length === 0) {
+    out("no conflicts found in scope.");
+    return;
+  }
+  for (const r of rows) {
+    const winner = s(r.winnerId) !== "" ? `  winner=${s(r.winnerId)}` : "";
+    out(`${s(r.id)}  [${s(r.status) || "open"}]  ${s(r.memoryAId)} \u21C4 ${s(r.memoryBId)}  verdict=${s(r.verdict) || "review"}${winner}`);
+  }
+}
+function renderStaleRefs(res, json2, out) {
+  if (json2) {
+    out(JSON.stringify(res.body ?? {}, null, 2));
+    return;
+  }
+  const rows = rowsOf(res.body, "staleRefs");
+  if (rows.length === 0) {
+    out("no stale references found in scope.");
+    return;
+  }
+  for (const r of rows) {
+    const refs = Array.isArray(r.staleRefs) ? r.staleRefs : [];
+    out(`${s(r.memoryId)}  [${s(r.refStatus) || "stale"}]  refs: ${refs.length > 0 ? refs.join(", ") : "(unrecorded)"}`);
+  }
+}
+function buildConflictsRequest(inv, out) {
+  if (inv.arg === "resolve") {
+    if (inv.id === "") {
+      out("usage: honeycomb memory conflicts resolve <id> --verdict <supersede|review|keep-both> [--winner <memory-id>]");
+      return null;
+    }
+    if (!MEMORY_CONFLICT_VERDICTS.includes(inv.verdict)) {
+      out(`error: --verdict must be one of: ${MEMORY_CONFLICT_VERDICTS.join(", ")}`);
+      return null;
+    }
+    const body = { verdict: inv.verdict };
+    if (inv.winner !== "")
+      body.winnerId = inv.winner;
+    if (inv.reason !== "")
+      body.reason = inv.reason;
+    return { method: "POST", path: `${MEMORY_CONFLICTS_RESOLVE_ROUTE}/${encodeURIComponent(inv.id)}/resolve`, body };
+  }
+  return { method: "GET", path: MEMORY_CONFLICTS_LIST_ROUTE, query: { status: inv.status } };
+}
+async function runMemoryVerb(argv, deps, json2 = false) {
+  const out = deps.out ?? ((line) => console.log(line));
+  const inv = parseMemoryCliArgs(argv);
+  if (inv.sub === "conflicts") {
+    const req = buildConflictsRequest(inv, out);
+    if (req === null)
+      return { exitCode: 1 };
+    const res = await deps.daemon.send(req);
+    if (res.status >= 400) {
+      out(`error: memory conflicts failed (daemon ${res.status}).`);
+      return { exitCode: 1 };
+    }
+    if (inv.arg === "resolve") {
+      if (json2)
+        out(JSON.stringify(res.body ?? {}, null, 2));
+      else
+        out(`resolved conflict ${inv.id} (${inv.verdict}).`);
+      return { exitCode: 0 };
+    }
+    renderConflicts(res, json2, out);
+    return { exitCode: 0 };
+  }
+  if (inv.sub === "stale-refs") {
+    const res = await deps.daemon.send({ method: "GET", path: MEMORY_STALE_REFS_ROUTE });
+    if (res.status >= 400) {
+      out(`error: memory stale-refs failed (daemon ${res.status}).`);
+      return { exitCode: 1 };
+    }
+    renderStaleRefs(res, json2, out);
+    return { exitCode: 0 };
+  }
+  if (inv.sub === "inspect") {
+    return runInspect(inv, deps, json2, out);
+  }
+  out("usage: honeycomb memory <conflicts|stale-refs|inspect>");
+  out("       conflicts [--status open]                 list conflicts in scope");
+  out("       conflicts resolve <id> --verdict <v> [--winner <id>]   resolve via the 058b endpoint");
+  out("       stale-refs                                list memories with stale references");
+  out("       inspect <id> --lifecycle                  show freshness, calibrated confidence, refStatus, conflict, H");
+  return { exitCode: inv.sub === "" ? 0 : 1 };
+}
+function n(v) {
+  const x = typeof v === "number" ? v : Number(v);
+  return Number.isFinite(x) ? x : void 0;
+}
+async function runInspect(inv, deps, json2, out) {
+  if (inv.arg === "") {
+    out("usage: honeycomb memory inspect <id> [--lifecycle]");
+    return { exitCode: 1 };
+  }
+  const res = await deps.daemon.send({ method: "GET", path: `${MEMORY_DETAIL_ROUTE}/${encodeURIComponent(inv.arg)}` });
+  if (res.status >= 400) {
+    out(`error: memory ${inv.arg} not found (daemon ${res.status}).`);
+    return { exitCode: 1 };
+  }
+  if (json2) {
+    out(JSON.stringify(res.body ?? {}, null, 2));
+    return { exitCode: 0 };
+  }
+  const body = typeof res.body === "object" && res.body !== null ? res.body : {};
+  const m = body.memory ?? {};
+  if (!inv.lifecycle) {
+    out(`memory ${s(m.id) || inv.arg}`);
+    return { exitCode: 0 };
+  }
+  const a = n(m.activation) ?? n(m.freshnessScore) ?? 1;
+  const cFactor = n(m.calibratedConfidence) ?? 1;
+  const sigma = n(m.staleness) ?? 0;
+  const kappa = n(m.kappa) ?? 1;
+  const clamp = (x) => Math.min(1, Math.max(0, x));
+  const health = clamp(a) * clamp(cFactor) * (1 - clamp(sigma)) * clamp(kappa);
+  out(`memory ${s(m.id) || inv.arg} \u2014 lifecycle`);
+  out(`  freshnessScore        ${n(m.freshnessScore) ?? n(m.activation) ?? "(none)"}`);
+  out(`  calibratedConfidence  ${n(m.calibratedConfidence) ?? "(none \u2014 calibration dormant)"}`);
+  out(`  refStatus             ${s(m.refStatus) || "unknown"}`);
+  out(`  open-conflict         ${m.openConflict === true ? "yes" : "no"}`);
+  out(`  H (health)            ${health.toFixed(3)}`);
+  return { exitCode: 0 };
+}
+
 // dist/src/daemon/runtime/vault/catalog.js
 var PROVIDER_CATALOG = Object.freeze([
   Object.freeze({
@@ -400,9 +578,9 @@ function coerceSettingValue(value) {
   if (value === "false")
     return false;
   if (value.trim().length > 0) {
-    const n = Number(value);
-    if (Number.isFinite(n) && String(n) === value.trim())
-      return n;
+    const n2 = Number(value);
+    if (Number.isFinite(n2) && String(n2) === value.trim())
+      return n2;
   }
   return value;
 }
@@ -13987,17 +14165,17 @@ var ZodArray = /* @__PURE__ */ $constructor("ZodArray", (inst, def) => {
   inst._zod.processJSONSchema = (ctx, json2, params) => arrayProcessor(inst, ctx, json2, params);
   inst.element = def.element;
   _installLazyMethods(inst, "ZodArray", {
-    min(n, params) {
-      return this.check(_minLength(n, params));
+    min(n2, params) {
+      return this.check(_minLength(n2, params));
     },
     nonempty(params) {
       return this.check(_minLength(1, params));
     },
-    max(n, params) {
-      return this.check(_maxLength(n, params));
+    max(n2, params) {
+      return this.check(_maxLength(n2, params));
     },
-    length(n, params) {
-      return this.check(_length(n, params));
+    length(n2, params) {
+      return this.check(_length(n2, params));
     },
     unwrap() {
       return this.element;
@@ -15068,12 +15246,12 @@ function convertSchema(schema, ctx) {
   let baseSchema = convertBaseSchema(schema, ctx);
   const hasExplicitType = schema.type || schema.enum !== void 0 || schema.const !== void 0;
   if (schema.anyOf && Array.isArray(schema.anyOf)) {
-    const options = schema.anyOf.map((s) => convertSchema(s, ctx));
+    const options = schema.anyOf.map((s2) => convertSchema(s2, ctx));
     const anyOfUnion = z.union(options);
     baseSchema = hasExplicitType ? z.intersection(baseSchema, anyOfUnion) : anyOfUnion;
   }
   if (schema.oneOf && Array.isArray(schema.oneOf)) {
-    const options = schema.oneOf.map((s) => convertSchema(s, ctx));
+    const options = schema.oneOf.map((s2) => convertSchema(s2, ctx));
     const oneOfUnion = z.xor(options);
     baseSchema = hasExplicitType ? z.intersection(baseSchema, oneOfUnion) : oneOfUnion;
   }
@@ -15786,10 +15964,10 @@ function resolveTenancy(creds, env = process.env) {
 // dist/src/daemon/storage/config.js
 var DEFAULT_QUERY_TIMEOUT_MS = 1e4;
 var QueryTimeoutMs = external_exports.preprocess((raw) => {
-  const n = typeof raw === "number" ? raw : Number(raw);
-  if (!Number.isFinite(n))
+  const n2 = typeof raw === "number" ? raw : Number(raw);
+  if (!Number.isFinite(n2))
     return DEFAULT_QUERY_TIMEOUT_MS;
-  return Math.min(Math.max(0, Math.trunc(n)), 6e5);
+  return Math.min(Math.max(0, Math.trunc(n2)), 6e5);
 }, external_exports.number());
 var StorageConfigSchema = external_exports.object({
   /** DeepLake HTTP query endpoint, e.g. https://api.deeplake.ai. */
@@ -15877,8 +16055,8 @@ function pickString(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 function pickNumber(value) {
-  const n = typeof value === "number" ? value : Number(value);
-  return Number.isFinite(n) ? n : void 0;
+  const n2 = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(n2) ? n2 : void 0;
 }
 function pickBool(value) {
   return typeof value === "boolean" ? value : void 0;
@@ -16292,7 +16470,7 @@ var STORAGE_VERB_ROUTES = Object.freeze({
 function subcommandOf(argv) {
   return argv.find((a) => !a.startsWith("--")) ?? "";
 }
-function flagValue2(argv, flag) {
+function flagValue3(argv, flag) {
   const idx = argv.indexOf(flag);
   if (idx < 0)
     return void 0;
@@ -16315,7 +16493,7 @@ function buildSkillRequest(argv) {
   }
   if (sub === "scope") {
     const scope = rest[1] ?? "";
-    const users = (flagValue2(argv, "--users") ?? "").split(",").map((u) => u.trim()).filter((u) => u.length > 0);
+    const users = (flagValue3(argv, "--users") ?? "").split(",").map((u) => u.trim()).filter((u) => u.length > 0);
     const force = argv.includes("--force");
     return { method: "POST", path: "/api/skills/scope", body: { scope, users, force } };
   }
@@ -16344,14 +16522,14 @@ function stripFlagPair(argv, flag) {
 }
 function buildRememberRequest(argv) {
   const content = stripFlagPair(argv, "--type").filter((a) => !a.startsWith("--")).join(" ");
-  const type = flagValue2(argv, "--type");
+  const type = flagValue3(argv, "--type");
   const body = { content };
   if (type !== void 0 && isMemoryType(type))
     body.type = type;
   return { method: "POST", path: "/api/memories", body };
 }
 function rememberTypeError(argv) {
-  const type = flagValue2(argv, "--type");
+  const type = flagValue3(argv, "--type");
   if (type === void 0 || isMemoryType(type))
     return null;
   return [
@@ -16507,7 +16685,7 @@ function canonicalizeRemote(rawRemote) {
     return "";
   let path = pathPart.replace(/\/+$/, "");
   path = path.replace(/\.git$/i, "");
-  const segments = path.split("/").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+  const segments = path.split("/").map((s2) => s2.trim().toLowerCase()).filter((s2) => s2.length > 0);
   if (segments.length === 0)
     return "";
   return `${host}/${segments.join("/")}`;
@@ -17047,7 +17225,7 @@ function buildAllowedProperties(input) {
 }
 var systemTelemetryClock = () => (/* @__PURE__ */ new Date()).toISOString();
 var DEFAULT_EMIT_TIMEOUT_MS = 2e3;
-var HONEYCOMB_VERSION = true ? "0.1.5" : "0.0.0-dev";
+var HONEYCOMB_VERSION = true ? "0.1.6" : "0.0.0-dev";
 async function emitTelemetry(event, opts, deps = {}) {
   const env = deps.env ?? process.env;
   const key = deps.posthogKey ?? POSTHOG_KEY;
@@ -17190,7 +17368,7 @@ function renderGlassBoxText(view) {
 // dist/src/shared/constants.js
 var DAEMON_PORT = 3850;
 var DAEMON_HOST = "127.0.0.1";
-var HONEYCOMB_VERSION2 = true ? "0.1.5" : "0.0.0-dev";
+var HONEYCOMB_VERSION2 = true ? "0.1.6" : "0.0.0-dev";
 var PRODUCT_SLUG = "honeycomb";
 
 // dist/src/commands/install.js
@@ -17399,6 +17577,9 @@ async function dispatchStorage(inv, deps) {
   if (inv.verb === "maintenance") {
     return runMaintenanceVerb(inv.argv, deps);
   }
+  if (inv.verb === "memory") {
+    return runMemoryVerb(inv.argv, deps, inv.flags.json);
+  }
   if (inv.verb === "settings") {
     return runSettingsVerb(inv.argv, deps);
   }
@@ -19456,8 +19637,8 @@ function parsePluginEnabled(listOutput, name) {
   }
   return false;
 }
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegExp(s2) {
+  return s2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function createClaudePluginRunner(binary = "claude") {
   function invoke(args) {
@@ -19729,7 +19910,7 @@ function buildKpisView(view) {
   return { kind: "metric", title: "KPIs", rows, data: view };
 }
 function buildSessionsView(view) {
-  const rows = view.sessions.map((s) => `${s.sessionId} \xB7 ${s.project} \xB7 ${s.startedAt} \xB7 ${s.eventCount} events \xB7 ${s.status}`);
+  const rows = view.sessions.map((s2) => `${s2.sessionId} \xB7 ${s2.project} \xB7 ${s2.startedAt} \xB7 ${s2.eventCount} events \xB7 ${s2.status}`);
   return { kind: "table", title: "Sessions", rows, data: view.sessions };
 }
 function buildSettingsView(view) {
@@ -19759,7 +19940,7 @@ function buildRulesView(view) {
   return { kind: "table", title: "Rules", rows, data: view.rules };
 }
 function buildSkillSyncView(view) {
-  const rows = view.skills.map((s) => `${s.name} \xB7 ${s.scope} \xB7 ${s.syncState}`);
+  const rows = view.skills.map((s2) => `${s2.name} \xB7 ${s2.scope} \xB7 ${s2.syncState}`);
   return { kind: "panel", title: "Skill-sync", rows, data: view.skills };
 }