@aitne/daemon 0.1.0

package/dist/db/hourly-check-signals.js

@@ -0,0 +1,289 @@
+/**
+ * Stage-0 signal compute for the three-stage hourly_check gate
+ * (cost-reduction-structural §B). Pure DB-read shape: every value is
+ * derived from existing tables (`observations`, `mail_messages_index`,
+ * `agent_schedule`, `agent_actions`) plus the optional today.md content
+ * passed in by the caller. No LLM call, no filesystem I/O of its own —
+ * the dispatcher injects the today.md snapshot (when available) so this
+ * module stays unit-testable from a synthetic Database handle.
+ *
+ * The shape mirrors the design doc 1:1 so the gate (Stage 1) can be
+ * a pure function over `HourlyCheckSignals` + a config block.
+ */
+export function computeHourlyCheckSignals(db, options = {}) {
+    const now = options.now ?? new Date();
+    const vipSenders = (options.vipMailSenders ?? []).map((s) => s.toLowerCase());
+    const calendarHorizonMs = (options.calendarHorizonHours ?? 24) * 60 * 60 * 1000;
+    const scheduleHorizonHours = options.scheduleHorizonHours ?? 6;
+    const pending = db
+        .prepare(`SELECT COUNT(*) AS count
+         FROM observations
+        WHERE consumed_at IS NULL
+          AND actor = 'user'`)
+        .get();
+    const noveltyMaxRow = db
+        .prepare(`SELECT MAX(novelty_score) AS max_score
+         FROM observations
+        WHERE consumed_at IS NULL
+          AND actor = 'user'
+          AND summary_status = 'done'
+          AND novelty_score IS NOT NULL`)
+        .get();
+    const distributionRows = db
+        .prepare(`SELECT novelty_score AS score, COUNT(*) AS count
+         FROM observations
+        WHERE consumed_at IS NULL
+          AND actor = 'user'
+          AND summary_status = 'done'
+          AND novelty_score IS NOT NULL
+        GROUP BY novelty_score`)
+        .all();
+    const noveltyDistribution = { low: 0, mid: 0, high: 0 };
+    for (const row of distributionRows) {
+        if (row.score <= 1)
+            noveltyDistribution.low += row.count;
+        else if (row.score === 2)
+            noveltyDistribution.mid += row.count;
+        else if (row.score >= 3)
+            noveltyDistribution.high += row.count;
+    }
+    const vipMailUnreadCount = countVipUnreadMail(db, vipSenders);
+    const calendarRow = db
+        .prepare(`SELECT COUNT(*) AS count
+         FROM observations
+        WHERE consumed_at IS NULL
+          AND actor = 'user'
+          AND source LIKE 'calendar:%'`)
+        .get();
+    const calendarHas24hChange = calendarRow.count > 0;
+    const calendarHasConflict = detectCalendarConflict(db, now, calendarHorizonMs);
+    const agentPlanOverdueCount = countOverdueAgentPlanRows(options.todayMd ?? null, now, options.agentTimezone);
+    const horizon = new Date(now.getTime() + scheduleHorizonHours * 60 * 60 * 1000);
+    const scheduleRow = db
+        .prepare(`SELECT COUNT(*) AS count
+         FROM agent_schedule
+        WHERE status = 'pending'
+          AND scheduled_for >= ?
+          AND scheduled_for < ?`)
+        .get(toSqliteUtc(now), toSqliteUtc(horizon));
+    const hoursSinceLastStage3Run = computeHoursSinceLastStage3(db, now);
+    return {
+        pendingObsCount: pending.count,
+        maxNoveltyScore: noveltyMaxRow.max_score,
+        noveltyDistribution,
+        vipMailUnreadCount,
+        calendarHas24hChange,
+        calendarHasConflict,
+        agentPlanOverdueCount,
+        scheduleApproachingCount: scheduleRow.count,
+        hoursSinceLastStage3Run,
+    };
+}
+function countVipUnreadMail(db, vipSenders) {
+    if (vipSenders.length === 0)
+        return 0;
+    // Defensive against a partially-migrated DB that lacks the table.
+    const tableExists = db
+        .prepare(`SELECT 1 AS present
+         FROM sqlite_master
+        WHERE type = 'table' AND name = 'mail_messages_index'`)
+        .get();
+    if (!tableExists)
+        return 0;
+    const placeholders = vipSenders.map(() => "?").join(",");
+    const row = db
+        .prepare(`SELECT COUNT(*) AS count
+         FROM mail_messages_index
+        WHERE is_read = 0
+          AND deleted_at_utc IS NULL
+          AND LOWER(COALESCE(from_email, '')) IN (${placeholders})`)
+        .get(...vipSenders);
+    return row.count;
+}
+function detectCalendarConflict(db, now, horizonMs) {
+    // Pull pending calendar observation payloads. We tolerate the common
+    // shapes (`start`, `end`, `start.dateTime`, `end.dateTime`) and bail
+    // gracefully when neither is recognizable. A "conflict" is two events
+    // whose [start, end) ranges intersect within the lookahead window.
+    const rows = db
+        .prepare(`SELECT payload
+         FROM observations
+        WHERE consumed_at IS NULL
+          AND actor = 'user'
+          AND source LIKE 'calendar:%'
+          AND payload IS NOT NULL`)
+        .all();
+    const ranges = [];
+    const horizon = now.getTime() + horizonMs;
+    for (const row of rows) {
+        if (!row.payload)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(row.payload);
+        }
+        catch {
+            continue;
+        }
+        const range = extractRange(parsed);
+        if (!range)
+            continue;
+        if (range.end <= now.getTime())
+            continue;
+        if (range.start >= horizon)
+            continue;
+        ranges.push(range);
+    }
+    if (ranges.length < 2)
+        return false;
+    ranges.sort((a, b) => a.start - b.start);
+    for (let i = 1; i < ranges.length; i++) {
+        if (ranges[i].start < ranges[i - 1].end) {
+            return true;
+        }
+    }
+    return false;
+}
+function extractRange(payload) {
+    if (!payload || typeof payload !== "object")
+        return null;
+    const record = payload;
+    const start = parseTimestamp(record["start"] ??
+        (typeof record["startTime"] === "string" ? record["startTime"] : undefined) ??
+        readNested(record, "start", "dateTime") ??
+        readNested(record, "start", "date"));
+    const end = parseTimestamp(record["end"] ??
+        (typeof record["endTime"] === "string" ? record["endTime"] : undefined) ??
+        readNested(record, "end", "dateTime") ??
+        readNested(record, "end", "date"));
+    if (start === null || end === null || end <= start)
+        return null;
+    return { start, end };
+}
+function readNested(record, key, inner) {
+    const child = record[key];
+    if (!child || typeof child !== "object")
+        return undefined;
+    return child[inner];
+}
+function parseTimestamp(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return null;
+    const ts = Date.parse(value);
+    return Number.isFinite(ts) ? ts : null;
+}
+const AGENT_PLAN_HEADING = /^##\s+Agent Plan\b/i;
+const NEXT_HEADING = /^##\s+/;
+const PLAN_ROW_TIME = /^[\s>*-]*?(\d{1,2}):(\d{2})\b/;
+function countOverdueAgentPlanRows(todayMd, now, agentTimezone) {
+    if (!todayMd)
+        return 0;
+    const lines = todayMd.split(/\r?\n/);
+    let inPlan = false;
+    let count = 0;
+    const nowMin = minutesOfDayInTimezone(now, agentTimezone);
+    for (const line of lines) {
+        if (AGENT_PLAN_HEADING.test(line)) {
+            inPlan = true;
+            continue;
+        }
+        if (inPlan && NEXT_HEADING.test(line)) {
+            break;
+        }
+        if (!inPlan)
+            continue;
+        const match = PLAN_ROW_TIME.exec(line);
+        if (!match)
+            continue;
+        const hh = Number(match[1]);
+        const mm = Number(match[2]);
+        if (!Number.isFinite(hh) || !Number.isFinite(mm))
+            continue;
+        if (hh > 23 || mm > 59)
+            continue;
+        const planMin = hh * 60 + mm;
+        if (planMin < nowMin)
+            count += 1;
+    }
+    return count;
+}
+/**
+ * Convert a wall-clock instant into "minutes-of-day in the given IANA
+ * timezone". Falls back to the JS engine's local timezone when no zone
+ * is supplied or the zone string is invalid — the latter avoids the
+ * gate going dark on an operator typo.
+ */
+function minutesOfDayInTimezone(now, timezone) {
+    if (!timezone) {
+        return now.getHours() * 60 + now.getMinutes();
+    }
+    try {
+        const formatter = new Intl.DateTimeFormat("en-GB", {
+            hour: "2-digit",
+            minute: "2-digit",
+            hour12: false,
+            timeZone: timezone,
+        });
+        const parts = formatter.formatToParts(now);
+        const hh = Number(parts.find((p) => p.type === "hour")?.value ?? "0");
+        const mm = Number(parts.find((p) => p.type === "minute")?.value ?? "0");
+        if (!Number.isFinite(hh) || !Number.isFinite(mm)) {
+            return now.getHours() * 60 + now.getMinutes();
+        }
+        return hh * 60 + mm;
+    }
+    catch {
+        return now.getHours() * 60 + now.getMinutes();
+    }
+}
+function computeHoursSinceLastStage3(db, now) {
+    // Prefer the gate-emitted row (`hourly_check.gate` with stage_reached
+    // ∈ {'stage3', 'stage3_shadow'}) — that matches the design doc's
+    // "since the last Stage 3 run" semantics. Shadow mode writes
+    // `stage3_shadow`, but a shadow tick still spawns a full Stage-3
+    // session; treating both as "did a real run" keeps the heartbeat
+    // honest in shadow mode without depending on the legacy fallback row
+    // (which can be pruned independently). Fall back to the legacy
+    // `routine.hourly_check` action-type for installs deployed before
+    // the gate was wired.
+    const gateRow = db
+        .prepare(`SELECT started_at
+         FROM agent_actions
+        WHERE action_type = 'hourly_check.gate'
+          AND json_extract(detail, '$.stage_reached') IN ('stage3', 'stage3_shadow')
+        ORDER BY started_at DESC
+        LIMIT 1`)
+        .get();
+    let lastStarted = gateRow?.started_at ?? null;
+    if (!lastStarted) {
+        const fallbackRow = db
+            .prepare(`SELECT started_at
+           FROM agent_actions
+          WHERE action_type = 'routine.hourly_check'
+            AND result IN ('success', 'partial', 'failed')
+          ORDER BY started_at DESC
+          LIMIT 1`)
+            .get();
+        lastStarted = fallbackRow?.started_at ?? null;
+    }
+    if (!lastStarted)
+        return Number.POSITIVE_INFINITY;
+    const lastUtc = parseSqliteUtc(lastStarted);
+    if (lastUtc === null)
+        return Number.POSITIVE_INFINITY;
+    const diffMs = now.getTime() - lastUtc;
+    if (diffMs <= 0)
+        return 0;
+    return diffMs / (60 * 60 * 1000);
+}
+function toSqliteUtc(date) {
+    // "YYYY-MM-DD HH:MM:SS" — matches CURRENT_TIMESTAMP / datetime('now').
+    return date.toISOString().replace("T", " ").slice(0, 19);
+}
+function parseSqliteUtc(value) {
+    // Tolerate both "YYYY-MM-DD HH:MM:SS" and ISO 8601.
+    const iso = value.includes("T") ? value : value.replace(" ", "T") + "Z";
+    const ts = Date.parse(iso);
+    return Number.isFinite(ts) ? ts : null;
+}
+//# sourceMappingURL=hourly-check-signals.js.map

