@exaudeus/workrail 3.40.0 → 3.42.0

package/dist/v2/durable-core/schemas/session/gaps.d.ts

@@ -4,38 +4,38 @@ export declare const GapReasonSchema: z.ZodDiscriminatedUnion<"category", [z.Zod
     category: z.ZodLiteral<"user_only_dependency">;
     detail: z.ZodEnum<["needs_user_secret_or_token", "needs_user_account_access", "needs_user_artifact", "needs_user_choice", "needs_user_approval", "needs_user_environment_action"]>;
 }, "strip", z.ZodTypeAny, {
-    detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
     category: "user_only_dependency";
-}, {
     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+}, {
     category: "user_only_dependency";
+    detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
 }>, z.ZodObject<{
     category: z.ZodLiteral<"contract_violation">;
     detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes", "assessment_followup_required"]>;
 }, "strip", z.ZodTypeAny, {
-    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
     category: "contract_violation";
+    detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
 }, {
-    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
     category: "contract_violation";
+    detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
 }>, z.ZodObject<{
     category: z.ZodLiteral<"capability_missing">;
     detail: z.ZodEnum<["required_capability_unavailable", "required_capability_unknown"]>;
 }, "strip", z.ZodTypeAny, {
-    detail: "required_capability_unknown" | "required_capability_unavailable";
     category: "capability_missing";
+    detail: "required_capability_unavailable" | "required_capability_unknown";
 }, {
-    detail: "required_capability_unknown" | "required_capability_unavailable";
     category: "capability_missing";
+    detail: "required_capability_unavailable" | "required_capability_unknown";
 }>, z.ZodObject<{
     category: z.ZodLiteral<"unexpected">;
     detail: z.ZodEnum<["invariant_violation", "storage_corruption_detected", "evaluation_error"]>;
 }, "strip", z.ZodTypeAny, {
-    detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
     category: "unexpected";
-}, {
     detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
+}, {
     category: "unexpected";
+    detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
 }>]>;
 export declare const GapResolutionSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"unresolved">;
@@ -79,38 +79,38 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
         category: z.ZodLiteral<"user_only_dependency">;
         detail: z.ZodEnum<["needs_user_secret_or_token", "needs_user_account_access", "needs_user_artifact", "needs_user_choice", "needs_user_approval", "needs_user_environment_action"]>;
     }, "strip", z.ZodTypeAny, {
-        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
         category: "user_only_dependency";
-    }, {
         detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+    }, {
         category: "user_only_dependency";
+        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
     }>, z.ZodObject<{
         category: z.ZodLiteral<"contract_violation">;
         detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes", "assessment_followup_required"]>;
     }, "strip", z.ZodTypeAny, {
-        detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
         category: "contract_violation";
+        detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
     }, {
-        detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
         category: "contract_violation";
+        detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
     }>, z.ZodObject<{
         category: z.ZodLiteral<"capability_missing">;
         detail: z.ZodEnum<["required_capability_unavailable", "required_capability_unknown"]>;
     }, "strip", z.ZodTypeAny, {
-        detail: "required_capability_unknown" | "required_capability_unavailable";
         category: "capability_missing";
+        detail: "required_capability_unavailable" | "required_capability_unknown";
     }, {
-        detail: "required_capability_unknown" | "required_capability_unavailable";
         category: "capability_missing";
+        detail: "required_capability_unavailable" | "required_capability_unknown";
     }>, z.ZodObject<{
         category: z.ZodLiteral<"unexpected">;
         detail: z.ZodEnum<["invariant_violation", "storage_corruption_detected", "evaluation_error"]>;
     }, "strip", z.ZodTypeAny, {
-        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
         category: "unexpected";
-    }, {
         detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
+    }, {
         category: "unexpected";
+        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
     }>]>;
     summary: z.ZodString;
     resolution: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -149,28 +149,28 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
         outputId: string;
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    summary: string;
+    gapId: string;
+    severity: "info" | "warning" | "critical";
     reason: {
-        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
         category: "user_only_dependency";
+        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
     } | {
-        detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
         category: "contract_violation";
+        detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
     } | {
-        detail: "required_capability_unknown" | "required_capability_unavailable";
         category: "capability_missing";
+        detail: "required_capability_unavailable" | "required_capability_unknown";
     } | {
-        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
         category: "unexpected";
+        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
     };
-    severity: "critical" | "info" | "warning";
+    summary: string;
     resolution: {
         kind: "unresolved";
     } | {
         kind: "resolves";
         resolvesGapId: string;
     };
