jeo-code 0.6.19 → 0.6.20

package/CHANGELOG.md

@@ -6,7 +6,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 The README mirrors the latest 5 entries — regenerate with `bun run changelog:sync`.
 
+## [0.6.20] - 2026-06-18
+_Launch REPL internals decomposed into testable modules: `@mention` path completion, slash-command view renderers, and slash-command handlers extracted from the monolithic `launch.ts` into dedicated files with full unit-test coverage._
+
+### Changed
+- **`mentionPaths` / `currentAtLabel` extracted to `src/commands/launch/mentions.ts`.** The `@path` filesystem completion and footer label logic are now pure, `cwd`-parametric functions that can be unit-tested in isolation; `launch.ts` delegates to them via thin wrappers.
+- **Slash-command view renderers extracted to `src/commands/launch/slash-views.ts`.** `hotkeysLines` and `contextUsageLines` are now pure functions (no I/O, no hidden state) returning `string[]`; verified with snapshot-style unit tests.
+- **Slash-command handlers extracted to `src/commands/launch/slash-handlers.ts`.** `/usage`, `/tools`, `/hotkeys`, `/context` handlers are isolated behind a `SlashContext` interface, each returning a typed result — testable without spinning up the full REPL.
+
+### Added
+- **Unit tests for all extracted modules** (`test/launch-mentions.test.ts`, `test/launch-slash-views.test.ts`, `test/slash-handlers.test.ts`): 13 new tests, 79 assertions — mentionPaths directory traversal, case-insensitive filtering, unreadable-dir guard, currentAtLabel edge cases, context token tallies, singular/plural spacing, handler outputs.
+
 ## [0.6.19] - 2026-06-18
+
 _Post-turn hooks run once per batch (not per edit), local hook reads are mtime-cached, tool-result formatting is parallelized, and wrapped colored text keeps its tint._
 
 ### Changed

package/README.ja.md

@@ -200,11 +200,11 @@ CI は `.github/workflows/npm-publish.yml` で公開します — GitHub リリ
 ## 変更履歴 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.6.20]** (2026-06-18) — Launch REPL internals decomposed into testable modules: `@mention` path completion, slash-command view renderers, and slash-command handlers extracted from the monolithic `launch.ts` into dedicated files with full unit-test coverage.
 - **[0.6.19]** (2026-06-18) — Post-turn hooks run once per batch (not per edit), local hook reads are mtime-cached, tool-result formatting is parallelized, and wrapped colored text keeps its tint.
 - **[0.6.18]** (2026-06-17) — Memory data-flow diagram and a README "Memory flow" section documenting the actual runtime behavior.
 - **[0.6.17]** (2026-06-17) — Legacy MEMORY.md migrates losslessly into the OKF concept bundle, with a one-shot command and a rollback toggle.
 - **[0.6.16]** (2026-06-17) — OKF memory grows a concept cross-link graph: 1-hop search expansion, bundle lint, graphify-optional.
-- **[0.6.15]** (2026-06-17) — Query-aware OKF memory injection with budget-priority selection, and a truthful end-of-turn Todos receipt.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.ko.md

@@ -200,11 +200,11 @@ CI는 `.github/workflows/npm-publish.yml`로 배포합니다 — GitHub 릴리
 ## 변경 이력 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.6.20]** (2026-06-18) — Launch REPL internals decomposed into testable modules: `@mention` path completion, slash-command view renderers, and slash-command handlers extracted from the monolithic `launch.ts` into dedicated files with full unit-test coverage.
 - **[0.6.19]** (2026-06-18) — Post-turn hooks run once per batch (not per edit), local hook reads are mtime-cached, tool-result formatting is parallelized, and wrapped colored text keeps its tint.
 - **[0.6.18]** (2026-06-17) — Memory data-flow diagram and a README "Memory flow" section documenting the actual runtime behavior.
 - **[0.6.17]** (2026-06-17) — Legacy MEMORY.md migrates losslessly into the OKF concept bundle, with a one-shot command and a rollback toggle.
 - **[0.6.16]** (2026-06-17) — OKF memory grows a concept cross-link graph: 1-hop search expansion, bundle lint, graphify-optional.
