@ahyi/restart-continuity 0.4.0 → 0.5.0

package/README.md

@@ -1,80 +1,35 @@
 # Restart Continuity Plugin
 
-OpenClaw plugin for **gateway restart continuity**:
-
-- runs resumable startup checks when the plugin service starts
-- can health-check and replay selected cron jobs
-- writes a structured continuity state file
-- writes a human-readable daily memory log
-- can hand off a one-shot startup receipt during agent bootstrap
-- works out of the box after `openclaw plugins install ...` + `enable`, with built-in default resumers for this mh instance
+OpenClaw plugin for **gateway restart continuity** with **zero-config behavior on this mh instance**.
 
 ## Install
 
-### npm registry
-
 ```bash
-openclaw --profile <profile> plugins install @ahyi/restart-continuity@0.4.0
+openclaw --profile <profile> plugins install @ahyi/restart-continuity@0.5.0
 openclaw --profile <profile> plugins enable restart-continuity
 ```
 
 Then restart the gateway.
 
-## What it does
-
-This plugin replaces scattered hook-based restart continuity setups with one installable extension.
-
-On plugin service start it can:
+## Zero-config behavior
 
-1. initialize runtime marker/state files
-2. run configured startup resumers
-3. fall back to built-in default resumers when none are configured
-4. write `memory/restart-continuity-state.json`
-5. append a summary to `memory/YYYY-MM-DD.md`
-6. stage a one-time startup receipt for bootstrap delivery
+After install + enable, the plugin will work **without any extra config** on this mh instance.
 
-## Default behavior
+It automatically:
 
-If you do **not** provide `plugins.entries.restart-continuity.config.resumers`, the plugin will automatically use built-in defaults for this mh instance:
-
-- `mh-nightly-learnings-check`
-- `mh-weekly-self-improve`
-
-That means install + enable is enough to make restart continuity work on this machine.
+- detects the mh workspace directory
+- assumes profile `mh` unless overridden
+- uses built-in default resumers for:
+  - `mh-nightly-learnings-check`
+  - `mh-weekly-self-improve`
+- writes `memory/restart-continuity-state.json`
+- writes `memory/restart-continuity-installed.json`
+- appends a summary to the daily memory log
+- stages a one-shot bootstrap receipt
 
 ## Optional explicit config
 
-```json
-{
-  "plugins": {
-    "entries": {
-      "restart-continuity": {
-        "enabled": true,
-        "config": {
-          "profile": "mh",
-          "workspaceDir": "/root/.openclaw/workspace-mh",
-          "logToDailyMemory": true,
-          "notifyOnBootstrap": true,
-          "resumers": [
-            {
-              "id": "nightly-learnings",
-              "kind": "cron-healthcheck",
-              "name": "mh-nightly-learnings-check",
-              "jobId": "38a8b8cb-c25a-4bc2-a8a1-d252f9d933ec"
-            },
-            {
-              "id": "weekly-self-improve",
-              "kind": "cron-healthcheck",
-              "name": "mh-weekly-self-improve",
-              "jobId": "6e912522-0591-4307-a155-a6ece496be9c"
-            }
-          ]
-        }
-      }
-    }
-  }
-}
-```
+You can still override behavior with `plugins.entries.restart-continuity.config`, but it is not required for this instance.
 
 ## Uninstall
 

package/index.ts

