@miraland-labs/conduit-bridge 0.16.115 → 0.16.117

package/dist/execution.js

@@ -13,7 +13,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { buildWorkspaceBrief, ensureCommitAvailable, fetchOrigin, normalizeRepositoryUrl, resolveAttemptStartCommit } from "./brief.js";
 import { buildSovereignExecutionFacts, bootstrapResultForWorkspace, changedExecutionFact, resumeExecutionFacts, workspaceIsClean } from "./execution-facts.js";
-import { agentOutputCause, boundedDetail, bridgeCause, executionFactChangedSignal, verificationRedBaseSignal, verificationScopeConflictSignal } from "./failure-signal.js";
+import { agentOutputCause, boundedDetail, bridgeCause, contractScopeConflictFailure, executionFactChangedSignal, verificationRedBaseSignal, verificationScopeConflictSignal } from "./failure-signal.js";
 import { forgeTransportFailure } from "./transport-fault.js";
 import { managedWorkspacePath, switchManagedWorkspace } from "./on-shift-apply.js";
 import { formatResetMinute, parseQuotaResetAt } from "./quota-reset.js";
@@ -207,11 +207,10 @@ export function classifyFinalizeFailure(message) {
     // Bridge names the contract defect it found (K3); an unknown throw below stays prose until its
     // own site names a code.
     if (FINALIZE_CONTRACT_PATTERN.test(message)) {
-        // The scope conflict Holds (contract/hold), and the runner's envelope schema admits only
-        // contract/rework from a supplied envelope — sending it would refuse the whole report. It stays
-        // prose until the finalize site emits it as a typed signal (K3 step 2b design).
+        // The envelope carries the contract and hold pair, which the runner schema admits. The prose
+        // stays beside it for the owner's words.
         const failure = CONTRACT_SCOPE_CONFLICT_MESSAGE.test(message)
-            ? undefined
+            ? contractScopeConflictFailure(message)
             : VERIFICATION_UNWITNESSABLE_MESSAGE.test(message)
                 ? bridgeCause("verification_unwitnessable", message)
                 : message.startsWith(AGENT_NO_LAND_COMMIT_PREFIX)

package/dist/failure-signal.js

@@ -8,10 +8,9 @@ import { z } from "zod";
  * beside the prose: drivers that hold structured knowledge (a vendor envelope status, an exit
  * code, the denied tool) emit it, and classification reads the signal first, the regex second.
  *
- * This file is mirrored byte-identical as packages/conduit-bridge/src/failure-signal.ts and
- * src/conductor/failure-signal.ts. Bridge cannot import from the control plane, and the other
- * way round, so test/failure-signal.test.ts pins the two files together instead of trusting
- * them to stay in step.
+ * The Bridge source is packages/conduit-bridge/src/failure-signal.ts. The control-plane copy at
+ * src/conductor/failure-signal.ts is generated by `npm run sync:twins`. Do not edit that copy.
+ * Bridge cannot import from the control plane, and the other way round.
  */
 export const failureSignalSchema = z.object({
     phase: z.enum(["claim", "checkout", "bootstrap", "agent", "verification", "delivery_report", "land"]),
@@ -118,7 +117,7 @@ export const BRIDGE_CAUSES = {
     workspace_head_changed: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The checkout changed after Conduit prepared the assignment.", next_action: "Let the checkout settle, then recheck readiness." },
     base_not_ancestor: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "Conduit could not prepare the required project version on this computer.", next_action: "No Git work is required from the product owner. Keep the computer and Bridge online, then try again so Bridge can refresh the project. If the hold returns, the computer operator should check Bridge's repository access." },
     workspace_dirty: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The source workspace has uncommitted changes.", next_action: "Commit, stash, or discard the local changes, then recheck readiness." },
-    missing_verification: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This checkout has no verification commands Conduit can run for this package.", next_action: "Conductor will adjust how this package is verified. Open Connect only if the computer itself is unhealthy — you do not need to author test commands." },
+    missing_verification: { class: "environment", disposition: "hold", responsible_party: "conduit", message: "This checkout has no verification commands Conduit can run for this package.", next_action: "Conductor will adjust how this package is verified. You do not need to author test commands or rewrite the plan for tooling." },
     verification_unwitnessable: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The project's verification command runs but prints nothing, so test evidence cannot be witnessed.", next_action: "Fix the verification recipe in the checkout so it prints real output, then recheck readiness. You do not need to author test commands for the agent." },
     execution_contract_failed: { class: "contract", disposition: "rework", responsible_party: "conduit", message: "The agent could not satisfy the approved execution contract.", next_action: "Review the last run and rework the same contract; change the plan only if its authority or outcome is wrong." },
     agent_no_land_commit: { class: "contract", disposition: "rework", responsible_party: "conduit", message: "The agent finished without committing the repository changes this package requires.", next_action: "Retry implement. Conductor will brief a land-focused recovery attempt — you do not need to edit technical constraints." },
@@ -126,6 +125,23 @@ export const BRIDGE_CAUSES = {
     forge_unreachable: { class: "transient", disposition: "retry", responsible_party: "conduit", message: "The connection to the code host failed mid-run.", next_action: "Nothing to repair here — the run stopped on a network fault, not on the work. Retry the same plan." },
     agent_model_abort: { class: "transient", disposition: "retry", responsible_party: "conduit", message: "The agent CLI stopped its own run: it detected a loop, asked for a different model, or the prompt did not fit the context window.", next_action: "Conduit retries on another model of the same intelligence tier. The product owner does not need to author technical constraints." },
     agent_execution_failed: { class: "transient", disposition: "retry", responsible_party: "conduit", message: "The agent run failed before delivery.", next_action: "Conduit will retry with bounded backoff while the authoring budget remains. No technical constraints are required from the owner." },
+    verification_failed_after_run: { class: "transient", disposition: "retry", responsible_party: "conduit", message: "The agent run failed its own verification before delivery.", next_action: "Conduit will diagnose the retained failed run and brief the next authoring attempt." },
+    bridge_finalize_failed: { class: "platform", disposition: "stop", responsible_party: "conduit", message: "Bridge stopped while finishing the delivery report.", next_action: "Inspect Bridge logs for the finalize fault. Fix Bridge or open a revision if the plan is wrong, then Retry." },
+    bridge_preflight_missing: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer has not reported Bridge readiness.", next_action: "Run Bridge Doctor and reinstall or restart the background service, then recheck readiness." },
+    bridge_preflight_stale: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer's Bridge readiness report is stale.", next_action: "Wake or restart the Bridge and wait for a fresh heartbeat, then recheck readiness." },
+    hosted_computer: { class: "environment", disposition: "hold", responsible_party: "conduit", message: "This hosted computer is Conduit's responsibility.", next_action: "Conduit fixes the hosted computer; Recheck runs the work package again." },
+    dependency_failed: { class: "contract", disposition: "hold", responsible_party: "conduit", message: "Earlier work this package depends on failed, so this work can never start.", next_action: "Recover or revise the package it depends on. This work resumes on its own once that one completes." },
+    dispatch_admit_blocked: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "Matching computers look ready but dispatch still cannot admit them.", next_action: "Confirm Bridge is on shift for this machine, then recheck. If it persists, restart Bridge." },
+    driver_fuel_mismatch: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The selected driver does not have a usable fuel source.", next_action: "Correct the driver fuel setting, then recheck readiness." },
+    driver_quota_exhausted: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The agent lane on this computer has spent its subscription allowance.", next_action: "Wait for the allowance to refill, bring another agent lane online to start sooner, or point this lane's model settings at a model that still has allowance." },
+    local_fuel_lanes_unavailable: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "Every local-fuel agent lane on this computer is currently unavailable.", next_action: "Wait for a reported provider allowance to recover, or bring another agent lane online to start sooner." },
+    execution_class_required: { class: "authority", disposition: "decision", responsible_party: "project_owner", message: "This work package is missing stamped execution_class.", next_action: "Revise the plan so the planner authors a class for every work item, then retry." },
+    no_online_driver: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer has no online agent lane ready for work.", next_action: "Bring an authenticated agent lane online, then recheck readiness." },
+    runner_behind_server: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer's assignment poll no longer matches the server's response shape.", next_action: "Restart the runner, then recheck readiness." },
+    stale_bridge: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer is running an unsupported Bridge version.", next_action: "Update and reinstall Bridge, then recheck readiness." },
+    workspace_diverged: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "This computer's checkout holds local commits the project does not have, so it would run on stale code.", next_action: "Ask the computer operator to push or park the local commits so the checkout can follow the project again, then recheck readiness." },
+    workspace_repository_missing: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "The configured workspace is not a repository checkout.", next_action: "Select or create the required repository checkout, then recheck readiness." },
+    workspace_tip_lag: { class: "environment", disposition: "hold", responsible_party: "computer_operator", message: "Conduit could not prepare the required project version on this computer.", next_action: "No Git work is required from the product owner. Keep the computer and Bridge online, then try again so Bridge can refresh the project. If the hold returns, the computer operator should check Bridge's repository access." },
 };
 /** Is this string a code Bridge may name as a cause? Narrows a caller-supplied reason. */
 export function isBridgeCauseCode(value) {

package/dist/quota-reset.js

@@ -1,10 +1,9 @@
 /**
  * The refill time a vendor states in a quota refusal, as an absolute clock.
  *
- * This file is mirrored byte-identical as packages/conduit-bridge/src/quota-reset.ts and
- * src/conductor/quota-reset.ts. Bridge cannot import from the control plane, and the other way
- * round, so test/failure-classification.test.ts pins the two files together instead of trusting
- * them to stay in step.
+ * The Bridge source is packages/conduit-bridge/src/quota-reset.ts. The control-plane copy at
+ * src/conductor/quota-reset.ts is generated by `npm run sync:twins`. Do not edit that copy. Bridge
+ * cannot import from the control plane, and the other way round.
  *
  * Vendors phrase the refill as an absolute clock time (RFC 1123), a wall clock in a named zone
  * (Claude Code's "resets 3:10pm (UTC)"), a duration ("try again in 2h 14m", or agy's Go form

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraland-labs/conduit-bridge",
-  "version": "0.16.115",
+  "version": "0.16.117",
   "description": "Conduit Bridge CLI \u2014 join, connect, disconnect, multi-driver lanes, and run Claude Code / Codex / Cursor / OpenCode / Pi / Kiro / Antigravity / Grok Build agents for a Conduit organization",
   "type": "module",
   "bin": {