Promote Source Coverage

1#!/usr/bin/env node
2'use strict';
3
4// Promote a full adapter's source-coverage record into the canonical discovery artifacts.
5//
6//   node scripts/promote-source-coverage.js <projectDir> --adapter wordpress|csv|shopify
7//
8// Run after `source-schema.json` is synthesized. Validates
9// `data/<source>-discovery/source-coverage.json`, writes `discovery/source-coverage.json`, and
10// stamps `sourceCoverageContract: 1` on the project-root `source-schema.json` -- the only place any
11// consumer reads that stamp from. Quick modes write their own coverage at `plan`.
12//
13// It also promotes the adapter's `source-locale.json` to `discovery/source-locale.json`
14// (currency, time zone, language, country -- unknown values are explicit). A missing or invalid
15// regional file refuses promotion exactly like a missing coverage file: there is no unstamped path.
16//
17// Exit codes: 0 promoted; 2 refused (unknown adapter, adapter file missing or malformed, or no
18// source-schema.json yet); 1 usage error.
19
20const path = require('node:path');
21const { promoteSourceCoverage, SourceCoverageError } = require('../../../lib/source-coverage.js');
22const { promoteSourceRegional, SourceRegionalError } = require('../../../lib/source-regional.js');
23
24async function main() {
25  const argv = process.argv.slice(2);
26  let adapter = null;
27  const positional = [];
28  for (let i = 0; i < argv.length; i += 1) {
29    if (argv[i] === '--adapter') { adapter = argv[i + 1]; i += 1; } else positional.push(argv[i]);
30  }
31  const [projectDirArg] = positional;
32  if (!projectDirArg || !adapter) {
33    process.stderr.write('Usage: promote-source-coverage.js <projectDir> --adapter wordpress|csv|shopify\n');
34    return 1;
35  }
36  try {
37    const projectDir = path.resolve(projectDirArg);
38    const result = await promoteSourceCoverage(projectDir, { adapter });
39    await promoteSourceRegional(projectDir, { adapter });
40    process.stdout.write(`${JSON.stringify({ ok: true, adapter, rows: result.rows, artifact: 'discovery/source-coverage.json', locale: 'discovery/source-locale.json' })}\n`);
41    return 0;
42  } catch (error) {
43    if (error instanceof SourceCoverageError || error instanceof SourceRegionalError) {
44      process.stderr.write(`refused: ${error.message}\n`);
45      return 2;
46    }
47    throw error;
48  }
49}
50
51main().then((code) => { process.exitCode = code; }).catch((error) => {
52  process.stderr.write(`${error.stack || error.message}\n`);
53  process.exitCode = 1;
54});