@tiangong-lca/cli 0.0.6 → 0.0.7

package/dist/src/cli.js

@@ -8,14 +8,20 @@ import { runLifecyclemodelBuildResultingProcess, } from './lib/lifecyclemodel-re
 import { runLifecyclemodelPublishResultingProcess, } from './lib/lifecyclemodel-publish-resulting-process.js';
 import { runLifecyclemodelValidateBuild, } from './lib/lifecyclemodel-validate-build.js';
 import { runLifecyclemodelPublishBuild, } from './lib/lifecyclemodel-publish-build.js';
+import { runLifecyclemodelSaveDraft, } from './lib/lifecyclemodel-save-draft-run.js';
+import { runLifecyclemodelGraph, } from './lib/lifecyclemodel-graph.js';
 import { runLifecyclemodelOrchestrate, } from './lib/lifecyclemodel-orchestrate.js';
 import { runProcessAutoBuild, } from './lib/process-auto-build.js';
 import { runProcessGet, } from './lib/process-get.js';
 import { runProcessList, } from './lib/process-list.js';
 import { runProcessBatchBuild, } from './lib/process-batch-build.js';
+import { runProcessScopeStatistics, } from './lib/process-scope-statistics.js';
+import { runProcessRefreshReferences, } from './lib/process-refresh-references.js';
+import { runProcessDedupReview, } from './lib/process-dedup-review.js';
 import { runProcessResumeBuild, } from './lib/process-resume-build.js';
 import { runProcessPublishBuild, } from './lib/process-publish-build.js';
 import { runProcessSaveDraft, } from './lib/process-save-draft-run.js';
+import { runProcessVerifyRows, } from './lib/process-verify-rows.js';
 import { runPublish } from './lib/publish.js';
 import { runProcessReview, } from './lib/review-process.js';
 import { runFlowReview, } from './lib/review-flow.js';
@@ -31,6 +37,8 @@ import { runFlowBuildAliasMap, } from './lib/flow-build-alias-map.js';
 import { runFlowApplyProcessFlowRepairs, runFlowPlanProcessFlowRepairs, runFlowRegenProduct, runFlowScanProcessFlowRefs, runFlowValidateProcesses, } from './lib/flow-regen-product.js';
 import { executeRemoteCommand, getRemoteCommandHelp } from './lib/remote.js';
 import { runValidation, } from './lib/validation.js';
