lastlight 0.1.15 → 0.2.1

package/dist/connectors/slack/mrkdwn.test.js

@@ -61,5 +61,54 @@ describe('markdownToSlackMrkdwn', () => {
         const result = markdownToSlackMrkdwn(input);
         expect(result).toBe('<https://img.example.com|alt> and <https://link.example.com|text>');
     });
+    describe('GFM tables', () => {
+        it('renders a table as an aligned monospace code block', () => {
+            const input = [
+                '| Feature | Last Light | Eve |',
+                '|---------|-----------|-----|',
+                '| Scope | maintenance agent | framework |',
+                '| Hosting | self-hosted | managed |',
+            ].join('\n');
+            const result = markdownToSlackMrkdwn(input);
+            // Wrapped in a code block so Slack renders it fixed-width.
+            expect(result.startsWith('```')).toBe(true);
+            expect(result.trimEnd().endsWith('```')).toBe(true);
+            // Header present, GFM delimiter pipes gone.
+            expect(result).toContain('Feature');
+            expect(result).toContain('Last Light');
+            expect(result).not.toContain('|');
+            // The header label and the row value below it start at the same column.
+            const lines = result.split('\n');
+            const headerLine = lines.find((l) => l.includes('Last Light'));
+            const rowLine = lines.find((l) => l.includes('maintenance agent'));
+            expect(rowLine.indexOf('maintenance agent')).toBe(headerLine.indexOf('Last Light'));
+        });
+        it('aligns columns to the widest cell', () => {
+            const input = '| A | Bbbbb |\n|---|---|\n| ccccc | d |';
+            const result = markdownToSlackMrkdwn(input);
+            // "A" padded to width of "ccccc"; two-space gutter between columns.
+            expect(result).toContain('A      Bbbbb');
+            expect(result).toContain('ccccc  d');
+        });
+        it('strips inline markdown inside cells', () => {
+            const input = '| Name | Link |\n|---|---|\n| **bold** | [docs](https://x.io) |';
+            const result = markdownToSlackMrkdwn(input);
+            expect(result).toContain('bold');
+            expect(result).not.toContain('**bold**');
+            expect(result).toContain('docs (https://x.io)');
+        });
+        it('leaves pipe characters inside fenced code blocks alone', () => {
+            const input = '```\n| not | a | table |\n|---|---|---|\n```';
+            const result = markdownToSlackMrkdwn(input);
+            expect(result).toContain('| not | a | table |');
+        });
+        it('only converts the table, leaving surrounding prose intact', () => {
+            const input = 'Here is the comparison:\n\n| X | Y |\n|---|---|\n| 1 | 2 |\n\nThanks!';
+            const result = markdownToSlackMrkdwn(input);
+            expect(result).toContain('Here is the comparison:');
+            expect(result).toContain('Thanks!');
+            expect(result).toContain('```');
+        });
+    });
 });
 //# sourceMappingURL=mrkdwn.test.js.map

package/dist/connectors/slack/mrkdwn.test.js.map

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

package/dist/connectors/types.d.ts

@@ -36,7 +36,7 @@ export interface EventEnvelope {
     /** Timestamp of the event */
     timestamp: Date;
 }
-export type EventType = "issue.opened" | "issue.reopened" | "issue.closed" | "pr.opened" | "pr.closed" | "pr.merged" | "comment.created" | "pr_review.submitted" | "pr_review_comment.created" | "message";
+export type EventType = "issue.opened" | "issue.reopened" | "issue.closed" | "pr.opened" | "pr.synchronize" | "pr.reopened" | "pr.closed" | "pr.merged" | "comment.created" | "pr_review.submitted" | "pr_review_comment.created" | "message";
 /**
  * Connector interface — all event sources implement this.
  * The core engine registers a handler via on('event', ...) and

package/dist/cron/fanout.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cron fan-out: when a cron job context contains a `repos` array, dispatch
+ * one workflow run per repo instead of passing the array through to a single
+ * dispatch that expects `context.repo` (singular).
+ *
+ * Each per-repo run gets its own workflow_runs row, taskId, sandbox, and
+ * trigger id, so failures are isolated and the existing per-run resume
+ * machinery works unchanged.
+ *
+ * Concurrency is bounded so 100 repo scans don't spin 100 concurrent
+ * sandboxes — default is 3, tunable per call.
+ */
+export type CronDispatcher = (workflow: string, context: Record<string, unknown>) => Promise<{
+    success: boolean;
+    error?: string;
+    paused?: boolean;
+}>;
+export interface FanOutResult {
+    /** Number of dispatch calls actually made */
+    dispatched: number;
+    /** Number that returned !success and !paused (or threw) */
+    failures: number;
+}
+export interface FanOutOptions {
+    /** Max concurrent dispatches. Default 3. */
+    concurrency?: number;
+}
+/**
+ * Dispatch a cron-scheduled workflow, fanning out over `context.repos` when
+ * present. When absent, behaves like a single dispatch. Always stamps
+ * `_triggerType: "cron"` on the outgoing context.
+ */
+export declare function dispatchCronWorkflow(workflowName: string, context: Record<string, unknown>, dispatch: CronDispatcher, options?: FanOutOptions): Promise<FanOutResult>;

