agent-contracts 0.30.0 → 0.30.1

package/cli-contract.yaml

@@ -3,7 +3,7 @@ cli_contracts: 0.1.0
 
 info:
   title: agent-contracts CLI
-  version: 0.30.0
+  version: 0.30.1
   description: >-
     Declarative YAML DSL toolkit for defining, validating, and rendering
     multi-agent development workflows. Provides static validation,
@@ -15,6 +15,26 @@ info:
     name: foo-ogawa
     url: https://github.com/foo-ogawa/agent-contracts
 
+artifact_slots:
+  dsl-definitions:
+    description: Agent contracts DSL YAML files (agent-contracts.yaml and extends targets)
+    direction: read
+  config:
+    description: agent-contracts.config.yaml configuration file
+    direction: read
+  generated-templates:
+    description: Rendered output files from Handlebars templates
+    direction: write
+  generated-guardrails:
+    description: Generated guardrail binding files (cursor-rules, AGENTS.md, etc.)
+    direction: write
+  generated-interface:
+    description: Generated team interface YAML/JSON files
+    direction: write
+  audit-report:
+    description: LLM audit result output files
+    direction: write
+
 command_sets:
   agent-contracts:
     summary: Agent contracts tooling — validate, lint, render DSL files.
@@ -297,13 +317,7 @@ command_sets:
         effects:
           risk_level: medium
           writes:
-            - target: "configured render output paths"
-              description: "rendered template files from DSL input"
-              overwrite: true
-              idempotent: true
-              idempotent_note: >-
-                Output is deterministic from DSL input and templates.
-                Repeated runs produce identical files.
+            - generated-templates
 
         options:
           - name: config
@@ -535,6 +549,11 @@ command_sets:
 
         effects:
           risk_level: medium
