@tiangong-lca/cli 0.0.7 → 0.0.9

package/dist/src/lib/{review-process.js → process-qa.js}

@@ -1,9 +1,9 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
-import { writeJsonArtifact, writeTextArtifact } from './artifacts.js';
+import { writeJsonArtifact, writeJsonLinesArtifact, writeTextArtifact } from './artifacts.js';
 import { CliError } from './errors.js';
 import { readJsonInput } from './io.js';
-import { invokeLlm, readLlmRuntimeEnv } from './llm.js';
+import { getRuntimeRuleset, resolveRuntimeRuleId } from './runtime-rulesets.js';
 const KIND_RE = /\[tg_io_kind_tag=([^\]]+)\]/gu;
 const UOM_RE = /\[tg_io_uom_tag=([^\]]+)\]/gu;
 const ENERGY_WORDS = [
@@ -110,33 +110,36 @@ function extractBaseNames(processPayload) {
         'baseName',
     ]);
     const items = Array.isArray(base) ? base : base ? [base] : [];
-    let zh = false;
-    let en = false;
     const values = [];
     items.forEach((item) => {
         if (!isRecord(item)) {
             return;
         }
-        const lang = String(item['@xml:lang'] ?? '').toLowerCase();
         const text = String(item['#text'] ?? '').trim();
         if (!text) {
             return;
         }
         values.push(text);
-        if (lang.startsWith('zh')) {
-            zh = true;
-        }
-        if (lang.startsWith('en')) {
-            en = true;
-        }
     });
-    if (!(zh && en) && values.length >= 2) {
-        zh = zh || true;
-        en = en || true;
+    return [values.length > 0, values];
+}
+function sourceTracePayload(exchange) {
+    const payload = deepGet(exchange, ['common:other', 'tidasimport:sourceTrace', 'payload']);
+    if (!isRecord(payload)) {
+        return null;
     }
-    return [zh, en, values];
+    return isRecord(payload.sourceTrace) ? payload.sourceTrace : payload;
+}
+function sourceClassification(exchange) {
+    const payload = sourceTracePayload(exchange);
+    return payload && isRecord(payload.sourceClassification) ? payload.sourceClassification : {};
+}
+function sourceGroup(exchange, groupName) {
+    const value = sourceClassification(exchange)[groupName];
+    const text = String(value ?? '').trim();
+    return text || null;
 }
