openclaw-scheduler 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.4] -- 2026-04-18
+
+### Fixed
+- fix(package): include dispatch/completion.mjs in the published npm tarball so dispatch CLI and watcher startup no longer crash with ERR_MODULE_NOT_FOUND in installed deployments
+
 ## [0.2.3] -- 2026-04-16
 
 ### Fixed

package/dispatch/completion.mjs

@@ -0,0 +1,135 @@
+const GENERIC_COMPLETION_TEXT_RE = /^(?:completed(?:\s*\([^\n)]*\))?|done|ok|okay|success|successful|complete|all set|none|n\/?a)$/i;
+const TRIVIAL_CHATTER_RE = /^(?:hi|hello|hey|yo|sup|thanks|thank you|cool|nice|sure|yep|yeah|k|kk|roger|copy that)[.!?]*$/i;
+
+export function normalizeCompletionText(value) {
+  if (typeof value !== 'string') return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+
+export function isMeaningfulCompletionText(value) {
+  const text = normalizeCompletionText(value);
+  if (!text) return false;
+
+  const normalized = text.toLowerCase().replace(/\s+/g, ' ').trim();
+  if (!normalized) return false;
+  if (GENERIC_COMPLETION_TEXT_RE.test(normalized)) return false;
+  if (TRIVIAL_CHATTER_RE.test(normalized)) return false;
+
+  const words = normalized.split(/\s+/).filter(Boolean);
+  if (words.length === 1) return false;
+
+  return true;
+}
+
+function shortSha(sha) {
+  const text = normalizeCompletionText(sha);
+  if (!text) return null;
+  return /^[0-9a-f]{7,40}$/i.test(text) ? text.slice(0, 7) : text;
+}
+
+function cloneChecklist(checklist) {
+  if (!checklist || typeof checklist !== 'object' || Array.isArray(checklist)) return null;
+  try {
+    return JSON.parse(JSON.stringify(checklist));
+  } catch {
+    return { ...checklist };
+  }
+}
+
+export function synthesizeCompletionReply({ checklist, sha } = {}) {
+  const normalizedChecklist = cloneChecklist(checklist);
+  const short = shortSha(sha);
+  const sentences = [];
+
+  if (normalizedChecklist?.tests_passed === true) {
+    sentences.push('Tests passed.');
+  }
+
+  if (normalizedChecklist?.pushed === true && short) {
+    sentences.push(`Pushed ${short}.`);
+  } else if (normalizedChecklist?.pushed === true) {
+    sentences.push('Changes pushed.');
+  } else if (short) {
+    sentences.push(`Commit ${short}.`);
+  }
+
+  const extraTrueFlags = normalizedChecklist
+    ? Object.entries(normalizedChecklist)
+      .filter(([key, value]) => value === true && !['work_complete', 'tests_passed', 'pushed'].includes(key))
+      .map(([key]) => key.replace(/_/g, ' '))
+    : [];
+
+  if (extraTrueFlags.length > 0) {
+    sentences.push(`Checks: ${extraTrueFlags.slice(0, 3).join(', ')}.`);
+  }
+
+  if (sentences.length === 0) return null;
+  return `Work complete. ${sentences.join(' ')}`.trim();
+}
+
+export function buildTerminalCompletionPayload({ summary, checklist, sha } = {}) {
+  const rawSummary = normalizeCompletionText(summary);
+  const normalizedChecklist = cloneChecklist(checklist);
+  const normalizedSha = normalizeCompletionText(sha);
+  const prose = isMeaningfulCompletionText(rawSummary) ? rawSummary : null;
+  const synthesizedReply = prose
+    ? null
+    : synthesizeCompletionReply({ checklist: normalizedChecklist, sha: normalizedSha });
+  const effectiveSummary = prose || synthesizedReply || rawSummary || null;
+  const deliveryText = prose || synthesizedReply || null;
+
+  return {
+    version: 1,
+    recordedAt: new Date().toISOString(),
+    summary: effectiveSummary,
+    deliveryText,
+    prose,
+    checklist: normalizedChecklist,
+    sha: normalizedSha,
+    debug: {
+      rawSummary,
+      synthesizedReply,
+      deliverySource: prose ? 'summary' : synthesizedReply ? 'synthesized' : 'none',
+    },
+  };
+}
+
+export function resolveCompletionDelivery({ lastReply, completion, fallbackSummary } = {}) {
+  const reply = normalizeCompletionText(lastReply);
+  const completionSummary = normalizeCompletionText(completion?.summary);
+  const completionDelivery = normalizeCompletionText(completion?.deliveryText);
+  const fallback = normalizeCompletionText(fallbackSummary);
+  const preferredSummary = completionSummary || fallback;
+  const meaningfulSummary = [completionSummary, fallback].find(isMeaningfulCompletionText) || null;
+
+  if (isMeaningfulCompletionText(reply)) {
+    return {
+      deliveryText: reply,
+      summary: preferredSummary || reply.slice(0, 500),
+      source: 'lastReply',
+    };
+  }
+
+  if (isMeaningfulCompletionText(completionDelivery)) {
+    return {
+      deliveryText: completionDelivery,
+      summary: completionSummary || completionDelivery,
+      source: completion?.debug?.deliverySource || 'completion',
+    };
+  }
+
+  if (meaningfulSummary) {
+    return {
+      deliveryText: meaningfulSummary,
+      summary: meaningfulSummary,
+      source: completionSummary && meaningfulSummary === completionSummary ? 'completion-summary' : 'summary',
+    };
+  }
+
+  return {
+    deliveryText: null,
+    summary: preferredSummary || null,
+    source: 'none',
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-scheduler",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "SQLite-backed job scheduler and workflow engine for OpenClaw agents",
   "type": "module",
   "main": "./index.js",
@@ -37,6 +37,7 @@
   "files": [
     "bin",
     "dispatch/529-recovery.mjs",
+    "dispatch/completion.mjs",
     "dispatch/config.example.json",
     "dispatch/deliver-watcher.sh",
     "dispatch/hooks.mjs",