package/dist/cron/fanout.js

@@ -0,0 +1,55 @@
+/**
+ * Cron fan-out: when a cron job context contains a `repos` array, dispatch
+ * one workflow run per repo instead of passing the array through to a single
+ * dispatch that expects `context.repo` (singular).
+ *
+ * Each per-repo run gets its own workflow_runs row, taskId, sandbox, and
+ * trigger id, so failures are isolated and the existing per-run resume
+ * machinery works unchanged.
+ *
+ * Concurrency is bounded so 100 repo scans don't spin 100 concurrent
+ * sandboxes — default is 3, tunable per call.
+ */
+/**
+ * Dispatch a cron-scheduled workflow, fanning out over `context.repos` when
+ * present. When absent, behaves like a single dispatch. Always stamps
+ * `_triggerType: "cron"` on the outgoing context.
+ */
+export async function dispatchCronWorkflow(workflowName, context, dispatch, options = {}) {
+    const base = { ...context, _triggerType: "cron" };
+    const rawRepos = base.repos;
+    if (!Array.isArray(rawRepos)) {
+        const result = await runOne(dispatch, workflowName, base);
+        return { dispatched: 1, failures: result ? 0 : 1 };
+    }
+    const { repos: _drop, ...rest } = base;
+    const repos = rawRepos.filter((r) => typeof r === "string" && r.length > 0);
+    if (repos.length === 0) {
+        return { dispatched: 0, failures: 0 };
+    }
+    const concurrency = Math.max(1, options.concurrency ?? 3);
+    let dispatched = 0;
+    let failures = 0;
+    for (let i = 0; i < repos.length; i += concurrency) {
+        const batch = repos.slice(i, i + concurrency);
+        const results = await Promise.allSettled(batch.map((repo) => runOne(dispatch, workflowName, { ...rest, repo })));
+        for (const r of results) {
+            dispatched++;
+            const ok = r.status === "fulfilled" && r.value === true;
+            if (!ok)
+                failures++;
+        }
+    }
+    return { dispatched, failures };
+}
+async function runOne(dispatch, workflowName, context) {
+    try {
+        const result = await dispatch(workflowName, context);
+        return !!(result.success || result.paused);
+    }
+    catch (err) {
+        console.error(`[cron-fanout] ${workflowName} dispatch threw for ${String(context.repo ?? "<no repo>")}:`, err);
+        return false;
+    }
+}
+//# sourceMappingURL=fanout.js.map

