@f-o-h/cli 0.1.8 → 0.1.9

package/README.md

@@ -1,175 +1,175 @@
-# Front Of House CLI
-
-AI-operator provisioning CLI for Front Of House.
-
-Public mirror: https://github.com/iiko38/front-of-house-cli
-
-Current published baseline: `@f-o-h/cli@0.1.8`
-
-This mirror is a generated release artifact. The private product monorepo is not
-published here, and no open-source license is granted unless stated separately.
-
-Package-local examples and schemas ship with the npm artifact:
-
-- `examples/scenario-suite.viewing.yml`
-- `examples/proof-report.example.json`
-- `examples/transcript-export.example.json`
-- `examples/improvement-packet.example.json`
-- `examples/external-agent-run.example.json`
-- `schemas/cli-envelope.schema.json`
-- `schemas/scenario-suite.schema.json`
-- `schemas/transcript-export.schema.json`
-- `schemas/improvement-packet.schema.json`
-- `schemas/external-agent-run.schema.json`
-
-## Install
-
-```bash
-npx @f-o-h/cli setup
-```
-
-Or install globally:
-
-```bash
-npm install -g @f-o-h/cli
-foh --help
-```
-
-Verify the package version:
-
-```bash
-npx @f-o-h/cli --version
-```
-
-## First Run
-
-```bash
-foh auth signup --web
-foh auth login --web
-foh auth login
-foh org list
-foh org use --org <org-id>
-foh setup
-foh prove --agent <agent-id> --json
-```
-
-For AI agents and text-only terminals:
-
-```bash
-foh auth signup --web --json
-foh auth login --web --json
-foh auth login --email "$FOH_EMAIL" --password "$FOH_PASSWORD" --json
-foh org list --json
-foh org use --org <org-id> --json
-foh setup --org <org-id> --agent-template <template-id> --agent-name "Demo Agent" --json
-foh prove --agent <agent-id> --json --out foh-proof.json
-foh test run --suite ./suite.yml --agent <agent-id> --json --out foh-test-report.json
-foh agent replay --file ./transcript-export.json --json
-foh bug improve --from-file foh-proof.json --out foh-improvement.json --json
-```
-
-`auth signup --web` opens the console signup page when possible and always
-prints the fallback URL. `auth login --web` starts browser device
-authorization, opens `/cli-auth`, waits for console approval, and stores the
-returned short-lived token. Credential auth remains available as fallback.
-
-`foh prove` produces a compact signed proof report across auth, org context,
-agent validation, contact phone readiness, voice provider health, widget
-channel/embed readiness, widget smoke, and simulation certification. It is
-read-only by default; pass `--mutation-mode ensure` or `--repair` only when you
-explicitly want proof to ensure missing widget state. Use `--strict` in
-automation when holds should fail the command, and `--mission voice` or
-`--require-phone` when a voice/contact number is mandatory for the demo.
-
-The CLI defaults to the production API at `https://api.frontofhouse.okii.uk`.
-
-## External-Agent Eval Capture
-
-Use this when testing whether a clean coding agent can start from public docs
-and the public npm package without private repo context:
-
-```bash
-foh eval external-agent run \
-  --model-provider openai \
-  --model-name codex \
-  --prompt-version blank-setup.v1
-```
-
-The command writes a versioned prompt, launches an instrumented shell, captures
-FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
-`external_agent_run.v1` artifact when the shell exits.
-
-## Local Scenario Suites
-
-`foh test run --suite <file>` runs deterministic widget-runtime checks for a
-specific agent. The suite format supports reply text checks plus structured
-runtime assertions for trace/correlation IDs, action or terminal state, latency,
-variables, tool calls, escalation/handoff, lead capture, and exact response
-field paths.
-
-```yaml
-agent: agent_123
-scenarios:
-  - id: viewing
-    turns:
-      - user: Can I book a viewing this week?
-        expect:
-          contains: viewing
-          trace_present: true
-          correlation_present: true
-          action: text
-          latency_ms:
-            max: 3000
-```
-
-Use transcript fixtures when turning real user conversations into regression
-tests:
-
-```yaml
-agent: agent_123
-scenarios:
-  - id: replay-viewing
-    fixture_transcript: ./fixtures/viewing-transcript.json
-```
-
-## Transcript Export
-
-Use hydrated transcript export to turn real behavior into replay/debug artifacts:
-
-```bash
-foh transcripts export \
-  --agent <agent-id> \
-  --hydrate \
-  --include-traces \
-  --format json \
-  --out foh-transcripts.json \
-  --json
-```
-
-Exports redact obvious emails, phone numbers, and secret-like tokens by default.
-Each exported conversation includes a `replay_command` and `test_fixture` seed
-so operators or AI agents can move from observed failure to replay or scenario
-regression without opening the console.
-
-Replay a local export without API access:
-
-```bash
-foh agent replay --file foh-transcripts.json --json
-```
-
-## Improvement Packets
-
-Use `foh bug improve` when a setup, proof, replay, knowledge, runtime, or
-live-proof failure should become actionable backlog/test/config/docs work:
-
-```bash
-foh bug improve \
-  --from-file test-results/proof-or-replay-failure.json \
-  --out test-results/improvement-packet.json \
-  --json
-```
-
-The command emits a redacted `foh_improvement_packet.v1` with stable IDs,
-reason code, promotion decision, evidence summary, and deterministic next
-commands.
+# Front Of House CLI
+
+AI-operator provisioning CLI for Front Of House.
+
+Public mirror: https://github.com/iiko38/front-of-house-cli
+
+Current published baseline: `@f-o-h/cli@0.1.9`
+
+This mirror is a generated release artifact. The private product monorepo is not
+published here, and no open-source license is granted unless stated separately.
+
+Package-local examples and schemas ship with the npm artifact:
+
+- `examples/scenario-suite.viewing.yml`
+- `examples/proof-report.example.json`
+- `examples/transcript-export.example.json`
+- `examples/improvement-packet.example.json`
+- `examples/external-agent-run.example.json`
+- `schemas/cli-envelope.schema.json`
+- `schemas/scenario-suite.schema.json`
+- `schemas/transcript-export.schema.json`
+- `schemas/improvement-packet.schema.json`
+- `schemas/external-agent-run.schema.json`
+
+## Install
+
+```bash
+npx @f-o-h/cli setup
+```
+
+Or install globally:
+
+```bash
+npm install -g @f-o-h/cli
+foh --help
+```
+
+Verify the package version:
+
+```bash
+npx @f-o-h/cli --version
+```
+
+## First Run
+
+```bash
+foh auth signup --web
+foh auth login --web
+foh auth login
+foh org list
+foh org use --org <org-id>
+foh setup
+foh prove --agent <agent-id> --json
+```
+
+For AI agents and text-only terminals:
+
+```bash
+foh auth signup --web --json
+foh auth login --web --json
+foh auth login --email "$FOH_EMAIL" --password "$FOH_PASSWORD" --json
+foh org list --json
+foh org use --org <org-id> --json
+foh setup --org <org-id> --agent-template <template-id> --agent-name "Demo Agent" --json
+foh prove --agent <agent-id> --json --out foh-proof.json
+foh test run --suite ./suite.yml --agent <agent-id> --json --out foh-test-report.json
+foh agent replay --file ./transcript-export.json --json
+foh bug improve --from-file foh-proof.json --out foh-improvement.json --json
+```
+
+`auth signup --web` opens the console signup page when possible and always
+prints the fallback URL. `auth login --web` starts browser device
+authorization, opens `/cli-auth`, waits for console approval, and stores the
+returned short-lived token. Credential auth remains available as fallback.
+
+`foh prove` produces a compact signed proof report across auth, org context,
+agent validation, contact phone readiness, voice provider health, widget
+channel/embed readiness, widget smoke, and simulation certification. It is
+read-only by default; pass `--mutation-mode ensure` or `--repair` only when you
+explicitly want proof to ensure missing widget state. Use `--strict` in
+automation when holds should fail the command, and `--mission voice` or
+`--require-phone` when a voice/contact number is mandatory for the demo.
+
+The CLI defaults to the production API at `https://api.frontofhouse.okii.uk`.
+
+## External-Agent Eval Capture
+
+Use this when testing whether a clean coding agent can start from public docs
+and the public npm package without private repo context:
+
+```bash
+foh eval external-agent run \
+  --model-provider openai \
+  --model-name codex \
+  --prompt-version blank-setup.v1
+```
+
+The command writes a versioned prompt, launches an instrumented shell, captures
+FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
+`external_agent_run.v1` artifact when the shell exits.
+
+## Local Scenario Suites
+
+`foh test run --suite <file>` runs deterministic widget-runtime checks for a
+specific agent. The suite format supports reply text checks plus structured
+runtime assertions for trace/correlation IDs, action or terminal state, latency,
+variables, tool calls, escalation/handoff, lead capture, and exact response
+field paths.
+
+```yaml
+agent: agent_123
+scenarios:
+  - id: viewing
+    turns:
+      - user: Can I book a viewing this week?
+        expect:
+          contains: viewing
+          trace_present: true
+          correlation_present: true
+          action: text
+          latency_ms:
+            max: 3000
+```
+
+Use transcript fixtures when turning real user conversations into regression
+tests:
+
+```yaml
+agent: agent_123
+scenarios:
+  - id: replay-viewing
+    fixture_transcript: ./fixtures/viewing-transcript.json
+```
+
+## Transcript Export
+
+Use hydrated transcript export to turn real behavior into replay/debug artifacts:
+
+```bash
+foh transcripts export \
+  --agent <agent-id> \
+  --hydrate \
+  --include-traces \
+  --format json \
+  --out foh-transcripts.json \
+  --json
+```
+
+Exports redact obvious emails, phone numbers, and secret-like tokens by default.
+Each exported conversation includes a `replay_command` and `test_fixture` seed
+so operators or AI agents can move from observed failure to replay or scenario
+regression without opening the console.
+
+Replay a local export without API access:
+
+```bash
+foh agent replay --file foh-transcripts.json --json
+```
+
+## Improvement Packets
+
+Use `foh bug improve` when a setup, proof, replay, knowledge, runtime, or
+live-proof failure should become actionable backlog/test/config/docs work:
+
+```bash
+foh bug improve \
+  --from-file test-results/proof-or-replay-failure.json \
+  --out test-results/improvement-packet.json \
+  --json
+```
+
+The command emits a redacted `foh_improvement_packet.v1` with stable IDs,
+reason code, promotion decision, evidence summary, and deterministic next
+commands.
 

