@cat-factory/contracts 0.299.1 → 0.301.0

package/dist/step-decisions.d.ts

@@ -65,6 +65,41 @@ export declare const companionVerdictSchema: v.ObjectSchema<{
     readonly passed: v.BooleanSchema<undefined>;
     /** The companion's challenge / justification (its assessment summary). */
     readonly feedback: v.StringSchema<undefined>;
+    /**
+     * The per-item challenges this round anchored (the assessment's own `comments`).
+     *
+     * Stored, rather than left to the summary alone, because the verdict list is what a LATER round
+     * is shown: a companion re-grades a document it has already reviewed, and the question worth
+     * spending a rework budget on is "was what I asked for done", which it cannot answer against a
+     * summary that named none of the specific asks. The producer is handed the same list for the
+     * mirror-image reason — so it cannot regress on a point raised two rounds ago and forgotten.
+     *
+     * Absent on a round that anchored nothing, and on every verdict written before this existed.
+     */
+    readonly comments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /**
+         * Verbatim raw-markdown source of the commented prose block. Optional: a comment
+         * may instead anchor to a structured item via {@link anchorId}, where there is no
+         * prose source to quote.
+         */
+        readonly quotedSource: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * 0-based source line range [start, end) of the commented prose block, for
+         * best-effort re-anchoring. Optional: a comment may instead anchor to a structured
+         * item via {@link anchorId} (e.g. a spec requirement/acceptance-criterion id), where
+         * there is no prose line range.
+         */
+        readonly srcStart: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly srcEnd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        /**
+         * Stable id of the structured item the comment targets (e.g. a spec
+         * requirement/criterion id), when the reviewed output is rendered as structured
+         * items rather than free prose. Absent for prose-range comments.
+         */
+        readonly anchorId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** The reviewer's note on this block / item. */
+        readonly body: v.StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
 }, undefined>;
 export type CompanionVerdict = v.InferOutput<typeof companionVerdictSchema>;
 /**

package/dist/step-decisions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-decisions.d.ts","sourceRoot":"","sources":["../src/step-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAgB5B;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;aAKzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;IAClC;;;;OAIG;;IAEH;;;;;OAKG;;;IAGH;;;;OAIG;;IAEH,gDAAgD;;aAEhD,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC,oEAAoE;;IAEpE,uDAAuD;;IAEvD,4CAA4C;;IAE5C,0EAA0E;;aAE1E,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,uFAKnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;IAC7B,2EAA2E;;IAE3E,gHAAgH;;IAEhH,4EAA4E;;IAE5E,sFAAsF;;IAEtF,kFAAkF;;QApFlF;;;;WAIG;;QAEH;;;;;WAKG;;;QAGH;;;;WAIG;;QAEH,gDAAgD;;;IAkEhD;;;;;;;OAOG;;IAEH;;;OAGG;;;;;IAEH;;;;OAIG;;;;;;aAEH,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"step-decisions.d.ts","sourceRoot":"","sources":["../src/step-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAgB5B;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;aAKzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;IAClC;;;;OAIG;;IAEH;;;;;OAKG;;;IAGH;;;;OAIG;;IAEH,gDAAgD;;aAEhD,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC,oEAAoE;;IAEpE,uDAAuD;;IAEvD,4CAA4C;;IAE5C,0EAA0E;;IAE1E;;;;;;;;;;OAUG;;QApDH;;;;WAIG;;QAEH;;;;;WAKG;;;QAGH;;;;WAIG;;QAEH,gDAAgD;;;aAkChD,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,uFAKnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;IAC7B,2EAA2E;;IAE3E,gHAAgH;;IAEhH,4EAA4E;;IAE5E,sFAAsF;;IAEtF,kFAAkF;;QAhGlF;;;;WAIG;;QAEH;;;;;WAKG;;;QAGH;;;;WAIG;;QAEH,gDAAgD;;;IA8EhD;;;;;;;OAOG;;IAEH;;;OAGG;;;;;IAEH;;;;OAIG;;;;;;aAEH,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/step-decisions.js

@@ -76,6 +76,18 @@ export const companionVerdictSchema = v.object({
     passed: v.boolean(),
     /** The companion's challenge / justification (its assessment summary). */
     feedback: v.string(),
+    /**
+     * The per-item challenges this round anchored (the assessment's own `comments`).
+     *
+     * Stored, rather than left to the summary alone, because the verdict list is what a LATER round
+     * is shown: a companion re-grades a document it has already reviewed, and the question worth
+     * spending a rework budget on is "was what I asked for done", which it cannot answer against a
+     * summary that named none of the specific asks. The producer is handed the same list for the
+     * mirror-image reason — so it cannot regress on a point raised two rounds ago and forgotten.
+     *
+     * Absent on a round that anchored nothing, and on every verdict written before this existed.
+     */
+    comments: v.optional(v.array(stepReviewCommentSchema)),
 });
 /**
  * An approval gate's lifecycle: `pending` while awaiting the human; terminal

package/dist/step-decisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-decisions.js","sourceRoot":"","sources":["../src/step-decisions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"step-decisions.js","sourceRoot":"","sources":["../src/step-decisions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.299.1",
+  "version": "0.301.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",