@knpkv/herdr-work 0.3.0 → 0.5.0

package/dist/service.d.ts

@@ -1,13 +1,1236 @@
-import { Effect } from "effect";
-import type { WorkCheckpointConflictError, WorkProjectionError, WorkStoreError } from "./errors.js";
-import type { WorkGoalCheckpoint, WorkSnapshots } from "./model.js";
+import { Effect, Option } from "effect";
+import { WorkPullRequestLinkError, WorkRecoveryContextError } from "./errors.js";
+import type { WorkAdmissionConflictError, WorkAgentBindingAuthorityError, WorkAgentBindingConflictError, WorkCheckpointConflictError, WorkCoordinatorHandoffConflictError, WorkDecisionAuthorityConflictError, WorkDecisionHandoffConflictError, WorkDecisionRevisionConflictError, WorkGoalAgentTargetConflictError, WorkGoalBindingRequiresAgentError, WorkGoalOwnerMismatchError, WorkGoalReassignmentConflictError, WorkGoalRevisionConflictError, WorkLaneClaimConflictError, WorkLaneGoalConflictError, WorkLaneOperationConflictError, WorkProjectionError, WorkStoreError, WorkTransactionConflictError } from "./errors.js";
+import type { WorkAdmissionPreflight, WorkAdmissionTarget, WorkAgentBinding, WorkAgentBindingRequest, WorkDecisionHandoff, WorkExistingGoalRecovery, WorkExistingOwnerReconciliation, WorkGoalCheckpoint, WorkGoalReassigned, WorkGoalReassignment, WorkLaneClaim, WorkLaneClaimed, WorkProspectiveAdmission, WorkRecoveryContext, WorkRecoveryPreflight, WorkRecoveryTarget, WorkSnapshots } from "./model.js";
+import { WorkPullRequestLink, WorkPullRequestLinkRequest } from "./model.js";
 import type { WorkStoreService } from "./store.js";
 export interface WorkService {
+    /** Exact durable checkpoint facts, not recovery eligibility or approval authority. */
+    readonly recoveryContext: (goalId: string) => Effect.Effect<WorkRecoveryContext, WorkRecoveryContextError | WorkProjectionError | WorkStoreError>;
+    readonly recoveryPreflight: (target: WorkRecoveryTarget) => Effect.Effect<WorkRecoveryPreflight, WorkProjectionError | WorkStoreError>;
+    readonly recoverExistingGoal: (request: WorkExistingGoalRecovery) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError>;
+    /** Approval-bound owner transfer; replaying the same approval job returns the prior result. */
+    readonly reassign: (request: WorkGoalReassignment) => Effect.Effect<WorkGoalReassigned, WorkGoalAgentTargetConflictError | WorkGoalBindingRequiresAgentError | WorkGoalOwnerMismatchError | WorkGoalReassignmentConflictError | WorkGoalRevisionConflictError | WorkProjectionError | WorkStoreError>;
+    readonly admissionPreflight: (target: WorkAdmissionTarget) => Effect.Effect<WorkAdmissionPreflight, WorkProjectionError | WorkStoreError>;
+    readonly admitExistingOwner: (request: WorkProspectiveAdmission) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError>;
+    readonly inspectPullRequest: (request: WorkPullRequestLinkRequest) => Effect.Effect<WorkPullRequestLink, WorkPullRequestLinkError | WorkProjectionError | WorkStoreError>;
+    readonly reconcileExistingOwner: (request: WorkExistingOwnerReconciliation) => Effect.Effect<WorkLaneClaimed, WorkPullRequestLinkError | WorkLaneClaimConflictError | WorkLaneGoalConflictError | WorkLaneOperationConflictError | WorkProjectionError | WorkStoreError>;
+    readonly bindAgent: (request: WorkAgentBindingRequest) => Effect.Effect<WorkAgentBinding, WorkAgentBindingAuthorityError | WorkAgentBindingConflictError | WorkProjectionError | WorkStoreError>;
+    readonly agentBinding: (dispatchRequestId: string) => Effect.Effect<Option.Option<WorkAgentBinding>, WorkStoreError>;
     readonly record: (event: WorkGoalCheckpoint) => Effect.Effect<WorkGoalCheckpoint, WorkCheckpointConflictError | WorkProjectionError | WorkStoreError>;
+    /**
+     * Projects history at an explicit timestamp, or at the later of the current
+     * clock and the coordinator-owned logical timestamp when none is given.
+     */
     readonly snapshots: (observedAt?: number) => Effect.Effect<WorkSnapshots, WorkStoreError | WorkProjectionError>;
+    readonly recordMany: (transactionId: string, events: ReadonlyArray<WorkGoalCheckpoint>) => Effect.Effect<ReadonlyArray<WorkGoalCheckpoint>, WorkCheckpointConflictError | WorkProjectionError | WorkTransactionConflictError | WorkStoreError>;
+    readonly claim: (claim: WorkLaneClaim) => Effect.Effect<WorkLaneClaimed, WorkLaneClaimConflictError | WorkLaneGoalConflictError | WorkLaneOperationConflictError | WorkPullRequestLinkError | WorkProjectionError | WorkStoreError>;
+    readonly currentClaim: (laneId: string) => Effect.Effect<Option.Option<WorkLaneClaimed>, WorkStoreError>;
+    readonly activeGoalClaim: (goalId: string) => Effect.Effect<Option.Option<WorkLaneClaimed>, WorkStoreError>;
+    readonly handoff: (handoff: WorkDecisionHandoff) => Effect.Effect<WorkDecisionHandoff, WorkCoordinatorHandoffConflictError | WorkDecisionAuthorityConflictError | WorkDecisionHandoffConflictError | WorkDecisionRevisionConflictError | WorkProjectionError | WorkStoreError>;
+    readonly coordinatorHandoff: (sessionId: string) => Effect.Effect<Option.Option<WorkDecisionHandoff>, WorkStoreError>;
+    readonly decisions: (laneId: string) => Effect.Effect<ReadonlyArray<WorkDecisionHandoff>, WorkStoreError>;
 }
 export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect<{
+    recoveryContext: (goalId: string) => Effect.Effect<{
+        goalId: string;
+        expectedGoalEventId: string;
+        expectedGoalUpdatedAt: number;
+    }, WorkProjectionError | WorkRecoveryContextError | WorkStoreError, never>;
+    recoveryPreflight: (target: WorkRecoveryTarget) => Effect.Effect<{
+        readonly _tag: "conflict";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+            readonly expectedGoalEventId: string;
+            readonly expectedGoalUpdatedAt: number;
+        };
+        readonly reason: string;
+    } | {
+        readonly _tag: "existing";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+            readonly expectedGoalEventId: string;
+            readonly expectedGoalUpdatedAt: number;
+        };
+        readonly link: {
+            readonly request: {
+                readonly repository: string;
+                readonly pullRequest: number;
+                readonly goalId: string;
+                readonly laneId: string;
+            };
+            readonly goalEventId: string;
+            readonly goal: {
+                readonly id: string;
+                readonly title: string;
+                readonly summary: string;
+                readonly detail: string;
+                readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                readonly owner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly repository: {
+                    readonly repository: string;
+                    readonly branch: string;
+                };
+                readonly spend: {
+                    readonly currency: string;
+                    readonly minorUnits: number;
+                } | null;
+                readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                readonly blocker: {
+                    readonly summary: string;
+                    readonly since: number;
+                } | null;
+                readonly connectTarget: {
+                    readonly host: string;
+                    readonly agentId: string;
+                    readonly url: string;
+                } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
+                readonly agentHierarchy?: {
+                    readonly agent: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                } | null;
+                readonly activity?: readonly {
+                    readonly id: string;
+                    readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                    readonly summary: string;
+                    readonly occurredAt: number;
+                }[];
+                readonly blockers?: readonly {
+                    readonly summary: string;
+                    readonly since: number;
+                }[];
+                readonly requests?: readonly {
+                    readonly id: string;
+                    readonly summary: string;
+                    readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                    readonly requestedAt: number;
+                    readonly approvalTarget: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                }[];
+                readonly review?: {
+                    readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                    readonly summary: string | null;
+                    readonly updatedAt: number;
+                    readonly url: string | null;
+                } | null;
+                readonly approvalTarget?: {
+                    readonly host: string;
+                    readonly jobId: string;
+                    readonly url: string;
+                } | null;
+                readonly createdAt: number;
+                readonly updatedAt: number;
+            };
+            readonly lane: {
+                readonly operationId: string;
+                readonly goalId: string;
+                readonly laneId: string;
+                readonly worktree: string;
+                readonly branch: string;
+                readonly head: string;
+                readonly owner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly parent: string | null;
+                readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+                readonly expectedRevision: number;
+                readonly reconciliation?: {
+                    readonly repository: string;
+                    readonly pullRequest: number;
+                    readonly expectedHead: string;
+                    readonly expectedOwner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly expectedGoalEventId: string;
+                    readonly bindingDispatchRequestId: string;
+                    readonly sessionId: string;
+                    readonly worker: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                };
+                readonly revision: number;
+            };
+            readonly binding: {
+                readonly version: "herdr.work.agent-binding.v1";
+                readonly request: {
+                    readonly version: "herdr.work.agent-binding-request.v1";
+                    readonly dispatchRequestId: string;
+                    readonly laneId: string;
+                    readonly expectedRevision: number;
+                    readonly worker: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                    readonly prospectiveAdmission?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedAbsenceToken: string;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                    };
+                    readonly existingGoalRecovery?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedHistoryToken: string;
+                        readonly expectedGoalEventId: string;
+                        readonly expectedGoalUpdatedAt: number;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                        readonly approvalApprovedBy: string;
+                        readonly approvalApprovedAt: number;
+                        readonly approvalHash: string;
+                    };
+                    readonly ownerReassignment?: {
+                        readonly previousDispatchRequestId: string;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                        readonly approvalApprovedBy: string;
+                        readonly approvalApprovedAt: number;
+                        readonly approvalHash: string;
+                    };
+                };
+                readonly lane: {
+                    readonly operationId: string;
+                    readonly goalId: string;
+                    readonly laneId: string;
+                    readonly worktree: string;
+                    readonly branch: string;
+                    readonly head: string;
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly parent: string | null;
+                    readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+                    readonly expectedRevision: number;
+                    readonly reconciliation?: {
+                        readonly repository: string;
+                        readonly pullRequest: number;
+                        readonly expectedHead: string;
+                        readonly expectedOwner: {
+                            readonly id: string;
+                            readonly name: string;
+                        };
+                        readonly expectedGoalEventId: string;
+                        readonly bindingDispatchRequestId: string;
+                        readonly sessionId: string;
+                        readonly worker: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    };
+                    readonly revision: number;
+                };
+                readonly checkpoint: {
+                    readonly version: "herdr.work.event.v1";
+                    readonly eventId: string;
+                    readonly occurredAt: number;
+                    readonly goal: {
+                        readonly id: string;
+                        readonly title: string;
+                        readonly summary: string;
+                        readonly detail: string;
+                        readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                        readonly owner: {
+                            readonly id: string;
+                            readonly name: string;
+                        };
+                        readonly repository: {
+                            readonly repository: string;
+                            readonly branch: string;
+                        };
+                        readonly spend: {
+                            readonly currency: string;
+                            readonly minorUnits: number;
+                        } | null;
+                        readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                        readonly blocker: {
+                            readonly summary: string;
+                            readonly since: number;
+                        } | null;
+                        readonly connectTarget: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly url: string;
+                        } | null;
+                        readonly goalFamily?: {
+                            readonly canonicalGoalId: string;
+                            readonly role: "canonical" | "superseded";
+                        };
+                        readonly agentHierarchy?: {
+                            readonly agent: {
+                                readonly host: string;
+                                readonly agentId: string;
+                                readonly name: string;
+                                readonly paneId: string;
+                                readonly relationship?: {
+                                    readonly parentAgentId: string;
+                                    readonly relation: "delegated" | "pair" | "review";
+                                };
+                            };
+                        } | null;
+                        readonly activity?: readonly {
+                            readonly id: string;
+                            readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                            readonly summary: string;
+                            readonly occurredAt: number;
+                        }[];
+                        readonly blockers?: readonly {
+                            readonly summary: string;
+                            readonly since: number;
+                        }[];
+                        readonly requests?: readonly {
+                            readonly id: string;
+                            readonly summary: string;
+                            readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                            readonly requestedAt: number;
+                            readonly approvalTarget: {
+                                readonly host: string;
+                                readonly jobId: string;
+                                readonly url: string;
+                            } | null;
+                        }[];
+                        readonly review?: {
+                            readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                            readonly summary: string | null;
+                            readonly updatedAt: number;
+                            readonly url: string | null;
+                        } | null;
+                        readonly approvalTarget?: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                        readonly createdAt: number;
+                        readonly updatedAt: number;
+                    };
+                };
+            };
+        };
+    } | {
+        readonly _tag: "recoverable";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+            readonly expectedGoalEventId: string;
+            readonly expectedGoalUpdatedAt: number;
+        };
+        readonly historyToken: string;
+    }, WorkProjectionError | WorkStoreError, never>;
+    recoverExistingGoal: (request: {
+        readonly kind: "work.recover";
+        readonly repository: string;
+        readonly pullRequest: number;
+        readonly reviewUrl: string;
+        readonly goalId: string;
+        readonly laneId: string;
+        readonly operationId: string;
+        readonly expectedGoalEventId: string;
+        readonly expectedGoalUpdatedAt: number;
+        readonly expectedHistoryToken: string;
+        readonly head: string;
+        readonly baseHead: string;
+        readonly owner: {
+            readonly id: string;
+            readonly name: string;
+        };
+        readonly sessionId: string;
+        readonly expectedWork: string;
+        readonly worker: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly worktree: string;
+        readonly branch: string;
+        readonly approvalJobId: string;
+        readonly approvalActor: string;
+        readonly approvalApprovedBy: string;
+        readonly approvalApprovedAt: number;
+        readonly approvalHash: string;
+    }) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError, never>;
+    reassign: (request: {
+        readonly kind: "work.reassign";
+        readonly goalId: string;
+        readonly from: {
+            readonly id: string;
+            readonly name: string;
+        };
+        readonly to: {
+            readonly id: string;
+            readonly name: string;
+        };
+        readonly toAgent: {
+            readonly _tag: "clear";
+        } | {
+            readonly _tag: "keep";
+        } | {
+            readonly _tag: "set";
+            readonly agent: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+        };
+        readonly reason: string;
+        readonly expectedGoalEventId: string;
+        readonly expectedGoalUpdatedAt: number;
+        readonly approvalJobId: string;
+        readonly approvalActor: string;
+        readonly approvalApprovedBy: string;
+        readonly approvalApprovedAt: number;
+        readonly approvalHash: string;
+    }) => Effect.Effect<WorkGoalReassigned, WorkGoalAgentTargetConflictError | WorkGoalBindingRequiresAgentError | WorkGoalOwnerMismatchError | WorkGoalReassignmentConflictError | WorkGoalRevisionConflictError | WorkProjectionError | WorkStoreError, never>;
+    admissionPreflight: (target: WorkAdmissionTarget) => Effect.Effect<{
+        readonly _tag: "conflict";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+        };
+        readonly reason: string;
+    } | {
+        readonly _tag: "existing";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+        };
+        readonly link: {
+            readonly request: {
+                readonly repository: string;
+                readonly pullRequest: number;
+                readonly goalId: string;
+                readonly laneId: string;
+            };
+            readonly goalEventId: string;
+            readonly goal: {
+                readonly id: string;
+                readonly title: string;
+                readonly summary: string;
+                readonly detail: string;
+                readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                readonly owner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly repository: {
+                    readonly repository: string;
+                    readonly branch: string;
+                };
+                readonly spend: {
+                    readonly currency: string;
+                    readonly minorUnits: number;
+                } | null;
+                readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                readonly blocker: {
+                    readonly summary: string;
+                    readonly since: number;
+                } | null;
+                readonly connectTarget: {
+                    readonly host: string;
+                    readonly agentId: string;
+                    readonly url: string;
+                } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
+                readonly agentHierarchy?: {
+                    readonly agent: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                } | null;
+                readonly activity?: readonly {
+                    readonly id: string;
+                    readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                    readonly summary: string;
+                    readonly occurredAt: number;
+                }[];
+                readonly blockers?: readonly {
+                    readonly summary: string;
+                    readonly since: number;
+                }[];
+                readonly requests?: readonly {
+                    readonly id: string;
+                    readonly summary: string;
+                    readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                    readonly requestedAt: number;
+                    readonly approvalTarget: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                }[];
+                readonly review?: {
+                    readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                    readonly summary: string | null;
+                    readonly updatedAt: number;
+                    readonly url: string | null;
+                } | null;
+                readonly approvalTarget?: {
+                    readonly host: string;
+                    readonly jobId: string;
+                    readonly url: string;
+                } | null;
+                readonly createdAt: number;
+                readonly updatedAt: number;
+            };
+            readonly lane: {
+                readonly operationId: string;
+                readonly goalId: string;
+                readonly laneId: string;
+                readonly worktree: string;
+                readonly branch: string;
+                readonly head: string;
+                readonly owner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly parent: string | null;
+                readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+                readonly expectedRevision: number;
+                readonly reconciliation?: {
+                    readonly repository: string;
+                    readonly pullRequest: number;
+                    readonly expectedHead: string;
+                    readonly expectedOwner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly expectedGoalEventId: string;
+                    readonly bindingDispatchRequestId: string;
+                    readonly sessionId: string;
+                    readonly worker: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                };
+                readonly revision: number;
+            };
+            readonly binding: {
+                readonly version: "herdr.work.agent-binding.v1";
+                readonly request: {
+                    readonly version: "herdr.work.agent-binding-request.v1";
+                    readonly dispatchRequestId: string;
+                    readonly laneId: string;
+                    readonly expectedRevision: number;
+                    readonly worker: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                    readonly prospectiveAdmission?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedAbsenceToken: string;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                    };
+                    readonly existingGoalRecovery?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedHistoryToken: string;
+                        readonly expectedGoalEventId: string;
+                        readonly expectedGoalUpdatedAt: number;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                        readonly approvalApprovedBy: string;
+                        readonly approvalApprovedAt: number;
+                        readonly approvalHash: string;
+                    };
+                    readonly ownerReassignment?: {
+                        readonly previousDispatchRequestId: string;
+                        readonly approvalJobId: string;
+                        readonly approvalActor: string;
+                        readonly approvalApprovedBy: string;
+                        readonly approvalApprovedAt: number;
+                        readonly approvalHash: string;
+                    };
+                };
+                readonly lane: {
+                    readonly operationId: string;
+                    readonly goalId: string;
+                    readonly laneId: string;
+                    readonly worktree: string;
+                    readonly branch: string;
+                    readonly head: string;
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly parent: string | null;
+                    readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+                    readonly expectedRevision: number;
+                    readonly reconciliation?: {
+                        readonly repository: string;
+                        readonly pullRequest: number;
+                        readonly expectedHead: string;
+                        readonly expectedOwner: {
+                            readonly id: string;
+                            readonly name: string;
+                        };
+                        readonly expectedGoalEventId: string;
+                        readonly bindingDispatchRequestId: string;
+                        readonly sessionId: string;
+                        readonly worker: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    };
+                    readonly revision: number;
+                };
+                readonly checkpoint: {
+                    readonly version: "herdr.work.event.v1";
+                    readonly eventId: string;
+                    readonly occurredAt: number;
+                    readonly goal: {
+                        readonly id: string;
+                        readonly title: string;
+                        readonly summary: string;
+                        readonly detail: string;
+                        readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                        readonly owner: {
+                            readonly id: string;
+                            readonly name: string;
+                        };
+                        readonly repository: {
+                            readonly repository: string;
+                            readonly branch: string;
+                        };
+                        readonly spend: {
+                            readonly currency: string;
+                            readonly minorUnits: number;
+                        } | null;
+                        readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                        readonly blocker: {
+                            readonly summary: string;
+                            readonly since: number;
+                        } | null;
+                        readonly connectTarget: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly url: string;
+                        } | null;
+                        readonly goalFamily?: {
+                            readonly canonicalGoalId: string;
+                            readonly role: "canonical" | "superseded";
+                        };
+                        readonly agentHierarchy?: {
+                            readonly agent: {
+                                readonly host: string;
+                                readonly agentId: string;
+                                readonly name: string;
+                                readonly paneId: string;
+                                readonly relationship?: {
+                                    readonly parentAgentId: string;
+                                    readonly relation: "delegated" | "pair" | "review";
+                                };
+                            };
+                        } | null;
+                        readonly activity?: readonly {
+                            readonly id: string;
+                            readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                            readonly summary: string;
+                            readonly occurredAt: number;
+                        }[];
+                        readonly blockers?: readonly {
+                            readonly summary: string;
+                            readonly since: number;
+                        }[];
+                        readonly requests?: readonly {
+                            readonly id: string;
+                            readonly summary: string;
+                            readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                            readonly requestedAt: number;
+                            readonly approvalTarget: {
+                                readonly host: string;
+                                readonly jobId: string;
+                                readonly url: string;
+                            } | null;
+                        }[];
+                        readonly review?: {
+                            readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                            readonly summary: string | null;
+                            readonly updatedAt: number;
+                            readonly url: string | null;
+                        } | null;
+                        readonly approvalTarget?: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                        readonly createdAt: number;
+                        readonly updatedAt: number;
+                    };
+                };
+            };
+        };
+    } | {
+        readonly _tag: "prospective";
+        readonly target: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly reviewUrl: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly head: string;
+            readonly baseHead: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly sessionId: string;
+            readonly expectedWork: string;
+            readonly worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly worktree: string;
+            readonly branch: string;
+        };
+        readonly absenceToken: string;
+    }, WorkProjectionError | WorkStoreError, never>;
+    admitExistingOwner: (request: {
+        readonly kind: "work.admit";
+        readonly repository: string;
+        readonly pullRequest: number;
+        readonly reviewUrl: string;
+        readonly goalId: string;
+        readonly laneId: string;
+        readonly operationId: string;
+        readonly expectedAbsenceToken: string;
+        readonly head: string;
+        readonly baseHead: string;
+        readonly owner: {
+            readonly id: string;
+            readonly name: string;
+        };
+        readonly sessionId: string;
+        readonly expectedWork: string;
+        readonly worker: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly worktree: string;
+        readonly branch: string;
+        readonly title: string;
+        readonly summary: string;
+        readonly detail: string;
+        readonly approvalJobId: string;
+        readonly approvalActor: string;
+    }) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError, never>;
+    agentBinding: (dispatchRequestId: string) => Effect.Effect<Option.Option<WorkAgentBinding>, WorkStoreError, never>;
+    inspectPullRequest: (request: WorkPullRequestLinkRequest) => Effect.Effect<{
+        readonly request: {
+            readonly repository: string;
+            readonly pullRequest: number;
+            readonly goalId: string;
+            readonly laneId: string;
+        };
+        readonly goalEventId: string;
+        readonly goal: {
+            readonly id: string;
+            readonly title: string;
+            readonly summary: string;
+            readonly detail: string;
+            readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly repository: {
+                readonly repository: string;
+                readonly branch: string;
+            };
+            readonly spend: {
+                readonly currency: string;
+                readonly minorUnits: number;
+            } | null;
+            readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+            readonly blocker: {
+                readonly summary: string;
+                readonly since: number;
+            } | null;
+            readonly connectTarget: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly url: string;
+            } | null;
+            readonly goalFamily?: {
+                readonly canonicalGoalId: string;
+                readonly role: "canonical" | "superseded";
+            };
+            readonly agentHierarchy?: {
+                readonly agent: {
+                    readonly host: string;
+                    readonly agentId: string;
+                    readonly name: string;
+                    readonly paneId: string;
+                    readonly relationship?: {
+                        readonly parentAgentId: string;
+                        readonly relation: "delegated" | "pair" | "review";
+                    };
+                };
+            } | null;
+            readonly activity?: readonly {
+                readonly id: string;
+                readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                readonly summary: string;
+                readonly occurredAt: number;
+            }[];
+            readonly blockers?: readonly {
+                readonly summary: string;
+                readonly since: number;
+            }[];
+            readonly requests?: readonly {
+                readonly id: string;
+                readonly summary: string;
+                readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                readonly requestedAt: number;
+                readonly approvalTarget: {
+                    readonly host: string;
+                    readonly jobId: string;
+                    readonly url: string;
+                } | null;
+            }[];
+            readonly review?: {
+                readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                readonly summary: string | null;
+                readonly updatedAt: number;
+                readonly url: string | null;
+            } | null;
+            readonly approvalTarget?: {
+                readonly host: string;
+                readonly jobId: string;
+                readonly url: string;
+            } | null;
+            readonly createdAt: number;
+            readonly updatedAt: number;
+        };
+        readonly lane: {
+            readonly operationId: string;
+            readonly goalId: string;
+            readonly laneId: string;
+            readonly worktree: string;
+            readonly branch: string;
+            readonly head: string;
+            readonly owner: {
+                readonly id: string;
+                readonly name: string;
+            };
+            readonly parent: string | null;
+            readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+            readonly expectedRevision: number;
+            readonly reconciliation?: {
+                readonly repository: string;
+                readonly pullRequest: number;
+                readonly expectedHead: string;
+                readonly expectedOwner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly expectedGoalEventId: string;
+                readonly bindingDispatchRequestId: string;
+                readonly sessionId: string;
+                readonly worker: {
+                    readonly host: string;
+                    readonly agentId: string;
+                    readonly name: string;
+                    readonly paneId: string;
+                    readonly relationship?: {
+                        readonly parentAgentId: string;
+                        readonly relation: "delegated" | "pair" | "review";
+                    };
+                };
+            };
+            readonly revision: number;
+        };
+        readonly binding: {
+            readonly version: "herdr.work.agent-binding.v1";
+            readonly request: {
+                readonly version: "herdr.work.agent-binding-request.v1";
+                readonly dispatchRequestId: string;
+                readonly laneId: string;
+                readonly expectedRevision: number;
+                readonly worker: {
+                    readonly host: string;
+                    readonly agentId: string;
+                    readonly name: string;
+                    readonly paneId: string;
+                    readonly relationship?: {
+                        readonly parentAgentId: string;
+                        readonly relation: "delegated" | "pair" | "review";
+                    };
+                };
+                readonly prospectiveAdmission?: {
+                    readonly sessionId: string;
+                    readonly workAssignment: string;
+                    readonly baseHead: string;
+                    readonly expectedAbsenceToken: string;
+                    readonly approvalJobId: string;
+                    readonly approvalActor: string;
+                };
+                readonly existingGoalRecovery?: {
+                    readonly sessionId: string;
+                    readonly workAssignment: string;
+                    readonly baseHead: string;
+                    readonly expectedHistoryToken: string;
+                    readonly expectedGoalEventId: string;
+                    readonly expectedGoalUpdatedAt: number;
+                    readonly approvalJobId: string;
+                    readonly approvalActor: string;
+                    readonly approvalApprovedBy: string;
+                    readonly approvalApprovedAt: number;
+                    readonly approvalHash: string;
+                };
+                readonly ownerReassignment?: {
+                    readonly previousDispatchRequestId: string;
+                    readonly approvalJobId: string;
+                    readonly approvalActor: string;
+                    readonly approvalApprovedBy: string;
+                    readonly approvalApprovedAt: number;
+                    readonly approvalHash: string;
+                };
+            };
+            readonly lane: {
+                readonly operationId: string;
+                readonly goalId: string;
+                readonly laneId: string;
+                readonly worktree: string;
+                readonly branch: string;
+                readonly head: string;
+                readonly owner: {
+                    readonly id: string;
+                    readonly name: string;
+                };
+                readonly parent: string | null;
+                readonly phase: "claim" | "implementation" | "review" | "shipped" | "validation";
+                readonly expectedRevision: number;
+                readonly reconciliation?: {
+                    readonly repository: string;
+                    readonly pullRequest: number;
+                    readonly expectedHead: string;
+                    readonly expectedOwner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly expectedGoalEventId: string;
+                    readonly bindingDispatchRequestId: string;
+                    readonly sessionId: string;
+                    readonly worker: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly name: string;
+                        readonly paneId: string;
+                        readonly relationship?: {
+                            readonly parentAgentId: string;
+                            readonly relation: "delegated" | "pair" | "review";
+                        };
+                    };
+                };
+                readonly revision: number;
+            };
+            readonly checkpoint: {
+                readonly version: "herdr.work.event.v1";
+                readonly eventId: string;
+                readonly occurredAt: number;
+                readonly goal: {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                };
+            };
+        };
+    }, WorkProjectionError | WorkPullRequestLinkError | WorkStoreError, never>;
+    reconcileExistingOwner: (request: WorkExistingOwnerReconciliation) => Effect.Effect<WorkLaneClaimed, WorkLaneClaimConflictError | WorkLaneGoalConflictError | WorkLaneOperationConflictError | WorkProjectionError | WorkPullRequestLinkError | WorkStoreError, never>;
+    activeGoalClaim: (goalId: string) => Effect.Effect<Option.Option<WorkLaneClaimed>, WorkStoreError, never>;
+    bindAgent: (request: WorkAgentBindingRequest) => Effect.Effect<WorkAgentBinding, WorkAgentBindingAuthorityError | WorkAgentBindingConflictError | WorkProjectionError | WorkStoreError, never>;
+    claim: (lane: WorkLaneClaim) => Effect.Effect<WorkLaneClaimed, WorkLaneClaimConflictError | WorkLaneGoalConflictError | WorkLaneOperationConflictError | WorkProjectionError | WorkPullRequestLinkError | WorkStoreError, never>;
+    coordinatorHandoff: (sessionId: string) => Effect.Effect<Option.Option<WorkDecisionHandoff>, WorkStoreError, never>;
+    currentClaim: (laneId: string) => Effect.Effect<Option.Option<WorkLaneClaimed>, WorkStoreError, never>;
+    decisions: (laneId: string) => Effect.Effect<readonly WorkDecisionHandoff[], WorkStoreError, never>;
+    handoff: (decision: WorkDecisionHandoff) => Effect.Effect<WorkDecisionHandoff, WorkCoordinatorHandoffConflictError | WorkDecisionAuthorityConflictError | WorkDecisionHandoffConflictError | WorkDecisionRevisionConflictError | WorkProjectionError | WorkStoreError, never>;
     record: (event: WorkGoalCheckpoint) => Effect.Effect<WorkGoalCheckpoint, WorkCheckpointConflictError | WorkProjectionError | WorkStoreError, never>;
