@tiangong-lca/cli 0.0.4 → 0.0.5

package/README.md

@@ -4,19 +4,21 @@ Package: `@tiangong-lca/cli` Executable: `tiangong` Node: `24.x`
 
 ## Run
 
-Use the published CLI directly:
+One-off published run:
 
 ```bash
-npx -y @tiangong-lca/cli@latest --help
-npx -y @tiangong-lca/cli@latest doctor
-npx -y @tiangong-lca/cli@latest flow --help
+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
 ```
 
-Optional global install:
+Install the published CLI:
 
 ```bash
 npm install --global @tiangong-lca/cli
 tiangong --help
+tiangong doctor
+tiangong flow --help
 ```
 
 Run from this repository:
@@ -76,9 +78,9 @@ Minimal `search flow` request:
 Run:
 
 ```bash
-npx -y @tiangong-lca/cli@latest search flow --input ./search-flow.request.json --json
-npx -y @tiangong-lca/cli@latest search process --input ./search-process.request.json --json
-npx -y @tiangong-lca/cli@latest search lifecyclemodel --input ./search-lifecyclemodel.request.json --json
+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
 ```
 
 Empty search results should be treated as empty whether the response is `[]` or `{"data":[]}`.
@@ -86,9 +88,10 @@ Empty search results should be treated as empty whether the response is `[]` or
 ## Read
 
 ```bash
-npx -y @tiangong-lca/cli@latest flow get --id <flow-id> --version <version> --json
-npx -y @tiangong-lca/cli@latest flow list --id <flow-id> --state-code 100 --limit 20 --json
-npx -y @tiangong-lca/cli@latest process get --id <process-id> --version <version> --json
+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
 ```
 
 ## Real DB Flow Review
@@ -135,15 +138,15 @@ npx -y @tiangong-lca/cli@latest process get --id <process-id> --version <version
 Run:
 
 ```bash
-npx -y @tiangong-lca/cli@latest flow fetch-rows \
+tiangong flow fetch-rows \
   --refs-file ./flow-refs.json \
   --out-dir ./flow-fetch
 
-npx -y @tiangong-lca/cli@latest review flow \
+tiangong review flow \
   --rows-file ./flow-fetch/review-input-rows.jsonl \
   --out-dir ./flow-review
 
-npx -y @tiangong-lca/cli@latest flow materialize-decisions \
+tiangong flow materialize-decisions \
   --decision-file ./approved-decisions.json \
   --flow-rows-file ./flow-fetch/review-input-rows.jsonl \
   --out-dir ./flow-decisions
@@ -167,11 +170,16 @@ Key `flow materialize-decisions` outputs:
 ## Other Common Commands
 
 ```bash
-npx -y @tiangong-lca/cli@latest review process --run-root ./artifacts/process_from_flow/<run_id> --run-id <run_id> --out-dir ./review
-npx -y @tiangong-lca/cli@latest publish run --input ./publish-request.json --dry-run
-npx -y @tiangong-lca/cli@latest doctor --json
+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
 ```
 
+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.
+
 ## More Docs
 
 - `docs/IMPLEMENTATION_GUIDE_CN.md`: maintainer-facing command contract and implementation notes
@@ -181,10 +189,10 @@ npx -y @tiangong-lca/cli@latest doctor --json
 ## Help
 
 ```bash
