jeo-code 0.5.0 → 0.5.2

package/README.ja.md

@@ -150,11 +150,11 @@ CI は `.github/workflows/npm-publish.yml` で公開します — GitHub リリ
 ## 変更履歴 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.5.2]** (2026-06-14) — `$skill` prompt invocation with prefix/fuzzy suggestions, and a per-session input-box hue (amber in cmd-mode).
+- **[0.5.1]** (2026-06-14) — cmd-mode `!<command>` shell escape — run a shell command without engaging the agent.
 - **[0.5.0]** (2026-06-14) — Performance: workspace-scan, workflow-state, and DNA-Claw HUD caches; plus a credential-safety fix that never wipes OAuth over an invalid config.
 - **[0.4.9]** (2026-06-14) — Live-frame width-clamp (content-sized height) replaces the constant-height approach, typed text shows during a running turn, and a docs/AGENTS refresh.
 - **[0.4.8]** (2026-06-14) — Live-frame stability: constant-height live turn, renderer self-heal off-by-one fix, and frame-safe child-stdout sanitizing — no more duplicate model bar or torn escapes.
-- **[0.4.7]** (2026-06-14) — Detached subagents + `subagent` control tool, live shaded in-flight output, registry-driven providers, fuller `read` budget, styled italics in the final report, and `gjc` retired.
-- **[0.4.6]** (2026-06-14) — Width-correct forge cards for CJK/emoji, red borders on failed tool cards, aligned `ooo ralph` monitor HUD, and a per-theme user-card palette.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.ko.md

@@ -150,11 +150,11 @@ CI는 `.github/workflows/npm-publish.yml`로 배포합니다 — GitHub 릴리
 ## 변경 이력 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.5.2]** (2026-06-14) — `$skill` prompt invocation with prefix/fuzzy suggestions, and a per-session input-box hue (amber in cmd-mode).
+- **[0.5.1]** (2026-06-14) — cmd-mode `!<command>` shell escape — run a shell command without engaging the agent.
 - **[0.5.0]** (2026-06-14) — Performance: workspace-scan, workflow-state, and DNA-Claw HUD caches; plus a credential-safety fix that never wipes OAuth over an invalid config.
 - **[0.4.9]** (2026-06-14) — Live-frame width-clamp (content-sized height) replaces the constant-height approach, typed text shows during a running turn, and a docs/AGENTS refresh.
 - **[0.4.8]** (2026-06-14) — Live-frame stability: constant-height live turn, renderer self-heal off-by-one fix, and frame-safe child-stdout sanitizing — no more duplicate model bar or torn escapes.
-- **[0.4.7]** (2026-06-14) — Detached subagents + `subagent` control tool, live shaded in-flight output, registry-driven providers, fuller `read` budget, styled italics in the final report, and `gjc` retired.
-- **[0.4.6]** (2026-06-14) — Width-correct forge cards for CJK/emoji, red borders on failed tool cards, aligned `ooo ralph` monitor HUD, and a per-theme user-card palette.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.md

@@ -150,11 +150,11 @@ Required npm token permissions (repository secret `NPM_TOKEN`):
 ## Changelog
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.5.2]** (2026-06-14) — `$skill` prompt invocation with prefix/fuzzy suggestions, and a per-session input-box hue (amber in cmd-mode).
+- **[0.5.1]** (2026-06-14) — cmd-mode `!<command>` shell escape — run a shell command without engaging the agent.
 - **[0.5.0]** (2026-06-14) — Performance: workspace-scan, workflow-state, and DNA-Claw HUD caches; plus a credential-safety fix that never wipes OAuth over an invalid config.
 - **[0.4.9]** (2026-06-14) — Live-frame width-clamp (content-sized height) replaces the constant-height approach, typed text shows during a running turn, and a docs/AGENTS refresh.
 - **[0.4.8]** (2026-06-14) — Live-frame stability: constant-height live turn, renderer self-heal off-by-one fix, and frame-safe child-stdout sanitizing — no more duplicate model bar or torn escapes.
-- **[0.4.7]** (2026-06-14) — Detached subagents + `subagent` control tool, live shaded in-flight output, registry-driven providers, fuller `read` budget, styled italics in the final report, and `gjc` retired.
-- **[0.4.6]** (2026-06-14) — Width-correct forge cards for CJK/emoji, red borders on failed tool cards, aligned `ooo ralph` monitor HUD, and a per-theme user-card palette.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.zh.md

@@ -150,11 +150,11 @@ CI 通过 `.github/workflows/npm-publish.yml` 发布 — GitHub 发布 release
 ## 更新日志 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.5.2]** (2026-06-14) — `$skill` prompt invocation with prefix/fuzzy suggestions, and a per-session input-box hue (amber in cmd-mode).
