kankaku-tui 0.3.0 → 0.3.1

package/README.md

@@ -16,24 +16,27 @@ kankaku setup
 ```
 
 On a real terminal, `kankaku setup` opens as a full-screen wizard — one
-step at a time, in the same sidebar/panel look as the rest of the app.
-`kankaku` with no arguments does the same the very first time (no
-`~/.kankaku/tui.json` yet); after that first run it opens straight into
-the Dashboard as usual.
+step at a time, in the same header/panel/footer look as the rest of the
+app (there's no sidebar in the wizard itself: the panel's own title
+tracks progress instead, e.g. `Setup · Agents 1/5`, numbering only the
+steps this run will actually show). `kankaku` with no arguments does the
+same the very first time (no `~/.kankaku/tui.json` yet); after that first
+run it opens straight into the Dashboard as usual.
 
 The wizard's steps, `enter` to advance and `esc` to go back throughout
-(`esc` at the first step quits):
+(`esc` at the first step, Agents, quits):
 
-1. **Detect** — which agents kankaku found on this machine, and their
-   current state.
-2. **Agents** — a checklist (`space` toggles): pi, gentle-shell, Claude
-   Code. Pre-checked means already configured; unchecking a configured
+1. **Agents** — a checklist (`space` toggles) that also carries detection
+   for every agent kankaku knows about: pi, gentle-shell and Claude Code
+   each show `configured (<path, shortened with ~>)` or `not configured`;
+   pre-checked means already configured, and unchecking a configured
    agent schedules removing kankaku from it, not just skipping it. Codex
-   and OpenCode are listed but disabled — no adapter yet.
-3. **Claude Code** — the `kankaku-claude` checkout path (only shown when
+   and OpenCode are listed but disabled, showing `no adapter yet` (found,
+   but kankaku can't write its config) or `not installed` (not found).
+2. **Claude Code** — the `kankaku-claude` checkout path (only shown when
    Claude Code is checked and not already configured), guessed from any
    existing `statusLine`.
-4. **Hub** — `use an existing hub` (URL, email, masked password, a `c`
+3. **Hub** — `use an existing hub` (URL, email, masked password, a `c`
    inline health check, reusing the current credentials as the default),
    `install locally`, or `skip`. Installing locally looks for a
    `kankaku-hub` checkout first; if found, its path is prefilled and
@@ -45,14 +48,14 @@ The wizard's steps, `enter` to advance and `esc` to go back throughout
    wizard shows the exact commands to run in another terminal and a `c`
    "check again" action, plus `m` to acknowledge you'll install it
    manually.
-5. **Roots** — the comma-separated project roots, defaulting to the
+4. **Roots** — the comma-separated project roots, defaulting to the
    current `tui.json` (or the parent of the current directory the first
-   time).
-6. **Review** — the plan: one line per change, with the exact file it
+   time). See "Configuration" below for how deep each root is searched.
+5. **Review** — the plan: one line per change, with the exact file it
    touches. `enter` applies it.
-7. **Apply** — runs each change and shows its result
+6. **Apply** — runs each change and shows its result
    (`wrote`/`unchanged`/`removed`/`started`/`error: …`) as it happens.
-8. **Done** — a summary, then `enter` opens the Dashboard in place — no
+7. **Done** — a summary, then `enter` opens the Dashboard in place — no
    restart.
 
 `kankaku setup --yes` and `kankaku setup --dry-run` stay exactly as
@@ -90,10 +93,23 @@ this repo with `npm run dev`.
 }
 ```
 
