@karmaniverous/jeeves-meta 0.12.4 → 0.13.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { Command } from 'commander';
 import { JeevesComponentDescriptor } from '@karmaniverous/jeeves';
+export { sleepAsync as sleep } from '@karmaniverous/jeeves';
 import pino, { Logger } from 'pino';
 import * as fastify from 'fastify';
 import { FastifyInstance, FastifyBaseLogger } from 'fastify';
@@ -236,7 +237,6 @@ declare const serviceConfigSchema: z.ZodObject<{
     metaProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     metaArchiveProperty: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     port: z.ZodDefault<z.ZodNumber>;
-    host: z.ZodDefault<z.ZodString>;
     schedule: z.ZodDefault<z.ZodString>;
     reportChannel: z.ZodOptional<z.ZodString>;
     serverBaseUrl: z.ZodOptional<z.ZodString>;
@@ -636,7 +636,7 @@ declare class Scheduler {
  * Shared between the descriptor's `onConfigApply` and the file-watcher
  * hot-reload in `bootstrap.ts`.
  */
-declare const RESTART_REQUIRED_FIELDS: readonly ["port", "host", "watcherUrl", "gatewayUrl", "gatewayApiKey", "defaultArchitect", "defaultCritic"];
+declare const RESTART_REQUIRED_FIELDS: readonly ["port", "watcherUrl", "gatewayUrl", "gatewayApiKey", "defaultArchitect", "defaultCritic"];
 
 /**
  * Load and resolve jeeves-meta service config.
@@ -1368,6 +1368,8 @@ declare function selectCandidate(candidates: StalenessCandidate[]): StalenessCan
  * @returns True if any file in scope was modified after `_generatedAt`.
  */
 declare function isStale(scopePrefix: string, meta: MetaJson, watcher: WatcherClient): Promise<boolean>;
+/** Maximum staleness for never-synthesized metas (1 year in seconds). */
+declare const MAX_STALENESS_SECONDS: number;
 /**
  * Compute actual staleness in seconds (now minus _generatedAt).
  *
@@ -1453,9 +1455,6 @@ declare function registerRoutes(app: FastifyInstance, deps: RouteDeps): void;
  */
 declare function verifyRuleApplication(watcher: WatcherClient, logger: MinimalLogger): Promise<number>;
 
-/** Sleep for a given number of milliseconds. */
-declare function sleep(ms: number): Promise<void>;
-
 /** Options for creating the server. */
 interface ServerOptions {
     /** Pino logger instance. */
@@ -1519,5 +1518,5 @@ declare function registerShutdownHandlers(deps: ShutdownDeps): void;
  */
 declare function startService(config: ServiceConfig, configPath?: string): Promise<void>;
 
-export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, ProgressReporter, RESTART_REQUIRED_FIELDS, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaDescriptor, metaErrorSchema, metaJsonSchema, migrateConfigPath, normalizePath, orchestrate, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerCustomCliCommands, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, verifyRuleApplication };
+export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, MAX_STALENESS_SECONDS, ProgressReporter, RESTART_REQUIRED_FIELDS, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaDescriptor, metaErrorSchema, metaJsonSchema, migrateConfigPath, normalizePath, orchestrate, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerCustomCliCommands, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, startService, toMetaError, verifyRuleApplication };
 export type { BuilderOutput, EnqueueResult, GatewayExecutorOptions, HttpWatcherClientOptions, InferenceRuleSpec, LockState, LoggerConfig, MergeOptions, MetaConfig, MetaContext, MetaEntry, MetaError, MetaExecutor, MetaJson, MetaListResult, MetaListSummary, MetaNode, MetaSpawnOptions, MetaSpawnResult, MinimalLogger, OrchestrateResult, OwnershipTree, ProgressCallback, ProgressEvent, ProgressPhase, ProgressReporterConfig, QueueItem, QueueState, RouteDeps, ServerOptions, ServiceConfig, ServiceStats, StalenessCandidate, WatcherClient, WatcherScanPoint, WatcherScanRequest, WatcherScanResult };

package/dist/index.js

@@ -11,9 +11,9 @@ import require$$4 from 'util';
 import require$$5 from 'assert';
 import require$$2 from 'events';
 import vm from 'vm';
+import { z } from 'zod';
 import * as commander from 'commander';
 import { tmpdir } from 'node:os';
-import { z } from 'zod';
 import 'node:child_process';
 import { randomUUID, createHash } from 'node:crypto';
 import pino from 'pino';
@@ -7243,6 +7243,32 @@ requireSemver();
 
 /** Core config file name. */
 const CONFIG_FILE = 'config.json';
+
+/**
+ * Default port assignments for Jeeves platform services.
+ *
+ * @remarks
+ * Each port number is a historical reference:
+ * - 1934: Wodehouse's *Thank You, Jeeves*; Popper's *Logic of Scientific Discovery*
+ * - 1936: Turing's "On Computable Numbers"; Church's lambda calculus
+ * - 1937: Turing's paper in *Proceedings of the London Mathematical Society*
+ * - 1938: Wodehouse's *The Code of the Woosters*; Shannon's relay/switching paper
+ */
+/** Default port for jeeves-server. */
+const SERVER_PORT = 1934;
+/** Default port for jeeves-watcher. */
+const WATCHER_PORT = 1936;
+/** Default port for jeeves-runner. */
+const RUNNER_PORT = 1937;
+/** Default port for jeeves-meta. */
+const META_PORT = 1938;
+/** Map of service names to their default ports. */
+const DEFAULT_PORTS = {
+    server: SERVER_PORT,
+    watcher: WATCHER_PORT,
+    runner: RUNNER_PORT,
+    meta: META_PORT,
+};
 /**
  * Get the core config directory path.
  *
@@ -7504,6 +7530,47 @@ function createStatusHandler(options) {
         };
     };
 }
+/** Core shared config section. */
+const workspaceCoreConfigSchema = z
+    .object({
+    /** Workspace root path. */
+    workspace: z.string().optional().describe('Workspace root path'),
+    /** Platform config root path. */
+    configRoot: z.string().optional().describe('Platform config root path'),
+    /** OpenClaw gateway URL. */
+    gatewayUrl: z.string().optional().describe('OpenClaw gateway URL'),
+})
+    .partial();
+/** Memory shared config section. */
+const workspaceMemoryConfigSchema = z
+    .object({
+    /** MEMORY.md character budget. */
+    budget: z.number().int().positive().optional().describe('Memory budget'),
+    /** Warning threshold as a fraction of budget. */
+    warningThreshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Memory warning threshold'),
+    /** Staleness threshold in days. */
+    staleDays: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Memory staleness threshold in days'),
+})
+    .partial();
+/** Workspace config Zod schema. */
+z.object({
+    /** JSON Schema pointer for IDE autocomplete. */
+    $schema: z.string().optional().describe('JSON Schema pointer'),
+    /** Core shared defaults. */
+    core: workspaceCoreConfigSchema.optional(),
+    /** Memory hygiene shared defaults. */
+    memory: workspaceMemoryConfigSchema.optional(),
+});
 
 function getDefaultExportFromCjs (x) {
 	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
@@ -7821,6 +7888,38 @@ function loadConfig(configDir) {
     }
 }
 
+/**
+ * Service URL resolution.
+ *
+ * @remarks
+ * Resolves the URL for a named Jeeves service using the following
+ * resolution order:
+ * 1. Consumer's own component config
+ * 2. Core config (`{configRoot}/jeeves-core/config.json`)
+ * 3. Default port constants
+ */
+/**
+ * Resolve the URL for a named Jeeves service.
+ *
+ * @param serviceName - The service name (e.g., 'watcher', 'runner').
+ * @param consumerName - Optional consumer component name for config override.
+ * @returns The resolved service URL.
+ * @throws Error if `init()` has not been called or the service is unknown.
+ */
+function getServiceUrl(serviceName, consumerName) {
+    // 2. Check core config
+    const coreDir = getCoreConfigDir();
+    const coreConfig = loadConfig(coreDir);
+    const coreUrl = coreConfig?.services[serviceName]?.url;
+    if (coreUrl)
+        return coreUrl;
+    // 3. Fall back to port constants
+    const port = DEFAULT_PORTS[serviceName];
+    {
+        return `http://127.0.0.1:${String(port)}`;
+    }
+}
+
 /**
  * Resolve the bind address for a Jeeves service.
  *
@@ -7858,6 +7957,10 @@ function getBindAddress(componentName) {
     // Tier 4: Default
     return DEFAULT_BIND_ADDRESS;
 }
+/** Async sleep via setTimeout. */
+function sleepAsync(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
 
 /**
  * Custom CLI commands for the jeeves-meta service.
@@ -7869,7 +7972,11 @@ function getBindAddress(componentName) {
  */
 /** Build the full API URL for a given port string and path. */
 function apiUrl(port, apiPath) {
-    return `http://127.0.0.1:${port}${apiPath}`;
+    const url = new URL(apiPath, getServiceUrl('meta'));
+    if (port !== DEFAULT_PORT_STR) {
+        url.port = port;
+    }
+    return url.toString();
 }
 /** Wrap an async CLI action with consistent error handling. */
 function withErrorHandling(fn, label) {
@@ -8024,7 +8131,6 @@ function registerCustomCliCommands(program) {
  */
 const RESTART_REQUIRED_FIELDS = [
     'port',
-    'host',
     'watcherUrl',
     'gatewayUrl',
     'gatewayApiKey',
@@ -8136,8 +8242,6 @@ const autoSeedRuleSchema = z.object({
 const serviceConfigSchema = metaConfigSchema.extend({
     /** HTTP port for the service (default: 1938). */
     port: z.number().int().min(1).max(65535).default(1938),
-    /** Bind address for the HTTP server (default: 127.0.0.1). */
-    host: z.string().default('127.0.0.1'),
     /** Cron schedule for synthesis cycles (default: every 30 min). */
     schedule: z.string().default('*/30 * * * *'),
     /** Optional channel identifier for reporting. */
@@ -8523,6 +8627,174 @@ async function readMetaJson(metaPath) {
     return JSON.parse(raw);
 }
 
+/**
+ * Escape special glob characters in a path so it can be used as a literal
+ * prefix in glob patterns.
+ *
+ * Glob metacharacters `* ? [ ] { } ( ) !` are escaped with a backslash so
+ * that paths containing parentheses (e.g. Slack channel IDs) or other
+ * special characters are matched literally by the watcher's walk endpoint.
+ *
+ * @module escapeGlob
+ */
+/**
+ * Escape glob metacharacters in a string using character-class wrapping.
+ *
+ * Backslash escaping (`\(`) does not work reliably on Windows where `\` is
+ * the path separator. Instead, each metacharacter is wrapped in a character
+ * class (e.g. `(` → `[(]`) which is universally supported by glob libraries.
+ *
+ * Square brackets themselves are escaped as `[[]` and `[]]`.
+ *
+ * @param s - Raw path string.
+ * @returns String with glob metacharacters wrapped in character classes.
+ */
+function escapeGlob(s) {
+    return s.replace(/[*?[\]{}()!]/g, (ch) => `[${ch}]`);
+}
+
+/**
+ * Filter file paths by modification time.
+ *
+ * Shared utility for staleness detection and delta file enumeration.
+ * Uses `fs.statSync` for fast local mtime checks on known paths.
+ *
+ * @module mtimeFilter
+ */
+/**
+ * Check if any file in the list was modified after the given timestamp.
+ *
+ * Short-circuits on first match for efficiency (staleness checks).
+ *
+ * @param files - Array of file paths to check.
+ * @param afterMs - Timestamp in milliseconds. Files with `mtimeMs > afterMs` match.
+ * @returns True if any file was modified after the timestamp.
+ */
+function hasModifiedAfter(files, afterMs) {
+    for (const filePath of files) {
+        try {
+            if (statSync(filePath).mtimeMs > afterMs)
+                return true;
+        }
+        catch {
+            // Unreadable file — skip
+        }
+    }
+    return false;
+}
+/**
+ * Filter files to only those modified after the given timestamp.
+ *
+ * @param files - Array of file paths to filter.
+ * @param afterMs - Timestamp in milliseconds. Files with `mtimeMs > afterMs` are included.
+ * @returns Filtered array of file paths.
+ */
+function filterModifiedAfter(files, afterMs) {
+    return files.filter((filePath) => {
+        try {
+            return statSync(filePath).mtimeMs > afterMs;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+
+/**
+ * Staleness detection via watcher walk.
+ *
+ * A meta is stale when any watched file in its scope was modified after
+ * `_generatedAt`.
+ *
+ * @module scheduling/staleness
+ */
+/**
+ * Check if a meta is stale.
+ *
+ * Uses watcher `/walk` to enumerate watched files under the scope prefix,
+ * then applies a local mtime check (fast) to detect any modifications since
+ * `_generatedAt`. Short-circuits on first match.
+ *
+ * @param scopePrefix - Path prefix for this meta's scope.
+ * @param meta - Current meta.json content.
+ * @param watcher - WatcherClient instance.
+ * @returns True if any file in scope was modified after `_generatedAt`.
+ */
+async function isStale(scopePrefix, meta, watcher) {
+    if (!meta._generatedAt)
+        return true; // Never synthesized = stale
+    const files = await watcher.walk([`${escapeGlob(scopePrefix)}/**`]);
+    // Exclude .meta/ subtree — synthesis outputs must not trigger staleness.
+    // Handle both forward and back slashes for cross-platform compatibility.
+    const metaSep = /[/\\]\.meta(?:[/\\]|$)/;
+    const filtered = files.filter((f) => !metaSep.test(f));
+    return hasModifiedAfter(filtered, new Date(meta._generatedAt).getTime());
+}
+/** Maximum staleness for never-synthesized metas (1 year in seconds). */
+const MAX_STALENESS_SECONDS = 365 * 86_400;
+/**
+ * Compute actual staleness in seconds (now minus _generatedAt).
+ *
+ * Never-synthesized metas are capped at {@link MAX_STALENESS_SECONDS}
+ * (1 year) so that depth weighting can differentiate them. Without
+ * bounding, `Infinity * depthFactor` = `Infinity` for all depths.
+ *
+ * @param meta - Current meta.json content.
+ * @returns Staleness in seconds, capped at 1 year for never-synthesized metas.
+ */
+function actualStaleness(meta) {
+    if (!meta._generatedAt)
+        return MAX_STALENESS_SECONDS;
+    const generatedMs = new Date(meta._generatedAt).getTime();
+    return Math.min((Date.now() - generatedMs) / 1000, MAX_STALENESS_SECONDS);
+}
+/**
+ * Check whether the architect step should be triggered.
+ *
+ * @param meta - Current meta.json.
+ * @param structureChanged - Whether the structure hash changed.
+ * @param steerChanged - Whether the steer directive changed.
+ * @param architectEvery - Config: run architect every N cycles.
+ * @returns True if the architect step should run.
+ */
+function isArchitectTriggered(meta, structureChanged, steerChanged, architectEvery) {
+    return (!meta._builder ||
+        structureChanged ||
+        steerChanged ||
+        (meta._synthesisCount ?? 0) >= architectEvery);
+}
+/**
+ * Detect whether the steer directive changed since the last archive.
+ *
+ * @param currentSteer - Current _steer value (or undefined).
+ * @param archiveSteer - Archive _steer value (or undefined).
+ * @param hasArchive - Whether an archive snapshot exists.
+ * @returns True if steer changed.
+ */
+function hasSteerChanged(currentSteer, archiveSteer, hasArchive) {
+    if (!hasArchive)
+        return Boolean(currentSteer);
+    return currentSteer !== archiveSteer;
+}
+/**
+ * Compute a normalized staleness score (0–1) for display purposes.
+ *
+ * Uses the same depth/emphasis weighting as candidate selection,
+ * normalized to a 30-day window.
+ *
+ * @param stalenessSeconds - Raw staleness in seconds (null = never synthesized).
+ * @param depth - Meta tree depth.
+ * @param emphasis - Scheduling emphasis multiplier.
+ * @param depthWeight - Depth weighting exponent from config.
+ * @returns Normalized score between 0 and 1.
+ */
+function computeStalenessScore(stalenessSeconds, depth, emphasis, depthWeight) {
+    if (stalenessSeconds === null)
+        return 1;
+    const depthFactor = Math.pow(1 + depthWeight, depth);
+    return Math.min(1, (stalenessSeconds * depthFactor * emphasis) / (30 * 86400));
+}
+
 /**
  * Build the ownership tree from discovered .meta/ paths.
  *
@@ -8605,8 +8877,6 @@ function findNode(tree, targetPath) {
  *
  * @module discovery/listMetas
  */
-/** Maximum staleness for never-synthesized metas (1 year in seconds). */
-const MAX_STALENESS_SECONDS$1 = 365 * 86_400;
 /**
  * Discover, deduplicate, and enrich all metas.
  *
@@ -8642,7 +8912,7 @@ async function listMetas(config, watcher) {
         // Compute staleness
         let stalenessSeconds;
         if (neverSynth) {
-            stalenessSeconds = MAX_STALENESS_SECONDS$1;
+            stalenessSeconds = MAX_STALENESS_SECONDS;
         }
         else {
             const genAt = new Date(meta._generatedAt).getTime();
@@ -8675,79 +8945,6 @@ async function listMetas(config, watcher) {
     };
 }
 
-/**
- * Escape special glob characters in a path so it can be used as a literal
- * prefix in glob patterns.
- *
- * Glob metacharacters `* ? [ ] { } ( ) !` are escaped with a backslash so
- * that paths containing parentheses (e.g. Slack channel IDs) or other
- * special characters are matched literally by the watcher's walk endpoint.
- *
- * @module escapeGlob
- */
-/**
- * Escape glob metacharacters in a string using character-class wrapping.
- *
- * Backslash escaping (`\(`) does not work reliably on Windows where `\` is
- * the path separator. Instead, each metacharacter is wrapped in a character
- * class (e.g. `(` → `[(]`) which is universally supported by glob libraries.
- *
- * Square brackets themselves are escaped as `[[]` and `[]]`.
- *
- * @param s - Raw path string.
- * @returns String with glob metacharacters wrapped in character classes.
- */
-function escapeGlob(s) {
-    return s.replace(/[*?[\]{}()!]/g, (ch) => `[${ch}]`);
-}
-
-/**
- * Filter file paths by modification time.
- *
- * Shared utility for staleness detection and delta file enumeration.
- * Uses `fs.statSync` for fast local mtime checks on known paths.
- *
- * @module mtimeFilter
- */
-/**
- * Check if any file in the list was modified after the given timestamp.
- *
- * Short-circuits on first match for efficiency (staleness checks).
- *
- * @param files - Array of file paths to check.
- * @param afterMs - Timestamp in milliseconds. Files with `mtimeMs > afterMs` match.
- * @returns True if any file was modified after the timestamp.
- */
-function hasModifiedAfter(files, afterMs) {
-    for (const filePath of files) {
-        try {
-            if (statSync(filePath).mtimeMs > afterMs)
-                return true;
-        }
-        catch {
-            // Unreadable file — skip
-        }
-    }
-    return false;
-}
-/**
- * Filter files to only those modified after the given timestamp.
- *
- * @param files - Array of file paths to filter.
- * @param afterMs - Timestamp in milliseconds. Files with `mtimeMs > afterMs` are included.
- * @returns Filtered array of file paths.
- */
-function filterModifiedAfter(files, afterMs) {
-    return files.filter((filePath) => {
-        try {
-            return statSync(filePath).mtimeMs > afterMs;
-        }
-        catch {
-            return false;
-        }
-    });
-}
-
 /**
  * Compute the file scope owned by a meta node.
  *
@@ -8824,11 +9021,6 @@ function getDeltaFiles(generatedAt, scopeFiles) {
     return filterModifiedAfter(scopeFiles, new Date(generatedAt).getTime());
 }
 
-/** Sleep for a given number of milliseconds. */
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 /**
  * Error thrown when a spawned subprocess is aborted via AbortController.
  *
@@ -8983,7 +9175,7 @@ class GatewayExecutor {
                 JSON.stringify(spawnResult));
         }
         // Step 2: Poll for completion via sessions_history
-        await sleep(3000);
+        await sleepAsync(3000);
         while (Date.now() < deadline) {
             // Check for abort before each poll iteration
             if (this.controller.signal.aborted) {
@@ -9047,7 +9239,7 @@ class GatewayExecutor {
             catch {
                 // Transient poll failure — keep trying
             }
-            await sleep(this.pollIntervalMs);
+            await sleepAsync(this.pollIntervalMs);
         }
         throw new SpawnTimeoutError('Synthesis subprocess timed out after ' + timeoutMs.toString() + 'ms', outputPath);
     }
@@ -9720,101 +9912,6 @@ function discoverStalestPath(candidates, depthWeight) {
     return winner?.node.metaPath ?? null;
 }
 
-/**
- * Staleness detection via watcher walk.
- *
- * A meta is stale when any watched file in its scope was modified after
- * `_generatedAt`.
- *
- * @module scheduling/staleness
- */
-/**
- * Check if a meta is stale.
- *
- * Uses watcher `/walk` to enumerate watched files under the scope prefix,
- * then applies a local mtime check (fast) to detect any modifications since
- * `_generatedAt`. Short-circuits on first match.
- *
- * @param scopePrefix - Path prefix for this meta's scope.
- * @param meta - Current meta.json content.
- * @param watcher - WatcherClient instance.
- * @returns True if any file in scope was modified after `_generatedAt`.
- */
-async function isStale(scopePrefix, meta, watcher) {
-    if (!meta._generatedAt)
-        return true; // Never synthesized = stale
-    const files = await watcher.walk([`${escapeGlob(scopePrefix)}/**`]);
-    // Exclude .meta/ subtree — synthesis outputs must not trigger staleness.
-    // Handle both forward and back slashes for cross-platform compatibility.
-    const metaSep = /[/\\]\.meta(?:[/\\]|$)/;
-    const filtered = files.filter((f) => !metaSep.test(f));
-    return hasModifiedAfter(filtered, new Date(meta._generatedAt).getTime());
-}
-/** Maximum staleness for never-synthesized metas (1 year in seconds). */
-const MAX_STALENESS_SECONDS = 365 * 86_400;
-/**
- * Compute actual staleness in seconds (now minus _generatedAt).
- *
- * Never-synthesized metas are capped at {@link MAX_STALENESS_SECONDS}
- * (1 year) so that depth weighting can differentiate them. Without
- * bounding, `Infinity * depthFactor` = `Infinity` for all depths.
- *
- * @param meta - Current meta.json content.
- * @returns Staleness in seconds, capped at 1 year for never-synthesized metas.
- */
-function actualStaleness(meta) {
-    if (!meta._generatedAt)
-        return MAX_STALENESS_SECONDS;
-    const generatedMs = new Date(meta._generatedAt).getTime();
-    return Math.min((Date.now() - generatedMs) / 1000, MAX_STALENESS_SECONDS);
-}
-/**
- * Check whether the architect step should be triggered.
- *
- * @param meta - Current meta.json.
- * @param structureChanged - Whether the structure hash changed.
- * @param steerChanged - Whether the steer directive changed.
- * @param architectEvery - Config: run architect every N cycles.
- * @returns True if the architect step should run.
- */
-function isArchitectTriggered(meta, structureChanged, steerChanged, architectEvery) {
-    return (!meta._builder ||
-        structureChanged ||
-        steerChanged ||
-        (meta._synthesisCount ?? 0) >= architectEvery);
-}
-/**
- * Detect whether the steer directive changed since the last archive.
- *
- * @param currentSteer - Current _steer value (or undefined).
- * @param archiveSteer - Archive _steer value (or undefined).
- * @param hasArchive - Whether an archive snapshot exists.
- * @returns True if steer changed.
- */
-function hasSteerChanged(currentSteer, archiveSteer, hasArchive) {
-    if (!hasArchive)
-        return Boolean(currentSteer);
-    return currentSteer !== archiveSteer;
-}
-/**
- * Compute a normalized staleness score (0–1) for display purposes.
- *
- * Uses the same depth/emphasis weighting as candidate selection,
- * normalized to a 30-day window.
- *
- * @param stalenessSeconds - Raw staleness in seconds (null = never synthesized).
- * @param depth - Meta tree depth.
- * @param emphasis - Scheduling emphasis multiplier.
- * @param depthWeight - Depth weighting exponent from config.
- * @returns Normalized score between 0 and 1.
- */
-function computeStalenessScore(stalenessSeconds, depth, emphasis, depthWeight) {
-    if (stalenessSeconds === null)
-        return 1;
-    const depthFactor = Math.pow(1 + depthWeight, depth);
-    return Math.min(1, (stalenessSeconds * depthFactor * emphasis) / (30 * 86400));
-}
-
 /**
  * Shared error utilities.
  *
@@ -10875,7 +10972,10 @@ function buildMetaRules(config) {
                 properties: {
                     file: {
                         properties: {
-                            path: { type: 'string', glob: '**/jeeves-meta.config.json' },
+                            path: {
+                                type: 'string',
+                                glob: '**/jeeves-meta{.config.json,/config.json}',
+                            },
                         },
                     },
                 },
@@ -12008,7 +12108,7 @@ class HttpWatcherClient {
             }
             // Exponential backoff
             const delayMs = this.backoffBaseMs * Math.pow(this.backoffFactor, attempt);
-            await sleep(delayMs);
+            await sleepAsync(delayMs);
         }
         // Unreachable, but TypeScript needs it
         throw new Error('Retry exhausted');
@@ -12264,4 +12364,4 @@ const metaDescriptor = jeevesComponentDescriptorSchema.parse({
     customCliCommands: registerCustomCliCommands,
 });
 
-export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, ProgressReporter, RESTART_REQUIRED_FIELDS, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaDescriptor, metaErrorSchema, metaJsonSchema, migrateConfigPath, normalizePath, orchestrate, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerCustomCliCommands, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, verifyRuleApplication };
+export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, MAX_STALENESS_SECONDS, ProgressReporter, RESTART_REQUIRED_FIELDS, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaDescriptor, metaErrorSchema, metaJsonSchema, migrateConfigPath, normalizePath, orchestrate, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerCustomCliCommands, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleepAsync as sleep, startService, toMetaError, verifyRuleApplication };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "author": "Jason Williscroft",
   "description": "Fastify HTTP service for the Jeeves Meta synthesis engine",
   "license": "BSD-3-Clause",
@@ -38,10 +38,10 @@
     "typescript"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.4.6",
+    "@karmaniverous/jeeves": "^0.5.1",
     "commander": "^14",
     "croner": "^10",
     "fastify": "^5.8",