jeo-code 0.5.13 → 0.5.15

package/src/commands/update.ts

@@ -35,7 +35,9 @@ export function compareVersions(a: string, b: string): -1 | 0 | 1 {
 export interface UpdateDeps {
   fetchJson: (url: string, options?: { signal?: AbortSignal }) => Promise<any>;
   localVersion: () => string;
-  install: () => Promise<{ success: boolean; stdout?: string; stderr?: string }>;
+  install: (version?: string) => Promise<{ success: boolean; stdout?: string; stderr?: string }>;
+  /** Display release notes after a successful self-update (best-effort, no-op in tests). */
+  showWhatsNew?: () => void;
 }
 
 export const defaultDeps: UpdateDeps = {
@@ -56,13 +58,26 @@ export const defaultDeps: UpdateDeps = {
   localVersion: () => {
     return pkg.version;
   },
-  install: async () => {
-    const proc = Bun.spawnSync(["bun", "install", "-g", "jeo-code"], {
+  install: async (version?: string) => {
+    // Self-update the global install. jeo runs on Bun (see the `#!/usr/bin/env bun`
+    // shebang), so Bun is always present; `@<version>` (default `latest`) forces the
+    // newest publish even if a stale global is cached.
+    const target = `jeo-code@${version ?? "latest"}`;
+    const proc = Bun.spawnSync(["bun", "install", "-g", target], {
       stdout: "inherit",
       stderr: "inherit",
     });
     return { success: proc.success };
   }
+  ,
+  showWhatsNew: () => {
+    try {
+      // Spawn the freshly-installed binary so it reads the NEW bundled CHANGELOG.
+      Bun.spawnSync(["jeo", "whats-new"], { stdout: "inherit", stderr: "inherit" });
+    } catch {
+      // Notes are a courtesy; a spawn failure must never fail the update.
+    }
+  }
 };
 
 export async function runUpdateCommand(args: string[] = []): Promise<void> {
@@ -72,6 +87,7 @@ export async function runUpdateCommand(args: string[] = []): Promise<void> {
 export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Promise<void> {
   const isHelp = args.includes("--help") || args.includes("-h");
   const hasInstall = args.includes("--install");
+  const hasCheck = args.includes("--check");
   const hasJson = args.includes("--json");
   const hasStrict = args.includes("--strict");
 
@@ -143,8 +159,13 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
     }
   }
 
+  // Default action is INSTALL (bare `jeo update` upgrades). `--check` forces a
+  // check-only run; `--json` stays check-only too (programmatic status polling must
+  // not trigger an install) unless `--install` is given explicitly.
+  const shouldInstall = hasInstall || (!hasCheck && !hasJson);
+
   // We got the version successfully
-  if (hasInstall) {
+  if (shouldInstall) {
     if (upToDate) {
       if (hasJson) {
         console.log(JSON.stringify({
@@ -154,14 +175,14 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
           installed: false
         }));
       } else {
-        console.log(`jeo-code is up-to-date (${current}). Skipping installation.`);
+        console.log(`jeo-code is already up-to-date (${current}).`);
       }
     } else {
       if (!hasJson) {
         console.log(`Installing update: ${current} -> ${latest}...`);
       }
       try {
-        const result = await deps.install();
+        const result = await deps.install(latest ?? undefined);
         if (result.success) {
           if (hasJson) {
             console.log(JSON.stringify({
@@ -172,6 +193,7 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
             }));
           } else {
             console.log(`Successfully installed jeo-code@${latest}`);
+            deps.showWhatsNew?.();
           }
         } else {
           if (hasJson) {
@@ -224,7 +246,7 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
         }));
       } else {
         console.log(`Newer version available: ${latest} (current: ${current}).`);
-        console.log("Run 'bun install -g jeo-code' to upgrade.");
+        console.log("Run 'jeo update' to install it.");
       }
     }
   }
@@ -236,8 +258,9 @@ function printUsage() {
   console.log("Check for and install updates for jeo-code.");
   console.log("");
   console.log("Options:");
-  console.log("  --check      Check for updates (default)");
-  console.log("  --install    Check and install if newer");
+  console.log("  (default)    Check and install if a newer version is available");
+  console.log("  --check      Only check; do not install");
+  console.log("  --install    Force install if newer (also used with --json)");
   console.log("  --json       Output result in JSON format");
   console.log("  --strict     Exit with code 1 on network/registry errors");
   console.log("  -h, --help   Show this help message");

package/src/commands/whats-new.ts

@@ -4,6 +4,7 @@ import {
   parseChangelogSections,
   releaseSections,
   renderWhatsNew,
+  RECENT_RELEASE_COUNT,
 } from "../util/whats-new";
 import { supportsUnicode } from "../tui/components/capability";
 
@@ -30,7 +31,7 @@ export async function runWhatsNewCommand(args: string[] = []): Promise<void> {
 
   const md = await loadBundledChangelog();
   const all = md ? releaseSections(parseChangelogSections(md)) : [];
-  const sections = hasAll ? all : all.slice(0, 1);
+  const sections = hasAll ? all : all.slice(0, RECENT_RELEASE_COUNT);
 
   if (hasJson) {
     console.log(JSON.stringify({ version: pkg.version, entries: sections }, null, 2));
@@ -56,7 +57,7 @@ function printUsage(): void {
   console.log("Show the release notes bundled with the installed jeo-code version.");
   console.log("");
   console.log("Options:");
-  console.log("  --all        Show notes for every released version, not just the latest");
+  console.log(`  --all        Show notes for every released version, not just the recent ${RECENT_RELEASE_COUNT}`);
   console.log("  --json       Output the notes as JSON");
   console.log("  -h, --help   Show this help message");
 }

package/src/skills/catalog.ts

@@ -183,50 +183,20 @@ export function skillsPromptSection(skills: SkillDoc[] = SKILLS): string {
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import * as os from "node:os";
-import { existsSync, statSync, readFileSync } from "node:fs";
-import { jeoEnv } from "../util/env";
 
-export function tryResolveSkillFromFilePath(filePath: string): SkillDoc | null {
-  try {
-    let targetPath = path.resolve(filePath);
-    if (!existsSync(targetPath)) {
-      return null;
-    }
-    const stat = statSync(targetPath);
-    if (stat.isDirectory()) {
-      const skillMd = path.join(targetPath, "SKILL.md");
-      if (existsSync(skillMd) && statSync(skillMd).isFile()) {
-        targetPath = skillMd;
-      } else {
-        return null;
-      }
-    } else if (!stat.isFile() || !targetPath.endsWith(".md")) {
-      return null;
-    }
+import { jeoEnv } from "../util/env";
 
-    const content = readFileSync(targetPath, "utf-8");
-    // Determine a name for this skill
-    let skillName = path.basename(targetPath, ".md");
-    if (skillName.toLowerCase() === "skill" || skillName.toLowerCase() === "readme") {
-      // Use the directory name if the filename is generic
-      skillName = path.basename(path.dirname(targetPath));
-    }
-    const parsed = parseSkillMarkdown(skillName, content, { preferMetaName: true });
-    return isSupportedExternalSkill(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
 const BUILTIN_SLASH_ALIASES = new Set([
   "/help", "/clear", "/compact", "/model", "/fast", "/provider", "/logout",
   "/agents", "/config", "/roles", "/thinking",
-  "/view", "/diff", "/find", "/search", "/sessions", "/skill", "/evolve",
+  "/view", "/diff", "/find", "/search",
   "/exit", "/quit",
 ]);
 
-const RESERVED_SKILL_NAMES = new Set(
-  [...BUILTIN_SLASH_ALIASES].map(alias => alias.slice(1).toLowerCase())
-);
+const RESERVED_SKILL_NAMES = new Set([
+  ...[...BUILTIN_SLASH_ALIASES].map(alias => alias.slice(1).toLowerCase()),
+  "skill",
+]);
 
 function normalizeSlashAlias(raw: string): string | undefined {
   const m = raw.trim().match(/^\/[A-Za-z][A-Za-z0-9_-]*(?:\.[A-Za-z][A-Za-z0-9_-]*)*$/);
@@ -410,12 +380,33 @@ export function parseSkillMarkdown(name: string, content: string, opts?: { prefe
   };
 }
 
+const ALLOWED_SKILL_NAMES = new Set([
+  "deep-interview",
+  "deep-dive",
+  "ralplan",
+  "team",
+  "ultragoal",
+  "research",
+  "ultrawork"
+]);
+
 function isSupportedExternalSkill(doc: SkillDoc): boolean {
-  return !RESERVED_SKILL_NAMES.has(doc.name.toLowerCase());
+  const nameLower = doc.name.toLowerCase();
+  return !RESERVED_SKILL_NAMES.has(nameLower);
 }
 
 /** Bundled skills merged with user skill docs from {@link skillDirs} (user overrides by name). */
 export async function loadSkills(cwd: string = process.cwd()): Promise<SkillDoc[]> {
+  try {
+    const lockPath = path.join(cwd, "skills-lock.json");
+    const lockContent = await fs.readFile(lockPath, "utf-8");
+    const lockData = JSON.parse(lockContent);
+    if (lockData && lockData.skills) {
+      for (const name of Object.keys(lockData.skills)) {
+        ALLOWED_SKILL_NAMES.add(name.toLowerCase());
+      }
+    }
+  } catch {}
   const byName = new Map<string, SkillDoc>(SKILLS.map(s => [s.name.toLowerCase(), s]));
   for (const dir of skillDirs(cwd)) {
     let entries: import("node:fs").Dirent[] = [];
@@ -512,59 +503,24 @@ export interface SkillInvocation {
   intent: string;
   invokedAs?: string;
 }
-
-/** Parse only explicit skill invocations. Ambient mentions of skill names or slash
- * aliases inside a broader prompt are deliberately ignored so pasted SKILL.md files
- * cannot hijack an ordinary coding request. */
+/** Parse only an explicit `$skill` invocation. Skills are invokable ONLY via the `$`
+ * entrypoint — `/` commands and slash aliases never load a skill file, and pasted SKILL.md
+ * paths cannot hijack an ordinary coding request. Only the FIRST token counts, and only
+ * when a skill with that exact name (or unique name prefix) is loaded; `$HOME is what?` or
+ * any unknown `$word` falls through to the model as an ordinary prompt. */
 export function parseSkillInvocation(input: string, skills: SkillDoc[]): SkillInvocation | null {
   const trimmed = input.trim();
   if (!trimmed) return null;
 
-  const explicitEntrypoint = trimmed.startsWith("/skill:")
-    ? "/skill:"
-    : (trimmed === "/skill" || trimmed.startsWith("/skill ")) ? "/skill" : "";
-  if (explicitEntrypoint) {
-    const rest = trimmed.substring(explicitEntrypoint.length).trim();
-    if (!rest) return null;
-    const [name, ...intentParts] = rest.split(/\s+/);
-    let skill = getSkillFrom(skills, name ?? "");
-    if (!skill && name) {
-      skill = tryResolveSkillFromFilePath(name) ?? undefined;
-    }
-    return skill ? { skill, intent: intentParts.join(" ").trim() } : null;
-  }
-
   const command = trimmed.split(/\s+/, 1)[0] ?? "";
-  // Codex/gjc-style exact-name entrypoint: `$team [intent]` invokes the skill
-  // named "team" directly (case-insensitive). Only the FIRST token counts, and
-  // only when a skill with that exact name is loaded — `$HOME is what?` or any
-  // unknown `$word` falls through to the model as an ordinary prompt.
   if (command.length > 1 && command.startsWith("$")) {
     const dollarSkill = getSkillFrom(skills, command.slice(1)) ?? uniquePrefixSkill(skills, command.slice(1));
     if (dollarSkill) {
       return { skill: dollarSkill, intent: trimmed.slice(command.length).trim(), invokedAs: command };
     }
   }
-  let skill = getSkillBySlash(skills, command);
-  // `/team`, `/deep-interview`, `/ultragoal`, … — a bare slash + skill NAME (or unique
-  // prefix) is the SAME entrypoint as `$name` and `/skill:name`. Only when getSkillBySlash
-  // found no alias and the token is a plain `/word` (no nested `/path` and no `.` so
-  // `/speckit.plan` aliases and `./file` paths keep their own resolution). This is what
-  // makes the bundled workflows actually run from the `/` menu, not just `/ralplan`.
-  if (!skill && command.length > 1 && command.startsWith("/") && !command.includes(".") && command.indexOf("/", 1) === -1) {
-    skill = getSkillFrom(skills, command.slice(1)) ?? uniquePrefixSkill(skills, command.slice(1));
-  }
-  if (!skill) {
-    if (command.startsWith("/") || command.startsWith(".") || command.includes("/")) {
-      const resolved = tryResolveSkillFromFilePath(command);
-      if (resolved) {
-        return { skill: resolved, intent: trimmed.slice(command.length).trim(), invokedAs: command };
-      }
-    }
-  }
-  return skill ? { skill, intent: trimmed.slice(command.length).trim(), invokedAs: command } : null;
+  return null;
 }
-
 /** Parse a LEADING run of `$skill` tokens into an ordered chain that shares the trailing
  *  text as one intent: `$ralplan $team build auth` → [ralplan, team] each with intent
  *  "build auth". This is what lets `$` invoke several skills in one line — they all run,

package/src/tui/app.ts

@@ -25,8 +25,8 @@ import { SECTION_GAP, stackSections } from "./components/section";
 import { resolveTheme, themeGradient, accentPaint, accentShadowPaint, diffPaint, mutedPaint, cardFillPaint } from "./components/themes";
 import { detectColorLevel, animatedGradientText, ColorLevel } from "./components/color";
 import { formatForgeBox, summarizeForgeInvocation, summarizeForgeResult, fitForgeBoxes, webSearchCardLines, type ForgeSummary } from "./components/forge";
-import { renderJeoStatus, renderStatusBar, renderStatusBox } from "./components/status";
-import { costForUsage, formatCost } from "../ai/pricing";
+import { renderStatusBar, renderStatusBox, type StatusBoxData } from "./components/status";
+import { costForUsage } from "../ai/pricing";
 import { renderMarkdownTables } from "./components/markdown-table";
  
 import { stripMarkdown, renderMarkdownAnsi } from "./components/markdown-text";
@@ -35,7 +35,7 @@ import { categoryBadge } from "./components/category-index";
 import { formatStepTimeline, stepsFromTools, formatStepHeader, formatStepTimelineCompact, formatDuration as formatToolMs, type StepState } from "./components/step-timeline";
 import { formatHintBar } from "./components/hints";
 import { formatDuration, formatUsage } from "./components/duration";
-import { renderHud, derivePhase, type JeoPhase } from "./components/hud";
+import { renderHud, type JeoPhase } from "./components/hud";
 import { formatTodoWriteCard } from "./components/todo-card";
 import { renderInputBox } from "./components/input-box";
 import { jeoEnv } from "../util/env";
@@ -505,9 +505,11 @@ export class LaunchTui {
           if (!success) this.flushForgeCard(result, false);
         } else {
           // Light tool: one ✓/✗ line, plus a dim result tree for list-shaped output
-          // (find/search/ls) and an error card when the tool failed.
+          // (find/search/ls) and an error card when the tool failed. The ledger line
+          // stays a clean single line (no ms suffix) — light tools are sub-ms and the
+          // duration detail lives on the heavier forge cards instead.
           const { suffix, children } = this.ledgerTree(tool, success, output);
-          this.appendLedger(`${paintedMark} ${target}${suffix}${durSuffix}\n${children.map(c => `${c}\n`).join("")}`, "tool");
+          this.appendLedger(`${paintedMark} ${target}${suffix}\n${children.map(c => `${c}\n`).join("")}`, "tool");
           if (!success) {
             this.rememberForge(result);
             this.flushForgeCard(result, false);
@@ -1105,6 +1107,40 @@ export class LaunchTui {
       align: "left",
     });
   }
+
+  /** Build the live status-box data — the ~20-field payload shared by the inline and
+   *  the bottom-pinned (non-inline) frames so they can't drift (color, verify-yellow,
+   *  metrics, usage all defined once). Only `cols` differs between callers. */
+  private statusBoxData(args: { cols: number; elapsedMs: number; stepNow: number; phase: number; colorLevel: number; idx: number }): StatusBoxData {
+    const { cols, elapsedMs, stepNow, phase, colorLevel, idx } = args;
+    const grad = themeGradient(this.theme, idx);
+    const verifying = this.runningTool;
+    const stats = this.tools.stats();
+    return {
+      cols,
+      phaseLabel: this.workflowStatus ? `${this.workflowStatus.skill}:${this.workflowStatus.phase}` : this.hudPhase,
+      spinner: verifying && this.theme.color ? chalk.yellow(this.spinner.current()) : this.spinner.current(),
+      activity: this.retryNotice ?? (this.streamingActivity || this.currentActivity()),
+      escHint: true,
+      elapsedMs,
+      stepElapsedMs: this.currentStepStartedAt ? Date.now() - this.currentStepStartedAt : undefined,
+      avgStepMs: stepNow > 0 ? elapsedMs / stepNow : undefined,
+      okCount: stats.ok,
+      failCount: stats.fail,
+      runningCount: stats.running,
+      totalCount: stats.total,
+      mutationGuarded: this.mutationGuarded,
+      unicode: this.unicode,
+      color: this.theme.color,
+      colorLevel,
+      phase,
+      palette: verifying ? [...STATUS_VERIFY_PALETTE] : [grad.from, grad.to],
+      isThinking: true,
+      usage: this.turnUsage,
+      costUsd: costForUsage(this.footer.model, this.turnUsage) ?? undefined,
+      subagentActive: this.subagentActive,
+    };
+  }
   /**
    * The gjc-style inline live frame: a flat stack with no outer border —
    *   <live forge card(s)> · <spinner status line> · <todos> · <hud line> · <model bar>
@@ -1178,37 +1214,7 @@ export class LaunchTui {
     // streamed activity is uniform across providers via streamingActivity and keeps
     // the ⟦esc⟧ cancel hint visible without trapping the message inside a border.
     if (isThinking) {
-      const grad = themeGradient(this.theme, idx);
-      // While a tool/process runs (background verification), the status animation turns
-      // amber/yellow — distinct from the cool thinking gradient (gjc warning-color parity).
-      const verifying = this.runningTool;
-      const verifySpin = verifying && this.theme.color ? chalk.yellow(this.spinner.current()) : this.spinner.current();
-      const costUsd = costForUsage(this.footer.model, this.turnUsage) ?? undefined;
-      const stats = this.tools.stats();
-      tail.push(...renderStatusBox({
-        cols: Math.max(24, Math.min(120, cols)),
-        phaseLabel: this.workflowStatus ? `${this.workflowStatus.skill}:${this.workflowStatus.phase}` : this.hudPhase,
-        spinner: verifySpin,
-        activity: this.retryNotice ?? (this.streamingActivity || this.currentActivity()),
-        escHint: true,
-        elapsedMs,
-        stepElapsedMs: this.currentStepStartedAt ? Date.now() - this.currentStepStartedAt : undefined,
-        avgStepMs: stepNow > 0 ? elapsedMs / stepNow : undefined,
-        okCount: stats.ok,
-        failCount: stats.fail,
-        runningCount: stats.running,
-        totalCount: stats.total,
-        mutationGuarded: this.mutationGuarded,
-        unicode: this.unicode,
-        color: this.theme.color,
-        colorLevel,
-        phase,
-        palette: verifying ? [...STATUS_VERIFY_PALETTE] : [grad.from, grad.to],
-        isThinking: true,
-        usage: this.turnUsage,
-        costUsd,
-        subagentActive: this.subagentActive,
-      }));
+      tail.push(...renderStatusBox(this.statusBoxData({ cols: Math.max(24, Math.min(120, cols)), elapsedMs, stepNow, phase, colorLevel, idx })));
     }
 
 
@@ -1365,31 +1371,7 @@ export class LaunchTui {
         // Live status field: unboxed thinking line + compact metrics row. The
         // streamed activity is uniform across providers, with the ⟦esc⟧ cancel hint
         // right-aligned and no misleading step counter.
-        const stats = this.tools.stats();
-        for (const line of renderStatusBox({
-          cols: innerWidth,
-          phaseLabel: this.workflowStatus ? `${this.workflowStatus.skill}:${this.workflowStatus.phase}` : this.hudPhase,
-          spinner: this.runningTool && this.theme.color ? chalk.yellow(this.spinner.current()) : this.spinner.current(),
-          activity: this.retryNotice ?? (this.streamingActivity || statusMsg),
-          escHint: true,
-          elapsedMs,
-          stepElapsedMs: this.currentStepStartedAt ? Date.now() - this.currentStepStartedAt : undefined,
-          avgStepMs: stepNow > 0 ? elapsedMs / stepNow : undefined,
-          okCount: stats.ok,
-          failCount: stats.fail,
-          runningCount: stats.running,
-          totalCount: stats.total,
-          mutationGuarded: this.mutationGuarded,
-          unicode: this.unicode,
-          color: this.theme.color,
-          colorLevel,
-          phase,
-          palette: this.runningTool ? [...STATUS_VERIFY_PALETTE] : palette,
-          isThinking: true,
-          usage: this.turnUsage,
-          costUsd,
-          subagentActive: this.subagentActive,
-        })) bottom.push(line);
+        for (const line of renderStatusBox(this.statusBoxData({ cols: innerWidth, elapsedMs, stepNow, phase, colorLevel, idx }))) bottom.push(line);
       } else {
         // Compact fallback still keeps progress and insight separate: no decorative
         // mixed "thinking/status" line, and retry notices never become stream logs.

package/src/tui/components/autocomplete.ts

@@ -133,11 +133,6 @@ export function complete(line: string, ctx: CompletionContext): CompletionResult
   // Completing the command name itself (single token, still typing it).
   if (tokens.length <= 1 && !trailingSpace) {
     const token = tokens[0] ?? "/";
-    if (token.toLowerCase().startsWith("/skill:")) {
-      const prefix = token.slice("/skill:".length);
-      const names = ctx.skillNames ?? skillNames();
-      return { completions: dedupeCap(prefixHits(names.map(n => `/skill:${n}`), `/skill:${prefix}`)), token, kind: "command" };
-    }
     return { completions: dedupeCap(prefixHits(ctx.slashCommands, token)), token, kind: "command" };
   }
 
@@ -183,8 +178,7 @@ export function complete(line: string, ctx: CompletionContext): CompletionResult
       if (argIndex === 2 && (tokens[2]?.toLowerCase() === "maxsteps" || tokens[2]?.toLowerCase() === "steps")) return { completions: [], token, kind: "none" };
       return { completions: [], token, kind: "none" };
     }
-    case "/skill":
-      return argIndex === 0 ? finish(ctx.skillNames ?? skillNames(), "subcommand") : { completions: [], token, kind: "none" };
+
     case "/roles": {
       const tiers = ["smol", "slow", "plan"];
       if (argIndex === 0) return finish(tiers, "role");
@@ -194,7 +188,7 @@ export function complete(line: string, ctx: CompletionContext): CompletionResult
     case "/thinking":
       return argIndex === 0 ? finish(ctx.thinkingLevels, "thinking") : { completions: [], token, kind: "none" };
     case "/session":
-      return argIndex === 0 ? finish(["info", "delete"], "subcommand") : { completions: [], token, kind: "none" };
+      return argIndex === 0 ? finish(["list", "info", "new", "drop", "delete", "rename", "resume"], "subcommand") : { completions: [], token, kind: "none" };
     case "/theme":
       return argIndex === 0 ? finish(listThemes().map(t => t.name), "subcommand") : { completions: [], token, kind: "none" };
     case "/login":

package/src/tui/components/slash.ts

@@ -46,8 +46,7 @@ export const SLASH_COMMAND_DETAILS: readonly SlashCommandInfo[] = [
   { command: "/diff", usage: "/diff [file]", description: "Render `git diff` with +/- coloring", group: "code" },
   { command: "/find", usage: "/find <glob>", description: "List files matching a glob", group: "code" },
   { command: "/search", usage: "/search <pat> [glob]", description: "Search the repo for a pattern", group: "code" },
-  { command: "/skill", usage: "/skill [name [intent]]", description: "List, show, or run a workflow skill", group: "skills" },
-  { command: "/skill:", usage: "/skill:<name> [intent]", description: "Run a workflow skill by GJC-style entrypoint", group: "skills" },
+
   { command: "/sessions", usage: "/sessions", description: "List saved sessions", group: "session" },
   { command: "/usage", usage: "/usage", description: "Show cumulative token usage for this session", group: "system" },
   { command: "/context", usage: "/context", description: "Show context token usage breakdown", group: "system" },

package/src/util/whats-new.ts

@@ -27,6 +27,9 @@ export interface ChangelogSection {
   groups: ChangelogGroup[];
 }
 
+/** Default number of recent releases surfaced as "update news" (whats-new default, post-upgrade notice). Use --all for the full history. */
+export const RECENT_RELEASE_COUNT = 5;
+
 const HEADER = /^##\s+\[([^\]]+)\](?:\s*-\s*(\S+))?\s*$/;
 const SUBHEADER = /^###\s+(.+?)\s*$/;
 const BULLET = /^[-*]\s+(.+)$/;
@@ -266,7 +269,7 @@ export async function consumeLaunchWhatsNew(opts?: WhatsNewRenderOpts): Promise<
   const md = await loadBundledChangelog();
   await writeLastSeenVersion(current);
   if (!md) return null;
-  const sections = selectNewSections(parseChangelogSections(md), lastSeen, current);
+  const sections = selectNewSections(parseChangelogSections(md), lastSeen, current).slice(0, RECENT_RELEASE_COUNT);
   if (sections.length === 0) return null;
   return renderWhatsNew(sections, opts);
 }