@knpkv/herdr-work 0.5.3 → 0.6.0

package/dist/service.d.ts

@@ -1,7 +1,7 @@
 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 type { WorkAdmissionConflictError, WorkAgentBindingAuthorityError, WorkAgentBindingConflictError, WorkCheckpointConflictError, WorkCoordinatorHandoffConflictError, WorkDecisionAuthorityConflictError, WorkDecisionHandoffConflictError, WorkDecisionRevisionConflictError, WorkGoalAbandonmentConflictError, WorkGoalAgentTargetConflictError, WorkGoalBindingRequiresAgentError, WorkGoalLaneActiveError, WorkGoalOwnerMismatchError, WorkGoalReassignmentConflictError, WorkGoalRevisionConflictError, WorkGoalTerminalError, WorkLaneClaimConflictError, WorkLaneGoalConflictError, WorkLaneOperationConflictError, WorkProjectionError, WorkStoreError, WorkTransactionConflictError } from "./errors.js";
+import type { WorkAdmissionPreflight, WorkAdmissionTarget, WorkAgentBinding, WorkAgentBindingRequest, WorkDecisionHandoff, WorkExistingGoalRecovery, WorkExistingOwnerReconciliation, WorkGoalAbandoned, WorkGoalAbandonment, WorkGoalCheckpoint, WorkGoalReassigned, WorkGoalReassignment, WorkLaneClaim, WorkLaneClaimed, WorkObservationEnvelope, WorkObservedAdmission, WorkObserveReport, WorkProspectiveAdmission, WorkReconcileOutcome, WorkRecoveryContext, WorkRecoveryPreflight, WorkRecoveryTarget, WorkSnapshots } from "./model.js";
 import { WorkPullRequestLink, WorkPullRequestLinkRequest } from "./model.js";
 import type { WorkStoreService } from "./store.js";
 export interface WorkService {
@@ -11,16 +11,40 @@ export interface WorkService {
     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>;
+    /**
+     * Approval-bound move of a goal to `abandoned`; refuses a goal with an active
+     * lane or one already finished. Replaying the same approval job returns the
+     * prior result.
+     */
+    readonly abandon: (request: WorkGoalAbandonment) => Effect.Effect<WorkGoalAbandoned, WorkGoalAbandonmentConflictError | WorkGoalLaneActiveError | WorkGoalOwnerMismatchError | WorkGoalRevisionConflictError | WorkGoalTerminalError | WorkProjectionError | WorkStoreError>;
     readonly admissionPreflight: (target: WorkAdmissionTarget) => Effect.Effect<WorkAdmissionPreflight, WorkProjectionError | WorkStoreError>;
     readonly admitExistingOwner: (request: WorkProspectiveAdmission) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError>;
+    /**
+     * Admits a worker the reconciler observed, without an approval: the same
+     * write as `admitExistingOwner`, credited to the observation. The caller has
+     * checked the pane's host, lineage and worktree; the store re-checks the
+     * absence evidence.
+     */
+    readonly admitObserved: (request: WorkObservedAdmission) => 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>;
+    /**
+     * Records goals whose pull request is observed merged or closed as completed
+     * or abandoned. Run it after `observe`; it never writes anything else.
+     */
+    readonly reconcile: () => Effect.Effect<ReadonlyArray<WorkReconcileOutcome>, WorkCheckpointConflictError | WorkProjectionError | WorkStoreError>;
+    /**
+     * Stores observed facts (a pull request's state, an agent's status) for the
+     * Work tab. Facts are not goal history and never change an approval token.
+     */
+    readonly observe: (envelopes: ReadonlyArray<WorkObservationEnvelope>) => Effect.Effect<WorkObserveReport, 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.
+     * clock and the coordinator-owned logical timestamp when none is given. The
+     * `now` window also carries each goal's observed facts.
      */
     readonly snapshots: (observedAt?: number) => Effect.Effect<WorkSnapshots, WorkStoreError | WorkProjectionError>;
     readonly recordMany: (transactionId: string, events: ReadonlyArray<WorkGoalCheckpoint>) => Effect.Effect<ReadonlyArray<WorkGoalCheckpoint>, WorkCheckpointConflictError | WorkProjectionError | WorkTransactionConflictError | WorkStoreError>;
@@ -113,7 +137,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly title: string;
                 readonly summary: string;
                 readonly detail: string;
-                readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
                 readonly owner: {
                     readonly id: string;
                     readonly name: string;
@@ -250,6 +274,14 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                         readonly approvalJobId: string;
                         readonly approvalActor: string;
                     };
+                    readonly observedAdmission?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedAbsenceToken: string;
+                        readonly actor: "reconciler";
+                        readonly observationId: string;
+                    };
                     readonly existingGoalRecovery?: {
                         readonly sessionId: string;
                         readonly workAssignment: string;
@@ -319,7 +351,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                         readonly title: string;
                         readonly summary: string;
                         readonly detail: string;
-                        readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                        readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
                         readonly owner: {
                             readonly id: string;
                             readonly name: string;
@@ -503,6 +535,22 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
         readonly approvalApprovedAt: number;
         readonly approvalHash: string;
     }) => Effect.Effect<WorkGoalReassigned, WorkGoalAgentTargetConflictError | WorkGoalBindingRequiresAgentError | WorkGoalOwnerMismatchError | WorkGoalReassignmentConflictError | WorkGoalRevisionConflictError | WorkProjectionError | WorkStoreError, never>;
+    abandon: (request: {
+        readonly kind: "work.abandon";
+        readonly goalId: string;
+        readonly owner: {
+            readonly id: string;
+            readonly name: string;
+        };
+        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<WorkGoalAbandoned, WorkGoalAbandonmentConflictError | WorkGoalLaneActiveError | WorkGoalOwnerMismatchError | WorkGoalRevisionConflictError | WorkGoalTerminalError | WorkProjectionError | WorkStoreError, never>;
     admissionPreflight: (target: WorkAdmissionTarget) => Effect.Effect<{
         readonly _tag: "conflict";
         readonly target: {
@@ -575,7 +623,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                 readonly title: string;
                 readonly summary: string;
                 readonly detail: string;
-                readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
                 readonly owner: {
                     readonly id: string;
                     readonly name: string;
@@ -712,6 +760,14 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                         readonly approvalJobId: string;
                         readonly approvalActor: string;
                     };
+                    readonly observedAdmission?: {
+                        readonly sessionId: string;
+                        readonly workAssignment: string;
+                        readonly baseHead: string;
+                        readonly expectedAbsenceToken: string;
+                        readonly actor: "reconciler";
+                        readonly observationId: string;
+                    };
                     readonly existingGoalRecovery?: {
                         readonly sessionId: string;
                         readonly workAssignment: string;
@@ -781,7 +837,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                         readonly title: string;
                         readonly summary: string;
                         readonly detail: string;
-                        readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                        readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
                         readonly owner: {
                             readonly id: string;
                             readonly name: string;
@@ -924,6 +980,39 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
         readonly approvalJobId: string;
         readonly approvalActor: string;
     }) => Effect.Effect<WorkPullRequestLink, WorkAdmissionConflictError | WorkProjectionError | WorkStoreError, never>;
+    admitObserved: (request: {
+        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 observationId: 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: {
@@ -938,7 +1027,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
             readonly title: string;
             readonly summary: string;
             readonly detail: string;
-            readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+            readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
             readonly owner: {
                 readonly id: string;
                 readonly name: string;
@@ -1075,6 +1164,14 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly approvalJobId: string;
                     readonly approvalActor: string;
                 };
+                readonly observedAdmission?: {
+                    readonly sessionId: string;
+                    readonly workAssignment: string;
+                    readonly baseHead: string;
+                    readonly expectedAbsenceToken: string;
+                    readonly actor: "reconciler";
+                    readonly observationId: string;
+                };
                 readonly existingGoalRecovery?: {
                     readonly sessionId: string;
                     readonly workAssignment: string;
@@ -1144,7 +1241,7 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
                     readonly title: string;
                     readonly summary: string;
                     readonly detail: string;
-                    readonly state: "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
+                    readonly state: "abandoned" | "blocked" | "completed" | "deployed" | "planned" | "review" | "working";
                     readonly owner: {
                         readonly id: string;
                         readonly name: string;
@@ -1229,990 +1326,22 @@ export declare const makeWorkService: (store: WorkStoreService) => Effect.Effect
     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>;
+    observe: (envelopes: readonly WorkObservationEnvelope[]) => Effect.Effect<WorkObserveReport, WorkStoreError, never>;
+    reconcile: () => Effect.Effect<readonly ({
+        readonly _tag: "applied";
+        readonly goalId: string;
+        readonly eventId: string;
+        readonly state: "abandoned" | "completed";
+    } | {
+        readonly _tag: "conflict";
+        readonly goalId: string;
+    } | {
+        readonly _tag: "recorded";
+        readonly goalId: string;
+        readonly eventId: string;
+    })[], WorkCheckpointConflictError | 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: {
-            readonly window: "day" | "month" | "now" | "week";
-            readonly observedAt: number;
-            readonly asOf: number;
-            readonly goals: 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 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";
-            readonly observedAt: number;
-            readonly asOf: number;
-            readonly goals: 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 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";
-            readonly observedAt: number;
-            readonly asOf: number;
-            readonly goals: 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 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";
-            readonly observedAt: number;
-            readonly asOf: number;
-            readonly goals: 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 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>;
+    snapshots: (observedAt?: number | undefined) => Effect.Effect<WorkSnapshots, WorkProjectionError | WorkStoreError, never>;
 }, never, never>;
 //# sourceMappingURL=service.d.ts.map