loop-task 1.1.0 → 1.3.0

package/dist/i18n/en.json

@@ -0,0 +1,267 @@
+{
+    "cli.error": "Error: {message}",
+    "cli.programDescription": "Open the loop board or start loops in the background.",
+    "cli.startDescription": "Start the background daemon (restores persisted loops)",
+    "cli.newDescription": "Create a new loop in the background",
+    "cli.runDescription": "Run a loop in the foreground",
+    "cli.argInterval": "Interval between runs (e.g. 30s, 5m, 1h)",
+    "cli.argCommand": "Command to execute",
+    "cli.optNow": "Run immediately before waiting",
+    "cli.optMaxRuns": "Stop after N executions",
+    "cli.optVerbose": "Show execution details",
+    "cli.optCwd": "Working directory for the command",
+    "cli.daemonStarted": "Daemon started. Loops restored.",
+    "cli.startedTitle": "Loop started in background",
+    "cli.startedId": "  ID:       {id}",
+    "cli.startedCommand": "  Command:  {command}",
+    "cli.startedInterval": "  Interval: {interval}",
+    "cli.startedStatus": "  Status:   running",
+    "cli.startedHint": "  loop-task new ...        # create another loop\n  loop-task                # open the board",
+    "cli.noLoops": "No background loops running.",
+    "cli.headerId": "ID",
+    "cli.headerCommand": "COMMAND",
+    "cli.headerInterval": "INTERVAL",
+    "cli.headerStatus": "STATUS",
+    "cli.headerRuns": "RUNS",
+    "cli.headerLastExit": "LAST EXIT",
+    "cli.statusTitle": "Loop: {id}",
+    "cli.statusCommand": "  Command:   {command}",
+    "cli.statusInterval": "  Interval:  {interval} ({duration})",
+    "cli.statusStatus": "  Status:    {status}",
+    "cli.statusRuns": "  Runs:      {runs} / {maxRuns}",
+    "cli.statusCreated": "  Created:   {created}",
+    "cli.statusLastRun": "  Last run:  {lastRun} {exit} {duration}",
+    "cli.statusNextRun": "  Next run:  {nextRun}",
+    "cli.exitInfo": "exit {code}",
+    "cli.unlimited": "∞",
+    "cli.paused": "Loop {id} paused.",
+    "cli.resumed": "Loop {id} resumed.",
+    "cli.deleted": "Loop {id} deleted.",
+    "cli.attaching": "Attaching to loop {id}... (Ctrl+C to detach)\n",
+    "cli.detached": "\nDetached.",
+    "loop.runHeader": "\n[Run #{runNumber} — {timestamp}]\n",
+    "loop.exitMarker": "[exit {code} · {duration}]\n",
+    "loop.cwdMissingLog": "[error] working directory does not exist: {cwd}\n",
+    "loop.cwdMissing": "Working directory does not exist: {cwd}",
+    "loop.executing": "Executing: {command}",
+    "loop.shuttingDown": "\nShutting down gracefully...",
+    "loop.completed": "Completed {runs} run(s). Exiting.",
+    "loop.waitingFirst": "Waiting {duration} before first run...",
+    "loop.runSeparator": "\n--- Run {run}{maxRuns} ---",
+    "loop.commandFailed": "Command failed with exit code {code}",
+    "loop.debugStartedAt": "Started at:  {timestamp}",
+    "loop.debugEndedAt": "Ended at:    {timestamp}",
+    "loop.debugExitCode": "Exit code:   {code}",
+    "loop.debugDuration": "Duration:    {duration}",
+    "loop.nextRun": "Next run in {duration} (at {time})",
+    "errors.durationEmpty": "Duration cannot be empty",
+    "errors.durationInvalid": "Invalid duration: \"{input}\". Use formats like 10s, 5m, 1h, 1d, 1w",
+    "errors.durationNotPositive": "Duration must be positive, got: \"{input}\"",
+    "errors.maxRunsInvalid": "--max-runs must be a positive integer",
+    "errors.unbalancedQuote": "Unbalanced quote in command",
+    "errors.commandEmpty": "Command cannot be empty",
+    "errors.loopNotFound": "Loop {id} not found",
+    "errors.invalidJson": "Invalid JSON",
+    "errors.noLogsYet": "No logs yet",
+    "errors.invalidResponse": "Invalid response from daemon",
+    "errors.connectionClosed": "Connection closed before response",
+    "errors.cannotConnect": "Cannot connect to daemon: {message}",
+    "errors.requestTimedOut": "Daemon request timed out",
+    "errors.daemonFailedToStart": "Daemon failed to start within 5 seconds",
+    "errors.daemonUncaught": "Daemon uncaught exception:",
+    "errors.daemonFailed": "Daemon failed to start:",
+    "errors.pauseFailed": "pause failed",
+    "errors.resumeFailed": "resume failed",
+    "errors.forceRunFailed": "force run failed",
+    "errors.deleteFailed": "delete failed",
+    "format.dash": "-",
+    "format.justNow": "just now",
+    "format.secsAgo": "{secs}s ago",
+    "format.minsAgo": "{mins}m ago",
+    "format.hrsAgo": "{hrs}h ago",
+    "format.daysAgo": "{days}d ago",
+    "format.secsAhead": "{secs}s",
+    "format.minsAhead": "{mins}m",
+    "format.hrsAhead": "{hrs}h",
+    "format.daysAhead": "{days}d",
+    "format.timingPaused": "paused",
+    "format.timingNext": "in {timeAgo}",
+    "format.timingLast": "last {timeAgo}",
+    "format.timingNew": "new",
+    "board.appName": "loop-task",
+    "board.appTagline": "  background task loops",
+    "board.daemonLabel": "Daemon: ",
+    "board.loopsLabel": "    Loops: ",
+    "board.runningLabel": "    Running: ",
+    "board.waitingLabel": "    Waiting: ",
+    "board.pausedLabel": "    Paused: ",
+    "board.searchTitle": " Search / ",
+    "board.searchPlaceholder": "type to filter, enter to apply",
+    "board.searchEmpty": "press / to search",
+    "board.statusFilterTitle": " Status f ",
+    "board.sortTitle": " Sort s ",
+    "board.newLoopTitle": " New ",
+    "board.newLoopLabel": "+ New Loop",
+    "board.headerStatus": "STATUS",
+    "board.headerDescription": "DESCRIPTION",
+    "board.headerTiming": "TIMING",
+    "board.headerExitRuns": "EXIT RUNS",
+    "board.navigatorTitle": " Loops {visible}/{total}  sort:{sort}  status:{status} ",
+    "board.noMatch": "  No loops match the current view",
+    "board.inspectorTitle": " Inspector ",
+    "board.inspectorEmpty": "  Select a loop to view details",
+    "board.fieldId": "ID:       ",
+    "board.fieldDesc": "Desc:     ",
+    "board.fieldCommand": "Command:  ",
+    "board.fieldDir": "Dir:      ",
+    "board.fieldInterval": "Interval: ",
+    "board.fieldStatus": "Status:   ",
+    "board.fieldRuns": "Runs:     ",
+    "board.fieldLastRun": "Last run: ",
+    "board.fieldLastExit": "Last exit:",
+    "board.fieldNextRun": "Next run: ",
+    "board.fieldPid": "PID:      ",
+    "board.inherit": "(inherit)",
+    "board.unlimited": "∞",
+    "board.timelineTitle": " Timeline ",
+    "board.timelineEmpty": "  No output yet.",
+    "board.runHistoryTitle": " Run History ",
+    "board.runHistoryEmpty": "  No runs yet.",
+    "board.runHistoryTime": "TIME",
+    "board.runHistoryDesc": "DESCRIPTION",
+    "board.runHistoryDuration": "DURATION",
+    "board.runHistorySize": "SIZE",
+    "board.logModalTitle": " Run Log {icon} {time} ",
+    "board.logModalLoading": "  Loading...",
+    "board.logModalEmpty": "  No output captured.",
+    "board.logModalEscClose": "esc to close",
+    "board.detailTitle": " Loop Detail ",
+    "board.detailFieldId": "ID:        ",
+    "board.detailFieldDesc": "Desc:      ",
+    "board.detailFieldCommand": "Command:   ",
+    "board.detailFieldDir": "Dir:       ",
+    "board.detailFieldInterval": "Interval:  ",
+    "board.detailFieldStatus": "Status:    ",
+    "board.detailFieldRuns": "Runs:      ",
+    "board.detailFieldCreated": "Created:   ",
+    "board.detailFieldLastRun": "Last run:  ",
+    "board.detailFieldLastExit": "Last exit: ",
+    "board.detailFieldNextRun": "Next run:  ",
+    "board.detailFieldPid": "PID:       ",
+    "board.detailSummaryStatus": "status",
+    "board.detailSummaryTiming": "next",
+    "board.detailSummaryInterval": "every",
+    "board.detailSummaryRuns": "runs",
+    "board.detailSummaryExit": "exit",
+    "board.liveOutputTitle": " Live Output ",
+    "board.helpTitle": " Help ",
+    "board.helpMoveSelection": "move selection",
+    "board.helpToggleDetail": "toggle loop detail",
+    "board.helpCreate": "create loop",
+    "board.helpEdit": "edit loop (pauses it)",
+    "board.helpPauseResume": "pause/resume selected loop",
+    "board.helpForceRun": "force run selected loop now",
+    "board.helpDelete": "delete selected loop",
+    "board.helpSearch": "search loops",
+    "board.helpCycleFilter": "cycle status filter",
+    "board.helpCycleSort": "cycle sort mode",
+    "board.helpRunHistory": "navigate run history",
+    "board.helpOpenRunLog": "open run log",
+    "board.helpSwitchPanel": "switch panel focus",
+    "board.helpKeyLeftRight": "←/→",
+    "board.helpToggleHelp": "toggle help",
+    "board.helpBack": "back to board",
+    "board.helpQuit": "quit",
+    "board.labelInterval": "Interval",
+    "board.labelCommand": "Command",
+    "board.labelDescription": "Description",
+    "board.labelCwd": "Working dir",
+    "board.labelRunNow": "Run immediately?",
+    "board.labelMaxRuns": "Max runs",
+    "board.hintInterval": "How often to run, e.g. 30s, 5m, 30m, 1h, 1d",
+    "board.hintCommand": "Full command line. Quote args with spaces",
+    "board.hintDescription": "Short label shown in the list. Blank uses the command",
+    "board.hintCwd": "Directory the command runs in. Must exist at run time",
+    "board.hintRunNow": "run once now then every interval, or wait the first interval",
+    "board.hintMaxRuns": "Stop after N runs. Leave blank to run forever",
+    "board.exampleInterval": "30m",
+    "board.exampleCommand": "opencode run \"search missing translations and translate them, 3 maximum\" --model \"opencode/big-pickle\"",
+    "board.exampleDescription": "translate missing strings",
+    "board.runNowNo": "No - wait the first interval",
+    "board.runNowYes": "Yes - run now, then every interval",
+    "board.cwdMissing": "Working directory does not exist: {cwd}",
+    "board.createTitle": " New Loop ",
+    "board.editTitle": " Edit Loop (will pause) ",
+    "board.exampleHeading": "Full example of the loop you are building:",
+    "board.exampleFull": "loop-task start 30m --now -- opencode run \"search missing translations and translate them, 3 maximum\" --model \"opencode/big-pickle\"",
+    "board.placeholderExample": "e.g. {example}",
+    "board.placeholderBlank": "(blank)",
+    "board.saving": "Saving...",
+    "board.save": "Save",
+    "board.create": "Create",
+    "board.cancel": "Cancel",
+    "board.formNav": "Tab/Shift+Tab to move | Enter advances or activates | Esc cancels",
+    "board.badgeNormal": "DASHBOARD",
+    "board.badgeSearch": "SEARCH",
+    "board.badgeCreate": "CREATE",
+    "board.badgeHelp": "HELP",
+    "board.badgeDetail": "DETAIL",
+    "board.badgeConfirm": "CONFIRM",
+    "board.confirmTitle": " Confirm ",
+    "board.yes": "Yes",
+    "board.no": "No",
+    "board.actionResume": "Resume",
+    "board.actionPause": "Pause",
+    "board.actionResumed": "Resumed",
+    "board.actionPaused": "Paused",
+    "board.actionRun": "Run",
+    "board.actionEdit": "Edit",
+    "board.actionDelete": "Delete",
+    "board.noActions": "Select a loop to see actions",
+    "board.confirmPauseResume": "{action} loop {id}?",
+    "board.confirmDelete": "Delete loop {id}?",
+    "board.confirmForceRun": "Force run loop {id} now?",
+    "board.toastActionId": "{verb} {id}",
+    "board.toastDeleted": "Deleted {id}",
+    "board.toastTriggered": "Triggered {id}",
+    "board.toastUpdated": "Updated {id} (paused)",
+    "board.toastStarted": "Started {id}",
+    "board.logWaiting": "  Waiting for live output...",
+    "board.logStreamError": "Log stream error: {message}",
+    "board.hintSearch": "search",
+    "board.hintRunHistory": "runs",
+    "board.hintOpenRun": "open log",
+    "board.hintSwitchPanel": "panel",
+    "board.hintHelp": "help",
+    "board.hintQuit": "quit",
+    "board.hintApply": "apply",
+    "board.hintCancel": "cancel",
+    "board.hintNextField": "next field",
+    "board.hintCreate": "create",
+    "board.hintBack": "back",
+    "board.hintChoose": "choose",
+    "board.hintConfirm": "confirm",
+    "board.hintYesNo": "yes/no",
+    "board.helpKeyMove": "up/down, j/k",
+    "board.helpKeyEnter": "enter",
+    "board.helpKeyN": "n",
+    "board.helpKeyE": "e",
+    "board.helpKeyP": "p",
+    "board.helpKeyX": "x",
+    "board.helpKeyD": "d",
+    "board.helpKeySlash": "/",
+    "board.helpKeyF": "f",
+    "board.helpKeyS": "s",
+    "board.helpKeyH": "h",
+    "board.helpKeyEsc": "esc",
+    "board.helpKeyQ": "q",
+    "board.hintKeySlash": "/",
+    "board.hintKeyH": "h",
+    "board.hintKeyQ": "q",
+    "board.hintKeyEnter": "enter",
+    "board.hintKeyEsc": "esc",
+    "board.hintKeyTab": "tab",
+    "board.hintKeyHelpEsc": "h/esc",
+    "board.hintKeyArrows": "←/→",
+    "board.hintKeyYN": "y/n"
+}

