XER/P6-lezer etappe 3: laag 1 (voltooide activiteiten), laag 3 (datums zoals opgeslagen), herpin op het volledige corpus

.superpowers/sdd/2026-08-20-plan-xer-p6-lezer/task-X6-wiring-report.md

@@ -0,0 +1,130 @@
+# X6 — resources en toewijzingen
+
+## Afbakening
+
+Deze wijziging bedraadt uitsluitend de actuele X6-kern in de XER-leesroute. RSRC, RSRCRATE,
+ROLERATE, RSRCCURVDATA en TASKRSRC worden één keer uit de geparste tabelset gelezen. X4b-
+meerdocumentselectie en baseline-uitsluiting blijven ongewijzigd; X5 SCHEDOPTIONS blijft
+ongewijzigd. Er is geen X8-wiring en er is geen X9-IFC-, recovery- of exportserialisatieclaim.
+De retained XER-metadata is uitsluitend in-memory bronbewijs voor een latere X9-overdracht.
+
+## Gewijzigde bestanden
+
+- `src/services/xer/xerResourceTypes.ts`: retained bronvormen, fouten en read-context.
+- `src/services/xer/xerResourceCurves.ts`: 21 rauwe curvepunten en niet-destructieve best-fit.
+- `src/services/xer/xerResourceAssignments.ts`: lineaire TASKRSRC-partitionering en projectview.
+- `src/services/xer/xerResources.ts`: bestandsbrede resource-/rol-/ratecatalogus en mutable
+  projectmaterialisatie.
+- `src/services/xer/xerReader.ts`: catalogus/index éénmaal maken en per X4b-project projecteren.
+- `src/services/xer/xerTables.ts`: rows en cells na parsing runtime-bevriezen.
+- `src/services/xer/xerMultiProject.ts`: catalogus/raw rows referentie-identiek herstellen na
+  de bestaande mutable projectclone.
+- `src/services/importTypes.ts`: optionele retained X6-metadata onder `xer`.
+- `tests/planning/check-xer-resources.ts`: X6-contract voor calendar/rates/curves,
+  task.resourceIds, X4b-projectfiltering, baselineretentie, catalogusalias en clone-isolatie.
+- `tests/planning/check-xer-resource-corpus.ts`: onafhankelijke bytescan met anonieme hashes,
+  twee publieke corpuspins en parser-/kernperformance/heap-poorten.
+- `tests/planning/run.sh`: beide X6-checks éénmaal buiten de tijdzonematrix; de corpuscheck met
+  `--expose-gc`.
+- `tests/planning/check-xer-schedule-options.ts`, `src/utils/wbs.ts` en
+  `src/state/slices/librarySlice.ts`: type- en instrumentatieaanpassingen die nodig waren nu
+  parserrows bevroren zijn; geen nieuwe X5- of library-semantiek.
+
+## Invarianten en mutatiebewijs
+
+- Eén `parseXerTables()` voedt één immutable catalogus; de catalogus deelt de ruwe `XerRow`
+  referenties met iedere projectview.
+- TASKRSRC wordt éénmaal naar `proj_id` gepartitioneerd. Een project materialiseert alleen zijn
+  rijen; ongescope en baseline-rijen blijven uitsluitend in de catalogus voor X9.
+- Per project worden resources gekloond en assignments nieuw geprojecteerd. De X4b-test muteert
+  P1-resource en -assignment en bewijst dat P2 ongewijzigd blijft, terwijl de catalogus gedeeld
+  en bevroren blijft.
+- Arbeidsfractie blijft `1 = 100%`; materiaal per uur wordt met de resourcekalender naar per dag
+  omgerekend. De tijdelijke productiemutatie `rawRate * 100` maakte de verse X6-bundel rood met
+  exitcode 1: `0,5 -> 50` en de onafhankelijke P2-waarde `2 -> 200`. De regel is daarna met
+  `apply_patch` exact hersteld; de verse contracttest is weer groen.
+
+## Onafhankelijke orakels en performance
+
+De corpuscheck importeert geen productiemodule voor zijn eerste meting. Hij scant de XER-bytes
+zelf, telt tabellen/typen en vergelijkt de anonieme SHA-16-pins voor Roads en rehab-2. Daarna
+controleert hij de productiecatalogus en lineaire projectprojectie tegen die onafhankelijke scan.
+
+De geslaagde rerun mat:
+
+| corpuspin | parser | parserheap | X6-kern | kernheap |
+| --- | ---: | ---: | ---: | ---: |
+| `a2ef7b35c00d8cf8` | 81,6 ms | 20.391.440 B | 59,6 ms | 2.919.512 B |
+| `2c1dce175b9f0781` | 977,5 ms | 243.986.592 B | 778,9 ms | 41.203.632 B |
+
+Beide bleven onder de vastgelegde grenzen. De bronlog staat lokaal in
+`task-X6-planning-rerun.log`; die log is bewust genegeerd en niet onderdeel van de commit.
+
+## Uitgevoerde poorten
+
+- Gerichte X6-contracttest na herstel: exitcode 0, 7 checks.
+- Gerichte X6-corpuscheck met openbare `OPS_XER_CORPUS`: exitcode 0, 14 checks.
+- `npm run typecheck`: exitcode 0.
+- Volledige `npm run test:planning` met `OPS_XER_CORPUS` en `OPS_P6_COMPARISON`: exitcode 0,
+  560/560 en UTC, America/New_York, Pacific/Midway, Pacific/Auckland en Atlantic/Azores groen.
+- Volledige `npm run verify` met dezelfde publieke corpuscontext: exitcode 0; inclusief lint,
+  planning/library/MCP/dev-server, examples, docs, i18n, cycles en audit (0 vulnerabilities).
+- `git diff --check`: exitcode 0.
+
+## X9-overdracht
+
+X9 moet de retained `xer.resources`-catalogus en projectassignment-view door het
+documentcontract, IFC-writer/-reader en recovery-bronserialisatie voeren. Deze X6-commit bewaart
+alleen de in-memory raw rows met referentie-identiteit; zij claimt expliciet geen save/reload-
+round-trip, export of MCP-leespaddocumentatie.
+
+## Reviewfix X6 — 2026-08-25
+
+De bestandsbrede catalogus is nu runtime-diep bevroren: nested resources, sourceprojecties,
+rate-entiteiten/-tuples, curve-tuples en issues zijn immutable. De doorloop werkt in-place en
+stopt bij de reeds bevroren parserrijen, dus raw `XerRow`- en celidentiteit wordt nooit gekloond.
+Documentprojecties blijven bewust mutable en geïsoleerd.
+
+`duplicateDocument()` kloont XER-metadata gericht: catalogus plus raw rows worden gedeeld, maar
+projectassignmentbronnen (entity, quantities, costs, rawCurves) en issues zijn nieuwe objecten.
+Hiermee wordt een catalogus met 52.640 retained TASKRSRC-rijen niet meer JSON-gekloneerd.
+
+De corpuspoort start met een directe byte-/tabelscanner voor presence/tellingen, exacte rates en
+ingangsdatums, resourcekalenders, role-only assignments, 21 curvepunten/best-fit, projectpartitie
+en raw-rowidentiteit. Zij rapporteert afzonderlijk parser, catalogusbouw, materialisatie en de
+volledige `readXER`-route. Heap is een live-delta vanaf één nulmeting per corpuscase, omdat alle
+resultaten voor het onafhankelijke orakel terecht live blijven.
+
+Laatste openbare corpusrun: Roads 90,6 / 6,6 / 72,4 / 246,1 ms; rehab-2 1.079,2 / 13,1 /
+1.066,6 / 2.707,8 ms (parser / catalogusbouw / materialisatie / end-to-end), 40 checks,
+exitcode 0. Rode mutaties (ieder exitcode 1, direct hersteld): rate ×100, verkeerde kalender,
+20 i.p.v. 21 curvepunten, resourceIds-fan-out weg, projectmisrouting en catalogusfilter met
+baseline/unscoped-verlies. De voorafgaande RED-tests bewezen ook shallow freeze en rawmetadata-
+klonen bij duplicateDocument().
+
+## Herreviewfix X6 — 2026-08-25 (twee Important-restpunten)
+
+De runtime-freeze is nu ook statisch afgedwongen. `XerReadonly<T>` is de ene canonieke,
+tuple-behoudende diep-readonlycompositie voor de catalogusgrens; `XerResourceCatalog` exposeert
+alle resources, identiteiten, rows, rates, entities, kostentuples, curve-tuples, issues en raw
+rows als readonly. De bestaande `Xer*`-bronvormen blijven de expliciet mutabele,
+documentgebonden projectie beschrijven. De compile-time contracttest zet `@ts-expect-error` op
+catalogusmutaties; wanneer een daarvan weer compileert wordt die directive ongebruikt en faalt
+de typecheck. Dezelfde proef bevestigt dat entity, assignedRole, quantities, costs en rawCurves
+in een `XerResourceReadResult` wél mutabel blijven.
+
+Materialisatie kloont naast resources nu ook catalogusidentiteiten, issues en bronwrappers voor
+resources, roles, rates en curves. Alleen `rawRow` blijft per ontwerp referentie-identiek aan de
+catalogus/parserrij. De X6-contracttest vergelijkt voor resource-, role- en
+assignmentprojecties afzonderlijk de objectidentiteit met catalogus/peerprojectie en vervolgens
+de isolatie na mutatie. Een tijdelijke vervanging van `structuredClone(catalog.resources)` door
+de catalogusreferentie gaf exitcode 1 met twee gerichte contractverschillen (identiteit en
+“gematerialiseerde projectie is niet mutable”), zonder stacktrace; de tijdelijke mutatie is
+direct hersteld.
+
+Zelf gereproduceerd op `50799884`: vóór de fix waren acht `@ts-expect-error`-directives
+ongebruikt (`npm run typecheck`, exitcode 2), dus catalogusmutaties compileerden. Dezelfde
+tijdelijke materialisatieclone-regressie beëindigde de oude test met een ongehanteerde
+`TypeError` en exitcode 1. Na de fix waren de gerichte resource-, duplicateDocument- en
+openbare corpuschecks respectievelijk groen met 38, 7 en 40 checks (alle exitcode 0); de
+volledige poorten staan onder de commit vastgelegd.

