pulseed 0.1.2 → 0.1.4

package/dist/reflection/morning-planning.js

@@ -0,0 +1,107 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { writeJsonFileAtomic } from "../utils/json-io.js";
+import { z } from "zod";
+import { PlanningReportSchema } from "./types.js";
+// ─── LLM response schema ───
+const LLMPlanningResponseSchema = z.object({
+    priorities: z.array(z.object({
+        goal_id: z.string(),
+        priority: z.enum(["high", "medium", "low"]),
+        reasoning: z.string(),
+    })),
+    suggestions: z.array(z.string()).default([]),
+    concerns: z.array(z.string()).default([]),
+});
+// ─── Helpers ───
+function todayISO() {
+    return new Date().toISOString().slice(0, 10);
+}
+function aggregateGapScore(gaps) {
+    if (gaps.length === 0)
+        return 0;
+    return Math.max(...gaps.map((g) => g.normalized_weighted_gap));
+}
+async function buildGoalSummaries(stateManager) {
+    const goalIds = await stateManager.listGoalIds();
+    const summaries = [];
+    for (const id of goalIds) {
+        const goal = await stateManager.loadGoal(id);
+        if (!goal || goal.status !== "active")
+            continue;
+        const gapHistory = await stateManager.loadGapHistory(id);
+        const latest = gapHistory.at(-1);
+        const gapScore = latest ? aggregateGapScore(latest.gap_vector) : 0;
+        summaries.push({
+            goal_id: goal.id,
+            title: goal.title,
+            status: goal.status,
+            gap_score: Math.min(1, Math.max(0, gapScore)),
+            stall_level: 0,
+            dimensions_count: goal.dimensions.length,
+        });
+    }
+    return summaries;
+}
+// ─── Main ───
+export async function runMorningPlanning(deps) {
+    const { stateManager, llmClient, baseDir, notificationDispatcher, hookManager } = deps;
+    const date = todayISO();
+    const now = new Date().toISOString();
+    const goalSummaries = await buildGoalSummaries(stateManager);
+    let priorities = [];
+    let suggestions = [];
+    let concerns = [];
+    if (goalSummaries.length > 0) {
+        const prompt = `You are PulSeed's morning planner. Review these active goals and create a daily plan.
+
+Goals:
+${JSON.stringify(goalSummaries, null, 2)}
+
+For each goal, assign priority (high/medium/low) with reasoning.
+List any suggestions for new actions or concerns.
+
+Respond with JSON matching this schema:
+{ "priorities": [{"goal_id": string, "priority": "high"|"medium"|"low", "reasoning": string}], "suggestions": [string], "concerns": [string] }`;
+        try {
+            const response = await llmClient.sendMessage([{ role: "user", content: prompt }]);
+            const parsed = llmClient.parseJSON(response.content, LLMPlanningResponseSchema);
+            priorities = parsed.priorities;
+            suggestions = parsed.suggestions ?? [];
+            concerns = parsed.concerns ?? [];
+        }
+        catch {
+            // LLM error — return partial report with empty priorities
+        }
+    }
+    const report = PlanningReportSchema.parse({
+        date,
+        created_at: now,
+        goals_reviewed: goalSummaries.length,
+        priorities,
+        suggestions,
+        concerns,
+    });
+    // Persist report
+    const reflectionsDir = path.join(baseDir, "reflections");
+    await fsp.mkdir(reflectionsDir, { recursive: true });
+    await writeJsonFileAtomic(path.join(reflectionsDir, `morning-${date}.json`), report);
+    void hookManager?.emit("ReflectionComplete", { data: { type: "morning_planning" } });
+    // Notify
+    if (notificationDispatcher && goalSummaries.length > 0) {
+        const now2 = new Date().toISOString();
+        await notificationDispatcher.dispatch({
+            id: `morning-planning-${date}`,
+            report_type: "daily_summary",
+            goal_id: null,
+            title: `Morning Planning — ${date}`,
+            content: `Reviewed ${goalSummaries.length} goals. ${concerns.length} concern(s).`,
+            verbosity: "standard",
+            generated_at: now2,
+            delivered_at: null,
+            read: false,
+        });
+    }
+    return report;
+}
+//# sourceMappingURL=morning-planning.js.map

package/dist/reflection/morning-planning.js.map

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

package/dist/reflection/types.d.ts

