@aitne/daemon 0.1.0

package/dist/db/automation-triggers.d.ts.map

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

package/dist/db/automation-triggers.js

@@ -0,0 +1,199 @@
+import { createRecurringSchedule, updateRecurringSchedule, deleteRecurringSchedule, getRecurringSchedule, } from "./recurring-schedules.js";
+// ── Helpers ──────────────────────────────────────────────────────────
+function rowToDTO(db, row) {
+    let recurrence = null;
+    let nextRunAt = null;
+    if (row.recurring_schedule_id !== null) {
+        const sched = getRecurringSchedule(db, row.recurring_schedule_id);
+        if (sched) {
+            recurrence = sched.recurrenceRule;
+            nextRunAt = sched.nextRunAt;
+        }
+    }
+    // Look up the most recent action this trigger drove. The dispatcher
+    // populates source_kind='trigger', source_ref=trigger.id once the
+    // wiring lands; until then this gracefully returns null.
+    const lastAction = db
+        .prepare(`SELECT id, started_at, result
+         FROM agent_actions
+        WHERE source_kind = 'trigger' AND source_ref = ?
+        ORDER BY started_at DESC
+        LIMIT 1`)
+        .get(String(row.id));
+    return {
+        id: row.id,
+        domain: row.domain,
+        eventType: row.event_type,
+        prompt: row.prompt,
+        enabled: row.enabled === 1,
+        recurringScheduleId: row.recurring_schedule_id,
+        recurrence,
+        nextRunAt,
+        lastRunActionId: lastAction?.id ?? null,
+        lastRunStartedAt: lastAction?.started_at ?? null,
+        lastRunResult: lastAction?.result ?? null,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function buildRecurrenceFromEvent(eventType, time, daysOfWeek, configTimezone) {
+    if (eventType === "cron.daily") {
+        return { frequency: "daily", time, timezone: configTimezone };
+    }
+    // cron.weekly — daysOfWeek is required. The Zod boundary already enforces
+    // non-empty arrays on create; on update the caller must explicitly carry
+    // the existing value forward when only `time` changes (otherwise we'd
+    // silently collapse to a single day). Treat a missing value as a bug.
+    if (daysOfWeek === undefined || daysOfWeek.length === 0) {
+        throw new Error("buildRecurrenceFromEvent: daysOfWeek is required for cron.weekly");
+    }
+    return {
+        frequency: "weekly",
+        time,
+        timezone: configTimezone,
+        daysOfWeek,
+    };
+}
+export function createTrigger(db, params) {
+    const recurrence = buildRecurrenceFromEvent(params.eventType, params.time, params.daysOfWeek, params.configTimezone);
+    // Order matters: we insert the automation_triggers row first so the
+    // triggerId is known before createRecurringSchedule materializes the
+    // first agent_schedule row. Otherwise the first firing of every new
+    // trigger would carry a task_context without triggerId, and the
+    // dispatcher (Phase 2.5) would write source_ref=NULL on the
+    // resulting agent_actions row.
+    const txn = db.transaction(() => {
+        const insert = db
+            .prepare(`INSERT INTO automation_triggers
+           (domain, event_type, prompt, recurring_schedule_id, enabled)
+         VALUES (?, ?, ?, NULL, 1)`)
+            .run(params.domain, params.eventType, params.prompt);
+        const triggerId = Number(insert.lastInsertRowid);
+        const sched = createRecurringSchedule(db, {
+            taskType: "agent.task",
+            description: params.prompt,
+            recurrenceRule: recurrence,
+            taskContext: {
+                triggerSource: "automation_trigger",
+                triggerDomain: params.domain,
+                triggerEventType: params.eventType,
+                triggerId,
+            },
+        });
+        db.prepare("UPDATE automation_triggers SET recurring_schedule_id = ? WHERE id = ?").run(sched.id, triggerId);
+        return triggerId;
+    });
+    const triggerId = txn();
+    const row = db
+        .prepare("SELECT * FROM automation_triggers WHERE id = ?")
+        .get(triggerId);
+    return rowToDTO(db, row);
+}
+export function listTriggers(db, options) {
+    const rows = options?.domain
+        ? db
+            .prepare("SELECT * FROM automation_triggers WHERE domain = ? ORDER BY created_at ASC")
+            .all(options.domain)
+        : db
+            .prepare("SELECT * FROM automation_triggers ORDER BY created_at ASC")
+            .all();
+    return rows.map((row) => rowToDTO(db, row));
+}
+export function getTrigger(db, id) {
+    const row = db
+        .prepare("SELECT * FROM automation_triggers WHERE id = ?")
+        .get(id);
+    if (!row)
+        return null;
+    return rowToDTO(db, row);
+}
+export function updateTrigger(db, id, params) {
+    const existing = db
+        .prepare("SELECT * FROM automation_triggers WHERE id = ?")
+        .get(id);
+    if (!existing)
+        return null;
+    const setClauses = [];
+    const args = [];
+    if (params.prompt !== undefined) {
+        setClauses.push("prompt = ?");
+        args.push(params.prompt);
+    }
+    if (params.enabled !== undefined) {
+        setClauses.push("enabled = ?");
+        args.push(params.enabled ? 1 : 0);
+    }
+    if (setClauses.length > 0) {
+        setClauses.push("updated_at = CURRENT_TIMESTAMP");
+        args.push(id);
+        db.prepare(`UPDATE automation_triggers SET ${setClauses.join(", ")} WHERE id = ?`).run(...args);
+    }
+    // Sync the paired recurring_schedule for cron triggers when prompt,
+    // schedule shape, or enabled flag changes. The schedule's description
+    // is the LLM prompt at firing time, so prompt edits must propagate.
+    if (existing.recurring_schedule_id !== null) {
+        const existingSched = getRecurringSchedule(db, existing.recurring_schedule_id);
+        const recurrenceUpdate = params.time !== undefined || params.daysOfWeek !== undefined
+            ? buildRecurrenceFromEvent(existing.event_type, params.time ?? existingSched?.recurrenceRule.time ?? "09:00", 
+            // Preserve the existing daysOfWeek on time-only edits.
+            // Without this, a weekly trigger silently collapses to a
+            // single Monday on PATCH {time} — the wizard always sends
+            // both fields today, but direct API/CLI callers won't.
+            params.daysOfWeek ??
+                (existing.event_type === "cron.weekly"
+                    ? existingSched?.recurrenceRule.daysOfWeek
+                    : undefined), params.configTimezone)
+            : undefined;
+        const update = {};
+        if (params.prompt !== undefined)
+            update.description = params.prompt;
+        if (params.enabled !== undefined)
+            update.enabled = params.enabled;
+        if (recurrenceUpdate !== undefined)
+            update.recurrenceRule = recurrenceUpdate;
+        if (Object.keys(update).length > 0) {
+            updateRecurringSchedule(db, existing.recurring_schedule_id, update);
+        }
+        // updateRecurringSchedule re-materializes the pending agent_schedule
+        // row only when recurrenceRule or enabled changes. A prompt-only edit
+        // would therefore leave the next firing using the stale prompt
+        // (next-after-that picks up the new one). Patch the pending row
+        // directly so the very next firing reflects the user's edit.
+        if (params.prompt !== undefined && recurrenceUpdate === undefined) {
+            db.prepare(`UPDATE agent_schedule
+            SET task_description = ?
+          WHERE recurring_schedule_id = ? AND status = 'pending'`).run(params.prompt, existing.recurring_schedule_id);
+        }
+    }
+    const fresh = db
+        .prepare("SELECT * FROM automation_triggers WHERE id = ?")
+        .get(id);
+    return rowToDTO(db, fresh);
+}
+export function deleteTrigger(db, id) {
+    const row = db
+        .prepare("SELECT recurring_schedule_id FROM automation_triggers WHERE id = ?")
+        .get(id);
+    if (!row)
+        return false;
+    if (row.recurring_schedule_id !== null) {
+        deleteRecurringSchedule(db, row.recurring_schedule_id);
+    }
+    const result = db
+        .prepare("DELETE FROM automation_triggers WHERE id = ?")
+        .run(id);
+    return result.changes > 0;
+}
+export function getCatalog(domain) {
+    if (domain === "git") {
+        return {
+            domain,
+            events: [
+                { type: "cron.daily", label: "Every day at…", needsTime: true, needsDayOfWeek: false },
+                { type: "cron.weekly", label: "Every week on…", needsTime: true, needsDayOfWeek: true },
+            ],
+        };
+    }
+    return { domain, events: [] };
+}
+//# sourceMappingURL=automation-triggers.js.map

package/dist/db/automation-triggers.js.map

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

package/dist/db/client.d.ts

@@ -0,0 +1,6 @@
+import Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+export declare function createDatabase(config: AgentConfig): Database.Database;
+/** Create an in-memory database for testing */
+export declare function createTestDatabase(): Database.Database;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAwCrE;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAItD"}

package/dist/db/client.js

@@ -0,0 +1,47 @@
+import Database from "better-sqlite3";
+import { getDbPath } from "../config.js";
+import { chmodSync, mkdirSync, statSync } from "node:fs";
+import { dirname } from "node:path";
+import { createLogger } from "../logging.js";
+const logger = createLogger("db-client");
+export function createDatabase(config) {
+    const dbPath = getDbPath(config);
+    // Ensure data directory exists with restricted permissions
+    mkdirSync(dirname(dbPath), { recursive: true, mode: 0o700 });
+    const db = new Database(dbPath);
+    // Restrict DB file permissions to owner-only (rw-------)
+    try {
+        const st = statSync(dbPath);
+        if ((st.mode & 0o077) !== 0) {
+            chmodSync(dbPath, 0o600);
+        }
+    }
+    catch { /* ignore — stat can fail on in-memory DBs */ }
+    // Enable WAL mode for concurrent reads/writes
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    // Synchronous NORMAL is safe with WAL and faster than FULL
+    db.pragma("synchronous = NORMAL");
+    // Quick structural integrity check — catches B-tree corruption without
+    // the full-table scan cost of integrity_check. Log and continue rather
+    // than throwing so the daemon can still attempt to operate.
+    try {
+        const rows = db.pragma("quick_check");
+        const ok = rows.length === 1 && rows[0].quick_check === "ok";
+        if (!ok) {
+            const issues = rows.map((r) => r.quick_check).join("; ");
+            logger.error({ issues }, "Database quick_check failed — data may be corrupted. See docs/troubleshooting.md");
+        }
+    }
+    catch (err) {
+        logger.error({ err }, "Failed to run database quick_check");
+    }
+    return db;
+}
+/** Create an in-memory database for testing */
+export function createTestDatabase() {
+    const db = new Database(":memory:");
+    db.pragma("foreign_keys = ON");
+    return db;
+}
+//# sourceMappingURL=client.js.map

package/dist/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEjC,2DAA2D;IAC3D,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7D,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,yDAAyD;IACzD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,6CAA6C,CAAC,CAAC;IAEzD,8CAA8C;IAC9C,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAElC,uEAAuE;IACvE,uEAAuE;IACvE,4DAA4D;IAC5D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAA8B,CAAC;QACnE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC;QAC7D,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,CAAC,KAAK,CACV,EAAE,MAAM,EAAE,EACV,kFAAkF,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,oCAAoC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,92 @@
+import type Database from "better-sqlite3";
+import { type Domain, type EntityType } from "@aitne/shared";
+/**
+ * Public entity DTO. `sources` is the parsed `frontmatter.sources` map
+ * — keys are user-typed app labels, matching the `App` column in
+ * `rules/management.md`. The route layer serializes this directly.
+ */
+export interface EntityRecord {
+    path: string;
+    domain: Domain;
+    type: EntityType;
+    slug: string;
+    title: string;
+    status: string | null;
+    date: string | null;
+    lastSyncedAt: string | null;
+    sources: Record<string, unknown>;
+}
+/**
+ * §7.6 tier-1 lookup: exact `(source_key, external_id)` match. Joins
+ * the `entity_source_keys` sidecar (§7.6.1) to use its index, then
+ * extracts the per-source `external_id` from the JSON blob.
+ *
+ * Source-key matching is case-insensitive — the sidecar's
+ * `source_key_normalized` column collapses every casing variant onto
+ * the same bucket so a caller passing `"Zoom"` still matches an entity
+ * that wrote `sources.ZOOM` to its frontmatter. The JSON-path
+ * extraction below uses `k.source_key` (verbatim) so the per-row
+ * casing of the stored sidecar key is what reads the JSON blob —
+ * lowercasing the JSON path would break entries whose verbatim key is
+ * not lower-case.
+ *
+ * Returns 0..N matches. Multiple matches are valid in principle (an
+ * external_id could be reused across two entities the user explicitly
+ * wants to keep separate), but the lookup is intended for the
+ * scheduled-managed-task skill's "is this row already mirrored?"
+ * probe which expects ≤ 1 hit.
+ */
+export declare function findEntitiesBySource(db: Database.Database, sourceKey: string, externalId: string): EntityRecord[];
+/**
+ * Bias-input lookup for `management-task-register` Step 4a. Returns
+ * every entity carrying a `sources.<sourceKey>.*` binding regardless
+ * of `external_id`. Used so the registration skill can pick the
+ * `(domain, type)` already dominant for that app instead of guessing
+ * from the probe sample shape alone.
+ *
+ * Distinct from `findEntitiesBySource` (which requires both the key
+ * and the id) because the bias query has no candidate id yet — it
+ * runs at registration time, before any datum has been fetched.
+ */
+export declare function findEntitiesBySourceKey(db: Database.Database, sourceKey: string, limit?: number): EntityRecord[];
+/**
+ * §7.6 tier-2 lookup: fall-back when the upstream app does not expose
+ * a stable `external_id`. Matches on `(domain, type, date)` and
+ * (optionally) a substring of `title` (case-insensitive).
+ *
+ * `date` is the ISO-`YYYY-MM-DD` form pulled from the entity
+ * frontmatter; the column is indexed (idx_entities_domain_type_date).
+ * The `title` filter is a `LIKE %q%` over the indexed-by-prefix path
+ * but is intentionally not a full-text search — that lives at
+ * tier 3 (`fts_docs`, §7.6 lookup precedence) and is out of scope for
+ * this lookup helper.
+ */
+export interface FindEntitiesByDateInput {
+    domain: Domain;
+    type: EntityType;
+    /** ISO `YYYY-MM-DD`. */
+    date: string;
+    /** Optional case-insensitive substring of `title`. */
+    q?: string;
+    limit?: number;
+}
+export declare function findEntitiesByDomainTypeDate(db: Database.Database, input: FindEntitiesByDateInput): EntityRecord[];
+/**
+ * Exact-path lookup (`GET /api/entities/by-path`). Returns `null` when
+ * the path is malformed or no row matches; the route translates the
+ * latter into a 404. The path validator runs before the DB hit so a
+ * bad `domain` / `type-plural` returns 404 without a SQL roundtrip.
+ */
+export declare function getEntityByPath(db: Database.Database, path: string): EntityRecord | null;
+/**
+ * Sanity helper for routes — returns a normalized `(domain, type)`
+ * pair from a `<domain>/<type-plural>/` partial path, or `null` when
+ * either segment is unrecognised. Lives here (not in
+ * management-domains.ts) because it is a route-layer convenience
+ * over the shared validators, not a property of the L2 schema itself.
+ */
+export declare function resolveDomainType(domain: string, typePluralOrSingular: string): {
+    domain: Domain;
+    type: EntityType;
+} | null;
+//# sourceMappingURL=entities-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities-store.d.ts","sourceRoot":"","sources":["../../src/db/entities-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AA+BvB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAoCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CA2BhB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,EAAE,CAmBhB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,uBAAuB,GAC7B,YAAY,EAAE,CAqBhB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,IAAI,CAMrB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,MAAM,GAC3B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAQ7C"}

package/dist/db/entities-store.js

@@ -0,0 +1,180 @@
+import { isDomain, isEntityType, pluralToType, parseEntityPath, } from "@aitne/shared";
+function rowToRecord(row) {
+    // The mirror is built from validated frontmatter, but this is the
+    // boundary between SQL strings and the public TS contract — the
+    // domain/type fields go through `isDomain` / `pluralToType` so a
+    // hand-poked row (or an out-of-date schema) cannot smuggle an unknown
+    // value into the route response.
+    if (!isDomain(row.domain))
+        return null;
+    if (!isEntityType(row.type))
+        return null;
+    let sources;
+    try {
+        const parsed = JSON.parse(row.sources_json);
+        sources =
+            parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+                ? parsed
+                : {};
+    }
+    catch {
+        sources = {};
+    }
+    return {
+        path: row.path,
+        domain: row.domain,
+        type: row.type,
+        slug: row.slug,
+        title: row.title,
+        status: row.status,
+        date: row.date,
+        lastSyncedAt: row.last_synced_at,
+        sources,
+    };
+}
+const SELECT_COLUMNS = "path, domain, type, slug, title, status, date, last_synced_at, sources_json";
+/**
+ * §7.6 tier-1 lookup: exact `(source_key, external_id)` match. Joins
+ * the `entity_source_keys` sidecar (§7.6.1) to use its index, then
+ * extracts the per-source `external_id` from the JSON blob.
+ *
+ * Source-key matching is case-insensitive — the sidecar's
+ * `source_key_normalized` column collapses every casing variant onto
+ * the same bucket so a caller passing `"Zoom"` still matches an entity
+ * that wrote `sources.ZOOM` to its frontmatter. The JSON-path
+ * extraction below uses `k.source_key` (verbatim) so the per-row
+ * casing of the stored sidecar key is what reads the JSON blob —
+ * lowercasing the JSON path would break entries whose verbatim key is
+ * not lower-case.
+ *
+ * Returns 0..N matches. Multiple matches are valid in principle (an
+ * external_id could be reused across two entities the user explicitly
+ * wants to keep separate), but the lookup is intended for the
+ * scheduled-managed-task skill's "is this row already mirrored?"
+ * probe which expects ≤ 1 hit.
+ */
+export function findEntitiesBySource(db, sourceKey, externalId) {
+    if (!sourceKey || !externalId)
+        return [];
+    // Qualify every column with the `e.` alias — `path` is in both
+    // `entities` and `entity_source_keys`, so the bare reference is
+    // ambiguous to SQLite's column resolver. `DISTINCT` guards against
+    // an entity that carries the same `external_id` under multiple
+    // casing variants of the source key (`sources.Zoom` AND
+    // `sources.ZOOM` both pointing to `zm_x`) — both sidecar rows match
+    // the case-insensitive WHERE so the JOIN would otherwise surface
+    // the entity twice.
+    const rows = db
+        .prepare(`SELECT DISTINCT e.path, e.domain, e.type, e.slug, e.title, e.status,
+              e.date, e.last_synced_at, e.sources_json
+         FROM entities e
+         JOIN entity_source_keys k ON k.path = e.path
+        WHERE k.source_key_normalized = ?
+          AND json_extract(
+                e.sources_json,
+                '$.' || k.source_key || '.external_id'
+              ) = ?
+        ORDER BY e.path ASC`)
+        .all(sourceKey.toLowerCase(), externalId);
+    return rows
+        .map(rowToRecord)
+        .filter((r) => r !== null);
+}
+/**
+ * Bias-input lookup for `management-task-register` Step 4a. Returns
+ * every entity carrying a `sources.<sourceKey>.*` binding regardless
+ * of `external_id`. Used so the registration skill can pick the
+ * `(domain, type)` already dominant for that app instead of guessing
+ * from the probe sample shape alone.
+ *
+ * Distinct from `findEntitiesBySource` (which requires both the key
+ * and the id) because the bias query has no candidate id yet — it
+ * runs at registration time, before any datum has been fetched.
+ */
+export function findEntitiesBySourceKey(db, sourceKey, limit) {
+    if (!sourceKey)
+        return [];
+    const cap = clampLimit(limit, 50, 200);
+    // Case-insensitive match via the sidecar's normalised column — see
+    // {@link findEntitiesBySource} for the rationale.
+    const rows = db
+        .prepare(`SELECT DISTINCT e.path, e.domain, e.type, e.slug, e.title, e.status,
+              e.date, e.last_synced_at, e.sources_json
+         FROM entities e
+         JOIN entity_source_keys k ON k.path = e.path
+        WHERE k.source_key_normalized = ?
+        ORDER BY e.path ASC
+        LIMIT ?`)
+        .all(sourceKey.toLowerCase(), cap);
+    return rows
+        .map(rowToRecord)
+        .filter((r) => r !== null);
+}
+export function findEntitiesByDomainTypeDate(db, input) {
+    const limit = clampLimit(input.limit, 50, 200);
+    const params = [input.domain, input.type, input.date];
+    let where = "domain = ? AND type = ? AND date = ?";
+    if (input.q) {
+        where += " AND title LIKE ? COLLATE NOCASE";
+        params.push(`%${escapeLike(input.q)}%`);
+    }
+    params.push(limit);
+    const rows = db
+        .prepare(`SELECT ${SELECT_COLUMNS}
+         FROM entities
+        WHERE ${where}
+        ORDER BY path ASC
+        LIMIT ?`)
+        .all(...params);
+    return rows
+        .map(rowToRecord)
+        .filter((r) => r !== null);
+}
+/**
+ * Exact-path lookup (`GET /api/entities/by-path`). Returns `null` when
+ * the path is malformed or no row matches; the route translates the
+ * latter into a 404. The path validator runs before the DB hit so a
+ * bad `domain` / `type-plural` returns 404 without a SQL roundtrip.
+ */
+export function getEntityByPath(db, path) {
+    if (!parseEntityPath(path))
+        return null;
+    const row = db
+        .prepare(`SELECT ${SELECT_COLUMNS} FROM entities WHERE path = ?`)
+        .get(path);
+    return row ? rowToRecord(row) : null;
+}
+/**
+ * Sanity helper for routes — returns a normalized `(domain, type)`
+ * pair from a `<domain>/<type-plural>/` partial path, or `null` when
+ * either segment is unrecognised. Lives here (not in
+ * management-domains.ts) because it is a route-layer convenience
+ * over the shared validators, not a property of the L2 schema itself.
+ */
+export function resolveDomainType(domain, typePluralOrSingular) {
+    if (!isDomain(domain))
+        return null;
+    const pluralMatch = pluralToType(typePluralOrSingular);
+    if (pluralMatch !== null)
+        return { domain, type: pluralMatch };
+    if (isEntityType(typePluralOrSingular)) {
+        return { domain, type: typePluralOrSingular };
+    }
+    return null;
+}
+function clampLimit(raw, defaultValue, max) {
+    if (raw === undefined)
+        return defaultValue;
+    if (!Number.isFinite(raw) || raw < 1)
+        return defaultValue;
+    return Math.min(Math.floor(raw), max);
+}
+function escapeLike(value) {
+    // SQLite LIKE: backslash is the default escape character only when
+    // ESCAPE is specified. Strip it from user input together with `%`/`_`
+    // so a free-form title query cannot smuggle a wildcard. The mirror
+    // is a recall aid, not an exact-match contract — collapsing wildcard
+    // metacharacters keeps the API contract simple.
+    return value.replace(/[\\%_]/g, "");
+}
+//# sourceMappingURL=entities-store.js.map

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

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

package/dist/db/hourly-check-signals.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 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.
+ */
+import type Database from "better-sqlite3";
+export interface HourlyCheckSignals {
+    /** Post dedup-against-today user-actor pending observation count. */
+    pendingObsCount: number;
+    /**
+     * Maximum `novelty_score` across pending user observations whose
+     * `summary_status='done'`. `null` when no observation has a done
+     * summary yet — the gate treats null as a cautious mid-novelty default
+     * (see decideStage).
+     */
+    maxNoveltyScore: number | null;
+    /** Histogram of novelty levels across pending+done observations. */
+    noveltyDistribution: {
+        low: number;
+        mid: number;
+        high: number;
+    };
+    /** Count of unread mail rows whose sender is in the VIP list. */
+    vipMailUnreadCount: number;
+    /** True when at least one pending calendar observation exists. */
+    calendarHas24hChange: boolean;
+    /**
+     * True when at least two pending calendar observations carry
+     * overlapping `start`/`end` ISO timestamps in their JSON payload
+     * within the next 24 hours. Tolerant of missing fields — when the
+     * payload shape isn't recognizable, returns false (the LLM still
+     * sees the underlying observation in Stage 3 if escalated).
+     */
+    calendarHasConflict: boolean;
+    /**
+     * Number of `## Agent Plan` rows in today.md whose HH:MM is before
+     * `now` in the agent timezone. Best-effort regex parse — when
+     * today.md is missing or unparseable, returns 0.
+     */
+    agentPlanOverdueCount: number;
+    /** Count of `agent_schedule` rows due in the next 6 hours. */
+    scheduleApproachingCount: number;
+    /**
+     * Hours since the last hourly_check that escalated to Stage 3 (or
+     * before the gate was deployed, since the last hourly_check run at
+     * all). `Infinity` when no row has been recorded yet.
+     */
+    hoursSinceLastStage3Run: number;
+}
+export interface ComputeHourlyCheckSignalsOptions {
+    /** Owner-VIP mail addresses, lowercased exact-match. */
+    vipMailSenders?: readonly string[];
+    /** Look-ahead window for `scheduleApproachingCount`. Default 6h. */
+    scheduleHorizonHours?: number;
+    /** Look-ahead window for calendar conflict detection. Default 24h. */
+    calendarHorizonHours?: number;
+    /** today.md content snapshot (or null when missing/unreadable). */
+    todayMd?: string | null;
+    /** Wall-clock anchor — injectable for tests. Defaults to `new Date()`. */
+    now?: Date;
+    /**
+     * Agent timezone (IANA name, e.g. `Asia/Tokyo`) used to compare
+     * `## Agent Plan` HH:MM rows against `now`. When omitted, falls back
+     * to the JS engine's local timezone — fine in the common single-user
+     * deployment but wrong if the daemon runs in UTC and the operator
+     * pinned a different `config.timezone`.
+     */
+    agentTimezone?: string;
+}
+export declare function computeHourlyCheckSignals(db: Database.Database, options?: ComputeHourlyCheckSignalsOptions): HourlyCheckSignals;
+//# sourceMappingURL=hourly-check-signals.d.ts.map

package/dist/db/hourly-check-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hourly-check-signals.d.ts","sourceRoot":"","sources":["../../src/db/hourly-check-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oEAAoE;IACpE,mBAAmB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;;OAMG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,wBAAwB,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC;IAC/C,wDAAwD;IACxD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,IAAI,CAAC;IACX;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,gCAAqC,GAC7C,kBAAkB,CA0FpB"}