@nanhara/hara 0.111.0 → 0.112.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to `@nanhara/hara`.
 > Versioning (pre-1.0, SemVer-style): the **minor** (middle) number bumps for a **new feature**; the
 > **patch** (last) number bumps for **optimizations/fixes of existing features**.
 
+## 0.112.0 — /jobs: see (and manage) what's running in the background
+
+- **`/jobs` — a user-facing view of the agent's background shell jobs** (dev servers, watchers, long
+  builds started via `bash {background:true}`). hara already tracked these for the *agent* (the `job`
+  tool), but the *user* had no way to glance and see "what's running back there" — the way codex and
+  Claude Code surface it. Now: `/jobs` lists them (id · status · age · command), `/jobs tail <id>`
+  shows recent output, `/jobs kill <id>` stops one. Works in the TUI and the readline REPL.
+- **Status row shows a `⚙ N bg` indicator** when background jobs are running, so a preview server /
+  watcher humming along is visible at a glance (live while working; `/jobs` is the on-demand truth).
+
 ## 0.111.0 — an interactive /model picker: ↑↓ a model, ←→ its thinking
 
 - **`/model` (no argument) now opens an interactive picker** built on the provider registry — the

package/dist/index.js

@@ -44,6 +44,21 @@ import { createAnthropicProvider } from "./providers/anthropic.js";
 import { createOpenAIProvider } from "./providers/openai.js";
 import { resolvePlatform } from "./providers/registry.js";
 import { listModels } from "./providers/models.js";
+import { listJobs, tailJob, killJob } from "./exec/jobs.js";
+/** Render the background-job list for /jobs (user-facing view of what the agent has running in the
+ *  background — dev servers, watchers, long tasks). Mirrors codex/Claude-Code process visibility. */
+function renderBgJobs() {
+    const js = listJobs();
+    if (!js.length)
+        return "(no background jobs — the agent starts them with bash {background:true})";
+    const age = (ms) => (ms < 60_000 ? `${Math.round(ms / 1000)}s` : `${Math.round(ms / 60_000)}m`);
+    const rows = js.map((j) => {
+        const st = j.status === "running" ? "▶ running" : j.status === "killed" ? "✕ killed" : `● exited${j.code != null ? ` (${j.code})` : ""}`;
+        const cmd = j.command.length > 64 ? j.command.slice(0, 64) + "…" : j.command;
+        return `  ${j.id}  ${st}  ${age(j.ageMs).padStart(4)}  ${cmd}`;
+    });
+    return `Background jobs — /jobs tail <id> · /jobs kill <id>:\n${rows.join("\n")}`;
+}
 import { qwenDeviceLogin, getValidQwenAuth } from "./providers/qwen-oauth.js";
 import { loadAgentsMd, hasAgentsMd, INIT_PROMPT, findProjectRoot } from "./context/agents-md.js";
 import { getEmbedder } from "./search/embed.js";
@@ -2517,6 +2532,14 @@ program.action(async (opts) => {
             },
         },
         { name: "usage", desc: "show token usage this session", run: () => void out(statusLine(cfg.model, stats.input, stats.output) + "\n") },
+        { name: "jobs", desc: "list/tail/kill background shell jobs (dev servers, watchers)", run: (a) => {
+                const [sub, jid] = (a || "").trim().split(/\s+/);
+                if (sub === "kill" && jid)
+                    return void out((killJob(jid) ? `✕ killed ${jid}` : `no running job ${jid}`) + "\n");
+                if (sub === "tail" && jid)
+                    return void out((tailJob(jid) ?? `no job ${jid}`) + "\n");
+                out(renderBgJobs() + "\n");
+            } },
         { name: "doctor", desc: "check your hara setup", run: () => void out(runDoctor(cfg) + "\n") },
         {
             name: "roles",
@@ -2990,6 +3013,14 @@ program.action(async (opts) => {
                     }
                     if (nm === "usage")
                         return void h.sink.notice(`tokens — ↑${stats.input} ↓${stats.output}`);
+                    if (nm === "jobs") {
+                        const [sub, jid] = (arg || "").trim().split(/\s+/);
+                        if (sub === "kill" && jid)
+                            return void h.sink.notice(killJob(jid) ? `✕ killed ${jid}` : `no running job ${jid}`);
+                        if (sub === "tail" && jid)
+                            return void h.sink.notice(tailJob(jid) ?? `no job ${jid}`);
+                        return void h.sink.notice(renderBgJobs());
+                    }
                     if (nm === "doctor")
                         return void h.sink.notice(runDoctor(cfg).replace(/\[[0-9;]*m/g, ""));
                     if (nm === "vision")

package/dist/tui/App.js

@@ -18,6 +18,7 @@ import { accent } from "./theme.js";
 import { renderMarkdown } from "../md.js";
 import { clearTodos, currentTodos, onTodosChange } from "../tools/todo.js";
 import { onTurnPhase, turnPhase } from "../agent/phase.js";
+import { listJobs } from "../exec/jobs.js";
 import { ModelPicker } from "./model-picker.js";
 let _id = 0;
 const nid = () => ++_id;
@@ -268,14 +269,19 @@ function StatusRow({ working, todos, queued }) {
         const id = setInterval(() => setFrame((x) => x + 1), SPINNER_FRAME_MS);
         return () => clearInterval(id);
     }, [working]);
+    // Background-job indicator — so the user can SEE what's running in the background (a preview server, a
+    // watcher) without asking. Live while working (spinner ticks re-render); best-effort at idle (/jobs is
+    // the authoritative on-demand view). Re-read each render.
+    const bg = listJobs().filter((j) => j.status === "running").length;
+    const bgTag = bg ? ` · ⚙ ${bg} bg (/jobs)` : "";
     if (!working) {
-        return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `  ${IDLE_HINTS}` }) }));
+        return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `  ${IDLE_HINTS}${bgTag}` }) }));
     }
     const frames = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
     const elapsedSec = Math.floor((Date.now() - startRef.current) / 1000);
     // Pre-first-token honesty (codex-parity): "waiting for the model" reads very differently from a
     // generic "working" when the network is slow — the user knows the request is out, not dead.
-    const verb = phase === "waiting" ? `waiting for the model… ${elapsedSec}s · esc to interrupt` : spinnerVerb(todos, elapsedSec);
+    const verb = (phase === "waiting" ? `waiting for the model… ${elapsedSec}s · esc to interrupt` : spinnerVerb(todos, elapsedSec)) + bgTag;
     return (_jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "yellow", children: frames[frame % frames.length] }), _jsx(Text, { dimColor: true, children: ` ${verb} · ⏎ queues${queued ? ` (${queued})` : ""}` })] }));
 }
 // Short per-mode descriptions for the ONE-ROW mode line (the old two-row ModeBar's long sentences

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.111.0",
+  "version": "0.112.0",
   "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
     "hara": "dist/index.js"