@tiangong-lca/cli 0.0.5 → 0.0.7

package/README.md

@@ -1,24 +1,47 @@
+---
+docType: guide
+scope: repo
+status: active
+authoritative: false
+owner: cli
+language: en
+whenToUse:
+  - when installing or invoking the TianGong LCA CLI
+  - when checking public command examples
+whenToUpdate:
+  - when the published CLI executable or invocation contract changes
+  - when user-facing command examples change
+checkPaths:
+  - README.md
+  - package.json
+  - bin/**
+  - src/cli.ts
+  - src/main.ts
+lastReviewedAt: 2026-05-08
+lastReviewedCommit: 06dbec3287513cf94c5d64c73bd467ed5347f40a
+---
+
 # TianGong LCA CLI
 
-Package: `@tiangong-lca/cli` Executable: `tiangong` Node: `24.x`
+Package: `@tiangong-lca/cli` Executable: `tiangong-lca` Node: `24.x`
 
 ## Run
 
 One-off published run:
 
 ```bash
-npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong --help
-npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong doctor
-npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong flow --help
+npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong-lca --help
+npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong-lca doctor
+npm exec --yes --package=@tiangong-lca/cli@latest -- tiangong-lca flow --help
 ```
 
 Install the published CLI:
 
 ```bash
 npm install --global @tiangong-lca/cli
-tiangong --help
-tiangong doctor
-tiangong flow --help
+tiangong-lca --help
+tiangong-lca doctor
+tiangong-lca flow --help
 ```
 
 Run from this repository:
@@ -26,7 +49,7 @@ Run from this repository:
 ```bash
 npm ci
 npm run build
-node ./bin/tiangong.js --help
+node ./bin/tiangong-lca.js --help
 ```
 
 ## Env
@@ -78,9 +101,9 @@ Minimal `search flow` request:
 Run:
 
 ```bash
-tiangong search flow --input ./search-flow.request.json --json
-tiangong search process --input ./search-process.request.json --json
-tiangong search lifecyclemodel --input ./search-lifecyclemodel.request.json --json
+tiangong-lca search flow --input ./search-flow.request.json --json
+tiangong-lca search process --input ./search-process.request.json --json
+tiangong-lca search lifecyclemodel --input ./search-lifecyclemodel.request.json --json
 ```
 
 Empty search results should be treated as empty whether the response is `[]` or `{"data":[]}`.
@@ -88,10 +111,10 @@ Empty search results should be treated as empty whether the response is `[]` or
 ## Read
 
 ```bash
-tiangong flow get --id <flow-id> --version <version> --json
-tiangong flow list --id <flow-id> --state-code 100 --limit 20 --json
-tiangong process get --id <process-id> --version <version> --json
-tiangong process list --state-code 100 --limit 20 --json
+tiangong-lca flow get --id <flow-id> --version <version> --json
+tiangong-lca flow list --id <flow-id> --state-code 100 --limit 20 --json
+tiangong-lca process get --id <process-id> --version <version> --json
+tiangong-lca process list --state-code 100 --limit 20 --json
 ```
 
 ## Real DB Flow Review
@@ -138,15 +161,15 @@ tiangong process list --state-code 100 --limit 20 --json
 Run:
 
 ```bash
-tiangong flow fetch-rows \
+tiangong-lca flow fetch-rows \
   --refs-file ./flow-refs.json \
   --out-dir ./flow-fetch
 
-tiangong review flow \
+tiangong-lca review flow \
   --rows-file ./flow-fetch/review-input-rows.jsonl \
   --out-dir ./flow-review
 
-tiangong flow materialize-decisions \
+tiangong-lca flow materialize-decisions \
   --decision-file ./approved-decisions.json \
   --flow-rows-file ./flow-fetch/review-input-rows.jsonl \
   --out-dir ./flow-decisions
@@ -170,29 +193,49 @@ Key `flow materialize-decisions` outputs:
 ## Other Common Commands
 
 ```bash
-tiangong review process --rows-file ./process-list-report.json --out-dir ./review
-tiangong review process --run-root ./artifacts/process_from_flow/<run_id> --run-id <run_id> --out-dir ./review
-tiangong publish run --input ./publish-request.json --dry-run
-tiangong doctor --json
+tiangong-lca process auto-build --input ./examples/process-auto-build.request.json --out-dir /abs/path/to/process-run --json
+tiangong-lca process resume-build --run-dir /abs/path/to/process-run --json
+tiangong-lca process publish-build --run-dir /abs/path/to/process-run --json
+tiangong-lca process batch-build --input ./examples/process-batch-build.request.json --out-dir /abs/path/to/process-batch --json
+tiangong-lca dataset validate --input ./rows.jsonl --type auto --out-dir /abs/path/to/dataset-validate --json
+tiangong-lca dataset references rewrite --input ./rows.jsonl --from flow:<old-id>@<old-version> --to flow:<new-id>@<new-version> --out-dir /abs/path/to/dataset-rewrite --json
+tiangong-lca lifecyclemodel auto-build --input ./examples/lifecyclemodel-auto-build.request.json --out-dir /abs/path/to/lifecyclemodel-run --json
+tiangong-lca lifecyclemodel validate-build --run-dir /abs/path/to/lifecyclemodel-run --json
+tiangong-lca lifecyclemodel publish-build --run-dir /abs/path/to/lifecyclemodel-run --json
+tiangong-lca lifecyclemodel save-draft --input ./lifecyclemodels.jsonl --out-dir /abs/path/to/lifecyclemodel-save-draft --dry-run --json
+tiangong-lca lifecyclemodel graph --input ./lifecyclemodels.jsonl --out-dir /abs/path/to/lifecyclemodel-graph --format all --json
+tiangong-lca lifecyclemodel orchestrate plan --input ./lifecyclemodel-orchestrate.request.json --out-dir /abs/path/to/lifecyclemodel-recursive-run --json
+tiangong-lca review process --rows-file ./process-list-report.json --out-dir ./review
+tiangong-lca review process --run-root /abs/path/to/process-run --run-id <run_id> --out-dir ./review
+tiangong-lca process save-draft --input ./patched-processes.jsonl --out-dir /abs/path/to/process-save-draft --dry-run --json
+tiangong-lca process save-draft --input ./patched-processes.jsonl --out-dir /abs/path/to/process-save-draft --commit --json
+tiangong-lca publish run --input ./publish-request.json --dry-run
+tiangong-lca doctor --json
 ```
 
 For `publish run`, relative `out_dir` values from either the request body or `--out-dir` are resolved against the request file directory, not the shell `cwd`. Use an absolute path when you want a fixed destination independent of the request file location.
 
-For `review process`, `--rows-file` accepts either raw process rows as JSON/JSONL or the full JSON report emitted by `tiangong process list --json`, as long as it contains a `rows` array.
+For `review process`, `--rows-file` accepts either raw process rows as JSON/JSONL or the full JSON report emitted by `tiangong-lca process list --json`, as long as it contains a `rows` array.
+
+For `process save-draft`, canonical process payloads are validated locally with `ProcessSchema` before any `--commit` write. Schema-invalid rows remain in `outputs/save-draft-rpc/failures.jsonl` instead of being persisted.
+
+For `lifecyclemodel save-draft`, canonical lifecyclemodel payloads are validated locally with `LifeCycleModelSchema` before any `--commit` write. Schema-invalid rows remain in `outputs/save-draft-bundle/failures.jsonl` instead of being persisted.
+
+For `dataset references rewrite`, `--commit` executes the state-aware save-draft path for patched process and lifecyclemodel rows; without `--commit`, the command only writes local rewrite artifacts.
 
 ## More Docs
 
 - `docs/IMPLEMENTATION_GUIDE_CN.md`: maintainer-facing command contract and implementation notes
-- `--help`: the canonical command surface for `tiangong`, `tiangong flow`, `tiangong review`, `tiangong process`, `tiangong lifecyclemodel`, and `tiangong publish`
+- `--help`: the canonical command surface for `tiangong-lca`, `tiangong-lca flow`, `tiangong-lca review`, `tiangong-lca process`, `tiangong-lca lifecyclemodel`, and `tiangong-lca publish`
 - `tiangong-lca-skills`: use the skill-specific `SKILL.md` and wrapper docs for agent workflows; the CLI README only covers the public invocation contract
 
 ## Help
 
 ```bash
-tiangong --help
-tiangong flow --help
-tiangong review --help
-tiangong process --help
-tiangong lifecyclemodel --help
-tiangong publish --help
+tiangong-lca --help
+tiangong-lca flow --help
+tiangong-lca review --help
+tiangong-lca process --help
+tiangong-lca lifecyclemodel --help
+tiangong-lca publish --help
 ```