jeo-code 0.5.12 → 0.5.14

package/src/commands/launch.ts

@@ -1,7 +1,7 @@
 import { createInterface } from "node:readline/promises";
 import { emitKeypressEvents } from "node:readline";
 import { PassThrough } from "node:stream";
-import { runAgentLoop, executorSystemPrompt, DEFAULT_TOOLS, TOOL_PROTOCOL, WORKING_DISCIPLINE, OUTPUT_DISCIPLINE, type AgentLoopEvents } from "../agent/engine";
+import { runAgentLoop, DEFAULT_TOOLS, TOOL_PROTOCOL, WORKING_DISCIPLINE, OUTPUT_DISCIPLINE, type AgentLoopEvents } from "../agent/engine";
 import { createOpikTracer, wrapEvents } from "../agent/opik-tracer";
 import { initialDynamicStepLimit } from "../agent/step-budget";
 import { memoryPromptSection, spawnDetachedDistill } from "../agent/memory";
@@ -10,11 +10,11 @@ import { createSubagentTool, SUBAGENT_TOOL_PROTOCOL_LINE } from "../agent/subage
 import { SubagentRegistry } from "../agent/subagent-registry";
 import { createTodoTool, TODO_TOOL_PROTOCOL_LINE } from "../agent/todo-tool";
 import { LaunchTui } from "../tui/app";
-import { runDeepInterviewEngine } from "./deep-interview";
-import { runRalplanEngine } from "./ralplan";
-import { runTeamEngine } from "./team";
-import { runUltragoalEngine } from "./ultragoal";
-import { skillsPromptSection, loadSkills, formatSkill, buildSkillTask, getSkillFrom, skillSlashAliases, workflowSkillsForPrompt, parseSkillInvocation, parseSkillChain, looksLikeSkillEcho, skillInvocationCard, type SkillDoc, type SkillInvocation } from "../skills/catalog";
+import { runDeepInterviewEngine, type DeepInterviewEngineOptions } from "./deep-interview";
+import { runRalplanEngine, type RalplanEngineOptions } from "./ralplan";
+import { runTeamEngine, type TeamEngineOptions } from "./team";
+import { runUltragoalEngine, type UltragoalEngineOptions } from "./ultragoal";
+import { skillsPromptSection, loadSkills, buildSkillTask, workflowSkillsForPrompt, parseSkillInvocation, parseSkillChain, looksLikeSkillEcho, skillInvocationCard, type SkillDoc, type SkillInvocation } from "../skills/catalog";
 import { formatForgeBox } from "../tui/components/forge";
 import { interactiveOAuthLogin } from "./auth";
 import { logoutOAuth } from "../auth";
@@ -54,7 +54,7 @@ import {
   formatCapabilityLine,
 } from "../tui/components/config-panel";
 import { liveModelPicker, renderLiveModelPicker, type ModelAssignmentBadge } from "../tui/components/live-model-picker";
-import { skillPicker, renderSkillPicker } from "../tui/components/skill-picker";
+
 import { providerPicker, renderProviderPicker } from "../tui/components/provider-picker";
 import { detectLanguage, languageLabel, parseLineRange, sliceLines, formatCodeBlock, formatDiff, sanitizeForTerminal } from "../tui/components/code-view";
 import { categoryBadge } from "../tui/components/category-index";
@@ -509,6 +509,18 @@ export function isStandaloneBackspace(chunk: string): boolean {
   return chunk.length > 0 && /^[\x7f\b]+$/.test(chunk);
 }
 