package/dist/i18n/index.js

@@ -0,0 +1,11 @@
+import en from "./en.json" with { type: "json" };
+const messages = en;
+export function t(key, params) {
+    let result = messages[key] ?? key;
+    if (params) {
+        for (const name of Object.keys(params)) {
+            result = result.split(`{${name}}`).join(String(params[name]));
+        }
+    }
+    return result;
+}

package/dist/ipc/handlers/logs-stream.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import { send } from "../send.js";
+import { tail } from "../../shared/tail.js";
+const TAIL_WINDOW_BYTES = 64 * 1024;
+function readInitialTail(logPath, tailCount) {
+    const size = fs.statSync(logPath).size;
+    if (tailCount <= 0 || size <= TAIL_WINDOW_BYTES) {
+        return tail(fs.readFileSync(logPath, "utf-8"), tailCount);
+    }
+    const fd = fs.openSync(logPath, "r");
+    const buf = Buffer.alloc(TAIL_WINDOW_BYTES);
+    fs.readSync(fd, buf, 0, TAIL_WINDOW_BYTES, size - TAIL_WINDOW_BYTES);
+    fs.closeSync(fd);
+    const windowLines = buf.toString("utf-8").split("\n");
+    windowLines.shift();
+    if (windowLines.length >= tailCount) {
+        return windowLines.slice(-tailCount);
+    }
+    return tail(fs.readFileSync(logPath, "utf-8"), tailCount);
+}
+export function streamLogFollow(logPath, socket, tailCount) {
+    if (fs.existsSync(logPath)) {
+        for (const line of readInitialTail(logPath, tailCount)) {
+            if (line) {
+                send(socket, { type: "data", line });
+            }
+        }
+    }
+    let fileSize = fs.existsSync(logPath) ? fs.statSync(logPath).size : 0;
+    const watcher = fs.watch(logPath, (eventType) => {
+        if (eventType === "rename" && !fs.existsSync(logPath)) {
+            watcher.close();
+            send(socket, { type: "end" });
+            return;
+        }
+        if (eventType === "change") {
+            try {
+                const stat = fs.statSync(logPath);
+                if (stat.size > fileSize) {
+                    const fd = fs.openSync(logPath, "r");
+                    const buf = Buffer.alloc(stat.size - fileSize);
+                    fs.readSync(fd, buf, 0, buf.length, fileSize);
+                    fs.closeSync(fd);
+                    fileSize = stat.size;
+                    const newContent = buf.toString();
+                    for (const line of newContent.split("\n")) {
+                        if (line) {
+                            send(socket, { type: "data", line });
+                        }
+                    }
+                }
+            }
+            catch {
+                watcher.close();
+                send(socket, { type: "end" });
+            }
+        }
+    });
+    socket.on("close", () => {
+        watcher.close();
+    });
+    socket.on("error", () => {
+        watcher.close();
+    });
+}

