agent-dealer 1.2.7 → 1.2.9

package/bundle/shared/dist/issues.d.ts

@@ -3,6 +3,12 @@ export declare const IssueStatus: z.ZodEnum<["ready", "developing", "reviewing",
 export type IssueStatus = z.infer<typeof IssueStatus>;
 export declare const IssueOwner: z.ZodEnum<["human", "developer", "reviewer", "system"]>;
 export type IssueOwner = z.infer<typeof IssueOwner>;
+/**
+ * NOT-313: default CI-repair budget — a failing CI check is the expected feedback
+ * loop, not an infrastructure failure, so it spends `ci_attempts` (bounded by this),
+ * never `infra_attempts`. Mirrors the infra default (3) deliberately.
+ */
+export declare const DEFAULT_MAX_CI_ATTEMPTS = 3;
 /** "agent" covers an issue a coding agent created via the API/CLI (PRD §5). */
 export declare const IssueSource: z.ZodEnum<["manual", "linear", "agent"]>;
 export type IssueSource = z.infer<typeof IssueSource>;
@@ -15,6 +21,49 @@ export declare const Issue: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     acceptanceCriteria: z.ZodNullable<z.ZodString>;
+    /**
+     * NOT-306: compiled execution contract derived from the ticket description
+     * (canonical `##` headings). Derived data — the description stays the source
+     * of truth — null for legacy/contract-free issues. Optional so previously
+     * stored rows and existing fixtures parse unchanged.
+     */
+    executionContract: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<"v1">;
+        executionMode: z.ZodEnum<["feature", "bug fix", "refactor", "investigation", "split child"]>;
+        nonGoals: z.ZodArray<z.ZodString, "many">;
+        exitPredicate: z.ZodString;
+        onePrStoppingPoint: z.ZodString;
+        acceptanceCriteria: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            evidence: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            evidence: string | null;
+        }, {
+            text: string;
+            evidence: string | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    }, {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    }>>>;
     /**
      * Portable GitHub identity (`github.com/owner/repo`) for new issues (NOT-149).
      * Legacy rows may still hold a local filesystem path until explicitly migrated —
@@ -32,6 +81,14 @@ export declare const Issue: z.ZodObject<{
     /** 0 is a valid policy: no automatic infra retry, escalate to a human immediately. */
     maxInfraAttempts: z.ZodNumber;
     infraAttempts: z.ZodNumber;
+    /**
+     * NOT-313: separate CI-repair budget. `checks_failed` spends `ciAttempts`
+     * (bounded by `maxCiAttempts`), every other retryable failure spends
+     * `infraAttempts`. 0 means no automatic CI repair — escalate immediately.
+     * Deliberately absent from CreateIssueInput/UpdateIssueInput (no per-ticket config).
+     */
+    maxCiAttempts: z.ZodNumber;
+    ciAttempts: z.ZodNumber;
     branch: z.ZodNullable<z.ZodString>;
     baseSha: z.ZodNullable<z.ZodString>;
     headSha: z.ZodNullable<z.ZodString>;
@@ -52,13 +109,13 @@ export declare const Issue: z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     repo: string;
+    acceptanceCriteria: string | null;
+    description: string | null;
     title: string;
     source: "manual" | "linear" | "agent";
     externalId: string | null;
     externalLabel: string | null;
     externalUrl: string | null;
-    description: string | null;
-    acceptanceCriteria: string | null;
     baseBranch: string;
     currentOwner: "reviewer" | "developer" | "human" | "system";
     currentIntent: string | null;