@@ -0,0 +1,168 @@
+import { z } from "zod";
+export declare const GoalSummarySchema: z.ZodObject<{
+    goal_id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodString;
+    gap_score: z.ZodNumber;
+    stall_level: z.ZodNumber;
+    dimensions_count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    title: string;
+    goal_id: string;
+    gap_score: number;
+    stall_level: number;
+    dimensions_count: number;
+}, {
+    status: string;
+    title: string;
+    goal_id: string;
+    gap_score: number;
+    stall_level: number;
+    dimensions_count: number;
+}>;
+export type GoalSummary = z.infer<typeof GoalSummarySchema>;
+export declare const PlanningReportSchema: z.ZodObject<{
+    date: z.ZodString;
+    created_at: z.ZodString;
+    goals_reviewed: z.ZodNumber;
+    priorities: z.ZodArray<z.ZodObject<{
+        goal_id: z.ZodString;
+        priority: z.ZodEnum<["high", "medium", "low"]>;
+        reasoning: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        goal_id: string;
+        reasoning: string;
+        priority: "low" | "high" | "medium";
+    }, {
+        goal_id: string;
+        reasoning: string;
+        priority: "low" | "high" | "medium";
+    }>, "many">;
+    suggestions: z.ZodArray<z.ZodString, "many">;
+    concerns: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    date: string;
+    created_at: string;
+    suggestions: string[];
+    goals_reviewed: number;
+    priorities: {
+        goal_id: string;
+        reasoning: string;
+        priority: "low" | "high" | "medium";
+    }[];
+    concerns: string[];
+}, {
+    date: string;
+    created_at: string;
+    suggestions: string[];
+    goals_reviewed: number;
+    priorities: {
+        goal_id: string;
+        reasoning: string;
+        priority: "low" | "high" | "medium";
+    }[];
+    concerns: string[];
+}>;
+export type PlanningReport = z.infer<typeof PlanningReportSchema>;
+export declare const CatchupReportSchema: z.ZodObject<{
+    date: z.ZodString;
+    created_at: z.ZodString;
+    goals_reviewed: z.ZodNumber;
+    progress_summary: z.ZodString;
+    completions: z.ZodArray<z.ZodString, "many">;
+    stalls: z.ZodArray<z.ZodString, "many">;
+    concerns: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    date: string;
+    created_at: string;
+    stalls: string[];
+    goals_reviewed: number;
+    concerns: string[];
+    progress_summary: string;
+    completions: string[];
+}, {
+    date: string;
+    created_at: string;
+    stalls: string[];
+    goals_reviewed: number;
+    concerns: string[];
+    progress_summary: string;
+    completions: string[];
+}>;
+export type CatchupReport = z.infer<typeof CatchupReportSchema>;
+export declare const ConsolidationReportSchema: z.ZodObject<{
+    date: z.ZodString;
+    created_at: z.ZodString;
+    goals_consolidated: z.ZodNumber;
+    entries_compressed: z.ZodNumber;
+    stale_entries_found: z.ZodNumber;
+    revalidation_tasks_created: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    date: string;
+    created_at: string;
+    entries_compressed: number;
+    goals_consolidated: number;
+    stale_entries_found: number;
+    revalidation_tasks_created: number;
+}, {
+    date: string;
+    created_at: string;
+    entries_compressed: number;
+    goals_consolidated: number;
+    stale_entries_found: number;
+    revalidation_tasks_created: number;
+}>;
+export type ConsolidationReport = z.infer<typeof ConsolidationReportSchema>;
+export declare const WeeklyReviewReportSchema: z.ZodObject<{
+    week: z.ZodString;
+    created_at: z.ZodString;
+    goals_reviewed: z.ZodNumber;
+    rankings: z.ZodArray<z.ZodObject<{
+        goal_id: z.ZodString;
+        progress_rate: z.ZodNumber;
+        strategy_effectiveness: z.ZodEnum<["high", "medium", "low"]>;
+        recommendation: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        goal_id: string;
+        progress_rate: number;
+        strategy_effectiveness: "low" | "high" | "medium";
+        recommendation: string;
+    }, {
+        goal_id: string;
+        progress_rate: number;
+        strategy_effectiveness: "low" | "high" | "medium";
+        recommendation: string;
+    }>, "many">;
+    suggested_additions: z.ZodArray<z.ZodString, "many">;
+    suggested_removals: z.ZodArray<z.ZodString, "many">;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    summary: string;
+    goals_reviewed: number;
+    week: string;
+    rankings: {
+        goal_id: string;
+        progress_rate: number;
+        strategy_effectiveness: "low" | "high" | "medium";
+        recommendation: string;
+    }[];
+    suggested_additions: string[];
+    suggested_removals: string[];
+}, {
+    created_at: string;
+    summary: string;
+    goals_reviewed: number;
+    week: string;
+    rankings: {
+        goal_id: string;
+        progress_rate: number;
+        strategy_effectiveness: "low" | "high" | "medium";
+        recommendation: string;
+    }[];
+    suggested_additions: string[];
+    suggested_removals: string[];
+}>;
+export type WeeklyReviewReport = z.infer<typeof WeeklyReviewReportSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/reflection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reflection/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAenC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/reflection/types.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+// ─── GoalSummary ───
+export const GoalSummarySchema = z.object({
+    goal_id: z.string(),
+    title: z.string(),
+    status: z.string(),
+    gap_score: z.number().min(0).max(1),
+    stall_level: z.number().int().min(0).max(3),
+    dimensions_count: z.number().int().min(0),
+});
+// ─── PlanningReport ───
+export const PlanningReportSchema = z.object({
+    date: z.string(),
+    created_at: z.string(),
+    goals_reviewed: z.number().int().min(0),
+    priorities: z.array(z.object({
+        goal_id: z.string(),
+        priority: z.enum(["high", "medium", "low"]),
+        reasoning: z.string(),
+    })),
+    suggestions: z.array(z.string()),
+    concerns: z.array(z.string()),
+});
+// ─── CatchupReport ───
+export const CatchupReportSchema = z.object({
+    date: z.string(),
+    created_at: z.string(),
+    goals_reviewed: z.number().int().min(0),
+    progress_summary: z.string(),
+    completions: z.array(z.string()),
+    stalls: z.array(z.string()),
+    concerns: z.array(z.string()),
+});
+// ─── ConsolidationReport ───
+export const ConsolidationReportSchema = z.object({
+    date: z.string(),
+    created_at: z.string(),
+    goals_consolidated: z.number().int().min(0),
+    entries_compressed: z.number().int().min(0),
+    stale_entries_found: z.number().int().min(0),
+    revalidation_tasks_created: z.number().int().min(0),
+});
+// ─── WeeklyReviewReport ───
+export const WeeklyReviewReportSchema = z.object({
+    week: z.string(),
+    created_at: z.string(),
+    goals_reviewed: z.number().int().min(0),
+    rankings: z.array(z.object({
+        goal_id: z.string(),
+        progress_rate: z.number().min(0).max(1),
+        strategy_effectiveness: z.enum(["high", "medium", "low"]),
+        recommendation: z.string(),
+    })),
+    suggested_additions: z.array(z.string()),
+    suggested_removals: z.array(z.string()),
+    summary: z.string(),
+});
+//# sourceMappingURL=types.js.map

