@exaudeus/workrail 3.74.3 → 3.76.0

package/dist/v2/durable-core/schemas/artifacts/index.d.ts

@@ -3,6 +3,7 @@ export { LOOP_CONTROL_CONTRACT_REF, LoopControlDecisionSchema, LoopControlMetada
 export { COORDINATOR_SIGNAL_CONTRACT_REF, CoordinatorSignalKindSchema, CoordinatorSignalArtifactV1Schema, isCoordinatorSignalArtifact, parseCoordinatorSignalArtifact, type CoordinatorSignalKind, type CoordinatorSignalArtifactV1, } from './coordinator-signal.js';
 export { REVIEW_VERDICT_CONTRACT_REF, ReviewVerdictArtifactV1Schema, isReviewVerdictArtifact, parseReviewVerdictArtifact, type ReviewVerdictArtifactV1, } from './review-verdict.js';
 export { DISCOVERY_HANDOFF_CONTRACT_REF, DiscoveryHandoffArtifactV1Schema, isDiscoveryHandoffArtifact, parseDiscoveryHandoffArtifact, type DiscoveryHandoffArtifactV1, } from './discovery-handoff.js';
-export declare const ARTIFACT_CONTRACT_REFS: readonly ["wr.contracts.assessment", "wr.contracts.loop_control", "wr.contracts.coordinator_signal", "wr.contracts.review_verdict", "wr.contracts.discovery_handoff"];
+export { SHAPING_HANDOFF_CONTRACT_REF, ShapingHandoffArtifactV1Schema, isShapingHandoffArtifact, parseShapingHandoffArtifact, type ShapingHandoffArtifactV1, CODING_HANDOFF_CONTRACT_REF, CodingHandoffArtifactV1Schema, isCodingHandoffArtifact, parseCodingHandoffArtifact, type CodingHandoffArtifactV1, type PhaseHandoffArtifact, } from './phase-handoff.js';
+export declare const ARTIFACT_CONTRACT_REFS: readonly ["wr.contracts.assessment", "wr.contracts.loop_control", "wr.contracts.coordinator_signal", "wr.contracts.review_verdict", "wr.contracts.discovery_handoff", "wr.contracts.shaping_handoff", "wr.contracts.coding_handoff"];
 export type ArtifactContractRef = (typeof ARTIFACT_CONTRACT_REFS)[number];
 export declare function isValidContractRef(ref: string): ref is ArtifactContractRef;

package/dist/v2/durable-core/schemas/artifacts/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ARTIFACT_CONTRACT_REFS = exports.parseDiscoveryHandoffArtifact = exports.isDiscoveryHandoffArtifact = exports.DiscoveryHandoffArtifactV1Schema = exports.DISCOVERY_HANDOFF_CONTRACT_REF = exports.parseReviewVerdictArtifact = exports.isReviewVerdictArtifact = exports.ReviewVerdictArtifactV1Schema = exports.REVIEW_VERDICT_CONTRACT_REF = exports.parseCoordinatorSignalArtifact = exports.isCoordinatorSignalArtifact = exports.CoordinatorSignalArtifactV1Schema = exports.CoordinatorSignalKindSchema = exports.COORDINATOR_SIGNAL_CONTRACT_REF = exports.findLoopControlArtifact = exports.parseLoopControlArtifact = exports.isLoopControlArtifact = exports.LoopControlArtifactV1Schema = exports.LoopControlMetadataV1Schema = exports.LoopControlDecisionSchema = exports.LOOP_CONTROL_CONTRACT_REF = exports.parseAssessmentArtifact = exports.isAssessmentArtifact = exports.AssessmentDimensionSubmissionSchema = exports.AssessmentArtifactV1Schema = exports.ASSESSMENT_CONTRACT_REF = void 0;
+exports.ARTIFACT_CONTRACT_REFS = exports.parseCodingHandoffArtifact = exports.isCodingHandoffArtifact = exports.CodingHandoffArtifactV1Schema = exports.CODING_HANDOFF_CONTRACT_REF = exports.parseShapingHandoffArtifact = exports.isShapingHandoffArtifact = exports.ShapingHandoffArtifactV1Schema = exports.SHAPING_HANDOFF_CONTRACT_REF = exports.parseDiscoveryHandoffArtifact = exports.isDiscoveryHandoffArtifact = exports.DiscoveryHandoffArtifactV1Schema = exports.DISCOVERY_HANDOFF_CONTRACT_REF = exports.parseReviewVerdictArtifact = exports.isReviewVerdictArtifact = exports.ReviewVerdictArtifactV1Schema = exports.REVIEW_VERDICT_CONTRACT_REF = exports.parseCoordinatorSignalArtifact = exports.isCoordinatorSignalArtifact = exports.CoordinatorSignalArtifactV1Schema = exports.CoordinatorSignalKindSchema = exports.COORDINATOR_SIGNAL_CONTRACT_REF = exports.findLoopControlArtifact = exports.parseLoopControlArtifact = exports.isLoopControlArtifact = exports.LoopControlArtifactV1Schema = exports.LoopControlMetadataV1Schema = exports.LoopControlDecisionSchema = exports.LOOP_CONTROL_CONTRACT_REF = exports.parseAssessmentArtifact = exports.isAssessmentArtifact = exports.AssessmentDimensionSubmissionSchema = exports.AssessmentArtifactV1Schema = exports.ASSESSMENT_CONTRACT_REF = void 0;
 exports.isValidContractRef = isValidContractRef;
 var assessment_js_1 = require("./assessment.js");
 Object.defineProperty(exports, "ASSESSMENT_CONTRACT_REF", { enumerable: true, get: function () { return assessment_js_1.ASSESSMENT_CONTRACT_REF; } });
@@ -32,12 +32,23 @@ Object.defineProperty(exports, "DISCOVERY_HANDOFF_CONTRACT_REF", { enumerable: t
 Object.defineProperty(exports, "DiscoveryHandoffArtifactV1Schema", { enumerable: true, get: function () { return discovery_handoff_js_1.DiscoveryHandoffArtifactV1Schema; } });
 Object.defineProperty(exports, "isDiscoveryHandoffArtifact", { enumerable: true, get: function () { return discovery_handoff_js_1.isDiscoveryHandoffArtifact; } });
 Object.defineProperty(exports, "parseDiscoveryHandoffArtifact", { enumerable: true, get: function () { return discovery_handoff_js_1.parseDiscoveryHandoffArtifact; } });
+var phase_handoff_js_1 = require("./phase-handoff.js");
+Object.defineProperty(exports, "SHAPING_HANDOFF_CONTRACT_REF", { enumerable: true, get: function () { return phase_handoff_js_1.SHAPING_HANDOFF_CONTRACT_REF; } });
+Object.defineProperty(exports, "ShapingHandoffArtifactV1Schema", { enumerable: true, get: function () { return phase_handoff_js_1.ShapingHandoffArtifactV1Schema; } });
+Object.defineProperty(exports, "isShapingHandoffArtifact", { enumerable: true, get: function () { return phase_handoff_js_1.isShapingHandoffArtifact; } });
+Object.defineProperty(exports, "parseShapingHandoffArtifact", { enumerable: true, get: function () { return phase_handoff_js_1.parseShapingHandoffArtifact; } });
+Object.defineProperty(exports, "CODING_HANDOFF_CONTRACT_REF", { enumerable: true, get: function () { return phase_handoff_js_1.CODING_HANDOFF_CONTRACT_REF; } });
+Object.defineProperty(exports, "CodingHandoffArtifactV1Schema", { enumerable: true, get: function () { return phase_handoff_js_1.CodingHandoffArtifactV1Schema; } });
+Object.defineProperty(exports, "isCodingHandoffArtifact", { enumerable: true, get: function () { return phase_handoff_js_1.isCodingHandoffArtifact; } });
+Object.defineProperty(exports, "parseCodingHandoffArtifact", { enumerable: true, get: function () { return phase_handoff_js_1.parseCodingHandoffArtifact; } });
 exports.ARTIFACT_CONTRACT_REFS = [
     'wr.contracts.assessment',
     'wr.contracts.loop_control',
     'wr.contracts.coordinator_signal',
     'wr.contracts.review_verdict',
     'wr.contracts.discovery_handoff',
+    'wr.contracts.shaping_handoff',
+    'wr.contracts.coding_handoff',
 ];
 function isValidContractRef(ref) {
     return exports.ARTIFACT_CONTRACT_REFS.includes(ref);

package/dist/v2/durable-core/schemas/artifacts/phase-handoff.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import type { DiscoveryHandoffArtifactV1 } from './discovery-handoff.js';
+export declare const SHAPING_HANDOFF_CONTRACT_REF: "wr.contracts.shaping_handoff";
+export declare const ShapingHandoffArtifactV1Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"wr.shaping_handoff">;
+    version: z.ZodLiteral<1>;
+    pitchPath: z.ZodString;
+    selectedShape: z.ZodString;
+    appetite: z.ZodString;
+    keyConstraints: z.ZodArray<z.ZodString, "many">;
+    rabbitHoles: z.ZodArray<z.ZodString, "many">;
+    outOfScope: z.ZodArray<z.ZodString, "many">;
+    validationChecklist: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    kind: "wr.shaping_handoff";
+    version: 1;
+    pitchPath: string;
+    selectedShape: string;
+    appetite: string;
+    keyConstraints: string[];
+    rabbitHoles: string[];
+    outOfScope: string[];
+    validationChecklist: string[];
+}, {
+    kind: "wr.shaping_handoff";
+    version: 1;
+    pitchPath: string;
+    selectedShape: string;
+    appetite: string;
+    keyConstraints: string[];
+    rabbitHoles: string[];
+    outOfScope: string[];
+    validationChecklist: string[];
+}>;
+export type ShapingHandoffArtifactV1 = z.infer<typeof ShapingHandoffArtifactV1Schema>;
+export declare function isShapingHandoffArtifact(artifact: unknown): artifact is {
+    readonly kind: 'wr.shaping_handoff';
+};
+export declare function parseShapingHandoffArtifact(artifact: unknown): ShapingHandoffArtifactV1 | null;
+export declare const CODING_HANDOFF_CONTRACT_REF: "wr.contracts.coding_handoff";
+export declare const CodingHandoffArtifactV1Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"wr.coding_handoff">;
+    version: z.ZodLiteral<1>;
+    branchName: z.ZodString;
+    keyDecisions: z.ZodArray<z.ZodString, "many">;
+    knownLimitations: z.ZodArray<z.ZodString, "many">;
+    testsAdded: z.ZodArray<z.ZodString, "many">;
+    filesChanged: z.ZodArray<z.ZodString, "many">;
+    correctedAssumptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        assumed: z.ZodString;
+        actual: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        assumed: string;
+        actual: string;
+    }, {
+        assumed: string;
+        actual: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    kind: "wr.coding_handoff";
+    version: 1;
+    branchName: string;
+    keyDecisions: string[];
+    knownLimitations: string[];
+    testsAdded: string[];
+    filesChanged: string[];
+    correctedAssumptions?: {
+        assumed: string;
+        actual: string;
+    }[] | undefined;
+}, {
+    kind: "wr.coding_handoff";
+    version: 1;
+    branchName: string;
+    keyDecisions: string[];
+    knownLimitations: string[];
+    testsAdded: string[];
+    filesChanged: string[];
+    correctedAssumptions?: {
+        assumed: string;
+        actual: string;
+    }[] | undefined;
+}>;
+export type CodingHandoffArtifactV1 = z.infer<typeof CodingHandoffArtifactV1Schema>;
+export declare function isCodingHandoffArtifact(artifact: unknown): artifact is {
+    readonly kind: 'wr.coding_handoff';
+};
+export declare function parseCodingHandoffArtifact(artifact: unknown): CodingHandoffArtifactV1 | null;
+export type PhaseHandoffArtifact = DiscoveryHandoffArtifactV1 | ShapingHandoffArtifactV1 | CodingHandoffArtifactV1;

package/dist/v2/durable-core/schemas/artifacts/phase-handoff.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodingHandoffArtifactV1Schema = exports.CODING_HANDOFF_CONTRACT_REF = exports.ShapingHandoffArtifactV1Schema = exports.SHAPING_HANDOFF_CONTRACT_REF = void 0;
+exports.isShapingHandoffArtifact = isShapingHandoffArtifact;
+exports.parseShapingHandoffArtifact = parseShapingHandoffArtifact;
+exports.isCodingHandoffArtifact = isCodingHandoffArtifact;
+exports.parseCodingHandoffArtifact = parseCodingHandoffArtifact;
+const zod_1 = require("zod");
+exports.SHAPING_HANDOFF_CONTRACT_REF = 'wr.contracts.shaping_handoff';
+exports.ShapingHandoffArtifactV1Schema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('wr.shaping_handoff'),
+    version: zod_1.z.literal(1),
+    pitchPath: zod_1.z.string().min(1),
+    selectedShape: zod_1.z.string().min(1).max(200),
+    appetite: zod_1.z.string().min(1).max(100),
+    keyConstraints: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(8),
+    rabbitHoles: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(6),
+    outOfScope: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(6),
+    validationChecklist: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(10),
+})
+    .strict();
+function isShapingHandoffArtifact(artifact) {
+    return (typeof artifact === 'object' &&
+        artifact !== null &&
+        artifact.kind === 'wr.shaping_handoff');
+}
+function parseShapingHandoffArtifact(artifact) {
+    const result = exports.ShapingHandoffArtifactV1Schema.safeParse(artifact);
+    return result.success ? result.data : null;
+}
+exports.CODING_HANDOFF_CONTRACT_REF = 'wr.contracts.coding_handoff';
+exports.CodingHandoffArtifactV1Schema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('wr.coding_handoff'),
+    version: zod_1.z.literal(1),
+    branchName: zod_1.z.string().min(1),
+    keyDecisions: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(8),
+    knownLimitations: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(6),
+    testsAdded: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(10),
+    filesChanged: zod_1.z.array(zod_1.z.string().min(1).max(300)).max(20),
+    correctedAssumptions: zod_1.z.array(zod_1.z.object({
+        assumed: zod_1.z.string().min(1).max(200),
+        actual: zod_1.z.string().min(1).max(200),
+    })).max(6).optional(),
+})
+    .strict();
+function isCodingHandoffArtifact(artifact) {
+    return (typeof artifact === 'object' &&
+        artifact !== null &&
+        artifact.kind === 'wr.coding_handoff');
+}
+function parseCodingHandoffArtifact(artifact) {
+    const result = exports.CodingHandoffArtifactV1Schema.safeParse(artifact);
+    return result.success ? result.data : null;
+}

