@indigoai-us/hq-cli 5.50.0 → 5.50.1

package/scripts/generate-scan-packages-table.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+/**
+ * generate-scan-packages-table.mjs (US-003)
+ *
+ * Emits the bash data block that `core/scripts/scan-packages.sh` reads, from the
+ * single-source `src/utils/contribution-table.ts`. This keeps the bash wirer
+ * GENERATED FROM the table rather than restating the mapping -- the US-003
+ * single-source-of-truth invariant.
+ *
+ * The TS table is the authority; this script transcribes it to bash. It does
+ * NOT parse TypeScript -- it imports the same literal data by re-declaring the
+ * rows is avoided by reading the table via a tiny regex extraction of the
+ * `CONTRIBUTION_TABLE` object literal, so the table file stays the only place
+ * the rows live.
+ *
+ * Output: a bash snippet (to stdout, or written in place into scan-packages.sh
+ * between the BEGIN/END GENERATED markers when --write <path> is passed).
+ *
+ * Usage:
+ *   node scripts/generate-scan-packages-table.mjs                 # print block
+ *   node scripts/generate-scan-packages-table.mjs --check <path>  # verify in-sync
+ *   node scripts/generate-scan-packages-table.mjs --write <path>  # rewrite in place
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TABLE_TS = path.resolve(__dirname, '../src/utils/contribution-table.ts');
+
+const BEGIN = '# >>> BEGIN GENERATED contribution table (US-003) — do not edit by hand';
+const END = '# <<< END GENERATED contribution table';
+
+/**
+ * Extract the rows from the `CONTRIBUTION_TABLE` object literal in the TS file.
+ * Each row line looks like:
+ *   key: { payload: 'p/{item}', host: 'h', wire: 'symlink' },
+ */
+function readTable() {
+  const ts = fs.readFileSync(TABLE_TS, 'utf-8');
+  const open = ts.indexOf('export const CONTRIBUTION_TABLE');
+  if (open < 0) throw new Error('CONTRIBUTION_TABLE not found in ' + TABLE_TS);
+  const body = ts.slice(open, ts.indexOf('} as const', open));
+  const rowRe =
+    /^\s*([A-Za-z_][A-Za-z0-9_]*):\s*\{\s*payload:\s*'([^']+)'\s*,\s*host:\s*'([^']+)'\s*,\s*wire:\s*'([^']+)'\s*\}/gm;
+  const rows = [];
+  let m;
+  while ((m = rowRe.exec(body)) !== null) {
+    rows.push({ key: m[1], payload: m[2], host: m[3], wire: m[4] });
+  }
+  if (rows.length === 0) throw new Error('No rows parsed from CONTRIBUTION_TABLE');
+  return rows;
+}
+
+function renderBlock(rows) {
+  const lines = [];
+  lines.push(BEGIN);
+  lines.push('# Generated from hq-cli/src/utils/contribution-table.ts by');
+  lines.push('# hq-cli/scripts/generate-scan-packages-table.mjs. Regenerate with:');
+  lines.push('#   node scripts/generate-scan-packages-table.mjs --write core/scripts/scan-packages.sh');
+  lines.push('# Each row is "payload|host|wire" (payload uses {item} for the name).');
+  lines.push('# bash 3.2-compatible (macOS default bash has no associative arrays):');
+  lines.push('# a plain indexed key list + a generated case-lookup function.');
+  lines.push('CONTRIB_KEYS=(' + rows.map((r) => r.key).join(' ') + ')');
+  lines.push('# contrib_row <key> -> echoes "payload|host|wire", empty if unknown.');
+  lines.push('contrib_row() {');
+  lines.push('  case "$1" in');
+  for (const r of rows) {
+    lines.push(`    ${r.key}) printf '%s' '${r.payload}|${r.host}|${r.wire}' ;;`);
+  }
+  lines.push("    *) return 0 ;;");
+  lines.push('  esac');
+  lines.push('}');
+  lines.push(END);
+  return lines.join('\n');
+}
+
+function splice(scriptText, block) {
+  const b = scriptText.indexOf(BEGIN);
+  const e = scriptText.indexOf(END);
+  if (b < 0 || e < 0) {
+    throw new Error('BEGIN/END GENERATED markers not found in target script');
+  }
+  const before = scriptText.slice(0, b);
+  const after = scriptText.slice(e + END.length);
+  return before + block + after;
+}
+
+const rows = readTable();
+const block = renderBlock(rows);
+
+const arg = process.argv[2];
+const target = process.argv[3];
+
+if (arg === '--write') {
+  const text = fs.readFileSync(target, 'utf-8');
+  fs.writeFileSync(target, splice(text, block));
+  console.error(`Wrote generated contribution table into ${target}`);
+} else if (arg === '--check') {
+  const text = fs.readFileSync(target, 'utf-8');
+  const expected = splice(text, block);
+  if (expected !== text) {
+    console.error(
+      `OUT OF SYNC: ${target} differs from contribution-table.ts. ` +
+        `Run: node scripts/generate-scan-packages-table.mjs --write ${target}`,
+    );
+    process.exit(1);
+  }
+  console.error(`${target} is in sync with the contribution table.`);
+} else {
+  process.stdout.write(block + '\n');
+}