@markjaquith/agency 2.12.0 → 2.14.0

package/src/workbase/schemas.test.ts

@@ -2,6 +2,7 @@ import { describe, expect, test } from "bun:test"
 import { Schema } from "@effect/schema"
 import {
 	EntityId,
+	ClaimRecord,
 	EpicFrontmatter,
 	PhaseFrontmatter,
 	TaskFrontmatter,
@@ -154,6 +155,32 @@ describe("work status", () => {
 	})
 })
 
+describe("claim records", () => {
+	const record = {
+		claimant: "orchestrator",
+		runner: "agent",
+		sessionId: "job-1",
+		startedAt: "2026-07-17T12:00:00.000Z",
+		targetRevision: "0".repeat(64),
+		expiresAt: "2026-07-17T13:00:00.000Z",
+		state: "active" as const,
+	}
+
+	test("accepts explicit ownership and revision metadata", () => {
+		expect(Schema.decodeUnknownSync(ClaimRecord)(record)).toEqual(record)
+	})
+
+	test("rejects malformed timestamps, revisions, and empty identities", () => {
+		for (const invalid of [
+			{ ...record, claimant: "" },
+			{ ...record, startedAt: "today" },
+			{ ...record, targetRevision: "abc" },
+		]) {
+			expect(() => Schema.decodeUnknownSync(ClaimRecord)(invalid)).toThrow()
+		}
+	})
+})
+
 describe("workbase registry", () => {
 	test("accepts registered paths", () => {
 		expect(

package/src/workbase/schemas.ts

@@ -23,6 +23,25 @@ export const WorkStatus = Schema.Literal(
 	"dropped",
 )
 
+const IsoTimestamp = NonEmptyString.pipe(
+	Schema.pattern(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/),
+)
+
+const DocumentRevision = Schema.String.pipe(Schema.pattern(/^[a-f0-9]{64}$/))
+
+export const ClaimRecord = Schema.Struct({
+	claimant: NonEmptyString,
+	runner: NonEmptyString,
+	sessionId: NonEmptyString,
+	startedAt: IsoTimestamp,
+	targetRevision: DocumentRevision,
+	expiresAt: Schema.optional(IsoTimestamp),
+	state: Schema.Literal("active", "released", "finished"),
+	releasedAt: Schema.optional(IsoTimestamp),
+	finishedAt: Schema.optional(IsoTimestamp),
+	outcome: Schema.optional(Schema.Literal("done", "dropped")),
+})
+
 const Url = NonEmptyString.pipe(Schema.pattern(/^[a-zA-Z][a-zA-Z0-9+.-]*:/))
 
 const GitHubPullRequestUrl = NonEmptyString.pipe(
@@ -51,6 +70,7 @@ const ExecutionUnit = {
 	base: NonEmptyString,
 	pr: Schema.NullOr(GitHubPullRequestUrl),
 	status: Schema.optionalWith(WorkStatus, { default: () => "open" as const }),
+	claim: Schema.optional(ClaimRecord),
 }
 
 export const EpicFrontmatter = Schema.Struct({
@@ -89,6 +109,7 @@ export type WorkbaseRegistry = Schema.Schema.Type<typeof WorkbaseRegistry>
 export type Dependency = Schema.Schema.Type<typeof Dependency>
 export type RepositoryReference = Schema.Schema.Type<typeof RepositoryReference>
 export type WorkStatus = Schema.Schema.Type<typeof WorkStatus>
+export type ClaimRecord = Schema.Schema.Type<typeof ClaimRecord>
 export type EpicFrontmatter = Schema.Schema.Type<typeof EpicFrontmatter>
 export type TaskFrontmatter = Schema.Schema.Type<typeof TaskFrontmatter>
 export type PhaseFrontmatter = Schema.Schema.Type<typeof PhaseFrontmatter>