archicratie-edition/docs/HANDOFF-SESSION.md

HANDOFF — Bilan synthèse (passation)

Mission

Rendre la CI Gitea Actions fiable (Synology) et sécuriser les ancrages de paragraphes :

• mapping oldId -> newId versionné
• injection build-time dans dist pour préserver les liens profonds

Causes racines identifiées

1. DNS instable dans les conteneurs de job via bridge Docker (127.0.0.11) sur cette infra
2. Checkout GitHub externe impossible/indésirable + variables GITEA_* parfois absentes
3. engines Node imposent >=22 <23 => EBADENGINE si Node 20

Résolution validée (baseline)

• Runner : container.network = host
• Job : image Node 22
• Checkout : via workflow/event.json (pas actions/checkout)
• Workflow : pas de apt-get
• Anchors :
  • src/anchors/anchor-aliases.json (par route)
  • scripts/inject-anchor-aliases.mjs injecte avant l’élément id="newId"
  • scripts/check-anchor-aliases.mjs valide le schéma en CI

État actuel

• CI passe (host net + Node 22 + checkout event.json + no apt)
• Injection d’aliases vérifiée localement dans dist/…/index.html