@kynver-app/runtime 0.1.102 → 0.1.105

package/dist/index.js

@@ -2128,7 +2128,7 @@ var NO_START_MS = 18e4;
 var STALE_MS = 6e5;
 function computeAttention(input) {
   const now = Date.now();
-  if (input.completionBlocker) {
+  if (input.completionBlocker && !isSkippedTerminalCompletionBlocker(input.completionBlocker)) {
     return { state: "blocked", reason: input.completionBlocker };
   }
   if (input.finalResult) {
@@ -2166,6 +2166,9 @@ function computeAttention(input) {
     return { state: "done", reason: "final result recorded" };
   }
   if (!input.alive) {
+    if (isAbandonedEmptyWorker(input)) {
+      return { state: "done", reason: "empty abandoned worker record" };
+    }
     const classified = classifyExitFailure(input.error);
     if (classified) return { state: "blocked", reason: classified.reason };
     const salvage = assessExitedWorkerSalvage({
@@ -2200,6 +2203,19 @@ function computeAttention(input) {
   }
   return { state: "ok", reason: "recent activity" };
 }
+function isSkippedTerminalCompletionBlocker(reason) {
+  const text = reason?.trim();
+  if (!text) return false;
+  return /completion acknowledged but board not advanced/i.test(text) && /task already terminal/i.test(text);
+}
+function isAbandonedEmptyWorker(input) {
+  if (input.finalResult) return false;
+  if (input.taskId || input.agentOsId) return false;
+  if (input.stdoutBytes > 0 || (input.stderrBytes ?? 0) > 0 || input.heartbeatBytes > 0) return false;
+  if (input.error?.trim()) return false;
+  if ((input.changedFiles ?? []).some((line) => line.trim())) return false;
+  return /empty worker dir|marked abandoned/i.test(input.reconcileReason ?? "");
+}
 function hasMergedTargetPrReconciliation(value) {
   let record3 = null;
   if (typeof value === "string") record3 = extractEmbeddedWorkerFinalResultRecord(value);
@@ -2244,6 +2260,7 @@ function computeWorkerStatus(worker, options = {}) {
   ]);
   const error = parsed.error || (!alive && !finalResult ? tailFile(worker.stderrPath, 10).trim() || void 0 : void 0);
   const completionBlocker = typeof worker.completionBlocker === "string" && worker.completionBlocker.trim() ? worker.completionBlocker.trim() : null;
+  const effectiveCompletionBlocker = isSkippedTerminalCompletionBlocker(completionBlocker) ? null : completionBlocker;
   const landingContract = worker.repairTargetPrUrl ? {
     landingOnly: false,
     targetPrUrls: [worker.repairTargetPrUrl],
@@ -2255,6 +2272,7 @@ function computeWorkerStatus(worker, options = {}) {
     finalResult,
     firstEventAt: parsed.firstEventAt,
     stdoutBytes,
+    stderrBytes,
     heartbeatBytes,
     lastActivityAt,
     heartbeatBlocker: heartbeat.heartbeatBlocker,
@@ -2262,12 +2280,15 @@ function computeWorkerStatus(worker, options = {}) {
     error,
     changedFiles,
     gitAncestry,
-    completionBlocker,
+    completionBlocker: effectiveCompletionBlocker,
     landingContract,
     prUrl: worker.repairTargetPrUrl ?? worker.taskPrUrl ?? null,
-    localOnly: worker.localOnly === true
+    localOnly: worker.localOnly === true,
+    taskId: worker.taskId ?? null,
+    agentOsId: worker.agentOsId ?? null,
+    reconcileReason: worker.reconcileReason ?? null
   });
-  const workerStatusLabel = completionBlocker || attention.state === "blocked" ? "blocked" : completionAcknowledged || attention.state === "done" ? "done" : finalResult ? "exited" : alive ? "running" : "exited";
+  const workerStatusLabel = effectiveCompletionBlocker || attention.state === "blocked" ? "blocked" : completionAcknowledged || attention.state === "done" ? "done" : finalResult ? "exited" : alive ? "running" : "exited";
   return {
     runId: worker.runId,
     worker: worker.name,
@@ -3203,6 +3224,9 @@ function enforceCursorWorkerProvider(input) {
   if (taskAllowsClaudeWorker(task)) {
     return routing;
   }
+  if (routing.rule === "explicit:cli" && isClaudeFamilyProvider(routing.provider)) {
+    return routing;
+  }
   if (!isClaudeFamilyProvider(routing.provider)) {
     return routing;
   }
@@ -4256,7 +4280,7 @@ function resolveWorkerLaunch(input) {
   if (!input.task || Object.keys(input.task).length === 0) {
     return afterCursorPolicy;
   }
-  if (afterCursorPolicy.rule === "explicit:model_provider_alias" || afterCursorPolicy.rule === "explicit:model_provider_alias_overrode_provider") {
+  if (afterCursorPolicy.rule === "explicit:model_provider_alias" || afterCursorPolicy.rule === "explicit:model_provider_alias_overrode_provider" || afterCursorPolicy.rule === "explicit:cli") {
     return afterCursorPolicy;
   }
   if (isClaudeFamilyProvider(afterCursorPolicy.provider) && (input.explicitProviderIsOperatorOverride || taskAllowsClaudeWorker(input.task))) {
@@ -4873,6 +4897,7 @@ function asString(value) {
 var ADVANCED_OUTCOMES = /* @__PURE__ */ new Set([
   "review_scheduled",
   "review_already_scheduled",
+  "skipped_terminal_task",
   "closed",
   "dispatched",
   "dispatch_already_done"
@@ -5220,6 +5245,36 @@ function defaultPrBody(taskId, workerName, runId) {
     "Opened by orchestrator completion enforcement so production review receives a reviewable artifact."
   ].filter(Boolean).join("\n");
 }
+function commitDirtyToExistingPr(input) {
+  if (input.snapshot.changedFiles.length === 0) {
+    return {
+      ok: true,
+      prUrl: input.prUrl,
+      headCommit: input.snapshot.headCommit ?? resolveHeadCommit(input.snapshot.worktreePath, input.exec) ?? void 0
+    };
+  }
+  const pushResult = commitAndPushBranch({
+    worktreePath: input.snapshot.worktreePath,
+    branch: input.snapshot.branch,
+    commitMessage: input.commitMessage,
+    hasDirtyFiles: true,
+    exec: input.exec
+  });
+  if (!pushResult.ok) {
+    return {
+      ok: false,
+      reason: `PR-ready handoff blocked: ${pushResult.detail ?? "git commit/push failed"}`,
+      nextAction: "Commit and push the dirty worker changes to the existing PR branch, then rerun `kynver worker complete`."
+    };
+  }
+  return {
+    ok: true,
+    prUrl: input.prUrl,
+    headCommit: pushResult.headCommit ?? input.snapshot.headCommit ?? void 0,
+    committed: pushResult.committed,
+    pushed: pushResult.pushed
+  };
+}
 function ensurePrReadyHandoff(input, exec = defaultPrHandoffExec) {
   const prUrlHint = input.prUrlHint ?? extractPrUrlFromText(input.status.finalResult) ?? null;
   const snapshot = buildPrHandoffSnapshotFromStatus(input.status, {
@@ -5243,10 +5298,23 @@ function ensurePrReadyHandoff(input, exec = defaultPrHandoffExec) {
     snapshot
   });
   if (!requirement.required) {
-    return { ok: true, prUrl: prUrlHint ?? void 0 };
+    if (prUrlHint) {
+      return commitDirtyToExistingPr({
+        snapshot,
+        prUrl: prUrlHint,
+        commitMessage: `chore(harness): update PR handoff for ${input.worker.name}`,
+        exec
+      });
+    }
+    return { ok: true };
   }
   if (prUrlHint) {
-    return { ok: true, prUrl: prUrlHint };
+    return commitDirtyToExistingPr({
+      snapshot,
+      prUrl: prUrlHint,
+      commitMessage: `chore(harness): update PR handoff for ${input.worker.name}`,
+      exec
+    });
   }
   if (!ghAvailable(exec)) {
     const dirty = snapshot.changedFiles.length;
@@ -5309,11 +5377,12 @@ function ensurePrReadyHandoff(input, exec = defaultPrHandoffExec) {
   }
   const existing = findOpenPrUrl(snapshot.worktreePath, repo, snapshot.branch, exec);
   if (existing) {
-    return {
-      ok: true,
+    return commitDirtyToExistingPr({
+      snapshot,
       prUrl: existing,
-      headCommit: snapshot.headCommit ?? resolveHeadCommit(snapshot.worktreePath, exec) ?? void 0
-    };
+      commitMessage: `chore(harness): update PR handoff for ${input.worker.name}`,
+      exec
+    });
   }
   const hasDirty = snapshot.changedFiles.length > 0;
   let committed = false;
@@ -5723,6 +5792,11 @@ function deriveNextAction(input) {
   }
   return null;
 }
+function isSkippedTerminalCompletionBlocker2(reason) {
+  const text = reason?.trim();
+  if (!text) return false;
+  return /completion acknowledged but board not advanced/i.test(text) && /task already terminal/i.test(text);
+}
 function deriveHandoffState(input) {
   if (input.prUrl) return "pr_handoff";
   if (input.headCommit) return "commit_handoff";
@@ -5779,6 +5853,23 @@ async function tryCompleteWorker(args) {
   if (!forceReplay && shouldReplayHarnessCompletion(worker)) {
     clearCompletionBlockerForReplay(worker);
   }
+  const skipPrHandoff = args.skipPrHandoff === true || args.skipPrHandoff === "true";
+  if (!skipPrHandoff && worker.dispatched && taskId) {
+    const handoff = ensurePrReadyHandoff({ worker, run, status });
+    if (!handoff.ok) {
+      persistCompletionBlocker(worker, handoff.reason);
+      return {
+        ok: false,
+        reason: handoff.reason,
+        nextAction: handoff.nextAction,
+        completionBlocked: true
+      };
+    }
+    if (handoff.prUrl || handoff.headCommit) {
+      status = computeWorkerStatus(worker, workerStatusOptions(run));
+      status = applyPrHandoffToStatus(status, handoff);
+    }
+  }
   const headCommit = status.gitAncestry.headIsAncestorOfBase === false && status.gitAncestry.head ? status.gitAncestry.head : status.headCommit;
   if (worker.dispatched) {
     const handoff = assessWorktreeCompletionHandoff({
@@ -5799,22 +5890,6 @@ async function tryCompleteWorker(args) {
       };
     }
   }
-  const skipPrHandoff = args.skipPrHandoff === true || args.skipPrHandoff === "true";
-  if (!skipPrHandoff && worker.dispatched && taskId) {
-    const handoff = ensurePrReadyHandoff({ worker, run, status });
-    if (!handoff.ok) {
-      persistCompletionBlocker(worker, handoff.reason);
-      return {
-        ok: false,
-        reason: handoff.reason,
-        nextAction: handoff.nextAction,
-        completionBlocked: true
-      };
-    }
-    if (handoff.prUrl || handoff.headCommit) {
-      status = applyPrHandoffToStatus(status, handoff);
-    }
-  }
   const base = resolveBaseUrl(args.baseUrl ? String(args.baseUrl) : void 0);
   const explicitSecret = args.secret ? String(args.secret) : void 0;
   let secret = await resolveCallbackSecretWithMint(explicitSecret, agentOsId, { baseUrl: base });
@@ -6020,7 +6095,8 @@ function buildWorkerBoardEntry(input) {
     headCommit
   });
   const rawBlocker = worker.completionBlocker;
-  const completionBlocker = typeof rawBlocker === "string" && rawBlocker ? rawBlocker : void 0;
+  const rawCompletionBlocker = typeof rawBlocker === "string" && rawBlocker ? rawBlocker : void 0;
+  const completionBlocker = isSkippedTerminalCompletionBlocker2(rawCompletionBlocker) ? void 0 : rawCompletionBlocker;
   const boardStatus = completionBlocker ? "blocked" : status.status;
   const boardAttention = completionBlocker ? "blocked" : status.attention.state;
   const completionResponse = asRecord3(worker.completionResponse);
@@ -6105,7 +6181,8 @@ function buildWorkerBoardEntry(input) {
 }
 function isMetadataTerminalDone(worker) {
   const status = typeof worker.status === "string" ? worker.status : "";
-  const completionBlocker = typeof worker.completionBlocker === "string" && worker.completionBlocker.trim().length > 0;
+  const rawCompletionBlocker = typeof worker.completionBlocker === "string" && worker.completionBlocker.trim().length > 0 ? worker.completionBlocker : void 0;
+  const completionBlocker = rawCompletionBlocker && !isSkippedTerminalCompletionBlocker2(rawCompletionBlocker);
   if (completionBlocker) return false;
   if (typeof worker.completionReportedAt === "string" && worker.completionReportedAt.trim()) return true;
   if (worker.completionOutcome === "acknowledged") return true;
@@ -7367,6 +7444,11 @@ function readAdmissionExhaustion(result) {
   if (!raw || typeof raw !== "object") return null;
   return raw;
 }
+function readDispatchSkipDrain(result) {
+  const raw = result.dispatchSkipDrain;
+  if (!raw || typeof raw !== "object") return null;
+  return raw;
+}
 function readHarnessWorkerContext(decision) {
   const raw = decision.harnessWorkerContext;
   if (!raw || typeof raw !== "object") return null;
@@ -7530,6 +7612,7 @@ async function dispatchRun(args) {
     const result = first.result;
     if (dryRun) {
       const admissionExhaustion2 = readAdmissionExhaustion(result);
+      const dispatchSkipDrain2 = readDispatchSkipDrain(result);
       const summary2 = {
         runId: run.id,
         agentOsId,
@@ -7548,7 +7631,8 @@ async function dispatchRun(args) {
         pagesScanned: result.pagesScanned ?? null,
         candidatesExhausted: result.candidatesExhausted ?? null,
         capacityIdle: admissionExhaustion2?.capacityIdle === true,
-        admissionExhaustion: admissionExhaustion2
+        admissionExhaustion: admissionExhaustion2,
+        dispatchSkipDrain: dispatchSkipDrain2
       };
       if (pipeline) return { ok: true, ...summary2 };
       console.log(JSON.stringify(summary2, null, 2));
@@ -7738,13 +7822,15 @@ async function dispatchRun(args) {
     }
     const startedCount = outcomes.filter((o) => o.started).length;
     const admissionExhaustion = readAdmissionExhaustion(result);
-    const capacityIdle = admissionExhaustion?.capacityIdle === true || startedCount === 0 && Number(result.resourceGate?.slotsAvailable) > 0;
+    const dispatchSkipDrain = readDispatchSkipDrain(result);
+    const capacityIdle = startedCount === 0 && (admissionExhaustion?.capacityIdle === true || Number(result.resourceGate?.slotsAvailable) > 0);
     if (capacityIdle && admissionExhaustion?.summary) {
       const retryCeiling = admissionExhaustion.skipReasonCounts?.retry_ceiling_exceeded ?? 0;
-      const recovery = admissionExhaustion.overAttemptIdleRecovery;
+      const recovery = result.overAttemptIdleRecovery ?? admissionExhaustion.overAttemptIdleRecovery;
       const recoveryNote = recovery?.attempted === true ? `; over_attempt_recovery minted=${recovery.minted ?? 0} started=${recovery.started ?? 0}` : retryCeiling > 0 ? "; over_attempt_recovery not attempted" : "";
+      const drainNote = dispatchSkipDrain ? `; dispatch_skip_drain scanned=${dispatchSkipDrain.scanned ?? 0} advanced=${dispatchSkipDrain.advanced ?? 0}` : "";
       console.error(
-        `[dispatch] ${admissionExhaustion.summary}${retryCeiling > 0 ? `; retry_ceiling_exceeded=${retryCeiling}` : ""}${recoveryNote}`
+        `[dispatch] ${admissionExhaustion.summary}${retryCeiling > 0 ? `; retry_ceiling_exceeded=${retryCeiling}` : ""}${recoveryNote}${drainNote}`
       );
     }
     const summary = {
@@ -7755,6 +7841,7 @@ async function dispatchRun(args) {
       startedCount,
       capacityIdle,
       admissionExhaustion,
+      dispatchSkipDrain,
       outcomes,
       skipped: skipped.map((d) => ({
         taskId: d.task.id,
@@ -9714,30 +9801,7 @@ function indexedWorktreeHasMaterialChanges(entry) {
   return materialWorktreeChanges2(gitStatusShort(entry.worktreePath)).length > 0;
 }
 
-// src/cleanup-run-liveness.ts
-function deriveRunTerminal(indexed, ctx) {
-  if (ctx) return ctx.runTerminalCache.derive(indexed.run);
-  return deriveTerminalRunStatus(indexed.run);
-}
-function isWorkerProcessLive(indexed) {
-  if (isPidAlive(indexed.worker.pid)) return true;
-  if (!indexed.worker.pid) return indexedWorktreeStatus(indexed).alive;
-  return false;
-}
-function isRunStaleActive(indexed, ctx) {
-  if (TERMINAL_RUN_STATUSES.has(indexed.run.status)) return false;
-  return deriveRunTerminal(indexed, ctx) !== null;
-}
-function runBlocksWorktreeRemoval(indexed, ctx) {
-  if (isWorkerProcessLive(indexed)) return true;
-  if (indexed.worker.completionBlocker) return true;
-  if (TERMINAL_RUN_STATUSES.has(indexed.run.status)) return false;
-  if (isRunStaleActive(indexed, ctx)) return false;
-  if (!isFinishedWorkerStatus(indexedWorktreeStatus(indexed))) return true;
-  return deriveRunTerminal(indexed, ctx) === null;
-}
-
-// src/cleanup-guards.ts
+// src/cleanup-worktree-salvage.ts
 function prUrlFromFinalResult(finalResult) {
   if (typeof finalResult === "string") {
     const match = finalResult.match(/https:\/\/github\.com\/[^\s]+\/pull\/\d+/i);
@@ -9762,12 +9826,63 @@ function isPrOrUnmergedWork(status) {
   if (status.changedFiles.length > 0 && status.finalResult) return true;
   return false;
 }
+
+// src/cleanup-completion-blocker.ts
+function completionBlockerBlocksWorktreeRemoval(indexed, status) {
+  const blocker = typeof indexed.worker.completionBlocker === "string" ? indexed.worker.completionBlocker.trim() : "";
+  if (!blocker) return false;
+  if (isWorkerProcessLive(indexed)) return true;
+  const resolved = status ?? indexedWorktreeStatus(indexed);
+  if (!isFinishedWorkerStatus(resolved)) return true;
+  if (isPrOrUnmergedWork(resolved)) return true;
+  if (materialWorktreeChanges2(resolved.changedFiles).length > 0) return true;
+  const landing = assessWorkerLanding({
+    finalResult: resolved.finalResult,
+    changedFiles: resolved.changedFiles,
+    gitAncestry: resolved.gitAncestry,
+    prUrl: prUrlFromFinalResult(resolved.finalResult)
+  });
+  if (landing.blocked) return true;
+  return false;
+}
+
+// src/cleanup-run-liveness.ts
+function deriveRunTerminal(indexed, ctx) {
+  if (ctx) return ctx.runTerminalCache.derive(indexed.run);
+  return deriveTerminalRunStatus(indexed.run);
+}
+function isWorkerProcessLive(indexed) {
+  if (isPidAlive(indexed.worker.pid)) return true;
+  if (!indexed.worker.pid) return indexedWorktreeStatus(indexed).alive;
+  return false;
+}
+function isRunStaleActive(indexed, ctx) {
+  if (TERMINAL_RUN_STATUSES.has(indexed.run.status)) return false;
+  return deriveRunTerminal(indexed, ctx) !== null;
+}
+function runBlocksWorktreeRemoval(indexed, ctx) {
+  if (isWorkerProcessLive(indexed)) return true;
+  const status = indexedWorktreeStatus(indexed);
+  if (completionBlockerBlocksWorktreeRemoval(indexed, status)) return true;
+  if (isFinishedWorkerStatus(status)) return false;
+  if (TERMINAL_RUN_STATUSES.has(indexed.run.status)) return false;
+  if (isRunStaleActive(indexed, ctx)) return false;
+  return deriveRunTerminal(indexed, ctx) === null;
+}
+
+// src/cleanup-guards.ts
 function effectiveWorktreeAgeMs(input) {
   const { indexed, includeOrphans, worktreesAgeMs, terminalWorktreesAgeMs } = input;
   if (!indexed) return includeOrphans ? terminalWorktreesAgeMs : worktreesAgeMs;
   if (TERMINAL_RUN_STATUSES.has(indexed.run.status)) {
     return terminalWorktreesAgeMs;
   }
+  if (input.liveness && isRunStaleActive(indexed, input.liveness)) {
+    return terminalWorktreesAgeMs;
+  }
+  if (input.liveness && isFinishedWorkerStatus(indexedWorktreeStatus(indexed)) && !isWorkerProcessLive(indexed)) {
+    return terminalWorktreesAgeMs;
+  }
   return worktreesAgeMs;
 }
 function skipWorktreeRemoval(input) {
@@ -9781,7 +9896,7 @@ function skipWorktreeRemoval(input) {
   if (ageThresholdMs > 0 && ageMs < ageThresholdMs) return "below_age_threshold";
   const status = indexedWorktreeStatus(indexed);
   if (isWorkerProcessLive(indexed)) return "active_worker";
-  if (indexed.worker.completionBlocker) return "completion_blocked";
+  if (completionBlockerBlocksWorktreeRemoval(indexed, status)) return "completion_blocked";
   if (runBlocksWorktreeRemoval(indexed, input.liveness)) return "run_still_active";
   if (!isFinishedWorkerStatus(status)) return "run_still_active";
   if (isPrOrUnmergedWork(status)) return "pr_or_unmerged_commits";
@@ -9937,7 +10052,9 @@ function skipRunDirectoryRemoval(input) {
   }
   if (!runDirectoryIsEmpty(runPath)) return "run_still_active";
   const run = loadRunStatus(harnessRoot, runId);
-  if (run && !TERMINAL_RUN_STATUSES.has(run.status)) return "run_still_active";
+  if (run && !TERMINAL_RUN_STATUSES.has(run.status)) {
+    if (!deriveTerminalRunStatus(run)) return "run_still_active";
+  }
   if (runDirectoriesAgeMs > 0 && ageMs < runDirectoriesAgeMs) return "below_age_threshold";
   return null;
 }
@@ -10902,14 +11019,14 @@ function runHarnessCleanup(options = {}) {
   const paths = resolvePaths(options);
   emitCleanupProgress("scan", `${paths.scanRoots.length} harness root(s)`);
   const activeGuards = collectActiveWorktreeGuards(paths.scanRoots, paths.now);
-  emitCleanupProgress("index", "building worktree index");
-  const index = mergeWorktreeIndexes(paths.scanRoots);
-  emitCleanupProgress("index", `${index.size} indexed worktree(s)`);
-  const liveness = { runTerminalCache: new CleanupRunTerminalCache() };
   const finalizedRuns = retention.finalizeStaleRuns ? finalizeStaleRuns().map((f) => ({ runId: f.runId, from: f.from, to: f.to })) : [];
   if (finalizedRuns.length > 0) {
     emitCleanupProgress("finalize", `${finalizedRuns.length} stale run(s) marked terminal`);
   }
+  emitCleanupProgress("index", "building worktree index");
+  const index = mergeWorktreeIndexes(paths.scanRoots);
+  emitCleanupProgress("index", `${index.size} indexed worktree(s)`);
+  const liveness = { runTerminalCache: new CleanupRunTerminalCache() };
   const skips = [];
   const actions = [];
   const processedPaths = /* @__PURE__ */ new Set();
@@ -14919,7 +15036,7 @@ async function runLandingMaintainerLaneTick(args) {
   const agentOsId = String(required(String(args.agentOsId || ""), "--agent-os-id"));
   const repoSlug = String(args.repo || LANDING_MAINTAINER_LANE_SPEC.defaultRepo).trim();
   const fleet = args.fleet === true || args.fleet === "true";
-  const execute = args.execute !== false && args.execute !== "false";
+  const execute = args.execute === true || args.execute === "true";
   const runId = args.run ? String(args.run) : void 0;
   const resourceGate = observeRunnerResourceGate({
     runId: runId ?? "fleet-lane-tick"