feat: schedule cache, workflow-aligned prompts, dispatchInbound wakeup

1. ScheduleCache: local cache of today's schedule, synced every 5 min
   from HF backend via new getDaySchedule() API

2. Wakeup prompts updated to reference daily-routine skill workflows
   (task-handson, plan-schedule, slot-complete)

3. Agent wakeup via dispatchInboundMessageWithDispatcher (in-process)
   - Same mechanism as Discord plugin
   - Creates unique session per slot: agent:{agentId}:hf-calendar:slot-{slotId}
   - No WebSocket, CLI, or cron dependency
   - Verified working on test environment

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.gitignore

@@ -4,5 +4,3 @@ plugin/**/*.js
 plugin/**/*.js.map
 plugin/**/*.d.ts
 plugin/**/*.d.ts.map
-# Hand-written ambient declarations are tracked; only compiled .d.ts above is ignored.
-!plugin/openclaw-sdk.d.ts

README.md

@@ -1,107 +1,84 @@
 # HarborForge OpenClaw Plugin
 
-OpenClaw plugin that exposes OpenClaw-side metadata to the HarborForge Monitor, provides an optional local Monitor bridge, drives the HarborForge Calendar scheduler, and can optionally install the `hf` CLI.
+OpenClaw 插件：向 HarborForge Monitor 暴露 OpenClaw 侧元数据，并提供可选的本地桥接能力；安装时也可顺带安装 `hf` CLI。
 
-Part of the [HarborForge](../README.md) platform.
+## 当前状态
 
-- Role: OpenClaw integration layer for HarborForge (registered plugin id: `harbor-forge`).
-- Talks to the HarborForge backend (`backendUrl`, default `https://monitor.hangman-lab.top`) for Calendar APIs.
-- Talks to a local HarborForge.Monitor bridge over `127.0.0.1:<monitor_port>` (no fixed default; commonly `9100`).
+- 插件注册名：`harbor-forge`
+- 旧 sidecar `server/` 架构已移除
+- 监控桥接走本地 `monitor_port`
+- 安装脚本支持 `--install-cli`
+- `skills/hf/` 仅在 `--install-cli` 时一并安装
 
-## Current State
-
-- Plugin registration id: `harbor-forge` (was `harborforge-monitor`)
-- Plugin version: `0.2.0` (package manifests); telemetry reports `pluginVersion` `0.3.1`
-- Legacy sidecar `server/` architecture removed — telemetry is served directly by the plugin
-- Monitor bridge runs over the local `monitor_port`
-- Calendar scheduler integration (PLG-CAL-001 / 002 / 004)
-- Installer supports `--install-cli` and an optional managed Monitor (`--install-monitor`)
-- `skills/hf/` is installed only with `--install-cli`
-
-## Project Structure
+## 项目结构
 
 ```text
 HarborForge.OpenclawPlugin/
 ├── package.json
 ├── README.md
-├── docs/                         # design notes (calendar, monitor connector)
 ├── plugin/
-│   ├── openclaw.plugin.json      # plugin manifest + config schema
-│   ├── index.ts                  # plugin entry, tool registration
-│   ├── tsconfig.json
+│   ├── openclaw.plugin.json
+│   ├── index.ts
 │   ├── core/
-│   │   ├── config.ts             # config defaults / resolution
-│   │   ├── managed-monitor.ts    # optionally spawn HarborForge.Monitor
-│   │   ├── monitor-bridge.ts     # client for the Monitor bridge
-│   │   └── openclaw-agents.ts    # enumerate OpenClaw agents
-│   ├── calendar/                 # Calendar scheduler + bridge
-│   │   ├── index.ts
-│   │   ├── scheduler.ts
-│   │   ├── calendar-bridge.ts
-│   │   └── types.ts
+│   │   ├── config.ts
+│   │   ├── managed-monitor.ts
+│   │   └── monitor-bridge.ts
 │   ├── hooks/
 │   │   ├── gateway-start.ts
 │   │   └── gateway-stop.ts
 │   └── package.json
 ├── skills/
 │   └── hf/
-│       └── SKILL.md              # installed only with --install-cli
+│       └── SKILL.md
 └── scripts/
     └── install.mjs
 ```
 
-## Installation
+## 安装
 
-### Standard Install
+### 普通安装
 
 ```bash
 node scripts/install.mjs
 ```
 