+import { runDatasetValidate, } from './lib/dataset-validate.js';
+import { runDatasetReferencesRewrite, } from './lib/dataset-references-rewrite.js';
 function renderMainHelp(dotEnvStatus) {
     return `TianGong LCA CLI
 
@@ -43,15 +51,16 @@ Design principles:
   - file-first input and JSON-first output
 
 Usage:
-  tiangong <command> [subcommand] [options]
+  tiangong-lca <command> [subcommand] [options]
 
 Commands:
 Implemented Commands:
   doctor     show environment diagnostics
   search     flow | process | lifecyclemodel
-  process    get | list | auto-build | resume-build | publish-build | save-draft | batch-build
+  process    get | list | scope-statistics | dedup-review | auto-build | resume-build | publish-build | save-draft | batch-build | refresh-references | verify-rows
+  dataset    validate | references rewrite
   flow       get | list | fetch-rows | materialize-decisions | remediate | publish-version | publish-reviewed-data | build-alias-map | scan-process-flow-refs | plan-process-flow-repairs | apply-process-flow-repairs | regen-product | validate-processes
-  lifecyclemodel auto-build | validate-build | publish-build | build-resulting-process | publish-resulting-process | orchestrate
+  lifecyclemodel auto-build | validate-build | publish-build | save-draft | graph | build-resulting-process | publish-resulting-process | orchestrate
   review     process | flow | lifecyclemodel
   publish    run
   validation run
@@ -64,40 +73,48 @@ Planned Surface (not implemented yet):
 Planned commands currently print an explicit "not implemented yet" message and exit with code 2.
 
 Examples:
-  tiangong doctor
-  tiangong search flow --input ./request.json
-  tiangong search process --input ./request.json --dry-run
-  tiangong process get --id <process-id>
-  tiangong process list --state-code 100 --limit 20
-  tiangong process auto-build --input ./pff-request.json
-  tiangong process resume-build --run-id <id>
-  tiangong process publish-build --run-id <id>
-  tiangong process save-draft --input ./patched-processes.jsonl --dry-run
-  tiangong process batch-build --input ./batch-request.json
-  tiangong lifecyclemodel auto-build --input ./lifecyclemodel-auto-build.request.json
-  tiangong lifecyclemodel validate-build --run-dir ./artifacts/lifecyclemodel_auto_build/<run_id>
-  tiangong lifecyclemodel publish-build --run-dir ./artifacts/lifecyclemodel_auto_build/<run_id>
-  tiangong lifecyclemodel orchestrate plan --input ./lifecyclemodel-orchestrate.request.json --out-dir ./artifacts/lifecyclemodel_recursive/run-001
-  tiangong flow get --id <flow-id> --version <version>
-  tiangong flow list --id <flow-id> --state-code 100 --limit 20
-  tiangong flow fetch-rows --refs-file ./flow-refs.json --out-dir ./flow-fetch
-  tiangong flow materialize-decisions --decision-file ./approved-decisions.json --flow-rows-file ./review-input-rows.jsonl --out-dir ./flow-decisions
-  tiangong flow remediate --input-file ./invalid-flows.jsonl --out-dir ./flow-remediation
-  tiangong flow publish-version --input-file ./ready-flows.jsonl --out-dir ./flow-publish --commit
-  tiangong flow publish-reviewed-data --flow-rows-file ./reviewed-flows.jsonl --original-flow-rows-file ./original-flows.jsonl --out-dir ./flow-publish-review
-  tiangong flow build-alias-map --old-flow-file ./old-flows.jsonl --new-flow-file ./new-flows.jsonl --out-dir ./flow-alias-map
-  tiangong flow scan-process-flow-refs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-scan
-  tiangong flow plan-process-flow-repairs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-repair-plan
-  tiangong flow apply-process-flow-repairs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-repair-apply
-  tiangong flow regen-product --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-regeneration --apply
-  tiangong flow validate-processes --original-processes-file ./before.jsonl --patched-processes-file ./after.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-validation
-  tiangong review process --rows-file ./processes.jsonl --out-dir ./review
-  tiangong review process --run-root ./artifacts/process_from_flow/<run_id> --run-id <run_id> --out-dir ./review
-  tiangong review flow --rows-file ./flows.json --out-dir ./review
-  tiangong review lifecyclemodel --run-dir ./artifacts/lifecyclemodel_auto_build/<run_id> --out-dir ./lifecyclemodel-review
-  tiangong publish run --input ./publish-request.json --dry-run
-  tiangong validation run --input-dir ./package --engine auto
-  tiangong admin embedding-run --input ./jobs.json
+  tiangong-lca doctor
+  tiangong-lca search flow --input ./request.json
+  tiangong-lca search process --input ./request.json --dry-run
+  tiangong-lca process get --id <process-id>
+  tiangong-lca process list --state-code 100 --limit 20
+  tiangong-lca process scope-statistics --out-dir /abs/path/to/process-scope --state-code 0 --state-code 100
+  tiangong-lca process dedup-review --input ./duplicate-groups.json --out-dir /abs/path/to/process-dedup
+  tiangong-lca process auto-build --input ./pff-request.json --out-dir /abs/path/to/process-run
+  tiangong-lca process resume-build --run-dir /abs/path/to/process-run
+  tiangong-lca process publish-build --run-dir /abs/path/to/process-run
+  tiangong-lca process save-draft --input ./patched-processes.jsonl --out-dir /abs/path/to/process-save-draft --dry-run
+  tiangong-lca process batch-build --input ./batch-request.json --out-dir /abs/path/to/process-batch
+  tiangong-lca process refresh-references --out-dir /abs/path/to/process-refresh --dry-run
+  tiangong-lca process verify-rows --rows-file ./process-list-report.json --out-dir /abs/path/to/process-verify
+  tiangong-lca dataset validate --input ./rows.jsonl --type auto --out-dir /abs/path/to/dataset-validate
+  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
+  tiangong-lca lifecyclemodel auto-build --input ./lifecyclemodel-auto-build.request.json --out-dir /abs/path/to/lifecyclemodel-run
+  tiangong-lca lifecyclemodel validate-build --run-dir /abs/path/to/lifecyclemodel-run
+  tiangong-lca lifecyclemodel publish-build --run-dir /abs/path/to/lifecyclemodel-run
+  tiangong-lca lifecyclemodel save-draft --input ./lifecyclemodels.jsonl --out-dir /abs/path/to/lifecyclemodel-save-draft --dry-run
+  tiangong-lca lifecyclemodel graph --input ./lifecyclemodels.jsonl --out-dir /abs/path/to/lifecyclemodel-graph --format all
+  tiangong-lca lifecyclemodel orchestrate plan --input ./lifecyclemodel-orchestrate.request.json --out-dir /abs/path/to/lifecyclemodel-recursive-run
+  tiangong-lca flow get --id <flow-id> --version <version>
+  tiangong-lca flow list --id <flow-id> --state-code 100 --limit 20
+  tiangong-lca flow fetch-rows --refs-file ./flow-refs.json --out-dir ./flow-fetch
+  tiangong-lca flow materialize-decisions --decision-file ./approved-decisions.json --flow-rows-file ./review-input-rows.jsonl --out-dir ./flow-decisions
+  tiangong-lca flow remediate --input-file ./invalid-flows.jsonl --out-dir ./flow-remediation
+  tiangong-lca flow publish-version --input-file ./ready-flows.jsonl --out-dir ./flow-publish --commit
+  tiangong-lca flow publish-reviewed-data --flow-rows-file ./reviewed-flows.jsonl --original-flow-rows-file ./original-flows.jsonl --out-dir ./flow-publish-review
+  tiangong-lca flow build-alias-map --old-flow-file ./old-flows.jsonl --new-flow-file ./new-flows.jsonl --out-dir ./flow-alias-map
+  tiangong-lca flow scan-process-flow-refs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-scan
+  tiangong-lca flow plan-process-flow-repairs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-repair-plan
+  tiangong-lca flow apply-process-flow-repairs --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-repair-apply
+  tiangong-lca flow regen-product --processes-file ./processes.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-regeneration --apply
+  tiangong-lca flow validate-processes --original-processes-file ./before.jsonl --patched-processes-file ./after.jsonl --scope-flow-file ./flows.jsonl --out-dir ./flow-validation
+  tiangong-lca review process --rows-file ./processes.jsonl --out-dir ./review
+  tiangong-lca review process --run-root /abs/path/to/process-run --run-id <run_id> --out-dir ./review
+  tiangong-lca review flow --rows-file ./flows.json --out-dir ./review
+  tiangong-lca review lifecyclemodel --run-dir /abs/path/to/lifecyclemodel-run --out-dir ./lifecyclemodel-review
+  tiangong-lca publish run --input ./publish-request.json --dry-run
+  tiangong-lca validation run --input-dir ./package --engine auto
+  tiangong-lca admin embedding-run --input ./jobs.json
 
 Environment:
   .env loaded: ${dotEnvStatus.loaded ? `yes (${dotEnvStatus.path}, ${dotEnvStatus.count} keys)` : 'no'}
@@ -105,7 +122,7 @@ Environment:
 }
 function renderDoctorHelp() {
     return `Usage:
-  tiangong doctor [--json]
+  tiangong-lca doctor [--json]
 
 Options:
   --json    Print structured environment diagnostics
@@ -114,7 +131,7 @@ Options:
 }
 function renderSearchHelp() {
     return `Usage:
-  tiangong search <flow|process|lifecyclemodel> --input <file> [options]
+  tiangong-lca search <flow|process|lifecyclemodel> --input <file> [options]
 
 Options:
   --input <file>   JSON request file
@@ -139,7 +156,7 @@ Runtime note:
 }
 function renderAdminHelp() {
     return `Usage:
-  tiangong admin embedding-run --input <file> [options]
+  tiangong-lca admin embedding-run --input <file> [options]
 
 Options:
   --input <file>   JSON request file
@@ -162,7 +179,7 @@ Runtime note:
 }
 function renderPublishHelp() {
     return `Usage:
-  tiangong publish run --input <file> [options]
+  tiangong-lca publish run --input <file> [options]
 
 Options:
   --input <file>       JSON publish request file
@@ -178,7 +195,7 @@ Path rule:
 }
 function renderValidationHelp() {
     return `Usage:
-  tiangong validation run --input-dir <dir> [options]
+  tiangong-lca validation run --input-dir <dir> [options]
 
 Options:
   --input-dir <dir>    TIDAS package directory
@@ -188,9 +205,67 @@ Options:
   -h, --help
 `.trim();
 }
+function renderDatasetHelp() {
+    return `Usage:
+  tiangong-lca dataset <subcommand> [options]
+
+Implemented Subcommands:
+  validate             Validate local flow / process / lifecyclemodel rows with the TIDAS SDK
+  references rewrite   Rewrite flow references in local process and lifecyclemodel rows
+
+Examples:
+  tiangong-lca dataset validate --input ./rows.jsonl --type auto --out-dir ./dataset-validate --help
+  tiangong-lca dataset references rewrite --input ./rows.jsonl --from flow:<old-id>@<old-version> --to flow:<new-id>@<new-version> --out-dir ./dataset-rewrite --help
+`.trim();
+}
+function renderDatasetValidateHelp() {
+    return `Usage:
+  tiangong-lca dataset validate --input <file> [options]
+
+Options:
+  --input <file>   Local rows as JSON or JSONL; objects with rows[] are also accepted
+  --type <type>    auto | flow | process | lifecyclemodel (default: auto)
+  --out-dir <dir>  Optional artifact directory for validation report and row splits
+  --json           Print compact JSON
+  -h, --help
+
+Outputs written under --out-dir:
+  - outputs/validation-report.json
+  - outputs/valid-rows.jsonl
+  - outputs/invalid-rows.jsonl
+`.trim();
+}
+function renderDatasetReferencesHelp() {
+    return `Usage:
+  tiangong-lca dataset references rewrite --input <file> --from flow:<id>[@<version>] --to flow:<id>[@<version>] [options]
+
+Options:
+  --input <file>   Local rows as JSON or JSONL; process and lifecyclemodel rows are supported
+  --from <ref>     Source flow reference, for example flow:<old-id>@01.00.000
+  --to <ref>       Target flow reference, for example flow:<new-id>@01.01.000
+  --type <type>    Repeatable row type filter: process | lifecyclemodel (default: both)
+  --types <csv>    Comma-separated alias for one or more row types
+  --scope <label>  Optional artifact label for the already-frozen input scope
+  --out-dir <dir>  Artifact directory for rewrite plan and patched rows
+  --commit         Execute state-aware save-draft writes for patched rows
+  --dry-run        Keep the command local-only (default)
+  --json           Print compact JSON
+  -h, --help
+
+Environment:
+  none for local dry-run
+  TIANGONG_LCA_API_BASE_URL, TIANGONG_LCA_API_KEY, and TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
+  when --commit executes remote writes
+
+Outputs written under --out-dir:
+  - outputs/patched-rows.jsonl
+  - outputs/rewrite-plan.json
+  - outputs/summary.json
+`.trim();
+}
 function renderFlowHelp() {
     return `Usage:
-  tiangong flow <subcommand> [options]
+  tiangong-lca flow <subcommand> [options]
 
 Implemented Subcommands:
   get          Load one flow dataset by identifier through direct Supabase access
@@ -208,25 +283,25 @@ Implemented Subcommands:
   validate-processes Validate locally patched process rows against allowed flow-reference-only changes
 
 Examples:
-  tiangong flow --help
-  tiangong flow get --help
-  tiangong flow list --help
-  tiangong flow fetch-rows --help
-  tiangong flow materialize-decisions --help
-  tiangong flow remediate --help
-  tiangong flow publish-version --help
-  tiangong flow publish-reviewed-data --help
-  tiangong flow build-alias-map --help
-  tiangong flow scan-process-flow-refs --help
-  tiangong flow plan-process-flow-repairs --help
-  tiangong flow apply-process-flow-repairs --help
-  tiangong flow regen-product --help
-  tiangong flow validate-processes --help
+  tiangong-lca flow --help
+  tiangong-lca flow get --help
+  tiangong-lca flow list --help
+  tiangong-lca flow fetch-rows --help
+  tiangong-lca flow materialize-decisions --help
+  tiangong-lca flow remediate --help
+  tiangong-lca flow publish-version --help
+  tiangong-lca flow publish-reviewed-data --help
+  tiangong-lca flow build-alias-map --help
+  tiangong-lca flow scan-process-flow-refs --help
+  tiangong-lca flow plan-process-flow-repairs --help
+  tiangong-lca flow apply-process-flow-repairs --help
+  tiangong-lca flow regen-product --help
+  tiangong-lca flow validate-processes --help
 `.trim();
 }
 function renderFlowGetHelp() {
     return `Usage:
-  tiangong flow get --id <flow-id> [options]
+  tiangong-lca flow get --id <flow-id> [options]
 
 Options:
   --id <flow-id>        Flow UUID
@@ -248,7 +323,7 @@ Runtime note:
 }
 function renderFlowListHelp() {
     return `Usage:
-  tiangong flow list [options]
+  tiangong-lca flow list [options]
 
 Options:
   --id <flow-id>                  Repeatable exact flow UUID filter
@@ -276,7 +351,7 @@ Runtime note:
 }
 function renderFlowRemediateHelp() {
     return `Usage:
-  tiangong flow remediate --input-file <file> --out-dir <dir> [options]
+  tiangong-lca flow remediate --input-file <file> --out-dir <dir> [options]
 
 Options:
   --input-file <file>  Invalid flow rows as JSON or JSONL
@@ -295,7 +370,7 @@ Outputs written under --out-dir:
 }
 function renderFlowFetchRowsHelp() {
     return `Usage:
-  tiangong flow fetch-rows --refs-file <file> --out-dir <dir> [options]
+  tiangong-lca flow fetch-rows --refs-file <file> --out-dir <dir> [options]
 
 Options:
   --refs-file <file>         Flow refs as JSON or JSONL
@@ -320,7 +395,7 @@ Outputs written under --out-dir:
 }
 function renderFlowMaterializeDecisionsHelp() {
     return `Usage:
-  tiangong flow materialize-decisions --decision-file <file> --flow-rows-file <file> --out-dir <dir> [options]
+  tiangong-lca flow materialize-decisions --decision-file <file> --flow-rows-file <file> --out-dir <dir> [options]
 
 Options:
   --decision-file <file>     Approved cluster decisions as JSON or JSONL
@@ -339,7 +414,7 @@ Outputs written under --out-dir:
 }
 function renderFlowPublishVersionHelp() {
     return `Usage:
-  tiangong flow publish-version --input-file <file> --out-dir <dir> [options]
+  tiangong-lca flow publish-version --input-file <file> --out-dir <dir> [options]
 
 Options:
   --input-file <file>       Ready-for-publish flow rows as JSON or JSONL
@@ -365,7 +440,7 @@ Outputs written under --out-dir:
 }
 function renderFlowPublishReviewedDataHelp() {
     return `Usage:
-  tiangong flow publish-reviewed-data --out-dir <dir> [--flow-rows-file <file>] [--process-rows-file <file>] [options]
+  tiangong-lca flow publish-reviewed-data --out-dir <dir> [--flow-rows-file <file>] [--process-rows-file <file>] [options]
 
 Options:
   --flow-rows-file <file>           Reviewed flow rows as JSON or JSONL
@@ -400,7 +475,7 @@ Outputs written under --out-dir:
 }
 function renderFlowBuildAliasMapHelp() {
     return `Usage:
-  tiangong flow build-alias-map --old-flow-file <file> --new-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow build-alias-map --old-flow-file <file> --new-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --old-flow-file <file>          Repeatable pre-governance flow snapshot as JSON or JSONL
@@ -420,7 +495,7 @@ Outputs written under --out-dir:
 }
 function renderFlowScanProcessFlowRefsHelp() {
     return `Usage:
-  tiangong flow scan-process-flow-refs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow scan-process-flow-refs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --processes-file <file>         Process rows as JSON or JSONL
@@ -441,7 +516,7 @@ Outputs written under --out-dir:
 }
 function renderFlowPlanProcessFlowRepairsHelp() {
     return `Usage:
-  tiangong flow plan-process-flow-repairs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow plan-process-flow-repairs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --processes-file <file>         Process rows as JSON or JSONL
@@ -462,7 +537,7 @@ Outputs written under --out-dir:
 }
 function renderFlowApplyProcessFlowRepairsHelp() {
     return `Usage:
-  tiangong flow apply-process-flow-repairs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow apply-process-flow-repairs --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --processes-file <file>         Process rows as JSON or JSONL
@@ -486,7 +561,7 @@ Outputs written under --out-dir:
 }
 function renderFlowRegenProductHelp() {
     return `Usage:
-  tiangong flow regen-product --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow regen-product --processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --processes-file <file>         Process rows as JSON or JSONL
@@ -512,7 +587,7 @@ Outputs written under --out-dir:
 }
 function renderFlowValidateProcessesHelp() {
     return `Usage:
-  tiangong flow validate-processes --original-processes-file <file> --patched-processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
+  tiangong-lca flow validate-processes --original-processes-file <file> --patched-processes-file <file> --scope-flow-file <file> --out-dir <dir> [options]
 
 Options:
   --original-processes-file <file>  Original process rows before repair as JSON or JSONL
@@ -530,7 +605,7 @@ Outputs written under --out-dir:
 }
 function renderReviewHelp() {
     return `Usage:
-  tiangong review <subcommand> [options]
+  tiangong-lca review <subcommand> [options]
 
 Implemented Subcommands:
   process      Review process build runs or rows-file snapshots and emit artifact-first findings
@@ -538,15 +613,15 @@ Implemented Subcommands:
   lifecyclemodel Review one local lifecyclemodel build run and emit artifact-first findings
 
 Examples:
-  tiangong review --help
-  tiangong review process --help
-  tiangong review flow --help
-  tiangong review lifecyclemodel --help
+  tiangong-lca review --help
+  tiangong-lca review process --help
+  tiangong-lca review flow --help
+  tiangong-lca review lifecyclemodel --help
 `.trim();
 }
 function renderReviewProcessHelp() {
     return `Usage:
-  tiangong review process (--rows-file <file> | --run-root <dir>) --out-dir <dir> [options]
+  tiangong-lca review process (--rows-file <file> | --run-root <dir>) --out-dir <dir> [options]
 
 Options:
   --rows-file <file>        Process rows JSON/JSONL file; full process list reports with rows[] are also accepted
@@ -565,7 +640,7 @@ Options:
 }
 function renderReviewFlowHelp() {
     return `Usage:
-  tiangong review flow (--rows-file <file> | --flows-dir <dir> | --run-root <dir>) --out-dir <dir> [options]
+  tiangong-lca review flow (--rows-file <file> | --flows-dir <dir> | --run-root <dir>) --out-dir <dir> [options]
 
 Options:
   --rows-file <file>        Flow rows JSON / JSONL file; the CLI materializes review-input/flows automatically
@@ -588,7 +663,7 @@ Options:
 }
 function renderReviewLifecyclemodelHelp() {
     return `Usage:
-  tiangong review lifecyclemodel --run-dir <dir> --out-dir <dir> [options]
+  tiangong-lca review lifecyclemodel --run-dir <dir> --out-dir <dir> [options]
 
 Options:
   --run-dir <dir>          Existing lifecyclemodel auto-build run directory
@@ -607,7 +682,7 @@ This command:
 }
 function renderLifecyclemodelBuildResultingProcessHelp() {
     return `Usage:
-  tiangong lifecyclemodel build-resulting-process --input <file> [options]
+  tiangong-lca lifecyclemodel build-resulting-process --input <file> [options]
 
 Options:
   --input <file>     JSON request file
@@ -623,7 +698,7 @@ Remote lookup env (only when process_sources.allow_remote_lookup=true):
 }
 function renderLifecyclemodelPublishResultingProcessHelp() {
     return `Usage:
-  tiangong lifecyclemodel publish-resulting-process --run-dir <dir> [options]
+  tiangong-lca lifecyclemodel publish-resulting-process --run-dir <dir> [options]
 
 Options:
   --run-dir <dir>         Existing lifecyclemodel resulting-process run directory
@@ -633,30 +708,83 @@ Options:
   -h, --help
 `.trim();
 }
