@knpkv/herdr-work 0.2.0 → 0.4.0

package/README.md

@@ -4,4 +4,16 @@ Durable fleet work checkpoints and the Rly departure-board projection used by th
 
 Each `WorkGoalCheckpoint` stores a complete, Schema-decoded goal state at its exact durable timestamp. `projectWorkSnapshots` selects the latest recorded checkpoint at now, 24 hours, 7 days, and 30 days. A goal does not appear before its creation checkpoint, and missing history is never synthesized.
 
-`WorkStore` persists events in SQLite. Recording the exact same checkpoint again is an idempotent replay; reusing an event ID or goal timestamp with changed content returns `WorkCheckpointConflictError`. `makeWorkService` is the small runtime interface for recording checkpoints and reading all four snapshots. `WorkBoard` renders the projection and links only through the persisted `AgentConnectTarget`.
+`WorkGoal.goalFamily` records a goal as either the canonical member of a family or a superseded member pointing to that canonical goal. Superseded goals leave the active projection only after their durable relation checkpoint. Earlier snapshots still show their previous state, blockers, reviews, and activity. A relation cannot be removed or retargeted, and a superseded goal cannot precede its canonical member.
+
+`WorkStore` persists events in SQLite. Recording the exact same checkpoint again is an idempotent replay; reusing an event ID or goal timestamp with changed content returns `WorkCheckpointConflictError`. `makeWorkService` is the small runtime interface for recording checkpoints and reading all four snapshots.
+
+`WorkBoard` renders these persisted outbound-link forms:
+
+- `AgentConnectTarget.url` — local terminal handoff.
+- `WorkApprovalTarget` — approval deep link with its host and job identity. The approvals ingestion boundary resolves the configured destination and verifies the URL origin before persistence; the root path and identity query remain required.
+- `WorkReview.url` — review destination.
+
+Every URL uses the credential-free HTTP(S) `LinkUrl` boundary. Provider credentials and private locators never enter these persisted or browser-visible links.
+
+`WorkBoard` accepts `externalLinks="enabled"` by default. With `externalLinks="disabled"`, it keeps recorded approval, review, and Connect targets visible as metadata without rendering outbound links for read-only LAN Work.

package/dist/goal-family.d.ts

@@ -0,0 +1,4 @@
+import { WorkProjectionError } from "./errors.js";
+import type { WorkGoalCheckpoint } from "./model.js";
+export declare const validateGoalFamilyHistory: (events: ReadonlyArray<WorkGoalCheckpoint>) => WorkProjectionError | undefined;
+//# sourceMappingURL=goal-family.d.ts.map

package/dist/goal-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-family.d.ts","sourceRoot":"","sources":["../src/goal-family.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAA;AAKpE,eAAO,MAAM,yBAAyB,WAC5B,aAAa,CAAC,kBAAkB,CAAC,KACxC,mBAAmB,GAAG,SAkCxB,CAAA"}

package/dist/goal-family.js

@@ -0,0 +1,32 @@
+import { WorkProjectionError } from "./errors.js";
+const inconsistency = (detail, cause) => new WorkProjectionError({ cause, detail, reason: "inconsistent_history" });
+export const validateGoalFamilyHistory = (events) => {
+    const familyByGoal = new Map();
+    const canonicalActivatedAt = new Map();
+    const ordered = events.toSorted((left, right) => left.occurredAt - right.occurredAt);
+    for (const event of ordered) {
+        const family = event.goal.goalFamily;
+        const previousFamily = familyByGoal.get(event.goal.id);
+        if (previousFamily !== undefined && (family === undefined ||
+            family.canonicalGoalId !== previousFamily.canonicalGoalId ||
+            family.role !== previousFamily.role)) {
+            return inconsistency(`goal ${event.goal.id} changed or removed its goal-family relation`, event);
+        }
+        if (family !== undefined) {
+            familyByGoal.set(event.goal.id, family);
+            if (family.role === "canonical" && !canonicalActivatedAt.has(event.goal.id)) {
+                canonicalActivatedAt.set(event.goal.id, event.occurredAt);
+            }
+        }
+    }
+    for (const event of ordered) {
+        const family = event.goal.goalFamily;
+        if (family?.role !== "superseded")
+            continue;
+        const canonicalAt = canonicalActivatedAt.get(family.canonicalGoalId);
+        if (canonicalAt === undefined || canonicalAt > event.occurredAt) {
+            return inconsistency(`goal ${event.goal.id} was superseded before canonical goal ${family.canonicalGoalId} was recorded`, event);
+        }
+    }
+};
+//# sourceMappingURL=goal-family.js.map

