Dependency Preflight

1#!/usr/bin/env node
2'use strict';
3
4// Mapping dependency preflight, before mapping approval:
5//
6//   node scripts/dependency-preflight.js --project-dir <dir>
7//       Resolves every proposed dependent operation's dependencies from the mapping plan, census
8//       and source evidence (no setup plan or execution manifest needed), validates noProducer
9//       proofs, and writes mapping/review/dependency-preflight.json. Exit 2 when the mapping is not
10//       structurally ready; each diagnostic names the dependent edge and the next step.
11//   node scripts/dependency-preflight.js --project-dir <dir> --contract-digest <entityRef> <operation>
12//       Prints the operationContractDigest a proof for that operation must bind.
13
14const path = require('node:path');
15const readiness = require('../lib/dependency-readiness.js');
16const proofs = require('../lib/dependency-proofs.js');
17
18async function main(argv) {
19  const index = argv.indexOf('--project-dir');
20  const digestAt = argv.indexOf('--contract-digest');
21  if (digestAt >= 0) {
22    const resolve = () => proofs.operationContract(argv[digestAt + 1], argv[digestAt + 2]);
23    const found = index >= 0 && argv[index+1] ? require('../lib/operation-assessments').withProject(path.resolve(argv[index+1]),resolve) : resolve();
24    if (!found) { console.error(`no reviewed operation contract for ${argv[digestAt + 1]} ${argv[digestAt + 2]}`); return 2; }
25    console.log(JSON.stringify({ entityRef: argv[digestAt + 1], operation: found.name, operationContractDigest: proofs.contractDigest(found.contract), dependencies: found.contract.dependencies }, null, 2));
26    return 0;
27  }
28  if (index < 0 || !argv[index + 1]) { console.error('usage: dependency-preflight.js --project-dir <dir> [--contract-digest <entityRef> <operation>]'); return 1; }
29  const report = await readiness.preflightMappingDependencies(path.resolve(argv[index + 1]));
30  console.log(JSON.stringify({ structuralReady: report.structuralReady, executionReady: report.executionReady, pendingSetup: report.pendingSetup, errors: report.errors, work: report.work }, null, 2));
31  return report.structuralReady ? 0 : 2;
32}
33
34main(process.argv.slice(2)).then(code => { process.exitCode = code; }, error => { console.error(error.message); process.exitCode = 1; });