@karmaniverous/jeeves-meta-openclaw 0.13.1 → 0.13.3

package/dist/index.js

@@ -1,5 +1,5 @@
 import { resolvePluginSetting, resolveOptionalPluginSetting, fetchJson, postJson, ok, connectionFail, createPluginToolset, resolveWorkspacePath, init, loadWorkspaceConfig, WORKSPACE_CONFIG_DEFAULTS, createAsyncContentCache, jeevesComponentDescriptorSchema, getPackageVersion, createComponentWriter } from '@karmaniverous/jeeves';
-import { phaseNames, getEndpoint, META_COMPONENT } from '@karmaniverous/jeeves-meta-core';
+import { phaseStatuses, phaseNames, getEndpoint, META_COMPONENT } from '@karmaniverous/jeeves-meta-core';
 
 /**
  * Shared constants for the jeeves-meta OpenClaw plugin.
@@ -35,6 +35,33 @@ function getConfigRoot(api) {
  *
  * @module promptInjection
  */
+/** Phase statuses that require per-phase breakdown (everything except fresh). */
+const nonFreshStatuses = phaseStatuses.filter((s) => s !== 'fresh');
+/**
+ * Format a duration in seconds as a compound human-readable interval.
+ *
+ * Produces at most two units: `2d 3h`, `1h 35m`, `45m`, etc.
+ * Returns `'never synthesized'` for non-finite input.
+ *
+ * @param seconds - Duration in seconds.
+ * @returns Formatted interval string.
+ */
+function formatAge(seconds) {
+    if (!isFinite(seconds))
+        return 'never synthesized';
+    const d = Math.floor(seconds / 86400);
+    const h = Math.floor((seconds % 86400) / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    if (d > 0 && h > 0)
+        return `${d.toString()}d ${h.toString()}h`;
+    if (d > 0)
+        return `${d.toString()}d`;
+    if (h > 0 && m > 0)
+        return `${h.toString()}h ${m.toString()}m`;
+    if (h > 0)
+        return `${h.toString()}h`;
+    return `${Math.max(m, 1).toString()}m`;
+}
 /**
  * Generate the Meta menu Markdown for TOOLS.md.
  *
@@ -56,15 +83,6 @@ async function generateMetaMenu(client) {
         ].join('\n');
     }
     const { summary } = metas;
-    const formatAge = (seconds) => {
-        if (!isFinite(seconds))
-            return 'never synthesized';
-        if (seconds < 3600)
-            return Math.round(seconds / 60).toString() + 'm';
-        if (seconds < 86400)
-            return Math.round(seconds / 3600).toString() + 'h';
-        return Math.round(seconds / 86400).toString() + 'd';
-    };
     // Find stalest age
     let stalestAge = 0;
     for (const item of metas.metas) {
@@ -103,20 +121,19 @@ async function generateMetaMenu(client) {
     const phaseLines = [];
     const phaseSummary = status.health.phaseStateSummary;
     if (phaseSummary) {
-        // Aggregate counts across all phases
-        const totals = {};
+        // Fresh counts are aggregated; non-fresh show <count> <state> <phase>
+        let freshTotal = 0;
         for (const phase of phaseNames) {
-            const counts = phaseSummary[phase];
-            for (const [state, count] of Object.entries(counts)) {
-                if (count > 0) {
-                    totals[state] = (totals[state] ?? 0) + count;
-                }
-            }
+            freshTotal += phaseSummary[phase].fresh;
         }
         const parts = [];
-        for (const state of ['fresh', 'pending', 'running', 'stale', 'failed']) {
-            if (totals[state]) {
-                parts.push(totals[state].toString() + ' ' + state);
+        if (freshTotal > 0)
+            parts.push(freshTotal.toString() + ' fresh');
+        for (const phase of phaseNames) {
+            for (const state of nonFreshStatuses) {
+                const count = phaseSummary[phase][state];
+                if (count > 0)
+                    parts.push(`${count.toString()} ${state} ${phase}`);
             }
         }
         if (parts.length > 0) {
@@ -443,7 +460,7 @@ function buildMetaSeedTool(client, baseUrl) {
                 },
                 crossRefs: {
                     type: 'string',
-                    description: 'JSON array of cross-ref owner paths (e.g. \'["j:/path/a","j:/path/b"]\').',
+                    description: 'JSON array of cross-ref owner paths (e.g. \'["<drive label>:/path/a","<drive label>:/path/b"]\'). Use server_drives to discover available drive labels.',
                 },
                 steer: {
                     type: 'string',

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

@@ -202,8 +202,8 @@ Key settings:
 | `watcherUrl` | (required) | Watcher service URL (e.g. `http://localhost:1936`) |
 | `gatewayUrl` | `http://127.0.0.1:18789` | OpenClaw gateway URL for subprocess spawning |
 | `gatewayApiKey` | (optional) | API key for gateway authentication |
-| `metaProperty` | `{ _meta: "current" }` | Watcher metadata properties applied to live `.meta/meta.json` files. `Record<string, unknown>` — any shape accepted. |
-| `metaArchiveProperty` | `{ _meta: "archive" }` | Watcher metadata properties applied to `.meta/archive/**` snapshots. Same shape flexibility. |
+| `metaProperty` | (required) | Watcher metadata properties applied to live `.meta/meta.json` files. `Record<string, unknown>` — any shape accepted. Avoid underscore-prefixed keys (e.g. `_meta`) — they may conflict with watcher reserved fields and break rendering. |
+| `metaArchiveProperty` | (required) | Watcher metadata properties applied to `.meta/archive/**` snapshots. Same shape flexibility and underscore-prefix caveat as `metaProperty`. |
 | `architectEvery` | 10 | Re-run architect every N cycles even if structure unchanged |
 | `depthWeight` | 0.5 | Exponent for depth-based scheduling (0 = pure staleness) |
 | `maxArchive` | 20 | Max archived snapshots per meta |
@@ -214,9 +214,14 @@ 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. |
+| `serverDriveRoots` | (optional) | Drive label to absolute path mapping for Linux path resolution in progress links (e.g. `{ "content": "/opt/jeeves/content" }`). |
 | `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 |
+| `workspaceDir` | OS tmpdir + `/jeeves-meta` | Directory for sub-agent output staging files |
+| `stagingRetries` | 10 | Max retries when staging file not yet visible after session completion (min 0) |
+| `stagingRetryDelayMs` | 250 | Delay between staging file retry attempts in ms (min 0) |
+| `previewDeltaFilesCap` | 50 | Max delta files included in `/preview` response; excess sets `deltaFilesTruncated: true` (min 1) |
 | `logging.level` | `info` | Log level (trace/debug/info/warn/error) |
 | `logging.file` | (optional) | Log file path |
 
@@ -271,24 +276,13 @@ properties.
 
 ### Prompt System
 
-The service ships with built-in default architect and critic prompts. Most
-installations need no prompt configuration at all.
-
-**Overriding defaults:** Set `defaultArchitect` and/or `defaultCritic` in the
-config to replace the built-in prompts. Supports `@file:` references resolved
-relative to the config file's directory:
-
-```json
-{
-  "defaultArchitect": "@file:jeeves-meta/prompts/architect.md",
-  "defaultCritic": "@file:jeeves-meta/prompts/critic.md"
-}
-```
+The service ships with built-in default architect and critic prompts. Prompts
+ship with the package and cannot be overridden via config.
 
 **Per-meta overrides:** Set `_architect` or `_critic` directly in a `meta.json`
 to override the defaults for that specific entity.
 
-**Template variables:** All prompts (default, config-overridden, and per-meta)
+**Template variables:** All prompts (built-in and per-meta)
 are compiled as Handlebars templates at synthesis time with access to:
 
 - `{{config.maxLines}}`, `{{config.architectEvery}}`, etc.
@@ -302,19 +296,20 @@ prompt is compiled.
 
 ### Minimal Config Example
 
-A minimum viable config file requires only `watcherUrl`:
+A minimum viable config file requires `watcherUrl`, `metaProperty`, and `metaArchiveProperty`:
 
 ```json
 {
   "watcherUrl": "http://localhost:1936",
   "gatewayUrl": "http://127.0.0.1:18789",
-  "gatewayApiKey": "your-api-key"
+  "gatewayApiKey": "your-api-key",
+  "metaProperty": { "_meta": "current" },
+  "metaArchiveProperty": { "_meta": "archive" }
 }
 ```
 
 All other fields use sensible defaults (port 1938, schedule every 30 min,
-depth weight 0.5, built-in prompts, etc). Add `reportChannel`, `metaProperty`,
-`logging`, etc. as needed.
+depth weight 0.5, built-in prompts, etc). Add `reportChannel`, `logging`, etc. as needed.
 
 ### Adding New Metas
 
@@ -410,8 +405,6 @@ restart-required fields:
 - `watcherUrl` — watcher service URL
 - `gatewayUrl` — OpenClaw gateway URL
 - `gatewayApiKey` — gateway authentication key
-- `defaultArchitect` — architect system prompt
-- `defaultCritic` — critic system prompt
 
 Edit the config file and save; the service detects changes via `fs.watchFile`.
 When a restart-required field changes, the service logs a warning but the
@@ -457,14 +450,11 @@ Before the synthesis engine can operate:
    - Verify: `curl http://localhost:6333/healthz`
 
 4. **Config file** must exist at the path specified by `JEEVES_META_CONFIG`
-   - Must contain valid `watcherUrl`
-   - `defaultArchitect` and `defaultCritic` are optional (built-in defaults
-     ship with the package). Set them only to override the defaults.
-
-5. **Prompt files** must exist only if using `@file:` references in config
-   - Not needed if using the built-in defaults (most installations)
+   - Must contain valid `watcherUrl`, `metaProperty`, and `metaArchiveProperty`
+   - Built-in architect and critic prompts ship with the package; no prompt
+     configuration is required
 
-6. **`.meta/` directories** must exist and be within paths the watcher indexes
+5. **`.meta/` directories** must exist and be within paths the watcher indexes
    - Seed new metas: `jeeves-meta seed <path>`
 
 ### Installation
@@ -696,12 +686,11 @@ not yet indexed new files
 - First-run quality is lower — the feedback loop needs 2-3 cycles to calibrate.
 - Changing `metaProperty` requires both a meta service restart AND a watcher reindex.
   The service restart re-registers virtual rules; the reindex retags existing points.
-- `defaultArchitect`/`defaultCritic` are optional — built-in defaults ship with
-  the package. The `@file:` prefix (when used) is resolved relative to the config
-  file's directory, not the working directory.
-- All prompts are compiled as Handlebars templates. Avoid using `{{` in prompt
-  overrides unless you intend template variable resolution. Escape with `\{{`
-  for literal double-braces.
+- Built-in architect and critic prompts ship with the package and cannot be
+  overridden via config.
+- All prompts (built-in and per-meta `_architect`/`_critic`) are compiled as
+  Handlebars templates. Avoid using `{{` in prompt text unless you intend
+  template variable resolution. Escape with `\{{` for literal double-braces.
 - The synthesis queue is single-threaded with three layers: `current` (the
   running phase), `overrides` (explicitly triggered entries, highest priority),
   and `automatic` (scheduler-computed candidates). Override entries are

package/dist/src/promptInjection.d.ts

@@ -7,6 +7,16 @@
  * @module promptInjection
  */
 import type { MetaServiceClient } from './serviceClient.js';
+/**
+ * Format a duration in seconds as a compound human-readable interval.
+ *
+ * Produces at most two units: `2d 3h`, `1h 35m`, `45m`, etc.
+ * Returns `'never synthesized'` for non-finite input.
+ *
+ * @param seconds - Duration in seconds.
+ * @returns Formatted interval string.
+ */
+export declare function formatAge(seconds: number): string;
 /**
  * Generate the Meta menu Markdown for TOOLS.md.
  *

package/dist/src/serviceClient.d.ts

@@ -6,8 +6,8 @@
  *
  * @module serviceClient
  */
-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, };
+import { type DepHealth, type GatewayDepHealth, type MetaListSummary, type MetasItem, type MetasResponse, type NextPhaseCandidate, type PhaseStateSummary, type ServiceState, type WatcherDepHealth } from '@karmaniverous/jeeves-meta-core';
+export type { DepHealth, GatewayDepHealth, MetaListSummary, MetasItem, MetasResponse, NextPhaseCandidate, PhaseStateSummary, ServiceState, WatcherDepHealth, };
 /**
  * Service status response from GET /status.
  *
@@ -31,6 +31,10 @@ export interface StatusResponse {
             watcher: WatcherDepHealth;
             gateway: GatewayDepHealth;
         };
+        /** Per-phase counts of each status, from the scheduler. */
+        phaseStateSummary?: PhaseStateSummary;
+        /** Next phase candidate from the scheduler. */
+        nextPhase?: NextPhaseCandidate | null;
         [key: string]: unknown;
     };
 }

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.13.1",
+  "version": "0.13.3",
   "skills": [
     "dist/skills/jeeves-meta"
   ],

package/package.json

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@karmaniverous/jeeves": "^0.5.12",
-    "@karmaniverous/jeeves-meta-core": "^0.2.0"
+    "@karmaniverous/jeeves-meta-core": "^0.2.2"
   },
   "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
   "devDependencies": {
@@ -112,5 +112,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.13.1"
+  "version": "0.13.3"
 }