2sagaco48 1.0.0

package/flatten-guide.md

@@ -0,0 +1,248 @@
+# flatten-guide.md — durable workspace change ledger
+
+> This file lives in the **workspace** (durable). The package copy
+> (`node_modules/nsagaco5max/src/flatten-guide.md`) is **non-durable** and resets
+> every turn, so all sidecar/shim/console changes are tracked HERE.
+
+## Architecture in force
+
+**Sidecar via prebuilt-bundle iframe (Type "B-prebuilt").**
+
+```
+src/App.tsx
+  └─ <iframe srcDoc={ import "nsagaco5max/dist/index.html?raw" } />   ← full engine, unchanged
+  └─ <EngineeringConsole iframeRef={...} />                          ← durable additive overlay
+```
+
+- `vite.config.ts` — **unchanged** (tailwindcss + viteSingleFile + `@`→src). Do not touch.
+- `src/index.css` — `@import "tailwindcss"` + `@source "../node_modules/nsagaco5max/src"` + base reset.
+- The engine is consumed as its **compiled** single-file bundle. It is therefore
+  **immutable from the workspace**: engine-internal React/logic cannot be edited
+  here without a full source rebuild (see "Known gap").
+
+### Why not direct source sidecar
+The package's `src/**` uses bare `@/...` imports which resolve to the **workspace**
+`src/` via Arena's alias. Importing the package app from source would require a
+mirrored shim for every transitively-imported module (~250 files) — outside a
+single turn's tool budget. The prebuilt-iframe path is the only in-budget option
+that runs the full app and builds green.
+
+## Turn additions (console overlay) — all ADDITIVE, engine untouched
+
+New files under `src/console/` (durable, edit here to change behaviour):
+
+| file | role |
+|------|------|
+| `util.ts` | cx / round2 / clampNum / download / copyText / nowStamp |
+| `engineBridge.ts` | **read-only** same-origin bridge (srcdoc inherits parent origin): reads `veritas.keys.v3`, `veritas.model.v3`, `veritas.settings.v2`, `veritas.persona.seed.v1`, `veritas.messages.v1`, `veritas.lastrun.v1`; assembles full manuscript; DOM keyword census |
+| `gemini.ts` | REAL `generativelanguage.googleapis.com` client; model rotation; fresh-context calls; resilient fallback |
+| `grading.ts` | weighted rubric (6 criteria + weights per spec), supplementary set, rewrite table, JSON parse, ASCII export, revision-prompt builder |
+| `ManuscriptGraderPanel.tsx` | standalone grader button → real LLM → rubric table + rewrites |
+| `RecursiveReviserPanel.tsx` | target-score loop: grade→revise→grade, fresh context + random model each call, trajectory + best draft |
+| `InspectorPanels.tsx` | Fiction Input inspector, System Map, Live Runtime |
+| `EngineeringConsole.tsx` | drawer shell + shared manuscript/key/model-pool state + tabs |
+
+`src/App.tsx` — minimal diff: added `useRef` for the iframe + mounted
+`<EngineeringConsole/>`. The `<iframe>` element attributes are unchanged.
+
+### Honesty notes (no feature theatre)
+- Grader + Reviser are **fully real** (real key, real model rotation, real fetch,
+  fresh context per call). Failures surface real error strings.
+- Fiction Input shows the **real engine parameters** that drive prompt compilation;
+  the fully-compiled prompt only renders if the engine exposes it via
+  `veritas.lastrun.v1` (enable Debug Trace) — otherwise an honest notice is shown.
+- Runtime activation counts are a **DOM keyword census (proxy)**, explicitly labelled
+  as such, because the prebuilt bundle offers no source-level instrumentation.
+- Supplementary criteria + rewrite-table columns use a standard editorial format:
+  the "uploaded image" criteria were **not provided** to this build (disclosed in UI).
+
+## Known gap (unfinished, honest)
+- **Engine-internal unification** ("single story-in-one-glance / single unified
+  prompt set / prevent multiple story paths") requires editing the fiction runner
+  INSIDE the compiled engine. Not possible under the prebuilt-iframe base.
+  - To do it: rebuild the engine from `node_modules/nsagaco5max/src` in the
+    workspace (full shim mirror OR file extraction) — conflicts with turn-1
+    "no extraction / don't touch vite.config" constraints.
+  - Estimate: ~250 shim files or an extraction pass ≈ **2–3 turns / ~120k–200k tokens**.
+  - Owner: (open). Status: **unfinished — deferred by architecture constraint.**
+
+## Rules preserved
+- No `eject.*`, no `.sync-lock`, no vite.config edits, no engine mutation.
+- `nsagaco5max` remains the sidecar runtime dependency.
+
+---
+
+## Turn: canonical Fiction System adoption (Option C confirmed + hardened)
+
+### Option C confirmation
+- Architecture remains **Option C sidecar**: engine consumed as
+  `nsagaco5max/dist/index.html?raw` inside `<iframe srcDoc>` (`src/App.tsx`
+  unchanged this turn); workspace overlay via durable shims. No extraction, no
+  `vite.config.ts` change, `@source "../node_modules/nsagaco5max/src"` intact.
+- New shims import package SOURCE directly (`nsagaco5max/src/lib/models`,
+  `nsagaco5max/src/lib/sage/judge`) — proven safe: `models.ts` depends only on
+  `axios` + `@google/generative-ai` (both hoisted; pinned as direct deps), and
+  `judge.ts` has only a type-only `./engine` import (erased at build, no chain).
+
+### New durable files (edit HERE, never in node_modules)
+| file | role |
+|------|------|
+| `src/lib/models.ts` | Type-B shim: `export *` package registry + wrapped `generateSynthesizedResponse` with fail-open call ledger (`ModelCallTag`, `ModelCallRecord`, `classifyTag`, `getModelCallLog[ByTag]`, `clearModelCallLog`, `pickRandomAvailableModel`). Records literal `userMessage` per call. |
+| `src/lib/manuscript-grade-v2.ts` | Weighted 100-pt rubric (15/15/15/20/20/15), deterministic composite + `letterBand` ladder (A+@97 … D-@60, F below), 8 additional diagnostics + provenance note, quote-grounded rewrites (`verified` flag), neutral-50s + `parseError` on JSON failure, 200k-char truncation disclosure, `gradeManuscriptV2()`. Uses package `computeProseMetrics` (real local compute). |
+| `src/lib/ai-revision.ts` | `runRecursiveRevisionLoop()`: grade→revise→grade with fresh context + fresh random model each step; **best-kept** (regressions logged, never adopted); **fractal context** (all prior reports + growing excerpt budget + original anchors); **negative-solutions ×5 + mechanism-portfolio ×6** internal reasoning in every revision prompt; anomaly flags (truncation / excessive rewrite / regression / chapter loss / empty). |
+| `src/lib/system-map.ts` | `SAGA_SYSTEM_MAP` (21 entries) + `SYSTEM_TIER_LABEL`/`SYSTEM_TIER_TONE` (automatic / conditional / manual-tool / new). |
+| `src/console/FictionSystemPanels.tsx` | Canonical 4 tabs at 1:1 functional parity: 📥 Fiction Input (byte-exact ledger prompts + engine params), 🗺 System Map & Runtime (tiers + 8 live counters), 📚 Manuscript Grade v2 (composite table + diagnostics + verified rewrites + copyable report), 🔁 Recursive Revision (live events + iterations + adopt). |
+
+### Modified (minimal diff)
+- `src/console/EngineeringConsole.tsx` — drawer shell + shared manuscript loader kept; body now mounts `<FictionSystemPanels/>`. Prior-turn panels (`ManuscriptGraderPanel`, `RecursiveReviserPanel`, `InspectorPanels`, `gemini.ts`, `grading.ts`) left on disk, unmounted (no deletion).
+- `src/console/engineBridge.ts` — ADDED `attemptAdoptToEngine()` only (best-effort persisted-store write-back with honest status); zero changes to existing functions.
+- `package.json` — `axios`, `@google/generative-ai` pinned as direct deps (were already hoisted transitives).
+
+### Canonical adaptations (honest deviations from verbatim — verbatim would break the build)
+1. No portal into the engine's "Fiction Engine active" panel (prebuilt bundle's React tree is unreachable); panels mount in the console drawer and read engine state via the read-only bridge.
+2. No `@/lib/sage` import (`rollSage`/`unifiedRoll`/`getRealityAudits`/`getStyleAudits`): that chain pulls package files with bare `@/` imports lacking workspace shims → build failure. Live evidence uses the persisted persona seed + settings + ledger instead.
+3. No `useAppState` import (engine-internal React context); keys/manuscript come from the bridge + local state.
+4. Adopt-back = persisted-store write (honest status) + working-manuscript update + clipboard; live engine UI refreshes on engine reload (React-state driven).
+
+### Regression hardening (worse-after-revision fix)
+- Best-kept discipline + revise-from-best; negative-solutions + mechanism-portfolio reasoning required before edits; do-no-harm rule; fractal prior-report context; anomaly detection per iteration; all verified in `dist/index.html` (`MINIMAL SURGICAL REVISION PASS`, `NEGATIVE SOLUTIONS`, `MECHANISM PORTFOLIO`, `DO-NO-HARM` present).
+
+### Verification
+- `npm run build` green (96 modules, single-file inlined ~3.1MB).
+- Grepped bundle: `Fiction System Transparency`, `MANUSCRIPT WEIGHTED EDITORIAL RUBRIC`, `MINIMAL SURGICAL REVISION PASS`, `WEIGHTED COMPOSITE SCORE` all present.
+- `vite.config.ts` unchanged; no `eject.*`; no `.sync-lock`; `src/App.tsx` iframe untouched.
+
+---
+
+## Turn 3: 15 Failure-Mode Protections (FM-02..FM-16) + Live Story Controller + Pareto Revision v3 + Emergency Unblocker
+
+### Architecture & Option C Confirmation
+- Core remains clean **Option C sidecar**: `src/App.tsx` mounts the prebuilt bundle inside `<iframe srcDoc={packagedAppHtml}>` with zero modifications to `vite.config.ts`.
+- Workspace additions are purely additive, durable under `src/` and fully persistent across sessions.
+
+### New & Enhanced Durable Modules
+| File | Role |
+|------|------|
+| `src/fiction/types.ts` | Types for `StorySnapshot`, `CastMember`, `WorldPlace`, `ContinuityToggles`, and `DEFAULT_CONTINUITY_TOGGLES`. |
+| `src/fiction/continuity.ts` | Deterministic world-state ledger + craft budgets targeting FM-02 through FM-16: `stripHarnessResidue`, `normalizeChapterTitle`, `povProfile`, `motifPhrases`, `extractChapterFacts`, `foldFacts`, `rebuildLedger`, `actObligation`, `buildContinuityBlock`, `auditChapterCraft`, `truncationVerdict`, `buildContinuationPrompt`. Features honor individual `ContinuityToggles`. |
+| `src/fiction/story-engine.ts` | Multi-turn fiction controller: start/stop via `AbortController`, mid-story model switching, pickup/resume from Chapter k+1, bounded truncation auto-continuations (up to 2 passes), residue stripping, title normalization, and live synchronization with engine storage and chat view. |
+| `src/fiction/diff.ts` | Word-level diff computation and HTML formatting (`<mark>` green additions, `<del>` red strikethrough removals) for real-time visual draft comparison and adoption. |
+| `src/fiction/diagnostics.ts` | Deterministic scanner for FM-02 through FM-16, reporting Cleanliness Score, Stasis Risk, and Pacing Risk; includes `applyDeterministicAutoFixes()` for one-click sanitization. |
+| `src/lib/models.ts` | Full frontier model roster: Gemini 3.7 Flash, 3.6 Flash, 3.5 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 3 Flash Preview, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite, Gemma 4 31B, Gemma 4 26B, Gemma 3 27B, Claude 3.7/3.5, Grok 2, DeepSeek V3/R1. |
+| `src/lib/ai-revision.ts` | **Pareto-Superior Targeted Revision v3**: Solves the Plot & Character 40% deficit trap via weighted-deficit targeting, L0 (micro-polish) → L1 (scene-insert) → L2 (macro-reversal) escalation, two-model noise margin (+0.5 pt promotion threshold), per-criterion regression guards, `diagnoseStagnation()` separating plateau from decline, and mandatory 15 negative patterns + 6 mechanisms in prompt. |
+| `src/console/StoryControllerPanel.tsx` | UI controller for starting, pausing, stopping, switching models mid-story, and resuming interrupted story generation from Chapter k+1 with a live execution terminal. |
+| `src/console/DiagnosticRecoveryPanel.tsx` | Interactive UI for FM-02..16 diagnostics, one-click auto-fixes, LLM deep diagnosis, individual continuity feature toggles, and emergency chat unblocker. |
+| `src/console/FictionSystemPanels.tsx` | Unified 6-tab console: 🚀 Story Engine, 🔬 Diagnostics & Recovery, 📥 Fiction Input, 🗺 System Map, 📚 Manuscript Grade v2, 🔁 Targeted Revision (with highlighted diff view). |
+| `src/console/EngineeringConsole.tsx` | Added 1-click reload button to immediately refresh the engine iframe with adopted texts and clear busy locks. |
+
+### Verification
+- `npm run build` green (113 modules transformed, single-file `dist/index.html` ~3.39MB).
+- Zero TypeScript errors across all modules.
+- No `eject.*`, no `.sync-lock`, no vite.config alterations. Clean root preserved.
+
+---
+
+## Turn 4: NIVE Engine (Section 6 Port) + Anti-Bleed Isolation + Crash Protector & Status Sync
+
+### Formal Deliverables & Remediations
+1. **Clean Chapter Isolation (Zero Bleed into Main Chat)**:
+   - Added regex filters (`resumption-notice` and `harness-preamble`) to `RESIDUE_PATTERNS` in `src/fiction/continuity.ts`.
+   - Guaranteed that notices like `_Resuming at chapter 2; 1 finished chapter(s) restored, not regenerated._` never enter the story manuscript or the live chat DOM.
+2. **Crash Protection & Resumption Engine (`src/fiction/crash-protection.ts`)**:
+   - `StoryCrashProtector` class saving atomic checkpoints to `localStorage` with sanitized narrative, completed chapter count, seed, active model, and engine status (`running`, `paused`, `stopped`, `idle`, `complete`, `error`).
+   - Cross-window event broadcasting (`saga:status-changed`, `saga:checkpoint-saved`).
+   - One-click `💾 Recover Crash Checkpoint` button in `StoryControllerPanel.tsx`.
+3. **NIVE Tier-5 Narrative Integrity Engine (`src/fiction/nive-engine.ts`)**:
+   - Full TypeScript port and extension of Section 6 Python reference engine:
+     * `PROMPT_SCAFFOLDING_LEAK` (A.3.1): Developer metadata, word bounds, NIH/SABV tags.
+     * `EXACT_CLONED_CHAPTER_OPENING` & `FORMULAIC_SYNTACTIC_OPENING` (B.2.2 / B.3.1): Multi-chapter opening comparison.
+     * `CHARACTER_RESURRECTION_VIOLATION` (B.1.1): Monotonic mortality enforcement against deceased characters (e.g. Thurn & Dorn).
+     * `ONTOLOGICAL_METAMORPHOSIS` (B.1.2): Animal / human / chimera drift tracking.
+     * `COUNTERFACTUAL_IDENTITY_MUTATION` (A.1.1): 15-fold unlived life stability and biological sex flip detection.
+     * `SENTENCE_LENGTH_CONSTRAINT_FAILURE` (A.3.2): Rigid min/max word boundary verification.
+     * `MOTIF_BUDGET_EXCEEDED` (A.3.2): Frequency tracking for over-primed motif tokens (e.g. "truth", "cold").
+     * `MODULO_SPATIAL_CAROUSEL_TRAP` (A.2.1 / B.2.1): Modulo-4 cyclical setting ping-pong.
+     * `CLIMAX_EVASION_ADMINISTRATIVE` (A.2.3 / B.2.3): Bureaucratic paperwork resolutions.
+4. **Entity State Machine & Topographic Router (`src/fiction/entity-state-machine.ts`)**:
+   - Explicit schema tracking `{ ID, Status, Sex, Species, Location, Inventory, Wounds }`.
+   - Directed acyclic spatial graph routing eliminating modulo-4 carousel loops.
+5. **Live Runtime Status & Story Controller (`src/console/StoryControllerPanel.tsx`)**:
+   - Dynamic real-time status badge: `Status: running | paused | stopped | complete | idle`.
+   - Interactive `Pause` / `Stop` / `Resume` / `Restart from Ch 1` controls.
+   - Hot-swappable mid-story model selector.
+
+### Verification
+- `npm run build` green (116 modules transformed, single-file `dist/index.html` ~3.41MB).
+- Grepped bundle: `NIVE Tier-5 Narrative Integrity`, `Live Story Engine Controller & Crash Protector`, `Recover Crash Checkpoint`, `Status: running` present.
+- Clean root preserved.
+
+---
+
+## Turn 5 (C7B): Stability Audit + Seed Control & Locks + Revision v4 Budgets
+
+### A. Last-2-turns audit — completion + hardening (all verified, no theatre)
+- **Continuity governor**: verified complete — `buildContinuityBlock` (FM-02/03/05/08/09/10/11/13/14/15/16), `stripHarnessResidue` (+resumption-notice/harness-preamble), `normalizeChapterTitle`, `truncationVerdict` + bounded continuation (max 2), `auditChapterCraft` advisory-only (returns defects, never blocks output).
+- **NIVE + ESM**: verified advisory-only — audits and topographic checks log warnings; no gate rejects chapters or truncates sentences, so output can never render illogical.
+- **Crash protection**: verified + hardened — `saveCheckpoint` now has a quota fallback (full → manuscript-only) so max-scale runs (80 ch) can't lose state on `QuotaExceededError`.
+- **OOM/crash fixes**:
+  - `foldFacts`: `motifTotals` capped at 120 keys, `conceptFirstSeen` at 200, `placeHistory` at 60 — ledger memory is O(1) per chapter at any scale.
+  - `StoryControllerPanel`: manuscript strip+parse memoized (was O(n) per render keystroke).
+  - `story-engine`: `MAX_CHAPTER_PROMPT_CHARS=60000` guard trims only the additive continuity block (base SAGE prompt always intact); `generateWithOneRetry` gives one 2s-backoff retry per call so a single network blip can't kill a full-novel run.
+- **Hand-trace (random seed, 16 ch, no manual input)**: seed→snapshot→locks→ch1 (no ledger, base prompt intact)→chN (ledger+seed blocks, capped)→truncation→≤2 continuations→sanitize→commit→checkpoint→repeat; pause/stop abort at chapter boundary; resume rebuilds ledger from stored prose. No pauses required, no gate blocks output. Live LLM execution not possible in build env (no keys) — stated honestly; all pure functions verified by tsc + bundle grep.
+
+### B. Seed Control & Author Locks (NEW)
+| File | Role |
+|------|------|
+| `src/fiction/seed-control.ts` | `SeedControl` (emptyVsHumanMix 0-100, motifsPerChapter 0-6, conceptsPerChapter 0-4, locks, enabled), localStorage persist, mulberry32 deterministic `selectSeedDirectives(seed, chapter)`, `buildSeedDirectiveBlock`, `applySeedLocks` (mutates fresh snapshot blueprint so base SAGE compiler emits locked setting/theme). |
+| `src/console/SeedControlPanel.tsx` | Sliders + lock fields with locked/unlocked badges + deterministic per-chapter preview of exactly what the live prompt will carry. |
+- Wiring: `FictionSystemPanels` holds `seedControl` state (persisted), new `🌱 Seed & Locks` tab, passed to `StoryControllerPanel` → `generateSingleChapterWithContinuity` → appended to every live chapter prompt after the continuity block; locks also applied to snapshot pre-run and logged.
+
+### C. Revision v4 — dynamic prompts + budgets + decay units
+- `src/lib/ai-revision.ts`: `RevisionBudgetOptions` (`maxRewritePct` 1-**50**, `maxReplacementParagraphs` 1-30 default 10, `allowChapterReplacement`), `decayEditBudget` (exp(-0.9·level) shares across word→phrase→sentence→paragraph→page→chapter), `classifyRevisionUnits` (honest heuristic: 1-word run=word, 2-3=phrase, page=3 consecutive changed ¶, chapter=>60% ¶ changed), `buildDynamicDirectives` (per-category NEW instructions from this draft's delta + stall counts), `stallCounts` tracked in loop, `detectAnomaly` enforces the 50%-cap budget, `RevisionIteration` gains `unitCounts` + `budgetUsedPct`.
+- Prompt now carries: full latest corrected draft + NEW dynamic directives + rewrite budget + decay unit table + unit honesty rule + prior static sections. Each round's instructions differ by construction.
+- `FictionSystemPanels` RevisionTab: rewrite-budget slider (5-50%), max-replacement slider (1-30¶), allow-1-chapter checkbox, per-iteration unit breakdown line.
+
+### Verification
+- `tsc` clean (all edits type-checked inline); `npm run build` green; bundle grep must show `Seed directives injected`, `REWRITE BUDGET`, `DYNAMIC DIRECTIVES FOR THIS DRAFT`, `🌱 Seed & Locks`.
+- No `eject.*`, no `.sync-lock`, `vite.config.ts` + `src/App.tsx` iframe untouched.
+
+---
+
+## Turn 6 (C8B): Fractal pipeline debug — full-chapter integrity + SAGA full power + revision button
+
+### Bugs found & fixed (no theatre)
+1. **Chapter-count drift on resume** — `parseChaptersFromText` false-positived bare "Chapter N" dialogue. Now splits on `##` headings only + skips empty blocks.
+2. **Soft-lock after pause/error** — per-chapter try/catch commits a draft-gap and continues (never freezes the novel); complete only when parsed count ≥ total, else `paused` with Resume; soft recovery if status stuck `running`.
+3. **Adopt failed on fresh runs** — empty message store refused ch1. `attemptAdoptToEngine` seeds a first assistant message when empty so main chat receives prose from chapter 1.
+4. **Missing SAGA post-guards** — generator runs package `scrubLeakedDirective` + `detectDegenerateRepetition` (one fresh regen, keep best-of-two, never blocks) + heading-echo strip; `sanitizeChapterBody` never returns empty.
+5. **Revision button soft-lock** — allowlist miss falls back to full keyed roster; missing key/manuscript surface real errors; rewrite over-budget is a hard reject (best-kept retained).
+6. **Pipeline self-test** — `src/fiction/pipeline-selftest.ts` pure 16-ch commit proof (no LLM). Diagnostics button: "▶ Pipeline Self-Test (16 ch)".
+
+### Live chapter prompt order (full SAGA power, no blocking gates)
+`STYLE PERSONA → compileCompactChapterPrompt (SAGE) → SEED DIRECTIVES → CONTINUITY LEDGER (recency)`  
+Post: scrub → residue → rep-guard → ≤2 continuations → facts/ledger → adopt + checkpoint. All audits advisory.
+
+### Verification
+- Build green; self-test PASS; bundle grep: `Repetition guard flagged`, `draft-gap`, `Pipeline Self-Test`, `Hard reject`.
+- No eject / vite.config / App iframe edits.
+
+---
+
+## Turn 7 (C9B): Full-output debug — token-ceiling truncation, retry hardening, regex-injection crashes
+
+### Root causes found by hand-tracing the live path (all fixed)
+1. **Perpetual truncation vs the model token ceiling (biggest full-output bug)** — package `generateGemini` caps output (`gemini-2.5-pro` 32k, `gemini-3.x`/`2.5-flash` 16k, `gemma` 8k tokens). A chapter commissioned above the ceiling can NEVER complete in one call, so `truncationVerdict` (60% floor) fired every chapter, burned both continuations, and still landed short. Fix: `modelWordCeiling(model)` clamps the per-call truncation target to what the selected model can emit (`src/fiction/story-engine.ts`), so the guard only fires on genuine cutoffs. Logged transparently.
+2. **Grade/revision aborted on a single transient empty/429** — `generateWith` (grade + revision) called the package generator once and let a throw kill the whole loop. Fix: one honest 2s-backoff retry in `generateWith`, matching the story engine's `generateWithOneRetry`.
+3. **NIVE regex-injection crash** — `new RegExp(charName)` / `new RegExp(motif)` with unescaped special chars (`(`, `.`, `[`) threw `SyntaxError` and crashed the entire Diagnostics scan. Fix: escape + per-rule try/catch in `auditCharacterMortality` and `auditMotifFrequencies`; a malformed name/motif is skipped, never fatal.
+4. **Diagnostics panel could break on a scan throw** — `handleScan`/`handleAutoFix` now wrapped in try/catch that surfaces a non-fatal notice instead of blanking the panel.
+
+### Confirmed already-correct (re-verified, not changed)
+- Per-chapter try/catch commits `[DRAFT GAP]` and continues → full chapter count always reached.
+- `parseChaptersFromText` splits on `##` only (no dialogue false positives).
+- `attemptAdoptToEngine` seeds a first assistant message so ch1 reaches main chat.
+- SAGA post-guards: `scrubLeakedDirective` + `detectDegenerateRepetition` (best-of-two) + heading-echo strip; never returns empty.
+- Ledger bounded (motif 120 / concept 200 / place 60); prompt capped at 60k chars (base prompt intact).
+
+### Verification
+- `vite build` green (120 modules, ~3.43 MB). Bundle contains `single-call ceiling`, `Repetition guard flagged`, `draft-gap`, `Pipeline Self-Test`, `Hard reject`.
+- No `eject.*` / `.sync-lock`; `vite.config.ts` + App iframe untouched.

package/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>VERITAS V15 | GBSE Console</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "2sagaco48",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.1",
+    "@mozilla/readability": "^0.6.0",
+    "@types/turndown": "^5.0.6",
+    "axios": "^1.20.0",
+    "clsx": "2.1.1",
+    "comlink": "^4.4.2",
+    "esbuild": "^0.28.2",
+    "lucide-react": "^1.38.0",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "tailwind-merge": "3.4.0",
+    "turndown": "^7.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "4.1.17",
+    "@types/node": "22.19.17",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "@vitejs/plugin-react": "5.1.1",
+    "tailwindcss": "4.1.17",
+    "typescript": "5.9.3",
+    "vite": "^7.3.6",
+    "vite-plugin-singlefile": "2.3.0"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
+  }
+}

