@karmaniverous/jeeves-watcher-openclaw 0.14.10 → 0.15.0

package/dist/rollup.config.d.ts

@@ -2,9 +2,9 @@
  * Rollup configuration for the OpenClaw plugin package.
  * Two entry points: plugin (ESM + declarations) and CLI (ESM executable).
  *
- * `@karmaniverous/jeeves` is BUNDLED into the plugin output — the plugin
- * runs in OpenClaw's extensions directory where node_modules is not
- * reliably available. All node: builtins are externalized.
+ * `@karmaniverous/jeeves` is externalized — the plugin installer copies
+ * the jeeves core lib into the extensions directory alongside the plugin
+ * output, so it is always resolvable at runtime.
  *
  * @module rollup.config
  */

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

@@ -397,7 +397,7 @@ Apply config changes atomically.
 Validates, writes to disk, and triggers configured reindex behavior. Returns validation errors if invalid. Config changes take full effect without service restart — including new/removed watch paths (filesystem watcher is rebuilt), inference rule changes, move detection settings, and gitignore filter updates.
 
 ### `watcher_reindex`
-Trigger a reindex operation. All scopes return a `plan` object showing blast area before execution begins.
+Trigger a reindex operation. Non-prune scopes return a `plan` object showing blast area before execution begins. Live prune (non-dry-run) returns immediately without a plan.
 
 **Parameters:**
 - `scope` (string, optional) — Reindex scope. Default: `"rules"`. One of:
