@f-o-h/cli 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +43 -6
  2. package/dist/foh.js +830 -104
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,7 +4,7 @@ AI-operator provisioning CLI for Front Of House.
4
4
 
5
5
  Public mirror: https://github.com/iiko38/front-of-house-cli
6
6
 
7
- Current published baseline: `@f-o-h/cli@0.1.10`
7
+ Current published baseline: `@f-o-h/cli@0.1.12`
8
8
 
9
9
  This mirror is a generated release artifact. The private product monorepo is not
10
10
  published here, and no open-source license is granted unless stated separately.
@@ -104,11 +104,48 @@ foh eval external-agent run \
104
104
  --prompt-version blank-setup.v1
105
105
  ```
106
106
 
107
- The command writes a versioned prompt, launches an instrumented shell, captures
108
- FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
109
- `external_agent_run.v1` artifact when the shell exits.
110
-
111
- ## Local Scenario Suites
107
+ The command writes a versioned prompt, launches an instrumented shell, captures
108
+ FOH CLI commands into `commands.ndjson`, and finalizes `run.json` as an
109
+ `external_agent_run.v1` artifact when the shell exits.
110
+
111
+ For guarded programmable-runner planning:
112
+
113
+ ```bash
114
+ foh eval external-agent execute \
115
+ --runner codex \
116
+ --batch test-results/external-agent-runs/<batch>/batch.json \
117
+ --dry-run \
118
+ --json
119
+ ```
120
+
121
+ This writes `executor-plan.json`, creates intentionally empty clean workspaces
122
+ outside the private repo, validates the local Codex binary/help flags, and
123
+ prints exact `codex exec` commands without executing them.
124
+
125
+ Before promoting run artifacts, scan and redact them:
126
+
127
+ ```bash
128
+ foh eval external-agent scan-artifacts \
129
+ --run-dir test-results/external-agent-runs/<batch>/<run-id> \
130
+ --private-repo-root <private-repo-root> \
131
+ --write-redacted \
132
+ --json
133
+ ```
134
+
135
+ After dry-run review, one controlled Codex run can be launched explicitly with
136
+ `--live`. Live mode is intentionally limited to one run per batch and finalizes
137
+ `run.json` even on timeout or non-zero exit:
138
+
139
+ ```bash
140
+ foh eval external-agent execute \
141
+ --runner codex \
142
+ --batch test-results/external-agent-runs/<one-model-batch>/batch.json \
143
+ --timeout-minutes 30 \
144
+ --live \
145
+ --json
146
+ ```
147
+
148
+ ## Local Scenario Suites
112
149
 
113
150
  `foh test run --suite <file>` runs deterministic widget-runtime checks for a
114
151
  specific agent. The suite format supports reply text checks plus structured