@openrig/cli 0.1.11 → 0.2.0

package/daemon/dist/domain/view-projector.d.ts

@@ -0,0 +1,83 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "./event-bus.js";
+/**
+ * View projector (PL-004 Phase B; L5 View — read-only projections).
+ *
+ * Per PRD § L5 + slice IMPL § Guard Checkpoint Focus item 5+6:
+ * - 6 built-in views over Phase A's queue_items + queue_transitions tables.
+ * - Custom view registration via views_custom table.
+ * - Read-only over Phase A state + Phase B state. NO writes to queue_items
+ *   or queue_transitions from this module.
+ * - Sub-100 ms latency target (per PRD § Acceptance Criteria); achieved by
+ *   leaning on Phase A's existing indexes.
+ * - Fixture rig exclusion default: rig names matching `^test-` or `^fixture-`
+ *   are excluded; opt-in via OPENRIG_VIEW_INCLUDE_FIXTURES=1.
+ *
+ * Custom views in views_custom store a SQL string (`definition`) that the
+ * projector executes verbatim. Operator-defined; no taxonomy enforced.
+ *
+ * Pattern mirrors Phase A's queue-repository.ts read-API shape.
+ */
+export declare const BUILT_IN_VIEW_NAMES: readonly ["recently-active", "founder", "pod-load", "escalations", "held", "activity"];
+export type BuiltInViewName = (typeof BUILT_IN_VIEW_NAMES)[number];
+export interface ViewQueryResult {
+    viewName: string;
+    generatedAt: string;
+    rows: Record<string, unknown>[];
+    rowCount: number;
+}
+export interface CustomView {
+    viewId: string;
+    viewName: string;
+    definition: string;
+    registeredBySession: string;
+    registeredAt: string;
+    lastEvaluatedAt: string | null;
+}
+export declare class ViewProjectorError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class ViewProjector {
+    readonly db: Database.Database;
+    private readonly eventBus;
+    private readonly now;
+    constructor(db: Database.Database, eventBus: EventBus, opts?: {
+        now?: () => Date;
+    });
+    /**
+     * Run a view by name. Built-in names (BUILT_IN_VIEW_NAMES) dispatch to
+     * hardcoded SQL; other names dispatch to custom-view lookup.
+     */
+    show(viewName: string, opts?: {
+        rig?: string;
+        limit?: number;
+    }): ViewQueryResult;
+    list(): {
+        builtIn: BuiltInViewName[];
+        custom: CustomView[];
+    };
+    private runBuiltIn;
+    private runCustom;
+    /**
+     * Register a custom view. UNIQUE on view_name; re-registration of the
+     * same name updates the definition (operator-friendly: edit views.yaml,
+     * re-register, get the new query).
+     */
+    registerCustomView(input: {
+        viewName: string;
+        definition: string;
+        registeredBySession: string;
+    }): CustomView;
+    getCustomView(viewName: string): CustomView | null;
+    listCustomViews(): CustomView[];
+    /**
+     * Used by routes/views.ts to emit view.changed when underlying state
+     * changes. Phase B does not auto-evaluate; callers (route SSE handlers)
+     * subscribe to event-bus events and trigger this notify.
+     */
+    notifyViewChanged(viewName: string, cause: string): void;
+    private getCustomViewByIdOrThrow;
+    private rowToCustomView;
+}
+//# sourceMappingURL=view-projector.d.ts.map

package/daemon/dist/domain/view-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-projector.d.ts","sourceRoot":"","sources":["../../src/domain/view-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,mBAAmB,wFAOtB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAWD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAmBD,qBAAa,aAAa;IACxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAG/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,QAAQ,EAClB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IAO7B;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAYhF,IAAI,IAAI;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,MAAM,EAAE,UAAU,EAAE,CAAA;KAAE;IAI5D,OAAO,CAAC,UAAU;IAyHlB,OAAO,CAAC,SAAS;IA4BjB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,GAAG,UAAU;IAgCd,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOlD,eAAe,IAAI,UAAU,EAAE;IAO/B;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASxD,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,eAAe;CAUxB"}