-function classifyExchange(exchange) {
+function classifyExchange(exchange, referenceFlowId = null) {
     const comments = `${textFromValue(exchange.commonComment)} ${textFromValue(exchange.generalComment)}`.toLowerCase();
     const flowDescription = textFromValue(isRecord(exchange.referenceToFlowDataSet)
         ? exchange.referenceToFlowDataSet['common:shortDescription']
@@ -146,36 +149,54 @@ function classifyExchange(exchange) {
     const kindSet = new Set(kinds);
     const uoms = Array.from(blob.matchAll(UOM_RE), (match) => match[1].toLowerCase());
     const direction = String(exchange.exchangeDirection ?? '').toLowerCase();
+    const inputGroup = sourceGroup(exchange, 'inputGroup');
+    const outputGroup = sourceGroup(exchange, 'outputGroup');
+    const internalId = String(exchange['@dataSetInternalID'] ?? '').trim();
+    const isReferenceFlow = Boolean(referenceFlowId && internalId === referenceFlowId);
+    const meta = {
+        kinds,
+        uoms,
+        blob,
+        source_input_group: inputGroup,
+        source_output_group: outputGroup,
+        reference_flow: isReferenceFlow,
+    };
     const isEnergy = ENERGY_WORDS.some((word) => blob.includes(word)) ||
         uoms.some((uom) => uom === 'kwh' || uom === 'mj' || uom === 'gj');
     if (direction === 'input') {
         if (kindSet.has('energy') || isEnergy) {
-            return { classification: 'energy_input', kinds, uoms, blob };
+            return { classification: 'energy_input', ...meta };
         }
         if (kindSet.has('waste')) {
-            return { classification: 'other_input', kinds, uoms, blob };
+            return { classification: 'other_input', ...meta };
         }
-        if (kindSet.has('raw_material') || kindSet.has('resource')) {
-            return { classification: 'raw_material_input', kinds, uoms, blob };
+        if (inputGroup === '4' || kindSet.has('raw_material') || kindSet.has('resource')) {
+            return { classification: 'raw_material_input', ...meta };
         }
         if (kindSet.has('product') || RAW_WORDS.some((word) => blob.includes(word))) {
-            return { classification: 'raw_material_input', kinds, uoms, blob };
+            return { classification: 'raw_material_input', ...meta };
         }
-        return { classification: 'other_input', kinds, uoms, blob };
+        return { classification: 'other_input', ...meta };
     }
     if (direction === 'output') {
-        if (kindSet.has('waste') || WASTE_WORDS.some((word) => blob.includes(word))) {
-            return { classification: 'waste_output', kinds, uoms, blob };
+        if (isReferenceFlow || outputGroup === '0') {
+            return { classification: 'product_output', ...meta };
+        }
+        if (kindSet.has('waste') ||
+            outputGroup === '4' ||
+            outputGroup === '5' ||
+            WASTE_WORDS.some((word) => blob.includes(word))) {
+            return { classification: 'waste_output', ...meta };
         }
         if (BYP_WORDS.some((word) => blob.includes(word))) {
-            return { classification: 'byproduct_output', kinds, uoms, blob };
+            return { classification: 'byproduct_output', ...meta };
         }
         if (kindSet.has('product')) {
-            return { classification: 'product_output', kinds, uoms, blob };
+            return { classification: 'product_output', ...meta };
         }
-        return { classification: 'other_output', kinds, uoms, blob };
+        return { classification: 'other_output', ...meta };
     }
-    return { classification: 'other', kinds, uoms, blob };
+    return { classification: 'other', ...meta };
 }
 function unitIssueCheck(exchange, uoms, blob) {
     const flowUuid = isRecord(exchange.referenceToFlowDataSet)
@@ -226,8 +247,99 @@ function unitIssueCheck(exchange, uoms, blob) {
     }
     return [];
 }
+function hasNumericAmount(exchange) {
+    for (const key of ['meanAmount', 'resultingAmount']) {
+        const value = exchange[key];
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return true;
+        }
+        if (typeof value === 'string' && value.trim() && Number.isFinite(Number(value))) {
+            return true;
+        }
+    }
+    return false;
+}
+function createProcessQaFinding(options) {
+    const methodologyRuleId = resolveRuntimeRuleId('process-authoring/strict', options.code);
+    return {
+        process_file: options.processFile,
+        severity: options.severity,
+        code: options.code,
+        methodology_rule_id: methodologyRuleId,
+        message: options.message,
+        source: 'rule',
+        ...(options.evidence ? { evidence: options.evidence } : {}),
+    };
+}
+function reviewFindingsForBase(processFile, base) {
+    const findings = [];
+    if (!base.source_name_ok) {
+        findings.push(createProcessQaFinding({
+            processFile,
+            severity: 'warning',
+            code: 'process_missing_source_base_name',
+            message: 'Process baseName should include a usable source-language entry before Foundry authoring is complete.',
+            evidence: { base_names: base.base_names },
+        }));
+    }
+    if (!base.functional_unit_ok) {
+        findings.push(createProcessQaFinding({
+            processFile,
+            severity: 'warning',
+            code: 'process_missing_functional_unit',
+            message: 'Process quantitative reference functionalUnitOrOther is missing and should be curated by Foundry.',
+        }));
+    }
+    for (const [ok, code, message] of [
+        [
+            base.system_boundary_ok,
+            'process_missing_system_boundary',
+            'Process system boundary or typeOfDataSet context is missing.',
+        ],
+        [base.time_ok, 'process_missing_time', 'Process time coverage is missing.'],
+        [base.geo_ok, 'process_missing_geography', 'Process geography is missing.'],
+        [base.tech_ok, 'process_missing_technology', 'Process technology description is missing.'],
+        [
+            base.admin_ok,
+            'process_missing_admin_metadata',
+            'Process administrative metadata is missing.',
+        ],
+    ]) {
+        if (!ok) {
+            findings.push(createProcessQaFinding({
+                processFile,
+                severity: 'warning',
+                code,
+                message,
+            }));
+        }
+    }
+    return findings;
+}
+function processRulesetGate(findings) {
+    const ruleset = getRuntimeRuleset('process-authoring/strict');
+    const blockers = findings.filter((finding) => finding.severity === 'blocker');
+    const status = blockers.length > 0 ? 'blocked' : findings.length > 0 ? 'needs_review' : 'passed';
+    return {
+        status,
+        ruleset_id: ruleset.id,
+        ruleset_version: ruleset.version,
+        ruleset_source_version: ruleset.source_version,
+        ruleset_rule_ids: ruleset.rule_ids,
+        counts: {
+            findings: findings.length,
+            blockers: blockers.length,
+        },
+        blockers,
+        next_action: status === 'blocked'
+            ? 'fix_blockers'
+            : status === 'needs_review'
+                ? 'review_findings_in_foundry'
+                : 'continue',
+    };
+}
 function baseInfoCheck(processPayload) {
-    const [zhOk, enOk, values] = extractBaseNames(processPayload);
+    const [sourceNameOk, values] = extractBaseNames(processPayload);
     const functionalUnit = deepGet(processPayload, [
         'processDataSet',
         'processInformation',
@@ -253,7 +365,6 @@ function baseInfoCheck(processPayload) {
         'processDataSet',
         'administrativeInformation',
     ]);
-    const nameOk = zhOk && enOk;
     const functionalUnitOk = hasNonEmpty(functionalUnit);
     const systemBoundaryOk = hasNonEmpty(mixAndLocation) || hasNonEmpty(route);
     const timeOk = hasNonEmpty(time);
@@ -261,7 +372,7 @@ function baseInfoCheck(processPayload) {
     const technologyOk = hasNonEmpty(technology);
     const administrativeOk = hasNonEmpty(administrativeInformation);
     const completenessScore = [
-        nameOk,
+        sourceNameOk,
         functionalUnitOk,
         systemBoundaryOk,
         timeOk,
@@ -270,7 +381,7 @@ function baseInfoCheck(processPayload) {
         administrativeOk,
     ].filter(Boolean).length;
     return {
-        name_zh_en_ok: nameOk,
+        source_name_ok: sourceNameOk,
         functional_unit_ok: functionalUnitOk,
         system_boundary_ok: systemBoundaryOk,
         time_ok: timeOk,
@@ -283,8 +394,8 @@ function baseInfoCheck(processPayload) {
 }
 function unwrapProcessPayload(value, filePath) {
     if (!isRecord(value)) {
-        throw new CliError(`Expected process review file to contain a JSON object: ${filePath}`, {
-            code: 'PROCESS_REVIEW_INPUT_INVALID',
+        throw new CliError(`Expected process QA file to contain a JSON object: ${filePath}`, {
+            code: 'PROCESS_QA_INPUT_INVALID',
             exitCode: 2,
         });
     }
@@ -294,8 +405,8 @@ function unwrapProcessPayload(value, filePath) {
         (isRecord(value.json) && value.json) ||
         value;
     if (!isRecord(candidate.processDataSet)) {
-        throw new CliError(`Process review file is missing processDataSet: ${filePath}`, {
-            code: 'PROCESS_REVIEW_INPUT_INVALID',
+        throw new CliError(`Process QA file is missing processDataSet: ${filePath}`, {
+            code: 'PROCESS_QA_INPUT_INVALID',
             exitCode: 2,
         });
     }
@@ -335,7 +446,7 @@ function loadReviewRows(rowsFile) {
                 const parsed = JSON.parse(line);
                 if (!isRecord(parsed)) {
                     throw new CliError(`Expected JSON object rows in JSONL file: ${resolved}`, {
-                        code: 'PROCESS_REVIEW_ROWS_INVALID_JSONL_ROW',
+                        code: 'PROCESS_QA_ROWS_INVALID_JSONL_ROW',
                         exitCode: 2,
                     });
                 }
@@ -345,8 +456,8 @@ function loadReviewRows(rowsFile) {
                 if (error instanceof CliError) {
                     throw error;
                 }
-                throw new CliError(`Process review rows file contains invalid JSONL at line ${index + 1}.`, {
-                    code: 'PROCESS_REVIEW_ROWS_INVALID_JSONL',
+                throw new CliError(`Process QA rows file contains invalid JSONL at line ${index + 1}.`, {
+                    code: 'PROCESS_QA_ROWS_INVALID_JSONL',
                     exitCode: 2,
                     details: String(error),
                 });
@@ -358,8 +469,8 @@ function loadReviewRows(rowsFile) {
         parsed = JSON.parse(text);
     }
     catch (error) {
-        throw new CliError(`Process review rows file is not valid JSON: ${resolved}`, {
-            code: 'PROCESS_REVIEW_ROWS_INVALID_JSON',
+        throw new CliError(`Process QA rows file is not valid JSON: ${resolved}`, {
+            code: 'PROCESS_QA_ROWS_INVALID_JSON',
             exitCode: 2,
             details: String(error),
         });
@@ -371,13 +482,13 @@ function loadReviewRows(rowsFile) {
         return parsed.rows;
     }
     throw new CliError(`Expected JSON array of objects or a report object with rows[]: ${resolved}`, {
-        code: 'PROCESS_REVIEW_ROWS_INVALID_JSON',
+        code: 'PROCESS_QA_ROWS_INVALID_JSON',
         exitCode: 2,
     });
 }
 function materializeRowsFile(rowsFile, outDir) {
     const rows = loadReviewRows(rowsFile);
-    const targetDir = path.join(outDir, 'review-input', 'processes');
+    const targetDir = path.join(outDir, 'qa-input', 'processes');
     mkdirSync(targetDir, { recursive: true });
     const byKey = {};
     let duplicateCount = 0;
@@ -403,7 +514,7 @@ function materializeRowsFile(rowsFile, outDir) {
             file: filePath,
         });
     });
-    const summaryPath = path.join(outDir, 'review-input', 'materialization-summary.json');
+    const summaryPath = path.join(outDir, 'qa-input', 'materialization-summary.json');
     writeJsonArtifact(summaryPath, {
         source_rows_file: path.resolve(rowsFile),
         input_row_count: rows.length,
@@ -420,8 +531,8 @@ function materializeRowsFile(rowsFile, outDir) {
 function resolveReviewInput(options) {
     const declaredModes = [Boolean(options.rowsFile), Boolean(options.runRoot)].filter(Boolean);
     if (declaredModes.length !== 1) {
-        throw new CliError('Process review requires exactly one of --rows-file or --run-root.', {
-            code: 'PROCESS_REVIEW_INPUT_MODE_REQUIRED',
+        throw new CliError('Process QA requires exactly one of --rows-file or --run-root.', {
+            code: 'PROCESS_QA_INPUT_MODE_REQUIRED',
             exitCode: 2,
         });
     }
@@ -463,8 +574,8 @@ function resolveReviewInput(options) {
 }
 function readProcessFiles(processDir) {
     if (!existsSync(processDir) || !statSync(processDir).isDirectory()) {
-        throw new CliError(`Process review directory not found: ${processDir}`, {
-            code: 'PROCESS_REVIEW_EXPORTS_NOT_FOUND',
+        throw new CliError(`Process QA directory not found: ${processDir}`, {
+            code: 'PROCESS_QA_EXPORTS_NOT_FOUND',
             exitCode: 2,
         });
     }
@@ -475,7 +586,7 @@ function readProcessFiles(processDir) {
 }
 function buildPrompt(processSummaries) {
     return [
-        '请基于以下 process 摘要做语义一致性审核（中英名称一致性、边界表达、修订建议）。',
+        '请基于以下 process 摘要做语义一致性审核（源语言名称、边界表达、修订建议）。',
         '要求：',
         '1) 只根据给定摘要；',
         '2) 证据不足必须明确标注；',
@@ -497,71 +608,35 @@ function parseLlmJsonOutput(output) {
     }
 }
 async function runOptionalLlmReview(processSummaries, options) {
+    void processSummaries;
+    void options.env;
+    void options.fetchImpl;
+    void options.outDir;
     if (!options.enableLlm) {
         return {
             enabled: false,
             reason: 'disabled',
         };
     }
-    let env = readLlmRuntimeEnv(options.env);
-    if (options.llmModel) {
-        env = {
-            ...env,
-            model: options.llmModel,
-        };
-    }
-    try {
-        const response = await invokeLlm({
-            env,
-            input: {
-                prompt: '你是严谨的LCA审核助手。只给基于输入证据的判断，不得臆造。输出必须是JSON对象。',
-                context: buildPrompt(processSummaries),
-            },
-            fetchImpl: options.fetchImpl,
-            timeoutMs: 45_000,
-            cacheDir: path.join(options.outDir, '.llm-cache'),
-            tracePath: path.join(options.outDir, 'llm-trace.jsonl'),
-            module: 'review-process',
-            stage: 'semantic-review',
-            runId: 'review-process',
-        });
-        const parsed = parseLlmJsonOutput(response.output);
-        if (!parsed) {
-            return {
-                enabled: true,
-                ok: false,
-                reason: 'llm_non_json_output',
-                raw: response.output.slice(0, 8_000),
-            };
-        }
-        return {
-            enabled: true,
-            ok: true,
-            result: parsed,
-        };
-    }
-    catch (error) {
-        return {
-            enabled: true,
-            ok: false,
-            reason: error instanceof Error ? error.message : String(error),
-        };
-    }
+    return {
+        enabled: false,
+        reason: 'moved_to_foundry_process_curation',
+    };
 }
 function formatPercent(value) {
     return value === null ? '' : `${(value * 100).toFixed(2)}%`;
 }
 function renderZhReview(options) {
     const lines = [
-        '# one_flow_rerun_review_v2_1_zh\n',
+        '# one_flow_rerun_qa_v2_1_zh\n',
         `- run_id: \`${options.runId}\`\n`,
         `- logic_version: \`${options.logicVersion}\`\n`,
         '\n## 2.1 基础信息核查\n',
-        '|process file|中英名称|功能单位|系统边界|时间|地理|技术|管理元数据|完整性得分(0-7)|\n',
+        '|process file|源语言名称|功能单位|系统边界|时间|地理|技术|管理元数据|完整性得分(0-7)|\n',
         '|---|---|---|---|---|---|---|---|---:|\n',
     ];
     options.baseRows.forEach(([fileName, base]) => {
-        lines.push(`|${fileName}|${base.name_zh_en_ok ? '✅' : '❌'}|${base.functional_unit_ok ? '✅' : '❌'}|${base.system_boundary_ok ? '✅' : '❌'}|${base.time_ok ? '✅' : '❌'}|${base.geo_ok ? '✅' : '❌'}|${base.tech_ok ? '✅' : '❌'}|${base.admin_ok ? '✅' : '❌'}|${base.completeness_score}|\n`);
+        lines.push(`|${fileName}|${base.source_name_ok ? '✅' : '❌'}|${base.functional_unit_ok ? '✅' : '❌'}|${base.system_boundary_ok ? '✅' : '❌'}|${base.time_ok ? '✅' : '❌'}|${base.geo_ok ? '✅' : '❌'}|${base.tech_ok ? '✅' : '❌'}|${base.admin_ok ? '✅' : '❌'}|${base.completeness_score}|\n`);
     });
     lines.push('\n## 物料平衡口径\n- 物料平衡：仅核查 `原材料投入 = 产品+副产品+废物`\n- 能量投入：单列记录，不计入平衡\n');
     lines.push('\n## 分过程结果\n|process file|原材料投入|产品|副产品|废物|能量投入(不计平衡)|差值(输出-投入)|相对偏差|\n|---|---:|---:|---:|---:|---:|---:|---:|\n');
@@ -595,15 +670,15 @@ function renderZhReview(options) {
 }
 function renderEnReview(options) {
     const lines = [
-        '# one_flow_rerun_review_v2_1_en\n',
+        '# one_flow_rerun_qa_v2_1_en\n',
         `- run_id: \`${options.runId}\`\n`,
         `- logic_version: \`${options.logicVersion}\`\n`,
         '\n## 2.1 Basic info checks\n',
-        '|process file|zh+en names|functional unit|system boundary|time|geo|tech|admin metadata|completeness(0-7)|\n',
+        '|process file|source-language name|functional unit|system boundary|time|geo|tech|admin metadata|completeness(0-7)|\n',
         '|---|---|---|---|---|---|---|---|---:|\n',
     ];
     options.baseRows.forEach(([fileName, base]) => {
-        lines.push(`|${fileName}|${base.name_zh_en_ok ? '✅' : '❌'}|${base.functional_unit_ok ? '✅' : '❌'}|${base.system_boundary_ok ? '✅' : '❌'}|${base.time_ok ? '✅' : '❌'}|${base.geo_ok ? '✅' : '❌'}|${base.tech_ok ? '✅' : '❌'}|${base.admin_ok ? '✅' : '❌'}|${base.completeness_score}|\n`);
+        lines.push(`|${fileName}|${base.source_name_ok ? '✅' : '❌'}|${base.functional_unit_ok ? '✅' : '❌'}|${base.system_boundary_ok ? '✅' : '❌'}|${base.time_ok ? '✅' : '❌'}|${base.geo_ok ? '✅' : '❌'}|${base.tech_ok ? '✅' : '❌'}|${base.admin_ok ? '✅' : '❌'}|${base.completeness_score}|\n`);
     });
     lines.push('\n## Material balance scope\n- Check only `raw material input = product + by-product + waste`\n- Energy inputs are listed but excluded from balance\n');
     lines.push('\n## Per-process results\n|process file|raw material in|product|by-product|waste|energy in (excluded)|delta(out-in)|relative deviation|\n|---|---:|---:|---:|---:|---:|---:|---:|\n');
@@ -622,7 +697,7 @@ function renderTiming(options) {
         const end = new Date(options.endTs);
         if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
             throw new CliError('Expected --start-ts and --end-ts to be valid ISO timestamps.', {
-                code: 'PROCESS_REVIEW_INVALID_TIMESTAMP',
+                code: 'PROCESS_QA_INVALID_TIMESTAMP',
                 exitCode: 2,
             });
         }
@@ -655,15 +730,15 @@ function renderUnitIssues(runId, unitIssues) {
     });
     return lines.join('');
 }
-export async function runProcessReview(options) {
-    const outDir = path.resolve(requiredNonEmpty(options.outDir, '--out-dir', 'PROCESS_REVIEW_OUT_DIR_REQUIRED'));
+export async function runProcessQa(options) {
+    const outDir = path.resolve(requiredNonEmpty(options.outDir, '--out-dir', 'PROCESS_QA_OUT_DIR_REQUIRED'));
     const resolvedInput = resolveReviewInput({
         rowsFile: options.rowsFile,
         runRoot: options.runRoot,
         runId: options.runId,
         outDir,
     });
-    const runId = requiredNonEmpty(resolvedInput.runId, '--run-id', 'PROCESS_REVIEW_RUN_ID_REQUIRED');
+    const runId = requiredNonEmpty(resolvedInput.runId, '--run-id', 'PROCESS_QA_RUN_ID_REQUIRED');
     const logicVersion = options.logicVersion?.trim() || 'v2.1';
     const fetchImpl = options.fetchImpl ?? fetch;
     const env = options.env ?? process.env;
@@ -676,6 +751,7 @@ export async function runProcessReview(options) {
     const baseRows = [];
     const rows = [];
     const unitIssues = [];
+    const ruleFindings = [];
     const processSummariesForLlm = [];
     let totalRaw = 0;
     let totalProduct = 0;
@@ -690,16 +766,35 @@ export async function runProcessReview(options) {
             : isRecord(exchangesValue)
                 ? [exchangesValue]
                 : [];
+        const referenceFlowId = String(deepGet(processPayload, [
+            'processDataSet',
+            'processInformation',
+            'quantitativeReference',
+            'referenceToReferenceFlow',
+        ]) ?? '').trim() || null;
         const base = baseInfoCheck(processPayload);
         const fileName = path.basename(filePath);
         baseRows.push([fileName, base]);
+        ruleFindings.push(...reviewFindingsForBase(fileName, base));
         let rawInput = 0;
         let product = 0;
         let byproduct = 0;
         let waste = 0;
         let energyExcluded = 0;
         exchanges.forEach((exchange) => {
-            const classified = classifyExchange(exchange);
+            const classified = classifyExchange(exchange, referenceFlowId);
+            if (!hasNumericAmount(exchange)) {
+                ruleFindings.push(createProcessQaFinding({
+                    processFile: fileName,
+                    severity: 'warning',
+                    code: 'process_missing_exchange_amount',
+                    message: 'Process exchange is missing both numeric meanAmount and resultingAmount and should be curated by Foundry.',
+                    evidence: {
+                        exchange_internal_id: String(exchange['@dataSetInternalID'] ?? ''),
+                        direction: String(exchange.exchangeDirection ?? ''),
+                    },
+                }));
+            }
             const amount = toNumber(exchange.meanAmount ?? exchange.resultingAmount);
             if (classified.classification === 'raw_material_input') {
                 rawInput += amount;
@@ -716,7 +811,17 @@ export async function runProcessReview(options) {
             else if (classified.classification === 'energy_input') {
                 energyExcluded += amount;
             }
-            unitIssues.push(...unitIssueCheck(exchange, classified.uoms, classified.blob));
+            const currentUnitIssues = unitIssueCheck(exchange, classified.uoms, classified.blob);
+            unitIssues.push(...currentUnitIssues);
+            currentUnitIssues.forEach((issue) => {
+                ruleFindings.push(createProcessQaFinding({
+                    processFile: fileName,
+                    severity: 'warning',
+                    code: 'process_exchange_unit_semantic_mismatch',
+                    message: 'Exchange unit tag conflicts with flow description semantics.',
+                    evidence: { ...issue },
+                }));
+            });
         });
         const balanceOut = product + byproduct + waste;
         const delta = balanceOut - rawInput;
@@ -731,6 +836,22 @@ export async function runProcessReview(options) {
             delta,
             relative_deviation: relativeDeviation,
         });
+        if (relativeDeviation !== null && relativeDeviation > 0.05) {
+            ruleFindings.push(createProcessQaFinding({
+                processFile: fileName,
+                severity: 'warning',
+                code: 'process_material_balance_deviation',
+                message: 'Material balance deviation exceeds the QA threshold for raw inputs versus product/by-product/waste outputs.',
+                evidence: {
+                    raw_input: rawInput,
+                    product,
+                    byproduct,
+                    waste,
+                    relative_deviation: relativeDeviation,
+                    policy_decision_owner: 'foundry',
+                },
+            }));
+        }
         totalRaw += rawInput;
         totalProduct += product;
         totalByproduct += byproduct;
@@ -741,7 +862,7 @@ export async function runProcessReview(options) {
                 process_file: fileName,
                 base_names: base.base_names.slice(0, 4),
                 base_checks: {
-                    name_zh_en_ok: base.name_zh_en_ok,
+                    source_name_ok: base.source_name_ok,
                     functional_unit_ok: base.functional_unit_ok,
                     system_boundary_ok: base.system_boundary_ok,
                     time_ok: base.time_ok,
@@ -770,7 +891,7 @@ export async function runProcessReview(options) {
         energy_excluded: totalEnergy,
     };
     const evidenceStrong = [
-        '已基于 exchange 的 comment 标签/描述做口径过滤，仅核算 原材料投入 vs 产品+副产品+废物，能量单列不计入平衡。',
+        '已优先使用 quantitativeReference.referenceToReferenceFlow、EcoSpold inputGroup/outputGroup 和 exchange 标签/描述做口径过滤，仅核算 原材料投入 vs 产品+副产品+废物，能量单列不计入平衡。',
         ...(unitIssues.length > 0
             ? ['发现单位疑似错误时均附带 flow 描述与单位标签的直接矛盾证据。']
             : []),
@@ -786,15 +907,21 @@ export async function runProcessReview(options) {
         fetchImpl,
         outDir,
     });
+    const rulesetGate = processRulesetGate(ruleFindings);
     const summary = {
         run_id: runId,
         logic_version: logicVersion,
         process_count: processFiles.length,
         totals,
+        ruleset_gate: rulesetGate,
         llm: llmResult,
+        policy_decision_owner: 'foundry',
+        qa_mode: 'deterministic_qa_report',
     };
-    const reviewInputSummaryPath = writeJsonArtifact(path.join(outDir, 'review-input-summary.json'), resolvedInput.reviewInputSummary);
-    const reviewZhPath = writeTextArtifact(path.join(outDir, 'one_flow_rerun_review_v2_1_zh.md'), renderZhReview({
+    const reviewInputSummaryPath = writeJsonArtifact(path.join(outDir, 'qa-input-summary.json'), resolvedInput.reviewInputSummary);
+    const ruleFindingsPath = writeJsonLinesArtifact(path.join(outDir, 'process-qa-rule-findings.jsonl'), ruleFindings);
+    const rulesetGatePath = writeJsonArtifact(path.join(outDir, 'process-qa-ruleset-gate.json'), rulesetGate);
+    const reviewZhPath = writeTextArtifact(path.join(outDir, 'one_flow_rerun_qa_v2_1_zh.md'), renderZhReview({
         runId,
         logicVersion,
         baseRows,
@@ -804,7 +931,7 @@ export async function runProcessReview(options) {
         evidenceStrong,
         evidenceWeak,
     }));
-    const reviewEnPath = writeTextArtifact(path.join(outDir, 'one_flow_rerun_review_v2_1_en.md'), renderEnReview({
+    const reviewEnPath = writeTextArtifact(path.join(outDir, 'one_flow_rerun_qa_v2_1_en.md'), renderEnReview({
         runId,
         logicVersion,
         baseRows,
@@ -820,11 +947,11 @@ export async function runProcessReview(options) {
         processCount: processFiles.length,
     }));
     const unitIssuePath = writeTextArtifact(path.join(outDir, 'flow_unit_issue_log.md'), renderUnitIssues(runId, unitIssues));
-    const summaryPath = writeJsonArtifact(path.join(outDir, 'review_summary_v2_1.json'), summary);
+    const summaryPath = writeJsonArtifact(path.join(outDir, 'qa_summary_v2_1.json'), summary);
     const report = {
         schema_version: 1,
         generated_at_utc: (options.now ?? (() => new Date()))().toISOString(),
-        status: 'completed_local_process_review',
+        status: 'completed_local_process_qa',
         run_id: runId,
         run_root: resolvedInput.runRoot,
         rows_file: resolvedInput.rowsFile,
@@ -832,13 +959,24 @@ export async function runProcessReview(options) {
         input_mode: resolvedInput.inputMode,
         effective_processes_dir: resolvedInput.effectiveProcessesDir,
         logic_version: logicVersion,
+        ruleset_id: rulesetGate.ruleset_id,
+        ruleset_version: rulesetGate.ruleset_version,
+        ruleset_source_version: rulesetGate.ruleset_source_version,
+        ruleset_rule_ids: rulesetGate.ruleset_rule_ids,
         process_count: processFiles.length,
         totals,
+        rule_finding_count: ruleFindings.length,
+        blocker_count: rulesetGate.counts.blockers,
+        ruleset_gate: rulesetGate,
+        policy_decision_owner: 'foundry',
+        qa_mode: 'deterministic_qa_report',
         files: {
-            review_input_summary: reviewInputSummaryPath,
+            qa_input_summary: reviewInputSummaryPath,
             materialization_summary: resolvedInput.materializationSummaryPath,
-            review_zh: reviewZhPath,
-            review_en: reviewEnPath,
+            rule_findings: ruleFindingsPath,
+            ruleset_gate: rulesetGatePath,
+            qa_zh: reviewZhPath,
+            qa_en: reviewEnPath,
             timing: timingPath,
             unit_issue_log: unitIssuePath,
             summary: summaryPath,
@@ -846,7 +984,7 @@ export async function runProcessReview(options) {
         },
         llm: llmResult,
     };
-    const reportPath = writeJsonArtifact(path.join(outDir, 'process-review-report.json'), report);
+    const reportPath = writeJsonArtifact(path.join(outDir, 'process-qa-report.json'), report);
     report.files.report = reportPath;
     writeJsonArtifact(reportPath, report);
     return report;
@@ -860,6 +998,10 @@ export const __testInternals = {
     extractBaseNames,
     classifyExchange,
     unitIssueCheck,
+    hasNumericAmount,
+    createProcessQaFinding,
+    reviewFindingsForBase,
+    processRulesetGate,
     baseInfoCheck,
     unwrapProcessPayload,
     buildPrompt,
@@ -870,4 +1012,4 @@ export const __testInternals = {
     renderTiming,
     renderUnitIssues,
 };
-//# sourceMappingURL=review-process.js.map
+//# sourceMappingURL=process-qa.js.map