agent-dealer 1.2.8 → 1.2.9

package/bundle/server/static-ui/index.html

@@ -8,7 +8,7 @@
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
     <meta name="theme-color" content="#0a0e14" />
     <link rel="preload" href="/fonts/Monaco.ttf" as="font" type="font/ttf" crossorigin />
-    <script type="module" crossorigin src="/assets/index-B6SVCzMR.js"></script>
+    <script type="module" crossorigin src="/assets/index-CU6fNntg.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-K_YcYkQU.css">
   </head>
   <body>

package/bundle/shared/dist/human-actions.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const HumanActionType: z.ZodEnum<["product_scope_decision", "policy_escalation", "attempts_exhausted", "final_review", "deck_interaction_required", "reflection_interaction_required", "outbound_delivery_interaction_required", "muse_capability"]>;
+export declare const HumanActionType: z.ZodEnum<["product_scope_decision", "policy_escalation", "attempts_exhausted", "final_review", "deck_interaction_required", "reflection_interaction_required", "outbound_delivery_interaction_required", "muse_capability", "operator_verification"]>;
 export type HumanActionType = z.infer<typeof HumanActionType>;
 export declare const HumanActionStatus: z.ZodEnum<["open", "resolved"]>;
 export type HumanActionStatus = z.infer<typeof HumanActionStatus>;
