@karmaniverous/jeeves 0.4.4 → 0.4.6

package/dist/cli/jeeves/index.js

@@ -261,14 +261,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.3` placeholder is replaced by
+ * The `0.4.5` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.4.3';
+const CORE_VERSION = '0.4.5';
 
 /**
  * Dynamic discovery of installed Jeeves component CLIs.

package/dist/cli/plugin/index.js

@@ -119,14 +119,14 @@ const COMPONENT_VERSIONS_FILE = 'component-versions.json';
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.3` placeholder is replaced by
+ * The `0.4.5` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.4.3';
+const CORE_VERSION = '0.4.5';
 
 /**
  * Shared file I/O helpers for managed section operations.

package/dist/cli/service/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { execSync, spawn } from 'node:child_process';
 import { existsSync, unlinkSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import * as commander from 'commander';
 import { z } from 'zod';
+import { execSync } from 'node:child_process';
 import { homedir } from 'node:os';
 
 function getDefaultExportFromCjs (x) {
@@ -185,12 +185,17 @@ z.object({
         .optional(),
     /**
      * Returns command + args for launching the service process.
-     * Consumed by `start` CLI command and `service install`.
+     * Consumed by `service install`.
      */
     startCommand: z.function({
         input: [z.string()],
         output: z.array(z.string()),
     }),
+    /** In-process service entry point for the CLI `start` command. */
+    run: z.function({
+        input: [z.string()],
+        output: z.promise(z.void()),
+    }),
     /** TOOLS.md section name (e.g., 'Watcher'). */
     sectionId: z.string().min(1, 'sectionId must be a non-empty string'),
     /** Refresh interval in seconds (must be a prime number). */
@@ -227,6 +232,14 @@ function getEffectiveServiceName(descriptor) {
     return descriptor.serviceName ?? `jeeves-${descriptor.name}`;
 }
 
+/**
+ * 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-';
+
 /**
  * Workspace and config root initialization.
  *
@@ -237,6 +250,19 @@ function getEffectiveServiceName(descriptor) {
  * - `{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),
+    };
+}
 /**
  * Derive the component config directory from the component name.
  *
@@ -245,7 +271,9 @@ function getEffectiveServiceName(descriptor) {
  * @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}`);
 }
 
 /**
@@ -668,6 +696,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.
  *
@@ -710,14 +751,11 @@ function createServiceCli(descriptor) {
         .command('start')
         .description('Launch the service process (foreground)')
         .requiredOption('-c, --config <path>', 'Config file path')
-        .action((opts) => {
-        const cmdArgs = descriptor.startCommand(opts.config);
-        const proc = spawn(cmdArgs[0], cmdArgs.slice(1), {
-            stdio: 'inherit',
-        });
-        proc.on('exit', (code) => {
-            process.exit(code ?? 1);
-        });
+        .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 ---
     program

package/dist/index.d.ts

@@ -118,6 +118,7 @@ declare const jeevesComponentDescriptorSchema: z.ZodObject<{
     onConfigApply: z.ZodOptional<z.ZodFunction<z.ZodTuple<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>], null>, z.ZodPromise<z.ZodVoid>>>;
     customMerge: z.ZodOptional<z.ZodFunction<z.ZodTuple<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>], null>, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     startCommand: z.ZodFunction<z.ZodTuple<readonly [z.ZodString], null>, z.ZodArray<z.ZodString>>;
+    run: z.ZodFunction<z.ZodTuple<readonly [z.ZodString], null>, z.ZodPromise<z.ZodVoid>>;
     sectionId: z.ZodString;
     refreshIntervalSeconds: z.ZodNumber;
     generateToolsContent: z.ZodFunction<z.ZodTuple<readonly [], null>, z.ZodString>;

package/dist/index.js

@@ -5,8 +5,8 @@ import { JSONPath } from 'jsonpath-plus';
 import * as commander from 'commander';
 import { valid, gte, gt } from 'semver';
 import { homedir } from 'node:os';
-import { execSync, spawn } from 'node:child_process';
 import { z } from 'zod';
+import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { packageDirectorySync } from 'package-directory';
 
@@ -176,14 +176,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.3` placeholder is replaced by
+ * The `0.4.5` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.4.3';
+const CORE_VERSION = '0.4.5';
 
 /**
  * Workspace and config root initialization.
@@ -1537,12 +1537,17 @@ const jeevesComponentDescriptorSchema = z.object({
         .optional(),
     /**
      * Returns command + args for launching the service process.
-     * Consumed by `start` CLI command and `service install`.
+     * Consumed by `service install`.
      */
     startCommand: z.function({
         input: [z.string()],
         output: z.array(z.string()),
     }),
+    /** In-process service entry point for the CLI `start` command. */
+    run: z.function({
+        input: [z.string()],
+        output: z.promise(z.void()),
+    }),
     /** TOOLS.md section name (e.g., 'Watcher'). */
     sectionId: z.string().min(1, 'sectionId must be a non-empty string'),
     /** Refresh interval in seconds (must be a prime number). */
@@ -2011,6 +2016,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.
  *
@@ -2053,14 +2071,11 @@ function createServiceCli(descriptor) {
         .command('start')
         .description('Launch the service process (foreground)')
         .requiredOption('-c, --config <path>', 'Config file path')
-        .action((opts) => {
-        const cmdArgs = descriptor.startCommand(opts.config);
-        const proc = spawn(cmdArgs[0], cmdArgs.slice(1), {
-            stdio: 'inherit',
-        });
-        proc.on('exit', (code) => {
-            process.exit(code ?? 1);
-        });
+        .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 ---
     program

package/package.json

@@ -50,7 +50,7 @@
     "prettier": "^3.8.1",
     "release-it": "^19.2.4",
     "rimraf": "^6.1.3",
-    "rollup": "^4.60.0",
+    "rollup": "^4.60.1",
     "rollup-plugin-dts": "^6.4.1",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.18",
@@ -139,5 +139,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.4.4"
+  "version": "0.4.6"
 }