@aitne/daemon 0.1.7 → 0.1.8

package/dist/core/dispatcher-hourly-check.d.ts

@@ -49,6 +49,7 @@
  *     a refresh, matching pre-injection behaviour.
  */
 import type Database from "better-sqlite3";
+import type { IntegrationKey } from "@aitne/shared";
 import type { AgentConfig } from "../config.js";
 import type { EventBus } from "./event-bus.js";
 import type { TodayWriteLockManager } from "./today-write-lock.js";
@@ -66,7 +67,7 @@ export interface HourlyCheckCoordinatorDeps {
     todayWriteLock: TodayWriteLockManager | undefined;
     prompt: PromptAssembler;
     /**
-     * ROUTINE_DATA_ACQUISITION_DESIGN.md Phase 4 / D3 — pre-pass runner
+     * docs/design/appendices/routine-data-acquisition.md Phase 4 / D3 — pre-pass runner
      * spawned between Stage 2 (lite-tier triage) and Stage 3 (medium-tier
      * main session) on `escalate` / `failed` verdicts. The rendered
      * `<fetch_report>` block rides on the Stage 3 RoutineEvent's
@@ -89,6 +90,59 @@ export interface HourlyCheckCoordinatorDeps {
      * permitted to proceed.
      */
     isAutonomousAllowed: () => TriggerHourlyCheckSkipReason | null;
+    /**
+     * Accessor for the scheduler's `queueMorningRoutineWake`. Returns the
+     * bound function once wiring has completed, or `null` early in startup
+     * before the scheduler is constructed. The pre-routine gate calls this
+     * when it detects the current agent-day's morning_routine has not run
+     * yet (typical cause: Mac slept through the 04:00 cron tick). The
+     * wake row carries the dedup guarantee — multiple back-to-back hourly
+     * ticks all see the same in-flight row instead of stacking up.
+     */
+    getQueueMorningRoutineWake: () => QueueMorningRoutineWake | null;
+}
+/** Signature of `AgentScheduler.queueMorningRoutineWake`, narrowed to the
+ *  surface the dispatcher gate consumes. Kept structural so we don't pull
+ *  the scheduler class into this module just for a type reference. */
+export type QueueMorningRoutineWake = (source: string, options?: {
+    postCatchupRoutines?: string[];
+    postCatchupHourlyCheck?: boolean;
+}) => {
+    inserted: boolean;
+    existingId?: number;
+};
+/**
+ * HOURLY_CHECK_GATE_REDESIGN_PLAN.md §3.3 + §7.2 — outcome of the
+ * Layer-1 pre-pass harvest that runs at the top of `trigger()` for
+ * delegated/native integrations. Surfaced both in the audit row (per-
+ * tick observability) and on the Stage 3 event (the rendered
+ * `<fetch_report>` block).
+ */
+export interface HarvestResult {
+    /** True when at least one integration was eligible and the runner ran. */
+    ran: boolean;
+    /** Integrations whose sub-session completed successfully or partially. */
+    integrations: IntegrationKey[];
+    /** Eligible integrations suppressed by the freshness window. */
+    skippedIntegrations: IntegrationKey[];
+    /** Eligible integrations whose sub-session ended in `failed`. */
+    failedIntegrations: IntegrationKey[];
+    /** Wall-clock time spent on the harvest (ms). */
+    durationMs: number;
+    /**
+     * True when any eligible integration failed. Triggers §3.5 cautious-
+     * escalate: gate decision is forced to `stage3` regardless of the
+     * signal verdict so a fetch outage doesn't manifest as silent
+     * stage0.
+     */
+    failed: boolean;
+    /**
+     * Rendered `<fetch_report>` block from the runner, ready to plumb
+     * onto `stage3Event.data.fetchReportBlock`. `null` when the runner
+     * was not spawned (no eligible integrations) — in that case the
+     * Stage 3 prompt simply omits the block.
+     */
+    fetchReportBlock: string | null;
 }
 export declare class HourlyCheckCoordinator {
     private readonly db;
@@ -105,8 +159,26 @@ export declare class HourlyCheckCoordinator {
     private readonly isHourlyCheckInProgress;
     private readonly isMorningRoutineActive;
     private readonly isAutonomousAllowed;
+    private readonly getQueueMorningRoutineWake;
     constructor(deps: HourlyCheckCoordinatorDeps);
     trigger(source: string, options?: TriggerHourlyCheckOptions): Promise<TriggerHourlyCheckResult>;
+    /**
+     * HOURLY_CHECK_GATE_REDESIGN_PLAN.md §3.3 Layer 1 — pre-pass harvest
+     * for active non-direct integrations. Reads the per-integration
+     * `pre_pass_last_run:<key>` freshness key; integrations whose last
+     * successful run is within `hourlyCheckPrePassFreshnessMinutes` are
+     * skipped this tick. Forced runs (`/api/agent/run-now`) bypass the
+     * freshness gate.
+     *
+     * Returns a `HarvestResult` so the caller can:
+     *   - emit telemetry (which integrations fetched, which skipped on
+     *     freshness, which failed),
+     *   - cautious-escalate when any non-direct integration failed
+     *     (§3.5 — prevents silent stage0 from masking a fetch outage),
+     *   - plumb the rendered `<fetch_report>` block onto the Stage 3
+     *     event so ContextBuilder folds it into the prompt.
+     */
+    private harvestForGate;
     /**
      * cost-reduction-structural §B — pull a fresh signal snapshot and run
      * the deterministic gate. Helper so the dispatcher's call site stays

package/dist/core/dispatcher-hourly-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher-hourly-check.d.ts","sourceRoot":"","sources":["../../src/core/dispatcher-hourly-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAe3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAKjF,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,eAAe,CAAC;IAChC,WAAW,EAAE,YAAY,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,cAAc,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClD,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;;OAOG;IACH,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,wEAAwE;IACxE,uBAAuB,EAAE,MAAM,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5D,gEAAgE;IAChE,wBAAwB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,gEAAgE;IAChE,uBAAuB,EAAE,MAAM,OAAO,CAAC;IACvC,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,OAAO,CAAC;IACtC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,4BAA4B,GAAG,IAAI,CAAC;CAChE;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAqC;IAC7E,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAgB;IACxD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4C;gBAEpE,IAAI,EAAE,0BAA0B;IAiBtC,OAAO,CACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC;IAgUpC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAoBtC,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;YA0ElB,wBAAwB;IAoEtC,OAAO,CAAC,eAAe;IA8DvB;;;;;;;;;;;;;;;;;;;;;OAqBG;YACW,eAAe;CA2F9B"}
+{"version":3,"file":"dispatcher-hourly-check.d.ts","sourceRoot":"","sources":["../../src/core/dispatcher-hourly-check.ts"],"names":[],"mappings":"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"}