+function renderLifecyclemodelSaveDraftHelp() {
+    return `Usage:
+  tiangong-lca lifecyclemodel save-draft --input <file> [options]
+
+Options:
+  --input <file>     Lifecyclemodel rows JSON/JSONL file or publish-request.json
+  --out-dir <dir>    Run root written relative to cwd when a relative path is passed
+  --commit           Execute remote save-draft writes
+  --dry-run          Keep the command local-only (default)
+  --json             Print compact JSON
+  -h, --help
+
+Environment:
+  none for local dry-run
+  TIANGONG_LCA_API_BASE_URL, TIANGONG_LCA_API_KEY, and TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
+  when --commit executes remote writes
+
+Local gate:
+  canonical lifecyclemodel payloads are validated against LifeCycleModelSchema before any remote write;
+  schema-invalid rows stay in failures.jsonl instead of being committed
+
+Outputs written under --out-dir:
+  - inputs/normalized-input.json
+  - outputs/save-draft-bundle/selected-lifecyclemodels.jsonl
+  - outputs/save-draft-bundle/progress.jsonl
+  - outputs/save-draft-bundle/failures.jsonl
+  - outputs/save-draft-bundle/summary.json
+`.trim();
+}
+function renderLifecyclemodelGraphHelp() {
+    return `Usage:
+  tiangong-lca lifecyclemodel graph --input <file> [options]
+
+Options:
+  --input <file>          Lifecyclemodel rows JSON/JSONL file
+  --out-dir <dir>         Artifact directory for graph files and findings
+  --format <format>       json | dot | svg | all (default: all)
+  --check-connections     Fail when process-instance links are missing or unresolved
+  --json                  Print compact JSON
+  -h, --help
+
+Outputs written under --out-dir:
+  - outputs/graph-report.json
+  - outputs/findings.jsonl
+  - graphs/*.json
+  - graphs/*.dot
+  - graphs/*.svg
+`.trim();
+}
 function renderLifecyclemodelHelp() {
     return `Usage:
-  tiangong lifecyclemodel <subcommand> [options]
+  tiangong-lca lifecyclemodel <subcommand> [options]
 
 Implemented Subcommands:
   auto-build                Build native lifecyclemodel json_ordered artifacts from local process run exports
   validate-build            Re-run local validation on one lifecyclemodel build run
   publish-build             Prepare lifecyclemodel publish handoff artifacts from one local build run
+  save-draft                Save canonical lifecyclemodel datasets through the bundle save path
+  graph                     Derive lifecyclemodel graph artifacts and connection findings
   build-resulting-process   Deterministically aggregate a lifecycle model into a resulting process bundle
   publish-resulting-process Prepare publish-bundle.json and publish-intent.json from a prior resulting-process run
   orchestrate               Plan, execute, or publish a recursive lifecyclemodel assembly run
 
 Examples:
-  tiangong lifecyclemodel --help
-  tiangong lifecyclemodel auto-build --help
-  tiangong lifecyclemodel validate-build --help
-  tiangong lifecyclemodel publish-build --help
-  tiangong lifecyclemodel build-resulting-process --help
-  tiangong lifecyclemodel orchestrate --help
+  tiangong-lca lifecyclemodel --help
+  tiangong-lca lifecyclemodel auto-build --help
+  tiangong-lca lifecyclemodel validate-build --help
+  tiangong-lca lifecyclemodel publish-build --help
+  tiangong-lca lifecyclemodel save-draft --help
+  tiangong-lca lifecyclemodel graph --help
+  tiangong-lca lifecyclemodel build-resulting-process --help
+  tiangong-lca lifecyclemodel orchestrate --help
 `.trim();
 }
 function renderLifecyclemodelOrchestrateHelp() {
     return `Usage:
-  tiangong lifecyclemodel orchestrate <plan|execute|publish> [options]
+  tiangong-lca lifecyclemodel orchestrate <plan|execute|publish> [options]
 
 Plan / execute options:
   --input <file>                           JSON request file
@@ -682,11 +810,11 @@ This command:
 }
 function renderLifecyclemodelAutoBuildHelp() {
     return `Usage:
-  tiangong lifecyclemodel auto-build --input <file> [options]
+  tiangong-lca lifecyclemodel auto-build --input <file> [options]
 
 Options:
   --input <file>     JSON request file
-  --out-dir <dir>    Override the default lifecyclemodel build run root
+  --out-dir <dir>    Explicit run root; otherwise request.out_dir is required
   --json             Print compact JSON
   -h, --help
 
@@ -696,6 +824,7 @@ Minimal request contract:
   }
 
 This first CLI slice is local-only and read-only:
