@karmaniverous/jeeves-meta 0.1.0 → 0.2.1

package/dist/index.js

@@ -1,7 +1,7 @@
 import { readdirSync, unlinkSync, readFileSync, mkdirSync, writeFileSync, existsSync, statSync } from 'node:fs';
 import { join, dirname, relative, sep } from 'node:path';
-import { randomUUID, createHash } from 'node:crypto';
 import { z } from 'zod';
+import { randomUUID, createHash } from 'node:crypto';
 
 /**
  * List archive snapshot files in chronological order.
@@ -99,6 +99,201 @@ function createSnapshot(metaPath, meta) {
     return archiveFile;
 }
 
+/**
+ * Zod schema for jeeves-meta configuration.
+ *
+ * Consumers load config however they want (file, env, constructor).
+ * The library validates via this schema.
+ *
+ * @module schema/config
+ */
+/** Zod schema for jeeves-meta configuration. */
+const synthConfigSchema = z.object({
+    /** Filesystem paths to watch for .meta/ directories. */
+    watchPaths: z.array(z.string()).min(1),
+    /** Watcher service base URL. */
+    watcherUrl: z.url(),
+    /** OpenClaw gateway base URL for subprocess spawning. */
+    gatewayUrl: z.url().default('http://127.0.0.1:3000'),
+    /** Optional API key for gateway authentication. */
+    gatewayApiKey: z.string().optional(),
+    /** Run architect every N cycles (per meta). */
+    architectEvery: z.number().int().min(1).default(10),
+    /** Exponent for depth weighting in staleness formula. */
+    depthWeight: z.number().min(0).default(0.5),
+    /** Maximum archive snapshots to retain per meta. */
+    maxArchive: z.number().int().min(1).default(20),
+    /** Maximum lines of context to include in subprocess prompts. */
+    maxLines: z.number().int().min(50).default(500),
+    /** Architect subprocess timeout in seconds. */
+    architectTimeout: z.number().int().min(30).default(120),
+    /** Builder subprocess timeout in seconds. */
+    builderTimeout: z.number().int().min(60).default(600),
+    /** Critic subprocess timeout in seconds. */
+    criticTimeout: z.number().int().min(30).default(300),
+    /** Resolved architect system prompt text. */
+    defaultArchitect: z.string(),
+    /** Resolved critic system prompt text. */
+    defaultCritic: z.string(),
+    /**
+     * When true, skip unchanged candidates and iterate to the next-stalest
+     * until finding one with actual changes. Skipped candidates get their
+     * _generatedAt bumped to prevent re-selection next cycle.
+     */
+    skipUnchanged: z.boolean().default(true),
+    /** Number of metas to synthesize per invocation. */
+    batchSize: z.number().int().min(1).default(1),
+});
+
+/**
+ * Structured error from a synthesis step failure.
+ *
+ * @module schema/error
+ */
+/** Zod schema for synthesis step errors. */
+const synthErrorSchema = z.object({
+    /** Which step failed: 'architect', 'builder', or 'critic'. */
+    step: z.enum(['architect', 'builder', 'critic']),
+    /** Error classification code. */
+    code: z.string(),
+    /** Human-readable error message. */
+    message: z.string(),
+});
+
+/**
+ * Zod schema for .meta/meta.json files.
+ *
+ * Reserved properties are underscore-prefixed and engine-managed.
+ * All other keys are open schema (builder output).
+ *
+ * @module schema/meta
+ */
+/** Zod schema for the reserved (underscore-prefixed) meta.json properties. */
+const metaJsonSchema = z
+    .object({
+    /** Stable identity. Generated on first synthesis, never changes. */
+    _id: z.uuid(),
+    /** Human-provided steering prompt. Optional. */
+    _steer: z.string().optional(),
+    /** Architect system prompt used this turn. Defaults from config. */
+    _architect: z.string().optional(),
+    /**
+     * Task brief generated by the architect. Cached and reused across cycles;
+     * regenerated only when triggered.
+     */
+    _builder: z.string().optional(),
+    /** Critic system prompt used this turn. Defaults from config. */
+    _critic: z.string().optional(),
+    /** Timestamp of last synthesis. ISO 8601. */
+    _generatedAt: z.iso.datetime().optional(),
+    /** Narrative synthesis output. Rendered by watcher for embedding. */
+    _content: z.string().optional(),
+    /**
+     * Hash of sorted file listing in scope. Detects directory structure
+     * changes that trigger an architect re-run.
+     */
+    _structureHash: z.string().optional(),
+    /**
+     * Cycles since last architect run. Reset to 0 when architect runs.
+     * Used with architectEvery to trigger periodic re-prompting.
+     */
+    _synthesisCount: z.number().int().min(0).optional(),
+    /** Critic evaluation of the last synthesis. */
+    _feedback: z.string().optional(),
+    /**
+     * Present and true on archive snapshots. Distinguishes live vs. archived
+     * metas.
+     */
+    _archived: z.boolean().optional(),
+    /** Timestamp when this snapshot was archived. ISO 8601. */
+    _archivedAt: z.iso.datetime().optional(),
+    /**
+     * Scheduling priority. Higher = updates more often. Negative allowed;
+     * normalized to min 0 at scheduling time.
+     */
+    _depth: z.number().optional(),
+    /**
+     * Emphasis multiplier for depth weighting in scheduling.
+     * Default 1. Higher values increase this meta's scheduling priority
+     * relative to its depth. Set to 0.5 to halve the depth effect,
+     * 2 to double it, 0 to ignore depth entirely for this meta.
+     */
+    _emphasis: z.number().min(0).optional(),
+    /** Token count from last architect subprocess call. */
+    _architectTokens: z.number().int().optional(),
+    /** Token count from last builder subprocess call. */
+    _builderTokens: z.number().int().optional(),
+    /** Token count from last critic subprocess call. */
+    _criticTokens: z.number().int().optional(),
+    /** Exponential moving average of architect token usage (decay 0.3). */
+    _architectTokensAvg: z.number().optional(),
+    /** Exponential moving average of builder token usage (decay 0.3). */
+    _builderTokensAvg: z.number().optional(),
+    /** Exponential moving average of critic token usage (decay 0.3). */
+    _criticTokensAvg: z.number().optional(),
+    /**
+     * Structured error from last cycle. Present when a step failed.
+     * Cleared on successful cycle.
+     */
+    _error: synthErrorSchema.optional(),
+})
+    .loose();
+
+/**
+ * Load and resolve jeeves-meta config with \@file: indirection.
+ *
+ * @module configLoader
+ */
+/**
+ * Resolve \@file: references in a config value.
+ *
+ * @param value - String value that may start with "\@file:".
+ * @param baseDir - Base directory for resolving relative paths.
+ * @returns The resolved string (file contents or original value).
+ */
+function resolveFileRef(value, baseDir) {
+    if (!value.startsWith('@file:'))
+        return value;
+    const filePath = join(baseDir, value.slice(6));
+    return readFileSync(filePath, 'utf8');
+}
+/**
+ * Load synth config from a JSON file, resolving \@file: references.
+ *
+ * @param configPath - Path to jeeves-meta.config.json.
+ * @returns Validated SynthConfig with resolved prompt strings.
+ */
+function loadSynthConfig(configPath) {
+    const raw = JSON.parse(readFileSync(configPath, 'utf8'));
+    const baseDir = dirname(configPath);
+    if (typeof raw.defaultArchitect === 'string') {
+        raw.defaultArchitect = resolveFileRef(raw.defaultArchitect, baseDir);
+    }
+    if (typeof raw.defaultCritic === 'string') {
+        raw.defaultCritic = resolveFileRef(raw.defaultCritic, baseDir);
+    }
+    return synthConfigSchema.parse(raw);
+}
+/**
+ * Resolve config path from --config flag or JEEVES_META_CONFIG env var.
+ *
+ * @param args - CLI arguments (process.argv.slice(2)).
+ * @returns Resolved config path.
+ * @throws If no config path found.
+ */
+function resolveConfigPath(args) {
+    // Check --config flag
+    const configIdx = args.indexOf('--config');
+    if (configIdx !== -1 && args[configIdx + 1]) {
+        return args[configIdx + 1];
+    }
+    // Check env var
+    const envPath = process.env['JEEVES_META_CONFIG'];
+    if (envPath)
+        return envPath;
+    throw new Error('Config path required. Use --config <path> or set JEEVES_META_CONFIG env var.');
+}
+
 /**
  * Ensure meta.json exists in each .meta/ directory.
  *
@@ -243,6 +438,16 @@ function buildOwnershipTree(metaPaths) {
     }
     return { nodes, roots };
 }
+/**
+ * Find a node in the ownership tree by meta path or owner path.
+ *
+ * @param tree - The ownership tree to search.
+ * @param targetPath - Path to search for (meta path or owner path).
+ * @returns The matching node, or undefined if not found.
+ */
+function findNode(tree, targetPath) {
+    return Array.from(tree.nodes.values()).find((n) => n.metaPath === targetPath || n.ownerPath === targetPath);
+}
 
 /**
  * Compute the file scope owned by a meta node.
@@ -379,12 +584,6 @@ function condenseScopeFiles(files, maxIndividual = 30) {
         .map(([pattern, count]) => pattern + ' (' + count.toString() + ' files)')
         .join('\n');
 }
-/** Filter files to exclude child meta subtrees. */
-function excludeChildSubtrees(files, childPrefixes) {
-    if (childPrefixes.length === 0)
-        return files;
-    return files.filter((f) => childPrefixes.every((cp) => !f.startsWith(cp)));
-}
 /**
  * Build the context package for a synthesis cycle.
  *
@@ -394,13 +593,11 @@ function excludeChildSubtrees(files, childPrefixes) {
  * @returns The computed context package.
  */
 async function buildContextPackage(node, meta, watcher) {
-    const childPrefixes = node.children.map((c) => c.ownerPath + '/');
     // Scope files via watcher scan, excluding child subtrees
     const allScanFiles = await paginatedScan(watcher, {
         pathPrefix: node.ownerPath,
     });
-    const allFiles = allScanFiles.map((f) => f.file_path);
-    const scopeFiles = excludeChildSubtrees(allFiles, childPrefixes);
+    const scopeFiles = filterInScope(node, allScanFiles.map((f) => f.file_path));
     // Delta files: modified since _generatedAt
     let deltaFiles;
     if (meta._generatedAt) {
@@ -409,7 +606,7 @@ async function buildContextPackage(node, meta, watcher) {
             pathPrefix: node.ownerPath,
             modifiedAfter,
         });
-        deltaFiles = excludeChildSubtrees(deltaScanFiles.map((f) => f.file_path), childPrefixes);
+        deltaFiles = filterInScope(node, deltaScanFiles.map((f) => f.file_path));
     }
     else {
         deltaFiles = scopeFiles; // First run: all files are delta
@@ -555,142 +752,6 @@ function buildCriticTask(ctx, meta, config) {
     return sections.join('\n');
 }
 
-/**
- * Zod schema for jeeves-meta configuration.
- *
- * Consumers load config however they want (file, env, constructor).
- * The library validates via this schema.
- *
- * @module schema/config
- */
-/** Zod schema for jeeves-meta configuration. */
-const synthConfigSchema = z.object({
-    /** Filesystem paths to watch for .meta/ directories. */
-    watchPaths: z.array(z.string()).min(1),
-    /** Watcher service base URL. */
-    watcherUrl: z.url(),
-    /** Run architect every N cycles (per meta). */
-    architectEvery: z.number().int().min(1).default(10),
-    /** Exponent for depth weighting in staleness formula. */
-    depthWeight: z.number().min(0).default(0.5),
-    /** Maximum archive snapshots to retain per meta. */
-    maxArchive: z.number().int().min(1).default(20),
-    /** Maximum lines of context to include in subprocess prompts. */
-    maxLines: z.number().int().min(50).default(500),
-    /** Architect subprocess timeout in seconds. */
-    architectTimeout: z.number().int().min(30).default(120),
-    /** Builder subprocess timeout in seconds. */
-    builderTimeout: z.number().int().min(60).default(600),
-    /** Critic subprocess timeout in seconds. */
-    criticTimeout: z.number().int().min(30).default(300),
-    /** Resolved architect system prompt text. */
-    defaultArchitect: z.string(),
-    /** Resolved critic system prompt text. */
-    defaultCritic: z.string(),
-    /**
-     * When true, skip unchanged candidates and iterate to the next-stalest
-     * until finding one with actual changes. Skipped candidates get their
-     * _generatedAt bumped to prevent re-selection next cycle.
-     */
-    skipUnchanged: z.boolean().default(true),
-    /** Number of metas to synthesize per invocation. */
-    batchSize: z.number().int().min(1).default(1),
-});
-
-/**
- * Structured error from a synthesis step failure.
- *
- * @module schema/error
- */
-/** Zod schema for synthesis step errors. */
-const synthErrorSchema = z.object({
-    /** Which step failed: 'architect', 'builder', or 'critic'. */
-    step: z.enum(['architect', 'builder', 'critic']),
-    /** Error classification code. */
-    code: z.string(),
-    /** Human-readable error message. */
-    message: z.string(),
-});
-
-/**
- * Zod schema for .meta/meta.json files.
- *
- * Reserved properties are underscore-prefixed and engine-managed.
- * All other keys are open schema (builder output).
- *
- * @module schema/meta
- */
-/** Zod schema for the reserved (underscore-prefixed) meta.json properties. */
-const metaJsonSchema = z
-    .object({
-    /** Stable identity. Generated on first synthesis, never changes. */
-    _id: z.uuid(),
-    /** Human-provided steering prompt. Optional. */
-    _steer: z.string().optional(),
-    /** Architect system prompt used this turn. Defaults from config. */
-    _architect: z.string().optional(),
-    /**
-     * Task brief generated by the architect. Cached and reused across cycles;
-     * regenerated only when triggered.
-     */
-    _builder: z.string().optional(),
-    /** Critic system prompt used this turn. Defaults from config. */
-    _critic: z.string().optional(),
-    /** Timestamp of last synthesis. ISO 8601. */
-    _generatedAt: z.iso.datetime().optional(),
-    /** Narrative synthesis output. Rendered by watcher for embedding. */
-    _content: z.string().optional(),
-    /**
-     * Hash of sorted file listing in scope. Detects directory structure
-     * changes that trigger an architect re-run.
-     */
-    _structureHash: z.string().optional(),
-    /**
-     * Cycles since last architect run. Reset to 0 when architect runs.
-     * Used with architectEvery to trigger periodic re-prompting.
-     */
-    _synthesisCount: z.number().int().min(0).optional(),
-    /** Critic evaluation of the last synthesis. */
-    _feedback: z.string().optional(),
-    /**
-     * Present and true on archive snapshots. Distinguishes live vs. archived
-     * metas.
-     */
-    _archived: z.boolean().optional(),
-    /** Timestamp when this snapshot was archived. ISO 8601. */
-    _archivedAt: z.iso.datetime().optional(),
-    /**
-     * Scheduling priority. Higher = updates more often. Negative allowed;
-     * normalized to min 0 at scheduling time.
-     */
-    _depth: z.number().optional(),
-    /**
-     * Emphasis multiplier for depth weighting in scheduling.
-     * Default 1. Higher values increase this meta's scheduling priority
-     * relative to its depth. Set to 0.5 to halve the depth effect,
-     * 2 to double it, 0 to ignore depth entirely for this meta.
-     */
-    _emphasis: z.number().min(0).optional(),
-    /** Token count from last architect subprocess call. */
-    _architectTokens: z.number().int().optional(),
-    /** Token count from last builder subprocess call. */
-    _builderTokens: z.number().int().optional(),
-    /** Token count from last critic subprocess call. */
-    _criticTokens: z.number().int().optional(),
-    /** Exponential moving average of architect token usage (decay 0.3). */
-    _architectTokensAvg: z.number().optional(),
-    /** Exponential moving average of builder token usage (decay 0.3). */
-    _builderTokensAvg: z.number().optional(),
-    /** Exponential moving average of critic token usage (decay 0.3). */
-    _criticTokensAvg: z.number().optional(),
-    /**
-     * Structured error from last cycle. Present when a step failed.
-     * Cleared on successful cycle.
-     */
-    _error: synthErrorSchema.optional(),
-})
-    .loose();
-
 /**
  * Merge synthesis results into meta.json.
  *
@@ -874,6 +935,25 @@ function isLocked(metaPath) {
     }
 }
 
+/**
+ * Normalize file paths to forward slashes for consistency with watcher-indexed paths.
+ *
+ * Watcher indexes paths with forward slashes (`j:/domains/...`). This utility
+ * ensures all paths in the library use the same convention, regardless of
+ * the platform's native separator.
+ *
+ * @module normalizePath
+ */
+/**
+ * Normalize a file path to forward slashes.
+ *
+ * @param p - File path (may contain backslashes).
+ * @returns Path with all backslashes replaced by forward slashes.
+ */
+function normalizePath(p) {
+    return p.replaceAll('\\', '/');
+}
+
 /**
  * Select the best synthesis candidate from stale metas.
  *
@@ -937,6 +1017,34 @@ function actualStaleness(meta) {
     const generatedMs = new Date(meta._generatedAt).getTime();
     return (Date.now() - generatedMs) / 1000;
 }
+/**
+ * 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;
+}
 
 /**
  * Weighted staleness formula for candidate selection.
@@ -1070,10 +1178,6 @@ function parseCriticOutput(output) {
  *
  * @module orchestrator/orchestrate
  */
-/** Normalize path separators to forward slashes. */
-function normalizePath(p) {
-    return p.replaceAll('\\', '/');
-}
 /** Finalize a cycle: merge, snapshot, prune. */
 function finalizeCycle(metaPath, current, config, architect, builder, critic, builderOutput, feedback, structureHash, synthesisCount, error, architectTokens, builderTokens, criticTokens) {
     const updated = mergeAndWrite({
@@ -1172,16 +1276,11 @@ async function orchestrateOnce(config, executor, watcher) {
         const structureChanged = newStructureHash !== currentMeta._structureHash;
         // Step 6: Steer change detection
         const latestArchive = readLatestArchive(node.metaPath);
-        const steerChanged = latestArchive
-            ? currentMeta._steer !== latestArchive._steer
-            : Boolean(currentMeta._steer);
+        const steerChanged = hasSteerChanged(currentMeta._steer, latestArchive?._steer, Boolean(latestArchive));
         // Step 7: Compute context
         const ctx = await buildContextPackage(node, currentMeta, watcher);
         // Step 8: Architect (conditional)
-        const architectTriggered = !currentMeta._builder ||
-            structureChanged ||
-            steerChanged ||
-            (currentMeta._synthesisCount ?? 0) >= config.architectEvery;
+        const architectTriggered = isArchitectTriggered(currentMeta, structureChanged, steerChanged, config.architectEvery);
         let builderBrief = currentMeta._builder ?? '';
         let synthesisCount = currentMeta._synthesisCount ?? 0;
         let stepError = null;
@@ -1307,6 +1406,108 @@ function createSynthEngine(config, executor, watcher) {
     };
 }
 
+/**
+ * SynthExecutor implementation using the OpenClaw gateway HTTP API.
+ *
+ * Lives in the library package so both plugin and runner can import it.
+ * Spawns sub-agent sessions via the gateway, polls for completion,
+ * and extracts output text.
+ *
+ * @module executor/GatewayExecutor
+ */
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_TIMEOUT_MS = 600_000; // 10 minutes
+/** Sleep helper. */
+function sleep$1(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * SynthExecutor that spawns OpenClaw sessions via the gateway HTTP API.
+ *
+ * Used by both the OpenClaw plugin (in-process tool calls) and the
+ * runner/CLI (external invocation). Constructs from `gatewayUrl` and
+ * optional `apiKey` — typically sourced from `SynthConfig`.
+ */
+class GatewayExecutor {
+    gatewayUrl;
+    apiKey;
+    pollIntervalMs;
+    constructor(options = {}) {
+        this.gatewayUrl = (options.gatewayUrl ?? 'http://127.0.0.1:3000').replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    }
+    async spawn(task, options) {
+        const timeoutMs = (options?.timeout ?? DEFAULT_TIMEOUT_MS / 1000) * 1000;
+        const deadline = Date.now() + timeoutMs;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = 'Bearer ' + this.apiKey;
+        }
+        const spawnRes = await fetch(this.gatewayUrl + '/api/sessions/spawn', {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                task,
+                mode: 'run',
+                model: options?.model,
+                runTimeoutSeconds: options?.timeout,
+            }),
+        });
+        if (!spawnRes.ok) {
+            const text = await spawnRes.text();
+            throw new Error('Gateway spawn failed: HTTP ' +
+                spawnRes.status.toString() +
+                ' - ' +
+                text);
+        }
+        const spawnData = (await spawnRes.json());
+        if (!spawnData.sessionKey) {
+            throw new Error('Gateway spawn returned no sessionKey: ' + JSON.stringify(spawnData));
+        }
+        const { sessionKey } = spawnData;
+        // Poll for completion
+        while (Date.now() < deadline) {
+            await sleep$1(this.pollIntervalMs);
+            const historyRes = await fetch(this.gatewayUrl +
+                '/api/sessions/' +
+                encodeURIComponent(sessionKey) +
+                '/history?limit=50', { headers });
+            if (!historyRes.ok)
+                continue;
+            const history = (await historyRes.json());
+            if (history.status === 'completed' || history.status === 'done') {
+                // Extract token usage from session-level or message-level usage
+                let tokens;
+                if (history.usage?.totalTokens) {
+                    tokens = history.usage.totalTokens;
+                }
+                else {
+                    // Sum message-level usage as fallback
+                    let sum = 0;
+                    for (const msg of history.messages ?? []) {
+                        if (msg.usage?.totalTokens)
+                            sum += msg.usage.totalTokens;
+                    }
+                    if (sum > 0)
+                        tokens = sum;
+                }
+                // Extract the last assistant message as output
+                const messages = history.messages ?? [];
+                for (let i = messages.length - 1; i >= 0; i--) {
+                    if (messages[i].role === 'assistant' && messages[i].content) {
+                        return { output: messages[i].content, tokens };
+                    }
+                }
+                return { output: '', tokens };
+            }
+        }
+        throw new Error('Synthesis subprocess timed out after ' + timeoutMs.toString() + 'ms');
+    }
+}
+
 /**
  * HTTP implementation of the WatcherClient interface.
  *
@@ -1365,9 +1566,13 @@ class HttpWatcherClient {
         throw new Error('Retry exhausted');
     }
     async scan(params) {
-        const body = {
-            pathPrefix: params.pathPrefix,
-        };
+        const body = {};
+        if (params.pathPrefix !== undefined) {
+            body.pathPrefix = params.pathPrefix;
+        }
+        if (params.filter !== undefined) {
+            body.filter = params.filter;
+        }
         if (params.modifiedAfter !== undefined) {
             body.modifiedAfter = params.modifiedAfter;
         }
@@ -1391,4 +1596,4 @@ class HttpWatcherClient {
     }
 }
 
-export { HttpWatcherClient, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, computeEffectiveStaleness, computeEma, computeStructureHash, createSnapshot, createSynthEngine, ensureMetaJson, filterInScope, getScopeExclusions, getScopePrefix, globMetas, isLocked, isStale, listArchiveFiles, mergeAndWrite, metaJsonSchema, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, releaseLock, selectCandidate, synthConfigSchema, synthErrorSchema, toSynthError };
+export { GatewayExecutor, HttpWatcherClient, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildOwnershipTree, computeEffectiveStaleness, computeEma, computeStructureHash, createSnapshot, createSynthEngine, ensureMetaJson, filterInScope, findNode, getScopeExclusions, getScopePrefix, globMetas, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, loadSynthConfig, mergeAndWrite, metaJsonSchema, normalizePath, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, releaseLock, resolveConfigPath, selectCandidate, synthConfigSchema, synthErrorSchema, toSynthError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "author": "Jason Williscroft",
   "description": "Knowledge synthesis engine for the Jeeves platform",
   "license": "BSD-3-Clause",
@@ -107,5 +107,8 @@
     "npm": {
       "publish": true
     }
+  },
+  "bin": {
+    "jeeves-meta": "dist/cli.js"
   }
 }