@mickorz/opencode-agentic-workflow 0.3.2 → 0.5.0

package/dist/scheduler/cron.js

@@ -0,0 +1,171 @@
+// cron 子集校验与 slot 计算（P2-7，v1-parity；零依赖实现）
+//
+// 支持的四模式（与 v1 同子集——覆盖定时场景的第一版全部需求）：
+//   每分钟 / 每 n 分钟    `* * * * *` / 分钟字段 星杠n（n 1-59）
+//   每小时 m 分           `m * * * *`
+//   每天 h 点 m 分        `m h * * *`
+//   每周 W 的 h 点 m 分   `m h * * W`（W = 0-6 单值或逗号列表，0=周日）
+//
+// slot 计算：本地时区闭式数学（v1 用 cron-parser；v2 零依赖手写）。
+// DST 切换日的 slot 可能与墙钟偏差 1 小时（诚实边界，对分钟级/小时级
+// 场景无实质影响）。同一表达式各次计算确定一致。
+//
+// 纪律：Core 侧模块，禁止 import OpenCode API（架构不变量）。
+const EVERY_MINUTES = /^(\*\/(\d{1,2})|\*) \* \* \* \*$/;
+const HOURLY = /^(\d{1,2}) \* \* \* \*$/;
+const DAILY = /^(\d{1,2}) (\d{1,2}) \* \* \*$/;
+const WEEKLY = /^(\d{1,2}) (\d{1,2}) \* \* (\d(?:,\d)*)$/;
+const FORMAT_HELP = [
+    '不支持的 cron 表达式 "${expr}"。仅支持四种模式：',
+    "  * * * * *    每分钟；*/n * * * * 每 n 分钟（n 1-59，如 */5 每 5 分钟）",
+    "  m * * * *   每小时 m 分（如 30 * * * * 每小时半点）",
+    "  m h * * *   每天 h 点 m 分（如 0 9 * * * 每天 9 点）",
+    "  m h * * W   每周 W 的 h 点 m 分（W 0-6，0=周日；如 0 10 * * 1 每周一 10 点）",
+].join("\n");
+/**
+ * 校验并解析 cron 表达式。
+ * 合法返回 CronSpec；非法返回错误信息（含格式说明，可直接展示）。
+ */
+export function parseCron(expr) {
+    const text = expr.trim();
+    if (text.length === 0) {
+        return 'cron 表达式为空（支持格式见下）\n' + FORMAT_HELP.replace("${expr}", expr);
+    }
+    let m = EVERY_MINUTES.exec(text);
+    if (m) {
+        const step = m[2] === undefined ? 1 : Number(m[2]); // 裸 "*" 等价 */1
+        if (step < 1 || step > 59)
+            return `每分钟模式的步长需在 1-59 之间，收到 ${step}`;
+        return { kind: "minutes", step };
+    }
+    m = HOURLY.exec(text);
+    if (m) {
+        const minute = Number(m[1]);
+        if (minute > 59)
+            return `分钟需在 0-59 之间，收到 ${minute}`;
+        return { kind: "hourly", minute };
+    }
+    m = DAILY.exec(text);
+    if (m) {
+        const minute = Number(m[1]);
+        const hour = Number(m[2]);
+        if (minute > 59)
+            return `分钟需在 0-59 之间，收到 ${minute}`;
+        if (hour > 23)
+            return `小时需在 0-23 之间，收到 ${hour}`;
+        return { kind: "daily", minute, hour };
+    }
+    m = WEEKLY.exec(text);
+    if (m) {
+        const minute = Number(m[1]);
+        const hour = Number(m[2]);
+        if (minute > 59)
+            return `分钟需在 0-59 之间，收到 ${minute}`;
+        if (hour > 23)
+            return `小时需在 0-23 之间，收到 ${hour}`;
+        const days = m[3].split(",").map(Number);
+        for (const day of days) {
+            if (day > 6)
+                return `星期需在 0-6 之间（0=周日），收到 ${day}`;
+        }
+        return { kind: "weekly", minute, hour, days };
+    }
+    return FORMAT_HELP.replace("${expr}", expr);
+}
+export function validateCron(expr) {
+    const parsed = parseCron(expr);
+    return typeof parsed === "string" ? parsed : null;
+}
+/** 把时间截到分钟（秒/毫秒归零） */
+function zeroToMinute(date) {
+    const d = new Date(date.getTime());
+    d.setSeconds(0, 0);
+    return d;
+}
+/** 严格晚于 after 的第一个候选（分钟对齐）；先保证 > after 再按谓词推进 */
+function firstCandidate(after) {
+    let t = zeroToMinute(new Date(after.getTime() + 1));
+    while (t.getTime() <= after.getTime()) {
+        t = new Date(t.getTime() + 60_000);
+    }
+    return t;
+}
+/**
+ * after 之后的下一个未来 slot（严格晚于 after）。
+ * 已通过校验的 spec 才可调用（parseCron 返回 CronSpec）。
+ */
+export function nextRun(spec, after) {
+    let t = firstCandidate(after);
+    switch (spec.kind) {
+        case "minutes": {
+            // 分钟 0 恒满足（0 % n === 0），60 分钟内必命中
+            for (let i = 0; i < 60 && t.getMinutes() % spec.step !== 0; i++) {
+                t = new Date(t.getTime() + 60_000);
+            }
+            return t;
+        }
+        case "hourly": {
+            t.setMinutes(spec.minute);
+            if (t.getTime() <= after.getTime())
+                t = new Date(t.getTime() + 3_600_000);
+            t.setMinutes(spec.minute); // 跨小时后再对齐分钟（+1h 保持分钟不变，此行防御 DST 偏移）
+            return t;
+        }
+        case "daily": {
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            if (t.getTime() <= after.getTime())
+                t = new Date(t.getTime() + 86_400_000);
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            return t;
+        }
+        case "weekly": {
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            if (t.getTime() <= after.getTime())
+                t = new Date(t.getTime() + 86_400_000);
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            for (let i = 0; i < 7 && !spec.days.includes(t.getDay()); i++) {
+                t = new Date(t.getTime() + 86_400_000);
+                t.setHours(spec.hour, spec.minute, 0, 0);
+            }
+            return t;
+        }
+    }
+}
+/** now 之前（含恰好等于）最近的一个过去 slot */
+export function latestSlot(spec, now) {
+    let t = zeroToMinute(now);
+    switch (spec.kind) {
+        case "minutes": {
+            for (let i = 0; i < 60 && t.getMinutes() % spec.step !== 0; i++) {
+                t = new Date(t.getTime() - 60_000);
+            }
+            return t;
+        }
+        case "hourly": {
+            t.setMinutes(spec.minute);
+            if (t.getTime() > now.getTime())
+                t = new Date(t.getTime() - 3_600_000);
+            t.setMinutes(spec.minute);
+            return t;
+        }
+        case "daily": {
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            if (t.getTime() > now.getTime())
+                t = new Date(t.getTime() - 86_400_000);
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            return t;
+        }
+        case "weekly": {
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            if (t.getTime() > now.getTime())
+                t = new Date(t.getTime() - 86_400_000);
+            t.setHours(spec.hour, spec.minute, 0, 0);
+            for (let i = 0; i < 7 && !spec.days.includes(t.getDay()); i++) {
+                t = new Date(t.getTime() - 86_400_000);
+                t.setHours(spec.hour, spec.minute, 0, 0);
+            }
+            return t;
+        }
+    }
+}
+//# sourceMappingURL=cron.js.map