-Each root is either a project itself (it has its own `.kankaku/worklog.jsonl`)
-or a directory containing one or more projects as direct subdirectories.
-`~` expands to the home directory. Missing or malformed config falls back
-to the current working directory as the only root.
+### Projects across roots
+
+Each root is searched recursively for projects, up to 5 directory levels
+below it by default: a directory is a project once it has its own
+`.kankaku/worklog.jsonl` — including the root itself — and the search
+still continues below it, so a stray worklog in a parent directory (a pi
+session run once in `~/desarrollo`) never hides the projects beneath;
+every directory is listed at most once. Subdirectories are searched one
+level deeper, skipping `node_modules`, `.git` and any hidden
+(dot-prefixed) directory. This lets one root cover a whole workspace, e.g.
+`~/desarrollo` finding every project under `~/desarrollo/<client>/<project>`
+without listing each one. Projects are deduped by real (symlink-resolved)
+path and sorted by name — the directory's basename, or the last two path
+segments joined with `/` when two discovered projects share a basename
+(e.g. `clientA/shared` and `clientB/shared`). `~` expands to the home
+directory. Missing or malformed config falls back to the current working
+directory as the only root.
 
 ### Hub credentials (Catalog and Sync)
 

package/dist/adapters/project-discovery.js

@@ -1,12 +1,20 @@
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { basename, join } from "node:path";
+import { existsSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { basename, join, sep } from "node:path";
+/** How many directory levels below each root {@link discoverProjects} descends into by default. */
+const DEFAULT_MAX_DEPTH = 5;
+const SKIPPED_DIR_NAMES = new Set(["node_modules", ".git"]);
 function hasWorklog(dir) {
     return existsSync(join(dir, ".kankaku", "worklog.jsonl"));
 }
-function childDirs(root) {
+/** `node_modules`, `.git`, and any dot-prefixed (hidden) directory are never searched. */
+function isSkipped(name) {
+    return name.startsWith(".") || SKIPPED_DIR_NAMES.has(name);
+}
+function childDirs(dir) {
     try {
-        return readdirSync(root)
-            .map((entry) => join(root, entry))
+        return readdirSync(dir)
+            .filter((name) => !isSkipped(name))
+            .map((name) => join(dir, name))
             .filter((entry) => {
             try {
                 return statSync(entry).isDirectory();
@@ -21,23 +29,72 @@ function childDirs(root) {
     }
 }
 /**
- * Discover projects under `roots`: a root that itself has
- * `.kankaku/worklog.jsonl` is a project; otherwise each direct child
- * directory with one is a project. Deduped by `dir`, sorted by `name`.
- * Never throws on an unreadable or missing root.
+ * The real (symlink-resolved) path, used only as the dedup key — the
+ * `ProjectRef.dir` returned to callers always stays the path as
+ * discovered. Falls back to `dir` itself when it cannot be resolved (e.g.
+ * a permission error), so an unreadable directory never throws.
+ */
+function realDirPath(dir) {
+    try {
+        return realpathSync(dir);
+    }
+    catch {
+        return dir;
+    }
+}
+/**
+ * Walk `dir`, `depth` levels below its root: a directory with
+ * `.kankaku/worklog.jsonl` is a project, and the walk still continues
+ * below it — a pi session run once in a parent directory (`~/desarrollo`)
+ * leaves a worklog there, and that stray file must never hide the real
+ * projects beneath (`~/desarrollo/<client>/<project>`). Subdirectories
+ * (skipping `node_modules`, `.git` and any hidden directory) are walked
+ * one level deeper, up to `maxDepth`.
  */
-export function discoverProjects(roots) {
-    const byDir = new Map();
+function walk(dir, depth, maxDepth, found) {
+    if (hasWorklog(dir))
+        found.set(realDirPath(dir), dir);
+    if (depth >= maxDepth)
+        return;
+    for (const child of childDirs(dir)) {
+        walk(child, depth + 1, maxDepth, found);
+    }
+}
+/** `basename(dir)`, or the last two path segments joined with `/` when that basename is ambiguous (shared by another discovered project). */
+function projectName(dir, duplicateBasenames) {
+    const base = basename(dir);
+    if (!duplicateBasenames.has(base))
+        return base;
+    const segments = dir.split(sep).filter((segment) => segment.length > 0);
+    return segments.slice(-2).join("/");
+}
+/**
+ * Discover projects under `roots`, searching up to `options.maxDepth`
+ * directory levels below each root (default {@link DEFAULT_MAX_DEPTH}): a
+ * directory with `.kankaku/worklog.jsonl` is a project and is never
+ * descended into (so a project nested inside another project is never
+ * double-counted); otherwise its subdirectories are searched one level
+ * deeper, skipping `node_modules`, `.git` and any hidden (dot-prefixed)
+ * directory. Deduped by real (symlink-resolved) path; sorted by `name`,
+ * which is the directory basename, or the last two path segments joined
+ * with `/` when two discovered projects share a basename. Never throws on
+ * an unreadable or missing root or subdirectory — those are silently
+ * skipped.
+ */
+export function discoverProjects(roots, options = {}) {
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const found = new Map();
     for (const root of roots) {
-        if (hasWorklog(root)) {
-            byDir.set(root, { name: basename(root), dir: root });
-            continue;
-        }
-        for (const child of childDirs(root)) {
-            if (hasWorklog(child)) {
-                byDir.set(child, { name: basename(child), dir: child });
-            }
-        }
+        walk(root, 0, maxDepth, found);
+    }
+    const dirs = Array.from(found.values());
+    const basenameCounts = new Map();
+    for (const dir of dirs) {
+        const base = basename(dir);
+        basenameCounts.set(base, (basenameCounts.get(base) ?? 0) + 1);
     }
-    return Array.from(byDir.values()).sort((a, b) => a.name.localeCompare(b.name));
+    const duplicateBasenames = new Set(Array.from(basenameCounts.entries())
+        .filter(([, count]) => count > 1)
+        .map(([base]) => base));
+    return dirs.map((dir) => ({ name: projectName(dir, duplicateBasenames), dir })).sort((a, b) => a.name.localeCompare(b.name));
 }

package/dist/cli.js

@@ -259,7 +259,7 @@ function gatherWizardFacts(deps) {
         defaultRoots: [dirname(deps.cwd)],
         path: tuiPath,
     };
-    return { agentFacts, hub, roots };
+    return { agentFacts, hub, roots, homeDir: deps.homeDir };
 }
 /** Runs `adapters/setup/local-hub.ts#installLocalHub` for real, sharing one `ScriptRunner`/timer setup between the wizard's `installLocalHub` action and `apply`'s own `install-local-hub` handling. */
 async function performLocalHubInstall(checkout, deps) {

package/dist/domain/setup-wizard.js

@@ -14,6 +14,22 @@ export function guessClaudeCheckout(statusLineCommand) {
     const match = CLAUDE_STATUS_LINE_RE.exec(statusLineCommand);
     return match ? match[1] : "";
 }
+/**
+ * Shorten `path` for display by replacing a leading `homeDir` with `~`.
+ * Only a real path-boundary match counts (`homeDir` itself, or `homeDir`
+ * followed by `/`) — a sibling directory that merely shares the prefix
+ * (e.g. `/homework` vs `/home`) is left unchanged. `path` is returned as-is
+ * when it doesn't start under `homeDir`.
+ */
+export function shortenHome(path, homeDir) {
+    if (homeDir === "")
+        return path;
+    if (path === homeDir)
+        return "~";
+    if (path.startsWith(`${homeDir}/`))
+        return `~${path.slice(homeDir.length)}`;
+    return path;
+}
 function clearError(errors, key) {
     if (!(key in errors))
         return errors;
@@ -30,7 +46,7 @@ export function createWizardState(facts) {
     const agents = detectAgents(facts.agentFacts);
     const selected = Object.fromEntries(agents.map((agent) => [agent.id, agent.configured]));
     return {
-        step: "detect",
+        step: "agents",
         agents,
         selected,
         claudeCheckout: guessClaudeCheckout(facts.agentFacts.claudeCode?.statusLineCommand),
@@ -48,8 +64,8 @@ export function createWizardState(facts) {
         results: [],
     };
 }
-/** Whether the Claude Code step should be shown: Claude is selected and not already configured. */
-function claudeStepNeeded(state) {
+/** Whether the Claude Code step should be shown: Claude is selected and not already configured. Exported so `ui/setup/wizard-screen.tsx` can number only the steps that will actually be shown for this run. */
+export function claudeStepNeeded(state) {
     const claude = state.agents.find((agent) => agent.id === "claude-code");
     return state.selected["claude-code"] === true && claude !== undefined && !claude.configured;
 }
@@ -154,8 +170,6 @@ export function planFromWizard(state, facts) {
 /** Advance from the current step: validates it, sets `errors` and stays when invalid, otherwise moves on. */
 export function next(state, facts) {
     switch (state.step) {
-        case "detect":
-            return { ...state, step: "agents", errors: {} };
         case "agents":
             return { ...state, step: claudeStepNeeded(state) ? "claude" : "hub", errors: {} };
         case "claude": {
@@ -186,13 +200,11 @@ export function next(state, facts) {
             return state;
     }
 }
-/** Move back to the previous step, mirroring `next`'s claude-step skip. Terminal/first steps (`detect`, `apply`, `done`) are no-ops. */
+/** Move back to the previous step, mirroring `next`'s claude-step skip. Terminal/first steps (`agents`, `apply`, `done`) are no-ops. */
 export function back(state) {
     switch (state.step) {
-        case "detect":
-            return state;
         case "agents":
-            return { ...state, step: "detect", errors: {} };
+            return state;
         case "claude":
             return { ...state, step: "agents", errors: {} };
         case "hub":
@@ -214,10 +226,9 @@ export function applyResult(state, result) {
 export function hintsForStep(step) {
     const quit = { key: "q", label: "quit" };
     switch (step) {
-        case "detect":
-            return [{ key: "enter", label: "next" }, quit];
         case "agents":
-            return [{ key: "space", label: "toggle" }, { key: "↑↓", label: "move" }, { key: "enter", label: "next" }, { key: "esc", label: "back" }, quit];
+            // The first step: esc quits (handled by the caller), so it isn't hinted as "back" here.
+            return [{ key: "space", label: "toggle" }, { key: "↑↓", label: "move" }, { key: "enter", label: "next" }, quit];
         case "claude":
             return [{ key: "enter", label: "next" }, { key: "esc", label: "back" }, quit];
         case "hub":

package/dist/ui/setup/wizard-screen.js

@@ -1,26 +1,44 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
-import { Box, Text, useInput } from "ink";
-import { applyResult, back, createWizardState, hintsForStep, next, planFromWizard, setClaudeCheckout, setHubField, setHubHealth, setHubLocalManual, setHubMode, setLocalCheckout, setRoots, toggleAgent, } from "../../domain/setup-wizard.js";
-import { Layout } from "../layout.js";
+import { Box, Text, useInput, useStdout } from "ink";
+import { applyResult, back, claudeStepNeeded, createWizardState, hintsForStep, next, planFromWizard, setClaudeCheckout, setHubField, setHubHealth, setHubLocalManual, setHubMode, setLocalCheckout, setRoots, shortenHome, toggleAgent, } from "../../domain/setup-wizard.js";
+import { HeaderBar } from "../components/header-bar.js";
+import { KeyHints } from "../components/key-hints.js";
 import { Panel } from "../components/panel.js";
 import { Table } from "../components/table.js";
 import { Checklist } from "../components/checklist.js";
 import { Radio } from "../components/radio.js";
 import { TextInput } from "../components/text-input.js";
 import { useTheme } from "../theme.js";
-/** The seven steps shown in the sidebar; `apply` has no entry of its own (it is the Review step's own execution, not a step the user navigates to). */
-const SIDEBAR_STEPS = ["detect", "agents", "claude", "hub", "roots", "review", "done"];
+/** Fallback terminal height when neither `rows` nor `useStdout().rows` is available (matches `ui/layout.tsx`'s own fallback). */
+const DEFAULT_ROWS = 24;
+/** Rows used by the header line. */
+const HEADER_ROWS = 1;
+/** Rows used by the footer key-hints line. */
+const FOOTER_ROWS = 1;
+/** Panel titles for every step. Used verbatim for `apply`/`done` (never numbered); `agents`/`claude`/`hub`/`roots`/`review` get a `n/total` suffix from {@link panelTitle}. */
 const STEP_TITLES = {
-    detect: "Detect",
     agents: "Agents",
-    claude: "Claude",
+    claude: "Claude Code",
     hub: "Hub",
     roots: "Roots",
     review: "Review",
     apply: "Apply",
     done: "Done",
 };
+/** The steps a run numbers in its panel title, in order; `claude` is dropped from this list when the run doesn't need it (see {@link numberedStepsForRun}). `apply` and `done` are never numbered — `apply` is Review's own execution and `done` is the terminal summary. */
+const NUMBERED_STEPS = ["agents", "claude", "hub", "roots", "review"];
+/** The steps that will actually be shown for this run, e.g. `["agents", "hub", "roots", "review"]` when Claude Code is skipped. */
+function numberedStepsForRun(state) {
+    return NUMBERED_STEPS.filter((step) => step !== "claude" || claudeStepNeeded(state));
+}
+/** `[ Setup · Agents 1/5 ]`-style progress title: `n/total` over only the steps this run will show; `apply`/`done` render unnumbered. */
+function panelTitle(state) {
+    const title = STEP_TITLES[state.step];
+    const steps = numberedStepsForRun(state);
+    const index = steps.indexOf(state.step);
+    return index === -1 ? `Setup · ${title}` : `Setup · ${title} ${index + 1}/${steps.length}`;
+}
 const AGENT_TITLES = {
     pi: "pi",
     "gentle-shell": "gentle-shell",
@@ -28,45 +46,11 @@ const AGENT_TITLES = {
     codex: "Codex",
     opencode: "OpenCode",
 };
-/** The sidebar's own active id: `apply` has no sidebar row, so it maps to `review` (the step it is executing). */
-function sidebarActiveId(step) {
-    return step === "apply" ? "review" : step;
-}
-function wizardSidebarItems(step) {
-    const activeIndex = SIDEBAR_STEPS.indexOf(sidebarActiveId(step));
-    return SIDEBAR_STEPS.map((entry, index) => ({
-        id: entry,
-        key: String(index + 1),
-        label: index < activeIndex ? `✓ ${STEP_TITLES[entry]}` : STEP_TITLES[entry],
-    }));
-}
-function agentStateLabel(agent) {
+/** The Agents checklist row's note: presence/configured state for pi/gentle-shell/Claude Code (always checkable), or why an agent with no adapter yet (Codex/OpenCode, always disabled) can't be. */
+function agentNote(agent, homeDir) {
     if (!agent.adapterAvailable)
-        return "no adapter";
-    if (!agent.present)
-        return "not found";
-    return agent.configured ? "configured" : "present";
-}
-const DETECT_FIXED_COLUMNS_WIDTH = 14 + 1 + 12 + 1 + 2 + 2;
-function detectColumns(panelWidth) {
-    const detailWidth = Math.max(panelWidth - DETECT_FIXED_COLUMNS_WIDTH, 10);
-    return [
-        { key: "agent", header: "agent", width: 14 },
-        { key: "state", header: "state", width: 12 },
-        { key: "detail", header: "detail", width: detailWidth },
-    ];
-}
-function detectCell(row, key) {
-    switch (key) {
-        case "agent":
-            return AGENT_TITLES[row.id];
-        case "state":
-            return agentStateLabel(row);
-        case "detail":
-            return row.detail;
-        default:
-            return "";
-    }
+        return agent.present ? "no adapter yet" : "not installed";
+    return agent.configured ? `configured (${shortenHome(agent.detail, homeDir)})` : "not configured";
 }
 const REVIEW_FIXED_COLUMNS_WIDTH = 30 + 1 + 2 + 2;
 function reviewColumns(panelWidth) {
@@ -85,17 +69,21 @@ function applyResultLine(result) {
     const detail = result.detail ? ` (${result.detail})` : "";
     return `${result.outcome} ${result.action.file}${detail}`;
 }
-function agentChecklistItems(agents, selected) {
-    return agents.map((agent) => {
-        const disabled = agent.id === "codex" || agent.id === "opencode";
-        return {
-            id: agent.id,
-            label: AGENT_TITLES[agent.id],
-            checked: selected[agent.id] === true,
-            disabled,
-            note: disabled ? "no adapter yet" : undefined,
-        };
-    });
+/**
+ * Detection is folded into the Agents checklist itself (R1): each row's
+ * label already carries the agent's presence/configured state, e.g.
+ * `pi — configured (~/.pi/agent/settings.json)` or `gentle-shell — not
+ * configured`; disabled rows (no adapter yet) read `Codex — no adapter
+ * yet` or `OpenCode — not installed`. `note` is left unset so `Checklist`
+ * never appends its own `(note)` suffix on top.
+ */
+function agentChecklistItems(agents, selected, homeDir) {
+    return agents.map((agent) => ({
+        id: agent.id,
+        label: `${AGENT_TITLES[agent.id]} — ${agentNote(agent, homeDir)}`,
+        checked: selected[agent.id] === true,
+        disabled: !agent.adapterAvailable,
+    }));
 }
 const HUB_MODE_OPTIONS = [
     { value: "existing", label: "use an existing hub" },
@@ -112,10 +100,15 @@ function healthLine(healthOk, checking) {
     return healthOk ? "health ok" : "health failed";
 }
 /**
- * `kankaku setup`'s interactive wizard: one full-screen step at a time
- * inside the shared `Layout` frame, driven by `domain/setup-wizard.ts`'s
- * pure reducers. Enter advances (validating first), Esc goes back (quits
- * from Detect, via `onQuit`); `q` quits from anywhere a text field isn't
+ * `kankaku setup`'s interactive wizard: one full-screen step at a time,
+ * driven by `domain/setup-wizard.ts`'s pure reducers. Unlike every other
+ * screen it renders its own header/panel/footer frame directly instead of
+ * `ui/layout.tsx`'s `Layout` — there is no sidebar to show, since the
+ * wizard's progress lives in the panel's own title instead (`panelTitle`,
+ * e.g. `Setup · Agents 1/5`, numbering only the steps this run will
+ * actually show — Claude Code is dropped when it isn't needed). Enter
+ * advances (validating first), Esc goes back (quits from Agents, the
+ * first step, via `onQuit`); `q` quits from anywhere a text field isn't
  * currently capturing keystrokes.
  */
 export function SetupWizard({ facts, actions, onDone, onQuit, version, columns, rows }) {
@@ -162,7 +155,7 @@ export function SetupWizard({ facts, actions, onDone, onQuit, version, columns,
             return;
         }
         if (key.escape) {
-            if (state.step === "detect") {
+            if (state.step === "agents") {
                 onQuit();
                 return;
             }
@@ -189,10 +182,14 @@ export function SetupWizard({ facts, actions, onDone, onQuit, version, columns,
             }
         }
     });
-    const stepTitle = STEP_TITLES[state.step];
     const hints = hintsForStep(state.step);
-    return (_jsx(Layout, { columns: columns, rows: rows, headerLeft: `>_ kankaku setup${version ? ` ${version}` : ""}`, sidebarItems: wizardSidebarItems(state.step), activeId: sidebarActiveId(state.step), sidebarStats: [], keyHints: hints, focus: "main", children: ({ mainWidth, mainHeight }) => (_jsxs(Panel, { title: `Setup · ${stepTitle}`, width: mainWidth, height: mainHeight, active: true, children: [state.step === "detect" && (_jsx(Table, { columns: detectColumns(mainWidth), rows: state.agents, rowKey: (row) => row.id, cell: detectCell, emptyText: "no agents detected" })), state.step === "agents" && (_jsx(Checklist, { items: agentChecklistItems(state.agents, state.selected), cursor: agentCursor, onToggle: (id) => setState((s) => toggleAgent(s, id)), onMove: (delta) => setAgentCursor((c) => Math.min(Math.max(c + delta, 0), state.agents.length - 1)), focused: true })), state.step === "claude" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "kankaku-claude checkout path:" }), _jsx(TextInput, { value: state.claudeCheckout, onChange: (value) => setState((s) => setClaudeCheckout(s, value)), focused: true }), state.errors.claudeCheckout && _jsx(Text, { color: theme.error, children: state.errors.claudeCheckout })] })), state.step === "hub" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Radio, { options: HUB_MODE_OPTIONS, value: state.hub.mode, onChange: (mode) => setState((s) => setHubMode(s, mode)), focused: hubFocus === 0 }), state.hub.mode === "existing" && (_jsxs(Box, { flexDirection: "column", children: [["url", "email", "password"].map((field, index) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { children: `${field}: ` }), _jsx(TextInput, { value: state.hub[field], onChange: (value) => setState((s) => setHubField(s, field, value)), masked: field === "password", focused: hubFocus === index + 1 })] }, field))), state.errors.url && _jsx(Text, { color: theme.error, children: state.errors.url }), state.errors.email && _jsx(Text, { color: theme.error, children: state.errors.email }), state.errors.password && _jsx(Text, { color: theme.error, children: state.errors.password }), _jsx(Text, { children: `[ check ] c   ${healthLine(state.hub.healthOk, healthChecking)}` })] })), state.hub.mode === "local" && hasCheckoutField && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "local checkout path:" }), _jsx(TextInput, { value: checkoutValue, onChange: (value) => setState((s) => setLocalCheckout(s, value)), focused: hubFocus === 1 })] })), state.hub.mode === "local" && !hasCheckoutField && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "no kankaku-hub checkout found; run these commands, then check again:" }), actions.manualCommands(state.hub.localCheckout || undefined).map((line) => (_jsx(Text, { children: `  ${line}` }, line))), _jsx(Text, { children: `[ check again ] c   ${healthLine(state.hub.healthOk, healthChecking)}` }), _jsx(Text, { children: `[ m ] acknowledge manual install${state.hub.localManual ? " (acknowledged)" : ""}` }), state.errors.localCheckout && _jsx(Text, { color: theme.error, children: state.errors.localCheckout })] }))] })), state.step === "roots" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "project roots (comma-separated):" }), _jsx(TextInput, { value: rootsText, onChange: (value) => {
-                                setRootsText(value);
-                                setState((s) => setRoots(s, value));
-                            }, focused: true }), state.errors.roots && _jsx(Text, { color: theme.error, children: state.errors.roots })] })), state.step === "review" && (_jsx(Table, { columns: reviewColumns(mainWidth), rows: state.plan, rowKey: (row) => `${row.kind}-${row.file}`, cell: reviewCell, emptyText: "nothing to change" })), state.step === "apply" && (_jsxs(Box, { flexDirection: "column", children: [state.results.map((result, index) => (_jsx(Text, { children: applyResultLine(result) }, `${result.action.kind}-${index}`))), state.results.length < state.plan.length && _jsx(Text, { dimColor: true, children: "applying\u2026" })] })), state.step === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: `setup complete: ${state.results.length} change(s) applied` }), _jsx(Text, { dimColor: true, children: "enter open dashboard" })] }))] })) }));
+    const { stdout } = useStdout();
+    const width = columns ?? stdout?.columns ?? 80;
+    const height = rows ?? stdout?.rows ?? DEFAULT_ROWS;
+    const mainWidth = width;
+    const mainHeight = Math.max(height - HEADER_ROWS - FOOTER_ROWS, 0);
+    return (_jsxs(Box, { flexDirection: "column", width: width, height: height, children: [_jsx(HeaderBar, { left: `>_ kankaku setup${version ? ` ${version}` : ""}`, width: width }), _jsx(Box, { flexDirection: "column", flexGrow: 1, minHeight: 0, children: _jsxs(Panel, { title: panelTitle(state), width: mainWidth, height: mainHeight, active: true, children: [state.step === "agents" && (_jsx(Checklist, { items: agentChecklistItems(state.agents, state.selected, facts.homeDir), cursor: agentCursor, onToggle: (id) => setState((s) => toggleAgent(s, id)), onMove: (delta) => setAgentCursor((c) => Math.min(Math.max(c + delta, 0), state.agents.length - 1)), focused: true })), state.step === "claude" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "kankaku-claude checkout path:" }), _jsx(TextInput, { value: state.claudeCheckout, onChange: (value) => setState((s) => setClaudeCheckout(s, value)), focused: true }), state.errors.claudeCheckout && _jsx(Text, { color: theme.error, children: state.errors.claudeCheckout })] })), state.step === "hub" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Radio, { options: HUB_MODE_OPTIONS, value: state.hub.mode, onChange: (mode) => setState((s) => setHubMode(s, mode)), focused: hubFocus === 0 }), state.hub.mode === "existing" && (_jsxs(Box, { flexDirection: "column", children: [["url", "email", "password"].map((field, index) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { children: `${field}: ` }), _jsx(TextInput, { value: state.hub[field], onChange: (value) => setState((s) => setHubField(s, field, value)), masked: field === "password", focused: hubFocus === index + 1 })] }, field))), state.errors.url && _jsx(Text, { color: theme.error, children: state.errors.url }), state.errors.email && _jsx(Text, { color: theme.error, children: state.errors.email }), state.errors.password && _jsx(Text, { color: theme.error, children: state.errors.password }), _jsx(Text, { children: `[ check ] c   ${healthLine(state.hub.healthOk, healthChecking)}` })] })), state.hub.mode === "local" && hasCheckoutField && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "local checkout path:" }), _jsx(TextInput, { value: checkoutValue, onChange: (value) => setState((s) => setLocalCheckout(s, value)), focused: hubFocus === 1 })] })), state.hub.mode === "local" && !hasCheckoutField && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "no kankaku-hub checkout found; run these commands, then check again:" }), actions.manualCommands(state.hub.localCheckout || undefined).map((line) => (_jsx(Text, { children: `  ${line}` }, line))), _jsx(Text, { children: `[ check again ] c   ${healthLine(state.hub.healthOk, healthChecking)}` }), _jsx(Text, { children: `[ m ] acknowledge manual install${state.hub.localManual ? " (acknowledged)" : ""}` }), state.errors.localCheckout && _jsx(Text, { color: theme.error, children: state.errors.localCheckout })] }))] })), state.step === "roots" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "project roots (comma-separated):" }), _jsx(TextInput, { value: rootsText, onChange: (value) => {
+                                        setRootsText(value);
+                                        setState((s) => setRoots(s, value));
+                                    }, focused: true }), state.errors.roots && _jsx(Text, { color: theme.error, children: state.errors.roots })] })), state.step === "review" && (_jsx(Table, { columns: reviewColumns(mainWidth), rows: state.plan, rowKey: (row) => `${row.kind}-${row.file}`, cell: reviewCell, emptyText: "nothing to change" })), state.step === "apply" && (_jsxs(Box, { flexDirection: "column", children: [state.results.map((result, index) => (_jsx(Text, { children: applyResultLine(result) }, `${result.action.kind}-${index}`))), state.results.length < state.plan.length && _jsx(Text, { dimColor: true, children: "applying\u2026" })] })), state.step === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: `setup complete: ${state.results.length} change(s) applied` }), _jsx(Text, { dimColor: true, children: "enter open dashboard" })] }))] }) }), _jsx(KeyHints, { hints: hints })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kankaku-tui",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Terminal app that shows today's kankaku work across every project on disk",
   "license": "MIT",
   "type": "module",