package/daemon/dist/domain/view-projector.js

@@ -0,0 +1,296 @@
+import { ulid } from "ulid";
+/**
+ * View projector (PL-004 Phase B; L5 View — read-only projections).
+ *
+ * Per PRD § L5 + slice IMPL § Guard Checkpoint Focus item 5+6:
+ * - 6 built-in views over Phase A's queue_items + queue_transitions tables.
+ * - Custom view registration via views_custom table.
+ * - Read-only over Phase A state + Phase B state. NO writes to queue_items
+ *   or queue_transitions from this module.
+ * - Sub-100 ms latency target (per PRD § Acceptance Criteria); achieved by
+ *   leaning on Phase A's existing indexes.
+ * - Fixture rig exclusion default: rig names matching `^test-` or `^fixture-`
+ *   are excluded; opt-in via OPENRIG_VIEW_INCLUDE_FIXTURES=1.
+ *
+ * Custom views in views_custom store a SQL string (`definition`) that the
+ * projector executes verbatim. Operator-defined; no taxonomy enforced.
+ *
+ * Pattern mirrors Phase A's queue-repository.ts read-API shape.
+ */
+export const BUILT_IN_VIEW_NAMES = [
+    "recently-active",
+    "founder",
+    "pod-load",
+    "escalations",
+    "held",
+    "activity",
+];
+export class ViewProjectorError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+/**
+ * Detect fixture rigs by session name suffix `@<rig>` where <rig> starts
+ * with `test-` or `fixture-`. Used to filter views by default; opt-in via
+ * OPENRIG_VIEW_INCLUDE_FIXTURES=1.
+ */
+function fixtureExclusionClause() {
+    if (process.env.OPENRIG_VIEW_INCLUDE_FIXTURES === "1")
+        return "1=1";
+    // Exclude qitems whose source_session OR destination_session has a rig
+    // name starting with test- or fixture-.
+    return `(
+    destination_session NOT LIKE '%@test-%' AND
+    destination_session NOT LIKE '%@fixture-%' AND
+    source_session NOT LIKE '%@test-%' AND
+    source_session NOT LIKE '%@fixture-%'
+  )`;
+}
+export class ViewProjector {
+    db;
+    eventBus;
+    now;
+    constructor(db, eventBus, opts) {
+        this.db = db;
+        this.eventBus = eventBus;
+        this.now = opts?.now ?? (() => new Date());
+    }
+    /**
+     * Run a view by name. Built-in names (BUILT_IN_VIEW_NAMES) dispatch to
+     * hardcoded SQL; other names dispatch to custom-view lookup.
+     */
+    show(viewName, opts) {
+        const limit = Math.max(1, Math.min(opts?.limit ?? 100, 1000));
+        if (BUILT_IN_VIEW_NAMES.includes(viewName)) {
+            return this.runBuiltIn(viewName, opts?.rig, limit);
+        }
+        const custom = this.getCustomView(viewName);
+        if (!custom) {
+            throw new ViewProjectorError("view_not_found", `view '${viewName}' is not registered (built-in or custom)`);
+        }
+        return this.runCustom(custom, limit);
+    }
+    list() {
+        return { builtIn: [...BUILT_IN_VIEW_NAMES], custom: this.listCustomViews() };
+    }
+    runBuiltIn(name, rig, limit) {
+        const fixtureClause = fixtureExclusionClause();
+        const rigClause = rig ? `AND (destination_session LIKE ? OR source_session LIKE ?)` : "";
+        const rigParams = rig ? [`%@${rig}`, `%@${rig}`] : [];
+        let sql;
+        let params = [];
+        switch (name) {
+            case "recently-active":
+                // qitems by ts_updated DESC; live states (pending/in-progress/blocked).
+                sql = `
+          SELECT qitem_id, source_session, destination_session, state, priority, tier, ts_updated, body
+          FROM queue_items
+          WHERE state IN ('pending', 'in-progress', 'blocked')
+            AND ${fixtureClause}
+            ${rigClause}
+          ORDER BY ts_updated DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            case "founder":
+                // priority='critical' OR tier='critical' OR tier='fast'.
+                sql = `
+          SELECT qitem_id, source_session, destination_session, state, priority, tier, ts_updated
+          FROM queue_items
+          WHERE (priority = 'critical' OR tier IN ('critical', 'fast'))
+            AND state IN ('pending', 'in-progress', 'blocked')
+            AND ${fixtureClause}
+            ${rigClause}
+          ORDER BY ts_updated DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            case "pod-load":
+                // R1 NOTE 4: PRD § L5 names this view "per-pod queue-item counts",
+                // but Phase A's queue_items table does not carry pod metadata —
+                // destination_session is `<member>@<rig>` shape and there is no
+                // pod_id column. v0 interpretation: group by destination_session
+                // (i.e., per-seat counts). When pod metadata becomes available
+                // (Phase D workflow runtime or later), this view should be
+                // upgraded to GROUP BY pod_id with destination_session aggregation
+                // as a sub-grouping. Documented v0 behavior preserves the view
+                // name but reduces the grouping key.
+                sql = `
+          SELECT destination_session AS pod, COUNT(*) AS active_count
+          FROM queue_items
+          WHERE state IN ('pending', 'in-progress', 'blocked')
+            AND ${fixtureClause}
+            ${rigClause}
+          GROUP BY destination_session
+          ORDER BY active_count DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            case "escalations":
+                // closure_reason = 'escalation' OR transition note matches.
+                sql = `
+          SELECT qitem_id, source_session, destination_session, state, closure_reason, closure_target, ts_updated
+          FROM queue_items
+          WHERE closure_reason = 'escalation'
+            AND ${fixtureClause}
+            ${rigClause}
+          ORDER BY ts_updated DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            case "held":
+                // state = 'blocked' OR blocked_on is non-null.
+                sql = `
+          SELECT qitem_id, source_session, destination_session, state, blocked_on, ts_updated, body
+          FROM queue_items
+          WHERE (state = 'blocked' OR blocked_on IS NOT NULL)
+            AND ${fixtureClause}
+            ${rigClause}
+          ORDER BY ts_updated DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            case "activity": {
+                // Recent transitions joined with qitem state. Fixture-clause must
+                // reference queue_items columns, so use the prefixed clause.
+                const fixtureClauseQI = fixtureClause === "1=1"
+                    ? "1=1"
+                    : `(
+              q.destination_session NOT LIKE '%@test-%' AND
+              q.destination_session NOT LIKE '%@fixture-%' AND
+              q.source_session NOT LIKE '%@test-%' AND
+              q.source_session NOT LIKE '%@fixture-%'
+            )`;
+                const rigClauseQI = rig
+                    ? `AND (q.destination_session LIKE ? OR q.source_session LIKE ?)`
+                    : "";
+                sql = `
+          SELECT t.transition_id, t.qitem_id, t.ts, t.state, t.actor_session, t.transition_note,
+                 q.destination_session, q.source_session
+          FROM queue_transitions t
+          JOIN queue_items q ON t.qitem_id = q.qitem_id
+          WHERE ${fixtureClauseQI}
+            ${rigClauseQI}
+          ORDER BY t.ts DESC
+          LIMIT ?
+        `;
+                params = [...rigParams, limit];
+                break;
+            }
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return {
+            viewName: name,
+            generatedAt: this.now().toISOString(),
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    runCustom(view, limit) {
+        // Custom view definitions are operator-supplied SQL. Append LIMIT if
+        // the operator's SQL does not already include one. We do not parse SQL;
+        // operators are responsible for the definition's correctness.
+        const sql = view.definition.toLowerCase().includes("limit")
+            ? view.definition
+            : `${view.definition.trim().replace(/;$/, "")} LIMIT ${limit}`;
+        let rows;
+        try {
+            rows = this.db.prepare(sql).all();
+        }
+        catch (err) {
+            throw new ViewProjectorError("view_query_failed", `custom view '${view.viewName}' query failed: ${err.message}`);
+        }
+        // Touch last_evaluated_at (best-effort; not transactional).
+        this.db
+            .prepare(`UPDATE views_custom SET last_evaluated_at = ? WHERE view_id = ?`)
+            .run(this.now().toISOString(), view.viewId);
+        return {
+            viewName: view.viewName,
+            generatedAt: this.now().toISOString(),
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    /**
+     * Register a custom view. UNIQUE on view_name; re-registration of the
+     * same name updates the definition (operator-friendly: edit views.yaml,
+     * re-register, get the new query).
+     */
+    registerCustomView(input) {
+        if (BUILT_IN_VIEW_NAMES.includes(input.viewName)) {
+            throw new ViewProjectorError("view_name_reserved", `view name '${input.viewName}' is a reserved built-in name; choose a different name`);
+        }
+        const existing = this.db
+            .prepare(`SELECT * FROM views_custom WHERE view_name = ?`)
+            .get(input.viewName);
+        const registeredAt = this.now().toISOString();
+        if (existing) {
+            this.db
+                .prepare(`UPDATE views_custom
+             SET definition = ?, registered_by_session = ?, registered_at = ?
+           WHERE view_id = ?`)
+                .run(input.definition, input.registeredBySession, registeredAt, existing.view_id);
+            return this.getCustomViewByIdOrThrow(existing.view_id);
+        }
+        const viewId = ulid();
+        this.db
+            .prepare(`INSERT INTO views_custom (
+          view_id, view_name, definition, registered_by_session, registered_at
+        ) VALUES (?, ?, ?, ?, ?)`)
+            .run(viewId, input.viewName, input.definition, input.registeredBySession, registeredAt);
+        return this.getCustomViewByIdOrThrow(viewId);
+    }
+    getCustomView(viewName) {
+        const row = this.db
+            .prepare(`SELECT * FROM views_custom WHERE view_name = ?`)
+            .get(viewName);
+        return row ? this.rowToCustomView(row) : null;
+    }
+    listCustomViews() {
+        const rows = this.db
+            .prepare(`SELECT * FROM views_custom ORDER BY view_name ASC`)
+            .all();
+        return rows.map((r) => this.rowToCustomView(r));
+    }
+    /**
+     * Used by routes/views.ts to emit view.changed when underlying state
+     * changes. Phase B does not auto-evaluate; callers (route SSE handlers)
+     * subscribe to event-bus events and trigger this notify.
+     */
+    notifyViewChanged(viewName, cause) {
+        const persisted = this.eventBus.persistWithinTransaction({
+            type: "view.changed",
+            viewName,
+            cause,
+        });
+        this.eventBus.notifySubscribers(persisted);
+    }
+    getCustomViewByIdOrThrow(viewId) {
+        const row = this.db
+            .prepare(`SELECT * FROM views_custom WHERE view_id = ?`)
+            .get(viewId);
+        if (!row) {
+            throw new ViewProjectorError("view_not_found", `custom view ${viewId} not found after write`);
+        }
+        return this.rowToCustomView(row);
+    }
+    rowToCustomView(row) {
+        return {
+            viewId: row.view_id,
+            viewName: row.view_name,
+            definition: row.definition,
+            registeredBySession: row.registered_by_session,
+            registeredAt: row.registered_at,
+            lastEvaluatedAt: row.last_evaluated_at,
+        };
+    }
+}
+//# sourceMappingURL=view-projector.js.map

package/daemon/dist/domain/view-projector.js.map

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

package/daemon/dist/domain/watchdog-history-log.d.ts

@@ -0,0 +1,49 @@
+import type Database from "better-sqlite3";
+/**
+ * Watchdog history log (PL-004 Phase C; append-only audit writer).
+ *
+ * Per slice IMPL § Guard Checkpoint Focus item 2:
+ * - Pure `not_due` polls are NOT recorded (matches POC; minimizes
+ *   table size). Only `sent` / `skipped` / `terminal` outcomes pass
+ *   through this log.
+ * - Append-only API surface: only `record()` exposed. UPDATE/DELETE
+ *   are not exposed. SQLite has no view/role layer so direct SQL
+ *   could mutate, but the contract is enforced at this domain
+ *   boundary.
+ */
+export type WatchdogOutcome = "sent" | "skipped" | "terminal";
+export interface WatchdogHistoryRecordInput {
+    jobId: string;
+    evaluatedAt: string;
+    outcome: WatchdogOutcome;
+    skipReason?: string | null;
+    deliveryTargetSession?: string | null;
+    deliveryStatus?: string | null;
+    deliveryMessage?: string | null;
+    evaluationNotes?: Record<string, unknown> | null;
+}
+export interface WatchdogHistoryEntry {
+    historyId: string;
+    jobId: string;
+    evaluatedAt: string;
+    outcome: WatchdogOutcome;
+    skipReason: string | null;
+    deliveryTargetSession: string | null;
+    deliveryStatus: string | null;
+    deliveryMessage: string | null;
+    evaluationNotes: Record<string, unknown> | null;
+}
+export declare class WatchdogHistoryLog {
+    private readonly db;
+    constructor(db: Database.Database);
+    /**
+     * Append a meaningful evaluation outcome. Returns the persisted entry.
+     * Caller MUST NOT invoke this for `not_due` pure-skip outcomes — those
+     * are not recorded (per POC + IMPL guidance).
+     */
+    record(input: WatchdogHistoryRecordInput): WatchdogHistoryEntry;
+    listForJob(jobId: string, limit?: number): WatchdogHistoryEntry[];
+    listAll(limit?: number): WatchdogHistoryEntry[];
+    countForJob(jobId: string): number;
+}
+//# sourceMappingURL=watchdog-history-log.d.ts.map

package/daemon/dist/domain/watchdog-history-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-history-log.d.ts","sourceRoot":"","sources":["../../src/domain/watchdog-history-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjD;AAcD,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,oBAAoB;IAkC/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,oBAAoB,EAAE;IAU7D,OAAO,CAAC,KAAK,SAAM,GAAG,oBAAoB,EAAE;IAU5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAMnC"}

package/daemon/dist/domain/watchdog-history-log.js

@@ -0,0 +1,67 @@
+import { ulid } from "ulid";
+export class WatchdogHistoryLog {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Append a meaningful evaluation outcome. Returns the persisted entry.
+     * Caller MUST NOT invoke this for `not_due` pure-skip outcomes — those
+     * are not recorded (per POC + IMPL guidance).
+     */
+    record(input) {
+        const historyId = ulid();
+        this.db
+            .prepare(`INSERT INTO watchdog_history (
+          history_id, job_id, evaluated_at, outcome,
+          skip_reason, delivery_target_session, delivery_status,
+          delivery_message, evaluation_notes
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(historyId, input.jobId, input.evaluatedAt, input.outcome, input.skipReason ?? null, input.deliveryTargetSession ?? null, input.deliveryStatus ?? null, input.deliveryMessage ?? null, input.evaluationNotes ? JSON.stringify(input.evaluationNotes) : null);
+        return {
+            historyId,
+            jobId: input.jobId,
+            evaluatedAt: input.evaluatedAt,
+            outcome: input.outcome,
+            skipReason: input.skipReason ?? null,
+            deliveryTargetSession: input.deliveryTargetSession ?? null,
+            deliveryStatus: input.deliveryStatus ?? null,
+            deliveryMessage: input.deliveryMessage ?? null,
+            evaluationNotes: input.evaluationNotes ?? null,
+        };
+    }
+    listForJob(jobId, limit = 50) {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_history WHERE job_id = ?
+         ORDER BY evaluated_at DESC, history_id DESC LIMIT ?`)
+            .all(jobId, limit);
+        return rows.map(rowToEntry);
+    }
+    listAll(limit = 100) {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_history
+         ORDER BY evaluated_at DESC, history_id DESC LIMIT ?`)
+            .all(limit);
+        return rows.map(rowToEntry);
+    }
+    countForJob(jobId) {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS n FROM watchdog_history WHERE job_id = ?`)
+            .get(jobId);
+        return row.n;
+    }
+}
+function rowToEntry(row) {
+    return {
+        historyId: row.history_id,
+        jobId: row.job_id,
+        evaluatedAt: row.evaluated_at,
+        outcome: row.outcome,
+        skipReason: row.skip_reason,
+        deliveryTargetSession: row.delivery_target_session,
+        deliveryStatus: row.delivery_status,
+        deliveryMessage: row.delivery_message,
+        evaluationNotes: row.evaluation_notes ? JSON.parse(row.evaluation_notes) : null,
+    };
+}
+//# sourceMappingURL=watchdog-history-log.js.map

package/daemon/dist/domain/watchdog-history-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-history-log.js","sourceRoot":"","sources":["../../src/domain/watchdog-history-log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAoD5B,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAEtD;;;;OAIG;IACH,MAAM,CAAC,KAAiC;QACtC,MAAM,SAAS,GAAG,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;6CAIqC,CACtC;aACA,GAAG,CACF,SAAS,EACT,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,UAAU,IAAI,IAAI,EACxB,KAAK,CAAC,qBAAqB,IAAI,IAAI,EACnC,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,KAAK,CAAC,eAAe,IAAI,IAAI,EAC7B,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CACrE,CAAC;QACJ,OAAO;YACL,SAAS;YACT,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;YACpC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,IAAI,IAAI;YAC1D,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;YAC5C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;YAC9C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;SAC/C,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;6DACqD,CACtD;aACA,GAAG,CAAC,KAAK,EAAE,KAAK,CAAiB,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,KAAK,GAAG,GAAG;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;6DACqD,CACtD;aACA,GAAG,CAAC,KAAK,CAAiB,CAAC;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,6DAA6D,CAAC;aACtE,GAAG,CAAC,KAAK,CAAkB,CAAC;QAC/B,OAAO,GAAG,CAAC,CAAC,CAAC;IACf,CAAC;CACF;AAED,SAAS,UAAU,CAAC,GAAe;IACjC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,KAAK,EAAE,GAAG,CAAC,MAAM;QACjB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,OAAO,EAAE,GAAG,CAAC,OAA0B;QACvC,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,qBAAqB,EAAE,GAAG,CAAC,uBAAuB;QAClD,cAAc,EAAE,GAAG,CAAC,eAAe;QACnC,eAAe,EAAE,GAAG,CAAC,gBAAgB;QACrC,eAAe,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI;KAChF,CAAC;AACJ,CAAC"}

package/daemon/dist/domain/watchdog-jobs-repository.d.ts

@@ -0,0 +1,81 @@
+import type Database from "better-sqlite3";
+/**
+ * Watchdog jobs repository (PL-004 Phase C; extended in Phase D).
+ *
+ * Owns all reads/writes against `watchdog_jobs`. Pure persistence; no
+ * event-bus, no scheduler, no policy dispatch. Composed by the
+ * scheduler and policy engine.
+ *
+ * Phase D v1 accepts FOUR policy values (the orch-ratified Phase C
+ * `workflow-keepalive` deferral has been lifted; the policy module
+ * now exists at `policies/workflow-keepalive.ts` and reads from the
+ * SQLite `workflow_instances` table introduced in Phase D):
+ *   - periodic-reminder (Phase C)
+ *   - artifact-pool-ready (Phase C)
+ *   - edge-artifact-required (Phase C)
+ *   - workflow-keepalive (Phase D)
+ *
+ * PHASE_C_POLICIES retained as a deprecated alias for callers that
+ * still reference it; new code uses PHASE_D_POLICIES.
+ */
+export declare const PHASE_D_POLICIES: readonly ["periodic-reminder", "artifact-pool-ready", "edge-artifact-required", "workflow-keepalive"];
+/** @deprecated since Phase D — use PHASE_D_POLICIES. */
+export declare const PHASE_C_POLICIES: readonly ["periodic-reminder", "artifact-pool-ready", "edge-artifact-required", "workflow-keepalive"];
+export type WatchdogPolicyName = (typeof PHASE_D_POLICIES)[number];
+export type WatchdogJobState = "active" | "stopped" | "terminal";
+export interface WatchdogJob {
+    jobId: string;
+    policy: WatchdogPolicyName;
+    specYaml: string;
+    targetSession: string;
+    intervalSeconds: number;
+    activeWakeIntervalSeconds: number | null;
+    scanIntervalSeconds: number | null;
+    lastEvaluationAt: string | null;
+    lastFireAt: string | null;
+    actionable: boolean;
+    lastActionableAt: string | null;
+    state: WatchdogJobState;
+    registeredBySession: string;
+    registeredAt: string;
+    terminalReason: string | null;
+}
+export interface RegisterWatchdogJobInput {
+    policy: string;
+    specYaml: string;
+    targetSession: string;
+    intervalSeconds: number;
+    activeWakeIntervalSeconds?: number | null;
+    scanIntervalSeconds?: number | null;
+    registeredBySession: string;
+}
+export declare class WatchdogJobsError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare class WatchdogJobsRepository {
+    private readonly db;
+    private readonly now;
+    constructor(db: Database.Database, now?: () => Date);
+    register(input: RegisterWatchdogJobInput): WatchdogJob;
+    getById(jobId: string): WatchdogJob | null;
+    getByIdOrThrow(jobId: string): WatchdogJob;
+    listAll(): WatchdogJob[];
+    listActive(): WatchdogJob[];
+    recordEvaluation(jobId: string, evaluatedAt: string, fired: boolean): void;
+    /**
+     * R1 fix: write the actionable-state machine columns. Mirrors POC
+     * engine's `state.actionable` + `state.last_actionable_at`. Called
+     * by the policy engine after every meaningful evaluation:
+     *   - newActionable=false (skip): clears actionable + last_actionable_at.
+     *   - newActionable=true with no preserveLastActionableAt: stamps
+     *     last_actionable_at to evaluatedAt (newly actionable).
+     *   - newActionable=true with preserveLastActionableAt set: keeps the
+     *     existing first-actionable timestamp (continued actionable window).
+     */
+    setActionable(jobId: string, newActionable: boolean, evaluatedAt: string, preserveLastActionableAt?: string | null): void;
+    markTerminal(jobId: string, reason: string): void;
+    stop(jobId: string, reason?: string): WatchdogJob;
+}
+//# sourceMappingURL=watchdog-jobs-repository.d.ts.map

package/daemon/dist/domain/watchdog-jobs-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-jobs-repository.d.ts","sourceRoot":"","sources":["../../src/domain/watchdog-jobs-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,gBAAgB,uGAKnB,CAAC;AAEX,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,uGAAmB,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAoBD,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,GAAE,MAAM,IAAuB;IAGrD,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,WAAW;IA+CtD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO1C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAY1C,OAAO,IAAI,WAAW,EAAE;IAOxB,UAAU,IAAI,WAAW,EAAE;IAO3B,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAc1E;;;;;;;;;OASG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,MAAM,EACnB,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAC7C,IAAI;IAiBP,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQjD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAqB,GAAG,WAAW;CAe9D"}