@karmaniverous/jeeves 0.4.1 → 0.4.3

package/dist/cli/jeeves/index.js

@@ -261,14 +261,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.0` placeholder is replaced by
+ * The `0.4.2` 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.0';
+const CORE_VERSION = '0.4.2';
 
 /**
  * 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.0` placeholder is replaced by
+ * The `0.4.2` 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.0';
+const CORE_VERSION = '0.4.2';
 
 /**
  * Shared file I/O helpers for managed section operations.

package/dist/cli/service/index.js

@@ -162,6 +162,19 @@ z.object({
         .args(z.record(z.unknown()))
         .returns(z.promise(z.void()))
         .optional(),
+    /**
+     * Custom merge function for config apply. Receives the existing config
+     * and the patch, returns the merged result. Optional — if omitted,
+     * the default deep-merge (object-recursive, array-replacing) is used.
+     *
+     * Use this to implement domain-specific merge strategies such as
+     * name-based array merging for inference rules.
+     */
+    customMerge: z
+        .function()
+        .args(z.record(z.unknown()), z.record(z.unknown()))
+        .returns(z.record(z.unknown()))
+        .optional(),
     /**
      * Returns command + args for launching the service process.
      * Consumed by `start` CLI command and `service install`.
@@ -661,7 +674,7 @@ function createServiceManager(descriptor) {
  * Standard commands:
  * - `start -c <path>` - Launch the service process (foreground)
  * - `status [-p port]` - Probe service health
- * - `config [jsonpath] [-p port]` - Query running config
+ * - `config [jsonpath] [-p port]` - Query running config (jsonpath optional)
  * - `config validate -c <path>` - Validate a config file
  * - `config apply [-p port] [--file path] [--replace]` - Apply config patch
  * - `init [-o path]` - Generate default config
@@ -717,10 +730,7 @@ function createServiceCli(descriptor) {
     // --- config ---
     const configCmd = program
         .command('config')
-        .description('Query or manage service configuration');
-    configCmd
-        .command('query')
-        .description('Query running service config via JSONPath')
+        .description('Query or manage service configuration')
         .argument('[jsonpath]', 'JSONPath expression')
         .option('-p, --port <port>', 'Service port', String(descriptor.defaultPort))
         .action(async (jsonpath, opts) => {
@@ -777,9 +787,12 @@ function createServiceCli(descriptor) {
                 patch = JSON.parse(input);
             }
         }
-        const qs = opts.replace ? '?replace=true' : '';
+        const body = { patch };
+        if (opts.replace) {
+            body.replace = true;
+        }
         try {
-            const result = await postJson(`${url}/config/apply${qs}`, patch);
+            const result = await postJson(`${url}/config/apply`, body);
             console.log(JSON.stringify(result, null, 2));
         }
         catch (err) {

package/dist/index.d.ts

@@ -130,6 +130,15 @@ declare const jeevesComponentDescriptorSchema: z.ZodObject<{
      * write-only (service picks up changes on restart).
      */
     onConfigApply: z.ZodOptional<z.ZodFunction<z.ZodTuple<[z.ZodRecord<z.ZodString, z.ZodUnknown>], z.ZodUnknown>, z.ZodPromise<z.ZodVoid>>>;
