24f965b6a4
key-cities is a gated profile: generate-tree leaves it out of the manifest and the pages. Its bundle file was still in public/dx-maps/key-cities/key-cities.js, committed, and the landing freshness pass rebuilt it into public/ every time it looked "stale", so any host that serves or drops in the tree folder whole shipped it. - vite.config.js builds a gated bundle into .gated/<tree>/ (ignored by git) instead of public/. - check:composite-freshness skips gated bundles: they have no committed bytes to be fresh against. - The committed public/dx-maps/key-cities/ is removed. History is not rewritten. - generate-tree removes a gated folder it finds in the tree (an older build, or a landing that kept the tree's side of a conflict), so the tree it writes is clean whatever came before. Measured: a planted public/dx-maps/key-cities/key-cities.js fails the gate, and one regeneration removes it. - The gated list is read in one place, internal/_tree-name.mjs, beside the tree name. - check:gated-not-in-tree (gates:pre) fails if a gated name has a folder in the tree, a manifest entry, or a page referencing its script, and proves each arm on a planted leak first. It FAILED on the tree before this change (key-cities/ is in the tree) and PASSES after. The data tables are left alone on purpose: key-cities.json also feeds the production Cities with Internet map, and whether that dataset should be public is a separate decision.
56 lines
2.8 KiB
JavaScript
56 lines
2.8 KiB
JavaScript
/**
|
|
* _tree-name.mjs — the ONE place the output tree's name is read.
|
|
*
|
|
* The built tree lives at public/<TREE_NAME>/ and every embeddable URL carries it
|
|
* (…/<TREE_NAME>/<bundle>/<profile>/index.html). Its name has always been configurable —
|
|
* vite.doxa-maps-build-config.json `name` — but a census on 2026-09-25 found 61 tooling files
|
|
* that ignored the knob and hardcoded 'doxa-maps' (181 literals), so changing the config renamed
|
|
* the build while those gates kept reading the old folder. Every tool now imports TREE_NAME from
|
|
* here, which makes renaming the tree a one-line config change (see
|
|
* _qa-cycle/03-deployment-cycle/qa-loops/RENAME-IMPACT-dx.md, mechanism A).
|
|
*
|
|
* import { TREE_NAME, BUILD_CONFIG_FILE } from './_tree-name.mjs'
|
|
* TREE=$(node internal/_tree-name.mjs) # from a shell script
|
|
*
|
|
* The fallback, used only when the config is missing or has no name, is the historical name,
|
|
* so a checkout without the config behaves exactly as before.
|
|
*/
|
|
import { readFileSync } from 'node:fs'
|
|
import { resolve, dirname } from 'node:path'
|
|
import { fileURLToPath } from 'node:url'
|
|
|
|
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
|
|
export const BUILD_CONFIG_FILE = resolve(ROOT, 'vite.doxa-maps-build-config.json')
|
|
const FALLBACK = 'doxa-maps'
|
|
|
|
function read() {
|
|
let name = ''
|
|
try {
|
|
const cfg = JSON.parse(readFileSync(BUILD_CONFIG_FILE, 'utf8'))
|
|
if (cfg && typeof cfg.name === 'string') name = cfg.name.trim()
|
|
} catch { /* no config: the fallback */ }
|
|
if (!name) return FALLBACK
|
|
// A tree name is ONE path segment that also appears in public URLs: refuse anything that could
|
|
// escape public/ or need escaping in a URL, rather than build into a surprising place.
|
|
if (!/^[a-z0-9][a-z0-9._-]*$/i.test(name) || name.includes('..')) {
|
|
throw new Error(`[_tree-name] build config "name" must be a single URL-safe path segment, got ${JSON.stringify(name)}`)
|
|
}
|
|
return name
|
|
}
|
|
|
|
export const TREE_NAME = read()
|
|
// GATED profiles (the config's gatedProfiles): bundles that build but must never reach a public surface.
|
|
// generate-tree leaves them out of the manifest and pages; vite.config.js builds them OUTSIDE public/
|
|
// (.gated/<tree>/); check:gated-not-in-tree fails if one appears in the tree anyway.
|
|
function readGated() {
|
|
try {
|
|
const cfg = JSON.parse(readFileSync(BUILD_CONFIG_FILE, 'utf8'))
|
|
return Array.isArray(cfg.gatedProfiles) ? cfg.gatedProfiles.filter((x) => typeof x === 'string' && x.trim()).map((x) => x.trim()) : []
|
|
} catch { return [] }
|
|
}
|
|
export const GATED_PROFILES = readGated()
|
|
|
|
// The name escaped for use inside a RegExp source (a '.' in a future name must not match any char).
|
|
export const TREE_NAME_RE = TREE_NAME.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
|
|
|
|
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) process.stdout.write(TREE_NAME + '\n')
|