conatus 0.1.0

package/dist/drive-scorer.js

@@ -0,0 +1,235 @@
+import { DriveConfigSchema } from "./types/drive.js";
+/**
+ * DriveScorer implements the three-drive scoring pipeline defined in drive-scoring.md:
+ *   Dissatisfaction Drive × Deadline Drive × Opportunity Drive → combined DriveScore
+ *
+ * All functions are pure (no side effects).
+ *
+ * Key design constraints:
+ * - Input is normalized_weighted_gap from GapCalculator pipeline ([0, 1]).
+ * - Final score = max(dissatisfaction, deadline, opportunity).
+ * - Deadline urgency override kicks in when urgency >= urgency_override_threshold.
+ */
+// ─── Default Config ───
+function defaultConfig() {
+    return DriveConfigSchema.parse({});
+}
+// ─── Helpers ───
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+// ─── Dissatisfaction Drive ───
+/**
+ * Score the dissatisfaction drive for a single dimension.
+ *
+ * Formula from drive-scoring.md section 1:
+ *   decay_factor(t) = decay_floor + (1 - decay_floor) × (1 - exp(-t / recovery_time))
+ *   score = normalized_weighted_gap × decay_factor
+ *
+ * At t=0: decay_factor = decay_floor (floor, not zero)
+ * At t→∞: decay_factor → 1.0 (full weight recovered)
+ *
+ * @param normalizedWeightedGap - pipeline output from GapCalculator [0, 1+]
+ * @param timeSinceLastAttemptHours - hours elapsed since last attempt (>= 0)
+ * @param config - optional drive configuration
+ */
+export function scoreDissatisfaction(normalizedWeightedGap, timeSinceLastAttemptHours, config) {
+    const cfg = config ?? defaultConfig();
+    const { decay_floor, recovery_time_hours } = cfg;
+    const t = Math.max(0, timeSinceLastAttemptHours);
+    const decayFactor = decay_floor + (1 - decay_floor) * (1 - Math.exp(-t / recovery_time_hours));
+    const score = normalizedWeightedGap * decayFactor;
+    return {
+        dimension_name: "",
+        normalized_weighted_gap: normalizedWeightedGap,
+        decay_factor: decayFactor,
+        score,
+    };
+}
+// ─── Deadline Drive ───
+/**
+ * Score the deadline drive for a single dimension.
+ *
+ * Formula from drive-scoring.md section 2:
+ *   urgency(T) = exp(urgency_steepness × (1 - T / deadline_horizon))
+ *   score = normalized_weighted_gap × urgency
+ *
+ * Special cases:
+ *   T >= deadline_horizon → urgency = 1.0
+ *   T < 0 (overdue)       → score = cap (urgency at T=0)
+ *   deadline = null        → score = 0, urgency = 0
+ *
+ * @param normalizedWeightedGap - pipeline output from GapCalculator [0, 1+]
+ * @param timeRemainingHours - hours until deadline; null if no deadline; negative if overdue
+ * @param config - optional drive configuration
+ */
+export function scoreDeadline(normalizedWeightedGap, timeRemainingHours, config) {
+    const cfg = config ?? defaultConfig();
+    const { deadline_horizon_hours, urgency_steepness } = cfg;
+    if (timeRemainingHours === null) {
+        return {
+            dimension_name: "",
+            normalized_weighted_gap: normalizedWeightedGap,
+            urgency: 0,
+            score: 0,
+        };
+    }
+    // Cap value: urgency at T=0 (moment of deadline)
+    const urgencyAtZero = Math.exp(urgency_steepness * (1 - 0 / deadline_horizon_hours));
+    let urgency;
+    if (timeRemainingHours >= deadline_horizon_hours) {
+        // Far from deadline — urgency is at its minimum (1.0 by formula at T=horizon)
+        urgency = 1.0;
+    }
+    else if (timeRemainingHours < 0) {
+        // Overdue: cap at urgency computed at T=0
+        urgency = urgencyAtZero;
+    }
+    else {
+        urgency = Math.exp(urgency_steepness * (1 - timeRemainingHours / deadline_horizon_hours));
+    }
+    const score = normalizedWeightedGap * urgency;
+    return {
+        dimension_name: "",
+        normalized_weighted_gap: normalizedWeightedGap,
+        urgency,
+        score,
+    };
+}
+// ─── Opportunity Drive ───
+/**
+ * Score the opportunity drive for a single dimension.
+ *
+ * Formula from drive-scoring.md section 3:
+ *   freshness_decay(t) = exp(-ln(2) × t / half_life)
+ *   score = opportunity_value × freshness_decay
+ *
+ * @param opportunityValue - computed opportunity value [0.0, 2.0]
+ * @param timeSinceDetectedHours - hours elapsed since opportunity was detected
+ * @param config - optional drive configuration
+ */
+export function scoreOpportunity(opportunityValue, timeSinceDetectedHours, config) {
+    const cfg = config ?? defaultConfig();
+    const { half_life_hours } = cfg;
+    const t = Math.max(0, timeSinceDetectedHours);
+    const freshnessDecay = Math.exp((-Math.LN2 * t) / half_life_hours);
+    const score = opportunityValue * freshnessDecay;
+    return {
+        dimension_name: "",
+        opportunity_value: opportunityValue,
+        freshness_decay: freshnessDecay,
+        score,
+    };
+}
+// ─── Opportunity Value Computation ───
+/**
+ * Compute the opportunity value from its components.
+ *
+ * Formula from drive-scoring.md section 3:
+ *   value = downstream_impact × (1 + external_bonus + timing_bonus)
+ *
+ * @param downstreamImpact - fraction of dimensions that depend on this one [0.0, 1.0]
+ * @param externalBonus - bonus from event queue (0.0 | 0.25 | 0.5)
+ * @param timingBonus - bonus from LLM evaluation (0.0 | 0.25 | 0.5)
+ * @returns opportunity value in [0.0, 2.0]
+ */
+export function computeOpportunityValue(downstreamImpact, externalBonus, timingBonus) {
+    return downstreamImpact * (1 + externalBonus + timingBonus);
+}
+// ─── Score Combination ───
+/**
+ * Combine the three drive scores into a final DriveScore.
+ *
+ * Formula from drive-scoring.md:
+ *   final_score = max(dissatisfaction.score, deadline.score, opportunity.score)
+ *   dominant_drive = whichever drive had the max score
+ *
+ * Override: if deadline.urgency >= urgency_override_threshold:
+ *   final_score = deadline.score
+ *   dominant_drive = "deadline"
+ *
+ * @param dissatisfaction - result from scoreDissatisfaction
+ * @param deadline - result from scoreDeadline
+ * @param opportunity - result from scoreOpportunity
+ * @param config - optional drive configuration
+ */
+export function combineDriveScores(dissatisfaction, deadline, opportunity, config) {
+    const cfg = config ?? defaultConfig();
+    const { urgency_override_threshold } = cfg;
+    // Deadline urgency override takes precedence
+    if (deadline.urgency >= urgency_override_threshold) {
+        return {
+            dimension_name: dissatisfaction.dimension_name,
+            dissatisfaction: dissatisfaction.score,
+            deadline: deadline.score,
+            opportunity: opportunity.score,
+            final_score: deadline.score,
+            dominant_drive: "deadline",
+        };
+    }
+    // Normal case: max of the three scores
+    const scores = [
+        { drive: "dissatisfaction", value: dissatisfaction.score },
+        { drive: "deadline", value: deadline.score },
+        { drive: "opportunity", value: opportunity.score },
+    ];
+    let best = scores[0];
+    for (const s of scores) {
+        if (s.value > best.value) {
+            best = s;
+        }
+    }
+    return {
+        dimension_name: dissatisfaction.dimension_name,
+        dissatisfaction: dissatisfaction.score,
+        deadline: deadline.score,
+        opportunity: opportunity.score,
+        final_score: best.value,
+        dominant_drive: best.drive,
+    };
+}
+// ─── All Dimensions ───
+/**
+ * Score all dimensions in a GapVector using the provided context.
+ *
+ * For each dimension in gapVector.gaps:
+ *   1. Retrieve context (timeSinceLastAttempt, deadline, opportunity)
+ *   2. Compute all three drive scores
+ *   3. Combine into a DriveScore
+ *
+ * @param gapVector - output from GapCalculator.calculateGapVector
+ * @param context - per-dimension context (timings, deadlines, opportunities)
+ * @param config - optional drive configuration
+ */
+export function scoreAllDimensions(gapVector, context, config) {
+    return gapVector.gaps.map((weightedGap) => {
+        const dimName = weightedGap.dimension_name;
+        const nwg = weightedGap.normalized_weighted_gap;
+        const timeSince = context.time_since_last_attempt[dimName] ?? 0;
+        const deadline = context.deadlines[dimName] !== undefined
+            ? context.deadlines[dimName]
+            : null;
+        const opp = context.opportunities[dimName];
+        const dissatisfactionRaw = scoreDissatisfaction(nwg, timeSince, config);
+        const deadlineRaw = scoreDeadline(nwg, deadline, config);
+        const opportunityRaw = opp !== null && opp !== undefined
+            ? (() => {
+                const timeSinceDetected = (Date.now() - new Date(opp.detected_at).getTime()) / (1000 * 60 * 60);
+                return scoreOpportunity(opp.value, timeSinceDetected, config);
+            })()
+            : scoreOpportunity(0, 0, config);
+        const combined = combineDriveScores(dissatisfactionRaw, deadlineRaw, opportunityRaw, config);
+        return { ...combined, dimension_name: dimName };
+    });
+}
+// ─── Ranking ───
+/**
+ * Sort DriveScore array by final_score descending (highest priority first).
+ *
+ * @param scores - array of DriveScore objects
+ * @returns new array sorted by final_score descending
+ */
+export function rankDimensions(scores) {
+    return [...scores].sort((a, b) => b.final_score - a.final_score);
+}
+//# sourceMappingURL=drive-scorer.js.map