-This will:
-- Build and install the OpenClaw plugin
-- Copy regular skills
-- **Not** install the `hf` binary
-- **Not** copy `skills/hf/`
+这会：
+- 构建并安装 OpenClaw 插件
+- 复制常规 skills
+- **不会**安装 `hf` 二进制
+- **不会**复制 `skills/hf/`
 
-### Plugin + `hf` CLI
+### 安装插件 + `hf` CLI
 
 ```bash
 node scripts/install.mjs --install-cli
 ```
 
-This additionally:
-- Builds `HarborForge.Cli` (`go build ./cmd/hf`)
-- Installs `hf` to `<openclaw>/bin/hf` (default `~/.openclaw/bin/hf`) and `chmod +x`
-- Copies `skills/hf/` into the OpenClaw skills directory
+这会额外：
+- 构建 `HarborForge.Cli`
+- 安装 `hf` 到 `~/.openclaw/bin/hf`
+- `chmod +x ~/.openclaw/bin/hf`
+- 复制 `skills/hf/` 到 OpenClaw profile skills 目录
 
-### Common Options
+### 常用选项
 
 ```bash
-# Build only (no install / config)
+# 仅构建
 node scripts/install.mjs --build-only
 
-# Install only, skip dependency checks
-node scripts/install.mjs --skip-check
-
-# Specify OpenClaw profile path (also honors OPENCLAW_PATH env)
+# 指定 OpenClaw profile
 node scripts/install.mjs --openclaw-profile-path /custom/path/.openclaw
 
-# Build and install a managed HarborForge.Monitor binary alongside the plugin
-node scripts/install.mjs --install-monitor yes --monitor-branch main
-
-# Verbose logs
+# 详细日志
 node scripts/install.mjs --verbose
 
-# Uninstall (plugin, config entries, hf binary, managed monitor)
+# 卸载
 node scripts/install.mjs --uninstall
 ```
 
-The installer also updates OpenClaw config (`plugins.load.paths`, `plugins.allow`, `plugins.entries.harbor-forge.enabled`) via `openclaw config`.
+## 配置
 
-## Configuration
-
-Edit `~/.openclaw/openclaw.json`:
+编辑 `~/.openclaw/openclaw.json`：
 
 ```json
 {
@@ -117,9 +94,7 @@ Edit `~/.openclaw/openclaw.json`:
           "monitor_port": 9100,
           "reportIntervalSec": 30,
           "httpFallbackIntervalSec": 60,
-          "logLevel": "info",
-          "calendarEnabled": true,
-          "calendarHeartbeatIntervalSec": 60
+          "logLevel": "info"
         }
       }
     }
@@ -127,72 +102,51 @@ Edit `~/.openclaw/openclaw.json`:
 }
 ```
 
-Then restart:
+然后重启：
 
 ```bash
 openclaw gateway restart
 ```
 
-## Config Options
+## 配置项
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `enabled` | boolean | `true` | Enable the plugin |
-| `backendUrl` | string | `https://monitor.hangman-lab.top` | HarborForge backend base URL (Monitor + Calendar APIs) |
-| `identifier` | string | hostname | Server / claw identifier |
-| `apiKey` | string | (none) | Server API key from the HarborForge Monitor admin panel |
-| `monitor_port` | number | (none) | Local bridge port; plugin talks to HarborForge.Monitor via `127.0.0.1:<monitor_port>` |
-| `reportIntervalSec` | number | `30` | Metadata push interval (seconds) |
-| `httpFallbackIntervalSec` | number | `60` | HTTP heartbeat interval when WS unavailable |
-| `logLevel` | string | `info` | Log level: `debug` / `info` / `warn` / `error` |
-| `calendarEnabled` | boolean | `true` | Enable Calendar scheduler integration (PLG-CAL-001) |
-| `calendarHeartbeatIntervalSec` | number | `60` | Calendar heartbeat interval (seconds) |
-| `calendarApiKey` | string | (none) | API key for Calendar API auth; falls back to `apiKey` / `X-Agent-ID` |
-| `managedMonitor` | string | (none) | Absolute path to a HarborForge.Monitor binary; if set, gateway start/stop hooks spawn/stop it |
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `enabled` | boolean | `true` | 是否启用插件 |
+| `backendUrl` | string | `https://monitor.hangman-lab.top` | HarborForge Monitor 后端地址 |
+| `identifier` | string | 主机名 | 服务器标识符 |
+| `apiKey` | string | 无 | HarborForge Monitor 生成的服务器 API Key |
+| `monitor_port` | number | 无 | 本地桥接端口；插件通过 `127.0.0.1:<monitor_port>` 与 HarborForge.Monitor 通信 |
+| `reportIntervalSec` | number | `30` | 报告间隔（秒） |
+| `httpFallbackIntervalSec` | number | `60` | HTTP 回退间隔（秒） |
+| `logLevel` | string | `info` | 日志级别：`debug` / `info` / `warn` / `error` |
 