+  - applies no implicit repo-local ./artifacts fallback; callers must provide a run root
   - loads local process build run directories
   - infers the process graph from shared flow UUIDs
   - emits native lifecyclemodel json_ordered artifacts
@@ -704,7 +833,7 @@ This first CLI slice is local-only and read-only:
 }
 function renderLifecyclemodelValidateBuildHelp() {
     return `Usage:
-  tiangong lifecyclemodel validate-build --run-dir <dir> [options]
+  tiangong-lca lifecyclemodel validate-build --run-dir <dir> [options]
 
 Options:
   --run-dir <dir>    Existing lifecyclemodel auto-build run directory
@@ -720,7 +849,7 @@ This command:
 }
 function renderLifecyclemodelPublishBuildHelp() {
     return `Usage:
-  tiangong lifecyclemodel publish-build --run-dir <dir> [options]
+  tiangong-lca lifecyclemodel publish-build --run-dir <dir> [options]
 
 Options:
   --run-dir <dir>    Existing lifecyclemodel auto-build run directory
@@ -730,24 +859,26 @@ Options:
 This command:
   - collects native lifecyclemodel json_ordered payloads from one local build run
   - writes publish-bundle.json, publish-request.json, and publish-intent.json
-  - keeps actual dry-run / commit execution in tiangong publish run
+  - keeps actual dry-run / commit execution in tiangong-lca publish run
   - routes lifecyclemodel commit through save_lifecycle_model_bundle internally
 `.trim();
 }
 function renderProcessAutoBuildHelp() {
     return `Usage:
-  tiangong process auto-build --input <file> [options]
+  tiangong-lca process auto-build --input <file> [options]
 
 Options:
   --input <file>     JSON request file
-  --out-dir <dir>    Override the default run root directory
+  --out-dir <dir>    Explicit run root; otherwise request.workspace_run_root is required
   --json             Print compact JSON
   -h, --help
+
+This command applies no implicit repo-local ./artifacts fallback.
 `.trim();
 }
 function renderProcessGetHelp() {
     return `Usage:
-  tiangong process get --id <process-id> [options]
+  tiangong-lca process get --id <process-id> [options]
 
 Options:
   --id <process-id>    Process UUID
@@ -767,7 +898,7 @@ Runtime note:
 }
 function renderProcessListHelp() {
     return `Usage:
-  tiangong process list [options]
+  tiangong-lca process list [options]
 
 Options:
   --id <process-id>               Repeatable exact process UUID filter
@@ -792,31 +923,102 @@ Runtime note:
   and authenticates that client with the resolved user access token.
 `.trim();
 }
