feat: persist advisor sessions

Co-authored-by: Codex <noreply@openai.com>

README.md

@@ -80,6 +80,12 @@ map, so the share artifact visually proves whether the page sits in an empty mar
 The custom frontend shows optimistic ink immediately after submit. If the first streamed token is slow, a lightweight
 watchdog updates the page text so the demo never sits in a silent blank state during Space startup or model routing.
 
+## Session Persistence
+
+The frontend stores the current advisor session in browser `localStorage`: profile notes, selected targets, idea board,
+trace, latest build plan, and last share artifact. Refreshing the Space restores the same cockpit state; the `Reset`
+button clears the saved session and returns to the current snapshot defaults.
+
 ## Tool-Call Contract
 
 `/api/tool-contracts` exposes the JSON schemas intended for MiniCPM-style tool calling. `tool_contract_check` accepts a

static/app.js

@@ -20,6 +20,9 @@ const overallEl = document.querySelector("#overall");
 const exportButton = document.querySelector("#export-artifact");
 const exportTraceButton = document.querySelector("#export-trace");
 const exportNotesButton = document.querySelector("#export-notes");
+const resetButton = document.querySelector("#reset-session");
+
+const SESSION_STORAGE_KEY = "hackathon-advisor-session-v1";
 
 let session = {};
 let clientPromise = Client.connect(window.location.origin);
@@ -57,6 +60,11 @@ exportNotesButton.addEventListener("click", async () => {
   await exportNotes();
 });
 
+resetButton.addEventListener("click", () => {
+  clearSavedSession();
+  window.location.reload();
+});
+
 targetsEl.addEventListener("change", (event) => {
   const target = event.target;
   if (!(target instanceof HTMLInputElement) || !target.dataset.target) return;
@@ -65,6 +73,7 @@ targetsEl.addEventListener("change", (event) => {
   );
   session.targets = targetOptions.filter((option) => checked.has(option));
   syncCurrentIdeaTargets();
+  saveSession();
   renderIdeas(session.ideas || []);
 });
 
@@ -79,6 +88,7 @@ profileEl.addEventListener("input", (event) => {
     delete profile[target.dataset.profileField];
   }
   session.profile = profile;
+  saveSession();
 });
 
 async function runTurn(message) {
@@ -126,16 +136,12 @@ async function bootstrap() {
     profile: {},
     targets: data.default_targets || targetOptions.slice(0, 3),
   };
+  session = normalizeSession(readSavedSession(), session);
   renderProvenance(data);
   renderTargets(session.targets);
   renderProfile(session.profile);
-  renderProjects(data.top_projects || []);
+  renderRestoredSession(data);
   renderWhitespace(data.whitespace || []);
-  renderIdeas([]);
-  renderWoodMap(null);
-  renderScore(null);
-  renderPlan([]);
-  renderTrace([]);
 }
 
 function renderProvenance(data) {
@@ -145,6 +151,76 @@ function renderProvenance(data) {
   provenanceEl.textContent = `${data.index_algorithm || "index"} · snapshot ${snapshot} · index ${index} · ${digest}`;
 }
 
+function renderRestoredSession(data) {
+  currentArtifact = session.last_artifact || null;
+  if (currentArtifact?.seal) {
+    renderScore(currentArtifact.seal);
+    verdictEl.textContent = currentArtifact.verdict || currentArtifact.seal.verdict || "UNWRITTEN";
+    overallEl.textContent = Number(currentArtifact.overall || currentArtifact.seal.overall || 0).toFixed(1);
+    renderWoodMap(currentArtifact.wood_map || null);
+    if (currentArtifact.seal.echoes?.length) {
+      renderCitations(currentArtifact.seal.echoes);
+    } else {
+      renderProjects(data.top_projects || []);
+    }
+    exportButton.disabled = false;
+  } else {
+    renderScore(null);
+    renderWoodMap(null);
+    renderProjects(data.top_projects || []);
+    exportButton.disabled = true;
+  }
+  renderIdeas(session.ideas || []);
+  renderPlan(session.last_plan || []);
+  renderTrace(session.trace || []);
+  exportTraceButton.disabled = !(session.trace?.length);
+  exportNotesButton.disabled = !(session.trace?.length);
+}
+
+function readSavedSession() {
+  try {
+    const raw = window.localStorage.getItem(SESSION_STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function normalizeSession(savedSession, defaultSession) {
+  const normalized = { ...defaultSession };
+  if (!savedSession) return normalized;
+  normalized.profile = savedSession.profile && typeof savedSession.profile === "object" ? savedSession.profile : {};
+  const savedTargets = Array.isArray(savedSession.targets) ? savedSession.targets : defaultSession.targets;
+  normalized.targets = targetOptions.filter((option) => savedTargets.includes(option));
+  if (!normalized.targets.length && defaultSession.targets?.length) normalized.targets = [...defaultSession.targets];
+  if (Array.isArray(savedSession.ideas)) normalized.ideas = savedSession.ideas;
+  if (Array.isArray(savedSession.trace)) normalized.trace = savedSession.trace;
+  if (Array.isArray(savedSession.last_plan)) normalized.last_plan = savedSession.last_plan;
+  if (savedSession.current_idea_id) normalized.current_idea_id = savedSession.current_idea_id;
+  if (savedSession.current_whitespace) normalized.current_whitespace = savedSession.current_whitespace;
+  if (savedSession.last_tool_resolution) normalized.last_tool_resolution = savedSession.last_tool_resolution;
+  if (savedSession.last_artifact) normalized.last_artifact = savedSession.last_artifact;
+  return normalized;
+}
+
+function saveSession() {
+  try {
+    window.localStorage.setItem(SESSION_STORAGE_KEY, JSON.stringify(session));
+  } catch {
+    // Storage may be disabled in some embeds; the app still works in-memory.
+  }
+}
+
+function clearSavedSession() {
+  try {
+    window.localStorage.removeItem(SESSION_STORAGE_KEY);
+  } catch {
+    // Nothing else to clear when storage is unavailable.
+  }
+}
+
 function renderTargets(selectedTargets) {
   const selected = new Set(selectedTargets || []);
   targetsEl.innerHTML = "";
@@ -234,6 +310,7 @@ function handleEvent(event) {
     }
     exportTraceButton.disabled = !(session.trace?.length);
     exportNotesButton.disabled = !(session.trace?.length);
+    saveSession();
   }
 }
 

static/index.html

@@ -35,6 +35,7 @@
               <button type="button" id="export-trace" title="Export the tool trace" disabled>JSONL</button>
               <button type="button" id="export-notes" title="Export Field Notes" disabled>Notes</button>
               <button type="button" id="export-artifact" title="Export the current fate page" disabled>PNG</button>
+              <button type="button" id="reset-session" title="Clear the saved session">Reset</button>
             </div>
             <div id="corrections" class="corrections" aria-live="polite"></div>
           </section>

static/styles.css

@@ -184,7 +184,7 @@ button:disabled {
 
 .command-row {
   display: grid;
-  grid-template-columns: repeat(6, minmax(0, 1fr));
+  grid-template-columns: repeat(7, minmax(0, 1fr));
   gap: 8px;
   margin-top: 10px;
 }
@@ -527,7 +527,7 @@ button:disabled {
   }
 
   .command-row {
-    grid-template-columns: repeat(3, minmax(0, 1fr));
+    grid-template-columns: repeat(4, minmax(0, 1fr));
   }
 
   .score-row {