+- **[0.5.1]** (2026-06-14) — cmd-mode `!<command>` shell escape — run a shell command without engaging the agent.
 - **[0.5.0]** (2026-06-14) — Performance: workspace-scan, workflow-state, and DNA-Claw HUD caches; plus a credential-safety fix that never wipes OAuth over an invalid config.
 - **[0.4.9]** (2026-06-14) — Live-frame width-clamp (content-sized height) replaces the constant-height approach, typed text shows during a running turn, and a docs/AGENTS refresh.
 - **[0.4.8]** (2026-06-14) — Live-frame stability: constant-height live turn, renderer self-heal off-by-one fix, and frame-safe child-stdout sanitizing — no more duplicate model bar or torn escapes.
-- **[0.4.7]** (2026-06-14) — Detached subagents + `subagent` control tool, live shaded in-flight output, registry-driven providers, fuller `read` budget, styled italics in the final report, and `gjc` retired.
-- **[0.4.6]** (2026-06-14) — Width-correct forge cards for CJK/emoji, red borders on failed tool cards, aligned `ooo ralph` monitor HUD, and a per-theme user-card palette.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/package.json

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

package/src/commands/launch.ts

@@ -66,7 +66,7 @@ import { stripMarkdown } from "../tui/components/markdown-text";
 import { summarizeForgeInvocation } from "../tui/components/forge";
 import { formatDuration, formatUsage } from "../tui/components/duration";
 
-import { findTool, searchTool } from "../agent/tools";
+import { findTool, searchTool, bashTool } from "../agent/tools";
 import { loadProjectContext, withProjectContext } from "../agent/context-files";
 import { maybeCompact, historyTokens } from "../agent/compaction";
 import * as path from "node:path";
@@ -2148,6 +2148,27 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
   let uiTheme = resolveTheme(process.env);
   let uiAccent = accentPaint(uiTheme);
   let uiAccentShadow = accentShadowPaint(uiTheme);
