@karmaniverous/jeeves-meta 0.4.1 → 0.4.2

package/dist/cli/jeeves-meta/index.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { readFileSync, readdirSync, unlinkSync, mkdirSync, writeFileSync, existsSync, statSync, copyFileSync, watchFile } from 'node:fs';
-import { dirname, join, relative } from 'node:path';
+import { dirname, join, resolve, relative } from 'node:path';
 import { z } from 'zod';
+import { fileURLToPath } from 'node:url';
 import { createHash, randomUUID } from 'node:crypto';
+import { tmpdir } from 'node:os';
 import pino from 'pino';
 import { Cron } from 'croner';
 import Fastify from 'fastify';
@@ -166,6 +168,42 @@ var configLoader = /*#__PURE__*/Object.freeze({
     resolveConfigPath: resolveConfigPath
 });
 
+/**
+ * Shared constants for the jeeves-meta service package.
+ *
+ * @module constants
+ */
+/** Default HTTP port for the jeeves-meta service. */
+const DEFAULT_PORT = 1938;
+/** Default port as a string (for Commander CLI defaults). */
+const DEFAULT_PORT_STR = String(DEFAULT_PORT);
+/** Service name identifier. */
+const SERVICE_NAME = 'jeeves-meta';
+/** Service version, read from package.json at startup. */
+const SERVICE_VERSION = (() => {
+    try {
+        const dir = dirname(fileURLToPath(import.meta.url));
+        // Walk up to find package.json (works from src/ or dist/)
+        for (const candidate of [
+            resolve(dir, '..', 'package.json'),
+            resolve(dir, '..', '..', 'package.json'),
+        ]) {
+            try {
+                const pkg = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                // try next candidate
+            }
+        }
+        return 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+})();
+
 /**
  * List archive snapshot files in chronological order.
  *
@@ -962,7 +1000,7 @@ class GatewayExecutor {
         this.gatewayUrl = (options.gatewayUrl ?? 'http://127.0.0.1:18789').replace(/\/+$/, '');
         this.apiKey = options.apiKey;
         this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-        this.workspaceDir = options.workspaceDir ?? 'J:\\jeeves\\jeeves-meta';
+        this.workspaceDir = options.workspaceDir ?? join(tmpdir(), 'jeeves-meta');
     }
     /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
     async invoke(tool, args) {
@@ -2930,8 +2968,8 @@ function registerStatusRoute(app, deps) {
         // Metas summary is expensive (paginated watcher scan + disk reads).
         // Use GET /metas for full inventory; status is a lightweight health check.
         return {
-            service: 'jeeves-meta',
-            version: '0.4.0',
+            service: SERVICE_NAME,
+            version: SERVICE_VERSION,
             uptime: process.uptime(),
             status,
             currentTarget: queue.current?.path ?? null,
@@ -3153,7 +3191,7 @@ function buildMetaRules(config) {
                 },
             ],
             render: {
-                frontmatter: ['meta_id', 'generated_at', '*', '!has_error'],
+                frontmatter: ['meta_id', 'generated_at', '*', '!_*', '!has_error'],
                 body: [{ path: 'json._content', heading: 1, label: 'Synthesis' }],
             },
             renderAs: 'md',
@@ -3670,7 +3708,7 @@ async function startService(config, configPath) {
  * @module cli
  */
 const program = new Command();
-program.name('jeeves-meta').description('Jeeves Meta synthesis service');
+program.name(SERVICE_NAME).description('Jeeves Meta synthesis service');
 // ─── start ──────────────────────────────────────────────────────────
 program
     .command('start')
@@ -3709,7 +3747,7 @@ async function apiPost(port, path, body) {
 program
     .command('status')
     .description('Show service status')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (opts) => {
     try {
         const data = await apiGet(parseInt(opts.port, 10), '/status');
@@ -3724,7 +3762,7 @@ program
 program
     .command('list')
     .description('List all discovered meta entities')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (opts) => {
     try {
         const data = await apiGet(parseInt(opts.port, 10), '/metas');
@@ -3739,7 +3777,7 @@ program
 program
     .command('detail <path>')
     .description('Show full detail for a single meta entity')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (metaPath, opts) => {
     try {
         const encoded = encodeURIComponent(metaPath);
@@ -3755,7 +3793,7 @@ program
 program
     .command('preview')
     .description('Dry-run: preview inputs for next synthesis cycle')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .option('--path <path>', 'Specific meta path to preview')
     .action(async (opts) => {
     try {
@@ -3772,7 +3810,7 @@ program
 program
     .command('synthesize')
     .description('Trigger synthesis (enqueues work)')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .option('--path <path>', 'Specific meta path to synthesize')
     .action(async (opts) => {
     try {
@@ -3789,7 +3827,7 @@ program
 program
     .command('seed <path>')
     .description('Create .meta/ directory + meta.json for a path')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (metaPath, opts) => {
     try {
         const data = await apiPost(parseInt(opts.port, 10), '/seed', {
@@ -3806,7 +3844,7 @@ program
 program
     .command('unlock <path>')
     .description('Remove .lock file from a meta entity')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (metaPath, opts) => {
     try {
         const data = await apiPost(parseInt(opts.port, 10), '/unlock', {
@@ -3823,7 +3861,7 @@ program
 program
     .command('validate')
     .description('Validate current or candidate config')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .option('-c, --config <path>', 'Validate a candidate config file locally')
     .action(async (opts) => {
     try {
@@ -3959,7 +3997,7 @@ service.addCommand(new Command('stop')
 // status command (service subcommand — queries HTTP API)
 service.addCommand(new Command('status')
     .description('Show service status via HTTP API')
-    .option('-p, --port <port>', 'Service port', '1938')
+    .option('-p, --port <port>', 'Service port', DEFAULT_PORT_STR)
     .action(async (opts) => {
     try {
         const data = await apiGet(parseInt(opts.port, 10), '/status');

package/dist/index.d.ts

@@ -185,6 +185,20 @@ declare function readLatestArchive(metaPath: string): MetaJson | null;
  */
 declare function createSnapshot(metaPath: string, meta: MetaJson): string;
 
+/**
+ * Shared constants for the jeeves-meta service package.
+ *
+ * @module constants
+ */
+/** Default HTTP port for the jeeves-meta service. */
+declare const DEFAULT_PORT = 1938;
+/** Default port as a string (for Commander CLI defaults). */
+declare const DEFAULT_PORT_STR: string;
+/** Service name identifier. */
+declare const SERVICE_NAME = "jeeves-meta";
+/** Service version, read from package.json at startup. */
+declare const SERVICE_VERSION: string;
+
 /**
  * Load and resolve jeeves-meta service config.
  *
@@ -778,7 +792,7 @@ interface GatewayExecutorOptions {
     apiKey?: string;
     /** Polling interval in ms. Default: 5000. */
     pollIntervalMs?: number;
-    /** Workspace directory for output staging. Default: J:\\jeeves\\jeeves-meta */
+    /** Workspace directory for output staging. Default: OS temp dir + /jeeves-meta. */
     workspaceDir?: string;
 }
 /**
@@ -1445,5 +1459,5 @@ declare function registerShutdownHandlers(deps: ShutdownDeps): void;
  */
 declare function startService(config: ServiceConfig, configPath?: string): Promise<void>;
 
-export { GatewayExecutor, HttpWatcherClient, ProgressReporter, RuleRegistrar, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildMetaFilter, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaErrorSchema, metaJsonSchema, normalizePath, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, walkFiles };
+export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, ProgressReporter, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildMetaFilter, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaErrorSchema, metaJsonSchema, normalizePath, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, walkFiles };
 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, ScanFile, ScanParams, ScanResponse, ServerOptions, ServiceConfig, ServiceStats, StalenessCandidate, WatcherClient };

package/dist/index.js

@@ -1,7 +1,9 @@
 import { readdirSync, unlinkSync, readFileSync, mkdirSync, writeFileSync, existsSync, statSync, copyFileSync, watchFile } from 'node:fs';
-import { join, dirname, relative } from 'node:path';
+import { join, dirname, resolve, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { z } from 'zod';
 import { createHash, randomUUID } from 'node:crypto';
+import { tmpdir } from 'node:os';
 import pino from 'pino';
 import { Cron } from 'croner';
 import Fastify from 'fastify';
@@ -102,6 +104,42 @@ function createSnapshot(metaPath, meta) {
     return archiveFile;
 }
 
+/**
+ * Shared constants for the jeeves-meta service package.
+ *
+ * @module constants
+ */
+/** Default HTTP port for the jeeves-meta service. */
+const DEFAULT_PORT = 1938;
+/** Default port as a string (for Commander CLI defaults). */
+const DEFAULT_PORT_STR = String(DEFAULT_PORT);
+/** Service name identifier. */
+const SERVICE_NAME = 'jeeves-meta';
+/** Service version, read from package.json at startup. */
+const SERVICE_VERSION = (() => {
+    try {
+        const dir = dirname(fileURLToPath(import.meta.url));
+        // Walk up to find package.json (works from src/ or dist/)
+        for (const candidate of [
+            resolve(dir, '..', 'package.json'),
+            resolve(dir, '..', '..', 'package.json'),
+        ]) {
+            try {
+                const pkg = JSON.parse(readFileSync(candidate, 'utf8'));
+                if (pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                // try next candidate
+            }
+        }
+        return 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+})();
+
 /**
  * Zod schema for jeeves-meta service configuration.
  *
@@ -954,7 +992,7 @@ class GatewayExecutor {
         this.gatewayUrl = (options.gatewayUrl ?? 'http://127.0.0.1:18789').replace(/\/+$/, '');
         this.apiKey = options.apiKey;
         this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-        this.workspaceDir = options.workspaceDir ?? 'J:\\jeeves\\jeeves-meta';
+        this.workspaceDir = options.workspaceDir ?? join(tmpdir(), 'jeeves-meta');
     }
     /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
     async invoke(tool, args) {
@@ -2926,8 +2964,8 @@ function registerStatusRoute(app, deps) {
         // Metas summary is expensive (paginated watcher scan + disk reads).
         // Use GET /metas for full inventory; status is a lightweight health check.
         return {
-            service: 'jeeves-meta',
-            version: '0.4.0',
+            service: SERVICE_NAME,
+            version: SERVICE_VERSION,
             uptime: process.uptime(),
             status,
             currentTarget: queue.current?.path ?? null,
@@ -3149,7 +3187,7 @@ function buildMetaRules(config) {
                 },
             ],
             render: {
-                frontmatter: ['meta_id', 'generated_at', '*', '!has_error'],
+                frontmatter: ['meta_id', 'generated_at', '*', '!_*', '!has_error'],
                 body: [{ path: 'json._content', heading: 1, label: 'Synthesis' }],
             },
             renderAs: 'md',
@@ -3660,4 +3698,4 @@ async function startService(config, configPath) {
     logger.info('Service fully initialized');
 }
 
-export { GatewayExecutor, HttpWatcherClient, ProgressReporter, RuleRegistrar, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildMetaFilter, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaErrorSchema, metaJsonSchema, normalizePath, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, walkFiles };
+export { DEFAULT_PORT, DEFAULT_PORT_STR, GatewayExecutor, HttpWatcherClient, ProgressReporter, RuleRegistrar, SERVICE_NAME, SERVICE_VERSION, Scheduler, SynthesisQueue, acquireLock, actualStaleness, buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, buildMetaFilter, buildOwnershipTree, cleanupStaleLocks, computeEffectiveStaleness, computeEma, computeStructureHash, createLogger, createServer, createSnapshot, discoverMetas, filterInScope, findNode, formatProgressEvent, getScopePrefix, hasSteerChanged, isArchitectTriggered, isLocked, isStale, listArchiveFiles, listMetas, loadServiceConfig, mergeAndWrite, metaConfigSchema, metaErrorSchema, metaJsonSchema, normalizePath, orchestrate, paginatedScan, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, pruneArchive, readLatestArchive, readLockState, registerRoutes, registerShutdownHandlers, releaseLock, resolveConfigPath, resolveMetaDir, selectCandidate, serviceConfigSchema, sleep, startService, toMetaError, walkFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "author": "Jason Williscroft",
   "description": "Fastify HTTP service for the Jeeves Meta synthesis engine",
   "license": "BSD-3-Clause",