@tiangong-lca/cli 0.0.9 → 0.0.11

package/README.md

@@ -263,6 +263,7 @@ 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 curation-queue build --processes ./rows/processes.jsonl --flows ./rows/flows.jsonl --support ./rows/sources.jsonl --out-dir /abs/path/to/curation-queue --json
 tiangong-lca dataset evidence-search plan --query "中国2026年电力结构数据" --out-dir /abs/path/to/evidence-search --json
 tiangong-lca dataset evidence-search run --input ./evidence-search.request.json --results ./search-results.json --out-dir /abs/path/to/evidence-search --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
@@ -302,6 +303,8 @@ For `lifecyclemodel save-draft`, canonical lifecyclemodel payloads are validated
 
 For `dataset evidence-search`, `plan` creates the field-level query matrix and search budget. `run` accepts normalized external search results from browser/web-search tools or a generic JSON provider endpoint, then writes `outputs/evidence-search-plan.json`, `outputs/evidence-search-results.jsonl`, `outputs/evidence-search-report.json`, and `outputs/evidence-search-declaration.json` when evidence is absent or only partial. The CLI records scope and normalization; Codex/skills still own semantic judgement and source selection.
 
+For `dataset curation-queue build`, the CLI writes entity-level Foundry import queue artifacts: `outputs/curation-queue-manifest.json`, `outputs/curation-queue-tasks.jsonl`, `outputs/curation-queue-locks.json`, `outputs/curation-queue-blockers.jsonl`, and per-entity `input.jsonl`, `closure.json`, and `entity-run-plan.json`. The command only builds deterministic queue state. AI authoring must return structured patches or build plans, and remote writes remain gated by deterministic apply, schema/QA, prewrite verify, and readback.
+
 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

package/dist/src/cli.js

