@aitne/daemon 0.1.0

package/dist/db/managed-tasks-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-tasks-store.d.ts","sourceRoot":"","sources":["../../src/db/managed-tasks-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAmDvB;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,EAAE,CAWrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,GACT,WAAW,GAAG,IAAI,CAYpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAO/D;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CA+BvE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAWnE;AASD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,sBAAsB,GAC5B,WAAW,CA4Bb;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,GAC5B,WAAW,GAAG,IAAI,CAwBpB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GACA,WAAW,GAAG,IAAI,CAYpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAMT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,WAAW,GAAG,IAAI,CAYpB"}

package/dist/db/managed-tasks-store.js

@@ -0,0 +1,238 @@
+import { formatManagedTaskId, isValidManagedTaskId, managedTaskSchema, normalizeAppLabel, } from "@aitne/shared";
+function rowToManagedTask(row) {
+    // Re-validate on read so a manually-poked row cannot smuggle an
+    // invalid `output_path` (or any other field) into the renderer. The
+    // CHECK constraint already enforces the trailing-slash rule (§9.2);
+    // the Zod refinement covers the §9.1 enum invariants the SQL CHECK
+    // intentionally does not encode.
+    return managedTaskSchema.parse({
+        id: row.id,
+        intent: row.intent,
+        app: row.app,
+        app_normalized: row.app_normalized,
+        cadence: row.cadence,
+        output_path: row.output_path,
+        schedule_id: row.schedule_id,
+        last_run_at: row.last_run_at,
+        last_result: row.last_result,
+        consecutive_failures: row.consecutive_failures,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    });
+}
+/**
+ * List all active managed tasks ordered by numeric id ascending so the
+ * rendered table is deterministic across calls (NFR-2 idempotency: same
+ * DB → byte-identical render).
+ *
+ * Sorting on `CAST(SUBSTR(id, 4) AS INTEGER)` avoids string-compare
+ * surprises when the seq crosses 10/100/1000 boundaries (`mt_10` would
+ * sort before `mt_2` lexically).
+ */
+export function listManagedTasks(db) {
+    const rows = db
+        .prepare(`SELECT id, intent, app, app_normalized, cadence, output_path,
+              schedule_id, last_run_at, last_result, consecutive_failures,
+              created_at, updated_at
+         FROM managed_tasks
+         ORDER BY CAST(SUBSTR(id, 4) AS INTEGER) ASC`)
+        .all();
+    return rows.map(rowToManagedTask);
+}
+/**
+ * Read one managed task by id. Returns `null` when the id does not
+ * match `/^mt_[1-9]\d*$/` or when no row is present, so callers can
+ * cleanly distinguish "bad input" from "deleted".
+ */
+export function getManagedTask(db, id) {
+    if (!isValidManagedTaskId(id))
+        return null;
+    const row = db
+        .prepare(`SELECT id, intent, app, app_normalized, cadence, output_path,
+              schedule_id, last_run_at, last_result, consecutive_failures,
+              created_at, updated_at
+         FROM managed_tasks WHERE id = ?`)
+        .get(id);
+    if (!row)
+        return null;
+    return rowToManagedTask(row);
+}
+/**
+ * Total active managed-task count — surfaced by the §14.3
+ * `aitne_managed_tasks_active` gauge and the §13.2 cap check (returning
+ * 409 once the configured `managementMaxActiveTasks` is hit).
+ */
+export function countManagedTasks(db) {
+    // `COUNT(*)` always returns one row in SQLite, so the result is
+    // non-undefined by SQL semantics — no defensive `?? 0` needed.
+    const row = db
+        .prepare("SELECT COUNT(*) AS n FROM managed_tasks")
+        .get();
+    return row.n;
+}
+/**
+ * Allocate the next `mt_<n>` id atomically. Increments
+ * `managed_task_seq.next_id` and returns the formatted id. The caller
+ * MUST run this inside a transaction that also INSERTs the matching
+ * `managed_tasks` row, otherwise a crash between allocation and insert
+ * burns the id (which is fine — IDs are never reused) but a duplicate
+ * caller could race to allocate the same value if the UPDATE+SELECT
+ * are not in one statement. SQLite's `RETURNING` on UPDATE is exactly
+ * that single statement.
+ *
+ * The boot-side reconciler invokes `bootstrapNextManagedTaskId` instead
+ * to pre-seed the counter from the max existing id — restoring from a
+ * backup whose `data.db` carries higher mt_ids than the seed value
+ * would otherwise collide on the next allocate. A simple call (without
+ * `bootstrap=true`) does not consult `MAX(...)` because the per-call
+ * cost is unnecessary at steady state.
+ */
+export function allocateNextManagedTaskId(db) {
+    const row = db
+        .prepare(`UPDATE managed_task_seq
+          SET next_id = next_id + 1
+        WHERE singleton = 1
+        RETURNING next_id`)
+        .get();
+    if (!row) {
+        // The schema seeds `(singleton=1, next_id=1)` and the row is
+        // protected by the `CHECK (singleton = 1)` PK; a missing row means
+        // someone has manually wiped it. Re-seed so the daemon recovers,
+        // then retry once.
+        db.prepare("INSERT OR IGNORE INTO managed_task_seq (singleton, next_id) VALUES (1, 1)").run();
+        const retry = db
+            .prepare(`UPDATE managed_task_seq
+            SET next_id = next_id + 1
+          WHERE singleton = 1
+          RETURNING next_id`)
+            .get();
+        return formatManagedTaskId(retry.next_id - 1);
+    }
+    // RETURNING surfaces the new value (post-increment); the caller's id
+    // is the *previous* counter, i.e. `next_id - 1`. This keeps the seed
+    // semantics — first allocation returns `mt_1`.
+    return formatManagedTaskId(row.next_id - 1);
+}
+/**
+ * §12 recovery path: ensure `managed_task_seq.next_id` is greater than
+ * the maximum existing `managed_tasks.id` numeric component. Idempotent
+ * — call from boot once, after the schema is applied. Safe to call
+ * even on an empty table (no-op when MAX returns NULL).
+ */
+export function bootstrapManagedTaskSeq(db) {
+    const row = db
+        .prepare(`SELECT MAX(CAST(SUBSTR(id, 4) AS INTEGER)) AS max_id FROM managed_tasks`)
+        .get();
+    const maxId = row?.max_id ?? 0;
+    if (maxId <= 0)
+        return;
+    db.prepare(`UPDATE managed_task_seq SET next_id = ? WHERE singleton = 1 AND next_id <= ?`).run(maxId + 1, maxId);
+}
+export function insertManagedTask(db, input) {
+    if (!isValidManagedTaskId(input.id)) {
+        throw new Error(`insertManagedTask: invalid id ${input.id}`);
+    }
+    db.prepare(`INSERT INTO managed_tasks
+        (id, intent, app, app_normalized, cadence, output_path, schedule_id,
+         consecutive_failures, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, 0, datetime('now'), datetime('now'))`).run(input.id, input.intent, input.app, normalizeAppLabel(input.app), input.cadence, input.outputPath, input.scheduleId);
+    const dto = getManagedTask(db, input.id);
+    // INSERT just succeeded, the row is guaranteed to exist; the branch
+    // is defensive against a post-insert deletion racing in another
+    // connection (no such caller exists today).
+    /* c8 ignore start */
+    if (!dto) {
+        throw new Error(`insertManagedTask: row vanished after insert (${input.id})`);
+    }
+    /* c8 ignore stop */
+    return dto;
+}
+export function updateManagedTask(db, id, input) {
+    if (!isValidManagedTaskId(id))
+        return null;
+    const sets = [];
+    const values = [];
+    if (input.intent !== undefined) {
+        sets.push("intent = ?");
+        values.push(input.intent);
+    }
+    if (input.cadence !== undefined) {
+        sets.push("cadence = ?");
+        values.push(input.cadence);
+    }
+    if (input.outputPath !== undefined) {
+        sets.push("output_path = ?");
+        values.push(input.outputPath);
+    }
+    if (sets.length === 0)
+        return getManagedTask(db, id);
+    sets.push("updated_at = datetime('now')");
+    values.push(id);
+    const result = db
+        .prepare(`UPDATE managed_tasks SET ${sets.join(", ")} WHERE id = ?`)
+        .run(...values);
+    if (result.changes === 0)
+        return null;
+    return getManagedTask(db, id);
+}
+/**
+ * Internal-only — applied by the scheduled-managed-task skill via
+ * `PATCH /api/managed-tasks/:id/run-result` (§10.4 step 5). Replace-
+ * semantics on every column so the skill is responsible for the
+ * three-strikes counter (§10.4 step 6 is the route layer's notify
+ * path).
+ */
+export function updateManagedTaskRunResult(db, id, input) {
+    if (!isValidManagedTaskId(id))
+        return null;
+    const result = db
+        .prepare(`UPDATE managed_tasks
+          SET last_run_at = ?, last_result = ?, consecutive_failures = ?,
+              updated_at = datetime('now')
+        WHERE id = ?`)
+        .run(input.lastRunAt, input.lastResult, input.consecutiveFailures, id);
+    if (result.changes === 0)
+        return null;
+    return getManagedTask(db, id);
+}
+/**
+ * Hard-delete a managed task (§10.3). Returns `true` when a row was
+ * removed, `false` when the id did not exist. The caller is expected
+ * to also delete the matching `recurring_schedules.id` row in the
+ * same transaction; the FK's `ON DELETE CASCADE` handles the reverse
+ * direction when the schedule is deleted first, but the §10.3 flow
+ * deletes managed_tasks first (so a partial failure leaves the
+ * schedule orphaned for the boot reconciler to clean up rather than
+ * silently dropping the user's commitment).
+ */
+export function deleteManagedTask(db, id) {
+    if (!isValidManagedTaskId(id))
+        return false;
+    const result = db
+        .prepare("DELETE FROM managed_tasks WHERE id = ?")
+        .run(id);
+    return result.changes > 0;
+}
+/**
+ * §10.1 step 2 — DB-side dedup probe. Used by the route layer when an
+ * Idempotency-Key collision (§11.4) misses but the (app_normalized,
+ * cadence) pair already exists. Returns the existing row so a 409
+ * response can carry the mt_id back to the agent's DM.
+ *
+ * Returns `null` when no row matches. The match is exact on the
+ * normalized app label and on the verbatim cadence string —
+ * semantic-cadence matching is left to the LLM-judged dedup at
+ * registration time (§10.1 step 2).
+ */
+export function findManagedTaskByAppCadence(db, app, cadence) {
+    const row = db
+        .prepare(`SELECT id, intent, app, app_normalized, cadence, output_path,
+              schedule_id, last_run_at, last_result, consecutive_failures,
+              created_at, updated_at
+         FROM managed_tasks
+        WHERE app_normalized = ? AND cadence = ?
+        LIMIT 1`)
+        .get(normalizeAppLabel(app), cadence);
+    return row ? rowToManagedTask(row) : null;
+}
+//# sourceMappingURL=managed-tasks-store.js.map

