openclaw-scheduler 0.2.7 → 0.2.9

package/dispatch/529-recovery.mjs

@@ -23,9 +23,10 @@ import { readFileSync, writeFileSync, renameSync } from 'fs';
 import { execFileSync } from 'child_process';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { resolveLabelsPath } from './paths.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const LABELS_PATH = process.env.DISPATCH_LABELS_PATH || join(__dirname, 'labels.json');
+const LABELS_PATH = resolveLabelsPath({ legacyCandidates: [join(__dirname, 'labels.json')] });
 const INDEX_PATH  = process.env.DISPATCH_INDEX_PATH  || join(__dirname, 'index.mjs');
 
 const MAX_RETRIES = 3;

package/dispatch/README.md

@@ -23,7 +23,7 @@ No scheduler DB dependency. No dispatcher tick delay. Sessions start instantly.
 | `chilisaus.mjs` | Branded wrapper |
 | `config.example.json` | Example config |
 | `test-done-postoffice.mjs` | Done handler test |
-| `labels.json` | Local label→session ledger (gitignored) |
+| `~/.openclaw/scheduler/dispatch/labels.json` | Durable label→session ledger |
 | `README.md` | This file |
 
 ---
@@ -45,7 +45,7 @@ Orchestrator calls:
   → Patches session with model/thinking/spawnDepth
   → Calls gateway `agent` method with the task
   → Session starts immediately (no scheduler tick delay)
-  → Tracks label→sessionKey in labels.json
+  → Tracks label→sessionKey in the durable labels ledger
   → Agent auto-announces results on completion
   → hooks.mjs fires dispatch.started to Loki
 ```
@@ -117,7 +117,7 @@ node dispatch/index.mjs stuck --threshold-min 15
 Exit 0 = nothing stuck (silent).
 Exit 1 = stuck sessions found (triggers announce delivery).
 
-Checks labels.json for sessions marked `running`, cross-references gateway
+Checks the labels ledger for sessions marked `running`, cross-references gateway
 session store for last activity timestamp.
 
 ### `result` — last assistant reply from a session
@@ -206,7 +206,7 @@ Shows all labels in the ledger, sorted by most recent. Filter by status.
 node dispatch/index.mjs sync
 ```
 
-Reconciles `labels.json` with the gateway sessions store. Sessions that no
+Reconciles the labels ledger with the gateway sessions store. Sessions that no
 longer exist on the gateway are marked stale, and sessions present on the
 gateway but missing from the ledger are imported. Useful after gateway restarts
 or manual session cleanup.

package/dispatch/index.mjs

@@ -41,6 +41,7 @@ import {
   taskRequiresGitSha,
 } from './completion.mjs';
 import { getDispatchLivenessPolicy } from './liveness.mjs';
+import { resolveLabelsPath } from './paths.mjs';
 import { onStarted, onFinished, onStuck } from './hooks.mjs';
 import { resolveMessageInput } from './message-input.mjs';
 import { buildDispatchDeliverySurface } from '../scripts/dispatch-cli-utils.mjs';
@@ -67,7 +68,9 @@ const INVOKE_DIR = (() => {
 
 // -- Config ---------------------------------------------------
 
-const LABELS_PATH = process.env.DISPATCH_LABELS_PATH || join(INVOKE_DIR, 'labels.json');
+const LABELS_PATH = resolveLabelsPath({
+  legacyCandidates: [join(INVOKE_DIR, 'labels.json'), join(__dirname, 'labels.json')],
+});
 
 /** Load dispatch config from config.json.
  *  Resolution order:

package/dispatch/paths.mjs

@@ -0,0 +1,36 @@
+import { copyFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, join, resolve as pathResolve } from 'path';
+import { homedir } from 'os';
+
+function schedulerHome() {
+  return process.env.OPENCLAW_SCHEDULER_HOME ||
+    join(process.env.HOME || homedir(), '.openclaw', 'scheduler');
+}
+
+export function resolveDispatchStateDir() {
+  return process.env.DISPATCH_STATE_DIR ||
+    join(schedulerHome(), 'dispatch');
+}
+
+export function resolveLabelsPath({ legacyCandidates = [] } = {}) {
+  if (process.env.DISPATCH_LABELS_PATH) {
+    mkdirSync(dirname(process.env.DISPATCH_LABELS_PATH), { recursive: true });
+    return process.env.DISPATCH_LABELS_PATH;
+  }
+
+  const labelsPath = join(resolveDispatchStateDir(), 'labels.json');
+  mkdirSync(dirname(labelsPath), { recursive: true });
+
+  if (!existsSync(labelsPath)) {
+    const normalizedTarget = pathResolve(labelsPath);
+    const legacyPath = legacyCandidates
+      .filter(Boolean)
+      .map((candidate) => pathResolve(candidate))
+      .find((candidate) => candidate !== normalizedTarget && existsSync(candidate));
+    if (legacyPath) {
+      copyFileSync(legacyPath, labelsPath);
+    }
+  }
+
+  return labelsPath;
+}

package/dispatch/watcher.mjs

@@ -37,11 +37,12 @@ import {
   resolveCompletionDelivery,
 } from './completion.mjs';
 import { getDispatchLivenessPolicy } from './liveness.mjs';
+import { resolveLabelsPath } from './paths.mjs';
 import { sendMessage } from '../messages.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const INDEX_PATH = process.env.DISPATCH_INDEX_PATH || join(__dirname, 'index.mjs');
-const LABELS_PATH = process.env.DISPATCH_LABELS_PATH || join(__dirname, 'labels.json');
+const LABELS_PATH = resolveLabelsPath({ legacyCandidates: [join(__dirname, 'labels.json')] });
 const HOME_DIR = process.env.HOME || homedir();
 let labelsCache = null;
 let labelsCacheSignature = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-scheduler",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "SQLite-backed job scheduler and workflow engine for OpenClaw agents",
   "type": "module",
   "main": "./index.js",
@@ -44,6 +44,7 @@
     "dispatch/index.mjs",
     "dispatch/liveness.mjs",
     "dispatch/message-input.mjs",
+    "dispatch/paths.mjs",
     "dispatch/README.md",
     "dispatch/watcher.mjs",
     "scripts/dispatch-cli-utils.mjs",

package/scripts/stuck-run-detector.mjs

@@ -29,12 +29,13 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { tmpdir } from 'os';
 import { resolveDispatchCliPath, resolveDispatchLabel } from './dispatch-cli-utils.mjs';
+import { resolveLabelsPath } from '../dispatch/paths.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 // -- Paths ----------------------------------------------------
 
-const LABELS_PATH  = process.env.DISPATCH_LABELS_PATH || join(__dirname, '..', 'dispatch', 'labels.json');
+const LABELS_PATH  = resolveLabelsPath({ legacyCandidates: [join(__dirname, '..', 'dispatch', 'labels.json')] });
 const STATE_PATH   = process.env.STUCK_STATE_PATH || join(tmpdir(), 'stuck-detector-state.json');
 const DISPATCH_CLI = resolveDispatchCliPath(process.env);
 const DISPATCH_IS_BIN = !DISPATCH_CLI.includes('/') && !DISPATCH_CLI.includes('\\');