package/dist/db/hourly-check-signals.js.map

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

package/dist/db/integration-probe-store.d.ts

@@ -0,0 +1,27 @@
+import type Database from "better-sqlite3";
+import { type BackendId, type IntegrationKey } from "@aitne/shared";
+import type { ProbeResult } from "../core/integration-probe.js";
+export declare function writeProbe(db: Database.Database, result: ProbeResult): void;
+export declare function readProbe(db: Database.Database, integration: IntegrationKey, backend: BackendId): ProbeResult | null;
+/**
+ * Read every probe row keyed by `(integration, backend)`. The /health
+ * endpoint and dashboard call this to render the per-key feature matrix
+ * without N round-trips.
+ */
+export declare function listProbes(db: Database.Database): ReadonlyMap<string, ProbeResult>;
+/**
+ * Stable composite key used by callers that need to look up by
+ * `(integration, backend)` after listing — e.g. /health iterating the
+ * registry then matching the cache. Kept as a single function so callers
+ * never reinvent the join character.
+ */
+export declare function probeKey(integration: IntegrationKey, backend: BackendId): string;
+/**
+ * Drop every cached probe row for an integration. Called by the PATCH
+ * handler after a mode change so `/health.integrationModes.<key>.features`
+ * stops showing stale probe data taken before the change — /health then
+ * falls back to the descriptor's POC-inventory defaults until the next
+ * live probe (dashboard button) re-populates the cache.
+ */
+export declare function deleteProbesForIntegration(db: Database.Database, integration: IntegrationKey): number;
+//# sourceMappingURL=integration-probe-store.d.ts.map

