@intrect/openswarm 0.9.3 → 0.10.1

package/dist/cli/reviewMaxCommand.js

@@ -0,0 +1,278 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// ============================================
+// OpenSwarm - `openswarm review --max` entry (INT-2006)
+// ============================================
+//
+// CLI shell for the full-codebase, multi-agent audit: collect source → partition
+// into areas → cost gate → mount the live ink board → fan reviewer subagents out
+// (runMaxReview) → print the aggregate verdict → optionally file per-area Linear
+// follow-ups. The orchestration/aggregation lives in reviewAudit.ts (unit-tested
+// and ink-free); this file is the effectful boundary.
+import { render } from 'ink';
+import { EventEmitter } from 'node:events';
+import { createInterface } from 'node:readline';
+import { execFileSync } from 'node:child_process';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname, basename } from 'node:path';
+import { listSourceFiles, partitionIntoAreas, runMaxReview, formatAuditSummary, formatAuditReport, mergeFallback, } from './reviewAudit.js';
+import { AuditBoard } from '../tui/components/AuditBoard.js';
+import { resolveIssueFromBranch, ensureTaskSource, resolveProjectId } from './reviewCommand.js';
+import { synthesizeAuditIssues } from './auditPM.js';
+/**
+ * Pick the adapter to retry usage-limited areas on. Explicit --fallback wins;
+ * otherwise a codex primary auto-falls back to claude (Claude subscription). (INT-2192)
+ */
+function resolveFallbackAdapter(opts) {
+    if (opts.noFallback)
+        return undefined;
+    if (opts.fallbackAdapter)
+        return opts.fallbackAdapter;
+    const primary = opts.adapter ?? 'codex-responses';
+    return primary === 'codex' || primary === 'codex-responses' ? 'claude' : undefined;
+}
+/** Interactive cost gate. Non-TTY always proceeds (scripted runs). */
+async function confirmCost(areas, files, concurrency) {
+    if (!process.stdin.isTTY)
+        return true;
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    const answer = await new Promise((res) => rl.question(`Audit ${files} file(s) across ${areas} area(s) with ${concurrency} concurrent reviewer subagents ` +
+        `(~${areas} agent runs). Continue? [y/N] `, res));
+    rl.close();
+    return /^y(es)?$/i.test(answer.trim());
+}
+/** File each area's recommendedActions as Linear follow-ups, one call per area (avoids the 10-action cap). */
+async function filePerAreaFollowups(cwd, fileIssue, run) {
+    const withActions = run.results.filter((r) => r.review?.recommendedActions?.length);
+    if (!withActions.length) {
+        console.log('No follow-ups to file.');
+        return;
+    }
+    const source = await ensureTaskSource();
+    if (!source) {
+        console.log('Could not file follow-ups: Linear not connected. Run `openswarm auth login --provider linear` (or set linearApiKey).');
+        return;
+    }
+    let parent = typeof fileIssue === 'string' ? fileIssue : undefined;
+    if (!parent) {
+        const branch = (() => {
+            try {
+                return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, stdio: ['ignore', 'pipe', 'ignore'] })
+                    .toString()
+                    .trim();
+            }
+            catch {
+                return '';
+            }
+        })();
+        parent = resolveIssueFromBranch(branch);
+        if (parent)
+            console.log(`Filing follow-ups under ${parent} (inferred from branch "${branch}").`);
+    }
+    const projectId = parent ? undefined : await resolveProjectId(cwd);
+    const { fileReviewerFollowups } = await import('../automation/runnerExecution.js');
+    let filed = 0;
+    for (const r of withActions) {
+        filed += await fileReviewerFollowups(source, parent, r.review, { autoFile: true, projectId, requireApprove: false });
+    }
+    console.log(filed > 0
+        ? parent
+            ? `Filed ${filed} follow-up sub-issue(s) under ${parent}.`
+            : `Filed ${filed} standalone follow-up issue(s) (pass \`--issues <id>\` to nest them).`
+        : 'Could not file follow-ups (0 created).');
+}
+/**
+ * Run the full-codebase multi-agent audit. Returns the aggregate verdict (or
+ * null when there's nothing to audit / the user declined). exit code is set to 1
+ * by the caller on a reject verdict.
+ */
+export async function runReviewMaxCommand(opts = {}) {
+    const cwd = opts.path ?? process.cwd();
+    const concurrency = Math.max(1, opts.concurrency ?? 4);
+    let files;
+    try {
+        files = listSourceFiles(cwd);
+    }
+    catch {
+        console.error(`Not a git repository (or git unavailable): ${cwd}`);
+        return null;
+    }
+    if (!files.length) {
+        console.log('No production source files to audit.');
+        return null;
+    }
+    const areas = partitionIntoAreas(files, opts.maxFilesPerArea ?? 12);
+    if (opts.dryRun) {
+        console.log(`Audit plan — ${files.length} file(s) across ${areas.length} area(s):`);
+        areas.forEach((a) => console.log(`  · ${a.label}  (${a.files.length} file(s))`));
+        return null;
+    }
+    if (!opts.yes && !(await confirmCost(areas.length, files.length, concurrency))) {
+        console.log('Aborted.');
+        return null;
+    }
+    // Live board → stderr so the final report on stdout stays pipe-clean.
+    const events = new EventEmitter();
+    events.setMaxListeners(0);
+    const board = render(_jsx(AuditBoard, { areas: areas, concurrency: concurrency, events: events }), {
+        stdout: process.stderr,
+    });
+    let run;
+    try {
+        run = await runMaxReview(areas, cwd, { concurrency, adapter: opts.adapter }, { onProgress: (e) => events.emit('progress', e) });
+    }
+    finally {
+        board.unmount();
+    }
+    // Auto-fallback: a codex usage-limit aborted the run early → retry the failed/
+    // skipped areas on the fallback adapter (default claude → Claude subscription). (INT-2192)
+    if (run.rateLimit) {
+        const fallback = resolveFallbackAdapter(opts);
+        if (fallback) {
+            const pending = areas.filter((_, i) => run.results[i]?.error);
+            console.warn(`\n⚠ Codex usage limit hit — falling back to "${fallback}" for ${pending.length} remaining area(s)...`);
+            const fbRun = await runMaxReview(pending, cwd, { concurrency, adapter: fallback }, {
+                onProgress: (e) => {
+                    if (e.type === 'done')
+                        console.error(`  [${fallback}] ${e.label}: ${e.decision}`);
+                    else if (e.type === 'error')
+                        console.error(`  [${fallback}] ${e.label}: failed`);
+                },
+            });
+            run = mergeFallback(run, fbRun);
+        }
+    }
+    console.log(formatAuditSummary(run.summary));
+    // If a usage-limit is still unresolved (fallback also exhausted, or no fallback),
+    // surface the reset time. (INT-2192)
+    if (run.rateLimit) {
+        const skipped = run.summary.areas.filter((a) => a.decision === 'error').length;
+        const when = run.rateLimit.resetsAt ? new Date(run.rateLimit.resetsAt * 1000).toLocaleString() : 'an unknown time';
+        console.warn(`\n⚠ Usage limit unresolved — ${skipped} area(s) still incomplete. ${run.rateLimit.message}`);
+        console.warn(`  Retry after ${when}${resolveFallbackAdapter(opts) ? ' (fallback adapter also exhausted)' : ', or set `--fallback <adapter>`'}.`);
+    }
+    // (3) Persist a markdown report so the result isn't lost to the scrollback. (INT-2022)
+    const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const report = formatAuditReport(run.summary, basename(cwd) || cwd, ts);
+    const outPath = opts.out ?? join(cwd, '.openswarm', 'audit', `audit-${ts}.md`);
+    try {
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, report, 'utf8');
+        console.log(`\nReport saved: ${outPath}`);
+    }
+    catch (e) {
+        console.warn(`Could not save report: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // (4) Linear: PM synthesis is the DEFAULT — a master parent + ≤10 cohesive
+    //     sub-issues. `--issues <id>` overrides the parent with an existing issue;
+    //     `--issues-per-area` keeps the legacy per-area fan-out; `--no-linear`
+    //     skips Linear entirely (report only). (INT-2022 / INT-2225)
+    if (opts.issuesPerArea) {
+        await filePerAreaFollowups(cwd, opts.issuesPerArea, run);
+    }
+    else if (!opts.noLinear && run.summary.recommendedActions.length) {
+        await filePmSynthesizedIssues(cwd, opts, run.summary, report, ts);
+    }
+    else if (run.summary.recommendedActions.length) {
+        console.log(`\n${run.summary.recommendedActions.length} follow-up(s) — captured in the report (--no-linear).`);
+    }
+    return { decision: run.summary.decision };
+}
+/**
+ * Create one master audit issue holding the full report (default Linear
+ * behavior). Returns the created issue's internal id (usable as a sub-issue
+ * parent) or null on failure. (INT-2022 / INT-2225)
+ */
+async function createMasterAuditIssue(cwd, summary, report, ts) {
+    const source = await ensureTaskSource();
+    if (!source) {
+        console.log('Linear not connected — report saved to file only. `openswarm auth login --provider linear` to enable.');
+        return null;
+    }
+    const projectId = await resolveProjectId(cwd);
+    const title = `chore(audit): codebase audit ${ts.slice(0, 10)} — review --max (${summary.recommendedActions.length} follow-ups)`;
+    try {
+        const res = await source.createTask(title, report, projectId);
+        if ('identifier' in res) {
+            console.log(`Linear master audit issue: ${res.identifier}`);
+            return res.id;
+        }
+        console.warn(`Could not create Linear issue (report saved to file): ${res.error}`);
+        return null;
+    }
+    catch (e) {
+        console.warn(`Could not create Linear issue (report saved to file): ${e instanceof Error ? e.message : String(e)}`);
+        return null;
+    }
+}
+/**
+ * PM layer for `--issues`: synthesize the deduped follow-ups into ≤10 cohesive
+ * issues and file them as sub-issues. The parent is the explicit `--issues <id>`
+ * when given, otherwise a freshly created master audit issue (which also holds
+ * the full report). Falls back gracefully — if synthesis yields nothing (too few
+ * follow-ups, or the LLM output couldn't be parsed), the master issue alone still
+ * captures everything. (INT-2225)
+ */
+async function filePmSynthesizedIssues(cwd, opts, summary, report, ts) {
+    const actions = summary.recommendedActions;
+    if (!actions.length) {
+        console.log('No follow-ups to file.');
+        return;
+    }
+    const source = await ensureTaskSource();
+    if (!source) {
+        console.log('Could not file follow-ups: Linear not connected. Run `openswarm auth login --provider linear` (or set linearApiKey).');
+        return;
+    }
+    const projectId = await resolveProjectId(cwd);
+    if (!projectId) {
+        // No <repo>/openswarm.json mapping → issues get filed without a project (and
+        // on a multi-team config, only the first team). Tell the user how to map it. (INT-2239)
+        console.warn('⚠ No Linear project mapped for this repo (openswarm.json `linear.projectId` missing) — ' +
+            'issues will not be linked to a project. Run `openswarm add` here to map it.');
+    }
+    // Resolve the parent: explicit --issues <id>, else create the master report issue.
+    let parentId = typeof opts.fileIssue === 'string' && opts.fileIssue ? opts.fileIssue : undefined;
+    if (!parentId && !opts.noLinear) {
+        parentId = (await createMasterAuditIssue(cwd, summary, report, ts)) ?? undefined;
+    }
+    console.log(`Synthesizing ${actions.length} follow-up(s) into cohesive issues (PM pass)...`);
+    const issues = await synthesizeAuditIssues(actions, {
+        adapter: opts.adapter,
+        cwd,
+        repoName: basename(cwd) || cwd,
+        onLog: (l) => console.error(`  · ${l}`),
+    });
+    if (!issues.length) {
+        console.log(parentId
+            ? 'PM synthesis produced no grouped issues — the master audit issue captures all follow-ups.'
+            : 'PM synthesis produced no grouped issues — follow-ups are captured in the saved report.');
+        return;
+    }
+    let filed = 0;
+    for (const issue of issues) {
+        try {
+            const res = parentId
+                ? await source.createSubIssue(parentId, issue.title, issue.description, {
+                    priority: issue.priority,
+                    projectId,
+                })
+                : await source.createTask(issue.title, issue.description, projectId);
+            if ('identifier' in res) {
+                filed++;
+                console.log(`  ✓ ${res.identifier}  ${issue.title}  (${issue.items.length} follow-up(s))`);
+            }
+            else {
+                console.warn(`  ✗ Could not create issue "${issue.title}": ${res.error}`);
+            }
+        }
+        catch (e) {
+            console.warn(`  ✗ Could not create issue "${issue.title}": ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    console.log(filed > 0
+        ? parentId
+            ? `Filed ${filed} synthesized sub-issue(s) under the master audit issue.`
+            : `Filed ${filed} synthesized issue(s).`
+        : 'Could not file synthesized issues (0 created).');
+}
+//# sourceMappingURL=reviewMaxCommand.js.map

package/dist/cli/reviewMaxCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewMaxCommand.js","sourceRoot":"","sources":["../../src/cli/reviewMaxCommand.tsx"],"names":[],"mappings":"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"}

package/dist/cli/reviewProgress.d.ts

@@ -0,0 +1,34 @@
+/** Braille spinner frame for a tick. Pure. */
+export declare function spinnerFrame(tick: number): string;
+/** Collapse newlines/whitespace runs to single spaces so a note stays one line. Pure. */
+export declare function oneLine(s: string): string;
+/** Display width of a string in terminal columns (wide chars count as 2). Pure. */
+export declare function displayWidth(s: string): number;
+/**
+ * Truncate to a terminal COLUMN budget (not code-unit length) with an ellipsis,
+ * so a line of wide chars never exceeds the width and wraps. (INT-1966)
+ */
+export declare function truncateLine(s: string, width: number): string;
+/** One progress line: `⠙ reviewing… 3s · 🔧 read_file`. Pure. */
+export declare function formatProgress(tick: number, elapsedSec: number, last?: string, width?: number): string;
+export interface ReviewProgressDeps {
+    write?: (s: string) => void;
+    now?: () => number;
+    setIntervalFn?: (fn: () => void, ms: number) => ReturnType<typeof setInterval>;
+    clearIntervalFn?: (h: ReturnType<typeof setInterval>) => void;
+    intervalMs?: number;
+    /** Terminal width to truncate the line to (default stdout.columns ?? 80). */
+    columns?: number;
+}
+export interface ReviewProgress {
+    /** Update the trailing activity note (e.g. the latest tool line). */
+    note: (line: string) => void;
+    /** Stop the spinner and clear the line. */
+    stop: () => void;
+}
+/**
+ * Start a spinner heartbeat that re-renders every intervalMs until stop().
+ * Returns handles to update the activity note and to stop. (INT-1963)
+ */
+export declare function startReviewProgress(deps?: ReviewProgressDeps): ReviewProgress;
+//# sourceMappingURL=reviewProgress.d.ts.map

package/dist/cli/reviewProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewProgress.d.ts","sourceRoot":"","sources":["../../src/cli/reviewProgress.ts"],"names":[],"mappings":"AAUA,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AA2BD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAItG;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAC/E,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,kBAAuB,GAAG,cAAc,CAkCjF"}

package/dist/cli/reviewProgress.js

@@ -0,0 +1,109 @@
+// ============================================
+// OpenSwarm - review progress indicator (INT-1963)
+// ============================================
+//
+// A live "still working" heartbeat for `openswarm review`, so a multi-second
+// reviewer run doesn't look frozen. The formatter is pure (unit-tested); the
+// runtime owns a timer + stderr writes (injectable for tests).
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/** Braille spinner frame for a tick. Pure. */
+export function spinnerFrame(tick) {
+    return FRAMES[((tick % FRAMES.length) + FRAMES.length) % FRAMES.length];
+}
+/** Collapse newlines/whitespace runs to single spaces so a note stays one line. Pure. */
+export function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Terminal display width of a code point: East-Asian wide / fullwidth characters
+ * (Hangul, CJK, kana, fullwidth forms) and most emoji occupy 2 columns. (INT-1966)
+ */
+function charWidth(cp) {
+    if ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        (cp >= 0x2e80 && cp <= 0x303e) || // CJK radicals, Kangxi, symbols
+        (cp >= 0x3041 && cp <= 0x33ff) || // Hiragana, Katakana, CJK symbols
+        (cp >= 0x3400 && cp <= 0x4dbf) || // CJK Ext A
+        (cp >= 0x4e00 && cp <= 0x9fff) || // CJK Unified
+        (cp >= 0xa000 && cp <= 0xa4cf) || // Yi
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul Syllables
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK Compatibility
+        (cp >= 0xfe30 && cp <= 0xfe4f) || // CJK Compatibility Forms
+        (cp >= 0xff00 && cp <= 0xff60) || // Fullwidth Forms
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1faff) || // emoji & symbols
+        (cp >= 0x20000 && cp <= 0x3fffd) // CJK Ext B+
+    ) {
+        return 2;
+    }
+    return 1;
+}
+/** Display width of a string in terminal columns (wide chars count as 2). Pure. */
+export function displayWidth(s) {
+    let w = 0;
+    for (const ch of s)
+        w += charWidth(ch.codePointAt(0) ?? 0);
+    return w;
+}
+/**
+ * Truncate to a terminal COLUMN budget (not code-unit length) with an ellipsis,
+ * so a line of wide chars never exceeds the width and wraps. (INT-1966)
+ */
+export function truncateLine(s, width) {
+    if (width <= 0)
+        return '';
+    if (displayWidth(s) <= width)
+        return s;
+    let out = '';
+    let w = 0;
+    for (const ch of s) {
+        const cw = charWidth(ch.codePointAt(0) ?? 0);
+        if (w + cw > width - 1)
+            break; // reserve one column for the ellipsis
+        out += ch;
+        w += cw;
+    }
+    return `${out}…`;
+}
+/** One progress line: `⠙ reviewing… 3s · 🔧 read_file`. Pure. */
+export function formatProgress(tick, elapsedSec, last, width) {
+    const base = `${spinnerFrame(tick)} reviewing… ${elapsedSec}s`;
+    const line = last ? `${base} · ${last}` : base;
+    return width ? truncateLine(line, width) : line;
+}
+const CLEAR_LINE = '\r\x1b[2K';
+/**
+ * Start a spinner heartbeat that re-renders every intervalMs until stop().
+ * Returns handles to update the activity note and to stop. (INT-1963)
+ */
+export function startReviewProgress(deps = {}) {
+    const write = deps.write ?? ((s) => process.stderr.write(s));
+    const now = deps.now ?? (() => Date.now());
+    const setIntervalFn = deps.setIntervalFn ?? setInterval;
+    const clearIntervalFn = deps.clearIntervalFn ?? clearInterval;
+    const intervalMs = deps.intervalMs ?? 200;
+    const columns = deps.columns ?? process.stdout.columns ?? 80;
+    // Reserve the last column: writing into it auto-wraps on most terminals, which
+    // re-introduces the multi-row stacking we're trying to avoid. (INT-1966)
+    const maxCols = Math.max(10, columns - 1);
+    const start = now();
+    let tick = 0;
+    let last;
+    const render = () => {
+        const elapsedSec = Math.max(0, Math.floor((now() - start) / 1000));
+        // Single line, truncated to display width — a wide-char note must never wrap/stack. (INT-1966)
+        write(`${CLEAR_LINE}${formatProgress(tick, elapsedSec, last, maxCols)}`);
+        tick += 1;
+    };
+    render(); // immediate first frame
+    const handle = setIntervalFn(render, intervalMs);
+    return {
+        note: (line) => {
+            last = oneLine(line) || last;
+        },
+        stop: () => {
+            clearIntervalFn(handle);
+            write(CLEAR_LINE);
+        },
+    };
+}
+//# sourceMappingURL=reviewProgress.js.map