package/dist/db/managed-tasks-store.js.map

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

package/dist/db/management-parse-failures-store.d.ts

@@ -0,0 +1,45 @@
+import type Database from "better-sqlite3";
+/**
+ * `management_parse_failures` access helpers (docs/design/21-management-
+ * registry-and-entities.md §9.1 parse rules, §17.1).
+ *
+ * Failures recorded here are surfaced on the dashboard's degraded-mode
+ * banner (P6) and counted by the §14.3
+ * `aitne_management_parse_failures_total` metric (P8). This module
+ * provides the smallest necessary surface — record / list / clear —
+ * to keep both consumers cheap and the registry's hot path uncluttered.
+ */
+export type ManagementParseFailureSection = "A" | "B" | "C" | null;
+export interface ManagementParseFailure {
+    id: number;
+    section: ManagementParseFailureSection;
+    reason: string;
+    raw: string | null;
+    created_at: string;
+}
+interface InsertParseFailure {
+    section?: ManagementParseFailureSection;
+    reason: string;
+    raw?: string | null;
+}
+/**
+ * Persist a single parse failure. Returns the inserted row id so call
+ * sites can correlate the registry's structured parse result with the
+ * dashboard banner's deep-link.
+ */
+export declare function recordManagementParseFailure(db: Database.Database, failure: InsertParseFailure): number;
+/**
+ * List the most recent parse failures, newest first. The default cap
+ * matches the dashboard banner's render budget (a single row carries
+ * the user-facing message; older rows are reachable from the
+ * "see all" link).
+ */
+export declare function listManagementParseFailures(db: Database.Database, limit?: number): ManagementParseFailure[];
+/**
+ * Drop every recorded failure. Called by the registry once the file
+ * round-trips cleanly so the dashboard banner clears without manual
+ * intervention.
+ */
+export declare function clearManagementParseFailures(db: Database.Database): number;
+export {};
+//# sourceMappingURL=management-parse-failures-store.d.ts.map

