@karmaniverous/jeeves-watcher-openclaw 0.14.9 → 0.14.11

package/content/tools-platform.md

@@ -24,6 +24,20 @@ When editing files outside the workspace, use the bridge pattern: copy in → ed
 
 **Cross-channel sends:** Use the `message` tool with an explicit `target` to send to a different channel or DM.
 
+### Slack File Downloads
+
+To download a Slack-hosted file, first try the `message` tool's `download-file` action. If that fails, fall back to a direct HTTP fetch using the bot token:
+
+```js
+fetch(url_private_download, {
+  headers: { Authorization: 'Bearer ' + botToken },
+});
+```
+
+The bot token is at `channels.slack.accounts.default.botToken` in `openclaw.json`.
+
+Never tell the user a file can't be downloaded until both methods have been tried.
+
 ### Plugin Lifecycle
 
 ```bash

package/dist/cli.js

@@ -4749,6 +4749,9 @@ function requireRange () {
 	  }
 
 	  parseRange (range) {
+	    // strip build metadata so it can't bleed into the version
+	    range = range.replace(BUILDSTRIPRE, '');
+
 	    // memoize range parsing for performance.
 	    // this is a very hot path, and fully deterministic.
 	    const memoOpts =
@@ -4874,6 +4877,7 @@ function requireRange () {
 	const SemVer = requireSemver$1();
 	const {
 	  safeRe: re,
+	  src,
 	  t,
 	  comparatorTrimReplace,
 	  tildeTrimReplace,
@@ -4881,6 +4885,9 @@ function requireRange () {
 	} = requireRe();
 	const { FLAG_INCLUDE_PRERELEASE, FLAG_LOOSE } = requireConstants();
 
+	// unbounded global build-metadata stripper used by parseRange
+	const BUILDSTRIPRE = new RegExp(src[t.BUILD], 'g');
+
 	const isNullSet = c => c.value === '<0.0.0-0';
 	const isAny = c => c.value === '';
 
@@ -5932,7 +5939,7 @@ function requireSubset () {
 	        if (higher === c && higher !== gt) {
 	          return false
 	        }
-	      } else if (gt.operator === '>=' && !satisfies(gt.semver, String(c), options)) {
+	      } else if (gt.operator === '>=' && !c.test(gt.semver)) {
 	        return false
 	      }
 	    }
@@ -5950,7 +5957,7 @@ function requireSubset () {
 	        if (lower === c && lower !== lt) {
 	          return false
 	        }
-	      } else if (lt.operator === '<=' && !satisfies(lt.semver, String(c), options)) {
+	      } else if (lt.operator === '<=' && !c.test(lt.semver)) {
 	        return false
 	      }
 	    }
@@ -24475,14 +24482,14 @@ const SECTION_ORDER = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.9` placeholder is replaced by
+ * The `0.5.10` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.9';
+const CORE_VERSION = '0.5.10';
 
 /**
  * Workspace and config root initialization.
@@ -24495,12 +24502,26 @@ const CORE_VERSION = '0.5.9';
  * - `{configRoot}/jeeves-{name}/` for each component
  */
 let state;
