npm - mover-os - Versions diffs - 4.7.6 → 4.7.8 - Mend

mover-os 4.7.6 → 4.7.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (107) hide show

package/install.js +763 -70
package/package.json +15 -3
package/src/dashboard/build.js +1503 -0
package/src/dashboard/dashboard.js +276 -0
package/src/dashboard/index.js +319 -0
package/src/dashboard/lib/activation-log.js +297 -0
package/src/dashboard/lib/active-context-parser.js +177 -0
package/src/dashboard/lib/agent-command.js +93 -0
package/src/dashboard/lib/agent-detect.js +255 -0
package/src/dashboard/lib/agent-detector.js +92 -0
package/src/dashboard/lib/agent-session.js +462 -0
package/src/dashboard/lib/anti-identity-detector.js +116 -0
package/src/dashboard/lib/auto-learnings-parser.js +183 -0
package/src/dashboard/lib/cli-usage-parser.js +92 -0
package/src/dashboard/lib/config-parser.js +109 -0
package/src/dashboard/lib/connect-recommender.js +131 -0
package/src/dashboard/lib/correlations-parser.js +231 -0
package/src/dashboard/lib/daily-note-resolver.js +211 -0
package/src/dashboard/lib/date-utils.js +35 -0
package/src/dashboard/lib/distribution-parser.js +78 -0
package/src/dashboard/lib/dossier-parser.js +64 -0
package/src/dashboard/lib/drift-history.js +83 -0
package/src/dashboard/lib/drift-score.js +119 -0
package/src/dashboard/lib/engine-health.js +170 -0
package/src/dashboard/lib/engine-writer.js +1685 -0
package/src/dashboard/lib/execution-plan.js +125 -0
package/src/dashboard/lib/experiments-parser.js +429 -0
package/src/dashboard/lib/feed-parser.js +294 -0
package/src/dashboard/lib/forked-future.js +60 -0
package/src/dashboard/lib/goal-forecast.js +304 -0
package/src/dashboard/lib/goals-parser.js +67 -0
package/src/dashboard/lib/health-protocols-parser.js +133 -0
package/src/dashboard/lib/hook-activity.js +48 -0
package/src/dashboard/lib/hook-indexer.js +169 -0
package/src/dashboard/lib/hourly-activity-parser.js +143 -0
package/src/dashboard/lib/identity-parser.js +85 -0
package/src/dashboard/lib/ingestion.js +418 -0
package/src/dashboard/lib/library-indexer-v2.js +212 -0
package/src/dashboard/lib/library-indexer.js +105 -0
package/src/dashboard/lib/log-activation.sh +61 -0
package/src/dashboard/lib/memory-curator.js +97 -0
package/src/dashboard/lib/memory-gardener.js +177 -0
package/src/dashboard/lib/memory-gepa.js +102 -0
package/src/dashboard/lib/memory-index.js +470 -0
package/src/dashboard/lib/memory-rerank.js +72 -0
package/src/dashboard/lib/memory-text.js +136 -0
package/src/dashboard/lib/metrics-log-parser.js +76 -0
package/src/dashboard/lib/moves-usage-parser.js +184 -0
package/src/dashboard/lib/onboarding-forge.js +70 -0
package/src/dashboard/lib/override-outcome-parser.js +68 -0
package/src/dashboard/lib/override-summary.js +73 -0
package/src/dashboard/lib/paths.js +192 -0
package/src/dashboard/lib/pattern-manifest-loader.js +29 -0
package/src/dashboard/lib/phantom-strategy.js +129 -0
package/src/dashboard/lib/project-scanner.js +121 -0
package/src/dashboard/lib/promise-wall.js +88 -0
package/src/dashboard/lib/record-score.js +173 -0
package/src/dashboard/lib/redaction.js +140 -0
package/src/dashboard/lib/refusal-parser.js +44 -0
package/src/dashboard/lib/regenerate-manifest.js +206 -0
package/src/dashboard/lib/rewind-snapshots.js +689 -0
package/src/dashboard/lib/roast-wall-parser.js +200 -0
package/src/dashboard/lib/run-registry.js +226 -0
package/src/dashboard/lib/safe-write.js +63 -0
package/src/dashboard/lib/session-log-parser.js +145 -0
package/src/dashboard/lib/session-time-parser.js +158 -0
package/src/dashboard/lib/skill-index.js +171 -0
package/src/dashboard/lib/skill-indexer.js +118 -0
package/src/dashboard/lib/skill-recommender.js +689 -0
package/src/dashboard/lib/strategy-parser.js +245 -0
package/src/dashboard/lib/strategy-protocol-parser.js +135 -0
package/src/dashboard/lib/streak-parser.js +95 -0
package/src/dashboard/lib/suggested-now.js +254 -0
package/src/dashboard/lib/tool-awareness.js +125 -0
package/src/dashboard/lib/transcript-parser.js +331 -0
package/src/dashboard/lib/vault-graph-parser.js +205 -0
package/src/dashboard/lib/view-generator.js +163 -0
package/src/dashboard/lib/voice-dna-parser.js +57 -0
package/src/dashboard/lib/walkthrough-script.js +140 -0
package/src/dashboard/lib/workflow-graph-parser.js +170 -0
package/src/dashboard/lib/workflow-library-parser.js +146 -0
package/src/dashboard/server.js +2024 -0
package/src/dashboard/shortcut.js +0 -0
package/src/dashboard/static/setup-poc.html +306 -0
package/src/dashboard/static/walkthrough-poc.html +580 -0
package/src/dashboard/styles.css +1201 -0
package/src/dashboard/templates/index.html +278 -0
package/src/dashboard/ui/dist/assets/hanken-grotesk-latin-ext-wght-normal-Dg-wlmqe.woff2 +0 -0
package/src/dashboard/ui/dist/assets/hanken-grotesk-latin-wght-normal-CaVRRdDk.woff2 +0 -0
package/src/dashboard/ui/dist/assets/hanken-grotesk-vietnamese-wght-normal-CHiFlh_0.woff2 +0 -0
package/src/dashboard/ui/dist/assets/hero.png +0 -0
package/src/dashboard/ui/dist/assets/index-598CSGOZ.js +157 -0
package/src/dashboard/ui/dist/assets/index-BP--M69H.css +1 -0
package/src/dashboard/ui/dist/assets/index-CidzmwSW.js +34 -0
package/src/dashboard/ui/dist/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2 +0 -0
package/src/dashboard/ui/dist/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2 +0 -0
package/src/dashboard/ui/dist/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2 +0 -0
package/src/dashboard/ui/dist/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2 +0 -0
package/src/dashboard/ui/dist/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2 +0 -0
package/src/dashboard/ui/dist/assets/mover-system.css +62 -0
package/src/dashboard/ui/dist/assets/xterm-CqkleIqs.js +1 -0
package/src/dashboard/ui/dist/icon.svg +4 -0
package/src/dashboard/ui/dist/index.html +18 -0
package/src/dashboard/ui/dist/manifest.webmanifest +1 -0
package/src/dashboard/ui/dist/registerSW.js +1 -0
package/src/dashboard/ui/dist/sw.js +1 -0
package/src/dashboard/ui/dist/workbox-39fa566e.js +1 -0