+    /**
+     * Custom merge function for config apply. Receives the existing config
+     * and the patch, returns the merged result. Optional — if omitted,
+     * the default deep-merge (object-recursive, array-replacing) is used.
+     *
+     * Use this to implement domain-specific merge strategies such as
+     * name-based array merging for inference rules.
+     */
+    customMerge: z.ZodOptional<z.ZodFunction<z.ZodTuple<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>], z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     /**
      * Returns command + args for launching the service process.
      * Consumed by `start` CLI command and `service install`.
@@ -171,6 +180,7 @@ declare const jeevesComponentDescriptorSchema: z.ZodObject<{
     generateToolsContent: (...args: unknown[]) => string;
     serviceName?: string | undefined;
     onConfigApply?: ((args_0: Record<string, unknown>, ...args: unknown[]) => Promise<void>) | undefined;
+    customMerge?: ((args_0: Record<string, unknown>, args_1: Record<string, unknown>, ...args: unknown[]) => Record<string, unknown>) | undefined;
     dependencies?: {
         hard: string[];
         soft: string[];
@@ -192,6 +202,7 @@ declare const jeevesComponentDescriptorSchema: z.ZodObject<{
     generateToolsContent: (...args: unknown[]) => string;
     serviceName?: string | undefined;
     onConfigApply?: ((args_0: Record<string, unknown>, ...args: unknown[]) => Promise<void>) | undefined;
+    customMerge?: ((args_0: Record<string, unknown>, args_1: Record<string, unknown>, ...args: unknown[]) => Record<string, unknown>) | undefined;
     dependencies?: {
         hard: string[];
         soft: string[];
@@ -383,7 +394,7 @@ declare function createPluginCli(options: CreatePluginCliOptions): Command;
  * Standard commands:
  * - `start -c <path>` - Launch the service process (foreground)
  * - `status [-p port]` - Probe service health
- * - `config [jsonpath] [-p port]` - Query running config
+ * - `config [jsonpath] [-p port]` - Query running config (jsonpath optional)
  * - `config validate -c <path>` - Validate a config file
  * - `config apply [-p port] [--file path] [--replace]` - Apply config patch
  * - `init [-o path]` - Generate default config

package/dist/index.js

@@ -176,14 +176,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.0` placeholder is replaced by
+ * The `0.4.2` 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.0';
+const CORE_VERSION = '0.4.2';
 
 /**
  * Workspace and config root initialization.
@@ -405,7 +405,8 @@ function createConfigApplyHandler(descriptor) {
         // Read existing config
         const existing = readConfigFile(configPath);
         // Merge or replace
-        const merged = replace ? { ...patch } : deepMerge(existing, patch);
+        const mergeFn = descriptor.customMerge ?? deepMerge;
+        const merged = replace ? { ...patch } : mergeFn(existing, patch);
         // Validate against schema
         const schema = descriptor.configSchema;
         const parseResult = schema.safeParse(merged);
@@ -1501,6 +1502,19 @@ const jeevesComponentDescriptorSchema = z.object({
         .args(z.record(z.unknown()))
         .returns(z.promise(z.void()))
         .optional(),
+    /**
+     * Custom merge function for config apply. Receives the existing config
+     * and the patch, returns the merged result. Optional — if omitted,
+     * the default deep-merge (object-recursive, array-replacing) is used.
+     *
+     * Use this to implement domain-specific merge strategies such as
+     * name-based array merging for inference rules.
+     */
+    customMerge: z
+        .function()
+        .args(z.record(z.unknown()), z.record(z.unknown()))
+        .returns(z.record(z.unknown()))
+        .optional(),
     /**
      * Returns command + args for launching the service process.
      * Consumed by `start` CLI command and `service install`.
@@ -1991,7 +2005,7 @@ function createServiceManager(descriptor) {
  * Standard commands:
  * - `start -c <path>` - Launch the service process (foreground)
  * - `status [-p port]` - Probe service health
- * - `config [jsonpath] [-p port]` - Query running config
+ * - `config [jsonpath] [-p port]` - Query running config (jsonpath optional)
  * - `config validate -c <path>` - Validate a config file
  * - `config apply [-p port] [--file path] [--replace]` - Apply config patch
  * - `init [-o path]` - Generate default config
@@ -2047,10 +2061,7 @@ function createServiceCli(descriptor) {
     // --- config ---
     const configCmd = program
         .command('config')
-        .description('Query or manage service configuration');
-    configCmd
-        .command('query')
-        .description('Query running service config via JSONPath')
+        .description('Query or manage service configuration')
         .argument('[jsonpath]', 'JSONPath expression')
         .option('-p, --port <port>', 'Service port', String(descriptor.defaultPort))
         .action(async (jsonpath, opts) => {
@@ -2107,9 +2118,12 @@ function createServiceCli(descriptor) {
                 patch = JSON.parse(input);
             }
         }
-        const qs = opts.replace ? '?replace=true' : '';
+        const body = { patch };
+        if (opts.replace) {
+            body.replace = true;
+        }
         try {
-            const result = await postJson(`${url}/config/apply${qs}`, patch);
+            const result = await postJson(`${url}/config/apply`, body);
             console.log(JSON.stringify(result, null, 2));
         }
         catch (err) {
@@ -3845,7 +3859,9 @@ function createPluginToolset(descriptor) {
                 return fail('Missing required parameter: config');
             }
             try {
-                const result = await postJson(`${baseUrl}/config/apply`, config);
+                const result = await postJson(`${baseUrl}/config/apply`, {
+                    patch: config,
+                });
                 return ok(result);
             }
             catch (err) {

package/package.json

@@ -139,5 +139,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.4.1"
+  "version": "0.4.3"
 }