-## Local Monitor Bridge
+## 本地桥接说明
 
-When the plugin has `monitor_port` configured and HarborForge.Monitor uses the same `MONITOR_PORT`:
+当插件配置了 `monitor_port`，并且 HarborForge.Monitor 也使用相同的 `MONITOR_PORT` 时：
 
-- Monitor serves a local bridge on `127.0.0.1:<MONITOR_PORT>`
-- The plugin probes `GET /health`
-- The plugin tool `harborforge_monitor_telemetry` reads `GET /telemetry`
-- The plugin pushes OpenClaw metadata (version, plugin version, agents) via `POST /openclaw` on the `reportIntervalSec` cadence, enriching Monitor heartbeats
-- If the bridge port is unconfigured or unreachable, the plugin still works normally
+- Monitor 在 `127.0.0.1:<MONITOR_PORT>` 提供本地桥接服务
+- 插件可探测 `GET /health`
+- 插件工具 `harborforge_monitor_telemetry` 可读取 `GET /telemetry`
+- 如果桥接端口未配置或不可达，插件仍可正常运行
 
-This link is an **optional enhancement**, not a precondition for the plugin to start or for Monitor heartbeats.
+也就是说，这条链路是**可选增强**，不是插件启动或 Monitor 心跳的前置条件。
 
-## Managed Monitor
+## 插件提供的信息
 
-If `managedMonitor` points to an installed HarborForge.Monitor binary, the `gateway_start` hook spawns it (passing `--backend-url`, `--identifier`, `--api-key`, `--monitor-port`, `--report-interval`, `--log-level` from the plugin config) and `gateway_stop` terminates it. Use `install.mjs --install-monitor yes` to build and wire this automatically.
+### OpenClaw 元数据
+- OpenClaw version
+- plugin version
+- 标识符 / 主机名
+- 时间戳
 
-## Calendar Scheduler
+### 系统快照
+- uptime
+- memory total/free/used/usagePercent
+- load avg1/avg5/avg15
+- platform
 
-When `calendarEnabled` is true, on gateway start the plugin starts a Calendar scheduler that heartbeats the backend (`/calendar/agent/heartbeat`, `/calendar/agent/status`, `/calendar/agent/notify`) to receive and run scheduled TimeSlots, waking/spawning agents via the OpenClaw `spawn` API (with a notification fallback). Scheduler state is persisted to a state file; gateway restarts can be requested by the backend (PLG-CAL-004).
-
-## Tools Provided
-
-| Tool | Description |
-|------|-------------|
-| `harborforge_status` | Plugin status, resolved config, Monitor bridge health, calendar status, telemetry snapshot |
-| `harborforge_telemetry` | Current system telemetry snapshot from this host |
-| `harborforge_monitor_telemetry` | Query the Monitor bridge for host hardware telemetry |
-| `harborforge_calendar_status` | Calendar scheduler status and current slot |
-| `harborforge_calendar_complete` | Complete the current calendar slot with actual duration |
-| `harborforge_calendar_abort` | Abort the current calendar slot |
-| `harborforge_calendar_pause` | Pause the current calendar slot |
-| `harborforge_calendar_resume` | Resume the paused calendar slot |
-| `harborforge_restart_status` | Check whether a gateway restart is pending |
-
-### Telemetry Snapshot Fields
-
-- `identifier`, `hostname`, `platform`, `timestamp`
-- `uptime`
-- `memory`: `total` / `free` / `used` / `usagePercent`
-- `load`: `avg1` / `avg5` / `avg15`
-- `openclaw`: `version` / `pluginVersion`
-
-## Development
+## 开发
 
 ```bash
 cd plugin
@@ -200,16 +154,14 @@ npm install
 npm run build
 ```
 