package/src/dashboard/static/walkthrough-poc.html ADDED Viewed

@@ -0,0 +1,580 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Mover OS · Walkthrough</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Archivo:wght@400;500;600&family=Newsreader:opsz,wght@6..72,400;6..72,500&display=swap" rel="stylesheet">
+<!-- Shared Mover OS tokens — canonical values live in styles/v6/v3.css.
+     The /assets/ path is served from ui/dist/assets/ by server.js. -->
+<link rel="stylesheet" href="/assets/mover-system.css">
+<style>
+  * { box-sizing: border-box; }
+  body { margin: 0; background: var(--m-bg); color: var(--m-ink);
+    font: 15px/1.6 var(--m-sans); -webkit-font-smoothing: antialiased; }
+  /* Warm wash identical to setup-poc.html — same atmosphere, different page. */
+  body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
+    background: radial-gradient(70% 50% at 82% 0%, var(--m-gold-glow), transparent 60%);
+    opacity: 0.5; }
+  .wrap { max-width: 680px; margin: 0 auto; padding: 32px 22px 116px; }
+  /* Header: brand left, status right (mirrors setup-poc.html exactly). */
+  header { display: flex; align-items: center; justify-content: space-between;
+    padding: 4px 0 22px; border-bottom: 1px solid var(--m-line); margin-bottom: 26px; }
+  .brand { font-family: var(--m-serif); font-size: 23px; color: var(--m-ink); }
+  .brand small { font-family: var(--m-sans); color: var(--m-ink-3); font-size: 12px;
+    margin-left: 11px; letter-spacing: .04em; }
+  .status { display: flex; align-items: center; gap: 8px; color: var(--m-ink-2);
+    font-size: 12px; font-variant-numeric: tabular-nums; }
+  .dot { width: 8px; height: 8px; border-radius: 50%; background: #4a4742; }
+  .dot.live { background: var(--m-good); box-shadow: 0 0 8px rgba(169,191,130,0.55); }
+  /* Progress bar — the walkthrough's key UI addition over setup: the user sees
+     how far through the 8 steps they are. Thin, gold, no percentage text. */
+  .progress-rail { height: 2px; background: var(--m-line); border-radius: 2px;
+    margin-bottom: 26px; overflow: hidden; }
+  .progress-fill { height: 100%; background: linear-gradient(90deg, var(--m-gold), var(--m-gold-2));
+    border-radius: 2px; width: 0%; transition: width .4s var(--m-ease); }
+  /* Step card: slightly wider left accent instead of border-color change — it
+     differentiates from the setup Q card while using the same base .card class. */
+  .card { background: var(--m-card); border: 1px solid var(--m-line); border-radius: 16px;
+    padding: 18px 20px; margin: 14px 0;
+    box-shadow: 0 1px 0 rgba(255,240,214,0.05) inset, 0 30px 60px -34px rgba(0,0,0,0.9);
+    animation: rise .24s var(--m-ease); }
+  .card.step { border-left: 3px solid var(--m-gold-line); }
+  .card.step.active { border-left-color: var(--m-gold); }
+  .card.step.done { border-left-color: var(--m-good); opacity: .7; }
+  /* Step anatomy: badge + title + body + doThis strip. */
+  .step-badge { font-size: 11px; letter-spacing: .1em; text-transform: uppercase;
+    color: var(--m-ink-3); margin-bottom: 6px; }
+  .step-badge span { color: var(--m-gold-2); font-weight: 600; }
+  .step-title { font-family: var(--m-serif); font-size: 20px; line-height: 1.3;
+    color: var(--m-ink); margin-bottom: 8px; }
+  .step-body { color: var(--m-ink-2); font-size: 14px; line-height: 1.6; }
+  .step-do { margin-top: 14px; padding: 12px 14px; border-radius: 10px;
+    background: var(--m-gold-soft); border: 1px solid var(--m-gold-line);
+    font-size: 13px; color: var(--m-gold-2); }
+  .step-do::before { content: "Do this  ·  "; font-weight: 600;
+    letter-spacing: .04em; color: var(--m-gold); }
+  .check-icon { float: right; color: var(--m-good); font-size: 16px; line-height: 1; margin-left: 8px; }
+  /* Agent response bubble — same .q style as setup-poc.html. */
+  .q { font-family: var(--m-serif); font-size: 19px; line-height: 1.45; color: var(--m-ink); }
+  .a { color: var(--m-ink-2); font-size: 14px; margin-top: 6px; }
+  /* Permission card (defensive — walkthrough is tool-free but we mirror setup). */
+  .perm { border-color: var(--m-gold-line); }
+  .perm .lbl { color: var(--m-gold-2); font-size: 10px; text-transform: uppercase;
+    letter-spacing: .14em; margin-bottom: 8px; }
+  .row { display: flex; gap: 10px; margin-top: 16px; }
+  /* Composer — fixed bottom, exact clone of setup-poc.html. */
+  button { font: inherit; border: 1px solid var(--m-line-2); background: rgba(255,240,214,0.03);
+    color: var(--m-ink); padding: 10px 17px; border-radius: 11px; cursor: pointer;
+    transition: border-color .15s, background .15s; }
+  button:hover:not(:disabled) { border-color: var(--m-gold-line); }
+  button.primary { background: linear-gradient(180deg, var(--m-gold-2), var(--m-gold));
+    color: var(--m-on-gold); border-color: transparent; font-weight: 600;
+    box-shadow: 0 0 24px -8px var(--m-gold-glow); }
+  button:disabled { opacity: .4; cursor: default; box-shadow: none; }
+  .composer { position: fixed; left: 0; right: 0; bottom: 0;
+    background: linear-gradient(transparent, var(--m-bg) 34%); padding: 18px 22px; }
+  .composer .inner { max-width: 680px; margin: 0 auto; display: flex; gap: 10px; }
+  textarea { flex: 1; background: var(--m-bg-2); border: 1px solid var(--m-line-2);
+    border-radius: 12px; color: var(--m-ink); padding: 13px; font: inherit; resize: none; height: 50px; }
+  textarea:focus { outline: none; border-color: var(--m-gold-line); }
+  /* Done state — shown when the last step is confirmed. */
+  .done-banner { text-align: center; padding: 48px 0 24px; }
+  .done-banner .headline { font-family: var(--m-serif); font-size: 28px; color: var(--m-ink);
+    margin-bottom: 10px; }
+  .done-banner .sub { color: var(--m-ink-2); font-size: 15px; max-width: 440px;
+    margin: 0 auto 28px; line-height: 1.6; }
+  .done-banner .cta { display: inline-flex; align-items: center; gap: 8px;
+    background: linear-gradient(180deg, var(--m-gold-2), var(--m-gold));
+    color: var(--m-on-gold); border: none; padding: 14px 28px; border-radius: 13px;
+    font-size: 15px; font-weight: 600; cursor: pointer;
+    box-shadow: 0 0 32px -8px var(--m-gold-glow); }
+  /* Thinking indicator — identical to setup-poc.html: gold orb + rotating verbs. */
+  .thinking { display: flex; align-items: center; gap: 14px; }
+  .thinking .orb { position: relative; width: 22px; height: 22px; flex: none; }
+  .thinking .orb span { position: absolute; inset: 0; border-radius: 50%;
+    border: 1.5px solid var(--m-gold-line); animation: ripple 1.9s var(--m-ease) infinite; }
+  .thinking .orb span:nth-child(2) { animation-delay: .63s; }
+  .thinking .orb span:nth-child(3) { animation-delay: 1.26s; }
+  .thinking .orb::after { content: ""; position: absolute; inset: 7px; border-radius: 50%;
+    background: var(--m-gold); box-shadow: 0 0 12px -1px var(--m-gold-glow);
+    animation: breathe 1.9s var(--m-ease) infinite; }
+  .thinking .verb { font-family: var(--m-serif); font-size: 18px; color: var(--m-gold-2); }
+  .thinking .verb em { font-style: normal; opacity: .55; animation: dots 1.4s ease-in-out infinite; }
+  .thinking .verb.swap { animation: fade .7s var(--m-ease); }
+  @keyframes rise { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } }
+  @keyframes ripple { from { transform: scale(.5); opacity: .85; } to { transform: scale(1.4); opacity: 0; } }
+  @keyframes breathe { 0%,100% { opacity: .5; transform: scale(.82); } 50% { opacity: 1; transform: scale(1.1); } }
+  @keyframes dots { 0%,100% { opacity: .25; } 50% { opacity: .7; } }
+  @keyframes fade { from { opacity: 0; transform: translateY(2px); } to { opacity: 1; transform: none; } }
+  @media (prefers-reduced-motion: reduce) {
+    .thinking .orb span, .thinking .orb::after, .thinking .verb em, .thinking .verb.swap,
+    .progress-fill { animation: none; transition: none; }
+    .thinking .orb::after { opacity: .85; }
+  }
+</style>
+</head>
+<body>
+<div class="wrap">
+  <header>
+    <div class="brand">Mover OS<small>Walkthrough · local</small></div>
+    <div class="status"><span class="dot" id="dot"></span><span id="st">connecting…</span></div>
+  </header>
+  <!-- Progress rail: thin gold fill advances with each step completion. -->
+  <div class="progress-rail"><div class="progress-fill" id="prog"></div></div>
+  <!-- Feed: step cards + agent response cards append here in order. -->
+  <div id="feed"></div>
+</div>
+<div class="composer"><div class="inner">
+  <textarea id="inp" placeholder="Your response…" disabled></textarea>
+  <button class="primary" id="send" disabled>Send</button>
+  <button id="endBtn" disabled>End</button>
+</div></div>
+<script>
+// ── Walkthrough step data — kept inline so this page is a standalone file
+//    with no build step. Server-side authoritative copy: lib/walkthrough-script.js.
+//    SYNC RULE: when walkthrough-script.js STEPS changes, mirror it here.
+const STEPS = [
+  {
+    id: "welcome", step: 1,
+    title: "You're set up. Now let's operate.",
+    body: "Setup extracted who you are and built your Engine. This walkthrough teaches you how to RUN it. Eight steps, eight minutes. No reading — only doing.",
+    doThis: "Type \"ready\" to begin.",
+    checkpoint: "User says they are ready or asks a question. Either counts — they are engaged.",
+  },
+  {
+    id: "first-workflow", step: 2,
+    title: "Drive the system with workflows.",
+    body: "This is not a chatbot. You run commands. The core command is /morning — it loads your Engine files, checks your energy, and sets your Single Test for the session. Without /morning, you are flying blind.",
+    doThis: "Open a Claude Code session (a terminal, type `claude`). Run: /morning",
+    checkpoint: "User confirms they ran /morning, or asks where Claude Code is.",
+  },
+  {
+    id: "one-chat", step: 3,
+    title: "One session. Not ten tabs.",
+    body: "Every new Claude Code window starts from zero — no memory of the last one. Your Engine files ARE the persistent memory. Opening a new window mid-task means re-loading all that context, which costs tokens and minutes.",
+    doThis: "For today: stay in the Claude Code session where you ran /morning. Do not open a new window unless you run /morning first.",
+    checkpoint: "User acknowledges the habit. No file action needed.",
+  },
+  {
+    id: "compact", step: 4,
+    title: "Compact before context breaks down.",
+    body: "After a long session, responses get shallower — the model is losing the thread. /compact compresses the conversation while re-loading your Engine context. Not 'start over' — 'keep going with a clear head'. Use it when responses feel off.",
+    doThis: "In your Claude Code session: type /compact. If the session is short, run it anyway so you know what it does.",
+    checkpoint: "User ran /compact, or confirms they understand when to use it.",
+  },
+  {
+    id: "verify-files", step: 5,
+    title: "The files are the truth. Not the chat.",
+    body: "The chat transcript is temporary. Every workflow writes its output to a file — Daily Note, Active_Context.md, plan.md. If it's only in the chat, it's gone when you close the session. Always verify: did that land in a file?",
+    doThis: "Open Obsidian. Navigate to 02_Areas/Engine/. Confirm Active_Context.md exists and has content from setup.",
+    checkpoint: "User confirms they saw Active_Context.md with content. That is proof the system is working.",
+  },
+  {
+    id: "discover", step: 6,
+    title: "Every workflow tells you what comes next.",
+    body: "You do not need to memorize 25 commands. Every workflow ends with a handoff — a specific suggestion for what to run next. Today that chain is: /morning → work → /log → /analyse-day → /plan-tomorrow. You ran /morning. /log is next.",
+    doThis: "In your Claude Code session: type /log — the end-of-session capture. Read its output and note what it suggests you run after.",
+    checkpoint: "User ran /log and reports what it suggested. Any answer is correct — they have seen the handoff pattern live.",
+  },
+  {
+    id: "daily-loop", step: 7,
+    title: "The loop that keeps the system alive.",
+    body: "Run this every day and the system compounds. Skip it and it decays. The loop: /morning to start → work → /log to capture → /analyse-day to audit → /plan-tomorrow to set tomorrow. This is not optional ceremony. This is the product.",
+    doThis: "Say the loop back from memory — just the five steps.",
+    checkpoint: "User gives some version of: morning, work, log, analyse-day, plan-tomorrow.",
+  },
+  {
+    id: "first-plan", step: 8,
+    title: "Close the loop before you leave.",
+    body: "Do not walk away without a plan for tomorrow. /plan-tomorrow pulls from your strategy, backlogs, and today's work. It gives you a clear first task for tomorrow morning. This is the bridge from 'I installed this' to 'I am actually using this'.",
+    doThis: "In your Claude Code session: type /plan-tomorrow. Confirm you have a plan for tomorrow when it finishes.",
+    checkpoint: "User confirms they ran /plan-tomorrow and have a plan for tomorrow. Done-gate.",
+  },
+];
+const STEP_COUNT = STEPS.length;
+// ── DOM refs ──────────────────────────────────────────────────────────────────
+const feed = document.getElementById('feed');
+const inp  = document.getElementById('inp');
+const sendBtn = document.getElementById('send');
+const endBtn  = document.getElementById('endBtn');
+const dot  = document.getElementById('dot');
+const st   = document.getElementById('st');
+const prog = document.getElementById('prog');
+// ── State ─────────────────────────────────────────────────────────────────────
+let token = null, sessionId = null, es = null, busy = false;
+let currentStepIndex = 0;    // 0-based index into STEPS
+let completedSteps = new Set();
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function card(cls) {
+  const d = document.createElement('div');
+  d.className = 'card ' + (cls || '');
+  feed.appendChild(d);
+  window.scrollTo(0, document.body.scrollHeight);
+  return d;
+}
+function setBusy(b) {
+  busy = b;
+  sendBtn.disabled = b || !sessionId;
+  inp.disabled = b || !sessionId;
+}
+function setStatus(text, live) {
+  st.textContent = text;
+  dot.className = 'dot' + (live ? ' live' : '');
+}
+function setProgress(stepsDone) {
+  prog.style.width = Math.round((stepsDone / STEP_COUNT) * 100) + '%';
+}
+async function post(path, body) {
+  const r = await fetch(path, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'X-Mover-Token': token },
+    body: JSON.stringify(body),
+  });
+  return r.json();
+}
+// ── Thinking indicator — identical to setup-poc.html ─────────────────────────
+const THINK_VERBS = [
+  "Following your lead", "Checking that off", "Noting it down",
+  "Moving you forward", "Reading your progress", "Advancing the step",
+  "Tracking that", "Lining up the next one", "Good — processing",
+  "Marking it done", "Pulling up the next step", "Almost there",
+];
+let thinkingEl = null, thinkTimer = null, lastVerb = -1;
+function nextVerb() {
+  let i;
+  do { i = Math.floor(Math.random() * THINK_VERBS.length); }
+  while (i === lastVerb && THINK_VERBS.length > 1);
+  lastVerb = i;
+  return THINK_VERBS[i];
+}
+function paintVerb() {
+  if (!thinkingEl) return;
+  const v = thinkingEl.querySelector('.verb');
+  v.innerHTML = nextVerb() + '<em>…</em>';
+  v.classList.remove('swap'); void v.offsetWidth; v.classList.add('swap');
+}
+function showThinking() {
+  if (thinkingEl) return;
+  thinkingEl = card('thinking');
+  thinkingEl.innerHTML = '<div class="orb"><span></span><span></span><span></span></div><div class="verb"></div>';
+  paintVerb();
+  thinkTimer = setInterval(paintVerb, 2300);
+  window.scrollTo(0, document.body.scrollHeight);
+}
+function hideThinking() {
+  if (thinkTimer) { clearInterval(thinkTimer); thinkTimer = null; }
+  if (thinkingEl) { thinkingEl.remove(); thinkingEl = null; }
+}
+// ── Step cards ────────────────────────────────────────────────────────────────
+// Each step is rendered as a card BEFORE the agent turn so the user can read
+// the instruction while the agent is composing. The card state updates as steps
+// are confirmed: pending → active → done.
+const stepCardEls = {};  // id → card DOM element
+function renderStepCard(step, state) {
+  // state: 'pending' | 'active' | 'done'
+  const existing = stepCardEls[step.id];
+  if (existing) {
+    // Update class on the existing card.
+    existing.className = 'card step ' + state;
+    if (state === 'done') {
+      const chk = existing.querySelector('.check-icon');
+      if (chk) chk.style.display = 'inline';
+    }
+    return existing;
+  }
+  const c = card('step ' + state);
+  c.innerHTML = `
+    <div class="step-badge">Step <span>${step.step}</span> of ${STEP_COUNT}</div>
+    <div class="step-title">${escHtml(step.title)}</div>
+    <div class="step-body">${escHtml(step.body)}</div>
+    <div class="step-do">${escHtml(step.doThis)}<span class="check-icon" style="display:none">&#10003;</span></div>
+  `;
+  stepCardEls[step.id] = c;
+  return c;
+}
+function escHtml(str) {
+  return String(str)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+// ── Session boot ──────────────────────────────────────────────────────────────
+async function start() {
+  const h = await (await fetch('/api/health')).json();
+  token = h.token;
+  // Boot the session with the walkthrough-specific system prompt.
+  // Mirrors walkthrough-script.js WALKTHROUGH_SYSTEM — keep in sync.
+  // agent-session.js start() already accepts opts.systemPrompt (line 176).
+  const WALKTHROUGH_SYSTEM = [
+    "You are the Mover OS walkthrough guide.",
+    "Your ONLY job: teach the user to operate the system in 8 steps, taking no more than 8 minutes total.",
+    "Do NOT re-explain what Mover OS is, what Engine files are, or what setup covered.",
+    "Each turn: acknowledge the user's last action in ONE sentence, then give the next step's instruction clearly.",
+    "Keep every response under 4 sentences. No exceptions.",
+    "Do NOT use numbered lists, bullet points, or headings in your responses. Prose only.",
+    "Do NOT run any tools and do NOT read files — you have no tools in this session.",
+    "You may reference file names (like Active_Context.md or plan.md) but never their contents.",
+    "Tone: warm but fast. A co-founder showing someone the system in a short video call, not a teacher at a whiteboard.",
+    "When the user confirms they completed step 8 (running /plan-tomorrow and having a plan for tomorrow), emit the exact token [[WALKTHROUGH_COMPLETE]] on its own line, then write one sentence that says they are ready to operate the system.",
+    "CRITICAL: Only emit [[WALKTHROUGH_COMPLETE]] after the user has confirmed step 8. Not before.",
+  ].join(" ");
+  const r = await post('/api/session/start', {
+    agent: 'claude-code',
+    systemPrompt: WALKTHROUGH_SYSTEM,
+  });
+  if (!r.ok) { setStatus('start failed: ' + r.error, false); return; }
+  sessionId = r.sessionId;
+  setStatus('session live', true);
+  endBtn.disabled = false;
+  // Subscribe to SSE stream from the agent.
+  es = new EventSource('/api/session/events?id=' + encodeURIComponent(sessionId));
+  es.onmessage = (m) => { let ev; try { ev = JSON.parse(m.data); } catch (_) { return; } handle(ev); };
+  es.onerror = () => setStatus('stream dropped', false);
+  // Render first step card and send the opening prompt to the agent.
+  const firstStep = STEPS[0];
+  renderStepCard(firstStep, 'active');
+  setBusy(true);
+  showThinking();
+  // The opening agent turn provides the guide persona framing + step 1 instruction.
+  // We pass the full step as context so the agent can give a tight, grounded response.
+  const openingPrompt = buildStepPrompt(firstStep, true);
+  await post('/api/session/send', { sessionId, text: openingPrompt });
+}
+// Build the internal prompt the dashboard sends to the agent for each step.
+// The user never sees this — they see the agent's natural-language response.
+function buildStepPrompt(step, isFirst) {
+  const prefix = isFirst
+    ? 'Begin the walkthrough. The user just completed setup.'
+    : 'The user completed the previous step.';
+  return [
+    prefix,
+    `Current step: ${step.step}/${STEP_COUNT} — "${step.title}".`,
+    `What to teach: ${step.body}`,
+    `The action for the user: ${step.doThis}`,
+    `How to verify: ${step.checkpoint}`,
+    'Give your response now. Max 4 sentences.',
+  ].join(' ');
+}
+// Build the "advance to next step" prompt sent when a step is confirmed done.
+function buildAdvancePrompt(nextStep) {
+  return [
+    `The user confirmed step ${nextStep.step - 1} is done.`,
+    `Next step: ${nextStep.step}/${STEP_COUNT} — "${nextStep.title}".`,
+    `What to teach: ${nextStep.body}`,
+    `The action for the user: ${nextStep.doThis}`,
+    `How to verify: ${nextStep.checkpoint}`,
+    'Give your response now. Max 4 sentences.',
+  ].join(' ');
+}
+// ── Sentinel detection ────────────────────────────────────────────────────────
+// When the agent confirms step 8, it emits [[WALKTHROUGH_COMPLETE]] exactly
+// as setup-poc.html emits [[SETUP_COMPLETE]]. We split the text, render the
+// pre-sentinel portion, and fire the done banner — so the banner is driven by
+// the agent's confirmation, not solely by client-side step counting.
+const DONE_SENTINEL = '[[WALKTHROUGH_COMPLETE]]';
+let walkthroughDone = false;
+// ── Event handler ─────────────────────────────────────────────────────────────
+function handle(ev) {
+  if (ev.kind === 'assistant') {
+    hideThinking();
+    // Check for the completion sentinel (may arrive with surrounding text).
+    if (!walkthroughDone && ev.text.indexOf(DONE_SENTINEL) >= 0) {
+      walkthroughDone = true;
+      const parts = ev.text.split(DONE_SENTINEL);
+      const pre = (parts[0] || '').trim();
+      const closing = parts.slice(1).join(' ').trim();
+      // Render whatever the agent said before the sentinel.
+      if (pre) {
+        const c = card(); const q = document.createElement('div'); q.className = 'q';
+        q.textContent = pre; c.appendChild(q);
+      }
+      // Show the done banner — closing line becomes the sub-text if present.
+      showDone(closing);
+      setBusy(true);
+      if (es) es.close();
+      return;
+    }
+    const c = card();
+    const q = document.createElement('div');
+    q.className = 'q';
+    q.textContent = ev.text;
+    c.appendChild(q);
+  }
+  else if (ev.kind === 'result') {
+    hideThinking();
+    if (!walkthroughDone) { setBusy(false); inp.focus(); }
+  }
+  else if (ev.kind === 'permission') {
+    // Defensive: walkthrough is tool-free so this should not fire.
+    // Forward to GUI as a plain-English choice (mirrors setup-poc.html).
+    hideThinking();
+    const id = ev.requestId;
+    const c = card('perm');
+    c.innerHTML = '<div class="lbl">Permission requested</div>';
+    const q = document.createElement('div'); q.className = 'q';
+    q.textContent = (JSON.stringify(ev.request) || '').slice(0, 240);
+    c.appendChild(q);
+    const row = document.createElement('div'); row.className = 'row';
+    const allow = document.createElement('button'); allow.className = 'primary'; allow.textContent = 'Allow';
+    const deny  = document.createElement('button'); deny.textContent = 'Deny';
+    const decide = (d) => {
+      allow.disabled = true; deny.disabled = true;
+      const note = document.createElement('span');
+      note.className = 'a'; note.style.marginLeft = '8px'; note.textContent = d + ' sent…';
+      row.appendChild(note);
+      post('/api/session/approve', { sessionId, requestId: id, decision: d });
+    };
+    allow.onclick = () => decide('allow');
+    deny.onclick  = () => decide('deny');
+    row.appendChild(allow); row.appendChild(deny); c.appendChild(row);
+  }
+  else if (ev.kind === 'closed' || ev.kind === 'error') {
+    hideThinking();
+    setStatus('session ended', false);
+    setBusy(true);
+    endBtn.disabled = true;
+    if (es) es.close();
+  }
+}
+// ── User sends a response ─────────────────────────────────────────────────────
+// The walkthrough is conversational: the user types their response, the agent
+// interprets whether the step checkpoint is met, and we advance the step card.
+// Client advances the step card OPTIMISTICALLY on send (snappy UI). The agent's
+// response provides the natural-language bridge. On step 8, the agent emits
+// [[WALKTHROUGH_COMPLETE]] which triggers showDone() via handle(). As a safety
+// net, if the sentinel never arrives (e.g. agent session fault after all steps
+// are client-confirmed), showDone() fires after a 12s grace window.
+sendBtn.onclick = async () => {
+  const t = inp.value.trim();
+  if (!t || busy) return;
+  // Show user's response in the feed.
+  const uc = card();
+  const ua = document.createElement('div'); ua.className = 'a';
+  ua.textContent = 'You: ' + t;
+  uc.appendChild(ua);
+  inp.value = '';
+  // Mark current step done.
+  const currentStep = STEPS[currentStepIndex];
+  if (currentStep) {
+    completedSteps.add(currentStep.id);
+    renderStepCard(currentStep, 'done');
+    setProgress(completedSteps.size);
+  }
+  // Advance to next step.
+  currentStepIndex++;
+  const nextStep = STEPS[currentStepIndex];
+  if (!nextStep) {
+    // All client-side steps confirmed. Send final turn to agent so it can
+    // emit [[WALKTHROUGH_COMPLETE]]. Safety net: if sentinel never arrives,
+    // show done banner after 12s (covers agent latency on slow connections).
+    setBusy(true);
+    showThinking();
+    const finalTurn = t + '\n\n[SYSTEM: The user confirmed step 8 is complete. Emit [[WALKTHROUGH_COMPLETE]] on its own line, then write one closing sentence that says they are ready to operate the system.]';
+    await post('/api/session/send', { sessionId, text: finalTurn });
+    // Safety net — fire if sentinel never lands.
+    setTimeout(() => {
+      if (!walkthroughDone) { showDone(); if (es) es.close(); }
+    }, 12000);
+    return;
+  }
+  // Render the next step card immediately (user sees where they're going).
+  renderStepCard(nextStep, 'active');
+  // Send the user's message + advance prompt to the agent in one turn.
+  // The agent sees the user's actual words AND the step context.
+  const agentTurn = t + '\n\n[SYSTEM: ' + buildAdvancePrompt(nextStep) + ']';
+  setBusy(true);
+  showThinking();
+  await post('/api/session/send', { sessionId, text: agentTurn });
+};
+inp.addEventListener('keydown', (e) => {
+  if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); sendBtn.click(); }
+});
+endBtn.onclick = async () => {
+  if (es) es.close();
+  await post('/api/session/end', { sessionId });
+  setStatus('ended', false);
+  setBusy(true);
+  endBtn.disabled = true;
+};
+// ── Done state ────────────────────────────────────────────────────────────────
+// closingLine: optional string from the agent post-sentinel (one "you're ready" sentence).
+// rendered: internal guard so the banner renders exactly once.
+let _doneRendered = false;
+function showDone(closingLine) {
+  if (_doneRendered) return; // already shown — safety net or double-call guard
+  _doneRendered = true;
+  walkthroughDone = true;
+  setStatus('walkthrough complete', true);
+  const DEFAULT_SUB = 'You know how to drive it. Run <strong>/morning</strong> every session, follow the handoffs, and the system compounds every day.';
+  const banner = document.createElement('div');
+  banner.className = 'done-banner';
+  banner.innerHTML = `
+    <div class="headline">Engine is live.</div>
+    <div class="sub">${closingLine ? escHtml(closingLine) : DEFAULT_SUB}</div>
+    <button class="cta" onclick="window.location.href='/'">
+      Open Mover Studio
+    </button>
+  `;
+  feed.appendChild(banner);
+  window.scrollTo(0, document.body.scrollHeight);
+  // Hide the composer — walkthrough is complete.
+  document.querySelector('.composer').style.display = 'none';
+  // End the session gracefully (fire-and-forget — no await needed here).
+  post('/api/session/end', { sessionId }).catch(() => {});
+}
+// ── Boot ──────────────────────────────────────────────────────────────────────
+start();
+</script>
+</body>
+</html>