@adhdev/mesh-shared 1.0.82-rc.27 → 1.0.82-rc.29

package/dist/mesh-tool-names.d.ts

@@ -18,10 +18,10 @@
  * Order mirrors mcp-server `ALL_MESH_TOOLS` for easy visual diffing, but the consistency
  * checks are set-based (order-insensitive).
  */
-export declare const CANONICAL_MESH_TOOL_NAMES: readonly ["mesh_status", "mesh_route_preview", "mesh_list_nodes", "mesh_enqueue_batch", "mesh_enqueue_task", "mesh_view_queue", "mesh_queue_cancel", "mesh_queue_requeue", "mesh_send_task", "mesh_read_chat", "mesh_read_debug", "mesh_read_terminal", "mesh_send_keys", "mesh_launch_session", "mesh_git_status", "mesh_read_node_logs", "mesh_fast_forward_node", "mesh_restart_daemon", "mesh_checkpoint", "mesh_approve", "mesh_answer_question", "mesh_list_pending_approvals", "mesh_create", "mesh_add_node", "mesh_attach_remote", "mesh_clone_node", "mesh_remove_node", "mesh_cleanup_worktree_nodes", "mesh_refine_node", "mesh_refine_batch", "mesh_config", "mesh_init", "mesh_cleanup_sessions", "mesh_task_history", "mesh_ledger_query", "mesh_note", "mesh_reconcile_ledger", "mesh_mission_upsert", "mesh_mission_list", "mesh_review_inbox", "mesh_node_slots", "driver_list", "driver_describe", "artifact_list"];
+export declare const CANONICAL_MESH_TOOL_NAMES: readonly ["mesh_status", "mesh_route_preview", "mesh_list_nodes", "mesh_enqueue_batch", "mesh_enqueue_task", "mesh_view_queue", "mesh_queue_cancel", "mesh_queue_requeue", "mesh_queue_revise", "mesh_send_task", "mesh_read_chat", "mesh_read_debug", "mesh_read_terminal", "mesh_send_keys", "mesh_launch_session", "mesh_git_status", "mesh_read_node_logs", "mesh_fast_forward_node", "mesh_restart_daemon", "mesh_checkpoint", "mesh_approve", "mesh_answer_question", "mesh_list_pending_approvals", "mesh_create", "mesh_add_node", "mesh_attach_remote", "mesh_clone_node", "mesh_remove_node", "mesh_cleanup_worktree_nodes", "mesh_refine_node", "mesh_refine_batch", "mesh_config", "mesh_init", "mesh_cleanup_sessions", "mesh_task_history", "mesh_ledger_query", "mesh_note", "mesh_reconcile_ledger", "mesh_mission_upsert", "mesh_mission_list", "mesh_review_inbox", "mesh_node_slots", "driver_list", "driver_describe", "artifact_list"];
 export type CanonicalMeshToolName = typeof CANONICAL_MESH_TOOL_NAMES[number];
 /** The count the `NN tools` barrel doc comments and consistency test assert against. */
-export declare const CANONICAL_MESH_TOOL_COUNT: 44;
+export declare const CANONICAL_MESH_TOOL_COUNT: 45;
 /**
  * Tool names retired by the 2026-09-26 tool-surface consolidation (60 → 48).
  * Every capability behind them is still reachable: each retired name maps to the

package/dist/mesh-vocabulary.d.ts

@@ -15,9 +15,11 @@
  * ./brain-routing.ts and are re-exported here for one-stop discovery.
  */
 export { MESH_TASK_DIFFICULTIES, type MeshTaskDifficulty } from './brain-routing';
-export declare const MESH_TASK_STATUSES: readonly ["pending", "assigned", "completed", "failed", "cancelled"];
+/** `blocked` ends a worker attempt pending external follow-up; only completed satisfies dependencies.
+ * Branch convergence (including blocked_review) remains an independent axis. */
+export declare const MESH_TASK_STATUSES: readonly ["pending", "assigned", "completed", "blocked", "failed", "cancelled"];
 export type MeshTaskStatus = typeof MESH_TASK_STATUSES[number];
-export declare const MESH_TERMINAL_TASK_STATUSES: readonly ["completed", "failed", "cancelled"];
+export declare const MESH_TERMINAL_TASK_STATUSES: readonly ["completed", "blocked", "failed", "cancelled"];
 export type MeshTerminalTaskStatus = typeof MESH_TERMINAL_TASK_STATUSES[number];
 export declare const MESH_TASK_MODES: readonly ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"];
 export type MeshTaskMode = typeof MESH_TASK_MODES[number];
