@karmaniverous/jeeves-meta-openclaw 0.12.4 → 0.12.6

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
 	      }
 	    }
@@ -24346,14 +24353,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.
@@ -24366,12 +24373,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,
@@ -26177,6 +26198,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
 	      }
 	    }
@@ -24465,14 +24472,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.
@@ -24485,12 +24492,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,
@@ -26599,6 +26620,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
@@ -27757,6 +27792,113 @@ const META_COMPONENT = {
     pluginPackage: '@karmaniverous/jeeves-meta-openclaw',
     defaultPort: 1938};
 
+/**
+ * Shared endpoint catalog — single source of truth for the jeeves-meta 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-meta 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 META_ENDPOINTS = [
+    {
+        name: 'status',
+        method: 'GET',
+        path: '/status',
+        description: 'Service health and status overview.',
+    },
+    {
+        name: 'listMetas',
+        method: 'GET',
+        path: '/metas',
+        description: 'List metas with summary stats and per-meta projection. Response includes _phaseState and owedPhase per meta.',
+    },
+    {
+        name: 'metaDetail',
+        method: 'GET',
+        path: '/metas/:path',
+        description: 'Full detail for a single meta, with optional archive history. Response includes _phaseState and owedPhase.',
+    },
+    {
+        name: 'updateMeta',
+        method: 'PATCH',
+        path: '/metas/:path',
+        description: 'Update user-settable reserved properties on a meta entity.',
+    },
+    {
+        name: 'synthesize',
+        method: 'POST',
+        path: '/synthesize',
+        description: 'Trigger synthesis. Path-targeted creates an override queue entry; returns owedPhase. Fully-fresh metas return status:skipped.',
+    },
+    {
+        name: 'abort',
+        method: 'POST',
+        path: '/synthesize/abort',
+        description: 'Abort the currently running synthesis.',
+    },
+    {
+        name: 'preview',
+        method: 'GET',
+        path: '/preview',
+        description: 'Dry-run preview of next synthesis. Returns owedPhase, priorityBand, phaseState, inputStatus, and architectInvalidators.',
+    },
+    {
+        name: 'seed',
+        method: 'POST',
+        path: '/seed',
+        description: 'Create a .meta/ directory and initial meta.json for a new entity path.',
+    },
+    {
+        name: 'unlock',
+        method: 'POST',
+        path: '/unlock',
+        description: 'Remove a stale .lock from a meta entity that is stuck.',
+    },
+    {
+        name: 'config',
+        method: 'GET',
+        path: '/config',
+        description: 'Query service configuration with optional JSONPath.',
+    },
+    {
+        name: 'configApply',
+        method: 'POST',
+        path: '/config/apply',
+        description: 'Apply a configuration patch.',
+    },
+    {
+        name: 'queue',
+        method: 'GET',
+        path: '/queue',
+        description: 'List queued synthesis operations (3-layer model: current, overrides, automatic).',
+    },
+    {
+        name: 'queueClear',
+        method: 'POST',
+        path: '/queue/clear',
+        description: 'Clear override entries from the queue.',
+    },
+];
+/**
+ * Look up an endpoint descriptor by name.
+ *
+ * @param name - The endpoint identifier.
+ * @returns The matching {@link EndpointDescriptor}.
+ */
+function getEndpoint(name) {
+    const ep = META_ENDPOINTS.find((e) => e.name === name);
+    if (!ep)
+        throw new Error(`Unknown endpoint: ${name}`);
+    return ep;
+}
+
 /**
  * Structured error schema from a synthesis step failure.
  *
@@ -28032,9 +28174,22 @@ class MetaServiceClient {
     async post(path, body) {
         return postJson(this.baseUrl + path, body);
     }
+    /**
+     * Interpolate a parameterized endpoint path.
+     * Replaces `:param` placeholders with URI-encoded values.
+     */
+    endpointPath(name, params) {
+        let p = getEndpoint(name).path;
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                p = p.replace(`:${key}`, encodeURIComponent(value));
+            }
+        }
+        return p;
+    }
     /** GET /status — service health + queue state. */
     async status() {
-        return this.get('/status');
+        return this.get(this.endpointPath('status'));
     }
     /** GET /metas — list all meta entities with summary. */
     async listMetas(params) {
@@ -28054,12 +28209,11 @@ class MetaServiceClient {
         if (params?.fields?.length)
             qs.set('fields', params.fields.join(','));
         const query = qs.toString();
-        return this.get('/metas' + (query ? '?' + query : ''));
+        return this.get(this.endpointPath('listMetas') + (query ? '?' + query : ''));
     }
     /** PATCH /metas/:path — update user-settable reserved properties. */
     async update(metaPath, updates) {
-        const encoded = encodeURIComponent(metaPath);
-        return fetchJson(`${this.baseUrl}/metas/${encoded}`, {
+        return fetchJson(`${this.baseUrl}${this.endpointPath('updateMeta', { path: metaPath })}`, {
             method: 'PATCH',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(updates),
@@ -28067,23 +28221,23 @@ class MetaServiceClient {
     }
     /** GET /metas/:path — detail for a single meta. */
     async detail(metaPath, options) {
-        const encoded = encodeURIComponent(metaPath);
         const qs = new URLSearchParams();
         if (options?.includeArchive !== undefined)
             qs.set('includeArchive', String(options.includeArchive));
         if (options?.fields?.length)
             qs.set('fields', options.fields.join(','));
         const query = qs.toString();
-        return this.get(`/metas/${encoded}` + (query ? '?' + query : ''));
+        return this.get(this.endpointPath('metaDetail', { path: metaPath }) +
+            (query ? '?' + query : ''));
     }
     /** GET /preview — dry-run next synthesis candidate. */
     async preview(path) {
         const qs = path ? '?path=' + encodeURIComponent(path) : '';
-        return this.get('/preview' + qs);
+        return this.get(this.endpointPath('preview') + qs);
     }
     /** POST /synthesize — enqueue synthesis. */
     async synthesize(path) {
-        return this.post('/synthesize', path ? { path } : {});
+        return this.post(this.endpointPath('synthesize'), path ? { path } : {});
     }
     /** POST /seed — create .meta/ for a path. */
     async seed(path, crossRefs, steer) {
@@ -28092,28 +28246,28 @@ class MetaServiceClient {
             body.crossRefs = crossRefs;
         if (steer !== undefined)
             body.steer = steer;
-        return this.post('/seed', body);
+        return this.post(this.endpointPath('seed'), body);
     }
     /** POST /unlock — remove .lock from a meta entity. */
     async unlock(path) {
-        return this.post('/unlock', { path });
+        return this.post(this.endpointPath('unlock'), { path });
     }
     /** GET /config — query service config with optional JSONPath. */
     async config(path) {
         const qs = path ? '?path=' + encodeURIComponent(path) : '';
-        return this.get('/config' + qs);
+        return this.get(this.endpointPath('config') + qs);
     }
     /** GET /queue — current queue state. */
     async queue() {
-        return this.get('/queue');
+        return this.get(this.endpointPath('queue'));
     }
     /** POST /queue/clear — remove all pending queue items. */
     async clearQueue() {
-        return this.post('/queue/clear', {});
+        return this.post(this.endpointPath('queueClear'), {});
     }
     /** POST /synthesize/abort — abort current synthesis. */
     async abort() {
-        return this.post('/synthesize/abort', {});
+        return this.post(this.endpointPath('abort'), {});
     }
 }
 
@@ -28147,7 +28301,7 @@ function wrap(baseUrl, fn) {
 function buildMetaListTool(client, baseUrl) {
     return {
         name: 'meta_list',
-        description: 'List metas with summary stats and per-meta projection. Response includes _phaseState and owedPhase per meta.',
+        description: getEndpoint('listMetas').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28190,7 +28344,7 @@ function buildMetaListTool(client, baseUrl) {
 function buildMetaDetailTool(client, baseUrl) {
     return {
         name: 'meta_detail',
-        description: 'Full detail for a single meta, with optional archive history. Response includes _phaseState and owedPhase.',
+        description: getEndpoint('metaDetail').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28219,7 +28373,7 @@ function buildMetaDetailTool(client, baseUrl) {
 function buildMetaPreviewTool(client, baseUrl) {
     return {
         name: 'meta_preview',
-        description: 'Dry-run preview of next synthesis. Returns owedPhase, priorityBand, phaseState, stalenessInputs, and architectInvalidators.',
+        description: getEndpoint('preview').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28235,7 +28389,7 @@ function buildMetaPreviewTool(client, baseUrl) {
 function buildMetaTriggerTool(client, baseUrl) {
     return {
         name: 'meta_trigger',
-        description: 'Trigger synthesis. Path-targeted creates an override queue entry; returns owedPhase. Fully-fresh metas return status:skipped.',
+        description: getEndpoint('synthesize').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28251,7 +28405,7 @@ function buildMetaTriggerTool(client, baseUrl) {
 function buildMetaSeedTool(client, baseUrl) {
     return {
         name: 'meta_seed',
-        description: 'Create a .meta/ directory and initial meta.json for a new entity path.',
+        description: getEndpoint('seed').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28294,7 +28448,7 @@ function buildMetaSeedTool(client, baseUrl) {
 function buildMetaUnlockTool(client, baseUrl) {
     return {
         name: 'meta_unlock',
-        description: 'Remove a stale .lock from a meta entity that is stuck.',
+        description: getEndpoint('unlock').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28311,7 +28465,7 @@ function buildMetaUnlockTool(client, baseUrl) {
 function buildMetaQueueTool(client, baseUrl) {
     return {
         name: 'meta_queue',
-        description: 'Queue management. list: 3-layer model (current with phase, overrides, automatic, pending). clear: removes overrides only. abort: returns {status,path,phase} or {status:idle}.',
+        description: `Queue management. list: ${getEndpoint('queue').description} clear: ${getEndpoint('queueClear').description} abort: ${getEndpoint('abort').description}`,
         parameters: {
             type: 'object',
             properties: {
@@ -28341,7 +28495,7 @@ function buildMetaQueueTool(client, baseUrl) {
 function buildMetaUpdateTool(client, baseUrl) {
     return {
         name: 'meta_update',
-        description: 'Update user-settable reserved properties on a meta entity.',
+        description: getEndpoint('updateMeta').description,
         parameters: {
             type: 'object',
             properties: {
@@ -28351,7 +28505,7 @@ function buildMetaUpdateTool(client, baseUrl) {
                 },
                 updates: {
                     type: 'object',
-                    description: 'Properties to set. Supported: _steer, _emphasis, _depth, _crossRefs, _disabled. Set to null to remove.',
+                    description: 'Properties to set. Supported: _steer, _emphasis, _depth, _crossRefs, _disabled, _architectTimeout, _builderTimeout, _criticTimeout. Set to null to remove.',
                     properties: {
                         _steer: { type: ['string', 'null'] },
                         _emphasis: { type: ['number', 'null'] },
@@ -28363,6 +28517,9 @@ function buildMetaUpdateTool(client, baseUrl) {
                             ],
                         },
                         _disabled: { type: ['boolean', 'null'] },
+                        _architectTimeout: { type: ['number', 'null'] },
+                        _builderTimeout: { type: ['number', 'null'] },
+                        _criticTimeout: { type: ['number', 'null'] },
                     },
                 },
             },
@@ -28414,15 +28571,27 @@ function register(api) {
         WORKSPACE_CONFIG_DEFAULTS.core.gatewayUrl;
     const placeholder = 'The jeeves-meta synthesis engine is initializing...\n\n' +
         'Read the `jeeves-meta` skill for usage guidance, configuration, and troubleshooting.';
+    let consecutive503s = 0;
     const getContent = createAsyncContentCache({
-        fetch: async () => generateMetaMenu(client),
+        fetch: async () => {
+            const content = await generateMetaMenu(client);
+            consecutive503s = 0;
+            return content;
+        },
         placeholder,
         onError: (error) => {
             const msg = error instanceof Error ? error.message : String(error);
             if (/HTTP 503\b/i.test(msg) || /scan.in.progress/i.test(msg)) {
-                console.warn('[jeeves-meta] Watcher scan still in progress — will retry on next refresh cycle.');
+                consecutive503s++;
+                if (consecutive503s === 1) {
+                    console.warn('[jeeves-meta] Watcher scan still in progress — will retry on next refresh cycle.');
+                }
+                else {
+                    console.debug(`[jeeves-meta] Watcher scan still in progress (attempt ${String(consecutive503s)}) — suppressing repeated warnings.`);
+                }
                 return;
             }
+            consecutive503s = 0;
             console.warn('[jeeves-meta] Content fetch failed:', msg);
         },
     });

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

@@ -48,8 +48,12 @@ Full detail for a single meta, with optional archive history. Includes
 Dry-run for the next synthesis candidate. Shows scope files, delta files,
 architect trigger reasons, steer status, structure changes, and the
 phase that would execute next — without running any LLM calls. Includes
-`phaseState` and `owedPhase` (the phase that would run). Use before
-`meta_trigger` to understand what will happen.
+`phaseState`, `owedPhase` (the phase that would run), `inputStatus`
+(informational flags: structureHash, steerChanged, architectChanged,
+criticChanged, crossRefsDeclChanged, crossRefContentChanged), and
+`architectInvalidators` (list of reasons architect was triggered, e.g.
+`structureHash`, `steer`, `_crossRefs`, `firstRun`, `architectEvery`).
+Use before `meta_trigger` to understand what will happen.
 
 **Parameters:**
 - `path` (optional): Specific `.meta/` or owner directory path. If omitted,
@@ -105,7 +109,8 @@ modify `_crossRefs` — without editing `meta.json` directly on the filesystem.
 **Parameters:**
 - `path` (required): `.meta/` or owner directory path.
 - `updates` (required): Object with properties to set. Supported:
-  `_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`.
+  `_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`,
+  `_architectTimeout`, `_builderTimeout`, `_criticTimeout`.
   Set a value to `null` to remove the property.
 
 ### meta_queue
@@ -141,6 +146,7 @@ compatibility.
 - **Disabling a meta:** `meta_update` with path and `updates: { _disabled: true }`
 - **Re-enabling a meta:** `meta_update` with path and `updates: { _disabled: null }`
 - **Changing steer via API:** `meta_update` with path and `updates: { _steer: "new focus" }`
+- **Setting per-entity timeouts:** `meta_update` with path and `updates: { _builderTimeout: 600 }`
 - **Reading synthesis output:** Use `watcher_search` filtered by the properties
   configured in `metaProperty` (e.g. `{ "domains": ["meta"] }` in production).
   The default properties are `{ _meta: "current" }` for live metas and
@@ -213,7 +219,9 @@ Key settings:
 
 | `schedule` | `*/30 * * * *` | Cron expression for automatic synthesis scheduling |
 | `serverBaseUrl` | (optional) | Public base URL of the service (e.g. `http://myhost:1938`). When set, progress reports include clickable entity links. |
-| `reportChannel` | (optional) | Gateway channel target for progress messages (e.g. Slack channel ID) |
+| `reportChannel` | (optional) | Gateway channel name (e.g. `slack`). Legacy: also used as target if `reportTarget` is unset. |
+| `reportTarget` | (optional) | Channel/user ID to send progress messages to |
+| `tier2ScanLimit` | 50 | Max all-fresh candidates to scan per tick in Tier 2 invalidation |
 | `logging.level` | `info` | Log level (trace/debug/info/warn/error) |
 | `logging.file` | (optional) | Log file path |
 
@@ -335,7 +343,7 @@ The `autoSeed` config field enables declarative, config-driven `.meta/`
 creation. It is an array of policy rules, each with the shape:
 
 ```json
-{ "match": "<glob>", "steer": "<optional prompt>", "crossRefs": ["<optional paths>"] }
+{ "match": "<glob>", "steer": "<optional>", "crossRefs": ["<optional>"], "parentDepth": 0 }
 ```
 
 - **`match`** (required) — a glob pattern compatible with `watcher.walk()`.
@@ -345,6 +353,14 @@ creation. It is an array of policy rules, each with the shape:
   seeded `meta.json`.
 - **`crossRefs`** (optional) — array of cross-ref owner paths written as
   `_crossRefs` in the seeded `meta.json`.
+- **`parentDepth`** (optional, default 0) — walk up this many extra parent
+  levels from the matched file's directory.
+- **`architectTimeout`** (optional) — per-category timeout override for
+  the architect phase (seconds, min 30).
+- **`builderTimeout`** (optional) — per-category timeout override for
+  the builder phase (seconds, min 30).
+- **`criticTimeout`** (optional) — per-category timeout override for
+  the critic phase (seconds, min 30).
 
 **Evaluation order:** Rules are processed in array order. If multiple rules
 match the same directory, the last match wins for `steer` and `crossRefs`.
@@ -567,7 +583,8 @@ jeeves-meta <command> [options]
 ```
 
 Commands: `start`, `status`, `list`, `detail`, `preview`, `synthesize`,
-`seed`, `unlock`, `config`, `service install|start|stop|status|remove`.
+`seed`, `unlock`, `abort`, `prune`, `config`, `queue list|clear`,
+`service install|start|stop|status|remove`.
 
 Config resolution: `--config` flag → `JEEVES_META_CONFIG` env var → error.
 All client commands support `-p, --port` to specify the service port (default: 1938).

package/dist/src/serviceClient.d.ts

@@ -6,7 +6,7 @@
  *
  * @module serviceClient
  */
-import type { DepHealth, GatewayDepHealth, MetaListSummary, MetasItem, MetasResponse, ServiceState, WatcherDepHealth } from '@karmaniverous/jeeves-meta-core';
+import { type DepHealth, type GatewayDepHealth, type MetaListSummary, type MetasItem, type MetasResponse, type ServiceState, type WatcherDepHealth } from '@karmaniverous/jeeves-meta-core';
 export type { DepHealth, GatewayDepHealth, MetaListSummary, MetasItem, MetasResponse, ServiceState, WatcherDepHealth, };
 /**
  * Service status response from GET /status.
@@ -48,6 +48,11 @@ export declare class MetaServiceClient {
     private get;
     /** POST helper — returns parsed JSON. */
     private post;
+    /**
+     * Interpolate a parameterized endpoint path.
+     * Replaces `:param` placeholders with URI-encoded values.
+     */
+    private endpointPath;
     /** GET /status — service health + queue state. */
     status(): Promise<StatusResponse>;
     /** GET /metas — list all meta entities with summary. */
@@ -67,6 +72,9 @@ export declare class MetaServiceClient {
         _depth?: number | null;
         _crossRefs?: string[] | null;
         _disabled?: boolean | null;
+        _architectTimeout?: number | null;
+        _builderTimeout?: number | null;
+        _criticTimeout?: number | null;
     }): Promise<unknown>;
     /** GET /metas/:path — detail for a single meta. */
     detail(metaPath: string, options?: {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-meta-openclaw",
   "name": "Jeeves Meta",
   "description": "Knowledge synthesis tools — trigger synthesis, view status, manage entities.",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "skills": [
     "dist/skills/jeeves-meta"
   ],

package/package.json

@@ -1,15 +1,30 @@
 {
-  "name": "@karmaniverous/jeeves-meta-openclaw",
-  "version": "0.12.4",
   "author": "Jason Williscroft",
-  "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
-  "license": "BSD-3-Clause",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "bin": {
     "jeeves-meta-openclaw": "./dist/cli.js"
   },
+  "bugs": {
+    "url": "https://github.com/karmaniverous/jeeves-meta/issues"
+  },
+  "dependencies": {
+    "@karmaniverous/jeeves": "^0.5.11",
+    "@karmaniverous/jeeves-meta-core": "^0.1.3"
+  },
+  "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
+  "devDependencies": {
+    "@dotenvx/dotenvx": "^1.69.1",
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "cross-env": "^10.1.0",
+    "release-it": "^20.0.1",
+    "rollup": "^4.60.4",
+    "tslib": "^2.8.1",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=22"
+  },
   "exports": {
     ".": {
       "import": {
@@ -23,17 +38,6 @@
     "content",
     "openclaw.plugin.json"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/karmaniverous/jeeves-meta.git",
-    "directory": "packages/openclaw"
-  },
-  "bugs": {
-    "url": "https://github.com/karmaniverous/jeeves-meta/issues"
-  },
   "homepage": "https://github.com/karmaniverous/jeeves-meta#readme",
   "keywords": [
     "openclaw",
@@ -41,46 +45,23 @@
     "jeeves-meta",
     "synthesis"
   ],
-  "engines": {
-    "node": ">=22"
-  },
+  "license": "BSD-3-Clause",
+  "main": "dist/index.js",
+  "name": "@karmaniverous/jeeves-meta-openclaw",
   "openclaw": {
     "extensions": [
       "./dist/index.js"
     ]
   },
-  "devDependencies": {
-    "@dotenvx/dotenvx": "^1.65.0",
-    "@rollup/plugin-commonjs": "^29.0.2",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "cross-env": "^10.1.0",
-    "release-it": "^20.0.1",
-    "rollup": "^4.60.3",
-    "tslib": "^2.8.1",
-    "vitest": "^4.1.6"
-  },
-  "scripts": {
-    "build": "npm run build:plugin && npm run build:skills && npm run build:content",
-    "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",
-    "knip": "knip",
-    "test": "vitest run",
-    "typecheck": "tsc",
-    "diagrams": "cd diagrams && plantuml -tpng -o ../assets -r .",
-    "build:plugin": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
-    "build:skills": "node scripts/build-skills.mjs",
-    "build:content": "node scripts/copy-content.mjs"
+  "publishConfig": {
+    "access": "public"
   },
   "release-it": {
     "git": {
       "changelog": "npx git-cliff --unreleased --strip header",
       "commitMessage": "chore: release @karmaniverous/jeeves-meta-openclaw v${version}",
-      "tagName": "openclaw/${version}",
-      "requireBranch": "main"
+      "requireBranch": "main",
+      "tagName": "openclaw/${version}"
     },
     "github": {
       "release": true
@@ -89,10 +70,6 @@
       "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"
-      ],
       "after:init": [
         "npm run lint",
         "npm run typecheck",
@@ -103,14 +80,37 @@
         "git switch -c release/openclaw/${version}",
         "git push -u origin release/openclaw/${version}",
         "git switch ${branchName}"
+      ],
+      "before:npm:release": [
+        "npx git-cliff -o CHANGELOG.md",
+        "git add -A"
       ]
     },
     "npm": {
       "publish": true
     }
   },
-  "dependencies": {
-    "@karmaniverous/jeeves": "^0.5.10",
-    "@karmaniverous/jeeves-meta-core": "^0.1.0"
-  }
+  "repository": {
+    "directory": "packages/openclaw",
+    "type": "git",
+    "url": "git+https://github.com/karmaniverous/jeeves-meta.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": "node scripts/build-skills.mjs",
+    "changelog": "git-cliff -o CHANGELOG.md",
+    "diagrams": "cd diagrams && plantuml -tpng -o ../assets -r .",
+    "knip": "knip",
+    "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.12.6"
 }