@f-o-h/cli 0.1.71 → 0.1.73

package/dist/foh.js

@@ -32790,7 +32790,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.71";
+var CLI_VERSION = "0.1.73";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -39593,9 +39593,11 @@ function ranked(map3) {
 function collectDocUrls(text) {
   return Array.from(new Set((String(text || "").match(DOC_URL_RE) || []).map((url2) => url2.replace(/[.?!:]+$/g, "")).filter((url2) => url2.startsWith("https://frontofhouse.okii.uk/")))).sort();
 }
-function findRunFiles(root) {
+function findRunCandidates(root) {
   if (!(0, import_fs16.existsSync)(root)) return [];
-  const files = [];
+  const candidates = [];
+  const seenRunDirs = /* @__PURE__ */ new Set();
+  const captureDirs = [];
   const stack = [root];
   while (stack.length > 0) {
     const current = stack.pop();
@@ -39605,11 +39607,18 @@ function findRunFiles(root) {
       if (entry.isDirectory()) {
         stack.push(absolute);
       } else if (entry.isFile() && entry.name === "run.json") {
-        files.push(absolute);
+        candidates.push({ path: absolute, synthetic: false });
+        seenRunDirs.add((0, import_path15.dirname)(absolute));
+      } else if (entry.isFile() && entry.name === "commands.ndjson") {
+        captureDirs.push(current);
       }
     }
   }
-  return files.sort();
+  for (const captureDir of captureDirs) {
+    if (seenRunDirs.has(captureDir)) continue;
+    candidates.push({ path: (0, import_path15.join)(captureDir, "run.json"), synthetic: true });
+  }
+  return candidates.sort((a, b) => a.path.localeCompare(b.path));
 }
 function validateExternalAgentRun(value) {
   const findings = [];
@@ -39642,6 +39651,90 @@ function runSortTime(run) {
   const time3 = Date.parse(raw);
   return Number.isFinite(time3) ? time3 : 0;
 }
+function latestCommandTime(commands) {
+  const times = commands.map((command) => String(command.completed_at || command.started_at || command.recorded_at || "")).map((raw) => ({ raw, time: Date.parse(raw) })).filter((entry) => Number.isFinite(entry.time)).sort((a, b) => b.time - a.time);
+  return times[0]?.raw ?? null;
+}
+function firstCommandTime(commands) {
+  const times = commands.map((command) => String(command.started_at || command.recorded_at || command.completed_at || "")).map((raw) => ({ raw, time: Date.parse(raw) })).filter((entry) => Number.isFinite(entry.time)).sort((a, b) => a.time - b.time);
+  return times[0]?.raw ?? null;
+}
+function commandReasonCodes(commands) {
+  const codes = /* @__PURE__ */ new Set();
+  for (const command of commands) {
+    if (command.reason_code) codes.add(String(command.reason_code));
+    for (const reasonCode of toArray2(command.check_reason_codes)) {
+      if (reasonCode) codes.add(String(reasonCode));
+    }
+  }
+  return Array.from(codes);
+}
+function syntheticStatusFromCommands(commands) {
+  const commandReasons = commandReasonCodes(commands);
+  const failed = commands.find((command) => {
+    const status = String(command.status || "").toLowerCase();
+    return status === "fail" || typeof command.exit_code === "number" && command.exit_code !== 0 && status !== "hold";
+  });
+  if (failed) {
+    return {
+      status: "fail",
+      reasonCode: String(failed.reason_code || commandReasons[0] || "external_agent_command_failed")
+    };
+  }
+  const held = commands.find((command) => String(command.status || "").toLowerCase() === "hold");
+  if (held) {
+    return {
+      status: "hold",
+      reasonCode: String(held.reason_code || commandReasons[0] || "external_agent_command_held")
+    };
+  }
+  if (commands.length === 0) {
+    return { status: "hold", reasonCode: "external_agent_capture_empty" };
+  }
+  return { status: "pass", reasonCode: null };
+}
+function synthesizeRunFromCapture(runPath) {
+  const runDir = (0, import_path15.dirname)(runPath);
+  const commands = collapseCommandRecords(readNdjson((0, import_path15.join)(runDir, "commands.ndjson")));
+  const metadata = asObject((0, import_fs16.existsSync)((0, import_path15.join)(runDir, "external-agent-metadata.json")) ? readJson((0, import_path15.join)(runDir, "external-agent-metadata.json")) : {});
+  const blockerCodes = toArray2(metadata?.blocker_reason_codes).map(String).filter(Boolean);
+  const commandClassification = syntheticStatusFromCommands(commands);
+  const status = commandClassification.status === "fail" ? "fail" : blockerCodes.length > 0 ? "hold" : commandClassification.status;
+  const reasonCode = commandClassification.status === "fail" ? commandClassification.reasonCode : blockerCodes[0] || commandClassification.reasonCode;
+  const firstCommand = commands[0] || {};
+  const startedAt = firstCommandTime(commands) || (/* @__PURE__ */ new Date(0)).toISOString();
+  const endedAt = latestCommandTime(commands) || startedAt;
+  const docs = toArray2(metadata?.docs_pages_used).map(String).filter(Boolean);
+  const runId = (0, import_path15.dirname)(runPath).split(/[\\/]/).filter(Boolean).slice(-3).join("-") || "capture-only-run";
+  return {
+    schema_version: "external_agent_run.v1",
+    run_id: runId,
+    status,
+    failure_reason_code: status === "pass" ? null : reasonCode || "external_agent_capture_unfinalized",
+    model_provider: "unknown",
+    model_name: "unknown",
+    prompt_version: String(firstCommand.prompt_version || "unknown"),
+    started_at: startedAt,
+    ended_at: endedAt,
+    manual_intervention_count: 0,
+    environment: {
+      foh_cli_version: firstCommand.cli_version || null,
+      capture_only: true
+    },
+    public_entrypoints: [
+      "https://frontofhouse.okii.uk",
+      "npx --yes @f-o-h/cli@latest"
+    ],
+    commands_run: commands.map((command) => String(command.command || "")).filter(Boolean),
+    docs_pages_used: docs,
+    artifacts: {
+      command_log: "commands.ndjson",
+      agent_metadata: (0, import_fs16.existsSync)((0, import_path15.join)(runDir, "external-agent-metadata.json")) ? "external-agent-metadata.json" : null,
+      capture_only: true
+    },
+    summary: "Synthetic run record created from external-agent capture artifacts because run.json was missing."
+  };
+}
 function cohortIdForRunPath(root, runPath) {
   const normalized = (0, import_path15.relative)(root, (0, import_path15.dirname)(runPath)).replaceAll("\\", "/");
   const parts = normalized.split("/").filter(Boolean);
@@ -39652,9 +39745,10 @@ function cohortIdForRunPath(root, runPath) {
 function readRunRecords(root, cwd) {
   const records = [];
   const invalid_runs = [];
-  for (const file2 of findRunFiles(root)) {
+  for (const candidate of findRunCandidates(root)) {
+    const file2 = candidate.path;
     try {
-      const parsed = readJson(file2);
+      const parsed = candidate.synthetic ? synthesizeRunFromCapture(file2) : readJson(file2);
       const findings = validateExternalAgentRun(parsed);
       if (findings.length > 0) {
         invalid_runs.push({ path: (0, import_path15.relative)(cwd, file2).replaceAll("\\", "/"), findings });
@@ -39813,7 +39907,7 @@ function summarizeExternalAgentRuns(options) {
     for (const page of toArray2(artifactSummary.docs_pages_observed)) increment(docsCounts, page);
   }
   const topFailures = ranked(failureCounts);
-  const commandReasonCodes = ranked(commandReasonCounts);
+  const commandReasonCodes2 = ranked(commandReasonCounts);
   const recommendedFixes = topFailures.map((failure) => ({
     reason_code: failure.key,
     count: failure.count,
@@ -39841,7 +39935,7 @@ function summarizeExternalAgentRuns(options) {
       missing_completion_count: missingCompletionCount,
       commands_with_duration_count: commandsWithDurationCount,
       total_command_duration_ms: totalCommandDurationMs,
-      command_reason_codes: commandReasonCodes,
+      command_reason_codes: commandReasonCodes2,
       slow_steps: slowSteps.sort((a, b) => Number(b.duration_ms || 0) - Number(a.duration_ms || 0) || String(a.command || "").localeCompare(String(b.command || ""))).slice(0, 20)
     },
     codex_telemetry: {
@@ -39915,11 +40009,11 @@ function classifyExternalAgentRun(input) {
   if (observedVersions.some((version2) => version2 !== CLI_VERSION)) {
     return { status: "hold", reasonCode: "external_agent_cli_version_drift" };
   }
-  const commandReasonCodes = completedCommands.flatMap((record2) => [
+  const commandReasonCodes2 = completedCommands.flatMap((record2) => [
     String(record2.reason_code || ""),
     ...Array.isArray(record2.check_reason_codes) ? record2.check_reason_codes.map((code) => String(code || "")) : []
   ]).filter(Boolean);
-  const hasCommandReason = (pattern) => commandReasonCodes.some((reason) => pattern.test(reason));
+  const hasCommandReason = (pattern) => commandReasonCodes2.some((reason) => pattern.test(reason));
   if (hasCommandReason(new RegExp(PAID_RESOURCE_BLOCKED_REASON_CODE, "i"))) {
     return { status: "hold", reasonCode: PAID_RESOURCE_BLOCKED_REASON_CODE };
   }

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@f-o-h/cli",
-  "version": "0.1.71",
-  "description": "FOH CLI - AI-operator provisioning tool for Front Of House",
-  "license": "UNLICENSED",
-  "bin": {
-    "foh": "dist/foh.js"
-  },
-  "main": "dist/foh.js",
-  "files": [
-    "dist/",
-    "examples/",
-    "schemas/",
-    "README.md",
-    "package.json"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "node build.mjs",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "commander": "^12.1.0",
-    "js-yaml": "^4.1.1",
-    "picocolors": "^1.1.1",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.0.0",
-    "esbuild": "^0.24.0",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "@f-o-h/cli",
+  "version": "0.1.73",
+  "description": "FOH CLI - AI-operator provisioning tool for Front Of House",
+  "license": "UNLICENSED",
+  "bin": {
+    "foh": "dist/foh.js"
+  },
+  "main": "dist/foh.js",
+  "files": [
+    "dist/",
+    "examples/",
+    "schemas/",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.1",
+    "picocolors": "^1.1.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "vitest": "^2.0.0"
+  }
+}