package/dist/scheduler/cron.js.map

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

package/dist/scheduler/service.d.ts

@@ -0,0 +1,78 @@
+/**
+ * SchedulerService（P2-7）：定时任务的核心编排（宿主无关）
+ *
+ * 职责：何时触发（cron slot + 游标去重）与记录生命周期；
+ * 怎么执行（workflow 启动方式）经 TriggerFn 注入（插件侧接线
+ * startWorkflowDetached + 单飞检查）。
+ *
+ * 触发语义（如实告知，全部写进工具描述）：
+ *   - 游标基线 = 创建时刻的最近过去 slot：创建前的 slot 不补跑
+ *     （要立刻跑用 runNow）
+ *   - 宿主停机错过的 slot，重启后**合并为最近一个** slot 补跑一次
+ *     （绝不按停机时长逐个补）
+ *   - 单飞冲突（本进程已有 live run）：该 slot 记录 skipped 并消费——
+ *     是跳过不是延迟
+ *   - 调度器随宿主进程存活（timer unref，不阻止退出）
+ *
+ * 纪律：Core 侧模块，禁止 import OpenCode API（架构不变量）。
+ */
+import type { Schedule, ScheduleRun, ScheduleView } from "./types.js";
+/** 触发器以此异常表示「本次跳过」（如单飞冲突）；其他异常 = failed */
+export declare class ScheduleSkipError extends Error {
+    constructor(reason: string);
+}
+export interface TriggerResult {
+    runId: string;
+    /** workflow 终态映射（completed→success / failed→failed / aborted→aborted） */
+    completion: Promise<"success" | "failed" | "aborted">;
+}
+/** 执行器注入：如何启动一次 workflow run（返回 runId + 终态 promise） */
+export type TriggerFn = (schedule: Schedule, trigger: "scheduled" | "manual") => Promise<TriggerResult>;
+export interface SchedulerDeps {
+    /** schedulesDir（绝对路径） */
+    dir: string;
+    /** 时钟注入（测试用）；缺省真实时间 */
+    now?: () => Date;
+    /** create 时校验 flow 存在（registry 查询） */
+    flowExists: (flow: string) => boolean;
+    /** 已知 flow 清单（报错提示用） */
+    knownFlows?: () => string[];
+    /** 执行注入（插件侧接线 startWorkflowDetached） */
+    trigger: TriggerFn;
+    /** tick 间隔 ms，默认 15000 */
+    tickMs?: number;
+}
+export interface CreateScheduleInput {
+    id: string;
+    flow: string;
+    cron: string;
+    name?: string;
+    args?: Record<string, unknown>;
+    /** 缺省 true */
+    enabled?: boolean;
+}
+export declare class SchedulerService {
+    private readonly deps;
+    private timer;
+    constructor(deps: SchedulerDeps);
+    private now;
+    start(): void;
+    stop(): void;
+    create(input: CreateScheduleInput): Promise<ScheduleView>;
+    setEnabled(id: string, enabled: boolean): Promise<ScheduleView>;
+    remove(id: string): Promise<void>;
+    list(): Promise<ScheduleView[]>;
+    /** 详情：视图 + 最近触发记录（默认 10 条） */
+    detail(id: string, runLimit?: number): Promise<{
+        view: ScheduleView;
+        runs: ScheduleRun[];
+    }>;
+    private require;
+    private view;
+    /** 手动立即触发（manual；不消费 cron 游标；单飞冲突照常 skip） */
+    runNow(id: string): Promise<ScheduleRun>;
+    /** 一个 tick：消费到点 slot。返回本轮触发的 schedule id（可测/日志） */
+    tick(): Promise<string[]>;
+    /** 触发一次：记录 running → 执行注入 → 终态回写。fire 不抛（异常进记录） */
+    private fire;
+}