-The build runs `tsc` and emits `dist/` (`dist/index.js` is the plugin entry).
-
-## Dependencies
+## 依赖
 
 - Node.js 18+
 - OpenClaw Gateway
-- Go 1.20+ (only for `--install-cli` / `--install-monitor`)
+- Go 1.20+（仅 `--install-cli` 需要）
 
-## Tips
+## 相关提示
 
-- After installing `hf`, add `~/.openclaw/bin` to your `PATH`
-- When an agent uses `hf`, try `hf --help-brief` first
-- For the full command tree, see `hf --help`
+- 安装 `hf` 后，建议把 `~/.openclaw/bin` 加到 `PATH`
+- Agent 使用 `hf` 时，优先试 `hf --help-brief`
+- 完整命令树看 `hf --help`

plugin/calendar/calendar-bridge.ts

@@ -29,7 +29,7 @@ import {
   CalendarSlotResponse,
   SlotAgentUpdate,
   SlotStatus,
-} from './types.js';
+} from './types';
 
 export interface CalendarBridgeConfig {
   /** HarborForge backend base URL (e.g. "https://monitor.hangman-lab.top") */
@@ -292,7 +292,7 @@ export class CalendarBridgeClient {
 // ---------------------------------------------------------------------------
 
 import { hostname } from 'os';
-import { getPluginConfig } from '../core/config.js';
+import { getPluginConfig } from '../core/config';
 
 export interface CalendarPluginConfig {
   /** Backend URL for calendar API (overrides monitor backendUrl) */

plugin/calendar/index.ts

@@ -13,7 +13,7 @@
  *   • AgentWakeContext — context passed to agent when waking
  *
  * Usage in plugin/index.ts:
- *   import { createCalendarBridgeClient, createCalendarScheduler } from './calendar.js';
+ *   import { createCalendarBridgeClient, createCalendarScheduler } from './calendar';
  *
  *   const agentId = process.env.AGENT_ID || 'unknown';
  *   const calendar = createCalendarBridgeClient(api, 'https://monitor.hangman-lab.top', agentId);
@@ -28,7 +28,7 @@
  *   scheduler.start();
  */
 
-export * from './types.js';
-export * from './calendar-bridge.js';
-export * from './scheduler.js';
-export * from './schedule-cache.js';
+export * from './types';
+export * from './calendar-bridge';
+export * from './scheduler';
+export * from './schedule-cache';

plugin/calendar/scheduler.ts

@@ -18,7 +18,8 @@
 
 import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
-import { CalendarBridgeClient } from './calendar-bridge.js';
+import { CalendarBridgeClient } from './calendar-bridge';
+import { ScheduleCache } from './schedule-cache';
 import {
   CalendarSlotResponse,
   SlotStatus,
@@ -26,7 +27,7 @@ import {
   SlotAgentUpdate,
   CalendarEventDataJob,
   CalendarEventDataSystemEvent,
-} from './types.js';
+} from './types';
 
 export interface CalendarSchedulerConfig {
   /** Calendar bridge client for backend communication */
@@ -44,6 +45,8 @@ export interface CalendarSchedulerConfig {
   };
   /** Heartbeat interval in milliseconds (default: 60000) */
   heartbeatIntervalMs?: number;
+  /** Schedule sync interval in milliseconds (default: 300000 = 5 min) */
+  syncIntervalMs?: number;
   /** Enable verbose debug logging */
   debug?: boolean;
   /** Directory for state persistence (default: plugin data dir) */
@@ -95,8 +98,10 @@ interface SchedulerState {
   currentSlot: CalendarSlotResponse | null;
   /** Last heartbeat timestamp */
   lastHeartbeatAt: Date | null;
-  /** Interval handle for cleanup */
+  /** Heartbeat interval handle */
   intervalHandle: ReturnType<typeof setInterval> | null;
+  /** Schedule sync interval handle */
+  syncIntervalHandle: ReturnType<typeof setInterval> | null;
   /** Set of slot IDs that have been deferred in current session */
   deferredSlotIds: Set<string>;
   /** Whether agent is currently processing a slot */
@@ -117,10 +122,13 @@ export class CalendarScheduler {
   private config: Required<CalendarSchedulerConfig>;
   private state: SchedulerState;
   private stateFilePath: string;
+  /** Local cache of today's full schedule, synced periodically from backend */
+  private scheduleCache: ScheduleCache = new ScheduleCache();
 
   constructor(config: CalendarSchedulerConfig) {
     this.config = {
       heartbeatIntervalMs: 60000, // 1 minute default
+      syncIntervalMs: 300_000,    // 5 minutes default
       debug: false,
       stateDir: this.getDefaultStateDir(),
       ...config,
@@ -133,6 +141,7 @@ export class CalendarScheduler {
       currentSlot: null,
       lastHeartbeatAt: null,
       intervalHandle: null,
+      syncIntervalHandle: null,
       deferredSlotIds: new Set(),
       isProcessing: false,
       isRestartPending: false,
@@ -327,14 +336,21 @@ export class CalendarScheduler {
     this.state.isRestartPending = false;
     this.config.logger.info('Calendar scheduler started');
 
-    // Run initial heartbeat immediately
+    // Run initial sync + heartbeat immediately
+    this.runSync();
     this.runHeartbeat();
 
-    // Schedule periodic heartbeats
+    // Schedule periodic heartbeats (slot execution checks)
     this.state.intervalHandle = setInterval(
       () => this.runHeartbeat(),
       this.config.heartbeatIntervalMs
     );
+
+    // Schedule periodic schedule sync (full day schedule refresh)
+    this.state.syncIntervalHandle = setInterval(
+      () => this.runSync(),
+      this.config.syncIntervalMs
+    );
   }
 
   /**
@@ -348,10 +364,41 @@ export class CalendarScheduler {
       clearInterval(this.state.intervalHandle);
       this.state.intervalHandle = null;
     }
+    if (this.state.syncIntervalHandle) {
+      clearInterval(this.state.syncIntervalHandle);
+      this.state.syncIntervalHandle = null;
+    }
 
     this.config.logger.info('Calendar scheduler stopped');
   }
 
+  /**
+   * Sync today's full schedule from backend into local cache.
+   * Runs every syncIntervalMs (default: 5 min).
+   * Catches new slots assigned by other agents or the manager.
+   */
+  async runSync(): Promise<void> {
+    if (!this.state.isRunning || this.state.isRestartPending) return;
+
+    const today = new Date().toISOString().slice(0, 10);
+    try {
+      const slots = await this.config.bridge.getDaySchedule(today);
+      if (slots) {
+        this.scheduleCache.sync(today, slots);
+        this.logDebug(`Schedule synced: ${slots.length} slots for ${today}`);
+      }
+    } catch (err) {
+      this.config.logger.warn(`Schedule sync failed: ${String(err)}`);
+    }
+  }
+
+  /**
+   * Get the local schedule cache (for status reporting / tools).
+   */
+  getScheduleCache(): ScheduleCache {
+    return this.scheduleCache;
+  }
+
   /**
    * Execute a single heartbeat cycle.
    * Fetches pending slots and handles execution logic.
@@ -611,13 +658,11 @@ Task Code: ${code}
 Estimated Duration: ${duration} minutes
 Slot Type: ${slot.slot_type}
 Priority: ${slot.priority}
+Working Sessions: ${jobData.working_sessions?.join(', ') || 'none recorded'}
 
-Please focus on this task for the allocated time. When you finish or need to pause,
-report your progress back to the calendar system.
-
-Working sessions: ${jobData.working_sessions?.join(', ') || 'none recorded'}
-
-Start working on ${code} now.`;
+Follow the daily-routine skill's task-handson workflow to execute this task.
+Use harborforge_calendar_complete when finished, or harborforge_calendar_pause to pause.
+Before going idle, check for overdue slots as described in the slot-complete workflow.`;
   }
 
   /**
@@ -630,19 +675,15 @@ Start working on ${code} now.`;
     switch (sysData.event) {
       case 'ScheduleToday':
         return `System Event: Schedule Today
-
-Please review today's calendar and schedule any pending tasks or planning activities.
 Estimated time: ${slot.estimated_duration} minutes.
 
-Check your calendar and plan the day's work.`;
+Follow the daily-routine skill's plan-schedule workflow to plan today's work.`;
 
       case 'SummaryToday':
         return `System Event: Daily Summary
-
-Please provide a summary of today's activities and progress.
 Estimated time: ${slot.estimated_duration} minutes.
 
-Review what was accomplished and prepare end-of-day notes.`;
+Review today's completed, deferred, and abandoned slots. Write a summary to your daily note (memory/YYYY-MM-DD.md).`;
 
       case 'ScheduledGatewayRestart':
         return `System Event: Scheduled Gateway Restart

plugin/hooks/gateway-start.ts

@@ -1,6 +1,6 @@
 import { hostname } from 'os';
-import { getPluginConfig } from '../core/config.js';
-import { startManagedMonitor } from '../core/managed-monitor.js';
+import { getPluginConfig } from '../core/config';
+import { startManagedMonitor } from '../core/managed-monitor';
 
 export function registerGatewayStartHook(api: any, deps: {
   logger: any;

plugin/hooks/gateway-stop.ts

@@ -1,4 +1,4 @@
-import { stopManagedMonitor } from '../core/managed-monitor.js';
+import { stopManagedMonitor } from '../core/managed-monitor';
 
 export function registerGatewayStopHook(api: any, deps: {
   logger: any;

plugin/index.ts

@@ -11,20 +11,18 @@
  * served directly by the plugin when Monitor queries via the
  * local monitor_port communication path.
  */
-import { hostname, freemem, totalmem, uptime, loadavg, platform } from 'node:os';
-import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
-import { MultiAgentScheduleCache } from './calendar/schedule-cache.js';
-import { getPluginConfig } from './core/config.js';
-import { MonitorBridgeClient, type OpenClawMeta } from './core/monitor-bridge.js';
-import type { OpenClawAgentInfo } from './core/openclaw-agents.js';
-import { registerGatewayStartHook } from './hooks/gateway-start.js';
-import { registerGatewayStopHook } from './hooks/gateway-stop.js';
+import { hostname, freemem, totalmem, uptime, loadavg, platform } from 'os';
+import { getPluginConfig } from './core/config';
+import { MonitorBridgeClient, type OpenClawMeta } from './core/monitor-bridge';
+import type { OpenClawAgentInfo } from './core/openclaw-agents';
+import { registerGatewayStartHook } from './hooks/gateway-start';
+import { registerGatewayStopHook } from './hooks/gateway-stop';
 import {
   createCalendarBridgeClient,
   createCalendarScheduler,
   CalendarScheduler,
   AgentWakeContext,
-} from './calendar/index.js';
+} from './calendar';
 
 interface PluginAPI {
   logger: {
@@ -55,7 +53,10 @@ interface PluginAPI {
   getAgentStatus?: () => Promise<{ status: string } | null>;
 }
 
-function register(api: PluginAPI): void {
+export default {
+  id: 'harbor-forge',
+  name: 'HarborForge',
+  register(api: PluginAPI) {
     const logger = api.logger || {
       info: (...args: any[]) => console.log('[HarborForge]', ...args),
       error: (...args: any[]) => console.error('[HarborForge]', ...args),
@@ -197,18 +198,7 @@ function register(api: PluginAPI): void {
      * Wake agent via dispatchInboundMessage — same mechanism used by Discord plugin.
      * Direct in-process call, no WebSocket or CLI needed.
      */
-    async function wakeAgent(
-      agentId: string,
-      dueSlots?: Array<{
-        id?: number | null;
-        virtual_id?: string | null;
-        event_data?: any;
-        scheduled_at?: string;
-        priority?: number;
-        slot_type?: string;
-        [k: string]: unknown;
-      }>
-    ): Promise<boolean> {
+    async function wakeAgent(agentId: string): Promise<boolean> {
       logger.info(`Waking agent ${agentId}: has due slots`);
 
       const sessionKey = `agent:${agentId}:hf-wakeup`;
@@ -219,39 +209,13 @@ function register(api: PluginAPI): void {
           /* webpackIgnore: true */ sdkPath
         );
 
-        // api.config first (current public API). Fall back to deprecated
-        // runtime.config.loadConfig() for older host versions. Both should
-        // contain agents.list / channels for dispatch routing.
-        const cfg = (api as any).config ?? api.runtime?.config?.loadConfig?.();
+        const cfg = api.runtime?.config?.loadConfig?.();
         if (!cfg) {
           logger.error('Cannot load OpenClaw config for dispatch');
           return false;
         }
 
-        // Inline the highest-priority due slot's context so the agent does
-        // not need a second round-trip to harborforge_calendar_status. The
-        // agent can read event_data.task_code / task_title etc. directly.
-        let slotBlock = '';
-        const top = dueSlots && dueSlots.length ? dueSlots[0] : undefined;
-        if (top) {
-          slotBlock = `\n\nMatching slot:\n\`\`\`json\n${JSON.stringify(
-            {
-              slot_id: top.id ?? null,
-              virtual_id: top.virtual_id ?? null,
-              scheduled_at: top.scheduled_at ?? null,
-              priority: top.priority ?? null,
-              slot_type: top.slot_type ?? null,
-              event_data: top.event_data ?? null,
-            },
-            null,
-            2
-          )}\n\`\`\``;
-        }
-
-        const wakeupMessage =
-          `You have due slots. Follow the \`hf-wakeup\` workflow of skill ` +
-          `\`hf-hangman-lab\` to proceed. Only reply \`WAKEUP_OK\` in this ` +
-          `session.${slotBlock}`;
+        const wakeupMessage = `You have due slots. Follow the \`hf-wakeup\` workflow of skill \`hf-hangman-lab\` to proceed. Only reply \`WAKEUP_OK\` in this session.`;
 
         const result = await dispatchInboundMessageWithDispatcher({
           ctx: {
@@ -326,6 +290,7 @@ function register(api: PluginAPI): void {
       );
 
       // Multi-agent sync + check loop
+      const { MultiAgentScheduleCache } = require('./calendar/schedule-cache') as typeof import('./calendar/schedule-cache');
       const scheduleCache = new MultiAgentScheduleCache();
 
       const SYNC_INTERVAL_MS = 300_000; // 5 min
@@ -345,59 +310,28 @@ function register(api: PluginAPI): void {
         }
       }
 
-      // Track wakes already dispatched for a slot in the current sync
-      // window — the simplified inline scheduler does not PATCH slot
-      // status server-side, so without dedupe the check loop re-wakes
-      // the same slot every 30s. Set is cleared by runSync (fresh wake
-      // budget per sync).
-      const wakedSlotKeys = new Set<string>();
-
       // Check: find agents with due slots and wake them
       async function runCheck() {
         const now = new Date();
         const agentsWithDue = scheduleCache.getAgentsWithDueSlots(now);
 
-        for (const { agentId, slots } of agentsWithDue) {
-          // Filter out slots we've already woken this sync window
-          const fresh = slots.filter((s) => {
-            const key = `${agentId}::${s.id ?? s.virtual_id ?? s.scheduled_at}`;
-            if (wakedSlotKeys.has(key)) return false;
-            return true;
-          });
-          if (fresh.length === 0) continue;
-
-          // Check if agent is busy (best effort; backend may 405 the GET
-          // — treat unknown as not-busy so wakeup still fires)
-          let status: string | null = null;
-          try {
-            status = await calendarBridge.getAgentStatus(agentId);
-          } catch {
-            status = null;
-          }
+        for (const { agentId } of agentsWithDue) {
+          // Check if agent is busy
+          const status = await calendarBridge.getAgentStatus(agentId);
           if (status === 'busy' || status === 'offline' || status === 'exhausted') {
             continue;
           }
 
-          // Wake the agent with the slot context inlined
-          const ok = await wakeAgent(agentId, fresh);
-          if (ok) {
-            for (const s of fresh) {
-              const key = `${agentId}::${s.id ?? s.virtual_id ?? s.scheduled_at}`;
-              wakedSlotKeys.add(key);
-            }
-          }
+          // Wake the agent
+          await wakeAgent(agentId);
         }
       }
 
-      // Initial sync (also resets the wake-dedupe window)
-      const runSyncReset = async () => {
-        wakedSlotKeys.clear();
-        await runSync();
-      };
-      runSyncReset();
+      // Initial sync
+      runSync();
 
       // Start intervals
-      const syncHandle = setInterval(runSyncReset, SYNC_INTERVAL_MS);
+      const syncHandle = setInterval(runSync, SYNC_INTERVAL_MS);
       const checkHandle = setInterval(runCheck, CHECK_INTERVAL_MS);
 
       // Store handles for cleanup (reuse calendarScheduler variable)
@@ -661,16 +595,5 @@ function register(api: PluginAPI): void {
     }));
 
     logger.info('HarborForge plugin registered (id: harbor-forge)');
-}
-
-// HarborForge's local PluginAPI is broader than the standard OpenClawPluginApi
-// (it surfaces optional `version`/`runtime`/`spawn` accessors that older
-// OpenClaw builds exposed). The cast at the definePluginEntry boundary
-// acknowledges that gap — the runtime api object is whatever the gateway
-// passes us, and each access is guarded with optional chaining / fallbacks.
-export default definePluginEntry({
-  id: 'harbor-forge',
-  name: 'HarborForge',
-  description: 'HarborForge plugin for OpenClaw - project management, monitoring, and CLI integration',
-  register: register as (api: any) => void,
-});
+  },
+};

plugin/openclaw-sdk.d.ts

@@ -1,25 +0,0 @@
-// Ambient declarations for the focused subpaths of the openclaw plugin SDK
-// that this plugin needs at compile time.
-//
-// We intentionally do NOT take a `dependencies` (or `devDependencies`) entry
-// on the openclaw npm package itself: openclaw is provided by the host
-// gateway at runtime, and listing it as a file:/.../openclaw devDep breaks
-// the installer's `npm install --omit=dev` step because npm/arborist trips
-// over openclaw's own (deeply nested) dependency graph.
-//
-// These declarations cover only what we use here. They are deliberately
-// permissive — the runtime contract is whatever the gateway hands us, and
-// we guard each api access with optional chaining or a fallback at call site.
-
-declare module 'openclaw/plugin-sdk/plugin-entry' {
-  export function definePluginEntry<T extends {
-    id: string;
-    name: string;
-    description?: string;
-    register: (api: any) => void | Promise<void>;
-  }>(opts: T): T;
-}
-
-declare module 'openclaw/plugin-sdk/core' {
-  export type OpenClawPluginApi = unknown;
-}

plugin/openclaw.plugin.json

@@ -1,23 +1,9 @@
 {
   "id": "harbor-forge",
   "name": "HarborForge",
+  "version": "0.2.0",
   "description": "HarborForge plugin for OpenClaw - project management, monitoring, and CLI integration",
-  "activation": {
-    "onStartup": true
-  },
-  "contracts": {
-    "tools": [
-      "harborforge_status",
-      "harborforge_telemetry",
-      "harborforge_monitor_telemetry",
-      "harborforge_calendar_status",
-      "harborforge_calendar_complete",
-      "harborforge_calendar_abort",
-      "harborforge_calendar_pause",
-      "harborforge_calendar_resume",
-      "harborforge_restart_status"
-    ]
-  },
+  "entry": "./dist/index.js",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

plugin/package-lock.json

@@ -9,14 +9,14 @@
       "version": "0.2.0",
       "license": "MIT",
       "devDependencies": {
-        "@types/node": "^20.19.41",
+        "@types/node": "^20.0.0",
         "typescript": "^5.0.0"
       }
     },
     "node_modules/@types/node": {
-      "version": "20.19.41",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.41.tgz",
-      "integrity": "sha512-ECymXOukMnOoVkC2bb1Vc/w/836DXncOg5m8Xj1RH7xSHZJWNYY6Zh7EH477vcnD5egKNNfy2RpNOmuChhFPgQ==",
+      "version": "20.19.37",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.37.tgz",
+      "integrity": "sha512-8kzdPJ3FsNsVIurqBs7oodNnCEVbni9yUEkaHbgptDACOPW04jimGagZ51E6+lXUwJjgnBw+hyko/lkFWCldqw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {

plugin/package.json

@@ -2,7 +2,6 @@
   "name": "harbor-forge-plugin",
   "version": "0.2.0",
   "description": "OpenClaw plugin for HarborForge monitor bridge and CLI integration",
-  "type": "module",
   "main": "dist/index.js",
   "scripts": {
     "clean": "rm -rf dist",
@@ -10,7 +9,7 @@
     "watch": "tsc --watch"
   },
   "devDependencies": {
-    "@types/node": "^20.19.41",
+    "@types/node": "^20.0.0",
     "typescript": "^5.0.0"
   },
   "license": "MIT"

plugin/tsconfig.json

@@ -1,8 +1,8 @@
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
+    "module": "CommonJS",
+    "moduleResolution": "node",
     "esModuleInterop": true,
     "strict": true,
     "skipLibCheck": true,