mover-os 4.4.2 → 4.4.3

package/install.js

@@ -182,7 +182,17 @@ async function printHeader(animate = IS_TTY) {
     }
   } catch {}
 
-  ln(`  ${dim(`v${VERSION}`)}  ${gray("the agentic operating system for obsidian")}${infoRight ? `  ${infoRight}` : ""}`);
+  const pkgVer = require("./package.json").version;
+  ln(`  ${dim(`v${pkgVer}`)}  ${gray("the agentic operating system for obsidian")}${infoRight ? `  ${infoRight}` : ""}`);
+
+  // Non-blocking update check
+  try {
+    const latest = execSync("npm view mover-os version", { encoding: "utf8", timeout: 5000 }).trim();
+    if (latest && latest !== pkgVer && compareVersions(latest, pkgVer) > 0) {
+      ln(`  ${yellow(`Update available: v${pkgVer} → v${latest}`)}  ${dim(`run ${bold("moveros update")}`)}`);
+    }
+  } catch {}
+
   ln();
   ln(gray("  ─────────────────────────────────────────────"));
   ln();
@@ -3847,230 +3857,270 @@ async function cmdRestore(opts) {
 
 // ─── moveros help ──────────────────────────────────────────────────────────
 async function cmdHelp(opts) {
-  // Interactive animated guide — paginated walkthrough of Mover OS
+  // Animated typing helper
+  const typeOut = async (text, speed = 12) => {
+    if (!IS_TTY) { ln(text); return; }
+    const raw = strip(text);
+    let rawIdx = 0, ansiIdx = 0;
+    // Build mapping of raw char positions to the styled string slices
+    while (rawIdx < raw.length) {
+      w(text[ansiIdx] || "");
+      if (text[ansiIdx] && text[ansiIdx] !== "\x1b" && !text.slice(Math.max(0, ansiIdx - 10), ansiIdx).match(/\x1b\[[^m]*$/)) {
+        rawIdx++;
+      }
+      ansiIdx++;
+      if (rawIdx % 2 === 0) await sleep(speed);
+    }
+    // flush remaining ANSI codes
+    while (ansiIdx < text.length) { w(text[ansiIdx]); ansiIdx++; }
+    w("\n");
+  };
+
+  const typeLine = async (text, speed = 8) => {
+    if (!IS_TTY) { ln(`  ${text}`); return; }
+    w("  ");
+    for (let i = 0; i < text.length; i++) {
+      w(text[i]);
+      if (text[i] !== "\x1b" && i % 3 === 0) await sleep(speed);
+    }
+    w("\n");
+  };
+
   const pages = [
     {
-      title: "Welcome to Mover OS",
+      title: "What is Mover OS?",
       body: [
-        `${bold("The agentic operating system for Obsidian.")}`,
+        `${bold("Your second brain, but it actually works.")}`,
         "",
-        "Mover OS turns your Obsidian vault into an AI-powered execution engine.",
-        "It works across 16 AI coding agents — Claude Code, Cursor, Gemini,",
-        "Copilot, Codex, and more. Same brain, every editor.",
+        "Most productivity systems fail because you have to maintain them.",
+        "Mover OS is different — your AI agents maintain it for you.",
         "",
-        `${dim("How it works:")}`,
-        `  ${cyan("1.")} Your ${bold("Engine")} stores who you are — identity, strategy, goals`,
-        `  ${cyan("2.")} ${bold("Workflows")} run your day — plan, execute, log, analyse, repeat`,
-        `  ${cyan("3.")} ${bold("Skills")} give your AI agents deep domain knowledge`,
-        `  ${cyan("4.")} The system ${bold("learns")} from your behavior and adapts`,
+        "You tell your AI who you are, what you're building, and where",
+        "you're going. It remembers across every session, every editor.",
         "",
-        `${dim("This guide walks through everything. Use ← → to navigate.")}`,
+        `${dim("Three things make it work:")}`,
+        `  ${cyan("1.")} The ${bold("Engine")} — files that store your identity, strategy, goals`,
+        `  ${cyan("2.")} ${bold("Workflows")} — 23 commands that run your day (plan, build, log, repeat)`,
+        `  ${cyan("3.")} ${bold("Skills")} — 61 packs that make your AI genuinely useful`,
+        "",
+        `Works across 16 agents. Claude Code, Cursor, Gemini, all of them.`,
+        `Same context, every editor. ${dim("Press → to continue.")}`,
       ],
     },
     {
-      title: "The Engine — Your Brain",
+      title: "The Engine",
       body: [
-        `${dim("Location:")} 02_Areas/Engine/`,
+        `${dim("Your identity, stored as markdown. Read by every AI session.")}`,
         "",
-        `${bold("Core files that define you:")}`,
+        `  ${cyan("Identity_Prime.md")}   Who you are — values, strengths, anti-patterns`,
+        `  ${cyan("Strategy.md")}         What you're betting on right now`,
+        `  ${cyan("Active_Context.md")}   What's happening today — focus, blockers, energy`,
+        `  ${cyan("Goals.md")}            Where you're heading — 90 days to 10 years`,
+        `  ${cyan("Mover_Dossier.md")}    What you've got — skills, audience, assets`,
+        `  ${cyan("Auto_Learnings.md")}   What the AI has noticed about your behavior`,
         "",
-        `  ${cyan("Identity_Prime.md")}   Who you are — values, psychology, anti-identity`,
-        `  ${cyan("Strategy.md")}         What you're testing — current hypothesis`,
-        `  ${cyan("Active_Context.md")}   What's happening NOW — blockers, focus, state`,
-        `  ${cyan("Goals.md")}            Where you're going — 90d, 1yr, 10yr targets`,
-        `  ${cyan("Mover_Dossier.md")}    What you have — skills, capital, network`,
-        `  ${cyan("Auto_Learnings.md")}   What the AI notices — behavioral patterns`,
+        "These files are yours. The system never overwrites them.",
+        "Every workflow reads them. They evolve as you do.",
         "",
-        `These files are ${bold("irreplaceable")}. The system never overwrites them.`,
-        "Every AI session reads them. Every workflow updates them.",
-        `Your Engine ${bold("evolves")} as you do.`,
+        `${dim("Location:")} 02_Areas/Engine/`,
       ],
     },
     {
-      title: "Daily Rhythm — The Loop",
+      title: "Your Daily Loop",
       body: [
-        `${bold("The daily execution cycle:")}`,
+        `${dim("The rhythm that makes it stick:")}`,
         "",
-        `  ${green("→")} ${bold("/morning")}         Start your day — energy check, set focus`,
-        `  ${green("→")} ${bold("[WORK]")}            Build, ship, create`,
-        `  ${green("→")} ${bold("/log")}              Capture what happened — syncs plan + state`,
-        `  ${green("→")} ${bold("/analyse-day")}      Brutal daily audit — patterns + verdict`,
-        `  ${green("→")} ${bold("/plan-tomorrow")}    Generate tomorrow's battle plan`,
+        `  ${green("→")} ${bold("/morning")}         Check in. Set your one thing for the day.`,
+        `  ${green("→")} ${bold("[WORK]")}            Build, ship, create.`,
+        `  ${green("→")} ${bold("/log")}              Capture what happened. Plan syncs automatically.`,
+        `  ${green("→")} ${bold("/analyse-day")}      Honest audit. What worked, what didn't.`,
+        `  ${green("→")} ${bold("/plan-tomorrow")}    Set up tomorrow before you close the laptop.`,
         "",
-        `${dim("Weekly:")}`,
-        `  ${green("→")} ${bold("/review-week")}      Sunday deep review + strategy validation`,
+        `  ${dim("Sundays:")} ${bold("/review-week")}  — zoom out, validate strategy, clean the system.`,
         "",
-        `${dim("The rhythm is the system.")} Miss a day, patterns detect it.`,
-        "Miss three, /reboot triggers recovery protocol.",
-        `Every workflow hands off to the next — ${bold("no dead ends")}.`,
+        "Miss a day, the system notices. Miss three, /reboot kicks in.",
+        "Each workflow hands off to the next. No dead ends.",
       ],
     },
     {
-      title: "Workflows — 23 Commands",
+      title: "23 Workflows",
       body: [
-        `${bold("Daily:")}  /morning  /log  /analyse-day  /plan-tomorrow  /review-week`,
-        `${bold("Build:")}  /ignite  /overview  /refactor-plan  /capture  /debrief`,
-        `${bold("Think:")}  /debug-resistance  /pivot-strategy  /mover-ideas  /screenshot`,
-        `${bold("Grow:")}   /harvest  /history  /reboot`,
-        `${bold("Meta:")}   /setup  /update  /walkthrough  /migrate  /mover-check  /mover-report`,
+        `${dim("Slash commands inside your AI agent. Type / and go.")}`,
         "",
-        `${dim("Key concepts:")}`,
-        `  ${cyan("•")} ${bold("/ignite")} creates projects — brief + plan in one workflow`,
-        `  ${cyan("•")} ${bold("/debug-resistance")} diagnoses WHY you're avoiding something`,
-        `  ${cyan("•")} ${bold("/pivot-strategy")} formally changes direction with logging`,
-        `  ${cyan("•")} ${bold("/harvest")} extracts permanent knowledge to your Library`,
-        `  ${cyan("•")} ${bold("/screenshot")} does meta-analysis of your AI session patterns`,
+        `${bold("Daily:")}     /morning  /log  /analyse-day  /plan-tomorrow  /review-week`,
+        `${bold("Projects:")}  /ignite  /overview  /refactor-plan  /capture  /debrief`,
+        `${bold("Strategy:")} /debug-resistance  /pivot-strategy  /mover-ideas  /screenshot`,
+        `${bold("Growth:")}   /harvest  /history  /reboot`,
+        `${bold("System:")}   /setup  /update  /walkthrough  /migrate  /mover-check`,
         "",
-        "Every command reads your Engine context and adapts to your state.",
+        `${dim("Highlights:")}`,
+        `  ${bold("/ignite")}            Starts any project — interrogation, brief, plan`,
+        `  ${bold("/debug-resistance")}  Figures out WHY you're avoiding something`,
+        `  ${bold("/harvest")}           Turns conversations into permanent knowledge`,
+        `  ${bold("/screenshot")}        Meta-analysis of how you actually use AI`,
       ],
     },
     {
-      title: "Skills — Domain Intelligence",
+      title: "61 Skill Packs",
       body: [
-        `${bold("Skills give your AI agents specialized knowledge.")}`,
+        `${dim("Specialized knowledge your AI loads automatically.")}`,
         "",
-        `${dim("Categories:")}`,
-        `  ${cyan("dev")}        Debugging, TDD, refactoring, error handling, React`,
-        `  ${cyan("marketing")} Copywriting, SEO, CRO, social content, email`,
-        `  ${cyan("cro")}        Page optimization, forms, popups, paywalls, onboarding`,
-        `  ${cyan("strategy")}  Pricing, launch, competitors, referrals, analytics`,
-        `  ${cyan("seo")}        Audits, schema markup, programmatic SEO, content`,
-        `  ${cyan("design")}    UI/UX, frontend design, Obsidian markdown/canvas`,
-        `  ${cyan("obsidian")} JSON Canvas, Bases, Obsidian CLI, markdown`,
+        `  ${cyan("dev")}        TDD, debugging, refactoring, error handling, React`,
+        `  ${cyan("marketing")} Copywriting, SEO, CRO, social media, email sequences`,
+        `  ${cyan("strategy")}  Pricing, launch strategy, competitor analysis`,
+        `  ${cyan("design")}    UI/UX, frontend patterns, accessibility`,
+        `  ${cyan("obsidian")} Canvas, Bases, markdown, CLI automation`,
         "",
-        `${dim("System skills (always active):")}`,
-        `  friction-enforcer  pattern-detector  plan-md-guardian`,
-        `  mover-os-context   workflow-router    daily-note-writer`,
+        `${dim("System skills (always watching):")}`,
+        `  ${bold("friction-enforcer")}   Pushes back when you drift from your plan`,
+        `  ${bold("pattern-detector")}    Spots recurring behavior across sessions`,
+        `  ${bold("plan-md-guardian")}    Protects your roadmap from corruption`,
+        `  ${bold("workflow-router")}     Suggests the right workflow for the moment`,
         "",
-        "Skills trigger automatically based on what you're doing.",
+        "You choose categories during install. Skills activate on context.",
       ],
     },
     {
       title: "The Friction System",
       body: [
-        `${bold("Your AI pushes back when you drift from your plan.")}`,
+        `${dim("Your AI has opinions. That's the point.")}`,
         "",
-        `  ${dim("Level 1")} ${cyan("Surface")}    \"Your plan says X. You're working on Y.\"`,
-        `  ${dim("Level 2")} ${yellow("Justify")}   \"Why is this more important than your Single Test?\"`,
-        `  ${dim("Level 3")} ${red("Earn It")}     AI stops helping with off-plan work.`,
-        `  ${dim("Level 4")} ${red("Hard Block")} Destructive actions require explicit reason.`,
+        `  ${dim("Level 1")} ${cyan("Surface")}    "Your plan says X. You're doing Y. Intentional?"`,
+        `  ${dim("Level 2")} ${yellow("Justify")}   "Why is this more important than your Single Test?"`,
+        `  ${dim("Level 3")} ${red("Earn It")}     Stops helping with off-plan work entirely.`,
+        `  ${dim("Level 4")} ${red("Hard Block")} Won't delete Engine files without a reason.`,
         "",
-        `You can always push through Levels 1-3. Friction creates`,
-        `${bold("awareness")}, not walls. But the AI won't silently comply`,
-        "when you're avoiding the hard thing.",
+        "You can always push through. It's awareness, not a wall.",
+        "But if you're avoiding the hard thing, the AI won't pretend.",
         "",
-        `${dim("Pre-Escalation Gate:")} If the work is exploration or compound`,
-        `value (not avoidance), it logs as ${dim("[COMPOUND]")} and doesn't escalate.`,
+        `${dim("Smart gate:")} If the work is genuinely useful (compound value,`,
+        `exploration), it logs ${dim("[COMPOUND]")} and doesn't escalate.`,
       ],
     },
     {
-      title: "Pattern Detection",
+      title: "What is this CLI?",
       body: [
-        `${bold("The system watches your behavior across sessions.")}`,
+        `${bold("Terminal utilities that don't need an AI session.")}`,
         "",
-        `${dim("How it works:")}`,
-        `  ${cyan("1.")} AI observes recurring behavior (3+ data points)`,
-        `  ${cyan("2.")} Logs to Auto_Learnings.md with confidence score (1-5)`,
-        `  ${cyan("3.")} Patterns surface proactively in workflows`,
-        `  ${cyan("4.")} You confirm or dismiss — the system adapts`,
+        "Your AI agents handle the complex stuff — planning, analysis,",
+        "writing. This CLI handles everything else: quick lookups, status",
+        "checks, maintenance, things you want instantly.",
         "",
-        `${dim("Pattern types:")}`,
-        `  ${yellow("Avoidance")}       Dodging specific tasks repeatedly`,
-        `  ${yellow("Time Drift")}      Working past shutdown, skipping rest`,
-        `  ${yellow("System Spree")}    Building tools instead of shipping`,
-        `  ${yellow("Scope Creep")}     Tasks growing beyond plan boundaries`,
-        `  ${yellow("Energy Cycles")}   Performance tied to sleep/food/time`,
+        `${dim("How it fits together:")}`,
+        `  ${cyan("Workflows")}   Run inside AI agents (/morning, /log, /ignite)`,
+        `  ${cyan("Skills")}      Loaded by AI agents automatically`,
+        `  ${cyan("CLI")}         Runs in your terminal, no AI needed`,
         "",
-        `Confidence 3+ patterns route to the workflow that fixes them.`,
+        "The CLI supplements your agents. It never replaces them.",
+        `Think of it as ${bold("htop for your productivity")} — instant, free, always there.`,
       ],
     },
     {
-      title: "16 AI Agents — One Brain",
+      title: "CLI — Status & Insight",
       body: [
-        `${bold("Mover OS installs to every major AI coding agent.")}`,
+        `${dim("See what's happening without opening an AI session.")}`,
         "",
-        `${dim("Full tier (rules + skills + commands + hooks):")}`,
-        `  Claude Code  Cursor  Cline  Windsurf  Gemini CLI`,
-        `  Copilot  Amazon Q  OpenCode  Kilo Code`,
+        `  ${cyan("pulse")}       Dashboard — tasks, streaks, energy, blockers`,
+        `                ${dim("Like htop for your day. One glance.")}`,
         "",
-        `${dim("Enhanced tier (rules + skills):")}`,
-        `  Codex  Amp  Roo Code  Antigravity`,
+        `  ${cyan("replay")}      Session replay — what you did, when, drift analysis`,
+        `                ${dim("\"You planned 4 tasks, completed 2, drifted into 3.\"")}`,
         "",
-        `${dim("Basic tier (rules only):")}`,
-        `  Continue  Aider`,
+        `  ${cyan("diff")}        Engine evolution — how your strategy changed over time`,
+        `                ${dim("Git-powered. Shows exactly when and why.")}`,
+        "",
+        `  ${cyan("context")}     What each agent sees — loaded rules, skills, token count`,
+        `                ${dim("Debug why an agent is behaving differently.")}`,
+        "",
+        `  ${cyan("doctor")}      Health check — are all agents configured correctly?`,
+      ],
+    },
+    {
+      title: "CLI — Quick Actions",
+      body: [
+        `${dim("Do things fast without starting a session.")}`,
+        "",
+        `  ${cyan("capture")}     Quick capture — task, idea, link, brain dump`,
+        `                ${dim("moveros capture --task \"Fix the login bug\"")}`,
         "",
-        "Switch editors freely. Your identity, strategy, and patterns",
-        `follow you everywhere. The ${bold("Engine is the constant")}.`,
-        `Run ${cyan("moveros sync")} to update all agents at once.`,
+        `  ${cyan("who")}         Entity lookup — search People, Orgs, Places`,
+        `                ${dim("moveros who \"Ishaaq\" → everything you know about them")}`,
+        "",
+        `  ${cyan("warm")}        Pre-warm an AI session with fresh context`,
+        `                ${dim("Run before opening Claude/Cursor. Eliminates cold start.")}`,
+        "",
+        `  ${cyan("prayer")}      Mosque timetable — next prayer in your status line`,
+        `                ${dim("Paste or fetch. Shows countdown. Optional.")}`,
       ],
     },
     {
-      title: "CLI Commands",
+      title: "CLI — Maintenance",
       body: [
-        `${bold("Terminal utilities — no AI session needed.")}`,
+        `${dim("Keep everything in sync without thinking about it.")}`,
+        "",
+        `  ${cyan("sync")}        Update all agents to latest rules and skills`,
+        `                ${dim("One command updates 16 agents. Shows what changed.")}`,
         "",
-        `  ${cyan("moveros pulse")}      Dashboard — energy, tasks, streaks, blockers`,
-        `  ${cyan("moveros doctor")}     Health check across all installed agents`,
-        `  ${cyan("moveros capture")}    Quick capture — tasks, links, ideas from terminal`,
-        `  ${cyan("moveros who")}        Entity memory lookup — people, orgs, places`,
-        `  ${cyan("moveros sync")}       Update all agents to latest rules/skills`,
-        `  ${cyan("moveros context")}    See what each agent loads — rules, skills, tokens`,
-        `  ${cyan("moveros diff")}       Engine file evolution via git history`,
-        `  ${cyan("moveros replay")}     Session replay from Daily Notes`,
-        `  ${cyan("moveros settings")}   View/edit config — ${dim("settings set <key> <val>")}`,
-        `  ${cyan("moveros backup")}     Manual backup wizard (engine, areas, agents)`,
-        `  ${cyan("moveros restore")}    Restore from backup`,
-        `  ${cyan("moveros warm")}       Pre-warm an AI session with context`,
+        `  ${cyan("backup")}      Backup Engine, Areas, or agent configs`,
+        `                ${dim("With manifest. Knows what's in each backup.")}`,
+        "",
+        `  ${cyan("restore")}     Restore from any backup — selective, safe`,
+        `                ${dim("Creates a safety backup before restoring.")}`,
+        "",
+        `  ${cyan("settings")}    View/edit config from terminal`,
+        `                ${dim("moveros settings set review_day sunday")}`,
+        "",
+        `  ${cyan("update")}      Update CLI + workflows + skills in one go`,
+        `                ${dim("Self-updates the CLI, then pulls latest payload.")}`,
       ],
     },
     {
-      title: "The Status Line",
+      title: "16 Agents, One Brain",
       body: [
-        `${bold("Your life, glanceable. Always visible in Claude Code.")}`,
+        `${dim("Install once. Every agent gets the same context.")}`,
         "",
-        `  ${dim("Line 1:")} Model · Context% · Project(branch) · Lines · Time · Cost`,
-        `  ${dim("Line 2:")} Next task · Progress · Vitality · Prayer · Last log`,
-        `  ${dim("Line 3:")} Rate limits (5hr + 7day + extra usage)`,
+        `${dim("Full tier")} ${dim("(rules + skills + commands + hooks):")}`,
+        `  Claude Code  Cursor  Cline  Windsurf  Gemini CLI`,
+        `  Copilot  Amazon Q  OpenCode  Kilo Code`,
         "",
-        `${dim("Features:")}`,
-        `  ${cyan("•")} Next unchecked task from today's Daily Note`,
-        `  ${cyan("•")} Strategic task count (vitality excluded)`,
-        `  ${cyan("•")} Vitality slot machine — rotates reminders every minute`,
-        `  ${cyan("•")} Next prayer time (if ${dim("show_prayer_times: true")} in settings)`,
-        `  ${cyan("•")} Time since last /log — so you never forget`,
-        `  ${cyan("•")} Rate limit bars with reset times`,
+        `${dim("Enhanced tier")} ${dim("(rules + skills):")}`,
+        `  Codex  Amp  Roo Code  Antigravity`,
         "",
-        `All data from your vault. ${bold("No API calls")} except rate limits.`,
+        `${dim("Basic tier")} ${dim("(rules only):")}`,
+        `  Continue  Aider`,
+        "",
+        "Switch editors whenever. Your Engine follows you.",
+        `${cyan("moveros sync")} keeps them all current.`,
       ],
     },
     {
-      title: "Getting Started",
+      title: "Get Started",
       body: [
-        `${bold("You're ready.")}`,
+        `${bold("Five minutes to a system that remembers everything.")}`,
         "",
-        `  ${cyan("1.")} Run ${bold("/setup")} in any AI agent to build your Engine`,
+        `  ${cyan("1.")} Run ${bold("/setup")} in your AI agent — it'll interview you`,
         `  ${cyan("2.")} Run ${bold("/morning")} to start your first session`,
         `  ${cyan("3.")} Work. Build. Ship.`,
-        `  ${cyan("4.")} Run ${bold("/log")} to capture what happened`,
+        `  ${cyan("4.")} Run ${bold("/log")} when you're done — captures everything`,
         `  ${cyan("5.")} Run ${bold("/plan-tomorrow")} before bed`,
         "",
-        `${dim("Quick tips:")}`,
-        `  ${cyan("•")} ${bold("Single Test")} — one thing that makes the day a win`,
-        `  ${cyan("•")} ${bold("Sacrifice")} — what you won't do today (as important as what you will)`,
-        `  ${cyan("•")} The system gets smarter the more you use it`,
-        `  ${cyan("•")} Trust the Engine files — they're your memory between sessions`,
+        `${dim("Two things to know:")}`,
+        `  ${bold("Single Test")}  — the one thing that makes today a win`,
+        `  ${bold("Sacrifice")}    — what you won't do (just as important)`,
+        "",
+        "The system learns from you. The more you use it, the sharper it gets.",
         "",
-        `${dim("moveros.dev")}  ${dim("·")}  ${dim("$49 one-time")}  ${dim("·")}  ${dim("updates included")}`,
+        `${dim("moveros.dev")}`,
       ],
     },
   ];
 
   // Paginated display with keyboard navigation
   let page = 0;
+  const seen = new Set();
 
-  function renderPage() {
+  async function renderPage(animate) {
     const p = pages[page];
-    // Clear screen area
     w("\x1b[2J\x1b[H"); // clear screen, cursor to top
     ln();
 
@@ -4086,9 +4136,14 @@ async function cmdHelp(opts) {
     ln(`  ${S.cyan}└${"─".repeat(56)}┘${S.reset}`);
     ln();
 
-    // Body
-    for (const line of p.body) {
-      ln(`  ${line}`);
+    // Body — animate on first visit, instant on revisit
+    if (animate && !seen.has(page)) {
+      for (const line of p.body) {
+        await typeLine(line, 6);
+      }
+      seen.add(page);
+    } else {
+      for (const line of p.body) ln(`  ${line}`);
     }
     ln();
     ln();
@@ -4103,7 +4158,6 @@ async function cmdHelp(opts) {
 
   return new Promise((resolve) => {
     if (!IS_TTY) {
-      // Non-interactive: dump all pages
       for (const p of pages) {
         ln(bold(`\n## ${p.title}\n`));
         for (const line of p.body) ln(`  ${line}`);
@@ -4118,22 +4172,32 @@ async function cmdHelp(opts) {
     stdin.setEncoding("utf8");
     w(S.hide);
 
-    renderPage();
+    let navigating = false;
+    const go = async (newPage) => {
+      if (navigating) return;
+      navigating = true;
+      page = newPage;
+      await renderPage(true);
+      navigating = false;
+    };
+
+    go(0); // initial render with animation
 
     const handler = (data) => {
+      if (navigating) return; // ignore input during animation
       if (data === "\x1b[C" || data === "l" || data === " ") {
-        if (page < pages.length - 1) { page++; renderPage(); }
+        if (page < pages.length - 1) go(page + 1);
       } else if (data === "\x1b[D" || data === "h") {
-        if (page > 0) { page--; renderPage(); }
+        if (page > 0) go(page - 1);
       } else if (data === "q" || data === "\x1b" || data === "\x03") {
         stdin.removeListener("data", handler);
         stdin.setRawMode(false);
         stdin.pause();
         w(S.show);
-        w("\x1b[2J\x1b[H"); // clear
+        w("\x1b[2J\x1b[H");
         resolve();
       } else if (data === "\r" || data === "\n") {
-        if (page < pages.length - 1) { page++; renderPage(); }
+        if (page < pages.length - 1) go(page + 1);
         else {
           stdin.removeListener("data", handler);
           stdin.setRawMode(false);
@@ -4154,27 +4218,20 @@ async function cmdTest(opts) { barLn(yellow("moveros test — not yet implemente
 
 // ─── Interactive Main Menu ────────────────────────────────────────────────────
 async function cmdMainMenu() {
-  const categories = [
-    { header: "Setup", cmds: ["install", "update"] },
-    { header: "Dashboard", cmds: ["pulse", "replay", "diff"] },
-    { header: "Agents", cmds: ["doctor", "sync", "context", "warm"] },
-    { header: "Capture", cmds: ["capture", "who"] },
-    { header: "System", cmds: ["settings", "prayer", "backup", "restore", "help"] },
+  const menuOrder = [
+    "install", "update",
+    "pulse", "replay", "diff",
+    "doctor", "sync", "context", "warm",
+    "capture", "who",
+    "settings", "prayer", "backup", "restore", "help",
   ];
 
-  const menuItems = [];
-  for (const cat of categories) {
-    menuItems.push({ id: `_sep_${cat.header}`, name: `── ${cat.header}`, _separator: true });
-    for (const cmd of cat.cmds) {
-      const meta = CLI_COMMANDS[cmd];
-      if (!meta || meta.hidden) continue;
-      menuItems.push({
-        id: cmd,
-        name: `${cmd.padEnd(12)} ${dim(meta.desc)}`,
-        tier: `${cat.header}`,
-      });
-    }
-  }
+  const menuItems = menuOrder
+    .filter(cmd => { const m = CLI_COMMANDS[cmd]; return m && !m.hidden; })
+    .map(cmd => ({
+      id: cmd,
+      name: `${cmd.padEnd(12)} ${dim(CLI_COMMANDS[cmd].desc)}`,
+    }));
 
   question(`${bold("moveros")} ${dim("— choose a command")}`);
   barLn();
@@ -5020,9 +5077,9 @@ async function main() {
       } else if (method === "fetch") {
         barLn();
         const city = await textInput({ label: "City (e.g. London, Watford, Istanbul)", placeholder: "London" });
-        if (city === null) break;
+        if (city === null) return;
         const country = await textInput({ label: "Country", placeholder: "United Kingdom" });
-        if (country === null) break;
+        if (country === null) return;
         barLn();
 
         if (city && country) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mover-os",
-  "version": "4.4.2",
+  "version": "4.4.3",
   "description": "The self-improving OS for AI agents. Turns Obsidian into an execution engine.",
   "bin": {
     "moveros": "install.js"