package/dist/goal-family.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-family.js","sourceRoot":"","sources":["../src/goal-family.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,KAAyB,EAAE,EAAE,CAClE,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,MAAyC,EACR,EAAE;IACnC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAA;IACtD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAA;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;IACpF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAA;QACpC,MAAM,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACtD,IACE,cAAc,KAAK,SAAS,IAAI,CAC9B,MAAM,KAAK,SAAS;YACpB,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,eAAe;YACzD,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,IAAI,CACpC,EACD,CAAC;YACD,OAAO,aAAa,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,EAAE,8CAA8C,EAAE,KAAK,CAAC,CAAA;QAClG,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;YACvC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5E,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAA;QACpC,IAAI,MAAM,EAAE,IAAI,KAAK,YAAY;YAAE,SAAQ;QAC3C,MAAM,WAAW,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QACpE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;YAChE,OAAO,aAAa,CAClB,QAAQ,KAAK,CAAC,IAAI,CAAC,EAAE,yCAAyC,MAAM,CAAC,eAAe,eAAe,EACnG,KAAK,CACN,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/model.d.ts

@@ -31,6 +31,74 @@ export declare const WorkBlocker: Schema.Struct<{
 }>;
 export interface WorkBlocker extends Schema.Schema.Type<typeof WorkBlocker> {
 }
+export declare const WorkAgentHierarchy: Schema.Struct<{
+    readonly agent: Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly name: Schema.String;
+        readonly paneId: Schema.String;
+        readonly relationship: Schema.optionalKey<Schema.Struct<{
+            readonly parentAgentId: Schema.String;
+            readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+        }>>;
+    }>;
+}>;
+export interface WorkAgentHierarchy extends Schema.Schema.Type<typeof WorkAgentHierarchy> {
+}
+export declare const WorkActivityKind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+export type WorkActivityKind = typeof WorkActivityKind.Type;
+export declare const WorkActivity: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+    readonly summary: Schema.String;
+    readonly occurredAt: Schema.Number;
+}>;
+export interface WorkActivity extends Schema.Schema.Type<typeof WorkActivity> {
+}
+export declare const WorkApprovalTarget: Schema.Struct<{
+    readonly host: Schema.String;
+    readonly jobId: Schema.String;
+    readonly url: Schema.String;
+}>;
+export interface WorkApprovalTarget extends Schema.Schema.Type<typeof WorkApprovalTarget> {
+}
+/**
+ * Checks a decoded approval target against the origin resolved by the
+ * configuration-aware approvals boundary before the target is persisted.
+ */
+export declare const approvalTargetMatchesOrigin: (target: WorkApprovalTarget, authoritativeOrigin: string) => boolean;
+export declare const WorkRequestState: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+export type WorkRequestState = typeof WorkRequestState.Type;
+export declare const WorkRequest: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly summary: Schema.String;
+    readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+    readonly requestedAt: Schema.Number;
+    readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly jobId: Schema.String;
+        readonly url: Schema.String;
+    }>>;
+}>;
+export interface WorkRequest extends Schema.Schema.Type<typeof WorkRequest> {
+}
+export declare const WorkReviewState: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+export type WorkReviewState = typeof WorkReviewState.Type;
+/** Review status plus the persisted credential-free destination, when known. */
+export declare const WorkReview: Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+    readonly summary: Schema.NullOr<Schema.String>;
+    readonly updatedAt: Schema.Number;
+    readonly url: Schema.NullOr<Schema.String>;
+}>;
+export interface WorkReview extends Schema.Schema.Type<typeof WorkReview> {
+}
+export declare const WorkGoalFamily: Schema.Struct<{
+    readonly canonicalGoalId: Schema.String;
+    readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+}>;
+export interface WorkGoalFamily extends Schema.Schema.Type<typeof WorkGoalFamily> {
+}
 export declare const WorkGoal: Schema.Struct<{
     readonly id: Schema.String;
     readonly title: Schema.String;
@@ -59,6 +127,54 @@ export declare const WorkGoal: Schema.Struct<{
         readonly agentId: Schema.String;
         readonly url: Schema.String;
     }>>;
+    readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+        readonly canonicalGoalId: Schema.String;
+        readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+    }>>;
+    readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+        readonly agent: Schema.Struct<{
+            readonly host: Schema.String;
+            readonly agentId: Schema.String;
+            readonly name: Schema.String;
+            readonly paneId: Schema.String;
+            readonly relationship: Schema.optionalKey<Schema.Struct<{
+                readonly parentAgentId: Schema.String;
+                readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+            }>>;
+        }>;
+    }>>>;
+    readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+        readonly summary: Schema.String;
+        readonly occurredAt: Schema.Number;
+    }>>>;
+    readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly since: Schema.Number;
+    }>>>;
+    readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly summary: Schema.String;
+        readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+        readonly requestedAt: Schema.Number;
+        readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+            readonly url: Schema.String;
+        }>>;
+    }>>>;
+    readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+        readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+        readonly summary: Schema.NullOr<Schema.String>;
+        readonly updatedAt: Schema.Number;
+        readonly url: Schema.NullOr<Schema.String>;
+    }>>>;
+    readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly jobId: Schema.String;
+        readonly url: Schema.String;
+    }>>>;
     readonly createdAt: Schema.Number;
     readonly updatedAt: Schema.Number;
 }>;
