2sagaco48 1.0.0

package/src/console/DiagnosticRecoveryPanel.tsx

@@ -0,0 +1,358 @@
+import { useState } from "react";
+import {
+  runDeterministicDiagnostics,
+  applyDeterministicAutoFixes,
+  type FullDiagnosticReport,
+} from "../fiction/diagnostics";
+import { NarrativeIntegrityEngine, type NIVEViolation } from "../fiction/nive-engine";
+import { runFictionPipelineSelfTest, type SelfTestReport } from "../fiction/pipeline-selftest";
+import { type ContinuityToggles } from "../fiction/types";
+import { callGeminiResilient } from "./gemini";
+import { copyText, cx } from "./util";
+
+interface Props {
+  manuscript: string;
+  setManuscript: (s: string) => void;
+  toggles: ContinuityToggles;
+  setToggles: React.Dispatch<React.SetStateAction<ContinuityToggles>>;
+  apiKey: string;
+  modelPool: string[];
+  iframeRef: React.RefObject<HTMLIFrameElement | null>;
+}
+
+export function DiagnosticRecoveryPanel({
+  manuscript,
+  setManuscript,
+  toggles,
+  setToggles,
+  apiKey,
+  modelPool,
+  iframeRef,
+}: Props) {
+  const [report, setReport] = useState<FullDiagnosticReport | null>(null);
+  const [niveViolations, setNiveViolations] = useState<NIVEViolation[]>([]);
+  const [niveScore, setNiveScore] = useState<number | null>(null);
+  const [autoFixLog, setAutoFixLog] = useState<string[]>([]);
+  const [llmDiag, setLlmDiag] = useState<string>("");
+  const [llmBusy, setLlmBusy] = useState(false);
+  const [resetMsg, setResetMsg] = useState("");
+  const [selfTest, setSelfTest] = useState<SelfTestReport | null>(null);
+
+  const handleScan = () => {
+    try {
+      // 1. Run basic deterministic diagnostics
+      setReport(runDeterministicDiagnostics(manuscript));
+      // 2. Run deep NIVE Tier-5 audit engine
+      const nive = new NarrativeIntegrityEngine(manuscript, "MS-ACTIVE", {
+        sentenceRange: [6, 28],
+        motifLimits: { truth: 6, cold: 6, vault: 6, refrigeratory: 3, borderland: 6 },
+        mortality: { Thurn: 1, Dorn: 8 },
+      });
+      const niveReport = nive.runAllAudits();
+      setNiveViolations(niveReport.violations);
+      setNiveScore(niveReport.cleanScore);
+    } catch (e) {
+      // A scan crash must never break the panel; surface it as an empty result.
+      setNiveViolations([]);
+      setNiveScore(null);
+      setAutoFixLog([`Scan error (non-fatal): ${e instanceof Error ? e.message : String(e)}`]);
+    }
+  };
+
+  const handleAutoFix = () => {
+    try {
+      const { cleanedText, fixesApplied } = applyDeterministicAutoFixes(manuscript);
+      setManuscript(cleanedText);
+      setAutoFixLog(fixesApplied);
+      setReport(runDeterministicDiagnostics(cleanedText));
+      const nive = new NarrativeIntegrityEngine(cleanedText, "MS-ACTIVE");
+      const niveReport = nive.runAllAudits();
+      setNiveViolations(niveReport.violations);
+      setNiveScore(niveReport.cleanScore);
+    } catch (e) {
+      setAutoFixLog([`Auto-fix error (non-fatal): ${e instanceof Error ? e.message : String(e)}`]);
+    }
+  };
+
+  const handleLlmDiagnose = async () => {
+    if (!manuscript.trim() || !apiKey.trim() || llmBusy) return;
+    setLlmBusy(true);
+    setLlmDiag("");
+    try {
+      const prompt = [
+        "You are an expert narrative architect and literary diagnostic engineer.",
+        "Diagnose why this manuscript has low scores in Plot Architecture & Pacing and Character Voice.",
+        "Check specifically for: (1) Procedural deadlock / repetitive inspections, (2) Climax evasion / administrative anticlimax, (3) Lack of active antagonist pressure, (4) Invariant time windowing, (5) Sensor/instrument padding, (6) Character resurrection or sex/profession drift.",
+        "Provide 3-5 concrete, actionable prompt adjustments and code-level continuity recommendations.",
+        "",
+        "MANUSCRIPT EXCERPT:",
+        manuscript.slice(0, 12000),
+      ].join("\n");
+
+      const res = await callGeminiResilient(modelPool, undefined, {
+        apiKey,
+        prompt,
+        temperature: 0.3,
+      });
+
+      if (res.ok) {
+        setLlmDiag(res.text);
+      } else {
+        setLlmDiag(`Diagnostic call failed: ${res.error}`);
+      }
+    } finally {
+      setLlmBusy(false);
+    }
+  };
+
+  const handleEmergencyReset = () => {
+    try {
+      const frame = iframeRef.current;
+      if (frame?.contentWindow) {
+        try {
+          frame.contentWindow.sessionStorage.removeItem("veritas.busyState");
+          frame.contentWindow.localStorage.removeItem("veritas.busyLock");
+        } catch {}
+      }
+      window.sessionStorage.removeItem("veritas.busyState");
+      window.localStorage.removeItem("veritas.busyLock");
+
+      const unlockEvent = new CustomEvent("veritas:emergency-unblock", { detail: { time: Date.now() } });
+      window.dispatchEvent(unlockEvent);
+      frame?.contentWindow?.dispatchEvent(unlockEvent);
+
+      setResetMsg("✓ Emergency reset dispatched: cleared busy locks across iframe and parent window.");
+      setTimeout(() => setResetMsg(""), 6000);
+    } catch (e) {
+      setResetMsg(`Reset error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  };
+
+  const toggleList: { key: keyof ContinuityToggles; label: string; desc: string }[] = [
+    { key: "enableFM02ContinueFrom", label: "FM-02 Continue-From Lock", desc: "Quotes exact closing sentence and forbids restarting the opening beat." },
+    { key: "enableFM03AntiStasis", label: "FM-03 Anti-Stasis Vector", desc: "Requires physical/knowledge change vectors and bans repeating dominant inspection verbs." },
+    { key: "enableFM04TruncationRecovery", label: "FM-04 Truncation Recovery", desc: "Detects unterminated sentences and triggers bounded same-chapter continuations." },
+    { key: "enableFM05MotifCooldown", label: "FM-05 Motif Cooldown", desc: "Enforces phrase count ceiling; overused story-bible tags become a banned list." },
+    { key: "enableFM06TitleNormalization", label: "FM-06 Title Normalization", desc: "Collapses 'The The Reckoning' and duplicate articles into clean grammar." },
+    { key: "enableFM07ResidueStripping", label: "FM-07 Residue Stripping", desc: "Strips [Source N], [CHECKSUM], and harness error artifacts before committing prose." },
+    { key: "enableFM08PovLock", label: "FM-08 POV Lock", desc: "Enforces point-of-view pronoun consistency against the frozen blueprint." },
+    { key: "enableFM09ActLadder", label: "FM-09 Act Ladder Climax", desc: "Forbids administrative anticlimaxes and enforces real dramatic confrontations." },
+    { key: "enableFM10TransitRules", label: "FM-10 Transit Rules", desc: "Enforces sensory travel duration and costs to prevent spatial teleportation." },
+    { key: "enableFM11ConceptBudget", label: "FM-11 Concept Budget", desc: "Caps new worldbuilding jargon to at most 2 per chapter to prevent epistemic overload." },
+    { key: "enableFM12BeatLedger", label: "FM-12 Beat Ledger", desc: "Prevents repeating identical relational beats (like cognitive handoffs) in consecutive scenes." },
+    { key: "enableFM13ClockMonotonicity", label: "FM-13 Clock Monotonicity", desc: "Prevents temporal claustrophobia by enforcing monotonic forward movement of the macro-clock." },
+    { key: "enableFM14MeasurementBudget", label: "FM-14 Sensor Budget", desc: "Caps numeric measurements (Hz, dB, millibars) to at most 6 per chapter." },
+    { key: "enableFM15CurrencyBudget", label: "FM-15 Currency Budget", desc: "Caps coin/fee accounting to at most 2 per chapter, preventing bookkeeping stasis." },
+    { key: "enableFM16IrreversibleLedger", label: "FM-16 Irreversible Ledger", desc: "Records permanent consequences (deaths, destroyed assets) and prevents zero-stakes resets." },
+  ];
+
+  return (
+    <div className="space-y-4 text-[13px]">
+      {/* Recovery & Unblock section */}
+      <div className="rounded-xl border border-rose-300 bg-rose-50/60 p-3">
+        <div className="flex flex-wrap items-center justify-between gap-2">
+          <div>
+            <h4 className="font-bold text-rose-900">🚨 Runtime Pipeline Recovery &amp; Unfreeze</h4>
+            <p className="text-[11px] text-rose-700">
+              If the main &apos;Ground &amp; Answer&apos; button is grayed out or a crashed generation left the engine in a frozen busy state, click below to immediately unblock.
+            </p>
+          </div>
+          <button
+            onClick={handleEmergencyReset}
+            className="rounded-lg bg-rose-700 px-3 py-1.5 text-xs font-bold text-white shadow-sm hover:bg-rose-800"
+          >
+            ⚡ Unblock Chat &amp; Reset Busy State
+          </button>
+        </div>
+        {resetMsg && <div className="mt-2 text-[11px] font-semibold text-rose-900">{resetMsg}</div>}
+      </div>
+
+      {/* Deterministic Scan & Auto-Fix */}
+      <div className="rounded-xl border border-zinc-200 bg-white p-3 shadow-sm">
+        <div className="flex flex-wrap items-center justify-between gap-2 border-b border-zinc-100 pb-2">
+          <div>
+            <h4 className="font-bold text-zinc-900">🔬 NIVE Tier-5 Narrative Integrity &amp; Failure-Mode Scanner</h4>
+            <p className="text-[11px] text-zinc-500">
+              Deterministic verification against all 15 failure modes: character resurrection, ontological drift, prompt leaks, and stasis.
+            </p>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            <button
+              onClick={handleScan}
+              disabled={!manuscript.trim()}
+              className="rounded-lg bg-teal-600 px-3 py-1 text-xs font-semibold text-white hover:bg-teal-700 disabled:opacity-40"
+            >
+              Scan Manuscript
+            </button>
+            <button
+              onClick={handleAutoFix}
+              disabled={!manuscript.trim()}
+              className="rounded-lg border border-teal-300 bg-teal-50 px-3 py-1 text-xs font-semibold text-teal-800 hover:bg-teal-100 disabled:opacity-40"
+            >
+              Apply Auto-Fixes
+            </button>
+            <button
+              onClick={() => setSelfTest(runFictionPipelineSelfTest(16))}
+              className="rounded-lg border border-indigo-300 bg-indigo-50 px-3 py-1 text-xs font-semibold text-indigo-800 hover:bg-indigo-100"
+              title="Pure deterministic proof that a full 16-chapter commit loop never stalls (no LLM, no network)"
+            >
+              ▶ Pipeline Self-Test (16 ch)
+            </button>
+          </div>
+        </div>
+
+        {autoFixLog.length > 0 && (
+          <div className="mt-2 rounded bg-emerald-50 p-2 text-[11px] text-emerald-800">
+            <div className="font-bold">Auto-Fixes Executed:</div>
+            <ul className="list-disc pl-4">
+              {autoFixLog.map((log, i) => (
+                <li key={i}>{log}</li>
+              ))}
+            </ul>
+          </div>
+        )}
+
+        {selfTest && (
+          <div className={cx("mt-2 rounded border p-2 text-[11px]", selfTest.pass ? "border-emerald-300 bg-emerald-50 text-emerald-900" : "border-rose-300 bg-rose-50 text-rose-900")}>
+            <div className="font-bold">
+              Pipeline Self-Test: {selfTest.pass ? "PASS" : "FAIL"} ({selfTest.cases.filter((c) => c.pass).length}/{selfTest.cases.length})
+            </div>
+            <ul className="mt-1 max-h-40 space-y-0.5 overflow-y-auto font-mono text-[10px]">
+              {selfTest.cases.map((c, i) => (
+                <li key={i}>
+                  {c.pass ? "✓" : "✗"} {c.name}
+                  {c.detail ? ` — ${c.detail}` : ""}
+                </li>
+              ))}
+            </ul>
+          </div>
+        )}
+
+        {report && (
+          <div className="mt-3 space-y-3">
+            <div className="grid grid-cols-4 gap-2 text-center text-xs">
+              <div className="rounded border border-zinc-100 bg-zinc-50 p-2">
+                <div className="text-[10px] uppercase text-zinc-400">NIVE Integrity</div>
+                <div className="text-base font-bold text-indigo-700">{niveScore !== null ? `${niveScore}/100` : "—"}</div>
+              </div>
+              <div className="rounded border border-zinc-100 bg-zinc-50 p-2">
+                <div className="text-[10px] uppercase text-zinc-400">Cleanliness</div>
+                <div className="text-base font-bold text-teal-700">{report.cleanlinessScore}/100</div>
+              </div>
+              <div className="rounded border border-zinc-100 bg-zinc-50 p-2">
+                <div className="text-[10px] uppercase text-zinc-400">Stasis Risk</div>
+                <div className={cx("text-base font-bold capitalize", report.stasisRisk === "high" ? "text-rose-600" : "text-emerald-700")}>
+                  {report.stasisRisk}
+                </div>
+              </div>
+              <div className="rounded border border-zinc-100 bg-zinc-50 p-2">
+                <div className="text-[10px] uppercase text-zinc-400">Pacing Risk</div>
+                <div className={cx("text-base font-bold capitalize", report.pacingRisk === "high" ? "text-rose-600" : "text-emerald-700")}>
+                  {report.pacingRisk}
+                </div>
+              </div>
+            </div>
+
+            {/* NIVE Violations List */}
+            {niveViolations.length > 0 && (
+              <div className="space-y-1.5 mt-2">
+                <div className="font-bold text-xs text-zinc-800">NIVE Programmatic Violations ({niveViolations.length}):</div>
+                {niveViolations.map((v, i) => (
+                  <div key={i} className="rounded border border-rose-200 bg-rose-50/50 p-2 text-xs">
+                    <div className="flex items-center gap-2">
+                      <span className={cx("rounded px-1.5 py-0.5 text-[9px] font-bold uppercase", v.severity === "critical" ? "bg-rose-200 text-rose-900" : "bg-amber-200 text-amber-900")}>
+                        {v.type}
+                      </span>
+                      {v.chapter && <span className="font-semibold text-zinc-700">Ch {v.chapter}</span>}
+                      {v.chapters && <span className="font-semibold text-zinc-700">Ch {v.chapters.join(", ")}</span>}
+                    </div>
+                    <div className="mt-1 text-zinc-800">{v.message}</div>
+                    {v.evidence && v.evidence.length > 0 && (
+                      <div className="mt-0.5 text-[10px] text-zinc-500 font-mono">
+                        Evidence: {v.evidence.join(" · ")}
+                      </div>
+                    )}
+                  </div>
+                ))}
+              </div>
+            )}
+
+            {report.findings.length === 0 && niveViolations.length === 0 ? (
+              <div className="rounded bg-emerald-50 p-2 text-center text-xs text-emerald-800">
+                ✓ No critical structural defects or residue leaks detected in current manuscript.
+              </div>
+            ) : null}
+          </div>
+        )}
+      </div>
+
+      {/* LLM Deep Narrative Diagnostic */}
+      <div className="rounded-xl border border-zinc-200 bg-white p-3 shadow-sm">
+        <div className="flex flex-wrap items-center justify-between gap-2 border-b border-zinc-100 pb-2">
+          <div>
+            <h4 className="font-bold text-zinc-900">🧠 LLM Deep Narrative Diagnosis</h4>
+            <p className="text-[11px] text-zinc-500">Prompt an LLM to evaluate plot pacing and character voice with fresh context.</p>
+          </div>
+          <button
+            onClick={handleLlmDiagnose}
+            disabled={!manuscript.trim() || !apiKey.trim() || llmBusy}
+            className="rounded-lg bg-indigo-600 px-3 py-1 text-xs font-semibold text-white hover:bg-indigo-700 disabled:opacity-40"
+          >
+            {llmBusy ? "Analyzing..." : "Run LLM Diagnostic"}
+          </button>
+        </div>
+
+        {llmDiag && (
+          <div className="mt-3">
+            <div className="flex items-center justify-between pb-1">
+              <span className="text-[11px] font-bold text-zinc-700">Diagnostic Assessment:</span>
+              <button
+                onClick={() => copyText(llmDiag)}
+                className="rounded border border-zinc-200 px-2 py-0.5 text-[10px] text-zinc-600 hover:bg-zinc-100"
+              >
+                Copy
+              </button>
+            </div>
+            <pre className="max-h-60 overflow-y-auto whitespace-pre-wrap rounded-lg bg-zinc-900 p-2.5 font-mono text-[10px] leading-relaxed text-zinc-100">
+              {llmDiag}
+            </pre>
+          </div>
+        )}
+      </div>
+
+      {/* Continuity Governor Feature Toggles */}
+      <div className="rounded-xl border border-zinc-200 bg-white p-3 shadow-sm">
+        <h4 className="font-bold text-zinc-900 mb-1">🎛️ Continuity Governor Feature Toggles</h4>
+        <p className="text-[11px] text-zinc-500 mb-3">
+          Enable or disable individual failure-mode rules. All features are additively layered into the chapter prompt.
+        </p>
+
+        <div className="grid grid-cols-1 gap-2 sm:grid-cols-2">
+          {toggleList.map((t) => {
+            const isChecked = toggles[t.key];
+            return (
+              <label
+                key={t.key}
+                className={cx(
+                  "flex items-start gap-2.5 rounded-lg border p-2 cursor-pointer transition-colors",
+                  isChecked ? "border-teal-300 bg-teal-50/40" : "border-zinc-200 bg-zinc-50/30"
+                )}
+              >
+                <input
+                  type="checkbox"
+                  checked={isChecked}
+                  onChange={(e) => setToggles((prev) => ({ ...prev, [t.key]: e.target.checked }))}
+                  className="mt-0.5 h-4 w-4 rounded border-zinc-300 text-teal-600 focus:ring-teal-500"
+                />
+                <div className="flex-1">
+                  <div className="font-semibold text-zinc-800 text-xs">{t.label}</div>
+                  <div className="text-[10px] text-zinc-500 leading-snug">{t.desc}</div>
+                </div>
+              </label>
+            );
+          })}
+        </div>
+      </div>
+    </div>
+  );
+}

package/src/console/EngineeringConsole.tsx

@@ -0,0 +1,103 @@
+import { useEffect, useState, type RefObject } from "react";
+import { assembleManuscript, getGeminiKey, type ManuscriptSource } from "./engineBridge";
+import { cx } from "./util";
+import { FictionSystemPanels } from "./FictionSystemPanels";
+
+const SOURCE_LABEL: Record<ManuscriptSource, string> = {
+  "engine-messages": "engine chat history",
+  "engine-dom": "engine DOM (fallback)",
+  none: "not found",
+};
+
+export function EngineeringConsole({ iframeRef }: { iframeRef: RefObject<HTMLIFrameElement | null> }) {
+  const [open, setOpen] = useState(false);
+  const [manuscript, setManuscript] = useState("");
+  const [source, setSource] = useState<ManuscriptSource>("none");
+
+  function loadFromEngine() {
+    const m = assembleManuscript(iframeRef.current);
+    setManuscript(m.text);
+    setSource(m.source);
+    // Touch the key store so first-load failures surface early; panels read keys live.
+    getGeminiKey(iframeRef.current);
+  }
+
+  useEffect(() => {
+    if (open && !manuscript) loadFromEngine();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open]);
+
+  return (
+    <>
+      {/* Launcher */}
+      <button
+        onClick={() => setOpen((o) => !o)}
+        className="fixed bottom-4 right-4 z-[2147483000] flex items-center gap-2 rounded-full bg-zinc-900 px-4 py-2.5 text-[13px] font-semibold text-white shadow-lg ring-1 ring-black/10 hover:bg-zinc-800"
+        title="SAGA OS Studio — Fiction System Transparency"
+      >
+        <span>{"\u{1F9EA}"}</span>
+        <span className="hidden sm:inline">SAGA Console</span>
+      </button>
+
+      {/* Drawer */}
+      <div
+        className={cx(
+          "fixed inset-y-0 right-0 z-[2147482000] flex w-full max-w-[760px] flex-col bg-zinc-50 shadow-2xl ring-1 ring-black/10 transition-transform duration-200",
+          open ? "translate-x-0" : "translate-x-full",
+        )}
+        role="dialog"
+        aria-label="SAGA OS Studio Fiction System Transparency"
+      >
+        <header className="flex items-center justify-between border-b border-zinc-200 bg-white px-4 py-2.5">
+          <div>
+            <h2 className="text-[14px] font-bold text-zinc-900">SAGA OS Studio · Fiction System Transparency</h2>
+            <p className="text-[11px] text-zinc-500">Fiction Input · System Map &amp; Runtime · Grade v2 · Recursive Revision</p>
+          </div>
+          <button onClick={() => setOpen(false)} className="rounded-lg px-2 py-1 text-zinc-400 hover:bg-zinc-100 hover:text-zinc-700">
+            {"\u2715"}
+          </button>
+        </header>
+
+        {/* Shared manuscript */}
+        <div className="space-y-2 border-b border-zinc-200 bg-white px-4 py-2.5">
+          <div className="flex flex-wrap items-center gap-2">
+            <button onClick={loadFromEngine} className="rounded-lg border border-teal-300 bg-teal-50 px-2.5 py-1 text-[12px] font-semibold text-teal-700 hover:bg-teal-100">
+              Load manuscript from engine
+            </button>
+            <button
+              onClick={() => {
+                const frame = iframeRef.current;
+                if (frame?.contentWindow) {
+                  try {
+                    frame.contentWindow.sessionStorage.removeItem("veritas.busyState");
+                    frame.contentWindow.localStorage.removeItem("veritas.busyLock");
+                    frame.contentWindow.location.reload();
+                  } catch {}
+                }
+                loadFromEngine();
+              }}
+              className="rounded-lg border border-zinc-300 bg-zinc-50 px-2.5 py-1 text-[12px] font-semibold text-zinc-700 hover:bg-zinc-100"
+              title="Reload the engine iframe to immediately sync adopted texts and unfreeze buttons"
+            >
+              🔄 Reload Engine View
+            </button>
+            <span className="text-[11px] text-zinc-500">
+              source: <b>{SOURCE_LABEL[source]}</b> · {manuscript.length.toLocaleString()} chars
+            </span>
+          </div>
+          <textarea
+            value={manuscript}
+            onChange={(e) => setManuscript(e.target.value)}
+            placeholder="Full manuscript (whole book). Auto-loaded from the engine, or paste/edit here."
+            className="h-24 w-full resize-y rounded-lg border border-zinc-300 p-2 font-mono text-[11px] text-zinc-700"
+          />
+        </div>
+
+        {/* Canonical panels */}
+        <div className="flex-1 overflow-y-auto p-4">
+          <FictionSystemPanels iframeRef={iframeRef} manuscript={manuscript} setManuscript={setManuscript} />
+        </div>
+      </div>
+    </>
+  );
+}