package/dist/ipc/send.js

@@ -0,0 +1,5 @@
+export function send(socket, message) {
+    if (!socket.destroyed) {
+        socket.write(JSON.stringify(message) + "\n");
+    }
+}

package/dist/logger.js

@@ -24,4 +24,3 @@ export class Logger {
         return new Date().toISOString();
     }
 }
-//# sourceMappingURL=logger.js.map

package/dist/loop-config.d.ts

@@ -0,0 +1,13 @@
+import type { LoopOptions } from "./types.js";
+export interface LoopCommandOptionsInput {
+    now?: boolean;
+    maxRuns?: number | string | null;
+    verbose?: boolean;
+}
+export interface BuiltLoopOptions {
+    intervalHuman: string;
+    options: LoopOptions;
+}
+export declare function parseMaxRuns(value: number | string | null | undefined): number | null;
+export declare function buildLoopOptions(intervalHuman: string, command: string, commandArgs: string[], input?: LoopCommandOptionsInput): BuiltLoopOptions;
+//# sourceMappingURL=loop-config.d.ts.map

package/dist/loop-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-config.d.ts","sourceRoot":"","sources":["../src/loop-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWrF;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,GAAE,uBAA4B,GAClC,gBAAgB,CAgBlB"}

package/dist/loop-config.js