@@ -56,8 +58,8 @@ export declare const WORKER_REPORT_SUMMARY_MAX_CHARS = 8000;
 /** Final branch state a worker reports (see coordinator convergence rules). */
 export declare const WORKER_BRANCH_STATES: readonly ["merged_to_main", "pushed_feature_branch_needs_merge", "blocked_review", "cleanup_candidate", "not_mergeable"];
 export type WorkerBranchState = typeof WORKER_BRANCH_STATES[number];
-export declare const isMeshTaskStatus: (value: unknown) => value is "pending" | "failed" | "assigned" | "completed" | "cancelled";
-export declare const isMeshTerminalTaskStatus: (value: unknown) => value is "failed" | "completed" | "cancelled";
+export declare const isMeshTaskStatus: (value: unknown) => value is "pending" | "failed" | "blocked" | "assigned" | "completed" | "cancelled";
+export declare const isMeshTerminalTaskStatus: (value: unknown) => value is "failed" | "blocked" | "completed" | "cancelled";
 export declare const isMeshTaskMode: (value: unknown) => value is "code_change" | "validation" | "live_debug_readonly" | "launch_app" | "convergence";
 export declare const isMeshTaskPriority: (value: unknown) => value is "low" | "high" | "normal";
 export declare const isMeshDeliveryMode: (value: unknown) => value is "when_idle" | "interrupt";

package/dist/task-source-phase.d.ts

@@ -0,0 +1,75 @@
+import type { OwnedPathEntry } from './path-ownership';
+export type MeshTaskPhase = 'source' | 'integration';
+/** Host-produced evidence. Never accepted from MCP/peer-supplied paths or branch labels. */
+export interface PhysicalOwnershipScope {
+    version: 1;
+    repoIdentity: string;
+    machineId: string;
+    nodeId: string;
+    worktree: string;
+    worktreeIdentity: string;
+    gitDir: string;
+    commonGitDir: string;
+    phase: MeshTaskPhase;
+    gitResources: {
+        index: string;
+        refs: string;
+        hooks: string;
+        config: string;
+    };
+    resources: Array<{
+        path: string;
+        identity?: string;
+        subtree: boolean;
+    }>;
+    declaration: readonly OwnedPathEntry[];
+}
+/** A source packet is an input to integration, never release/feature acceptance. */
+export interface MeshSourceCandidate {
+    version: 1;
+    readiness: 'uncommitted' | 'verified_source_candidate';
+    taskId: string;
+    missionId: string;
+    revision: number;
+    repoIdentity: string;
+    machineId: string;
+    canonicalWorktree: string;
+    rootBaseSha: string;
+    ossBaseSha: string;
+    rootCandidateSha?: string;
+    ossCandidateSha?: string;
+    patchSha256: string;
+    manifestSha256: string;
+    touchedPaths: string[];
+    tests: Array<{
+        command: string;
+        exit: number;
+        logSha256: string;
+    }>;
+    settledCommands: boolean;
+    integrationTaskId: string;
+    logicalOverlapTaskIds: string[];
+}
+/** Product B consumes one frozen batch; normal hooks/parity/gates remain required. */
+export interface MeshIntegrationBatchContract {
+    version: 1;
+    batchId: string;
+    candidates: MeshSourceCandidate[];
+    integrationOrder: string[];
+    approvedRootSha: string;
+    approvedOssSha: string;
+    bundleInvocationCount: 1;
+    requiredGates: string[];
+    normalHooksRequired: true;
+    independentReviewRequired: true;
+    ownerLandingApprovalRequired: true;
+}
+/** These only rank legal targets; targetNodeId/SessionId and requiredTags remain hard. */
+export interface MeshRoutingPreferences {
+    nodeIds?: string[];
+    providers?: string[];
+}
+export interface MeshReviewConstraint {
+    sourceTaskId: string;
+    differentProvider: true;
+}

package/dist/turn-evidence.d.ts