@@ -5,6 +5,7 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 const OPENCLAW_BIN = process.env.OPENCLAW_BIN || "openclaw";
+let bootStarted = false;
 
 const BUILTIN_DEFAULT_RESUMERS = [
   {
@@ -29,14 +30,17 @@ function normalizeString(value, fallback = "") {
   return typeof value === "string" && value.trim() ? value.trim() : fallback;
 }
 
-function getWorkspaceDir(api) {
+function detectWorkspaceDir(api) {
   const pluginConfig = api.pluginConfig || {};
   const explicit = normalizeString(pluginConfig.workspaceDir, "");
   if (explicit) return explicit;
-  return normalizeString(api.config?.workspace?.dir, process.cwd());
+  const cfgWorkspace = normalizeString(api.config?.workspace?.dir, "");
+  if (cfgWorkspace) return cfgWorkspace;
+  const mhWorkspace = "/root/.openclaw/workspace-mh";
+  return mhWorkspace;
 }
 
-function getProfile(api) {
+function detectProfile(api) {
   const pluginConfig = api.pluginConfig || {};
   return normalizeString(pluginConfig.profile, "mh");
 }
@@ -165,9 +169,7 @@ async function runCronHealthcheck(profile, resumer) {
   return { status: "resumed", detail: `${resumer.name || resumer.id} => ${normalized}`, latestStatus };
 }
 
-async function ensureConfigInitialized(api) {
-  const workspaceDir = getWorkspaceDir(api);
-  const pluginConfig = api.pluginConfig || {};
+async function ensureConfigInitialized(api, workspaceDir, pluginConfig) {
   const stateFile = resolvePath(workspaceDir, pluginConfig.stateFile, "memory/restart-continuity-state.json");
   const markerFile = resolvePath(workspaceDir, pluginConfig.markerFile, "memory/restart-continuity-installed.json");
 
@@ -193,10 +195,8 @@ async function ensureConfigInitialized(api) {
   api.logger.info?.("[restart-continuity] initialized");
 }
 
-async function runStartupCheck(api) {
-  const pluginConfig = api.pluginConfig || {};
-  const profile = getProfile(api);
-  const workspaceDir = getWorkspaceDir(api);
+async function runStartupCheck(api, workspaceDir, pluginConfig) {
+  const profile = detectProfile(api);
   const stateFile = resolvePath(workspaceDir, pluginConfig.stateFile, "memory/restart-continuity-state.json");
   const receiptFile = resolvePath(workspaceDir, pluginConfig.receiptFile, "memory/restart-continuity-receipt.json");
   const logToDailyMemory = pluginConfig.logToDailyMemory !== false;
@@ -261,6 +261,20 @@ async function runStartupCheck(api) {
   api.logger.info?.(`[restart-continuity] ${summary.receipt}`);
 }
 
+async function boot(api) {
+  if (bootStarted) return;
+  bootStarted = true;
+  const pluginConfig = api.pluginConfig || {};
+  const workspaceDir = detectWorkspaceDir(api);
+
+  try {
+    await ensureConfigInitialized(api, workspaceDir, pluginConfig);
+    await runStartupCheck(api, workspaceDir, pluginConfig);
+  } catch (err) {
+    api.logger.warn?.(`[restart-continuity] boot failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+
 const plugin = {
   id: "restart-continuity",
   name: "Restart Continuity",
@@ -274,7 +288,6 @@ const plugin = {
       workspaceDir: { label: "Workspace Directory" },
       stateFile: { label: "State File" },
       receiptFile: { label: "Receipt File" },
-      defaultsFile: { label: "Defaults File" },
       markerFile: { label: "Install Marker File" },
       logToDailyMemory: { label: "Append summary to daily memory" },
       notifyOnBootstrap: { label: "Inject startup receipt into next bootstrap reply" },
@@ -282,18 +295,7 @@ const plugin = {
     },
   },
   register(api) {
-    api.registerService({
-      id: "restart-continuity-service",
-      start: async () => {
-        try {
-          await ensureConfigInitialized(api);
-          await runStartupCheck(api);
-        } catch (err) {
-          api.logger.warn?.(`[restart-continuity] service start failed: ${err instanceof Error ? err.message : String(err)}`);
-        }
-      },
-      stop: async () => {},
-    });
+    void boot(api);
 
     api.registerHook(
       "agent:bootstrap",
@@ -304,7 +306,7 @@ const plugin = {
         const bootstrapFiles = Array.isArray(ctx.bootstrapFiles) ? ctx.bootstrapFiles : null;
         if (!bootstrapFiles) return;
 
-        const workspaceDir = getWorkspaceDir(api);
+        const workspaceDir = detectWorkspaceDir(api);
         const receiptFile = resolvePath(workspaceDir, pluginConfig.receiptFile, "memory/restart-continuity-receipt.json");
         const pending = await readJsonSafe(receiptFile, null);
         if (!pending || !pending.receipt) return;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "restart-continuity",
   "name": "Restart Continuity",
   "description": "Gateway restart continuity plugin with resumable startup checks and receipt handoff.",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -11,7 +11,6 @@
       "workspaceDir": { "type": "string", "default": "" },
       "stateFile": { "type": "string", "default": "memory/restart-continuity-state.json" },
       "receiptFile": { "type": "string", "default": "memory/restart-continuity-receipt.json" },
-      "defaultsFile": { "type": "string", "default": "plugins/restart-continuity.defaults.json" },
       "markerFile": { "type": "string", "default": "memory/restart-continuity-installed.json" },
       "logToDailyMemory": { "type": "boolean", "default": true },
       "notifyOnBootstrap": { "type": "boolean", "default": true },
@@ -45,7 +44,6 @@
     "workspaceDir": { "label": "Workspace Directory" },
     "stateFile": { "label": "State File" },
     "receiptFile": { "label": "Receipt File" },
-    "defaultsFile": { "label": "Defaults File" },
     "markerFile": { "label": "Install Marker File" },
     "logToDailyMemory": { "label": "Append summary to daily memory" },
     "notifyOnBootstrap": { "label": "Inject startup receipt into next bootstrap reply" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahyi/restart-continuity",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "OpenClaw restart continuity plugin with resumable startup checks and receipt handoff",
   "type": "module",
   "license": "MIT",