+          reads:
+            - dsl-definitions
+            - config
+          writes:
+            - audit-report
           network:
             description: >-
               LLM API calls to configured adapter (e.g. OpenAI,
@@ -713,16 +732,9 @@ command_sets:
         effects:
           risk_level: low
           writes:
-            - target: "configured render, guardrail, and interface output paths"
-              description: >-
-                template files, guardrail binding files, and/or team
-                interface files generated from DSL input
-              overwrite: true
-              idempotent: true
-              idempotent_note: >-
-                Output is deterministic from DSL input, templates,
-                policies, and bindings. Repeated runs produce
-                identical files.
+            - generated-templates
+            - generated-guardrails
+            - generated-interface
 
         arguments:
           - name: type

package/dist/cli.js

@@ -40342,17 +40342,19 @@ var require_errors = __commonJS({
     exports.convertAjvErrors = exports.RulesetValidationError = void 0;
     var isAggregateError_1 = require_isAggregateError();
     var RulesetValidationError = class extends Error {
-      constructor(code, message, path) {
+      constructor(code, message, path, location2) {
         super(message);
         this.code = code;
         this.message = message;
         this.path = path;
+        this.range = location2 === null || location2 === void 0 ? void 0 : location2.range;
+        this.source = location2 === null || location2 === void 0 ? void 0 : location2.source;
       }
     };
     exports.RulesetValidationError = RulesetValidationError;
     var RULE_INSTANCE_PATH = /^\/rules\/[^/]+/;
     var GENERIC_INSTANCE_PATH = /^\/(?:aliases|extends|overrides(?:\/\d+\/extends)?)/;
-    function convertAjvErrors(errors) {
+    function convertAjvErrors(errors, sourceContext) {
       const sortedErrors = [...errors].sort((errorA, errorB) => {
         const diff = errorA.instancePath.length - errorB.instancePath.length;
         return diff === 0 ? errorA.keyword === "errorMessage" && errorB.keyword !== "errorMessage" ? -1 : 0 : diff;
@@ -40385,10 +40387,12 @@ var require_errors = __commonJS({
       return filteredErrors.flatMap((error) => {
         var _a;
         if (error.keyword === "x-spectral-runtime") {
-          return flatErrors(error.params.errors);
+          const flat = flatErrors(error.params.errors);
+          const list = Array.isArray(flat) ? flat : [flat];
+          return list.map((e3) => enrichWithLocation(e3, sourceContext));
         }
         const path = error.instancePath.slice(1).split("/");
-        return new RulesetValidationError(inferErrorCode(path, error.keyword), (_a = error.message) !== null && _a !== void 0 ? _a : "unknown error", path);
+        return new RulesetValidationError(inferErrorCode(path, error.keyword), (_a = error.message) !== null && _a !== void 0 ? _a : "unknown error", path, resolveLocation(path, sourceContext));
       });
     }
     exports.convertAjvErrors = convertAjvErrors;
@@ -40398,6 +40402,22 @@ var require_errors = __commonJS({
       }
       return error;
     }
+    function resolveLocation(path, sourceContext) {
+      var _a;
+      if (sourceContext === void 0) {
+        return void 0;
+      }
+      return {
+        source: sourceContext.source,
+        range: (_a = sourceContext.getLocationForJsonPath(path)) === null || _a === void 0 ? void 0 : _a.range
+      };
+    }
+    function enrichWithLocation(error, sourceContext) {
+      if (sourceContext === void 0 || error.source !== void 0 || error.range !== void 0) {
+        return error;
+      }
+      return new RulesetValidationError(error.code, error.message, error.path, resolveLocation(error.path, sourceContext));
+    }
     function inferErrorCode(path, keyword) {
       if (path.length === 0) {
         return "generic-validation-error";
@@ -45918,17 +45938,17 @@ var require_assertions = __commonJS({
     var ajv_1 = require_ajv();
     var errors_1 = require_errors();
     var es_aggregate_error_1 = (0, tslib_1.__importDefault)(require_es_aggregate_error());
-    function assertValidRuleset(ruleset2, format2 = "js") {
-      var _a;
+    function assertValidRuleset(ruleset2, format2 = "js", sourceContext) {
+      var _a, _b;
       if (!(0, json_1.isPlainObject)(ruleset2)) {
-        throw new errors_1.RulesetValidationError("invalid-ruleset-definition", "Provided ruleset is not an object", []);
+        throw new errors_1.RulesetValidationError("invalid-ruleset-definition", "Provided ruleset is not an object", [], sourceContext === void 0 ? void 0 : { source: sourceContext.source });
       }
       if (!("rules" in ruleset2) && !("extends" in ruleset2) && !("overrides" in ruleset2)) {
-        throw new errors_1.RulesetValidationError("invalid-ruleset-definition", "Ruleset must have rules or extends or overrides defined", []);
+        throw new errors_1.RulesetValidationError("invalid-ruleset-definition", "Ruleset must have rules or extends or overrides defined", [], sourceContext === void 0 ? void 0 : { source: sourceContext.source, range: (_a = sourceContext.getLocationForJsonPath([])) === null || _a === void 0 ? void 0 : _a.range });
       }
       const validate = (0, ajv_1.createValidator)(format2);
       if (!validate(ruleset2)) {
-        throw new es_aggregate_error_1.default((0, errors_1.convertAjvErrors)((_a = validate.errors) !== null && _a !== void 0 ? _a : []));
+        throw new es_aggregate_error_1.default((0, errors_1.convertAjvErrors)((_b = validate.errors) !== null && _b !== void 0 ? _b : [], sourceContext));
       }
     }
     exports.assertValidRuleset = assertValidRuleset;
@@ -46098,10 +46118,10 @@ var require_ruleset = __commonJS({
         let definition;
         if ((0, json_1.isPlainObject)(maybeDefinition) && "extends" in maybeDefinition) {
           const { extends: _2, ...def } = maybeDefinition;
-          (0, index_1.assertValidRuleset)({ extends: [], ...def }, "js");
+          (0, index_1.assertValidRuleset)({ extends: [], ...def }, "js", context === null || context === void 0 ? void 0 : context.sourceContext);
           definition = maybeDefinition;
         } else {
-          (0, index_1.assertValidRuleset)(maybeDefinition, "js");
+          (0, index_1.assertValidRuleset)(maybeDefinition, "js", context === null || context === void 0 ? void 0 : context.sourceContext);
           definition = maybeDefinition;
         }
         this.definition = definition;
@@ -49224,13 +49244,7 @@ var commandDefinitions = {
     "effects": {
       "risk_level": "medium",
       "writes": [
-        {
-          "target": "configured render output paths",
-          "description": "rendered template files from DSL input",
-          "overwrite": true,
-          "idempotent": true,
-          "idempotent_note": "Output is deterministic from DSL input and templates. Repeated runs produce identical files."
-        }
+        "generated-templates"
       ]
     },
     "options": [
@@ -49357,6 +49371,13 @@ var commandDefinitions = {
   "audit": {
     "effects": {
       "risk_level": "medium",
+      "reads": [
+        "dsl-definitions",
+        "config"
+      ],
+      "writes": [
+        "audit-report"
+      ],
       "network": {
         "description": "LLM API calls to configured adapter (e.g. OpenAI, Gemini, Cursor). Incurs token cost and sends DSL content to the LLM provider.",
         "idempotent": false,
@@ -49460,13 +49481,9 @@ var commandDefinitions = {
     "effects": {
       "risk_level": "low",
       "writes": [
-        {
-          "target": "configured render, guardrail, and interface output paths",
-          "description": "template files, guardrail binding files, and/or team interface files generated from DSL input",
-          "overwrite": true,
-          "idempotent": true,
-          "idempotent_note": "Output is deterministic from DSL input, templates, policies, and bindings. Repeated runs produce identical files."
-        }
+        "generated-templates",
+        "generated-guardrails",
+        "generated-interface"
       ]
     },
     "options": [