agent-contracts 0.19.4 → 0.20.0

package/cli-contract.yaml

@@ -3,7 +3,7 @@ cliContracts: 0.1.0
 
 info:
   title: agent-contracts CLI
-  version: 0.19.4
+  version: 0.20.0
   description: >-
     Declarative YAML DSL toolkit for defining, validating, and rendering
     multi-agent development workflows. Provides static validation,
@@ -117,6 +117,8 @@ commandSets:
           requiresConfirmation: false
           idempotent: true
           sideEffects: []
+          expectedDurationMs: 3000
+          retryableExitCodes: []
 
       # ── validate ──────────────────────────────────────
       validate:
@@ -206,6 +208,8 @@ commandSets:
           requiresConfirmation: false
           idempotent: true
           sideEffects: []
+          expectedDurationMs: 3000
+          retryableExitCodes: []
 
       # ── lint ──────────────────────────────────────────
       lint:
@@ -294,6 +298,8 @@ commandSets:
           requiresConfirmation: false
           idempotent: true
           sideEffects: []
+          expectedDurationMs: 3000
+          retryableExitCodes: []
 
       # ── render ────────────────────────────────────────
       render:
@@ -369,6 +375,8 @@ commandSets:
           recommendedBeforeUse:
             - Ensure agent-contracts.config.yaml exists with render targets.
             - Run validate first to confirm DSL is valid.
+          expectedDurationMs: 5000
+          retryableExitCodes: []
 
       # ── check ─────────────────────────────────────────
       check:
@@ -449,6 +457,8 @@ commandSets:
           sideEffects: []
           recommendedBeforeUse:
             - Ensure agent-contracts.config.yaml exists.
+          expectedDurationMs: 10000
+          retryableExitCodes: []
 
       # ── score ─────────────────────────────────────────
       score:
@@ -535,6 +545,8 @@ commandSets:
           requiresConfirmation: false
           idempotent: true
           sideEffects: []
+          expectedDurationMs: 5000
+          retryableExitCodes: []
 
       # ── audit ───────────────────────────────────────────
       audit:
@@ -832,3 +844,5 @@ commandSets:
           recommendedBeforeUse:
             - Ensure agent-contracts.config.yaml exists with binding definitions.
             - Run validate first to confirm DSL is valid.
+          expectedDurationMs: 5000
+          retryableExitCodes: []

package/dist/cli.js

@@ -49565,18 +49565,27 @@ async function resolveRefsDeep(data, baseDir, resolving, rootDoc) {
       }
       resolving.add(refValue);
       const target = resolveJsonPointer(rootDoc, refValue);
-      const resolved2 = await resolveRefsDeep(
+      const resolved = await resolveRefsDeep(
         deepClone(target),
         baseDir,
         resolving,
         rootDoc
       );
       resolving.delete(refValue);
-      return resolved2;
+      return resolved;
     }
-    const refTarget = resolve2(baseDir, refValue);
+    const hashIdx = refValue.indexOf("#");
+    const filePart = hashIdx >= 0 ? refValue.slice(0, hashIdx) : refValue;
+    const fragment = hashIdx >= 0 ? refValue.slice(hashIdx) : null;
+    const refTarget = resolve2(baseDir, filePart);
     const s2 = await fsStat(refTarget).catch(() => null);
     if (s2?.isDirectory()) {
+      if (fragment) {
+        throw new DslLoadError(
+          `Cannot use JSON Pointer fragment with directory $ref: ${refValue}`,
+          refTarget
+        );
+      }
       if (resolving.has(refTarget)) {
         throw new DslLoadError(
           `Circular $ref detected: ${refTarget}`,
@@ -49599,14 +49608,24 @@ async function resolveRefsDeep(data, baseDir, resolving, rootDoc) {
     }
     resolving.add(refTarget);
     const content = await readYaml(refTarget);
-    const resolved = await resolveRefsDeep(
+    const fileRoot = fragment ? content : rootDoc;
+    let fileData = await resolveRefsDeep(
       content,
       dirname2(refTarget),
       resolving,
-      rootDoc
+      fileRoot
     );
     resolving.delete(refTarget);
-    return resolved;
+    if (fragment && fragment.startsWith("#/")) {
+      if (!isRecord(fileData)) {
+        throw new DslLoadError(
+          `Cannot resolve fragment "${fragment}" in ${refTarget}: file content is not an object`,
+          refTarget
+        );
+      }
+      fileData = resolveJsonPointer(fileData, fragment);
+    }
+    return fileData;
   }
   let obj = data;
   if (hasRefs(obj)) {