+    recordMany: (transactionId: string, events: readonly WorkGoalCheckpoint[]) => Effect.Effect<readonly WorkGoalCheckpoint[], WorkCheckpointConflictError | WorkProjectionError | WorkStoreError | WorkTransactionConflictError, never>;
     snapshots: (observedAt?: number | undefined) => Effect.Effect<{
         readonly observedAt: number;
         readonly now: {
@@ -42,6 +1265,10 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly agentId: string;
                     readonly url: string;
                 } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
                 readonly agentHierarchy?: {
                     readonly agent: {
                         readonly host: string;
@@ -89,6 +1316,167 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly createdAt: number;
                 readonly updatedAt: number;
             }[];
+            readonly families?: readonly {
+                readonly canonicalGoalId: string;
+                readonly canonical: {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                };
+                readonly superseded: readonly {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                }[];
+            }[];
         };
         readonly day: {
             readonly window: "day" | "month" | "now" | "week";
@@ -122,6 +1510,10 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly agentId: string;
                     readonly url: string;
                 } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
                 readonly agentHierarchy?: {
                     readonly agent: {
                         readonly host: string;
@@ -169,6 +1561,167 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly createdAt: number;
                 readonly updatedAt: number;
             }[];
+            readonly families?: readonly {
+                readonly canonicalGoalId: string;
+                readonly canonical: {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                };
+                readonly superseded: readonly {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                }[];
+            }[];
         };
         readonly week: {
             readonly window: "day" | "month" | "now" | "week";
@@ -202,6 +1755,10 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly agentId: string;
                     readonly url: string;
                 } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
                 readonly agentHierarchy?: {
                     readonly agent: {
                         readonly host: string;
@@ -249,6 +1806,167 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly createdAt: number;
                 readonly updatedAt: number;
             }[];
+            readonly families?: readonly {
+                readonly canonicalGoalId: string;
+                readonly canonical: {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                };
+                readonly superseded: readonly {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                }[];
+            }[];
         };
         readonly month: {
             readonly window: "day" | "month" | "now" | "week";
@@ -282,6 +2000,10 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly agentId: string;
                     readonly url: string;
                 } | null;
+                readonly goalFamily?: {
+                    readonly canonicalGoalId: string;
+                    readonly role: "canonical" | "superseded";
+                };
                 readonly agentHierarchy?: {
                     readonly agent: {
                         readonly host: string;
@@ -329,6 +2051,167 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly createdAt: number;
                 readonly updatedAt: number;
             }[];
+            readonly families?: readonly {
+                readonly canonicalGoalId: string;
+                readonly canonical: {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                };
+                readonly superseded: readonly {
+                    readonly id: string;
+                    readonly title: string;
+                    readonly summary: string;
+                    readonly detail: string;
+                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly owner: {
+                        readonly id: string;
+                        readonly name: string;
+                    };
+                    readonly repository: {
+                        readonly repository: string;
+                        readonly branch: string;
+                    };
+                    readonly spend: {
+                        readonly currency: string;
+                        readonly minorUnits: number;
+                    } | null;
+                    readonly delivery: "deployed" | "local" | "merged" | "pull_request" | "review";
+                    readonly blocker: {
+                        readonly summary: string;
+                        readonly since: number;
+                    } | null;
+                    readonly connectTarget: {
+                        readonly host: string;
+                        readonly agentId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly goalFamily?: {
+                        readonly canonicalGoalId: string;
+                        readonly role: "canonical" | "superseded";
+                    };
+                    readonly agentHierarchy?: {
+                        readonly agent: {
+                            readonly host: string;
+                            readonly agentId: string;
+                            readonly name: string;
+                            readonly paneId: string;
+                            readonly relationship?: {
+                                readonly parentAgentId: string;
+                                readonly relation: "delegated" | "pair" | "review";
+                            };
+                        };
+                    } | null;
+                    readonly activity?: readonly {
+                        readonly id: string;
+                        readonly kind: "blocker" | "note" | "request" | "review" | "shipment" | "status";
+                        readonly summary: string;
+                        readonly occurredAt: number;
+                    }[];
+                    readonly blockers?: readonly {
+                        readonly summary: string;
+                        readonly since: number;
+                    }[];
+                    readonly requests?: readonly {
+                        readonly id: string;
+                        readonly summary: string;
+                        readonly state: "approved" | "fulfilled" | "open" | "rejected";
+                        readonly requestedAt: number;
+                        readonly approvalTarget: {
+                            readonly host: string;
+                            readonly jobId: string;
+                            readonly url: string;
+                        } | null;
+                    }[];
+                    readonly review?: {
+                        readonly state: "approved" | "changes_requested" | "not_requested" | "requested";
+                        readonly summary: string | null;
+                        readonly updatedAt: number;
+                        readonly url: string | null;
+                    } | null;
+                    readonly approvalTarget?: {
+                        readonly host: string;
+                        readonly jobId: string;
+                        readonly url: string;
+                    } | null;
+                    readonly createdAt: number;
+                    readonly updatedAt: number;
+                }[];
+            }[];
         };
     }, WorkProjectionError | WorkStoreError, never>;
 }, never, never>;