loop-task 1.4.7 → 1.5.1

package/README.md

@@ -252,6 +252,121 @@ loop-task (board) ──IPC──► daemon ──► loop 1 ──► task (com
 - **Persistent** - loop and task state is saved after every run; survives restarts
 - **Graceful shutdown** - background loops are daemon-managed; foreground loops finish the current execution on Ctrl+C
 
+## Chain Context Sharing
+
+When tasks are arranged in a chain (on-success or on-failure), context flows between them automatically. This lets later tasks reference output from earlier ones without custom glue.
+
+### How it works
+
+1. **Auto-capture** - stdout from every task in the chain is captured before the next task starts.
+2. **Parse rules** - captured output is parsed by content type:
+   - **JSON object** (`{"key": "value"}`) - each key is merged into the shared context.
+   - **JSONL** (one JSON object per line) - each line's keys are merged in order.
+   - **Plain text** - stored under a single `output` key.
+   - **Empty output** - no change to context.
+3. **Template interpolation** - use `{{key}}` in the command or arguments of any task. Before spawning, `{{key}}` is replaced with the current value of `key` from the shared context.
+4. **Merge semantics** - keys accumulate across the chain. Task 1 produces `{ "id": "42" }`, task 2 can use `{{id}}` and also add `{ "status": "ok" }`. Task 3 sees both.
+5. **Output clobbering** - plain text tasks overwrite the `output` key. Use JSON with named keys when data must survive across multiple downstream tasks.
+6. **Context lifecycle** - context is built fresh each loop iteration and exists only in memory. It is never persisted to disk.
+
+### Example: Issue Refinement Chain
+
+A four-task chain that finds an issue, marks it in-progress, rewrites it with AI, and relabels it - all without re-querying:
+
+**Task 1** (primary): Find an issue to refine
+
+```bash
+gh issue list --label "to refine" --limit 1 --json number,title,body --jq '{number: .[0].number, title: .[0].title, body: .[0].body}'
+```
+
+stdout: `{"number":123,"title":"Fix login","body":"It doesn't work"}`
+context: `{ number: 123, title: "Fix login", body: "It doesn't work" }`
+
+**Task 2** (chain, onSuccess): Mark as in-progress
+
+```bash
+gh issue edit {{number}} --add-label "refining" --remove-label "to refine"
+```
+
+interpolated: `gh issue edit 123 --add-label "refining" --remove-label "to refine"`
+
+**Task 3** (chain, onSuccess): Rewrite with AI (edits the issue directly)
+
+```bash
+opencode run "Rewrite this GitHub issue as a detailed user story using project context. Update the issue title and body directly using gh issue edit. Issue number: {{number}} Original title: {{title}} Original body: {{body}}" --model "opencode/big-pickle"
+```
+
+interpolated: `opencode run "Rewrite this GitHub issue as a detailed user story using project context. Update the issue title and body directly using gh issue edit. Issue number: 123 Original title: Fix login Original body: It doesn't work" --model "opencode/big-pickle"`
+
+**Task 4** (chain, onSuccess): Relabel as ready to implement
+
+```bash
+gh issue edit {{number}} --remove-label "refining" --add-label "to implement"
+```
+
+interpolated: `gh issue edit 123 --remove-label "refining" --add-label "to implement"`
+
+### How it works
+
+1. Task 1 queries the issue and emits a JSON object with `number`, `title`, and `body` via `--jq`. The primary task cannot use `{{key}}` interpolation because the chain context is empty when it runs.
+2. Task 2 receives `{{number}}` interpolated from task 1's context. It relabels the issue from "to refine" to "refining" - no re-query needed.
+3. Task 3 runs opencode, which finds the issue by the "refining" label and rewrites it in place using `gh issue edit`. The AI agent edits the issue directly - no need to parse its stdout as JSON.
+4. Task 4 receives `{{number}}` (still 123 from task 1) and relabels the issue as "to implement" - no re-query needed.
+
+### Wrapping values with --jq
+
+To avoid the plain-text `output` clobbering, wrap any value in a named JSON key using `--jq` (requires `--json` before `--jq`):
+
+```bash
+gh issue list --label "to refine" --json number,title --jq '{number: .[0].number, title: .[0].title}'
+```
+
+This stores `{ "number": 123, "title": "Fix login" }` in context instead of overwriting `output`.
+
+### Example: Issue Implementation Chain
+
+A four-task chain that finds an issue to implement, marks it in-progress, runs an AI agent to implement it, then closes it - all without re-querying:
+
+**Task 1** (primary): Find an issue to implement (or exit if one is already in progress)
+
+```bash
+gh issue list --label "implementing" --limit 1 --json number --jq 'length == 0' | grep -q true && gh issue list --label "to implement" --limit 1 --json number,title,body --jq '{number: .[0].number, title: .[0].title, body: .[0].body}'
+```
+
+stdout: `{"number":456,"title":"Add dark mode toggle","body":"Users want a dark theme"}`
+context: `{ number: 456, title: "Add dark mode toggle", body: "Users want a dark theme" }`
+
+If an issue with the "implementing" label already exists, `length == 0` returns `false`, `grep -q true` fails, and the `&&` short-circuits - the chain does not fire. The loop waits for the next iteration.
+
+**Task 2** (chain, onSuccess): Mark as in-progress
+
+```bash
+gh issue edit {{number}} --add-label "implementing" --remove-label "to implement"
+```
+
+interpolated: `gh issue edit 456 --add-label "implementing" --remove-label "to implement"`
+
+**Task 3** (chain, onSuccess): Implement with AI agent
+
+```bash
+git fetch origin && git checkout main && git reset --hard origin/main && opencode run "Implement this GitHub issue using /ob-autopilot and return only JSON with fields title and body after implementation is completed, merged to main, pushed to origin and the issue has been referenced in GitHub. Issue title: {{title}} Issue body: {{body}}" --model "opencode/big-pickle"
+```
+
+interpolated: `git fetch origin && git checkout main && git reset --hard origin/main && opencode run "Implement this GitHub issue using /ob-autopilot ... Issue title: Add dark mode toggle Issue body: Users want a dark theme" --model "opencode/big-pickle"`
+
+stdout: `{"title":"Add dark mode toggle","body":"Implemented dark mode toggle with CSS variables..."}`
+context: `{ number: 456, title: "Add dark mode toggle", body: "Implemented dark mode toggle..." }`
+
+**Task 4** (chain, onSuccess): Verify sync and close the issue
+
+```bash
+git push && git fetch origin && [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] && gh issue edit {{number}} --remove-label "implementing" && gh issue close {{number}}
+```
+
+interpolated: `git push && git fetch origin && [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] && gh issue edit 456 --remove-label "implementing" && gh issue close 456`
+
+The `git rev-parse` check ensures local and remote are in sync before closing - if the push failed or remote is ahead, the command fails and the issue stays open.
+
 ## Development
 
 Requires [Bun](https://bun.sh) >= 1.2 for package management and the board, and [Node.js](https://nodejs.org) >= 20 for the CLI and daemon.

package/dist/board/App.js

@@ -12,8 +12,9 @@ import { FilterBar } from "./components/FilterBar.js";
 import { Navigator } from "./components/Navigator.js";
 import { Inspector } from "./components/Inspector.js";
 import { RunHistory } from "./components/RunHistory.js";
-import { ActionButtons } from "./components/ActionButtons.js";
+import { ActionButtons, getActionKeys } from "./components/ActionButtons.js";
 import { HelpModal } from "./components/HelpModal.js";
+import { ContextHelpModal } from "./components/ContextHelpModal.js";
 import { Footer } from "./components/Footer.js";
 import { ConfirmModal } from "./components/ConfirmModal.js";
 import { CreateView, createInitialValues } from "./components/CreateForm.js";
@@ -27,6 +28,7 @@ import { fetchRunLog, deleteLoop, pauseLoop, resumeLoop, stopLoop, playLoop, tri
 import { useBreakpoint } from "./hooks/useBreakpoint.js";
 import { useRouter } from "./router.js";
 import { POLL_MS } from "../config/constants.js";
+import { useTabNav } from "./hooks/useTabNav.js";
 const VIEW_TO_MODE = {
     create: "create",
     "task-create": "task",
@@ -58,6 +60,7 @@ export function App(props) {
     const [selectedIndex, setSelectedIndex] = useState(0);
     const [searchActive, setSearchActive] = useState(false);
     const [helpOpen, setHelpOpen] = useState(false);
+    const [contextHelpOpen, setContextHelpOpen] = useState(false);
     const [confirm, setConfirm] = useState(null);
     const [confirmChoice, setConfirmChoice] = useState(0);
     const [editTarget, setEditTarget] = useState(null);
@@ -66,14 +69,12 @@ export function App(props) {
     const [pendingTaskSelection, setPendingTaskSelection] = useState(null);
     const [selectedRunIndex, setSelectedRunIndex] = useState(0);
     const [selectedAction, setSelectedAction] = useState(0);
-    const [focusedPanel, setFocusedPanel] = useState("loops");
     const [logModalRun, setLogModalRun] = useState(null);
     const [logModalLines, setLogModalLines] = useState([]);
     const [logModalLoading, setLogModalLoading] = useState(false);
     const [tasks, setTasks] = useState([]);
     const [taskSelectedIndex, setTaskSelectedIndex] = useState(0);
     const [taskSelectedAction, setTaskSelectedAction] = useState(0);
-    const [taskFocusedPanel, setTaskFocusedPanel] = useState("tasks");
     const [taskSearchActive, setTaskSearchActive] = useState(false);
     const [taskQuery, setTaskQuery] = useState("");
     const [projects, setProjects] = useState([]);
@@ -280,6 +281,30 @@ export function App(props) {
         pop();
         pushToast("success", updated ? t("board.toastTaskUpdated", { id }) : t("board.toastTaskCreated", { id }));
     };
+    const FORM_VIEWS = ["create", "task-create", "task-edit"];
+    const isFormView = FORM_VIEWS.includes(view);
+    const actionKeys = selected ? getActionKeys(selected.status) : [];
+    const actionItems = actionKeys.map((k) => `action-${k}`);
+    const boardItems = ["search", "project-filter", "status", "sort", "header-1", "header-2", "header-3", "navigator", "run-history", ...actionItems];
+    const taskItems = ["task-search", "header-1", "header-2", "header-3", "task-list", ...(["select", "edit", "delete"].map((k) => `task-action-${k}`))];
+    const projectItems = ["header-1", "header-2", "header-3"];
+    const navItems = isFormView ? [] : view === "task-list" ? taskItems : view === "projects" ? projectItems : boardItems;
+    const { focusedItem: navFocused, setFocusIndex: setNavIndex, enabled: navEnabled } = useTabNav(navItems);
+    const HEADER_MAP = { "header-1": "header-tasks", "header-2": "header-projects", "header-3": "header-new" };
+    const isHeaderFocused = navFocused === "header-1" || navFocused === "header-2" || navFocused === "header-3";
+    const derivedFocusedPanel = isHeaderFocused ? HEADER_MAP[navFocused] : navFocused ?? "loops";
+    const actionIdx = navFocused?.startsWith("action-") ? actionKeys.indexOf(navFocused.slice("action-".length)) : -1;
+    const derivedSelectedAction = actionIdx >= 0 ? actionIdx : selectedAction;
+    const taskActionIdx = navFocused?.startsWith("task-action-") ? ["select", "edit", "delete"].indexOf(navFocused.slice("task-action-".length)) : -1;
+    const derivedTaskAction = taskActionIdx >= 0 ? taskActionIdx : taskSelectedAction;
+    const taskPanelMap = {
+        "task-search": "search",
+        "task-list": "tasks",
+        "task-action-select": "actions",
+        "task-action-edit": "actions",
+        "task-action-delete": "actions",
+    };
+    const derivedTaskPanel = (navFocused ? taskPanelMap[navFocused] : undefined) ?? "tasks";
     useBoardKeybindings({
         confirm,
         confirmChoice,
@@ -307,9 +332,13 @@ export function App(props) {
         selectedRunIndex,
         setSelectedRunIndex,
         selectedRunCount: selected?.runHistory?.length ?? 0,
-        focusedPanel,
-        setFocusedPanel,
-        selectedAction,
+        focusedPanel: derivedFocusedPanel,
+        setFocusedPanel: ((p) => {
+            const navIdx = navItems.indexOf(p);
+            if (navIdx >= 0)
+                setNavIndex(navIdx);
+        }),
+        selectedAction: derivedSelectedAction,
         setSelectedAction,
         onAction: handleAction,
         onOpenRunLog: handleOpenRunLog,
@@ -327,10 +356,23 @@ export function App(props) {
         tasks: filteredTasks,
         taskSelectedIndex,
         setTaskSelectedIndex,
-        taskSelectedAction,
-        setTaskSelectedAction,
-        taskFocusedPanel,
-        setTaskFocusedPanel,
+        taskSelectedAction: derivedTaskAction,
+        setTaskSelectedAction: ((updater) => {
+            const nextIdx = typeof updater === "function" ? updater(derivedTaskAction) : updater;
+            const taskActions = ["select", "edit", "delete"];
+            const actionKey = taskActions[nextIdx];
+            if (actionKey) {
+                const navIdx = navItems.indexOf(`task-action-${actionKey}`);
+                if (navIdx >= 0)
+                    setNavIndex(navIdx);
+            }
+        }),
+        taskFocusedPanel: derivedTaskPanel,
+        setTaskFocusedPanel: ((p) => {
+            const navIdx = navItems.indexOf(p === "search" ? "task-search" : p === "actions" ? "task-actions" : "task-list");
+            if (navIdx >= 0)
+                setNavIndex(navIdx);
+        }),
         taskSearchActive,
         setTaskSearchActive,
         taskQuery,
@@ -338,9 +380,8 @@ export function App(props) {
         onTaskAction: handleTaskAction,
         onCancel: cancelTaskList,
         onCreateTask: handleCreateTask,
-        onEnterHeader: (direction) => {
-            setFocusedPanel(direction === "right" ? "header-tasks" : "header-new");
-        },
+        onToggleContextHelp: () => setContextHelpOpen((v) => !v),
+        headerFocused: isHeaderFocused,
         selectable: stack.includes("create") || stack.includes("task-edit"),
     });
     const counts = {
@@ -351,16 +392,14 @@ export function App(props) {
         idle: loops.filter((l) => l.status === "idle").length,
     };
     const mode = resolveMode(confirm, searchActive || taskSearchActive, helpOpen, view);
-    return (_jsxs("box", { style: { flexDirection: "column", width: "100%", height: "100%", backgroundColor: "#0b0b0b" }, children: [_jsx(Header, { daemonStatus: daemonStatus, counts: counts, view: view, focusedPanel: focusedPanel, onViewLoops: () => replace("board"), onViewTasks: () => { void refreshTasks(); push("task-list"); }, onViewProjects: () => push("projects"), onAddLoop: () => { setEditTarget(null); push("create"); }, onAddTask: () => { setEditTask(null); push("task-create"); }, onAddProject: () => { if (view === "projects") {
+    return (_jsxs("box", { style: { flexDirection: "column", width: "100%", height: "100%", backgroundColor: "#0b0b0b" }, children: [_jsx(Header, { daemonStatus: daemonStatus, counts: counts, view: view, focusedPanel: derivedFocusedPanel, onViewLoops: () => replace("board"), onViewTasks: () => { void refreshTasks(); push("task-list"); }, onViewProjects: () => push("projects"), onAddLoop: () => { setEditTarget(null); push("create"); }, onAddTask: () => { setEditTask(null); push("task-create"); }, onAddProject: () => { if (view === "projects") {
                     createProjectTriggerRef.current?.();
                 }
                 else {
                     push("projects");
-                } } }), view === "board" ? (_jsx(FilterBar, { filters: filters, sort: sort, searchActive: searchActive, focusedPanel: focusedPanel, onStatusCycle: () => setFilters((prev) => ({ ...prev, status: cycleStatusFilter(prev.status) })), onSortCycle: () => setSort(cycleSortMode(sort)), onSelectProject: () => setProjectsModalOpen(true), currentProjectName: currentProjectId === "all" ? t("project.showAll") : (projects.find(p => p.id === currentProjectId)?.name ?? "Default"), onQueryChange: (value) => setFilters((prev) => ({ ...prev, query: value })), onSearchActivate: () => setSearchActive(true), onSearchDismiss: () => { setSearchActive(false); setFocusedPanel("loops"); } })) : view === "task-list" ? (_jsx(TaskFilterBar, { query: taskQuery, searchActive: taskSearchActive, focusedPanel: taskFocusedPanel, onQueryChange: setTaskQuery, onSearchActivate: () => setTaskSearchActive(true), onSearchDismiss: () => { setTaskSearchActive(false); setTaskFocusedPanel("tasks"); } })) : null, _jsx("box", { style: { flexGrow: 1, backgroundColor: "#0b0b0b" }, children: view === "create" ? (_jsx(CreateView, { mode: editTarget && !cloneMode ? "edit" : "create", editId: editTarget && !cloneMode ? editTarget.id : null, initial: createInitialValues(editTarget, currentProjectId), selectedTaskId: pendingTaskSelection?.id ?? null, selectedTaskName: pendingTaskSelection?.name ?? null, projects: projects, currentProjectId: currentProjectId, onCancel: cancelCreate, onDone: onCreateDone, onChooseTask: handleChooseTask })) : TASK_FORM_VIEWS.has(view) ? (_jsx(TaskForm, { mode: view === "task-edit" ? "edit" : "create", editTask: editTask, onCancel: cancelTask, onDone: onTaskDone })) : view === "task-list" ? (_jsxs("box", { style: { flexDirection: breakpoint === "narrow" ? "column" : "row", flexGrow: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(TaskNavigator, { visible: filteredTasks, total: tasks.length, selectedIndex: taskClampedIndex, focused: taskFocusedPanel === "tasks", query: taskQuery, onSelect: (index) => { setTaskSelectedIndex(index); setTaskFocusedPanel("tasks"); }, onActivate: (index) => { setTaskSelectedIndex(index); setEditTask(filteredTasks[index] ?? null); push("task-edit"); } }), _jsxs("box", { style: { flexDirection: "column", flexGrow: 1, backgroundColor: "#0b0b0b", overflow: "hidden" }, children: [_jsx(TaskInspector, { task: selectedTask }, `ti-${selectedTask?.id}`), _jsx(TaskActionButtons, { task: selectedTask, focused: taskFocusedPanel === "actions", selectedAction: taskSelectedAction, selectable: stack.includes("create") || stack.includes("task-edit"), onAction: handleTaskAction }, `tab-${selectedTask?.id}`)] })] })) : view === "projects" ? (_jsx(ProjectsPage, { projects: projects, loops: loops, onClose: () => pop(), onRefresh: refreshProjects, onOpenCreate: (trigger) => { createProjectTriggerRef.current = trigger; }, onEnterHeader: (direction) => {
-                        setFocusedPanel(direction === "right" ? "header-tasks" : "header-new");
-                    } })) : (_jsxs("box", { style: { flexDirection: breakpoint === "narrow" ? "column" : "row", flexGrow: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(Navigator, { visible: visible, total: loops.length, selectedIndex: clampedIndex, filters: filters, sort: sort, breakpoint: breakpoint, focused: focusedPanel === "loops", projects: projects, onSelect: (index) => { setSelectedIndex(index); setFocusedPanel("loops"); }, onActivate: (index) => { setSelectedIndex(index); const loop = visible[index]; if (loop) {
+                } } }), view === "board" ? (_jsx(FilterBar, { filters: filters, sort: sort, searchActive: searchActive, focusedPanel: derivedFocusedPanel, onStatusCycle: () => setFilters((prev) => ({ ...prev, status: cycleStatusFilter(prev.status) })), onSortCycle: () => setSort(cycleSortMode(sort)), onSelectProject: () => setProjectsModalOpen(true), currentProjectName: currentProjectId === "all" ? t("project.showAll") : (projects.find(p => p.id === currentProjectId)?.name ?? "Default"), onQueryChange: (value) => setFilters((prev) => ({ ...prev, query: value })), onSearchActivate: () => setSearchActive(true), onSearchDismiss: () => { setSearchActive(false); } })) : view === "task-list" ? (_jsx(TaskFilterBar, { query: taskQuery, searchActive: taskSearchActive, focusedPanel: derivedTaskPanel, onQueryChange: setTaskQuery, onSearchActivate: () => setTaskSearchActive(true), onSearchDismiss: () => { setTaskSearchActive(false); } })) : null, _jsx("box", { style: { flexGrow: 1, backgroundColor: "#0b0b0b" }, children: view === "create" ? (_jsx(CreateView, { mode: editTarget && !cloneMode ? "edit" : "create", editId: editTarget && !cloneMode ? editTarget.id : null, initial: createInitialValues(editTarget, currentProjectId), selectedTaskId: pendingTaskSelection?.id ?? null, selectedTaskName: pendingTaskSelection?.name ?? null, projects: projects, currentProjectId: currentProjectId, onCancel: cancelCreate, onDone: onCreateDone, onChooseTask: handleChooseTask })) : TASK_FORM_VIEWS.has(view) ? (_jsx(TaskForm, { mode: view === "task-edit" ? "edit" : "create", editTask: editTask, onCancel: cancelTask, onDone: onTaskDone })) : view === "task-list" ? (_jsxs("box", { style: { flexDirection: breakpoint === "narrow" ? "column" : "row", flexGrow: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(TaskNavigator, { visible: filteredTasks, total: tasks.length, selectedIndex: taskClampedIndex, focused: derivedTaskPanel === "tasks", query: taskQuery, onSelect: (index) => { setTaskSelectedIndex(index); }, onActivate: (index) => { setTaskSelectedIndex(index); setEditTask(filteredTasks[index] ?? null); push("task-edit"); } }), _jsxs("box", { style: { flexDirection: "column", flexGrow: 1, backgroundColor: "#0b0b0b", overflow: "hidden" }, children: [_jsx(TaskInspector, { task: selectedTask }, `ti-${selectedTask?.id}`), _jsx(TaskActionButtons, { task: selectedTask, focused: taskActionIdx >= 0, selectedAction: derivedTaskAction, selectable: stack.includes("create") || stack.includes("task-edit"), onAction: handleTaskAction }, `tab-${selectedTask?.id}`)] })] })) : view === "projects" ? (_jsx(ProjectsPage, { projects: projects, loops: loops, headerFocused: isHeaderFocused, onClose: () => pop(), onRefresh: refreshProjects, onOpenCreate: (trigger) => { createProjectTriggerRef.current = trigger; }, onEnterHeader: () => { } })) : (_jsxs("box", { style: { flexDirection: breakpoint === "narrow" ? "column" : "row", flexGrow: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(Navigator, { visible: visible, total: loops.length, selectedIndex: clampedIndex, filters: filters, sort: sort, breakpoint: breakpoint, focused: derivedFocusedPanel === "loops" || derivedFocusedPanel === "navigator", projects: projects, onSelect: (index) => setSelectedIndex(index), onActivate: (index) => { setSelectedIndex(index); const loop = visible[index]; if (loop) {
                                 setEditTarget(loop);
                                 push("create");
-                            } } }), _jsxs("box", { style: { flexDirection: "column", flexGrow: 1, backgroundColor: "#0b0b0b", overflow: "hidden" }, children: [_jsx(Inspector, { loop: selected }), _jsx(RunHistory, { loop: selected, selectedRunIndex: selectedRunIndex, focused: focusedPanel === "runs", onSelectRun: (index) => { setSelectedRunIndex(index); setFocusedPanel("runs"); }, onOpenRun: handleOpenRunLog }), _jsx(ActionButtons, { loop: selected, focused: focusedPanel === "actions", selectedAction: selectedAction, onAction: handleAction })] })] })) }, viewKey(view, editTarget, editTask)), _jsx(Footer, { mode: mode }), confirm ? (_jsx(ConfirmModal, { message: confirm.message, choice: confirmChoice, onYes: () => { const action = confirm.action; setConfirm(null); void action(); }, onNo: () => setConfirm(null) })) : null, helpOpen ? _jsx(HelpModal, { view: view }) : null, logModalRun ? (_jsx(LogModal, { loopId: selectedId, run: logModalRun, logLines: logModalLines, loading: logModalLoading, onClose: () => setLogModalRun(null) })) : null, projectsModalOpen ? (_jsx(ProjectsModal, { projects: projects, loops: loops, currentProjectId: currentProjectId, onSelect: (id) => { setCurrentProjectId(id); setProjectsModalOpen(false); }, onClose: () => setProjectsModalOpen(false) })) : null, _jsx(ToastStack, { toasts: toasts })] }));
+                            } } }), _jsxs("box", { style: { flexDirection: "column", flexGrow: 1, backgroundColor: "#0b0b0b", overflow: "hidden" }, children: [_jsx(Inspector, { loop: selected }), _jsx(RunHistory, { loop: selected, selectedRunIndex: selectedRunIndex, focused: derivedFocusedPanel === "runs" || derivedFocusedPanel === "run-history", onSelectRun: (index) => setSelectedRunIndex(index), onOpenRun: handleOpenRunLog }), _jsx(ActionButtons, { loop: selected, focused: actionIdx >= 0, selectedAction: derivedSelectedAction, onAction: handleAction })] })] })) }, viewKey(view, editTarget, editTask)), _jsx(Footer, { mode: mode }), confirm ? (_jsx(ConfirmModal, { message: confirm.message, choice: confirmChoice, onYes: () => { const action = confirm.action; setConfirm(null); void action(); }, onNo: () => setConfirm(null) })) : null, helpOpen ? _jsx(HelpModal, { view: view }) : null, contextHelpOpen ? _jsx(ContextHelpModal, { onClose: () => setContextHelpOpen(false) }) : null, logModalRun ? (_jsx(LogModal, { loopId: selectedId, run: logModalRun, logLines: logModalLines, loading: logModalLoading, onClose: () => setLogModalRun(null) })) : null, projectsModalOpen ? (_jsx(ProjectsModal, { projects: projects, loops: loops, currentProjectId: currentProjectId, onSelect: (id) => { setCurrentProjectId(id); setProjectsModalOpen(false); }, onClose: () => setProjectsModalOpen(false) })) : null, _jsx(ToastStack, { toasts: toasts })] }));
 }
 const TASK_FORM_VIEWS = new Set(["task-create", "task-edit"]);

package/dist/board/components/ActionButtons.js

@@ -2,22 +2,22 @@ import { jsx as _jsx } from "@opentui/react/jsx-runtime";
 import { t } from "../../i18n/index.js";
 import { useHoverState } from "../hooks/useHoverState.js";
 import { HOVER_BG } from "../../config/constants.js";
-export function getActions(status) {
+const STOP_ACTION = { key: "stop", label: t("board.actionStop") };
+const PAUSE_ACTION = { key: "pause", label: t("board.actionPause") };
+const PLAY_ACTION = { key: "play", label: t("board.actionPlay") };
+const STATUS_ACTIONS = {
+    running: [STOP_ACTION],
+    waiting: [PAUSE_ACTION, STOP_ACTION],
+    paused: [STOP_ACTION, PLAY_ACTION],
+    idle: [PLAY_ACTION],
+    stopped: [PLAY_ACTION],
+};
+function getActions(status) {
     const actions = [
         { key: "edit", label: t("board.actionEdit") },
         { key: "delete", label: t("board.actionDelete") },
     ];
-    if (status === "waiting") {
-        actions.push({ key: "pause", label: t("board.actionPause") });
-        actions.push({ key: "stop", label: t("board.actionStop") });
-    }
-    else if (status === "paused") {
-        actions.push({ key: "stop", label: t("board.actionStop") });
-        actions.push({ key: "play", label: t("board.actionPlay") });
-    }
-    else if (status === "idle" || status === "stopped") {
-        actions.push({ key: "play", label: t("board.actionPlay") });
-    }
+    actions.push(...STATUS_ACTIONS[status]);
     if (status !== "running") {
         actions.push({ key: "clone", label: t("board.actionClone") });
         actions.push({ key: "trigger", label: t("board.actionTrigger") });

package/dist/board/components/ContextHelpModal.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
+import { useTerminalDimensions } from "@opentui/react";
+import { t } from "../../i18n/index.js";
+export function ContextHelpModal(props) {
+    const { onClose } = props;
+    const { width } = useTerminalDimensions();
+    return (_jsx("box", { onMouseDown: onClose, style: {
+            position: "absolute",
+            top: 0,
+            left: 0,
+            width: "100%",
+            height: "100%",
+            justifyContent: "center",
+            alignItems: "center",
+            zIndex: 90,
+        }, children: _jsxs("box", { title: t("context.helpTitle"), border: true, style: {
+                flexDirection: "column",
+                padding: 1,
+                minWidth: Math.min(72, width - 4),
+                backgroundColor: "#111827",
+            }, children: [_jsx("text", { fg: "#e5e7eb", children: t("context.helpRules") }), _jsx("text", { children: " " }), _jsx("text", { fg: "#38bdf8", children: "{{key}} Templates" }), _jsx("text", { fg: "#e5e7eb", children: t("context.helpTemplates") }), _jsx("text", { children: " " }), _jsx("text", { fg: "#f59e0b", children: "Caveat" }), _jsx("text", { fg: "#e5e7eb", children: t("context.helpCaveat") }), _jsx("text", { children: " " }), _jsx("text", { fg: "#34d399", children: "jq Tip" }), _jsx("text", { fg: "#e5e7eb", children: t("context.helpJqTip") }), _jsx("text", { children: " " }), _jsx("text", { fg: "#9ca3af", children: "Press any key or click to close" })] }) }));
+}

package/dist/board/components/CreateForm.js

@@ -8,6 +8,8 @@ import { commandLine } from "../format.js";
 import { createLoop, updateLoop, listTasks } from "../daemon.js";
 import { useHoverState } from "../hooks/useHoverState.js";
 import { useInputShortcuts } from "../hooks/useInputShortcuts.js";
+import { useTabNav } from "../hooks/useTabNav.js";
+import { SearchSelect } from "./SearchSelect.js";
 import { HOVER_BG } from "../../config/constants.js";
 export const TASK_MODE_INLINE = "inline";
 export const TASK_MODE_EXISTING = "existing";
@@ -44,25 +46,10 @@ export function CreateView(props) {
         project: props.initial.project ?? props.currentProjectId ?? "default",
     });
     const valuesRef = useRef(values);
-    const [focusIndex, setFocusIndex] = useState(0);
     const [error, setError] = useState("");
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [selectedTaskName, setSelectedTaskName] = useState(props.selectedTaskName ?? null);
     const inputRef = useRef(null);
-    useInputShortcuts(() => {
-        if (focusIndex >= saveIndex)
-            return null;
-        return inputRef.current;
-    });
-    useState(() => {
-        if (values.taskId && !selectedTaskName) {
-            void listTasks().then((tasks) => {
-                const found = tasks.find((t) => t.id === values.taskId);
-                if (found)
-                    setSelectedTaskName(found.name);
-            }).catch(() => { });
-        }
-    });
     const { width: termWidth } = useTerminalDimensions();
     const btnWidth = Math.max(10, Math.min(14, Math.floor(termWidth / 6)));
     const isInline = values.taskMode === TASK_MODE_INLINE;
@@ -76,9 +63,22 @@ export function CreateView(props) {
             return !isInline;
         return true;
     });
-    const chooseTaskIdx = filteredFields.indexOf("taskId");
-    const saveIndex = filteredFields.length;
-    const cancelIndex = filteredFields.length + 1;
+    const navItems = [...filteredFields, "save", "cancel"];
+    const { setFocusIndex, focusedItem, isFocused } = useTabNav(navItems);
+    useInputShortcuts(() => {
+        if (focusedItem === "save" || focusedItem === "cancel")
+            return null;
+        return inputRef.current;
+    });
+    useState(() => {
+        if (values.taskId && !selectedTaskName) {
+            void listTasks().then((tasks) => {
+                const found = tasks.find((t) => t.id === values.taskId);
+                if (found)
+                    setSelectedTaskName(found.name);
+            }).catch(() => { });
+        }
+    });
     function updateValues(next) {
         valuesRef.current = next;
         setValues(next);
@@ -90,66 +90,29 @@ export function CreateView(props) {
         setSelectedTaskName(props.selectedTaskName ?? props.selectedTaskId);
     }
     useKeyboard((key) => {
-        if (key.name === "tab") {
-            setFocusIndex((i) => {
-                const next = key.shift ? i - 1 : i + 1;
-                if (next < 0)
-                    return cancelIndex;
-                if (next > cancelIndex)
-                    return 0;
-                return next;
-            });
-            key.preventDefault();
-            return;
-        }
-        if (key.name === "up" || key.name === "down") {
-            const field = filteredFields[focusIndex];
-            if (field === "project" && projectOptions.length > 1) {
-                const currentIdx = projectOptions.findIndex((p) => p.value === valuesRef.current.project);
-                const nextIdx = key.name === "down"
-                    ? (currentIdx + 1) % projectOptions.length
-                    : (currentIdx - 1 + projectOptions.length) % projectOptions.length;
-                const next = projectOptions[nextIdx];
-                if (next)
-                    updateValues({ ...valuesRef.current, project: next.value });
-                key.preventDefault();
-                return;
-            }
-            setFocusIndex((i) => {
-                const next = key.name === "up" ? i - 1 : i + 1;
-                if (next < 0)
-                    return cancelIndex;
-                if (next > cancelIndex)
-                    return 0;
-                return next;
-            });
-            key.preventDefault();
-            return;
-        }
         if (key.name === "return" || key.name === "enter" || key.name === " ") {
-            const field = filteredFields[focusIndex];
-            if (field === "taskMode") {
+            if (focusedItem === "taskMode") {
                 const next = valuesRef.current.taskMode === TASK_MODE_INLINE ? TASK_MODE_EXISTING : TASK_MODE_INLINE;
                 updateValues({ ...valuesRef.current, taskMode: next });
                 key.preventDefault();
                 return;
             }
-            if (field === "runNow") {
+            if (focusedItem === "runNow") {
                 const next = valuesRef.current.runNow === "y" ? "n" : "y";
                 updateValues({ ...valuesRef.current, runNow: next });
                 key.preventDefault();
                 return;
             }
-            if (focusIndex === chooseTaskIdx && !isInline) {
+            if (focusedItem === "taskId" && !isInline) {
                 props.onChooseTask();
                 key.preventDefault();
                 return;
             }
-            if (focusIndex === saveIndex) {
+            if (focusedItem === "save") {
                 void submit(valuesRef.current);
                 key.preventDefault();
             }
-            else if (focusIndex === cancelIndex) {
+            else if (focusedItem === "cancel") {
                 props.onCancel();
                 key.preventDefault();
             }
@@ -278,8 +241,8 @@ export function CreateView(props) {
     return (_jsxs("box", { title: title, border: true, style: { flexDirection: "column", flexGrow: 1, padding: 1, backgroundColor: "#0b0b0b" }, children: [_jsxs("box", { style: { flexDirection: "column", marginBottom: 1 }, children: [_jsx("text", { fg: "#9ca3af", children: t("board.exampleHeading") }), _jsx("text", { fg: "#d1d5db", children: t("board.exampleFull") })] }), _jsx("box", { style: { flexDirection: "column", flexGrow: 1 }, children: Array.from({ length: Math.ceil(filteredFields.length / 2) }, (_, row) => {
                     const leftField = filteredFields[row * 2];
                     const rightField = row * 2 + 1 < filteredFields.length ? filteredFields[row * 2 + 1] : null;
-                    return (_jsxs("box", { style: { flexDirection: "row", marginBottom: 1 }, children: [_jsx(FormRow, { field: leftField, index: row * 2, focusIndex: focusIndex, values: values, valuesRef: valuesRef, updateValues: updateValues, setFocusIndex: setFocusIndex, submit: submit, labels: labels, hints: hints, examples: examples, taskModeOptions: taskModeOptions, runNowOptions: runNowOptions, projectOptions: projectOptions, selectedTaskName: selectedTaskName, fields: filteredFields, onChooseTask: props.onChooseTask, inputRef: inputRef, style: { width: "50%", paddingRight: 1 } }), rightField ? (_jsx(FormRow, { field: rightField, index: row * 2 + 1, focusIndex: focusIndex, values: values, valuesRef: valuesRef, updateValues: updateValues, setFocusIndex: setFocusIndex, submit: submit, labels: labels, hints: hints, examples: examples, taskModeOptions: taskModeOptions, runNowOptions: runNowOptions, projectOptions: projectOptions, selectedTaskName: selectedTaskName, fields: filteredFields, onChooseTask: props.onChooseTask, inputRef: inputRef, style: { width: "50%" } })) : (_jsx("box", { style: { width: "50%" } }))] }, row));
-                }) }), _jsxs("box", { style: { flexDirection: "row", height: 3, marginBottom: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(HoverButton, { label: isSubmitting ? t("board.saving") : props.mode === "edit" ? t("board.save") : t("board.create"), onMouseDown: () => void submit(valuesRef.current), selected: focusIndex === saveIndex, width: btnWidth, marginRight: 1 }), _jsx(HoverButton, { label: t("board.cancel"), onMouseDown: props.onCancel, selected: focusIndex === cancelIndex, width: btnWidth })] }), _jsx("text", { fg: "#9ca3af", children: t("board.formNav") }), error ? _jsx("text", { fg: "#f87171", children: error }) : null] }));
+                    return (_jsxs("box", { style: { flexDirection: "row", marginBottom: 1 }, children: [_jsx(FormRow, { field: leftField, index: row * 2, isFocused: isFocused(leftField), values: values, valuesRef: valuesRef, updateValues: updateValues, setFocusIndex: setFocusIndex, submit: submit, labels: labels, hints: hints, examples: examples, taskModeOptions: taskModeOptions, runNowOptions: runNowOptions, projectOptions: projectOptions, selectedTaskName: selectedTaskName, onChooseTask: props.onChooseTask, inputRef: inputRef, style: { width: "50%", paddingRight: 1 } }), rightField ? (_jsx(FormRow, { field: rightField, index: row * 2 + 1, isFocused: isFocused(rightField), values: values, valuesRef: valuesRef, updateValues: updateValues, setFocusIndex: setFocusIndex, submit: submit, labels: labels, hints: hints, examples: examples, taskModeOptions: taskModeOptions, runNowOptions: runNowOptions, projectOptions: projectOptions, selectedTaskName: selectedTaskName, onChooseTask: props.onChooseTask, inputRef: inputRef, style: { width: "50%" } })) : (_jsx("box", { style: { width: "50%" } }))] }, row));
+                }) }), _jsxs("box", { style: { flexDirection: "row", height: 3, marginBottom: 1, backgroundColor: "#0b0b0b" }, children: [_jsx(HoverButton, { label: isSubmitting ? t("board.saving") : props.mode === "edit" ? t("board.save") : t("board.create"), onMouseDown: () => void submit(valuesRef.current), selected: isFocused("save"), width: btnWidth, marginRight: 1 }), _jsx(HoverButton, { label: t("board.cancel"), onMouseDown: props.onCancel, selected: isFocused("cancel"), width: btnWidth })] }), _jsx("text", { fg: "#9ca3af", children: t("board.formNav") }), error ? _jsx("text", { fg: "#f87171", children: error }) : null] }));
 }
 function HoverButton(props) {
     const { isHovered, hoverProps } = useHoverState();
@@ -288,9 +251,8 @@ function HoverButton(props) {
     return (_jsx("box", { border: true, onMouseDown: props.onMouseDown, borderColor: borderColor, style: { width: props.width, justifyContent: "center", alignItems: "center", marginRight: props.marginRight, backgroundColor: bg }, ...hoverProps, children: _jsx("text", { fg: "#e5e7eb", children: _jsx("strong", { children: props.label }) }) }));
 }
 function FormRow(props) {
-    const { field, index, focusIndex, values, valuesRef, updateValues, setFocusIndex, submit, labels, hints, examples, taskModeOptions, runNowOptions, projectOptions, selectedTaskName, fields, onChooseTask, inputRef, style } = props;
+    const { field, index, isFocused, values, valuesRef, updateValues, setFocusIndex, submit, labels, hints, examples, taskModeOptions, runNowOptions, projectOptions, selectedTaskName, onChooseTask, inputRef, style } = props;
     const { isHovered, hoverProps } = useHoverState();
-    const isFocused = focusIndex === index;
     const isToggleField = field === "taskMode" || field === "runNow";
     const isTaskButton = field === "taskId";
     const isProjectField = field === "project";
@@ -301,15 +263,5 @@ function FormRow(props) {
                     return (_jsx("box", { onMouseDown: () => updateValues({ ...valuesRef.current, [field]: opt.value }), style: { backgroundColor: isActive ? "#1e3a8a" : undefined, paddingLeft: 1, paddingRight: 1, marginRight: 1 }, ...hoverProps, children: _jsx("text", { fg: isActive ? "#ffffff" : isHovered ? "#e5e7eb" : "#9ca3af", children: _jsx("strong", { children: opt.name }) }) }, opt.value));
                 }) })) : isTaskButton ? (_jsx("box", { border: true, borderColor: isFocused ? "#38bdf8" : undefined, style: { height: 3, flexDirection: "row", backgroundColor: "#0b0b0b", alignItems: "center", paddingLeft: 1 }, onMouseDown: () => { setFocusIndex(index); onChooseTask(); }, children: _jsx("text", { fg: values.taskId ? "#4ade80" : "#9ca3af", children: values.taskId
                         ? t("board.selectedTask", { name: selectedTaskName ?? values.taskId })
-                        : t("board.chooseTask") }) })) : isProjectField ? (_jsx("box", { border: true, borderColor: isFocused ? "#38bdf8" : undefined, style: { height: 3, flexDirection: "row", backgroundColor: "#0b0b0b", alignItems: "center", paddingLeft: 1 }, onMouseDown: () => setFocusIndex(index), children: projectOptions.map((opt) => {
-                    const isActive = values.project === opt.value;
-                    return (_jsx("box", { onMouseDown: () => updateValues({ ...valuesRef.current, project: opt.value }), style: { backgroundColor: isActive ? "#1e3a8a" : undefined, paddingLeft: 1, paddingRight: 1, marginRight: 1 }, children: _jsx("text", { fg: isActive ? "#ffffff" : "#9ca3af", children: `● ${opt.name}` }) }, opt.value));
-                }) })) : (_jsx("box", { border: true, borderColor: isFocused ? "#38bdf8" : undefined, style: { height: 3, backgroundColor: "#0b0b0b" }, children: _jsx("input", { ref: inputRef, focused: isFocused, value: values[field], placeholder: examples[field] ? t("board.placeholderExample", { example: examples[field] }) : t("board.placeholderBlank"), onInput: (value) => updateValues({ ...valuesRef.current, [field]: value }), onSubmit: () => {
-                        if (index < fields.length - 1) {
-                            setFocusIndex(index + 1);
-                        }
-                        else {
-                            void submit(valuesRef.current);
-                        }
-                    } }) }))] }));
+                        : t("board.chooseTask") }) })) : isProjectField ? (_jsx(SearchSelect, { options: projectOptions, value: values.project, onChange: (v) => updateValues({ ...valuesRef.current, project: v }), focused: isFocused })) : (_jsx("box", { border: true, borderColor: isFocused ? "#38bdf8" : undefined, style: { height: 3, backgroundColor: "#0b0b0b" }, children: _jsx("input", { ref: inputRef, focused: isFocused, value: values[field], placeholder: examples[field] ? t("board.placeholderExample", { example: examples[field] }) : t("board.placeholderBlank"), onInput: (value) => updateValues({ ...valuesRef.current, [field]: value }), onSubmit: () => { void submit(valuesRef.current); } }) }))] }));
 }

