@f-o-h/cli 0.1.6 → 0.1.7

package/dist/foh.js

@@ -32640,7 +32640,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.6";
+var CLI_VERSION = "0.1.7";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -36362,6 +36362,7 @@ var import_path8 = require("path");
 var import_fs9 = require("fs");
 var import_path7 = require("path");
 var IMPROVEMENT_SOURCE_TYPES = [
+  "external_agent_run",
   "setup_failure",
   "proof_failure",
   "replay_failure",
@@ -36373,6 +36374,8 @@ var IMPROVEMENT_DECISIONS = [
   "ignore",
   "fix_docs",
   "fix_config",
+  "fix_cli",
+  "fix_api",
   "fix_runtime",
   "add_test"
 ];
@@ -36408,6 +36411,7 @@ function parseEnum(raw, allowed, label) {
 function inferSourceType(artifact) {
   const schema2 = nonEmpty2(getPath2(artifact, "schema_version")) || "";
   const status = nonEmpty2(getPath2(artifact, "status")) || "";
+  if (schema2 === "external_agent_run.v1") return "external_agent_run";
   if (schema2.includes("knowledge_query") || nonEmpty2(getPath2(artifact, "failure_packet.schema_version"))?.includes("knowledge_query")) {
     return "knowledge_miss";
   }
@@ -36419,6 +36423,8 @@ function inferSourceType(artifact) {
 function inferReasonCode(artifact) {
   const direct = nonEmpty2(getPath2(artifact, "reason_code"));
   if (direct) return direct;
+  const failureReason = nonEmpty2(getPath2(artifact, "failure_reason_code"));
+  if (failureReason) return failureReason;
   const nested = nonEmpty2(getPath2(artifact, "failure_packet.reason_code"));
   if (nested) return nested;
   const checks = getPath2(artifact, "checks");
@@ -36432,6 +36438,7 @@ function inferReasonCode(artifact) {
   return nonEmpty2(getPath2(artifact, "status"));
 }
 function inferPromotionDecision(sourceType) {
+  if (sourceType === "external_agent_run") return "fix_docs";
   if (sourceType === "knowledge_miss") return "fix_docs";
   if (sourceType === "setup_failure" || sourceType === "proof_failure" || sourceType === "live_proof_failure") return "fix_config";
   if (sourceType === "replay_failure" || sourceType === "runtime_miss") return "add_test";
@@ -36473,6 +36480,9 @@ function defaultNextCommands(input) {
   if (input.sourceType === "knowledge_miss" && input.ids.agent_id) {
     commands.push(`foh knowledge query --agent ${input.ids.agent_id} --text "<question>" --explain --json`);
   }
+  if (input.sourceType === "external_agent_run" && input.sourceArtifactPath) {
+    commands.push(`foh bug improve --from external-agent-run --file ${input.sourceArtifactPath} --json`);
+  }
   if (input.sourceArtifactPath) {
     commands.push(`foh bug report --out test-results/bug-report.from-improvement.json --command "investigate ${input.reasonCode}" --request-url https://front-of-house-api.stldocs.app/api --response-status 500 --next-check "Review ${(0, import_path7.basename)(input.sourceArtifactPath)}" --json`);
   }
@@ -36835,18 +36845,20 @@ function registerBug(program3) {
       throw e;
     }
   });
-  bug.command("improve").description("Write a redacted failure-to-improvement packet from a setup/proof/replay/knowledge/runtime artifact").option("--from-file <path>", "Source JSON artifact to convert into an improvement packet").option("--out <path>", "Output JSON file path for improvement packet").option("--source-type <type>", "setup_failure|proof_failure|replay_failure|knowledge_miss|runtime_miss|live_proof_failure").option("--reason-code <code>", "Deterministic failure reason code").option("--recommendation <decision>", "ignore|fix_docs|fix_config|fix_runtime|add_test").option("--evidence-summary <text>", "Compact redacted evidence summary").option("--source-command <text>", "Command or operation that produced the source artifact").option("--org <id>", "Org ID for boundary check and packet IDs").option("--agent <id>", "Agent ID to attach").option("--conversation <id>", "Conversation ID to attach").option("--trace <id>", "Trace ID to attach").option("--correlation <id>", "Correlation ID to attach").option("--proof-artifact <path>", "Proof artifact path to attach").option(
+  bug.command("improve").description("Write a redacted failure-to-improvement packet from an external-agent/setup/proof/replay/knowledge/runtime artifact").option("--from <type>", "Source artifact type alias, for example external-agent-run").option("--file <path>", "Source JSON artifact alias for --from-file").option("--from-file <path>", "Source JSON artifact to convert into an improvement packet").option("--out <path>", "Output JSON file path for improvement packet").option("--source-type <type>", "external_agent_run|setup_failure|proof_failure|replay_failure|knowledge_miss|runtime_miss|live_proof_failure").option("--reason-code <code>", "Deterministic failure reason code").option("--recommendation <decision>", "ignore|fix_docs|fix_config|fix_cli|fix_api|fix_runtime|add_test").option("--evidence-summary <text>", "Compact redacted evidence summary").option("--source-command <text>", "Command or operation that produced the source artifact").option("--org <id>", "Org ID for boundary check and packet IDs").option("--agent <id>", "Agent ID to attach").option("--conversation <id>", "Conversation ID to attach").option("--trace <id>", "Trace ID to attach").option("--correlation <id>", "Correlation ID to attach").option("--proof-artifact <path>", "Proof artifact path to attach").option(
     "--next-command <text>",
     "Deterministic next command (repeat this flag for multiple commands)",
     (value, previous = []) => [...previous, value],
     []
   ).option("--json", "Output as JSON").action(async (opts) => withCommandErrorHandling(async () => {
-    const sourceArtifact = readSourceArtifact(opts.fromFile);
+    const sourcePath = opts.fromFile ?? opts.file;
+    const sourceType = opts.sourceType ?? (typeof opts.from === "string" ? opts.from.replaceAll("-", "_") : void 0);
+    const sourceArtifact = readSourceArtifact(sourcePath);
     const outPath = String(opts.out || defaultImprovementArtifactPath());
     const packet = buildImprovementPacket({
       sourceArtifact,
-      sourceArtifactPath: opts.fromFile,
-      sourceType: opts.sourceType,
+      sourceArtifactPath: sourcePath,
+      sourceType,
       reasonCode: opts.reasonCode,
       evidenceSummary: opts.evidenceSummary,
       promotionDecision: opts.recommendation,

package/examples/external-agent-run.example.json

@@ -0,0 +1,53 @@
+{
+  "schema_version": "external_agent_run.v1",
+  "run_id": "2026-05-04-codex-001",
+  "status": "fail",
+  "failure_reason_code": "docs_widget_proof_path_unclear",
+  "model_provider": "openai",
+  "model_name": "codex",
+  "agent_shell": "vscode-terminal",
+  "workspace_type": "clean-no-repo",
+  "prompt_version": "blank-setup.v1",
+  "prompt_path": "Docs/operations/external-agent-feedback-loop.md#blank-setupv1",
+  "started_at": "2026-05-04T09:00:00.000Z",
+  "ended_at": "2026-05-04T09:30:00.000Z",
+  "manual_intervention_count": 1,
+  "manual_interventions": [
+    {
+      "at": "2026-05-04T09:12:00.000Z",
+      "summary": "Human pointed the agent from generic docs to the CLI install guide."
+    }
+  ],
+  "environment": {
+    "os": "windows",
+    "node_version": "v24.11.1",
+    "npm_version": "10.x",
+    "foh_cli_version": "0.1.6"
+  },
+  "public_entrypoints": [
+    "https://frontofhouse.okii.uk",
+    "https://frontofhouse.okii.uk/llms.txt",
+    "npx --yes @f-o-h/cli@latest"
+  ],
+  "commands_run": [
+    "npx --yes @f-o-h/cli@latest --version",
+    "npx --yes @f-o-h/cli@latest setup --help",
+    "npx --yes @f-o-h/cli@latest prove --help"
+  ],
+  "docs_pages_used": [
+    "https://frontofhouse.okii.uk/guides/cli-install-and-upgrade",
+    "https://frontofhouse.okii.uk/guides/error-handling-and-debugging"
+  ],
+  "artifacts": {
+    "terminal_transcript": "terminal-transcript.txt",
+    "proof_bundle": null,
+    "replay_packet": null,
+    "knowledge_packet": null,
+    "improvement_packet": "improvement-packet.json",
+    "notes": "notes.md"
+  },
+  "summary": "Agent installed the CLI but could not identify the shortest widget proof path without human direction.",
+  "next_commands": [
+    "foh bug improve --from external-agent-run --file run.json --out improvement-packet.json --json"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f-o-h/cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "FOH CLI - AI-operator provisioning tool for Front Of House",
   "license": "UNLICENSED",
   "bin": {

package/schemas/external-agent-run.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://frontofhouse.okii.uk/schemas/external-agent-run.schema.json",
+  "title": "FOH External Agent Run",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "run_id",
+    "status",
+    "model_provider",
+    "model_name",
+    "prompt_version",
+    "started_at",
+    "manual_intervention_count",
+    "environment",
+    "public_entrypoints",
+    "commands_run",
+    "docs_pages_used",
+    "artifacts"
+  ],
+  "properties": {
+    "schema_version": { "const": "external_agent_run.v1" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "status": { "type": "string", "enum": ["pass", "hold", "fail"] },
+    "failure_reason_code": { "type": ["string", "null"] },
+    "model_provider": { "type": "string", "minLength": 1 },
+    "model_name": { "type": "string", "minLength": 1 },
+    "agent_shell": { "type": "string" },
+    "workspace_type": { "type": "string" },
+    "prompt_version": { "type": "string", "minLength": 1 },
+    "prompt_path": { "type": "string" },
+    "started_at": { "type": "string" },
+    "ended_at": { "type": ["string", "null"] },
+    "manual_intervention_count": { "type": "integer", "minimum": 0 },
+    "manual_interventions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "at": { "type": "string" },
+          "summary": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "environment": {
+      "type": "object",
+      "required": ["os", "foh_cli_version"],
+      "properties": {
+        "os": { "type": "string", "minLength": 1 },
+        "node_version": { "type": ["string", "null"] },
+        "npm_version": { "type": ["string", "null"] },
+        "foh_cli_version": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": true
+    },
+    "public_entrypoints": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "commands_run": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "docs_pages_used": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "artifacts": {
+      "type": "object",
+      "properties": {
+        "terminal_transcript": { "type": ["string", "null"] },
+        "proof_bundle": { "type": ["string", "null"] },
+        "replay_packet": { "type": ["string", "null"] },
+        "knowledge_packet": { "type": ["string", "null"] },
+        "improvement_packet": { "type": ["string", "null"] },
+        "notes": { "type": ["string", "null"] }
+      },
+      "additionalProperties": true
+    },
+    "summary": { "type": "string" },
+    "next_commands": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": true,
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "enum": ["hold", "fail"] } }, "required": ["status"] },
+      "then": { "required": ["failure_reason_code"] }
+    }
+  ]
+}

package/schemas/improvement-packet.schema.json

@@ -19,6 +19,7 @@
     "source_type": {
       "type": "string",
       "enum": [
+        "external_agent_run",
         "setup_failure",
         "proof_failure",
         "replay_failure",
@@ -30,7 +31,7 @@
     "reason_code": { "type": "string", "minLength": 1 },
     "promotion_decision": {
       "type": "string",
-      "enum": ["ignore", "fix_docs", "fix_config", "fix_runtime", "add_test"]
+      "enum": ["ignore", "fix_docs", "fix_config", "fix_cli", "fix_api", "fix_runtime", "add_test"]
     },
     "ids": {
       "type": "object",
@@ -74,3 +75,4 @@
   },
   "additionalProperties": false
 }
+