+function renderProcessScopeStatisticsHelp() {
+    return `Usage:
+  tiangong-lca process scope-statistics --out-dir <dir> [options]
+
+Options:
+  --out-dir <dir>          Artifact root to write inputs/outputs/reports
+  --scope <name>           visible | current-user (default: visible)
+  --state-code <code>      Repeatable non-negative integer state code filter
+  --state-codes <csv>      Comma-separated alias for one or more state codes
+  --page-size <n>          Remote page size (default: 200)
+  --reuse-snapshot         Reuse inputs/processes.snapshot.rows.jsonl instead of refetching
+  --json                   Print compact JSON
+  -h, --help
+
+Outputs written under --out-dir:
+  - inputs/processes.snapshot.manifest.json
+  - inputs/processes.snapshot.rows.jsonl
+  - outputs/process-scope-summary.json
+  - outputs/domain-summary.json
+  - outputs/craft-summary.json
+  - outputs/product-summary.json
+  - outputs/type-of-dataset-summary.json
+  - reports/process-scope-statistics.md
+  - reports/process-scope-statistics.zh-CN.md
+`.trim();
+}
+function renderProcessDedupReviewHelp() {
+    return `Usage:
+  tiangong-lca process dedup-review --input <file> --out-dir <dir> [options]
+
+Options:
+  --input <file>           Grouped duplicate-candidate JSON input
+  --out-dir <dir>          Artifact root to write inputs/outputs
+  --skip-remote            Skip optional TianGong remote enrichment and reference scans
+  --json                   Print compact JSON
+  -h, --help
+
+Input contract:
+  {
+    "source_label": "duplicate-processes-export",
+    "groups": [
+      {
+        "group_id": 1,
+        "processes": [
+          {
+            "process_id": "proc-1",
+            "version": "01.00.000",
+            "name_en": "Example",
+            "name_zh": "示例",
+            "sheet_exchange_rows": [
+              {
+                "flow_id": "flow-1",
+                "direction": "Input",
+                "mean_amount": "1",
+                "resulting_amount": "1"
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+
+Outputs written under --out-dir:
+  - inputs/dedup-input.manifest.json
+  - inputs/processes.remote-metadata.json (when remote enrichment succeeds)
+  - outputs/duplicate-groups.json
+  - outputs/delete-plan.json
+  - outputs/current-user-reference-scan.json (when reference scan succeeds)
+`.trim();
+}
 function renderProcessResumeBuildHelp() {
     return `Usage:
-  tiangong process resume-build [--run-id <id>] [--run-dir <dir>] [options]
+  tiangong-lca process resume-build --run-dir <dir> [options]
 
 Options:
-  --run-id <id>      Existing process build run id
   --run-dir <dir>    Existing process build run directory
+  --run-id <id>      Optional run id consistency check
   --json             Print compact JSON
   -h, --help
 `.trim();
 }
 function renderProcessPublishBuildHelp() {
     return `Usage:
-  tiangong process publish-build [--run-id <id>] [--run-dir <dir>] [options]
+  tiangong-lca process publish-build --run-dir <dir> [options]
 
 Options:
-  --run-id <id>      Existing process build run id
   --run-dir <dir>    Existing process build run directory
+  --run-id <id>      Optional run id consistency check
   --json             Print compact JSON
   -h, --help
 `.trim();
 }
 function renderProcessSaveDraftHelp() {
     return `Usage:
-  tiangong process save-draft --input <file> [options]
+  tiangong-lca process save-draft --input <file> [options]
 
 Options:
   --input <file>     Process rows JSON/JSONL file or publish-request.json
@@ -831,6 +1033,10 @@ Environment:
   TIANGONG_LCA_API_BASE_URL, TIANGONG_LCA_API_KEY, and TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
   when --commit executes remote writes
 
+Local gate:
+  canonical process payloads are validated against ProcessSchema before any remote write;
+  schema-invalid rows stay in failures.jsonl instead of being committed
+
 Outputs written under --out-dir:
   - inputs/normalized-input.json
   - outputs/save-draft-rpc/selected-processes.jsonl
@@ -839,39 +1045,99 @@ Outputs written under --out-dir:
   - outputs/save-draft-rpc/summary.json
 `.trim();
 }
