@openrig/cli 0.1.12 → 0.2.0

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"}

package/daemon/dist/domain/watchdog-jobs-repository.js

@@ -0,0 +1,164 @@
+import { ulid } from "ulid";
+/**
+ * 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 const PHASE_D_POLICIES = [
+    "periodic-reminder",
+    "artifact-pool-ready",
+    "edge-artifact-required",
+    "workflow-keepalive",
+];
+/** @deprecated since Phase D — use PHASE_D_POLICIES. */
+export const PHASE_C_POLICIES = PHASE_D_POLICIES;
+export class WatchdogJobsError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "WatchdogJobsError";
+    }
+}
+export class WatchdogJobsRepository {
+    db;
+    now;
+    constructor(db, now = () => new Date()) {
+        this.db = db;
+        this.now = now;
+    }
+    register(input) {
+        if (!PHASE_D_POLICIES.includes(input.policy)) {
+            throw new WatchdogJobsError("policy_unknown", `unknown watchdog policy '${input.policy}'; Phase D v1 supports: ${PHASE_D_POLICIES.join(", ")}`, { policy: input.policy, supported: [...PHASE_D_POLICIES] });
+        }
+        if (!Number.isInteger(input.intervalSeconds) || input.intervalSeconds <= 0) {
+            throw new WatchdogJobsError("interval_invalid", `interval_seconds must be a positive integer (got ${input.intervalSeconds})`, { intervalSeconds: input.intervalSeconds });
+        }
+        if (!input.targetSession || !input.targetSession.includes("@")) {
+            throw new WatchdogJobsError("target_session_invalid", `target_session must be canonical '<member>@<rig>' (got '${input.targetSession}')`, { targetSession: input.targetSession });
+        }
+        const jobId = ulid();
+        const registeredAt = this.now().toISOString();
+        this.db
+            .prepare(`INSERT INTO watchdog_jobs (
+          job_id, policy, spec_yaml, target_session,
+          interval_seconds, active_wake_interval_seconds, scan_interval_seconds,
+          last_evaluation_at, last_fire_at, state,
+          registered_by_session, registered_at, terminal_reason
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, 'active', ?, ?, NULL)`)
+            .run(jobId, input.policy, input.specYaml, input.targetSession, input.intervalSeconds, input.activeWakeIntervalSeconds ?? null, input.scanIntervalSeconds ?? null, input.registeredBySession, registeredAt);
+        return this.getByIdOrThrow(jobId);
+    }
+    getById(jobId) {
+        const row = this.db
+            .prepare(`SELECT * FROM watchdog_jobs WHERE job_id = ?`)
+            .get(jobId);
+        return row ? rowToJob(row) : null;
+    }
+    getByIdOrThrow(jobId) {
+        const job = this.getById(jobId);
+        if (!job) {
+            throw new WatchdogJobsError("job_not_found", `watchdog job ${jobId} not found`, { jobId });
+        }
+        return job;
+    }
+    listAll() {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_jobs ORDER BY registered_at ASC`)
+            .all();
+        return rows.map(rowToJob);
+    }
+    listActive() {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_jobs WHERE state = 'active' ORDER BY registered_at ASC`)
+            .all();
+        return rows.map(rowToJob);
+    }
+    recordEvaluation(jobId, evaluatedAt, fired) {
+        if (fired) {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET last_evaluation_at = ?, last_fire_at = ? WHERE job_id = ?`)
+                .run(evaluatedAt, evaluatedAt, jobId);
+        }
+        else {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET last_evaluation_at = ? WHERE job_id = ?`)
+                .run(evaluatedAt, jobId);
+        }
+    }
+    /**
+     * 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, newActionable, evaluatedAt, preserveLastActionableAt = null) {
+        if (!newActionable) {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET actionable = 0, last_actionable_at = NULL WHERE job_id = ?`)
+                .run(jobId);
+            return;
+        }
+        const stamp = preserveLastActionableAt ?? evaluatedAt;
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET actionable = 1, last_actionable_at = ? WHERE job_id = ?`)
+            .run(stamp, jobId);
+    }
+    markTerminal(jobId, reason) {
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET state = 'terminal', terminal_reason = ? WHERE job_id = ?`)
+            .run(reason, jobId);
+    }
+    stop(jobId, reason = "operator_stopped") {
+        const existing = this.getByIdOrThrow(jobId);
+        if (existing.state === "terminal") {
+            throw new WatchdogJobsError("job_terminal", `cannot stop watchdog job ${jobId}: state is terminal`, { jobId, state: existing.state });
+        }
+        if (existing.state === "stopped")
+            return existing;
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET state = 'stopped', terminal_reason = ? WHERE job_id = ?`)
+            .run(reason, jobId);
+        return this.getByIdOrThrow(jobId);
+    }
+}
+function rowToJob(row) {
+    return {
+        jobId: row.job_id,
+        policy: row.policy,
+        specYaml: row.spec_yaml,
+        targetSession: row.target_session,
+        intervalSeconds: row.interval_seconds,
+        activeWakeIntervalSeconds: row.active_wake_interval_seconds,
+        scanIntervalSeconds: row.scan_interval_seconds,
+        lastEvaluationAt: row.last_evaluation_at,
+        lastFireAt: row.last_fire_at,
+        actionable: row.actionable !== 0,
+        lastActionableAt: row.last_actionable_at,
+        state: row.state,
+        registeredBySession: row.registered_by_session,
+        registeredAt: row.registered_at,
+        terminalReason: row.terminal_reason,
+    };
+}
+//# sourceMappingURL=watchdog-jobs-repository.js.map

package/daemon/dist/domain/watchdog-jobs-repository.js.map

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

package/daemon/dist/domain/watchdog-policy-engine.d.ts

@@ -0,0 +1,92 @@
+import type { EventBus } from "./event-bus.js";
+import type { Policy, PolicyEvaluation } from "./policies/types.js";
+import { type WatchdogJob, type WatchdogJobsRepository } from "./watchdog-jobs-repository.js";
+import type { WatchdogHistoryEntry, WatchdogHistoryLog } from "./watchdog-history-log.js";
+/**
+ * Watchdog policy engine (PL-004 Phase C R1).
+ *
+ * Owns the per-evaluation state machine that mirrors POC engine
+ * `lib/engine.mjs`:
+ *   1. Resolve policy by name from registry. Unknown policy → terminal.
+ *   2. Parse spec_yaml into top-level `target:` + top-level `message?:` +
+ *      nested `context:` block, then build a PolicyJob with the
+ *      resolved target object (falls back to registered targetSession
+ *      when spec lacks an explicit `target:`).
+ *   3. Dispatch policy.evaluate(policyJob).
+ *   4. Action handling:
+ *      - skip: clear actionable=false; record history + emit event
+ *        ONLY if reason is "loud" (not in QUIET_SKIP_REASONS).
+ *      - send: enforce active-wake throttle. If state.actionable was
+ *        already true AND active_wake_interval_seconds is set AND not
+ *        elapsed since last_fire_at → emit/record `active_wake_not_due`
+ *        (quiet skip per POC). Otherwise call delivery, record history
+ *        with sent outcome, emit evaluation_fired, set actionable=true.
+ *      - terminal: mark job terminal, record history, emit terminal.
+ *
+ * `not_due` polls are filtered upstream by the scheduler and never
+ * reach this engine.
+ */
+export interface DeliveryRequest {
+    targetSession: string;
+    message: string;
+}
+export interface DeliveryOutcome {
+    status: "ok" | "failed";
+    error?: string;
+}
+export type DeliveryFn = (req: DeliveryRequest) => Promise<DeliveryOutcome>;
+export interface PolicyContextParser {
+    /**
+     * Parse the operator-supplied spec_yaml into the structured fields the
+     * engine needs. Returns the top-level `target` (object), top-level
+     * `message` (string), and the `context:` block (Record).
+     */
+    (specYaml: string): {
+        target: {
+            session: string;
+        } | null;
+        message: string | null;
+        context: Record<string, unknown>;
+    };
+}
+interface WatchdogPolicyEngineDeps {
+    jobsRepo: WatchdogJobsRepository;
+    historyLog: WatchdogHistoryLog;
+    eventBus: EventBus;
+    deliver: DeliveryFn;
+    parseSpec?: PolicyContextParser;
+    now?: () => Date;
+    /**
+     * PL-004 Phase D extension point (orch-ratified per slice IMPL):
+     * additional policies to register alongside the Phase C built-in
+     * three. Used to register `workflow-keepalive` (which depends on
+     * the Phase D workflow_instances DB and so must be constructed at
+     * daemon startup with a db handle injected).
+     */
+    additionalPolicies?: Policy[];
+}
+export interface EvaluationResult {
+    job: WatchdogJob;
+    outcome: PolicyEvaluation | {
+        action: "skip";
+        reason: "active_wake_not_due";
+    };
+    history: WatchdogHistoryEntry | null;
+    delivery: DeliveryOutcome | null;
+    /** True if this evaluation produced a history record + event. */
+    meaningful: boolean;
+}
+export declare class WatchdogPolicyEngine {
+    private readonly jobsRepo;
+    private readonly historyLog;
+    private readonly eventBus;
+    private readonly deliver;
+    private readonly parseSpec;
+    private readonly now;
+    private readonly policies;
+    constructor(deps: WatchdogPolicyEngineDeps);
+    resolvePolicy(name: string): Policy | undefined;
+    evaluate(job: WatchdogJob): Promise<EvaluationResult>;
+}
+export {};
+//# sourceMappingURL=watchdog-policy-engine.d.ts.map

package/daemon/dist/domain/watchdog-policy-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-policy-engine.d.ts","sourceRoot":"","sources":["../../src/domain/watchdog-policy-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAa,MAAM,qBAAqB,CAAC;AAI/E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAqBD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC;IAC9E,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,iEAAiE;IACjE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,IAAI,EAAE,wBAAwB;IAc1C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA0K5D"}