-- **[0.6.15]** (2026-06-17) — Query-aware OKF memory injection with budget-priority selection, and a truthful end-of-turn Todos receipt.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.md

@@ -200,11 +200,11 @@ Required npm token permissions (repository secret `NPM_TOKEN`):
 ## Changelog
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.6.20]** (2026-06-18) — Launch REPL internals decomposed into testable modules: `@mention` path completion, slash-command view renderers, and slash-command handlers extracted from the monolithic `launch.ts` into dedicated files with full unit-test coverage.
 - **[0.6.19]** (2026-06-18) — Post-turn hooks run once per batch (not per edit), local hook reads are mtime-cached, tool-result formatting is parallelized, and wrapped colored text keeps its tint.
 - **[0.6.18]** (2026-06-17) — Memory data-flow diagram and a README "Memory flow" section documenting the actual runtime behavior.
 - **[0.6.17]** (2026-06-17) — Legacy MEMORY.md migrates losslessly into the OKF concept bundle, with a one-shot command and a rollback toggle.
 - **[0.6.16]** (2026-06-17) — OKF memory grows a concept cross-link graph: 1-hop search expansion, bundle lint, graphify-optional.
-- **[0.6.15]** (2026-06-17) — Query-aware OKF memory injection with budget-priority selection, and a truthful end-of-turn Todos receipt.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.zh.md

@@ -200,11 +200,11 @@ CI 通过 `.github/workflows/npm-publish.yml` 发布 — GitHub 发布 release
 ## 更新日志 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.6.20]** (2026-06-18) — Launch REPL internals decomposed into testable modules: `@mention` path completion, slash-command view renderers, and slash-command handlers extracted from the monolithic `launch.ts` into dedicated files with full unit-test coverage.
 - **[0.6.19]** (2026-06-18) — Post-turn hooks run once per batch (not per edit), local hook reads are mtime-cached, tool-result formatting is parallelized, and wrapped colored text keeps its tint.
 - **[0.6.18]** (2026-06-17) — Memory data-flow diagram and a README "Memory flow" section documenting the actual runtime behavior.
 - **[0.6.17]** (2026-06-17) — Legacy MEMORY.md migrates losslessly into the OKF concept bundle, with a one-shot command and a rollback toggle.
 - **[0.6.16]** (2026-06-17) — OKF memory grows a concept cross-link graph: 1-hop search expansion, bundle lint, graphify-optional.
-- **[0.6.15]** (2026-06-17) — Query-aware OKF memory injection with budget-priority selection, and a truthful end-of-turn Todos receipt.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "jeo-code",
-  "version": "0.6.19",
-
+  "version": "0.6.20",
   "description": "Clean, highly optimized AI coding agent using spec-first loop",
   "type": "module",
   "main": "src/cli.ts",

package/src/commands/launch/mentions.ts

