jeo-code 0.7.21 → 0.7.22

package/CHANGELOG.md

@@ -6,6 +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.7.22] - 2026-06-30
+_gajae-code 0.7.3–0.7.8 parity sweep: terminal-bell notifications, a gruvbox-dark TUI theme, a resilient `jeo update` runtime check, and an ultragoal artifact gate. Ports the user-facing improvements from upstream gajae-code that jeo did not yet have, re-implemented to fit jeo's config, command, theming, and skill surfaces._
+
+### Added
+- **Terminal-bell notifications (`notify.bell` / `JEO_NOTIFY_BELL`).** gajae-code 0.7.8 (#1277) parity. Emits an ASCII BEL when an agent turn finishes so a backgrounded `jeo` session pings you. Off by default; opt in with `config.notify.bell` (per-event `onComplete`/`onAsk` refine it) or force with `JEO_NOTIFY_BELL=1`/`0`. Never fires for a cancelled turn, and a dead terminal never crashes the turn.
+- **gruvbox-dark TUI theme.** New `JEO_TUI_THEME=gruvbox-dark` option alongside the existing themes.
+
+### Fixed
+- **`jeo update` no longer reports false failures from Bun tarball-extraction errors.** gajae-code 0.7.8 (#1280) parity. When the package manager exits nonzero but the active `jeo` on PATH actually reports the requested version, the update is treated as recovered (with a clear message and `recovered: true` in `--json`) instead of failing; genuine failures still exit 1.
+
+### Changed
+- **ultragoal artifact gate.** gajae-code 0.7.4 (#1163) parity. The completion report must cite concrete verification artifacts — exact commands and their observed results, plus changed-file paths tied to each acceptance criterion — and must explicitly mark any unverifiable criterion as unresolved rather than implying success.
+
 ## [0.7.21] - 2026-06-26
 _Global llm-wiki vault integration, Gemini/Antigravity thinking indicators, generous file-reading windows, and autopilot flag validation. Adds a shared global wiki root configuration with a /wiki slash command, fires reasoning start signals up front for Gemini/Antigravity models, adjusts the large-file reading discipline to use generous windows, and validates autopilot goal and integer flags._
 

package/README.ja.md

@@ -179,7 +179,7 @@ jeo doctor && jeo
 ANTHROPIC_API_KEY=... OPENAI_API_KEY=... GEMINI_API_KEY=...
 JEO_DEFAULT_MODEL=...           # 例: ollama/qwen2.5:0.5b
 OLLAMA_HOST=http://localhost:11434
-JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura
+JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura/gruvbox-dark
 JEO_TUI_ALT_SCREEN=1            # レガシー alt-screen ターン(デフォルト: インラインスクロールバック)
 JEO_STEP_BASE=24                # 動的ステップ予算のローリングベース
 JEO_STEP_HARD_CAP=600           # 絶対終了保証
@@ -205,11 +205,11 @@ CI は `.github/workflows/npm-publish.yml` で公開します — GitHub リリ
 ## 変更履歴 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.7.22]** (2026-06-30) — gajae-code 0.7.3–0.7.8 parity sweep: terminal-bell notifications, a gruvbox-dark TUI theme, a resilient `jeo update` runtime check, and an ultragoal artifact gate. Ports the user-facing improvements from upstream gajae-code that jeo did not yet have, re-implemented to fit jeo's config, command, theming, and skill surfaces.
 - **[0.7.21]** (2026-06-26) — Global llm-wiki vault integration, Gemini/Antigravity thinking indicators, generous file-reading windows, and autopilot flag validation. Adds a shared global wiki root configuration with a /wiki slash command, fires reasoning start signals up front for Gemini/Antigravity models, adjusts the large-file reading discipline to use generous windows, and validates autopilot goal and integer flags.
 - **[0.7.20]** (2026-06-26) — OKF concept-memory retrieval gains a hybrid reranker ported from memsearch. Injection priority no longer rides one raw keyword score — it fuses two complementary ranked channels by Reciprocal Rank Fusion (RRF): IDF-weighted lexical relevance (the sparse/BM25 channel, so rare discriminating terms steer recall) and concept-graph proximity (the local dense/semantic-neighbour channel, so a hub linked from multiple query hits surfaces even with no keyword of its own). All embedding-free and deterministic, layered atop the existing failure-first tier and pinned-invariant reserved budget.
 - **[0.7.19]** (2026-06-26) — The live model picker gains gajae-code's `/model` provider tabs, and skill invocation is consolidated onto a single `$` entrypoint. The picker now shows an `ALL` tab plus one tab per provider that `tab`/`shift+tab` cycles, and skills (including their declared aliases) are invoked only via `$` — the slash palette stays builtins-only.
 - **[0.7.18]** (2026-06-26) — Slash-command discovery and the `/model` flow reach gajae-code parity. The slash palette/autocomplete now fuzzy-matches command names (with a description fallback for intent-style queries), resolved skills can contribute their own `/aliases` as real dispatchable commands, and `/model` runs gjc's two-menu target → reasoning flow so a picked model can be assigned to the default or any subagent role with its own thinking budget.
-- **[0.7.17]** (2026-06-25) — Developer workflow parity (gjc `dev:link`/`dev:doctor`, adapted for jeo's zero-native-dep Bun runtime): the global `jeo` command can be linked to run this checkout's source hot to every edit, with a drift doctor that flags when `jeo` resolves to a compiled binary or an installed copy instead. README gains "Skill migration and bundled skill inspection" + "Development" sections. Also ships OKF concept-memory search/scoring with budget-aware injection and a round of workflow-prompt hardening (anti-punt, todo-first planning, verdict discipline) that keeps every loop escape hatch intact.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.ko.md

@@ -179,7 +179,7 @@ jeo doctor && jeo
 ANTHROPIC_API_KEY=... OPENAI_API_KEY=... GEMINI_API_KEY=...
 JEO_DEFAULT_MODEL=...           # 예: ollama/qwen2.5:0.5b
 OLLAMA_HOST=http://localhost:11434
-JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura
+JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura/gruvbox-dark
 JEO_TUI_ALT_SCREEN=1            # 레거시 alt-screen 턴(기본: 인라인 스크롤백)
 JEO_STEP_BASE=24                # 동적 스텝 버짓의 롤링 베이스
 JEO_STEP_HARD_CAP=600           # 절대 종료 보증
@@ -205,11 +205,11 @@ CI는 `.github/workflows/npm-publish.yml`로 배포합니다 — GitHub 릴리
 ## 변경 이력 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.7.22]** (2026-06-30) — gajae-code 0.7.3–0.7.8 parity sweep: terminal-bell notifications, a gruvbox-dark TUI theme, a resilient `jeo update` runtime check, and an ultragoal artifact gate. Ports the user-facing improvements from upstream gajae-code that jeo did not yet have, re-implemented to fit jeo's config, command, theming, and skill surfaces.
 - **[0.7.21]** (2026-06-26) — Global llm-wiki vault integration, Gemini/Antigravity thinking indicators, generous file-reading windows, and autopilot flag validation. Adds a shared global wiki root configuration with a /wiki slash command, fires reasoning start signals up front for Gemini/Antigravity models, adjusts the large-file reading discipline to use generous windows, and validates autopilot goal and integer flags.
 - **[0.7.20]** (2026-06-26) — OKF concept-memory retrieval gains a hybrid reranker ported from memsearch. Injection priority no longer rides one raw keyword score — it fuses two complementary ranked channels by Reciprocal Rank Fusion (RRF): IDF-weighted lexical relevance (the sparse/BM25 channel, so rare discriminating terms steer recall) and concept-graph proximity (the local dense/semantic-neighbour channel, so a hub linked from multiple query hits surfaces even with no keyword of its own). All embedding-free and deterministic, layered atop the existing failure-first tier and pinned-invariant reserved budget.
 - **[0.7.19]** (2026-06-26) — The live model picker gains gajae-code's `/model` provider tabs, and skill invocation is consolidated onto a single `$` entrypoint. The picker now shows an `ALL` tab plus one tab per provider that `tab`/`shift+tab` cycles, and skills (including their declared aliases) are invoked only via `$` — the slash palette stays builtins-only.
 - **[0.7.18]** (2026-06-26) — Slash-command discovery and the `/model` flow reach gajae-code parity. The slash palette/autocomplete now fuzzy-matches command names (with a description fallback for intent-style queries), resolved skills can contribute their own `/aliases` as real dispatchable commands, and `/model` runs gjc's two-menu target → reasoning flow so a picked model can be assigned to the default or any subagent role with its own thinking budget.
-- **[0.7.17]** (2026-06-25) — Developer workflow parity (gjc `dev:link`/`dev:doctor`, adapted for jeo's zero-native-dep Bun runtime): the global `jeo` command can be linked to run this checkout's source hot to every edit, with a drift doctor that flags when `jeo` resolves to a compiled binary or an installed copy instead. README gains "Skill migration and bundled skill inspection" + "Development" sections. Also ships OKF concept-memory search/scoring with budget-aware injection and a round of workflow-prompt hardening (anti-punt, todo-first planning, verdict discipline) that keeps every loop escape hatch intact.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.md

@@ -180,7 +180,7 @@ jeo doctor && jeo
 ANTHROPIC_API_KEY=... OPENAI_API_KEY=... GEMINI_API_KEY=...
 JEO_DEFAULT_MODEL=...           # e.g. ollama/qwen2.5:0.5b
 OLLAMA_HOST=http://localhost:11434
-JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura
+JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura/gruvbox-dark
 JEO_TUI_ALT_SCREEN=1            # legacy alt-screen turn (default: inline scrollback)
 JEO_STEP_BASE=24                # dynamic step budget: rolling base
 JEO_STEP_HARD_CAP=600           # absolute termination guarantee
@@ -232,11 +232,11 @@ Huge thanks to [gajae-code](https://github.com/Yeachan-Heo/gajae-code) for the i
 ## Changelog
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.7.22]** (2026-06-30) — gajae-code 0.7.3–0.7.8 parity sweep: terminal-bell notifications, a gruvbox-dark TUI theme, a resilient `jeo update` runtime check, and an ultragoal artifact gate. Ports the user-facing improvements from upstream gajae-code that jeo did not yet have, re-implemented to fit jeo's config, command, theming, and skill surfaces.
 - **[0.7.21]** (2026-06-26) — Global llm-wiki vault integration, Gemini/Antigravity thinking indicators, generous file-reading windows, and autopilot flag validation. Adds a shared global wiki root configuration with a /wiki slash command, fires reasoning start signals up front for Gemini/Antigravity models, adjusts the large-file reading discipline to use generous windows, and validates autopilot goal and integer flags.
 - **[0.7.20]** (2026-06-26) — OKF concept-memory retrieval gains a hybrid reranker ported from memsearch. Injection priority no longer rides one raw keyword score — it fuses two complementary ranked channels by Reciprocal Rank Fusion (RRF): IDF-weighted lexical relevance (the sparse/BM25 channel, so rare discriminating terms steer recall) and concept-graph proximity (the local dense/semantic-neighbour channel, so a hub linked from multiple query hits surfaces even with no keyword of its own). All embedding-free and deterministic, layered atop the existing failure-first tier and pinned-invariant reserved budget.
 - **[0.7.19]** (2026-06-26) — The live model picker gains gajae-code's `/model` provider tabs, and skill invocation is consolidated onto a single `$` entrypoint. The picker now shows an `ALL` tab plus one tab per provider that `tab`/`shift+tab` cycles, and skills (including their declared aliases) are invoked only via `$` — the slash palette stays builtins-only.
 - **[0.7.18]** (2026-06-26) — Slash-command discovery and the `/model` flow reach gajae-code parity. The slash palette/autocomplete now fuzzy-matches command names (with a description fallback for intent-style queries), resolved skills can contribute their own `/aliases` as real dispatchable commands, and `/model` runs gjc's two-menu target → reasoning flow so a picked model can be assigned to the default or any subagent role with its own thinking budget.
-- **[0.7.17]** (2026-06-25) — Developer workflow parity (gjc `dev:link`/`dev:doctor`, adapted for jeo's zero-native-dep Bun runtime): the global `jeo` command can be linked to run this checkout's source hot to every edit, with a drift doctor that flags when `jeo` resolves to a compiled binary or an installed copy instead. README gains "Skill migration and bundled skill inspection" + "Development" sections. Also ships OKF concept-memory search/scoring with budget-aware injection and a round of workflow-prompt hardening (anti-punt, todo-first planning, verdict discipline) that keeps every loop escape hatch intact.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/README.zh.md

@@ -179,7 +179,7 @@ jeo doctor && jeo
 ANTHROPIC_API_KEY=... OPENAI_API_KEY=... GEMINI_API_KEY=...
 JEO_DEFAULT_MODEL=...           # 例: ollama/qwen2.5:0.5b
 OLLAMA_HOST=http://localhost:11434
-JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura
+JEO_TUI_THEME=cosmic            # cosmic/matrix/solar/red-claw/blue-crab/mono/aurora/synthwave/sakura/gruvbox-dark
 JEO_TUI_ALT_SCREEN=1            # 旧版 alt-screen 回合(默认: 内联滚动缓冲)
 JEO_STEP_BASE=24                # 动态步数预算的滚动基数
 JEO_STEP_HARD_CAP=600           # 绝对终止保证
@@ -205,11 +205,11 @@ CI 通过 `.github/workflows/npm-publish.yml` 发布 — GitHub 发布 release
 ## 更新日志 (Changelog)
 
 <!-- CHANGELOG:START (auto-generated from CHANGELOG.md — run `bun run changelog:sync`) -->
+- **[0.7.22]** (2026-06-30) — gajae-code 0.7.3–0.7.8 parity sweep: terminal-bell notifications, a gruvbox-dark TUI theme, a resilient `jeo update` runtime check, and an ultragoal artifact gate. Ports the user-facing improvements from upstream gajae-code that jeo did not yet have, re-implemented to fit jeo's config, command, theming, and skill surfaces.
 - **[0.7.21]** (2026-06-26) — Global llm-wiki vault integration, Gemini/Antigravity thinking indicators, generous file-reading windows, and autopilot flag validation. Adds a shared global wiki root configuration with a /wiki slash command, fires reasoning start signals up front for Gemini/Antigravity models, adjusts the large-file reading discipline to use generous windows, and validates autopilot goal and integer flags.
 - **[0.7.20]** (2026-06-26) — OKF concept-memory retrieval gains a hybrid reranker ported from memsearch. Injection priority no longer rides one raw keyword score — it fuses two complementary ranked channels by Reciprocal Rank Fusion (RRF): IDF-weighted lexical relevance (the sparse/BM25 channel, so rare discriminating terms steer recall) and concept-graph proximity (the local dense/semantic-neighbour channel, so a hub linked from multiple query hits surfaces even with no keyword of its own). All embedding-free and deterministic, layered atop the existing failure-first tier and pinned-invariant reserved budget.
 - **[0.7.19]** (2026-06-26) — The live model picker gains gajae-code's `/model` provider tabs, and skill invocation is consolidated onto a single `$` entrypoint. The picker now shows an `ALL` tab plus one tab per provider that `tab`/`shift+tab` cycles, and skills (including their declared aliases) are invoked only via `$` — the slash palette stays builtins-only.
 - **[0.7.18]** (2026-06-26) — Slash-command discovery and the `/model` flow reach gajae-code parity. The slash palette/autocomplete now fuzzy-matches command names (with a description fallback for intent-style queries), resolved skills can contribute their own `/aliases` as real dispatchable commands, and `/model` runs gjc's two-menu target → reasoning flow so a picked model can be assigned to the default or any subagent role with its own thinking budget.
-- **[0.7.17]** (2026-06-25) — Developer workflow parity (gjc `dev:link`/`dev:doctor`, adapted for jeo's zero-native-dep Bun runtime): the global `jeo` command can be linked to run this checkout's source hot to every edit, with a drift doctor that flags when `jeo` resolves to a compiled binary or an installed copy instead. README gains "Skill migration and bundled skill inspection" + "Development" sections. Also ships OKF concept-memory search/scoring with budget-aware injection and a round of workflow-prompt hardening (anti-punt, todo-first planning, verdict discipline) that keeps every loop escape hatch intact.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full history.
 <!-- CHANGELOG:END -->

package/package.json

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

package/src/agent/config-schema.ts

@@ -73,6 +73,17 @@ export const ConfigSchema = z
     lmstudioBaseUrl: z.string().optional(),
     defaultModel: z.string().min(1),
     theme: z.string().optional(),
+    /** Terminal-bell notifications (gajae-code 0.7.8 parity): emit an ASCII BEL
+     *  (\x07) at notable interaction points so a backgrounded session pings the
+     *  user. Off by default; `bell` is the master toggle, per-event flags refine it.
+     *  Env `JEO_NOTIFY_BELL=1/0` force-overrides the master toggle. */
+    notify: z
+      .object({
+        bell: z.boolean().optional(),
+        onComplete: z.boolean().optional(),
+        onAsk: z.boolean().optional(),
+      })
+      .optional(),
     /** Root path of the global llm-wiki vault, shared across every session
      *  regardless of project/cwd. A leading `~` is expanded; env `JEO_WIKI_ROOT`
      *  overrides. Consumed by `resolveWikiRoot` and injected into the prompt. */

package/src/agent/state.ts

@@ -51,6 +51,13 @@ export interface Config {
    *  overrides. Resolve with `resolveWikiRoot()`. */
   wikiRoot?: string;
   theme?: string;
+  /** Terminal-bell notifications (gajae-code 0.7.8 parity). `bell` is the master
+   *  toggle; per-event flags refine it. Env `JEO_NOTIFY_BELL=1/0` force-overrides. */
+  notify?: {
+    bell?: boolean;
+    onComplete?: boolean;
+    onAsk?: boolean;
+  };
   thinkingLevel?: "minimal" | "low" | "medium" | "high" | "xhigh";
   /** Friendly model aliases, e.g. { fast: "ollama/qwen2.5:0.5b" }. Override built-ins. */
   modelAliases?: { [alias: string]: string };

package/src/commands/launch.ts

@@ -29,6 +29,7 @@ import { checkForUpdate, readUpdateCache, writeUpdateCache } from "../util/updat
 import { jeoEnv } from "../util/env";
 import { renderUpdateBox } from "../tui/components/update-box";
 import { consumeLaunchWhatsNew } from "../util/whats-new";
+import { maybeBell } from "../util/notify";
 import { supportsUnicode } from "../tui/components/capability";
 import pkg from "../../package.json";
 import chalk from "chalk";
@@ -4486,6 +4487,10 @@ export async function runLaunchCommand(args: string[]): Promise<void> {
         } else if (usage) {
           console.log(usage.trim());
         }
+        // gajae-code 0.7.8 parity: ping the terminal bell when a turn finishes so a
+        // backgrounded session notifies the user. Off unless config.notify.bell (or
+        // JEO_NOTIFY_BELL=1) is set; never fires for a cancelled turn.
+        if (reply !== "Cancelled.") maybeBell("complete", cfg.notify, (s) => out.write(s), process.env as Record<string, string | undefined>);
       } catch (err) {
         console.log(`! ${friendlyProviderError(err)}`);
       }

package/src/commands/update.ts

@@ -235,18 +235,38 @@ export async function runUpdateCommandWith(args: string[], deps: UpdateDeps): Pr
             deps.showWhatsNew?.();
           }
         } else {
-          if (hasJson) {
-            console.log(JSON.stringify({
-              current,
-              latest,
-              upToDate: false,
-              installed: false,
-              error: "Installation failed"
-            }));
+          // gajae-code 0.7.8 parity (#1280): a nonzero bun/npm exit is NOT always a
+          // real failure — Bun tarball-extraction errors can exit nonzero AFTER the
+          // requested version actually landed. Before reporting failure, verify the
+          // active `jeo` on PATH: if it now reports >= latest, treat it as recovered.
+          const recovered = deps.activeVersion?.();
+          if (recovered && latest && compareVersions(recovered, latest) >= 0) {
+            if (hasJson) {
+              console.log(JSON.stringify({
+                current,
+                latest,
+                upToDate: false,
+                installed: true,
+                recovered: true
+              }));
+            } else {
+              console.log(`Successfully installed jeo-code@${latest} (package manager reported an error, but the runtime verified clean).`);
+              deps.showWhatsNew?.();
+            }
           } else {
-            console.error("Failed to install update.");
+            if (hasJson) {
+              console.log(JSON.stringify({
+                current,
+                latest,
+                upToDate: false,
+                installed: false,
+                error: "Installation failed"
+              }));
+            } else {
+              console.error("Failed to install update.");
+            }
+            process.exitCode = 1;
           }
-          process.exitCode = 1;
         }
       } catch (installErr: any) {
         const installErrMsg = installErr.message || String(installErr);

package/src/prompts/skills/ultragoal/SKILL.md

@@ -9,3 +9,15 @@ when: When tasks are implemented and you need a final, high-level verification a
 Verifies the implementation against the acceptance criteria specified in the plan.
 Runs checks, tests, or validations to ensure correctness.
 Generates a final completion report outlining the changes and verification evidence.
+
+## Artifact gate (gajae-code 0.7.4 parity)
+
+The completion report must be backed by concrete artifacts, not assertions:
+- Cite the exact verification commands run and their observed result (e.g. test
+  counts, `typecheck` clean, build exit code) — never claim "tests pass" without
+  the command and its output.
+- Reference each changed file by path, and tie it to the acceptance criterion it
+  satisfies.
+- If an acceptance criterion could not be verified (missing credential, service,
+  or product decision), say so explicitly and mark it unresolved rather than
+  implying success. A criterion with no supporting artifact is NOT met.

package/src/tui/components/themes.ts

@@ -181,6 +181,25 @@ const SAKURA: EvolutionTheme = {
   userCard: { accent: "#d6336c", border: "#862e59", shadow: "#43172c", fill: "#210b16" },
 };
 
+const GRUVBOX_DARK: EvolutionTheme = {
+  name: "gruvbox-dark",
+  description: "Gruvbox dark — warm retro earth tones arcing from bark to cream (canonical Gruvbox palette).",
+  gradients: [
+    { from: "#282828", to: "#d65d0e" },
+    { from: "#d65d0e", to: "#fe8019" },
+    { from: "#fe8019", to: "#fabd2f" },
+    { from: "#fabd2f", to: "#b8bb26" },
+    { from: "#b8bb26", to: "#ebdbb2" },
+  ],
+  color: true,
+  accent: "#fabd2f",
+  accentShadow: "#79740e",
+  diff: { add: "#b8bb26", del: "#fb4934", addBg: "#1c2611", delBg: "#2a1416", hunk: "#8ec07c" },
+  userCard: { accent: "#fabd2f", border: "#79740e", shadow: "#3c3836", fill: "#282828" },
+  muted: "#a89984",
+  card: { fill: "#32302f" },
+};
+
 const MONO: EvolutionTheme = {
   name: "mono",
   description: "Colorless — plain text for NO_COLOR / minimal terminals.",
@@ -189,7 +208,7 @@ const MONO: EvolutionTheme = {
   accent: "#ffffff",
 };
 
-export const THEMES: readonly EvolutionTheme[] = [COSMIC, MATRIX, SOLAR, RED_CLAW, BLUE_CRAB, AURORA, SYNTHWAVE, SAKURA, MONO];
+export const THEMES: readonly EvolutionTheme[] = [COSMIC, MATRIX, SOLAR, RED_CLAW, BLUE_CRAB, AURORA, SYNTHWAVE, SAKURA, GRUVBOX_DARK, MONO];
 
 /** Look up a theme by name (case-insensitive); unknown names fall back to cosmic. */
 export function getTheme(name: string | undefined): EvolutionTheme {

package/src/util/notify.ts

@@ -0,0 +1,73 @@
+/**
+ * Terminal-bell notifications (gajae-code 0.7.8 parity).
+ *
+ * Emits an ASCII BEL (`\x07`) to the controlling terminal at notable
+ * interaction points so a backgrounded `jeo` session pings the user when it
+ * finishes a turn or stops to ask for input. Off by default; opt in through
+ * `config.notify.bell` (or force with `JEO_NOTIFY_BELL=1`).
+ *
+ * The decision logic (`shouldBell`) is pure and env-injectable so it is unit
+ * testable without a real terminal; `emitBell` is the only side effect.
+ */
+
+export type NotifyEvent = "complete" | "ask" | "approval";
+
+export interface NotifyConfig {
+  /** Master toggle — no bell fires unless this is true (or the env override is set). */
+  bell?: boolean;
+  /** Bell when an agent turn finishes (default: on when the master toggle is on). */
+  onComplete?: boolean;
+  /** Bell when an ask / approval prompt awaits the user (default: on when master on). */
+  onAsk?: boolean;
+}
+
+type EnvLike = Record<string, string | undefined>;
+
+/**
+ * Decide whether a terminal bell should fire for `event`.
+ *
+ * Precedence: `JEO_NOTIFY_BELL` env force-overrides the config master toggle
+ * (`1`/`true` forces on, `0`/`false` forces off). When the master toggle is on,
+ * each event is enabled unless its per-event flag is explicitly `false`.
+ */
+export function shouldBell(
+  event: NotifyEvent,
+  config: NotifyConfig | undefined,
+  env: EnvLike = {},
+): boolean {
+  const raw = env.JEO_NOTIFY_BELL;
+  const envForceOn = raw === "1" || raw === "true";
+  const envForceOff = raw === "0" || raw === "false";
+  const masterOn = envForceOn || (!envForceOff && config?.bell === true);
+  if (!masterOn) return false;
+  switch (event) {
+    case "complete":
+      return config?.onComplete !== false;
+    case "ask":
+    case "approval":
+      return config?.onAsk !== false;
+    default:
+      return false;
+  }
+}
+
+/** Write a single ASCII BEL to `write` (best-effort; a dead terminal never throws). */
+export function emitBell(write: (s: string) => void): void {
+  try {
+    write("\x07");
+  } catch {
+    /* terminal gone — a courtesy bell must never crash a turn */
+  }
+}
+
+/** Convenience: emit a bell for `event` iff `shouldBell` allows it. */
+export function maybeBell(
+  event: NotifyEvent,
+  config: NotifyConfig | undefined,
+  write: (s: string) => void,
+  env: EnvLike = {},
+): boolean {
+  if (!shouldBell(event, config, env)) return false;
+  emitBell(write);
+  return true;
+}