@karmaniverous/jeeves-watcher-openclaw 0.17.0 → 0.18.0

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

@@ -0,0 +1,5 @@
+/**
+ * @module test/distFreshness.test
+ * The stale-build check behind the dist smoke test (spec D201): a build is fresh until an input under any input directory changes after it; test files, `test` folders and missing directories do not count.
+ */
+export {};

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

@@ -0,0 +1,27 @@
+/**
+ * @module test/surfaceDiff
+ * Renders the agent-facing differences between two plugin tool surfaces (tool name, description, parameters, catalog mode, options) as Markdown, for the reviewed delta report. Pure.
+ */
+/** One registered tool, as the surface fixtures record it. */
+export interface ToolSurface {
+    name: string;
+    description: string;
+    parameters: {
+        type?: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: unknown;
+        [key: string]: unknown;
+    };
+    catalogMode?: unknown;
+    options?: unknown;
+}
+/**
+ * Render the delta report between a baseline surface and the current one.
+ *
+ * @param before - Baseline tools, in registration order.
+ * @param after - Current tools, in registration order.
+ * @param renames - Each renamed baseline tool and its current name.
+ * @returns Markdown: one section per tool that changed, then removed and added tools.
+ */
+export declare function renderSurfaceDiff(before: readonly ToolSurface[], after: readonly ToolSurface[], renames: Readonly<Record<string, string>>): string;

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

@@ -0,0 +1,13 @@
+/**
+ * @module test/toolRenames
+ * The plugin tool renames of 0.18.0 (D77, Design 14): each 0.17.0 tool name and its current name, for the surface tests. Pure data.
+ */
+/** Each renamed 0.17.0 tool name and its current name. */
+export declare const TOOL_RENAMES: Readonly<Record<string, string>>;
+/**
+ * A 0.17.0 tool name under its current name.
+ *
+ * @param name - The 0.17.0 name.
+ * @returns The current name.
+ */
+export declare const renamedTool: (name: string) => string;

package/dist/src/toolGating.d.ts

@@ -8,19 +8,17 @@
  * that only call the service HTTP API keep working without it.
  *
  * Audit of the tools the plugin registers:
- * - `watcher_status` (core standard toolset, `createPluginToolset`): HTTP
- *   only (`{apiUrl}/status`, resolved per call).
- * - `watcher_config`, `watcher_config_apply`: implemented by the plugin
- *   (`configTools.ts`, replacing the core ones so the request carries the
- *   `Authorization: Bearer` key); HTTP only.
+ * - `watcher_status`, `watcher_config`, `watcher_config_apply` (core
+ *   toolset from `WATCHER_CATALOG`, `catalogTools.ts`): HTTP only
+ *   (`{apiUrl}` resolved per call; the bearer key sent where the entry
+ *   requires it).
  * - `watcher_service` (core standard toolset): only `install` reads
  *   `configRoot` (`createServiceManager` → `resolveConfigFilePath` →
  *   `getComponentConfigDir`); the other actions query or drive the OS
  *   service manager by service name.
  *
- * The 14 domain tools (7 in `watcherTools.ts`, 7 VCS tools in
- * `vcsTools.ts`) call the service API via `registerApiTool` →
- * `requestJson` and are never gated.
+ * The 14 domain tools come from the same core toolset (D38): HTTP only,
+ * never gated.
  */
 /** Decides, per call, whether a tool invocation reads `configRoot`. */
 export type ConfigRootPredicate = (params: Record<string, unknown> | undefined) => boolean;

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

@@ -0,0 +1,5 @@
+/**
+ * @module plugin/toolSurface.test
+ * Agent-facing surface: every registered tool's name, description, parameters, `catalogMode` and registration options, and the injected prompt rules, are pinned in `test/surface-0.18.0/`, and the differences from what plugin 0.17.0 registered (`test/baseline-0.17.0/`) are rendered to `test/surface-0.18.0/deltas.md`: the reviewed list of agent-facing changes (spec #281 A6). Any change to the surface changes these files.
+ */
+export {};

