@dadado/agent-kit-cli 5.17.0 → 6.0.0

package/dashboard/lib/run-logs.mjs

@@ -0,0 +1,218 @@
+/**
+ * Headless run feed for Mission Control: the kit's own `.cursor/loop-logs/`
+ * (`tick-*.log` from `agent-kit run-plan`, `run-*.log` from `agent-kit run`),
+ * so the panel and an embedding host can show agent output, gates and tick
+ * results without reading `~/.cursor/projects` (ADR 2026-10-08
+ * mission-control-embeddable-contract).
+ *
+ * The logs are already redacted when the CLI writes them; a caller-supplied
+ * `redact` runs again over every string this module returns. Read-only and
+ * bounded: newest MAX_RUN_LOGS files, the last MAX_RUN_LOG_BYTES of each.
+ * Understands the three shapes the backends write: claude / cursor-agent
+ * stream-json, codex `exec --json`, and the cursor-acp JSON-RPC transcript.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+export const MAX_RUN_LOGS = 10;
+export const MAX_RUN_LOG_BYTES = 256 * 1024;
+export const MAX_RUN_LOG_TEXT = 600;
+const MAX_LIST = 10;
+
+const LOG_NAME_RE = /^(tick|run)-[0-9-]+\.log$/;
+const GATE_RE = /^HITL_GATE:\s*([a-z0-9-]+)\s*\|/m;
+const SENTINEL_RE = /LOOP_TICK_RESULT:\s*(continue|stop(?:\s*[—-].*)?)/i;
+const REPLY_RE = /HITL_REPLY:\s*[a-z0-9-]+\s*\|[^\n]*/;
+
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+
+function cap(text, max = MAX_RUN_LOG_TEXT) {
+  const s = String(text ?? "").trim();
+  return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+}
+
+function textOf(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content
+    .map((part) => (isRecord(part) && typeof part.text === "string" ? part.text : ""))
+    .join("");
+}
+
+/**
+ * Summary of one log's text: backend shape, session id, last agent text,
+ * the final result, the `LOOP_TICK_RESULT` line, gate ids and reply stamps.
+ * Never throws; unknown lines are skipped.
+ */
+export function summarizeRunLog(text, redact = (s) => s) {
+  const out = {
+    format: null,
+    sessionId: null,
+    events: 0,
+    lastText: "",
+    result: null,
+    sentinel: null,
+    gates: [],
+    replies: [],
+  };
+  let acpTurn = "";
+  const noteText = (t) => {
+    if (!t) return;
+    out.lastText = t;
+    const gate = GATE_RE.exec(t);
+    if (gate?.[1] && out.gates.length < MAX_LIST) out.gates.push(gate[1]);
+  };
+  const noteReply = (t) => {
+    const m = REPLY_RE.exec(t);
+    if (m && out.replies.length < MAX_LIST) out.replies.push(m[0].trim());
+  };
+  for (const raw of String(text ?? "").split("\n")) {
+    const line = raw.trim();
+    if (!line.startsWith("{")) continue;
+    let ev;
+    try {
+      ev = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (!isRecord(ev)) continue;
+    out.events += 1;
+    // cursor-acp: JSON-RPC 2.0 transcript (both directions).
+    if (ev.jsonrpc === "2.0") {
+      out.format ??= "acp";
+      const params = isRecord(ev.params) ? ev.params : null;
+      if (ev.method === "session/update" && isRecord(params?.update)) {
+        const u = params.update;
+        if (u.sessionUpdate === "agent_message_chunk" && isRecord(u.content)) {
+          acpTurn += typeof u.content.text === "string" ? u.content.text : "";
+        }
+      } else if (ev.method === "session/prompt" && params) {
+        noteReply(textOf(params.prompt));
+      } else if (isRecord(ev.result) && typeof ev.result.sessionId === "string") {
+        out.sessionId = ev.result.sessionId;
+      } else if (isRecord(ev.result) && typeof ev.result.stopReason === "string") {
+        noteText(acpTurn);
+        out.result = { isError: false, subtype: ev.result.stopReason, text: cap(acpTurn) };
+        acpTurn = "";
+      } else if (isRecord(ev.error) && ev.id !== undefined && !ev.method) {
+        const message = typeof ev.error.message === "string" ? ev.error.message : "error";
+        out.result = { isError: true, subtype: "error", text: cap(message) };
+      }
+      continue;
+    }
+    const type = ev.type;
+    // codex exec --json
+    if (type === "thread.started" || type === "turn.completed" || type === "turn.failed") {
+      out.format ??= "codex";
+    }
+    if (type === "thread.started" && typeof ev.thread_id === "string") out.sessionId = ev.thread_id;
+    else if (type === "item.completed" && isRecord(ev.item)) {
+      const kind = ev.item.type ?? ev.item.item_type;
+      if (
+        (kind === "agent_message" || kind === "assistant_message") &&
+        typeof ev.item.text === "string"
+      ) {
+        noteText(ev.item.text);
+      }
+    } else if (type === "turn.completed") {
+      out.result = { isError: false, subtype: "success", text: cap(out.lastText) };
+    } else if (type === "turn.failed") {
+      const message =
+        isRecord(ev.error) && typeof ev.error.message === "string" ? ev.error.message : "failed";
+      out.result = { isError: true, subtype: "error", text: cap(message) };
+    }
+    // claude / cursor-agent stream-json
+    else if (type === "system" && ev.subtype === "init") {
+      out.format ??= "stream-json";
+      if (typeof ev.session_id === "string") out.sessionId = ev.session_id;
+    } else if (type === "assistant" && isRecord(ev.message)) {
+      noteText(textOf(ev.message.content));
+    } else if (type === "user" && ev.isReplay === true && isRecord(ev.message)) {
+      noteReply(textOf(ev.message.content));
+    } else if (type === "result") {
+      out.format ??= "stream-json";
+      const resultText = typeof ev.result === "string" ? ev.result : "";
+      if (resultText) noteText(resultText);
+      out.result = {
+        isError: ev.is_error === true,
+        subtype: typeof ev.subtype === "string" ? ev.subtype : null,
+        text: cap(resultText),
+      };
+    }
+  }
+  const sentinel = SENTINEL_RE.exec(out.result?.text || out.lastText);
+  out.sentinel = sentinel ? `LOOP_TICK_RESULT: ${sentinel[1].trim()}` : null;
+  out.lastText = cap(out.lastText);
+  out.gates = [...new Set(out.gates)];
+  out.lastText = redact(out.lastText);
+  if (out.result) out.result.text = redact(out.result.text);
+  out.replies = out.replies.map((r) => redact(r));
+  return out;
+}
+
+/**
+ * Runner state dir for the loop logs: mirrors `resolveStateDir` in
+ * packages/cli/src/utils/kit-paths.ts (`AGENT_KIT_STATE_ROOT`, `.cursor` or
+ * `.agent-kit`, anything else falls back to `.cursor`). HTML/ESM cannot import
+ * the TS module; a parity test keeps the two in step.
+ */
+export function resolveRunnerStateDir(env = process.env) {
+  const raw = String(env?.AGENT_KIT_STATE_ROOT ?? "")
+    .trim()
+    .replace(/\/+$/, "");
+  return raw === ".agent-kit" ? ".agent-kit" : ".cursor";
+}
+
+/** Read the tail of a file (the newest events matter; the head may be a long prompt echo). */
+function readTail(file, size) {
+  const text = readFileSync(file, "utf8");
+  if (size <= MAX_RUN_LOG_BYTES) return text;
+  const tail = text.slice(-MAX_RUN_LOG_BYTES);
+  const cut = tail.indexOf("\n");
+  return cut === -1 ? tail : tail.slice(cut + 1);
+}
+
+/**
+ * Rows for the newest headless logs under `<root>/<stateDir>/loop-logs/`.
+ * A missing directory or unreadable file yields fewer rows, never an error.
+ */
+export function collectRunLogs(root, opts = {}) {
+  const stateDir = opts.stateDir ?? resolveRunnerStateDir();
+  const redact = typeof opts.redact === "function" ? opts.redact : (s) => s;
+  const max = opts.max ?? MAX_RUN_LOGS;
+  const dir = join(root, stateDir, "loop-logs");
+  let names;
+  try {
+    names = readdirSync(dir).filter((f) => LOG_NAME_RE.test(f));
+  } catch {
+    return [];
+  }
+  const files = [];
+  for (const name of names) {
+    try {
+      const st = statSync(join(dir, name));
+      if (st.isFile()) files.push({ name, mtimeMs: st.mtimeMs, size: st.size });
+    } catch {
+      // vanished between readdir and stat
+    }
+  }
+  files.sort((a, b) => b.mtimeMs - a.mtimeMs || (a.name < b.name ? 1 : -1));
+  const rows = [];
+  for (const f of files.slice(0, max)) {
+    try {
+      const summary = summarizeRunLog(readTail(join(dir, f.name), f.size), redact);
+      rows.push({
+        id: f.name,
+        kind: f.name.startsWith("tick-") ? "tick" : "run",
+        path: `${stateDir}/loop-logs/${f.name}`,
+        updatedAt: new Date(f.mtimeMs).toISOString(),
+        bytes: f.size,
+        source: "loop-logs",
+        ...summary,
+      });
+    } catch {
+      // unreadable log: skipped
+    }
+  }
+  return rows;
+}

package/dashboard/lib/semantic-model.mjs

@@ -2,10 +2,10 @@
 // Pure Mission Control view-model helpers (testable; no fs/git I/O).
 
 import { truncateStr } from "./guards.mjs";
-import { TRIAGE_HEADING_RE, hasTriageHeading } from "./triage-heading.mjs";
+import { hasTriageHeading, TRIAGE_HEADING_RE } from "./triage-heading.mjs";
 
 /** Durable triage heading SoT (shared with CLI `monitors --untriaged`). */
-export { TRIAGE_HEADING_RE, hasTriageHeading };
+export { hasTriageHeading, TRIAGE_HEADING_RE };
 
 export const MAX_ACTIVITY = 28;
 export const MAX_ATTENTION = 15;
@@ -1399,7 +1399,7 @@ export function normalizeHandoffGaps(raw) {
   if (!text) return null;
   if (/^(none|n\/a)$/i.test(text)) return null;
   // OK + pointer anti-pattern: "none. Residuals…", "None: …", "N/A - …", "none (…)"
-  if (/^(none|n\/a)\s*[.:,;\/(\-–—…]/i.test(text)) return null;
+  if (/^(none|n\/a)\s*[.:,;/(\-–—…]/i.test(text)) return null;
   // Empty residual placeholders
   if (/^([-–—.…]|empty|no gaps?|cleared|all clear|ok)$/i.test(text)) return null;
   return truncateStr(text, MAX_SEMANTIC_LABEL);
@@ -1426,6 +1426,7 @@ export function classifyFlightLogMessageKind(text, opts = {}) {
   const collapsed = text.replace(/\s+/g, " ").trim();
   if (!collapsed) return "ok";
   if (/^(none|n\/a)$/i.test(collapsed)) return "ok";
+  // biome-ignore lint/complexity/noUselessEscapeInRegex: byte parity with dashboard.html flightLogMessageKind (pinned by plugin-ux-validation.test.ts)
   if (/^(none|n\/a)\s*[.:,;\/(\-–—…]/i.test(collapsed)) return "ok";
   if (/^([-–—.…]|empty|no gaps?|cleared|all clear|ok)$/i.test(collapsed)) return "ok";
   if (

package/dashboard/serve.mjs

@@ -12,17 +12,17 @@ import { dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { shareShellTokenRequired } from "./lib/broadcast-share.mjs";
 import {
-  DEFAULT_HOST,
-  REPO_ROOT_ENV,
   allowlistConfig,
   applyCorsHeaders,
   authorizeMissionControlRequest,
   broadcastAuthCookieHeader,
+  DEFAULT_HOST,
   isAllowedHostHeader,
   isAllowedOrigin,
   isLoopbackAddress,
   listLanIPv4Addresses,
   mergeConfigAllowlist,
+  REPO_ROOT_ENV,
   resolveBroadcastAuth,
   resolveContextConfigPath,
   resolveDashboardStatic,
@@ -30,11 +30,11 @@ import {
   validateConfigWriteBody,
 } from "./lib/guards.mjs";
 import {
-  PERIODIC_REFRESH_MS,
-  WATCH_DEBOUNCE_MS,
   createTrailingDebounce,
+  PERIODIC_REFRESH_MS,
   resolveAgentTranscriptsWatchPath,
   resolveWatchPaths,
+  WATCH_DEBOUNCE_MS,
 } from "./lib/live-refresh.mjs";
 import { PIPELINE_CACHE_ENV, pipelineCacheJsonFromSnapshot } from "./lib/pipeline-cache.mjs";
 import { buildInventoryBaseline } from "./lib/semantic-model.mjs";

package/dashboard/start-broadcast.mjs

@@ -25,7 +25,6 @@ import {
 } from "./lib/broadcast-share.mjs";
 import {
   BROADCAST_TOKEN_ENV,
-  REPO_ROOT_ENV,
   describeBroadcastListener,
   escapePerlDoubleQuoted,
   generateBroadcastToken,
@@ -33,6 +32,7 @@ import {
   isValidBroadcastToken,
   listLanIPv4Addresses,
   normalizeAuthToken,
+  REPO_ROOT_ENV,
   repoRootLogId,
   resolveBindHost,
   resolveBroadcastPort,

package/dashboard/start.mjs

@@ -21,8 +21,8 @@ import { existsSync, openSync, realpathSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import {
-  REPO_ROOT_ENV,
   escapePerlDoubleQuoted,
+  REPO_ROOT_ENV,
   repoRootLogId,
   resolveContextConfigPath,
   resolveMissionControlPort,

package/dist/{add-HTYIFKMN.js → add-YTCDLPUS.js}

@@ -5,7 +5,7 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-PNG7LO2F.js";
+} from "./chunk-3DGTPONS.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
@@ -22,12 +22,12 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   upsertIdList
-} from "./chunk-AW74INUW.js";
-import "./chunk-5VCOWTTP.js";
+} from "./chunk-DBPNGZNH.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
-import "./chunk-77V75A7O.js";
+import "./chunk-C26I6HTO.js";
+import "./chunk-5B4DVO6C.js";
 
 // src/commands/add.ts
 import { defineCommand } from "citty";

package/dist/{chunk-SMGFN3Z4.js → chunk-2FQX2O4I.js}

@@ -2,17 +2,17 @@ import {
   contextConfigPath,
   intervalElapsed,
   loadContextConfig
-} from "./chunk-NQ7IQ5XT.js";
+} from "./chunk-PFEUZXVT.js";
 import {
   diffAgainstRegistry,
   summarizeDiff
-} from "./chunk-2RDRMGD3.js";
+} from "./chunk-BBVBYQJO.js";
 import {
   DEFAULT_REGISTRY_URL,
   assertSafeRegistrySource,
   loadAgentKitManifest,
   resolveRegistryRoot
-} from "./chunk-AW74INUW.js";
+} from "./chunk-DBPNGZNH.js";
 import {
   KIT_PACKAGE_SPEC,
   KIT_VERSION
@@ -20,7 +20,7 @@ import {
 import {
   readJson,
   writeJson
-} from "./chunk-77V75A7O.js";
+} from "./chunk-5B4DVO6C.js";
 
 // src/lifecycle/check-updates.ts
 import { execFile } from "child_process";

package/dist/{chunk-PNG7LO2F.js → chunk-3DGTPONS.js}

@@ -5,7 +5,7 @@ import {
   DEFAULT_REGISTRY_REF,
   DEFAULT_REGISTRY_URL,
   resolveRegistryRoot
-} from "./chunk-AW74INUW.js";
+} from "./chunk-DBPNGZNH.js";
 
 // src/lifecycle/resolve-cli.ts
 async function resolveRegistryFromCli(options) {

package/dist/{chunk-VY7MTPJ2.js → chunk-426GITN7.js}

@@ -1,7 +1,7 @@
 import {
   PUBLIC_INBOUND_REPO,
   detectFactoryCheckout
-} from "./chunk-2IPXQFJE.js";
+} from "./chunk-4CRBUEJ6.js";
 
 // src/lifecycle/remote-issues.ts
 import { execFile } from "child_process";

package/dist/{chunk-2IPXQFJE.js → chunk-4CRBUEJ6.js}

@@ -2,11 +2,11 @@ import {
   contextConfigPath,
   intervalElapsed,
   loadContextConfig
-} from "./chunk-NQ7IQ5XT.js";
+} from "./chunk-PFEUZXVT.js";
 import {
   fileExists,
   writeJson
-} from "./chunk-77V75A7O.js";
+} from "./chunk-5B4DVO6C.js";
 
 // src/lifecycle/public-inbound-radar.ts
 import { execFile } from "child_process";

package/dist/{chunk-STGFBAYT.js → chunk-4U7DLAQH.js}

@@ -5,7 +5,10 @@ import {
   RESOLVE_AGENT_KIT_REL,
   SESSION_START_HOOK_MARKER,
   discoverInstalledCommands
-} from "./chunk-W24CMQ32.js";
+} from "./chunk-PPKX55GI.js";
+import {
+  findOnPath
+} from "./chunk-WGLPZXNU.js";
 import {
   createReadinessReport
 } from "./chunk-PNFF6OU3.js";
@@ -15,21 +18,21 @@ import {
   REQUIRED_SECRET_PATTERNS,
   detectGitDirty,
   runScanner
-} from "./chunk-ZCTSUQRR.js";
+} from "./chunk-T6P5ZMG2.js";
 import {
   CONTEXT_CONFIG_REL,
   contextConfigPath
-} from "./chunk-NQ7IQ5XT.js";
+} from "./chunk-PFEUZXVT.js";
 import {
   ensureDir,
   fileExists,
   readJson,
   writeJson
-} from "./chunk-77V75A7O.js";
+} from "./chunk-5B4DVO6C.js";
 
 // src/invariants/hooks-health.ts
 import { execFile } from "child_process";
-import { constants, access, readFile, readdir, stat } from "fs/promises";
+import { access, constants, readdir, readFile, stat } from "fs/promises";
 import path from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
@@ -66,13 +69,7 @@ async function resolveAgentKitCli(rootDir) {
   for (const c of candidates) {
     if (await exists(c)) return c;
   }
-  try {
-    const { stdout } = await execFileAsync("which", ["agent-kit"], { encoding: "utf8" });
-    const hit = stdout.trim().split("\n")[0]?.trim();
-    if (hit) return hit;
-  } catch {
-  }
-  return null;
+  return findOnPath("agent-kit");
 }
 function commandLooksLikeAdapter(command) {
   const trimmed = command.trim();
@@ -176,13 +173,8 @@ async function resolveGuardProbeArgv(root) {
   if (await isExecutable(local)) return [local];
   const dist = path.join(root, "packages", "cli", "dist", "index.js");
   if (await exists(dist)) return [process.execPath, dist];
-  try {
-    const { stdout } = await execFileAsync("which", ["agent-kit"], { encoding: "utf8" });
-    const hit = stdout.trim().split("\n")[0]?.trim();
-    if (hit) return [hit];
-  } catch {
-  }
-  return null;
+  const hit = await findOnPath("agent-kit");
+  return hit ? [hit] : null;
 }
 async function assessClaudeGuardProbe(rootDir) {
   const root = path.resolve(rootDir);

package/dist/{chunk-77V75A7O.js → chunk-5B4DVO6C.js}

@@ -1,7 +1,7 @@
 // src/utils/fs.ts
 import { randomUUID } from "crypto";
 import { constants } from "fs";
-import { access, mkdir, readFile, readdir, rename, writeFile } from "fs/promises";
+import { access, mkdir, readdir, readFile, rename, writeFile } from "fs/promises";
 import path from "path";
 async function fileExists(target) {
   try {

package/dist/{chunk-4IWG5CVE.js → chunk-B3VR5YBQ.js}

@@ -1,8 +1,10 @@
 // src/readiness/env-checks.ts
-import { constants, access, readFile, realpath, stat } from "fs/promises";
+import { access, constants, readFile, realpath, stat } from "fs/promises";
 import { homedir } from "os";
 import path from "path";
-var MIN_NODE_MAJOR = 20;
+var MIN_NODE_MAJOR = 22;
+var MIN_NODE_MINOR = 12;
+var MIN_NODE_VERSION_LABEL = `${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}`;
 var CLI_PACKAGE_JSON_REL = path.join(
   "lib",
   "node_modules",
@@ -91,11 +93,13 @@ async function resolveBinOnPath(binName, env, platform) {
   }
   return null;
 }
-function isNodeVersionOk(nodeVersion, minMajor = MIN_NODE_MAJOR) {
-  const match = /^v?(\d+)/.exec(nodeVersion);
+function isNodeVersionOk(nodeVersion, minMajor = MIN_NODE_MAJOR, minMinor = minMajor === MIN_NODE_MAJOR ? MIN_NODE_MINOR : 0) {
+  const match = /^v?(\d+)(?:\.(\d+))?/.exec(nodeVersion);
   if (!match) return false;
   const major = Number(match[1]);
-  return Number.isFinite(major) && major >= minMajor;
+  const minor = match[2] === void 0 ? 0 : Number(match[2]);
+  if (!Number.isFinite(major) || !Number.isFinite(minor)) return false;
+  return major > minMajor || major === minMajor && minor >= minMinor;
 }
 function detectShellName(env, platform) {
   if (platform === "win32") {
@@ -210,5 +214,6 @@ async function assessEnvironment(options = {}) {
 }
 
 export {
+  MIN_NODE_VERSION_LABEL,
   assessEnvironment
 };