@@ -0,0 +1,48 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { tokenize } from "../../tui/components/autocomplete";
+
+/** Filesystem completion for an `@path` mention prefix, relative to `cwd`.
+ *  Lists the directory the prefix points at, filtering by the basename fragment,
+ *  directories first, hidden entries dropped, capped at 50 — directories keep a
+ *  trailing `/` so the next Tab descends. Pure given `cwd`: never throws (an
+ *  unreadable directory yields no matches). Extracted verbatim from the launch
+ *  REPL so it can be unit-tested in isolation. */
+export function mentionPaths(cwd: string, prefix: string): string[] {
+  const norm = prefix.replace(/\\/g, "/");
+  const wantsDirChildren = norm.endsWith("/");
+  const dirPart = wantsDirChildren ? norm.slice(0, -1) : path.posix.dirname(norm) === "." ? "" : path.posix.dirname(norm);
+  const namePart = wantsDirChildren ? "" : path.posix.basename(norm);
+  const absDir = path.resolve(cwd, dirPart || ".");
+  let entries: fs.Dirent[] = [];
+  try {
+    entries = fs.readdirSync(absDir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries
+    .filter(entry => !entry.name.startsWith("."))
+    .filter(entry => !namePart || entry.name.toLowerCase().startsWith(namePart.toLowerCase()))
+    .sort((a, b) => {
+      if (a.isDirectory() !== b.isDirectory()) return a.isDirectory() ? -1 : 1;
+      return a.name.localeCompare(b.name);
+    })
+    .slice(0, 50)
+    .map(entry => {
+      const rel = dirPart ? `${dirPart}/${entry.name}` : entry.name;
+      return entry.isDirectory() ? `${rel}/` : rel;
+    });
+}
+
+/** The `@ <dir>` label shown in the boxed-input footer for the last `@mention`
+ *  token on the current line, or undefined when the line has no mention. Pure. */
+export function currentAtLabel(line: string): string | undefined {
+  const { tokens } = tokenize(line);
+  const token = [...tokens].reverse().find(t => t.startsWith("@"));
+  if (!token) return undefined;
+  const norm = token.slice(1).replace(/\\/g, "/");
+  if (!norm) return "@ .";
+  if (norm.endsWith("/")) return `@ ${norm.slice(0, -1) || "."}`;
+  const dir = path.posix.dirname(norm);
+  return `@ ${dir === "." ? norm : dir}`;
+}

package/src/commands/launch/slash-handlers.ts

@@ -0,0 +1,62 @@
+/**
+ * Slash command handlers extracted from launch.ts.
+ * Each handler is a pure function taking context and returning a result.
+ */
+
+import type { Message } from "../../agent/loop";
+import type { Config } from "../../agent/state";
+import { TOOL_PROTOCOL } from "../../agent/engine";
+import { taskToolProtocolLine } from "../../agent/task-tool";
+import { TODO_TOOL_PROTOCOL_LINE } from "../../agent/todo-tool";
+import { SUBAGENT_TOOL_PROTOCOL_LINE } from "../../agent/subagent-tool";
+import { hotkeysLines, contextUsageLines } from "./slash-views";
+import { describeModel, catalogMetadata } from "../../ai";
+import { readGlobalConfig } from "../../agent/state";
+
+/** Shared context passed to all slash handlers. */
+export interface SlashContext {
+  history: Message[];
+  sessionModel?: string;
+  sessionId?: string;
+  cwd: string;
+  config: Config;
+}
+
+/** Handler result: lines to print, or undefined if handler didn't match. */
+export type SlashResult = { lines: string[] } | { action: "exit" | "continue" } | undefined;
+
+/** Handles /usage command. */
+export function handleUsage(ctx: SlashContext, sessionUsage: { turns: number; inputTokens: number; outputTokens: number }): SlashResult {
+  const total = sessionUsage.inputTokens + sessionUsage.outputTokens;
+  return {
+    lines: [
+      "Provider token usage (this REPL):",
+      `  turns   ${sessionUsage.turns}`,
+      `  input   ${sessionUsage.inputTokens}`,
+      `  output  ${sessionUsage.outputTokens}`,
+      `  total   ${total}${total === 0 ? "  (providers report usage per turn; run a request first)" : ""}`,
+    ],
+  };
+}
+
+/** Handles /tools command. */
+export async function handleTools(ctx: SlashContext): Promise<SlashResult> {
+  const lines = ["Tools visible to the agent:"];
+  for (const line of TOOL_PROTOCOL.split("\n")) lines.push(`  ${line}`);
+  lines.push(`  ${taskToolProtocolLine(await readGlobalConfig())}`);
+  lines.push(`  ${TODO_TOOL_PROTOCOL_LINE}`);
+  lines.push(`  ${SUBAGENT_TOOL_PROTOCOL_LINE}`);
+  return { lines };
+}
+
+/** Handles /hotkeys command. */
+export function handleHotkeys(_ctx: SlashContext): SlashResult {
+  return { lines: hotkeysLines() };
+}
+
+/** Handles /context command. */
+export async function handleContext(ctx: SlashContext): Promise<SlashResult> {
+  const { resolved } = await describeModel(ctx.sessionModel || ctx.config.defaultModel);
+  const window = catalogMetadata(resolved)?.contextTokens;
+  return { lines: contextUsageLines(ctx.history, resolved, window) };
+}

package/src/commands/launch/slash-views.ts

@@ -0,0 +1,48 @@
+// Pure presenters for read-only REPL slash commands. These build the exact
+// line arrays the inline handlers used to `console.log` directly, extracted so
+// they can be unit-tested without driving the whole launch REPL. They hold NO
+// mutable session state — every input is passed in explicitly.
+import type { Message } from "../../agent/loop";
+
+/** Static keyboard-shortcut reference for `/hotkeys` (no inputs, no state). */
+export function hotkeysLines(): string[] {
+  return [
+    "Keyboard shortcuts:",
+    "  Tab        complete slash commands, models, roles, @paths",
+    "  ↑ / ↓      navigate the slash-command preview (Enter runs the highlighted one)",
+    "  Enter      submit input / confirm picker selection",
+    "  Esc        cancel an open picker",
+    "  Ctrl-C     cancel the in-flight turn (press again at the prompt to exit)",
+    "  Ctrl-D     exit the REPL",
+    "  Ctrl-O     dump the full last response (untruncated, tables rendered) into scrollback",
+    "  Ctrl-K / Ctrl-U / Ctrl-W   kill to end / start of line / previous word (emacs kill-ring)",
+    "  Ctrl-Y / Alt-Y             yank / yank-pop the killed text",
+    "  Ctrl-A / Ctrl-E            move to start / end of line",
+    "  /          open the slash-command palette",
+    "  @path      mention a file (Tab completes relative paths)",
+  ];
+}
+
+/** Per-role token tallies for `/context`, estimated at ~4 chars/token. Pure over
+ *  the in-memory history so the math is verifiable in isolation. */
+export function contextUsageLines(
+  history: Message[],
+  resolved: string,
+  window: number | undefined,
+): string[] {
+  const est = (s: string) => Math.ceil(s.length / 4);
+  const byRole: Record<string, { msgs: number; tokens: number }> = {};
+  for (const m of history) {
+    const slot = (byRole[m.role] ??= { msgs: 0, tokens: 0 });
+    slot.msgs++;
+    slot.tokens += est(m.content);
+  }
+  const total = Object.values(byRole).reduce((sum, r) => sum + r.tokens, 0);
+  const lines = ["Context usage (estimated, ~4 chars/token):"];
+  for (const [role, r] of Object.entries(byRole)) {
+    lines.push(`  ${role.padEnd(9)} ${String(r.msgs).padStart(3)} msg${r.msgs === 1 ? " " : "s"}  ~${r.tokens} tokens`);
+  }
+  lines.push(`  ${"total".padEnd(9)} ${String(history.length).padStart(3)} msgs  ~${total} tokens${window ? `  (${Math.round((total / window) * 100)}% of ${resolved}'s ${window}-token window)` : ""}`);
+  lines.push("  Free context with /compact or /clear.");
+  return lines;
+}

package/src/commands/launch.ts

@@ -147,6 +147,21 @@ import {
   isWorkflowSkill,
   runWorkflowEngine,
 } from "./launch/workflow";
+import {
+  mentionPaths as mentionPathsIn,
+  currentAtLabel as currentAtLabelFn,
+} from "./launch/mentions";
+import {
+  hotkeysLines,
+  contextUsageLines,
+} from "./launch/slash-views";
+import {
+  handleUsage,
+  handleTools,
+  handleHotkeys,
+  handleContext,
+  type SlashContext,
+} from "./launch/slash-handlers";
 
 export {
   type LaunchFlags,
@@ -192,6 +207,8 @@ export {
   WORKFLOW_NAMES,
   isWorkflowSkill,
   runWorkflowEngine,
+  mentionPathsIn as mentionPaths,
+  currentAtLabelFn as currentAtLabel,
 };
 export function normalizeSlashAlias(input: string): string {
   if (input === "/login" || input.startsWith("/login ")) return `/provider login${input.slice("/login".length)}`;
@@ -1158,31 +1175,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       liveModelsCache ??= r;
     })
     .catch(() => {});
-  const mentionPaths = (prefix: string): string[] => {
-    const norm = prefix.replace(/\\/g, "/");
-    const wantsDirChildren = norm.endsWith("/");
-    const dirPart = wantsDirChildren ? norm.slice(0, -1) : path.posix.dirname(norm) === "." ? "" : path.posix.dirname(norm);
-    const namePart = wantsDirChildren ? "" : path.posix.basename(norm);
-    const absDir = path.resolve(cwd, dirPart || ".");
-    let entries: fs.Dirent[] = [];
-    try {
-      entries = fs.readdirSync(absDir, { withFileTypes: true });
-    } catch {
-      return [];
-    }
-    return entries
-      .filter(entry => !entry.name.startsWith("."))
-      .filter(entry => !namePart || entry.name.toLowerCase().startsWith(namePart.toLowerCase()))
-      .sort((a, b) => {
-        if (a.isDirectory() !== b.isDirectory()) return a.isDirectory() ? -1 : 1;
-        return a.name.localeCompare(b.name);
-      })
-      .slice(0, 50)
-      .map(entry => {
-        const rel = dirPart ? `${dirPart}/${entry.name}` : entry.name;
-        return entry.isDirectory() ? `${rel}/` : rel;
-      });
-  };
+  const mentionPaths = (prefix: string): string[] => mentionPathsIn(cwd, prefix);
   const completionContext = (): CompletionContext => {
     const base = staticCompletionContext();
     return {
@@ -1512,16 +1505,7 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
   // turns/command output so the full-screen turn TUI renders normally. The footer
   // is drawn at absolute rows (per-row clear → no scroll, no duplication).
   // Opt out with JEO_NO_SLASH_PREVIEW=1; auto-off on short terminals.
-  const currentAtLabel = (line: string): string | undefined => {
-    const { tokens } = tokenize(line);
-    const token = [...tokens].reverse().find(t => t.startsWith("@"));
-    if (!token) return undefined;
-    const norm = token.slice(1).replace(/\\/g, "/");
-    if (!norm) return "@ .";
-    if (norm.endsWith("/")) return `@ ${norm.slice(0, -1) || "."}`;
-    const dir = path.posix.dirname(norm);
-    return `@ ${dir === "." ? norm : dir}`;
-  };
+  const currentAtLabel = (line: string): string | undefined => currentAtLabelFn(line);
   // Boxed-input footer height — ADAPTIVE so short terminals/panes still get the single
   // boxed input instead of silently falling back to the raw `jeo>` prompt (previously
   // any terminal under 17 rows lost the box entirely and showed bare CLI input).
@@ -2893,56 +2877,31 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
       }
       // ---- gjc-parity inspection commands ------------------------------------
       if (input === "/usage") {
-        const total = sessionUsage.inputTokens + sessionUsage.outputTokens;
-        console.log("Provider token usage (this REPL):");
-        console.log(`  turns   ${sessionUsage.turns}`);
-        console.log(`  input   ${sessionUsage.inputTokens}`);
-        console.log(`  output  ${sessionUsage.outputTokens}`);
-        console.log(`  total   ${total}${total === 0 ? "  (providers report usage per turn; run a request first)" : ""}`);
+        const cfg = await readGlobalConfig();
+        const ctx: SlashContext = { history, sessionModel, sessionId, cwd, config: cfg };
+        const result = handleUsage(ctx, sessionUsage);
+        if (result && "lines" in result) for (const line of result.lines) console.log(line);
         continue;
       }
       if (input === "/context") {
-        // Token estimate (~4 chars/token) over the in-memory history, by role.
-        const est = (s: string) => Math.ceil(s.length / 4);
-        const byRole: Record<string, { msgs: number; tokens: number }> = {};
-        for (const m of history) {
-          const slot = (byRole[m.role] ??= { msgs: 0, tokens: 0 });
-          slot.msgs++;
-          slot.tokens += est(m.content);
-        }
-        const total = Object.values(byRole).reduce((sum, r) => sum + r.tokens, 0);
-        const { resolved } = await describeModel(sessionModel || (await readGlobalConfig()).defaultModel);
-        const window = catalogMetadata(resolved)?.contextTokens;
-        console.log("Context usage (estimated, ~4 chars/token):");
-        for (const [role, r] of Object.entries(byRole)) {
-          console.log(`  ${role.padEnd(9)} ${String(r.msgs).padStart(3)} msg${r.msgs === 1 ? " " : "s"}  ~${r.tokens} tokens`);
-        }
-        console.log(`  ${"total".padEnd(9)} ${String(history.length).padStart(3)} msgs  ~${total} tokens${window ? `  (${Math.round((total / window) * 100)}% of ${resolved}'s ${window}-token window)` : ""}`);
-        console.log("  Free context with /compact or /clear.");
+        const cfg = await readGlobalConfig();
+        const ctx: SlashContext = { history, sessionModel, sessionId, cwd, config: cfg };
+        const result = await handleContext(ctx);
+        if (result && "lines" in result) for (const line of result.lines) console.log(line);
         continue;
       }
       if (input === "/tools") {
-        console.log("Tools visible to the agent:");
-        for (const line of TOOL_PROTOCOL.split("\n")) console.log(`  ${line}`);
-        console.log(`  ${taskToolProtocolLine(await readGlobalConfig())}`);
-        console.log(`  ${TODO_TOOL_PROTOCOL_LINE}`);
-        console.log(`  ${SUBAGENT_TOOL_PROTOCOL_LINE}`);
+        const cfg = await readGlobalConfig();
+        const ctx: SlashContext = { history, sessionModel, sessionId, cwd, config: cfg };
+        const result = await handleTools(ctx);
+        if (result && "lines" in result) for (const line of result.lines) console.log(line);
         continue;
       }
       if (input === "/hotkeys") {
-        console.log("Keyboard shortcuts:");
-        console.log("  Tab        complete slash commands, models, roles, @paths");
-        console.log("  ↑ / ↓      navigate the slash-command preview (Enter runs the highlighted one)");
-        console.log("  Enter      submit input / confirm picker selection");
-        console.log("  Esc        cancel an open picker");
-        console.log("  Ctrl-C     cancel the in-flight turn (press again at the prompt to exit)");
-        console.log("  Ctrl-D     exit the REPL");
-        console.log("  Ctrl-O     dump the full last response (untruncated, tables rendered) into scrollback");
-        console.log("  Ctrl-K / Ctrl-U / Ctrl-W   kill to end / start of line / previous word (emacs kill-ring)");
-        console.log("  Ctrl-Y / Alt-Y             yank / yank-pop the killed text");
-        console.log("  Ctrl-A / Ctrl-E            move to start / end of line");
-        console.log("  /          open the slash-command palette");
-        console.log("  @path      mention a file (Tab completes relative paths)");
+        const cfg = await readGlobalConfig();
+        const ctx: SlashContext = { history, sessionModel, sessionId, cwd, config: cfg };
+        const result = handleHotkeys(ctx);
+        if (result && "lines" in result) for (const line of result.lines) console.log(line);
         continue;
       }
       if (input === "/theme" || input.startsWith("/theme ")) {