CLAUDE.md

@@ -20,6 +20,7 @@ npm run test:library      # los: bibliotheek/IFC/i18n-checks
 npm run test:mcp          # los: MCP-tools
 npm run test:dev-server   # los: node:test-units + integratietest van de dev-serverpoort/-locks
 npm run test:browser      # los: echte gebruikersflows in Chromium via Playwright
+npm run test:browser:x11  # lokaal headed; vereist OPS_XER_CORPUS + desktopdisplay, vervangt de corpusloze CI-poort niet
 npm run verify:examples   # los: de gebundelde voorbeelden laden/rekenen door zoals verwacht
 npm run verify:docs       # los: in-app gidsen — nl+en hard vereist, overige 12 talen indien aanwezig
 npm run verify:i18n       # los: ontbrekende vertaalsleutels t.o.v. nl (CLDR-pluralcategorieën meegerekend)
@@ -105,6 +106,46 @@ eigenschappenpaneel (`TaskTimephasedNotice.tsx`); beide linken via `openHelpArti
 `tests/planning/check-mpp-*.ts`-batterijen (import/relations/calendars/summary-relations) voor de
 rest van de regressiedekking.
 
+### De XER-lezer (Primavera P6): bronarchief in het IFC, P6-getrouwheid in drie lagen
+
+`src/services/xer/` leest het native `.xer`-uitwisselingsformaat van Primavera P6 rechtstreeks
+(geen Rust, geen externe bibliotheek): `xerTables.ts` (tabelparser, getalnotatie uit `CURRTYPE`,
+tekencodering BOM → UTF-8 → Windows-1252), `xerReader.ts` (entry point `readXER()`, hetzelfde
+`ImportResult`-contract als de andere lezers, via `formatRegistry.ts` achter een dynamic import),
+`xerMultiProject.ts` (één bestand ⇒ meerdere documenten; baselineprojecten worden bij hun huidige
+project gematerialiseerd), `xerCalendarData.ts` (de `clndr_data`-decoder incl. herstelcodes),
+`xerScheduleOptions.ts` (SCHEDOPTIONS → `SchedulingOptions`, X5), `xerRecordedTimes.ts` (zie
+hieronder) en de resource-/metadata-lezers. Het volledige plan met eigenaarsbesluiten, dossiers en
+de overdrachtsstand staat in `docs/superpowers/plans/2026-08-20-plan-xer-p6-lezer.md`; lees §4.1
+(de veldwhitelist met vier "bakken") vóór je een TASK-kolom aanraakt.
+
+Drie architectuurregels die je moet kennen. (1) **Het bronarchief.** De volledige oorspronkelijke
+`.xer`-bytes reizen als `xerSourceArchive` (+ `xerImportMetadata`, `xerSourceProjectId`) mee in
+`DOCUMENT_FIELDS` én in `IFC_SAVE_KEYS` (`src/services/xerSourceArchive.ts`): het IFC-projectbestand
+en elke crashherstel-snapshot dragen het archief, zonder bovengrens — gemeten 17,7 MB `.xer` ⇒ ±50 MB
+IFC, ±3,6 s hoofdthread per auto-save-tick (`docs/xer-recovery-guardrails.md`; eigenaarsbesluit,
+plan §10.f). De MCP-tool `planner_xer_provenance` en de extensie-API `data.getImportSource*` (achter
+de permissie `importSource`, default-deny) lezen eruit. (2) **Bak 4 — opgeslagen rekenuitvoer is
+weergave, nooit solverinvoer.** De zes P6-uitvoerkolommen (`early_/late_start/end_date`,
+`total_/free_float_hr_cnt`) mogen uitsluitend via `xerRecordedTimes.ts` gelezen worden, als
+`ImportResult.recordedTimes`; ze voeden de weergave "Datums zoals opgeslagen" (issue #63, hierboven
+onder *State*) en de X12-meetlat, nooit `Task.time` als invoer. Bak 2 (`restart_date`, `driving_path_flag`,
+…) mag de lezer nooit lezen. `tests/planning/check-xer-field-whitelist.ts` grept beide grenzen
+corpusloos over heel `src/`; de X12-non-interferentie in `check-xer-product-fidelity-x12.ts` bewijst
+het per mutatie. (3) **P6-gedrag is fail-closed op `p6Source`.** Elke P6-specifieke solvertak
+(`CPMSolver.ts`, `p6Completed*.ts`, `p6OpenLoe*.ts`) staat achter
+`schedulingOptions.p6Source === 'XER'`; de XER-lezer zet die vlag, het IFC round-tript haar (met
+`sanitizeSchedulingOptions` als type-/sleutelpoort in `ifcReader.ts`), andere formaten blijven
+byte-identiek — de corpusloze planningssuite bewaakt dat. Uitzondering: `lagCalendar` is sinds X5 een
+werkende instelling voor élk formaat (was een dode UI-keuze).
+
+Meten gaat via het corpus (`OPS_XER_CORPUS`, plan §10.a; niet in de repo, geen CI-poort):
+`check-xer-product-fidelity-x12.ts` telt zesassige afwijkingen tegen P6's eigen uitvoer
+(`OPS_XER_FIDELITY_REPORT=summary|detail|baseline`), gepind in `xer-product-fidelity-baseline-v2.json`
+en corpusloos in `check-xer-corpusless-fidelity-gate.ts`. Het nuldoel van plan §1 is niet gehaald
+(15.056 op 2026-09-07); mét corpus staat de suite daarom by design rood op precies die drie regels.
+Gebruikersgidsen: `public/docs/{nl,en}/gids-xer-import.md` en `datums-zoals-opgeslagen.md`.
+
 ### De contour-engine: werkverdeling-per-dag als data, de curve-formule als terugval
 
 `src/engine/contour/contourEngine.ts` (puur, 2026-09) is de rekenkern voor **resource-contouring**:
@@ -248,10 +289,10 @@ bedrading — álle `@tauri-apps/*`-imports dynamisch achter `isTauri()`, zodat
 bouwen), `dispatcher.ts`, `schemaValidate.ts` (schema's worden in de dispatcher afgedwongen, óók
 binnen `planner_batch` — een draaiboek mag de poort niet omzeilen), `toolRegistry.ts`/`toolIndex.ts`,
 `staleGuard.ts` (`ensureFreshSchedule`), `backup.ts` (AI-backups per document in `appDataDir`,
-`MAX_PER_DOC = 10`) en `activityLog.ts` (ring-buffer achter het AI-activiteitenpaneel). De 39
+`MAX_PER_DOC = 10`) en `activityLog.ts` (ring-buffer achter het AI-activiteitenpaneel). De 40
 `planner_*`-tools staan in `src/services/mcp/tools/` (taken, relaties, resources, kalender, project,
-baselines, documenten/bestanden, leestools, en `planner_batch` als transactionele executor met
-temp-id-resolutie).
+baselines, documenten/bestanden, leestools, XER/P6-bronprovenance, en `planner_batch` als
+transactionele executor met temp-id-resolutie).
 
 Veiligheid is state, geen conventie: `ui.aiMode` (de hele AI-tab en bridge verschijnen pas hierdoor),
 `ui.aiPaused`, `ui.aiReadOnly` en `ui.aiServerStatus` leven in `uiSlice`; de per-request `McpContext`

README.md

@@ -73,7 +73,7 @@ src/
   extensions/        # Extensiesysteem (types, api, loader, service)
   i18n/              # Vertalingen, 14 talen × 4 namespaces
   hooks/  types/  utils/  styles/
-public/docs/         # In-app handleiding: 32 artikelen × 14 talen (voedt ook de wiki)
+public/docs/         # In-app handleiding: 33 artikelen × 14 talen (voedt ook de wiki)
 examples/            # Voorbeeldplanningen in IFC
 tests/               # planning · library · mcp · dev-server · browser
 src-tauri/           # De Rust-schil (dun: precies één native command)