@hasna/loops 0.4.12 → 0.4.13

package/CHANGELOG.md

@@ -5,6 +5,38 @@ documented in this file. Version entries are generated from the
 conventional-commit git history; one commit maps to one released patch version
 unless noted.
 
+## 0.4.13 (2026-07-05)
+
+`--pr-handoff` workflows whose worker pushes its own branch and opens the PR
+directly (no handoff artifact — the cursor pattern) now complete instead of
+failing the pr-handoff step and skipping the verifier.
+
+### Fixed
+
+- **pr-handoff — no-artifact/direct-PR path exited 1 instead of 0:** the step
+  runs as `bash -lc` (a login shell). The no-artifact guard ended with an
+  explicit `exit 0` while `set -e` was active; under systemd (`SHLVL` unset →
+  bash sets 1) an explicit exit sources `~/.bash_logout`, whose `clear_console`
+  fails without a controlling TTY, and errexit handed that failure back as the
+  step's exit code. The workflow failed, the verifier (which depends on
+  pr-handoff) was skipped, and the source task was stranded `in_progress`.
+  Both guard branches now route through bun heredocs and fall through the `if`'s
+  natural end — no top-level shell `exit` — so the intended status is preserved
+  on the local and remote execution paths alike (gate steps already ended
+  naturally, which is why only pr-handoff failed). (#34)
+
+### Added
+
+- **Worker-opened PR detection on the no-artifact path:** when no handoff
+  artifact exists, pr-handoff now looks up the worker's own open PR for the
+  workflow branch (`gh pr list --head <branch> --state open`), records the same
+  `openloops:pr-handoff=done task=… pr=… commit=… branch=…` comment the
+  artifact path records, and exits 0 — so direct-PR (cursor-style) completions
+  carry PR evidence into the verifier and merge lane. Best-effort and
+  fail-open on lookup: a missing PR or a `gh`/`git`/`todos` error is logged,
+  writes no done-evidence, and never fails the step. The artifact (codewith)
+  handoff path is unchanged. (#34)
+
 ## 0.4.12 (2026-07-05)
 
 Drain throughput: `--max-active` is now a per-route ceiling instead of a

package/README.md

@@ -38,6 +38,16 @@ package. Cloud mode is a public contract until a cloud-specific hosted URL and
 cloud token are configured through `LOOPS_CLOUD_API_URL` plus
 `LOOPS_CLOUD_TOKEN` or `HASNA_LOOPS_CLOUD_TOKEN`.
 
+Scheduler state is explicit in status JSON. `schedulerState.localStore` is
+SQLite plus local run artifact files: authoritative in `local`, cache/spool in
+non-local modes. `schedulerState.remoteStore` names the non-local contract
+(`api_control_plane_contract`, `postgres_contract`, or
+`hosted_control_plane_contract`) and reports `applySupported=false` because this
+public package does not directly mutate remote Postgres, S3/object storage, AWS
+resources, or hosted credentials. Route admission remains bounded by
+`max_dispatch`, `max_active`, `max_active_per_project`,
+`max_active_per_project_group`, `max_active_scope`, and `max_per_profile`.
+
 Useful status commands:
 
 ```bash
@@ -524,11 +534,12 @@ workflow unless the event data or metadata has `route_enabled=true`,
 `automation.allowed=true`, or a task tag containing `auto:route`. It also skips
 blocked, completed/done, cancelled/canceled, failed, archived, manual,
 approval-required, or `no-auto` tasks. Terminal route work items such as
-failed, dead-letter, cancelled, or succeeded history stay deduped until an
-operator runs `loops routes requeue <work-item-id> --reason "<cause fixed>"`.
-The next route-created output records `requeue` evidence with the previous work
-item id, previous attempts, operator reason, new attempt, workflow id, and loop
-id.
+failed, dead-letter, cancelled, or succeeded history are re-admitted only when
+the todos task is still actionable, the per-attempt backoff has elapsed, and the
+redispatch cap has not been reached. Operators can still force a retry with
+`loops routes requeue <work-item-id> --reason "<cause fixed>"`. The next
+route-created output records `requeue` evidence with the previous work item id,
+previous attempts, reason, new attempt, workflow id, and loop id.
 
 Task route drains can select providers from task metadata instead of running one
 fixed provider/account pool for the whole drain. Add one or more

package/dist/api/index.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.12",
+  version: "0.4.13",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -194,6 +194,50 @@ function sourceOfTruthForMode(mode) {
     return "self_hosted_control_plane";
   return "cloud_control_plane";
 }
+var ROUTE_ADMISSION_GATES = [
+  "max_dispatch",
+  "max_active",
+  "max_active_per_project",
+  "max_active_per_project_group",
+  "max_active_scope",
+  "max_per_profile"
+];
+function remoteSchedulerBackendForMode(mode, config) {
+  if (mode === "local")
+    return "none";
+  if (mode === "cloud")
+    return config.cloudApiUrl ? "hosted_control_plane_contract" : "unconfigured";
+  if (config.databaseUrlPresent)
+    return "postgres_contract";
+  if (config.apiUrl)
+    return "api_control_plane_contract";
+  return "unconfigured";
+}
+function schedulerStateForMode(args) {
+  const nonLocal = args.deploymentMode !== "local";
+  return {
+    authority: args.sourceOfTruth,
+    localStore: {
+      backend: "sqlite",
+      role: args.localRole,
+      runArtifacts: "local_files",
+      routeAdmissionState: "workflow_work_items"
+    },
+    remoteStore: {
+      backend: remoteSchedulerBackendForMode(args.deploymentMode, args.config),
+      configured: nonLocal && args.controlPlaneConfigured,
+      applySupported: false,
+      objectArtifacts: nonLocal ? "object_store_contract" : "none",
+      mutatesAws: false
+    },
+    routeAdmission: {
+      stateStore: nonLocal ? "control_plane_contract" : "local_sqlite",
+      activeStatuses: ["admitted", "running"],
+      gates: ROUTE_ADMISSION_GATES,
+      dryRunEvaluatesLiveCounts: false
+    }
+  };
+}
 function displayControlPlaneUrl(value) {
   if (!value)
     return;
@@ -219,6 +263,9 @@ function buildDeploymentStatus(opts = {}) {
   if (deploymentMode === "self_hosted" && !controlPlaneConfigured) {
     warnings.push("self_hosted mode needs LOOPS_API_URL or LOOPS_DATABASE_URL before it can become authoritative");
   }
+  if (deploymentMode === "self_hosted" && config.databaseUrlPresent && !config.apiUrl) {
+    warnings.push("LOOPS_DATABASE_URL selects the self_hosted storage contract; loops-runner still needs LOOPS_API_URL to claim remote work");
+  }
   if (deploymentMode === "cloud" && config.apiUrl && !config.cloudApiUrl) {
     warnings.push("LOOPS_API_URL selects self_hosted; cloud mode uses LOOPS_CLOUD_API_URL");
   }
@@ -252,6 +299,13 @@ function buildDeploymentStatus(opts = {}) {
       required: deploymentMode !== "local",
       role: deploymentMode === "local" ? "daemon" : "control_plane_worker"
     },
+    schedulerState: schedulerStateForMode({
+      deploymentMode,
+      sourceOfTruth: sourceOfTruthForMode(deploymentMode),
+      localRole: deploymentMode === "local" ? "authoritative" : "cache_and_spool",
+      controlPlaneConfigured,
+      config
+    }),
     warnings
   };
 }
@@ -264,6 +318,7 @@ function deploymentStatusLine(status) {
     `source=${status.deploymentModeSource}`,
     `truth=${status.sourceOfTruth}`,
     `local=${status.localStore.role}`,
+    `scheduler=${status.schedulerState.routeAdmission.stateStore}`,
     `control_plane=${configured}`
   ].join(" ");
 }

package/dist/cli/index.js

@@ -4268,7 +4268,7 @@ class Store {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.12",
+  version: "0.4.13",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -4459,6 +4459,50 @@ function sourceOfTruthForMode(mode) {
     return "self_hosted_control_plane";
   return "cloud_control_plane";
 }
+var ROUTE_ADMISSION_GATES = [
+  "max_dispatch",
+  "max_active",
+  "max_active_per_project",
+  "max_active_per_project_group",
+  "max_active_scope",
+  "max_per_profile"
+];
+function remoteSchedulerBackendForMode(mode, config) {
+  if (mode === "local")
+    return "none";
+  if (mode === "cloud")
+    return config.cloudApiUrl ? "hosted_control_plane_contract" : "unconfigured";
+  if (config.databaseUrlPresent)
+    return "postgres_contract";
+  if (config.apiUrl)
+    return "api_control_plane_contract";
+  return "unconfigured";
+}
+function schedulerStateForMode(args) {
+  const nonLocal = args.deploymentMode !== "local";
+  return {
+    authority: args.sourceOfTruth,
+    localStore: {
+      backend: "sqlite",
+      role: args.localRole,
+      runArtifacts: "local_files",
+      routeAdmissionState: "workflow_work_items"
+    },
+    remoteStore: {
+      backend: remoteSchedulerBackendForMode(args.deploymentMode, args.config),
+      configured: nonLocal && args.controlPlaneConfigured,
+      applySupported: false,
+      objectArtifacts: nonLocal ? "object_store_contract" : "none",
+      mutatesAws: false
+    },
+    routeAdmission: {
+      stateStore: nonLocal ? "control_plane_contract" : "local_sqlite",
+      activeStatuses: ["admitted", "running"],
+      gates: ROUTE_ADMISSION_GATES,
+      dryRunEvaluatesLiveCounts: false
+    }
+  };
+}
 function displayControlPlaneUrl(value) {
   if (!value)
     return;
@@ -4484,6 +4528,9 @@ function buildDeploymentStatus(opts = {}) {
   if (deploymentMode === "self_hosted" && !controlPlaneConfigured) {
     warnings.push("self_hosted mode needs LOOPS_API_URL or LOOPS_DATABASE_URL before it can become authoritative");
   }
+  if (deploymentMode === "self_hosted" && config.databaseUrlPresent && !config.apiUrl) {
+    warnings.push("LOOPS_DATABASE_URL selects the self_hosted storage contract; loops-runner still needs LOOPS_API_URL to claim remote work");
+  }
   if (deploymentMode === "cloud" && config.apiUrl && !config.cloudApiUrl) {
     warnings.push("LOOPS_API_URL selects self_hosted; cloud mode uses LOOPS_CLOUD_API_URL");
   }
@@ -4517,6 +4564,13 @@ function buildDeploymentStatus(opts = {}) {
       required: deploymentMode !== "local",
       role: deploymentMode === "local" ? "daemon" : "control_plane_worker"
     },
+    schedulerState: schedulerStateForMode({
+      deploymentMode,
+      sourceOfTruth: sourceOfTruthForMode(deploymentMode),
+      localRole: deploymentMode === "local" ? "authoritative" : "cache_and_spool",
+      controlPlaneConfigured,
+      config
+    }),
     warnings
   };
 }
@@ -4529,6 +4583,7 @@ function deploymentStatusLine(status) {
     `source=${status.deploymentModeSource}`,
     `truth=${status.sourceOfTruth}`,
     `local=${status.localStore.role}`,
+    `scheduler=${status.schedulerState.routeAdmission.stateStore}`,
     `control_plane=${configured}`
   ].join(" ");
 }
@@ -8147,6 +8202,21 @@ function runDoctor(store) {
   checks.push(status.running ? { id: "daemon", status: "ok", message: `daemon is running pid=${status.pid}` } : { id: "daemon", status: status.stale ? "warn" : "ok", message: status.stale ? "daemon pid file is stale" : "daemon is not running" });
   const failedRuns = store.countRuns("failed");
   checks.push(failedRuns === 0 ? { id: "loop-runs", status: "ok", message: "no failed loop runs recorded" } : { id: "loop-runs", status: "warn", message: `${failedRuns} failed loop run(s) recorded` });
+  const deployment = buildDeploymentStatus();
+  const schedulerState = deployment.schedulerState;
+  checks.push({
+    id: "scheduler-state",
+    status: deployment.deploymentMode === "local" || deployment.controlPlane.configured ? "ok" : "warn",
+    message: `scheduler state authority=${schedulerState.authority} local=${schedulerState.localStore.role} remote=${schedulerState.remoteStore.backend}`,
+    detail: [
+      `route_state=${schedulerState.routeAdmission.stateStore}`,
+      `active_statuses=${schedulerState.routeAdmission.activeStatuses.join(",")}`,
+      `gates=${schedulerState.routeAdmission.gates.join(",")}`,
+      `artifacts=${schedulerState.localStore.runArtifacts}`,
+      `remote_artifacts=${schedulerState.remoteStore.objectArtifacts}`,
+      `remote_apply=${String(schedulerState.remoteStore.applySupported)}`
+    ].join(" ")
+  });
   for (const loop of store.listLoops({ status: "active" })) {
     try {
       if (loop.target.type === "workflow") {
@@ -9476,6 +9546,50 @@ var PR_HANDOFF_SCRIPT = [
   "console.log(`PR handoff complete: ${finalPrUrl}`);"
 ].join(`
 `);
+var PR_HANDOFF_NO_ARTIFACT_SCRIPT = [
+  "const { spawnSync } = await import('node:child_process');",
+  "const artifactPath = process.env.OPENLOOPS_PR_HANDOFF_ARTIFACT || '';",
+  "const taskId = process.env.OPENLOOPS_PR_HANDOFF_TASK_ID || '';",
+  "const todosProject = process.env.OPENLOOPS_PR_HANDOFF_TODOS_PROJECT || '';",
+  "const worktree = process.env.OPENLOOPS_PR_HANDOFF_WORKTREE || process.cwd();",
+  "const expectedBranch = process.env.OPENLOOPS_PR_HANDOFF_EXPECTED_BRANCH || '';",
+  "const todosBin = process.env.OPENLOOPS_PR_HANDOFF_TODOS_BIN || 'todos';",
+  "const gitBin = process.env.OPENLOOPS_PR_HANDOFF_GIT_BIN || 'git';",
+  "const ghBin = process.env.OPENLOOPS_PR_HANDOFF_GH_BIN || 'gh';",
+  "process.stdout.write(`no PR handoff artifact at ${artifactPath}\\n`);",
+  "const run = (command, args, options = {}) => {",
+  "  try { return spawnSync(command, args, { encoding: 'utf8', ...options }); }",
+  "  catch (error) { return { status: 1, stdout: '', stderr: String((error && error.message) || error) }; }",
+  "};",
+  "const todosArgs = (...args) => todosProject ? ['--project', todosProject, ...args] : args;",
+  "const comment = (text) => {",
+  "  const result = run(todosBin, todosArgs('comment', taskId, text));",
+  "  if (result.status !== 0) console.error(`failed to comment original task: ${result.stderr || result.stdout || result.status}`);",
+  "};",
+  "const main = () => {",
+  "  let branch = expectedBranch;",
+  "  if (!branch) {",
+  "    const shown = run(gitBin, ['-C', worktree, 'branch', '--show-current']);",
+  "    branch = String((shown.status === 0 ? shown.stdout : '') || '').trim();",
+  "  }",
+  "  if (!branch) { console.log('pr-handoff: no artifact and no resolvable branch; nothing to hand off'); return; }",
+  "  const listed = run(ghBin, ['pr', 'list', '--head', branch, '--state', 'open', '--json', 'url,number,headRefName,headRefOid'], { cwd: worktree });",
+  "  if (listed.status !== 0) { console.log(`pr-handoff: no artifact; PR lookup failed for branch ${branch}: ${String(listed.stderr || listed.stdout || listed.status).slice(0, 300)}`); return; }",
+  "  let prs = [];",
+  "  try { prs = JSON.parse(String(listed.stdout || '[]')); } catch { prs = []; }",
+  "  const pr = Array.isArray(prs) ? prs.find((entry) => entry && entry.headRefName === branch && typeof entry.url === 'string' && entry.url) : undefined;",
+  "  if (!pr) { console.log(`pr-handoff: no artifact and no open PR for branch ${branch}; worker completed without opening a PR`); return; }",
+  "  let commit = String(pr.headRefOid || '').trim();",
+  "  if (!commit) {",
+  "    const head = run(gitBin, ['-C', worktree, 'rev-parse', 'HEAD']);",
+  "    commit = String((head.status === 0 ? head.stdout : '') || '').trim();",
+  "  }",
+  "  comment(`openloops:pr-handoff=done task=${taskId} pr=${pr.url} commit=${commit || 'unknown'} branch=${branch}`);",
+  "  console.log(`PR handoff complete (worker-opened PR): ${pr.url}`);",
+  "};",
+  "try { main(); } catch (error) { console.error(`pr-handoff no-artifact detection error (ignored): ${String((error && error.message) || error)}`); }"
+].join(`
+`);
 function prHandoffCommand(opts) {
   return [
     "set -euo pipefail",
@@ -9486,12 +9600,14 @@ function prHandoffCommand(opts) {
     `export OPENLOOPS_PR_HANDOFF_WORKTREE_ROOT=${shellQuote3(opts.worktreeRoot)}`,
     `export OPENLOOPS_PR_HANDOFF_EXPECTED_BRANCH=${shellQuote3(opts.expectedBranch)}`,
     'if [ ! -s "$OPENLOOPS_PR_HANDOFF_ARTIFACT" ]; then',
-    `  printf 'no PR handoff artifact at %s\\n' "$OPENLOOPS_PR_HANDOFF_ARTIFACT"`,
-    "  exit 0",
-    "fi",
+    "bun - <<'OPENLOOPS_PR_HANDOFF_NOARTIFACT'",
+    PR_HANDOFF_NO_ARTIFACT_SCRIPT,
+    "OPENLOOPS_PR_HANDOFF_NOARTIFACT",
+    "else",
     "bun - <<'BUN'",
     PR_HANDOFF_SCRIPT,
-    "BUN"
+    "BUN",
+    "fi"
   ].join(`
 `);
 }

package/dist/daemon/index.js

@@ -7816,7 +7816,7 @@ function enableStartup(result) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.12",
+  version: "0.4.13",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { Store } from "./lib/store.js";
 export { POSTGRES_MIGRATION_LEDGER_TABLE, POSTGRES_STORAGE_MIGRATIONS, PostgresStorage, SqliteLoopStorage, checksumStorageSql, createPostgresStorage, createSqliteLoopStorage, } from "./lib/storage/index.js";
 export type { AppliedStorageMigration, AuditEventRecord, LoopStorageBackend, LoopStorageContract, LoopStorageMethodName, PostgresQueryExecutor, RunnerLeaseRecord, RunnerLeaseStatus, RunnerMachineRecord, RunnerMachineStatus, SchemaMigrationStorage, StorageMigration, StorageMigrationPlanItem, StorageMigrationResult, } from "./lib/storage/index.js";
 export { LOOP_DEPLOYMENT_MODES, buildDeploymentStatus, deploymentStatusLine, loopControlPlaneConfig, normalizeLoopDeploymentMode, resolveLoopDeploymentMode, } from "./lib/mode.js";
-export type { LoopControlPlaneConfig, LoopDeploymentMode, LoopDeploymentStatus, LoopModeResolution, LoopSourceOfTruth } from "./lib/mode.js";
+export type { LoopControlPlaneConfig, LoopDeploymentMode, LoopDeploymentStatus, LoopModeResolution, LoopRemoteArtifactStore, LoopRemoteSchedulerBackend, LoopRouteAdmissionGate, LoopRouteAdmissionStateStore, LoopSchedulerStateStatus, LoopSourceOfTruth, } from "./lib/mode.js";
 export { executeLoop, executeTarget, preflightTarget } from "./lib/executor.js";
 export { executeLoopTarget, executeWorkflow, preflightWorkflow } from "./lib/workflow-runner.js";
 export { workflowBodyFromJson, workflowExecutionOrder } from "./lib/workflow-spec.js";

package/dist/index.js

@@ -4266,7 +4266,7 @@ class Store {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.12",
+  version: "0.4.13",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -4457,6 +4457,50 @@ function sourceOfTruthForMode(mode) {
     return "self_hosted_control_plane";
   return "cloud_control_plane";
 }
+var ROUTE_ADMISSION_GATES = [
+  "max_dispatch",
+  "max_active",
+  "max_active_per_project",
+  "max_active_per_project_group",
+  "max_active_scope",
+  "max_per_profile"
+];
+function remoteSchedulerBackendForMode(mode, config) {
+  if (mode === "local")
+    return "none";
+  if (mode === "cloud")
+    return config.cloudApiUrl ? "hosted_control_plane_contract" : "unconfigured";
+  if (config.databaseUrlPresent)
+    return "postgres_contract";
+  if (config.apiUrl)
+    return "api_control_plane_contract";
+  return "unconfigured";
+}
+function schedulerStateForMode(args) {
+  const nonLocal = args.deploymentMode !== "local";
+  return {
+    authority: args.sourceOfTruth,
+    localStore: {
+      backend: "sqlite",
+      role: args.localRole,
+      runArtifacts: "local_files",
+      routeAdmissionState: "workflow_work_items"
+    },
+    remoteStore: {
+      backend: remoteSchedulerBackendForMode(args.deploymentMode, args.config),
+      configured: nonLocal && args.controlPlaneConfigured,
+      applySupported: false,
+      objectArtifacts: nonLocal ? "object_store_contract" : "none",
+      mutatesAws: false
+    },
+    routeAdmission: {
+      stateStore: nonLocal ? "control_plane_contract" : "local_sqlite",
+      activeStatuses: ["admitted", "running"],
+      gates: ROUTE_ADMISSION_GATES,
+      dryRunEvaluatesLiveCounts: false
+    }
+  };
+}
 function displayControlPlaneUrl(value) {
   if (!value)
     return;
@@ -4482,6 +4526,9 @@ function buildDeploymentStatus(opts = {}) {
   if (deploymentMode === "self_hosted" && !controlPlaneConfigured) {
     warnings.push("self_hosted mode needs LOOPS_API_URL or LOOPS_DATABASE_URL before it can become authoritative");
   }
+  if (deploymentMode === "self_hosted" && config.databaseUrlPresent && !config.apiUrl) {
+    warnings.push("LOOPS_DATABASE_URL selects the self_hosted storage contract; loops-runner still needs LOOPS_API_URL to claim remote work");
+  }
   if (deploymentMode === "cloud" && config.apiUrl && !config.cloudApiUrl) {
     warnings.push("LOOPS_API_URL selects self_hosted; cloud mode uses LOOPS_CLOUD_API_URL");
   }
@@ -4515,6 +4562,13 @@ function buildDeploymentStatus(opts = {}) {
       required: deploymentMode !== "local",
       role: deploymentMode === "local" ? "daemon" : "control_plane_worker"
     },
+    schedulerState: schedulerStateForMode({
+      deploymentMode,
+      sourceOfTruth: sourceOfTruthForMode(deploymentMode),
+      localRole: deploymentMode === "local" ? "authoritative" : "cache_and_spool",
+      controlPlaneConfigured,
+      config
+    }),
     warnings
   };
 }
@@ -4527,6 +4581,7 @@ function deploymentStatusLine(status) {
     `source=${status.deploymentModeSource}`,
     `truth=${status.sourceOfTruth}`,
     `local=${status.localStore.role}`,
+    `scheduler=${status.schedulerState.routeAdmission.stateStore}`,
     `control_plane=${configured}`
   ].join(" ");
 }
@@ -5832,6 +5887,21 @@ function runDoctor(store) {
   checks.push(status.running ? { id: "daemon", status: "ok", message: `daemon is running pid=${status.pid}` } : { id: "daemon", status: status.stale ? "warn" : "ok", message: status.stale ? "daemon pid file is stale" : "daemon is not running" });
   const failedRuns = store.countRuns("failed");
   checks.push(failedRuns === 0 ? { id: "loop-runs", status: "ok", message: "no failed loop runs recorded" } : { id: "loop-runs", status: "warn", message: `${failedRuns} failed loop run(s) recorded` });
+  const deployment = buildDeploymentStatus();
+  const schedulerState = deployment.schedulerState;
+  checks.push({
+    id: "scheduler-state",
+    status: deployment.deploymentMode === "local" || deployment.controlPlane.configured ? "ok" : "warn",
+    message: `scheduler state authority=${schedulerState.authority} local=${schedulerState.localStore.role} remote=${schedulerState.remoteStore.backend}`,
+    detail: [
+      `route_state=${schedulerState.routeAdmission.stateStore}`,
+      `active_statuses=${schedulerState.routeAdmission.activeStatuses.join(",")}`,
+      `gates=${schedulerState.routeAdmission.gates.join(",")}`,
+      `artifacts=${schedulerState.localStore.runArtifacts}`,
+      `remote_artifacts=${schedulerState.remoteStore.objectArtifacts}`,
+      `remote_apply=${String(schedulerState.remoteStore.applySupported)}`
+    ].join(" ")
+  });
   for (const loop of store.listLoops({ status: "active" })) {
     try {
       if (loop.target.type === "workflow") {
@@ -10216,6 +10286,50 @@ var PR_HANDOFF_SCRIPT = [
   "console.log(`PR handoff complete: ${finalPrUrl}`);"
 ].join(`
 `);
+var PR_HANDOFF_NO_ARTIFACT_SCRIPT = [
+  "const { spawnSync } = await import('node:child_process');",
+  "const artifactPath = process.env.OPENLOOPS_PR_HANDOFF_ARTIFACT || '';",
+  "const taskId = process.env.OPENLOOPS_PR_HANDOFF_TASK_ID || '';",
+  "const todosProject = process.env.OPENLOOPS_PR_HANDOFF_TODOS_PROJECT || '';",
+  "const worktree = process.env.OPENLOOPS_PR_HANDOFF_WORKTREE || process.cwd();",
+  "const expectedBranch = process.env.OPENLOOPS_PR_HANDOFF_EXPECTED_BRANCH || '';",
+  "const todosBin = process.env.OPENLOOPS_PR_HANDOFF_TODOS_BIN || 'todos';",
+  "const gitBin = process.env.OPENLOOPS_PR_HANDOFF_GIT_BIN || 'git';",
+  "const ghBin = process.env.OPENLOOPS_PR_HANDOFF_GH_BIN || 'gh';",
+  "process.stdout.write(`no PR handoff artifact at ${artifactPath}\\n`);",
+  "const run = (command, args, options = {}) => {",
+  "  try { return spawnSync(command, args, { encoding: 'utf8', ...options }); }",
+  "  catch (error) { return { status: 1, stdout: '', stderr: String((error && error.message) || error) }; }",
+  "};",
+  "const todosArgs = (...args) => todosProject ? ['--project', todosProject, ...args] : args;",
+  "const comment = (text) => {",
+  "  const result = run(todosBin, todosArgs('comment', taskId, text));",
+  "  if (result.status !== 0) console.error(`failed to comment original task: ${result.stderr || result.stdout || result.status}`);",
+  "};",
+  "const main = () => {",
+  "  let branch = expectedBranch;",
+  "  if (!branch) {",
+  "    const shown = run(gitBin, ['-C', worktree, 'branch', '--show-current']);",
+  "    branch = String((shown.status === 0 ? shown.stdout : '') || '').trim();",
+  "  }",
+  "  if (!branch) { console.log('pr-handoff: no artifact and no resolvable branch; nothing to hand off'); return; }",
+  "  const listed = run(ghBin, ['pr', 'list', '--head', branch, '--state', 'open', '--json', 'url,number,headRefName,headRefOid'], { cwd: worktree });",
+  "  if (listed.status !== 0) { console.log(`pr-handoff: no artifact; PR lookup failed for branch ${branch}: ${String(listed.stderr || listed.stdout || listed.status).slice(0, 300)}`); return; }",
+  "  let prs = [];",
+  "  try { prs = JSON.parse(String(listed.stdout || '[]')); } catch { prs = []; }",
+  "  const pr = Array.isArray(prs) ? prs.find((entry) => entry && entry.headRefName === branch && typeof entry.url === 'string' && entry.url) : undefined;",
+  "  if (!pr) { console.log(`pr-handoff: no artifact and no open PR for branch ${branch}; worker completed without opening a PR`); return; }",
+  "  let commit = String(pr.headRefOid || '').trim();",
+  "  if (!commit) {",
+  "    const head = run(gitBin, ['-C', worktree, 'rev-parse', 'HEAD']);",
+  "    commit = String((head.status === 0 ? head.stdout : '') || '').trim();",
+  "  }",
+  "  comment(`openloops:pr-handoff=done task=${taskId} pr=${pr.url} commit=${commit || 'unknown'} branch=${branch}`);",
+  "  console.log(`PR handoff complete (worker-opened PR): ${pr.url}`);",
+  "};",
+  "try { main(); } catch (error) { console.error(`pr-handoff no-artifact detection error (ignored): ${String((error && error.message) || error)}`); }"
+].join(`
+`);
 function prHandoffCommand(opts) {
   return [
     "set -euo pipefail",
@@ -10226,12 +10340,14 @@ function prHandoffCommand(opts) {
     `export OPENLOOPS_PR_HANDOFF_WORKTREE_ROOT=${shellQuote2(opts.worktreeRoot)}`,
     `export OPENLOOPS_PR_HANDOFF_EXPECTED_BRANCH=${shellQuote2(opts.expectedBranch)}`,
     'if [ ! -s "$OPENLOOPS_PR_HANDOFF_ARTIFACT" ]; then',
-    `  printf 'no PR handoff artifact at %s\\n' "$OPENLOOPS_PR_HANDOFF_ARTIFACT"`,
-    "  exit 0",
-    "fi",
+    "bun - <<'OPENLOOPS_PR_HANDOFF_NOARTIFACT'",
+    PR_HANDOFF_NO_ARTIFACT_SCRIPT,
+    "OPENLOOPS_PR_HANDOFF_NOARTIFACT",
+    "else",
     "bun - <<'BUN'",
     PR_HANDOFF_SCRIPT,
-    "BUN"
+    "BUN",
+    "fi"
   ].join(`
 `);
 }

package/dist/lib/mode.d.ts

@@ -1,6 +1,10 @@
 export declare const LOOP_DEPLOYMENT_MODES: readonly ["local", "self_hosted", "cloud"];
 export type LoopDeploymentMode = (typeof LOOP_DEPLOYMENT_MODES)[number];
 export type LoopSourceOfTruth = "local_sqlite" | "self_hosted_control_plane" | "cloud_control_plane";
+export type LoopRemoteSchedulerBackend = "none" | "unconfigured" | "api_control_plane_contract" | "postgres_contract" | "hosted_control_plane_contract";
+export type LoopRemoteArtifactStore = "none" | "object_store_contract";
+export type LoopRouteAdmissionStateStore = "local_sqlite" | "control_plane_contract";
+export type LoopRouteAdmissionGate = "max_dispatch" | "max_active" | "max_active_per_project" | "max_active_per_project_group" | "max_active_scope" | "max_per_profile";
 export interface LoopModeResolution {
     deploymentMode: LoopDeploymentMode;
     source: string;
@@ -34,8 +38,31 @@ export interface LoopDeploymentStatus {
         required: boolean;
         role: "daemon" | "control_plane_worker";
     };
+    schedulerState: LoopSchedulerStateStatus;
     warnings: string[];
 }
+export interface LoopSchedulerStateStatus {
+    authority: LoopSourceOfTruth;
+    localStore: {
+        backend: "sqlite";
+        role: "authoritative" | "cache_and_spool";
+        runArtifacts: "local_files";
+        routeAdmissionState: "workflow_work_items";
+    };
+    remoteStore: {
+        backend: LoopRemoteSchedulerBackend;
+        configured: boolean;
+        applySupported: boolean;
+        objectArtifacts: LoopRemoteArtifactStore;
+        mutatesAws: false;
+    };
+    routeAdmission: {
+        stateStore: LoopRouteAdmissionStateStore;
+        activeStatuses: readonly ["admitted", "running"];
+        gates: readonly LoopRouteAdmissionGate[];
+        dryRunEvaluatesLiveCounts: false;
+    };
+}
 type Env = Record<string, string | undefined>;
 export declare function normalizeLoopDeploymentMode(value: string): LoopDeploymentMode;
 export declare function resolveLoopDeploymentMode(env?: Env): LoopModeResolution;