package/dist/db/management-parse-failures-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-parse-failures-store.d.ts","sourceRoot":"","sources":["../../src/db/management-parse-failures-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;GASG;AAEH,MAAM,MAAM,6BAA6B,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,6BAA6B,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,6BAA6B,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,SAAK,GACT,sBAAsB,EAAE,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAG1E"}

package/dist/db/management-parse-failures-store.js

@@ -0,0 +1,36 @@
+/**
+ * Persist a single parse failure. Returns the inserted row id so call
+ * sites can correlate the registry's structured parse result with the
+ * dashboard banner's deep-link.
+ */
+export function recordManagementParseFailure(db, failure) {
+    const result = db
+        .prepare(`INSERT INTO management_parse_failures (section, reason, raw)
+         VALUES (?, ?, ?)`)
+        .run(failure.section ?? null, failure.reason, failure.raw ?? null);
+    return Number(result.lastInsertRowid);
+}
+/**
+ * List the most recent parse failures, newest first. The default cap
+ * matches the dashboard banner's render budget (a single row carries
+ * the user-facing message; older rows are reachable from the
+ * "see all" link).
+ */
+export function listManagementParseFailures(db, limit = 50) {
+    return db
+        .prepare(`SELECT id, section, reason, raw, created_at
+         FROM management_parse_failures
+         ORDER BY id DESC
+         LIMIT ?`)
+        .all(Math.max(1, Math.floor(limit)));
+}
+/**
+ * Drop every recorded failure. Called by the registry once the file
+ * round-trips cleanly so the dashboard banner clears without manual
+ * intervention.
+ */
+export function clearManagementParseFailures(db) {
+    const result = db.prepare("DELETE FROM management_parse_failures").run();
+    return result.changes;
+}
+//# sourceMappingURL=management-parse-failures-store.js.map

