@tiangong-lca/cli 0.0.2 → 0.0.3

package/dist/src/lib/flow-materialize-decisions.js

@@ -0,0 +1,421 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { writeJsonArtifact } from './artifacts.js';
+import { CliError } from './errors.js';
+import { extractFlowRecord, loadRowsFromFile, } from './flow-governance.js';
+function normalizeToken(value) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    const trimmed = String(value).trim();
+    return trimmed ? trimmed : null;
+}
+function assertInputFile(inputFile, requiredCode, missingCode) {
+    const normalized = normalizeToken(inputFile);
+    if (!normalized) {
+        throw new CliError('Missing required input file value.', {
+            code: requiredCode,
+            exitCode: 2,
+        });
+    }
+    const resolved = path.resolve(normalized);
+    if (!existsSync(resolved)) {
+        throw new CliError(`Input file not found: ${resolved}`, {
+            code: missingCode,
+            exitCode: 2,
+        });
+    }
+    return resolved;
+}
+function assertOutDir(outDir) {
+    const normalized = normalizeToken(outDir);
+    if (!normalized) {
+        throw new CliError('Missing required --out-dir value.', {
+            code: 'FLOW_MATERIALIZE_DECISIONS_OUT_DIR_REQUIRED',
+            exitCode: 2,
+        });
+    }
+    return path.resolve(normalized);
+}
+function parseFlowRefString(value, code) {
+    const trimmed = value.trim();
+    const [id, version, rest] = trimmed.split('@');
+    if (!id || !version || rest !== undefined) {
+        throw new CliError(`Expected flow ref to use id@version format, received: ${value}`, {
+            code,
+            exitCode: 2,
+        });
+    }
+    return {
+        id,
+        version,
+    };
+}
+function parseFlowRefLike(value, code) {
+    if (typeof value === 'string') {
+        return parseFlowRefString(value, code);
+    }
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const record = value;
+        const id = normalizeToken(record.id);
+        const version = normalizeToken(record.version);
+        if (!id || !version) {
+            throw new CliError('Expected flow ref objects to contain id and version.', {
+                code,
+                exitCode: 2,
+                details: value,
+            });
+        }
+        return {
+            id,
+            version,
+        };
+    }
+    if (value === undefined || value === null) {
+        return null;
+    }
+    throw new CliError('Expected flow ref values to be id@version strings or { id, version } objects.', {
+        code,
+        exitCode: 2,
+        details: value,
+    });
+}
+function parseFlowRefArray(row, keys, code) {
+    const refs = [];
+    keys.forEach((key) => {
+        const value = row[key];
+        if (!Array.isArray(value)) {
+            return;
+        }
+        value.forEach((item) => {
+            const ref = parseFlowRefLike(item, code);
+            if (ref) {
+                refs.push(ref);
+            }
+        });
+    });
+    return refs;
+}
+function uniqueFlowRefs(refs) {
+    const seen = new Set();
+    const unique = [];
+    refs.forEach((ref) => {
+        const key = `${ref.id}@${ref.version}`;
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        unique.push(ref);
+    });
+    return unique;
+}
+function parseDecisionRow(row, index) {
+    const clusterId = normalizeToken(row.cluster_id ?? row.clusterId);
+    if (!clusterId) {
+        throw new CliError(`Decision row ${index + 1} is missing cluster_id.`, {
+            code: 'FLOW_MATERIALIZE_DECISIONS_CLUSTER_ID_REQUIRED',
+            exitCode: 2,
+            details: row,
+        });
+    }
+    const rawDecision = normalizeToken(row.decision ?? row.approved_decision ?? row.outcome);
+    if (rawDecision !== 'merge_keep_one' &&
+        rawDecision !== 'keep_distinct' &&
+        rawDecision !== 'blocked_missing_db_flow') {
+        throw new CliError(`Decision row ${clusterId} must use one of merge_keep_one, keep_distinct, or blocked_missing_db_flow.`, {
+            code: 'FLOW_MATERIALIZE_DECISIONS_INVALID_DECISION',
+            exitCode: 2,
+            details: row,
+        });
+    }
+    const canonicalRef = parseFlowRefLike(row.canonical_flow ??
+        row.canonical_ref ??
+        row.keep ??
+        row.keep_ref ??
+        row.keep_flow ??
+        row.canonical_flow_key, 'FLOW_MATERIALIZE_DECISIONS_INVALID_CANONICAL_REF');
+    const memberRefs = uniqueFlowRefs([
+        ...parseFlowRefArray(row, [
+            'flow_refs',
+            'cluster_members',
+            'members',
+            'flows',
+            'flow_keys',
+            'member_keys',
+            'drop_refs',
+            'drops',
+            'rewrite_sources',
+        ], 'FLOW_MATERIALIZE_DECISIONS_INVALID_MEMBER_REF'),
+        ...(canonicalRef ? [canonicalRef] : []),
+    ]);
+    if (rawDecision === 'merge_keep_one' && !canonicalRef) {
+        throw new CliError(`Decision row ${clusterId} is missing canonical flow information.`, {
+            code: 'FLOW_MATERIALIZE_DECISIONS_CANONICAL_REQUIRED',
+            exitCode: 2,
+            details: row,
+        });
+    }
+    if (rawDecision === 'merge_keep_one' && memberRefs.length < 2) {
+        throw new CliError(`Decision row ${clusterId} needs at least two cluster members for merge_keep_one.`, {
+            code: 'FLOW_MATERIALIZE_DECISIONS_MEMBERS_REQUIRED',
+            exitCode: 2,
+            details: row,
+        });
+    }
+    return {
+        clusterId,
+        decision: rawDecision,
+        reason: normalizeToken(row.reason ?? row.notes ?? row.message),
+        canonicalRef,
+        memberRefs,
+    };
+}
+function buildFlowIndex(rows) {
+    const index = new Map();
+    rows.forEach((row, rowIndex) => {
+        const record = extractFlowRecord(row);
+        const key = `${record.id}@${record.version}`;
+        if (index.has(key)) {
+            throw new CliError(`Duplicate flow row detected for ${key}.`, {
+                code: 'FLOW_MATERIALIZE_DECISIONS_DUPLICATE_FLOW_ROW',
+                exitCode: 2,
+                details: {
+                    flow_key: key,
+                    first_index: [...index.keys()].indexOf(key),
+                    duplicate_index: rowIndex,
+                },
+            });
+        }
+        index.set(key, {
+            key,
+            row,
+            record,
+        });
+    });
+    return index;
+}
+function summarizeFlow(record) {
+    return {
+        id: record.id,
+        version: record.version,
+        name: record.name,
+        flow_type: record.flowType,
+    };
+}
+function buildOutputFiles(outDir) {
+    return {
+        canonical_map: path.join(outDir, 'flow-dedup-canonical-map.json'),
+        rewrite_plan: path.join(outDir, 'flow-dedup-rewrite-plan.json'),
+        semantic_merge_seed: path.join(outDir, 'manual-semantic-merge-seed.current.json'),
+        summary: path.join(outDir, 'decision-summary.json'),
+        blocked_clusters: path.join(outDir, 'blocked-clusters.json'),
+    };
+}
+function incrementCount(record, key) {
+    record[key] = (record[key] ?? 0) + 1;
+}
+function sortedObject(entries) {
+    return Object.fromEntries(entries.sort(([left], [right]) => left.localeCompare(right)));
+}
+export async function runFlowMaterializeDecisions(options) {
+    const decisionFile = assertInputFile(options.decisionFile, 'FLOW_MATERIALIZE_DECISIONS_DECISION_FILE_REQUIRED', 'FLOW_MATERIALIZE_DECISIONS_DECISION_FILE_NOT_FOUND');
+    const flowRowsFile = assertInputFile(options.flowRowsFile, 'FLOW_MATERIALIZE_DECISIONS_FLOW_ROWS_FILE_REQUIRED', 'FLOW_MATERIALIZE_DECISIONS_FLOW_ROWS_FILE_NOT_FOUND');
+    const outDir = assertOutDir(options.outDir);
+    const generatedAt = (options.now ?? new Date()).toISOString();
+    const files = buildOutputFiles(outDir);
+    const decisions = loadRowsFromFile(decisionFile).map((row, index) => parseDecisionRow(row, index));
+    const flowIndex = buildFlowIndex(loadRowsFromFile(flowRowsFile));
+    const canonicalClusters = [];
+    const canonicalMapEntries = [];
+    const rewriteActions = [];
+    const seedAliasEntries = [];
+    const blockedClusters = [];
+    const decisionCounts = {
+        merge_keep_one: 0,
+        keep_distinct: 0,
+        blocked_missing_db_flow: 0,
+    };
+    const blockedReasonCounts = {};
+    decisions.forEach((decision) => {
+        decisionCounts[decision.decision] += 1;
+        if (decision.decision === 'keep_distinct') {
+            blockedClusters.push({
+                cluster_id: decision.clusterId,
+                decision: decision.decision,
+                blocker_code: 'decision_keep_distinct',
+                reason: decision.reason,
+                canonical_flow: decision.canonicalRef,
+                cluster_members: decision.memberRefs,
+                missing_flow_keys: [],
+            });
+            incrementCount(blockedReasonCounts, 'decision_keep_distinct');
+            return;
+        }
+        if (decision.decision === 'blocked_missing_db_flow') {
+            blockedClusters.push({
+                cluster_id: decision.clusterId,
+                decision: decision.decision,
+                blocker_code: 'blocked_missing_db_flow',
+                reason: decision.reason,
+                canonical_flow: decision.canonicalRef,
+                cluster_members: decision.memberRefs,
+                missing_flow_keys: [],
+            });
+            incrementCount(blockedReasonCounts, 'blocked_missing_db_flow');
+            return;
+        }
+        const canonicalRef = decision.canonicalRef;
+        const canonicalKey = `${canonicalRef.id}@${canonicalRef.version}`;
+        const missingFlowKeys = decision.memberRefs
+            .map((ref) => `${ref.id}@${ref.version}`)
+            .filter((key) => !flowIndex.has(key));
+        if (!flowIndex.has(canonicalKey)) {
+            blockedClusters.push({
+                cluster_id: decision.clusterId,
+                decision: decision.decision,
+                blocker_code: 'merge_canonical_flow_missing',
+                reason: decision.reason,
+                canonical_flow: canonicalRef,
+                cluster_members: decision.memberRefs,
+                missing_flow_keys: [...new Set([canonicalKey, ...missingFlowKeys])],
+            });
+            incrementCount(blockedReasonCounts, 'merge_canonical_flow_missing');
+            return;
+        }
+        if (missingFlowKeys.length > 0) {
+            blockedClusters.push({
+                cluster_id: decision.clusterId,
+                decision: decision.decision,
+                blocker_code: 'flow_row_missing',
+                reason: decision.reason,
+                canonical_flow: canonicalRef,
+                cluster_members: decision.memberRefs,
+                missing_flow_keys: [...new Set(missingFlowKeys)].sort(),
+            });
+            incrementCount(blockedReasonCounts, 'flow_row_missing');
+            return;
+        }
+        const canonicalFlow = flowIndex.get(canonicalKey);
+        const mergeReason = decision.reason ?? 'approved_merge_keep_one';
+        const mergedFlows = decision.memberRefs
+            .map((ref) => flowIndex.get(`${ref.id}@${ref.version}`))
+            .sort((left, right) => left.key.localeCompare(right.key))
+            .map((entry) => ({
+            ...summarizeFlow(entry.record),
+            relation: entry.key === canonicalKey
+                ? 'canonical_self'
+                : 'rewrite_to_canonical',
+        }));
+        canonicalClusters.push({
+            cluster_id: decision.clusterId,
+            decision: 'merge_keep_one',
+            reason: decision.reason,
+            canonical_flow: summarizeFlow(canonicalFlow.record),
+            merged_flows: mergedFlows,
+        });
+        mergedFlows.forEach((flow) => {
+            canonicalMapEntries.push([
+                `${flow.id}@${flow.version}`,
+                {
+                    id: canonicalFlow.record.id,
+                    version: canonicalFlow.record.version,
+                    cluster_id: decision.clusterId,
+                    relation: flow.relation,
+                    reason: mergeReason,
+                },
+            ]);
+            if (flow.relation === 'rewrite_to_canonical') {
+                rewriteActions.push({
+                    cluster_id: decision.clusterId,
+                    action: 'rewrite_to_canonical',
+                    reason: mergeReason,
+                    source_flow_id: flow.id,
+                    source_flow_version: flow.version,
+                    source_flow_name: flow.name,
+                    source_flow_type: flow.flow_type,
+                    target_flow_id: canonicalFlow.record.id,
+                    target_flow_version: canonicalFlow.record.version,
+                    target_flow_name: canonicalFlow.record.name,
+                    target_flow_type: canonicalFlow.record.flowType,
+                });
+                seedAliasEntries.push([
+                    `${flow.id}@${flow.version}`,
+                    {
+                        id: canonicalFlow.record.id,
+                        version: canonicalFlow.record.version,
+                        cluster_id: decision.clusterId,
+                        relation: 'rewrite_to_canonical',
+                        reason: mergeReason,
+                    },
+                ]);
+            }
+        });
+    });
+    const canonicalMapByFlowKey = sortedObject(canonicalMapEntries);
+    const semanticMergeSeed = sortedObject(seedAliasEntries.map(([key, value]) => [
+        key,
+        {
+            id: value.id,
+            version: value.version,
+            reason: value.reason,
+            cluster_id: value.cluster_id,
+        },
+    ]));
+    const report = {
+        schema_version: 1,
+        generated_at_utc: generatedAt,
+        status: blockedClusters.length > 0
+            ? 'completed_local_flow_decision_materialization_with_blocked_clusters'
+            : 'completed_local_flow_decision_materialization',
+        decision_file: decisionFile,
+        flow_rows_file: flowRowsFile,
+        out_dir: outDir,
+        counts: {
+            input_decisions: decisions.length,
+            materialized_clusters: canonicalClusters.length,
+            blocked_clusters: blockedClusters.length,
+            canonical_map_entries: Object.keys(canonicalMapByFlowKey).length,
+            rewrite_actions: rewriteActions.length,
+            seed_alias_entries: Object.keys(semanticMergeSeed).length,
+            decision_counts: decisionCounts,
+            blocked_reason_counts: blockedReasonCounts,
+        },
+        files,
+    };
+    writeJsonArtifact(files.canonical_map, {
+        schema_version: 1,
+        generated_at_utc: generatedAt,
+        clusters: canonicalClusters.sort((left, right) => left.cluster_id.localeCompare(right.cluster_id)),
+        by_flow_key: canonicalMapByFlowKey,
+    });
+    writeJsonArtifact(files.rewrite_plan, {
+        schema_version: 1,
+        generated_at_utc: generatedAt,
+        actions: rewriteActions.sort((left, right) => {
+            const clusterOrder = left.cluster_id.localeCompare(right.cluster_id);
+            if (clusterOrder !== 0) {
+                return clusterOrder;
+            }
+            const leftKey = `${left.source_flow_id}@${left.source_flow_version}`;
+            const rightKey = `${right.source_flow_id}@${right.source_flow_version}`;
+            return leftKey.localeCompare(rightKey);
+        }),
+    });
+    writeJsonArtifact(files.semantic_merge_seed, semanticMergeSeed);
+    writeJsonArtifact(files.blocked_clusters, {
+        schema_version: 1,
+        generated_at_utc: generatedAt,
+        clusters: blockedClusters.sort((left, right) => left.cluster_id.localeCompare(right.cluster_id)),
+    });
+    writeJsonArtifact(files.summary, report);
+    return report;
+}
+export const __testInternals = {
+    parseDecisionRow,
+    parseFlowRefLike,
+    parseFlowRefString,
+    uniqueFlowRefs,
+    buildFlowIndex,
+    buildOutputFiles,
+};
+//# sourceMappingURL=flow-materialize-decisions.js.map