package/dist/cron/fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.js","sourceRoot":"","sources":["../../src/cron/fanout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAoB,EACpB,OAAgC,EAChC,QAAwB,EACxB,UAAyB,EAAE;IAE3B,MAAM,IAAI,GAA4B,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAE5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QAC1D,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,KAAK,GAAI,QAAsB,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC1D,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CACvE,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;YACxD,IAAI,CAAC,EAAE;gBAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,MAAM,CACnB,QAAwB,EACxB,YAAoB,EACpB,OAAgC;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,iBAAiB,YAAY,uBAAuB,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,EAC1F,GAAG,CACJ,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cron/fanout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cron/fanout.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect, vi } from "vitest";
+import { dispatchCronWorkflow } from "./fanout.js";
+describe("dispatchCronWorkflow", () => {
+    it("dispatches once when context has no repos[]", async () => {
+        const dispatch = vi.fn().mockResolvedValue({ success: true });
+        const res = await dispatchCronWorkflow("repo-health", { repo: "cliftonc/lastlight", mode: "report" }, dispatch);
+        expect(dispatch).toHaveBeenCalledTimes(1);
+        expect(dispatch).toHaveBeenCalledWith("repo-health", expect.objectContaining({
+            repo: "cliftonc/lastlight",
+            mode: "report",
+            _triggerType: "cron",
+        }));
+        expect(res).toEqual({ dispatched: 1, failures: 0 });
+    });
+    it("fans out one dispatch per repo, stripping repos[] and injecting singular repo", async () => {
+        const dispatch = vi.fn().mockResolvedValue({ success: true });
+        const repos = ["cliftonc/a", "cliftonc/b", "cliftonc/c"];
+        const res = await dispatchCronWorkflow("security-review", { repos, mode: "scan", deliverSlackSummary: true }, dispatch);
+        expect(dispatch).toHaveBeenCalledTimes(3);
+        const passedRepos = dispatch.mock.calls.map((c) => c[1].repo);
+        expect(passedRepos.sort()).toEqual(repos.sort());
+        for (const call of dispatch.mock.calls) {
+            const ctx = call[1];
+            expect(ctx.repos).toBeUndefined(); // fan-out strips the array
+            expect(ctx._triggerType).toBe("cron");
+            expect(ctx.mode).toBe("scan");
+            expect(ctx.deliverSlackSummary).toBe(true);
+        }
+        expect(res).toEqual({ dispatched: 3, failures: 0 });
+    });
+    it("returns zero dispatches when repos[] is empty", async () => {
+        const dispatch = vi.fn().mockResolvedValue({ success: true });
+        const res = await dispatchCronWorkflow("security-review", { repos: [] }, dispatch);
+        expect(dispatch).not.toHaveBeenCalled();
+        expect(res).toEqual({ dispatched: 0, failures: 0 });
+    });
+    it("counts dispatch failures but isolates them (Promise.allSettled)", async () => {
+        const dispatch = vi.fn()
+            .mockResolvedValueOnce({ success: true })
+            .mockResolvedValueOnce({ success: false, error: "boom" })
+            .mockRejectedValueOnce(new Error("sandbox exploded"));
+        const res = await dispatchCronWorkflow("security-review", { repos: ["cliftonc/a", "cliftonc/b", "cliftonc/c"] }, dispatch, { concurrency: 3 });
+        expect(dispatch).toHaveBeenCalledTimes(3);
+        expect(res).toEqual({ dispatched: 3, failures: 2 });
+    });
+    it("counts paused runs as non-failures", async () => {
+        const dispatch = vi.fn().mockResolvedValue({ success: true, paused: true });
+        const res = await dispatchCronWorkflow("security-review", { repos: ["cliftonc/a"] }, dispatch);
+        expect(res).toEqual({ dispatched: 1, failures: 0 });
+    });
+    it("bounds concurrency — never more than N dispatches in flight", async () => {
+        let inFlight = 0;
+        let peakInFlight = 0;
+        const dispatch = vi.fn().mockImplementation(async () => {
+            inFlight++;
+            peakInFlight = Math.max(peakInFlight, inFlight);
+            await new Promise((r) => setTimeout(r, 5));
+            inFlight--;
+            return { success: true };
+        });
+        const repos = Array.from({ length: 10 }, (_, i) => `cliftonc/repo-${i}`);
+        const res = await dispatchCronWorkflow("security-review", { repos }, dispatch, { concurrency: 3 });
+        expect(res).toEqual({ dispatched: 10, failures: 0 });
+        expect(peakInFlight).toBeLessThanOrEqual(3);
+    });
+    it("drops non-string entries from repos[] silently", async () => {
+        const dispatch = vi.fn().mockResolvedValue({ success: true });
+        const res = await dispatchCronWorkflow("security-review", { repos: ["cliftonc/a", 42, null, "", "cliftonc/b"] }, dispatch);
+        expect(dispatch).toHaveBeenCalledTimes(2);
+        expect(res).toEqual({ dispatched: 2, failures: 0 });
+    });
+});
+//# sourceMappingURL=fanout.test.js.map

package/dist/cron/fanout.test.js.map

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

package/dist/cron/jobs.d.ts

@@ -1,4 +1,5 @@
 import type { CronJob } from "./scheduler.js";