+/** gjc-parity slash-command aliases, applied once before dispatch so each real command
+ *  keeps a SINGLE handler: `/login`→`/provider login`, `/settings`→`/config`,
+ *  `/subagent(s)`→`/agents`. Pure rewrite that preserves any trailing args. */
+export function normalizeSlashAlias(input: string): string {
+  if (input === "/login" || input.startsWith("/login ")) return `/provider login${input.slice("/login".length)}`;
+  if (input === "/settings") return "/config";
+  if (input === "/subagent" || input.startsWith("/subagent ")) return `/agents${input.slice("/subagent".length)}`;
+  if (input === "/subagents" || input.startsWith("/subagents ")) return `/agents${input.slice("/subagents".length)}`;
+  if (input === "/resume" || input.startsWith("/resume ")) return `/session resume${input.slice("/resume".length)}`;
+  return input;
+}
+
 export interface PromptInputQueue {
   pendingLines: string[];
   partial: string;
@@ -1013,6 +1025,28 @@ function resolveWorktree(cwd: string, wt: string): string {
   return abs;
 }
 
+/** The bundled workflow skills that run through a dedicated engine (deep-interview /
+ *  ralplan / team / ultragoal), not the ordinary agent loop. Single source of truth —
+ *  the menu listing, the dispatch guards, and the engine switch all read from here. */
+export const WORKFLOW_NAMES = ["deep-interview", "ralplan", "team", "ultragoal"] as const;
+
+/** True when a skill name is one of the bundled workflow engines. */
+export function isWorkflowSkill(name: string): boolean {
+  return (WORKFLOW_NAMES as readonly string[]).includes(name);
+}
+
+/** Dispatch a bundled workflow by name to its engine. Keeps the name→engine mapping in
+ *  ONE place so the one-shot and interactive skill runners can't drift apart. */
+export function runWorkflowEngine(
+  name: string,
+  opts: DeepInterviewEngineOptions & RalplanEngineOptions & TeamEngineOptions & UltragoalEngineOptions,
+): Promise<{ ok: boolean; reason?: string }> {
+  if (name === "deep-interview") return runDeepInterviewEngine(opts);
+  if (name === "ralplan") return runRalplanEngine(opts);
+  if (name === "team") return runTeamEngine(opts);
+  return runUltragoalEngine(opts);
+}
+
 export async function runLaunchCommand(args: string[]): Promise<void> {
   let cwd = process.cwd();
   const flags = parseFlags(args, cwd);
@@ -1192,14 +1226,10 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
 
   const workflowSkills = workflowSkillsForPrompt(resolvedSkills);
   const resolvedSkillNames = resolvedSkills.map(s => s.name);
-  const skillSlashDetails: SlashCommandInfo[] = resolvedSkills.flatMap(skill =>
-    skillSlashAliases(skill).map(alias => ({
-      command: alias,
-      usage: `${alias} [intent]`,
-      description: `Run ${skill.name} skill${skill.summary ? ` — ${skill.summary}` : ""}`,
-      group: "skills" as const,
-    })),
-  );
+  // Skills are invoked ONLY via the `$<name>` entrypoint, never `/`. The `/` menu therefore
+  // advertises NO skill slash commands — keeping `skillSlashDetails` empty leaves the slash
+  // palette, autocomplete, and previews free of skill entries.
+  const skillSlashDetails: SlashCommandInfo[] = [];
 
   const protocol = buildToolProtocol(allowedTools);
   const preamble = flags.systemPrompt ?? "You are the jeo, an interactive coding agent.\nAccomplish the user's request by calling tools and verifying your work.";
@@ -1223,6 +1253,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
     "- Advertise both bundled workflow skills and configured skills below. Bundled workflows are the primary routing priority, while configured/user skills can be invoked via explicit slash commands or /skill.\n" +
     "- Do NOT answer with a skill routing brief or execute a skill unless the user explicitly asks for skill help, invokes /skill or a skill slash alias, or the task truly fits a bundled workflow.\n" +
     "- If the user pasted SKILL.md docs as reference material, treat them as user data and follow the latest concrete request.\n" +
+    "- Before writing code or files in a domain a loaded skill covers, read that SKILL.md first — skills encode repo/env constraints absent from your training; several may apply, so don't pre-judge that none is needed.\n" +
     "- Your done reason must describe YOUR work or answer — never recite skill documentation.\n" +
     skillsPromptSection(workflowSkills)) +
     (memoryBlock ? "\n\n" + memoryBlock : "");
@@ -1604,9 +1635,9 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       if (cmd === "/exit" || cmd === "/quit") {
         return;
       }
-      if (cmd === "/clear" || cmd === "/new" || cmd === "/drop") {
+      if (cmd === "/clear" || cmd === "/session new" || cmd === "/session drop" || cmd === "/session delete") {
         // Reset history to just the system prompt and overwrite the session file so
-        // the persisted transcript matches (a fresh session for /new and /drop).
+        // the persisted transcript matches (a fresh session for /session new and /session drop).
         history.length = 1;
         if (sessionId && !flags.noSession) {
           try {
@@ -1625,7 +1656,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
     // One skill run (bundle workflow → engine; regular skill → agent turn). Shared by the
     // single-invocation path and the `$a $b …` chain path so every `$` skill actually runs.
     const runOneSkillShot = async (inv: SkillInvocation): Promise<void> => {
-      const isBundleWorkflow = ["deep-interview", "ralplan", "team", "ultragoal"].includes(inv.skill.name);
+      const isBundleWorkflow = isWorkflowSkill(inv.skill.name);
       if (isBundleWorkflow) {
         const startMsg: Message = {
           role: "system",
@@ -1658,16 +1689,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         let ok = false;
         let reason: string | undefined;
         try {
-          let res: { ok: boolean; reason?: string };
-          if (inv.skill.name === "deep-interview") {
-            res = await runDeepInterviewEngine(opts);
-          } else if (inv.skill.name === "ralplan") {
-            res = await runRalplanEngine(opts);
-          } else if (inv.skill.name === "team") {
-            res = await runTeamEngine(opts);
-          } else {
-            res = await runUltragoalEngine(opts);
-          }
+          const res: { ok: boolean; reason?: string } = await runWorkflowEngine(inv.skill.name, opts);
           ok = res.ok;
           reason = res.reason;
         } catch (err: any) {
@@ -1807,7 +1829,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       );
       logLines(card);
     }
-    const isBundleWorkflow = ["deep-interview", "ralplan", "team", "ultragoal"].includes(skill.name);
+    const isBundleWorkflow = isWorkflowSkill(skill.name);
     if (isBundleWorkflow) {
       const startMsg: Message = {
         role: "system",
@@ -1857,16 +1879,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       let ok = false;
       let reason: string | undefined;
       try {
-        let res: { ok: boolean; reason?: string };
-        if (skill.name === "deep-interview") {
-          res = await runDeepInterviewEngine(opts);
-        } else if (skill.name === "ralplan") {
-          res = await runRalplanEngine(opts);
-        } else if (skill.name === "team") {
-          res = await runTeamEngine(opts);
-        } else {
-          res = await runUltragoalEngine(opts);
-        }
+        const res: { ok: boolean; reason?: string } = await runWorkflowEngine(skill.name, opts);
         ok = res.ok;
         reason = res.reason;
       } catch (err: any) {
@@ -2816,54 +2829,6 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
     return true;
   };
 
-  const pickSkillFromList = async (skills: SkillDoc[]): Promise<SkillDoc | undefined> => {
-    if (!process.stdin.isTTY || skills.length === 0) return undefined;
-    const list = skillPicker(skills);
-    let chosen: SkillDoc | undefined;
-    await runSelectPicker(
-      (cols, rows) =>
-        renderSkillPicker(list, {
-          cols,
-          rows: Math.max(4, Math.min(rows, 12)),
-          unicode: true,
-          color: true,
-        }),
-      (ch, key) => {
-        if (key?.name === "up") {
-          list.up();
-          return false;
-        }
-        if (key?.name === "down") {
-          list.down();
-          return false;
-        }
-        if (key?.name === "pageup") {
-          list.page(-1, 6);
-          return false;
-        }
-        if (key?.name === "pagedown") {
-          list.page(1, 6);
-          return false;
-        }
-        if (key?.name === "backspace") {
-          list.backspace();
-          return false;
-        }
-        if (key?.name === "escape" || (key?.ctrl && key.name === "c")) {
-          return true;
-        }
-        if (key?.name === "return" || key?.name === "enter") {
-          chosen = list.selected()?.value;
-          return true;
-        }
-        if (ch && ch >= " " && !key?.ctrl && !key?.meta) {
-          list.typeChar(ch);
-        }
-        return false;
-      },
-    );
-    return chosen;
-  };
 
   const pickCloudProvider = async (statuses: Awaited<ReturnType<typeof describeAllProviders>>): Promise<AuthProvider | undefined> => {
     const cloud = new Set(["anthropic", "openai", "gemini", "antigravity"]);
@@ -3114,13 +3079,9 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       let input = pendingSelection && trigger && pendingSelection.startsWith(trigger.token)
         ? raw.slice(0, trigger.start) + pendingSelection
         : raw;
-      // gjc-parity command aliases (full behavior reuse, no duplicated handlers).
-      if (input === "/login" || input.startsWith("/login ")) input = `/provider login${input.slice("/login".length)}`;
-      else if (input === "/settings") input = "/config";
-      // `/subagent`(s) → the /agents roster/editor (view + change the current
-      // subagent composition: per-role model · thinking · steps).
-      else if (input === "/subagent" || input.startsWith("/subagent ")) input = `/agents${input.slice("/subagent".length)}`;
-      else if (input === "/subagents" || input.startsWith("/subagents ")) input = `/agents${input.slice("/subagents".length)}`;
+      // gjc-parity command aliases (full behavior reuse, no duplicated handlers):
+      // /login→/provider login, /settings→/config, /subagent(s)→/agents.
+      input = normalizeSlashAlias(input);
       pendingSelection = undefined;
       navMatches = [];
       navIdx = -1;
@@ -3185,156 +3146,169 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         }
         continue;
       }
-      if (input === "/sessions") {
-        const sessions = await listSessions(cwd);
-        if (sessions.length === 0) console.log("(no saved sessions)");
-        for (const s of sessions) {
-          const marker = s.id === sessionId ? "*" : " ";
-          const title = s.title ? `[${s.title}] ` : "";
-          console.log(` ${marker}${s.id}  (${s.messageCount} msgs)  ${title}${s.preview}`);
-        }
-        continue;
-      }
-      // ---- gjc-parity session management ------------------------------------
-      const startFreshSession = async (verb: string): Promise<void> => {
-        history.length = 1;
-        if (!flags.noSession) {
-          sessionId = (await createSession(cwd)).id;
-          advanceSessionBoxColor(); // distinct input-box hue per newly opened session
-          console.log(`(${verb} — new session ${sessionId})`);
-        } else {
-          sessionId = undefined;
-          console.log(`(${verb} — sessions disabled)`);
-        }
-      };
-      if (input === "/new") {
-        await startFreshSession("started fresh");
-        continue;
-      }
-      if (input === "/drop") {
-        if (sessionId) {
-          const removed = await deleteSession(sessionId, cwd);
-          console.log(removed ? `(deleted session ${sessionId})` : `(session ${sessionId} already gone)`);
-        }
-        await startFreshSession("dropped");
-        continue;
-      }
       if (input === "/session" || input.startsWith("/session ")) {
-        const sub = input.substring(8).trim().toLowerCase();
-        if (sub === "delete") {
-          if (!sessionId) {
-            console.log("(sessions are disabled — nothing to delete)");
-            continue;
+        const tokens = input.substring(8).trim().split(/\s+/).filter(Boolean);
+        const sub = (tokens[0] ?? "").toLowerCase();
+
+        const startFreshSession = async (verb: string): Promise<void> => {
+          history.length = 1;
+          if (!flags.noSession) {
+            sessionId = (await createSession(cwd)).id;
+            advanceSessionBoxColor(); // distinct input-box hue per newly opened session
+            console.log(`(${verb} — new session ${sessionId})`);
+          } else {
+            sessionId = undefined;
+            console.log(`(${verb} — sessions disabled)`);
           }
-          const removed = await deleteSession(sessionId, cwd);
-          console.log(removed ? `(deleted session ${sessionId})` : `(session ${sessionId} already gone)`);
-          await startFreshSession("dropped");
+        };
+
+        if (sub === "new") {
+          await startFreshSession("started fresh");
           continue;
         }
-        if (sub && sub !== "info") {
-          console.log("Usage: /session [info|delete]");
+        if (sub === "drop" || sub === "delete") {
+          if (sessionId) {
+            const removed = await deleteSession(sessionId, cwd);
+            console.log(removed ? `(deleted session ${sessionId})` : `(session ${sessionId} already gone)`);
+          }
+          await startFreshSession("dropped");
           continue;
         }
-        if (!sessionId) {
-          console.log("Session: disabled (--no-session)");
+        if (sub === "rename") {
+          const title = tokens.slice(1).join(" ").trim();
+          if (!title) {
+            console.log("Usage: /session rename <title>");
+            continue;
+          }
+          if (!sessionId) {
+            console.log("(sessions are disabled — nothing to rename)");
+            continue;
+          }
+          try {
+            await renameSession(sessionId, title, cwd);
+            console.log(`(session renamed to '${title}')`);
+          } catch (err) {
+            console.log(`! rename failed: ${(err as Error).message}`);
+          }
           continue;
         }
-        const all = await listSessions(cwd);
-        const current = all.find(s => s.id === sessionId);
-        console.log("Session info:");
-        console.log(`  id        ${sessionId}`);
-        if (current?.title) console.log(`  title     ${current.title}`);
-        console.log(`  file      ${sessionPath(sessionId, cwd)}`);
-        console.log(`  started   ${current?.timestamp ?? "(this run)"}`);
-        console.log(`  messages  ${current?.messageCount ?? Math.max(0, history.length - 1)} persisted · ${history.length - 1} in context`);
-        console.log(`  workspace ${cwd}`);
-        continue;
-      }
-      if (input === "/rename" || input.startsWith("/rename ")) {
-        const title = input.substring(7).trim();
-        if (!title) {
-          console.log("Usage: /rename <title>");
+        if (sub === "resume") {
+          const arg = tokens.slice(1).join(" ").trim();
+          const applyResume = async (rid: string): Promise<void> => {
+            try {
+              const { messages } = await loadSession(rid, cwd);
+              history.length = 1;
+              for (const m of messages) history.push(m);
+              sessionId = rid;
+              // Seed /retry + reply marker from the last user/assistant turn.
+              lastUserInput = ""; lastReply = "";
+              for (let k = history.length - 1; k >= 1; k--) {
+                if (history[k]!.role === "user" && !lastUserInput) lastUserInput = String(history[k]!.content ?? "");
+                if (history[k]!.role === "assistant" && !lastReply) lastReply = String(history[k]!.content ?? "");
+                if (lastUserInput && lastReply) break;
+              }
+              // Seed readline's input history so ↑ in the prompt recalls THIS session's
+              // prior prompts (not just lines typed in the current run). readline history
+              // is newest-first; unshift in chronological order so the session's newest
+              // prompt lands at the front (first ↑). Skip injected/framed messages.
+              const rli = rl as unknown as { history?: string[] };
+              if (Array.isArray(rli.history)) {
+                const priorPrompts = history
+                  .filter(m => m.role === "user")
+                  .map(m => String(m.content ?? "").trim())
+                  .filter(c => c && !c.startsWith("Tool [") && !c.startsWith("[mid-turn steering") && !c.startsWith("[Earlier conversation summary]"));
+                for (const p of priorPrompts) {
+                  if (rli.history[0] !== p) rli.history.unshift(p);
+                }
+              }
+              const sep = "─".repeat(Math.min(48, Math.max(20, (process.stdout.columns ?? 80) - 1)));
+              logLines([
+                sep,
+                `resumed session ${rid} · ${messages.length} message(s) (/history all for the full transcript)`,
+                sep,
+                ...formatTranscript(history, { maxTurns: 6, color: true, unicode: true }),
+                sep,
+              ]);
+            } catch (err) {
+              console.log(`! ${(err as Error).message}`);
+            }
+          };
+          if (arg) { await applyResume(arg); continue; }
+          // No id → only sessions with a real conversation are resumable (every launch
+          // creates an empty session; those are noise).
+          const sessions = (await listSessions(cwd)).filter(s => s.messageCount > 0);
+          if (sessions.length === 0) {
+            console.log("(no saved sessions with history)");
+            continue;
+          }
+          // Interactive arrow-key picker on a TTY: ↑↓ to move, Enter to resume, Esc cancels.
+          if (process.stdin.isTTY && process.stdout.isTTY) {
+            const items: SelectItem<string>[] = sessions.slice(0, 50).map(s => ({
+              value: s.id,
+              label: `${s.title ? `[${s.title}] ` : ""}${(s.preview || s.id).replace(/\s+/g, " ")}`.slice(0, 76) || s.id,
+              hint: `${s.messageCount} msgs${s.id === sessionId ? " · current" : ""}`,
+            }));
+            const picked = await pickFromOptions("Resume a session  ↑↓ move · Enter resume · Esc cancel", items);
+            if (picked) await applyResume(picked);
+            else console.log("(resume cancelled)");
+            continue;
+          }
+          // Non-TTY fallback: static list (resume with /session resume <id>).
+          console.log("Saved sessions — resume with /session resume <id>:");
+          for (const s of sessions.slice(0, 15)) {
+            const marker = s.id === sessionId ? "*" : " ";
+            console.log(` ${marker}${s.id}  (${s.messageCount} msgs)  ${s.title ? `[${s.title}] ` : ""}${s.preview}`);
+          }
           continue;
         }
-        if (!sessionId) {
-          console.log("(sessions are disabled — nothing to rename)");
+        if (sub === "list") {
+          const sessions = await listSessions(cwd);
+          if (sessions.length === 0) console.log("(no saved sessions)");
+          for (const s of sessions) {
+            const marker = s.id === sessionId ? "*" : " ";
+            const title = s.title ? `[${s.title}] ` : "";
+            console.log(` ${marker}${s.id}  (${s.messageCount} msgs)  ${title}${s.preview}`);
+          }
           continue;
         }
-        try {
-          await renameSession(sessionId, title, cwd);
-          console.log(`(session renamed to '${title}')`);
-        } catch (err) {
-          console.log(`! rename failed: ${(err as Error).message}`);
-        }
-        continue;
-      }
-      if (input === "/resume" || input.startsWith("/resume ")) {
-        const arg = input.substring(7).trim();
-        // Load a session into history and print its transcript so the resume is visible.
-        const applyResume = async (rid: string): Promise<void> => {
-          try {
-            const { messages } = await loadSession(rid, cwd);
-            history.length = 1;
-            for (const m of messages) history.push(m);
-            sessionId = rid;
-            // Seed /retry + reply marker from the last user/assistant turn.
-            lastUserInput = ""; lastReply = "";
-            for (let k = history.length - 1; k >= 1; k--) {
-              if (history[k]!.role === "user" && !lastUserInput) lastUserInput = String(history[k]!.content ?? "");
-              if (history[k]!.role === "assistant" && !lastReply) lastReply = String(history[k]!.content ?? "");
-              if (lastUserInput && lastReply) break;
-            }
-            // Seed readline's input history so ↑ in the prompt recalls THIS session's
-            // prior prompts (not just lines typed in the current run). readline history
-            // is newest-first; unshift in chronological order so the session's newest
-            // prompt lands at the front (first ↑). Skip injected/framed messages.
-            const rli = rl as unknown as { history?: string[] };
-            if (Array.isArray(rli.history)) {
-              const priorPrompts = history
-                .filter(m => m.role === "user")
-                .map(m => String(m.content ?? "").trim())
-                .filter(c => c && !c.startsWith("Tool [") && !c.startsWith("[mid-turn steering") && !c.startsWith("[Earlier conversation summary]"));
-              for (const p of priorPrompts) {
-                if (rli.history[0] !== p) rli.history.unshift(p);
-              }
-            }
-            const sep = "─".repeat(Math.min(48, Math.max(20, (process.stdout.columns ?? 80) - 1)));
-            logLines([
-              sep,
-              `resumed session ${rid} · ${messages.length} message(s) (/history all for the full transcript)`,
-              sep,
-              ...formatTranscript(history, { maxTurns: 6, color: true, unicode: true }),
-              sep,
-            ]);
-          } catch (err) {
-            console.log(`! ${(err as Error).message}`);
+        if (sub === "info") {
+          if (!sessionId) {
+            console.log("Session: disabled (--no-session)");
+            continue;
           }
-        };
-        if (arg) { await applyResume(arg); continue; }
-        // No id → only sessions with a real conversation are resumable (every launch
-        // creates an empty session; those are noise).
-        const sessions = (await listSessions(cwd)).filter(s => s.messageCount > 0);
-        if (sessions.length === 0) {
-          console.log("(no saved sessions with history)");
+          const all = await listSessions(cwd);
+          const current = all.find(s => s.id === sessionId);
+          console.log("Session info:");
+          console.log(`  id        ${sessionId}`);
+          if (current?.title) console.log(`  title     ${current.title}`);
+          console.log(`  file      ${sessionPath(sessionId, cwd)}`);
+          console.log(`  started   ${current?.timestamp ?? "(this run)"}`);
+          console.log(`  messages  ${current?.messageCount ?? Math.max(0, history.length - 1)} persisted · ${history.length - 1} in context`);
+          console.log(`  workspace ${cwd}`);
           continue;
         }
-        // Interactive arrow-key picker on a TTY: ↑↓ to move, Enter to resume, Esc cancels.
-        if (process.stdin.isTTY && process.stdout.isTTY) {
-          const items: SelectItem<string>[] = sessions.slice(0, 50).map(s => ({
-            value: s.id,
-            label: `${s.title ? `[${s.title}] ` : ""}${(s.preview || s.id).replace(/\s+/g, " ")}`.slice(0, 76) || s.id,
-            hint: `${s.messageCount} msgs${s.id === sessionId ? " · current" : ""}`,
-          }));
-          const picked = await pickFromOptions("Resume a session  ↑↓ move · Enter resume · Esc cancel", items);
-          if (picked) await applyResume(picked);
-          else console.log("(resume cancelled)");
+        if (sub && sub !== "info") {
+          console.log("Usage: /session [list|info|new|drop|rename <title>|resume [id]]");
           continue;
         }
-        // Non-TTY fallback: static list (resume with /resume <id>).
-        console.log("Saved sessions — resume with /resume <id>:");
-        for (const s of sessions.slice(0, 15)) {
-          const marker = s.id === sessionId ? "*" : " ";
-          console.log(` ${marker}${s.id}  (${s.messageCount} msgs)  ${s.title ? `[${s.title}] ` : ""}${s.preview}`);
+
+        // Default: list sessions AND show current session info
+        const sessions = await listSessions(cwd);
+        if (sessions.length === 0) {
+          console.log("(no saved sessions)");
+        } else {
+          console.log("Saved sessions:");
+          for (const s of sessions) {
+            const marker = s.id === sessionId ? "*" : " ";
+            const title = s.title ? `[${s.title}] ` : "";
+            console.log(` ${marker}${s.id}  (${s.messageCount} msgs)  ${title}${s.preview}`);
+          }
+        }
+        if (sessionId) {
+          const current = sessions.find(s => s.id === sessionId);
+          console.log(`\nCurrent session: ${sessionId}${current?.title ? ` [${current.title}]` : ""}`);
+        } else {
+          console.log("\nCurrent session: disabled (--no-session)");
         }
         continue;
       }
@@ -4235,46 +4209,23 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         console.log(res.success ? (res.output || "(no matches)") : `! ${res.error}`);
         continue;
       }
+
       const skillEntrypoint = input.startsWith("/skill:") ? "/skill:" : input.startsWith("/skill") && (input === "/skill" || input[6] === " ") ? "/skill" : "";
       if (skillEntrypoint) {
         if (flags.noSkills) {
           console.log("Skills are disabled.");
           continue;
         }
-        const rest = skillEntrypoint === "/skill:" ? input.substring(7).trim() : input.substring(6).trim();
+        // `/` never LOADS or RUNS a skill file — skills are invoked ONLY via `$<name>`.
+        // `/skill[:...]` is a read-only listing that points the user at the `$` entrypoint.
         let skills = await loadSkills(cwd);
         if (flags.skills) {
           const patterns = flags.skills.split(",").map(p => p.trim()).filter(Boolean);
           skills = skills.filter(s => patterns.some(p => matchSkillGlob(p, s.name)));
         }
-        if (!rest) {
-          if (process.stdin.isTTY && process.stdout.isTTY) {
-            const picked = await pickSkillFromList(skills);
-            if (!picked) {
-              console.log("(cancelled)");
-              continue;
-            }
-            await runSkillInvocation(picked, "");
-            continue;
-          }
-          console.log("Skills (bundled + configured docs) — run with /skill <name> [intent] or a skill slash alias:");
-          for (const s of skills) {
-            const aliases = skillSlashAliases(s);
-            console.log(`  ${s.name.padEnd(16)} ${s.summary}${aliases.length ? `  (${aliases.join(", ")})` : ""}`);
-          }
-          continue;
-        }
-        const [nm, ...intentParts] = rest.split(/\s+/);
-        const skill = getSkillFrom(skills, nm);
-        if (!skill) {
-          console.log(`Unknown skill: ${nm}. Available: ${skills.map(s => s.name).join(", ")}`);
-          continue;
-        }
-        const intent = intentParts.join(" ").trim();
-        try {
-          await runSkillInvocation(skill, intent);
-        } catch (err) {
-          console.log(`! ${(err as Error).message}`);
+        console.log("Skills are invoked with $<name> [intent] (e.g. $team build auth). Available:");
+        for (const s of skills) {
+          console.log(`  $${s.name.padEnd(16)} ${s.summary}`);
         }
         continue;
       }

package/src/commands/update.ts

@@ -36,6 +36,8 @@ export interface UpdateDeps {
   fetchJson: (url: string, options?: { signal?: AbortSignal }) => Promise<any>;
   localVersion: () => string;
   install: () => 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 = {
@@ -63,6 +65,15 @@ export const defaultDeps: UpdateDeps = {
     });
     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> {
@@ -172,6 +183,7 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
             }));
           } else {
             console.log(`Successfully installed jeo-code@${latest}`);
+            deps.showWhatsNew?.();
           }
         } else {
           if (hasJson) {