package/dist/cli/reviewProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewProgress.js","sourceRoot":"","sources":["../../src/cli/reviewProgress.ts"],"names":[],"mappings":"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"}

package/dist/cli/scheduleCommand.d.ts

@@ -0,0 +1,15 @@
+import type { ScheduledJob } from '../automation/scheduler.js';
+/** Render the schedule list for the terminal. */
+export declare function formatScheduleList(jobs: ScheduledJob[]): string;
+export interface ScheduleDeps {
+    add: (name: string, projectPath: string, prompt: string, schedule: string) => Promise<ScheduledJob>;
+    list: () => Promise<ScheduledJob[]>;
+    remove: (nameOrId: string) => Promise<boolean>;
+    toggle: (nameOrId: string) => Promise<ScheduledJob | null>;
+}
+export interface ScheduleCommandOptions {
+    path?: string;
+}
+/** Route a `schedule` subcommand. Returns the message to print. */
+export declare function runScheduleCommand(action: string, args: string[], opts?: ScheduleCommandOptions, deps?: ScheduleDeps): Promise<string>;
+//# sourceMappingURL=scheduleCommand.d.ts.map

package/dist/cli/scheduleCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleCommand.d.ts","sourceRoot":"","sources":["../../src/cli/scheduleCommand.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAc/D;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACpG,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAC5D;AAYD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,sBAA2B,EACjC,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,CAAC,CAkCjB"}

