@knpkv/herdr-work 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 knpkv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @knpkv/herdr-work
+
+Durable fleet work checkpoints and the Rly departure-board projection used by the Herdr control surface.
+
+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`.

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+import { Schema } from "effect";
+declare const WorkProjectionError_base: Schema.Class<WorkProjectionError, Schema.TaggedStruct<"WorkProjectionError", {
+    readonly cause: Schema.Defect;
+    readonly detail: Schema.String;
+    readonly reason: Schema.Literals<readonly ["malformed", "duplicate_event", "ambiguous_checkpoint", "inconsistent_history", "capacity_exceeded"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkProjectionError extends WorkProjectionError_base {
+}
+declare const WorkStoreError_base: Schema.Class<WorkStoreError, Schema.TaggedStruct<"WorkStoreError", {
+    readonly cause: Schema.Defect;
+    readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkStoreError extends WorkStoreError_base {
+}
+declare const WorkCheckpointConflictError_base: Schema.Class<WorkCheckpointConflictError, Schema.TaggedStruct<"WorkCheckpointConflictError", {
+    readonly eventId: Schema.String;
+    readonly goalId: Schema.String;
+    readonly occurredAt: Schema.Number;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkCheckpointConflictError extends WorkCheckpointConflictError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;;;AAE/B,qBAAa,mBAAoB,SAAQ,wBAaxC;CAAG;;;;;AAEJ,qBAAa,cAAe,SAAQ,mBAGnC;CAAG;;;;;;AAEJ,qBAAa,2BAA4B,SAAQ,gCAOhD;CAAG"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+import { Schema } from "effect";
+export class WorkProjectionError extends Schema.TaggedError()("WorkProjectionError", {
+    cause: Schema.Defect(),
+    detail: Schema.String,
+    reason: Schema.Literals([
+        "malformed",
+        "duplicate_event",
+        "ambiguous_checkpoint",
+        "inconsistent_history",
+        "capacity_exceeded"
+    ])
+}) {
+}
+export class WorkStoreError extends Schema.TaggedError()("WorkStoreError", { cause: Schema.Defect(), operation: Schema.String }) {
+}
+export class WorkCheckpointConflictError extends Schema.TaggedError()("WorkCheckpointConflictError", {
+    eventId: Schema.String,
+    goalId: Schema.String,
+    occurredAt: Schema.Number
+}) {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,OAAO,mBAAoB,SAAQ,MAAM,CAAC,WAAW,EAAuB,CAChF,qBAAqB,EACrB;IACE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;QACtB,WAAW;QACX,iBAAiB;QACjB,sBAAsB;QACtB,sBAAsB;QACtB,mBAAmB;KACpB,CAAC;CACH,CACF;CAAG;AAEJ,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,EAAkB,CACtE,gBAAgB,EAChB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CACrD;CAAG;AAEJ,MAAM,OAAO,2BAA4B,SAAQ,MAAM,CAAC,WAAW,EAA+B,CAChG,6BAA6B,EAC7B;IACE,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM;CAC1B,CACF;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./errors.js";
+export * from "./model.js";
+export * from "./projection.js";
+export * from "./service.js";
+export * from "./store.js";
+export * from "./view.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./errors.js";
+export * from "./model.js";
+export * from "./projection.js";
+export * from "./service.js";
+export * from "./store.js";
+export * from "./view.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/dist/model.d.ts

@@ -0,0 +1,294 @@
+import { Schema } from "effect";
+export declare const workHistoryMaxEvents = 16384;
+export declare const workSnapshotMaxGoals = 1024;
+export declare const WorkGoalId: Schema.String;
+export type WorkGoalId = typeof WorkGoalId.Type;
+export declare const WorkState: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+export type WorkState = typeof WorkState.Type;
+export declare const DeliveryStage: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+export type DeliveryStage = typeof DeliveryStage.Type;
+export declare const WorkOwner: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly name: Schema.String;
+}>;
+export interface WorkOwner extends Schema.Schema.Type<typeof WorkOwner> {
+}
+export declare const WorkRepository: Schema.Struct<{
+    readonly repository: Schema.String;
+    readonly branch: Schema.String;
+}>;
+export interface WorkRepository extends Schema.Schema.Type<typeof WorkRepository> {
+}
+export declare const WorkSpend: Schema.Struct<{
+    readonly currency: Schema.String;
+    readonly minorUnits: Schema.Number;
+}>;
+export interface WorkSpend extends Schema.Schema.Type<typeof WorkSpend> {
+}
+export declare const WorkBlocker: Schema.Struct<{
+    readonly summary: Schema.String;
+    readonly since: Schema.Number;
+}>;
+export interface WorkBlocker extends Schema.Schema.Type<typeof WorkBlocker> {
+}
+export declare const WorkGoal: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly title: Schema.String;
+    readonly summary: Schema.String;
+    readonly detail: Schema.String;
+    readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+    readonly owner: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+    }>;
+    readonly repository: Schema.Struct<{
+        readonly repository: Schema.String;
+        readonly branch: Schema.String;
+    }>;
+    readonly spend: Schema.NullOr<Schema.Struct<{
+        readonly currency: Schema.String;
+        readonly minorUnits: Schema.Number;
+    }>>;
+    readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+    readonly blocker: Schema.NullOr<Schema.Struct<{
+        readonly summary: Schema.String;
+        readonly since: Schema.Number;
+    }>>;
+    readonly connectTarget: Schema.NullOr<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly url: Schema.String;
+    }>>;
+    readonly createdAt: Schema.Number;
+    readonly updatedAt: Schema.Number;
+}>;
+export interface WorkGoal extends Schema.Schema.Type<typeof WorkGoal> {
+}
+export declare const WorkGoalCheckpoint: Schema.Struct<{
+    readonly version: Schema.Literal<"herdr.work.event.v1">;
+    readonly eventId: Schema.String;
+    readonly occurredAt: Schema.Number;
+    readonly goal: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly summary: Schema.String;
+        readonly detail: Schema.String;
+        readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+        readonly owner: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly name: Schema.String;
+        }>;
+        readonly repository: Schema.Struct<{
+            readonly repository: Schema.String;
+            readonly branch: Schema.String;
+        }>;
+        readonly spend: Schema.NullOr<Schema.Struct<{
+            readonly currency: Schema.String;
+            readonly minorUnits: Schema.Number;
+        }>>;
+        readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+        readonly blocker: Schema.NullOr<Schema.Struct<{
+            readonly summary: Schema.String;
+            readonly since: Schema.Number;
+        }>>;
+        readonly connectTarget: Schema.NullOr<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly agentId: Schema.String;
+            readonly url: Schema.String;
+        }>>;
+        readonly createdAt: Schema.Number;
+        readonly updatedAt: Schema.Number;
+    }>;
+}>;
+export interface WorkGoalCheckpoint extends Schema.Schema.Type<typeof WorkGoalCheckpoint> {
+}
+export declare const WorkSnapshotWindow: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+export type WorkSnapshotWindow = typeof WorkSnapshotWindow.Type;
+export declare const WorkSnapshot: Schema.Struct<{
+    readonly window: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+    readonly observedAt: Schema.Number;
+    readonly asOf: Schema.Number;
+    readonly goals: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly summary: Schema.String;
+        readonly detail: Schema.String;
+        readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+        readonly owner: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly name: Schema.String;
+        }>;
+        readonly repository: Schema.Struct<{
+            readonly repository: Schema.String;
+            readonly branch: Schema.String;
+        }>;
+        readonly spend: Schema.NullOr<Schema.Struct<{
+            readonly currency: Schema.String;
+            readonly minorUnits: Schema.Number;
+        }>>;
+        readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+        readonly blocker: Schema.NullOr<Schema.Struct<{
+            readonly summary: Schema.String;
+            readonly since: Schema.Number;
+        }>>;
+        readonly connectTarget: Schema.NullOr<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly agentId: Schema.String;
+            readonly url: Schema.String;
+        }>>;
+        readonly createdAt: Schema.Number;
+        readonly updatedAt: Schema.Number;
+    }>>;
+}>;
+export interface WorkSnapshot extends Schema.Schema.Type<typeof WorkSnapshot> {
+}
+export declare const WorkSnapshots: Schema.Struct<{
+    readonly observedAt: Schema.Number;
+    readonly now: Schema.Struct<{
+        readonly window: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+        readonly observedAt: Schema.Number;
+        readonly asOf: Schema.Number;
+        readonly goals: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly detail: Schema.String;
+            readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+            readonly owner: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+            }>;
+            readonly repository: Schema.Struct<{
+                readonly repository: Schema.String;
+                readonly branch: Schema.String;
+            }>;
+            readonly spend: Schema.NullOr<Schema.Struct<{
+                readonly currency: Schema.String;
+                readonly minorUnits: Schema.Number;
+            }>>;
+            readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+            readonly blocker: Schema.NullOr<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>;
+            readonly connectTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+            readonly createdAt: Schema.Number;
+            readonly updatedAt: Schema.Number;
+        }>>;
+    }>;
+    readonly day: Schema.Struct<{
+        readonly window: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+        readonly observedAt: Schema.Number;
+        readonly asOf: Schema.Number;
+        readonly goals: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly detail: Schema.String;
+            readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+            readonly owner: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+            }>;
+            readonly repository: Schema.Struct<{
+                readonly repository: Schema.String;
+                readonly branch: Schema.String;
+            }>;
+            readonly spend: Schema.NullOr<Schema.Struct<{
+                readonly currency: Schema.String;
+                readonly minorUnits: Schema.Number;
+            }>>;
+            readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+            readonly blocker: Schema.NullOr<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>;
+            readonly connectTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+            readonly createdAt: Schema.Number;
+            readonly updatedAt: Schema.Number;
+        }>>;
+    }>;
+    readonly week: Schema.Struct<{
+        readonly window: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+        readonly observedAt: Schema.Number;
+        readonly asOf: Schema.Number;
+        readonly goals: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly detail: Schema.String;
+            readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+            readonly owner: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+            }>;
+            readonly repository: Schema.Struct<{
+                readonly repository: Schema.String;
+                readonly branch: Schema.String;
+            }>;
+            readonly spend: Schema.NullOr<Schema.Struct<{
+                readonly currency: Schema.String;
+                readonly minorUnits: Schema.Number;
+            }>>;
+            readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+            readonly blocker: Schema.NullOr<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>;
+            readonly connectTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+            readonly createdAt: Schema.Number;
+            readonly updatedAt: Schema.Number;
+        }>>;
+    }>;
+    readonly month: Schema.Struct<{
+        readonly window: Schema.Literals<readonly ["now", "day", "week", "month"]>;
+        readonly observedAt: Schema.Number;
+        readonly asOf: Schema.Number;
+        readonly goals: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly detail: Schema.String;
+            readonly state: Schema.Literals<readonly ["planned", "working", "blocked", "review", "deployed", "completed"]>;
+            readonly owner: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+            }>;
+            readonly repository: Schema.Struct<{
+                readonly repository: Schema.String;
+                readonly branch: Schema.String;
+            }>;
+            readonly spend: Schema.NullOr<Schema.Struct<{
+                readonly currency: Schema.String;
+                readonly minorUnits: Schema.Number;
+            }>>;
+            readonly delivery: Schema.Literals<readonly ["local", "review", "pull_request", "merged", "deployed"]>;
+            readonly blocker: Schema.NullOr<Schema.Struct<{
+                readonly summary: Schema.String;
+                readonly since: Schema.Number;
+            }>>;
+            readonly connectTarget: Schema.NullOr<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly agentId: Schema.String;
+                readonly url: Schema.String;
+            }>>;
+            readonly createdAt: Schema.Number;
+            readonly updatedAt: Schema.Number;
+        }>>;
+    }>;
+}>;
+export interface WorkSnapshots extends Schema.Schema.Type<typeof WorkSnapshots> {
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +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"}

package/dist/model.js

@@ -0,0 +1,59 @@
+import { AgentConnectTarget } from "@knpkv/herdr-fleet/model";
+import { Schema } from "effect";
+const Identifier = Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(256));
+const Text = Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(4_096), Schema.isPattern(/^[^\p{Cc}]+$/u));
+const Timestamp = Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 0, maximum: 8_640_000_000_000_000 }));
+export const workHistoryMaxEvents = 16_384;
+export const workSnapshotMaxGoals = 1_024;
+export const WorkGoalId = Identifier;
+export const WorkState = Schema.Literals(["planned", "working", "blocked", "review", "deployed", "completed"]);
+export const DeliveryStage = Schema.Literals(["local", "review", "pull_request", "merged", "deployed"]);
+export const WorkOwner = Schema.Struct({ id: Identifier, name: Text });
+export const WorkRepository = Schema.Struct({
+    repository: Text,
+    branch: Text
+});
+export const WorkSpend = Schema.Struct({
+    currency: Schema.String.check(Schema.isPattern(/^[A-Z]{3}$/)),
+    minorUnits: Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER }))
+});
+export const WorkBlocker = Schema.Struct({
+    summary: Text,
+    since: Timestamp
+});
+export const WorkGoal = Schema.Struct({
+    id: WorkGoalId,
+    title: Text,
+    summary: Text,
+    detail: Text,
+    state: WorkState,
+    owner: WorkOwner,
+    repository: WorkRepository,
+    spend: Schema.NullOr(WorkSpend),
+    delivery: DeliveryStage,
+    blocker: Schema.NullOr(WorkBlocker),
+    connectTarget: Schema.NullOr(AgentConnectTarget),
+    createdAt: Timestamp,
+    updatedAt: Timestamp
+}).check(Schema.makeFilter((goal) => goal.updatedAt >= goal.createdAt && ((goal.state === "blocked") === (goal.blocker !== null)), { expected: "ordered goal timestamps and blocker present exactly for blocked state" }));
+export const WorkGoalCheckpoint = Schema.Struct({
+    version: Schema.Literal("herdr.work.event.v1"),
+    eventId: Identifier,
+    occurredAt: Timestamp,
+    goal: WorkGoal
+}).check(Schema.makeFilter((event) => event.occurredAt === event.goal.updatedAt, { expected: "checkpoint occurrence equal to the durable goal update timestamp" }));
+export const WorkSnapshotWindow = Schema.Literals(["now", "day", "week", "month"]);
+export const WorkSnapshot = Schema.Struct({
+    window: WorkSnapshotWindow,
+    observedAt: Timestamp,
+    asOf: Timestamp,
+    goals: Schema.Array(WorkGoal).check(Schema.isMaxLength(workSnapshotMaxGoals))
+});
+export const WorkSnapshots = Schema.Struct({
+    observedAt: Timestamp,
+    now: WorkSnapshot,
+    day: WorkSnapshot,
+    week: WorkSnapshot,
+    month: WorkSnapshot
+});
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/projection.d.ts

@@ -0,0 +1,151 @@
+import { Effect } from "effect";
+import { WorkProjectionError } from "./errors.js";
+import { WorkGoalCheckpoint } from "./model.js";
+export declare const projectWorkSnapshots: (input: readonly WorkGoalCheckpoint[], observedAt: number) => 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 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 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 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 createdAt: number;
+            readonly updatedAt: number;
+        }[];
+    };
+}, WorkProjectionError, never>;
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAEL,kBAAkB,EAKnB,MAAM,YAAY,CAAA;AAkFnB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAiB/B,CAAA"}