@foresthubai/workflow-cli 0.3.0 → 0.4.1

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/NOTICE CHANGED
@@ -17,7 +17,7 @@ source must be made available to users of that service — it is the
17
17
  repository linked above.
18
18
 
19
19
  It also bundles @foresthubai/workflow-core (Apache-2.0) and the
20
- third-party libraries ajv, ajv-formats, js-yaml, and jsep, each under
21
- its own license. See THIRD_PARTY_NOTICES in the repository.
20
+ third-party libraries ajv, ajv-formats, js-yaml, jsep, and zod, each
21
+ under its own license. See THIRD_PARTY_NOTICES in the repository.
22
22
 
23
23
  For commercial licensing inquiries: root@foresthub.ai
package/README.md CHANGED
@@ -27,6 +27,7 @@ fh-workflow open [file.json] [--static|--dev] Open the visual builder; optiona
27
27
  fh-workflow check-schema <file.json> Structural schema check against the contract. Non-zero on mismatch.
28
28
  fh-workflow validate <file.json> Semantic validation (references, wiring, types). Non-zero on errors.
29
29
  fh-workflow update <file.json> [out.json] Migrate a workflow to the current schema version.
30
+ fh-workflow deploy <file.json> [flags] Generate a self-contained deployment bundle. --help for flags.
30
31
  fh-workflow help | -h | --help Print usage.
31
32
  ```
32
33
 
@@ -67,6 +68,21 @@ Suitable for CI / pre-commit.
67
68
  Migrates a workflow document up to the current schema version, in place or to a
68
69
  second path.
69
70
 
71
+ ### `deploy <file.json> [flags]`
72
+
73
+ Generates a self-contained, **standalone** deployment bundle for an edge controller —
74
+ a directory the engine boots from directly, with no backend and no account. It always
75
+ holds `workflow.json`, `docker-compose.yml`, `.env` (operator config, written `0600`),
76
+ and a `README.md` with the build/transfer/run steps. Workflows that declare hardware,
77
+ MQTT, or custom models additionally get `device_manifest.json`, `external_resources.json`
78
+ (`0600`), and `deployment_mapping.json`.
79
+
80
+ Missing values are filled in **interactively** at a terminal. Without a terminal (a
81
+ Claude Code skill, CI), supply them through `--values <file.json>` — a partial deploy
82
+ config as JSON; any still-missing required value exits non-zero. LLM provider keys can
83
+ also be passed as flags (`--anthropic-key`, …). Run `fh-workflow deploy --help` for the
84
+ full flag list.
85
+
70
86
  ## In-repo development
71
87
 
72
88
  From `ts/workflow-cli` (resolves the libraries to **source**, so editing core/builder
@@ -94,7 +110,7 @@ FH_BUILDER_MODE=static npm run open -- sample.json
94
110
  | Script | Does |
95
111
  | --- | --- |
96
112
  | `dev` | `vite` — dev server, blank canvas, HMR |
97
- | `open` / `check-schema` / `validate` / `cli` | the dev CLI via `tsx` (`cli` = no preset subcommand) |
113
+ | `open` / `check-schema` / `validate` / `deploy` / `cli` | the dev CLI via `tsx` (`cli` = no preset subcommand) |
98
114
  | `build` | `vite build` — the SPA bundle → `dist/` |
99
115
  | `build:cli` | esbuild — the CLI bundle → `dist-cli/cli.js` (+ `workflow.yaml`) |
100
116
  | `build:all` | both of the above; the publishable artifacts |