@@ -837,6 +837,70 @@ Use `watcher_enrich` to tag documents after analysis (e.g., `reviewed: true`, pr
 
 ---
 
+## Version Tracking
+
+The watcher includes built-in history and undo for your watched files. When enabled, every change to a watched file is automatically versioned. You can view the history of any file or folder, see exactly what changed between versions, retrieve old versions, and undo changes — all through the `watcher_vcs_*` tools.
+
+### Tools
+
+| Tool | Purpose |
+|------|---------|
+| `watcher_vcs_status` | Check version tracking health: enabled state, tracked roots, remote sync status |
+| `watcher_vcs_history` | View change history for a file or folder, with optional date range and limit |
+| `watcher_vcs_show` | Retrieve the content of a file at a specific past version |
+| `watcher_vcs_diff` | Show what changed between two versions, or between a past version and now |
+| `watcher_vcs_revert` | Undo changes by restoring files to a specific past version |
+| `watcher_vcs_exclude` | Exclude (or re-include) paths from version tracking |
+| `watcher_vcs_check` | Check whether a path is excluded from version tracking and why |
+
+### Usage Patterns
+
+**View recent changes to a file:**
+```
+watcher_vcs_history: glob="J:/domains/jira/PROJ-123.json", limit=10
+```
+
+**See what changed between two versions:**
+```
+watcher_vcs_diff: glob="J:/domains/jira/PROJ-123.json", commit="abc1234"
+```
+
+**Restore a file to a previous version:**
+```
+watcher_vcs_revert: glob="J:/domains/jira/PROJ-123.json", commit="abc1234"
+```
+
+**View old content without restoring:**
+```
+watcher_vcs_show: path="J:/domains/jira/PROJ-123.json", commit="abc1234"
+```
+
+**Exclude files that don't need versioning** (e.g., Jira issues that are read-only syncs):
+```
+watcher_vcs_exclude: glob="J:/domains/jira/**/*.json"
+```
+
+**Check if a file is excluded and why:**
+```
+watcher_vcs_check: path="J:/domains/jira/PROJ-123.json"
+```
+
+### Enabling Version Tracking
+
+Version tracking is controlled by the `vcs.enabled` config setting. When set to `true`, the watcher automatically versions all watched files. No additional setup is required — just enable it and history starts accumulating.
+
+### Excluding Paths
+
+Not all watched files need version history. For example, if Jira issues are synced read-only, there's nothing to "undo." Use `watcher_vcs_exclude` to stop tracking specific paths.
+
+Exclusions are placed as close to the target as possible: if you exclude `J:/domains/jira/**/*.json`, the exclusion rule is written inside the `J:/domains/jira/` directory, not at the root. This keeps exclusions local and easy to reason about. Re-include a path by calling `watcher_vcs_exclude` with `remove: true`.
+
+### Score Interpretation
+
+VCS tools do not use vector search. There are no relevance scores to interpret — results are exact history lookups, diffs, and file retrievals.
+
+---
+
 ## Error Handling
 
 If the watcher is unreachable:

package/dist/src/watcherTools.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module plugin/watcherTools
- * Domain-specific watcher tool registrations (7 tools) for the OpenClaw plugin.
+ * Domain-specific watcher tool registrations (14 tools) for the OpenClaw plugin.
  */
 import { type PluginApi } from '@karmaniverous/jeeves';
-/** Register the 7 domain-specific watcher_* tools with the OpenClaw plugin API. */
+/** Register the 14 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.14.10",
+  "version": "0.15.0",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],
@@ -22,6 +22,28 @@
       }
     }
   },
+  "contracts": {
+    "tools": [
+      "watcher_status",
+      "watcher_config",
+      "watcher_config_apply",
+      "watcher_service",
+      "watcher_search",
+      "watcher_enrich",
+      "watcher_validate",
+      "watcher_reindex",
+      "watcher_scan",
+      "watcher_issues",
+      "watcher_walk",
+      "watcher_vcs_status",
+      "watcher_vcs_history",
+      "watcher_vcs_show",
+      "watcher_vcs_diff",
+      "watcher_vcs_revert",
+      "watcher_vcs_exclude",
+      "watcher_vcs_check"
+    ]
+  },
   "uiHints": {
     "apiUrl": {
       "label": "Watcher API URL",

package/package.json

@@ -1,15 +1,32 @@
 {
-  "name": "@karmaniverous/jeeves-watcher-openclaw",
-  "version": "0.14.10",
   "author": "Jason Williscroft",
-  "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
-  "license": "BSD-3-Clause",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "bin": {
     "jeeves-watcher-openclaw": "./dist/cli.js"
   },
+  "bugs": {
+    "url": "https://github.com/karmaniverous/jeeves-watcher/issues"
+  },
+  "dependencies": {
+    "@karmaniverous/jeeves": "^0.5.11",
+    "@karmaniverous/jeeves-watcher-core": "^0.2.0"
+  },
+  "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
+  "devDependencies": {
+    "@dotenvx/dotenvx": "^1.69.1",
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "cross-env": "^10.1.0",
+    "knip": "^6.14.2",
+    "release-it": "^20.0.1",
+    "rollup": "^4.60.4",
+    "tslib": "^2.8.1",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=22"
+  },
   "exports": {
     ".": {
       "import": {
@@ -23,17 +40,6 @@
     "content",
     "openclaw.plugin.json"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/karmaniverous/jeeves-watcher.git",
-    "directory": "packages/openclaw"
-  },
-  "bugs": {
-    "url": "https://github.com/karmaniverous/jeeves-watcher/issues"
-  },
   "homepage": "https://github.com/karmaniverous/jeeves-watcher#readme",
   "keywords": [
     "openclaw",
@@ -41,76 +47,70 @@
     "jeeves-watcher",
     "semantic-search"
   ],
-  "engines": {
-    "node": ">=22"
-  },
+  "license": "BSD-3-Clause",
+  "main": "dist/index.js",
+  "name": "@karmaniverous/jeeves-watcher-openclaw",
   "openclaw": {
     "extensions": [
       "./dist/index.js"
     ]
   },
-  "devDependencies": {
-    "@dotenvx/dotenvx": "^1.65.0",
-    "@rollup/plugin-commonjs": "^29.0.2",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "cross-env": "^10.1.0",
-    "knip": "^6.13.1",
-    "release-it": "^20.0.1",
-    "rollup": "^4.60.3",
-    "tslib": "^2.8.1",
-    "vitest": "^4.1.6"
-  },
-  "scripts": {
-    "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
-    "build:skills": "tsx scripts/build-skills.ts",
-    "build": "npm run build:plugin && npm run build:skills && npm run build:content",
-    "build:content": "node scripts/copy-content.mjs",
-    "changelog": "git-cliff -o CHANGELOG.md",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "release": "dotenvx run -f .env.local -- release-it",
-    "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease",
-    "test": "vitest run",
-    "typecheck": "tsc"
+  "publishConfig": {
+    "access": "public"
   },
   "release-it": {
     "git": {
       "changelog": "npx git-cliff --unreleased --strip header",
       "commitMessage": "chore: release @karmaniverous/jeeves-watcher-openclaw v${version}",
-      "tagName": "openclaw/${version}",
-      "requireBranch": "main"
+      "requireBranch": "main",
+      "tagName": "openclaw/${version}"
     },
     "github": {
       "release": true
     },
     "hooks": {
+      "after:bump": [
+        "node -e \"const f='openclaw.plugin.json';const j=JSON.parse(require('fs').readFileSync(f,'utf8'));j.version='${version}';require('fs').writeFileSync(f,JSON.stringify(j,null,2)+'')\""
+      ],
       "after:init": [
         "npm run lint",
         "npm run typecheck",
         "npm run test",
         "npm run build"
       ],
-      "before:npm:release": [
-        "npx git-cliff -o CHANGELOG.md",
-        "git add -A"
-      ],
       "after:release": [
         "git switch -c release/openclaw/${version}",
         "git push -u origin release/openclaw/${version}",
         "git switch ${branchName}"
       ],
-      "after:bump": [
-        "node -e \"const f='openclaw.plugin.json';const j=JSON.parse(require('fs').readFileSync(f,'utf8'));j.version='${version}';require('fs').writeFileSync(f,JSON.stringify(j,null,2)+'')\""
+      "before:npm:release": [
+        "npx git-cliff -o CHANGELOG.md",
+        "git add -A"
       ]
     },
     "npm": {
       "publish": true
     }
   },
-  "dependencies": {
-    "@karmaniverous/jeeves": "^0.5.10",
-    "@karmaniverous/jeeves-watcher-core": "^0.1.1"
-  }
+  "repository": {
+    "directory": "packages/openclaw",
+    "type": "git",
+    "url": "git+https://github.com/karmaniverous/jeeves-watcher.git"
+  },
+  "scripts": {
+    "build": "npm run build:plugin && npm run build:skills && npm run build:content",
+    "build:content": "node scripts/copy-content.mjs",
+    "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "build:skills": "tsx scripts/build-skills.ts",
+    "changelog": "git-cliff -o CHANGELOG.md",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "release": "dotenvx run -f .env.local -- release-it",
+    "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease",
+    "test": "vitest run",
+    "typecheck": "tsc"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "version": "0.15.0"
 }