package/dist/drive-scorer.js.map

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

package/dist/drive-system.d.ts

@@ -0,0 +1,92 @@
+import type { MotivaEvent, GoalSchedule } from "./types/drive.js";
+import type { StateManager } from "./state-manager.js";
+/**
+ * DriveSystem handles lightweight activation checks (no LLM calls), event queue
+ * processing, and goal schedule management.
+ *
+ * File layout:
+ *   <baseDir>/events/*.json          — event queue
+ *   <baseDir>/events/archive/*.json  — processed events
+ *   <baseDir>/schedule/<goalId>.json — goal schedules
+ *
+ * Inactive goal statuses: "completed", "cancelled", "archived"
+ * All writes are atomic: write to .tmp file, then rename.
+ */
+export declare class DriveSystem {
+    private readonly baseDir;
+    private readonly stateManager;
+    private watcher;
+    private inMemoryQueue;
+    private onEventCallback;
+    constructor(stateManager: StateManager, options?: {
+        baseDir?: string;
+    });
+    private ensureDirectories;
+    private atomicWrite;
+    /**
+     * Lightweight check (no LLM). Returns true if any condition is met:
+     * 1. Event queue has unprocessed events for this goal
+     * 2. Schedule is due (next_check_at <= now)
+     * 3. Goal is not in a terminal status ("completed", "cancelled", "archived")
+     */
+    shouldActivate(goalId: string): boolean;
+    /**
+     * Read all JSON files from {baseDir}/events/ directory.
+     * Parse each as MotivaEvent. Return sorted by timestamp (oldest first).
+     * Skips files that fail to parse (logs a warning).
+     */
+    readEventQueue(): MotivaEvent[];
+    /**
+     * Move an event file from {baseDir}/events/{fileName} to
+     * {baseDir}/events/archive/{fileName}. Creates the archive dir if needed.
+     */
+    archiveEvent(eventFileName: string): void;
+    /**
+     * Read queue, archive each processed event, return the events.
+     */
+    processEvents(): MotivaEvent[];
+    /**
+     * Load schedule from {baseDir}/schedule/{goalId}.json.
+     * Returns null if no schedule exists or parsing fails.
+     */
+    getSchedule(goalId: string): GoalSchedule | null;
+    /**
+     * Save schedule atomically to {baseDir}/schedule/{goalId}.json.
+     */
+    updateSchedule(goalId: string, schedule: GoalSchedule): void;
+    /**
+     * Check if the schedule for a goal is due (next_check_at <= now).
+     * If no schedule exists, returns true (needs initial check).
+     */
+    isScheduleDue(goalId: string): boolean;
+    /**
+     * Create a new schedule with next_check_at = now + intervalHours.
+     */
+    createDefaultSchedule(goalId: string, intervalHours: number): GoalSchedule;
+    /**
+     * Sort goals by drive score (highest first).
+     * Goals without scores go last (in their original relative order).
+     */
+    prioritizeGoals(goalIds: string[], scores: Map<string, number>): string[];
+    /**
+     * Write an event file to the events directory.
+     * Public method used by EventServer to enqueue events via HTTP.
+     */
+    writeEvent(event: MotivaEvent): void;
+    /**
+     * Start watching the events directory for new event files.
+     * When a new .json file appears, parse it and push it to the in-memory queue.
+     * Optionally calls onEvent callback immediately on each new event.
+     */
+    startWatcher(onEvent?: (event: MotivaEvent) => void): void;
+    /**
+     * Stop watching the events directory and clear the callback.
+     */
+    stopWatcher(): void;
+    /**
+     * Return all events accumulated in the in-memory queue since the last drain,
+     * and clear the queue.
+     */
+    drainInMemoryQueue(): MotivaEvent[];
+}
+//# sourceMappingURL=drive-system.d.ts.map

