agentel 0.3.0 → 0.3.1

package/src/cli.js

@@ -24,6 +24,7 @@ const { HISTORY_PROVIDER_OPTIONS, IMPORT_SOURCE_ORDER } = require("./sources");
 const { ensureBaseDirs, ensureDir, paths, readJson, writeJson } = require("./paths");
 const { PRICING_SOURCE, PRICING_VERSION, pricingForSession } = require("./pricing");
 const { runSupervisorForeground, startSupervisorDetached, stopSupervisor, supervisorStatus } = require("./supervisor");
+const { postSlackMessage, queuePath: slackQueuePath, runSlackNotify, slackAppCreationUrl, slackAuthTest, slackNotifySettings, statePath: slackStatePath } = require("./slack-notify");
 const { configureRemoteFromFlags, hasRemoteTarget, listRemoteSnapshots, replaceRemoteArchive, snapshotArchive, syncArchive, wipeRemoteArchive } = require("./sync");
 const {
   CLAUDE_CODE_REPAIR_COMMAND,
@@ -88,6 +89,8 @@ async function main(argv = process.argv.slice(2), env = process.env) {
       return stopCommand(env);
     case "watcher":
       return watcherCommand(positionals.slice(1), flags, env);
+    case "notify":
+      return notifyCommand(positionals.slice(1), flags, env);
     case "status":
       return statusCommand(flags, env);
     case "logs":
@@ -263,6 +266,22 @@ async function initCommand(flags, env) {
     printCheck("Login watcher", status.file ? `activated (${fullPath(status.file)})` : `activated (${fullPath(autostartFile)})`);
   }
 
+  const slackConfigured = Boolean(loadConfig(env).notify?.slack?.enabled);
+  if (!flags.yes && process.stdin.isTTY && !slackConfigured) {
+    printSection("Slack Notifications");
+    printMuted("Optional: post session summaries (and a live firehose) to Slack channels.");
+    const slackAnswer = (await ask("Set up the Slack sidecar now? [y/N]: ")).trim().toLowerCase();
+    if (slackAnswer === "y" || slackAnswer === "yes") {
+      try {
+        await notifyCommand(["slack", "setup"], {}, env);
+      } catch (error) {
+        printState("Slack setup", `${error.message} — run \`agentlog notify slack setup\` to retry`, "warn");
+      }
+    } else {
+      printMuted("Run `agentlog notify slack setup` anytime to connect Slack.");
+    }
+  }
+
   printNextSteps({ remoteConfigured: hasRemoteTarget(loadConfig(env), env), autostartEnabled: deferredAutostart });
 }
 
@@ -289,6 +308,223 @@ function watcherCommand(args, flags, env) {
   throw new Error("usage: agentlog watcher <start|stop|status|logs|login> [args]");
 }
 
+const NOTIFY_USAGE =
+  "usage: agentlog notify slack <setup|enable|disable|status|test> [--summaries on|off] [--summary-channel <id>] [--quiet-minutes <n>] [--firehose on|off] [--firehose-channel <id>] [--batch-seconds <n>] [--token <xoxb-…>] [--repos <a,b>] [--dry-run]";
+
+function onOffFlag(value, label) {
+  if (value === undefined) return undefined;
+  const normalized = String(value).toLowerCase();
+  if (["on", "true", "yes", "1"].includes(normalized)) return true;
+  if (["off", "false", "no", "0"].includes(normalized)) return false;
+  throw new Error(`${label} expects on or off, got: ${value}`);
+}
+
+async function notifyCommand(args, flags, env) {
+  if ((args[0] || "slack") !== "slack") throw new Error(NOTIFY_USAGE);
+  const action = args[1] || "status";
+  const title = "agentlog notify slack";
+  const cfg = loadConfig(env);
+
+  if (action === "setup") {
+    printPageTitle(title, "notify");
+    printMuted("This creates a personal Slack app (chat:write only) and connects it to a channel.");
+    const defaultName = `agentlog (${os.userInfo().username || cfg.device?.slug || "me"})`.slice(0, 35);
+    const nameAnswer = (await ask(`Bot name [${defaultName}]: `)).trim();
+    const appName = nameAnswer || defaultName;
+    const url = slackAppCreationUrl(appName);
+
+    printSection("Create The App");
+    printMuted("Your browser opens Slack's app creation pre-filled from a manifest.");
+    printMuted("");
+    printMuted("  1. Pick your workspace → click \"Create\".");
+    printMuted("  2. Slack lands on \"Basic Information\". You need a different page:");
+    printMuted("     in the LEFT SIDEBAR click \"OAuth & Permissions\".");
+    printMuted("     (Or: https://api.slack.com/apps → click your app → OAuth & Permissions)");
+    printMuted("  3. At the top of that page click \"Install to Workspace\" → \"Allow\".");
+    printMuted("  4. Copy the \"Bot User OAuth Token\" (xoxb-…) now shown at the top.");
+    printMuted("");
+    printMuted("  Nothing on Basic Information is needed — do not copy the Client ID,");
+    printMuted("  Client Secret, or Signing Secret.");
+    if (process.stdout.isTTY) {
+      try {
+        openUrl(url);
+        printMuted("If the browser did not open, use the link below.");
+      } catch {}
+    }
+    printMuted(`Creation link: ${url}`);
+    printMuted("");
+    printMuted("Stuck finding the token? https://api.slack.com/apps → your app →");
+    printMuted("OAuth & Permissions → Bot User OAuth Token.");
+
+    const token = (await ask("Paste the bot token (xoxb-…): ")).trim();
+    if (!token) throw new Error("setup cancelled: no token provided");
+    const probe = slackNotifySettings({ notify: { slack: { botToken: token } } }, env);
+    const identity = await slackAuthTest(probe);
+    printCheck("Slack auth", `${identity.team || "workspace"} as ${identity.user || appName}`);
+
+    printSection("Connect A Channel");
+    printMuted(`In Slack: invite the bot with /invite @${appName}, then copy the channel ID`);
+    printMuted("(click the channel name → About tab → the C… value at the bottom).");
+    const channel = (await ask("Summary channel ID (C…): ")).trim();
+    if (!channel) throw new Error("setup cancelled: no channel provided");
+
+    printMuted("The firehose streams turns live into a per-session thread as agents work.");
+    const firehoseAnswer = (await ask("Enable the live firehose too? [y/N]: ")).trim().toLowerCase();
+    const firehoseOn = firehoseAnswer === "y" || firehoseAnswer === "yes";
+    let firehoseChannel = channel;
+    if (firehoseOn) {
+      const separate = (await ask(`Firehose channel ID [${channel}]: `)).trim();
+      if (separate) firehoseChannel = separate;
+      if (firehoseChannel !== channel) printMuted(`Remember to /invite @${appName} in that channel too.`);
+    }
+
+    const slack = { ...cfg.notify.slack, enabled: true, botToken: token };
+    delete slack.channel;
+    delete slack.quietMinutes;
+    delete slack.mode;
+    slack.summary = { ...cfg.notify.slack.summary, enabled: true, channel };
+    slack.stream = { ...cfg.notify.slack.stream, enabled: firehoseOn, channel: firehoseOn ? firehoseChannel : cfg.notify.slack.stream.channel };
+    cfg.notify = { ...cfg.notify, slack };
+    saveConfig(cfg, env);
+
+    printSection("Verify");
+    const verifyChannels = [...new Set([channel, ...(firehoseOn ? [firehoseChannel] : [])])];
+    for (const target of verifyChannels) {
+      try {
+        await postSlackMessage(slackNotifySettings(cfg, env), {
+          channel: target,
+          text: `:wave: agentlog connected — posts from ${cfg.device?.name || "this device"} will land here.`,
+          unfurl_links: false
+        });
+        printCheck("Test post", `sent to ${target}`);
+      } catch (error) {
+        printState("Test post", `${target}: ${error.message} — invite the bot to the channel, then run \`agentlog notify slack test\``, "warn");
+      }
+    }
+    printCheck("Status", "enabled");
+    printNotifySettings(slackNotifySettings(cfg, env));
+    printMuted("Adjust anytime: agentlog notify slack enable --summaries on|off --firehose on|off --quiet-minutes N --batch-seconds N");
+    // Piped stdin would otherwise keep the process alive after the last
+    // prompt; nothing reads input past this point.
+    if (typeof process.stdin.unref === "function") process.stdin.unref();
+    return;
+  }
+
+  if (action === "enable" || action === "set") {
+    const current = slackNotifySettings(cfg, env);
+    const summary = { ...cfg.notify.slack.summary, channel: current.summary.channel, quietMinutes: current.summary.quietMinutes };
+    const stream = { ...cfg.notify.slack.stream };
+    const slack = { ...cfg.notify.slack, summary, stream };
+    // The pre-split keys are rewritten into the summary block on save.
+    delete slack.channel;
+    delete slack.quietMinutes;
+    delete slack.mode;
+
+    const summariesFlag = onOffFlag(flags.summaries, "--summaries");
+    if (summariesFlag !== undefined) summary.enabled = summariesFlag;
+    if (flags["summary-channel"] || flags.channel) summary.channel = String(flags["summary-channel"] || flags.channel);
+    if (flags["quiet-minutes"]) summary.quietMinutes = Number(flags["quiet-minutes"]);
+    const firehoseFlag = onOffFlag(flags.firehose ?? flags.stream, "--firehose");
+    if (firehoseFlag !== undefined) stream.enabled = firehoseFlag;
+    if (flags["firehose-channel"] || flags["stream-channel"]) stream.channel = String(flags["firehose-channel"] || flags["stream-channel"]);
+    if (flags["batch-seconds"]) stream.batchSeconds = Number(flags["batch-seconds"]);
+    if (flags.token) slack.botToken = String(flags.token);
+    if (flags.repos) slack.repos = String(flags.repos).split(",").map((repo) => repo.trim()).filter(Boolean);
+
+    if (summary.enabled && !summary.channel && !stream.channel) {
+      throw new Error("a channel is required: agentlog notify slack enable --summary-channel C0123456789");
+    }
+    if (stream.enabled && !stream.channel && !summary.channel) {
+      throw new Error("firehose needs a channel: --firehose-channel C0123456789");
+    }
+    slack.enabled = true;
+    cfg.notify = { ...cfg.notify, slack };
+    saveConfig(cfg, env);
+    const settings = slackNotifySettings(cfg, env);
+    printPageTitle(title, "notify");
+    printCheck("Status", "enabled");
+    printNotifySettings(settings);
+    if (settings.botToken) {
+      try {
+        const identity = await slackAuthTest(settings);
+        printCheck("Slack auth", `${identity.team || "workspace"} as ${identity.user || "bot"}`);
+      } catch (error) {
+        printState("Slack auth", error.message, "warn");
+      }
+    }
+    printMuted("Run `agentlog notify slack test` to verify the channel(s).");
+    return;
+  }
+
+  if (action === "disable") {
+    cfg.notify = { ...cfg.notify, slack: { ...cfg.notify.slack, enabled: false } };
+    saveConfig(cfg, env);
+    printPageTitle(title, "notify");
+    printCheck("Status", "disabled");
+    return;
+  }
+
+  if (action === "status") {
+    const settings = slackNotifySettings(cfg, env);
+    const state = readJson(slackStatePath(env), {});
+    const tracked = Object.keys(state.sessions || {});
+    let queued = 0;
+    try {
+      queued = fs.readFileSync(slackQueuePath(env), "utf8").split("\n").filter((line) => line.trim()).length;
+    } catch {}
+    printPageTitle(title, "notify");
+    printCheck("Status", settings.enabled ? "enabled" : "disabled");
+    printNotifySettings(settings);
+    printCheck("Tracked sessions", String(tracked.length));
+    printCheck("Queued writes", String(queued));
+    return;
+  }
+
+  if (action === "test") {
+    const settings = slackNotifySettings(cfg, env);
+    const channels = [...new Set([settings.summary.enabled ? settings.summary.channel : "", settings.stream.enabled ? settings.stream.channel : ""].filter(Boolean))];
+    if (!channels.length) throw new Error("no channel configured: agentlog notify slack enable --summary-channel C0123456789");
+    const text = `:wave: agentlog notify test from ${cfg.device?.name || cfg.device?.slug || "this device"}`;
+    printPageTitle(title, "notify");
+    if (flags["dry-run"]) {
+      for (const channel of channels) printCheck("Channel", channel);
+      printCheck("Message", text);
+      printMuted("Dry run: nothing was posted.");
+      return;
+    }
+    if (!settings.botToken) throw new Error("no Slack bot token (set notify.slack.botToken or SLACK_BOT_TOKEN)");
+    for (const channel of channels) {
+      await postSlackMessage(settings, { channel, text, unfurl_links: false });
+      printCheck("Status", `test message posted to ${channel}`);
+    }
+    return;
+  }
+
+  throw new Error(NOTIFY_USAGE);
+}
+
+function printNotifySettings(settings) {
+  printCheck(
+    "Summaries",
+    settings.summary.enabled
+      ? `on → ${settings.summary.channel || "no channel set"} (after ${settings.summary.quietMinutes}m quiet)`
+      : "off"
+  );
+  printCheck(
+    "Firehose",
+    settings.stream.enabled
+      ? `on → ${settings.stream.channel || "no channel set"} (batched every ${settings.stream.batchSeconds}s)`
+      : "off"
+  );
+  printCheck("Repos", settings.repos.length ? settings.repos.join(", ") : "all repos");
+  printCheck("Token", settings.botToken ? maskSlackToken(settings.botToken) : "none (set notify.slack.botToken or SLACK_BOT_TOKEN)");
+}
+
+function maskSlackToken(token) {
+  const value = String(token);
+  return value.length > 9 ? `${value.slice(0, 5)}…${value.slice(-4)}` : "set";
+}
+
 function stopCommand(env, title = "agentlog stop") {
   const status = supervisorStatus(env);
   const stopped = stopSupervisor(env);
@@ -3993,8 +4229,8 @@ function statsPayloadForSessions(sessions, options = {}) {
       memory_writes: positiveStatsNumber(buckets.memory_writes),
       memory_loads: positiveStatsNumber(buckets.memory_loads),
       providers: compactStatsBreakdownMap(buckets.providers, { includeSpend: true }),
-      companies: compactStatsBreakdownMap(buckets.companies),
-      models: compactStatsBreakdownMap(buckets.models)
+      companies: compactStatsBreakdownMap(buckets.companies, { includeSpend: true }),
+      models: compactStatsBreakdownMap(buckets.models, { includeSpend: true })
     }))
     .sort((a, b) => a.date.localeCompare(b.date));
   const dailyRepos = Array.from(dailyRepoMap.entries())
