tmux-ide 2.6.1 → 2.7.0

package/bin/cli.ts

@@ -9,8 +9,17 @@ import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
+// The node-runnable CLI path that spawned TUI surfaces shell back to (the app's
+// async fleet poll + `detect --write`). When we're the published `bin/cli.js`
+// this file IS it; under dev (`bun bin/cli.ts`) it's the built sibling
+// `bin/cli.js`. Forwarded to surfaces as TMUX_IDE_CLI so the COMPILED TUI binary
+// — whose own `import.meta.url` is a virtual bunfs path with no real cli.js next
+// to it — can still find the CLI to run its subprocesses.
+const selfPath = fileURLToPath(import.meta.url);
+const nodeCliPath = selfPath.endsWith(".js") ? selfPath : resolve(__dirname, "cli.js");
 import { launch } from "../packages/daemon/src/launch.ts";
-import { shouldOpenCockpit } from "../packages/daemon/src/tui/team/entry.ts";
+import { resolveEntry } from "../packages/daemon/src/tui/team/entry.ts";
+import { loadAppConfig } from "../packages/daemon/src/lib/app-config.ts";
 import {
   resolveTuiLaunch,
   findCompiledTui,
@@ -110,6 +119,7 @@ const knownCommands = new Set([
   "send",
   "settings",
   "team",
+  "app",
   "switcher",
   "wait",
   "events",
@@ -177,6 +187,7 @@ ${bold("Usage:")}
                               ${dim("(--resume-agents revives claude conversations via claude --resume)")}
   ${cyan("tmux-ide attach")}             ${dim("Reattach to a running session")}
   ${cyan("tmux-ide team")} [--json]      ${dim("TUI over all tmux sessions (--json prints fleet state)")}
+  ${cyan("tmux-ide app")} [session]      ${dim("Unified app: fleet home + live session mirror (bare = home)")}
   ${cyan("tmux-ide switcher")}           ${dim("Compact session picker (opens in the M-p popup on adopted sessions)")}
   ${cyan("tmux-ide wait agent-status")} <session> --status <s> [--timeout <ms>]
                               ${dim("Block until a session reaches a status (exit 0 match / 1 timeout)")}
@@ -269,7 +280,12 @@ function execBunWidget(
     );
   }
 
-  const env = { ...process.env, TMUX_IDE_CWD: process.cwd(), ...extraEnv };
+  const env = {
+    ...process.env,
+    TMUX_IDE_CWD: process.cwd(),
+    TMUX_IDE_CLI: nodeCliPath,
+    ...extraEnv,
+  };
   if (launch.mode === "bun") {
     // Spawn from the repo root so bun finds `bunfig.toml` (the @opentui/solid
     // JSX preload). Without this, running from any other cwd — e.g. bare
@@ -302,6 +318,7 @@ async function printFleetJson(): Promise<void> {
 }
 
 const teamScriptPath = resolve(__dirname, "../packages/daemon/src/tui/team/index.tsx");
+const appScriptPath = resolve(__dirname, "../packages/daemon/src/tui/mirror/app.tsx");
 
 // `tmux-ide team` runs the standalone full-screen cockpit (the OpenTUI app owns
 // the whole terminal). The floating switcher popup (M-p on adopted sessions)
@@ -310,6 +327,13 @@ function launchTeamCockpit(): void {
   execBunWidget("team", teamScriptPath, [], "team");
 }
 
+// The unified app as the front door (M22.6): bare `tmux-ide` opens `tmux-ide
+// app`'s HOME panel when `app.frontDoor` is on and there's nothing else to
+// launch. Same entry as the explicit `app` command with no session positional.
+function launchApp(): void {
+  execBunWidget("app", appScriptPath, [], "app");
+}
+
 try {
   switch (command) {
     case "start": {
@@ -332,13 +356,23 @@ try {
       }
       const targetDir = resolve(startTargetDir || ".");
       const hasIdeYml = existsSync(join(targetDir, "ide.yml"));
-      if (shouldOpenCockpit(hasIdeYml, values.team === true)) {
-        // No project here (or --team): the cockpit is the front door.
+      // M22.6 — the front-door decision. `--team` always means the classic
+      // cockpit; a present ide.yml still auto-launches the project; otherwise
+      // `app.frontDoor` flips the default no-project entry to the unified app.
+      const entry = resolveEntry({
+        hasIdeYml,
+        teamFlag: values.team === true,
+        frontDoor: loadAppConfig().app.frontDoor,
+      });
+      if (entry !== "project") {
+        // No project to launch here. `--json` is a scripting surface — it always
+        // prints the fleet, whichever interactive front door is configured.
         if (json) {
           await printFleetJson();
           break;
         }
-        launchTeamCockpit();
+        if (entry === "app") launchApp();
+        else launchTeamCockpit();
         break;
       }
       await launch(startTargetDir, { json });
@@ -491,6 +525,16 @@ try {
       break;
     }
 
+    case "app": {
+      // The unified app (M18.1): sidebar fleet + a live tmux-session mirror.
+      // Bare `tmux-ide app` opens the HOME panel (fleet cards); an optional
+      // session positional boots straight into that session's mirror.
+      const session = positionals[1];
+      const appArgs = session ? [`--target=${session}`] : [];
+      execBunWidget("app", appScriptPath, appArgs, "app");
+      break;
+    }
+
     case "switcher": {
       // Runs the team app in PICKER mode inside a tmux `display-popup` (bound to
       // `M-p` on adopt). Picking a session `switch-client`s the invoking client
@@ -1338,6 +1382,19 @@ try {
     }
 
     case "update": {
+      // `--tui-binary`: download the per-platform TUI binary (the fallback that
+      // lets an npm install with no bun run the full cockpit). Explicit opt-in —
+      // never auto-fetched on install (it's ~70MB). See lib/tui-binary.ts.
+      if (values["tui-binary"] === true) {
+        const { downloadTuiBinary } = await import("../packages/daemon/src/lib/tui-binary.ts");
+        const { path } = await downloadTuiBinary({ log: (m) => console.error(m) });
+        if (json) {
+          console.log(JSON.stringify({ ok: true, path }, null, 2));
+        } else {
+          console.log(`TUI binary ready: ${path}`);
+        }
+        break;
+      }
       // Detect how tmux-ide was installed and act on the pending update: a dev
       // checkout prints the `git pull` hint; a global install prints (with
       // --dry-run) or runs its package manager's update command. `__dirname` is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmux-ide",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "Turn any project into a tmux-powered terminal IDE with a simple ide.yml",
   "type": "module",
   "bin": {
@@ -65,15 +65,15 @@
   "dependencies": {
     "@hono/node-server": "^1.19.11",
     "@hono/zod-validator": "^0.7.6",
-    "@opentui/core": "^0.1.88",
-    "@opentui/solid": "^0.1.88",
+    "@opentui/core": "^0.4.3",
+    "@opentui/solid": "^0.4.3",
     "@parcel/watcher": "^2.5.6",
     "@types/ws": "^8.18.1",
     "hono": "^4.12.8",
     "ignore": "^7.0.5",
     "js-yaml": "^4.1.1",
     "node-pty": "1.2.0-beta.12",
-    "solid-js": "^1.9.11",
+    "solid-js": "1.9.12",
     "ws": "^8.20.0",
     "zod": "^4.3.6"
   },
@@ -82,7 +82,10 @@
       "@parcel/watcher",
       "esbuild",
       "node-pty"
-    ]
+    ],
+    "overrides": {
+      "zod": "^4.3.6"
+    }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -100,6 +103,6 @@
     "vitest": "^4.1.0"
   },
   "optionalDependencies": {
-    "@opentui/core-darwin-arm64": "^0.1.88"
+    "@opentui/core-darwin-arm64": "^0.4.3"
   }
 }

package/packages/daemon/dist/agent-explain.d.ts

@@ -1,4 +1,4 @@
-import { type DetectedState } from "./tui/detect/manifest.ts";
+import { type DetectedState, type ManifestConfidence } from "./tui/detect/manifest.ts";
 import { type AgentStatus, type InstantState } from "./tui/detect/classify.ts";
 export interface ExplainReport {
     pane: {
@@ -23,6 +23,13 @@ export interface ExplainReport {
         manifestId: string | null;
         matchedCommand: string;
         source: "hint" | "fast" | "tree" | "none";
+        /** The matched manifest's evidence confidence (null when nothing resolved). */
+        confidence: ManifestConfidence | null;
+        /**
+         * Executable-ish tokens seen in the pane's process subtree. Populated for
+         * the "no manifest matched" case so the report can say what it DID find.
+         */
+        subtree: string[];
     };
     states: Array<{
         state: DetectedState;

package/packages/daemon/dist/agent-explain.js

@@ -17,7 +17,7 @@ import { execFileSync } from "node:child_process";
 import { explain } from "./tui/detect/manifest.js";
 import { classifyInstant, parseAuthority, } from "./tui/detect/classify.js";
 import { getManifests } from "./tui/detect/manifest-loader.js";
-import { readProcessTable, resolveAgentCommand } from "./tui/detect/process-tree.js";
+import { describeSubtree, readProcessTable, resolveAgentCommand, } from "./tui/detect/process-tree.js";
 import { readPaneSnapshot } from "./tui/detect/snapshot.js";
 import { IdeError } from "./lib/errors.js";
 /** Working/blocked authority reports older than this are stale (mirrors classify.ts). */
@@ -91,6 +91,9 @@ export function buildReport(target) {
         hint: info.hintRaw,
     });
     const manifest = resolved.manifest;
+    // When nothing resolved, record what the process-tree DID see so `explain`
+    // can point the user at an `@agent_hint` target instead of a dead end.
+    const subtree = manifest ? [] : describeSubtree(table, info.pid);
     // Snapshot + per-state explanation.
     const snapshot = { ...readPaneSnapshot(info.id), title: info.title };
     const explained = manifest
@@ -119,6 +122,8 @@ export function buildReport(target) {
             manifestId: manifest?.id ?? null,
             matchedCommand: resolved.matchedCommand,
             source: resolved.source,
+            confidence: manifest ? (manifest.confidence ?? "conservative") : null,
+            subtree,
         },
         states: explained.checked,
         winner: explained.state,
@@ -168,8 +173,19 @@ export function renderReport(r, opts = {}) {
         out.push(`  ${label("hint")}      ${dim("(unset)")}`);
     }
     // Resolution
-    const mid = r.resolution.manifestId ?? dim("none");
-    out.push(`  ${label("manifest")}  ${mid}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}`);
+    if (r.resolution.manifestId) {
+        const conf = r.resolution.confidence === "tuned"
+            ? c("\x1b[32m", "tuned")
+            : dim(r.resolution.confidence ?? "conservative");
+        out.push(`  ${label("manifest")}  ${r.resolution.manifestId}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}  [${conf}]`);
+    }
+    else {
+        // No manifest matched — say so, and report what the process-tree DID see so
+        // the user can set an `@agent_hint` or add a manifest.
+        const saw = r.resolution.subtree.length > 0 ? r.resolution.subtree.join(", ") : r.pane.cmd || "(nothing)";
+        out.push(`  ${label("manifest")}  ${dim("none matched")} — ${dim(`process-tree saw: ${saw}`)}`);
+        out.push(`            ${dim("set `tmux set-option -p @agent_hint <agent>` to force one")}`);
+    }
     // Per-state rule results
     out.push("");
     out.push(bold("  state rules"));

package/packages/daemon/dist/lib/tui-binary.d.ts

@@ -0,0 +1,57 @@
+/** The `<os>-<arch>` tags we publish a prebuilt TUI binary for. */
+export type TuiPlatformTag = "darwin-arm64" | "darwin-x64" | "linux-x64" | "linux-arm64";
+/** The GitHub repo the release assets live under. */
+export declare const RELEASE_REPO = "wavyrai/tmux-ide";
+/** A downloaded binary smaller than this is treated as corrupt/truncated. */
+export declare const MIN_TUI_BINARY_BYTES: number;
+/**
+ * PURE — map a Node `process.platform`/`process.arch` pair to the release tag,
+ * or null when we don't publish a binary for it (e.g. windows, freebsd) so the
+ * caller can fall back to the "install bun" message.
+ */
+export declare function tuiPlatformTag(platform?: NodeJS.Platform, arch?: string): TuiPlatformTag | null;
+/** PURE — the `bun build --compile --target` flag for a tag (`bun-<tag>`). */
+export declare function bunTargetForTag(tag: TuiPlatformTag): string;
+/** PURE — the release asset filename for a tag (gzip-compressed binary). */
+export declare function releaseAssetName(tag: TuiPlatformTag): string;
+/** PURE — strip a leading `v` from a version string; `2.6.1` and `v2.6.1` both → `2.6.1`. */
+export declare function normalizeVersion(version: string): string;
+/**
+ * PURE — the GitHub download URL for a platform's asset at a given version:
+ * `https://github.com/<repo>/releases/download/v<version>/tmux-ide-tui-<tag>.gz`.
+ */
+export declare function releaseAssetUrl(version: string, tag: TuiPlatformTag): string;
+/**
+ * PURE — where a downloaded binary lives: `<home>/bin/tmux-ide-tui-<tag>-<version>`.
+ * The version is stamped INTO the name so a `tmux-ide update` to a new version
+ * misses the old download and re-fetches (rather than launching a stale binary).
+ */
+export declare function downloadedTuiPath(home: string, tag: TuiPlatformTag, version: string): string;
+/**
+ * io — the tmux-ide state home (`TMUX_IDE_HOME` override, else `~/.tmux-ide`),
+ * the same resolution the update-check cache and welcome marker use.
+ */
+export declare function tuiStateHome(): string;
+/**
+ * io — locate a previously downloaded per-platform binary for THIS version and
+ * platform, or null. Feeds the resolution order in `tui/compiled.ts` after the
+ * shipped/local compiled binary and before the honest "unavailable" error.
+ */
+export declare function findDownloadedTui(version?: string): string | null;
+/**
+ * io — download, verify, and install the per-platform TUI binary for the running
+ * version. Fetches the gzip asset, inflates it, rejects anything under
+ * {@link MIN_TUI_BINARY_BYTES} (a truncated download or an HTML error page),
+ * writes it `0o755`, and atomically renames it into place (temp-in-same-dir →
+ * rename, so a crashed download never leaves a half-written executable).
+ *
+ * Throws with an actionable message on an unsupported platform or a failed
+ * fetch. Returns the installed path and byte size.
+ */
+export declare function downloadTuiBinary(opts?: {
+    version?: string;
+    log?: (msg: string) => void;
+}): Promise<{
+    path: string;
+    bytes: number;
+}>;

package/packages/daemon/dist/lib/tui-binary.js

@@ -0,0 +1,130 @@
+/**
+ * Per-platform TUI binary: the runtime-download fallback that lets a clean
+ * `npm i -g tmux-ide` run the full OpenTUI/Solid cockpit WITHOUT `bun`.
+ *
+ * The dev checkout runs the `.tsx` surfaces via bun; an npm install with no bun
+ * needs a self-contained binary. We do NOT bundle that ~70MB blob in the npm
+ * tarball (a surprise on every install) — instead the release workflow
+ * (`.github/workflows/release-binaries.yml`) cross-compiles one per platform and
+ * uploads them as GitHub release assets, and this module downloads the right one
+ * on demand (explicit `tmux-ide update --tui-binary`, or a consented first run).
+ *
+ * The mapping/URL/path helpers are PURE (unit-tested); {@link downloadTuiBinary}
+ * and {@link findDownloadedTui} are the thin io that fetch and probe.
+ */
+import { chmodSync, existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { gunzipSync } from "node:zlib";
+import { getCurrentVersion } from "./update-check.js";
+/** The GitHub repo the release assets live under. */
+export const RELEASE_REPO = "wavyrai/tmux-ide";
+/** A downloaded binary smaller than this is treated as corrupt/truncated. */
+export const MIN_TUI_BINARY_BYTES = 10 * 1024 * 1024;
+const SUPPORTED = {
+    "darwin-arm64": "darwin-arm64",
+    "darwin-x64": "darwin-x64",
+    "linux-x64": "linux-x64",
+    "linux-arm64": "linux-arm64",
+};
+// ---------------------------------------------------------------------------
+// Pure
+// ---------------------------------------------------------------------------
+/**
+ * PURE — map a Node `process.platform`/`process.arch` pair to the release tag,
+ * or null when we don't publish a binary for it (e.g. windows, freebsd) so the
+ * caller can fall back to the "install bun" message.
+ */
+export function tuiPlatformTag(platform = process.platform, arch = process.arch) {
+    return SUPPORTED[`${platform}-${arch}`] ?? null;
+}
+/** PURE — the `bun build --compile --target` flag for a tag (`bun-<tag>`). */
+export function bunTargetForTag(tag) {
+    return `bun-${tag}`;
+}
+/** PURE — the release asset filename for a tag (gzip-compressed binary). */
+export function releaseAssetName(tag) {
+    return `tmux-ide-tui-${tag}.gz`;
+}
+/** PURE — strip a leading `v` from a version string; `2.6.1` and `v2.6.1` both → `2.6.1`. */
+export function normalizeVersion(version) {
+    return version.startsWith("v") ? version.slice(1) : version;
+}
+/**
+ * PURE — the GitHub download URL for a platform's asset at a given version:
+ * `https://github.com/<repo>/releases/download/v<version>/tmux-ide-tui-<tag>.gz`.
+ */
+export function releaseAssetUrl(version, tag) {
+    return `https://github.com/${RELEASE_REPO}/releases/download/v${normalizeVersion(version)}/${releaseAssetName(tag)}`;
+}
+/**
+ * PURE — where a downloaded binary lives: `<home>/bin/tmux-ide-tui-<tag>-<version>`.
+ * The version is stamped INTO the name so a `tmux-ide update` to a new version
+ * misses the old download and re-fetches (rather than launching a stale binary).
+ */
+export function downloadedTuiPath(home, tag, version) {
+    return join(home, "bin", `tmux-ide-tui-${tag}-${normalizeVersion(version)}`);
+}
+// ---------------------------------------------------------------------------
+// io
+// ---------------------------------------------------------------------------
+/**
+ * io — the tmux-ide state home (`TMUX_IDE_HOME` override, else `~/.tmux-ide`),
+ * the same resolution the update-check cache and welcome marker use.
+ */
+export function tuiStateHome() {
+    return process.env.TMUX_IDE_HOME ?? join(homedir(), ".tmux-ide");
+}
+/**
+ * io — locate a previously downloaded per-platform binary for THIS version and
+ * platform, or null. Feeds the resolution order in `tui/compiled.ts` after the
+ * shipped/local compiled binary and before the honest "unavailable" error.
+ */
+export function findDownloadedTui(version = getCurrentVersion()) {
+    const tag = tuiPlatformTag();
+    if (!tag)
+        return null;
+    const path = downloadedTuiPath(tuiStateHome(), tag, version);
+    return existsSync(path) ? path : null;
+}
+/**
+ * io — download, verify, and install the per-platform TUI binary for the running
+ * version. Fetches the gzip asset, inflates it, rejects anything under
+ * {@link MIN_TUI_BINARY_BYTES} (a truncated download or an HTML error page),
+ * writes it `0o755`, and atomically renames it into place (temp-in-same-dir →
+ * rename, so a crashed download never leaves a half-written executable).
+ *
+ * Throws with an actionable message on an unsupported platform or a failed
+ * fetch. Returns the installed path and byte size.
+ */
+export async function downloadTuiBinary(opts = {}) {
+    const log = opts.log ?? (() => { });
+    const version = normalizeVersion(opts.version ?? getCurrentVersion());
+    const tag = tuiPlatformTag();
+    if (!tag) {
+        throw new Error(`no prebuilt TUI binary is published for ${process.platform}-${process.arch} — ` +
+            `install bun (https://bun.sh) to run the TUI surfaces from source instead`);
+    }
+    const url = releaseAssetUrl(version, tag);
+    const dest = downloadedTuiPath(tuiStateHome(), tag, version);
+    mkdirSync(dirname(dest), { recursive: true });
+    log(`downloading ${url}`);
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`could not download the TUI binary (${url} → HTTP ${res.status} ${res.statusText}). ` +
+            `Check that release v${version} exists and published its assets.`);
+    }
+    const gz = Buffer.from(await res.arrayBuffer());
+    const bin = gunzipSync(gz);
+    if (bin.byteLength < MIN_TUI_BINARY_BYTES) {
+        throw new Error(`the downloaded TUI binary is only ${bin.byteLength} bytes (expected >10MB) — ` +
+            `treating it as corrupt and leaving the previous binary (if any) in place`);
+    }
+    const tmp = `${dest}.${process.pid}.tmp`;
+    writeFileSync(tmp, bin, { mode: 0o755 });
+    chmodSync(tmp, 0o755);
+    renameSync(tmp, dest);
+    const mb = (bin.byteLength / 1024 / 1024).toFixed(1);
+    log(`installed ${dest} (${mb} MB)`);
+    return { path: dest, bytes: bin.byteLength };
+}

package/packages/daemon/dist/widgets/explorer/breadcrumbs.d.ts

@@ -6,5 +6,5 @@ interface BreadcrumbsProps {
     theme: WidgetTheme;
     onNavigate: (absolutePath: string) => void;
 }
-export declare function Breadcrumbs(props: BreadcrumbsProps): any;
+export declare function Breadcrumbs(props: BreadcrumbsProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/explorer/footer.d.ts

@@ -2,5 +2,5 @@ import type { WidgetTheme } from "../lib/theme.ts";
 interface FooterProps {
     theme: WidgetTheme;
 }
-export declare function Footer(props: FooterProps): any;
+export declare function Footer(props: FooterProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/explorer/tree.d.ts

@@ -9,5 +9,5 @@ interface FileTreeProps {
     onActivate: (node: TreeNode) => void;
     onInputModeChange: (mode: "keyboard" | "mouse") => void;
 }
-export declare function FileTree(props: FileTreeProps): any;
+export declare function FileTree(props: FileTreeProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/lib/help-overlay.d.ts

@@ -16,4 +16,4 @@ export interface HelpOverlayProps {
  * the surface's own keys. Replaces the surface body while `?` is held open;
  * `esc`/`q`/`?` close it.
  */
-export declare function HelpOverlay(props: HelpOverlayProps): any;
+export declare function HelpOverlay(props: HelpOverlayProps): import("solid-js").JSX.Element;

package/packages/daemon/dist/widgets/setup/agent-naming.d.ts

@@ -5,5 +5,5 @@ interface AgentNamingProps {
     onContinue: (names: string[]) => void;
     theme: WidgetTheme;
 }
-export declare function AgentNaming(props: AgentNamingProps): any;
+export declare function AgentNaming(props: AgentNamingProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/config-tree.d.ts

@@ -9,5 +9,5 @@ interface ConfigTreeProps {
     onConfigChange: (config: IdeConfig) => void;
     theme: WidgetTheme;
 }
-export declare function ConfigTree(props: ConfigTreeProps): any;
+export declare function ConfigTree(props: ConfigTreeProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/detect-panel.d.ts

@@ -10,5 +10,5 @@ interface DetectPanelProps {
     onContinue: () => void;
     theme: WidgetTheme;
 }
-export declare function DetectPanel(props: DetectPanelProps): any;
+export declare function DetectPanel(props: DetectPanelProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/field-editor.d.ts

@@ -9,4 +9,4 @@ export interface FieldEditorProps {
     onCancel: () => void;
     theme: WidgetTheme;
 }
-export declare function FieldEditor(props: FieldEditorProps): any;
+export declare function FieldEditor(props: FieldEditorProps): import("solid-js").JSX.Element;

package/packages/daemon/dist/widgets/setup/footer.d.ts

@@ -13,5 +13,5 @@ interface FooterProps {
     theme: WidgetTheme;
     actions?: FooterActions;
 }
-export declare function Footer(props: FooterProps): any;
+export declare function Footer(props: FooterProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/layout-picker.d.ts

@@ -5,5 +5,5 @@ interface LayoutPickerProps {
     onSelect: (preset: LayoutPreset) => void;
     theme: WidgetTheme;
 }
-export declare function LayoutPicker(props: LayoutPickerProps): any;
+export declare function LayoutPicker(props: LayoutPickerProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/src/agent-explain.ts

@@ -14,7 +14,7 @@
  * the target pane.
  */
 import { execFileSync } from "node:child_process";
-import { explain, type DetectedState } from "./tui/detect/manifest.ts";
+import { explain, type DetectedState, type ManifestConfidence } from "./tui/detect/manifest.ts";
 import {
   classifyInstant,
   parseAuthority,
@@ -22,7 +22,11 @@ import {
   type InstantState,
 } from "./tui/detect/classify.ts";
 import { getManifests } from "./tui/detect/manifest-loader.ts";
-import { readProcessTable, resolveAgentCommand } from "./tui/detect/process-tree.ts";
+import {
+  describeSubtree,
+  readProcessTable,
+  resolveAgentCommand,
+} from "./tui/detect/process-tree.ts";
 import { readPaneSnapshot } from "./tui/detect/snapshot.ts";
 import { IdeError } from "./lib/errors.ts";
 
@@ -53,6 +57,13 @@ export interface ExplainReport {
     manifestId: string | null;
     matchedCommand: string;
     source: "hint" | "fast" | "tree" | "none";
+    /** The matched manifest's evidence confidence (null when nothing resolved). */
+    confidence: ManifestConfidence | null;
+    /**
+     * Executable-ish tokens seen in the pane's process subtree. Populated for
+     * the "no manifest matched" case so the report can say what it DID find.
+     */
+    subtree: string[];
   };
   states: Array<{ state: DetectedState; matched: boolean }>;
   winner: DetectedState | null;
@@ -137,6 +148,9 @@ export function buildReport(target: string): ExplainReport {
     hint: info.hintRaw,
   });
   const manifest = resolved.manifest;
+  // When nothing resolved, record what the process-tree DID see so `explain`
+  // can point the user at an `@agent_hint` target instead of a dead end.
+  const subtree = manifest ? [] : describeSubtree(table, info.pid);
 
   // Snapshot + per-state explanation.
   const snapshot = { ...readPaneSnapshot(info.id), title: info.title };
@@ -168,6 +182,8 @@ export function buildReport(target: string): ExplainReport {
       manifestId: manifest?.id ?? null,
       matchedCommand: resolved.matchedCommand,
       source: resolved.source,
+      confidence: manifest ? (manifest.confidence ?? "conservative") : null,
+      subtree,
     },
     states: explained.checked,
     winner: explained.state,
@@ -223,10 +239,22 @@ export function renderReport(r: ExplainReport, opts: { color?: boolean } = {}):
   }
 
   // Resolution
-  const mid = r.resolution.manifestId ?? dim("none");
-  out.push(
-    `  ${label("manifest")}  ${mid}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}`,
-  );
+  if (r.resolution.manifestId) {
+    const conf =
+      r.resolution.confidence === "tuned"
+        ? c("\x1b[32m", "tuned")
+        : dim(r.resolution.confidence ?? "conservative");
+    out.push(
+      `  ${label("manifest")}  ${r.resolution.manifestId}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}  [${conf}]`,
+    );
+  } else {
+    // No manifest matched — say so, and report what the process-tree DID see so
+    // the user can set an `@agent_hint` or add a manifest.
+    const saw =
+      r.resolution.subtree.length > 0 ? r.resolution.subtree.join(", ") : r.pane.cmd || "(nothing)";
+    out.push(`  ${label("manifest")}  ${dim("none matched")} — ${dim(`process-tree saw: ${saw}`)}`);
+    out.push(`            ${dim("set `tmux set-option -p @agent_hint <agent>` to force one")}`);
+  }
 
   // Per-state rule results
   out.push("");