package/dist/reflection/types.js.map

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

package/dist/reflection/weekly-review.d.ts

@@ -0,0 +1,11 @@
+import type { StateManager } from "../state-manager.js";
+import type { ILLMClient } from "../llm/llm-client.js";
+import type { INotificationDispatcher } from "../runtime/notification-dispatcher.js";
+import type { WeeklyReviewReport } from "./types.js";
+export declare function runWeeklyReview(deps: {
+    stateManager: StateManager;
+    llmClient: ILLMClient;
+    baseDir: string;
+    notificationDispatcher?: INotificationDispatcher;
+}): Promise<WeeklyReviewReport>;
+//# sourceMappingURL=weekly-review.d.ts.map

package/dist/reflection/weekly-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly-review.d.ts","sourceRoot":"","sources":["../../src/reflection/weekly-review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA4CrD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,uBAAuB,CAAC;CAClD,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwF9B"}

package/dist/reflection/weekly-review.js

@@ -0,0 +1,114 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { writeJsonFileAtomic } from "../utils/json-io.js";
+import { z } from "zod";
+import { WeeklyReviewReportSchema } from "./types.js";
+// ─── LLM response schema ───
+const LLMWeeklyResponseSchema = z.object({
+    rankings: z.array(z.object({
+        goal_id: z.string(),
+        progress_rate: z.number().min(0).max(1),
+        strategy_effectiveness: z.enum(["high", "medium", "low"]),
+        recommendation: z.string(),
+    })),
+    suggested_additions: z.array(z.string()).default([]),
+    suggested_removals: z.array(z.string()).default([]),
+    summary: z.string(),
+});
+// ─── Helpers ───
+function getISOWeek(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const day = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - day);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    return `${d.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+}
+function computeWeeklyDelta(gapHistory) {
+    if (gapHistory.length < 2)
+        return 0;
+    const recent = gapHistory.at(-1);
+    const prior = gapHistory.at(-2);
+    const latest = Math.max(...recent.gap_vector.map((g) => g.normalized_weighted_gap));
+    const previous = Math.max(...prior.gap_vector.map((g) => g.normalized_weighted_gap));
+    // positive delta = gap is closing (progress)
+    return Math.min(1, Math.max(0, previous - latest));
+}
+// ─── Main ───
+export async function runWeeklyReview(deps) {
+    const { stateManager, llmClient, baseDir, notificationDispatcher } = deps;
+    const now = new Date().toISOString();
+    const week = getISOWeek(new Date());
+    // Build per-goal summaries
+    const goalIds = await stateManager.listGoalIds();
+    const goalSummaries = [];
+    for (const id of goalIds) {
+        const goal = await stateManager.loadGoal(id);
+        if (!goal || goal.status !== "active")
+            continue;
+        const gapHistory = await stateManager.loadGapHistory(id);
+        const weekly_delta = computeWeeklyDelta(gapHistory);
+        goalSummaries.push({
+            goal_id: goal.id,
+            title: goal.title,
+            weekly_delta,
+        });
+    }
+    let rankings = [];
+    let suggested_additions = [];
+    let suggested_removals = [];
+    let summary = "";
+    if (goalSummaries.length > 0) {
+        const prompt = `You are PulSeed's weekly reviewer. Analyze this week's goal progress and provide a strategic review.
+
+Goals (weekly_delta = how much gap closed this week, 0-1):
+${JSON.stringify(goalSummaries, null, 2)}
+
+Rank each goal by progress_rate (0-1). Assess strategy_effectiveness (high/medium/low).
+Suggest new goal additions or removals where appropriate.
+Write a brief summary of the week.
+
+Respond with JSON matching this schema:
+{ "rankings": [{"goal_id": string, "progress_rate": number, "strategy_effectiveness": "high"|"medium"|"low", "recommendation": string}], "suggested_additions": [string], "suggested_removals": [string], "summary": string }`;
+        try {
+            const response = await llmClient.sendMessage([{ role: "user", content: prompt }]);
+            const parsed = llmClient.parseJSON(response.content, LLMWeeklyResponseSchema);
+            rankings = parsed.rankings;
+            suggested_additions = parsed.suggested_additions ?? [];
+            suggested_removals = parsed.suggested_removals ?? [];
+            summary = parsed.summary;
+        }
+        catch {
+            // LLM error — return partial report with empty rankings
+        }
+    }
+    const report = WeeklyReviewReportSchema.parse({
+        week,
+        created_at: now,
+        goals_reviewed: goalSummaries.length,
+        rankings,
+        suggested_additions,
+        suggested_removals,
+        summary,
+    });
+    // Persist report
+    const reflectionsDir = path.join(baseDir, "reflections");
+    await fsp.mkdir(reflectionsDir, { recursive: true });
+    await writeJsonFileAtomic(path.join(reflectionsDir, `weekly-${week}.json`), report);
+    // Notify
+    if (notificationDispatcher && goalSummaries.length > 0) {
+        await notificationDispatcher.dispatch({
+            id: `weekly-review-${week}`,
+            report_type: "weekly_report",
+            goal_id: null,
+            title: `Weekly Review — ${week}`,
+            content: `Reviewed ${goalSummaries.length} goals. ${suggested_removals.length} removal(s) suggested.`,
+            verbosity: "standard",
+            generated_at: now,
+            delivered_at: null,
+            read: false,
+        });
+    }
+    return report;
+}
+//# sourceMappingURL=weekly-review.js.map

package/dist/reflection/weekly-review.js.map

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

package/dist/runtime/cron-scheduler.d.ts

@@ -0,0 +1,13 @@
+import { type CronTask } from "../types/cron.js";
+export declare class CronScheduler {
+    private tasksPath;
+    constructor(baseDir: string);
+    loadTasks(): Promise<CronTask[]>;
+    saveTasks(tasks: CronTask[]): Promise<void>;
+    addTask(task: Omit<CronTask, "id" | "created_at">): Promise<CronTask>;
+    removeTask(id: string): Promise<boolean>;
+    getDueTasks(): Promise<CronTask[]>;
+    markFired(id: string): Promise<void>;
+    expireOldTasks(): Promise<void>;
+}
+//# sourceMappingURL=cron-scheduler.d.ts.map

package/dist/runtime/cron-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-scheduler.d.ts","sourceRoot":"","sources":["../../src/runtime/cron-scheduler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMrF,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,MAAM;IAIrB,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOhC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYrE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxC,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAclC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAQtC"}

package/dist/runtime/cron-scheduler.js

@@ -0,0 +1,90 @@
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+import { CronExpressionParser } from "cron-parser";
+import { writeJsonFileAtomic, readJsonFileOrNull } from "../utils/json-io.js";
+import { CronTaskSchema, CronTaskListSchema } from "../types/cron.js";
+const TASKS_FILE = "scheduled-tasks.json";
+const EXPIRY_DAYS = 7;
+const JITTER_FACTOR = 0.05; // ±5%
+export class CronScheduler {
+    tasksPath;
+    constructor(baseDir) {
+        this.tasksPath = path.join(baseDir, TASKS_FILE);
+    }
+    async loadTasks() {
+        const raw = await readJsonFileOrNull(this.tasksPath);
+        if (raw === null)
+            return [];
+        const result = CronTaskListSchema.safeParse(raw);
+        return result.success ? result.data : [];
+    }
+    async saveTasks(tasks) {
+        await writeJsonFileAtomic(this.tasksPath, tasks);
+    }
+    async addTask(task) {
+        const tasks = await this.loadTasks();
+        const newTask = CronTaskSchema.parse({
+            ...task,
+            id: randomUUID(),
+            created_at: new Date().toISOString(),
+        });
+        tasks.push(newTask);
+        await this.saveTasks(tasks);
+        return newTask;
+    }
+    async removeTask(id) {
+        const tasks = await this.loadTasks();
+        const filtered = tasks.filter((t) => t.id !== id);
+        if (filtered.length === tasks.length)
+            return false;
+        await this.saveTasks(filtered);
+        return true;
+    }
+    async getDueTasks() {
+        const tasks = await this.loadTasks();
+        const now = new Date();
+        const due = [];
+        for (const task of tasks) {
+            if (!task.enabled)
+                continue;
+            if (!isDue(task, now))
+                continue;
+            due.push(task);
+        }
+        return due;
+    }
+    async markFired(id) {
+        const tasks = await this.loadTasks();
+        const updated = tasks.map((t) => t.id === id ? { ...t, last_fired_at: new Date().toISOString() } : t);
+        await this.saveTasks(updated);
+    }
+    async expireOldTasks() {
+        const tasks = await this.loadTasks();
+        const cutoff = Date.now() - EXPIRY_DAYS * 24 * 60 * 60 * 1000;
+        const kept = tasks.filter((t) => t.permanent || new Date(t.created_at).getTime() >= cutoff);
+        await this.saveTasks(kept);
+    }
+}
+// ─── Helpers ───
+function isDue(task, now) {
+    try {
+        const interval = CronExpressionParser.parse(task.cron, { currentDate: now });
+        const prevFire = interval.prev();
+        // Apply one-sided jitter: only moves adjustedPrev earlier, never later
+        const nextFire = interval.next();
+        const intervalMs = nextFire.getTime() - prevFire.getTime();
+        const jitterMs = -(intervalMs * JITTER_FACTOR * Math.random());
+        const adjustedPrev = new Date(prevFire.getTime() + jitterMs);
+        // If never fired, task is due if the adjusted prev fire is in the past
+        if (task.last_fired_at === null) {
+            return adjustedPrev.getTime() <= now.getTime();
+        }
+        // Task is due if it hasn't been fired since the last scheduled time
+        const lastFired = new Date(task.last_fired_at).getTime();
+        return lastFired < adjustedPrev.getTime();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cron-scheduler.js.map

package/dist/runtime/cron-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-scheduler.js","sourceRoot":"","sources":["../../src/runtime/cron-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAiB,MAAM,kBAAkB,CAAC;AAErF,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,MAAM;AAElC,MAAM,OAAO,aAAa;IAChB,SAAS,CAAS;IAE1B,YAAY,OAAe;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAiB;QAC/B,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAyC;QACrD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC;YACnC,GAAG,IAAI;YACP,EAAE,EAAE,UAAU,EAAE;YAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACnD,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAe,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,SAAS;YAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC;gBAAE,SAAS;YAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CACpE,CAAC;QACF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,IAAI,MAAM,CACjE,CAAC;QACF,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,kBAAkB;AAElB,SAAS,KAAK,CAAC,IAAc,EAAE,GAAS;IACtC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEjC,uEAAuE;QACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,GAAG,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;QAE7D,uEAAuE;QACvE,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACjD,CAAC;QAED,oEAAoE;QACpE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,OAAO,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}