+function renderProcessRefreshReferencesHelp() {
+    return `Usage:
+  tiangong-lca process refresh-references --out-dir <dir> [options]
+
+Options:
+  --out-dir <dir>      Artifact root for manifest, progress, blockers, and reports
+  --apply              Commit state-aware draft writes after local validation passes
+  --dry-run            Refresh references locally only (default)
+  --reuse-manifest     Reuse inputs/processes.manifest.json instead of refetching the owner snapshot
+  --limit <n>          Process at most n manifest rows
+  --page-size <n>      Snapshot page size (default: 500)
+  --concurrency <n>    Parallel row workers (default: 1, max: 8)
+  --json               Print compact JSON
+  -h, --help
+
+Required env:
+  TIANGONG_LCA_API_BASE_URL
+  TIANGONG_LCA_API_KEY
+  TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
+
+Guardrails:
+  - refresh only the current authenticated user's process snapshot
+  - skip rows with state_code >= 20 instead of forcing an unsupported write path
+  - block remote writes when ProcessSchema validation fails or references stay unresolved
+  - never requires raw SUPABASE_EMAIL / SUPABASE_PASSWORD in the skill layer
+
+Outputs written under --out-dir:
+  - inputs/processes.manifest.json
+  - outputs/progress.jsonl
+  - outputs/errors.jsonl
+  - outputs/validation-blockers.jsonl
+  - outputs/summary.json
+  - reports/process-refresh-references.md
+`.trim();
+}
+function renderProcessVerifyRowsHelp() {
+    return `Usage:
+  tiangong-lca process verify-rows --rows-file <file> --out-dir <dir> [options]
+
+Options:
+  --rows-file <file>   Raw process rows JSON/JSONL file; full process list reports with rows[] are also accepted
+  --out-dir <dir>      Output directory for summary and verification JSONL artifacts
+  --json               Print compact JSON
+  -h, --help
+
+Outputs written under --out-dir:
+  - outputs/summary.json
+  - outputs/verification.jsonl
+`.trim();
+}
 function renderProcessBatchBuildHelp() {
     return `Usage:
-  tiangong process batch-build --input <file> [options]
+  tiangong-lca process batch-build --input <file> [options]
 
 Options:
   --input <file>     JSON batch manifest file
-  --out-dir <dir>    Override the batch artifact output directory
+  --out-dir <dir>    Explicit batch root; otherwise request.out_dir is required
   --json             Print compact JSON
   -h, --help
+
+This command applies no implicit repo-local ./artifacts fallback.
 `.trim();
 }
 function renderProcessHelp() {
     return `Usage:
-  tiangong process <subcommand> [options]
+  tiangong-lca process <subcommand> [options]
 
 Implemented Subcommands:
   get          Load one process dataset by identifier through direct Supabase access
   list         List visible process rows through direct Supabase access
+  scope-statistics Count repeatable coverage statistics from visible or owner-filtered process snapshots
+  dedup-review Review grouped duplicate process candidates and emit keep/delete evidence
   auto-build   Prepare a local process-from-flow run scaffold and artifact workspace
   resume-build Prepare a local resume handoff from one existing process build run
   publish-build Prepare publish handoff artifacts from one existing process build run
   save-draft   Save canonical process datasets through the state-aware draft-maintenance path
   batch-build  Run multiple process auto-build requests through one batch-oriented CLI surface
+  refresh-references Refresh current-user process references to the latest reachable dataset versions
+  verify-rows  Re-validate fetched process rows and required naming fields locally
 
 Examples:
-  tiangong process --help
-  tiangong process get --id <process-id>
-  tiangong process list --state-code 100 --limit 20 --help
-  tiangong process auto-build --help
-  tiangong process resume-build --run-id <id> --help
-  tiangong process publish-build --run-id <id> --help
-  tiangong process save-draft --input ./patched-processes.jsonl --help
-  tiangong process batch-build --input ./batch-request.json --help
+  tiangong-lca process --help
+  tiangong-lca process get --id <process-id>
+  tiangong-lca process list --state-code 100 --limit 20 --help
+  tiangong-lca process scope-statistics --out-dir ./process-scope --state-code 0 --state-code 100 --help
+  tiangong-lca process dedup-review --input ./duplicate-groups.json --out-dir ./process-dedup --help
+  tiangong-lca process auto-build --help
+  tiangong-lca process resume-build --run-dir /abs/path/to/process-run --help
+  tiangong-lca process publish-build --run-dir /abs/path/to/process-run --help
+  tiangong-lca process save-draft --input ./patched-processes.jsonl --help
+  tiangong-lca process batch-build --input ./batch-request.json --help
+  tiangong-lca process refresh-references --out-dir ./process-refresh --help
+  tiangong-lca process verify-rows --rows-file ./process-list-report.json --out-dir ./process-verify --help
 `.trim();
 }
 function renderDoctorText(report) {
@@ -1079,6 +1345,89 @@ function parseValidationFlags(args) {
         reportFile: typeof values['report-file'] === 'string' ? values['report-file'] : null,
     };
 }