@@ -96,6 +212,54 @@ export declare const WorkGoalCheckpoint: Schema.Struct<{
             readonly agentId: Schema.String;
             readonly url: Schema.String;
         }>>;
+        readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+            readonly canonicalGoalId: Schema.String;
+            readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+        }>>;
+        readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly agent: Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly name: Schema.String;
+                readonly paneId: Schema.String;
+                readonly relationship: Schema.optionalKey<Schema.Struct<{
+                    readonly parentAgentId: Schema.String;
+                    readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                }>>;
+            }>;
+        }>>>;
+        readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+            readonly summary: Schema.String;
+            readonly occurredAt: Schema.Number;
+        }>>>;
+        readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly summary: Schema.String;
+            readonly since: Schema.Number;
+        }>>>;
+        readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly summary: Schema.String;
+            readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+            readonly requestedAt: Schema.Number;
+            readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+        }>>>;
+        readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+            readonly summary: Schema.NullOr<Schema.String>;
+            readonly updatedAt: Schema.Number;
+            readonly url: Schema.NullOr<Schema.String>;
+        }>>>;
+        readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+            readonly url: Schema.String;
+        }>>>;
         readonly createdAt: Schema.Number;
         readonly updatedAt: Schema.Number;
     }>;
@@ -136,6 +300,54 @@ export declare const WorkSnapshot: Schema.Struct<{
             readonly agentId: Schema.String;
             readonly url: Schema.String;
         }>>;
+        readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+            readonly canonicalGoalId: Schema.String;
+            readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+        }>>;
+        readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly agent: Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly name: Schema.String;
+                readonly paneId: Schema.String;
+                readonly relationship: Schema.optionalKey<Schema.Struct<{
+                    readonly parentAgentId: Schema.String;
+                    readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                }>>;
+            }>;
+        }>>>;
+        readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+            readonly summary: Schema.String;
+            readonly occurredAt: Schema.Number;
+        }>>>;
+        readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly summary: Schema.String;
+            readonly since: Schema.Number;
+        }>>>;
+        readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly summary: Schema.String;
+            readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+            readonly requestedAt: Schema.Number;
+            readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+        }>>>;
+        readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+            readonly summary: Schema.NullOr<Schema.String>;
+            readonly updatedAt: Schema.Number;
+            readonly url: Schema.NullOr<Schema.String>;
+        }>>>;
+        readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+            readonly url: Schema.String;
+        }>>>;
         readonly createdAt: Schema.Number;
         readonly updatedAt: Schema.Number;
     }>>;
@@ -176,6 +388,54 @@ export declare const WorkSnapshots: Schema.Struct<{
                 readonly agentId: Schema.String;
                 readonly url: Schema.String;
             }>>;
+            readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+                readonly canonicalGoalId: Schema.String;
+                readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+            }>>;
+            readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly agent: Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly agentId: Schema.String;
+                    readonly name: Schema.String;
+                    readonly paneId: Schema.String;
+                    readonly relationship: Schema.optionalKey<Schema.Struct<{
+                        readonly parentAgentId: Schema.String;
+                        readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                    }>>;
+                }>;
+            }>>>;
+            readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+                readonly summary: Schema.String;
+                readonly occurredAt: Schema.Number;
+            }>>>;
+            readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>>;
+            readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly summary: Schema.String;
+                readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+                readonly requestedAt: Schema.Number;
+                readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly jobId: Schema.String;
+                    readonly url: Schema.String;
+                }>>;
+            }>>>;
+            readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+                readonly summary: Schema.NullOr<Schema.String>;
+                readonly updatedAt: Schema.Number;
+                readonly url: Schema.NullOr<Schema.String>;
+            }>>>;
+            readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>>;
             readonly createdAt: Schema.Number;
             readonly updatedAt: Schema.Number;
         }>>;
@@ -212,6 +472,54 @@ export declare const WorkSnapshots: Schema.Struct<{
                 readonly agentId: Schema.String;
                 readonly url: Schema.String;
             }>>;
+            readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+                readonly canonicalGoalId: Schema.String;
+                readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+            }>>;
+            readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly agent: Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly agentId: Schema.String;
+                    readonly name: Schema.String;
+                    readonly paneId: Schema.String;
+                    readonly relationship: Schema.optionalKey<Schema.Struct<{
+                        readonly parentAgentId: Schema.String;
+                        readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                    }>>;
+                }>;
+            }>>>;
+            readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+                readonly summary: Schema.String;
+                readonly occurredAt: Schema.Number;
+            }>>>;
+            readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>>;
+            readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly summary: Schema.String;
+                readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+                readonly requestedAt: Schema.Number;
+                readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly jobId: Schema.String;
+                    readonly url: Schema.String;
+                }>>;
+            }>>>;
+            readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+                readonly summary: Schema.NullOr<Schema.String>;
+                readonly updatedAt: Schema.Number;
+                readonly url: Schema.NullOr<Schema.String>;
+            }>>>;
+            readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>>;
             readonly createdAt: Schema.Number;
             readonly updatedAt: Schema.Number;
         }>>;