package/dist/cli/scheduleCommand.js

@@ -0,0 +1,68 @@
+// ============================================
+// OpenSwarm - `openswarm schedule add|list|remove|pause` (INT-1957)
+// ============================================
+//
+// CLI surface over the existing scheduler (src/automation/scheduler.ts): register
+// agent tasks on a cron/interval, persisted to ~/.openswarm/schedules.json and
+// run by the daemon (startAllSchedules). The formatter is pure; routing delegates
+// to the scheduler via injectable deps (testable without fs/cron).
+/** Render the schedule list for the terminal. */
+export function formatScheduleList(jobs) {
+    if (!jobs.length) {
+        return 'No schedules. Add one: openswarm schedule add <name> <cron|interval> <task>';
+    }
+    return jobs
+        .map((j) => {
+        const state = j.enabled ? '▶' : '⏸';
+        const last = j.lastRun ? ` (last: ${new Date(j.lastRun).toISOString()})` : '';
+        const fails = j.consecutiveFailures
+            ? ` ⚠ ${j.consecutiveFailures} consecutive failure(s)${j.enabled ? '' : ' — auto-paused'}`
+            : '';
+        return `  ${state} ${j.name} — ${j.schedule} — ${j.prompt}${last}${fails}`;
+    })
+        .join('\n');
+}
+async function defaultDeps() {
+    const s = await import('../automation/scheduler.js');
+    return {
+        add: (name, projectPath, prompt, schedule) => s.addSchedule(name, projectPath, prompt, schedule),
+        list: () => s.listSchedules(),
+        remove: (nameOrId) => s.removeSchedule(nameOrId),
+        toggle: (nameOrId) => s.toggleSchedule(nameOrId),
+    };
+}
+/** Route a `schedule` subcommand. Returns the message to print. */
+export async function runScheduleCommand(action, args, opts = {}, deps) {
+    const d = deps ?? (await defaultDeps());
+    switch (action) {
+        case 'add': {
+            const [name, schedule, ...rest] = args;
+            if (!name || !schedule || !rest.length) {
+                throw new Error('usage: openswarm schedule add <name> <cron|interval> <task...>');
+            }
+            const job = await d.add(name, opts.path ?? process.cwd(), rest.join(' '), schedule);
+            return `Added schedule "${job.name}" (${job.schedule}). The daemon runs it on schedule.`;
+        }
+        case 'list':
+            return formatScheduleList(await d.list());
+        case 'remove': {
+            const name = args[0];
+            if (!name)
+                throw new Error('usage: openswarm schedule remove <name>');
+            return (await d.remove(name)) ? `Removed schedule "${name}".` : `No schedule named "${name}".`;
+        }
+        case 'pause':
+        case 'toggle': {
+            const name = args[0];
+            if (!name)
+                throw new Error('usage: openswarm schedule pause <name>');
+            const job = await d.toggle(name);
+            if (!job)
+                return `No schedule named "${name}".`;
+            return `${job.enabled ? 'Resumed' : 'Paused'} schedule "${name}".`;
+        }
+        default:
+            throw new Error(`Unknown schedule action "${action}" (use add|list|remove|pause)`);
+    }
+}
+//# sourceMappingURL=scheduleCommand.js.map

package/dist/cli/scheduleCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleCommand.js","sourceRoot":"","sources":["../../src/cli/scheduleCommand.ts"],"names":[],"mappings":"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"}