-    gapId: string;
     evidenceRefs?: ({
         kind: "event";
         eventId: string;
@@ -179,28 +179,28 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
         outputId: string;
     })[] | undefined;
 }, {
-    summary: string;
+    gapId: string;
+    severity: "info" | "warning" | "critical";
     reason: {
-        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
         category: "user_only_dependency";
+        detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
     } | {
-        detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
         category: "contract_violation";
+        detail: "missing_required_output" | "invalid_required_output" | "missing_required_notes" | "assessment_followup_required";
     } | {
-        detail: "required_capability_unknown" | "required_capability_unavailable";
         category: "capability_missing";
+        detail: "required_capability_unavailable" | "required_capability_unknown";
     } | {
-        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
         category: "unexpected";
+        detail: "invariant_violation" | "storage_corruption_detected" | "evaluation_error";
     };
-    severity: "critical" | "info" | "warning";
+    summary: string;
     resolution: {
         kind: "unresolved";
     } | {
         kind: "resolves";
         resolvesGapId: string;
     };
-    gapId: string;
     evidenceRefs?: ({
         kind: "event";
         eventId: string;

package/dist/v2/durable-core/schemas/session/manifest.d.ts

@@ -11,23 +11,23 @@ export declare const ManifestRecordV1Schema: z.ZodDiscriminatedUnion<"kind", [z.
     bytes: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     kind: "segment_closed";
-    sessionId: string;
     v: 1;
-    sha256: string;
     manifestIndex: number;
+    sessionId: string;
     firstEventIndex: number;
     lastEventIndex: number;
     segmentRelPath: string;
+    sha256: string;
     bytes: number;
 }, {
     kind: "segment_closed";
-    sessionId: string;
     v: 1;
-    sha256: string;
     manifestIndex: number;
+    sessionId: string;
     firstEventIndex: number;
     lastEventIndex: number;
     segmentRelPath: string;
+    sha256: string;
     bytes: number;
 }>, z.ZodObject<{
     v: z.ZodLiteral<1>;
@@ -39,17 +39,17 @@ export declare const ManifestRecordV1Schema: z.ZodDiscriminatedUnion<"kind", [z.
     createdByEventId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     kind: "snapshot_pinned";
-    sessionId: string;
     v: 1;
     manifestIndex: number;
+    sessionId: string;
     eventIndex: number;
     snapshotRef: string;
     createdByEventId: string;
 }, {
     kind: "snapshot_pinned";
-    sessionId: string;
     v: 1;
     manifestIndex: number;
+    sessionId: string;
     eventIndex: number;
     snapshotRef: string;
     createdByEventId: string;

package/dist/v2/durable-core/schemas/session/outputs.d.ts

@@ -90,6 +90,8 @@ export declare const NodeOutputAppendedDataV1Schema: z.ZodEffects<z.ZodObject<{
         content?: unknown;
     }>]>;
 }, "strip", z.ZodTypeAny, {
+    outputId: string;
+    outputChannel: "recap" | "artifact";
     payload: {
         payloadKind: "notes";
         notesMarkdown: string;
@@ -100,10 +102,10 @@ export declare const NodeOutputAppendedDataV1Schema: z.ZodEffects<z.ZodObject<{
         byteLength: number;
         content?: unknown;
     };
-    outputId: string;
-    outputChannel: "recap" | "artifact";
     supersedesOutputId?: string | undefined;
 }, {
+    outputId: string;
+    outputChannel: "recap" | "artifact";
     payload: {
         payloadKind: "notes";
         notesMarkdown: string;
@@ -114,10 +116,10 @@ export declare const NodeOutputAppendedDataV1Schema: z.ZodEffects<z.ZodObject<{
         byteLength: number;
         content?: unknown;
     };
-    outputId: string;
-    outputChannel: "recap" | "artifact";
     supersedesOutputId?: string | undefined;
 }>, {
+    outputId: string;
+    outputChannel: "recap" | "artifact";
     payload: {
         payloadKind: "notes";
         notesMarkdown: string;
@@ -128,10 +130,10 @@ export declare const NodeOutputAppendedDataV1Schema: z.ZodEffects<z.ZodObject<{
         byteLength: number;
         content?: unknown;
     };
-    outputId: string;
-    outputChannel: "recap" | "artifact";
     supersedesOutputId?: string | undefined;
 }, {
+    outputId: string;
+    outputChannel: "recap" | "artifact";
     payload: {
         payloadKind: "notes";
         notesMarkdown: string;
@@ -142,7 +144,5 @@ export declare const NodeOutputAppendedDataV1Schema: z.ZodEffects<z.ZodObject<{
         byteLength: number;
         content?: unknown;
     };
-    outputId: string;
-    outputChannel: "recap" | "artifact";
     supersedesOutputId?: string | undefined;
 }>;

package/dist/v2/durable-core/schemas/session/validation-event.d.ts

@@ -46,23 +46,23 @@ export declare const ValidationPerformedDataV1Schema: z.ZodObject<{
         suggestions: readonly string[];
     }>;
 }, "strict", z.ZodTypeAny, {
+    validationId: string;
+    attemptId: string;
     contractRef: string;
     result: {
         issues: readonly string[];
         valid: boolean;
         suggestions: readonly string[];
     };
+}, {
     validationId: string;
     attemptId: string;
-}, {
     contractRef: string;
     result: {
         issues: readonly string[];
         valid: boolean;
         suggestions: readonly string[];
     };
-    validationId: string;
-    attemptId: string;
 }>;
 export type ValidationPerformedDataV1 = z.infer<typeof ValidationPerformedDataV1Schema>;
 export type ValidationPerformedResultV1 = z.infer<typeof ValidationPerformedResultV1Schema>;

package/dist/v2/usecases/console-routes.d.ts

@@ -4,4 +4,5 @@ import type { WorkflowService } from '../../application/services/workflow-servic
 import type { ToolCallTimingRingBuffer } from '../../mcp/tool-call-timing.js';
 import type { TriggerRouter } from '../../trigger/trigger-router.js';
 import type { V2ToolContext } from '../../mcp/types.js';
-export declare function mountConsoleRoutes(app: Application, consoleService: ConsoleService, workflowService?: WorkflowService, timingRingBuffer?: ToolCallTimingRingBuffer, toolCallsPerfFile?: string, serverVersion?: string, v2ToolContext?: V2ToolContext, triggerRouter?: TriggerRouter): () => void;
+import type { SteerRegistry } from '../../daemon/workflow-runner.js';
+export declare function mountConsoleRoutes(app: Application, consoleService: ConsoleService, workflowService?: WorkflowService, timingRingBuffer?: ToolCallTimingRingBuffer, toolCallsPerfFile?: string, serverVersion?: string, v2ToolContext?: V2ToolContext, triggerRouter?: TriggerRouter, steerRegistry?: SteerRegistry): () => void;

package/dist/v2/usecases/console-routes.js

@@ -45,6 +45,7 @@ const worktree_service_js_1 = require("./worktree-service.js");
 const workflow_js_1 = require("../../types/workflow.js");
 const dev_mode_js_1 = require("../../mcp/dev-mode.js");
 const workflow_runner_js_1 = require("../../daemon/workflow-runner.js");
+const assert_never_js_1 = require("../../runtime/assert-never.js");
 const start_js_1 = require("../../mcp/handlers/v2-execution/start.js");
 const v2_token_ops_js_1 = require("../../mcp/handlers/v2-token-ops.js");
 function watchSessionsDir(sessionsDir, onChanged) {
@@ -90,7 +91,7 @@ function loadWorkflowTags() {
         return { version: 0, tags: [], workflows: {} };
     }
 }
-function mountConsoleRoutes(app, consoleService, workflowService, timingRingBuffer, toolCallsPerfFile, serverVersion, v2ToolContext, triggerRouter) {
+function mountConsoleRoutes(app, consoleService, workflowService, timingRingBuffer, toolCallsPerfFile, serverVersion, v2ToolContext, triggerRouter, steerRegistry) {
     const sseClients = new Set();
     let sseDebounceTimer = null;
     function broadcastChange() {
@@ -590,18 +591,21 @@ function mountConsoleRoutes(app, consoleService, workflowService, timingRingBuff
             triggerRouter.dispatch(trigger);
         }
         else {
-            void (0, workflow_runner_js_1.runWorkflow)(trigger, v2ToolContext, apiKey ?? '').then((result) => {
+            void (0, workflow_runner_js_1.runWorkflow)(trigger, v2ToolContext, apiKey ?? '', undefined, undefined, steerRegistry).then((result) => {
                 if (result._tag === 'success') {
                     console.log(`[ConsoleRoutes] Auto dispatch completed: workflowId=${workflowId} stopReason=${result.stopReason}`);
                 }
+                else if (result._tag === 'delivery_failed') {
+                    console.log(`[ConsoleRoutes] Auto dispatch delivery failed: workflowId=${workflowId}`);
+                }
                 else if (result._tag === 'timeout') {
                     console.log(`[ConsoleRoutes] Auto dispatch timed out: workflowId=${workflowId}`);
                 }
-                else if (result._tag === 'delivery_failed') {
-                    console.log(`[ConsoleRoutes] Auto dispatch delivery failed: workflowId=${workflowId}`);
+                else if (result._tag === 'error') {
+                    console.log(`[ConsoleRoutes] Auto dispatch failed: workflowId=${workflowId} error=${result.message}`);
                 }
                 else {
-                    console.log(`[ConsoleRoutes] Auto dispatch failed: workflowId=${workflowId} error=${result.message}`);
+                    (0, assert_never_js_1.assertNever)(result);
                 }
             });
         }
@@ -621,6 +625,26 @@ function mountConsoleRoutes(app, consoleService, workflowService, timingRingBuff
         }));
         res.json({ success: true, data: { triggers } });
     });
+    app.post('/api/v2/sessions/:sessionId/steer', express_1.default.json(), (req, res) => {
+        if (!steerRegistry) {
+            res.status(503).json({ success: false, error: 'Steer not available (not a daemon context).' });
+            return;
+        }
+        const { sessionId } = req.params;
+        const body = req.body;
+        const text = typeof body.text === 'string' ? body.text.trim() : '';
+        if (!text) {
+            res.status(400).json({ success: false, error: 'text is required and must be a non-empty string.' });
+            return;
+        }
+        const callback = steerRegistry.get(sessionId);
+        if (!callback) {
+            res.status(404).json({ success: false, error: 'Session not found or not a daemon session.' });
+            return;
+        }
+        callback(text);
+        res.json({ success: true });
+    });
     const consoleDist = resolveConsoleDist();
     if (consoleDist) {
         app.use('/console', express_1.default.static(consoleDist, {

package/dist/v2/usecases/console-service.js

@@ -585,6 +585,17 @@ function extractRepoRoot(events) {
     }
     return workspacePathFallback;
 }
+function extractParentSessionId(events) {
+    for (const e of events) {
+        if (e.kind === constants_js_1.EVENT_KIND.SESSION_CREATED) {
+            const parentId = e.data.parentSessionId;
+            if (typeof parentId === 'string' && parentId.length > 0)
+                return parentId;
+            return null;
+        }
+    }
+    return null;
+}
 function truncateTitle(text, maxLen = 120) {
     if (text.length <= maxLen)
         return text;
@@ -612,6 +623,7 @@ function projectSessionSummary(sessionId, truth, completionByRunId, workflowName
     const sessionTitle = sortedEventsRes.isOk() ? deriveSessionTitle(sortedEventsRes.value) : null;
     const gitBranch = extractGitBranch(events);
     const repoRoot = extractRepoRoot(events);
+    const parentSessionId = extractParentSessionId(events);
     const isAutonomous = (() => {
         if (!sortedEventsRes.isOk())
             return false;
@@ -643,6 +655,7 @@ function projectSessionSummary(sessionId, truth, completionByRunId, workflowName
             lastModifiedMs,
             isAutonomous,
             isLive,
+            parentSessionId,
         };
     }
     const workflow = run.workflow;
@@ -688,6 +701,7 @@ function projectSessionSummary(sessionId, truth, completionByRunId, workflowName
         lastModifiedMs,
         isAutonomous,
         isLive,
+        parentSessionId,
     };
 }
 function projectSessionDetail(sessionId, truth, completionByRunId, stepLabels, workflowNames, skippedStepsMap = {}) {

package/dist/v2/usecases/console-types.d.ts

@@ -20,6 +20,7 @@ export interface ConsoleSessionSummary {
     readonly lastModifiedMs: number;
     readonly isAutonomous: boolean;
     readonly isLive: boolean;
+    readonly parentSessionId: string | null;
 }
 export interface ConsoleSessionListResponse {
     readonly sessions: readonly ConsoleSessionSummary[];

package/docs/authoring.md

@@ -42,7 +42,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 **Source refs**
 - `spec/workflow.schema.json` (schema) — Legal structure and supported fields.
 - `src/application/services/validation-engine.ts` (runtime) — Validator-enforced authoring rules.
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Current modern example.
+- `workflows/coding-task-workflow-agentic.json` (example) — Current modern example.
 
 ### validate-early-and-often
 - **Level**: required
@@ -141,7 +141,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Part A / Part B / Rules: ... when the structure adds ceremony rather than clarity
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — See the sharpened user-voiced prompts in the current lean coding workflow.
+- `workflows/coding-task-workflow-agentic.json` — See the sharpened user-voiced prompts in the current lean coding workflow.
 
 ### protocol-footers-stay-explicit
 - **Level**: required
@@ -160,10 +160,10 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Replacing exact capture requirements with vague summary prose
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Uses compact Capture footers and explicit loop-control wording.
+- `workflows/coding-task-workflow-agentic.json` — Uses compact Capture footers and explicit loop-control wording.
 
 **Source refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Uses explicit capture footers and shape-preserving loop outputs.
+- `workflows/coding-task-workflow-agentic.json` (example) — Uses explicit capture footers and shape-preserving loop outputs.
 
 
 ## Prompt composition
@@ -185,11 +185,11 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Encoding runtime logic in prose when promptFragments or templates are the right mechanism
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Uses prompt fragments and context templates to keep prompts slimmer at render time.
+- `workflows/coding-task-workflow-agentic.json` — Uses prompt fragments and context templates to keep prompts slimmer at render time.
 
 **Source refs**
 - `docs/authoring.md` (documentation) — Documents context templates and prompt fragments.
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Uses prompt fragments to slim mode-specific prompt branches.
+- `workflows/coding-task-workflow-agentic.json` (example) — Uses prompt fragments to slim mode-specific prompt branches.
 
 ### templates-are-for-simple-substitution
 - **Level**: recommended
@@ -405,11 +405,11 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Prompt text says to stop, but the example output only permits continue
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Current loop decision steps show shape-only output examples.
+- `workflows/coding-task-workflow-agentic.json` — Current loop decision steps show shape-only output examples.
 
 **Source refs**
 - `scripts/validate-workflows-registry.ts` (validator) — Registry validation should preserve semantically correct discoverable workflows.
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Current loop decision prompts show shape-only output examples.
+- `workflows/coding-task-workflow-agentic.json` (example) — Current loop decision prompts show shape-only output examples.
 
 ### loops-need-real-exit-rules
 - **Level**: required
@@ -445,7 +445,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - `contextAuditNeeded = true|false` without an explicit rubric
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Phase 0 uses a context-clarity rubric instead of a vibes-only confidence flag.
+- `workflows/coding-task-workflow-agentic.json` — Phase 0 uses a context-clarity rubric instead of a vibes-only confidence flag.
 
 
 ## Confirmation discipline
@@ -466,7 +466,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Using requireConfirmation as a substitute for clear loop or rigor policy
 
 **Source refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Uses confirmation for real review barriers like MultiPR checkpoints.
+- `workflows/coding-task-workflow-agentic.json` (example) — Uses confirmation for real review barriers like MultiPR checkpoints.
 
 
 ## Assessment gates
@@ -544,7 +544,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Treating named builder or researcher roles as alternate owners
 
 **Source refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Delegation checkpoints keep the main agent as the synthesizer and decision-maker.
+- `workflows/coding-task-workflow-agentic.json` (example) — Delegation checkpoints keep the main agent as the synthesizer and decision-maker.
 
 ### batched-checkpoints-over-ad-hoc-optionality
 - **Level**: recommended
@@ -563,7 +563,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Optional challenge wording at high-value decision points
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Uses explicit challenge, audit, and verification barriers.
+- `workflows/coding-task-workflow-agentic.json` — Uses explicit challenge, audit, and verification barriers.
 
 
 ## Subagent synthesis and claim adoption
@@ -601,10 +601,10 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Using delegated findings as blockers or green lights without verification
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Major synthesis checkpoints use Confirmed / Plausible / Rejected for decision-driving findings.
+- `workflows/coding-task-workflow-agentic.json` — Major synthesis checkpoints use Confirmed / Plausible / Rejected for decision-driving findings.
 
 **Source refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` (example) — Major synthesis checkpoints use Confirmed / Plausible / Rejected for adopted claims.
+- `workflows/coding-task-workflow-agentic.json` (example) — Major synthesis checkpoints use Confirmed / Plausible / Rejected for adopted claims.
 
 
 ## Discouraged legacy patterns
@@ -670,7 +670,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Keeping a canonical example ref after the workflow has drifted into a legacy style
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Current example of modern prompt composition, delegation barriers, and loop semantics.
+- `workflows/coding-task-workflow-agentic.json` — Current example of modern prompt composition, delegation barriers, and loop semantics.
 
 
 ## Validation
@@ -728,7 +728,7 @@ Canonical current rules for authoring good WorkRail workflows. workflow.schema.j
 - Verification steps check one artifact while planning updates a different one
 
 **Example refs**
-- `workflows/coding-task-workflow-agentic.lean.v2.json` — Uses explicit spec vs implementation-plan ownership.
+- `workflows/coding-task-workflow-agentic.json` — Uses explicit spec vs implementation-plan ownership.
 
 
 ## Planned guidance