package/dist/drive-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-system.d.ts","sourceRoot":"","sources":["../src/drive-system.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,eAAe,CAA+C;gBAE1D,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAWtE,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,WAAW;IAQnB;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAkCvC;;;;OAIG;IACH,cAAc,IAAI,WAAW,EAAE;IA6C/B;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,aAAa,IAAI,WAAW,EAAE;IA+C9B;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAehD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQ5D;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAStC;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY;IAgB1E;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE;IAqBzE;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAUpC;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAwB1D;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;;OAGG;IACH,kBAAkB,IAAI,WAAW,EAAE;CAKpC"}

package/dist/drive-system.js

@@ -0,0 +1,325 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { MotivaEventSchema, GoalScheduleSchema } from "./types/drive.js";
+/**
+ * DriveSystem handles lightweight activation checks (no LLM calls), event queue
+ * processing, and goal schedule management.
+ *
+ * File layout:
+ *   <baseDir>/events/*.json          — event queue
+ *   <baseDir>/events/archive/*.json  — processed events
+ *   <baseDir>/schedule/<goalId>.json — goal schedules
+ *
+ * Inactive goal statuses: "completed", "cancelled", "archived"
+ * All writes are atomic: write to .tmp file, then rename.
+ */
+export class DriveSystem {
+    baseDir;
+    stateManager;
+    watcher = null;
+    inMemoryQueue = [];
+    onEventCallback = null;
+    constructor(stateManager, options) {
+        this.stateManager = stateManager;
+        this.baseDir = options?.baseDir ?? stateManager.getBaseDir();
+        this.watcher = null;
+        this.inMemoryQueue = [];
+        this.onEventCallback = null;
+        this.ensureDirectories();
+    }
+    // ─── Directory Management ───
+    ensureDirectories() {
+        const dirs = [
+            path.join(this.baseDir, "events"),
+            path.join(this.baseDir, "events", "archive"),
+            path.join(this.baseDir, "schedule"),
+        ];
+        for (const dir of dirs) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    // ─── Atomic Write ───
+    atomicWrite(filePath, data) {
+        const tmpPath = filePath + ".tmp";
+        fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+        fs.renameSync(tmpPath, filePath);
+    }
+    // ─── Activation Check ───
+    /**
+     * Lightweight check (no LLM). Returns true if any condition is met:
+     * 1. Event queue has unprocessed events for this goal
+     * 2. Schedule is due (next_check_at <= now)
+     * 3. Goal is not in a terminal status ("completed", "cancelled", "archived")
+     */
+    shouldActivate(goalId) {
+        // Check goal status — terminal statuses suppress activation
+        const goal = this.stateManager.loadGoal(goalId);
+        if (goal !== null) {
+            if (goal.status === "completed" ||
+                goal.status === "cancelled" ||
+                goal.status === "archived") {
+                return false;
+            }
+        }
+        // Check event queue for events targeting this goal
+        const events = this.readEventQueue();
+        if (events.length > 0) {
+            const hasGoalEvent = events.some((e) => e.data["goal_id"] === goalId || e.data["target_goal_id"] === goalId);
+            if (hasGoalEvent) {
+                return true;
+            }
+        }
+        // Check if schedule is due
+        if (this.isScheduleDue(goalId)) {
+            return true;
+        }
+        return false;
+    }
+    // ─── Event Queue ───
+    /**
+     * Read all JSON files from {baseDir}/events/ directory.
+     * Parse each as MotivaEvent. Return sorted by timestamp (oldest first).
+     * Skips files that fail to parse (logs a warning).
+     */
+    readEventQueue() {
+        const eventsDir = path.join(this.baseDir, "events");
+        if (!fs.existsSync(eventsDir)) {
+            return [];
+        }
+        let fileNames;
+        try {
+            fileNames = fs.readdirSync(eventsDir).filter((f) => f.endsWith(".json"));
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const fileName of fileNames) {
+            const filePath = path.join(eventsDir, fileName);
+            // Skip directories (e.g., the archive subdirectory)
+            try {
+                const stat = fs.statSync(filePath);
+                if (!stat.isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            try {
+                const content = fs.readFileSync(filePath, "utf-8");
+                const raw = JSON.parse(content);
+                const event = MotivaEventSchema.parse(raw);
+                events.push(event);
+            }
+            catch (err) {
+                console.warn(`DriveSystem: skipping invalid event file "${fileName}": ${err}`);
+            }
+        }
+        // Sort oldest first by timestamp
+        events.sort((a, b) => {
+            const ta = new Date(a.timestamp).getTime();
+            const tb = new Date(b.timestamp).getTime();
+            return ta - tb;
+        });
+        return events;
+    }
+    /**
+     * Move an event file from {baseDir}/events/{fileName} to
+     * {baseDir}/events/archive/{fileName}. Creates the archive dir if needed.
+     */
+    archiveEvent(eventFileName) {
+        const srcPath = path.join(this.baseDir, "events", eventFileName);
+        const archiveDir = path.join(this.baseDir, "events", "archive");
+        fs.mkdirSync(archiveDir, { recursive: true });
+        const dstPath = path.join(archiveDir, eventFileName);
+        fs.renameSync(srcPath, dstPath);
+    }
+    /**
+     * Read queue, archive each processed event, return the events.
+     */
+    processEvents() {
+        const eventsDir = path.join(this.baseDir, "events");
+        if (!fs.existsSync(eventsDir)) {
+            return [];
+        }
+        let fileNames;
+        try {
+            fileNames = fs.readdirSync(eventsDir).filter((f) => f.endsWith(".json"));
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const fileName of fileNames) {
+            const filePath = path.join(eventsDir, fileName);
+            try {
+                const stat = fs.statSync(filePath);
+                if (!stat.isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            try {
+                const content = fs.readFileSync(filePath, "utf-8");
+                const raw = JSON.parse(content);
+                const event = MotivaEventSchema.parse(raw);
+                this.archiveEvent(fileName);
+                events.push(event);
+            }
+            catch (err) {
+                console.warn(`DriveSystem: skipping invalid event file "${fileName}" during processEvents: ${err}`);
+            }
+        }
+        // Sort oldest first by timestamp
+        events.sort((a, b) => {
+            const ta = new Date(a.timestamp).getTime();
+            const tb = new Date(b.timestamp).getTime();
+            return ta - tb;
+        });
+        return events;
+    }
+    // ─── Schedule Management ───
+    /**
+     * Load schedule from {baseDir}/schedule/{goalId}.json.
+     * Returns null if no schedule exists or parsing fails.
+     */
+    getSchedule(goalId) {
+        const filePath = path.join(this.baseDir, "schedule", `${goalId}.json`);
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            const raw = JSON.parse(content);
+            return GoalScheduleSchema.parse(raw);
+        }
+        catch (err) {
+            if (typeof err === "object" && err !== null && "code" in err && err.code === "ENOENT") {
+                return null;
+            }
+            console.warn(`DriveSystem: failed to load schedule for goal "${goalId}": ${err}`);
+            return null;
+        }
+    }
+    /**
+     * Save schedule atomically to {baseDir}/schedule/{goalId}.json.
+     */
+    updateSchedule(goalId, schedule) {
+        const scheduleDir = path.join(this.baseDir, "schedule");
+        fs.mkdirSync(scheduleDir, { recursive: true });
+        const validated = GoalScheduleSchema.parse(schedule);
+        const filePath = path.join(scheduleDir, `${goalId}.json`);
+        this.atomicWrite(filePath, validated);
+    }
+    /**
+     * Check if the schedule for a goal is due (next_check_at <= now).
+     * If no schedule exists, returns true (needs initial check).
+     */
+    isScheduleDue(goalId) {
+        const schedule = this.getSchedule(goalId);
+        if (schedule === null) {
+            return true;
+        }
+        const nextCheckAt = new Date(schedule.next_check_at).getTime();
+        return nextCheckAt <= Date.now();
+    }
+    /**
+     * Create a new schedule with next_check_at = now + intervalHours.
+     */
+    createDefaultSchedule(goalId, intervalHours) {
+        const now = new Date();
+        const nextCheckAt = new Date(now.getTime() + intervalHours * 60 * 60 * 1000);
+        return GoalScheduleSchema.parse({
+            goal_id: goalId,
+            next_check_at: nextCheckAt.toISOString(),
+            check_interval_hours: intervalHours,
+            last_triggered_at: null,
+            consecutive_actions: 0,
+            cooldown_until: null,
+            current_interval_hours: intervalHours,
+        });
+    }
+    // ─── Multi-Goal Prioritization ───
+    /**
+     * Sort goals by drive score (highest first).
+     * Goals without scores go last (in their original relative order).
+     */
+    prioritizeGoals(goalIds, scores) {
+        const withScore = [];
+        const withoutScore = [];
+        for (const id of goalIds) {
+            const score = scores.get(id);
+            if (score !== undefined) {
+                withScore.push({ id, score });
+            }
+            else {
+                withoutScore.push(id);
+            }
+        }
+        // Sort descending by score (stable sort preserves original order for ties)
+        withScore.sort((a, b) => b.score - a.score);
+        return [...withScore.map((g) => g.id), ...withoutScore];
+    }
+    // ─── Event Writing & Real-Time Watching ───
+    /**
+     * Write an event file to the events directory.
+     * Public method used by EventServer to enqueue events via HTTP.
+     */
+    writeEvent(event) {
+        const eventsDir = path.join(this.baseDir, "events");
+        fs.mkdirSync(eventsDir, { recursive: true });
+        const filename = `event_${Date.now()}_${Math.random().toString(36).slice(2, 8)}.json`;
+        const filePath = path.join(eventsDir, filename);
+        const tmpPath = filePath + ".tmp";
+        fs.writeFileSync(tmpPath, JSON.stringify(event, null, 2), "utf-8");
+        fs.renameSync(tmpPath, filePath);
+    }
+    /**
+     * Start watching the events directory for new event files.
+     * When a new .json file appears, parse it and push it to the in-memory queue.
+     * Optionally calls onEvent callback immediately on each new event.
+     */
+    startWatcher(onEvent) {
+        this.onEventCallback = onEvent ?? null;
+        const eventsDir = path.join(this.baseDir, "events");
+        fs.mkdirSync(eventsDir, { recursive: true });
+        this.watcher = fs.watch(eventsDir, (eventType, filename) => {
+            if (eventType !== "rename" || !filename?.endsWith(".json"))
+                return;
+            if (filename.endsWith(".tmp"))
+                return;
+            const filePath = path.join(eventsDir, filename);
+            try {
+                if (!fs.existsSync(filePath))
+                    return;
+                const content = fs.readFileSync(filePath, "utf-8");
+                const event = MotivaEventSchema.parse(JSON.parse(content));
+                this.inMemoryQueue.push(event);
+                if (this.onEventCallback) {
+                    this.onEventCallback(event);
+                }
+            }
+            catch {
+                // Ignore invalid event files
+            }
+        });
+    }
+    /**
+     * Stop watching the events directory and clear the callback.
+     */
+    stopWatcher() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        this.onEventCallback = null;
+    }
+    /**
+     * Return all events accumulated in the in-memory queue since the last drain,
+     * and clear the queue.
+     */
+    drainInMemoryQueue() {
+        const events = [...this.inMemoryQueue];
+        this.inMemoryQueue = [];
+        return events;
+    }
+}
+//# sourceMappingURL=drive-system.js.map