+import type { StateDb } from "../state/db.js";
 /**
  * Get cron jobs based on configuration.
  *
@@ -7,7 +8,11 @@ import type { CronJob } from "./scheduler.js";
  * which is invoked on each tick. When webhooks are enabled
  * (WEBHOOK_SECRET is set), jobs with `condition.unless: webhooksEnabled`
  * are filtered out — those are handled in real-time via webhook events.
+ *
+ * When `db` is supplied, cron_overrides rows applied: disabled jobs are
+ * dropped and schedule overrides replace the YAML schedule.
  */
 export declare function getJobs(opts?: {
     webhooksEnabled?: boolean;
+    db?: StateDb;
 }): CronJob[];

package/dist/cron/jobs.js

@@ -1,4 +1,4 @@
-import { MANAGED_REPOS } from "../managed-repos.js";
+import { getManagedRepos } from "../managed-repos.js";
 import { getCronWorkflows } from "../workflows/loader.js";
 /**
  * Get cron jobs based on configuration.
@@ -8,6 +8,9 @@ import { getCronWorkflows } from "../workflows/loader.js";
  * which is invoked on each tick. When webhooks are enabled
  * (WEBHOOK_SECRET is set), jobs with `condition.unless: webhooksEnabled`
  * are filtered out — those are handled in real-time via webhook events.
+ *
+ * When `db` is supplied, cron_overrides rows applied: disabled jobs are
+ * dropped and schedule overrides replace the YAML schedule.
  */
 export function getJobs(opts) {
     const jobs = [];
@@ -16,13 +19,17 @@ export function getJobs(opts) {
     if (opts?.webhooksEnabled) {
         cronDefs = cronDefs.filter((def) => def.condition?.unless !== "webhooksEnabled");
     }
+    const overrides = opts?.db?.getAllCronOverrides() ?? new Map();
     for (const def of cronDefs) {
+        const override = overrides.get(def.name);
+        if (override && !override.enabled)
+            continue;
         jobs.push({
             name: def.name,
-            schedule: def.schedule,
+            schedule: override?.schedule || def.schedule,
             workflow: def.workflow,
             // Merge managed repos into the context the workflow receives
-            context: { repos: MANAGED_REPOS, ...def.context },
+            context: { repos: getManagedRepos(), ...def.context },
         });
     }
     return jobs;

package/dist/cron/jobs.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/cron/jobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,IAAoC;IAC1D,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,IAAI,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IAElC,mBAAmB;IACnB,IAAI,IAAI,EAAE,eAAe,EAAE,CAAC;QAC1B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,6DAA6D;YAC7D,OAAO,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/cron/jobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,IAAkD;IACxE,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,IAAI,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IAElC,mBAAmB;IACnB,IAAI,IAAI,EAAE,eAAe,EAAE,CAAC;QAC1B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,IAAI,GAAG,EAAE,CAAC;IAE/D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,SAAS;QAC5C,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,QAAQ;YAC5C,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,6DAA6D;YAC7D,OAAO,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cron/scheduler.d.ts

@@ -28,6 +28,18 @@ export declare class CronScheduler {
     register(job: CronJob): void;
     /** Register a lightweight direct handler (no skill/sandbox overhead) */
     registerDirect(job: DirectCronJob): void;
+    /** Whether a cron with this name is currently registered. */
+    has(name: string): boolean;
+    /** Stop and remove a single cron. No-op if not registered. */
+    unregister(name: string): void;
+    /** Replace an existing cron with a new schedule/context. Equivalent to unregister + register. */
+    update(job: CronJob): void;
+    /** Snapshot of registered jobs with the croner-computed next-run timestamp. */
+    list(): Array<{
+        name: string;
+        schedule: string;
+        nextRun: Date | null;
+    }>;
     /** Stop all cron jobs */
     stopAll(): void;
 }

package/dist/cron/scheduler.js

@@ -30,7 +30,7 @@ export class CronScheduler {
             catch (err) {
                 console.error(`[cron] ${job.name} failed:`, err.message);
                 // Check consecutive failures (tracked under the workflow name)
-                const failures = this.db.consecutiveFailures(job.workflow);
+                const failures = this.db.executions.consecutiveFailures(job.workflow);
                 const max = job.maxFailures || 3;
                 if (failures >= max) {
                     console.error(`[cron] ALERT: ${job.name} has failed ${failures} times consecutively`);
@@ -67,6 +67,32 @@ export class CronScheduler {
         this.jobs.set(job.name, cronJob);
         console.log(`[cron] Registered: ${job.name} (${job.schedule})`);
     }
+    /** Whether a cron with this name is currently registered. */
+    has(name) {
+        return this.jobs.has(name);
+    }
+    /** Stop and remove a single cron. No-op if not registered. */
+    unregister(name) {
+        const job = this.jobs.get(name);
+        if (!job)
+            return;
+        job.stop();
+        this.jobs.delete(name);
+        console.log(`[cron] Stopped: ${name}`);
+    }
+    /** Replace an existing cron with a new schedule/context. Equivalent to unregister + register. */
+    update(job) {
+        this.unregister(job.name);
+        this.register(job);
+    }
+    /** Snapshot of registered jobs with the croner-computed next-run timestamp. */
+    list() {
+        return Array.from(this.jobs.entries()).map(([name, cronJob]) => ({
+            name,
+            schedule: cronJob.getPattern() ?? "",
+            nextRun: cronJob.nextRun(),
+        }));
+    }
     /** Stop all cron jobs */
     stopAll() {
         for (const [name, job] of this.jobs) {

package/dist/cron/scheduler.js.map

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

package/dist/engine/agent-executor.d.ts

@@ -0,0 +1,158 @@
+import type { RunResult } from "agentic-pi";
+import { type DockerSandbox } from "../sandbox/index.js";
+import { type ExecutorConfig, type ExecutionResult, type ExtensionStatusMap, type SkillsStatus, type GitSandboxAccess } from "./profiles.js";
+/**
+ * Stage this phase's declared skills into a per-phase bundle directory at
+ * `<workspaceRoot>/.lastlight-skills/<phaseKey>/<basename>/` and return the
+ * staged skill dirs, so the caller can point pi at them explicitly (via
+ * `--skill` for docker or `skillPaths` for the in-process backends). Each
+ * skill is a directory containing SKILL.md plus any `scripts/` / `references/`
+ * / `assets/` — the whole tree comes along.
+ *
+ * Keyed by phase so concurrent phases in one workspace never touch each
+ * other's bundle: only the phase's own `<phaseKey>` subtree is cleared, so a
+ * clean slate per phase doesn't disturb a sibling phase mid-run.
+ *
+ * `mode` controls how each skill lands:
+ *   - "symlink": one symlink per skill → host source. gondolin/none, where pi
+ *     reads skill files host-side / through the cwd mount. Zero-copy.
+ *   - "copy": recursive copy. docker, where the agent's tools run inside the
+ *     container and host symlink targets wouldn't resolve; the copy lands
+ *     under the bind-mounted workspace.
+ *
+ * Returns `undefined` when the phase declares no skills (after clearing its
+ * bundle), so a phase with no `skills:` gets no catalogue at all.
+ */
+export declare function stageSkillBundle(workspaceRoot: string, phaseKey: string, skillPaths: string[] | undefined, mode: "symlink" | "copy"): string[] | undefined;
+/**
+ * Add `entry` to a checkout's local `.git/info/exclude` (idempotent) so the
+ * agent's own `git add`/`commit` can never pick it up. This file lives inside
+ * `.git/` — it is never tracked, committed, or pushed, and it leaves the repo's
+ * real `.gitignore` untouched; the exclusion applies only to this ephemeral
+ * sandbox checkout. Used for the gondolin backend, where the skill bundle must
+ * be staged under cwd (the only mounted dir) rather than as an out-of-repo
+ * sibling. No-op when `repoDir` isn't a git checkout (e.g. the workspace root).
+ */
+export declare function excludeFromGit(repoDir: string, entry: string): void;
+/**
+ * Execute one workflow-phase agent task via agentic-pi.
+ *
+ * Sandbox backend (decided per call):
+ *  1. gondolin — agentic-pi's QEMU micro-VM. cwd is the host worktree,
+ *     mounted at /workspace inside the VM.
+ *  2. docker — the legacy container path (`src/sandbox/docker.ts`). The
+ *     entrypoint inside the container execs `agentic-pi run --sandbox none`.
+ *  3. none — agentic-pi in-process with cwd = the host worktree.
+ */
+export declare function executeAgent(prompt: string, config: ExecutorConfig, opts?: {
+    taskId?: string;
+    /**
+     * Fired as soon as the run gets a session id. Used to persist the id
+     * onto the in-flight executions row so the dashboard can deep-link
+     * the running phase to its live JSONL.
+     */
+    onSessionId?: (sessionId: string) => void;
+    githubAccess?: GitSandboxAccess;
+}): Promise<ExecutionResult>;
+/**
+ * Build a RunResult-shaped tally from the JSONL event stream emitted by
+ * `agentic-pi run` inside the docker sandbox. Mirrors what agentic-pi's
+ * own `run()` function does in-process — minimum viable subset of
+ * fields the executor cares about.
+ *
+ * Usage accounting accumulates each assistant `message_end`'s `usage`
+ * rather than trusting the terminal `usage_snapshot`. pi's snapshot is
+ * derived from `getSessionStats()`, which recomputes from the *current*
+ * in-memory message window — auto-compaction replaces those messages with
+ * a summary, so the snapshot reports zero tokens/cost/turns the moment a
+ * phase compacts. The per-message events fire at finalization (before any
+ * compaction rebuild), so summing them is compaction-proof. `bestStats()`
+ * prefers the accumulation and falls back to the snapshot only when no
+ * per-message usage was observed.
+ */
+export declare class RunResultAccumulator {
+    private sessionId?;
+    private finalText;
+    private agentEnded;
+    private toolErrors;
+    private lastToolError?;
+    private lastAssistantHadToolCall;
+    private fatalError?;
+    private snapshotStats?;
+    private messages;
+    private assistantMessages;
+    private userMessages;
+    private toolCalls;
+    private toolResults;
+    private msgInput;
+    private msgOutput;
+    private msgCacheRead;
+    private msgCacheWrite;
+    private msgCost;
+    private ext;
+    private skillsRaw?;
+    feed(r: Record<string, unknown>): void;
+    private accumulateUsage;
+    /** Stats summed from per-message usage, or undefined if none was seen. */
+    private accumulatedStats;
+    /**
+     * Prefer the per-message accumulation (compaction-proof) over pi's
+     * terminal `usage_snapshot`. Fall back to the snapshot only when the
+     * accumulation carries no token data — e.g. a provider that doesn't
+     * report per-message usage — so a non-compacted snapshot still wins.
+     */
+    bestStats(): RunResult["stats"] | undefined;
+    build(exitCode: 0 | 1 | 2): RunResult;
+    /**
+     * Normalized extension status captured from `extension_status` events
+     * (file-search / github / web-search), or undefined if none reported.
+     * Decoupled from agentic-pi's `RunResult` type, which lags the runtime —
+     * the docker sandbox's agentic-pi emits file-search even when the harness's
+     * pinned `RunResult` type doesn't yet declare it.
+     */
+    extensions(): ExtensionStatusMap | undefined;
+    /**
+     * Normalized skill-loading status from the gated `skills_status` event, or
+     * undefined if none was reported (agentic-pi suppresses it on a run that
+     * configured no skills and discovered none). The skill-loading counterpart
+     * to {@link extensions}.
+     */
+    skills(): SkillsStatus | undefined;
+    /**
+     * The last tool result that came back with `isError: true`, including the
+     * failure text — or undefined if no tool errored. This is what turns a
+     * bare `error_tool` stop reason into a human-readable cause.
+     */
+    toolError(): {
+        tool?: string;
+        message: string;
+    } | undefined;
+    /**
+     * True iff the run's final assistant turn ended on a tool call — meaning
+     * the agent intended to keep going but the loop stopped before it could
+     * respond to the tool result and write its answer. The signal a run was
+     * truncated (step-limit) rather than genuinely finished.
+     */
+    endedOnToolCall(): boolean;
+}
+/**
+ * Detect a provider account error (out of credit, quota, rate-limited, bad key)
+ * that pi may have surfaced as plain text rather than a hard failure.
+ *
+ * Critically, on a **successful** run we scan ONLY the genuine provider-error
+ * channel (`agentErrorMessage`, which `extractAgentError` already turns into a
+ * non-success stopReason when set — so it's empty here). The agent's own output
+ * (`finalText`) and tool results (`fatalError`, `toolError`) are NOT scanned on
+ * success: a legitimate `verify`/`qa-test` report or a `curl` probing a 401
+ * endpoint routinely contains "unauthorized" / "rate limit" as part of the task
+ * itself, and folding that in would wrongly fail a genuinely successful run
+ * (and drop its report). Only on a failed run do we fold those in to label why.
+ */
+export declare function detectAccountError(opts: {
+    success: boolean;
+    fatalErrorMessage?: string;
+    agentErrorMessage?: string;
+    finalText?: string;
+    toolErrorText?: string;
+}): boolean;
+export type { DockerSandbox };