@karmaniverous/jeeves-watcher-openclaw 0.15.3 → 0.15.5

package/dist/cli.js

@@ -27068,12 +27068,12 @@ const vcsConfigSchema = object$1({
     author: vcsAuthorConfigSchema
         .optional()
         .describe('Git commit author identity. Set per-repo during init. Defaults: name="jeeves-watcher", email="watcher@localhost".'),
-    /** Debounce interval in milliseconds for batching commits. */
-    commitDebounceMs: number$2()
+    /** Throttle interval in milliseconds for batching commits. */
+    commitThrottleMs: number$2()
         .int()
         .min(1000)
         .default(30000)
-        .describe('Debounce interval in milliseconds for batching commits. Default: 30000.'),
+        .describe('Throttle interval in milliseconds for batching commits. Default: 30000.'),
     /** Maximum number of files per commit batch. */
     maxBatchSize: number$2()
         .int()
@@ -27092,6 +27092,18 @@ const vcsConfigSchema = object$1({
     defaultAccessToken: string$2()
         .optional()
         .describe('Default git access token for all roots. Supports env var substitution (e.g., "${GIT_TOKEN}").'),
+    /** Age in ms after which an index.lock is considered stale and force-removed. */
+    staleLockThresholdMs: number$2()
+        .int()
+        .min(5000)
+        .default(60000)
+        .describe('Age in ms after which an index.lock is considered stale and force-removed. Default: 60000.'),
+    /** Circuit breaker: stop re-queuing after this many consecutive commit failures. */
+    maxConsecutiveFailures: number$2()
+        .int()
+        .min(1)
+        .default(5)
+        .describe('Circuit breaker: stop re-queuing after this many consecutive commit failures. Default: 5.'),
 });
 /**
  * Per-root VCS overrides extending the root-level VCS config.

package/dist/index.js

@@ -27005,6 +27005,197 @@ const DEFAULT_PORT = DEFAULT_PORTS.watcher;
 ({
     port: DEFAULT_PORTS.watcher});
 
+/**
+ * Shared endpoint catalog — single source of truth for the jeeves-watcher API.
+ *
+ * Both the CLI service and the OpenClaw plugin derive their registrations
+ * from this declarative catalog, eliminating drift between the two.
+ *
+ */
+/**
+ * Canonical endpoint catalog for the jeeves-watcher API.
+ *
+ * Every entry describes a single HTTP endpoint exposed by the service.
+ * Route handlers, plugin tools, and HTTP clients should reference these
+ * descriptors rather than hard-coding paths and descriptions.
+ */
+const WATCHER_ENDPOINTS = [
+    {
+        name: 'status',
+        method: 'GET',
+        path: '/status',
+        description: 'Service health and status overview.',
+    },
+    {
+        name: 'metadata',
+        method: 'POST',
+        path: '/metadata',
+        description: 'Set or update metadata on a document by file path.',
+    },
+    {
+        name: 'render',
+        method: 'POST',
+        path: '/render',
+        description: 'Render a document through the template pipeline.',
+    },
+    {
+        name: 'searchFacets',
+        method: 'GET',
+        path: '/search/facets',
+        description: 'List available search facets and their values.',
+    },
+    {
+        name: 'scan',
+        method: 'POST',
+        path: '/scan',
+        description: 'Filter-only point query without vector search. Returns metadata for points matching a Qdrant filter.',
+    },
+    {
+        name: 'walk',
+        method: 'POST',
+        path: '/walk',
+        description: 'Walk watched filesystem paths with glob intersection. Returns matching file paths.',
+    },
+    {
+        name: 'search',
+        method: 'POST',
+        path: '/search',
+        description: 'Semantic search over indexed documents. Supports Qdrant filters.',
+    },
+    {
+        name: 'rebuildMetadata',
+        method: 'POST',
+        path: '/rebuild-metadata',
+        description: 'Rebuild metadata from enrichment store into vector points.',
+    },
+    {
+        name: 'reindex',
+        method: 'POST',
+        path: '/reindex',
+        description: 'Trigger a scoped reindex of watched files.',
+    },
+    {
+        name: 'issues',
+        method: 'GET',
+        path: '/issues',
+        description: 'Get runtime embedding failures. Shows files that failed processing and why.',
+    },
+    {
+        name: 'configSchema',
+        method: 'GET',
+        path: '/config/schema',
+        description: 'Get the JSON Schema for the configuration file.',
+    },
+    {
+        name: 'configMatch',
+        method: 'POST',
+        path: '/config/match',
+        description: 'Test file paths against config inference rules.',
+    },
+    {
+        name: 'config',
+        method: 'GET',
+        path: '/config',
+        description: 'Query service configuration with optional JSONPath.',
+    },
+    {
+        name: 'configValidate',
+        method: 'POST',
+        path: '/config/validate',
+        description: 'Validate a candidate config. Optionally test file paths against the config.',
+    },
+    {
+        name: 'configApply',
+        method: 'POST',
+        path: '/config/apply',
+        description: 'Apply a configuration patch.',
+    },
+    {
+        name: 'rulesRegister',
+        method: 'POST',
+        path: '/rules/register',
+        description: 'Register external inference rules.',
+    },
+    {
+        name: 'rulesUnregister',
+        method: 'DELETE',
+        path: '/rules/unregister',
+        description: 'Unregister external inference rules.',
+    },
+    {
+        name: 'rulesUnregisterBySource',
+        method: 'DELETE',
+        path: '/rules/unregister/:source',
+        description: 'Unregister all external inference rules from a source.',
+    },
+    {
+        name: 'pointsDelete',
+        method: 'POST',
+        path: '/points/delete',
+        description: 'Delete points from the vector store by filter.',
+    },
+    {
+        name: 'rulesReapply',
+        method: 'POST',
+        path: '/rules/reapply',
+        description: 'Re-apply inference rules to existing vector points.',
+    },
+    {
+        name: 'vcsStatus',
+        method: 'GET',
+        path: '/vcs/status',
+        description: 'VCS state for all roots: enabled state, tracked files, last commit, remote status.',
+    },
+    {
+        name: 'vcsHistory',
+        method: 'GET',
+        path: '/vcs/history',
+        description: 'Query change history by path or glob with optional date range.',
+    },
+    {
+        name: 'vcsShow',
+        method: 'GET',
+        path: '/vcs/show',
+        description: 'Retrieve file content at a specific version.',
+    },
+    {
+        name: 'vcsDiff',
+        method: 'GET',
+        path: '/vcs/diff',
+        description: 'Show what changed between two versions, or between a version and current.',
+    },
+    {
+        name: 'vcsCheckExclusion',
+        method: 'GET',
+        path: '/vcs/check-exclusion',
+        description: 'Check whether a path is excluded from version tracking and why.',
+    },
+    {
+        name: 'vcsRevert',
+        method: 'POST',
+        path: '/vcs/revert',
+        description: 'Restore files from a historical commit (forward-only reversion).',
+    },
+    {
+        name: 'vcsExclude',
+        method: 'POST',
+        path: '/vcs/exclude',
+        description: 'Manage .gitignore entries for version tracking exclusion.',
+    },
+];
+/**
+ * Look up an endpoint descriptor by name.
+ *
+ * @param name - The endpoint identifier.
+ * @returns The matching {@link EndpointDescriptor}.
+ */
+function getEndpoint(name) {
+    const ep = WATCHER_ENDPOINTS.find((e) => e.name === name);
+    if (!ep)
+        throw new Error(`Unknown endpoint: ${name}`);
+    return ep;
+}
+
 /**
  * @module schemas/vcs
  * VCS (version control system) configuration schema for git-backed content versioning.
@@ -27078,12 +27269,12 @@ const vcsConfigSchema = object$1({
     author: vcsAuthorConfigSchema
         .optional()
         .describe('Git commit author identity. Set per-repo during init. Defaults: name="jeeves-watcher", email="watcher@localhost".'),
-    /** Debounce interval in milliseconds for batching commits. */
-    commitDebounceMs: number$2()
+    /** Throttle interval in milliseconds for batching commits. */
+    commitThrottleMs: number$2()
         .int()
         .min(1000)
         .default(30000)
-        .describe('Debounce interval in milliseconds for batching commits. Default: 30000.'),
+        .describe('Throttle interval in milliseconds for batching commits. Default: 30000.'),
     /** Maximum number of files per commit batch. */
     maxBatchSize: number$2()
         .int()
@@ -27102,6 +27293,18 @@ const vcsConfigSchema = object$1({
     defaultAccessToken: string$2()
         .optional()
         .describe('Default git access token for all roots. Supports env var substitution (e.g., "${GIT_TOKEN}").'),
+    /** Age in ms after which an index.lock is considered stale and force-removed. */
+    staleLockThresholdMs: number$2()
+        .int()
+        .min(5000)
+        .default(60000)
+        .describe('Age in ms after which an index.lock is considered stale and force-removed. Default: 60000.'),
+    /** Circuit breaker: stop re-queuing after this many consecutive commit failures. */
+    maxConsecutiveFailures: number$2()
+        .int()
+        .min(1)
+        .default(5)
+        .describe('Circuit breaker: stop re-queuing after this many consecutive commit failures. Default: 5.'),
 });
 /**
  * Per-root VCS overrides extending the root-level VCS config.
@@ -27620,9 +27823,9 @@ async function generateWatcherMenu(apiUrl) {
     const scoreThresholds = { strong: 0.75, relevant: 0.5, noise: 0.25 };
     const fetchOpts = { signal: AbortSignal.timeout(MENU_FETCH_TIMEOUT_MS) };
     const [statusRes, thresholdsRes, vcsRes] = (await Promise.all([
-        fetchJson(`${apiUrl}/status`, fetchOpts),
-        fetchJson(`${apiUrl}/config?path=${encodeURIComponent('$.search.scoreThresholds')}`, fetchOpts),
-        fetchJson(`${apiUrl}/vcs/status`, fetchOpts).catch(() => ({
+        fetchJson(`${apiUrl}${getEndpoint('status').path}`, fetchOpts),
+        fetchJson(`${apiUrl}${getEndpoint('config').path}?path=${encodeURIComponent('$.search.scoreThresholds')}`, fetchOpts),
+        fetchJson(`${apiUrl}${getEndpoint('vcsStatus').path}`, fetchOpts).catch(() => ({
             enabled: false,
         })),
     ]));
@@ -27789,7 +27992,7 @@ function registerWatcherTools(api, baseUrl) {
                     'offset',
                     'filter',
                 ]);
-                return ['/search', body];
+                return [getEndpoint('search').path, body];
             },
         },
         {
@@ -27810,7 +28013,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                '/metadata',
+                getEndpoint('metadata').path,
                 { path: params.path, metadata: params.metadata },
             ],
         },
@@ -27833,7 +28036,7 @@ function registerWatcherTools(api, baseUrl) {
             },
             buildRequest: (params) => {
                 const body = pickDefined(params, ['config', 'testPaths']);
-                return ['/config/validate', body];
+                return [getEndpoint('configValidate').path, body];
             },
         },
         {
@@ -27861,7 +28064,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                '/reindex',
+                getEndpoint('reindex').path,
                 {
                     scope: params.scope ?? 'rules',
                     ...(params.path ? { path: params.path } : {}),
@@ -27907,14 +28110,14 @@ function registerWatcherTools(api, baseUrl) {
                     'fields',
                     'countOnly',
                 ]);
-                return ['/scan', body];
+                return [getEndpoint('scan').path, body];
             },
         },
         {
             name: 'watcher_issues',
             description: 'Get runtime embedding failures. Shows files that failed processing and why.',
             parameters: { type: 'object', properties: {} },
-            buildRequest: () => ['/issues'],
+            buildRequest: () => [getEndpoint('issues').path],
         },
         {
             name: 'watcher_walk',
@@ -27930,14 +28133,17 @@ function registerWatcherTools(api, baseUrl) {
                     },
                 },
             },
-            buildRequest: (params) => ['/walk', { globs: params.globs }],
+            buildRequest: (params) => [
+                getEndpoint('walk').path,
+                { globs: params.globs },
+            ],
         },
         // ── VCS tools ──────────────────────────────────────────────────────
         {
             name: 'watcher_vcs_status',
             description: 'Get version tracking health: enabled state, tracked roots, remote status, last activity',
             parameters: { type: 'object', properties: {} },
-            buildRequest: () => ['/vcs/status'],
+            buildRequest: () => [getEndpoint('vcsStatus').path],
         },
         {
             name: 'watcher_vcs_history',
@@ -27965,7 +28171,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                `/vcs/history${buildQuery(params, ['glob', 'since', 'until', 'limit'])}`,
+                `${getEndpoint('vcsHistory').path}${buildQuery(params, ['glob', 'since', 'until', 'limit'])}`,
             ],
         },
         {
@@ -27986,7 +28192,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                `/vcs/show${buildQuery(params, ['path', 'commit'])}`,
+                `${getEndpoint('vcsShow').path}${buildQuery(params, ['path', 'commit'])}`,
             ],
         },
         {
@@ -28011,7 +28217,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                `/vcs/diff${buildQuery(params, ['glob', 'commit', 'commitEnd'])}`,
+                `${getEndpoint('vcsDiff').path}${buildQuery(params, ['glob', 'commit', 'commitEnd'])}`,
             ],
         },
         {
@@ -28037,7 +28243,7 @@ function registerWatcherTools(api, baseUrl) {
             },
             buildRequest: (params) => {
                 const body = pickDefined(params, ['glob', 'commit', 'existingOnly']);
-                return ['/vcs/revert', body];
+                return [getEndpoint('vcsRevert').path, body];
             },
         },
         {
@@ -28063,7 +28269,7 @@ function registerWatcherTools(api, baseUrl) {
             },
             buildRequest: (params) => {
                 const body = pickDefined(params, ['glob', 'root', 'remove']);
-                return ['/vcs/exclude', body];
+                return [getEndpoint('vcsExclude').path, body];
             },
         },
         {
@@ -28080,7 +28286,7 @@ function registerWatcherTools(api, baseUrl) {
                 },
             },
             buildRequest: (params) => [
-                `/vcs/check-exclusion${buildQuery(params, ['path'])}`,
+                `${getEndpoint('vcsCheckExclusion').path}${buildQuery(params, ['path'])}`,
             ],
         },
     ];

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

@@ -889,6 +889,8 @@ watcher_vcs_check: path="J:/domains/jira/PROJ-123.json"
 
 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.
 
+Squash retention activates by default when VCS is enabled, even without explicit `retention` config. The defaults are: 30 days max age, 100 versions max, and a daily midnight cron schedule (`0 0 * * *`). These defaults prevent unbounded commit history growth.
+
 ### 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.

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.15.3",
+  "version": "0.15.5",
   "skills": [
     "dist/skills/jeeves-watcher"
   ],

package/package.json

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@karmaniverous/jeeves": "^0.5.12",
-    "@karmaniverous/jeeves-watcher-core": "^0.2.2"
+    "@karmaniverous/jeeves-watcher-core": "^0.2.4"
   },
   "description": "OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools",
   "devDependencies": {
@@ -112,5 +112,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.15.3"
+  "version": "0.15.5"
 }