d314c44043
Every reference to the Driver in internal/ is reworded the same way as in library/: the reason stays, the speaker and the quote go, an open decision reads "provisional, pending a product decision", and agent names and decision- sheet rows are dropped. Where a gate printed the word, its message now names the reviewer or the ruling instead. Three spots were code, not comments, and changed with their callers: - the element census's allowlist field `driver` is now `ruling`, in the gate and both presets (same validation: match, ruling, date and card required); - check:i18n-never-translated's DRIVER-GATED marker is DECISION-PENDING, in the entries and in the regex that counts them (its output is otherwise byte-identical); - the package.json description of the census says "ruling". public-hygiene-check keeps its two patterns for the word: they are what keep it out of the served folder.
145 lines
8.3 KiB
JavaScript
145 lines
8.3 KiB
JavaScript
#!/usr/bin/env node
|
|
// check-packet-strings-parity — the PACKET catalog must be whole in every language.
|
|
//
|
|
// ★ THE GAP THIS CLOSES. check:i18n-parity guards library/i18n/locales — the APP
|
|
// catalogs — and nothing guarded library/scripts/posters/packet-strings.json, which
|
|
// is a separate file with its own shape. Six gates READ it (check-packet-render,
|
|
// check-card-deck, check-print-geometry, check-packet-browser, check-locale-reachable,
|
|
// check-poster-prints) and not one checks that a language block is complete.
|
|
//
|
|
// That matters because the packet is where the 12 PRAYER POINTS and the PRAYER WHEEL
|
|
// live, and those are a stated requirement: they must be translatable into every
|
|
// locale doxa-life needs. A point silently dropped from one block renders that slot
|
|
// through the per-key English fallback — correct runtime behaviour, invisible defect.
|
|
//
|
|
// ⚠ IT ASSERTS PRESENCE, NOT TRANSLATEDNESS, and that distinction is load-bearing.
|
|
// check-packet-render prints "19 strings translated" and only ever asserted
|
|
// `translated === 0`, so a locale regressing from 19 to 1 passed silently. The fix is
|
|
// NOT to pin 19: measured 2026-09-24, de translates 18 and fr 17 of the same 19 keys
|
|
// because a word or two legitimately matches English ("Metacamp", "Status"). Pinning a
|
|
// count fails correct catalogs. What DOES hold for every locale is that every English
|
|
// key EXISTS in every block — a structural fact no translation choice can change.
|
|
//
|
|
// THE ONE DECLARED EXCEPTION is point4_passage + point4_passage_credit: Mark 5:1-20 in
|
|
// full, absent from all ten non-English blocks. That is a LICENSING decision, not an
|
|
// oversight — the English is deliberately public-domain (World English Bible) and most
|
|
// major translations are copyrighted, so it is tracked as
|
|
// DECIDE-MARK5-SCRIPTURE-IS-ENGLISH-IN-EVERY-TRANSLATED-PACKET. It is named here
|
|
// rather than silently tolerated, so the day someone lands a licensed translation the
|
|
// exception can be deleted and the gate tightens by itself.
|
|
import { readFileSync, existsSync } from 'node:fs'
|
|
import { resolve, dirname, join } from 'node:path'
|
|
import { fileURLToPath } from 'node:url'
|
|
|
|
const REPO = process.env.DOXA_REPO
|
|
|| resolve(dirname(fileURLToPath(import.meta.url)), '..')
|
|
const CATALOG = process.env.PACKET_STRINGS
|
|
|| join(REPO, 'library/scripts/posters/packet-strings.json')
|
|
|
|
if (!existsSync(CATALOG)) {
|
|
console.error(`PACKET-STRINGS-PARITY: FAIL — no catalog at ${CATALOG}`)
|
|
process.exit(1)
|
|
}
|
|
const cat = JSON.parse(readFileSync(CATALOG, 'utf8'))
|
|
const en = cat.en
|
|
if (!en) { console.error('PACKET-STRINGS-PARITY: FAIL — no English block to compare against'); process.exit(1) }
|
|
|
|
// Keys deliberately absent from translated blocks, with the reason. An entry here is a
|
|
// DECISION on record, not a silence — and removing one tightens the gate automatically.
|
|
const DECLARED_ABSENT = {
|
|
// ⚠ STILL DECLARED, BUT FOR FIVE FEWER LOCALES (2026-09-27). ar/ru/es/de/fr now carry a published
|
|
// PUBLIC-DOMAIN translation each — Van Dyck, Synodal, Reina-Valera 1909, Luther 1912, Ostervald —
|
|
// fetched with their licence metadata and recorded in data/people-groups/scripture-sources.json.
|
|
// hi/zh/pt/it/ro remain English: PD candidates exist but I could not confirm their licence status,
|
|
// and Scripture is never machine-translated OR reproduced from memory, which is the same failure
|
|
// wearing more confidence. This entry shrinks as each locale's text is cited, not as a batch.
|
|
point4_passage: 'Mark 5:1-20 — awaiting a CITED public-domain translation for hi/zh/pt/it/ro',
|
|
point4_passage_credit: 'the attribution line for the passage above',
|
|
// ── The new packet pages, 2026-09-27: a 100-year life calendar, the same grid shaded by
|
|
// the evangelical share of these groups' population, and the funnel's equation sidebar + tip.
|
|
// ENGLISH-ONLY ON PURPOSE, and declared rather than back-filled: English text copied into ten
|
|
// locale blocks would make them read as TRANSLATED to this gate and to a reader, which is worse
|
|
// than an honest gap — the per-KEY fallback already renders English without the lie. These come out
|
|
// of this list one at a time as real translations arrive.
|
|
}
|
|
|
|
// Language blocks are the short keys; anything longer is metadata, not a locale.
|
|
const locales = Object.keys(cat).filter((k) => k !== 'en' && k.length <= 3)
|
|
const strKeys = Object.keys(en).filter((k) => typeof en[k] === 'string')
|
|
|
|
const fails = []
|
|
const notes = []
|
|
const rows = []
|
|
|
|
for (const loc of locales) {
|
|
const b = cat[loc]
|
|
const missing = strKeys.filter((k) => typeof b[k] !== 'string' && !(k in DECLARED_ABSENT))
|
|
const absentOk = strKeys.filter((k) => typeof b[k] !== 'string' && (k in DECLARED_ABSENT))
|
|
if (missing.length) {
|
|
fails.push(`${loc} is missing ${missing.length} string key(s): ${missing.slice(0, 4).join(', ')}`)
|
|
}
|
|
|
|
// ── THE 12 PRAYER POINTS ──────────────────────────────────────────────────
|
|
// Structure, not prose: twelve of them, each carrying every field the renderer
|
|
// reads. A point with no `text` prints an empty block on a page the reader is
|
|
// meant to pray through.
|
|
const pts = b.points
|
|
if (!Array.isArray(pts)) {
|
|
fails.push(`${loc} has no points array — the 12 prayer points would fall back wholesale to English`)
|
|
} else if (pts.length !== en.points.length) {
|
|
fails.push(`${loc} has ${pts.length} prayer points, expected ${en.points.length}`)
|
|
} else {
|
|
for (let i = 0; i < pts.length; i++) {
|
|
const missF = Object.keys(en.points[i]).filter((f) => pts[i][f] === undefined)
|
|
if (missF.length) fails.push(`${loc} point ${i + 1} is missing ${missF.join(', ')}`)
|
|
if (typeof pts[i].text === 'string' && !pts[i].text.trim()) {
|
|
fails.push(`${loc} point ${i + 1} has an EMPTY text — a blank prayer point is worse than an English one`)
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── THE PRAYER WHEEL ──────────────────────────────────────────────────────
|
|
// Twelve rhythms, keyed the same as English. check-packet-render already asserts
|
|
// all twelve RENDER; this asserts the catalog can supply them in the first place.
|
|
const rh = b.rhythms
|
|
if (!rh || typeof rh !== 'object') {
|
|
fails.push(`${loc} has no rhythms block — the prayer wheel would be English in a ${loc} packet`)
|
|
} else {
|
|
const missR = Object.keys(en.rhythms).filter((k) => typeof rh[k] !== 'string')
|
|
if (missR.length) fails.push(`${loc} is missing ${missR.length} wheel rhythm(s): ${missR.slice(0, 4).join(', ')}`)
|
|
}
|
|
|
|
const translated = strKeys.filter((k) => typeof b[k] === 'string' && b[k] !== en[k]).length
|
|
const present = strKeys.filter((k) => typeof b[k] === 'string').length
|
|
rows.push({ loc, present, translated, absentOk: absentOk.length })
|
|
// Reported, never failed: a locale sharing a word with English is normal, but a
|
|
// locale sharing ALL of them is indistinguishable from an untranslated block.
|
|
if (present && translated === 0) {
|
|
fails.push(`${loc} has ${present} string(s) and NOT ONE differs from English — `
|
|
+ 'the block is present but untranslated, which a reader cannot tell from a missing one')
|
|
}
|
|
}
|
|
|
|
console.log('PACKET-STRINGS-PARITY')
|
|
console.log(` catalog : ${CATALOG.replace(REPO + '/', '')}`)
|
|
console.log(` locales : ${locales.length} (${locales.join(' ')})`)
|
|
console.log(` shape : ${strKeys.length} string key(s) + ${en.points.length} prayer points + `
|
|
+ `${Object.keys(en.rhythms).length} wheel rhythms`)
|
|
for (const r of rows) {
|
|
console.log(` ${r.loc.padEnd(3)} ${String(r.present).padStart(2)}/${strKeys.length} present`
|
|
+ ` ${String(r.translated).padStart(2)} translated`
|
|
+ (r.absentOk ? ` (${r.absentOk} declared-absent)` : ''))
|
|
}
|
|
if (Object.keys(DECLARED_ABSENT).length) {
|
|
console.log('\n declared absent from every translated block, on record:')
|
|
for (const [k, why] of Object.entries(DECLARED_ABSENT)) console.log(` ${k} — ${why}`)
|
|
}
|
|
for (const n of notes) console.log(' ' + n)
|
|
|
|
if (fails.length) {
|
|
console.error(`\nPACKET-STRINGS-PARITY: FAIL — ${fails.length} problem(s)`)
|
|
for (const f of fails) console.error(' - ' + f)
|
|
process.exit(1)
|
|
}
|
|
console.log('\nPACKET-STRINGS-PARITY: PASS — every language block carries the whole packet: '
|
|
+ 'all string keys, all 12 prayer points with every field, and all 12 wheel rhythms.')
|