@ahyi/restart-continuity 0.3.1 → 0.5.0

package/README.md

@@ -1,91 +1,38 @@
 # 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
+OpenClaw plugin for **gateway restart continuity** with **zero-config behavior on this mh instance**.
 
 ## Install
 
-### Local path
-
 ```bash
-openclaw --profile <profile> plugins install /path/to/restart-continuity-plugin
+openclaw --profile <profile> plugins install @ahyi/restart-continuity@0.5.0
 openclaw --profile <profile> plugins enable restart-continuity
 ```
 
-### npm registry
+Then restart the gateway.
 
-```bash
-openclaw --profile <profile> plugins install @ahyi/restart-continuity@0.3.1
-openclaw --profile <profile> plugins enable restart-continuity
-```
-
-## What it does
+## Zero-config behavior
 
-This plugin is designed to replace scattered hook-based restart continuity setups with one installable extension.
+After install + enable, the plugin will work **without any extra config** on this mh instance.
 
-On plugin service start it can:
+It automatically:
 
-1. initialize its runtime marker/state files
-2. run configured startup resumers
-3. write `memory/restart-continuity-state.json`
-4. append a summary to `memory/YYYY-MM-DD.md`
-5. stage a one-time startup receipt for bootstrap delivery
+- 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
 
-## Example config
+## 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
 
 ```bash
 openclaw --profile <profile> plugins uninstall restart-continuity
 ```
-
-OpenClaw removes the plugin config entry and install record. If you want a fully clean teardown, also delete plugin runtime artifacts such as:
-
-- `memory/restart-continuity-state.json`
-- `memory/restart-continuity-installed.json`
-- `memory/restart-continuity-receipt.json`
-
-## Publish
-
-```bash
-npm publish --access public
-```
-
-If scoped publishing is used, make sure the npm account/org owns the scope.

package/index.ts

@@ -5,6 +5,22 @@ import { promisify } from "node:util";
 
 const execFileAsync = promisify(execFile);
 const OPENCLAW_BIN = process.env.OPENCLAW_BIN || "openclaw";
+let bootStarted = false;
+
+const BUILTIN_DEFAULT_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",
+  },
+];
 
 function nowIso() {
   return new Date().toISOString();
@@ -14,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");
 }
@@ -120,6 +139,13 @@ function getDatePartsForShanghai(date = new Date()) {
   };
 }
 
+function getEffectiveResumers(pluginConfig) {
+  if (Array.isArray(pluginConfig.resumers) && pluginConfig.resumers.length > 0) {
+    return pluginConfig.resumers;
+  }
+  return BUILTIN_DEFAULT_RESUMERS;
+}
+
 async function runCronHealthcheck(profile, resumer) {
   const successStatuses = Array.isArray(resumer.successStatuses) && resumer.successStatuses.length
     ? resumer.successStatuses.map(String)
@@ -143,21 +169,17 @@ 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 defaultsFile = resolvePath(workspaceDir, pluginConfig.defaultsFile, "plugins/restart-continuity.defaults.json");
   const markerFile = resolvePath(workspaceDir, pluginConfig.markerFile, "memory/restart-continuity-installed.json");
 
   if (await fileExists(markerFile)) return;
 
-  const defaults = await readJsonSafe(defaultsFile, null);
   await writeJson(markerFile, {
     installedAt: nowIso(),
     source: "restart-continuity",
     workspaceDir,
-    defaultsApplied: Boolean(defaults),
+    builtInDefaultsActive: !(Array.isArray(pluginConfig.resumers) && pluginConfig.resumers.length > 0),
   });
 
   if (!(await fileExists(stateFile))) {
@@ -166,23 +188,21 @@ async function ensureConfigInitialized(api) {
       initializedAt: nowIso(),
       status: "initialized",
       source: "restart-continuity",
-      defaultsApplied: Boolean(defaults),
+      builtInDefaultsActive: !(Array.isArray(pluginConfig.resumers) && pluginConfig.resumers.length > 0),
     });
   }
 
-  api.logger.info?.(`[restart-continuity] initialized (${defaults ? "defaults detected" : "no defaults file"})`);
+  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;
   const notifyOnBootstrap = pluginConfig.notifyOnBootstrap !== false;
   const { date, local } = getDatePartsForShanghai(new Date());
-  const resumers = Array.isArray(pluginConfig.resumers) ? pluginConfig.resumers : [];
+  const resumers = getEffectiveResumers(pluginConfig);
 
   const summary = {
     version: 1,
@@ -241,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",
@@ -254,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" },
@@ -262,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",
@@ -284,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.3.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.3.1",
+  "version": "0.5.0",
   "description": "OpenClaw restart continuity plugin with resumable startup checks and receipt handoff",
   "type": "module",
   "license": "MIT",