Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 36ffe35dcd | |||
| 41be1ee73b | |||
| 0f8b17a1f6 |
@@ -1,521 +0,0 @@
|
||||
{
|
||||
"schema": 1,
|
||||
"purpose": "offline-specification-only",
|
||||
"sourceCommit": "39fb9df06904e44916e258da0ed975dd46b9691c",
|
||||
"baseline": "eb2538772e1bfabbeb291e4a5efa177c79074de1",
|
||||
"nodes": [
|
||||
{
|
||||
"id": "s:GB:county:warwickshire",
|
||||
"country": "GB",
|
||||
"type": "county",
|
||||
"label": "Warwickshire",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:GB:town:warwick",
|
||||
"country": "GB",
|
||||
"type": "town",
|
||||
"label": "Warwick",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:GB:town:leamington",
|
||||
"country": "GB",
|
||||
"type": "town",
|
||||
"label": "Royal Leamington Spa",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:NO:county:vestfold",
|
||||
"country": "NO",
|
||||
"type": "county",
|
||||
"label": "Vestfold",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:NO:municipality:tonsberg",
|
||||
"country": "NO",
|
||||
"type": "municipality",
|
||||
"label": "Tønsberg",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:NO:municipality:bergen",
|
||||
"country": "NO",
|
||||
"type": "municipality",
|
||||
"label": "Bergen",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:NO:county:oslo",
|
||||
"country": "NO",
|
||||
"type": "county",
|
||||
"label": "Oslo",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:NO:municipality:oslo",
|
||||
"country": "NO",
|
||||
"type": "municipality",
|
||||
"label": "Oslo",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:SE:county:stockholm",
|
||||
"country": "SE",
|
||||
"type": "county",
|
||||
"label": "Stockholm län",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:SE:municipality:stockholm",
|
||||
"country": "SE",
|
||||
"type": "municipality",
|
||||
"label": "Stockholm",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:SE:settlement:stockholm",
|
||||
"country": "SE",
|
||||
"type": "settlement",
|
||||
"label": "Stockholm",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:DE:state:bavaria",
|
||||
"country": "DE",
|
||||
"type": "state",
|
||||
"label": "Bavaria",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
},
|
||||
{
|
||||
"id": "s:FR:region:idf",
|
||||
"country": "FR",
|
||||
"type": "region",
|
||||
"label": "Île-de-France",
|
||||
"edition": "synthetic-1",
|
||||
"provenance": "synthetic-no-boundary-claim"
|
||||
}
|
||||
],
|
||||
"edges": [
|
||||
{
|
||||
"child": "s:GB:town:warwick",
|
||||
"parent": "s:GB:county:warwickshire",
|
||||
"type": "administrative-parent"
|
||||
},
|
||||
{
|
||||
"child": "s:GB:town:leamington",
|
||||
"parent": "s:GB:county:warwickshire",
|
||||
"type": "administrative-parent"
|
||||
},
|
||||
{
|
||||
"child": "s:NO:municipality:tonsberg",
|
||||
"parent": "s:NO:county:vestfold",
|
||||
"type": "administrative-parent"
|
||||
},
|
||||
{
|
||||
"child": "s:NO:municipality:oslo",
|
||||
"parent": "s:NO:county:oslo",
|
||||
"type": "administrative-parent"
|
||||
},
|
||||
{
|
||||
"child": "s:SE:municipality:stockholm",
|
||||
"parent": "s:SE:county:stockholm",
|
||||
"type": "administrative-parent"
|
||||
},
|
||||
{
|
||||
"child": "s:SE:settlement:stockholm",
|
||||
"parent": "s:SE:municipality:stockholm",
|
||||
"type": "settlement-intersects"
|
||||
},
|
||||
{
|
||||
"child": "s:NO:municipality:oslo",
|
||||
"parent": "s:NO:county:oslo",
|
||||
"type": "same-footprint"
|
||||
}
|
||||
],
|
||||
"scenarios": [
|
||||
{
|
||||
"name": "whole county children unchecked",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": []
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:county:warwickshire"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:county:warwickshire"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:county:warwickshire"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "explicit town refines county",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:warwick"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:town:warwick"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:town:warwick"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:town:warwick"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "two towns",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:warwick",
|
||||
"s:GB:town:leamington"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:town:warwick",
|
||||
"s:GB:town:leamington"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:town:warwick",
|
||||
"s:GB:town:leamington"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:town:warwick",
|
||||
"s:GB:town:leamington"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "remove one town",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:leamington"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:town:leamington"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:town:leamington"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:town:leamington"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "remove last town",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": []
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:county:warwickshire"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:county:warwickshire"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:county:warwickshire"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "independent Bergen branch",
|
||||
"countries": [
|
||||
"GB",
|
||||
"NO"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:warwick"
|
||||
]
|
||||
},
|
||||
{
|
||||
"root": "s:NO:municipality:bergen",
|
||||
"refinements": []
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:GB:town:warwick",
|
||||
"s:NO:municipality:bergen"
|
||||
],
|
||||
"tree": [
|
||||
"s:GB:town:warwick",
|
||||
"s:NO:municipality:bergen"
|
||||
],
|
||||
"map": [
|
||||
"s:GB:town:warwick",
|
||||
"s:NO:municipality:bergen"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "Vestfold whole",
|
||||
"countries": [
|
||||
"NO"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:NO:county:vestfold",
|
||||
"refinements": []
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:NO:county:vestfold"
|
||||
],
|
||||
"tree": [
|
||||
"s:NO:county:vestfold"
|
||||
],
|
||||
"map": [
|
||||
"s:NO:county:vestfold"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "Tonsberg refinement",
|
||||
"countries": [
|
||||
"NO"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:NO:county:vestfold",
|
||||
"refinements": [
|
||||
"s:NO:municipality:tonsberg"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:NO:municipality:tonsberg"
|
||||
],
|
||||
"tree": [
|
||||
"s:NO:municipality:tonsberg"
|
||||
],
|
||||
"map": [
|
||||
"s:NO:municipality:tonsberg"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "Oslo dual typed identity",
|
||||
"countries": [
|
||||
"NO"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:NO:county:oslo",
|
||||
"refinements": [
|
||||
"s:NO:municipality:oslo"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:NO:municipality:oslo"
|
||||
],
|
||||
"tree": [
|
||||
"s:NO:municipality:oslo"
|
||||
],
|
||||
"map": [
|
||||
"s:NO:municipality:oslo"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "Stockholm municipality is not settlement",
|
||||
"countries": [
|
||||
"SE"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:SE:county:stockholm",
|
||||
"refinements": [
|
||||
"s:SE:municipality:stockholm"
|
||||
]
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:SE:municipality:stockholm"
|
||||
],
|
||||
"tree": [
|
||||
"s:SE:municipality:stockholm"
|
||||
],
|
||||
"map": [
|
||||
"s:SE:municipality:stockholm"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "parent deselected removes children",
|
||||
"countries": [
|
||||
"GB"
|
||||
],
|
||||
"branches": [],
|
||||
"expected": {
|
||||
"query": [],
|
||||
"tree": [],
|
||||
"map": []
|
||||
},
|
||||
"expanded": []
|
||||
},
|
||||
{
|
||||
"name": "country change retains compatible branch",
|
||||
"countries": [
|
||||
"NO"
|
||||
],
|
||||
"branches": [
|
||||
{
|
||||
"root": "s:NO:municipality:bergen",
|
||||
"refinements": []
|
||||
}
|
||||
],
|
||||
"expected": {
|
||||
"query": [
|
||||
"s:NO:municipality:bergen"
|
||||
],
|
||||
"tree": [
|
||||
"s:NO:municipality:bergen"
|
||||
],
|
||||
"map": [
|
||||
"s:NO:municipality:bergen"
|
||||
]
|
||||
},
|
||||
"expanded": []
|
||||
}
|
||||
],
|
||||
"journeys": [
|
||||
{ "residence": "NO", "uiLocale": "en-GB", "countries": ["GB"], "adLanguages": ["en"], "documentLanguages": ["nb"] },
|
||||
{ "residence": "NO", "uiLocale": "nb-NO", "countries": ["SE"], "adLanguages": ["sv", "en"], "documentLanguages": ["nb"] },
|
||||
{ "residence": "DE", "uiLocale": "pl-PL", "countries": ["DE"], "adLanguages": ["de", "pl"], "documentLanguages": ["pl"] },
|
||||
{ "residence": "BE", "uiLocale": "fr-FR", "countries": ["BE", "FR"], "adLanguages": ["fr"], "documentLanguages": ["en"] }
|
||||
],
|
||||
"countryChange": {
|
||||
"beforeCountries": [
|
||||
"NO",
|
||||
"GB"
|
||||
],
|
||||
"afterCountries": [
|
||||
"GB"
|
||||
],
|
||||
"beforeBranches": [
|
||||
{
|
||||
"root": "s:NO:county:vestfold",
|
||||
"refinements": [
|
||||
"s:NO:municipality:tonsberg"
|
||||
]
|
||||
},
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:warwick"
|
||||
]
|
||||
}
|
||||
],
|
||||
"afterBranches": [
|
||||
{
|
||||
"root": "s:GB:county:warwickshire",
|
||||
"refinements": [
|
||||
"s:GB:town:warwick"
|
||||
]
|
||||
}
|
||||
],
|
||||
"cleared": [
|
||||
"s:NO:county:vestfold"
|
||||
],
|
||||
"explanation": "Norway location removed from this temporary search.",
|
||||
"before": {
|
||||
"residence": "NO",
|
||||
"uiLocale": "en-GB",
|
||||
"adLanguages": [
|
||||
"nb",
|
||||
"en"
|
||||
],
|
||||
"documentLanguages": [
|
||||
"fr",
|
||||
"nb"
|
||||
],
|
||||
"savedSearch": "unchanged-synthetic-definition"
|
||||
},
|
||||
"after": {
|
||||
"residence": "NO",
|
||||
"uiLocale": "en-GB",
|
||||
"adLanguages": [
|
||||
"nb",
|
||||
"en"
|
||||
],
|
||||
"documentLanguages": [
|
||||
"fr",
|
||||
"nb"
|
||||
],
|
||||
"savedSearch": "unchanged-synthetic-definition"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,54 +0,0 @@
|
||||
# Offline European geography contract QA
|
||||
|
||||
17 November 2026. Bounded documentation/tooling increment authorised by the current direct roadmap continuation. This is executable specification QA, not GJ-01/GJ-02 implementation or acceptance. No application imports, dependencies, settings, migrations, HTTP requests, provider/model calls or qualification statuses change.
|
||||
|
||||
## Inputs and identity
|
||||
|
||||
Application baseline: `eb2538772e1bfabbeb291e4a5efa177c79074de1` (A3). Isolated branch `codex/global-geo-contracts`; worktree `E:/Storage/Projects/Active/temp docs/jobjakt-local-build/global-geo-contracts`.
|
||||
|
||||
The validator reads committed Git blobs directly. It does not copy a country registry, inspect another checkout's uncommitted data or require the I18N worktree to remain present. Required commits must exist locally; missing objects fail execution rather than falling back to stale checkout files. It performs no fetch.
|
||||
|
||||
| Source commit | Repository path | Exact Git blob |
|
||||
| --- | --- | --- |
|
||||
| `39fb9df06904e44916e258da0ed975dd46b9691c` | `docs/i18n/00/EUROPE_COUNTRY_LANGUAGE_MATRIX.md` | `4b88eb52e91d1c1ad0bb9082ed3ce075e0602dbd` |
|
||||
| `39fb9df06904e44916e258da0ed975dd46b9691c` | `docs/i18n/00/EUROPE_RELEASE_COVERAGE.csv` | `395fc09934a516a2445fddb092b5de18c9469080` |
|
||||
| `0ec9f98e6ed4a646fc5e017d8eb6fade07653f37` | `docs/global-jobs/00/GEOGRAPHY_DECISIONS.md` | `48f108ef02648f53490ae505b223ebff321264bb` |
|
||||
|
||||
The I18N source commit was inspected in the existing `i18n-message-census` worktree. Both matrix/CSV blob identities also match A3 exactly. All inputs are available in this local repository object store. The GJ planning documents remain on their separate planning history; they are not merged or replaced here. The geography decision blob is bound for traceability; its prose semantics were reviewed by a human-readable source inspection, not automatically interpreted by the script.
|
||||
|
||||
Authority: Prompt 7 and the GJ pack retain predecessor/initiative gates; GJ-00 geography decisions define branch refinement and typed relationships. The later EUROPE-READY owner addendum §§4/14 requires country/refinement contract tests and §15 preserves shared owners and gates. Existing `docs/i18n/00/IMPLEMENTATION_PLAN.md` permits future fixture design without inventing dependent runtime. Current direct instruction narrows this increment to offline documentation contracts. It does not authorise a runtime scope compiler.
|
||||
|
||||
## What runs
|
||||
|
||||
From the repository root, using installed Node and Git only:
|
||||
|
||||
```text
|
||||
rtk proxy node docs/global-jobs/00/validate-contracts.cjs --self-test
|
||||
rtk proxy node --check docs/global-jobs/00/validate-contracts.cjs
|
||||
rtk git diff --check
|
||||
```
|
||||
|
||||
The first command checks the matrix's exact 59-code roster and 1,062 coverage cells (18 columns per country); validates status vocabulary and the frozen qualification snapshot, including the sole existing Norway NAV fixture result; and checks XK's explicit non-ISO caveat. Updating any status requires a separately reviewed source/evidence change and validator update. This snapshot guard is not a general release approval engine.
|
||||
|
||||
`GEOGRAPHY_CONTRACT_FIXTURES.json` contains 13 deliberately synthetic typed identities, seven typed edges and 12 selection expectation cases. Every ID uses the `s:` namespace, edition `synthetic-1`, and explicit synthetic provenance. Display labels resemble representative locations, but neither the IDs nor edges are authoritative geographic data or a licensed boundary dataset. Administrative reachability is used only to check fixture expectations; settlement intersection and shared footprint cannot substitute for administrative containment. No query plan is emitted and no function is exported for application use.
|
||||
|
||||
Cases cover whole Warwickshire, one/two towns, removing refinements, independent Bergen OR, Vestfold/Tønsberg, distinct Oslo identities, Stockholm municipality versus settlement and parent/country removal. Query/tree/map are declared expected scope lists whose consistency is checked; no UI, query service or map is exercised. Four preference examples cover EN/NO→GB, NB→SE, PL→DE and FR→BE+FR as separate residence/UI/ad/document-language fields. One explicit country-change fixture preserves unrelated preferences and a saved-search sentinel, removes only incompatible branches and requires an explanation. JSON roundtrip checks apply to these fixtures only, not server persistence.
|
||||
|
||||
## Validation outcome
|
||||
|
||||
Executed with Node `v24.19.0`:
|
||||
|
||||
- PASS: 59 country rows / 1,062 coverage cells; 13 nodes, 12 selection cases, four preference examples and one country-change expectation.
|
||||
- PASS: 22 negative mutations rejected. They cover false release claims, missing/duplicate/invented countries, invalid status, crediting the NAV fixture to GB, typed identity/edition/provenance errors, invented geometry, cross-country edges, unresolved scopes, invalid refinements, broad-parent leakage, map divergence, language/saved-search resets, invisible filters, missing explanations, settlement overlap treated as containment, administrative cycles and invalid journey country.
|
||||
- PASS: Node syntax check and staged Git diff whitespace check (exit 0 each).
|
||||
- RED evidence: before implementation, the permissive validator failed the negative suite with `Missing expected exception: must reject false release coverage` (exit 1). First implemented run then caught the real CSV's NO/SE/GB administrative hierarchy `AWAITING REVIEW` nuance; the corrected frozen-snapshot guard preserves that existing status.
|
||||
|
||||
The 22 mutations are checks of the validator, not 22 additional product tests. The counts above describe one successful final contract run; intermediate reruns are not added. Syntax/diff verification is recorded separately from product tests.
|
||||
|
||||
Required `rtk proxy graphify update .` completed exit 0 with 19,842 nodes / 48,008 edges, explicitly AST-only/no LLM. It retained warnings for unavailable PDF/SQL extractors and 146 code files yielding no symbols. Generated `graphify-out/` is local/untracked and excluded from this documentation commit; graph counts are structural orientation, not acceptance tests.
|
||||
|
||||
## Gates and limits
|
||||
|
||||
All 59 entries remain candidate scope with their existing statuses. Real geography licences, exact dataset epochs/IDs/geometry, provider rights, live operation, map attribution/privacy, native-language/device/AT evidence and release approval remain open. Phase 10 D02/frozen-candidate acceptance, Product Review, GJ implementation authority and sequential accepted stages are unchanged. No precise town/radius, accessible tree, map switching, server preference persistence or country-specific provider behavior is qualified by these checks.
|
||||
|
||||
The existing NAV municipality substring limitation remains assigned to GJ geography work; this increment does not establish or repair a separate Norway regression. No main merge, orchestrator action, push or deployment occurs. Application builds/browser/backend/hosted/provider/model suites were intentionally not run for documentation-only tooling.
|
||||
@@ -1,163 +0,0 @@
|
||||
// Offline specification QA only; never imported by the application.
|
||||
const assert = require('node:assert/strict');
|
||||
const { execFileSync } = require('node:child_process');
|
||||
const { readFileSync } = require('node:fs');
|
||||
const path = require('node:path');
|
||||
const root = path.resolve(__dirname, '../../..');
|
||||
const git = (...args) => execFileSync('git', args, { cwd: root, encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 });
|
||||
const load = () => JSON.parse(readFileSync(path.join(__dirname, 'GEOGRAPHY_CONTRACT_FIXTURES.json'), 'utf8'));
|
||||
function validate(fixture, matrix, coverage) {
|
||||
assert.equal(fixture.schema, 1);
|
||||
assert.equal(fixture.purpose, 'offline-specification-only');
|
||||
assert.equal(fixture.sourceCommit, '39fb9df06904e44916e258da0ed975dd46b9691c');
|
||||
assert.equal(fixture.baseline, 'eb2538772e1bfabbeb291e4a5efa177c79074de1');
|
||||
const unique = (values, label) => assert.equal(new Set(values).size, values.length, `duplicate ${label}`);
|
||||
const sorted = values => [...values].sort();
|
||||
const codes = [...matrix.matchAll(/^\| [^|]+ \| ([A-Z]{2}) \|/gm)].map(match => match[1]);
|
||||
assert.equal(codes.length, 59);
|
||||
unique(codes, 'matrix code');
|
||||
assert(matrix.includes('XK is a CLDR user-assigned territory code, not ISO 3166-1'));
|
||||
// This pinned CSV has no quoted fields; fail rather than silently parse a new format.
|
||||
assert(!coverage.includes('"'), 'CSV format changed; review parser');
|
||||
const [header, ...lines] = coverage.trim().split(/\r?\n/).map(line => line.split(','));
|
||||
const columns = 'territoryCode,scopeReview,countrySelectable,administrativeHierarchy,canonicalResolution,mapCountrySwitching,canonicalLocationFilters,providerCoverage,countryAwareResults,multiCountrySavedSearches,marketLanguageOptions,marketCatalogue,currencyAndTimezone,mobile,accessibility,countryTestEvidence,humanApproval,productionAvailability,existingNavFixture'.split(',');
|
||||
assert.deepEqual(header, columns);
|
||||
unique(lines.map(row => row[0]), 'coverage code');
|
||||
assert.deepEqual(sorted(lines.map(row => row[0])), sorted(codes));
|
||||
const statuses = ['NOT IMPLEMENTED', 'IMPLEMENTED', 'TESTED', 'BLOCKED', 'AWAITING REVIEW', 'ACCEPTED', 'RELEASED'];
|
||||
for (const row of lines) {
|
||||
assert.equal(row.length, columns.length);
|
||||
for (let i = 1; i < row.length; i++) {
|
||||
assert(statuses.includes(row[i]), `invalid status ${row[0]} ${columns[i]}`);
|
||||
let expected = 'NOT IMPLEMENTED';
|
||||
if (['scopeReview', 'humanApproval'].includes(columns[i])) expected = 'AWAITING REVIEW';
|
||||
if (columns[i] === 'administrativeHierarchy' && ['NO', 'SE', 'GB'].includes(row[0])) expected = 'AWAITING REVIEW';
|
||||
if (columns[i] === 'productionAvailability' || (columns[i] === 'providerCoverage' && ['NO', 'SE', 'GB'].includes(row[0]))) expected = 'BLOCKED';
|
||||
if (columns[i] === 'existingNavFixture' && row[0] === 'NO') expected = 'TESTED';
|
||||
assert.equal(row[i], expected, `unqualified coverage change ${row[0]} ${columns[i]}`);
|
||||
}
|
||||
}
|
||||
const nodes = new Map(fixture.nodes.map(node => [node.id, node]));
|
||||
unique(fixture.nodes.map(node => node.id), 'node ID');
|
||||
for (const node of fixture.nodes) {
|
||||
assert(codes.includes(node.country));
|
||||
assert(['county', 'municipality', 'town', 'settlement', 'state', 'region'].includes(node.type));
|
||||
assert(node.id.startsWith(`s:${node.country}:${node.type}:`), 'typed country identity mismatch');
|
||||
assert.equal(node.edition, 'synthetic-1');
|
||||
assert.equal(node.provenance, 'synthetic-no-boundary-claim');
|
||||
assert.equal(typeof node.label, 'string');
|
||||
assert(node.label.trim());
|
||||
assert(!('coordinates' in node || 'geometry' in node || 'providerCode' in node), 'unqualified spatial/provider data');
|
||||
}
|
||||
unique(fixture.edges.map(edge => JSON.stringify(edge)), 'edge');
|
||||
for (const edge of fixture.edges) {
|
||||
assert(nodes.has(edge.child) && nodes.has(edge.parent), 'unresolved edge');
|
||||
assert.notEqual(edge.child, edge.parent);
|
||||
assert.equal(nodes.get(edge.child).country, nodes.get(edge.parent).country, 'cross-country edge');
|
||||
assert(['administrative-parent', 'settlement-intersects', 'same-footprint'].includes(edge.type));
|
||||
if (edge.type === 'settlement-intersects') assert.equal(nodes.get(edge.child).type, 'settlement');
|
||||
}
|
||||
// Reachability checks fixture declarations only; this is not a runtime scope compiler.
|
||||
function ancestor(child, parent, trail = []) {
|
||||
assert(!trail.includes(child), 'administrative cycle');
|
||||
return fixture.edges.filter(edge => edge.type === 'administrative-parent' && edge.child === child)
|
||||
.some(edge => edge.parent === parent || ancestor(edge.parent, parent, [...trail, child]));
|
||||
}
|
||||
for (const node of nodes.keys()) assert(!ancestor(node, node), 'administrative cycle');
|
||||
function checkBranches(branches, countries) {
|
||||
unique(countries, 'search country');
|
||||
assert(countries.every(country => codes.includes(country)));
|
||||
unique(branches.map(branch => branch.root), 'branch');
|
||||
for (const branch of branches) {
|
||||
assert(nodes.has(branch.root), 'unresolved scope');
|
||||
assert(countries.includes(nodes.get(branch.root).country), 'incompatible country scope');
|
||||
unique(branch.refinements, 'refinement');
|
||||
for (const refinement of branch.refinements) {
|
||||
assert(nodes.has(refinement) && ancestor(refinement, branch.root), 'invalid refinement');
|
||||
assert.equal(nodes.get(refinement).country, nodes.get(branch.root).country);
|
||||
}
|
||||
}
|
||||
}
|
||||
unique(fixture.scenarios.map(scenario => scenario.name), 'scenario name');
|
||||
assert(fixture.scenarios.length >= 12);
|
||||
for (const scenario of fixture.scenarios) {
|
||||
checkBranches(scenario.branches, scenario.countries);
|
||||
assert(scenario.expanded.every(id => nodes.has(id)));
|
||||
const leaves = scenario.branches.flatMap(branch => branch.refinements.length
|
||||
? branch.refinements.filter(id => !branch.refinements.some(other => id !== other && ancestor(other, id))) : [branch.root]);
|
||||
unique(leaves, 'effective scope');
|
||||
for (const surface of ['query', 'tree', 'map']) {
|
||||
assert.deepEqual(sorted(scenario.expected[surface]), sorted(leaves), `incorrect ${surface} scope: ${scenario.name}`);
|
||||
}
|
||||
assert.deepEqual(JSON.parse(JSON.stringify(scenario)), scenario, 'fixture roundtrip');
|
||||
}
|
||||
const change = fixture.countryChange;
|
||||
checkBranches(change.beforeBranches, change.beforeCountries);
|
||||
checkBranches(change.afterBranches, change.afterCountries);
|
||||
const retained = change.beforeBranches.filter(branch => change.afterCountries.includes(nodes.get(branch.root).country));
|
||||
assert.deepEqual(change.afterBranches, retained, 'only incompatible filters may clear');
|
||||
assert.deepEqual(change.cleared, change.beforeBranches.filter(branch => !retained.includes(branch)).map(branch => branch.root));
|
||||
assert(change.explanation.trim(), 'country change explanation required');
|
||||
assert.deepEqual(change.after, change.before, 'unrelated preferences/saved search changed');
|
||||
assert.deepEqual(Object.keys(change.before).sort(), ['adLanguages', 'documentLanguages', 'residence', 'savedSearch', 'uiLocale']);
|
||||
assert.equal(fixture.journeys.length, 4);
|
||||
for (const journey of fixture.journeys) {
|
||||
assert(codes.includes(journey.residence));
|
||||
assert(journey.countries.length && journey.countries.every(country => codes.includes(country)));
|
||||
unique(journey.countries, 'journey country');
|
||||
assert.equal(typeof journey.uiLocale, 'string');
|
||||
assert(journey.adLanguages.length && journey.documentLanguages.length);
|
||||
assert(journey.adLanguages.every(language => typeof language === 'string'));
|
||||
assert(journey.documentLanguages.every(language => typeof language === 'string'));
|
||||
}
|
||||
return { countries: codes.length, coverageCells: lines.length * (columns.length - 1), syntheticNodes: nodes.size,
|
||||
syntheticScenarios: fixture.scenarios.length, preferenceJourneys: fixture.journeys.length, countryChangeInvariants: 1,
|
||||
qualification: 'offline specification consistency only' };
|
||||
}
|
||||
function selfTest(fixture, matrix, coverage) {
|
||||
const cases = [
|
||||
['false release coverage', (f, m, c) => [f, m, c.replace('BLOCKED', 'RELEASED')]],
|
||||
['cross-country edge', f => { f.edges[0].parent = 's:NO:county:vestfold'; }],
|
||||
['invalid refinement', f => { f.scenarios[1].branches[0].refinements = ['s:NO:municipality:tonsberg']; }],
|
||||
['unqualified provenance', f => { f.nodes[0].provenance = 'licensed-real-data'; }],
|
||||
['duplicate country', (f, m, c) => [f, m, c + c.trim().split('\n')[1] + '\n']],
|
||||
['missing country', (f, m, c) => [f, m, c.trim().split('\n').slice(0, -1).join('\n')]],
|
||||
['invented country', (f, m, c) => [f, m, c.replace('AD,', 'ZZ,')]],
|
||||
['invalid status', (f, m, c) => [f, m, c.replace('BLOCKED', 'HEALTHY')]],
|
||||
['NO fixture credited to GB', (f, m, c) => [f, m, c.replace(/^GB,(.*),NOT IMPLEMENTED$/m, 'GB,$1,TESTED')]],
|
||||
['wrong type identity', f => { f.nodes[0].type = 'town'; }],
|
||||
['missing edition', f => { delete f.nodes[0].edition; }],
|
||||
['invented geometry', f => { f.nodes[0].geometry = {}; }],
|
||||
['unresolved scope', f => { f.scenarios[0].branches[0].root = 'missing'; }],
|
||||
['parent incorrectly ORed with town', f => { f.scenarios[1].expected.query.push(f.scenarios[1].branches[0].root); }],
|
||||
['map divergent from query', f => { f.scenarios[1].expected.map = []; }],
|
||||
['unrelated language reset', f => { f.countryChange.after.uiLocale = 'nb-NO'; }],
|
||||
['saved search overwritten', f => { f.countryChange.after.savedSearch = 'rewritten'; }],
|
||||
['invisible country filter', f => { f.countryChange.afterBranches = f.countryChange.beforeBranches; }],
|
||||
['silent country clearing', f => { f.countryChange.explanation = ''; }],
|
||||
['settlement overlap used as containment', f => {
|
||||
f.scenarios[9].branches[0].refinements = ['s:SE:settlement:stockholm'];
|
||||
}],
|
||||
['administrative cycle', f => { f.edges.push({child: f.edges[0].parent, parent: f.edges[0].child, type: 'administrative-parent'}); }],
|
||||
['invalid journey country', f => { f.journeys[0].countries = ['ZZ']; }],
|
||||
];
|
||||
for (const [name, mutate] of cases) {
|
||||
const candidate = structuredClone(fixture);
|
||||
const inputs = mutate(candidate, matrix, coverage) || [candidate, matrix, coverage];
|
||||
assert.throws(() => validate(...inputs), undefined, `must reject ${name}`);
|
||||
}
|
||||
return cases.length;
|
||||
}
|
||||
const fixture = load();
|
||||
// Read committed inputs directly; never copy a second register or use another worktree's dirty files.
|
||||
const bindings = [
|
||||
[fixture.sourceCommit, 'docs/i18n/00/EUROPE_COUNTRY_LANGUAGE_MATRIX.md', '4b88eb52e91d1c1ad0bb9082ed3ce075e0602dbd'],
|
||||
[fixture.sourceCommit, 'docs/i18n/00/EUROPE_RELEASE_COVERAGE.csv', '395fc09934a516a2445fddb092b5de18c9469080'],
|
||||
['0ec9f98e6ed4a646fc5e017d8eb6fade07653f37', 'docs/global-jobs/00/GEOGRAPHY_DECISIONS.md', '48f108ef02648f53490ae505b223ebff321264bb'],
|
||||
];
|
||||
for (const [commit, file, blob] of bindings) assert.equal(git('rev-parse', `${commit}:${file}`).trim(), blob, `source binding: ${file}`);
|
||||
const matrix = git('show', `${fixture.sourceCommit}:docs/i18n/00/EUROPE_COUNTRY_LANGUAGE_MATRIX.md`);
|
||||
const coverage = git('show', `${fixture.sourceCommit}:docs/i18n/00/EUROPE_RELEASE_COVERAGE.csv`);
|
||||
const result = validate(fixture, matrix, coverage);
|
||||
if (process.argv.includes('--self-test')) result.rejectedMutations = selfTest(fixture, matrix, coverage);
|
||||
console.log(JSON.stringify(result, null, 2));
|
||||
Reference in New Issue
Block a user