@@ -9116,6 +9352,8 @@ body.project-view .stats-project-controls{display:flex}
 .stats-chart-frame .stats-axis-label{font-size:9px;font-weight:500;fill:var(--ui-text-subtle)}
 .stats-chart-frame.stats-empty{height:232px;min-height:232px;padding:0 18px}
 .stats-share-area{transition:opacity .12s ease}
+.stats-momentum-line{fill:none;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}
+.stats-momentum-zero{stroke:var(--ui-text-subtle);stroke-width:1.2}
 .stats-empty{display:flex;align-items:center;justify-content:center;min-height:200px;color:var(--ui-text-subtle);font-size:12px;line-height:1.4;text-align:center;padding:0 18px}
 .stats-legend{display:flex;flex-wrap:wrap;gap:8px;font-size:11px;color:var(--ui-text-secondary);letter-spacing:.01em}
 .stats-legend-item{display:inline-flex;align-items:center;gap:5px}
@@ -9618,6 +9856,17 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
 .inline-empty{padding:22px;color:var(--ui-text-muted)}
 .conversation.empty .session-header{display:none}
 .conversation.empty .detail-scroll{display:flex;align-items:center;justify-content:center}
+.session-outline{position:absolute;z-index:21;right:0;top:50%;transform:translateY(-50%);display:flex;align-items:center}
+.session-outline-ticks{display:flex;flex-direction:column;gap:7px;padding:12px 12px 12px 16px}
+.session-outline-tick{width:16px;height:2px;border-radius:999px;background:var(--ui-border);transition:background .12s ease}
+.session-outline-tick.active{background:var(--ui-text-strong)}
+.session-outline-panel{position:absolute;right:38px;top:50%;transform:translateY(-50%);width:min(360px,56vw);max-height:min(440px,72vh);overflow-y:auto;padding:6px;border:1px solid var(--ui-border);border-radius:12px;background:var(--ui-surface-raised);box-shadow:0 10px 30px var(--ui-shadow-sm);opacity:0;visibility:hidden;transition:opacity .12s ease,visibility .12s ease}
+.session-outline:hover .session-outline-panel,.session-outline:focus-within .session-outline-panel{opacity:1;visibility:visible}
+.session-outline-item{display:block;width:100%;padding:8px 10px;border:0;border-radius:8px;background:transparent;color:var(--ui-text-body);font-size:12.5px;line-height:1.35;text-align:left;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:pointer}
+.session-outline-item:hover{background:var(--ui-surface-hover)}
+.session-outline-item.active{background:var(--ui-surface-subtle);color:var(--ui-text-strong);font-weight:600}
+.session-outline-note{padding:7px 10px;color:var(--ui-text-subtle);font-size:11px}
+@media (max-width:950px){.session-outline{display:none}}
 .conversation.empty #readableView.inline-empty{padding:0;color:var(--ui-text-muted);text-align:center}
 @media (max-width:1180px){.toolbar{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:8px;align-items:end}.search-wrap{grid-column:1;grid-row:1}.toolbar-actions{grid-column:2;grid-row:1}.filters{display:grid;grid-column:1 / -1;grid-template-columns:repeat(4,minmax(0,1fr));gap:8px}.filter select,.filter input,.select-field,.filter.path-filter input{width:100%}}
 @media (max-width:950px){html,body{overflow:auto}body{height:auto}.app-head{align-items:center}main{display:block}aside{height:42vh;border-right:0;border-bottom:1px solid var(--line)}.splitter{display:none}.sidebar-collapse-button{display:none}.conversation{height:58vh}.bubble{max-width:94%}#readableView,#markdownView{padding:16px 14px 40px}}
@@ -9776,6 +10025,10 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
       <pre id="markdownView"></pre>
     </div>
     <button id="jumpEnd" class="jump-end" type="button" title="Jump to end" hidden><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 5v14"/><path d="m19 12-7 7-7-7"/></svg></button>
+    <div id="sessionOutline" class="session-outline" hidden>
+      <div id="sessionOutlineTicks" class="session-outline-ticks" aria-hidden="true"></div>
+      <div id="sessionOutlinePanel" class="session-outline-panel" role="menu" aria-label="Jump to user message"></div>
+    </div>
   </section>
 </main>
 <div id="sessionModal" class="session-modal" hidden role="dialog" aria-modal="true" aria-labelledby="sessionModalTitle">
@@ -9875,7 +10128,7 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
     <div class="stats-section-head">
       <div class="stats-section-heading">
         <div class="stats-section-title">Usage</div>
-        <div id="statsUsageSub" class="stats-section-sub">Recent activity window and overall token mix.</div>
+        <div id="statsUsageSub" class="stats-section-sub">Last 30 days summary and token mix for the selected range.</div>
       </div>
     </div>
     <div class="stats-window" id="statsUsageWindow" hidden></div>
@@ -9919,7 +10172,8 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
       <div id="statsLegend" class="stats-legend"></div>
     </div>
     <div class="stats-grid">
-      <div class="stats-card stats-card--wide"><div class="stats-card-title" id="chartTokenSharePerDayTitle">Daily token share</div><div class="stats-card-meta" id="chartTokenSharePerDayMeta">Selected tokens by provider</div><div id="chartTokenSharePerDay" class="stats-empty stats-chart-frame">No token share yet.</div></div>
+      <div class="stats-card"><div class="stats-card-title" id="chartTokenSharePerDayTitle">Daily token share</div><div class="stats-card-meta" id="chartTokenSharePerDayMeta">Selected tokens by provider</div><div id="chartTokenSharePerDay" class="stats-empty stats-chart-frame">No token share yet.</div></div>
+      <div class="stats-card"><div class="stats-card-title" id="chartMonthlyMomentumTitle">Monthly momentum</div><div class="stats-card-meta" id="chartMonthlyMomentumMeta">Month-over-month change</div><div id="chartMonthlyMomentum" class="stats-empty stats-chart-frame">No monthly momentum yet.</div></div>
       <div class="stats-card"><div class="stats-card-title">Tokens per day</div><div id="chartTokensPerDay" class="stats-empty">No data yet.</div></div>
       <div class="stats-card"><div class="stats-card-title" id="chartActivityPerDayTitle">User messages per day</div><div id="chartSessionsPerDay" class="stats-empty">No data yet.</div></div>
     </div>
@@ -9928,7 +10182,7 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
     <div class="stats-section-head">
       <div class="stats-section-heading">
         <div class="stats-section-title">Tokens &amp; messages per folder</div>
-        <div class="stats-section-sub">Top folders by the selected breakdown above.</div>
+        <div id="statsFoldersSub" class="stats-section-sub">Top folders by the selected breakdown above.</div>
       </div>
     </div>
     <div class="stats-grid">
@@ -9962,18 +10216,18 @@ mark.search-match.search-match-current{background:var(--ui-search-strong-bg);col
       </div>
     </div>
     <div class="stats-grid stats-grid--mix">
-      <div class="stats-card stats-card--mix"><div class="stats-card-title">Session time per month</div><div id="chartSessionTimePerMonth" class="stats-empty">No session time yet.</div></div>
-      <div class="stats-card stats-card--mix"><div class="stats-card-title">Most used tools</div><div id="chartTopTools" class="stats-empty">No tool calls yet.</div></div>
-      <div class="stats-card stats-card--mix"><div class="stats-card-title">Tools by category</div><div id="chartToolCategories" class="stats-empty">No tool calls yet.</div></div>
-      <div class="stats-card stats-card--mix"><div class="stats-card-title">Skills used</div><div id="chartTopSkills" class="stats-empty">No skill calls yet.</div></div>
-      <div class="stats-card stats-card--mix"><div class="stats-card-title">MCP servers</div><div id="chartMcpServers" class="stats-empty">No MCP calls yet.</div></div>
+      <div class="stats-card stats-card--mix"><div class="stats-card-title">Session time per month</div><div class="stats-card-meta" id="chartSessionTimePerMonthMeta">Selected range</div><div id="chartSessionTimePerMonth" class="stats-empty">No session time yet.</div></div>
+      <div class="stats-card stats-card--mix"><div class="stats-card-title">Most used tools</div><div class="stats-card-meta">All time</div><div id="chartTopTools" class="stats-empty">No tool calls yet.</div></div>
+      <div class="stats-card stats-card--mix"><div class="stats-card-title">Tools by category</div><div class="stats-card-meta">All time</div><div id="chartToolCategories" class="stats-empty">No tool calls yet.</div></div>
+      <div class="stats-card stats-card--mix"><div class="stats-card-title">Skills used</div><div class="stats-card-meta">All time</div><div id="chartTopSkills" class="stats-empty">No skill calls yet.</div></div>
+      <div class="stats-card stats-card--mix"><div class="stats-card-title">MCP servers</div><div class="stats-card-meta">All time</div><div id="chartMcpServers" class="stats-empty">No MCP calls yet.</div></div>
     </div>
   </div>
   <div class="stats-section">
     <div class="stats-section-head">
       <div class="stats-section-heading">
         <div class="stats-section-title">Provider insights</div>
-        <div id="statsProviderInsightsSub" class="stats-section-sub">Per-provider highlights.</div>
+        <div id="statsProviderInsightsSub" class="stats-section-sub">Per-provider highlights · all time.</div>
       </div>
     </div>
     <div id="statsProviderInsights" class="stats-grid stats-grid--insights stats-empty">No provider activity yet.</div>
@@ -11277,7 +11531,7 @@ function shouldTrustModelForSession(model, sessionProvider) {
   if (!m) return false;
   const p = String(sessionProvider || '').toLowerCase();
   if (p.includes('claude') || p === 'anthropic') {
-    if (/\bgpt-|^gpt|openai|o1-|o3\b|o4|4o-mini|\b4o\b|davinci|text-davinci/i.test(m)) return false;
+    if (/\\bgpt-|^gpt|openai|o1-|o3\\b|o4|4o-mini|\\b4o\\b|davinci|text-davinci/i.test(m)) return false;
   }
   if (p === 'codex' && /claude-/i.test(m) && !/via claude/i.test(m)) return false;
   return true;
@@ -11380,7 +11634,7 @@ function sessionDisplayTitle(payload) {
     return m && m.role === 'user';
   });
   const fullContent = firstUser && firstUser.content != null ? String(firstUser.content) : '';
-  const collapsed = fullContent.replace(/\s+/g, ' ').trim();
+  const collapsed = fullContent.replace(/\\s+/g, ' ').trim();
   const snippet = collapsed.slice(0, 76);
   const junkTitle = !raw || looksLikeModelListTitle(raw);
   if (!junkTitle) return raw;
@@ -11593,6 +11847,7 @@ function clearLoadingSessionTimer() {
 
 function paintLoadingSession(id) {
   renderMessagesSerial += 1;
+  hideSessionOutline();
   document.querySelector('.conversation').classList.remove('empty');
   currentSessionPayload = null;
   sessionTitle.textContent = 'Loading session...';
@@ -11613,6 +11868,7 @@ function paintLoadingSession(id) {
     'Session info — copy IDs, paths, and dates for agentlog recall or pasting into another agent.'
   );
   jumpEnd.hidden = true;
+  hideSessionOutline();
 }
 
 function setEmptySession(message) {
@@ -11637,6 +11893,7 @@ function setEmptySession(message) {
     'Session info — copy IDs, paths, and dates for agentlog recall or pasting into another agent.'
   );
   jumpEnd.hidden = true;
+  hideSessionOutline();
 }
 
 function resetSessionHeaderChips() {
@@ -11902,6 +12159,7 @@ function memorySourceLabel(value) {
 
 function renderMessages(messages, sessionSummary) {
   const renderSerial = ++renderMessagesSerial;
+  hideSessionOutline();
   readableView.className = '';
   readableView.innerHTML = '';
   const summaryText = sessionSummaryText(sessionSummary);
@@ -11949,6 +12207,7 @@ function renderMessages(messages, sessionSummary) {
     button: showButton ? earlierButton : null,
     anchor: null
   };
+  rebuildSessionOutline();
   let previousTimestamp = '';
   let previousModel = '';
   let index = windowStart;
@@ -11967,6 +12226,7 @@ function renderMessages(messages, sessionSummary) {
         previousModel = itemModel;
       }
       const node = messageElement(message, item);
+      item._domNode = node;
       if (windowedRenderState && windowedRenderState.serial === renderSerial && !windowedRenderState.anchor) {
         windowedRenderState.anchor = node;
       }
@@ -11982,7 +12242,9 @@ function renderMessages(messages, sessionSummary) {
     if (activeSearchTerm) highlightSearchMatches(readableView, activeSearchTerm);
     if (typeof updateJumpEndVisibility === 'function') {
       scheduleNext(() => {
-        if (renderSerial === renderMessagesSerial) updateJumpEndVisibility();
+        if (renderSerial !== renderMessagesSerial) return;
+        updateJumpEndVisibility();
+        updateSessionOutlineActive();
       });
     }
   };
@@ -12048,6 +12310,7 @@ function prependRenderItemsToView(renderItems) {
     const gap = renderTimeGap(previousTimestamp, message.timestamp);
     if (gap) fragment.appendChild(gap);
     const node = messageElement(message, item);
+    item._domNode = node;
     if (!firstNode) firstNode = gap || node;
     fragment.appendChild(node);
     previousTimestamp = item.lastTimestamp || message.timestamp || previousTimestamp;
@@ -12079,6 +12342,139 @@ function loadEarlierInMemory() {
   else removeEarlierButton(state);
 }
 
+// Conversation outline: a rail of tick marks (one per user message) on the
+// right edge of the transcript. Hover expands it into a jump list; click
+// scrolls to the message, revealing earlier windowed batches when needed.
+const sessionOutlineEl = document.getElementById('sessionOutline');
+const sessionOutlineTicksEl = document.getElementById('sessionOutlineTicks');
+const sessionOutlinePanelEl = document.getElementById('sessionOutlinePanel');
+const SESSION_OUTLINE_MAX_TICKS = 28;
+let sessionOutlineEntries = [];
+let sessionOutlineTicks = [];
+let sessionOutlineScrollPending = false;
+
+function hideSessionOutline() {
+  sessionOutlineEntries = [];
+  sessionOutlineTicks = [];
+  if (sessionOutlineTicksEl) sessionOutlineTicksEl.innerHTML = '';
+  if (sessionOutlinePanelEl) sessionOutlinePanelEl.innerHTML = '';
+  if (sessionOutlineEl) sessionOutlineEl.hidden = true;
+}
+
+function sessionOutlineLabel(message) {
+  const collapsed = String(message.content || '').replace(/<[^>]+>/g, ' ').replace(/\\s+/g, ' ').trim();
+  if (collapsed) return collapsed.length > 160 ? collapsed.slice(0, 159) + '\u2026' : collapsed;
+  const attachments = Array.isArray(message.attachments) ? message.attachments.length : 0;
+  return attachments ? '(attachment)' : '(empty message)';
+}
+
+function rebuildSessionOutline() {
+  if (!sessionOutlineEl || !sessionOutlineTicksEl || !sessionOutlinePanelEl) return;
+  const state = windowedRenderState;
+  const entries = [];
+  if (state && state.serial === renderMessagesSerial) {
+    for (const item of state.items) {
+      if (item.type && item.type !== 'message') continue;
+      const message = item.message;
+      if (!message || String(message.role || '').toLowerCase() !== 'user') continue;
+      if (message.metadata && message.metadata._inlineThinkingOnly) continue;
+      if (message.metadata && message.metadata.summaryKind === 'conversation_summary') continue;
+      if (generatedContextForMessage(message)) continue;
+      entries.push({ item, label: sessionOutlineLabel(message), button: null });
+    }
+  }
+  sessionOutlineEntries = entries;
+  if (entries.length < 2 || viewMode !== 'readable') {
+    sessionOutlineEl.hidden = true;
+    return;
+  }
+  sessionOutlineEl.hidden = false;
+  const win = currentSessionPayload && currentSessionPayload.transcript_window;
+  sessionOutlinePanelEl.innerHTML = win && win.has_more_before
+    ? '<div class="session-outline-note">Earlier messages are not loaded yet.</div>'
+    : '';
+  for (const entry of entries) {
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.className = 'session-outline-item';
+    button.setAttribute('role', 'menuitem');
+    button.textContent = entry.label;
+    button.title = entry.label;
+    button.onclick = function () { jumpToOutlineEntry(entry); };
+    entry.button = button;
+    sessionOutlinePanelEl.appendChild(button);
+  }
+  sessionOutlineTicksEl.innerHTML = '';
+  sessionOutlineTicks = [];
+  const tickCount = Math.min(entries.length, SESSION_OUTLINE_MAX_TICKS);
+  for (let t = 0; t < tickCount; t += 1) {
+    const entryIndex = Math.round((t * (entries.length - 1)) / (tickCount - 1));
+    const tick = document.createElement('div');
+    tick.className = 'session-outline-tick';
+    sessionOutlineTicksEl.appendChild(tick);
+    sessionOutlineTicks.push({ tick, entryIndex });
+  }
+  updateSessionOutlineActive();
+}
+
+function jumpToOutlineEntry(entry) {
+  const state = windowedRenderState;
+  if (!state || state.serial !== renderMessagesSerial) return;
+  const targetIndex = state.items.indexOf(entry.item);
+  if (targetIndex < 0) return;
+  // Reveal buffered batches until the target message has a DOM node.
+  let guard = 0;
+  while (state.windowStart > targetIndex && state.windowStart > 0 && guard < 500) {
+    loadEarlierInMemory();
+    guard += 1;
+  }
+  const node = entry.item._domNode;
+  if (node && node.isConnected) {
+    node.scrollIntoView({ block: 'start' });
+    if (detailScrollEl) detailScrollEl.scrollTop -= 12;
+    updateSessionOutlineActive();
+  }
+}
+
+function updateSessionOutlineActive() {
+  if (!sessionOutlineEl || sessionOutlineEl.hidden || !detailScrollEl) return;
+  if (sessionOutlineScrollPending) return;
+  sessionOutlineScrollPending = true;
+  requestAnimationFrame(function () {
+    sessionOutlineScrollPending = false;
+    if (!sessionOutlineEntries.length || sessionOutlineEl.hidden) return;
+    const threshold = detailScrollEl.getBoundingClientRect().top + detailScrollEl.clientHeight * 0.4;
+    let activeIndex = -1;
+    let firstRendered = -1;
+    for (let i = 0; i < sessionOutlineEntries.length; i += 1) {
+      const node = sessionOutlineEntries[i].item._domNode;
+      if (!node || !node.isConnected) continue;
+      if (firstRendered < 0) firstRendered = i;
+      if (node.getBoundingClientRect().top <= threshold) activeIndex = i;
+      else if (activeIndex >= 0) break;
+    }
+    if (activeIndex < 0) activeIndex = firstRendered;
+    sessionOutlineEntries.forEach(function (entry, i) {
+      if (entry.button) entry.button.classList.toggle('active', i === activeIndex);
+    });
+    let activeTick = -1;
+    for (let t = 0; t < sessionOutlineTicks.length; t += 1) {
+      if (sessionOutlineTicks[t].entryIndex <= activeIndex) activeTick = t;
+      else break;
+    }
+    sessionOutlineTicks.forEach(function (tickEntry, t) {
+      tickEntry.tick.classList.toggle('active', t === activeTick);
+    });
+  });
+}
+
+if (sessionOutlineEl) {
+  sessionOutlineEl.addEventListener('mouseenter', function () {
+    const active = sessionOutlinePanelEl && sessionOutlinePanelEl.querySelector('.session-outline-item.active');
+    if (active) active.scrollIntoView({ block: 'nearest' });
+  });
+}
+
 // Fetch the previous server page and append it to the in-memory buffer WITHOUT
 // painting all of it. We then reveal a single batch so a click that crosses a
 // page boundary stays as snappy as an in-memory reveal.
@@ -12127,6 +12523,7 @@ async function loadEarlierServerWindow() {
   if (grew) {
     // Reveal a single batch from the freshly-grown buffer (re-labels the button).
     loadEarlierInMemory();
+    rebuildSessionOutline();
   } else if (state.button) {
     // Fetch failed or bailed: restore a clickable button so the user can retry.
     const cur = currentSessionPayload && currentSessionPayload.transcript_window;
@@ -12348,7 +12745,7 @@ function toolResultDisplayScore(result) {
   if (rawCategory === 'function_call_output' || rawCategory === 'custom_tool_call_output') score -= 1000;
   if (category && category !== 'function') score += 250;
   if (kind && !kind.startsWith('call_')) score += 150;
-  if (/^\$\s/.test(String(result?.detail || result?.output || ''))) score += 250;
+  if (/^\\$\\s/.test(String(result?.detail || result?.output || ''))) score += 250;
   score += Math.min(200, String(result?.output || '').length / 200);
   return score;
 }
@@ -13003,7 +13400,7 @@ function legacyContextKind(provider, content) {
   const first = firstLine(content);
   if (provider === 'codex') {
     if (root === 'environment_context') return 'environment';
-    if (/^# AGENTS\.md instructions for\b/.test(first)) return 'project_instructions';
+    if (/^# AGENTS\\.md instructions for\\b/.test(first)) return 'project_instructions';
     if (/^# Files mentioned by the user:/.test(first)) return 'attachment_context';
     if (root === 'subagent_notification') return 'task_notification';
     if (root === 'turn_aborted') return 'turn_aborted';
@@ -13117,7 +13514,7 @@ function rootXmlTag(text) {
   const end = value.indexOf('>');
   if (end < 2) return '';
   const head = value.slice(1, end).trim();
-  const tag = head.split(/\s+/)[0] || '';
+  const tag = head.split(/\\s+/)[0] || '';
   return /^[A-Za-z][A-Za-z0-9_-]*$/.test(tag) ? tag : '';
 }
 
@@ -13861,7 +14258,7 @@ function toolSubjectFallback(card) {
 
 function compactPathLabel(value) {
   const text = String(value || '').trim();
-  if (!text || /\s/.test(text) || !text.includes('/')) return text;
+  if (!text || /\\s/.test(text) || !text.includes('/')) return text;
   return text.split('/').filter(Boolean).pop() || text;
 }
 
@@ -14799,6 +15196,7 @@ function setView(mode, options) {
   markdownButton.setAttribute('aria-pressed', markdown ? 'true' : 'false');
   readableView.style.display = markdown ? 'none' : 'block';
   markdownView.style.display = markdown ? 'block' : 'none';
+  if (sessionOutlineEl) sessionOutlineEl.hidden = markdown || sessionOutlineEntries.length < 2;
   const markdownLoad = markdown
     ? ensureMarkdownLoaded().catch((error) => {
       markdownView.textContent = error.message || 'Markdown could not be loaded.';
@@ -15664,7 +16062,7 @@ async function saveMemoryEdit(id) {
 }
 
 async function loadStats(options = {}) {
-  const elements = ['statsUsageWindow', 'chartTokensByProvider', 'chartTokensByCompany', 'chartTokensByModel', 'chartSpendPerDay', 'chartSpendPerMonth', 'chartSpendByProvider', 'chartSpendByModel', 'chartOutputTokenWork', 'chartMeaningfulRatios', 'chartSessionTimePerMonth', 'chartTopTools', 'chartToolCategories', 'chartTopSkills', 'chartMcpServers', 'statsProviderInsights', 'chartTokenSharePerDay', 'chartTokensPerDay', 'chartSessionsPerDay', 'chartTokensPerRepo', 'chartSessionsPerRepo', 'statsAgentHeatmap', 'statsChatHeatmap', 'statsSdkHeatmap'].map((id) => document.getElementById(id));
+  const elements = ['statsUsageWindow', 'chartTokensByProvider', 'chartTokensByCompany', 'chartTokensByModel', 'chartSpendPerDay', 'chartSpendPerMonth', 'chartSpendByProvider', 'chartSpendByModel', 'chartOutputTokenWork', 'chartMeaningfulRatios', 'chartSessionTimePerMonth', 'chartTopTools', 'chartToolCategories', 'chartTopSkills', 'chartMcpServers', 'statsProviderInsights', 'chartTokenSharePerDay', 'chartMonthlyMomentum', 'chartTokensPerDay', 'chartSessionsPerDay', 'chartTokensPerRepo', 'chartSessionsPerRepo', 'statsAgentHeatmap', 'statsChatHeatmap', 'statsSdkHeatmap'].map((id) => document.getElementById(id));
   const query = statsParams();
   const paramsKey = query.toString();
   const hasCachedPayload = Boolean(globalStatsPayload && lastStatsParamsKey === paramsKey);
@@ -16064,7 +16462,7 @@ function emptyProjectStatsPayload() {
 }
 
 async function loadProjectStats() {
-  const elements = ['statsUsageWindow', 'chartTokensByProvider', 'chartTokensByCompany', 'chartTokensByModel', 'chartSpendPerDay', 'chartSpendPerMonth', 'chartSpendByProvider', 'chartSpendByModel', 'chartOutputTokenWork', 'chartMeaningfulRatios', 'chartSessionTimePerMonth', 'chartTopTools', 'chartToolCategories', 'chartTopSkills', 'chartMcpServers', 'statsProviderInsights', 'chartTokenSharePerDay', 'chartTokensPerDay', 'chartSessionsPerDay', 'chartTokensPerRepo', 'chartSessionsPerRepo', 'statsAgentHeatmap', 'statsChatHeatmap', 'statsSdkHeatmap'].map((id) => document.getElementById(id));
+  const elements = ['statsUsageWindow', 'chartTokensByProvider', 'chartTokensByCompany', 'chartTokensByModel', 'chartSpendPerDay', 'chartSpendPerMonth', 'chartSpendByProvider', 'chartSpendByModel', 'chartOutputTokenWork', 'chartMeaningfulRatios', 'chartSessionTimePerMonth', 'chartTopTools', 'chartToolCategories', 'chartTopSkills', 'chartMcpServers', 'statsProviderInsights', 'chartTokenSharePerDay', 'chartMonthlyMomentum', 'chartTokensPerDay', 'chartSessionsPerDay', 'chartTokensPerRepo', 'chartSessionsPerRepo', 'statsAgentHeatmap', 'statsChatHeatmap', 'statsSdkHeatmap'].map((id) => document.getElementById(id));
   const clearLoading = scheduleStatsLoading(elements, 'Loading\u2026');
   if (projectStatsControls) projectStatsControls.hidden = false;
   const metaLoadingTimer = window.setTimeout(() => {
@@ -16310,12 +16708,6 @@ function addStatsTotals(target, entry) {
   target.user_messages += Number(entry.user_messages || 0);
 }
 
-function statsBreakdownEntry(group, totals) {
-  if (statsBreakdownMode === 'model') return { model: group, ...totals };
-  if (statsBreakdownMode === 'company') return { company: group, ...totals };
-  return { provider: group, ...totals };
-}
-
 function statsDateInChartRange(date) {
   const start = statsChartStartYm + '-01';
   const end = chartRangeEndIso(statsChartEndYm);
@@ -16331,21 +16723,23 @@ function statsBreakdownSort(a, b) {
     || String(statsBreakdownGroupId(a)).localeCompare(String(statsBreakdownGroupId(b)));
 }
 
-function statsBreakdownRangeTotals(payload) {
-  const groupKey = statsBreakdownGroupKey();
+function statsRangeTotalsForKey(payload, bucketKey, idKey) {
   const totals = new Map();
   const daily = Array.isArray(payload?.daily) ? payload.daily : [];
   for (const day of daily) {
     if (!statsDateInChartRange(day?.date)) continue;
-    const buckets = day[groupKey] || {};
+    const buckets = day[bucketKey] || {};
     for (const [group, entry] of Object.entries(buckets)) {
       if (!totals.has(group)) totals.set(group, emptyStatsTotals());
       addStatsTotals(totals.get(group), entry);
     }
   }
-  return Array.from(totals.entries())
-    .map(([group, totalsEntry]) => statsBreakdownEntry(group, totalsEntry))
-    .sort(statsBreakdownSort);
+  return Array.from(totals.entries()).map(([group, totalsEntry]) => ({ [idKey]: group, ...totalsEntry }));
+}
+
+function statsBreakdownRangeTotals(payload) {
+  const idKey = statsBreakdownMode === 'model' ? 'model' : statsBreakdownMode === 'company' ? 'company' : 'provider';
+  return statsRangeTotalsForKey(payload, statsBreakdownGroupKey(), idKey).sort(statsBreakdownSort);
 }
 
 function statsBreakdownGroupsList(payload, totalsOverride) {
@@ -16415,15 +16809,18 @@ function renderStatsDailyCharts() {
   const densified = densifyDailyInMonthRange(lastStatsPayload.daily || [], statsChartStartYm, statsChartEndYm, statsBreakdownGroupKey());
   if (!densified.length || !groups.length) {
     const emptyShare = document.getElementById('chartTokenSharePerDay');
+    const emptyMomentum = document.getElementById('chartMonthlyMomentum');
     const empty = document.getElementById('chartTokensPerDay');
     const empty2 = document.getElementById('chartSessionsPerDay');
     if (emptyShare) { emptyShare.classList.add('stats-empty'); emptyShare.textContent = 'No token share in this range.'; }
+    if (emptyMomentum) { emptyMomentum.classList.add('stats-empty'); emptyMomentum.textContent = 'No monthly momentum in this range.'; }
     if (empty) { empty.classList.add('stats-empty'); empty.textContent = 'No days in this range.'; }
     if (empty2) { empty2.classList.add('stats-empty'); empty2.textContent = 'No days in this range.'; }
     return;
   }
   const canonicalGroups = statsCanonicalOrderedGroups(groups);
   renderDailyShareChart('chartTokenSharePerDay', densified, canonicalGroups, usageMetric);
+  renderMonthlyMomentumChart('chartMonthlyMomentum', lastStatsPayload.daily || [], groups, usageMetric);
   renderDailyChart('chartTokensPerDay', densified, canonicalGroups, usageMetric, 336);
   renderDailyChart('chartSessionsPerDay', densified, canonicalGroups, activityMetric, 336);
 }
@@ -16445,6 +16842,8 @@ function renderStats(payload) {
   const groups = statsBreakdownGroupsList(payload, breakdownTotals);
   renderStatsLegend(groups, breakdownTotals);
   renderStatsDailyCharts();
+  const foldersSub = document.getElementById('statsFoldersSub');
+  if (foldersSub) foldersSub.textContent = 'Top folders by the selected breakdown above · ' + statsChartRangeLabel();
   const repoRows = statsRepoRowsForRange(payload);
   const canonicalGroupsForRepo = statsCanonicalOrderedGroups(groups);
   renderRepoChart('chartTokensPerRepo', repoRows, canonicalGroupsForRepo, statsTokenMetric());
@@ -16494,20 +16893,20 @@ function isoDayOffset(day, deltaDays) {
 function renderStatsMixCharts(payload) {
   const sub = document.getElementById('statsMixSub');
   const metric = statsTokenMetric();
-  if (sub) sub.textContent = statsTokenMixLabel(metric);
-  renderDonutChart('chartTokensByProvider', payload?.byProvider || [], {
+  if (sub) sub.textContent = statsTokenMixLabel(metric) + ' · ' + statsChartRangeLabel();
+  renderDonutChart('chartTokensByProvider', statsRangeTotalsForKey(payload, 'providers', 'provider'), {
     key: 'provider',
     metric,
     label: providerLabel,
     color: providerColor
   });
-  renderDonutChart('chartTokensByCompany', payload?.byCompany || [], {
+  renderDonutChart('chartTokensByCompany', statsRangeTotalsForKey(payload, 'companies', 'company'), {
     key: 'company',
     metric,
     label: companyLabel,
     color: companyColor
   });
-  renderDonutChart('chartTokensByModel', payload?.byModelBreakdown || payload?.byModel || [], {
+  renderDonutChart('chartTokensByModel', statsRangeTotalsForKey(payload, 'models', 'model'), {
     key: 'model',
     metric,
     label: modelLabel,
@@ -16517,15 +16916,16 @@ function renderStatsMixCharts(payload) {
 
 function renderStatsSpendCharts(payload) {
   const sub = document.getElementById('statsSpendSub');
-  const spend = Number(payload?.spend_usd || 0);
-  const pricedTokens = Number(payload?.spend_priced_tokens || 0);
-  const unpricedTokens = Number(payload?.spend_unpriced_tokens || 0);
+  const providerRows = statsRangeTotalsForKey(payload, 'providers', 'provider');
+  const spend = providerRows.reduce((sum, row) => sum + Number(row.spend_usd || 0), 0);
+  const pricedTokens = providerRows.reduce((sum, row) => sum + Number(row.spend_priced_tokens || 0), 0);
+  const unpricedTokens = providerRows.reduce((sum, row) => sum + Number(row.spend_unpriced_tokens || 0), 0);
   const coverageTotal = pricedTokens + unpricedTokens;
   const coverage = coverageTotal ? Math.round((pricedTokens / coverageTotal) * 100) : 0;
   if (sub) {
     sub.textContent = spend
-      ? formatUsd(spend) + ' estimated · ' + coverage + '% token coverage'
-      : 'No priced model/token splits yet.';
+      ? formatUsd(spend) + ' estimated · ' + coverage + '% token coverage · ' + statsChartRangeLabel()
+      : 'No priced model/token splits in this range.';
   }
   renderStatsDailySpendChart('chartSpendPerDay', payload);
   renderMonthlyStackedChart('chartSpendPerMonth', payload, 'providers', 'spend_usd', {
@@ -16534,7 +16934,7 @@ function renderStatsSpendCharts(payload) {
     groupColor: providerColor,
     emptyText: 'No priced spend in this range.'
   });
-  renderDonutChart('chartSpendByProvider', payload?.byProvider || [], {
+  renderDonutChart('chartSpendByProvider', providerRows, {
     key: 'provider',
     metric: 'spend_usd',
     label: providerLabel,
@@ -16542,7 +16942,7 @@ function renderStatsSpendCharts(payload) {
     formatValue: formatUsd,
     unitLabel: 'est.'
   });
-  renderDonutChart('chartSpendByModel', payload?.byModelBreakdown || payload?.byModel || [], {
+  renderDonutChart('chartSpendByModel', statsRangeTotalsForKey(payload, 'models', 'model'), {
     key: 'model',
     metric: 'spend_usd',
     label: modelLabel,
@@ -16555,12 +16955,17 @@ function renderStatsSpendCharts(payload) {
 function renderStatsDailySpendChart(elementId, payload) {
   const el = document.getElementById(elementId);
   if (!el) return;
-  const activity = (Array.isArray(payload?.daily_activity) ? payload.daily_activity : []).filter((row) => row && row.date);
-  const empty = () => { el.classList.add('stats-empty'); el.textContent = 'No priced spend yet.'; };
-  if (!activity.length) { empty(); return; }
-  const byDate = new Map(activity.map((row) => [row.date, Number(row.spend_usd || 0)]));
-  const startDate = activity[0].date;
-  const endDate = activity[activity.length - 1].date;
+  const empty = () => { el.classList.add('stats-empty'); el.textContent = 'No priced spend in this range.'; };
+  const byDate = new Map();
+  for (const row of Array.isArray(payload?.daily) ? payload.daily : []) {
+    if (!row || !statsDateInChartRange(row.date)) continue;
+    const spend = Object.values(row.providers || {}).reduce((sum, entry) => sum + Number(entry?.spend_usd || 0), 0);
+    if (spend > 0) byDate.set(row.date, spend);
+  }
+  if (!byDate.size) { empty(); return; }
+  const dates = Array.from(byDate.keys()).sort();
+  const startDate = dates[0];
+  const endDate = dates[dates.length - 1];
   const rows = [];
   let cursor = startDate;
   let guard = 0;
@@ -16623,8 +17028,8 @@ function renderStatsOutputWorkCharts(payload) {
   if (sub) {
     const coverage = totals.total ? Math.round((totals.known / totals.total) * 100) : 0;
     sub.textContent = totals.total
-      ? formatCompactNumber(totals.total) + ' output tokens classified · ' + coverage + '% known'
-      : 'No output job-mix metadata yet.';
+      ? formatCompactNumber(totals.total) + ' output tokens classified · ' + coverage + '% known · ' + statsChartRangeLabel()
+      : 'No output job-mix metadata in this range.';
   }
   renderOutputWorkChart('chartOutputTokenWork', payload);
   renderMeaningfulRatios('chartMeaningfulRatios', payload);
@@ -16782,8 +17187,10 @@ function renderStatsWorkCharts(payload) {
     const parts = [];
     if (totalDuration) parts.push(formatDurationMs(totalDuration) + ' session time');
     if (toolCalls) parts.push(formatFullNumber(toolCalls) + ' tool calls');
-    sub.textContent = parts.join(', ') || 'No session time or tool calls yet.';
+    sub.textContent = parts.length ? parts.join(', ') + ' · all time' : 'No session time or tool calls yet.';
   }
+  const sessionTimeMeta = document.getElementById('chartSessionTimePerMonthMeta');
+  if (sessionTimeMeta) sessionTimeMeta.textContent = statsChartRangeLabel();
   renderMonthlySingleMetricChart('chartSessionTimePerMonth', payload?.daily_activity || [], 'session_duration_ms', {
     valueLabel: formatDurationMs,
     emptyText: 'No session time in this range.',
@@ -16823,7 +17230,7 @@ function renderProviderInsights(payload) {
   const rows = (Array.isArray(payload?.byProviderInsights) ? payload.byProviderInsights : [])
     .filter((row) => Number(row.conversations || 0) + Number(row.subagent_runs || 0) > 0);
   const sub = document.getElementById('statsProviderInsightsSub');
-  if (sub) sub.textContent = rows.length ? 'Highlights across ' + rows.length + ' provider' + (rows.length === 1 ? '' : 's') + '.' : 'Per-provider highlights.';
+  if (sub) sub.textContent = rows.length ? 'Highlights across ' + rows.length + ' provider' + (rows.length === 1 ? '' : 's') + ' · all time.' : 'Per-provider highlights · all time.';
   if (!rows.length) {
     el.classList.add('stats-empty');
     el.textContent = 'No provider activity yet.';
@@ -17306,12 +17713,16 @@ function syncStatsBreakdownLabels() {
   const title = document.getElementById('statsBreakdownTitle');
   const shareTitle = document.getElementById('chartTokenSharePerDayTitle');
   const shareMeta = document.getElementById('chartTokenSharePerDayMeta');
+  const momentumTitle = document.getElementById('chartMonthlyMomentumTitle');
+  const momentumMeta = document.getElementById('chartMonthlyMomentumMeta');
   const providerBtn = document.getElementById('statsBreakdownProviderToggle');
   const companyBtn = document.getElementById('statsBreakdownCompanyToggle');
   const modelBtn = document.getElementById('statsBreakdownModelToggle');
   if (title) title.textContent = isModel ? 'Model breakdown' : isCompany ? 'Company breakdown' : 'Provider breakdown';
   if (shareTitle) shareTitle.textContent = isModel ? 'Daily token share by model' : isCompany ? 'Daily token share by company' : 'Daily token share by provider';
   if (shareMeta) shareMeta.textContent = statsTokenMixLabel(statsTokenMetric());
+  if (momentumTitle) momentumTitle.textContent = isModel ? 'Monthly momentum by model' : isCompany ? 'Monthly momentum by company' : 'Monthly momentum by provider';
+  if (momentumMeta) momentumMeta.textContent = statsTokenMixLabel(statsTokenMetric()) + ' \u00b7 % change vs prior month';
   if (providerBtn) {
     const active = !isModel && !isCompany;
     providerBtn.classList.toggle('active', active);
@@ -18110,7 +18521,7 @@ function renderDailyShareChart(elementId, daily, groups, metric) {
     return;
   }
   el.classList.remove('stats-empty');
-  const width = 760;
+  const width = 600;
   const height = 232;
   const padding = { top: 16, right: 18, bottom: 36, left: 54 };
   const innerW = width - padding.left - padding.right;
@@ -18215,6 +18626,170 @@ function formatStatsIsoDayTick(iso) {
   return monthAbbrev(month) + ' ' + String(day).padStart(2, '0');
 }
 
+function statsPrevYearMonth(ym) {
+  const y = Number(String(ym).slice(0, 4));
+  const m = Number(String(ym).slice(5, 7));
+  if (!Number.isFinite(y) || !Number.isFinite(m)) return '';
+  const d = new Date(y, m - 2, 1);
+  return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0');
+}
+
+function statsMonthlyGroupTotals(dailySparse, metric) {
+  const groupKey = statsBreakdownGroupKey();
+  const months = new Map();
+  for (const row of Array.isArray(dailySparse) ? dailySparse : []) {
+    const ym = String(row?.date || '').slice(0, 7);
+    if (ym.length !== 7) continue;
+    let bucket = months.get(ym);
+    if (!bucket) { bucket = { total: 0, groups: new Map() }; months.set(ym, bucket); }
+    for (const [group, entry] of Object.entries(row[groupKey] || {})) {
+      const value = statsMetricValue(entry, metric);
+      if (value <= 0) continue;
+      bucket.total += value;
+      bucket.groups.set(group, (bucket.groups.get(group) || 0) + value);
+    }
+  }
+  return months;
+}
+
+function formatMomentumPercent(pct) {
+  if (pct == null) return 'new';
+  const rounded = Math.abs(pct) >= 10 ? Math.round(pct) : Math.round(pct * 10) / 10;
+  return (rounded > 0 ? '+' : '') + formatFullNumber(rounded) + '%';
+}
+
+function renderMonthlyMomentumChart(elementId, dailySparse, usageSortedGroups, metric) {
+  const el = document.getElementById(elementId);
+  if (!el) return;
+  const months = statsMonthlyGroupTotals(dailySparse, metric);
+  const lineGroups = statsCanonicalOrderedGroups(usageSortedGroups.slice(0, 6));
+  const currentYm = isoDayLocal(new Date()).slice(0, 7);
+  const emptyBucket = { total: 0, groups: new Map() };
+  const rows = Array.from(months.keys())
+    .filter((ym) => ym >= statsChartStartYm && ym <= statsChartEndYm)
+    .sort()
+    .map((ym) => {
+      const cur = months.get(ym) || emptyBucket;
+      const prevBucket = months.get(statsPrevYearMonth(ym)) || emptyBucket;
+      const groupRows = lineGroups.map((group) => {
+        const value = cur.groups.get(group) || 0;
+        const prev = prevBucket.groups.get(group) || 0;
+        return { group, value, prev, pct: prev > 0 ? ((value - prev) / prev) * 100 : null };
+      });
+      const totalPct = prevBucket.total > 0 ? ((cur.total - prevBucket.total) / prevBucket.total) * 100 : null;
+      return { ym, partial: ym === currentYm, total: cur.total, prevTotal: prevBucket.total, totalPct, groups: groupRows };
+    })
+    .filter((row) => row.total > 0 || row.prevTotal > 0);
+  const hasPoint = rows.some((row) => row.groups.some((g) => g.pct != null));
+  if (!rows.length || !hasPoint) {
+    el.classList.add('stats-empty');
+    el.textContent = 'Not enough monthly history yet.';
+    return;
+  }
+  el.classList.remove('stats-empty');
+  const clampPct = (pct) => Math.max(-100, Math.min(300, pct));
+  let minV = 0;
+  let maxV = 0;
+  for (const row of rows) {
+    for (const g of row.groups) {
+      if (g.pct == null) continue;
+      const v = clampPct(g.pct);
+      if (v < minV) minV = v;
+      if (v > maxV) maxV = v;
+    }
+  }
+  if (maxV - minV < 20) { maxV += 10; minV -= 10; }
+  const span = maxV - minV;
+  const stepOptions = [5, 10, 20, 25, 50, 100, 150, 200];
+  const step = stepOptions.find((s) => span / s <= 5) || 200;
+  const tickMin = Math.floor(minV / step) * step;
+  const tickMax = Math.ceil(maxV / step) * step;
+  const ticks = [];
+  for (let v = tickMin; v <= tickMax; v += step) ticks.push(v);
+  const width = 600;
+  const height = 232;
+  const padding = { top: 14, right: 16, bottom: 36, left: 54 };
+  const innerW = width - padding.left - padding.right;
+  const innerH = height - padding.top - padding.bottom;
+  const xFor = (idx) => rows.length === 1
+    ? padding.left + innerW / 2
+    : padding.left + (idx / (rows.length - 1)) * innerW;
+  const yFor = (pct) => padding.top + innerH * (1 - (clampPct(pct) - tickMin) / (tickMax - tickMin || 1));
+  const yTicks = ticks.map((value) => {
+    const y = yFor(value);
+    const lineClass = value === 0 ? 'stats-momentum-zero' : 'stats-axis-line';
+    return '<line class="' + lineClass + '" x1="' + padding.left + '" x2="' + (padding.left + innerW) + '" y1="' + y.toFixed(2) + '" y2="' + y.toFixed(2) + '"/>'
+      + '<text class="stats-axis-label" x="' + (padding.left - 7) + '" y="' + (y + 3).toFixed(2) + '" text-anchor="end">' + esc((value > 0 ? '+' : '') + value + '%') + '</text>';
+  }).join('');
+  const axisTitle = '<text class="stats-axis-label" transform="rotate(-90 15 ' + (padding.top + innerH / 2).toFixed(2) + ')" x="15" y="' + (padding.top + innerH / 2).toFixed(2) + '" text-anchor="middle">MoM %</text>';
+  const shapes = [];
+  lineGroups.forEach((group, groupIdx) => {
+    const color = statsBreakdownColor(group);
+    for (let idx = 0; idx < rows.length; idx += 1) {
+      const point = rows[idx].groups[groupIdx];
+      if (point.pct == null) continue;
+      const x = xFor(idx);
+      const y = yFor(point.pct);
+      const prevPoint = idx > 0 ? rows[idx - 1].groups[groupIdx] : null;
+      if (prevPoint && prevPoint.pct != null) {
+        const fade = rows[idx].partial ? ' stroke-opacity="0.45"' : '';
+        shapes.push('<line class="stats-momentum-line" x1="' + xFor(idx - 1).toFixed(2) + '" y1="' + yFor(prevPoint.pct).toFixed(2) + '" x2="' + x.toFixed(2) + '" y2="' + y.toFixed(2) + '" stroke="' + esc(color) + '"' + fade + '/>');
+      }
+      const title = statsBreakdownLabel(group) + ' \u00b7 ' + formatStatsYearMonth(rows[idx].ym) + ' \u00b7 ' + formatMomentumPercent(point.pct);
+      shapes.push('<circle pointer-events="none" cx="' + x.toFixed(2) + '" cy="' + y.toFixed(2) + '" r="2.6" fill="' + esc(color) + '"><title>' + esc(title) + '</title></circle>');
+    }
+  });
+  const maxLabels = Math.max(2, Math.floor(innerW / 58));
+  const labelStep = Math.max(1, Math.ceil(rows.length / maxLabels));
+  const lastLabelIdx = rows.length - 1;
+  const xLabels = rows
+    .map((row, idx) => ((idx % labelStep === 0 && lastLabelIdx - idx >= Math.ceil(labelStep / 2)) || idx === lastLabelIdx)
+      ? '<text class="stats-axis-label" x="' + xFor(idx).toFixed(2) + '" y="' + (padding.top + innerH + 18) + '" text-anchor="middle">' + esc(formatChartMonthTick(row.ym + '-01')) + '</text>'
+      : '')
+    .join('');
+  const hits = rows.map((row, idx) => {
+    const prevX = idx === 0 ? padding.left : (xFor(idx - 1) + xFor(idx)) / 2;
+    const nextX = idx === rows.length - 1 ? padding.left + innerW : (xFor(idx) + xFor(idx + 1)) / 2;
+    return '<rect class="stats-momentum-hit" pointer-events="all" x="' + prevX.toFixed(2) + '" y="' + padding.top + '" width="' + Math.max(1, nextX - prevX).toFixed(2) + '" height="' + innerH.toFixed(2) + '" fill="transparent" data-month-index="' + idx + '"/>';
+  }).join('');
+  el.innerHTML = '<svg viewBox="0 0 ' + width + ' ' + height + '" preserveAspectRatio="xMidYMid meet" width="100%" height="100%" aria-label="Monthly momentum">' + yTicks + axisTitle + shapes.join('') + xLabels + hits + '</svg>';
+  el.__momentumRows = rows;
+  el.__momentumMetric = metric;
+  bindMomentumChartHover(el);
+}
+
+function formatMomentumTooltipHtml(row, metric) {
+  const head = formatStatsYearMonth(row.ym) + (row.partial ? ' \u00b7 month to date' : '');
+  const unit = statsMetricUnit(metric, row.total);
+  const totalPctText = row.prevTotal > 0 ? formatMomentumPercent(row.totalPct) : (row.total > 0 ? 'new' : '\u2014');
+  const detailLines = [];
+  for (const g of row.groups) {
+    if (g.value <= 0 && g.prev <= 0) continue;
+    const pctText = g.prev > 0 ? formatMomentumPercent(g.pct) : (g.value > 0 ? 'new' : '\u2014');
+    detailLines.push(esc(statsBreakdownLabel(g.group)) + ': ' + esc(pctText) + ' \u00b7 ' + esc(formatFullNumber(g.value)) + ' ' + esc(unit) + ' (prev ' + esc(formatFullNumber(g.prev)) + ')');
+  }
+  let html = '<strong>' + esc(head) + '</strong><br><strong>Total: ' + esc(totalPctText) + ' \u00b7 ' + esc(formatFullNumber(row.total)) + ' ' + esc(unit) + '</strong>';
+  if (detailLines.length) html += '<br><span class="stats-tip-muted">' + detailLines.join('<br>') + '</span>';
+  return html;
+}
+
+function bindMomentumChartHover(chartEl) {
+  if (!chartEl || chartEl.dataset.statsMomentumHover === '1') return;
+  chartEl.dataset.statsMomentumHover = '1';
+  chartEl.addEventListener('mousemove', function (e) {
+    const hit = e.target && e.target.closest && e.target.closest('.stats-momentum-hit');
+    if (!hit || !chartEl.contains(hit)) {
+      hideStatsTooltip();
+      return;
+    }
+    const idx = Number(hit.getAttribute('data-month-index'));
+    const rows = chartEl.__momentumRows;
+    if (!rows || !Number.isFinite(idx) || !rows[idx]) return;
+    showStatsTooltipHtml(formatMomentumTooltipHtml(rows[idx], chartEl.__momentumMetric), e.clientX, e.clientY);
+  });
+  chartEl.addEventListener('mouseleave', hideStatsTooltip);
+}
+
 function renderDailyChart(elementId, daily, providers, metric, height) {
   const el = document.getElementById(elementId);
   if (!el) return;
@@ -18685,6 +19260,7 @@ if (sessionHeaderEl && detailScrollEl) {
   detailScrollEl.addEventListener('scroll', () => {
     sessionHeaderEl.classList.toggle('scrolled', detailScrollEl.scrollTop > 0);
     updateJumpEndVisibility();
+    updateSessionOutlineActive();
   }, { passive: true });
 }
 setupKeyboardShortcuts();
@@ -18827,6 +19403,9 @@ Browse and recall:
 Runtime and maintenance:
   watcher <start|stop|status|logs>      manage the background watcher
   watcher login <enable|disable|status> manage login startup
+  notify slack setup                    guided Slack app creation + channel connect
+  notify slack <enable|disable|status|test>
+                                        post session summaries to a Slack channel
   mcp serve                             run the MCP recall server over stdio
   update [--since all]                  reimport from saved preferences after package updates
   repair claude-code-backups            explicitly restore repairable Claude Code raw backups
@@ -18943,6 +19522,52 @@ Details:
 `;
 
 const HELP_TOPICS = {
+  notify: `
+agentlog notify slack
+
+Post session summaries to a Slack channel. Off by default; posting publishes
+session content beyond this machine. Only redacted archive output is posted.
+
+Usage:
+  agentlog notify slack setup
+  agentlog notify slack enable [--summaries on|off] [--summary-channel C…] [--quiet-minutes 10]
+                               [--firehose on|off] [--firehose-channel C…] [--batch-seconds 45]
+                               [--token xoxb-…] [--repos github.com/org/repo,…]
+  agentlog notify slack disable
+  agentlog notify slack status
+  agentlog notify slack test [--dry-run]
+
+Setup:
+  \`setup\` is the guided path: it opens Slack's app creation page pre-filled
+  from a manifest (one personal app, chat:write only), verifies the pasted
+  bot token, connects channels, and sends test posts. \`enable\` is the
+  manual/scriptable path and also updates individual settings in place.
+
+Behavior:
+  Two independent surfaces, each with its own channel:
+  - Summaries post one recap per session after it goes quiet for
+    --quiet-minutes (default 10).
+  - The firehose mirrors the conversation into one thread per session: each
+    user and agent turn posts whole as its own message under its speaker's
+    identity (requires the chat:write.customize scope; without it, turns
+    post as the plain bot). Passes are batched every --batch-seconds
+    (default 45). Tool calls are skipped unless notify.slack.stream
+    .includeTools is true; the recap closes the thread out.
+  The bot token comes from notify.slack.botToken, AGENTLOG_SLACK_BOT_TOKEN,
+  or SLACK_BOT_TOKEN. An empty --repos list posts for all repos.
+
+Threads:
+  A session that goes quiet has its firehose thread closed (the recap is the
+  closer when summaries are on). Picking the session back up later opens a
+  fresh thread marked "(resumed)" that streams only the new turns.
+
+Offline:
+  Going offline pauses posting, never archiving. Failed posts keep their
+  place (cursors and summaries are not marked done) and retry about once a
+  minute, so everything drains on reconnect. One guard: a backlog larger
+  than 20 turns for one session posts only the most recent 20 plus a
+  skipped-count note instead of flooding the channel.
+`,
   help: `
 agentlog help