@karmaniverous/jeeves-meta 0.12.2 → 0.12.4

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

@@ -7007,15 +7007,48 @@ function packageDirectorySync({cwd, ignoreTypeOnlyPackageJson} = {}) {
 	return findPackageDirectorySync(cwd ?? process$1.cwd(), ignoreTypeOnlyPackageJson);
 }
 
+/**
+ * Directory and file path conventions for the Jeeves platform.
+ */
+/** Core config directory name within the config root. */
+const CORE_CONFIG_DIR = 'jeeves-core';
+/** Prefix for component config directories: `jeeves-{name}`. */
+const COMPONENT_CONFIG_PREFIX = 'jeeves-';
 /** Core config file name. */
 const CONFIG_FILE = 'config.json';
+
+/**
+ * Workspace and config root initialization.
+ *
+ * @remarks
+ * `init()` must be called once before any other core library functions.
+ * It caches `workspacePath` and `configRoot` at module level.
+ * Core derives all namespaced paths from these values:
+ * - `{configRoot}/jeeves-core/` for core config
+ * - `{configRoot}/jeeves-{name}/` for each component
+ */
+let state;
+/**
+ * Initialize the core library with workspace and config root paths.
+ *
+ * @param options - Workspace and config root paths.
+ */
+function init(options) {
+    state = {
+        workspacePath: options.workspacePath,
+        configRoot: options.configRoot,
+        coreConfigDir: join(options.configRoot, CORE_CONFIG_DIR),
+    };
+}
 /**
  * Get the core config directory path.
  *
  * @throws Error if `init()` has not been called.
  */
 function getCoreConfigDir() {
-    throw new Error('jeeves-core: init() must be called first');
+    if (!state)
+        throw new Error('jeeves-core: init() must be called first');
+    return state.coreConfigDir;
 }
 /**
  * Derive the component config directory from the component name.
@@ -7025,7 +7058,9 @@ function getCoreConfigDir() {
  * @throws Error if `init()` has not been called.
  */
 function getComponentConfigDir(componentName) {
-    throw new Error('jeeves-core: init() must be called first');
+    if (!state)
+        throw new Error('jeeves-core: init() must be called first');
+    return join(state.configRoot, `${COMPONENT_CONFIG_PREFIX}${componentName}`);
 }
 /**
  * Write content to a file atomically via a temp file + rename.
@@ -7901,6 +7936,19 @@ function createServiceManager(descriptor) {
     }
 }
 
+/**
+ * Shared CLI defaults and option registration for Jeeves CLI commands.
+ *
+ * @remarks
+ * All three CLI commands (install, uninstall, status) share the same
+ * `--workspace` and `--config-root` options with the same defaults.
+ * This module centralizes them to eliminate duplication.
+ */
+/** Default workspace path (current directory). */
+const DEFAULT_WORKSPACE = '.';
+/** Default config root path. */
+const DEFAULT_CONFIG_ROOT = './config';
+
 /**
  * Factory for the standard Jeeves service CLI.
  *
@@ -7943,7 +7991,10 @@ function createServiceCli(descriptor) {
         .command('start')
         .description('Launch the service process (foreground)')
         .requiredOption('-c, --config <path>', 'Config file path')
+        .option('-w, --workspace <path>', 'Workspace root path', DEFAULT_WORKSPACE)
+        .option('--config-root <path>', 'Platform config root path', DEFAULT_CONFIG_ROOT)
         .action(async (opts) => {
+        init({ workspacePath: opts.workspace, configRoot: opts.configRoot });
         await descriptor.run(opts.config);
     });
     // --- status ---
@@ -8251,7 +8302,7 @@ function loadConfig(configDir) {
 function getBindAddress(componentName) {
     // Tier 1: Component config (if provided)
     {
-        const componentConfig = loadConfig(getComponentConfigDir());
+        const componentConfig = loadConfig(getComponentConfigDir(componentName));
         if (componentConfig?.bindAddress) {
             return componentConfig.bindAddress;
         }
@@ -10168,7 +10219,11 @@ async function isStale(scopePrefix, meta, watcher) {
     if (!meta._generatedAt)
         return true; // Never synthesized = stale
     const files = await watcher.walk([`${escapeGlob(scopePrefix)}/**`]);
-    return hasModifiedAfter(files, new Date(meta._generatedAt).getTime());
+    // 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;
@@ -12536,7 +12591,7 @@ async function startService(config, configPath) {
         deps: routeDeps,
     });
     // Start HTTP server
-    const bindAddress = getBindAddress();
+    const bindAddress = getBindAddress('meta');
     try {
         await server.listen({ port: config.port, host: bindAddress });
         logger.info({ port: config.port, host: bindAddress }, 'Service listening');

package/dist/index.js

@@ -9744,7 +9744,11 @@ async function isStale(scopePrefix, meta, watcher) {
     if (!meta._generatedAt)
         return true; // Never synthesized = stale
     const files = await watcher.walk([`${escapeGlob(scopePrefix)}/**`]);
-    return hasModifiedAfter(files, new Date(meta._generatedAt).getTime());
+    // 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;

package/package.json

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