package/dist/board/components/CreateProjectModal.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
 import { useState } from "react";
+import { useTabNav } from "../hooks/useTabNav.js";
 import { useKeyboard, useTerminalDimensions } from "@opentui/react";
 import { t } from "../../i18n/index.js";
 import { createProject } from "../daemon.js";
@@ -12,15 +13,8 @@ export function CreateProjectModal(props) {
     const [selectedColorKey, setSelectedColorKey] = useState(defaultColorKey);
     const [error, setError] = useState("");
     const [isSubmitting, setIsSubmitting] = useState(false);
-    const [focusField, setFocusField] = useState("name");
+    const { focusedItem: focusField, setFocusIndex } = useTabNav(["name", "color", "save", "cancel"]);
     useKeyboard((key) => {
-        if (key.name === "tab") {
-            const order = ["name", "color", "save", "cancel"];
-            const idx = order.indexOf(focusField);
-            const next = key.shift ? order[(idx - 1 + order.length) % order.length] : order[(idx + 1) % order.length];
-            setFocusField(next ?? "name");
-            return;
-        }
         if (key.name === "escape") {
             onCancel();
             return;
@@ -34,14 +28,11 @@ export function CreateProjectModal(props) {
             return;
         }
         if (focusField === "color") {
-            if (key.name === "left") {
-                const idx = PROJECT_COLOR_KEYS.indexOf(selectedColorKey);
-                setSelectedColorKey(PROJECT_COLOR_KEYS[(idx - 1 + PROJECT_COLOR_KEYS.length) % PROJECT_COLOR_KEYS.length] ?? selectedColorKey);
-                return;
-            }
-            if (key.name === "right") {
+            if (key.name === "left" || key.name === "right") {
                 const idx = PROJECT_COLOR_KEYS.indexOf(selectedColorKey);
-                setSelectedColorKey(PROJECT_COLOR_KEYS[(idx + 1) % PROJECT_COLOR_KEYS.length] ?? selectedColorKey);
+                const dir = key.name === "left" ? -1 : 1;
+                setSelectedColorKey(PROJECT_COLOR_KEYS[(idx + dir + PROJECT_COLOR_KEYS.length) % PROJECT_COLOR_KEYS.length] ?? selectedColorKey);
+                key.preventDefault();
                 return;
             }
         }
@@ -81,9 +72,9 @@ export function CreateProjectModal(props) {
                 padding: 1,
                 minWidth: Math.min(44, width - 4),
                 backgroundColor: "#111827",
-            }, children: [_jsx("text", { fg: focusField === "name" ? "#38bdf8" : "#e5e7eb", children: t("project.labelName") }), _jsx("text", { fg: "#6b7280", children: t("project.hintName") }), _jsx("box", { border: true, borderColor: focusField === "name" ? "#38bdf8" : undefined, style: { height: 3, backgroundColor: "#0b0b0b", marginBottom: 1 }, children: _jsx("input", { focused: focusField === "name", value: name, placeholder: "My Project", onInput: (value) => setName(value), onSubmit: () => setFocusField("color") }) }), _jsx("text", { fg: focusField === "color" ? "#38bdf8" : "#e5e7eb", children: t("project.labelColor") }), _jsx("text", { fg: "#6b7280", children: t("project.hintColor") }), _jsx("box", { border: true, borderColor: focusField === "color" ? "#38bdf8" : undefined, style: { height: 3, flexDirection: "row", backgroundColor: "#0b0b0b", alignItems: "center", marginBottom: 1 }, children: PROJECT_COLOR_KEYS.map((colorKey) => {
+            }, children: [_jsx("text", { fg: focusField === "name" ? "#38bdf8" : "#e5e7eb", children: t("project.labelName") }), _jsx("text", { fg: "#6b7280", children: t("project.hintName") }), _jsx("box", { border: true, borderColor: focusField === "name" ? "#38bdf8" : undefined, style: { height: 3, backgroundColor: "#0b0b0b", marginBottom: 1 }, children: _jsx("input", { focused: focusField === "name", value: name, placeholder: "My Project", onInput: (value) => setName(value) }) }), _jsx("text", { fg: focusField === "color" ? "#38bdf8" : "#e5e7eb", children: t("project.labelColor") }), _jsx("text", { fg: "#6b7280", children: t("project.hintColor") }), _jsx("box", { border: true, borderColor: focusField === "color" ? "#38bdf8" : undefined, style: { height: 3, flexDirection: "row", backgroundColor: "#0b0b0b", alignItems: "center", marginBottom: 1 }, children: PROJECT_COLOR_KEYS.map((colorKey) => {
                         const isActive = selectedColorKey === colorKey;
-                        return (_jsx("box", { onMouseDown: () => { setFocusField("color"); setSelectedColorKey(colorKey); }, style: {
+                        return (_jsx("box", { onMouseDown: () => { setFocusIndex(1); setSelectedColorKey(colorKey); }, style: {
                                 backgroundColor: isActive ? "#1e3a8a" : undefined,
                                 paddingLeft: 1,
                                 paddingRight: 1,