@kici-dev/orchestrator 0.1.3 → 0.1.5

package/dist/stale-detector/stale-run-detector.d.ts

@@ -96,8 +96,20 @@ export declare class StaleRunDetector {
     private scanStaleRunningJobsNullHeartbeat;
     /**
      * Sub-scan C: Find dispatched entries that were never acknowledged.
-     * Only checks 'dispatched' status (job sent to agent but agent never started it).
-     * 'queued' jobs are legitimately waiting for agents and handled by queue timeout instead.
+     *
+     * Only catches dispatches that the agent never started — i.e., the
+     * dispatch_queue row is still 'dispatched' AND there is no
+     * execution_jobs row in 'running' state. When the agent has reported
+     * the job as running (so execution_jobs.status='running'), heartbeat
+     * supervision falls to sub-scans A and B, which look at
+     * `execution_jobs.last_heartbeat_at`. Without this filter, a long
+     * job whose first step legitimately exceeds the dispatch threshold
+     * (e.g. an inline `npm install` for a workflow that imports
+     * `@kici-dev/sdk`) would be marked stale here before sub-scan A's
+     * heartbeat path has a chance to keep it alive.
+     *
+     * 'queued' jobs are legitimately waiting for agents and handled by
+     * the queue timeout in {@link JobQueue.markExpired} instead.
      */
     private scanStaleDispatchedJobs;
     /**