@exaudeus/workrail 3.41.0 → 3.43.0

package/dist/mcp/tools.d.ts

@@ -27,19 +27,19 @@ export declare const WorkflowNextInput: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
     state: import("../domain/execution/state.js").ExecutionState;
-    context?: Record<string, unknown> | undefined;
     event?: {
         readonly kind: "step_completed";
         readonly stepInstanceId: import("../domain/execution/ids.js").StepInstanceId;
     } | undefined;
+    context?: Record<string, unknown> | undefined;
 }, {
     workflowId: string;
     state: import("../domain/execution/state.js").ExecutionState;
-    context?: Record<string, unknown> | undefined;
     event?: {
         readonly kind: "step_completed";
         readonly stepInstanceId: import("../domain/execution/ids.js").StepInstanceId;
     } | undefined;
+    context?: Record<string, unknown> | undefined;
 }>;
 export type WorkflowNextInput = z.infer<typeof WorkflowNextInput>;
 export declare const WorkflowValidateJsonInput: z.ZodObject<{

package/dist/mcp/v2/tools.d.ts

@@ -34,12 +34,12 @@ export declare const V2StartWorkflowInput: z.ZodObject<{
     goal: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
-    workspacePath: string;
     goal: string;
+    workspacePath: string;
 }, {
     workflowId: string;
-    workspacePath: string;
     goal: string;
+    workspacePath: string;
 }>;
 export type V2StartWorkflowInput = z.infer<typeof V2StartWorkflowInput>;
 export declare const V2ContinueWorkflowInputShape: z.ZodObject<{
@@ -59,22 +59,22 @@ export declare const V2ContinueWorkflowInputShape: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
-}, {
-    continueToken: string;
+    intent?: "rehydrate" | "advance" | undefined;
     context?: Record<string, unknown> | undefined;
     workspacePath?: string | undefined;
+}, {
+    continueToken: string;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
 }>;
 export declare const V2ContinueWorkflowInput: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     workspacePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -95,43 +95,43 @@ export declare const V2ContinueWorkflowInput: z.ZodEffects<z.ZodEffects<z.ZodObj
     contextVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
     contextVariables?: Record<string, unknown> | undefined;
 }, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
     contextVariables?: Record<string, unknown> | undefined;
 }>, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
     contextVariables?: Record<string, unknown> | undefined;
 }, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
     contextVariables?: Record<string, unknown> | undefined;
 }>, {
     workspacePath?: string | undefined;
@@ -140,17 +140,17 @@ export declare const V2ContinueWorkflowInput: z.ZodEffects<z.ZodEffects<z.ZodObj
         artifacts?: unknown[] | undefined;
     } | undefined;
     context?: {} | undefined;
-    intent: "advance" | "rehydrate";
+    intent: "rehydrate" | "advance";
     continueToken: string;
 }, {
     continueToken: string;
-    context?: Record<string, unknown> | undefined;
-    workspacePath?: string | undefined;
     output?: {
         notesMarkdown?: string | undefined;
         artifacts?: unknown[] | undefined;
     } | undefined;
-    intent?: "advance" | "rehydrate" | undefined;
+    intent?: "rehydrate" | "advance" | undefined;
+    context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
     contextVariables?: Record<string, unknown> | undefined;
 }>;
 export type V2ContinueWorkflowInput = z.infer<typeof V2ContinueWorkflowInput>;

package/dist/trigger/delivery-action.d.ts

