@shivaedev/work-board 0.7.2 → 0.9.0

package/dist/rpc/server.js.map

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

package/dist/serve-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runServe(): void;
+//# sourceMappingURL=serve-cli.d.ts.map

package/dist/serve-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-cli.d.ts","sourceRoot":"","sources":["../src/serve-cli.ts"],"names":[],"mappings":";AAkCA,wBAAgB,QAAQ,SAEvB"}

package/dist/serve-cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { NodeRuntime, NodeServices } from "@effect/platform-node";
+import { Effect, Layer, Option, Path } from "effect";
+import { Argument, Command, Flag } from "effect/unstable/cli";
+import { HOST, serveBoard } from "./serve.js";
+const VERSION = "0.9.0";
+const serve = Effect.fn("WorkBoard.serve")(function* (input) {
+    const path = yield* Path.Path;
+    return yield* Layer.launch(serveBoard({ home: Option.getOrUndefined(input.home), port: input.port, responses: input.responses, root: path.resolve(input.dir) }));
+});
+const workBoard = Command.make("work-board", {
+    dir: Argument.directory("dir", { mustExist: true }).pipe(Argument.withDescription("The folder of markdown files to serve")),
+    home: Flag.string("home").pipe(Flag.optional, Flag.withDescription("The file shown as a board at /, relative to the folder")),
+    port: Flag.integer("port").pipe(Flag.withDefault(4747), Flag.withDescription(`The port to listen on at ${HOST}`)),
+    responses: Flag.boolean("responses").pipe(Flag.withDefault(false), Flag.withDescription("Explicitly enable local durable question and response writes (Linux)")),
+}, serve).pipe(Command.withDescription("Serve a folder of markdown files as a live page that updates in place when a file changes."));
+export function runServe() {
+    Command.run(workBoard, { version: VERSION }).pipe(Effect.provide(NodeServices.layer), NodeRuntime.runMain);
+}
+//# sourceMappingURL=serve-cli.js.map

package/dist/serve-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-cli.js","sourceRoot":"","sources":["../src/serve-cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,EAAE,KAKrD;IACA,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CACzB,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CACpI,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC7B,YAAY,EACZ;IACC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,uCAAuC,CAAC,CAAC;IAC3H,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,wDAAwD,CAAC,CAAC;IAC7H,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IACjH,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CACxC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EACvB,IAAI,CAAC,eAAe,CAAC,sEAAsE,CAAC,CAC5F;CACD,EACD,KAAK,CACL,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,4FAA4F,CAAC,CAAC,CAAC;AAE9H,MAAM,UAAU,QAAQ;IACvB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5G,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/work-board",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "Serve a folder of markdown files as a live local page that updates in place when a file changes",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/work-board#readme",
   "bugs": {
@@ -63,7 +63,7 @@
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",
     "@effect/platform-node-shared": "4.0.0-rc.112",
-    "@shivaedev/quality": "0.16.0",
+    "@shivaedev/quality": "0.17.0",
     "@types/hast": "3.0.5",
     "@types/mdast": "4.0.4",
     "@types/node": "24.10.1",
@@ -90,7 +90,7 @@
   },
   "scripts": {
     "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc6 --project tsconfig.build.json && pnpm build:browser",
-    "build:browser": "esbuild src/browser/session.ts --bundle --platform=browser --format=esm --conditions=source --minify --outfile=assets/native.js",
+    "build:browser": "esbuild src/browser/entry.ts --bundle --platform=browser --format=esm --conditions=source --minify --outfile=assets/native.js && esbuild src/responses/agent-cli.ts --bundle --platform=node --format=esm --conditions=source --minify --outfile=assets/agent.js",
     "ready": "pnpm typecheck && pnpm test && pnpm build",
     "test": "pnpm test:prepare && vitest run",
     "test:prepare": "pnpm build:browser",

package/src/board.ts

@@ -17,11 +17,14 @@ import { start } from "#http/start.ts";
 import { work } from "#http/work.ts";
 import type { RenderFailed } from "#render/failed.ts";
 import { Highlighter } from "#render/highlighter.ts";
+import { responsePage } from "#responses/page.ts";
+import { responseService } from "#responses/service.ts";
 import { server } from "#rpc/server.ts";
 import { searchSnapshot } from "#search/snapshot.ts";
 
 export interface BoardOptions {
 	readonly home?: string | undefined;
+	readonly responses?: boolean;
 	readonly root: string;
 }
 
@@ -59,6 +62,14 @@ const routes = (options: BoardOptions) =>
 			}
 			yield* serve(MERMAID_ROUTE, mermaidFile(mermaid));
 			yield* serve(NATIVE_ROUTE, nativeAsset);