@@ -68,11 +125,24 @@ export declare const Issue: z.ZodObject<{
     currentRound: number;
     maxInfraAttempts: number;
     infraAttempts: number;
+    maxCiAttempts: number;
+    ciAttempts: number;
     baseSha: string | null;
     headSha: string | null;
     prNumber: number | null;
     prUrl: string | null;
     autoMerge: boolean;
+    executionContract?: {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    } | null | undefined;
 }, {
     branch: string | null;
     status: "final_review" | "done" | "ready" | "developing" | "reviewing" | "repairing" | "needs_human" | "closed";
@@ -80,13 +150,13 @@ export declare const Issue: z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     repo: string;
+    acceptanceCriteria: string | null;
+    description: string | null;
     title: string;
     source: "manual" | "linear" | "agent";
     externalId: string | null;
     externalLabel: string | null;
     externalUrl: string | null;
-    description: string | null;
-    acceptanceCriteria: string | null;
     baseBranch: string;
     currentOwner: "reviewer" | "developer" | "human" | "system";
     currentIntent: string | null;
@@ -96,11 +166,24 @@ export declare const Issue: z.ZodObject<{
     currentRound: number;
     maxInfraAttempts: number;
     infraAttempts: number;
+    maxCiAttempts: number;
+    ciAttempts: number;
     baseSha: string | null;
     headSha: string | null;
     prNumber: number | null;
     prUrl: string | null;
     autoMerge: boolean;
+    executionContract?: {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    } | null | undefined;
 }>;
 export type Issue = z.infer<typeof Issue>;
 export declare const CreateIssueInput: z.ZodObject<{
@@ -137,22 +220,22 @@ export declare const CreateIssueInput: z.ZodObject<{
     maxInfraAttempts: number;
     autoMerge: boolean;
     enqueue: boolean;
+    acceptanceCriteria?: string | undefined;
+    description?: string | undefined;
     externalId?: string | undefined;
     externalLabel?: string | undefined;
     externalUrl?: string | undefined;
-    description?: string | undefined;
-    acceptanceCriteria?: string | undefined;
 }, {
     repo: string;
     title: string;
     developerAgentId: string;
     reviewerAgentId: string;
+    acceptanceCriteria?: string | undefined;
+    description?: string | undefined;
     source?: "manual" | "linear" | "agent" | undefined;
     externalId?: string | undefined;
     externalLabel?: string | undefined;
     externalUrl?: string | undefined;
-    description?: string | undefined;
-    acceptanceCriteria?: string | undefined;
     baseBranch?: string | undefined;
     maxReviewRounds?: number | undefined;
     maxInfraAttempts?: number | undefined;
@@ -176,9 +259,9 @@ export declare const UpdateIssueInput: z.ZodObject<{
     autoMerge: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     repo?: string | undefined;
-    title?: string | undefined;
-    description?: string | null | undefined;
     acceptanceCriteria?: string | null | undefined;
+    description?: string | null | undefined;
+    title?: string | undefined;
     baseBranch?: string | undefined;
     developerAgentId?: string | undefined;
     reviewerAgentId?: string | undefined;
@@ -187,9 +270,9 @@ export declare const UpdateIssueInput: z.ZodObject<{
     autoMerge?: boolean | undefined;
 }, {
     repo?: string | undefined;
-    title?: string | undefined;
-    description?: string | null | undefined;
     acceptanceCriteria?: string | null | undefined;
+    description?: string | null | undefined;
+    title?: string | undefined;
     baseBranch?: string | undefined;
     developerAgentId?: string | undefined;
     reviewerAgentId?: string | undefined;
@@ -239,6 +322,49 @@ export declare const CreateIssueResult: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     acceptanceCriteria: z.ZodNullable<z.ZodString>;
+    /**
+     * NOT-306: compiled execution contract derived from the ticket description
+     * (canonical `##` headings). Derived data — the description stays the source
+     * of truth — null for legacy/contract-free issues. Optional so previously
+     * stored rows and existing fixtures parse unchanged.
+     */
+    executionContract: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<"v1">;
+        executionMode: z.ZodEnum<["feature", "bug fix", "refactor", "investigation", "split child"]>;
+        nonGoals: z.ZodArray<z.ZodString, "many">;
+        exitPredicate: z.ZodString;
+        onePrStoppingPoint: z.ZodString;
+        acceptanceCriteria: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            evidence: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            evidence: string | null;
+        }, {
+            text: string;
+            evidence: string | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    }, {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    }>>>;
     /**
      * Portable GitHub identity (`github.com/owner/repo`) for new issues (NOT-149).
      * Legacy rows may still hold a local filesystem path until explicitly migrated —
@@ -256,6 +382,14 @@ export declare const CreateIssueResult: z.ZodObject<{
     /** 0 is a valid policy: no automatic infra retry, escalate to a human immediately. */
     maxInfraAttempts: z.ZodNumber;
     infraAttempts: z.ZodNumber;
+    /**
+     * NOT-313: separate CI-repair budget. `checks_failed` spends `ciAttempts`
+     * (bounded by `maxCiAttempts`), every other retryable failure spends
+     * `infraAttempts`. 0 means no automatic CI repair — escalate immediately.
+     * Deliberately absent from CreateIssueInput/UpdateIssueInput (no per-ticket config).
+     */
+    maxCiAttempts: z.ZodNumber;
+    ciAttempts: z.ZodNumber;
     branch: z.ZodNullable<z.ZodString>;
     baseSha: z.ZodNullable<z.ZodString>;
     headSha: z.ZodNullable<z.ZodString>;
@@ -286,13 +420,13 @@ export declare const CreateIssueResult: z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     repo: string;
+    acceptanceCriteria: string | null;
+    description: string | null;
     title: string;
     source: "manual" | "linear" | "agent";
     externalId: string | null;
     externalLabel: string | null;
     externalUrl: string | null;
-    description: string | null;
-    acceptanceCriteria: string | null;
     baseBranch: string;
     currentOwner: "reviewer" | "developer" | "human" | "system";
     currentIntent: string | null;
@@ -302,6 +436,8 @@ export declare const CreateIssueResult: z.ZodObject<{
     currentRound: number;
     maxInfraAttempts: number;
     infraAttempts: number;
+    maxCiAttempts: number;
+    ciAttempts: number;
     baseSha: string | null;
     headSha: string | null;
     prNumber: number | null;
@@ -310,6 +446,17 @@ export declare const CreateIssueResult: z.ZodObject<{
     created: boolean;
     queue: "enqueued" | "already_queued" | "not_queued";
     priorPasses: number;
+    executionContract?: {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    } | null | undefined;
 }, {
     branch: string | null;
     status: "final_review" | "done" | "ready" | "developing" | "reviewing" | "repairing" | "needs_human" | "closed";
@@ -317,13 +464,13 @@ export declare const CreateIssueResult: z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     repo: string;
+    acceptanceCriteria: string | null;
+    description: string | null;
     title: string;
     source: "manual" | "linear" | "agent";
     externalId: string | null;
     externalLabel: string | null;
     externalUrl: string | null;
-    description: string | null;
-    acceptanceCriteria: string | null;
     baseBranch: string;
     currentOwner: "reviewer" | "developer" | "human" | "system";
     currentIntent: string | null;
@@ -333,6 +480,8 @@ export declare const CreateIssueResult: z.ZodObject<{
     currentRound: number;
     maxInfraAttempts: number;
     infraAttempts: number;
+    maxCiAttempts: number;
+    ciAttempts: number;
     baseSha: string | null;
     headSha: string | null;
     prNumber: number | null;
@@ -341,6 +490,17 @@ export declare const CreateIssueResult: z.ZodObject<{
     created: boolean;
     queue: "enqueued" | "already_queued" | "not_queued";
     priorPasses: number;
+    executionContract?: {
+        version: "v1";
+        executionMode: "feature" | "bug fix" | "refactor" | "investigation" | "split child";
+        nonGoals: string[];
+        exitPredicate: string;
+        onePrStoppingPoint: string;
+        acceptanceCriteria: {
+            text: string;
+            evidence: string | null;
+        }[];
+    } | null | undefined;
 }>;
 export type CreateIssueResult = z.infer<typeof CreateIssueResult>;
 /** 409 body when a re-import collides with a live issue — mirrors the runs promote path. */

package/bundle/shared/dist/issues.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { GitHubRepoInput } from "./github-repo.js";
+import { ExecutionContractV1 } from "./execution-contract.js";
 export const IssueStatus = z.enum([
     "ready",
     "developing",
@@ -11,6 +12,12 @@ export const IssueStatus = z.enum([
     "closed",
 ]);
 export const IssueOwner = z.enum(["human", "developer", "reviewer", "system"]);
+/**
+ * NOT-313: default CI-repair budget — a failing CI check is the expected feedback
+ * loop, not an infrastructure failure, so it spends `ci_attempts` (bounded by this),
+ * never `infra_attempts`. Mirrors the infra default (3) deliberately.
+ */
+export const DEFAULT_MAX_CI_ATTEMPTS = 3;
 /** "agent" covers an issue a coding agent created via the API/CLI (PRD §5). */
 export const IssueSource = z.enum(["manual", "linear", "agent"]);
 export const Issue = z.object({
@@ -22,6 +29,13 @@ export const Issue = z.object({
     title: z.string(),
     description: z.string().nullable(),
     acceptanceCriteria: z.string().nullable(),
+    /**
+     * NOT-306: compiled execution contract derived from the ticket description
+     * (canonical `##` headings). Derived data — the description stays the source
+     * of truth — null for legacy/contract-free issues. Optional so previously
+     * stored rows and existing fixtures parse unchanged.
+     */
+    executionContract: ExecutionContractV1.nullable().optional(),
     /**
      * Portable GitHub identity (`github.com/owner/repo`) for new issues (NOT-149).
      * Legacy rows may still hold a local filesystem path until explicitly migrated —
@@ -39,6 +53,14 @@ export const Issue = z.object({
     /** 0 is a valid policy: no automatic infra retry, escalate to a human immediately. */
     maxInfraAttempts: z.number().int().min(0),
     infraAttempts: z.number().int().min(0),
+    /**
+     * NOT-313: separate CI-repair budget. `checks_failed` spends `ciAttempts`
+     * (bounded by `maxCiAttempts`), every other retryable failure spends
+     * `infraAttempts`. 0 means no automatic CI repair — escalate immediately.
+     * Deliberately absent from CreateIssueInput/UpdateIssueInput (no per-ticket config).
+     */
+    maxCiAttempts: z.number().int().min(0),
+    ciAttempts: z.number().int().min(0),
     branch: z.string().nullable(),
     baseSha: z.string().nullable(),
     headSha: z.string().nullable(),

package/bundle/shared/dist/issues.test.js

@@ -27,6 +27,7 @@ test("Issue schema parses a well-formed issue", () => {
         title: "Fix login bug",
         description: null,
         acceptanceCriteria: null,
+        executionContract: null,
         repo: "acme/app",
         baseBranch: "main",
         status: "ready",
@@ -38,6 +39,8 @@ test("Issue schema parses a well-formed issue", () => {
         currentRound: 1,
         maxInfraAttempts: 3,
         infraAttempts: 0,
+        maxCiAttempts: 3,
+        ciAttempts: 0,
         branch: null,
         baseSha: null,
         headSha: null,

package/bundle/shared/dist/outbound-draft.d.ts

@@ -5,11 +5,11 @@ export declare const OutboundDraftSummary: z.ZodObject<{
     target: z.ZodString;
     body: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    target: string;
     body: string;
-}, {
     target: string;
+}, {
     body: string;
+    target: string;
 }>;
 export type OutboundDraftSummary = z.infer<typeof OutboundDraftSummary>;
 export declare const OutboundToolCall: z.ZodObject<{
@@ -33,11 +33,11 @@ export declare const OutboundDraftBlock: z.ZodObject<{
         target: z.ZodString;
         body: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        target: string;
         body: string;
-    }, {
         target: string;
+    }, {
         body: string;
+        target: string;
     }>;
     toolCall: z.ZodObject<{
         serviceName: z.ZodString;
@@ -55,8 +55,8 @@ export declare const OutboundDraftBlock: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     actionType: "slack_message" | "email" | "service_tool_call";
     summary: {
-        target: string;
         body: string;
+        target: string;
     };
     toolCall: {
         serviceName: string;
@@ -66,8 +66,8 @@ export declare const OutboundDraftBlock: z.ZodObject<{
 }, {
     actionType: "slack_message" | "email" | "service_tool_call";
     summary: {
-        target: string;
         body: string;
+        target: string;
     };
     toolCall: {
         serviceName: string;
@@ -86,11 +86,11 @@ export declare const OutboundDraftContent: z.ZodObject<{
             target: z.ZodString;
             body: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            target: string;
             body: string;
-        }, {
             target: string;
+        }, {
             body: string;
+            target: string;
         }>;
         toolCall: z.ZodObject<{
             serviceName: z.ZodString;
@@ -108,8 +108,8 @@ export declare const OutboundDraftContent: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         actionType: "slack_message" | "email" | "service_tool_call";
         summary: {
-            target: string;
             body: string;
+            target: string;
         };
         toolCall: {
             serviceName: string;
@@ -119,8 +119,8 @@ export declare const OutboundDraftContent: z.ZodObject<{
     }, {
         actionType: "slack_message" | "email" | "service_tool_call";
         summary: {
-            target: string;
             body: string;
+            target: string;
         };
         toolCall: {
             serviceName: string;
@@ -141,8 +141,8 @@ export declare const OutboundDraftContent: z.ZodObject<{
     draft: {
         actionType: "slack_message" | "email" | "service_tool_call";
         summary: {
-            target: string;
             body: string;
+            target: string;
         };
         toolCall: {
             serviceName: string;
@@ -159,8 +159,8 @@ export declare const OutboundDraftContent: z.ZodObject<{
     draft: {
         actionType: "slack_message" | "email" | "service_tool_call";
         summary: {
-            target: string;
             body: string;
+            target: string;
         };
         toolCall: {
             serviceName: string;

package/bundle/shared/dist/worker-sessions.d.ts

@@ -44,6 +44,14 @@ export declare const WorkerSession: z.ZodObject<{
     processPid: z.ZodNullable<z.ZodNumber>;
     processOwner: z.ZodNullable<z.ZodString>;
     processStartedAt: z.ZodNullable<z.ZodString>;
+    /**
+     * Opaque Agent Deck correlation UUID for this session (NOT-305). Generated once at
+     * session creation, before spawn, and passed as observability metadata in every
+     * runtime's Agent Deck launch configuration. Lets Deck correlate its normalized
+     * playbook-fetch stream back to this durable Dealer session without granting any
+     * authority. Null only for rows written before NOT-305.
+     */
+    deckCorrelationId: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
     startedAt: z.ZodNullable<z.ZodString>;
     heartbeatAt: z.ZodNullable<z.ZodString>;
@@ -70,6 +78,7 @@ export declare const WorkerSession: z.ZodObject<{
     processPid: number | null;
     processOwner: string | null;
     processStartedAt: string | null;
+    deckCorrelationId: string | null;
     createdAt: string;
     startedAt: string | null;
     heartbeatAt: string | null;
@@ -96,6 +105,7 @@ export declare const WorkerSession: z.ZodObject<{
     processPid: number | null;
     processOwner: string | null;
     processStartedAt: string | null;
+    deckCorrelationId: string | null;
     createdAt: string;
     startedAt: string | null;
     heartbeatAt: string | null;

package/bundle/shared/dist/worker-sessions.js

@@ -50,6 +50,14 @@ export const WorkerSession = z.object({
     processPid: z.number().int().nullable(),
     processOwner: z.string().nullable(),
     processStartedAt: z.string().nullable(),
+    /**
+     * Opaque Agent Deck correlation UUID for this session (NOT-305). Generated once at
+     * session creation, before spawn, and passed as observability metadata in every
+     * runtime's Agent Deck launch configuration. Lets Deck correlate its normalized
+     * playbook-fetch stream back to this durable Dealer session without granting any
+     * authority. Null only for rows written before NOT-305.
+     */
+    deckCorrelationId: z.string().uuid().nullable(),
     createdAt: z.string(),
     startedAt: z.string().nullable(),
     heartbeatAt: z.string().nullable(),

package/bundle/shared/dist/worker-sessions.test.js

@@ -23,6 +23,7 @@ test("WorkerSession schema parses a queued developer session", () => {
         processPid: null,
         processOwner: null,
         processStartedAt: null,
+        deckCorrelationId: null,
         createdAt: new Date().toISOString(),
         startedAt: null,
         heartbeatAt: null,

package/bundle/shared/dist/workflow.d.ts

@@ -24,7 +24,7 @@ export declare const WorkflowInstance: z.ZodObject<{
     outcome: "done" | "closed" | "migrated" | null;
 }>;
 export type WorkflowInstance = z.infer<typeof WorkflowInstance>;
-export declare const WorkflowEventType: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "legacy.imported"]>;
+export declare const WorkflowEventType: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "operator_verification.waived", "legacy.imported"]>;
 export type WorkflowEventType = z.infer<typeof WorkflowEventType>;
 export declare const WorkflowEvent: z.ZodObject<{
     id: z.ZodString;
@@ -32,7 +32,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     /** Nullable only for issue creation/guidance emitted before any workflow starts. */
     workflowInstanceId: z.ZodNullable<z.ZodString>;
     workerSessionId: z.ZodNullable<z.ZodString>;
-    type: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "legacy.imported"]>;
+    type: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "operator_verification.waived", "legacy.imported"]>;
     actorType: z.ZodEnum<["human", "developer", "reviewer", "system"]>;
     actorRef: z.ZodNullable<z.ZodString>;
     /** Issue status at emit time — lets the timeline render without re-deriving state. */
@@ -45,7 +45,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     causationEventId: z.ZodNullable<z.ZodString>;
     ts: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "legacy.imported";
+    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "operator_verification.waived" | "legacy.imported";
     id: string;
     issueId: string;
     round: number | null;
@@ -60,7 +60,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     causationEventId: string | null;
     ts: string;
 }, {
-    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "legacy.imported";
+    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "operator_verification.waived" | "legacy.imported";
     id: string;
     issueId: string;
     round: number | null;

package/bundle/shared/dist/workflow.js

@@ -21,6 +21,8 @@ export const WorkflowEventType = z.enum([
     "worker.deferred",
     /** Mid-session milestones (NOT-109) — low volume, not per-tool-call. */
     "worktree.ready",
+    /** NOT-315: pre-spawn dependency provisioning settled (ran or skipped). */
+    "worktree.deps_ready",
     "deck.connected",
     "brief.resolved",
     "branch.pushed",
@@ -59,6 +61,20 @@ export const WorkflowEventType = z.enum([
      * per session via idempotency keys and never drive retry/routing decisions. */
     "checkpoint.observed",
     "retry.reused",
+    /** NOT-310: merge-time base-sync attempt after a not-mergeable failure. Payload
+     * carries `outcome` (skipped | merged | repair_queued | conflict_spent |
+     * failed) plus the branch, base, and (for conflicts) the conflicting files.
+     * Audit only — never re-read. */
+    "auto_merge.conflict_sync",
+    /** NOT-310: conflict-repair developer round queued after the sync hit a textual
+     * conflict (payload: baseBranch, branch, files, round, workItemId). Append-only
+     * bound key: a later not-mergeable failure with no `human_action.resolved` after
+     * this event escalates with the file list instead of syncing again. */
+    "auto_merge.conflict_repair_queued",
+    /** NOT-314: the operator explicitly waived an `[operator]` criterion instead of
+     * running its probe (payload: headSha the waiver covers, waivedBy, note).
+     * The gate re-blocks when the head moves past the waived SHA. */
+    "operator_verification.waived",
     /** Migration-only — the NOT-66 cutover repoints a legacy `events` row under this type,
      * preserving the original type/payload inside `payloadJson` (see `role: "legacy"` on
      * `WorkerSessionRole` and `outcome: "migrated"` on `WorkflowInstanceOutcome` for the same

package/bundle/shared/dist/workflow.test.js

@@ -20,6 +20,7 @@ test("WorkflowEventType accepts every PRD §9.2 event type", () => {
         "worker.completed",
         "worker.failed",
         "worktree.ready",
+        "worktree.deps_ready",
         "deck.connected",
         "brief.resolved",
         "branch.pushed",
@@ -41,6 +42,8 @@ test("WorkflowEventType accepts every PRD §9.2 event type", () => {
         "queue.removed",
         "checkpoint.observed",
         "retry.reused",
+        "auto_merge.conflict_sync",
+        "auto_merge.conflict_repair_queued",
     ];
     for (const t of types) {
         assert.equal(WorkflowEventType.parse(t), t);