@@ -11,6 +11,8 @@ export interface HandoffArtifact {
 export interface DeliveryFlags {
     readonly autoCommit?: boolean;
     readonly autoOpenPR?: boolean;
+    readonly sessionId?: string;
+    readonly branchPrefix?: string;
 }
 export type DeliveryResult = {
     readonly _tag: 'committed';

package/dist/trigger/delivery-action.js

@@ -146,6 +146,30 @@ async function runDelivery(artifact, workspacePath, flags, execFn) {
             reason: 'filesChanged is empty -- cannot stage files safely (no git add -A fallback)',
         };
     }
+    if (flags.sessionId) {
+        const expectedBranch = `${flags.branchPrefix ?? 'worktrain/'}${flags.sessionId}`;
+        let headBranch;
+        try {
+            const result = await execFn('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: workspacePath, timeout: DELIVERY_TIMEOUT_MS });
+            headBranch = result.stdout.trim();
+        }
+        catch (e) {
+            return {
+                _tag: 'error',
+                phase: 'commit',
+                details: `HEAD branch check failed (cannot stage): ${formatExecError(e)}`,
+            };
+        }
+        if (headBranch !== expectedBranch) {
+            return {
+                _tag: 'error',
+                phase: 'commit',
+                details: `HEAD branch mismatch: expected "${expectedBranch}" but found "${headBranch}". ` +
+                    `Refusing to stage or push -- the agent may have switched branches. ` +
+                    `Worktree path: ${workspacePath}`,
+            };
+        }
+    }
     const commitMessage = artifact.commitSubject.startsWith(`${artifact.commitType}(`)
         ? artifact.commitSubject
         : `${artifact.commitType}(${artifact.commitScope}): ${artifact.commitSubject}`;

package/dist/trigger/trigger-router.js

@@ -136,7 +136,17 @@ async function maybeRunDelivery(triggerId, trigger, result, execFn) {
             `Ensure the workflow's final step produces a JSON block with commitType, filesChanged, etc.`);
         return;
     }
-    const deliveryResult = await (0, delivery_action_js_1.runDelivery)(parseResult.value, trigger.workspacePath, { autoCommit: trigger.autoCommit, autoOpenPR: trigger.autoOpenPR }, execFn);
+    const deliveryCwd = result.sessionWorkspacePath ?? trigger.workspacePath;
+    const deliveryResult = await (0, delivery_action_js_1.runDelivery)(parseResult.value, deliveryCwd, {
+        autoCommit: trigger.autoCommit,
+        autoOpenPR: trigger.autoOpenPR,
+        ...(trigger.branchStrategy === 'worktree' && result.sessionWorkspacePath
+            ? {
+                sessionId: result.sessionId ?? '',
+                branchPrefix: trigger.branchPrefix ?? 'worktrain/',
+            }
+            : {}),
+    }, execFn);
     switch (deliveryResult._tag) {
         case 'committed':
             console.log(`[TriggerRouter] Delivery committed: triggerId=${triggerId} sha=${deliveryResult.sha}`);
@@ -152,6 +162,16 @@ async function maybeRunDelivery(triggerId, trigger, result, execFn) {
                 `details=${deliveryResult.details}`);
             break;
     }
+    if (trigger.branchStrategy === 'worktree' && result.sessionWorkspacePath) {
+        try {
+            await execFn('git', ['-C', trigger.workspacePath, 'worktree', 'remove', '--force', result.sessionWorkspacePath], { cwd: trigger.workspacePath, timeout: 60000 });
+            console.log(`[TriggerRouter] Worktree removed: triggerId=${triggerId} path=${result.sessionWorkspacePath}`);
+        }
+        catch (err) {
+            console.warn(`[TriggerRouter] Could not remove worktree: triggerId=${triggerId} ` +
+                `path=${result.sessionWorkspacePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
 }
 class Semaphore {
     constructor(max) {
@@ -246,6 +266,9 @@ class TriggerRouter {
             ...(trigger.referenceUrls !== undefined ? { referenceUrls: trigger.referenceUrls } : {}),
             ...(trigger.agentConfig !== undefined ? { agentConfig: trigger.agentConfig } : {}),
             ...(trigger.soulFile !== undefined ? { soulFile: trigger.soulFile } : {}),
+            ...(trigger.branchStrategy !== undefined ? { branchStrategy: trigger.branchStrategy } : {}),
+            ...(trigger.baseBranch !== undefined ? { baseBranch: trigger.baseBranch } : {}),
+            ...(trigger.branchPrefix !== undefined ? { branchPrefix: trigger.branchPrefix } : {}),
         };
         this.emitter?.emit({ kind: 'trigger_fired', triggerId: trigger.id, workflowId: trigger.workflowId });
         const queueKey = trigger.concurrencyMode === 'parallel'

package/dist/trigger/trigger-store.js

@@ -391,6 +391,15 @@ function setTriggerField(trigger, key, value) {
         case 'soulFile':
             trigger.soulFile = value;
             break;
+        case 'branchStrategy':
+            trigger.branchStrategy = value;
+            break;
+        case 'baseBranch':
+            trigger.baseBranch = value;
+            break;
+        case 'branchPrefix':
+            trigger.branchPrefix = value;
+            break;
         default:
             break;
     }
@@ -602,6 +611,36 @@ function validateAndResolveTrigger(raw, env, workspaces = {}) {
         console.warn(`[TriggerStore] Warning: trigger "${rawId}" has autoOpenPR: true but autoCommit is not true. ` +
             `A PR requires a commit -- delivery will be skipped unless autoCommit is also set to true.`);
     }
+    const rawBranchStrategy = raw.branchStrategy?.trim();
+    if (rawBranchStrategy !== undefined && rawBranchStrategy !== 'worktree' && rawBranchStrategy !== 'none') {
+        return (0, result_js_1.err)({
+            kind: 'invalid_field_value',
+            field: `branchStrategy (must be "worktree" or "none", got: "${rawBranchStrategy}")`,
+            triggerId: rawId,
+        });
+    }
+    const branchStrategy = rawBranchStrategy === 'worktree' ? 'worktree' : rawBranchStrategy === 'none' ? 'none' : undefined;
+    const baseBranch = raw.baseBranch?.trim() || undefined;
+    const branchPrefix = raw.branchPrefix?.trim() || undefined;
+    const GIT_SAFE_RE = /^[a-zA-Z0-9._/-]+$/;
+    if (baseBranch !== undefined) {
+        if (!GIT_SAFE_RE.test(baseBranch) || baseBranch.startsWith('-')) {
+            return (0, result_js_1.err)({
+                kind: 'invalid_field_value',
+                field: `baseBranch (must match /^[a-zA-Z0-9._/-]+$/ and not start with "-", got: "${baseBranch}")`,
+                triggerId: rawId,
+            });
+        }
+    }
+    if (branchPrefix !== undefined) {
+        if (!GIT_SAFE_RE.test(branchPrefix) || branchPrefix.startsWith('-')) {
+            return (0, result_js_1.err)({
+                kind: 'invalid_field_value',
+                field: `branchPrefix (must match /^[a-zA-Z0-9._/-]+$/ and not start with "-", got: "${branchPrefix}")`,
+                triggerId: rawId,
+            });
+        }
+    }
     function parsePollIntervalSeconds(raw2, triggerId2) {
         const intervalRaw = raw2.pollIntervalSeconds?.trim();
         if (!intervalRaw)
@@ -741,6 +780,9 @@ function validateAndResolveTrigger(raw, env, workspaces = {}) {
         ...(pollingSource !== undefined ? { pollingSource } : {}),
         ...(resolvedWorkspaceName !== undefined ? { workspaceName: resolvedWorkspaceName } : {}),
         ...(resolvedSoulFile ? { soulFile: resolvedSoulFile } : {}),
+        ...(branchStrategy !== undefined ? { branchStrategy } : {}),
+        ...(baseBranch !== undefined ? { baseBranch } : {}),
+        ...(branchPrefix !== undefined ? { branchPrefix } : {}),
     };
     return (0, result_js_1.ok)(trigger);
 }

package/dist/trigger/types.d.ts

@@ -68,6 +68,9 @@ export interface TriggerDefinition {
     readonly pollingSource?: PollingSource;
     readonly workspaceName?: WorkspaceName;
     readonly soulFile?: string;
+    readonly branchStrategy?: 'worktree' | 'none';
+    readonly baseBranch?: string;
+    readonly branchPrefix?: string;
 }
 export interface TriggerConfig {
     readonly triggers: readonly TriggerDefinition[];

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

@@ -37,16 +37,16 @@ export declare const AssessmentArtifactV1Schema: z.ZodObject<{
         level: string;
         rationale?: string | undefined;
     }>;
-    assessmentId?: string | undefined;
     summary?: string | undefined;
+    assessmentId?: string | undefined;
 }, {
     kind: "wr.assessment";
     dimensions: Record<string, string | {
         level: string;
         rationale?: string | undefined;
     }>;
-    assessmentId?: string | undefined;
     summary?: string | undefined;
+    assessmentId?: string | undefined;
 }>;
 export type AssessmentArtifactV1 = z.infer<typeof AssessmentArtifactV1Schema>;
 export declare function isAssessmentArtifact(artifact: unknown): artifact is {

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

@@ -9,13 +9,13 @@ export declare const CoordinatorSignalArtifactV1Schema: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     kind: "wr.coordinator_signal";
-    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
     payload: Record<string, unknown>;
+    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
     sessionId?: string | undefined;
 }, {
     kind: "wr.coordinator_signal";
-    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
     payload: Record<string, unknown>;
+    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
     sessionId?: string | undefined;
 }>;
 export type CoordinatorSignalArtifactV1 = z.infer<typeof CoordinatorSignalArtifactV1Schema>;

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

@@ -9,14 +9,14 @@ export declare const LoopControlMetadataV1Schema: z.ZodOptional<z.ZodObject<{
     confidence: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     reason?: string | undefined;
+    confidence?: number | undefined;
     issuesFound?: number | undefined;
     iterationIndex?: number | undefined;
-    confidence?: number | undefined;
 }, {
     reason?: string | undefined;
+    confidence?: number | undefined;
     issuesFound?: number | undefined;
     iterationIndex?: number | undefined;
-    confidence?: number | undefined;
 }>>;
 export type LoopControlMetadataV1 = z.infer<typeof LoopControlMetadataV1Schema>;
 export declare const LoopControlArtifactV1Schema: z.ZodObject<{
@@ -30,14 +30,14 @@ export declare const LoopControlArtifactV1Schema: z.ZodObject<{
         confidence: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         reason?: string | undefined;
+        confidence?: number | undefined;
         issuesFound?: number | undefined;
         iterationIndex?: number | undefined;
-        confidence?: number | undefined;
     }, {
         reason?: string | undefined;
+        confidence?: number | undefined;
         issuesFound?: number | undefined;
         iterationIndex?: number | undefined;
-        confidence?: number | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     kind: "wr.loop_control";
@@ -45,9 +45,9 @@ export declare const LoopControlArtifactV1Schema: z.ZodObject<{
     loopId?: string | undefined;
     metadata?: {
         reason?: string | undefined;
+        confidence?: number | undefined;
         issuesFound?: number | undefined;
         iterationIndex?: number | undefined;
-        confidence?: number | undefined;
     } | undefined;
 }, {
     kind: "wr.loop_control";
@@ -55,9 +55,9 @@ export declare const LoopControlArtifactV1Schema: z.ZodObject<{
     loopId?: string | undefined;
     metadata?: {
         reason?: string | undefined;
+        confidence?: number | undefined;
         issuesFound?: number | undefined;
         iterationIndex?: number | undefined;
-        confidence?: number | undefined;
     } | undefined;
 }>;
 export type LoopControlArtifactV1 = z.infer<typeof LoopControlArtifactV1Schema>;

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

@@ -8,30 +8,30 @@ export declare const ReviewVerdictArtifactV1Schema: z.ZodObject<{
         severity: z.ZodEnum<["critical", "major", "minor", "nit"]>;
         summary: z.ZodString;
     }, "strict", z.ZodTypeAny, {
+        severity: "critical" | "minor" | "major" | "nit";
         summary: string;
-        severity: "minor" | "critical" | "major" | "nit";
     }, {
+        severity: "critical" | "minor" | "major" | "nit";
         summary: string;
-        severity: "minor" | "critical" | "major" | "nit";
     }>, "many">;
     summary: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     kind: "wr.review_verdict";
     summary: string;
-    confidence: "high" | "medium" | "low";
+    confidence: "low" | "high" | "medium";
     verdict: "clean" | "minor" | "blocking";
     findings: {
+        severity: "critical" | "minor" | "major" | "nit";
         summary: string;
-        severity: "minor" | "critical" | "major" | "nit";
     }[];
 }, {
     kind: "wr.review_verdict";
     summary: string;
-    confidence: "high" | "medium" | "low";
+    confidence: "low" | "high" | "medium";
     verdict: "clean" | "minor" | "blocking";
     findings: {
+        severity: "critical" | "minor" | "major" | "nit";
         summary: string;
-        severity: "minor" | "critical" | "major" | "nit";
     }[];
 }>;
 export type ReviewVerdictArtifactV1 = z.infer<typeof ReviewVerdictArtifactV1Schema>;