+function parseDatasetValidateFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                input: { type: 'string' },
+                type: { type: 'string' },
+                'out-dir': { type: 'string' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        inputPath: typeof values.input === 'string' ? values.input : '',
+        type: typeof values.type === 'string' ? values.type : undefined,
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : null,
+    };
+}
+function parseDatasetReferencesRewriteFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                input: { type: 'string' },
+                from: { type: 'string' },
+                to: { type: 'string' },
+                type: { type: 'string', multiple: true },
+                types: { type: 'string', multiple: true },
+                scope: { type: 'string' },
+                'out-dir': { type: 'string' },
+                commit: { type: 'boolean' },
+                'dry-run': { type: 'boolean' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    if (values.commit && values['dry-run']) {
+        throw new CliError('Cannot pass both --commit and --dry-run.', {
+            code: 'DATASET_REFERENCES_REWRITE_MODE_CONFLICT',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        inputPath: typeof values.input === 'string' ? values.input : '',
+        from: typeof values.from === 'string' ? values.from : '',
+        to: typeof values.to === 'string' ? values.to : '',
+        types: [
+            ...(Array.isArray(values.type)
+                ? values.type.filter((value) => typeof value === 'string')
+                : []),
+            ...(Array.isArray(values.types)
+                ? values.types.filter((value) => typeof value === 'string')
+                : []),
+        ],
+        scope: typeof values.scope === 'string' ? values.scope : null,
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        commit: Boolean(values.commit),
+    };
+}
 function parseFlowRemediateFlags(args) {
     let values;
     try {
@@ -1998,6 +2347,75 @@ function parseLifecyclemodelPublishBuildFlags(args) {
         runDir: typeof values['run-dir'] === 'string' ? values['run-dir'] : '',
     };
 }
+function parseLifecyclemodelSaveDraftFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                input: { type: 'string' },
+                'out-dir': { type: 'string' },
+                commit: { type: 'boolean' },
+                'dry-run': { type: 'boolean' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    if (values.commit && values['dry-run']) {
+        throw new CliError('Cannot pass both --commit and --dry-run.', {
+            code: 'INVALID_LIFECYCLEMODEL_SAVE_DRAFT_MODE',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        inputPath: typeof values.input === 'string' ? values.input : '',
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : null,
+        commit: Boolean(values.commit),
+    };
+}
+function parseLifecyclemodelGraphFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                input: { type: 'string' },
+                'out-dir': { type: 'string' },
+                format: { type: 'string' },
+                'check-connections': { type: 'boolean' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        inputPath: typeof values.input === 'string' ? values.input : '',
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        format: typeof values.format === 'string' ? values.format : undefined,
+        checkConnections: Boolean(values['check-connections']),
+    };
+}
 function parseLifecyclemodelBuildFlags(args) {
     let values;
     try {
@@ -2214,6 +2632,111 @@ function parseProcessListFlags(args) {
         order: typeof values.order === 'string' ? values.order : null,
     };
 }
+function parseProcessScopeStatisticsFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                'out-dir': { type: 'string' },
+                scope: { type: 'string' },
+                'state-code': { type: 'string', multiple: true },
+                'state-codes': { type: 'string' },
+                'page-size': { type: 'string' },
+                'reuse-snapshot': { type: 'boolean' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    const parseStateCode = (value) => {
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isInteger(parsed) || parsed < 0) {
+            throw new CliError('Expected --state-code to be a non-negative integer.', {
+                code: 'INVALID_PROCESS_SCOPE_STATE_CODE',
+                exitCode: 2,
+            });
+        }
+        return parsed;
+    };
+    const stateCodes = [
+        ...(Array.isArray(values['state-code'])
+            ? values['state-code'].map((value) => parseStateCode(String(value)))
+            : []),
+        ...(typeof values['state-codes'] === 'string' ? values['state-codes'].split(',') : [])
+            .map((value) => value.trim())
+            .filter(Boolean)
+            .map((value) => parseStateCode(value)),
+    ];
+    let pageSize = null;
+    if (typeof values['page-size'] === 'string') {
+        const parsed = Number.parseInt(values['page-size'], 10);
+        if (!Number.isInteger(parsed) || parsed <= 0) {
+            throw new CliError('Expected --page-size to be a positive integer.', {
+                code: 'INVALID_PROCESS_SCOPE_PAGE_SIZE',
+                exitCode: 2,
+            });
+        }
+        pageSize = parsed;
+    }
+    let scope;
+    if (typeof values.scope === 'string') {
+        if (values.scope !== 'visible' && values.scope !== 'current-user') {
+            throw new CliError("Expected --scope to be either 'visible' or 'current-user'.", {
+                code: 'INVALID_PROCESS_SCOPE_SCOPE',
+                exitCode: 2,
+            });
+        }
+        scope = values.scope;
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        scope,
+        stateCodes,
+        pageSize,
+        reuseSnapshot: Boolean(values['reuse-snapshot']),
+    };
+}
+function parseProcessDedupReviewFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                input: { type: 'string' },
+                'out-dir': { type: 'string' },
+                'skip-remote': { type: 'boolean' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        inputPath: typeof values.input === 'string' ? values.input : '',
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        skipRemote: Boolean(values['skip-remote']),
+    };
+}
 function parseProcessResumeBuildFlags(args) {
     let values;
     try {
@@ -2307,6 +2830,90 @@ function parseProcessSaveDraftFlags(args) {
         commit: Boolean(values.commit),
     };
 }
+function parseProcessRefreshReferencesFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                'out-dir': { type: 'string' },
+                apply: { type: 'boolean' },
+                'dry-run': { type: 'boolean' },
+                'reuse-manifest': { type: 'boolean' },
+                limit: { type: 'string' },
+                'page-size': { type: 'string' },
+                concurrency: { type: 'string' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    if (values.apply && values['dry-run']) {
+        throw new CliError('Cannot pass both --apply and --dry-run.', {
+            code: 'PROCESS_REFRESH_MODE_CONFLICT',
+            exitCode: 2,
+        });
+    }
+    const parseOptionalPositiveIntegerFlag = (value, label, code) => {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isInteger(parsed) || parsed <= 0) {
+            throw new CliError(`Expected ${label} to be a positive integer.`, {
+                code,
+                exitCode: 2,
+            });
+        }
+        return parsed;
+    };
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        apply: Boolean(values.apply),
+        reuseManifest: Boolean(values['reuse-manifest']),
+        limit: parseOptionalPositiveIntegerFlag(values.limit, '--limit', 'INVALID_PROCESS_REFRESH_LIMIT'),
+        pageSize: parseOptionalPositiveIntegerFlag(values['page-size'], '--page-size', 'INVALID_PROCESS_REFRESH_PAGE_SIZE'),
+        concurrency: parseOptionalPositiveIntegerFlag(values.concurrency, '--concurrency', 'INVALID_PROCESS_REFRESH_CONCURRENCY'),
+    };
+}
+function parseProcessVerifyRowsFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                'rows-file': { type: 'string' },
+                'out-dir': { type: 'string' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        rowsFile: typeof values['rows-file'] === 'string' ? values['rows-file'] : '',
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+    };
+}
 function parseProcessBatchBuildFlags(args) {
     let values;
     try {
@@ -2362,14 +2969,20 @@ export async function executeCli(argv, deps) {
         const lifecyclemodelPublishImpl = deps.runLifecyclemodelPublishResultingProcessImpl ?? runLifecyclemodelPublishResultingProcess;
         const lifecyclemodelValidateImpl = deps.runLifecyclemodelValidateBuildImpl ?? runLifecyclemodelValidateBuild;
         const lifecyclemodelPublishBuildImpl = deps.runLifecyclemodelPublishBuildImpl ?? runLifecyclemodelPublishBuild;
+        const lifecyclemodelSaveDraftImpl = deps.runLifecyclemodelSaveDraftImpl ?? runLifecyclemodelSaveDraft;
+        const lifecyclemodelGraphImpl = deps.runLifecyclemodelGraphImpl ?? runLifecyclemodelGraph;
         const lifecyclemodelOrchestrateImpl = deps.runLifecyclemodelOrchestrateImpl ?? runLifecyclemodelOrchestrate;
         const processGetImpl = deps.runProcessGetImpl ?? runProcessGet;
         const processListImpl = deps.runProcessListImpl ?? runProcessList;
         const processAutoBuildImpl = deps.runProcessAutoBuildImpl ?? runProcessAutoBuild;
         const processBatchBuildImpl = deps.runProcessBatchBuildImpl ?? runProcessBatchBuild;
+        const processScopeStatisticsImpl = deps.runProcessScopeStatisticsImpl ?? runProcessScopeStatistics;
+        const processRefreshReferencesImpl = deps.runProcessRefreshReferencesImpl ?? runProcessRefreshReferences;
+        const processDedupReviewImpl = deps.runProcessDedupReviewImpl ?? runProcessDedupReview;
         const processResumeBuildImpl = deps.runProcessResumeBuildImpl ?? runProcessResumeBuild;
         const processPublishBuildImpl = deps.runProcessPublishBuildImpl ?? runProcessPublishBuild;
         const processSaveDraftImpl = deps.runProcessSaveDraftImpl ?? runProcessSaveDraft;
+        const processVerifyRowsImpl = deps.runProcessVerifyRowsImpl ?? runProcessVerifyRows;
         const processReviewImpl = deps.runProcessReviewImpl ?? runProcessReview;
         const flowReviewImpl = deps.runFlowReviewImpl ?? runFlowReview;
         const lifecyclemodelReviewImpl = deps.runLifecyclemodelReviewImpl ?? runLifecyclemodelReview;
@@ -2386,6 +2999,8 @@ export async function executeCli(argv, deps) {
         const flowApplyProcessFlowRepairsImpl = deps.runFlowApplyProcessFlowRepairsImpl ?? runFlowApplyProcessFlowRepairs;
         const flowRegenProductImpl = deps.runFlowRegenProductImpl ?? runFlowRegenProduct;
         const flowValidateProcessesImpl = deps.runFlowValidateProcessesImpl ?? runFlowValidateProcesses;
+        const datasetValidateImpl = deps.runDatasetValidateImpl ?? runDatasetValidate;
+        const datasetReferencesRewriteImpl = deps.runDatasetReferencesRewriteImpl ?? runDatasetReferencesRewrite;
         if (flags.version) {
             return { exitCode: 0, stdout: `${loadCliPackageVersion(import.meta.url)}\n`, stderr: '' };
         }
@@ -2428,6 +3043,57 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'dataset' && !subcommand) {
+            return { exitCode: 0, stdout: `${renderDatasetHelp()}\n`, stderr: '' };
+        }
+        if (command === 'dataset' && subcommand === 'validate') {
+            const datasetFlags = parseDatasetValidateFlags(commandArgs);
+            if (datasetFlags.help) {
+                return { exitCode: 0, stdout: `${renderDatasetValidateHelp()}\n`, stderr: '' };
+            }
+            const report = await datasetValidateImpl({
+                inputPath: datasetFlags.inputPath,
+                type: datasetFlags.type,
+                outDir: datasetFlags.outDir,
+            });
+            return {
+                exitCode: report.counts.invalid > 0 ? 1 : 0,
+                stdout: stringifyJson(report, datasetFlags.json),
+                stderr: '',
+            };
+        }
+        if (command === 'dataset' && subcommand === 'references') {
+            const action = commandArgs[0] ?? '';
+            if (!action || action === '--help' || action === '-h') {
+                return { exitCode: 0, stdout: `${renderDatasetReferencesHelp()}\n`, stderr: '' };
+            }
+            if (action !== 'rewrite') {
+                throw new CliError("dataset references action must be 'rewrite'.", {
+                    code: 'INVALID_ARGS',
+                    exitCode: 2,
+                });
+            }
+            const datasetFlags = parseDatasetReferencesRewriteFlags(commandArgs.slice(1));
+            if (datasetFlags.help) {
+                return { exitCode: 0, stdout: `${renderDatasetReferencesHelp()}\n`, stderr: '' };
+            }
+            const report = await datasetReferencesRewriteImpl({
+                inputPath: datasetFlags.inputPath,
+                from: datasetFlags.from,
+                to: datasetFlags.to,
+                types: datasetFlags.types,
+                scope: datasetFlags.scope,
+                outDir: datasetFlags.outDir,
+                commit: datasetFlags.commit,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: report.status === 'completed_with_failures' ? 1 : 0,
+                stdout: stringifyJson(report, datasetFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'lifecyclemodel' && !subcommand) {
             return { exitCode: 0, stdout: `${renderLifecyclemodelHelp()}\n`, stderr: '' };
         }
@@ -2531,6 +3197,49 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'lifecyclemodel' && subcommand === 'save-draft') {
+            const lifecyclemodelFlags = parseLifecyclemodelSaveDraftFlags(commandArgs);
+            if (lifecyclemodelFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderLifecyclemodelSaveDraftHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await lifecyclemodelSaveDraftImpl({
+                inputPath: lifecyclemodelFlags.inputPath,
+                outDir: lifecyclemodelFlags.outDir,
+                commit: lifecyclemodelFlags.commit,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: report.status === 'completed_with_failures' ? 1 : 0,
+                stdout: stringifyJson(report, lifecyclemodelFlags.json),
+                stderr: '',
+            };
+        }
+        if (command === 'lifecyclemodel' && subcommand === 'graph') {
+            const lifecyclemodelFlags = parseLifecyclemodelGraphFlags(commandArgs);
+            if (lifecyclemodelFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderLifecyclemodelGraphHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await lifecyclemodelGraphImpl({
+                inputPath: lifecyclemodelFlags.inputPath,
+                outDir: lifecyclemodelFlags.outDir,
+                format: lifecyclemodelFlags.format,
+                checkConnections: lifecyclemodelFlags.checkConnections,
+            });
+            return {
+                exitCode: report.status === 'completed_with_findings' ? 1 : 0,
+                stdout: stringifyJson(report, lifecyclemodelFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'lifecyclemodel' && subcommand === 'orchestrate') {
             const lifecyclemodelFlags = parseLifecyclemodelOrchestrateFlags(commandArgs);
             if (lifecyclemodelFlags.help || !lifecyclemodelFlags.action) {
@@ -2618,6 +3327,52 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'process' && subcommand === 'scope-statistics') {
+            const processFlags = parseProcessScopeStatisticsFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessScopeStatisticsHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processScopeStatisticsImpl({
+                outDir: processFlags.outDir,
+                scope: processFlags.scope,
+                stateCodes: processFlags.stateCodes,
+                pageSize: processFlags.pageSize,
+                reuseSnapshot: processFlags.reuseSnapshot,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: 0,
+                stdout: stringifyJson(report, processFlags.json),
+                stderr: '',
+            };
+        }
+        if (command === 'process' && subcommand === 'dedup-review') {
+            const processFlags = parseProcessDedupReviewFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessDedupReviewHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processDedupReviewImpl({
+                inputPath: processFlags.inputPath,
+                outDir: processFlags.outDir,
+                skipRemote: processFlags.skipRemote,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: 0,
+                stdout: stringifyJson(report, processFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'process' && subcommand === 'auto-build') {
             const processFlags = parseProcessAutoBuildFlags(commandArgs);
             if (processFlags.help) {
@@ -2697,6 +3452,50 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'process' && subcommand === 'refresh-references') {
+            const processFlags = parseProcessRefreshReferencesFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessRefreshReferencesHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processRefreshReferencesImpl({
+                outDir: processFlags.outDir,
+                apply: processFlags.apply,
+                reuseManifest: processFlags.reuseManifest,
+                limit: processFlags.limit,
+                pageSize: processFlags.pageSize,
+                concurrency: processFlags.concurrency,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: report.status === 'completed_process_reference_refresh_with_errors' ? 1 : 0,
+                stdout: stringifyJson(report, processFlags.json),
+                stderr: '',
+            };
+        }
+        if (command === 'process' && subcommand === 'verify-rows') {
+            const processFlags = parseProcessVerifyRowsFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessVerifyRowsHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processVerifyRowsImpl({
+                rowsFile: processFlags.rowsFile,
+                outDir: processFlags.outDir,
+            });
+            return {
+                exitCode: report.invalid_count > 0 ? 1 : 0,
+                stdout: stringifyJson(report, processFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'process' && subcommand === 'batch-build') {
             const processFlags = parseProcessBatchBuildFlags(commandArgs);
             if (processFlags.help) {