+const WINDOWS_DRIVE_RE = /^[a-zA-Z]:/;
+/**
+ * Throw if a path looks like a Windows drive letter on a non-Windows platform.
+ *
+ * @param label - Human-readable name for the path (used in error messages).
+ * @param value - The raw path string to validate.
+ */
+function rejectWindowsDrivePath(label, value) {
+    if (process.platform !== 'win32' && WINDOWS_DRIVE_RE.test(value)) {
+        throw new Error(`jeeves-core: ${label} "${value}" looks like a Windows drive-letter path and will not resolve correctly on this platform.`);
+    }
+}
 /**
  * Initialize the core library with workspace and config root paths.
  *
  * @param options - Workspace and config root paths.
  */
 function init(options) {
+    rejectWindowsDrivePath('configRoot', options.configRoot);
+    rejectWindowsDrivePath('workspacePath', options.workspacePath);
     state = {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
@@ -26306,6 +26327,20 @@ When editing files outside the workspace, use the bridge pattern: copy in → ed
 
 **Cross-channel sends:** Use the \`message\` tool with an explicit \`target\` to send to a different channel or DM.
 
+### Slack File Downloads
+
+To download a Slack-hosted file, first try the \`message\` tool's \`download-file\` action. If that fails, fall back to a direct HTTP fetch using the bot token:
+
+\`\`\`js
+fetch(url_private_download, {
+  headers: { Authorization: 'Bearer ' + botToken },
+});
+\`\`\`
+
+The bot token is at \`channels.slack.accounts.default.botToken\` in \`openclaw.json\`.
+
+Never tell the user a file can't be downloaded until both methods have been tried.
+
 ### Plugin Lifecycle
 
 \`\`\`bash

package/dist/index.js

@@ -4748,6 +4748,9 @@ function requireRange () {
 	  }
 
 	  parseRange (range) {
+	    // strip build metadata so it can't bleed into the version
+	    range = range.replace(BUILDSTRIPRE, '');
+
 	    // memoize range parsing for performance.
 	    // this is a very hot path, and fully deterministic.
 	    const memoOpts =
@@ -4873,6 +4876,7 @@ function requireRange () {
 	const SemVer = requireSemver$1();
 	const {
 	  safeRe: re,
+	  src,
 	  t,
 	  comparatorTrimReplace,
 	  tildeTrimReplace,
@@ -4880,6 +4884,9 @@ function requireRange () {
 	} = requireRe();
 	const { FLAG_INCLUDE_PRERELEASE, FLAG_LOOSE } = requireConstants();
 
+	// unbounded global build-metadata stripper used by parseRange
+	const BUILDSTRIPRE = new RegExp(src[t.BUILD], 'g');
+
 	const isNullSet = c => c.value === '<0.0.0-0';
 	const isAny = c => c.value === '';
 
@@ -5931,7 +5938,7 @@ function requireSubset () {
 	        if (higher === c && higher !== gt) {
 	          return false
 	        }
-	      } else if (gt.operator === '>=' && !satisfies(gt.semver, String(c), options)) {
+	      } else if (gt.operator === '>=' && !c.test(gt.semver)) {
 	        return false
 	      }
 	    }
@@ -5949,7 +5956,7 @@ function requireSubset () {
 	        if (lower === c && lower !== lt) {
 	          return false
 	        }
-	      } else if (lt.operator === '<=' && !satisfies(lt.semver, String(c), options)) {
+	      } else if (lt.operator === '<=' && !c.test(lt.semver)) {
 	        return false
 	      }
 	    }
@@ -24554,14 +24561,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.9` placeholder is replaced by
+ * The `0.5.10` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.9';
+const CORE_VERSION = '0.5.10';
 
 /**
  * Workspace and config root initialization.
@@ -24574,12 +24581,26 @@ const CORE_VERSION = '0.5.9';
  * - `{configRoot}/jeeves-{name}/` for each component
  */
 let state;
+const WINDOWS_DRIVE_RE = /^[a-zA-Z]:/;
+/**
+ * Throw if a path looks like a Windows drive letter on a non-Windows platform.
+ *
+ * @param label - Human-readable name for the path (used in error messages).
+ * @param value - The raw path string to validate.
+ */
+function rejectWindowsDrivePath(label, value) {
+    if (process.platform !== 'win32' && WINDOWS_DRIVE_RE.test(value)) {
+        throw new Error(`jeeves-core: ${label} "${value}" looks like a Windows drive-letter path and will not resolve correctly on this platform.`);
+    }
+}
 /**
  * Initialize the core library with workspace and config root paths.
  *
  * @param options - Workspace and config root paths.
  */
 function init(options) {
+    rejectWindowsDrivePath('configRoot', options.configRoot);
+    rejectWindowsDrivePath('workspacePath', options.workspacePath);
     state = {
         workspacePath: options.workspacePath,
         configRoot: options.configRoot,
@@ -26688,6 +26709,20 @@ When editing files outside the workspace, use the bridge pattern: copy in → ed
 
 **Cross-channel sends:** Use the \`message\` tool with an explicit \`target\` to send to a different channel or DM.
 
+### Slack File Downloads
+
+To download a Slack-hosted file, first try the \`message\` tool's \`download-file\` action. If that fails, fall back to a direct HTTP fetch using the bot token:
+
+\`\`\`js
+fetch(url_private_download, {
+  headers: { Authorization: 'Bearer ' + botToken },
+});
+\`\`\`
+
+The bot token is at \`channels.slack.accounts.default.botToken\` in \`openclaw.json\`.
+
+Never tell the user a file can't be downloaded until both methods have been tried.
+
 ### Plugin Lifecycle
 
 \`\`\`bash

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:

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.9",
+  "version": "0.14.11",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],
@@ -22,6 +22,21 @@
       }
     }
   },
+  "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"
+    ]
+  },
   "uiHints": {
     "apiUrl": {
       "label": "Watcher API URL",

package/package.json

@@ -1,15 +1,32 @@
 {
-  "name": "@karmaniverous/jeeves-watcher-openclaw",
-  "version": "0.14.9",
   "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.1.2"
+  },
+  "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": "*"
-  }
+  "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.14.11"
 }