Artifact Freshness

1#!/usr/bin/env node
2'use strict';
3
4const path = require('node:path');
5const {
6  createFreshnessMetadata,
7  validateImportPlanFreshness,
8  writeFreshnessMetadata,
9  writeImportPlanDelta,
10} = require('../lib/artifact-freshness.js');
11
12function parseArgs(argv) {
13  const args = { _: [] };
14  for (let i = 0; i < argv.length; i += 1) {
15    const arg = argv[i];
16    if (arg.startsWith('--')) {
17      const key = arg.slice(2).replace(/-([a-z])/g, (_, char) => char.toUpperCase());
18      const next = argv[i + 1];
19      if (!next || next.startsWith('--')) {
20        args[key] = true;
21      } else {
22        args[key] = next;
23        i += 1;
24      }
25    } else {
26      args._.push(arg);
27    }
28  }
29  return args;
30}
31
32function usage() {
33  return [
34    'Usage:',
35    '  node scripts/artifact-freshness.js write <projectDir> --domains-dir <domainsDir> [--metadata <path>]',
36    '  node scripts/artifact-freshness.js check <projectDir> --domains-dir <domainsDir> [--metadata <path>] [--delta <path>]',
37  ].join('\n');
38}
39
40function main() {
41  const args = parseArgs(process.argv.slice(2));
42  const command = args._[0];
43  const projectDir = args._[1] ? path.resolve(args._[1]) : null;
44  if (args.help) {
45    process.stderr.write(`${usage()}\n`);
46    process.exit(0);
47  }
48  if (!command || !projectDir || args.help) {
49    process.stderr.write(`${usage()}\n`);
50    process.exit(1);
51  }
52  const domainsDir = args.domainsDir ? path.resolve(args.domainsDir) : null;
53  const metadataPath = args.metadata || 'execution/review/import-plan.freshness.json';
54  if (command === 'write') {
55    const metadata = createFreshnessMetadata({ projectDir, domainsDir });
56    writeFreshnessMetadata(path.resolve(projectDir, metadataPath), metadata);
57    process.stdout.write(`${JSON.stringify({ ok: true, metadataPath }, null, 2)}\n`);
58    return;
59  }
60  if (command === 'check') {
61    const result = validateImportPlanFreshness({ projectDir, domainsDir, metadataPath });
62    if (!result.ok && args.delta) {
63      writeImportPlanDelta(path.resolve(projectDir, args.delta), result);
64    }
65    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
66    process.exit(result.ok ? 0 : 1);
67  }
68  throw new Error(`Unknown command: ${command}\n${usage()}`);
69}
70
71try {
72  main();
73} catch (error) {
74  process.stderr.write(`${error.message}\n`);
75  process.exit(1);
76}