loop-task 1.4.5 → 1.5.0

package/README.md

@@ -50,6 +50,8 @@ loop-task                          # open the board (requires Bun)
 loop-task start                    # start the daemon, restore persisted loops
 loop-task new 30m -- npm test      # create a background loop
 loop-task run --now 10s -- echo hi # run a loop in the foreground
+loop-task stop <id>                # stop a frozen loop and kill its child process
+loop-task restart                  # kill daemon + all loops, restart fresh
 ```
 
 Or run it directly:
@@ -137,6 +139,8 @@ Colors can be a name (`white`, `cyan`, `green`, `yellow`, `orange`, `pink`) or a
 | `loop-task new <interval> -- <command>` | Create a background loop (creates an inline task) |
 | `loop-task new <interval> --project <name> -- <command>` | Create a loop assigned to a project |
 | `loop-task run <interval> -- <command>` | Run a loop in the foreground |
+| `loop-task stop <id>` | Stop a loop and interrupt its running child process |
+| `loop-task restart` | Kill the daemon and all running loops, then restart fresh |
 | `loop-task project list` | List all projects |
 | `loop-task project new <name> [--color <color>]` | Create a project |
 | `loop-task project rename <id\|name> <new-name>` | Rename a project |
@@ -248,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";
@@ -26,7 +27,7 @@ import { ProjectsPage } from "./components/ProjectsPage.js";
 import { fetchRunLog, deleteLoop, pauseLoop, resumeLoop, stopLoop, playLoop, triggerLoop, listTasks, deleteTask, listProjects } from "./daemon.js";
 import { useBreakpoint } from "./hooks/useBreakpoint.js";
 import { useRouter } from "./router.js";
-const BOARD_REFRESH_DELAY_MS = 150;
+import { POLL_MS } from "../config/constants.js";
 const VIEW_TO_MODE = {
     create: "create",
     "task-create": "task",
@@ -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);
@@ -117,14 +119,20 @@ export function App(props) {
         }
         catch { /* ignore */ }
     }
-    useState(() => { void refreshTasks(); });
     async function refreshProjects() {
         try {
             setProjects(await listProjects());
         }
         catch { /* ignore */ }
     }
-    useState(() => { void refreshProjects(); });
+    useEffect(() => { void refreshTasks(); void refreshProjects(); }, []);
+    useEffect(() => {
+        const timer = setInterval(() => {
+            void refreshTasks();
+            void refreshProjects();
+        }, POLL_MS);
+        return () => clearInterval(timer);
+    }, []);
     useEffect(() => {
         try {
             localStorage.setItem("loop-current-project", currentProjectId);
@@ -135,7 +143,7 @@ export function App(props) {
         return async () => {
             try {
                 await action();
-                setTimeout(() => { void refresh(); }, BOARD_REFRESH_DELAY_MS);
+                void refresh();
                 pushToast("success", label);
             }
             catch (error) {
@@ -266,7 +274,7 @@ export function App(props) {
         setPendingTaskSelection(null);
         pop();
         pushToast("success", updated ? t("board.toastUpdated", { desc }) : t("board.toastStarted", { desc }));
-        setTimeout(() => { void refresh(); }, BOARD_REFRESH_DELAY_MS);
+        void refresh();
     };
     const onTaskDone = (updated, id) => {
         setEditTask(null);
@@ -309,7 +317,7 @@ export function App(props) {
         onOpenRunLog: handleOpenRunLog,
         refreshTasks,
         onViewTasks: () => { void refreshTasks(); push("task-list"); },
-        onViewProjects: () => push("projects"),
+        onViewProjects: () => { void refreshProjects(); push("projects"); },
         onViewLoops: () => replace("board"),
         onAddLoop: () => { setEditTarget(null); push("create"); },
         onAddTask: () => { setEditTask(null); push("task-create"); },
@@ -335,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 = {
@@ -355,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/Navigator.js

@@ -26,9 +26,9 @@ export function Navigator(props) {
     const bulletW = 2;
     const nonVar = 2 + 1 + statusW + 1 + 1 + 1 + exitW + 1 + 1 + runsW + 1 + skpW;
     const avail = Math.floor(panelWidth) - nonVar - bulletW;
-    const descW = Math.min(22, Math.max(6, Math.round(avail * 0.30)));
-    const sinceW = Math.min(14, Math.max(8, Math.round(avail * 0.35)));
-    const timingW = Math.max(6, avail - descW - sinceW);
+    const descW = Math.min(32, Math.max(10, Math.round(avail * 0.38)));
+    const timingW = Math.min(16, Math.max(6, Math.round(avail * 0.25)));
+    const sinceW = Math.max(8, avail - descW - timingW);
     const header = "  " +
         fit("", bulletW) +
         fit(t("board.headerDescription"), descW) +

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/useInputShortcuts.js

@@ -9,33 +9,52 @@ export function useInputShortcuts(getActiveInput) {
             return;
         const name = key.name;
         if (name === "c") {
-            const text = input.getSelectedText();
-            if (text) {
-                copyToClipboard(text);
+            try {
+                const text = input.getSelectedText();
+                if (text) {
+                    copyToClipboard(text);
+                }
+            }
+            catch (e) {
+                console.error(`[loop-task] copy failed: ${e}`);
             }
             key.preventDefault();
+            key.stopPropagation();
             return;
         }
         if (name === "x") {
-            const text = input.getSelectedText();
-            if (text) {
-                copyToClipboard(text);
-                input.deleteSelection();
+            try {
+                const text = input.getSelectedText();
+                if (text) {
+                    copyToClipboard(text);
+                    input.deleteSelection();
+                }
+            }
+            catch (e) {
+                console.error(`[loop-task] cut failed: ${e}`);
             }
             key.preventDefault();
+            key.stopPropagation();
             return;
         }
         if (name === "v") {
-            const text = readFromClipboard();
-            if (text) {
-                input.insertText(text);
+            try {
+                const text = readFromClipboard();
+                if (text) {
+                    input.insertText(text);
+                }
+            }
+            catch (e) {
+                console.error(`[loop-task] paste failed: ${e}`);
             }
             key.preventDefault();
+            key.stopPropagation();
             return;
         }
         if (name === "a") {
             input.selectAll();
             key.preventDefault();
+            key.stopPropagation();
             return;
         }
     });

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/board/toast.js

@@ -46,7 +46,7 @@ export function ToastStack(props) {
     }
     return (_jsx("box", { style: {
             position: "absolute",
-            bottom: 1,
+            bottom: 3,
             right: 2,
             flexDirection: "column",
             alignItems: "flex-end",

package/dist/cli.js

@@ -4,6 +4,7 @@ import { createRequire } from "node:module";
 import { Logger } from "./logger.js";
 import { runLoop } from "./core/foreground-loop.js";
 import { buildLoopOptions } from "./loop-config.js";
+import { parseDuration } from "./duration.js";
 import { startLoop } from "./client/commands.js";
 import { listProjectsCli, createProjectCli, renameProjectCli, setProjectColorCli, deleteProjectCli, resolveProjectId, } from "./client/commands.js";
 import { t } from "./i18n/index.js";
@@ -22,6 +23,49 @@ program
     ensureDaemon();
     console.log(t("cli.daemonStarted"));
 });
+program
+    .command("stop")
+    .description("Stop a running loop and interrupt its current execution")
+    .argument("<id>", "Loop ID")
+    .action(async (id) => {
+    try {
+        const { sendRequest } = await import("./client/ipc.js");
+        const res = await sendRequest({ type: "stop-loop", payload: { id } });
+        if (res.type === "ok" && res.data) {
+            console.log(`Stopped loop ${id}`);
+        }
+        else if (res.type === "error") {
+            console.error(res.message);
+            process.exit(1);
+        }
+        else {
+            console.error(`Loop ${id} not found`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(t("cli.error", { message }));
+        process.exit(1);
+    }
+});
+program
+    .command("restart")
+    .description("Kill the daemon and all running loops, then restart fresh")
+    .action(async () => {
+    const { stopDaemon, ensureDaemon } = await import("./daemon/spawner.js");
+    const { readDaemonPid, removeDaemonPid, removeDaemonSignature } = await import("./daemon/state.js");
+    const pid = readDaemonPid();
+    if (pid !== null) {
+        console.log("Stopping daemon...");
+        stopDaemon(pid);
+        removeDaemonPid();
+        removeDaemonSignature();
+    }
+    console.log("Starting fresh daemon...");
+    ensureDaemon();
+    console.log("Daemon restarted.");
+});
 program
     .command("new")
     .description(t("cli.newDescription"))
@@ -32,17 +76,20 @@ program
     .option("--verbose", t("cli.optVerbose"), false)
     .option("--cwd <dir>", t("cli.optCwd"))
     .option("--project <name>", t("cli.optProject"))
+    .option("--offset <duration>", "Phase offset (e.g. 5m, 15m)")
     .action(async (intervalStr, cmdArgs, opts) => {
     try {
         const projectId = opts.project
             ? await resolveProjectId(opts.project)
             : undefined;
+        const offsetMs = opts.offset ? parseDuration(opts.offset) : null;
         const built = buildLoopOptions(intervalStr, {
             ...opts,
             command: cmdArgs[0],
             commandArgs: cmdArgs.slice(1),
             cwd: opts.cwd ?? process.cwd(),
             projectId,
+            offset: offsetMs,
         });
         await startLoop(built.options, built.intervalHuman);
     }

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

@@ -5,7 +5,10 @@ import { sleep } from "../shared/sleep.js";
 import { SLEEP_CHUNK_MS } from "../config/constants.js";
 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;
@@ -116,7 +119,11 @@ export class LoopController extends EventEmitter {
         this._resetSchedule = true;
         this._paused = false;
         this._status = "waiting";
-        this.nextRunAt = new Date(Date.now() + this.options.interval).toISOString();
+        const phase = this.options.offset !== null
+            ? this.options.offset
+            : computePhase(this.id, this.options.interval);
+        const delay = alignToPhase(Date.now(), this.options.interval, phase);
+        this.nextRunAt = new Date(Date.now() + delay).toISOString();
         if (this.resumeResolve) {
             this.resumeResolve();
             this.resumeResolve = null;
@@ -274,7 +281,14 @@ export class LoopController extends EventEmitter {
                     }
                 }
                 else if (isFirstRun && !this.options.immediate) {
-                    const completed = await this.waitForDelay(this.options.interval, signal);
+                    const phase = this.options.offset !== null
+                        ? this.options.offset
+                        : computePhase(this.id, this.options.interval);
+                    const delay = alignToPhase(Date.now(), this.options.interval, phase);
+                    if (delay > 0) {
+                        this.nextRunAt = new Date(Date.now() + delay).toISOString();
+                    }
+                    const completed = await this.waitForDelay(delay, signal);
                     if (!completed) {
                         break;
                     }
@@ -311,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;
@@ -361,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/scheduling.js

@@ -0,0 +1,12 @@
+export function computePhase(loopId, intervalMs) {
+    let hash = 0;
+    for (let i = 0; i < loopId.length; i++) {
+        hash = ((hash << 5) - hash + loopId.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash) % intervalMs;
+}
+export function alignToPhase(now, intervalMs, phaseMs) {
+    const elapsed = now % intervalMs;
+    const delay = (phaseMs - elapsed + intervalMs) % intervalMs;
+    return delay;
+}

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/daemon/manager.js

@@ -44,6 +44,7 @@ export class LoopManager {
                 verbose: meta.verbose,
                 description: meta.description ?? "",
                 projectId: meta.projectId ?? "default",
+                offset: meta.offset ?? null,
             };
             const logPath = getLogPath(meta.id);
             const controller = new LoopController(meta.id, options, logPath, this.taskResolver, {
@@ -161,10 +162,19 @@ export class LoopManager {
         const entry = this.loops.get(id);
         if (!entry)
             return false;
-        entry.controller.stopLoop();
+        entry.controller.stopLoop(true);
         this.persist(id, entry.controller, entry.options, entry.intervalHuman);
         return true;
     }
+    stopAllLoops() {
+        let count = 0;
+        for (const [id, entry] of this.loops) {
+            entry.controller.stopLoop(true);
+            this.persist(id, entry.controller, entry.options, entry.intervalHuman);
+            count++;
+        }
+        return count;
+    }
     playLoop(id) {
         const entry = this.loops.get(id);
         if (!entry)
@@ -255,6 +265,7 @@ export class LoopManager {
             remainingDelayMs: runtime.remainingDelayMs,
             pid: process.pid,
             projectId: options.projectId ?? "default",
+            offset: options.offset,
         };
     }
 }

package/dist/daemon/server.js

@@ -112,6 +112,11 @@ export class IpcServer {
                 this.respondOk(socket, this.manager.stopLoop(request.payload.id), request.payload.id);
                 break;
             }
+            case "stop-all": {
+                const count = this.manager.stopAllLoops();
+                send(socket, { type: "ok", data: count });
+                break;
+            }
             case "play-loop": {
                 if (this.manager.isMaxRunsBlocked(request.payload.id)) {
                     send(socket, { type: "error", message: t("errors.maxRunsReached") });

package/dist/daemon/spawner.js

@@ -16,7 +16,7 @@ function currentCodeSignature() {
 function blockingWait(ms) {
     Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
-function stopDaemon(pid) {
+export function stopDaemon(pid) {
     try {
         process.kill(pid, "SIGTERM");
     }

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/dist/loop-config.js

@@ -78,6 +78,7 @@ export function buildLoopOptions(intervalHuman, input = {}) {
             verbose: input.verbose ?? false,
             description,
             projectId: input.projectId ?? "default",
+            offset: input.offset ?? null,
         },
     };
 }

package/package.json

@@ -1,75 +1,74 @@
-{
-  "name": "loop-task",
-  "version": "1.4.5",
-  "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": {
-    "loop-task": "dist/entry.js"
-  },
-  "main": "dist/entry.js",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json && node -e \"require('fs').copyFileSync('src/entry.js','dist/entry.js'); require('fs').copyFileSync('src/esm-loader.js','dist/esm-loader.js')\"",
-    "prepublishOnly": "npm run build",
-    "start": "node dist/entry.js",
-    "dev": "bun src/cli.ts",
-    "dev:watch": "bun --watch src/cli.ts",
-    "board": "node dist/entry.js",
-    "test": "vitest run --exclude '**/background-cli.test.ts'",
-    "test:all": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage --exclude '**/background-cli.test.ts'",
-    "lint": "eslint src/ tests/",
-    "typecheck": "tsc --noEmit",
-    "release:dry": "npm publish --dry-run",
-    "release": "npm publish"
-  },
-  "keywords": [
-    "cli",
-    "loop",
-    "loop-engineering",
-    "repeat",
-    "interval",
-    "schedule",
-    "timer",
-    "cron",
-    "automation",
-    "automations",
-    "devops",
-    "agent",
-    "ai-agent",
-    "coding-agent",
-    "agent-automation",
-    "claude-code",
-    "codex",
-    "opencode",
-    "background-tasks",
-    "scheduler"
-  ],
-  "author": "Quique Fdez Guerra",
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "dependencies": {
-    "@opentui/core": "^0.4.1",
-    "@opentui/react": "^0.4.1",
-    "commander": "^13.1.0",
-    "execa": "^9.6.0",
-    "ms": "^2.1.3",
-    "react": "^19.2.7"
-  },
-  "devDependencies": {
-    "@types/ms": "^2.1.0",
-    "@types/node": "^22.15.0",
-    "@types/react": "^19.2.17",
-    "@vitest/coverage-v8": "^3.1.0",
-    "eslint": "^9.25.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.8.0",
-    "typescript-eslint": "^8.30.0",
-    "vitest": "^3.1.0"
-  }
+{
+  "name": "loop-task",
+  "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": {
+    "loop-task": "dist/entry.js"
+  },
+  "main": "dist/entry.js",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cli",
+    "loop",
+    "loop-engineering",
+    "repeat",
+    "interval",
+    "schedule",
+    "timer",
+    "cron",
+    "automation",
+    "automations",
+    "devops",
+    "agent",
+    "ai-agent",
+    "coding-agent",
+    "agent-automation",
+    "claude-code",
+    "codex",
+    "opencode",
+    "background-tasks",
+    "scheduler"
+  ],
+  "author": "Quique Fdez Guerra",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@opentui/core": "^0.4.1",
+    "@opentui/react": "^0.4.1",
+    "commander": "^13.1.0",
+    "execa": "^9.6.0",
+    "ms": "^2.1.3",
+    "react": "^19.2.7"
+  },
+  "devDependencies": {
+    "@types/ms": "^2.1.0",
+    "@types/node": "^22.15.0",
+    "@types/react": "^19.2.17",
+    "@vitest/coverage-v8": "^3.1.0",
+    "eslint": "^9.25.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.30.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node -e \"require('fs').copyFileSync('src/entry.js','dist/entry.js'); require('fs').copyFileSync('src/esm-loader.js','dist/esm-loader.js')\"",
+    "start": "node dist/entry.js",
+    "dev": "bun src/cli.ts",
+    "dev:watch": "bun --watch src/cli.ts",
+    "board": "node dist/entry.js",
+    "test": "vitest run --exclude '**/background-cli.test.ts'",
+    "test:all": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --exclude '**/background-cli.test.ts'",
+    "lint": "eslint src/ tests/",
+    "typecheck": "tsc --noEmit",
+    "release:dry": "npm publish --dry-run",
+    "release": "npm publish"
+  }
 }