@karmaniverous/jeeves-watcher-openclaw 0.13.2 → 0.14.0

package/dist/skills/jeeves-watcher/SKILL.md

@@ -48,7 +48,14 @@ curl http://127.0.0.1:<PORT>/config
 | `/issues` | GET | Runtime embedding failures |
 | `/rules/register` | POST | Register virtual inference rules (auto-triggers rules reindex) |
 | `/rules/unregister` | DELETE | Remove virtual rules by source |
+| `/rules/unregister/:source` | DELETE | Remove virtual rules by source (parameterized) |
+| `/rules/reapply` | POST | Re-apply rules to points |
 | `/points/delete` | POST | Delete points matching a Qdrant filter |
+| `/render` | POST | Render a template for a document |
+| `/search/facets` | GET | Get search facet values |
+| `/rebuild-metadata` | POST | Rebuild enrichment metadata from Qdrant |
+| `/config/schema` | GET | Get config JSON schema |
+| `/config/match` | POST | Match config paths against rules |
 
 **If the watcher is unreachable:** Check the service status (`nssm status jeeves-watcher` on Windows), check the configured port in the watcher config file, and check logs for startup errors.
 
@@ -119,12 +126,12 @@ When the plugin loads and the watcher service is NOT yet set up, drive the entir
 
 ### Step 1: Check Node.js
 
-Verify Node.js is installed and version ≥ 20:
+Verify Node.js is installed and version ≥ 22:
 ```bash
 node --version
 ```
 
-If missing or too old, guide the user to install Node.js 20+ from https://nodejs.org or via their package manager.
+If missing or too old, guide the user to install Node.js 22+ from https://nodejs.org or via their package manager.
 
 ### Step 2: Install Qdrant
 
@@ -461,6 +468,12 @@ do {
 } while (cursor);
 ```
 
+### `watcher_service`
+Manage the watcher background service (install, uninstall, start, stop, restart, check status).
+- `action` (string, required) — one of: `install`, `uninstall`, `start`, `stop`, `restart`, `status`
+
+Returns the service manager's response. On Windows uses NSSM, on Linux uses systemd.
+
 ### `watcher_issues`
 Get runtime embedding failures. Returns `{ filePath: IssueRecord }` showing files that failed and why.
 
@@ -777,6 +790,27 @@ $.mapHelpers              — JsonMap helper namespaces with exports
 $.templateHelpers         — Handlebars helper namespaces with exports
 ```
 
+### Built-in JsonMap Helpers
+
+The following helpers are available in every JsonMap `lib` context without any helper config:
+
+#### `fetchSiblings(filePath, options?)`
+Retrieve extracted text from neighboring files in the same directory. Useful for contextual embedding — e.g., injecting surrounding email messages into a thread member's embedding for better semantic search.
+
+**Parameters:**
+- `filePath` (string) — the current file path (typically `$file_path`)
+- `options` (object, optional):
+  - `before` (number, default 3) — number of preceding siblings to include
+  - `after` (number, default 1) — number of following siblings to include
+  - `sort` (`"name"` | `"mtime"`, default `"name"`) — sort order for determining neighbor position
+
+**Returns:** `string[]` — extracted text from sibling files, in sort order. Files that fail extraction are silently skipped.
+
+**Example** (in a JsonMap `$set` expression):
+```json
+{ "context": { "$fn": "fetchSiblings", "$args": ["$file_path", { "before": 2, "after": 1 }] } }
+```
+
 ---
 
 ## Enrichment

package/dist/src/configApplyIntegration.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module plugin/configApplyIntegration.test
+ * Cross-cutting integration test: exercises the factory-generated
+ * watcher_config_apply tool against a mock /config/apply handler to verify
+ * the `patch` envelope round-trip works end-to-end.
+ */
+export {};

package/dist/src/constants.d.ts

@@ -15,7 +15,7 @@ export declare const SERVICE_PACKAGE = "@karmaniverous/jeeves-watcher";
 /** npm package name for the plugin. */
 export declare const PLUGIN_PACKAGE = "@karmaniverous/jeeves-watcher-openclaw";
 /** Default watcher API port. */
-export declare const DEFAULT_PORT = 1936;
+export declare const DEFAULT_PORT: number;
 /** Default watcher API base URL. */
 export declare const DEFAULT_API_URL: string;
 /** Default platform config root path. */

package/dist/src/watcherTools.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module plugin/watcherTools
- * Watcher tool registrations (watcher_* tools) for the OpenClaw plugin.
+ * Domain-specific watcher tool registrations (7 tools) for the OpenClaw plugin.
  */
 import { type PluginApi } from '@karmaniverous/jeeves';
-/** Register all 9 watcher_* tools with the OpenClaw plugin API. */
+/** Register the 7 domain-specific watcher_* tools with the OpenClaw plugin API. */
 export declare function registerWatcherTools(api: PluginApi, baseUrl: string): void;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-watcher-openclaw",
   "name": "Jeeves Watcher",
   "description": "Semantic search, metadata enrichment, and instance administration for a jeeves-watcher deployment.",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-watcher-openclaw",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
   "license": "BSD-3-Clause",
@@ -42,7 +42,7 @@
     "semantic-search"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "openclaw": {
     "extensions": [
@@ -57,7 +57,7 @@
     "hideCredit": true
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.4.6"
+    "@karmaniverous/jeeves": "^0.5.1"
   },
   "devDependencies": {
     "@dotenvx/dotenvx": "^1.59.1",