+  // Input-box border colors. Each opened session gets a DISTINCT hue (so several jeo
+  // sessions are tellable apart at a glance), and cmd-mode (`!`) overrides it with a
+  // caution amber so entering the shell escape is unmistakable.
+  const SESSION_BOX_ACCENTS = ["#48dbfb", "#39ff14", "#a29bfe", "#1dd1a1", "#ff9ff3", "#54a0ff", "#ff6b81", "#c8d6e5"];
+  const CMD_MODE_BOX_ACCENT = "#ffb300";
+  const hexPaint = (hex: string) => (s: string) => chalk.hex(hex)(s);
+  const hexShadowPaint = (hex: string) => (s: string) => chalk.dim(chalk.hex(hex)(s));
+  // Per-process random start so different jeo processes differ at a glance; advanced on
+  // each newly opened session (advanceSessionBoxColor) so consecutive sessions never match.
+  let sessionBoxColorIdx = Math.floor(Math.random() * SESSION_BOX_ACCENTS.length);
+  const advanceSessionBoxColor = (): void => {
+    sessionBoxColorIdx = (sessionBoxColorIdx + 1) % SESSION_BOX_ACCENTS.length;
+  };
+  // Resolve the box painters for the current draft: cmd-mode amber when it starts with
+  // `!`, else the per-session hue, else the theme accent (colorless theme / no session).
+  const boxAccents = (line: string): { accent: (s: string) => string; shadow: (s: string) => string } => {
+    if (!uiTheme.color) return { accent: uiAccent, shadow: uiAccentShadow };
+    if (line.startsWith("!")) return { accent: hexPaint(CMD_MODE_BOX_ACCENT), shadow: hexShadowPaint(CMD_MODE_BOX_ACCENT) };
+    if (sessionId) { const hex = SESSION_BOX_ACCENTS[sessionBoxColorIdx]!; return { accent: hexPaint(hex), shadow: hexShadowPaint(hex) }; }
+    return { accent: uiAccent, shadow: uiAccentShadow };
+  };
   const refreshUiTheme = (): void => {
     uiTheme = resolveTheme(process.env);
     uiAccent = accentPaint(uiTheme);
@@ -2182,12 +2203,13 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
     // sits at the end of the text.
     const rli = rl as unknown as { line?: string; cursor?: number };
     const caret = rli.line === line && typeof rli.cursor === "number" ? rli.cursor : line.length;
+    const { accent: boxAccent, shadow: boxShadow } = boxAccents(line);
     const frame = renderInputFrame(line, {
       cols,
       color: true,
       unicode: true,
-      accent: uiAccent,
-      accentShadow: uiAccentShadow,
+      accent: boxAccent,
+      accentShadow: boxShadow,
       cwdLabel: currentAtLabel(line),
       attachmentLabel: pendingImages.length
         ? `⧉ ${pendingImages.length} image${pendingImages.length > 1 ? "s" : ""} attached — sent with the next message`
@@ -2998,9 +3020,29 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         if (pendingImages.length === 0) continue;
         input = "Please look at the attached image(s)."; // image-only submit
       }
+      // gjc-parity shell escape: `!<cmd>` runs the command directly in cmd-mode and
+      // prints its output WITHOUT engaging the agent (history untouched), like a REPL
+      // shell escape. The user is explicitly driving their own shell, so the deep-interview
+      // mutation guard (which gates the AGENT's tools) does not apply here.
+      if (input.startsWith("!")) {
+        const cmd = input.slice(1).trim();
+        if (!cmd) {
+          console.log("Usage: !<shell command>   (run a command in cmd-mode; the agent and history are untouched)");
+          continue;
+        }
+        try {
+          const res = await bashTool(cmd, cwd);
+          if (res.output) console.log(res.output);
+          if (!res.success && res.error) console.log(chalk.red(res.error));
+        } catch (err) {
+          console.log(chalk.red(`! command failed: ${(err as Error).message}`));
+        }
+        continue;
+      }
       if (input === "/" || input === "/?" || input === "/help") {
         logLines(formatSlashCommandList(input === "/help" ? "/" : input, skillSlashDetails));
         console.log("Tools: read / write / edit / bash / find / search. Sessions persist to .jeo/sessions/.");
+        console.log("Shell: !<command>   runs a command in cmd-mode directly (agent/history untouched).");
         const tip = getEvolutionTip(history.length, flags.maxSteps > 0 ? flags.maxSteps : initialStepLimit);
         console.log(`\n${chalk.cyan("Evolutionary Tip:")} ${tip}`);
         continue;
@@ -3042,6 +3084,7 @@ export async function runLaunchCommand(args: 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;
@@ -4095,6 +4138,25 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         }
         continue;
       }
+      // Unresolved `$skill` → suggest precisely, never silently send the typo to the model.
+      // `$exact`/`$prefix` already ran above; a leftover `$word` is a missed skill attempt,
+      // EXCEPT `$UPPERCASE` env-var-style tokens (e.g. `$HOME`), which pass through untouched.
+      if (input.startsWith("$")) {
+        const token = (input.split(/\s+/, 1)[0] ?? "").slice(1);
+        if (token && !/^[A-Z_][A-Z0-9_]*$/.test(token)) {
+          const lc = token.toLowerCase();
+          const prefix = resolvedSkills.filter(s => s.name.toLowerCase().startsWith(lc));
+          if (prefix.length) {
+            console.log(`Ambiguous skill '$${token}'. Did you mean: ${prefix.slice(0, 6).map(s => `$${s.name}`).join(", ")}?`);
+          } else {
+            const names = resolvedSkills.map(s => `$${s.name}`);
+            const shown = names.slice(0, 12).join(", ");
+            const more = names.length > 12 ? ` … +${names.length - 12} more` : "";
+            console.log(`No skill '$${token}'. ${names.length ? `Available: ${shown}${more}` : "No skills are loaded."}  (Type $ to autocomplete.)`);
+          }
+          continue;
+        }
+      }
       // Unhandled slash attempt → suggest, don't send the typo to the model.
       if (isSlashAttempt(input)) {
         const m = matchSlash(input, [...completionContext().slashCommands]);

package/src/skills/catalog.ts

@@ -475,6 +475,32 @@ export function getSkillFrom(skills: SkillDoc[], name: string): SkillDoc | undef
   return skills.find(s => s.name.toLowerCase() === name.toLowerCase());
 }
 
+/** The single skill whose name PREFIX-matches `query` (case-insensitive), or undefined
+ *  when zero or many match. Lets `$te` precisely resolve to `$team` without full spelling. */
+export function uniquePrefixSkill(skills: SkillDoc[], query: string): SkillDoc | undefined {
+  const q = query.toLowerCase();
+  if (!q) return undefined;
+  const hits = skills.filter(s => s.name.toLowerCase().startsWith(q));
+  return hits.length === 1 ? hits[0] : undefined;
+}
+
+/** Prefix-first, then fuzzy-subsequence skill suggestions for a `$query` that did NOT
+ *  resolve — drives the REPL's clear "did you mean / available" feedback. */
+export function suggestSkills(skills: SkillDoc[], query: string): SkillDoc[] {
+  const q = query.toLowerCase();
+  const prefix = skills.filter(s => s.name.toLowerCase().startsWith(q));
+  const seen = new Set(prefix.map(s => s.name));
+  const fuzzy = skills.filter(s => !seen.has(s.name) && skillNameSubsequence(q, s.name.toLowerCase()));
+  return [...prefix, ...fuzzy];
+}
+
+/** Order-preserving subsequence test (every char of `needle` appears in `hay` L→R). */
+function skillNameSubsequence(needle: string, hay: string): boolean {
+  let i = 0;
+  for (let j = 0; j < hay.length && i < needle.length; j++) if (hay[j] === needle[i]) i++;
+  return i === needle.length;
+}
+
 /** Case-insensitive lookup by direct slash alias, e.g. `/speckit.plan`. */
 export function getSkillBySlash(skills: SkillDoc[], command: string): SkillDoc | undefined {
   const q = command.toLowerCase();
@@ -514,7 +540,7 @@ export function parseSkillInvocation(input: string, skills: SkillDoc[]): SkillIn
   // 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));
+    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 };
     }