package/docs/authoring-v2.md

@@ -434,6 +434,18 @@ WorkRail v2 provides **built-in** building blocks that workflows (including exte
 - **Features**: deterministic, closed-set “middleware” applied by WorkRail (e.g., tier-aware instructions, formatting, durable recap guidance).
 - **Contract packs**: server-side definitions for allowed artifact kinds and small examples (no schema authoring required by workflow authors).
 
+**Available contract refs** (use in `outputContract: { contractRef: "..." }`):
+
+| contractRef | Artifact kind | Emitted by |
+|---|---|---|
+| `wr.contracts.loop_control` | `wr.loop_control` | Loop body exit steps |
+| `wr.contracts.coordinator_signal` | `wr.coordinator_signal` | Coordinator signal steps |
+| `wr.contracts.review_verdict` | `wr.review_verdict` | Review workflow final step |
+| `wr.contracts.discovery_handoff` | `wr.discovery_handoff` | Discovery workflow handoff step |
+| `wr.contracts.shaping_handoff` | `wr.shaping_handoff` | Shaping workflow finalize step |
+| `wr.contracts.coding_handoff` | `wr.coding_handoff` | Coding workflow retrospective step |
+| `wr.contracts.assessment` | `wr.assessment` | Assessment gate steps |
+
 External workflows can reference these builtins, but cannot define arbitrary new plugin code.
 
 ### Where injections happen: templates as anchors