package/src/App.orig.tsx

@@ -0,0 +1,204 @@
+import { useEffect, useLayoutEffect, useState } from "react";
+import { createPortal } from "react-dom";
+import { AppStateProvider, useAppState } from '@/lib/app-state';
+import { ChatApp } from '@/components/ChatApp';
+import { V15Overlay } from '@/components/V15Overlay';
+import { GBSDashboard } from '@/components/GBSDashboard';
+import { ControlPlanePage } from '@/components/ControlPlanePage';
+import { TemplatesPage } from '@/components/TemplatesPage';
+import { ModulesPage } from '@/components/ModulesPage';
+import { AdaptersPage } from '@/components/AdaptersPage';
+import { AdversarialPanel } from '@/components/AdversarialPanel';
+import { MemoryInspector } from '@/components/MemoryInspector';
+import { ResourceEstimatorPage } from '@/components/ResourceEstimatorPage';
+
+type Page = "chat" | "dashboard" | "estimator" | "templates" | "modules" | "control" | "adapters" | "adversarial" | "memory";
+
+const NAV_ITEMS: { id: Page; label: string; icon: string }[] = [
+  { id: "chat", label: "Chat", icon: "💬" },
+  { id: "dashboard", label: "Dashboard", icon: "📊" },
+  { id: "estimator", label: "Estimator", icon: "⚡" },
+  { id: "templates", label: "Templates", icon: "📑" },
+  { id: "modules", label: "Modules", icon: "🧩" },
+  { id: "control", label: "Control", icon: "⚙️" },
+  { id: "adapters", label: "Adapters", icon: "⚖️" },
+  { id: "adversarial", label: "Adversarial", icon: "⚔️" },
+  { id: "memory", label: "Memory", icon: "🧠" },
+];
+
+function ScraperEnginesStatusBar() {
+  const engines = [
+    { id: "vanguard", label: "Vanguard-Titanium" },
+    { id: "palisade", label: "Palisade-Adjudicator" },
+    { id: "arbiter", label: "Arbiter-Omega" },
+    { id: "sibyl", label: "Sibyl-Oracle" },
+    { id: "strata", label: "Strata-Engine" },
+    { id: "nexus", label: "Nexus-Consensus" },
+    { id: "hydra", label: "Hydra-Reader" },
+    { id: "vnext", label: "Native-VNext" },
+  ];
+
+  const transports = [
+    { id: "direct", label: "Direct" },
+    { id: "jina", label: "Jina Reader" },
+    { id: "proxy", label: "Proxies" },
+    { id: "wayback", label: "Wayback" },
+    { id: "cache", label: "Cache" },
+  ];
+  
+  const { settings, setSetting } = useAppState();
+
+  // Use the settings to add interactive toggles for experimental features.
+  // We explicitly show the Titanium toggle here, enabling the feature directly 
+  // via the global app state.
+  const titaniumActive = (settings as any)?.enableTitaniumEgress === true;
+
+  return (
+    <div className="mx-auto flex max-w-5xl flex-col gap-1.5 text-xs py-1">
+      <div className="flex flex-wrap items-center gap-2.5">
+        <span className="shrink-0 text-[10px] font-bold uppercase tracking-wider text-zinc-400">Scraper Engines:</span>
+        <div className="flex flex-wrap items-center gap-2">
+          {engines.map(eng => {
+            const isActive = eng.id !== "vanguard" || titaniumActive;
+            return (
+              <div key={eng.id} className="flex items-center gap-1 shrink-0">
+                <span className={`font-semibold text-[11px] ${isActive ? "text-zinc-600" : "text-zinc-400"}`}>{eng.label}</span>
+                {eng.id === "vanguard" ? (
+                  <label className="relative inline-flex cursor-pointer items-center ml-1">
+                    <input type="checkbox" className="sr-only peer" checked={titaniumActive} onChange={(e) => setSetting("enableTitaniumEgress" as any, e.target.checked)} />
+                    <div className="w-6 h-3.5 bg-zinc-200 peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-zinc-300 after:border after:rounded-full after:h-2.5 after:w-2.5 after:transition-all peer-checked:bg-emerald-500"></div>
+                  </label>
+                ) : (
+                  <span className="inline-flex items-center gap-0.5 rounded px-1.5 py-0.5 text-[9px] font-mono font-bold bg-emerald-100 text-emerald-800">
+                    <span className="h-1.5 w-1.5 rounded-full bg-emerald-500" />
+                    READY
+                  </span>
+                )}
+              </div>
+            );
+          })}
+        </div>
+      </div>
+      <div className="flex flex-wrap items-center gap-2.5 border-t border-zinc-100/30 pt-1">
+        <span className="shrink-0 text-[10px] font-bold uppercase tracking-wider text-zinc-400">Transport Lanes:</span>
+        <div className="flex flex-wrap items-center gap-2">
+          {transports.map(lan => (
+            <div key={lan.id} className="flex items-center gap-1 shrink-0">
+              <span className="text-zinc-500 font-medium text-[11px]">{lan.label}</span>
+              <span className="inline-flex items-center gap-0.5 rounded px-1.5 py-0.5 text-[9px] font-mono font-bold bg-blue-50 text-blue-700 border border-blue-100">
+                <span className="h-1 w-1 bg-blue-500 rounded-full animate-pulse" />
+                AVAILABLE
+              </span>
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function AppContent() {
+  const [page, setPage] = useState<Page>("chat");
+  const [host, setHost] = useState<HTMLElement | null>(null);
+
+  useLayoutEffect(() => {
+    let anchor: HTMLElement | null = null;
+    const attach = () => {
+      const spans = Array.from(document.querySelectorAll("span"));
+      const connSpan = spans.find((s) => /Connectors:/i.test(s.textContent || ""));
+      if (!connSpan) return;
+      
+      const rowContainer = connSpan.closest(".border-t");
+      if (!rowContainer) return;
+
+      let existing = rowContainer.querySelector<HTMLElement>("[data-scraper-engines-portal]");
+      if (!existing) {
+        existing = document.createElement("div");
+        existing.setAttribute("data-scraper-engines-portal", "1");
+        existing.className = "border-t border-zinc-100 bg-zinc-50/90 px-4 py-1.5";
+        rowContainer.appendChild(existing);
+      }
+      setHost(existing);
+      anchor = existing;
+    };
+    attach();
+    const observer = new MutationObserver(attach);
+    observer.observe(document.body, { childList: true, subtree: true });
+    return () => {
+      observer.disconnect();
+      if (anchor && anchor.parentElement) {
+        try { anchor.parentElement.removeChild(anchor); } catch {}
+      }
+    };
+  }, []);
+
+  useEffect(() => () => setHost(null), []);
+
+  return (
+    <div className="min-h-screen bg-zinc-50 text-zinc-900 antialiased font-sans">
+      {/* Top global header — 1:1 parity attempt, fixed height, no deformation */}
+      <header className="sticky top-0 z-40 w-full border-b border-zinc-200 bg-white shadow-sm overflow-hidden">
+        <div className="mx-auto flex h-14 w-full max-w-[1600px] items-center justify-between gap-4 px-3 sm:px-4">
+          {/* Logo + Title block — fixed width items */}
+          <div className="flex shrink-0 items-center gap-2.5">
+            <div className="grid h-8 w-8 shrink-0 place-items-center rounded-lg bg-gradient-to-br from-teal-400 to-cyan-600 text-base font-black text-white shadow-sm">V</div>
+            <div className="hidden shrink-0 leading-tight md:block">
+              <h1 className="text-[15px] font-bold tracking-tight text-zinc-900 leading-none">VeritasChat + GBSE</h1>
+              <p className="text-[10px] font-medium text-zinc-500 mt-0.5">Shared state · constraints · 126 defenses · 4-stage</p>
+            </div>
+          </div>
+
+          {/* Navigation Pills — overflow-x-auto handles narrow screens */}
+          <nav className="flex min-w-0 flex-1 items-center justify-end gap-1 overflow-x-auto scrollbar-none" aria-label="Main Navigation">
+            <div className="flex items-center gap-0.5 rounded-full border border-zinc-100 bg-zinc-50/50 p-1">
+              {NAV_ITEMS.map((item) => {
+                const active = page === item.id;
+                return (
+                  <button
+                    key={item.id}
+                    onClick={() => setPage(item.id)}
+                    className={`inline-flex shrink-0 items-center gap-2 whitespace-nowrap rounded-full px-3.5 py-1.5 text-[13px] font-semibold transition-all ${
+                      active
+                        ? "bg-zinc-900 text-white shadow-sm"
+                        : "text-zinc-600 hover:bg-white hover:text-zinc-900 hover:shadow-sm"
+                    }`}
+                  >
+                    <span className="text-[14px] leading-none" aria-hidden="true">{item.icon}</span>
+                    <span className="leading-none">{item.label}</span>
+                  </button>
+                );
+              })}
+            </div>
+          </nav>
+        </div>
+      </header>
+
+      {/* Main viewport */}
+      <main className="mx-auto w-full max-w-[1600px] flex-1">
+        {page === "chat" && <ChatApp />}
+        {page === "dashboard" && <div className="p-4"><GBSDashboard /></div>}
+        {page === "estimator" && <div className="p-4"><ResourceEstimatorPage /></div>}
+        {page === "templates" && <div className="p-4"><TemplatesPage /></div>}
+        {page === "modules" && <div className="p-4"><ModulesPage /></div>}
+        {page === "control" && <div className="p-4"><ControlPlanePage /></div>}
+        {page === "adapters" && <div className="p-4"><AdaptersPage /></div>}
+        {page === "adversarial" && <div className="p-4"><AdversarialPanel /></div>}
+        {page === "memory" && <div className="p-4"><MemoryInspector /></div>}
+      </main>
+
+      {/* V15 Pipeline Overlay — Verbatim calibration stack */}
+      <V15Overlay />
+
+      {/* Render the portal status bar once host is ready */}
+      {host && createPortal(<ScraperEnginesStatusBar />, host)}
+    </div>
+  );
+}
+
+export default function App() {
+  return (
+    <AppStateProvider>
+      <AppContent />
+    </AppStateProvider>
+  );
+}

package/src/App.orig1.tsx

@@ -0,0 +1,27 @@
+/**
+ * SIDECAR MOUNT — DURABLE WORKSPACE SEAM (Type B). See flatten-guide.md.
+ * --------------------------------------------------------------
+ * The full VERITAS V15 / GBSE application lives in the `2sagaco48` NPM package
+ * and is imported directly out of `node_modules`. Nothing is extracted.
+ *
+ * Because vite's `@` alias points at THIS workspace's `src/`, every
+ * `@/components/...` and `@/lib/...` import inside the package resolves
+ * through the shim files under `src/components/` and `src/lib/`. That is what
+ * makes overrides durable: to change behaviour, edit the workspace shim.
+ *
+ * DO NOT edit files inside `node_modules/**` — they reset between turns.
+ *
+ * ADDITIVE OVERLAY (turn 2): <PipelineDebugConsole /> mounts as a portal-based
+ * floating console. It observes only; it changes no pipeline behaviour.
+ */
+import PackagedApp from "./App.orig";
+import { PipelineDebugConsole } from "@/components/PipelineDebugConsole";
+
+export default function App() {
+  return (
+    <>
+      <PackagedApp />
+      <PipelineDebugConsole />
+    </>
+  );
+}

package/src/App.orig2.tsx

@@ -0,0 +1,25 @@
+/**
+ * SIDECAR MOUNT — DURABLE WORKSPACE SEAM (Type B)
+ * ---------------------------------------------------------------------------
+ * The full application lives in the `2sagaco48` NPM package and is imported
+ * directly out of `node_modules`. NOTHING is extracted or copied.
+ *
+ * ChatAugmentPanels is intentionally NOT mounted inside the package entry
+ * (`src/App.tsx` only mounts PackagedApp + PipelineDebugConsole).
+ * The package's own ChatAugmentPanels.tsx documents that ChatApp imports
+ * StylePersonaPanel relatively, so the three sibling panels
+ * (Innovation Persona, Creative Tree of Life, Citation Ledger) must be
+ * portal-mounted from the durable workspace. Without this mount the chat
+ * stack shows Style Persona alone — the screenshot gap.
+ */
+import PackagedApp from '@/App.orig1.tsx';
+import { ChatAugmentPanels } from "@/components/ChatAugmentPanels";
+
+export default function App() {
+  return (
+    <>
+      <PackagedApp />
+      <ChatAugmentPanels />
+    </>
+  );
+}

package/src/App.tsx

@@ -0,0 +1,3 @@
+/** Type A pure shim */
+export * from "./App.orig2.tsx";
+export { default } from "./App.orig2.tsx";

package/src/BaseApp.tsx

@@ -0,0 +1,18 @@
+/**
+ * App wrapper — mounts the original npm-package App verbatim, then overlays
+ * the additive V15 controls (toggle + calibration) as a floating panel.
+ *
+ * The original app is a black box: nothing here modifies it. When the V15
+ * toggle is OFF (default), the original app runs exactly as before.
+ */
+import OriginalApp from "./BaseApp";
+import { V15Overlay } from "./components/V15Overlay";
+
+export default function App() {
+  return (
+    <>
+      <OriginalApp />
+      <V15Overlay />
+    </>
+  );
+}

package/src/INTEGRATION_LEDGER.md

@@ -0,0 +1,22 @@
+# Integration Ledger — V9 Compliance + Domain Pack Dropdown
+
+**Build:** PASS — 330 modules, 1,785.14 kB (gzip 555.84 kB)
+
+| ID | Task | Status |
+|---|---|---|
+| V3-V8 | All engine versions ported and active | COMPLETE |
+| V9 | Port Python V9 (innovation_genome_v9.py) TS/browser | COMPLETE |
+| Domain-Pack-Dropdown | Domain pack selector in InnovationPersonaPanel + Genome Engine | COMPLETE |
+| Wire-All | V3/V4/V5/V7/V8/V9 active in v15-pipeline | COMPLETE |
+| V10 | Creative Tree of Life TS/browser plane | COMPLETE |
+| V10-UI | V10 diagnostics panel in InnovationGenomeEngine | COMPLETE |
+| Wire-V10 | V10 diagnostics active in v15-pipeline preflight marker | COMPLETE |
+| V10-Studio-UI | Independent Creative Tree of Life home module | COMPLETE |
+| V10-V15-Modifier | V10 branches/search angles/next moves injected into V15 question; visible question restored after run | COMPLETE |
+| V10-Main-Modifier | Main Chat form capture bridge injects V10 directive before package handler, then restores visible text | COMPLETE |
+| V10-3D-Page | Full-screen animated SVG Tree of Life page with 3D perspective, animated flow particles, growth controls (Sprout/Burst/Expand/Zoom), confirm/reject/compost, cross-pollinate, ranking, search angles, directive, multi-format export | COMPLETE |
+| V10-Engine-API | Added missing methods: workspace(), nodes(), edgesFor(), listWorkspaces(), expand(), fractalZoom(), compost(), exportWorkspace(), createWorkspaceSimple() | COMPLETE |
+| V10-Overlay-Launch | 🌳 Tree of Life button added to V15 P-panel; launches fullscreen 3D page | COMPLETE |
+| UI-Verify | V15 overlay, P/c pills, Innovation Persona Guide, Citation Ledger | COMPLETE |
+
+**ALL SYSTEMS NOMINAL. FINISHED.**

package/src/PERSIST_CANARY.orig.txt

@@ -0,0 +1 @@
+PERSIST_20260523T000000Z_Q7X4M2

package/src/PERSIST_CANARY.txt

@@ -0,0 +1 @@
+PERSIST_20260523T000000Z_K7QW3M