@@ -0,0 +1,74 @@
+import { parseDuration } from "./duration.js";
+import { t } from "./i18n/index.js";
+export function parseMaxRuns(value) {
+    if (value === null || value === undefined || value === "") {
+        return null;
+    }
+    const parsed = typeof value === "number" ? value : parseInt(value, 10);
+    if (Number.isNaN(parsed) || parsed < 1) {
+        throw new Error(t("errors.maxRunsInvalid"));
+    }
+    return parsed;
+}
+export function parseCommandLine(input) {
+    const tokens = [];
+    let current = "";
+    let quote = null;
+    let hasToken = false;
+    for (let i = 0; i < input.length; i += 1) {
+        const char = input[i];
+        if (quote) {
+            if (char === quote) {
+                quote = null;
+            }
+            else if (char === "\\" && quote === '"' && i + 1 < input.length) {
+                i += 1;
+                current += input[i];
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            hasToken = true;
+            continue;
+        }
+        if (char === " " || char === "\t") {
+            if (hasToken) {
+                tokens.push(current);
+                current = "";
+                hasToken = false;
+            }
+            continue;
+        }
+        current += char;
+        hasToken = true;
+    }
+    if (quote) {
+        throw new Error(t("errors.unbalancedQuote"));
+    }
+    if (hasToken) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+export function buildLoopOptions(intervalHuman, command, commandArgs, input = {}) {
+    if (!command.trim()) {
+        throw new Error(t("errors.commandEmpty"));
+    }
+    return {
+        intervalHuman,
+        options: {
+            interval: parseDuration(intervalHuman),
+            command,
+            commandArgs,
+            immediate: input.now ?? false,
+            maxRuns: parseMaxRuns(input.maxRuns),
+            verbose: input.verbose ?? false,
+            cwd: input.cwd?.trim() ?? "",
+            description: input.description?.trim() ?? "",
+        },
+    };
+}

package/dist/loop-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-config.js","sourceRoot":"","sources":["../src/loop-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAc9C,MAAM,UAAU,YAAY,CAAC,KAAyC;IACpE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,OAAe,EACf,WAAqB,EACrB,QAAiC,EAAE;IAEnC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,aAAa;QACb,OAAO,EAAE;YACP,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC;YACtC,OAAO;YACP,WAAW;YACX,SAAS,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK;YAC7B,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;YACpC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/loop.d.ts

@@ -1,5 +1,46 @@
-import type { LoopOptions, ExecutionResult } from "./types.js";
+import { EventEmitter } from "node:events";
+import type { LoopOptions, ExecutionResult, LoopStatus, LoopMeta } from "./types.js";
 import { Logger } from "./logger.js";
-export declare function executeCommand(command: string, commandArgs: string[], logger: Logger): Promise<ExecutionResult>;
+interface LoopControllerState {
+    status?: LoopStatus;
+    createdAt?: string;
+    runCount?: number;
+    lastRunAt?: string | null;
+    lastExitCode?: number | null;
+    lastDuration?: number | null;
+    nextRunAt?: string | null;
+    remainingDelayMs?: number | null;
+}
+export declare class LoopController extends EventEmitter {
+    private abortController;
+    private _paused;
+    private _status;
+    private resumeResolve;
+    private runCount;
+    private lastRunAt;
+    private lastExitCode;
+    private lastDuration;
+    private nextRunAt;
+    private readonly createdAt;
+    private readonly id;
+    private readonly options;
+    private readonly logPath;
+    private remainingDelayMs;
+    private logStream;
+    private loopPromise;
+    constructor(id: string, options: LoopOptions, logPath: string, state?: LoopControllerState);
+    get status(): LoopStatus;
+    start(): void;
+    private rotateLogIfNeeded;
+    pause(): void;
+    resume(): void;
+    stop(): Promise<void>;
+    getMeta(): Omit<LoopMeta, "command" | "commandArgs" | "interval" | "intervalHuman" | "immediate" | "maxRuns" | "verbose" | "pid">;
+    private waitForResume;
+    private waitForDelay;
+    private run;
+}
+export declare function executeCommandForeground(command: string, commandArgs: string[], logger: Logger): Promise<ExecutionResult>;
 export declare function runLoop(options: LoopOptions, logger: Logger, signal: AbortSignal): Promise<void>;
+export {};
 //# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAa,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAwBrC,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAyFf"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,QAAQ,EAET,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgErC,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAA8B;gBAG/C,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,mBAAmB;IAkB7B,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,iBAAiB;IA8BzB,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAaR,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;YAcnH,aAAa;YAOb,YAAY;YAsCZ,GAAG;CA2ElB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAgC1B;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAyFf"}