loop-task 1.4.7 → 1.5.0

package/README.md

@@ -252,6 +252,78 @@ 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
+
+```bash
+opencode run "Rewrite this GitHub issue as a detailed user story using project context and return only JSON with fields title and body." --model "opencode/big-pickle"
+```
+
+stdout: `{"title":"As a user, I want to log in securely","body":"## Acceptance Criteria\n- Login form validates email\n- ..."}`
+context: `{ number: 123, title: "As a user, I want to log in securely", body: "## Acceptance Criteria\n- ..." }`
+
+**Task 4** (chain, onSuccess): Apply the rewrite and relabel
+
+```bash
+gh issue edit {{number}} --title "{{title}}" --body "{{body}}" --remove-label "refining" --add-label "to implement"
+```
+
+interpolated: `gh issue edit 123 --title "As a user, I want to log in securely" --body "## Acceptance Criteria\n- ..." --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. It outputs a new JSON object with updated `title` and `body`. Since it uses the same key names, the context is updated with the new values (merge with last-writer-wins).
+4. Task 4 receives `{{number}}` (still 123 from task 1), `{{title}}` and `{{body}}` (now the rewritten versions from task 3). It applies the edits 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`.
+
 ## 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

@@ -14,6 +14,7 @@ import { Inspector } from "./components/Inspector.js";
 import { RunHistory } from "./components/RunHistory.js";
 import { ActionButtons } 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";