package/dist/db/management-parse-failures-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-parse-failures-store.js","sourceRoot":"","sources":["../../src/db/management-parse-failures-store.ts"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAqB,EACrB,OAA2B;IAE3B,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CACN;0BACoB,CACrB;SACA,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,EAAqB,EACrB,KAAK,GAAG,EAAE;IAEV,OAAO,EAAE;SACN,OAAO,CACN;;;iBAGW,CACZ;SACA,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAA6B,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAAqB;IAChE,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,EAAE,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/db/observations.d.ts

@@ -0,0 +1,145 @@
+import type Database from "better-sqlite3";
+type ObservationChangeType = "created" | "modified" | "deleted";
+type ObservationActor = "user" | "agent" | "system" | "unknown";
+export type SummaryStatus = "pending" | "done" | "skipped" | "failed";
+interface ObservationRecord {
+    id: number;
+    source: string;
+    ref: string;
+    change_type: ObservationChangeType;
+    actor: ObservationActor;
+    observed_at: string;
+    payload: string | null;
+    consumed_at: string | null;
+    consumed_by: string | null;
+    summary_text: string | null;
+    novelty_score: number | null;
+    summary_status: SummaryStatus;
+    summary_at: string | null;
+    summary_backend: string | null;
+}
+export interface ObservationSummaryRow {
+    id: number;
+    source: string;
+    ref: string;
+    changeType: ObservationChangeType;
+    actor: ObservationActor;
+    observedAt: string;
+    payload: unknown;
+    summaryStatus: SummaryStatus;
+}
+export interface PendingObservationsByActorRow {
+    actor: ObservationActor;
+    pendingCount: number;
+}
+export interface RecordObservationParams {
+    source: string;
+    ref: string;
+    changeType: ObservationChangeType;
+    actor?: ObservationActor;
+    payload?: unknown;
+}
+interface GetPendingObservationsParams {
+    pending?: boolean;
+    limit?: number;
+    offset?: number;
+    sourceFilter?: string;
+    actorFilter?: ObservationActor;
+    since?: string;
+}
+/**
+ * Hook called after a row is inserted/upserted, with the row id. The
+ * summarizer worker uses this to enqueue without coupling the DB
+ * helper to the observer module.
+ */
+export type ObservationEnqueueHook = (observationId: number) => void;
+export declare function setObservationEnqueueHook(hook: ObservationEnqueueHook | null): void;
+/**
+ * Fire the observation-enqueue hook for a row id. Exposed for callers that
+ * insert/update observation rows through paths other than `recordObservation`
+ * (currently the coalescing UPSERT in `drift-effects.ts`). The summarizer
+ * worker dedupes internally on its own `enqueued`/`inFlight` sets, so calling
+ * this for an id already in flight is a safe no-op.
+ *
+ * Errors thrown by the hook are swallowed and logged for the same reason as
+ * in `recordObservation`: observation writers are best-effort, and a
+ * downstream summarizer fault must not abort the caller's transaction.
+ */
+export declare function notifyObservationSummarizer(observationId: number): void;
+export declare function recordObservation(db: Database.Database, params: RecordObservationParams): void;
+export declare function getPendingObservations(db: Database.Database, params?: GetPendingObservationsParams): ObservationRecord[];
+export declare function consumeObservations(db: Database.Database, ids: number[], correlationId: string): {
+    consumed: number;
+    notFound: number[];
+};
+export declare function getPendingCount(db: Database.Database, params?: Pick<GetPendingObservationsParams, "sourceFilter" | "actorFilter" | "since">): number;
+export declare function getObservationStats(db: Database.Database, params?: Pick<GetPendingObservationsParams, "actorFilter">): {
+    totalPending: number;
+    oldestPendingObservedAt: string | null;
+    bySource: Array<{
+        source: string;
+        pendingCount: number;
+        oldestObservedAt: string | null;
+    }>;
+};
+export declare function getPendingCountsByActor(db: Database.Database): PendingObservationsByActorRow[];
+export declare function cleanupConsumedObservations(db: Database.Database, olderThanDays?: number): number;
+/**
+ * Read one observation by id along with its summarizer state. Returns
+ * null when the row was already consumed or no longer exists.
+ */
+export declare function getObservationForSummarization(db: Database.Database, id: number): ObservationSummaryRow | null;
+/**
+ * Pending-row counts grouped by `summary_status`. Used by the
+ * dashboard to surface summarizer health without scanning rows.
+ */
+export declare function getSummaryStatusCounts(db: Database.Database): Record<SummaryStatus, number>;
+/**
+ * Distribution of `novelty_score` values across pending observations
+ * with `summary_status='done'`. Drives the dashboard novelty-histogram
+ * card and the hourly_check fetch-rate evaluation.
+ */
+export declare function getNoveltyDistribution(db: Database.Database): {
+    score: 0 | 1 | 2 | 3;
+    count: number;
+}[];
+/**
+ * Bulk-fetch pending observation ids for the summarizer worker — used
+ * by the startup reclaim sweep and by recovery after a worker crash.
+ */
+export declare function listObservationsAwaitingSummary(db: Database.Database, options?: {
+    limit?: number;
+    olderThan?: string;
+}): number[];
+interface UpdateSummaryParams {
+    id: number;
+    summaryText: string | null;
+    noveltyScore: number | null;
+    summaryStatus: SummaryStatus;
+    summaryBackend?: string | null;
+    summaryAt?: string;
+}
+/**
+ * Persist the summarizer's verdict to the observations row. Idempotent
+ * — a same-id repeat overwrites with the latest values.
+ */
+export declare function updateObservationSummary(db: Database.Database, params: UpdateSummaryParams): void;
+/**
+ * Count pending observations that are older than `olderThanDays`.
+ *
+ * Pending observations are intentionally never auto-deleted (the hourly_check
+ * dispatcher is the only consumer; silently dropping them would hide
+ * operational bugs). However, if a row stays pending for many days it usually
+ * indicates that the dispatcher is consistently below threshold or otherwise
+ * stalled. Retention surfaces this via a warning so the operator can react.
+ *
+ * Returns the count and the oldest observed_at among stale pending rows.
+ */
+export declare function getStalePendingObservationStats(db: Database.Database, olderThanDays: number, options?: {
+    actorFilter?: "user" | "agent" | "system" | "unknown";
+}): {
+    count: number;
+    oldestObservedAt: string | null;
+};
+export {};
+//# sourceMappingURL=observations.d.ts.map

package/dist/db/observations.d.ts.map

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