better-supabase 0.13.0 → 0.14.0

package/dist/blocks/work-items/index.d.ts

@@ -1,193 +1,36 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { wt as Events } from "../../events-DhGgwqQA.js";
-import { T as WorkItemEventData } from "../../index-CE0p3st5.js";
-import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { t as SubjectConfig } from "../../subjects-DQ2SU4cA.js";
-//#region src/blocks/work-items/work-items.d.ts
-/** The state a stage's category sets; `completed` and `canceled` are closed. */
-type WorkItemState = "triage" | "backlog" | "unstarted" | "started" | "completed" | "canceled";
-type CloseReason = "completed" | "not_planned" | "duplicate";
-/** A work item. `F` types the extra columns the `fields` schema describes. */
-interface WorkItem<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly organizationId: string;
-  readonly number: bigint;
-  /** `TASK-12`, or the number-sequences format. */
-  readonly identifier: string;
-  readonly title: string;
-  readonly body?: string;
-  readonly parentId?: string;
-  readonly teamId?: string;
-  readonly projectId?: string;
-  readonly iterationId?: string;
-  /** 0 none, 1 urgent, 2 high, 3 medium, 4 low. */
-  readonly priority: number;
-  readonly estimate?: number;
-  /** Its own progress; `tree` rolls children up when it has none. */
-  readonly progress?: number;
-  readonly startAt?: Temporal.Instant;
-  readonly endAt?: Temporal.Instant;
-  readonly dueAt?: Temporal.Instant;
-  readonly pipelineId?: string;
-  readonly stageId?: string;
-  readonly stageEnteredAt?: Temporal.Instant;
-  readonly state: WorkItemState;
-  readonly closeReason?: CloseReason;
-  readonly closedAt?: Temporal.Instant;
-  /** A locked item keeps its dates, as a locked Gantt bar. */
-  readonly locked: boolean;
-  readonly rank: string;
-  readonly assigneeIds: readonly string[];
-  /** The extra columns, keyed by database name. */
-  readonly fields: ExtraFields<F>;
-  readonly archived: boolean;
-  readonly createdAt: Temporal.Instant;
-  readonly updatedAt: Temporal.Instant;
-}
-interface WorkItemInput<F extends object = Record<never, never>> {
-  readonly title: string;
-  readonly body?: string;
-  readonly parentId?: string;
-  readonly teamId?: string;
-  readonly projectId?: string;
-  readonly iterationId?: string;
-  readonly priority?: number;
-  readonly estimate?: number;
-  readonly progress?: number;
-  readonly startAt?: Temporal.Instant;
-  readonly endAt?: Temporal.Instant;
-  readonly dueAt?: Temporal.Instant;
-  readonly pipelineId?: string;
-  readonly stageId?: string;
-  /** The extra columns to set. */
-  readonly fields?: Partial<F>;
-}
-type WorkItemField = "title" | "body" | "parentId" | "teamId" | "projectId" | "iterationId" | "priority" | "estimate" | "progress" | "startAt" | "endAt" | "dueAt" | "stageId" | "closeReason";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { D as WorkItemEventData } from "../../block-events-records-BGVyoz57.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
+import { i as EventSink } from "../../cloud-event-SPyXMdcd.js";
+import { Lt as Section, c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { _ as WorkItems, a as Project, c as WorkItemChangeResult, d as WorkItemListOptions, f as WorkItemNode, g as WorkItemWatcher, h as WorkItemWatchLevel, i as Iteration, l as WorkItemField, m as WorkItemState, n as ChecklistItemInput, o as WorkItem, p as WorkItemRecurrence, r as CloseReason, s as WorkItemChange, t as ChecklistItem, u as WorkItemInput, v as WorkItemsOptions, y as createWorkItems } from "../../work-items-Cnntm8ij.js";
+//#region src/blocks/work-items/recurrence.d.ts
 /**
- * One cell edit or drag: a built-in field or an extra column. `null` clears the
- * field.
+ * The first occurrence of `rule` after `after`, or `undefined` when the rule
+ * has ended (COUNT or UNTIL) or has none in the next five years.
  */
-interface WorkItemChange<F extends object = Record<never, never>> {
-  readonly workItemId: string;
-  readonly field: WorkItemField | (keyof F & string);
-  readonly value: unknown;
-}
-interface WorkItemChangeResult {
-  readonly accepted: readonly {
-    readonly workItemId: string;
-    readonly field: string;
-  }[];
-  readonly rejected: readonly {
-    readonly workItemId: string;
-    readonly field: string;
-    readonly hint?: string;
-    readonly reason: string;
-  }[];
-}
-/** A node of `tree`, for a Gantt chart or a nested list. */
-interface WorkItemNode {
-  readonly id: string;
-  readonly parentId?: string;
-  readonly identifier: string;
-  readonly title: string;
-  readonly state: WorkItemState;
-  readonly startAt?: Temporal.Instant;
-  readonly endAt?: Temporal.Instant;
-  readonly dueAt?: Temporal.Instant;
-  readonly locked: boolean;
-  readonly depth: number;
-  readonly progress: number;
-}
-interface WorkItemListOptions {
-  readonly teamId?: string;
-  readonly projectId?: string;
-  readonly iterationId?: string;
-  readonly parentId?: string;
-  readonly assigneeId?: string;
-  readonly states?: readonly WorkItemState[];
-  /** Only items that aren't completed or canceled. */
-  readonly open?: boolean;
-  /** Matches the title, or the start of the identifier. */
-  readonly search?: string;
-  /** Continues after this item. */
-  readonly after?: string;
-  readonly limit?: number;
-}
-interface Project {
-  readonly id: string;
-  readonly key: string;
-  readonly name: string;
-  readonly ownerId?: string;
-  readonly status: "planned" | "active" | "paused" | "completed" | "canceled";
-  readonly startOn?: Temporal.PlainDate;
-  readonly targetOn?: Temporal.PlainDate;
-  /** The share of its items that are completed, canceled ones left out. */
-  readonly progress?: number;
-}
-interface Iteration {
-  readonly id: string;
-  readonly teamId?: string;
-  readonly name: string;
-  readonly startsOn: Temporal.PlainDate;
-  readonly endsOn: Temporal.PlainDate;
-}
-interface WorkItems<F extends object = Record<never, never>> {
-  create(organizationId: string, input: WorkItemInput<F>, assigneeIds?: readonly string[]): AsyncResult<WorkItem<F>>;
-  /** Extra column changes are validated with the `fields` schema first. */
-  update(changes: readonly WorkItemChange<F>[]): AsyncResult<WorkItemChangeResult>;
-  /** Replaces the assignees; new ones are notified and every one watches. */
-  assign(workItemId: string, userIds: readonly string[]): AsyncResult<number>;
-  archive(workItemId: string, archived?: boolean): AsyncResult<boolean>;
-  remove(workItemId: string): AsyncResult<boolean>;
-  tree(rootId: string): AsyncResult<WorkItemNode[]>;
-  list(organizationId: string, options?: WorkItemListOptions): AsyncResult<WorkItem<F>[]>;
-  saveProject(organizationId: string, project: Partial<Omit<Project, "id" | "progress" | "startOn" | "targetOn">> & {
-    readonly id?: string;
-    readonly startOn?: Temporal.PlainDate | null;
-    readonly targetOn?: Temporal.PlainDate | null;
-    readonly archived?: boolean;
-  }): AsyncResult<Project>;
-  saveIteration(organizationId: string, iteration: Partial<Omit<Iteration, "id">> & {
-    readonly id?: string;
-  }): AsyncResult<Iteration>;
-}
-interface WorkItemsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
-  readonly transport: BlockTransport;
-  readonly schema?: string;
+export declare function nextWorkItemOccurrence(rule: WorkItemRecurrence, after: Temporal.Instant): Temporal.Instant | undefined;
+interface WorkItemRecurrenceSinkOptions {
   /**
-   * A Standard Schema for the item's extra columns
-   * (`blocks.work-items.options.extraColumns`), keyed by database name. It
-   * types and parses them on reads, and validates them on `create` and
-   * `update`.
+   * The closed event's type without `typePrefix`, after
+   * `blocks.work-items.entities` (`task.closed`). Default `work_item.closed`.
    */
-  readonly fields?: S;
-  readonly hooks?: NoInfer<BlockHooks<WorkItems<FieldsOf<S>>>>;
-  readonly logger?: Logger;
-  readonly mappers?: readonly ErrorMapper[];
+  readonly type?: string;
+  /** Stripped from each event type. Defaults to `dev.better-supabase`. */
+  readonly typePrefix?: string;
+  /** The current time, for an item without a due date. */
+  readonly now?: () => Temporal.Instant;
 }
 /**
- * The work-items block: issues and tasks on pipelines, with batched edits for a
- * grid or a Gantt chart, assignees, a progress tree, projects and iterations.
+ * An outbox sink that creates the next item when a repeating one is completed:
+ * `outbox.relay('work-items', workItemRecurrenceSink(workItems))`. Build
+ * `workItems` with a service transport. The next item is due at the rule's
+ * first occurrence after the completed item's due date (or now), and `repeat`
+ * runs once per item, so a redelivered event changes nothing.
  */
-export declare function createWorkItems<S extends StandardSchemaV1 | undefined = undefined>(options: WorkItemsOptions<S>): WorkItems<FieldsOf<S>>;
-/**
- * The `config.subjects` entry for work items, so comments, tags, files,
- * relations (`blocks` for Gantt dependencies), rank and search attach. The
- * board moves an item by its stage id.
- */
-export declare function workItemsSubjects(options?: {
-  readonly schema?: string;
-  readonly url?: string;
-}): {
-  readonly work_item: SubjectConfig;
-};
+export declare function workItemRecurrenceSink(workItems: Pick<WorkItems, "get" | "repeat">, options?: WorkItemRecurrenceSinkOptions): EventSink;
 //#endregion
 //#region src/blocks/work-items/events.d.ts
 /** The events of the `work-items` block: type to data. */
@@ -203,8 +46,42 @@ type WorkItemsEvents = {
 /** The `work-items` block's event types, for its manifest and `onBlockEvent`. */
 export declare const workItemsEvents: Events<WorkItemsEvents>;
 //#endregion
+//#region src/blocks/work-items/section.d.ts
+/** A pending write to a work item's checklist, for `useOptimistic`. */
+type WorkItemChecklistOptimisticAction = {
+  readonly type: "save";
+  readonly item: ChecklistItem;
+} | {
+  readonly type: "remove";
+  readonly id: string;
+};
+/**
+ * The checklist with a pending write applied: `save` adds the item or replaces
+ * the one with the same id, kept in rank order; `remove` takes it out.
+ */
+export declare function workItemChecklistOptimistic(state: readonly ChecklistItem[], action: WorkItemChecklistOptimisticAction): readonly ChecklistItem[];
+/**
+ * A work item's checklist, on the work item's own page: the subject is the work
+ * item (`{ type: "work_item", id }`, or its renamed type). A checklist change
+ * emits `work_item.updated`, which makes the section stale.
+ */
+export declare const workItemChecklistSection: Section<WorkItems, readonly ChecklistItem[], never, WorkItemChecklistOptimisticAction>;
+//#endregion
 //#region src/blocks/work-items/manifest.d.ts
 /** The `work-items` block's manifest (ADR 0029). */
-export declare const workItemsBlock: BlockOf<"work-items", typeof createWorkItems, WorkItemsEvents>;
+export declare const workItemsBlock: BlockOf<"work-items", typeof createWorkItems, WorkItemsEvents, Record<never, never>, "sink", {
+  readonly checklist: typeof workItemChecklistSection;
+}>;
+//#endregion
+//#region src/blocks/work-items/schemas.d.ts
+/** What `create` takes, with the bounds the SQL checks. */
+export declare const workItemInputSchema: EntitySchema<WorkItemInput>;
+/**
+ * One edit `update` takes. `field` is a built-in field or an extra column, so
+ * any name passes; the SQL rejects an unknown one.
+ */
+export declare const workItemChangeSchema: EntitySchema<WorkItemChange>;
+/** The options `list` takes. */
+export declare const workItemListFilterSchema: EntitySchema<WorkItemListOptions>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CloseReason, type Iteration, type Project, type RpcClient, type WorkItem, type WorkItemChange, type WorkItemChangeResult, type WorkItemField, type WorkItemInput, type WorkItemListOptions, type WorkItemNode, type WorkItemState, type WorkItems, type WorkItemsEvents, type WorkItemsOptions, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type ChecklistItem, type ChecklistItemInput, type CloseReason, type Iteration, type Project, type RpcClient, type WorkItem, type WorkItemChange, type WorkItemChangeResult, type WorkItemChecklistOptimisticAction, type WorkItemField, type WorkItemInput, type WorkItemListOptions, type WorkItemNode, type WorkItemRecurrence, type WorkItemRecurrenceSinkOptions, type WorkItemState, type WorkItemWatchLevel, type WorkItemWatcher, type WorkItems, type WorkItemsEvents, type WorkItemsOptions, createWorkItems, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/work-items/index.js

@@ -1,12 +1,16 @@
-import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
-import { a as ok, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
+import { a as ok, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as workItemsSqlOptions } from "../../options-D1blDihM.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { a as stripTypePrefix } from "../../cloud-event-XsM53POL.js";
+import { t as defineSection } from "../../sections-DjxYmpu-.js";
+import { n as workItemInputSchema, r as workItemListFilterSchema, t as workItemChangeSchema } from "../../schemas-ypoQZ_6N.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, S as optionalInstant, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-DwE32_gT.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as blockFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { t as expandRule } from "../../rrule-xDm2znty.js";
 //#region src/blocks/work-items/work-items.ts
 const STATES = [
 	"triage",
@@ -59,6 +63,9 @@ const KNOWN = /* @__PURE__ */ new Set([
 	"locked",
 	"rank",
 	"archived_at",
+	"recurs_from",
+	"checklist",
+	"recurrence",
 	"created_by",
 	"created_at",
 	"updated_at",
@@ -105,12 +112,50 @@ function itemOf(value) {
 		locked: row["locked"] === true,
 		rank: textOf(row["rank"]),
 		assigneeIds: Array.isArray(row["assignees"]) ? row["assignees"].map(String) : [],
+		checklist: checklistSummaryOf(row["checklist"]),
+		recurrence: recurrenceOf(row["recurrence"]),
+		recursFromId: optionalText(row["recurs_from"]),
 		fields: Object.fromEntries(Object.entries(row).filter(([key]) => !KNOWN.has(key))),
 		archived: row["archived_at"] !== null && row["archived_at"] !== void 0,
 		createdAt: requiredInstant(row["created_at"], "createdAt"),
 		updatedAt: requiredInstant(row["updated_at"], "updatedAt")
 	});
 }
+function checklistSummaryOf(value) {
+	const row = isRecord(value) ? value : {};
+	return {
+		total: num(row["total"]) ?? 0,
+		done: num(row["done"]) ?? 0
+	};
+}
+function recurrenceOf(value) {
+	if (!isRecord(value)) return;
+	return {
+		rrule: textOf(value["rrule"]),
+		tzid: textOf(value["tzid"]),
+		dtstart: requiredInstant(value["dtstart"], "dtstart")
+	};
+}
+function checklistItemOf(value) {
+	const row = recordOf(value, "checklist item");
+	return compact({
+		id: textOf(row["id"]),
+		workItemId: textOf(row["workItemId"]),
+		title: textOf(row["title"]),
+		done: row["done"] === true,
+		doneAt: optionalInstant(row["doneAt"]),
+		doneBy: optionalText(row["doneBy"]),
+		rank: textOf(row["rank"]),
+		createdAt: requiredInstant(row["createdAt"], "createdAt")
+	});
+}
+function watcherOf(value) {
+	const row = recordOf(value, "watcher");
+	return {
+		userId: textOf(row["userId"]),
+		level: enumOrThrow(row["level"], ["all", "participating"], "watch level")
+	};
+}
 function nodeOf(value) {
 	const row = recordOf(value, "work item node");
 	return compact({
@@ -172,11 +217,12 @@ function createWorkItems(options) {
 	const fields = blockFields(options.fields, "work item fields");
 	return withBlockHooks({
 		create: (organizationId, input, assigneeIds) => {
-			const { fields: extra, ...attrs } = input;
+			const { fields: extra, attachmentIds, ...attrs } = input;
 			return fields.args(extra).andThen((checked) => call("create_work_item", {
 				tenant: organizationId,
 				attrs: {
 					...args(attrs),
+					...attachmentIds === void 0 ? {} : { attachments: [...attachmentIds] },
 					...checked === void 0 ? {} : { fields: checked }
 				},
 				assignees: assigneeIds === void 0 ? null : [...assigneeIds]
@@ -218,6 +264,28 @@ function createWorkItems(options) {
 		}, (value) => value === true),
 		remove: (workItemId) => call("delete_work_item", { work_item: workItemId }, (value) => value === true),
 		tree: (rootId) => call("work_item_tree", { root: rootId }, (value) => recordsOf(value, "work_item_tree").map(nodeOf)),
+		get: (workItemId) => call("get_work_item", { work_item: workItemId }, (value) => value === null || value === void 0 ? void 0 : itemOf(value)).andThen((item) => item === void 0 ? AsyncResult.ok(void 0) : fields.row(item)),
+		checklist: (workItemId) => call("list_work_item_checklist", { work_item: workItemId }, (value) => recordsOf(value, "list_work_item_checklist").map(checklistItemOf)),
+		saveChecklistItem: (workItemId, input, checklistItemId) => call("save_work_item_checklist_item", {
+			work_item: workItemId,
+			checklist_item: checklistItemId ?? null,
+			attrs: input
+		}, checklistItemOf),
+		removeChecklistItem: (checklistItemId) => call("delete_work_item_checklist_item", { checklist_item: checklistItemId }, (value) => value === true),
+		setRecurrence: (workItemId, rule) => call("set_work_item_recurrence", {
+			work_item: workItemId,
+			rrule: rule?.rrule ?? null,
+			tzid: rule?.tzid ?? "UTC"
+		}, recurrenceOf),
+		repeat: (workItemId, dueAt) => call("repeat_work_item", {
+			work_item: workItemId,
+			due_at: dueAt.toString()
+		}, itemOf).andThen(fields.row),
+		watch: (workItemId, level) => call("watch_work_item", {
+			work_item: workItemId,
+			level
+		}, (value) => value === true),
+		watchers: (workItemId) => call("list_work_item_watchers", { work_item: workItemId }, (value) => recordsOf(value, "list_work_item_watchers").map(watcherOf)),
 		list: (organizationId, list = {}) => {
 			const { search, after, limit, ...filter } = list;
 			return call("list_work_items", {
@@ -249,31 +317,50 @@ function createWorkItems(options) {
 		...options.logger ? { logger: options.logger } : {}
 	});
 }
+//#endregion
+//#region src/blocks/work-items/recurrence.ts
+/** How far ahead `nextWorkItemOccurrence` looks for the next occurrence. */
+const HORIZON_DAYS = 1830;
 /**
-* The `config.subjects` entry for work items, so comments, tags, files,
-* relations (`blocks` for Gantt dependencies), rank and search attach. The
-* board moves an item by its stage id.
+* The first occurrence of `rule` after `after`, or `undefined` when the rule
+* has ended (COUNT or UNTIL) or has none in the next five years.
 */
-function workItemsSubjects(options = {}) {
-	return { work_item: {
-		table: `${options.schema ?? "better_supabase"}.work_items`,
-		idType: "uuid",
-		tenant: "tenant_id",
-		title: "title",
-		deletedAt: "archived_at",
-		permissions: {
-			read: "work_items.read",
-			write: "work_items.write"
+function nextWorkItemOccurrence(rule, after) {
+	const [next] = expandRule({
+		dtstart: rule.dtstart.toZonedDateTimeISO(rule.tzid),
+		rrule: rule.rrule,
+		window: {
+			from: after.add({ milliseconds: 1 }),
+			until: after.add({ hours: 24 * HORIZON_DAYS })
 		},
-		rank: {
-			column: "rank",
-			group: "stage_id"
-		},
-		search: {
-			title: "title",
-			body: ["identifier", "body"]
-		},
-		...options.url === void 0 ? {} : { url: options.url }
+		limit: 1
+	});
+	return next?.toInstant();
+}
+/**
+* An outbox sink that creates the next item when a repeating one is completed:
+* `outbox.relay('work-items', workItemRecurrenceSink(workItems))`. Build
+* `workItems` with a service transport. The next item is due at the rule's
+* first occurrence after the completed item's due date (or now), and `repeat`
+* runs once per item, so a redelivered event changes nothing.
+*/
+function workItemRecurrenceSink(workItems, options = {}) {
+	const type = options.type ?? "work_item.closed";
+	const now = options.now ?? (() => temporal().Now.instant());
+	return { async send(events) {
+		for (const event of events) {
+			if (stripTypePrefix(event.type, options.typePrefix) !== type || !isRecord(event.data) || event.data["state"] !== "completed") continue;
+			const id = optionalText(event.data["subjectId"]);
+			if (id === void 0) continue;
+			const item = await workItems.get(id);
+			if (!item.ok) throw new Error(`workItemRecurrenceSink: reading ${id} failed: ${item.error.message}`);
+			const rule = item.data?.recurrence;
+			if (rule === void 0) continue;
+			const next = nextWorkItemOccurrence(rule, item.data?.dueAt ?? now());
+			if (next === void 0) continue;
+			const repeated = await workItems.repeat(id, next);
+			if (!repeated.ok) throw new Error(`workItemRecurrenceSink: repeating ${id} failed: ${repeated.error.message}`);
+		}
 	} };
 }
 //#endregion
@@ -289,6 +376,34 @@ const workItemsEvents = defineEvents({
 	"work_item.deleted": event()
 });
 //#endregion
+//#region src/blocks/work-items/section.ts
+const byRank = (left, right) => left.rank < right.rank ? -1 : left.rank > right.rank ? 1 : 0;
+/**
+* The checklist with a pending write applied: `save` adds the item or replaces
+* the one with the same id, kept in rank order; `remove` takes it out.
+*/
+function workItemChecklistOptimistic(state, action) {
+	switch (action.type) {
+		case "save": return [...state.filter((item) => item.id !== action.item.id), action.item].toSorted(byRank);
+		case "remove": return state.filter((item) => item.id !== action.id);
+		default: return action;
+	}
+}
+/**
+* A work item's checklist, on the work item's own page: the subject is the work
+* item (`{ type: "work_item", id }`, or its renamed type). A checklist change
+* emits `work_item.updated`, which makes the section stale.
+*/
+const workItemChecklistSection = defineSection({
+	permissions: {
+		read: "read",
+		write: "write"
+	},
+	load: (client, subject) => client.checklist(subject.id),
+	events: ["work_item.updated"],
+	optimistic: workItemChecklistOptimistic
+});
+//#endregion
 //#region src/blocks/work-items/manifest.ts
 /** The `work-items` block's manifest (ADR 0029). */
 const workItemsBlock = defineBlock({
@@ -296,9 +411,21 @@ const workItemsBlock = defineBlock({
 	sql: ["work-items"],
 	options: { "work-items": workItemsSqlOptions },
 	events: workItemsEvents,
+	provides: { sink: (client) => workItemRecurrenceSink(client) },
 	create: createWorkItems,
+	sections: { checklist: workItemChecklistSection },
 	category: "work",
-	recipes: ["work-item-board", "work-item-grid"]
+	recipes: [
+		"work-item-board",
+		"work-item-grid",
+		"entity-form",
+		"my-work"
+	],
+	schemas: { work_item: {
+		input: workItemInputSchema,
+		change: workItemChangeSchema,
+		listFilter: workItemListFilterSchema
+	} }
 });
 //#endregion
-export { createWorkItems, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, workItemsBlock, workItemsEvents, workItemsSubjects, wrapTransport };
+export { createWorkItems, dbTransport, extendBlock, nextWorkItemOccurrence, rpcTransport, sqlTransport, withBlockHooks, workItemChangeSchema, workItemChecklistOptimistic, workItemChecklistSection, workItemInputSchema, workItemListFilterSchema, workItemRecurrenceSink, workItemsBlock, workItemsEvents, wrapTransport };

package/dist/blocks/workflow-builder/index.d.ts

@@ -1,11 +1,11 @@
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { gt as WorkflowEventData, wt as Events } from "../../events-DhGgwqQA.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { $ as triggerMatches, A as WorkflowTriggerKind, B as WorkflowGraph, C as WorkflowGrantAction, D as WorkflowSinkEvent, E as WorkflowNodeRunStatus, F as TriggerEvent, G as WorkflowNodeKind, H as WorkflowGraphEdge, I as WorkflowCondition, J as durationMs, K as approved, L as WorkflowConditionOperator, M as WorkflowVersionOwner, N as WorkflowVersionStatus, O as WorkflowStepInfo, P as GraphScope, Q as topologicalOrder, R as WorkflowFilterCondition, S as WorkflowDefinitionScope, T as WorkflowNodeRun, U as WorkflowGraphNode, V as WorkflowGraphDiff, W as WorkflowNodeCondition, X as filterConditionOf, Y as evaluateCondition, Z as matchesFilter, _ as WorkflowBuilder, a as CredentialInput, b as WorkflowDefinition, c as GraphCompiler, d as PublishOptions, et as validateGraph, f as RunInput, g as WorkflowAlert, h as VersionSaveOptions, i as BuilderStarter, j as WorkflowVersion, k as WorkflowTrigger, l as NodeRunRecord, m as TriggerInput, n as BuilderOptions, o as DefinitionInput, p as TestRunInput, q as diffGraphs, r as BuilderStartCall, s as GrantInput, t as AlertInput, u as OutboxLikeEvent, v as WorkflowBuilderHooks, w as WorkflowGrantPrincipal, x as WorkflowDefinitionGrant, y as WorkflowCredential, z as WorkflowFilterField } from "../../types-vVsLvOUJ.js";
-import { a as GraphSubject, c as graphRunFields, i as GraphStepCall, l as startNodeOf, n as GraphRunFields, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-Cy1nk4MZ.js";
-import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, l as createWorkflowBuilderController, n as WorkflowBuilderController, o as WorkflowCanvasRunController, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions, u as createWorkflowCanvasRunController } from "../../client-Dsuy9wfA.js";
+import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
+import { r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
+import { Ct as Events, gt as WorkflowEventData } from "../../events-DbLjvxDX.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { $ as triggerMatches, A as WorkflowTriggerKind, B as WorkflowGraph, C as WorkflowGrantAction, D as WorkflowSinkEvent, E as WorkflowNodeRunStatus, F as TriggerEvent, G as WorkflowNodeKind, H as WorkflowGraphEdge, I as WorkflowCondition, J as durationMs, K as approved, L as WorkflowConditionOperator, M as WorkflowVersionOwner, N as WorkflowVersionStatus, O as WorkflowStepInfo, P as GraphScope, Q as topologicalOrder, R as WorkflowFilterCondition, S as WorkflowDefinitionScope, T as WorkflowNodeRun, U as WorkflowGraphNode, V as WorkflowGraphDiff, W as WorkflowNodeCondition, X as filterConditionOf, Y as evaluateCondition, Z as matchesFilter, _ as WorkflowBuilder, a as CredentialInput, b as WorkflowDefinition, c as GraphCompiler, d as PublishOptions, et as validateGraph, f as RunInput, g as WorkflowAlert, h as VersionSaveOptions, i as BuilderStarter, j as WorkflowVersion, k as WorkflowTrigger, l as NodeRunRecord, m as TriggerInput, n as BuilderOptions, o as DefinitionInput, p as TestRunInput, q as diffGraphs, r as BuilderStartCall, s as GrantInput, t as AlertInput, u as OutboxLikeEvent, v as WorkflowBuilderHooks, w as WorkflowGrantPrincipal, x as WorkflowDefinitionGrant, y as WorkflowCredential, z as WorkflowFilterField } from "../../types-uHD9yANu.js";
+import { a as GraphSubject, c as graphRunFields, i as GraphStepCall, l as startNodeOf, n as GraphRunFields, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-DQoczQZJ.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, l as createWorkflowBuilderController, n as WorkflowBuilderController, o as WorkflowCanvasRunController, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions, u as createWorkflowCanvasRunController } from "../../client-BSnf6fn6.js";
 //#region src/blocks/workflow-builder/workflow-builder.d.ts
 /**
  * The `workflow-builder` module's definitions, versions, triggers, credentials,

package/dist/blocks/workflow-builder/index.js

@@ -1,9 +1,9 @@
 import { t as workflowBuilderSqlOptions } from "../../options-DsUgamiy.js";
+import { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CiKtrb6g.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
 import { a as evaluateCondition, d as triggerMatches, i as durationMs, l as matchesFilter, o as filterConditionOf, p as validateGraph, r as diffGraphs, t as approved, u as topologicalOrder } from "../../graph-B4eubUQG.js";
-import { t as createWorkflowBuilder } from "../../workflow-builder-DzZNlI45.js";
+import { t as createWorkflowBuilder } from "../../workflow-builder-2q1iqHYG.js";
 import { i as startNodeOf, n as executeGraph, r as graphRunFields, t as approvalToken } from "../../executor-QtVn0axs.js";
 import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../client-DD3EcytK.js";
 //#region src/blocks/workflow-builder/events.ts

package/dist/blocks/workflow-builder/react/index.d.ts

@@ -1,5 +1,5 @@
-import { _ as WorkflowBuilder } from "../../../types-vVsLvOUJ.js";
-import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, t as WorkflowBuilderActions } from "../../../client-Dsuy9wfA.js";
+import { _ as WorkflowBuilder } from "../../../types-uHD9yANu.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, t as WorkflowBuilderActions } from "../../../client-BSnf6fn6.js";
 //#region src/blocks/workflow-builder/react/index.d.ts
 export interface UseWorkflowBuilderOptions {
   /** The tenant whose definitions to list. */

package/dist/blocks/workflow-builder/react/index.js

@@ -1,9 +1,9 @@
 "use client";
-import { r as rpcTransport } from "../../../block-transport-Ds0C2mUf.js";
+import { H as rpcTransport } from "../../../block-helpers-CiKtrb6g.js";
 import { t as useController } from "../../../react-controller-CKSdtJ10.js";
-import { t as useBlockEnv } from "../../../react-env-CodKZgPk.js";
-import { t as createWorkflows } from "../../../workflows-otOMN33L.js";
-import { t as createWorkflowBuilder } from "../../../workflow-builder-DzZNlI45.js";
+import { t as useBlockEnv } from "../../../react-env-CfA3EdBH.js";
+import { t as createWorkflows } from "../../../workflows-VJBSV-QR.js";
+import { t as createWorkflowBuilder } from "../../../workflow-builder-2q1iqHYG.js";
 import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-DD3EcytK.js";
 import { useMemo } from "react";
 //#region src/blocks/workflow-builder/react/index.ts

package/dist/blocks/workflow-builder/solid/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as SolidController } from "../../../solid-controller-BnF3ovwV.js";
-import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-Dsuy9wfA.js";
+import { t as SolidController } from "../../../solid-bind-C1jeq4Qm.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-BSnf6fn6.js";
 //#region src/blocks/workflow-builder/solid/index.d.ts
 /**
  * `createWorkflowBuilderController` as a Solid primitive: `state()` reads the

package/dist/blocks/workflow-builder/solid/index.js

@@ -1,4 +1,4 @@
-import { t as useBlockController } from "../../../solid-controller-7TxGaJNy.js";
+import { t as useBlockController } from "../../../solid-controller-DGuv7V8a.js";
 import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-DD3EcytK.js";
 //#region src/blocks/workflow-builder/solid/index.ts
 /**

package/dist/blocks/workflow-builder/svelte/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as SvelteController } from "../../../svelte-controller-DXO7gsmS.js";
-import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-Dsuy9wfA.js";
+import { t as SvelteController } from "../../../svelte-bind-Ja6CtQGp.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-BSnf6fn6.js";
 //#region src/blocks/workflow-builder/svelte/index.d.ts
 /**
  * `createWorkflowBuilderController` as a Svelte readable store of the snapshot,

package/dist/blocks/workflow-builder/svelte/index.js

@@ -1,4 +1,4 @@
-import { t as useBlockController } from "../../../svelte-controller-BmRhHvFz.js";
+import { t as useBlockController } from "../../../svelte-controller-oFKC9AYu.js";
 import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../../client-DD3EcytK.js";
 //#region src/blocks/workflow-builder/svelte/index.ts
 /**

package/dist/blocks/workflow-builder/vue/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as VueController } from "../../../vue-controller-DCOtUOA_.js";
-import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-Dsuy9wfA.js";
+import { t as VueController } from "../../../vue-bind-TPkbLl4z.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions } from "../../../client-BSnf6fn6.js";
 //#region src/blocks/workflow-builder/vue/index.d.ts
 /**
  * `createWorkflowBuilderController` as a Vue composable: `state` is a shallow