@tiangong-lca/cli 0.0.11 → 0.0.13

package/dist/src/lib/lifecyclemodel-qa.js

@@ -1,6 +1,7 @@
 import { existsSync, readdirSync } from 'node:fs';
 import path from 'node:path';
 import { readJsonArtifact, writeJsonArtifact, writeJsonLinesArtifact, writeTextArtifact, } from './artifacts.js';
+import { materializeDatasetRows } from './dataset-local.js';
 import { CliError } from './errors.js';
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -56,6 +57,11 @@ function uniqueStrings(values) {
 function copyJson(value) {
     return JSON.parse(JSON.stringify(value));
 }
+function sanitizeFileName(value) {
+    return (String(value ?? 'missing')
+        .replace(/[^A-Za-z0-9._-]+/gu, '_')
+        .replace(/^_+|_+$/gu, '') || 'missing');
+}
 function emptySeverityCounts() {
     return {
         error: 0,
@@ -115,11 +121,15 @@ function readOptionalJsonArray(filePath, invalidCode, label) {
     }
     return value;
 }
-function buildLayout(runRoot, outDir) {
+function buildLayout(options) {
+    const runRoot = options.runRoot;
+    const outDir = options.outDir;
     const runId = path.basename(runRoot);
     return {
         runId,
         runRoot,
+        rowsFile: options.rowsFile ?? '',
+        inputMode: options.inputMode ?? 'run_dir',
         outDir,
         modelsDir: path.join(runRoot, 'models'),
         reportsDir: path.join(runRoot, 'reports'),
@@ -127,6 +137,7 @@ function buildLayout(runRoot, outDir) {
         runManifestPath: path.join(runRoot, 'manifests', 'run-manifest.json'),
         invocationIndexPath: path.join(runRoot, 'manifests', 'invocation-index.json'),
         validationReportPath: path.join(runRoot, 'reports', 'lifecyclemodel-validate-build-report.json'),
+        qaInputSummaryPath: options.inputMode === 'rows_file' ? path.join(outDir, 'qa_input_summary.json') : null,
         modelSummariesPath: path.join(outDir, 'model_summaries.jsonl'),
         findingsPath: path.join(outDir, 'findings.jsonl'),
         summaryPath: path.join(outDir, 'lifecyclemodel_qa_summary.json'),
@@ -137,13 +148,6 @@ function buildLayout(runRoot, outDir) {
     };
 }
 function resolveLayout(options) {
-    const runDir = nonEmptyString(options.runDir);
-    if (!runDir) {
-        throw new CliError('Missing required --run-dir for qa lifecyclemodel.', {
-            code: 'LIFECYCLEMODEL_QA_RUN_DIR_REQUIRED',
-            exitCode: 2,
-        });
-    }
     const outDir = nonEmptyString(options.outDir);
     if (!outDir) {
         throw new CliError('Missing required --out-dir for qa lifecyclemodel.', {
@@ -151,7 +155,34 @@ function resolveLayout(options) {
             exitCode: 2,
         });
     }
-    return buildLayout(path.resolve(runDir), path.resolve(outDir));
+    const rowsFile = nonEmptyString(options.rowsFile);
+    const runDir = nonEmptyString(options.runDir);
+    if (rowsFile && runDir) {
+        throw new CliError('Use either --rows-file or --run-dir for qa lifecyclemodel, not both.', {
+            code: 'LIFECYCLEMODEL_QA_INPUT_MODE_CONFLICT',
+            exitCode: 2,
+        });
+    }
+    if (rowsFile) {
+        const resolvedRowsFile = path.resolve(rowsFile);
+        return buildLayout({
+            runRoot: path.join(path.resolve(outDir), 'qa-input', sanitizeFileName(path.basename(rowsFile))),
+            rowsFile: resolvedRowsFile,
+            inputMode: 'rows_file',
+            outDir: path.resolve(outDir),
+        });
+    }
+    if (!runDir) {
+        throw new CliError('Missing required --rows-file or --run-dir for qa lifecyclemodel.', {
+            code: 'LIFECYCLEMODEL_QA_RUN_DIR_REQUIRED',
+            exitCode: 2,
+        });
+    }
+    return buildLayout({
+        runRoot: path.resolve(runDir),
+        outDir: path.resolve(outDir),
+        inputMode: 'run_dir',
+    });
 }
 function ensureRunRootExists(layout) {
     if (!existsSync(layout.runRoot)) {
@@ -228,6 +259,7 @@ function discoverModelEntries(layout) {
                 summaryPath: path.join(layout.modelsDir, runName, 'summary.json'),
                 connectionsPath: path.join(layout.modelsDir, runName, 'connections.json'),
                 processCatalogPath: path.join(layout.modelsDir, runName, 'process-catalog.json'),
+                inputMode: layout.inputMode,
             },
         ];
     });
@@ -239,6 +271,69 @@ function discoverModelEntries(layout) {
     }
     return entries;
 }
+function materializeRowsFile(layout) {
+    if (!layout.rowsFile || !existsSync(layout.rowsFile)) {
+        throw new CliError(`Lifecyclemodel QA rows file not found: ${layout.rowsFile}`, {
+            code: 'LIFECYCLEMODEL_QA_ROWS_FILE_NOT_FOUND',
+            exitCode: 2,
+            details: { rowsFile: layout.rowsFile },
+        });
+    }
+    const rows = materializeDatasetRows(layout.rowsFile);
+    const entries = [];
+    writeJsonArtifact(layout.runManifestPath, {
+        schemaVersion: 1,
+        runId: layout.runId,
+        input_mode: 'rows_file',
+        rows_file: layout.rowsFile,
+        row_count: rows.length,
+    });
+    writeJsonArtifact(layout.invocationIndexPath, {
+        schema_version: 1,
+        invocations: [],
+    });
+    rows.forEach((row) => {
+        if (row.kind && row.kind !== 'lifecyclemodel') {
+            throw new CliError(`Expected lifecyclemodel row at index ${row.index}; detected ${row.kind}.`, {
+                code: 'LIFECYCLEMODEL_QA_ROWS_FILE_KIND_MISMATCH',
+                exitCode: 2,
+                details: { index: row.index, detectedKind: row.kind },
+            });
+        }
+        const runName = sanitizeFileName(row.id ?? `row-${row.index + 1}`);
+        const modelFile = path.join(layout.modelsDir, runName, 'tidas_bundle', 'lifecyclemodels', `${runName}.json`);
+        writeJsonArtifact(modelFile, row.payload);
+        entries.push({
+            runName,
+            modelFiles: [modelFile],
+            summaryPath: path.join(layout.modelsDir, runName, 'summary.json'),
+            connectionsPath: path.join(layout.modelsDir, runName, 'connections.json'),
+            processCatalogPath: path.join(layout.modelsDir, runName, 'process-catalog.json'),
+            inputMode: 'rows_file',
+        });
+    });
+    if (layout.qaInputSummaryPath) {
+        writeJsonArtifact(layout.qaInputSummaryPath, {
+            input_mode: 'rows_file',
+            rows_file: layout.rowsFile,
+            run_root: layout.runRoot,
+            materialized_lifecyclemodel_count: entries.length,
+            materialized_models_dir: layout.modelsDir,
+        });
+    }
+    return {
+        invocationIndex: {
+            schema_version: 1,
+            invocations: [],
+        },
+        validationAggregate: {
+            ok: null,
+            reportPath: null,
+            modelReports: new Map(),
+        },
+        modelEntries: entries,
+    };
+}
 function normalizeValidationIssue(raw) {
     if (!isRecord(raw)) {
         return {
@@ -423,22 +518,22 @@ function buildModelReview(entry, validationAggregate) {
     const multiplicationFactorCount = multiplicationFactors
         ? Object.keys(multiplicationFactors).length
         : 0;
-    if (!summaryArtifact) {
+    if (entry.inputMode === 'run_dir' && !summaryArtifact) {
         findings.push(makeFinding(entry.runName, entry.modelFiles[0] ?? null, 'warning', 'missing_model_summary', 'qa', 'Model bundle is missing summary.json generated by lifecyclemodel auto-build.', {
             summary_path: entry.summaryPath,
         }));
     }
-    if (!connections) {
+    if (entry.inputMode === 'run_dir' && !connections) {
         findings.push(makeFinding(entry.runName, entry.modelFiles[0] ?? null, 'warning', 'missing_connections_artifact', 'qa', 'Model bundle is missing connections.json generated by lifecyclemodel auto-build.', {
             connections_path: entry.connectionsPath,
         }));
     }
-    if (!processCatalog) {
+    if (entry.inputMode === 'run_dir' && !processCatalog) {
         findings.push(makeFinding(entry.runName, entry.modelFiles[0] ?? null, 'warning', 'missing_process_catalog', 'qa', 'Model bundle is missing process-catalog.json generated by lifecyclemodel auto-build.', {
             process_catalog_path: entry.processCatalogPath,
         }));
     }
-    if (referenceProcessUuids.length === 0) {
+    if (entry.inputMode === 'run_dir' && referenceProcessUuids.length === 0) {
         findings.push(makeFinding(entry.runName, entry.modelFiles[0] ?? null, 'warning', 'missing_reference_process_uuid', 'qa', 'QA could not resolve reference_process_uuid from summary.json.', {
             summary_path: summaryArtifact ? entry.summaryPath : null,
         }));
@@ -518,14 +613,14 @@ function buildInvocationIndex(layout, invocationIndex, options, now) {
     const priorInvocations = Array.isArray(invocationIndex.invocations)
         ? [...invocationIndex.invocations]
         : [];
-    const command = [
-        'qa',
-        'lifecyclemodel',
-        '--run-dir',
-        options.runDir,
-        '--out-dir',
-        options.outDir,
-    ];
+    const command = ['qa', 'lifecyclemodel'];
+    if (layout.inputMode === 'rows_file') {
+        command.push('--rows-file', options.rowsFile);
+    }
+    else {
+        command.push('--run-dir', options.runDir);
+    }
+    command.push('--out-dir', options.outDir);
     if (nonEmptyString(options.logicVersion)) {
         command.push('--logic-version', options.logicVersion);
     }
@@ -552,6 +647,13 @@ function buildInvocationIndex(layout, invocationIndex, options, now) {
     };
 }
 function buildNextActions(layout, validationAggregate) {
+    if (layout.inputMode === 'rows_file') {
+        return [
+            `inspect: ${layout.findingsPath}`,
+            `run: tiangong-lca dataset validate --type lifecyclemodel --input ${layout.rowsFile}`,
+            `run: tiangong-lca lifecyclemodel save-draft --input ${layout.rowsFile} --dry-run`,
+        ];
+    }
     return [
         `inspect: ${layout.findingsPath}`,
         validationAggregate.reportPath
@@ -566,6 +668,8 @@ function renderZhReview(options) {
         `- run_id: \`${options.runId}\`\n`,
         `- logic_version: \`${options.logicVersion}\`\n`,
         `- run_root: \`${options.runRoot}\`\n`,
+        `- input_mode: \`${options.inputMode}\`\n`,
+        ...(options.rowsFile ? [`- rows_file: \`${options.rowsFile}\`\n`] : []),
         '\n## 总览\n',
         `- model bundle 数量: **${options.modelSummaries.length}**\n`,
         `- findings 数量: **${options.findings.length}**\n`,
@@ -585,7 +689,9 @@ function renderZhReview(options) {
             lines.push(`|${finding.run_name}|${finding.severity}|${finding.source}|${finding.rule_id}|${finding.message.replace(/\|/gu, '/')}|\n`);
         });
     }
-    lines.push('\n## 说明\n', '- 当前 qa lifecyclemodel 保持 local-first / artifact-first，只读取现有 build run 与 validate-build 产物。\n', '- 当前命令不引入 Python、LangGraph 或 skill 私有 QA runtime。\n');
+    lines.push('\n## 说明\n', options.inputMode === 'rows_file'
+        ? '- 当前 qa lifecyclemodel rows-file 模式只做 payload-level deterministic QA，不要求 lifecyclemodel build-run 产物。\n'
+        : '- 当前 qa lifecyclemodel run-dir 模式保持 local-first / artifact-first，只读取现有 build run 与 validate-build 产物。\n', '- 当前命令不引入 Python、LangGraph 或 skill 私有 QA runtime。\n');
     return lines.join('');
 }
 function renderEnReview(options) {
@@ -594,6 +700,8 @@ function renderEnReview(options) {
         `- run_id: \`${options.runId}\`\n`,
         `- logic_version: \`${options.logicVersion}\`\n`,
         `- run_root: \`${options.runRoot}\`\n`,
+        `- input_mode: \`${options.inputMode}\`\n`,
+        ...(options.rowsFile ? [`- rows_file: \`${options.rowsFile}\`\n`] : []),
         '\n## Summary\n',
         `- model bundles: **${options.modelSummaries.length}**\n`,
         `- findings: **${options.findings.length}**\n`,
@@ -632,15 +740,21 @@ function renderTiming(options) {
 }
 export async function runLifecyclemodelQa(options) {
     const layout = resolveLayout(options);
-    ensureRunRootExists(layout);
-    readRequiredRunManifest(layout);
-    const invocationIndex = readInvocationIndex(layout);
-    const validationAggregate = readValidationAggregate(layout);
-    const modelEntries = discoverModelEntries(layout);
+    const input = layout.inputMode === 'rows_file'
+        ? materializeRowsFile(layout)
+        : (() => {
+            ensureRunRootExists(layout);
+            readRequiredRunManifest(layout);
+            return {
+                invocationIndex: readInvocationIndex(layout),
+                validationAggregate: readValidationAggregate(layout),
+                modelEntries: discoverModelEntries(layout),
+            };
+        })();
     const logicVersion = options.logicVersion?.trim() || 'lifecyclemodel-qa-v1.0';
     const now = options.now ?? (() => new Date());
     const generatedAt = now();
-    const reviewedModels = modelEntries.map((entry) => buildModelReview(entry, validationAggregate));
+    const reviewedModels = input.modelEntries.map((entry) => buildModelReview(entry, input.validationAggregate));
     const modelSummaries = reviewedModels.map((model) => model.summary);
     const findings = reviewedModels.flatMap((model) => model.findings);
     const report = {
@@ -649,20 +763,23 @@ export async function runLifecyclemodelQa(options) {
         status: 'completed_local_lifecyclemodel_qa',
         run_id: layout.runId,
         run_root: layout.runRoot,
+        rows_file: layout.rowsFile,
+        input_mode: layout.inputMode,
         out_dir: layout.outDir,
         logic_version: logicVersion,
         model_count: modelSummaries.length,
         finding_count: findings.length,
         severity_counts: severityCounts(findings),
         validation: {
-            available: validationAggregate.reportPath !== null,
-            ok: validationAggregate.ok,
-            report: validationAggregate.reportPath,
+            available: input.validationAggregate.reportPath !== null,
+            ok: input.validationAggregate.ok,
+            report: input.validationAggregate.reportPath,
         },
         files: {
             run_manifest: layout.runManifestPath,
             invocation_index: layout.invocationIndexPath,
-            validation_report: validationAggregate.reportPath,
+            qa_input_summary: layout.qaInputSummaryPath,
+            validation_report: input.validationAggregate.reportPath,
             model_summaries: layout.modelSummariesPath,
             findings: layout.findingsPath,
             summary: layout.summaryPath,
@@ -672,13 +789,15 @@ export async function runLifecyclemodelQa(options) {
             report: layout.reportPath,
         },
         model_summaries: modelSummaries,
-        next_actions: buildNextActions(layout, validationAggregate),
+        next_actions: buildNextActions(layout, input.validationAggregate),
     };
-    writeJsonArtifact(layout.invocationIndexPath, buildInvocationIndex(layout, invocationIndex, options, generatedAt));
+    writeJsonArtifact(layout.invocationIndexPath, buildInvocationIndex(layout, input.invocationIndex, options, generatedAt));
     writeJsonLinesArtifact(layout.modelSummariesPath, modelSummaries);
     writeJsonLinesArtifact(layout.findingsPath, findings);
     writeJsonArtifact(layout.summaryPath, {
         run_id: report.run_id,
+        rows_file: report.rows_file,
+        input_mode: report.input_mode,
         logic_version: report.logic_version,
         model_count: report.model_count,
         finding_count: report.finding_count,
@@ -689,6 +808,8 @@ export async function runLifecyclemodelQa(options) {
         runId: report.run_id,
         logicVersion: report.logic_version,
         runRoot: report.run_root,
+        rowsFile: report.rows_file,
+        inputMode: report.input_mode,
         modelSummaries,
         findings,
         validation: report.validation,
@@ -697,6 +818,8 @@ export async function runLifecyclemodelQa(options) {
         runId: report.run_id,
         logicVersion: report.logic_version,
         runRoot: report.run_root,
+        rowsFile: report.rows_file,
+        inputMode: report.input_mode,
         modelSummaries,
         findings,
         validation: report.validation,
@@ -716,6 +839,8 @@ export const __testInternals = {
     readInvocationIndex,
     discoverModelEntries,
     readValidationAggregate,
+    materializeRowsFile,
+    sanitizeFileName,
     readModelFileReviewInfo,
     buildModelReview,
     buildInvocationIndex,