@@ -12,7 +12,7 @@ export declare const HumanAction: z.ZodObject<{
     runId: z.ZodNullable<z.ZodString>;
     /** Nullable for pre-start product_scope_decision and imported legacy actions. */
     workflowInstanceId: z.ZodNullable<z.ZodString>;
-    actionType: z.ZodEnum<["product_scope_decision", "policy_escalation", "attempts_exhausted", "final_review", "deck_interaction_required", "reflection_interaction_required", "outbound_delivery_interaction_required", "muse_capability"]>;
+    actionType: z.ZodEnum<["product_scope_decision", "policy_escalation", "attempts_exhausted", "final_review", "deck_interaction_required", "reflection_interaction_required", "outbound_delivery_interaction_required", "muse_capability", "operator_verification"]>;
     reason: z.ZodString;
     question: z.ZodString;
     evidenceJson: z.ZodNullable<z.ZodString>;
@@ -29,7 +29,7 @@ export declare const HumanAction: z.ZodObject<{
     requestedAt: z.ZodString;
     resolvedAt: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    actionType: "policy_escalation" | "final_review" | "product_scope_decision" | "attempts_exhausted" | "deck_interaction_required" | "reflection_interaction_required" | "outbound_delivery_interaction_required" | "muse_capability";
+    actionType: "policy_escalation" | "final_review" | "product_scope_decision" | "attempts_exhausted" | "deck_interaction_required" | "reflection_interaction_required" | "outbound_delivery_interaction_required" | "muse_capability" | "operator_verification";
     question: string;
     reason: string;
     evidenceJson: string | null;
@@ -46,7 +46,7 @@ export declare const HumanAction: z.ZodObject<{
     requestedAt: string;
     resolvedAt: string | null;
 }, {
-    actionType: "policy_escalation" | "final_review" | "product_scope_decision" | "attempts_exhausted" | "deck_interaction_required" | "reflection_interaction_required" | "outbound_delivery_interaction_required" | "muse_capability";
+    actionType: "policy_escalation" | "final_review" | "product_scope_decision" | "attempts_exhausted" | "deck_interaction_required" | "reflection_interaction_required" | "outbound_delivery_interaction_required" | "muse_capability" | "operator_verification";
     question: string;
     reason: string;
     evidenceJson: string | null;

package/bundle/shared/dist/human-actions.js

@@ -30,6 +30,14 @@ export const HumanActionType = z.enum([
      * The only choice is `acknowledge`: for `missing` it records a per-version override
      * so admission proceeds on that version; for `unverified` it just dismisses. */
     "muse_capability",
+    /** An `[operator]` acceptance criterion from the frozen task snapshot (NOT-314):
+     * only a human with real credentials, a real login, or a paid session can prove
+     * it. Raised by the auto-merge gate (coordinator/auto-merge.ts) after reviewer
+     * approve, before the merge — the PR stays unmerged until the human records the
+     * result. Choices: `verified` (note = the result, stored as an artifact),
+     * `waive` (explicit waiver, note required, recorded as a workflow event), or
+     * `repair` (another developer round with the note threaded to its prompt). */
+    "operator_verification",
 ]);
 export const HumanActionStatus = z.enum(["open", "resolved"]);
 export const HumanAction = z.object({

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>;
@@ -75,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>;
@@ -111,6 +125,8 @@ 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;
@@ -150,6 +166,8 @@ 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;
@@ -364,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>;
@@ -410,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;
@@ -452,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;

package/bundle/shared/dist/issues.js

@@ -12,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({
@@ -47,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

@@ -39,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/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", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "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", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "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" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "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" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "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",
@@ -69,6 +71,10 @@ export const WorkflowEventType = z.enum([
      * 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",

package/bundle/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-dealer/shared",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/action.js

@@ -29,13 +29,16 @@ export async function runActionCommand(args) {
             const id = rest[0];
             const choice = flag(rest, "--choice");
             const resolvedBy = flag(rest, "--by");
+            // NOT-314: operator_verification requires a non-empty note (the result,
+            // waiver reason, or repair note) — the server 400s without one.
+            const note = flag(rest, "--note");
             if (!id || !choice || !resolvedBy) {
                 console.error("resolve requires an action id, --choice, and --by");
                 return 1;
             }
             const result = await apiFetch(`/api/human-actions/${id}/resolve`, {
                 method: "POST",
-                body: { choice, resolvedBy },
+                body: note?.trim() ? { choice, resolvedBy, note: note.trim() } : { choice, resolvedBy },
             });
             console.log(JSON.stringify(result, null, 2));
             return 0;

package/dist/action.test.js

@@ -54,6 +54,48 @@ test("action resolve calls POST /api/human-actions/:id/resolve with resolvedBy a
         stub.restore();
     }
 });
+test("action resolve forwards --note when given (required for operator_verification)", async () => {
+    const stub = stubFetch("/api/human-actions/a1/resolve", "POST", { issueStatus: "needs_human" });
+    try {
+        const code = await runActionCommand([
+            "resolve",
+            "a1",
+            "--choice",
+            "verified",
+            "--by",
+            "alice",
+            "--note",
+            "probe output here",
+        ]);
+        assert.equal(code, 0);
+        const body = stub.assertCalled();
+        assert.deepEqual(body, { choice: "verified", resolvedBy: "alice", note: "probe output here" });
+    }
+    finally {
+        stub.restore();
+    }
+});
+test("action resolve omits a blank --note so noteless resolves send the historical body", async () => {
+    const stub = stubFetch("/api/human-actions/a1/resolve", "POST", { issueStatus: "closed" });
+    try {
+        const code = await runActionCommand([
+            "resolve",
+            "a1",
+            "--choice",
+            "complete",
+            "--by",
+            "alice",
+            "--note",
+            "   ",
+        ]);
+        assert.equal(code, 0);
+        const body = stub.assertCalled();
+        assert.deepEqual(body, { choice: "complete", resolvedBy: "alice" });
+    }
+    finally {
+        stub.restore();
+    }
+});
 test("action resolve returns nonzero on API failure", async () => {
     const stub = stubFetch("/api/human-actions/a1/resolve", "POST", { error: "bad choice" }, 400);
     try {

package/dist/index.js

@@ -29,7 +29,7 @@ function printUsage() {
   agent-dealer queue list
   agent-dealer queue move <issueId> --top|--bottom|--before <id>|--after <id>
   agent-dealer action list
-  agent-dealer action resolve <id> --choice C --by NAME
+  agent-dealer action resolve <id> --choice C --by NAME [--note TEXT]
   agent-dealer --version
 
 Human control plane for agent execution.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dealer",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "description": "Human control plane for agent execution — queue, plan approval, audit",
   "license": "MIT",
   "type": "module",