package/dist/foh.js

@@ -32640,7 +32640,7 @@ var StdioServerTransport = class {
 };
 
 // src/lib/cli-version.ts
-var CLI_VERSION = "0.1.8";
+var CLI_VERSION = "0.1.9";
 
 // src/commands/mcp-serve.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -38267,6 +38267,12 @@ var SECRET_RE2 = /\b(?:Bearer\s+)?(?:sk|pk|xai|whsec|EAAN|ghp|gho|github_pat|npm
 function redactText(value) {
   return value.replace(SECRET_RE2, "[redacted_secret]");
 }
+function redactPath(value) {
+  let redacted = redactText(value);
+  const home = process.env.USERPROFILE || process.env.HOME;
+  if (home) redacted = redacted.replace(home, "~");
+  return redacted;
+}
 function safeJsonLine(value) {
   return JSON.stringify(value).replace(/\r?\n/g, " ") + "\n";
 }
@@ -38285,7 +38291,7 @@ function recordExternalAgentCliInvocation(input) {
       schema_version: "external_agent_cli_command.v1",
       recorded_at: (/* @__PURE__ */ new Date()).toISOString(),
       cli_version: input.cliVersion,
-      cwd: redactText(process.cwd()),
+      cwd: redactPath(process.cwd()),
       argv: args,
       command: args.join(" "),
       json_requested: args.includes("--json"),

package/package.json

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