@crewhaus/spec-patch 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -63,6 +63,14 @@ export type ApplySpecPatchResult = {
     /** The re-parsed Spec after the patch. */
     readonly spec: Spec;
 };
+/**
+ * Whether the YAML source TEXTUALLY carries a key at `path`. Patch producers
+ * need this to pick `add` vs `replace` correctly: Zod-defaulted fields (e.g.
+ * `model_pool.policy`) are always present on the PARSED spec, but `replace`
+ * throws when the key is absent from the document and `add` throws when it is
+ * present — only the CST knows which applies. Unparseable YAML → false.
+ */
+export declare function specHasPath(yamlText: string, path: ReadonlyArray<string>): boolean;
 /**
  * Apply a structured patch to a YAML spec source. Uses the `yaml`
  * package's CST so comments and key order survive the round-trip; the

package/dist/index.js

@@ -52,6 +52,21 @@ const specPatchSchema = z.object({
     value: z.unknown().optional(),
     rationale: z.string().optional(),
 });
+/**
+ * Whether the YAML source TEXTUALLY carries a key at `path`. Patch producers
+ * need this to pick `add` vs `replace` correctly: Zod-defaulted fields (e.g.
+ * `model_pool.policy`) are always present on the PARSED spec, but `replace`
+ * throws when the key is absent from the document and `add` throws when it is
+ * present — only the CST knows which applies. Unparseable YAML → false.
+ */
+export function specHasPath(yamlText, path) {
+    try {
+        return parseDocument(yamlText).hasIn([...path]);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Apply a structured patch to a YAML spec source. Uses the `yaml`
  * package's CST so comments and key order survive the round-trip; the
@@ -171,6 +186,15 @@ export const OPTIMIZABLE_PATHS = Object.freeze({
         // by patching their parent block.
         Object.freeze(["chains"]),
         Object.freeze(["transaction_policy"]),
+        // Adaptive model routing — the pool's POLICY knobs are tunable (advise
+        // mines the reward scoreboard into these; optimize --from-advice gates
+        // them), but deliberately NOT ["agent","model_pool"] wholesale and NOT
+        // ["agent","model_pool","candidates"]: the candidate ROSTER is
+        // human-owned, mirroring the standing ["agent","model"] exclusion —
+        // learning tunes selection within the declared set, never the set.
+        Object.freeze(["agent", "model_pool", "policy"]),
+        Object.freeze(["agent", "model_pool", "routing"]),
+        Object.freeze(["agent", "model_pool", "learning"]),
     ]),
     workflow: Object.freeze([
         Object.freeze(["steps"]),
@@ -183,6 +207,10 @@ export const OPTIMIZABLE_PATHS = Object.freeze({
         Object.freeze(["failure_taxonomy"]),
         Object.freeze(["chains"]),
         Object.freeze(["transaction_policy"]),
+        // Adaptive model routing — pool policy knobs only (see the cli entry).
+        Object.freeze(["agent", "model_pool", "policy"]),
+        Object.freeze(["agent", "model_pool", "routing"]),
+        Object.freeze(["agent", "model_pool", "learning"]),
     ]),
     graph: Object.freeze([
         Object.freeze(["nodes"]),
@@ -193,6 +221,10 @@ export const OPTIMIZABLE_PATHS = Object.freeze({
     managed: Object.freeze([
         Object.freeze(["agent", "instructions"]),
         Object.freeze(["failure_taxonomy"]),
+        // Adaptive model routing — pool policy knobs only (see the cli entry).
+        Object.freeze(["agent", "model_pool", "policy"]),
+        Object.freeze(["agent", "model_pool", "routing"]),
+        Object.freeze(["agent", "model_pool", "learning"]),
     ]),
     pipeline: Object.freeze([
         Object.freeze(["agent", "instructions"]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/spec-patch",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "Pillar-2 patch infrastructure — apply a SpecPatch to a YAML source preserving comments and key order via the yaml CST. Drives the active eval optimizer's spec-level mutation loop.",
   "main": "dist/index.js",
@@ -15,8 +15,8 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.2.1",
-    "@crewhaus/spec": "0.2.1",
+    "@crewhaus/errors": "0.2.3",
+    "@crewhaus/spec": "0.2.3",
     "yaml": "^2.6.0",
     "zod": "^3.23.8"
   },