@@ -101,7 +101,7 @@ export type NoProgressObservedStatus = SessionStatus | 'unknown';
  */
 export declare const HOLD_REASONS: readonly ["await_delivery", "await_consume", "await_turn", "liveness", "hard_ceiling", "live_pending", "transcript_quiet", "weak_candidate", "suspension_before_consumed", "await_report", "await_end", "report_correction"];
 export type HoldReason = typeof HOLD_REASONS[number];
-export declare const TURN_OUTCOMES: readonly ["completed", "failed", "cancelled"];
+export declare const TURN_OUTCOMES: readonly ["completed", "blocked", "failed", "cancelled"];
 export type TurnOutcome = typeof TURN_OUTCOMES[number];
 export declare const COMMIT_STRENGTHS: readonly ["genuine", "weak", "tool_report", "operator"];
 export type CommitStrength = typeof COMMIT_STRENGTHS[number];
@@ -118,7 +118,7 @@ export type TurnReason = typeof TURN_REASONS[number];
  * (refine terminal, worktree bootstrap, …) whose text lives only in the
  * owner's local `turn_events.payload_json` and is rendered at deliver time.
  */
-export declare const NOTIFY_KINDS: readonly ["completed", "failed", "cancelled", "stopped", "approval", "choice", "approval_resolved", "candidate", "no_progress", "progress", "late_completion", "mesh_event"];
+export declare const NOTIFY_KINDS: readonly ["completed", "blocked", "failed", "cancelled", "stopped", "approval", "choice", "approval_resolved", "candidate", "no_progress", "progress", "late_completion", "mesh_event"];
 export type NotifyKind = typeof NOTIFY_KINDS[number];
 export interface TurnAttemptRef {
     attemptId: string;
@@ -384,8 +384,8 @@ export declare const TURN_EVIDENCE_KINDS: readonly TurnEvidenceKind[];
 export declare const TERMINAL_CLASS_EVIDENCE_KINDS: readonly ["turn_end", "transcript_final", "no_progress", "worker_report", "session_error", "process_exit", "cancel", "operator_status"];
 export declare const isTurnEvidenceKind: (value: unknown) => value is "no_progress" | "delivered" | "liveness" | "turn_end" | "transcript_final" | "session_error" | "dispatch_failed" | "dispatch_accepted" | "delivery_refused" | "duplicate_dispatch_refusal" | "session_rebound" | "turn_started" | "suspension" | "suspension_resolved" | "transcript_activity" | "process_exit" | "worker_report" | "worker_report_correction_requested" | "worker_progress" | "git_side_effect" | "cancel" | "operator_status" | "coordinator_ack" | "hold_expired";
 export declare const isTurnReason: (value: unknown) => value is "provider_error" | "intentional_cleanup" | "operator_cancel" | "task_removed" | "mission_abandoned" | "superseded" | "operator_update" | "refine_terminal" | "validation_terminal" | "hard_ceiling" | "turn_end" | "weak_end_confirmed" | "transcript_final" | "worker_reported" | "finalization_timeout_no_response" | "weak_end_liveness_unconfirmed" | "weak_end_probe_unobserved" | "report_correction_expired" | "session_error" | "provider_auth_failed" | "provider_billing_failed" | "provider_usage_limit_exceeded" | "provider_server_overloaded" | "reclaim_budget_exhausted" | "hollow_max_retries" | "migration_orphan" | "dispatch_refused_session_exited" | "dispatch_refused_no_target" | "dispatch_refused_unsupported_input" | "dispatch_failed" | "session_exit" | "session_exit_before_turn" | "session_dead" | "hollow_completion" | "assigned_stranded_dispatch_unconfirmed" | "delivered_not_consumed_redrive" | "delivered_no_turn_deadline";
-export declare const isNotifyKind: (value: unknown) => value is "stopped" | "failed" | "no_progress" | "completed" | "cancelled" | "approval" | "choice" | "approval_resolved" | "candidate" | "progress" | "late_completion" | "mesh_event";
-export declare const isTurnOutcome: (value: unknown) => value is "failed" | "completed" | "cancelled";
+export declare const isNotifyKind: (value: unknown) => value is "stopped" | "failed" | "blocked" | "no_progress" | "completed" | "cancelled" | "approval" | "choice" | "approval_resolved" | "candidate" | "progress" | "late_completion" | "mesh_event";
+export declare const isTurnOutcome: (value: unknown) => value is "failed" | "blocked" | "completed" | "cancelled";
 export declare const isCommitStrength: (value: unknown) => value is "operator" | "genuine" | "weak" | "tool_report";
 export declare function isEvidenceIdentifier(value: unknown): value is string;
 export declare function isSummaryRef(value: unknown): value is SummaryRef;

package/dist/turn-ipc-mission.d.ts

@@ -89,6 +89,8 @@ export interface MeshMissionTaskAggregateWire {
     lastActivityAt: string | null;
 }
 export interface MeshMissionStatsWire {
+    /** Present on peers that project proven blocked outcomes separately. */
+    blocked?: number;
     missionId: string;
     taskCount: number;
     completed: number;
@@ -231,6 +233,8 @@ export interface LedgerQueryEntryWire {
     payload: Record<string, unknown>;
 }
 export interface LedgerQuerySummaryWire {
+    /** Absent on older peers; never folded into failed by the decoder. */
+    taskBlocked?: number;
     meshId: string;
     totalEntries: number;
     taskDispatched: number;

package/dist/turn-ipc-queue.d.ts

@@ -65,6 +65,8 @@ export interface QueueQueryResponse {
     counts?: Record<string, number>;
     /** `withCounts` + `historicalOlderThanMs`: terminal rows older than that age. */
     oldHistoricalCount?: number;
+    /** Included in counts.blocked, derived from proven worker reports; stored failed rows stay unchanged. */
+    legacyReportedBlockedCount?: number;
     /** `withDependencyHeads`. */
     dependencyHeads?: readonly QueueDependencyHeadWire[];
 }
@@ -194,3 +196,20 @@ export interface RecoveryContextQueryResponse {
 }
 export declare function decodeRecoveryContextQueryRequest(value: unknown): RecoveryContextQueryRequest | null;
 export declare function decodeRecoveryContextQueryResponse(value: unknown): RecoveryContextQueryResponse | null;
+export interface QueueReviseRequest {
+    v: typeof TURN_IPC_PROTOCOL_VERSION;
+    meshId: string;
+    taskId: string;
+    expectedRevision: number;
+    patch: {
+        message?: string;
+        ownedPaths?: string[];
+        phase?: 'source' | 'integration';
+        dependsOn?: string[];
+        routingPreferences?: import('./task-source-phase').MeshRoutingPreferences;
+        review?: import('./task-source-phase').MeshReviewConstraint;
+    };
+}
+export type QueueReviseResponse = QueueRequeueResponse;
+export declare function decodeQueueReviseRequest(value: unknown): QueueReviseRequest | null;
+export declare const decodeQueueReviseResponse: typeof decodeQueueRequeueResponse;

package/dist/turn-ipc.d.ts

@@ -94,6 +94,6 @@ export interface TurnIpcError {
 }
 export declare function isTurnIpcError(value: unknown): value is TurnIpcError;
 /** The complete, closed set of IPC command names this contract defines. */
-export declare const TURN_IPC_COMMANDS: readonly ["turn_observe", "mesh_record", "turn_cancel", "operator_status", "turn_query", "mesh_index_query", "mission_upsert", "mission_query", "note_upsert", "note_forget", "tool_call_record", "ledger_query", "mission_list_query", "record_local", "queue_query", "queue_enqueue", "queue_enqueue_batch", "queue_cancel", "queue_requeue", "direct_dispatch_record", "active_work_query", "recovery_context_query", "task_stats_query", "prune_stale_direct", "orphaned_pin_notify"];
+export declare const TURN_IPC_COMMANDS: readonly ["turn_observe", "mesh_record", "turn_cancel", "operator_status", "turn_query", "mesh_index_query", "mission_upsert", "mission_query", "note_upsert", "note_forget", "tool_call_record", "ledger_query", "mission_list_query", "record_local", "queue_query", "queue_enqueue", "queue_enqueue_batch", "queue_cancel", "queue_requeue", "queue_revise", "direct_dispatch_record", "active_work_query", "recovery_context_query", "task_stats_query", "prune_stale_direct", "orphaned_pin_notify"];
 export type TurnIpcCommand = typeof TURN_IPC_COMMANDS[number];
-export declare const isTurnIpcCommand: (value: unknown) => value is "prune_stale_direct" | "operator_status" | "turn_observe" | "mesh_record" | "turn_cancel" | "turn_query" | "mesh_index_query" | "mission_upsert" | "mission_query" | "note_upsert" | "note_forget" | "tool_call_record" | "ledger_query" | "mission_list_query" | "record_local" | "queue_query" | "queue_enqueue" | "queue_enqueue_batch" | "queue_cancel" | "queue_requeue" | "direct_dispatch_record" | "active_work_query" | "recovery_context_query" | "task_stats_query" | "orphaned_pin_notify";
+export declare const isTurnIpcCommand: (value: unknown) => value is "prune_stale_direct" | "operator_status" | "turn_observe" | "mesh_record" | "turn_cancel" | "turn_query" | "mesh_index_query" | "mission_upsert" | "mission_query" | "note_upsert" | "note_forget" | "tool_call_record" | "ledger_query" | "mission_list_query" | "record_local" | "queue_query" | "queue_enqueue" | "queue_enqueue_batch" | "queue_cancel" | "queue_requeue" | "queue_revise" | "direct_dispatch_record" | "active_work_query" | "recovery_context_query" | "task_stats_query" | "orphaned_pin_notify";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/mesh-shared",
-  "version": "1.0.82-rc.27",
+  "version": "1.0.82-rc.29",
   "description": "ADHDev mesh-shared — pure mesh/git status normalizers shared by daemon-core and web-core",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/assistant-protocol.ts

@@ -187,6 +187,7 @@ export interface AssistantRemoteAccessBinding {
     grantRevision: number
     status: 'active' | 'revoked'
     allowedOps: readonly AssistantFollowerAllowedOp[]
+    allowCoordinatorLaunch?: boolean
     grantedAt: number
     revokedAt?: number
 }
@@ -232,6 +233,7 @@ export interface FollowedRemoteProjectEntry {
     accountSlot: AssistantAccountSlot
     bindingRevision: number
     grantRevision: number
+    allowCoordinatorLaunch?: boolean
     state: FollowedRemoteProjectState
     followedAt: number | string
     updatedAt: number | string
@@ -261,6 +263,7 @@ export interface RemoteProjectCatalogItem {
     name: string
     sanitizedRepoIdentity: string | null
     coordinatorState?: 'none' | 'idle' | 'working' | 'waiting' | string
+    allowCoordinatorLaunch?: boolean
     capabilities: {
         status: true
         read: true
@@ -268,6 +271,7 @@ export interface RemoteProjectCatalogItem {
         report: true
         send: true
         coordinatorPresent?: boolean
+        allowCoordinatorLaunch?: boolean
     }
     observedAt: number | string
 }

package/src/daemon-normalize.ts

@@ -108,13 +108,15 @@ export function isPhantomDaemonEntry(
 export function machineCoreFromDaemonId(id: string | null | undefined): string | undefined {
     const trimmed = readString(id)
     if (!trimmed) return undefined
+    const lower = trimmed.toLowerCase()
     for (const prefix of DAEMON_ID_PREFIXES) {
-        if (trimmed.startsWith(prefix)) {
+        if (lower.startsWith(prefix)) {
             const core = trimmed.slice(prefix.length).trim()
-            return core || undefined
+            if (!core) return undefined
+            return /^mach_/i.test(core) ? `mach_${core.slice(5)}` : core
         }
     }
-    return trimmed
+    return /^mach_/i.test(trimmed) ? `mach_${trimmed.slice(5)}` : trimmed
 }
 
 /**
@@ -144,8 +146,8 @@ export function machineCoreFromDaemonId(id: string | null | undefined): string |
 export function canonicalDaemonId(id: string | null | undefined): string | undefined {
     const core = machineCoreFromDaemonId(id)
     if (!core) return undefined
-    if (!core.startsWith('mach_')) return core
-    return `daemon_${core}`
+    if (!/^mach_/i.test(core)) return core
+    return `daemon_mach_${core.slice(5)}`
 }
 
 /** True when both ids resolve to the same machine core — i.e. they are the same

package/src/index.ts

@@ -47,3 +47,4 @@ export * from './provider-question'
 export * from './launch-defaults'
 
 export * from './role-launch';
+export * from './task-source-phase';

package/src/mesh-tool-names.ts

@@ -28,6 +28,7 @@ export const CANONICAL_MESH_TOOL_NAMES = [
     'mesh_view_queue',
     'mesh_queue_cancel',
     'mesh_queue_requeue',
+    'mesh_queue_revise',
     'mesh_send_task',
     'mesh_read_chat',
     'mesh_read_debug',

package/src/mesh-vocabulary.ts

@@ -17,10 +17,12 @@
 
 export { MESH_TASK_DIFFICULTIES, type MeshTaskDifficulty } from './brain-routing'
 
-export const MESH_TASK_STATUSES = ['pending', 'assigned', 'completed', 'failed', 'cancelled'] as const
+/** `blocked` ends a worker attempt pending external follow-up; only completed satisfies dependencies.
+ * Branch convergence (including blocked_review) remains an independent axis. */
+export const MESH_TASK_STATUSES = ['pending', 'assigned', 'completed', 'blocked', 'failed', 'cancelled'] as const
 export type MeshTaskStatus = typeof MESH_TASK_STATUSES[number]
 
-export const MESH_TERMINAL_TASK_STATUSES = ['completed', 'failed', 'cancelled'] as const
+export const MESH_TERMINAL_TASK_STATUSES = ['completed', 'blocked', 'failed', 'cancelled'] as const
 export type MeshTerminalTaskStatus = typeof MESH_TERMINAL_TASK_STATUSES[number]
 
 export const MESH_TASK_MODES = ['code_change', 'validation', 'live_debug_readonly', 'launch_app', 'convergence'] as const

package/src/task-source-phase.ts

@@ -0,0 +1,61 @@
+import type { OwnedPathEntry } from './path-ownership'
+
+export type MeshTaskPhase = 'source' | 'integration'
+
+/** Host-produced evidence. Never accepted from MCP/peer-supplied paths or branch labels. */
+export interface PhysicalOwnershipScope {
+    version: 1
+    repoIdentity: string
+    machineId: string
+    nodeId: string
+    worktree: string
+    worktreeIdentity: string
+    gitDir: string
+    commonGitDir: string
+    phase: MeshTaskPhase
+    gitResources: { index: string; refs: string; hooks: string; config: string }
+    resources: Array<{ path: string; identity?: string; subtree: boolean }>
+    declaration: readonly OwnedPathEntry[]
+}
+
+/** A source packet is an input to integration, never release/feature acceptance. */
+export interface MeshSourceCandidate {
+    version: 1
+    readiness: 'uncommitted' | 'verified_source_candidate'
+    taskId: string
+    missionId: string
+    revision: number
+    repoIdentity: string
+    machineId: string
+    canonicalWorktree: string
+    rootBaseSha: string
+    ossBaseSha: string
+    rootCandidateSha?: string
+    ossCandidateSha?: string
+    patchSha256: string
+    manifestSha256: string
+    touchedPaths: string[]
+    tests: Array<{ command: string; exit: number; logSha256: string }>
+    settledCommands: boolean
+    integrationTaskId: string
+    logicalOverlapTaskIds: string[]
+}
+
+/** Product B consumes one frozen batch; normal hooks/parity/gates remain required. */
+export interface MeshIntegrationBatchContract {
+    version: 1
+    batchId: string
+    candidates: MeshSourceCandidate[]
+    integrationOrder: string[]
+    approvedRootSha: string
+    approvedOssSha: string
+    bundleInvocationCount: 1
+    requiredGates: string[]
+    normalHooksRequired: true
+    independentReviewRequired: true
+    ownerLandingApprovalRequired: true
+}
+
+/** These only rank legal targets; targetNodeId/SessionId and requiredTags remain hard. */
+export interface MeshRoutingPreferences { nodeIds?: string[]; providers?: string[] }
+export interface MeshReviewConstraint { sourceTaskId: string; differentProvider: true }

package/src/turn-evidence.ts

@@ -154,7 +154,7 @@ export const HOLD_REASONS = [
 ] as const
 export type HoldReason = typeof HOLD_REASONS[number]
 
-export const TURN_OUTCOMES = ['completed', 'failed', 'cancelled'] as const
+export const TURN_OUTCOMES = ['completed', 'blocked', 'failed', 'cancelled'] as const
 export type TurnOutcome = typeof TURN_OUTCOMES[number]
 
 export const COMMIT_STRENGTHS = ['genuine', 'weak', 'tool_report', 'operator'] as const
@@ -186,7 +186,7 @@ export type TurnReason = typeof TURN_REASONS[number]
  * owner's local `turn_events.payload_json` and is rendered at deliver time.
  */
 export const NOTIFY_KINDS = [
-    'completed', 'failed', 'cancelled', 'stopped', 'approval', 'choice', 'approval_resolved',
+    'completed', 'blocked', 'failed', 'cancelled', 'stopped', 'approval', 'choice', 'approval_resolved',
     'candidate', 'no_progress', 'progress', 'late_completion', 'mesh_event',
 ] as const
 export type NotifyKind = typeof NOTIFY_KINDS[number]

package/src/turn-ipc-mission.ts

@@ -221,6 +221,8 @@ export interface MeshMissionTaskAggregateWire {
 }
 
 export interface MeshMissionStatsWire {
+    /** Present on peers that project proven blocked outcomes separately. */
+    blocked?: number
     missionId: string
     taskCount: number
     completed: number
@@ -313,12 +315,13 @@ function isMeshMissionTaskAggregateWire(value: unknown): value is MeshMissionTas
 }
 
 function isMeshMissionStatsWire(value: unknown): value is MeshMissionStatsWire {
-    const keys = ['missionId', 'taskCount', 'completed', 'failed', 'totalDurationMs', 'wallClockMs', 'retries', 'incompleteTaskIds'] as const
+    const keys = ['missionId', 'taskCount', 'completed', 'failed', 'blocked', 'totalDurationMs', 'wallClockMs', 'retries', 'incompleteTaskIds'] as const
     if (!isRecord(value) || !hasOnlyKeys(value, keys)) return false
     if (!isEvidenceIdentifier(value.missionId)) return false
     for (const k of ['taskCount', 'completed', 'failed', 'totalDurationMs', 'retries'] as const) {
         if (!isNonNegativeInt(value[k])) return false
     }
+    if (value.blocked !== undefined && !isNonNegativeInt(value.blocked)) return false
     if (value.wallClockMs !== null && !isNonNegativeInt(value.wallClockMs)) return false
     if (!Array.isArray(value.incompleteTaskIds) || !value.incompleteTaskIds.every(isEvidenceIdentifier)) return false
     return true
@@ -580,6 +583,8 @@ export interface LedgerQueryEntryWire {
 }
 
 export interface LedgerQuerySummaryWire {
+    /** Absent on older peers; never folded into failed by the decoder. */
+    taskBlocked?: number
     meshId: string
     totalEntries: number
     taskDispatched: number
@@ -625,12 +630,13 @@ function isLedgerQueryEntryWire(value: unknown): value is LedgerQueryEntryWire {
 }
 
 function isLedgerQuerySummaryWire(value: unknown): value is LedgerQuerySummaryWire {
-    const keys = ['meshId', 'totalEntries', 'taskDispatched', 'taskCompleted', 'taskFailed', 'taskStalled', 'sessionLaunched', 'checkpointCreated', 'lastActivityAt', 'recentFailures'] as const
+    const keys = ['meshId', 'totalEntries', 'taskDispatched', 'taskCompleted', 'taskFailed', 'taskBlocked', 'taskStalled', 'sessionLaunched', 'checkpointCreated', 'lastActivityAt', 'recentFailures'] as const
     if (!isRecord(value) || !hasOnlyKeys(value, keys)) return false
     if (!isEvidenceIdentifier(value.meshId)) return false
     for (const k of ['totalEntries', 'taskDispatched', 'taskCompleted', 'taskFailed', 'taskStalled', 'sessionLaunched', 'checkpointCreated', 'recentFailures'] as const) {
         if (!isNonNegativeInt(value[k])) return false
     }
+    if (value.taskBlocked !== undefined && !isNonNegativeInt(value.taskBlocked)) return false
     if (value.lastActivityAt !== null && typeof value.lastActivityAt !== 'string') return false
     return true
 }

package/src/turn-ipc-queue.ts

@@ -135,6 +135,8 @@ export interface QueueQueryResponse {
     counts?: Record<string, number>
     /** `withCounts` + `historicalOlderThanMs`: terminal rows older than that age. */
     oldHistoricalCount?: number
+    /** Included in counts.blocked, derived from proven worker reports; stored failed rows stay unchanged. */
+    legacyReportedBlockedCount?: number
     /** `withDependencyHeads`. */
     dependencyHeads?: readonly QueueDependencyHeadWire[]
 }
@@ -159,9 +161,10 @@ function isQueueDependencyHeadWire(value: unknown): value is QueueDependencyHead
 }
 
 function isQueueQueryResponse(value: unknown): value is QueueQueryResponse {
-    if (!isRecord(value) || !hasOnlyKeys(value, ['entries', 'counts', 'oldHistoricalCount', 'dependencyHeads'])) return false
+    if (!isRecord(value) || !hasOnlyKeys(value, ['entries', 'counts', 'oldHistoricalCount', 'legacyReportedBlockedCount', 'dependencyHeads'])) return false
     if (!Array.isArray(value.entries) || !value.entries.every(isQueueEntryWire)) return false
     if (value.counts !== undefined && (!isRecord(value.counts) || !Object.values(value.counts).every(isNonNegativeInt))) return false
+    if (value.legacyReportedBlockedCount !== undefined && !isNonNegativeInt(value.legacyReportedBlockedCount)) return false
     if (value.oldHistoricalCount !== undefined && !isNonNegativeInt(value.oldHistoricalCount)) return false
     if (value.dependencyHeads !== undefined && (!Array.isArray(value.dependencyHeads) || !value.dependencyHeads.every(isQueueDependencyHeadWire))) return false
     return true
@@ -491,3 +494,28 @@ function isRecoveryContextQueryResponse(value: unknown): value is RecoveryContex
 export function decodeRecoveryContextQueryResponse(value: unknown): RecoveryContextQueryResponse | null {
     return isRecoveryContextQueryResponse(value) ? value : null
 }
+
+// ── queue_revise: host-authenticated pending CAS, never a force requeue ──
+export interface QueueReviseRequest {
+    v: typeof TURN_IPC_PROTOCOL_VERSION
+    meshId: string
+    taskId: string
+    expectedRevision: number
+    patch: { message?: string; ownedPaths?: string[]; phase?: 'source' | 'integration'; dependsOn?: string[]; routingPreferences?: import('./task-source-phase').MeshRoutingPreferences; review?: import('./task-source-phase').MeshReviewConstraint }
+}
+export type QueueReviseResponse = QueueRequeueResponse
+export function decodeQueueReviseRequest(value: unknown): QueueReviseRequest | null {
+    if (!isRecord(value) || !hasOnlyKeys(value, ['v', 'meshId', 'taskId', 'expectedRevision', 'patch'])
+        || value.v !== TURN_IPC_PROTOCOL_VERSION || !isEvidenceIdentifier(value.meshId) || !isEvidenceIdentifier(value.taskId)
+        || !Number.isSafeInteger(value.expectedRevision) || (value.expectedRevision as number) < 0
+        || !isRecord(value.patch) || !Object.keys(value.patch).length
+        || !hasOnlyKeys(value.patch, ['message', 'ownedPaths', 'phase', 'dependsOn', 'routingPreferences', 'review'])) return null
+    const p = value.patch
+    if (p.message !== undefined && (typeof p.message !== 'string' || !p.message.trim())) return null
+    if (p.phase !== undefined && p.phase !== 'source' && p.phase !== 'integration') return null
+    for (const key of ['ownedPaths', 'dependsOn']) {
+        if (p[key] !== undefined && (!Array.isArray(p[key]) || !(p[key] as unknown[]).every(x => typeof x === 'string' && !!x.trim()))) return null
+    }
+    return value as unknown as QueueReviseRequest
+}
+export const decodeQueueReviseResponse = decodeQueueRequeueResponse

package/src/turn-ipc-turn.ts

@@ -66,7 +66,7 @@ function isTurnObserveResponse(value: unknown): value is TurnObserveResponse {
         && (value.outcome === undefined || isTurnOutcomeValue(value.outcome))
 }
 
-const TURN_OUTCOMES_LOCAL = ['completed', 'failed', 'cancelled'] as const
+const TURN_OUTCOMES_LOCAL = ['completed', 'blocked', 'failed', 'cancelled'] as const
 function isTurnOutcomeValue(value: unknown): value is TurnOutcome {
     return typeof value === 'string' && (TURN_OUTCOMES_LOCAL as readonly string[]).includes(value)
 }

package/src/turn-ipc.ts

@@ -132,6 +132,7 @@ export const TURN_IPC_COMMANDS = [
     'queue_enqueue_batch',
     'queue_cancel',
     'queue_requeue',
+    'queue_revise',
     'direct_dispatch_record',
     'active_work_query',
     'recovery_context_query',