+			const responses = yield* responseService({
+				changes,
+				enabled: options.responses === true,
+				index: Effect.provideContext(index, context),
+				root: options.root,
+			});
+			const replyPage = responsePage(responses, changes, home, options.responses === true);
+			yield* serve("/_board/respond", replyPage);
 			const pages = page({ home, root: options.root }, changes, index);
 			const items = identity(index, pages, changes, home);
 			yield* serve("/_board/item/*", items);
@@ -67,6 +78,9 @@ const routes = (options: BoardOptions) =>
 				const pathname = new URL(url, "http://127.0.0.1").pathname;
 				let selected: ReturnType<typeof pages>;
 				switch (pathname) {
+					case "/_board/respond":
+						selected = replyPage(request);
+						break;
 					case "/_board/start":
 						selected = startPage();
 						break;
@@ -84,11 +98,11 @@ const routes = (options: BoardOptions) =>
 				}
 				return Effect.provideContext(selected, context);
 			}
-			const rpc = yield* server({ changes, home, index: Effect.provideContext(index, context), page: readPage });
+			const rpc = yield* server({ changes, home, index: Effect.provideContext(index, context), page: readPage, responses });
 			yield* serve(
 				"/_board/rpc",
 				(request) =>
-					sameOrigin(request)
+					sameOrigin(request) && (options.responses !== true || request.headers["content-type"]?.split(";")[0] === "application/ndjson")
 						? rpc.pipe(Effect.provideService(HttpServerRequest.HttpServerRequest, request))
 						: Effect.succeed(respond("Local same-origin requests only", "text/plain", 403)),
 				"POST",

package/src/browser/client.ts

@@ -4,18 +4,34 @@ import type * as AsyncResult from "effect/unstable/reactivity/AsyncResult";
 import type * as Atom from "effect/unstable/reactivity/Atom";
 import * as AtomRegistry from "effect/unstable/reactivity/AtomRegistry";
 import * as AtomRpc from "effect/unstable/reactivity/AtomRpc";
+import type * as Reactivity from "effect/unstable/reactivity/Reactivity";
 import { RpcClient, RpcSerialization } from "effect/unstable/rpc";
-import { bind } from "@shivaedev/effect-contract/bind.ts";
+import type { RpcClientError } from "effect/unstable/rpc/RpcClientError";
+import { type Bound, bind } from "@shivaedev/effect-contract/bind.ts";
+import type { Contract } from "@shivaedev/effect-contract/contract.ts";
 import { live } from "@shivaedev/effect-contract/live.ts";
 import { type ResumeOptions, resumeSignal } from "@shivaedev/effect-contract/resume.ts";
-import { workContract, workRpcs } from "#rpc/contract.ts";
+import { type ReadFailed, workContract, workRpcs } from "#rpc/contract.ts";
 import { workspace } from "#rpc/keys.ts";
+import { responseContract } from "#rpc/responseContract.ts";
 
 export interface Reader {
 	readonly reader: unique symbol;
 }
 
-export function browserClient(url: string, options: ResumeOptions = {}) {
+type BoundContract<TContract> =
+	TContract extends Contract<infer TName, infer TQueries, infer TCommands, infer TRpcs> ? Bound<TName, TQueries, TCommands, TRpcs, Reader> : never;
+export interface BrowserClient {
+	readonly api: BoundContract<typeof workContract>;
+	readonly mutate: <A, E>(effect: Effect.Effect<A, E, Reader | Reactivity.Reactivity>, signal?: AbortSignal) => Promise<A>;
+	readonly read: <A, E>(atom: Atom.Atom<AsyncResult.AsyncResult<A, E>>, signal?: AbortSignal) => Promise<A>;
+	readonly registry: AtomRegistry.AtomRegistry;
+	readonly responses: BoundContract<typeof responseContract>;
+	readonly run: <A, E>(effect: Effect.Effect<A, E, Reader>, signal?: AbortSignal) => Promise<A>;
+	readonly updates: ReturnType<typeof live<Reader, ReadFailed | RpcClientError, never>>;
+}
+
+export function browserClient(url: string, options: ResumeOptions = {}): BrowserClient {
 	class Client extends AtomRpc.Service<Reader>()("WorkBoard/Reader", {
 		group: workRpcs,
 		protocol: RpcClient.layerProtocolHttp({ url: `${url}/_board/rpc` }).pipe(Layer.provide([FetchHttpClient.layer, RpcSerialization.layerNdjson])),
@@ -55,5 +71,15 @@ export function browserClient(url: string, options: ResumeOptions = {}) {
 			throw error;
 		}
 	}
-	return { api, read, registry, run, updates };
+	async function mutate<A, E>(effect: Effect.Effect<A, E, Reader | Reactivity.Reactivity>, signal?: AbortSignal) {
+		const result = await Effect.runPromise(Effect.result(AtomRegistry.getResult(registry, Client.runtime.atom(effect), { suspendOnWaiting: true })), {
+			signal,
+		});
+		if (result._tag === "Failure") {
+			throw result.failure;
+		}
+		return result.success;
+	}
+	const responses = bind(responseContract, Client);
+	return { api, mutate, read, registry, responses, run, updates };
 }

package/src/browser/entry.ts

@@ -0,0 +1,9 @@
+import { setupResponses } from "#browser/responses/setup.ts";
+
+if (typeof window !== "undefined" && typeof document !== "undefined") {
+	setupResponses();
+}
+
+import { session as ownedSession } from "./session.ts";
+
+export const session = ownedSession;

package/src/browser/responses/Prompt.ts

@@ -0,0 +1,6 @@
+export interface Prompt {
+	readonly id: string;
+	readonly mode: "one" | "many" | "text";
+	readonly options: readonly { readonly id: string; readonly source: string }[];
+	readonly source: string;
+}

package/src/browser/responses/answerBody.ts

@@ -0,0 +1,11 @@
+import type { Prompt } from "./Prompt.ts";
+import type { PromptAnswer } from "./schema.ts";
+
+export function answerBody(prompts: readonly Prompt[], answers: readonly PromptAnswer[], note: string) {
+	const sections = prompts.map((prompt, index) => {
+		const answer = answers[index];
+		const chosen = prompt.options.filter((option) => answer?.selected.includes(option.id));
+		return `## Question: ${prompt.id}\n\n${prompt.source}\n\nSelected: ${chosen.map((option) => option.id).join(", ") || "No supplied option"}\n\n${chosen.map((option) => option.source).join("\n\n")}\n\n${answer?.text.trim() ? `Additional text:\n\n${answer.text}` : ""}`;
+	});
+	return `# Recorded response\n\n${sections.join("\n\n")}\n\n${note.trim() ? `## Overall response\n\n${note}` : ""}`.trim();
+}

package/src/browser/responses/draftSession.ts

@@ -0,0 +1,101 @@
+import { Clock, Effect } from "effect";
+import { DRAFT_AGE, type Draft, encodeDrafts, readDrafts } from "./drafts.ts";
+
+const states = new Map<string, Draft>();
+export function draftSession(key: string, revision: string, storage: Storage | undefined, storageKey: string, report: (message: string) => void) {
+	const stateKey = `${JSON.stringify(storageKey)}:${key}`;
+	function local() {
+		if (!storage) {
+			throw new Error("Draft storage unavailable");
+		}
+		return storage;
+	}
+	let blocked = false;
+	let drafts: Record<string, Draft> = {};
+	try {
+		const stored = readDrafts(local().getItem(storageKey), Effect.runSync(Clock.currentTimeMillis));
+		drafts = stored.drafts;
+		if (stored.expired) {
+			report("Expired drafts were cleared after 30 days. Saved responses are unaffected.");
+		}
+		local().setItem(storageKey, encodeDrafts(drafts));
+	} catch {
+		blocked = true;
+		report("Draft history is unavailable or malformed. Keep a copy; edits remain in this window.");
+	}
+	const memory = states.get(stateKey);
+	if (memory && Effect.runSync(Clock.currentTimeMillis) - memory.updatedAt >= DRAFT_AGE) {
+		states.delete(stateKey);
+		report("A window draft expired after 30 days. Saved responses are unaffected.");
+	}
+	let current = states.get(stateKey)
+		?? drafts[key] ?? {
+			author: "",
+			body: "",
+			id: `response.${crypto.randomUUID()}`,
+			revision,
+			type: "answer",
+			updatedAt: Effect.runSync(Clock.currentTimeMillis),
+		};
+	if (current.revision !== revision) {
+		report("Source changed since this draft. Your text is retained; review the new source and preview to bind it to this revision.");
+	}
+	function update(patch: Partial<Draft>) {
+		current = { ...(states.get(stateKey) ?? current), ...patch, updatedAt: Effect.runSync(Clock.currentTimeMillis) };
+		states.set(stateKey, current);
+		try {
+			if (blocked) {
+				throw new Error("Unknown draft history");
+			}
+			const latest = readDrafts(local().getItem(storageKey), Effect.runSync(Clock.currentTimeMillis)).drafts;
+			local().setItem(storageKey, encodeDrafts({ ...latest, [key]: current }));
+		} catch {
+			report("Draft could not be persisted (storage full or unavailable). Keep a copy; your text remains in this window.");
+		}
+		return current;
+	}
+	function clear() {
+		try {
+			local().removeItem(storageKey);
+			blocked = false;
+			for (const storedKey of states.keys()) {
+				if (storedKey.startsWith(`${JSON.stringify(storageKey)}:`)) {
+					states.delete(storedKey);
+				}
+			}
+			report("Workspace drafts cleared. Saved responses are unchanged; this visible text remains until you navigate away.");
+		} catch {
+			report("Draft storage could not be cleared.");
+		}
+	}
+	function saved(pending: Draft) {
+		if (states.get(stateKey) !== pending) {
+			const live = states.get(stateKey);
+			if (live?.id === pending.id) {
+				update({ id: `response.${crypto.randomUUID()}` });
+			}
+			return false;
+		}
+		states.delete(stateKey);
+		try {
+			const latest = readDrafts(local().getItem(storageKey), Effect.runSync(Clock.currentTimeMillis)).drafts;
+			if (latest[key]?.id === pending.id) {
+				delete latest[key];
+			}
+			local().setItem(storageKey, encodeDrafts(latest));
+		} catch {
+			report("Saved response confirmed, but its browser draft could not be cleared.");
+		}
+		current = {
+			...current,
+			answers: undefined,
+			body: "",
+			id: `response.${crypto.randomUUID()}`,
+			recovery: undefined,
+			supersedes: undefined,
+			updatedAt: Effect.runSync(Clock.currentTimeMillis),
+		};
+		return true;
+	}
+	return { clear, current: () => current, saved, update };
+}

package/src/browser/responses/drafts.ts

@@ -0,0 +1,82 @@
+import { Schema } from "effect";
+import { Identity } from "#path/Identity.ts";
+import { Answers, type PromptAnswer } from "./schema.ts";
+
+export const DRAFT_BYTES = 2 * 1024 * 1024;
+export const DRAFT_AGE = 30 * 24 * 60 * 60 * 1000;
+export interface Draft {
+	readonly answers?: readonly PromptAnswer[] | undefined;
+	readonly author: string;
+	readonly body: string;
+	readonly id: string;
+	readonly question?: string | undefined;
+	readonly recovery?: string | undefined;
+	readonly revision: string;
+	readonly supersedes?: string | undefined;
+	readonly type: string;
+	readonly updatedAt: number;
+}
+function extraFields(entry: object) {
+	return {
+		...("question" in entry ? { question: Schema.decodeUnknownSync(Identity)(entry.question) } : {}),
+		...("recovery" in entry ? { recovery: Schema.decodeUnknownSync(Schema.String)(entry.recovery) } : {}),
+		...("answers" in entry ? { answers: Schema.decodeUnknownSync(Answers, { onExcessProperty: "error" })(entry.answers) } : {}),
+		...("supersedes" in entry ? { supersedes: Schema.decodeUnknownSync(Identity)(entry.supersedes) } : {}),
+	};
+}
+export function readDrafts(raw: string | null, now: number): { drafts: Record<string, Draft>; expired: boolean } {
+	if (raw === null) {
+		return { drafts: {}, expired: false };
+	}
+	if (new TextEncoder().encode(raw).length > DRAFT_BYTES) {
+		throw new Error("Draft storage exceeds the workspace limit.");
+	}
+	const value: unknown = JSON.parse(raw);
+	if (typeof value !== "object" || value === null || Array.isArray(value)) {
+		throw new Error("Draft storage is malformed.");
+	}
+	const drafts: Record<string, Draft> = {};
+	let expired = false;
+	for (const [key, entry] of Object.entries(value)) {
+		if (
+			typeof entry !== "object"
+			|| entry === null
+			|| !("author" in entry)
+			|| !("body" in entry)
+			|| !("id" in entry)
+			|| !("revision" in entry)
+			|| !("type" in entry)
+			|| !("updatedAt" in entry)
+			|| typeof entry.author !== "string"
+			|| typeof entry.body !== "string"
+			|| typeof entry.id !== "string"
+			|| typeof entry.revision !== "string"
+			|| (entry.type !== "answer" && entry.type !== "clarify" && entry.type !== "not_now")
+			|| typeof entry.updatedAt !== "number"
+			|| !Number.isFinite(entry.updatedAt)
+		) {
+			throw new Error("Draft storage is malformed.");
+		}
+		if (entry.updatedAt > now || now - entry.updatedAt >= DRAFT_AGE) {
+			expired = true;
+			continue;
+		}
+		drafts[key] = {
+			...extraFields(entry),
+			author: entry.author,
+			body: entry.body,
+			id: entry.id,
+			revision: entry.revision,
+			type: entry.type,
+			updatedAt: entry.updatedAt,
+		};
+	}
+	return { drafts, expired };
+}
+export function encodeDrafts(drafts: Readonly<Record<string, Draft>>): string {
+	const value = JSON.stringify(drafts);
+	if (new TextEncoder().encode(value).length > DRAFT_BYTES) {
+		throw new Error("Draft storage is full. Copy this draft before clearing workspace drafts.");
+	}
+	return value;
+}

package/src/browser/responses/preview.ts

@@ -0,0 +1,7 @@
+import { answerBody } from "./answerBody.ts";
+import type { Draft } from "./drafts.ts";
+import type { Prompt } from "./Prompt.ts";
+
+export function responsePreview(draft: Draft, question: string, prompts: readonly Prompt[] = []): string {
+	return `New file: responses/${draft.id}.md\nRegistration (if needed): responses/${question}.md\nRecorded time is assigned by the server when saving.\n\n---\n${JSON.stringify({ id: draft.id, kind: "response", response: { answers: draft.answers, author: draft.author, question, reviewedRevision: draft.revision, supersedes: draft.supersedes, type: draft.type } }, null, 2)}\n---\n${draft.answers ? answerBody(prompts, draft.answers, draft.body) : draft.body}`;
+}

package/src/browser/responses/questionnaireControls.ts

@@ -0,0 +1,74 @@
+import type { Draft } from "./drafts.ts";
+import type { Prompt } from "./Prompt.ts";
+import type { PromptAnswer } from "./schema.ts";
+
+function restoreAnswers(fields: readonly HTMLFieldSetElement[], draft: Draft, same: boolean) {
+	for (const field of fields) {
+		const answer = draft.answers?.find((entry) => entry.prompt === field.dataset.prompt);
+		for (const input of field.querySelectorAll<HTMLInputElement>("input")) {
+			input.checked = same && (answer?.selected.includes(input.value) ?? false);
+		}
+		const text = field.querySelector<HTMLTextAreaElement>("textarea");
+		if (text) {
+			text.value = answer?.text ?? "";
+		}
+	}
+}
+export function questionnaireControls(form: HTMLFormElement) {
+	function modeOf(field: HTMLFieldSetElement) {
+		if (field.dataset.mode === "text") {
+			return "text";
+		}
+		return field.dataset.mode === "many" ? "many" : "one";
+	}
+	const fields = [...form.querySelectorAll<HTMLFieldSetElement>("fieldset[data-prompt]")];
+	const models: Prompt[] = fields.map((field) => ({
+		id: field.dataset.prompt ?? "",
+		mode: modeOf(field),
+		options: [...field.querySelectorAll<HTMLInputElement>("input[data-option-source]")].map((input) => ({
+			id: input.value,
+			source: input.dataset.optionSource ?? "",
+		})),
+		source: field.dataset.source ?? "",
+	}));
+	function read(): readonly PromptAnswer[] | undefined {
+		return fields.length === 0
+			? undefined
+			: fields.map((field) => ({
+					prompt: field.dataset.prompt ?? "",
+					selected: [...field.querySelectorAll<HTMLInputElement>("input:checked")].map((input) => input.value),
+					text: field.querySelector<HTMLTextAreaElement>("textarea")?.value ?? "",
+				}));
+	}
+	function restore(draft: Draft, revision: string) {
+		const same = draft.revision === revision && (draft.question === undefined || draft.question === form.dataset.question);
+		restoreAnswers(fields, draft, same);
+		const recovery = form.querySelector<HTMLPreElement>("#response-draft-recovery");
+		const retained =
+			!same && draft.answers
+				? `Earlier template answers (selections cleared; review before choosing again):\n${JSON.stringify(draft.answers, null, 2)}\n${draft.recovery ?? ""}`
+				: draft.recovery;
+		if (recovery) {
+			recovery.textContent = retained ?? "";
+			recovery.hidden = !retained;
+		}
+		return retained;
+	}
+	function validate(type: string) {
+		for (const field of fields) {
+			const text = field.querySelector<HTMLTextAreaElement>("textarea");
+			text?.setCustomValidity(
+				type === "answer" && !text.value.trim() && !field.querySelector("input:checked") ? "Choose an option or answer in your own words." : "",
+			);
+		}
+	}
+	for (const field of fields) {
+		field.querySelector("[data-clear-choices]")?.addEventListener("click", () => {
+			for (const input of field.querySelectorAll<HTMLInputElement>("input")) {
+				input.checked = false;
+			}
+			form.dispatchEvent(new Event("input", { bubbles: true }));
+		});
+	}
+	return { models, read, restore, validate };
+}

package/src/browser/responses/schema.ts

@@ -0,0 +1,63 @@
+import { Schema } from "effect";
+import { Identity } from "#path/Identity.ts";
+
+export const Revision = Schema.String.check(Schema.isPattern(/^[a-f\d]{64}$/u));
+export const ResponseKind = Schema.Literals(["answer", "clarify", "not_now"]);
+export const PromptAnswer = Schema.Struct({
+	prompt: Identity.check(Schema.isMaxLength(128)),
+	selected: Schema.Array(Identity.check(Schema.isMaxLength(128))).check(Schema.isMaxLength(32)),
+	text: Schema.String.check(Schema.isMaxLength(8192)),
+});
+export const Answers = Schema.Array(PromptAnswer).check(Schema.isMaxLength(32));
+export type PromptAnswer = typeof PromptAnswer.Type;
+export const QuestionRecord = Schema.Struct({
+	deadline: Schema.Number.check(Schema.isFinite(), Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(8_640_000_000_000_000)),
+	item: Identity,
+	reason: Schema.String,
+	registeredAt: Schema.Number.check(Schema.isFinite(), Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(8_640_000_000_000_000)),
+	request: Identity,
+	reviewedRevision: Revision,
+	source: Schema.String,
+});
+export const ResponseRecord = Schema.Struct({
+	answers: Schema.optional(Answers),
+	author: Schema.String.check(Schema.isPattern(/\S/u), Schema.isMaxLength(200)),
+	question: Identity,
+	recordedAt: Schema.Number.check(Schema.isFinite(), Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(8_640_000_000_000_000)),
+	reviewedRevision: Revision,
+	supersedes: Schema.optional(Identity),
+	type: ResponseKind,
+});
+export const QuestionPreview = Schema.Struct({
+	context: Schema.String,
+	id: Identity,
+	item: Identity,
+	reason: Schema.String,
+	request: Identity,
+	reviewedRevision: Revision,
+	source: Schema.String,
+});
+export type QuestionPreview = typeof QuestionPreview.Type;
+export const Question = Schema.Struct({ context: Schema.String, id: Identity, question: QuestionRecord });
+export const RecordedResponse = Schema.Struct({ body: Schema.String, id: Identity, response: ResponseRecord });
+export const Reading = Schema.Struct({ question: Question, responses: Schema.Array(RecordedResponse) });
+export const WaitReading = Schema.Struct({ expired: Schema.Boolean, question: Question, response: Schema.optional(RecordedResponse) });
+export type WaitReading = typeof WaitReading.Type;
+export class ResponseFailed extends Schema.TaggedError<ResponseFailed>()("ResponseFailed", {
+	cause: Schema.optional(Schema.Defect()),
+	code: Schema.Literals(["Disabled", "Missing", "Stale", "Conflict", "Unavailable", "Unsupported", "Uncertain", "Unanswered"]),
+	message: Schema.String,
+}) {}
+export const DraftInput = Schema.Struct({
+	answers: Schema.optional(Answers),
+	author: ResponseRecord.fields.author,
+	body: Schema.String.check(Schema.isMaxLength(32_768)),
+	id: Identity,
+	question: Identity,
+	supersedes: Schema.optional(Identity),
+	type: ResponseKind,
+});
+export type Question = typeof Question.Type;
+export type RecordedResponse = typeof RecordedResponse.Type;
+export type Reading = typeof Reading.Type;
+export type DraftInput = typeof DraftInput.Type;