-npx -y @tiangong-lca/cli@latest --help
-npx -y @tiangong-lca/cli@latest flow --help
-npx -y @tiangong-lca/cli@latest review --help
-npx -y @tiangong-lca/cli@latest process --help
-npx -y @tiangong-lca/cli@latest lifecyclemodel --help
-npx -y @tiangong-lca/cli@latest publish --help
+tiangong --help
+tiangong flow --help
+tiangong review --help
+tiangong process --help
+tiangong lifecyclemodel --help
+tiangong publish --help
 ```

package/bin/tiangong.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { existsSync } from 'node:fs';
+import { existsSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
@@ -8,6 +8,19 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const entryPath = path.join(rootDir, 'dist', 'src', 'main.js');
 
+export function resolveInvokedUrl(argv1 = process.argv[1]) {
+  if (!argv1) {
+    return null;
+  }
+
+  const resolvedPath = path.resolve(argv1);
+  try {
+    return pathToFileURL(realpathSync(resolvedPath)).href;
+  } catch {
+    return pathToFileURL(resolvedPath).href;
+  }
+}
+
 export async function runFromBin(argv = process.argv.slice(2), env = process.env) {
   if (!existsSync(entryPath)) {
     throw new Error(
@@ -20,7 +33,7 @@ export async function runFromBin(argv = process.argv.slice(2), env = process.env
   return main(argv, env);
 }
 
-const invokedUrl = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : null;
+const invokedUrl = resolveInvokedUrl(process.argv[1]);
 
 if (invokedUrl && import.meta.url === invokedUrl) {
   try {

package/dist/src/cli.js

@@ -2,6 +2,7 @@ import { parseArgs } from 'node:util';
 import { buildDoctorReport, readRuntimeEnv } from './lib/env.js';
 import { CliError, toErrorPayload } from './lib/errors.js';
 import { stringifyJson } from './lib/io.js';
+import { loadCliPackageVersion } from './lib/package-version.js';
 import { runLifecyclemodelAutoBuild, } from './lib/lifecyclemodel-auto-build.js';
 import { runLifecyclemodelBuildResultingProcess, } from './lib/lifecyclemodel-resulting-process.js';
 import { runLifecyclemodelPublishResultingProcess, } from './lib/lifecyclemodel-publish-resulting-process.js';
@@ -10,9 +11,11 @@ import { runLifecyclemodelPublishBuild, } from './lib/lifecyclemodel-publish-bui
 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 { 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 { runPublish } from './lib/publish.js';
 import { runProcessReview, } from './lib/review-process.js';
 import { runFlowReview, } from './lib/review-flow.js';
@@ -46,7 +49,7 @@ Commands:
 Implemented Commands:
   doctor     show environment diagnostics
   search     flow | process | lifecyclemodel
-  process    get | auto-build | resume-build | publish-build | batch-build
+  process    get | list | auto-build | resume-build | publish-build | save-draft | batch-build
   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
   review     process | flow | lifecyclemodel
@@ -65,9 +68,11 @@ Examples:
   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>
@@ -86,6 +91,7 @@ Examples:
   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
@@ -165,6 +171,9 @@ Options:
   --dry-run            Force publish.commit=false
   --json               Print compact JSON
   -h, --help
+
+Path rule:
+  Relative out_dir values from the request body or --out-dir resolve from the request file directory.
 `.trim();
 }
 function renderValidationHelp() {
@@ -524,7 +533,7 @@ function renderReviewHelp() {
   tiangong review <subcommand> [options]
 
 Implemented Subcommands:
-  process      Review one local process build run and emit artifact-first findings
+  process      Review process build runs or rows-file snapshots and emit artifact-first findings
   flow         Review local flow governance snapshots and emit artifact-first findings
   lifecyclemodel Review one local lifecyclemodel build run and emit artifact-first findings
 
@@ -537,11 +546,12 @@ Examples:
 }
 function renderReviewProcessHelp() {
     return `Usage:
-  tiangong review process --run-root <dir> --run-id <id> --out-dir <dir> [options]
+  tiangong 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
   --run-root <dir>          Process build run root containing exports/processes
-  --run-id <id>             Process build run identifier
+  --run-id <id>             Optional review run identifier; defaults to the rows-file name or run-root basename
   --out-dir <dir>           Review artifact output directory
   --start-ts <iso>          Optional run start timestamp
   --end-ts <iso>            Optional run end timestamp
@@ -749,6 +759,33 @@ Required env:
   TIANGONG_LCA_API_KEY
   TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
 
+Runtime note:
+  The CLI derives a native @supabase/supabase-js client and deterministic read target from TIANGONG_LCA_API_BASE_URL,
+  and authenticates that client with the resolved user access token.
+`.trim();
+}
+function renderProcessListHelp() {
+    return `Usage:
+  tiangong process list [options]
+
+Options:
+  --id <process-id>               Repeatable exact process UUID filter
+  --version <version>             Optional dataset version filter
+  --user-id <user-id>             Optional owner filter for private rows
+  --state-code <code>             Repeatable visibility filter such as 0 or 100
+  --order <expr>                  Deterministic PostgREST order expression (default: id.asc,version.asc)
+  --limit <n>                     Page size for one request (default: 100)
+  --offset <n>                    Row offset for one request (default: 0)
+  --all                           Fetch all matching rows via offset pagination
+  --page-size <n>                 Page size when --all is used (default: 100)
+  --json                          Print compact JSON
+  -h, --help
+
+Required env:
+  TIANGONG_LCA_API_BASE_URL
+  TIANGONG_LCA_API_KEY
+  TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY
+
 Runtime note:
   The CLI derives a native @supabase/supabase-js client and deterministic read target from TIANGONG_LCA_API_BASE_URL,
   and authenticates that client with the resolved user access token.
@@ -776,6 +813,31 @@ Options:
   -h, --help
 `.trim();
 }
+function renderProcessSaveDraftHelp() {
+    return `Usage:
+  tiangong process save-draft --input <file> [options]
+
+Options:
+  --input <file>     Process 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
+
+Outputs written under --out-dir:
+  - inputs/normalized-input.json
+  - outputs/save-draft-rpc/selected-processes.jsonl
+  - outputs/save-draft-rpc/progress.jsonl
+  - outputs/save-draft-rpc/failures.jsonl
+  - outputs/save-draft-rpc/summary.json
+`.trim();
+}
 function renderProcessBatchBuildHelp() {
     return `Usage:
   tiangong process batch-build --input <file> [options]
@@ -793,17 +855,21 @@ function renderProcessHelp() {
 
 Implemented Subcommands:
   get          Load one process dataset by identifier through direct Supabase access
+  list         List visible process rows through direct Supabase access
   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
 
 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
 `.trim();
 }
@@ -1694,6 +1760,7 @@ function parseReviewProcessFlags(args) {
             options: {
                 help: { type: 'boolean', short: 'h' },
                 json: { type: 'boolean' },
+                'rows-file': { type: 'string' },
                 'run-root': { type: 'string' },
                 'run-id': { type: 'string' },
                 'out-dir': { type: 'string' },
@@ -1725,8 +1792,9 @@ function parseReviewProcessFlags(args) {
     return {
         help: Boolean(values.help),
         json: Boolean(values.json),
-        runRoot: typeof values['run-root'] === 'string' ? values['run-root'] : '',
-        runId: typeof values['run-id'] === 'string' ? values['run-id'] : '',
+        rowsFile: typeof values['rows-file'] === 'string' ? values['rows-file'] : undefined,
+        runRoot: typeof values['run-root'] === 'string' ? values['run-root'] : undefined,
+        runId: typeof values['run-id'] === 'string' ? values['run-id'] : undefined,
         outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
         startTs: typeof values['start-ts'] === 'string' ? values['start-ts'] : undefined,
         endTs: typeof values['end-ts'] === 'string' ? values['end-ts'] : undefined,
@@ -2055,6 +2123,96 @@ function parseProcessGetFlags(args) {
         version: typeof values.version === 'string' ? values.version : null,
     };
 }
+function parseProcessListFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                id: { type: 'string', multiple: true },
+                version: { type: 'string' },
+                'user-id': { type: 'string' },
+                'state-code': { type: 'string', multiple: true },
+                limit: { type: 'string' },
+                offset: { type: 'string' },
+                all: { type: 'boolean' },
+                'page-size': { type: 'string' },
+                order: { type: 'string' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            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;
+    };
+    const parseOptionalNonNegativeIntegerFlag = (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 non-negative integer.`, {
+                code,
+                exitCode: 2,
+            });
+        }
+        return parsed;
+    };
+    const parseStateCodeValues = (value) => {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        return value.map((entry) => {
+            const parsed = Number.parseInt(String(entry), 10);
+            if (!Number.isInteger(parsed) || parsed < 0) {
+                throw new CliError('Expected --state-code to be a non-negative integer.', {
+                    code: 'INVALID_PROCESS_LIST_STATE_CODE',
+                    exitCode: 2,
+                });
+            }
+            return parsed;
+        });
+    };
+    const toStringArray = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : [];
+    if (values['page-size'] !== undefined && !values.all) {
+        throw new CliError('Use --page-size only with --all.', {
+            code: 'PROCESS_LIST_PAGE_SIZE_REQUIRES_ALL',
+            exitCode: 2,
+        });
+    }
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        ids: toStringArray(values.id),
+        version: typeof values.version === 'string' ? values.version : null,
+        userId: typeof values['user-id'] === 'string' ? values['user-id'] : null,
+        stateCodes: parseStateCodeValues(values['state-code']),
+        limit: parseOptionalPositiveIntegerFlag(values.limit, '--limit', 'INVALID_PROCESS_LIST_LIMIT'),
+        offset: parseOptionalNonNegativeIntegerFlag(values.offset, '--offset', 'INVALID_PROCESS_LIST_OFFSET'),
+        all: Boolean(values.all),
+        pageSize: parseOptionalPositiveIntegerFlag(values['page-size'], '--page-size', 'INVALID_PROCESS_LIST_PAGE_SIZE'),
+        order: typeof values.order === 'string' ? values.order : null,
+    };
+}
 function parseProcessResumeBuildFlags(args) {
     let values;
     try {
@@ -2111,6 +2269,43 @@ function parseProcessPublishBuildFlags(args) {
         runDir: typeof values['run-dir'] === 'string' ? values['run-dir'] : null,
     };
 }
+function parseProcessSaveDraftFlags(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_PROCESS_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 parseProcessBatchBuildFlags(args) {
     let values;
     try {
@@ -2168,10 +2363,12 @@ export async function executeCli(argv, deps) {
         const lifecyclemodelPublishBuildImpl = deps.runLifecyclemodelPublishBuildImpl ?? runLifecyclemodelPublishBuild;
         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 processResumeBuildImpl = deps.runProcessResumeBuildImpl ?? runProcessResumeBuild;
         const processPublishBuildImpl = deps.runProcessPublishBuildImpl ?? runProcessPublishBuild;
+        const processSaveDraftImpl = deps.runProcessSaveDraftImpl ?? runProcessSaveDraft;
         const processReviewImpl = deps.runProcessReviewImpl ?? runProcessReview;
         const flowReviewImpl = deps.runFlowReviewImpl ?? runFlowReview;
         const lifecyclemodelReviewImpl = deps.runLifecyclemodelReviewImpl ?? runLifecyclemodelReview;
@@ -2189,7 +2386,7 @@ export async function executeCli(argv, deps) {
         const flowRegenProductImpl = deps.runFlowRegenProductImpl ?? runFlowRegenProduct;
         const flowValidateProcessesImpl = deps.runFlowValidateProcessesImpl ?? runFlowValidateProcesses;
         if (flags.version) {
-            return { exitCode: 0, stdout: '0.0.1\n', stderr: '' };
+            return { exitCode: 0, stdout: `${loadCliPackageVersion(import.meta.url)}\n`, stderr: '' };
         }
         if (!command || command === 'help' || flags.help) {
             return { exitCode: 0, stdout: `${renderMainHelp(deps.dotEnvStatus)}\n`, stderr: '' };
@@ -2392,6 +2589,34 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'process' && subcommand === 'list') {
+            const processFlags = parseProcessListFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessListHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processListImpl({
+                ids: processFlags.ids,
+                version: processFlags.version,
+                userId: processFlags.userId,
+                stateCodes: processFlags.stateCodes,
+                limit: processFlags.limit,
+                offset: processFlags.offset,
+                all: processFlags.all,
+                pageSize: processFlags.pageSize,
+                order: processFlags.order,
+                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) {
@@ -2449,6 +2674,28 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'process' && subcommand === 'save-draft') {
+            const processFlags = parseProcessSaveDraftFlags(commandArgs);
+            if (processFlags.help) {
+                return {
+                    exitCode: 0,
+                    stdout: `${renderProcessSaveDraftHelp()}\n`,
+                    stderr: '',
+                };
+            }
+            const report = await processSaveDraftImpl({
+                inputPath: processFlags.inputPath,
+                outDir: processFlags.outDir,
+                commit: processFlags.commit,
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+            });
+            return {
+                exitCode: report.status === 'completed_with_failures' ? 1 : 0,
+                stdout: stringifyJson(report, processFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'process' && subcommand === 'batch-build') {
             const processFlags = parseProcessBatchBuildFlags(commandArgs);
             if (processFlags.help) {
@@ -2817,6 +3064,7 @@ export async function executeCli(argv, deps) {
                 return { exitCode: 0, stdout: `${renderReviewProcessHelp()}\n`, stderr: '' };
             }
             const report = await processReviewImpl({
+                rowsFile: reviewFlags.rowsFile,
                 runRoot: reviewFlags.runRoot,
                 runId: reviewFlags.runId,
                 outDir: reviewFlags.outDir,