@@ -41,6 +41,7 @@ import { runFlowApplyProcessFlowRepairs, runFlowPlanProcessFlowRepairs, runFlowR
 import { executeRemoteCommand, getRemoteCommandHelp } from './lib/remote.js';
 import { runValidation, } from './lib/validation.js';
 import { runDatasetValidate, } from './lib/dataset-validate.js';
+import { runDatasetCurationQueueBuild, } from './lib/dataset-curation-queue.js';
 import { runDatasetReferencesRewrite, } from './lib/dataset-references-rewrite.js';
 import { runDatasetRemoteRefresh, } from './lib/dataset-remote-refresh.js';
 import { runDatasetRemoteVerify, } from './lib/dataset-remote-verify.js';
@@ -68,7 +69,7 @@ Implemented Commands:
   doctor     show environment diagnostics
   search     flow | process | lifecyclemodel
   process    get | list | identity-preflight | build-plan | scope-statistics | dedup-review | auto-build | resume-build | publish-build | complete-required-fields | save-draft | batch-build | refresh-references | verify-rows
-  dataset    contract get | context-pack | import-lca convert | author | validate | verify-remote | bilingual extract/apply/validate | evidence-search plan/run | references rewrite/refresh-remote
+  dataset    contract get | context-pack | curation-queue build | import-lca convert | author | validate | verify-remote | bilingual extract/apply/validate | evidence-search plan/run | references rewrite/refresh-remote
   flow       get | list | identity-preflight | build-plan | 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 | save-draft | graph | build-resulting-process | publish-resulting-process | orchestrate
   qa         process | flow | lifecyclemodel
@@ -103,6 +104,7 @@ Examples:
   tiangong-lca dataset validate --input ./rows.jsonl --type auto --out-dir /abs/path/to/dataset-validate
   tiangong-lca dataset contract get --type process --include schema,methodology,ruleset --out-dir ./contract
   tiangong-lca dataset context-pack --type process --profile ai-import --out-dir ./context-pack
+  tiangong-lca dataset curation-queue build --processes ./processes.jsonl --flows ./flows.jsonl --out-dir ./curation-queue
   tiangong-lca dataset import-lca convert --input ./external-package --output-dir ./converted --from-format auto --target tidas
   tiangong-lca dataset author --input ./source.pdf --target-types process,flow --out-dir ./authoring
   tiangong-lca dataset verify-remote --input ./rows.jsonl --out-dir /abs/path/to/dataset-remote-verify
@@ -244,6 +246,7 @@ function renderDatasetHelp() {
 Implemented Subcommands:
   contract get        Write TIDAS schema / methodology / ruleset contract artifacts
   context-pack        Write an AI-ready TIDAS contract context pack
+  curation-queue build Build entity-level AI curation queue artifacts for Foundry imports
   import-lca convert  Convert supported external LCA packages through tidas-tools
   author              Extract source evidence and prepare TIDAS context packs for AI authoring
   validate             Validate local flow / process / lifecyclemodel rows with the TIDAS SDK
@@ -258,6 +261,7 @@ Implemented Subcommands:
 Examples:
   tiangong-lca dataset contract get --type process --include schema,methodology,ruleset --out-dir ./contract --help
   tiangong-lca dataset context-pack --type process --profile ai-import --out-dir ./context-pack --help
+  tiangong-lca dataset curation-queue build --processes ./rows/processes.jsonl --flows ./rows/flows.jsonl --support ./rows/sources.jsonl --out-dir ./curation-queue --help
   tiangong-lca dataset import-lca convert --input ./external-package --output-dir ./converted --from-format auto --target tidas --help
   tiangong-lca dataset author --input ./source.pdf --target-types process,flow --out-dir ./authoring --help
   tiangong-lca dataset validate --input ./rows.jsonl --type auto --out-dir ./dataset-validate --help
@@ -313,6 +317,35 @@ Outputs written under --out-dir:
   - outputs/contract-report.json
 `.trim();
 }
+function renderDatasetCurationQueueHelp() {
+    return `Usage:
+  tiangong-lca dataset curation-queue build --processes <file> --out-dir <dir> [options]
+
+Options:
+  --processes <file>         Process rows JSON/JSONL
+  --flows <file>             Local flow rows JSON/JSONL used by process references
+  --support <file>           Repeatable support rows JSON/JSONL, for source/contact/unitgroup/flowproperty rows
+  --external-flow-ref <file> Repeatable external flow ref rows JSON/JSONL treated as already resolvable
+  --exclude-process-id <id>  Repeatable process id to skip
+  --process-limit <n>        Limit process tasks for focused validation or retries
+  --out-dir <dir>            Queue artifact directory
+  --json                     Print compact JSON
+  -h, --help
+
+Outputs written under --out-dir:
+  - outputs/curation-queue-manifest.json
+  - outputs/curation-queue-tasks.jsonl
+  - outputs/curation-queue-locks.json
+  - outputs/curation-queue-blockers.jsonl
+  - entities/<supports|flows|processes>/<id>__<version>/input.jsonl
+  - entities/<supports|flows|processes>/<id>__<version>/closure.json
+  - entities/<supports|flows|processes>/<id>__<version>/entity-run-plan.json
+
+Contract:
+  This command builds the queue only. AI authoring must write structured patches or build plans,
+  and remote writes remain blocked until deterministic apply, schema/QA, prewrite verify, and readback gates pass.
+`.trim();
+}
 function renderDatasetImportLcaHelp() {
     return `Usage:
   tiangong-lca dataset import-lca convert --input <path> --output-dir <dir> [options]
@@ -1822,6 +1855,53 @@ function parseDatasetContractFlags(args) {
         outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : null,
     };
 }
+function parseDatasetCurationQueueBuildFlags(args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                json: { type: 'boolean' },
+                processes: { type: 'string' },
+                flows: { type: 'string' },
+                support: { type: 'string', multiple: true },
+                'external-flow-ref': { type: 'string', multiple: true },
+                'exclude-process-id': { type: 'string', multiple: true },
+                'process-limit': { type: 'string' },
+                'out-dir': { type: 'string' },
+            },
+        }));
+    }
+    catch (error) {
+        throw new CliError(String(error), {
+            code: 'INVALID_ARGS',
+            exitCode: 2,
+        });
+    }
+    const processLimit = typeof values['process-limit'] === 'string'
+        ? Number.parseInt(values['process-limit'], 10)
+        : undefined;
+    return {
+        help: Boolean(values.help),
+        json: Boolean(values.json),
+        processesPath: typeof values.processes === 'string' ? values.processes : '',
+        flowsPath: typeof values.flows === 'string' ? values.flows : undefined,
+        supportPaths: Array.isArray(values.support)
+            ? values.support.filter((value) => typeof value === 'string')
+            : [],
+        externalFlowRefPaths: Array.isArray(values['external-flow-ref'])
+            ? values['external-flow-ref'].filter((value) => typeof value === 'string')
+            : [],
+        outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : '',
+        excludeProcessIds: Array.isArray(values['exclude-process-id'])
+            ? values['exclude-process-id'].filter((value) => typeof value === 'string')
+            : [],
+        processLimit,
+    };
+}
 function parseDatasetImportLcaConvertFlags(args) {
     let values;
     try {
@@ -3908,6 +3988,7 @@ export async function executeCli(argv, deps) {
         const flowBuildPlanValidateImpl = deps.runFlowBuildPlanValidateImpl ?? runFlowBuildPlanValidate;
         const flowBuildPlanMaterializeImpl = deps.runFlowBuildPlanMaterializeImpl ?? runFlowBuildPlanMaterialize;
         const datasetValidateImpl = deps.runDatasetValidateImpl ?? runDatasetValidate;
+        const datasetCurationQueueBuildImpl = deps.runDatasetCurationQueueBuildImpl ?? runDatasetCurationQueueBuild;
         const datasetReferencesRewriteImpl = deps.runDatasetReferencesRewriteImpl ?? runDatasetReferencesRewrite;
         const datasetRemoteRefreshImpl = deps.runDatasetRemoteRefreshImpl ?? runDatasetRemoteRefresh;
         const datasetRemoteVerifyImpl = deps.runDatasetRemoteVerifyImpl ?? runDatasetRemoteVerify;
@@ -4009,6 +4090,36 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'dataset' && subcommand === 'curation-queue') {
+            const action = commandArgs[0] ?? '';
+            if (!action || action === '--help' || action === '-h') {
+                return { exitCode: 0, stdout: `${renderDatasetCurationQueueHelp()}\n`, stderr: '' };
+            }
+            if (action !== 'build') {
+                throw new CliError("dataset curation-queue action must be 'build'.", {
+                    code: 'DATASET_CURATION_QUEUE_ACTION_INVALID',
+                    exitCode: 2,
+                });
+            }
+            const datasetFlags = parseDatasetCurationQueueBuildFlags(commandArgs.slice(1));
+            if (datasetFlags.help) {
+                return { exitCode: 0, stdout: `${renderDatasetCurationQueueHelp()}\n`, stderr: '' };
+            }
+            const report = await datasetCurationQueueBuildImpl({
+                processesPath: datasetFlags.processesPath,
+                flowsPath: datasetFlags.flowsPath,
+                supportPaths: datasetFlags.supportPaths,
+                externalFlowRefPaths: datasetFlags.externalFlowRefPaths,
+                outDir: datasetFlags.outDir,
+                excludeProcessIds: datasetFlags.excludeProcessIds,
+                processLimit: datasetFlags.processLimit,
+            });
+            return {
+                exitCode: report.status === 'blocked' ? 1 : 0,
+                stdout: stringifyJson(report, datasetFlags.json),
+                stderr: '',
+            };
+        }
         if (command === 'dataset' && subcommand === 'import-lca') {
             const action = commandArgs[0] ?? '';
             if (!action || action === '--help' || action === '-h') {