package/dist/src/watcherComponent.d.ts

@@ -3,10 +3,9 @@
  * Jeeves component descriptor for the watcher OpenClaw plugin.
  *
  * @remarks
- * Feeds `createPluginToolset()`, of which the plugin registers
- * `watcher_status` and `watcher_service`; its `watcher_config` and
- * `watcher_config_apply` are replaced by the plugin's own (`configTools.ts`,
- * which send the API key). The service descriptor
+ * Feeds `createPluginToolset()` (with `WATCHER_CATALOG`, `catalogTools.ts`),
+ * which builds the four standard tools and the catalog-built domain tools.
+ * The service descriptor
  * (`packages/service/src/descriptor.ts`) is the canonical source for the
  * config schema and CLI commands.
  */

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.17.0",
+  "version": "0.18.0",
   "skills": ["dist/skills/jeeves-watcher"],
   "configSchema": {
     "type": "object",
@@ -30,19 +30,19 @@
       "watcher_config_apply",
       "watcher_service",
       "watcher_search",
-      "watcher_enrich",
-      "watcher_validate",
+      "watcher_set_metadata",
+      "watcher_validate_config",
       "watcher_reindex",
       "watcher_scan",
-      "watcher_issues",
+      "watcher_list_issues",
       "watcher_walk",
-      "watcher_vcs_status",
-      "watcher_vcs_history",
-      "watcher_vcs_show",
-      "watcher_vcs_diff",
-      "watcher_vcs_revert",
-      "watcher_vcs_exclude",
-      "watcher_vcs_check"
+      "watcher_get_vcs_status",
+      "watcher_list_vcs_history",
+      "watcher_show_vcs_file",
+      "watcher_diff_vcs",
+      "watcher_revert_vcs",
+      "watcher_exclude_vcs_path",
+      "watcher_check_vcs_exclusion"
     ]
   },
   "uiHints": {

package/package.json

@@ -4,25 +4,25 @@
     "url": "https://github.com/karmaniverous/jeeves-watcher/issues"
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "0.7.0",
-    "@karmaniverous/jeeves-watcher-core": "^0.4.0"
+    "@karmaniverous/jeeves": "0.9.0",
+    "@karmaniverous/jeeves-watcher-core": "^0.5.0"
   },
   "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
   "devDependencies": {
-    "@dotenvx/dotenvx": "^2.35.0",
+    "@dotenvx/dotenvx": "^2.38.2",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
+    "@rollup/plugin-typescript": "^12.3.1",
     "cross-env": "^10.1.0",
-    "knip": "^6.41.0",
-    "release-it": "^21.1.1",
-    "rollup": "^4.64.6",
-    "tslib": "^2.8.1",
-    "vitest": "^5.0.4"
+    "knip": "^6.44.1",
+    "release-it": "^21.1.2",
+    "rollup": "^4.67.5",
+    "tslib": "^2.9.1",
+    "vitest": "^5.1.0"
   },
   "engines": {
-    "node": ">=22.13"
+    "node": ">=24.22.2"
   },
   "exports": {
     ".": {
@@ -72,6 +72,9 @@
       "releaseNotes": "npx git-cliff --tag openclaw/${version} --unreleased --strip header"
     },
     "hooks": {
+      "before:init": [
+        "node ../../scripts/check-core-range.mjs"
+      ],
       "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)+'')\"",
         "npx prettier --write openclaw.plugin.json",
@@ -117,5 +120,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.17.0"
+  "version": "0.18.0"
 }

package/dist/src/apiTool.d.ts

@@ -1,45 +0,0 @@
-/**
- * @module plugin/apiTool
- * Generic HTTP-backed watcher tool registration: config shape, request helpers, and ok/connectionFail wrapping. Requests carry the bearer key (if configured) via `requestJson`.
- */
-import { type PluginApi, type ToolDescriptor } from '@karmaniverous/jeeves';
-/**
- * OpenClaw Tool Search catalog mode.
- *
- * @remarks
- * Mirrors `AnyAgentTool['catalogMode']` in the OpenClaw plugin SDK
- * (OpenClaw 2026.9+). `'direct-only'` keeps the tool model-visible instead of
- * moving it into the hidden `tool_search` catalog. Declared locally because
- * `ToolDescriptor` in `@karmaniverous/jeeves` does not carry it yet and
- * `openclaw` is not a dependency of this package.
- */
-export type ToolCatalogMode = 'direct-only';
-/** A tool descriptor carrying the optional OpenClaw catalog mode. */
-export type CatalogToolDescriptor = ToolDescriptor & {
-    /** OpenClaw Tool Search catalog mode (omitted = catalog-eligible). */
-    catalogMode?: ToolCatalogMode;
-};
-/** Config for a watcher API tool. */
-export interface ApiToolConfig {
-    name: string;
-    description: string;
-    parameters: Record<string, unknown>;
-    /** OpenClaw Tool Search catalog mode; omit to leave the tool catalog-eligible. */
-    catalogMode?: ToolCatalogMode;
-    /** Build the request: return [endpoint, body?]. No body = GET. */
-    buildRequest: (params: Record<string, unknown>) => [string, unknown?];
-}
-/** API base URL, or a resolver evaluated on every call. */
-export type BaseUrlSource = string | (() => string);
-/**
- * Register a single API tool with standard try/catch + ok/connectionFail.
- *
- * @remarks
- * The bearer key is resolved from `api` ({@link getApiKey}) on every call,
- * so a key set after registration takes effect without re-registering.
- */
-export declare function registerApiTool(api: PluginApi, baseUrlSource: BaseUrlSource, config: ApiToolConfig): void;
-/** Build a query string from defined params. */
-export declare function buildQuery(params: Record<string, unknown>, keys: string[]): string;
-/** Pick defined keys from params into a body object. */
-export declare function pickDefined(params: Record<string, unknown>, keys: string[]): Record<string, unknown>;

package/dist/src/configTools.d.ts

@@ -1,14 +0,0 @@
-/**
- * @module plugin/configTools
- * Watcher-owned `watcher_config` and `watcher_config_apply` tools: same names, parameters and requests as the core toolset's, but sent through the plugin HTTP helper so they carry the bearer key.
- *
- * @remarks
- * Core's `createPluginToolset` cannot attach request headers, so its two
- * authenticated HTTP tools are replaced by these (see {@link CORE_TOOLS_REPLACED}).
- * `watcher_status` stays with core: `GET /status` is always open.
- */
-import type { ApiToolConfig } from './apiTool.js';
-/** Core toolset tools that this module replaces. */
-export declare const CORE_TOOLS_REPLACED: ReadonlySet<string>;
-/** `watcher_config` and `watcher_config_apply`, as API tool configs. */
-export declare const configToolConfigs: ApiToolConfig[];

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

@@ -1,5 +0,0 @@
-/**
- * @module plugin/configTools.test
- * watcher_config and watcher_config_apply build the same requests as the core tools: GET /config (optional URL-encoded JSONPath) and POST /config/apply with the config wrapped as `patch`; a missing config is rejected before any request.
- */
-export {};

package/dist/src/http.d.ts

@@ -1,19 +0,0 @@
-/**
- * @module plugin/http
- * The plugin's single HTTP helper for watcher API calls: JSON GET/POST via `fetch` with the core bearer header and the core error mapping (errors carry the server `code`; 401 adds key guidance). Never logs the key.
- */
-/** Where the plugin reads its API key from (named in 401 guidance). */
-export declare const PLUGIN_KEY_SOURCES = "plugins.entries.jeeves-watcher-openclaw.config.apiKey or the JEEVES_WATCHER_API_KEY env var";
-/**
- * Call the watcher API and return the parsed JSON body.
- *
- * @param url - Full request URL.
- * @param body - JSON body; `undefined` sends a GET, anything else a POST.
- * @param apiKey - Bearer key; `undefined` sends no `Authorization` header.
- * @returns Parsed JSON response body.
- * @throws On `401` with core `unauthorizedMessage` (naming
- *   {@link PLUGIN_KEY_SOURCES}); on any other non-OK status with
- *   `HTTP <status> <code>: <message>` (core `httpError`); network errors
- *   propagate unchanged.
- */
-export declare function requestJson(url: string, body: unknown, apiKey: string | undefined): Promise<unknown>;

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

@@ -1,5 +0,0 @@
-/**
- * @module plugin/http.test
- * Unit tests for the plugin HTTP helper: bearer header presence/absence, unchanged unauthenticated request shape, 401 guidance naming the plugin key sources without the key, other errors carrying the server code.
- */
-export {};

package/dist/src/toolTestHarness.d.ts

@@ -1,23 +0,0 @@
-/**
- * @module plugin/toolTestHarness
- * Test-only helpers: a fetch stub and a plugin API that captures registered watcher tools by name. No side effects.
- */
-import type { ToolRegistrationOptions } from '@karmaniverous/jeeves';
-import { type Mock } from 'vitest';
-import type { CatalogToolDescriptor } from './apiTool.js';
-/** Base URL used by tool tests. */
-export declare const BASE = "http://localhost:1936";
-/** Signature of the `fetch` stub. */
-type FetchStub = (...args: unknown[]) => Promise<unknown>;
-/** A `fetch` stub resolving to an OK JSON response carrying `data`. */
-export declare function mockFetch(data?: unknown): Mock<FetchStub>;
-/** A registered tool plus the options it was registered with. */
-export interface CapturedTool {
-    tool: CatalogToolDescriptor;
-    options?: ToolRegistrationOptions;
-}
-/** Register the watcher tools against a capturing API; returns them by name, in order. */
-export declare function captureTools(baseUrl?: string): Map<string, CapturedTool>;
-/** Invoke a captured tool by name. */
-export declare function run(tools: Map<string, CapturedTool>, name: string, params: Record<string, unknown>): Promise<import("@karmaniverous/jeeves").ToolResult>;
-export {};

package/dist/src/vcsTools.d.ts

@@ -1,7 +0,0 @@
-/**
- * @module plugin/vcsTools
- * Version-tracking (watcher_vcs_*) tool configs for the OpenClaw plugin; each maps tool params to a watcher VCS endpoint.
- */
-import { type ApiToolConfig } from './apiTool.js';
-/** The 7 watcher_vcs_* tool configs. */
-export declare const vcsToolConfigs: ApiToolConfig[];

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

@@ -1 +0,0 @@
-export {};

package/dist/src/watcherTools.d.ts

@@ -1,21 +0,0 @@
-/**
- * @module plugin/watcherTools
- * Domain-specific watcher tool registrations (14 tools) for the OpenClaw plugin.
- */
-import { type PluginApi } from '@karmaniverous/jeeves';
-import { type BaseUrlSource } from './apiTool.js';
-/**
- * Register the 14 domain-specific watcher_* tools with the OpenClaw plugin API.
- *
- * @remarks
- * `watcher_search` and `watcher_scan` are `catalogMode: 'direct-only'` so
- * OpenClaw Tool Search keeps them model-visible: semantic search must be a
- * direct tool or the model reaches for grep first. All other tools remain
- * catalog-eligible.
- *
- * @param api - Plugin API.
- * @param baseUrl - API base URL, or a getter resolved on every call (so a
- *   changed `apiUrl` takes effect without re-registering, as for the config
- *   tools).
- */
-export declare function registerWatcherTools(api: PluginApi, baseUrl: BaseUrlSource): void;

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

@@ -1 +0,0 @@
-export {};