package/dist/db/integration-probe-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-probe-store.d.ts","sourceRoot":"","sources":["../../src/db/integration-probe-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAgChE,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,WAAW,GAClB,IAAI,CAaN;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,SAAS,GACjB,WAAW,GAAG,IAAI,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAclC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,SAAS,GACjB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,cAAc,GAC1B,MAAM,CAKR"}

package/dist/db/integration-probe-store.js

@@ -0,0 +1,75 @@
+import { isIntegrationKey, } from "@aitne/shared";
+function parseRow(row) {
+    try {
+        const parsed = JSON.parse(row.result_json);
+        // Trust the persisted shape — writers go through `writeProbe` which
+        // accepts a typed `ProbeResult`. A corrupted row (manual SQL edit,
+        // mid-write crash) returns null so callers fall back to the
+        // descriptor-default features map rather than crashing.
+        if (!isIntegrationKey(parsed.integration))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeProbe(db, result) {
+    db.prepare(`INSERT INTO integration_probes (integration_key, backend_id, result_json, probed_at)
+     VALUES (?, ?, ?, ?)
+     ON CONFLICT(integration_key, backend_id) DO UPDATE SET
+       result_json = excluded.result_json,
+       probed_at = excluded.probed_at`).run(result.integration, result.backend, JSON.stringify(result), result.probedAt);
+}
+export function readProbe(db, integration, backend) {
+    const row = db
+        .prepare(`SELECT integration_key, backend_id, result_json, probed_at
+         FROM integration_probes
+         WHERE integration_key = ? AND backend_id = ?`)
+        .get(integration, backend);
+    if (!row)
+        return null;
+    return parseRow(row);
+}
+/**
+ * Read every probe row keyed by `(integration, backend)`. The /health
+ * endpoint and dashboard call this to render the per-key feature matrix
+ * without N round-trips.
+ */
+export function listProbes(db) {
+    const rows = db
+        .prepare(`SELECT integration_key, backend_id, result_json, probed_at
+         FROM integration_probes`)
+        .all();
+    const out = new Map();
+    for (const row of rows) {
+        const parsed = parseRow(row);
+        if (!parsed)
+            continue;
+        out.set(probeKey(parsed.integration, parsed.backend), parsed);
+    }
+    return out;
+}
+/**
+ * Stable composite key used by callers that need to look up by
+ * `(integration, backend)` after listing — e.g. /health iterating the
+ * registry then matching the cache. Kept as a single function so callers
+ * never reinvent the join character.
+ */
+export function probeKey(integration, backend) {
+    return `${integration}::${backend}`;
+}
+/**
+ * Drop every cached probe row for an integration. Called by the PATCH
+ * handler after a mode change so `/health.integrationModes.<key>.features`
+ * stops showing stale probe data taken before the change — /health then
+ * falls back to the descriptor's POC-inventory defaults until the next
+ * live probe (dashboard button) re-populates the cache.
+ */
+export function deleteProbesForIntegration(db, integration) {
+    const result = db
+        .prepare(`DELETE FROM integration_probes WHERE integration_key = ?`)
+        .run(integration);
+    return result.changes;
+}
+//# sourceMappingURL=integration-probe-store.js.map

package/dist/db/integration-probe-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-probe-store.js","sourceRoot":"","sources":["../../src/db/integration-probe-store.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AAmBvB,SAAS,QAAQ,CAAC,GAAa;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAgB,CAAC;QAC1D,oEAAoE;QACpE,mEAAmE;QACnE,4DAA4D;QAC5D,wDAAwD;QACxD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,EAAqB,EACrB,MAAmB;IAEnB,EAAE,CAAC,OAAO,CACR;;;;sCAIkC,CACnC,CAAC,GAAG,CACH,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,OAAO,EACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EACtB,MAAM,CAAC,QAAQ,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,EAAqB,EACrB,WAA2B,EAC3B,OAAkB;IAElB,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;sDAEgD,CACjD;SACA,GAAG,CAAC,WAAW,EAAE,OAAO,CAAyB,CAAC;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,EAAqB;IAErB,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;iCAC2B,CAC5B;SACA,GAAG,EAAgB,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,WAA2B,EAC3B,OAAkB;IAElB,OAAO,GAAG,WAAW,KAAK,OAAO,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAqB,EACrB,WAA2B;IAE3B,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CAAC,0DAA0D,CAAC;SACnE,GAAG,CAAC,WAAW,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/db/integrations-store.d.ts

@@ -0,0 +1,19 @@
+import type Database from "better-sqlite3";
+import { type IntegrationKey, type IntegrationState } from "@aitne/shared";
+export type IntegrationsRecord = Record<IntegrationKey, IntegrationState>;
+export declare function readIntegrations(db: Database.Database): IntegrationsRecord;
+export declare function readIntegrationState(db: Database.Database, key: IntegrationKey): IntegrationState;
+/**
+ * Atomically replace the full integrations map. Unknown keys are dropped;
+ * missing keys are filled from the current stored map (or the all-disabled
+ * default) so a partial update does not wipe sibling integrations.
+ */
+export declare function writeIntegrations(db: Database.Database, update: Partial<IntegrationsRecord>): IntegrationsRecord;
+/**
+ * Update a single integration's state. The `lastChangedAt` timestamp is
+ * stamped by the store; callers do not need to supply it.
+ */
+export declare function updateIntegrationState(db: Database.Database, key: IntegrationKey, next: Omit<IntegrationState, "lastChangedAt"> & {
+    lastChangedAt?: string;
+}): IntegrationsRecord;
+//# sourceMappingURL=integrations-store.d.ts.map

package/dist/db/integrations-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-store.d.ts","sourceRoot":"","sources":["../../src/db/integrations-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAkBvB,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAqB1E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,CAa1E;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,cAAc,GAClB,gBAAgB,CAElB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,kBAAkB,CAgBpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,kBAAkB,CASpB"}

package/dist/db/integrations-store.js

@@ -0,0 +1,85 @@
+import { INTEGRATION_KEYS, defaultIntegrationsMap, integrationStateSchema, isIntegrationKey, } from "@aitne/shared";
+/**
+ * Integration Delegation Framework — persistence (Phase 1).
+ *
+ * The integrations map is a single JSON blob under `settings` key
+ * `"integrations"`. The shape is `Record<IntegrationKey, IntegrationState>`.
+ * Readers always get every registered key back (defaults filled in for
+ * missing rows) so callers don't have to null-check per integration; writers
+ * also re-validate every key before persisting.
+ *
+ * Not exposed through `SqliteSettingsStore` / `runtimeSettingsSchema` on
+ * purpose — integrations have their own `PATCH /api/integrations/:key`
+ * surface and are not part of the generic `PATCH /api/config` key-space.
+ */
+const STORAGE_KEY = "integrations";
+function withDefaults(raw, now = new Date().toISOString()) {
+    const fallback = defaultIntegrationsMap(now);
+    if (!raw)
+        return fallback;
+    const out = { ...fallback };
+    for (const key of INTEGRATION_KEYS) {
+        const candidate = raw[key];
+        if (candidate === undefined)
+            continue;
+        const parsed = integrationStateSchema.safeParse(candidate);
+        if (parsed.success) {
+            out[key] = parsed.data;
+        }
+    }
+    return out;
+}
+export function readIntegrations(db) {
+    try {
+        const row = db
+            .prepare("SELECT value_json FROM settings WHERE key = ?")
+            .get(STORAGE_KEY);
+        if (!row) {
+            return defaultIntegrationsMap();
+        }
+        const parsed = JSON.parse(row.value_json);
+        return withDefaults(parsed);
+    }
+    catch {
+        return defaultIntegrationsMap();
+    }
+}
+export function readIntegrationState(db, key) {
+    return readIntegrations(db)[key];
+}
+/**
+ * Atomically replace the full integrations map. Unknown keys are dropped;
+ * missing keys are filled from the current stored map (or the all-disabled
+ * default) so a partial update does not wipe sibling integrations.
+ */
+export function writeIntegrations(db, update) {
+    const current = readIntegrations(db);
+    const merged = { ...current };
+    for (const key of INTEGRATION_KEYS) {
+        const candidate = update[key];
+        if (candidate === undefined)
+            continue;
+        merged[key] = integrationStateSchema.parse(candidate);
+    }
+    db.prepare(`INSERT INTO settings (key, value_json, updated_at)
+     VALUES (?, ?, CURRENT_TIMESTAMP)
+     ON CONFLICT(key) DO UPDATE SET
+       value_json = excluded.value_json,
+       updated_at = CURRENT_TIMESTAMP`).run(STORAGE_KEY, JSON.stringify(merged));
+    return merged;
+}
+/**
+ * Update a single integration's state. The `lastChangedAt` timestamp is
+ * stamped by the store; callers do not need to supply it.
+ */
+export function updateIntegrationState(db, key, next) {
+    if (!isIntegrationKey(key)) {
+        throw new Error(`Unknown integration key: ${key}`);
+    }
+    const stamped = {
+        ...next,
+        lastChangedAt: next.lastChangedAt ?? new Date().toISOString(),
+    };
+    return writeIntegrations(db, { [key]: stamped });
+}
+//# sourceMappingURL=integrations-store.js.map

package/dist/db/integrations-store.js.map

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

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

@@ -0,0 +1,130 @@
+import type Database from "better-sqlite3";
+import { type ManagedTask } from "@aitne/shared";
+/**
+ * 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 declare function listManagedTasks(db: Database.Database): ManagedTask[];
+/**
+ * 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 declare function getManagedTask(db: Database.Database, id: string): ManagedTask | null;
+/**
+ * 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 declare function countManagedTasks(db: Database.Database): number;
+export interface AllocateNextIdOptions {
+    /**
+     * On boot, the §12 "managed_tasks.id collision after restore from
+     * backup" recovery path passes `bootstrap=true` so the seq is
+     * guaranteed to advance past every existing id (a backup-restored
+     * database can outpace its seq counter).
+     */
+    bootstrap?: boolean;
+}
+/**
+ * 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 declare function allocateNextManagedTaskId(db: Database.Database): string;
+/**
+ * §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 declare function bootstrapManagedTaskSeq(db: Database.Database): void;
+/**
+ * Insert a managed-task row. Returns the freshly-rehydrated DTO so
+ * the caller doesn't need a follow-up SELECT. The `id` MUST already
+ * have been allocated via {@link allocateNextManagedTaskId} inside the
+ * same transaction so the seq counter and the inserted row stay
+ * consistent on rollback.
+ *
+ * The `(app_normalized, cadence)` UNIQUE constraint is the dedup floor
+ * (§NFR-3 / §12); a SqliteError with code `SQLITE_CONSTRAINT_UNIQUE`
+ * surfaces from this function on collision, and the route layer maps
+ * it to a 409 with the existing mt_id (§17.2 integration test bullet).
+ */
+export interface InsertManagedTaskInput {
+    id: string;
+    intent: string;
+    app: string;
+    cadence: string;
+    outputPath: string | null;
+    scheduleId: number;
+}
+export declare function insertManagedTask(db: Database.Database, input: InsertManagedTaskInput): ManagedTask;
+/**
+ * Apply a partial update. Only the columns the API layer is permitted
+ * to mutate are accepted (§9.2 ManagedTaskPatchSchema). Returns the
+ * post-update DTO, or `null` when no row matches.
+ *
+ * `app` (and `app_normalized`) are intentionally NOT mutable through
+ * this surface — see the `rename-app` flow (§12) for the atomic path
+ * that updates entity-file `frontmatter.sources.<key>` references.
+ */
+export interface UpdateManagedTaskInput {
+    intent?: string;
+    cadence?: string;
+    outputPath?: string | null;
+}
+export declare function updateManagedTask(db: Database.Database, id: string, input: UpdateManagedTaskInput): ManagedTask | null;
+/**
+ * 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 declare function updateManagedTaskRunResult(db: Database.Database, id: string, input: {
+    lastRunAt: string;
+    lastResult: string;
+    consecutiveFailures: number;
+}): ManagedTask | null;
+/**
+ * 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 declare function deleteManagedTask(db: Database.Database, id: string): boolean;
+/**
+ * §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 declare function findManagedTaskByAppCadence(db: Database.Database, app: string, cadence: string): ManagedTask | null;
+//# sourceMappingURL=managed-tasks-store.d.ts.map