@pdtf/schemas 3.6.0-dev.3 → 3.6.0-dev.30

package/src/utils/syncTa6ed6v2Markers.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * Sync ta6ed6v2 markers from ta6ed6 across combined.json.
+ *
+ * ta6ed6v2 is a "full marker set" twin of ta6ed6: every shared field carries its
+ * own `ta6ed6v2*` markers so that inclusion is presence and suppression is the
+ * ABSENCE of a v2 ref (see src/tests/v3/ta6ed6v2.test.js — the drift-lint).
+ *
+ * Two subtrees intentionally diverge (their v2 shape is hand-authored) and are
+ * excluded from sync: propertyPack.heating and propertyPack.alterationsAndChanges.
+ *
+ * For every OTHER node, this tool guarantees each `ta6ed6<Suffix>` marker has a
+ * matching `ta6ed6v2<Suffix>` marker of equal value — adding missing twins and
+ * repairing drifted values. Edits are minimal text splices that preserve the
+ * file's existing formatting.
+ *
+ *   node src/utils/syncTa6ed6v2Markers.js          # apply (write)
+ *   node src/utils/syncTa6ed6v2Markers.js --check   # exit 1 if out of sync (CI)
+ *
+ * After running, regenerate overlays: node src/utils/extractOverlay.js
+ */
+const fs = require("fs");
+const path = require("path");
+
+const FILE = process.env.COMBINED_PATH || path.resolve(__dirname, "../schemas/v3/combined.json");
+const CHECK = process.argv.includes("--check");
+
+const MARKER_RE = /^ta6ed6(Ref|Required|Title|Description|Enum|EnumNames)$/;
+const v2Of = (k) => k.replace(/^ta6ed6/, "ta6ed6v2");
+// NOTE: array indices are numbers in the tokenizer path (strict-equal), so use 2 not "2".
+const COMPANY = ["properties", "participants", "items", "oneOf", 2, "properties", "sellersCapacity", "oneOf", 2, "properties"];
+const EXCLUDED_PREFIXES = [
+  ["properties", "propertyPack", "properties", "heating"],
+  ["properties", "propertyPack", "properties", "alterationsAndChanges"],
+  // §1.6 company seller fields: v2 realigns refs to the form (companyNumber→1.6.1,
+  // directorOrAuthorisedPerson→1.6.2) while ed6 keeps its existing refs — hand-authored.
+  [...COMPANY, "companyName"],
+  [...COMPANY, "companyNumber"],
+  [...COMPANY, "directorOrAuthorisedPerson"],
+];
+const isExcluded = (p) => EXCLUDED_PREFIXES.some((pre) => pre.every((seg, i) => p[i] === seg));
+
+// minimal position-tracking JSON tokenizer
+function tokenize(text) {
+  let i = 0; const n = text.length; const members = [];
+  const ws = () => { while (i < n && /\s/.test(text[i])) i++; };
+  const str = () => { i++; while (i < n) { const c = text[i]; if (c === "\\") { i += 2; continue; } if (c === '"') { i++; break; } i++; } };
+  const val = (p) => { ws(); const c = text[i]; if (c === "{") obj(p); else if (c === "[") arr(p); else if (c === '"') str(); else { while (i < n && !/[,}\]\s]/.test(text[i])) i++; } };
+  function obj(p) { i++; ws(); if (text[i] === "}") { i++; return; } while (i < n) { ws(); const ks = i; str(); const key = JSON.parse(text.slice(ks, i)); ws(); i++; ws(); const vs = i; val(p.concat(key)); members.push({ path: p.concat(key), key, keyStart: ks, valueStart: vs, valueEnd: i }); ws(); if (text[i] === ",") { i++; continue; } if (text[i] === "}") { i++; break; } break; } }
+  function arr(p) { i++; ws(); if (text[i] === "]") { i++; return; } let k = 0; while (i < n) { ws(); val(p.concat(k)); k++; ws(); if (text[i] === ",") { i++; continue; } if (text[i] === "]") { i++; break; } break; } }
+  ws(); val([]); return members;
+}
+
+let text = fs.readFileSync(FILE, "utf8");
+const members = tokenize(text);
+const owner = (m) => m.path.slice(0, -1).join("/");
+const keysByOwner = new Map();
+for (const m of members) { const o = owner(m); if (!keysByOwner.has(o)) keysByOwner.set(o, new Map()); keysByOwner.get(o).set(m.key, m); }
+const indentAt = (off) => text.slice(text.lastIndexOf("\n", off - 1) + 1, off);
+
+const edits = []; // {at, end, text}  (end omitted => pure insert)
+const adds = [], fixes = [];
+for (const m of members) {
+  if (!MARKER_RE.test(m.key)) continue;
+  if (isExcluded(m.path)) continue;
+  const v2 = v2Of(m.key);
+  const siblings = keysByOwner.get(owner(m));
+  const ed6Val = text.slice(m.valueStart, m.valueEnd);
+  if (!siblings.has(v2)) {
+    const indent = indentAt(m.keyStart);
+    edits.push({ at: m.valueEnd, text: `,\n${indent}"${v2}": ${ed6Val}` });
+    adds.push("/" + m.path.join("/"));
+  } else {
+    const tw = siblings.get(v2);
+    const v2Val = text.slice(tw.valueStart, tw.valueEnd);
+    if (JSON.stringify(JSON.parse(v2Val)) !== JSON.stringify(JSON.parse(ed6Val))) {
+      edits.push({ at: tw.valueStart, end: tw.valueEnd, text: ed6Val });
+      fixes.push("/" + tw.path.join("/"));
+    }
+  }
+}
+
+if (!edits.length) { console.log("ta6ed6v2 markers in sync — nothing to do."); process.exit(0); }
+console.log(`Out of sync: ${adds.length} missing twin(s), ${fixes.length} drifted value(s).`);
+[...adds, ...fixes].slice(0, 20).forEach((p) => console.log("  " + p));
+if (CHECK) process.exit(1);
+
+edits.sort((a, b) => b.at - a.at);
+for (const e of edits) text = text.slice(0, e.at) + e.text + text.slice(e.end ?? e.at);
+JSON.parse(text); // guard
+fs.writeFileSync(FILE, text);
+console.log(`Applied ${edits.length} edit(s) to ${FILE}. Now run: node src/utils/extractOverlay.js`);