@fabric-harness/cli 0.4.0 → 0.6.0

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.
package/README.md CHANGED
@@ -18,25 +18,31 @@ Provides two commands (aliases of each other):
18
18
  ## Quick start
19
19
 
20
20
  ```sh
21
+ fh init # scaffold a new .fabricharness/ workspace
22
+ npm install # install the deps the scaffolder declared
21
23
  fh agents # list workspace agents
22
- fh describe ask # show agent metadata + schema
23
- fh run ask --question "What is Temporal?" # one-shot run
24
+ fh describe hello # show agent metadata + schema
25
+ fh run hello --payload '{"name":"Ada"}' # one-shot run
24
26
  fh dev # watch mode — POST /agents/:name
25
27
  fh build --target node # build deployable artifact
26
28
  fh sessions # list persisted sessions
27
- fh inspect <session-id> # replay history
29
+ fh inspect <session-id> # session history snapshot
30
+ fh metrics <session-id> # tokens, tools, mounts, per-source bytes
28
31
  ```
29
32
 
30
33
  ## What's in the box
31
34
 
35
+ - **`fh init [--dir <path>] [--model <provider/model>] [--force]`** — scaffold `.fabricharness/` (sample agent, role, skill, config) plus `package.json`, `tsconfig.json`, `AGENTS.md`. Idempotent.
32
36
  - **`fh run / dev`** — local execution against any workspace agent.
33
- - **`fh build`** — emit deployable artifacts for `node`, `docker`, `temporal-worker`, `cloudflare`, `foundry-hosted-agent`.
37
+ - **`fh build`** — emit deployable artifacts for: `node`, `docker`, `temporal-worker`, `cloudflare`, `foundry-hosted-agent`, **`aks`** (Dockerfile + `k8s/` Deployment/Service manifests with health probes), **`aca`** (Dockerfile + `azure.yaml` + `infra/main.bicep` for `azd up`).
34
38
  - **`fh agents / describe`** — agent discovery and schema introspection.
35
- - **`fh sessions / inspect / logs / metrics / replay`** — session history operations.
39
+ - **`fh sessions / inspect / logs / metrics`** — session history operations. `fh metrics` reports tokens, tools, shells, **mounts** (count / files / bytes), and top tools / sources.
40
+ - **`fh replay <id> [--from <step-id>] [--limit <n>]`** — read-only active-path filter from a specific entry id.
36
41
  - **`fh approvals / approve / reject`** — capability-policy approval handling.
37
42
  - **`fh checkpoints / artifacts / artifact get`** — durable state inspection.
38
43
  - **`fh tasks / task / cancel-task`** — task tree management.
39
44
  - **`fh doctor`** — environment + model provider validation (`--live` to ping the model).
45
+ - **`fh temporal-worker`** — start a local Temporal worker with Fabric activities.
40
46
  - **`fh add`** — install connector recipes (sandbox, MCP, data).
41
47
  - **`fh verify-attestation / verify-provenance`** — supply-chain checks for built artifacts.
42
48