@@ -248,6 +556,54 @@ export declare const WorkSnapshots: Schema.Struct<{
                 readonly agentId: Schema.String;
                 readonly url: Schema.String;
             }>>;
+            readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+                readonly canonicalGoalId: Schema.String;
+                readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+            }>>;
+            readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly agent: Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly agentId: Schema.String;
+                    readonly name: Schema.String;
+                    readonly paneId: Schema.String;
+                    readonly relationship: Schema.optionalKey<Schema.Struct<{
+                        readonly parentAgentId: Schema.String;
+                        readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                    }>>;
+                }>;
+            }>>>;
+            readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+                readonly summary: Schema.String;
+                readonly occurredAt: Schema.Number;
+            }>>>;
+            readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>>;
+            readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly summary: Schema.String;
+                readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+                readonly requestedAt: Schema.Number;
+                readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly jobId: Schema.String;
+                    readonly url: Schema.String;
+                }>>;
+            }>>>;
+            readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+                readonly summary: Schema.NullOr<Schema.String>;
+                readonly updatedAt: Schema.Number;
+                readonly url: Schema.NullOr<Schema.String>;
+            }>>>;
+            readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>>;
             readonly createdAt: Schema.Number;
             readonly updatedAt: Schema.Number;
         }>>;
@@ -284,6 +640,54 @@ export declare const WorkSnapshots: Schema.Struct<{
                 readonly agentId: Schema.String;
                 readonly url: Schema.String;
             }>>;
+            readonly goalFamily: Schema.optionalKey<Schema.Struct<{
+                readonly canonicalGoalId: Schema.String;
+                readonly role: Schema.Literals<readonly ["canonical", "superseded"]>;
+            }>>;
+            readonly agentHierarchy: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly agent: Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly agentId: Schema.String;
+                    readonly name: Schema.String;
+                    readonly paneId: Schema.String;
+                    readonly relationship: Schema.optionalKey<Schema.Struct<{
+                        readonly parentAgentId: Schema.String;
+                        readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+                    }>>;
+                }>;
+            }>>>;
+            readonly activity: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Literals<readonly ["note", "status", "blocker", "request", "review", "shipment"]>;
+                readonly summary: Schema.String;
+                readonly occurredAt: Schema.Number;
+            }>>>;
+            readonly blockers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>>;
+            readonly requests: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly summary: Schema.String;
+                readonly state: Schema.Literals<readonly ["open", "approved", "rejected", "fulfilled"]>;
+                readonly requestedAt: Schema.Number;
+                readonly approvalTarget: Schema.NullOr<Schema.Struct<{
+                    readonly host: Schema.String;
+                    readonly jobId: Schema.String;
+                    readonly url: Schema.String;
+                }>>;
+            }>>>;
+            readonly review: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly state: Schema.Literals<readonly ["not_requested", "requested", "changes_requested", "approved"]>;
+                readonly summary: Schema.NullOr<Schema.String>;
+                readonly updatedAt: Schema.Number;
+                readonly url: Schema.NullOr<Schema.String>;
+            }>>>;
+            readonly approvalTarget: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly jobId: Schema.String;
+                readonly url: Schema.String;
+            }>>>;
             readonly createdAt: Schema.Number;
             readonly updatedAt: Schema.Number;
         }>>;

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAS/B,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAC1C,eAAO,MAAM,oBAAoB,OAAQ,CAAA;AAEzC,eAAO,MAAM,UAAU,eAAa,CAAA;AACpC,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,SAAS,gGAAwF,CAAA;AAC9G,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,aAAa,qFAA6E,CAAA;AACvG,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,SAAS;;;EAAgD,CAAA;AACtE,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E,eAAO,MAAM,cAAc;;;EAGzB,CAAA;AACF,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC;CAAG;AAEpF,eAAO,MAAM,SAAS;;;EAGpB,CAAA;AACF,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E,eAAO,MAAM,WAAW;;;EAGtB,CAAA;AACF,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AAE9E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBpB,CAAA;AACD,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU9B,CAAA;AACD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC;CAAG;AAE5F,eAAO,MAAM,kBAAkB,2DAAmD,CAAA;AAClF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKvB,CAAA;AACF,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC;CAAG;AAEhF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMxB,CAAA;AACF,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,CAAC;CAAG"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}