package/dist/src/lib/flow-materialize-decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-materialize-decisions.js","sourceRoot":"","sources":["../../../src/lib/flow-materialize-decisions.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { writeJsonArtifact } from './artifacts.js';\nimport { CliError } from './errors.js';\nimport {\n  extractFlowRecord,\n  loadRowsFromFile,\n  type FlowRecord,\n  type JsonRecord,\n} from './flow-governance.js';\n\ntype FlowRef = {\n  id: string;\n  version: string;\n};\n\ntype SupportedDecision = 'merge_keep_one' | 'keep_distinct' | 'blocked_missing_db_flow';\n\ntype NormalizedDecision = {\n  clusterId: string;\n  decision: SupportedDecision;\n  reason: string | null;\n  canonicalRef: FlowRef | null;\n  memberRefs: FlowRef[];\n};\n\ntype IndexedFlowRow = {\n  key: string;\n  row: JsonRecord;\n  record: FlowRecord;\n};\n\ntype CanonicalFlowSummary = {\n  id: string;\n  version: string;\n  name: string;\n  flow_type: string;\n};\n\ntype CanonicalMapCluster = {\n  cluster_id: string;\n  decision: 'merge_keep_one';\n  reason: string | null;\n  canonical_flow: CanonicalFlowSummary;\n  merged_flows: Array<\n    CanonicalFlowSummary & {\n      relation: 'canonical_self' | 'rewrite_to_canonical';\n    }\n  >;\n};\n\ntype CanonicalMapEntry = {\n  id: string;\n  version: string;\n  cluster_id: string;\n  relation: 'canonical_self' | 'rewrite_to_canonical';\n  reason: string;\n};\n\ntype RewritePlanAction = {\n  cluster_id: string;\n  action: 'rewrite_to_canonical';\n  reason: string;\n  source_flow_id: string;\n  source_flow_version: string;\n  source_flow_name: string;\n  source_flow_type: string;\n  target_flow_id: string;\n  target_flow_version: string;\n  target_flow_name: string;\n  target_flow_type: string;\n};\n\ntype BlockedCluster = {\n  cluster_id: string;\n  decision: SupportedDecision;\n  blocker_code:\n    | 'decision_keep_distinct'\n    | 'blocked_missing_db_flow'\n    | 'merge_canonical_flow_missing'\n    | 'flow_row_missing';\n  reason: string | null;\n  canonical_flow: FlowRef | null;\n  cluster_members: FlowRef[];\n  missing_flow_keys: string[];\n};\n\ntype FlowMaterializeDecisionsFiles = {\n  canonical_map: string;\n  rewrite_plan: string;\n  semantic_merge_seed: string;\n  summary: string;\n  blocked_clusters: string;\n};\n\ntype FlowMaterializeDecisionCounts = {\n  input_decisions: number;\n  materialized_clusters: number;\n  blocked_clusters: number;\n  canonical_map_entries: number;\n  rewrite_actions: number;\n  seed_alias_entries: number;\n  decision_counts: Record<SupportedDecision, number>;\n  blocked_reason_counts: Record<string, number>;\n};\n\nexport type FlowMaterializeDecisionsReport = {\n  schema_version: 1;\n  generated_at_utc: string;\n  status:\n    | 'completed_local_flow_decision_materialization'\n    | 'completed_local_flow_decision_materialization_with_blocked_clusters';\n  decision_file: string;\n  flow_rows_file: string;\n  out_dir: string;\n  counts: FlowMaterializeDecisionCounts;\n  files: FlowMaterializeDecisionsFiles;\n};\n\nexport type RunFlowMaterializeDecisionsOptions = {\n  decisionFile: string;\n  flowRowsFile: string;\n  outDir: string;\n  now?: Date;\n};\n\nfunction normalizeToken(value: unknown): string | null {\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  const trimmed = String(value).trim();\n  return trimmed ? trimmed : null;\n}\n\nfunction assertInputFile(inputFile: string, requiredCode: string, missingCode: string): string {\n  const normalized = normalizeToken(inputFile);\n  if (!normalized) {\n    throw new CliError('Missing required input file value.', {\n      code: requiredCode,\n      exitCode: 2,\n    });\n  }\n\n  const resolved = path.resolve(normalized);\n  if (!existsSync(resolved)) {\n    throw new CliError(`Input file not found: ${resolved}`, {\n      code: missingCode,\n      exitCode: 2,\n    });\n  }\n\n  return resolved;\n}\n\nfunction assertOutDir(outDir: string): string {\n  const normalized = normalizeToken(outDir);\n  if (!normalized) {\n    throw new CliError('Missing required --out-dir value.', {\n      code: 'FLOW_MATERIALIZE_DECISIONS_OUT_DIR_REQUIRED',\n      exitCode: 2,\n    });\n  }\n\n  return path.resolve(normalized);\n}\n\nfunction parseFlowRefString(value: string, code: string): FlowRef {\n  const trimmed = value.trim();\n  const [id, version, rest] = trimmed.split('@');\n  if (!id || !version || rest !== undefined) {\n    throw new CliError(`Expected flow ref to use id@version format, received: ${value}`, {\n      code,\n      exitCode: 2,\n    });\n  }\n\n  return {\n    id,\n    version,\n  };\n}\n\nfunction parseFlowRefLike(value: unknown, code: string): FlowRef | null {\n  if (typeof value === 'string') {\n    return parseFlowRefString(value, code);\n  }\n\n  if (value && typeof value === 'object' && !Array.isArray(value)) {\n    const record = value as JsonRecord;\n    const id = normalizeToken(record.id);\n    const version = normalizeToken(record.version);\n    if (!id || !version) {\n      throw new CliError('Expected flow ref objects to contain id and version.', {\n        code,\n        exitCode: 2,\n        details: value,\n      });\n    }\n    return {\n      id,\n      version,\n    };\n  }\n\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  throw new CliError(\n    'Expected flow ref values to be id@version strings or { id, version } objects.',\n    {\n      code,\n      exitCode: 2,\n      details: value,\n    },\n  );\n}\n\nfunction parseFlowRefArray(row: JsonRecord, keys: string[], code: string): FlowRef[] {\n  const refs: FlowRef[] = [];\n  keys.forEach((key) => {\n    const value = row[key];\n    if (!Array.isArray(value)) {\n      return;\n    }\n    value.forEach((item) => {\n      const ref = parseFlowRefLike(item, code);\n      if (ref) {\n        refs.push(ref);\n      }\n    });\n  });\n  return refs;\n}\n\nfunction uniqueFlowRefs(refs: FlowRef[]): FlowRef[] {\n  const seen = new Set<string>();\n  const unique: FlowRef[] = [];\n  refs.forEach((ref) => {\n    const key = `${ref.id}@${ref.version}`;\n    if (seen.has(key)) {\n      return;\n    }\n    seen.add(key);\n    unique.push(ref);\n  });\n  return unique;\n}\n\nfunction parseDecisionRow(row: JsonRecord, index: number): NormalizedDecision {\n  const clusterId = normalizeToken(row.cluster_id ?? row.clusterId);\n  if (!clusterId) {\n    throw new CliError(`Decision row ${index + 1} is missing cluster_id.`, {\n      code: 'FLOW_MATERIALIZE_DECISIONS_CLUSTER_ID_REQUIRED',\n      exitCode: 2,\n      details: row,\n    });\n  }\n\n  const rawDecision = normalizeToken(row.decision ?? row.approved_decision ?? row.outcome);\n  if (\n    rawDecision !== 'merge_keep_one' &&\n    rawDecision !== 'keep_distinct' &&\n    rawDecision !== 'blocked_missing_db_flow'\n  ) {\n    throw new CliError(\n      `Decision row ${clusterId} must use one of merge_keep_one, keep_distinct, or blocked_missing_db_flow.`,\n      {\n        code: 'FLOW_MATERIALIZE_DECISIONS_INVALID_DECISION',\n        exitCode: 2,\n        details: row,\n      },\n    );\n  }\n\n  const canonicalRef = parseFlowRefLike(\n    row.canonical_flow ??\n      row.canonical_ref ??\n      row.keep ??\n      row.keep_ref ??\n      row.keep_flow ??\n      row.canonical_flow_key,\n    'FLOW_MATERIALIZE_DECISIONS_INVALID_CANONICAL_REF',\n  );\n  const memberRefs = uniqueFlowRefs([\n    ...parseFlowRefArray(\n      row,\n      [\n        'flow_refs',\n        'cluster_members',\n        'members',\n        'flows',\n        'flow_keys',\n        'member_keys',\n        'drop_refs',\n        'drops',\n        'rewrite_sources',\n      ],\n      'FLOW_MATERIALIZE_DECISIONS_INVALID_MEMBER_REF',\n    ),\n    ...(canonicalRef ? [canonicalRef] : []),\n  ]);\n\n  if (rawDecision === 'merge_keep_one' && !canonicalRef) {\n    throw new CliError(`Decision row ${clusterId} is missing canonical flow information.`, {\n      code: 'FLOW_MATERIALIZE_DECISIONS_CANONICAL_REQUIRED',\n      exitCode: 2,\n      details: row,\n    });\n  }\n\n  if (rawDecision === 'merge_keep_one' && memberRefs.length < 2) {\n    throw new CliError(\n      `Decision row ${clusterId} needs at least two cluster members for merge_keep_one.`,\n      {\n        code: 'FLOW_MATERIALIZE_DECISIONS_MEMBERS_REQUIRED',\n        exitCode: 2,\n        details: row,\n      },\n    );\n  }\n\n  return {\n    clusterId,\n    decision: rawDecision,\n    reason: normalizeToken(row.reason ?? row.notes ?? row.message),\n    canonicalRef,\n    memberRefs,\n  };\n}\n\nfunction buildFlowIndex(rows: JsonRecord[]): Map<string, IndexedFlowRow> {\n  const index = new Map<string, IndexedFlowRow>();\n  rows.forEach((row, rowIndex) => {\n    const record = extractFlowRecord(row);\n    const key = `${record.id}@${record.version}`;\n    if (index.has(key)) {\n      throw new CliError(`Duplicate flow row detected for ${key}.`, {\n        code: 'FLOW_MATERIALIZE_DECISIONS_DUPLICATE_FLOW_ROW',\n        exitCode: 2,\n        details: {\n          flow_key: key,\n          first_index: [...index.keys()].indexOf(key),\n          duplicate_index: rowIndex,\n        },\n      });\n    }\n    index.set(key, {\n      key,\n      row,\n      record,\n    });\n  });\n  return index;\n}\n\nfunction summarizeFlow(record: FlowRecord): CanonicalFlowSummary {\n  return {\n    id: record.id,\n    version: record.version,\n    name: record.name,\n    flow_type: record.flowType,\n  };\n}\n\nfunction buildOutputFiles(outDir: string): FlowMaterializeDecisionsFiles {\n  return {\n    canonical_map: path.join(outDir, 'flow-dedup-canonical-map.json'),\n    rewrite_plan: path.join(outDir, 'flow-dedup-rewrite-plan.json'),\n    semantic_merge_seed: path.join(outDir, 'manual-semantic-merge-seed.current.json'),\n    summary: path.join(outDir, 'decision-summary.json'),\n    blocked_clusters: path.join(outDir, 'blocked-clusters.json'),\n  };\n}\n\nfunction incrementCount(record: Record<string, number>, key: string): void {\n  record[key] = (record[key] ?? 0) + 1;\n}\n\nfunction sortedObject<T>(entries: Array<[string, T]>): Record<string, T> {\n  return Object.fromEntries(entries.sort(([left], [right]) => left.localeCompare(right)));\n}\n\nexport async function runFlowMaterializeDecisions(\n  options: RunFlowMaterializeDecisionsOptions,\n): Promise<FlowMaterializeDecisionsReport> {\n  const decisionFile = assertInputFile(\n    options.decisionFile,\n    'FLOW_MATERIALIZE_DECISIONS_DECISION_FILE_REQUIRED',\n    'FLOW_MATERIALIZE_DECISIONS_DECISION_FILE_NOT_FOUND',\n  );\n  const flowRowsFile = assertInputFile(\n    options.flowRowsFile,\n    'FLOW_MATERIALIZE_DECISIONS_FLOW_ROWS_FILE_REQUIRED',\n    'FLOW_MATERIALIZE_DECISIONS_FLOW_ROWS_FILE_NOT_FOUND',\n  );\n  const outDir = assertOutDir(options.outDir);\n  const generatedAt = (options.now ?? new Date()).toISOString();\n  const files = buildOutputFiles(outDir);\n\n  const decisions = loadRowsFromFile(decisionFile).map((row, index) =>\n    parseDecisionRow(row, index),\n  );\n  const flowIndex = buildFlowIndex(loadRowsFromFile(flowRowsFile));\n\n  const canonicalClusters: CanonicalMapCluster[] = [];\n  const canonicalMapEntries: Array<[string, CanonicalMapEntry]> = [];\n  const rewriteActions: RewritePlanAction[] = [];\n  const seedAliasEntries: Array<[string, CanonicalMapEntry]> = [];\n  const blockedClusters: BlockedCluster[] = [];\n  const decisionCounts: FlowMaterializeDecisionCounts['decision_counts'] = {\n    merge_keep_one: 0,\n    keep_distinct: 0,\n    blocked_missing_db_flow: 0,\n  };\n  const blockedReasonCounts: Record<string, number> = {};\n\n  decisions.forEach((decision) => {\n    decisionCounts[decision.decision] += 1;\n\n    if (decision.decision === 'keep_distinct') {\n      blockedClusters.push({\n        cluster_id: decision.clusterId,\n        decision: decision.decision,\n        blocker_code: 'decision_keep_distinct',\n        reason: decision.reason,\n        canonical_flow: decision.canonicalRef,\n        cluster_members: decision.memberRefs,\n        missing_flow_keys: [],\n      });\n      incrementCount(blockedReasonCounts, 'decision_keep_distinct');\n      return;\n    }\n\n    if (decision.decision === 'blocked_missing_db_flow') {\n      blockedClusters.push({\n        cluster_id: decision.clusterId,\n        decision: decision.decision,\n        blocker_code: 'blocked_missing_db_flow',\n        reason: decision.reason,\n        canonical_flow: decision.canonicalRef,\n        cluster_members: decision.memberRefs,\n        missing_flow_keys: [],\n      });\n      incrementCount(blockedReasonCounts, 'blocked_missing_db_flow');\n      return;\n    }\n\n    const canonicalRef = decision.canonicalRef as FlowRef;\n    const canonicalKey = `${canonicalRef.id}@${canonicalRef.version}`;\n    const missingFlowKeys = decision.memberRefs\n      .map((ref) => `${ref.id}@${ref.version}`)\n      .filter((key) => !flowIndex.has(key));\n\n    if (!flowIndex.has(canonicalKey)) {\n      blockedClusters.push({\n        cluster_id: decision.clusterId,\n        decision: decision.decision,\n        blocker_code: 'merge_canonical_flow_missing',\n        reason: decision.reason,\n        canonical_flow: canonicalRef,\n        cluster_members: decision.memberRefs,\n        missing_flow_keys: [...new Set([canonicalKey, ...missingFlowKeys])],\n      });\n      incrementCount(blockedReasonCounts, 'merge_canonical_flow_missing');\n      return;\n    }\n\n    if (missingFlowKeys.length > 0) {\n      blockedClusters.push({\n        cluster_id: decision.clusterId,\n        decision: decision.decision,\n        blocker_code: 'flow_row_missing',\n        reason: decision.reason,\n        canonical_flow: canonicalRef,\n        cluster_members: decision.memberRefs,\n        missing_flow_keys: [...new Set(missingFlowKeys)].sort(),\n      });\n      incrementCount(blockedReasonCounts, 'flow_row_missing');\n      return;\n    }\n\n    const canonicalFlow = flowIndex.get(canonicalKey) as IndexedFlowRow;\n    const mergeReason = decision.reason ?? 'approved_merge_keep_one';\n    const mergedFlows = decision.memberRefs\n      .map((ref) => flowIndex.get(`${ref.id}@${ref.version}`) as IndexedFlowRow)\n      .sort((left, right) => left.key.localeCompare(right.key))\n      .map((entry) => ({\n        ...summarizeFlow(entry.record),\n        relation:\n          entry.key === canonicalKey\n            ? ('canonical_self' as const)\n            : ('rewrite_to_canonical' as const),\n      }));\n\n    canonicalClusters.push({\n      cluster_id: decision.clusterId,\n      decision: 'merge_keep_one',\n      reason: decision.reason,\n      canonical_flow: summarizeFlow(canonicalFlow.record),\n      merged_flows: mergedFlows,\n    });\n\n    mergedFlows.forEach((flow) => {\n      canonicalMapEntries.push([\n        `${flow.id}@${flow.version}`,\n        {\n          id: canonicalFlow.record.id,\n          version: canonicalFlow.record.version,\n          cluster_id: decision.clusterId,\n          relation: flow.relation,\n          reason: mergeReason,\n        },\n      ]);\n\n      if (flow.relation === 'rewrite_to_canonical') {\n        rewriteActions.push({\n          cluster_id: decision.clusterId,\n          action: 'rewrite_to_canonical',\n          reason: mergeReason,\n          source_flow_id: flow.id,\n          source_flow_version: flow.version,\n          source_flow_name: flow.name,\n          source_flow_type: flow.flow_type,\n          target_flow_id: canonicalFlow.record.id,\n          target_flow_version: canonicalFlow.record.version,\n          target_flow_name: canonicalFlow.record.name,\n          target_flow_type: canonicalFlow.record.flowType,\n        });\n        seedAliasEntries.push([\n          `${flow.id}@${flow.version}`,\n          {\n            id: canonicalFlow.record.id,\n            version: canonicalFlow.record.version,\n            cluster_id: decision.clusterId,\n            relation: 'rewrite_to_canonical',\n            reason: mergeReason,\n          },\n        ]);\n      }\n    });\n  });\n\n  const canonicalMapByFlowKey = sortedObject(canonicalMapEntries);\n  const semanticMergeSeed = sortedObject(\n    seedAliasEntries.map(([key, value]) => [\n      key,\n      {\n        id: value.id,\n        version: value.version,\n        reason: value.reason,\n        cluster_id: value.cluster_id,\n      },\n    ]),\n  );\n  const report: FlowMaterializeDecisionsReport = {\n    schema_version: 1,\n    generated_at_utc: generatedAt,\n    status:\n      blockedClusters.length > 0\n        ? 'completed_local_flow_decision_materialization_with_blocked_clusters'\n        : 'completed_local_flow_decision_materialization',\n    decision_file: decisionFile,\n    flow_rows_file: flowRowsFile,\n    out_dir: outDir,\n    counts: {\n      input_decisions: decisions.length,\n      materialized_clusters: canonicalClusters.length,\n      blocked_clusters: blockedClusters.length,\n      canonical_map_entries: Object.keys(canonicalMapByFlowKey).length,\n      rewrite_actions: rewriteActions.length,\n      seed_alias_entries: Object.keys(semanticMergeSeed).length,\n      decision_counts: decisionCounts,\n      blocked_reason_counts: blockedReasonCounts,\n    },\n    files,\n  };\n\n  writeJsonArtifact(files.canonical_map, {\n    schema_version: 1,\n    generated_at_utc: generatedAt,\n    clusters: canonicalClusters.sort((left, right) =>\n      left.cluster_id.localeCompare(right.cluster_id),\n    ),\n    by_flow_key: canonicalMapByFlowKey,\n  });\n  writeJsonArtifact(files.rewrite_plan, {\n    schema_version: 1,\n    generated_at_utc: generatedAt,\n    actions: rewriteActions.sort((left, right) => {\n      const clusterOrder = left.cluster_id.localeCompare(right.cluster_id);\n      if (clusterOrder !== 0) {\n        return clusterOrder;\n      }\n      const leftKey = `${left.source_flow_id}@${left.source_flow_version}`;\n      const rightKey = `${right.source_flow_id}@${right.source_flow_version}`;\n      return leftKey.localeCompare(rightKey);\n    }),\n  });\n  writeJsonArtifact(files.semantic_merge_seed, semanticMergeSeed);\n  writeJsonArtifact(files.blocked_clusters, {\n    schema_version: 1,\n    generated_at_utc: generatedAt,\n    clusters: blockedClusters.sort((left, right) =>\n      left.cluster_id.localeCompare(right.cluster_id),\n    ),\n  });\n  writeJsonArtifact(files.summary, report);\n\n  return report;\n}\n\nexport const __testInternals = {\n  parseDecisionRow,\n  parseFlowRefLike,\n  parseFlowRefString,\n  uniqueFlowRefs,\n  buildFlowIndex,\n  buildOutputFiles,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiangong-lca/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Unified TianGong LCA CLI with direct REST adapters and low-entropy command surface.",
   "repository": {
     "type": "git",