package/dist/scheduler/service.js

@@ -0,0 +1,210 @@
+/**
+ * SchedulerService（P2-7）：定时任务的核心编排（宿主无关）
+ *
+ * 职责：何时触发（cron slot + 游标去重）与记录生命周期；
+ * 怎么执行（workflow 启动方式）经 TriggerFn 注入（插件侧接线
+ * startWorkflowDetached + 单飞检查）。
+ *
+ * 触发语义（如实告知，全部写进工具描述）：
+ *   - 游标基线 = 创建时刻的最近过去 slot：创建前的 slot 不补跑
+ *     （要立刻跑用 runNow）
+ *   - 宿主停机错过的 slot，重启后**合并为最近一个** slot 补跑一次
+ *     （绝不按停机时长逐个补）
+ *   - 单飞冲突（本进程已有 live run）：该 slot 记录 skipped 并消费——
+ *     是跳过不是延迟
+ *   - 调度器随宿主进程存活（timer unref，不阻止退出）
+ *
+ * 纪律：Core 侧模块，禁止 import OpenCode API（架构不变量）。
+ */
+import { latestSlot, nextRun, parseCron } from "./cron.js";
+import { appendRun, deleteSchedule as deleteScheduleFiles, getSchedule, listRuns, listSchedules, readCursor, saveSchedule, updateRun, writeCursor, } from "./store.js";
+const ID_PATTERN = /^[a-z][a-z0-9-]*$/;
+/** 触发器以此异常表示「本次跳过」（如单飞冲突）；其他异常 = failed */
+export class ScheduleSkipError extends Error {
+    constructor(reason) {
+        super(reason);
+        this.name = "ScheduleSkipError";
+    }
+}
+export class SchedulerService {
+    deps;
+    timer;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() {
+        return this.deps.now ? this.deps.now() : new Date();
+    }
+    // ── 生命周期 ─────────────────────────────────────────────────────────
+    start() {
+        if (this.timer)
+            return;
+        const tickMs = this.deps.tickMs ?? 15_000;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, tickMs);
+        // 不阻止宿主进程退出（调度器随宿主存活，进程退出即停）
+        if (typeof this.timer.unref === "function")
+            this.timer.unref();
+        console.log(`[agentic-workflow] scheduler started (tick ${tickMs}ms, dir ${this.deps.dir})`);
+    }
+    stop() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    // ── CRUD ─────────────────────────────────────────────────────────────
+    async create(input) {
+        const { id, flow, cron } = input;
+        if (!ID_PATTERN.test(id)) {
+            throw new Error(`schedule id 必须是 kebab-case（小写字母开头，含小写字母/数字/-），收到 "${id}"`);
+        }
+        const cronError = ((spec) => (typeof spec === "string" ? spec : null))(parseCron(cron));
+        if (cronError)
+            throw new Error(`INVALID_CRON：${cronError}`);
+        if (!this.deps.flowExists(flow)) {
+            const known = this.deps.knownFlows?.().join(", ") ?? "（无）";
+            throw new Error(`FLOW_NOT_FOUND：未找到 flow "${flow}"（已知：${known}）`);
+        }
+        if (await getSchedule(this.deps.dir, id)) {
+            throw new Error(`DUPLICATE：schedule "${id}" 已存在（改配置请先 delete 再 create，或用 enable/disable）`);
+        }
+        const nowIso = this.now().toISOString();
+        const schedule = {
+            id,
+            name: input.name,
+            flow,
+            cron,
+            enabled: input.enabled ?? true,
+            ...(input.args !== undefined ? { args: input.args } : {}),
+            createdAt: nowIso,
+            updatedAt: nowIso,
+        };
+        await saveSchedule(this.deps.dir, schedule);
+        // 游标基线 = 创建时刻的最近过去 slot：创建前的 slot 不补跑
+        const spec = parseCron(cron);
+        const cursor = await readCursor(this.deps.dir);
+        cursor[id] = latestSlot(spec, this.now()).getTime();
+        await writeCursor(this.deps.dir, cursor);
+        return this.view(schedule);
+    }
+    async setEnabled(id, enabled) {
+        const schedule = await this.require(id);
+        schedule.enabled = enabled;
+        schedule.updatedAt = this.now().toISOString();
+        await saveSchedule(this.deps.dir, schedule);
+        return this.view(schedule);
+    }
+    async remove(id) {
+        await this.require(id);
+        await deleteScheduleFiles(this.deps.dir, id);
+    }
+    async list() {
+        const schedules = await listSchedules(this.deps.dir);
+        return Promise.all(schedules.map((s) => this.view(s)));
+    }
+    /** 详情：视图 + 最近触发记录（默认 10 条） */
+    async detail(id, runLimit = 10) {
+        const schedule = await this.require(id);
+        const runs = (await listRuns(this.deps.dir, id)).slice(0, runLimit);
+        return { view: await this.view(schedule), runs };
+    }
+    async require(id) {
+        const schedule = await getSchedule(this.deps.dir, id);
+        if (!schedule)
+            throw new Error(`NOT_FOUND：未找到 schedule "${id}"`);
+        return schedule;
+    }
+    async view(schedule) {
+        const spec = parseCron(schedule.cron);
+        const runs = await listRuns(this.deps.dir, schedule.id);
+        const last = runs[0];
+        return {
+            ...schedule,
+            ...(last ? { lastRunAt: last.startedAt, lastRunStatus: last.status } : {}),
+            ...(schedule.enabled && typeof spec === "object"
+                ? { nextRunAt: nextRun(spec, this.now()).toISOString() }
+                : {}),
+        };
+    }
+    // ── 触发 ─────────────────────────────────────────────────────────────
+    /** 手动立即触发（manual；不消费 cron 游标；单飞冲突照常 skip） */
+    async runNow(id) {
+        const schedule = await this.require(id);
+        const now = this.now();
+        return this.fire(schedule, "manual", now.getTime());
+    }
+    /** 一个 tick：消费到点 slot。返回本轮触发的 schedule id（可测/日志） */
+    async tick() {
+        const now = this.now();
+        const schedules = await listSchedules(this.deps.dir);
+        const cursor = await readCursor(this.deps.dir);
+        const fired = [];
+        for (const schedule of schedules) {
+            if (!schedule.enabled)
+                continue;
+            const spec = parseCron(schedule.cron);
+            if (typeof spec === "string") {
+                console.log(`[agentic-workflow] scheduler: schedule ${schedule.id} cron invalid, skipped: ${spec.split("\n")[0]}`);
+                continue;
+            }
+            const slot = latestSlot(spec, now).getTime();
+            const consumed = cursor[schedule.id] ?? 0;
+            if (slot <= consumed)
+                continue; // 已消费（或基线之内）
+            // 消费游标（含停机补跑合并：直接跳到最近 slot）后触发
+            cursor[schedule.id] = slot;
+            await writeCursor(this.deps.dir, cursor);
+            console.log(`[agentic-workflow] scheduler: ${schedule.id} due (slot ${new Date(slot).toISOString()})`);
+            await this.fire(schedule, "scheduled", slot);
+            fired.push(schedule.id);
+        }
+        return fired;
+    }
+    /** 触发一次：记录 running → 执行注入 → 终态回写。fire 不抛（异常进记录） */
+    async fire(schedule, trigger, slotEpoch) {
+        const startedAt = new Date().toISOString();
+        const record = {
+            scheduleId: schedule.id,
+            flow: schedule.flow,
+            trigger,
+            slot: new Date(slotEpoch).toISOString(),
+            slotEpoch,
+            status: "running",
+            startedAt,
+        };
+        await appendRun(this.deps.dir, schedule.id, record);
+        try {
+            const started = await this.deps.trigger(schedule, trigger);
+            record.workflowRunId = started.runId;
+            await updateRun(this.deps.dir, schedule.id, slotEpoch, trigger, { workflowRunId: started.runId });
+            // 终态回写（detached completion；fire 自身不等待终态）
+            void started.completion.then((status) => {
+                void updateRun(this.deps.dir, schedule.id, slotEpoch, trigger, {
+                    status,
+                    finishedAt: new Date().toISOString(),
+                });
+            }, (error) => {
+                void updateRun(this.deps.dir, schedule.id, slotEpoch, trigger, {
+                    status: "failed",
+                    finishedAt: new Date().toISOString(),
+                    note: error instanceof Error ? error.message : String(error),
+                });
+            });
+            return record;
+        }
+        catch (error) {
+            const skipped = error instanceof ScheduleSkipError;
+            const status = skipped ? "skipped" : "failed";
+            const patch = {
+                status,
+                finishedAt: new Date().toISOString(),
+                note: error instanceof Error ? error.message : String(error),
+            };
+            await updateRun(this.deps.dir, schedule.id, slotEpoch, trigger, patch);
+            return { ...record, ...patch };
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/scheduler/service.js.map

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

package/dist/scheduler/store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Schedule 文件存储（P2-7）
+ *
+ * schedulesDir 布局：
+ *   <id>.json          Schedule 配置（工具管理；点开头文件被忽略）
+ *   .cursor.json       触发游标 { [id]: lastSlotEpochMs }（原子写）
+ *   runs/<id>.json     该 id 的触发记录（新的在前，上限 50 条，原子写）
+ *
+ * 纪律：Core 侧模块，禁止 import OpenCode API（架构不变量）。
+ */
+import type { Schedule, ScheduleRun } from "./types.js";
+/** 全部 Schedule（按 id 排序；点开头与 runs/ 不算配置） */
+export declare function listSchedules(dir: string): Promise<Schedule[]>;
+export declare function getSchedule(dir: string, id: string): Promise<Schedule | undefined>;
+export declare function saveSchedule(dir: string, schedule: Schedule): Promise<void>;
+/** 删除配置 + 该 id 的游标与记录 */
+export declare function deleteSchedule(dir: string, id: string): Promise<void>;
+/** 触发游标：id -> 已消费的 slot epoch ms */
+export declare function readCursor(dir: string): Promise<Record<string, number>>;
+export declare function writeCursor(dir: string, cursor: Record<string, number>): Promise<void>;
+/** 某 id 的触发记录（新的在前） */
+export declare function listRuns(dir: string, id: string): Promise<ScheduleRun[]>;
+/** 追加一条记录（新的在前，上限 50 条截断） */
+export declare function appendRun(dir: string, id: string, run: ScheduleRun): Promise<void>;
+/** 按 slotEpoch + trigger 定位记录并更新（服务在 run 收口时改状态） */
+export declare function updateRun(dir: string, id: string, slotEpoch: number, trigger: "scheduled" | "manual", patch: Partial<ScheduleRun>): Promise<ScheduleRun | undefined>;

package/dist/scheduler/store.js

@@ -0,0 +1,94 @@
+/**
+ * Schedule 文件存储（P2-7）
+ *
+ * schedulesDir 布局：
+ *   <id>.json          Schedule 配置（工具管理；点开头文件被忽略）
+ *   .cursor.json       触发游标 { [id]: lastSlotEpochMs }（原子写）
+ *   runs/<id>.json     该 id 的触发记录（新的在前，上限 50 条，原子写）
+ *
+ * 纪律：Core 侧模块，禁止 import OpenCode API（架构不变量）。
+ */
+import { mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+const RUNS_KEEP = 50;
+/** 原子写（tmp + rename；与 journal 同纪律——绝不写半截文件） */
+async function atomicWrite(file, content) {
+    await mkdir(path.dirname(file), { recursive: true });
+    const tmp = `${file}.tmp-${process.pid}-${Date.now().toString(36)}`;
+    await writeFile(tmp, content, "utf8");
+    await rename(tmp, file);
+}
+async function readJson(file) {
+    try {
+        return JSON.parse(await readFile(file, "utf8"));
+    }
+    catch {
+        return undefined; // 不存在或坏 JSON：视为无（工具层对配置文件报错，游标自愈）
+    }
+}
+/** 全部 Schedule（按 id 排序；点开头与 runs/ 不算配置） */
+export async function listSchedules(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return []; // 目录不存在 = 无定时任务
+    }
+    const schedules = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json") || entry.startsWith("."))
+            continue;
+        const parsed = (await readJson(path.join(dir, entry)));
+        if (parsed && typeof parsed.id === "string" && typeof parsed.flow === "string") {
+            schedules.push(parsed);
+        }
+    }
+    return schedules.sort((a, b) => a.id.localeCompare(b.id));
+}
+export async function getSchedule(dir, id) {
+    const parsed = (await readJson(path.join(dir, `${id}.json`)));
+    return parsed && parsed.id === id ? parsed : undefined;
+}
+export async function saveSchedule(dir, schedule) {
+    await atomicWrite(path.join(dir, `${schedule.id}.json`), JSON.stringify(schedule, null, 2) + "\n");
+}
+/** 删除配置 + 该 id 的游标与记录 */
+export async function deleteSchedule(dir, id) {
+    await rm(path.join(dir, `${id}.json`), { force: true });
+    await rm(path.join(dir, "runs", `${id}.json`), { force: true });
+    const cursor = (await readJson(path.join(dir, ".cursor.json")));
+    if (cursor && id in cursor) {
+        delete cursor[id];
+        await atomicWrite(path.join(dir, ".cursor.json"), JSON.stringify(cursor, null, 2) + "\n");
+    }
+}
+/** 触发游标：id -> 已消费的 slot epoch ms */
+export async function readCursor(dir) {
+    return (await readJson(path.join(dir, ".cursor.json"))) ?? {};
+}
+export async function writeCursor(dir, cursor) {
+    await atomicWrite(path.join(dir, ".cursor.json"), JSON.stringify(cursor, null, 2) + "\n");
+}
+/** 某 id 的触发记录（新的在前） */
+export async function listRuns(dir, id) {
+    return (await readJson(path.join(dir, "runs", `${id}.json`))) ?? [];
+}
+/** 追加一条记录（新的在前，上限 50 条截断） */
+export async function appendRun(dir, id, run) {
+    const existing = await listRuns(dir, id);
+    const next = [run, ...existing].slice(0, RUNS_KEEP);
+    await atomicWrite(path.join(dir, "runs", `${id}.json`), JSON.stringify(next, null, 2) + "\n");
+}
+/** 按 slotEpoch + trigger 定位记录并更新（服务在 run 收口时改状态） */
+export async function updateRun(dir, id, slotEpoch, trigger, patch) {
+    const runs = await listRuns(dir, id);
+    const index = runs.findIndex((r) => r.slotEpoch === slotEpoch && r.trigger === trigger);
+    if (index === -1)
+        return undefined;
+    const updated = { ...runs[index], ...patch };
+    runs[index] = updated;
+    await atomicWrite(path.join(dir, "runs", `${id}.json`), JSON.stringify(runs, null, 2) + "\n");
+    return updated;
+}
+//# sourceMappingURL=store.js.map

package/dist/scheduler/store.js.map

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