@@ -58,6 +59,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);
@@ -341,6 +343,7 @@ export function App(props) {
         onEnterHeader: (direction) => {
             setFocusedPanel(direction === "right" ? "header-tasks" : "header-new");
         },
+        onToggleContextHelp: () => setContextHelpOpen((v) => !v),
         selectable: stack.includes("create") || stack.includes("task-edit"),
     });
     const counts = {
@@ -361,6 +364,6 @@ export function App(props) {
                     } })) : (_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) {
                                 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: 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, 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,7 @@ 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 { SearchSelect } from "./SearchSelect.js";
 import { HOVER_BG } from "../../config/constants.js";
 export const TASK_MODE_INLINE = "inline";
 export const TASK_MODE_EXISTING = "existing";
@@ -104,17 +105,8 @@ export function CreateView(props) {
         }
         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();
+            if (field === "project")
                 return;
-            }
             setFocusIndex((i) => {
                 const next = key.name === "up" ? i - 1 : i + 1;
                 if (next < 0)
@@ -301,10 +293,7 @@ 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: () => {
+                        : 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: () => {
                         if (index < fields.length - 1) {
                             setFocusIndex(index + 1);
                         }

package/dist/board/components/SearchSelect.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
+import { useRef, useState, useMemo } from "react";
+import { useKeyboard } from "@opentui/react";
+import { t } from "../../i18n/index.js";
+import { useInputShortcuts } from "../hooks/useInputShortcuts.js";
+import { SEARCH_SELECT_HEIGHT } from "../../config/constants.js";
+export function SearchSelect(props) {
+    const { options, value, onChange, focused, height } = props;
+    const placeholder = props.placeholder ?? t("board.searchSelectPlaceholder");
+    const maxHeight = height ?? SEARCH_SELECT_HEIGHT;
+    const inputRef = useRef(null);
+    const [filter, setFilter] = useState("");
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    useInputShortcuts(() => focused ? inputRef.current : null);
+    const filtered = useMemo(() => {
+        if (!filter)
+            return options;
+        const q = filter.toLowerCase();
+        return options.filter((o) => o.name.toLowerCase().includes(q) || o.value.toLowerCase().includes(q));
+    }, [options, filter]);
+    const currentIdx = filtered.findIndex((o) => o.value === value);
+    const safeSelected = currentIdx >= 0 ? currentIdx : selectedIndex;
+    const clampedSelected = Math.min(safeSelected, Math.max(0, filtered.length - 1));
+    useKeyboard((key) => {
+        if (!focused)
+            return;
+        const name = key.name;
+        if (name === "up" || name === "k") {
+            if (filtered.length > 0) {
+                setSelectedIndex((i) => i <= 0 ? filtered.length - 1 : i - 1);
+            }
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (name === "down" || name === "j") {
+            if (filtered.length > 0) {
+                setSelectedIndex((i) => i >= filtered.length - 1 ? 0 : i + 1);
+            }
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (name === "return" || name === "enter") {
+            const option = filtered[clampedSelected];
+            if (option) {
+                onChange(option.value);
+            }
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (name === "escape") {
+            if (filter) {
+                setFilter("");
+                setSelectedIndex(0);
+            }
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (name === "backspace") {
+            setFilter((f) => f.slice(0, -1));
+            setSelectedIndex(0);
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (key.ctrl)
+            return;
+        if (name && name.length === 1 && /[a-z0-9 _\-./]/i.test(name)) {
+            setFilter((f) => f + name);
+            setSelectedIndex(0);
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+        if (key.sequence && key.sequence.length === 1 && /[a-z0-9 _\-./]/i.test(key.sequence)) {
+            setFilter((f) => f + key.sequence);
+            setSelectedIndex(0);
+            key.preventDefault();
+            key.stopPropagation();
+            return;
+        }
+    });
+    const listHeight = Math.min(filtered.length, maxHeight);
+    return (_jsxs("box", { border: true, borderColor: focused ? "#38bdf8" : undefined, style: { flexDirection: "column", backgroundColor: "#0b0b0b" }, children: [_jsxs("box", { style: { height: 3, flexDirection: "row", alignItems: "center" }, children: [_jsx("text", { fg: "#6b7280", children: "  / " }), _jsx("input", { ref: inputRef, focused: focused, value: filter, placeholder: placeholder, onInput: (v) => {
+                            setFilter(v);
+                            setSelectedIndex(0);
+                        } })] }), _jsx("box", { style: { flexDirection: "column", height: listHeight }, children: filtered.map((option, i) => {
+                    const isSelected = i === clampedSelected;
+                    const isActive = option.value === value;
+                    const prefix = isSelected ? "› " : "  ";
+                    const colorIndicator = option.color ? `\u25cf ` : "";
+                    const bg = isSelected ? "#1e3a8a" : undefined;
+                    const fg = isSelected ? "#ffffff" : isActive ? "#38bdf8" : "#9ca3af";
+                    return (_jsx("box", { style: { flexDirection: "row", backgroundColor: bg }, children: _jsx("text", { fg: fg, children: `${prefix}${colorIndicator}${option.name}` }) }, option.value));
+                }) })] }));
+}

package/dist/board/components/TaskForm.js

@@ -7,6 +7,7 @@ import { createTask, updateTask, listTasks } from "../daemon.js";
 import { useHoverState } from "../hooks/useHoverState.js";
 import { useInputShortcuts } from "../hooks/useInputShortcuts.js";
 import { HOVER_BG } from "../../config/constants.js";
+import { SearchSelect } from "./SearchSelect.js";
 const taskFields = ["name", "command", "onSuccessTaskId", "onFailureTaskId"];
 function taskInitialValues(task) {
     if (!task) {
@@ -57,6 +58,9 @@ export function TaskForm(props) {
             return;
         }
         if (key.name === "up" || key.name === "down") {
+            const field = taskFields[focusIndex];
+            if (field === "onSuccessTaskId" || field === "onFailureTaskId")
+                return;
             setFocusIndex((i) => {
                 const next = key.name === "up" ? i - 1 : i + 1;
                 if (next < 0)
@@ -155,8 +159,7 @@ function TaskFormRow(props) {
     const isFocused = focusIndex === index;
     const isSelect = field === "onSuccessTaskId" || field === "onFailureTaskId";
     const selectOpts = isSelect ? chainOptions : [];
-    const selectedIdx = isSelect ? selectOpts.findIndex((o) => o.value === values[field]) : 0;
-    return (_jsxs("box", { style: { flexDirection: "column", ...style }, children: [_jsx("text", { fg: isFocused ? "#38bdf8" : "#e5e7eb", children: labels[field] }), _jsx("text", { fg: "#6b7280", children: hints[field] }), isSelect ? (_jsx("box", { border: true, borderColor: isFocused ? "#38bdf8" : undefined, style: { height: Math.min(selectOpts.length + 2, 6), backgroundColor: "#0b0b0b" }, children: _jsx("select", { focused: isFocused, options: selectOpts, selectedIndex: Math.max(0, selectedIdx), showDescription: false, style: { flexGrow: 1 }, onChange: (_i, option) => updateValues({ ...valuesRef.current, [field]: option?.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: field === "command" ? t("board.exampleCommand") : "", onInput: (value) => updateValues({ ...valuesRef.current, [field]: value }), onSubmit: () => {
+    return (_jsxs("box", { style: { flexDirection: "column", ...style }, children: [_jsx("text", { fg: isFocused ? "#38bdf8" : "#e5e7eb", children: labels[field] }), _jsx("text", { fg: "#6b7280", children: hints[field] }), isSelect ? (_jsx(SearchSelect, { options: selectOpts, value: values[field], onChange: (v) => updateValues({ ...valuesRef.current, [field]: 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: field === "command" ? t("board.exampleCommand") : "", onInput: (value) => updateValues({ ...valuesRef.current, [field]: value }), onSubmit: () => {
                         if (index < taskFields.length - 1) {
                             setFocusIndex(index + 1);
                         }

package/dist/board/hooks/useTaskKeybindings.js

@@ -1,7 +1,7 @@
 import { useKeyboard } from "@opentui/react";
 import { nextTaskPanel } from "../components/TaskBrowser.js";
 export function useTaskKeybindings(params) {
-    const { confirm, view, tasks, taskSelectedIndex, setTaskSelectedIndex, taskSelectedAction, setTaskSelectedAction, taskFocusedPanel, setTaskFocusedPanel, taskSearchActive, setTaskSearchActive, taskQuery, setTaskQuery, onTaskAction, onCancel, onCreateTask, onEnterHeader, selectable = true, } = params;
+    const { confirm, view, tasks, taskSelectedIndex, setTaskSelectedIndex, taskSelectedAction, setTaskSelectedAction, taskFocusedPanel, setTaskFocusedPanel, taskSearchActive, setTaskSearchActive, taskQuery, setTaskQuery, onTaskAction, onCancel, onCreateTask, onEnterHeader, onToggleContextHelp, selectable = true, } = params;
     const taskActions = selectable
         ? ["select", "edit", "delete"]
         : ["edit", "delete"];
@@ -36,6 +36,11 @@ export function useTaskKeybindings(params) {
             key.preventDefault();
             return;
         }
+        if (name === "?") {
+            onToggleContextHelp();
+            key.preventDefault();
+            return;
+        }
         if (name === "n") {
             onCreateTask();
             key.preventDefault();

package/dist/config/constants.js

@@ -3,6 +3,7 @@ export const TOAST_TIMEOUT_MS = 3500;
 export const TOAST_MAX = 4;
 export const LOG_LINES_MAX = 500;
 export const MAX_LOG_BYTES = 1024 * 1024;
+export const MAX_CONTEXT_STDOUT_BYTES = 1024 * 1024;
 export const MAX_LOG_GENERATIONS = 3;
 export const SLEEP_CHUNK_MS = 200;
 export const DAEMON_SPAWN_TIMEOUT_MS = 5000;
@@ -11,6 +12,7 @@ export const IPC_TIMEOUT_MS = 10000;
 export const LOG_TAIL_DEFAULT = 50;
 export const BOARD_BREAKPOINT_WIDTH = 80;
 export const HEADER_COMPACT_WIDTH = 60;
+export const SEARCH_SELECT_HEIGHT = 6;
 export const HOVER_BG = "#1e3a5f";
 export const PROJECT_COLORS = {
     white: "#ffffff",

package/dist/core/command-runner.js

@@ -2,12 +2,13 @@ import fs from "node:fs";
 import { execa } from "execa";
 import { formatDuration } from "../duration.js";
 import { t } from "../i18n/index.js";
+import { MAX_CONTEXT_STDOUT_BYTES } from "../config/constants.js";
 export function extractExitCode(error) {
     return error && typeof error === "object" && "exitCode" in error
         ? error.exitCode
         : 1;
 }
-export async function executeCommand(command, commandArgs, cwd, logStream, signal, runNumber) {
+export async function executeCommand(command, commandArgs, cwd, logStream, signal, runNumber, captureStdout = false) {
     const startedAt = new Date();
     const header = t("loop.runHeader", { timestamp: startedAt.toLocaleString(), runNumber: runNumber ?? 0 });
     logStream.write(header);
@@ -25,8 +26,25 @@ export async function executeCommand(command, commandArgs, cwd, logStream, signa
         cancelSignal: signal,
         shell: true,
     });
+    const stdoutChunks = [];
+    let stdoutTruncated = false;
+    let stdoutBytes = 0;
     child.stdout.on("data", (chunk) => {
         logStream.write(chunk);
+        if (captureStdout && !stdoutTruncated) {
+            const chunkStr = chunk.toString();
+            const chunkLen = Buffer.byteLength(chunkStr, "utf-8");
+            if (stdoutBytes + chunkLen > MAX_CONTEXT_STDOUT_BYTES) {
+                const remaining = MAX_CONTEXT_STDOUT_BYTES - stdoutBytes;
+                stdoutChunks.push(chunkStr.slice(0, remaining));
+                stdoutTruncated = true;
+                logStream.write(t("context.truncationWarning"));
+            }
+            else {
+                stdoutChunks.push(chunkStr);
+                stdoutBytes += chunkLen;
+            }
+        }
     });
     child.stderr.on("data", (chunk) => {
         logStream.write(chunk);
@@ -36,14 +54,26 @@ export async function executeCommand(command, commandArgs, cwd, logStream, signa
         const endedAt = new Date();
         const duration = endedAt.getTime() - startedAt.getTime();
         logStream.write(t("loop.exitMarker", { code: String(result.exitCode), duration: formatDuration(duration) }));
-        return { exitCode: result.exitCode ?? 0, duration, startedAt, endedAt };
+        return {
+            exitCode: result.exitCode ?? 0,
+            duration,
+            startedAt,
+            endedAt,
+            ...(captureStdout ? { stdout: stdoutChunks.join("") } : {}),
+        };
     }
     catch (error) {
         const endedAt = new Date();
         const duration = endedAt.getTime() - startedAt.getTime();
         const exitCode = extractExitCode(error);
         logStream.write(t("loop.exitMarker", { code: exitCode, duration: formatDuration(duration) }));
-        return { exitCode, duration, startedAt, endedAt };
+        return {
+            exitCode,
+            duration,
+            startedAt,
+            endedAt,
+            ...(captureStdout ? { stdout: stdoutChunks.join("") } : {}),
+        };
     }
 }
 export async function executeCommandForeground(command, commandArgs, logger, cwd = "") {

package/dist/core/context-parser.js

@@ -0,0 +1,55 @@
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function parseStdout(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    let whole;
+    try {
+        whole = JSON.parse(trimmed);
+    }
+    catch {
+        whole = undefined;
+    }
+    if (whole !== undefined) {
+        if (isObject(whole)) {
+            return whole;
+        }
+        if (typeof whole === "string" || typeof whole === "number" || typeof whole === "boolean" || whole === null) {
+            return { output: String(whole) };
+        }
+        if (Array.isArray(whole)) {
+            return { output: trimmed };
+        }
+    }
+    const lines = trimmed.split("\n");
+    const parsedLines = [];
+    let jsonlSuccess = true;
+    for (const line of lines) {
+        const l = line.trim();
+        if (l.length === 0)
+            continue;
+        try {
+            parsedLines.push(JSON.parse(l));
+        }
+        catch {
+            jsonlSuccess = false;
+            break;
+        }
+    }
+    if (jsonlSuccess && parsedLines.length > 0) {
+        const result = {};
+        for (const pl of parsedLines) {
+            if (isObject(pl)) {
+                Object.assign(result, pl);
+            }
+            else {
+                result.output = String(pl);
+            }
+        }
+        return result;
+    }
+    return { output: trimmed };
+}

package/dist/core/loop-controller.js

@@ -7,6 +7,8 @@ import { executeCommand } from "./command-runner.js";
 import { rotateLogIfNeeded } from "./log-rotator.js";
 import { computePhase, alignToPhase } from "./scheduling.js";
 import { t } from "../i18n/index.js";
+import { parseStdout } from "./context-parser.js";
+import { interpolate } from "./template.js";
 export class LoopController extends EventEmitter {
     abortController;
     runAbortController = null;
@@ -323,8 +325,16 @@ export class LoopController extends EventEmitter {
                 const command = task?.command ?? this.options.command;
                 const commandArgs = task?.commandArgs ?? this.options.commandArgs;
                 const cwd = this.options.cwd;
-                const result = await executeCommand(command, commandArgs, cwd, this.logStream, AbortSignal.any([signal, this.runAbortController.signal]), this.runCount);
+                const chainContext = {};
+                const hasChainTasks = !!(task?.onSuccessTaskId || task?.onFailureTaskId);
+                const result = await executeCommand(command, commandArgs, cwd, this.logStream, AbortSignal.any([signal, this.runAbortController.signal]), this.runCount, hasChainTasks);
                 this.runAbortController = null;
+                if (hasChainTasks && result.stdout) {
+                    const parsed = parseStdout(result.stdout);
+                    if (parsed !== null) {
+                        Object.assign(chainContext, parsed);
+                    }
+                }
                 this.lastExitCode = result.exitCode;
                 this.lastDuration = result.duration;
                 const logSize = fs.existsSync(this.logPath) ? fs.statSync(this.logPath).size - this.currentRunStartOffset : 0;
@@ -373,7 +383,15 @@ export class LoopController extends EventEmitter {
                             chainGroupId,
                             chainName: chainTask.name,
                         });
-                        const chainResult = await executeCommand(chainTask.command, chainTask.commandArgs, this.options.cwd, this.logStream, signal, this.runCount);
+                        const interpolatedCommand = interpolate(chainTask.command, chainContext);
+                        const interpolatedArgs = chainTask.commandArgs.map(a => interpolate(a, chainContext));
+                        const chainResult = await executeCommand(interpolatedCommand, interpolatedArgs, this.options.cwd, this.logStream, signal, this.runCount, true);
+                        if (chainResult.stdout) {
+                            const parsed = parseStdout(chainResult.stdout);
+                            if (parsed !== null) {
+                                Object.assign(chainContext, parsed);
+                            }
+                        }
                         const chainLogSize = fs.existsSync(this.logPath) ? fs.statSync(this.logPath).size - chainOffset : 0;
                         const chainRecord = this.runHistory.find((r) => r.chainGroupId === chainGroupId && r.status === "running" && r.chainName === chainTask.name);
                         if (chainRecord) {

package/dist/core/template.js

@@ -0,0 +1,3 @@
+export function interpolate(input, context) {
+    return input.replace(/{{(\w+)}}/g, (_, key) => String(context[key] ?? ""));
+}

package/dist/i18n/en.json

@@ -128,6 +128,7 @@
     "board.idleLabel": "    Stopped: ",
     "board.searchTitle": " Search / ",
     "board.searchPlaceholder": "type to filter, enter to apply",
+    "board.searchSelectPlaceholder": "type to filter...",
     "board.searchEmpty": "press / to search",
     "board.statusFilterTitle": " Status x ",
     "board.sortTitle": " Order o ",
@@ -384,5 +385,11 @@
     "project.error.deleteFailed": "Failed to delete project",
     "project.toastCreated": "Project \"{name}\" created",
     "project.toastUpdated": "Project \"{name}\" updated",
-    "project.toastDeleted": "Project \"{name}\" deleted"
+    "project.toastDeleted": "Project \"{name}\" deleted",
+    "context.truncationWarning": "stdout exceeded 1MB - context was truncated",
+    "context.helpTitle": "Chain Context Sharing",
+    "context.helpRules": "JSON output merges its keys. JSONL merges each line as a separate key. Plain text is stored under the \"output\" key. Empty output produces no change.",
+    "context.helpTemplates": "Use {{key}} in commands and args - replaced with context values from earlier tasks in the chain.",
+    "context.helpCaveat": "Plain text stdout overwrites the \"output\" key. Use JSON with named keys when data must survive across tasks.",
+    "context.helpJqTip": "Tip: use --jq '{key: .field}' to wrap any value in a named JSON key"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loop-task",
-  "version": "1.4.7",
+  "version": "1.5.0",
   "description": "Loop engineering toolkit. Run any command on a cadence, in the background, managed from a terminal board. Schedule tests, builds, syncs, or agent prompts.",
   "type": "module",
   "bin": {