@kici-dev/orchestrator 0.6.1 → 0.7.0

package/dist/sources/source-manager.d.ts

@@ -56,7 +56,7 @@ export interface SourceManagerOptions {
  */
 export declare class SourceManager {
     private readonly opts;
-    private client;
+    private listener;
     private registry;
     private currentSources;
     private debounceTimer;

package/dist/stale-detector/stale-dispatch-candidates.d.ts

@@ -0,0 +1,43 @@
+import { type Kysely } from 'kysely';
+import type { Database } from '../db/types.js';
+/** One dispatch row the stale scan may reap, with the run facts its verdict needs. */
+export interface StaleDispatchCandidate {
+    id: string;
+    run_id: string;
+    job_name: string;
+    status: string;
+    workflow_name: string;
+    repo_identifier: string;
+    workflow_repo_identifier: string | null;
+    trust_tier: string | null;
+    lock_file_source: string | null;
+    sha: string;
+    provider: string;
+    provider_context: string | null;
+    routing_key: string | null;
+}
+/**
+ * The dispatch rows that have gone unacknowledged long enough to reap.
+ *
+ * Split out of the detector so the three predicates that decide the verdict can
+ * be asserted against a real Postgres — they are raw SQL, and a mock records
+ * them without evaluating them.
+ *
+ * - **Both bounds read the DISPATCH clock**, not the enqueue clock.
+ *   `created_at` is when the job was queued, so keying on it measured "enqueued
+ *   more than two minutes ago and not yet reported running" — true of every job
+ *   that waited behind a busy fleet. A job claimed at 3:00 after a scaler cold
+ *   start, then cloning its repo and installing dependencies, was reaped at 3:30
+ *   with "dispatch never acknowledged" while the agent ran it to completion for
+ *   nothing.
+ * - **The COALESCE is the rolling-upgrade bridge.** A row dispatched before
+ *   `dispatched_at` existed carries NULL and keeps exactly the previous
+ *   behaviour. That is also what makes startup recovery's decision to spare an
+ *   unknown-owner row safe: a spared orphan is still reaped here.
+ * - **An acked dispatch is never reaped.** A row whose `ack_deadline` was
+ *   cleared while `ack_agent_id` is stamped was acknowledged, and the ack path
+ *   owns it. This scan's residual job is the never-acked, crashed-coordinator
+ *   case; the heartbeat sub-scans cover a job that acked and then went quiet.
+ */
+export declare function selectStaleDispatchCandidates(db: Kysely<Database>, threshold: Date, timeBound: Date): Promise<StaleDispatchCandidate[]>;
+//# sourceMappingURL=stale-dispatch-candidates.d.ts.map