@shivaedev/work-board 0.12.0 → 0.14.0

package/src/server/diagnostics/html.ts

@@ -1,93 +0,0 @@
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import type { FleetHealth } from "#diagnostics/health.ts";
-import { resetLabel } from "#diagnostics/resetLabel.ts";
-import type { CodexLimits, GithubLimits, Observation, UsageWindow } from "#diagnostics/source.ts";
-
-function time(milliseconds: number | null): string {
-	return milliseconds === null
-		? "Not reported"
-		: `<time datetime="${new Date(milliseconds).toISOString()}">${new Date(milliseconds)
-				.toISOString()
-				.replace("T", " ")
-				.replace(/\.\d{3}Z$/u, " UTC")}</time>`;
-}
-function observed(at: number): string {
-	return `<p class="diagnostics-freshness">Observed ${time(at)}</p>`;
-}
-function card<A>(name: string, source: Observation<A>, render: (value: A) => string, attention = false, stale = false): string {
-	let state: Observation<A>["state"] | "attention" | "stale" = source.state;
-	if (state === "ready" && attention) {
-		state = "attention";
-	}
-	if (source.state === "ready" && stale) {
-		state = "stale";
-	}
-	const label = { attention: "Needs attention", error: "Unavailable", "not-configured": "Not configured", ready: "Available", stale: "Stale" }[state];
-	return `<section class="diagnostics-card" data-source="${name.toLowerCase()}" data-state="${state}" aria-labelledby="diagnostics-${name.toLowerCase()}"><header><h2 id="diagnostics-${name.toLowerCase()}">${name}</h2><span class="diagnostics-status">${label}</span></header>${source.state === "ready" ? render(source.value) : `<p role="status">${escapeHtml(source.cause)}</p>`}${observed(source.observedAt)}</section>`;
-}
-function reset(at: number | null, now: number): string {
-	return at === null ? "Not reported" : `<time data-reset datetime="${new Date(at).toISOString()}">${resetLabel(at, now)}</time>`;
-}
-function windowLabel(name: string, minutes: number | null): string {
-	if (minutes === null) {
-		return `${name} — duration not reported`;
-	}
-	if (minutes === 10_080) {
-		return "Weekly";
-	}
-	for (const [duration, unit] of [
-		[1440, "day"],
-		[60, "hour"],
-	] as const) {
-		if (minutes % duration === 0) {
-			return `${minutes / duration}-${unit}`;
-		}
-	}
-	return `${minutes}-minute`;
-}
-function usage(name: string, window: UsageWindow | null, now: number): string {
-	if (window === null) {
-		return `<li><h3>${name}</h3><p>Window not reported</p></li>`;
-	}
-	const label = windowLabel(name, window.windowDurationMins);
-	return `<li><h3>${label}</h3><p><strong>${window.usedPercent}% used</strong></p><meter min="0" max="100" value="${Math.min(window.usedPercent, 100)}" aria-label="${label} percent used">${window.usedPercent}%</meter><p>Resets ${reset(window.resetsAt === null ? null : window.resetsAt * 1000, now)}</p></li>`;
-}
-function codex(value: CodexLimits, now: number): string {
-	return `<ul class="diagnostics-windows">${usage("Primary", value.primary, now)}${usage("Secondary", value.secondary, now)}</ul>`;
-}
-function github(value: GithubLimits, now: number): string {
-	return `<dl class="diagnostics-metrics">${(
-		[
-			["REST", value.core],
-			["GraphQL", value.graphql],
-		] as const
-	)
-		.map(
-			([name, window]) =>
-				`<div><dt>${name}</dt><dd><strong>${window.remaining} / ${window.limit}</strong> remaining</dd><dd>Resets ${reset(window.reset * 1000, now)}</dd></div>`,
-		)
-		.join("")}</dl><p class="diagnostics-freshness">Cached for one minute across all tabs.</p>`;
-}
-function fleet(value: FleetHealth, now: number): string {
-	let freshness = "Current snapshot";
-	if (now < value.observedAt) {
-		freshness = "Publisher clock is ahead";
-	} else if (now - value.observedAt > value.staleAfterMs) {
-		freshness = "Stale snapshot — Fleet has not refreshed its health";
-	}
-	return `<p class="diagnostics-freshness">${freshness}</p><dl class="diagnostics-metrics"><div><dt>Running / concurrency cap</dt><dd><strong>${value.running} / ${value.concurrency}</strong></dd></div><div><dt>Queued</dt><dd><strong>${value.queued}</strong></dd></div>${Object.entries(
-		value.waiting,
-	)
-		.map(([owner, count]) => `<div><dt>Waiting on ${owner}</dt><dd><strong>${count}</strong></dd></div>`)
-		.join(
-			"",
-		)}<div><dt>Last scheduler pass</dt><dd>${time(value.lastSchedulerPass)}</dd></div><div><dt>Last provider capacity rejection</dt><dd>${value.lastCapacityRejection === null ? "None observed" : `${escapeHtml(value.lastCapacityRejection.cause)}<br>${time(value.lastCapacityRejection.at)}`}</dd></div></dl>`;
-}
-
-export function diagnosticsHtml(
-	sources: { readonly codex: Observation<CodexLimits>; readonly github: Observation<GithubLimits>; readonly fleet: Observation<FleetHealth> },
-	now: number,
-): string {
-	const fleetSource = sources.fleet.state === "ready" ? { ...sources.fleet, observedAt: sources.fleet.value.observedAt } : sources.fleet;
-	return `<div class="diagnostics"><h1>Diagnostics</h1><p>Agent usage and Fleet health. Refreshes every 15 seconds while this view is visible; Pause updates holds the current view.</p><div class="diagnostics-grid">${card("Codex", sources.codex, (value) => codex(value, now), sources.codex.state === "ready" && [sources.codex.value.primary, sources.codex.value.secondary].some((window) => window !== null && window.usedPercent >= 90))}${card("GitHub", sources.github, (value) => github(value, now), sources.github.state === "ready" && [sources.github.value.core, sources.github.value.graphql].some((window) => window.remaining === 0))}${card("Fleet", fleetSource, (value) => fleet(value, now), fleetSource.state === "ready" && (fleetSource.value.running >= fleetSource.value.concurrency || Object.values(fleetSource.value.waiting).some((count) => count > 0) || now < fleetSource.value.observedAt), fleetSource.state === "ready" && now - fleetSource.value.observedAt > fleetSource.value.staleAfterMs)}</div></div>`;
-}

package/src/server/diagnostics/page.ts

@@ -1,31 +0,0 @@
-import { Clock, Effect } from "effect";
-import type { diagnostics } from "#diagnostics/source.ts";
-import type { Changes } from "#server/files/changes.ts";
-import { respond } from "#server/http/respond.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { diagnosticsHtml } from "./html.ts";
-
-export const diagnosticsPage = Effect.fn("WorkBoard.diagnosticsPage")(function* (
-	read: Effect.Success<ReturnType<typeof diagnostics>>,
-	changes: Changes,
-	home: string | undefined,
-	index?: Effect.Success<ReturnType<typeof searchSnapshot>>,
-) {
-	const result = yield* read;
-	const snapshot = index ? yield* index : undefined;
-	return respond(
-		shell(
-			"Diagnostics",
-			navHtml(yield* changes.files, "", home, snapshot),
-			diagnosticsHtml(result, yield* Clock.currentTimeMillis),
-			changes.realRoot,
-			true,
-			undefined,
-			"diagnostics",
-			snapshot,
-		),
-		"text/html",
-	);
-});

package/src/server/diagnostics/style.ts

@@ -1,19 +0,0 @@
-export function diagnosticsStyle(): string {
-	return `
-.diagnostics { max-width: 1200px; margin: auto; padding: clamp(1rem, 3vw, 2rem); }
-.diagnostics-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 320px), 1fr)); gap: 1rem; align-items: start; }
-.diagnostics-card { min-width: 0; border: 1px solid var(--border); border-radius: 12px; padding: 1.25rem; background: var(--surface); overflow-wrap: anywhere; }
-.diagnostics-card header { display: flex; align-items: baseline; flex-wrap: wrap; gap: .5rem 1rem; justify-content: space-between; }
-.diagnostics-card h2 { margin: 0; }
-.diagnostics-status { font-size: .85rem; border: 1px solid var(--border); border-radius: 1rem; padding: .2rem .6rem; }
-.diagnostics-card[data-state=attention], .diagnostics-card[data-state=error] { border-color: var(--link); }
-.diagnostics-card[data-state=stale] .diagnostics-metrics strong { opacity: .55; }
-.diagnostics-freshness { font-size: .85rem; color: var(--muted); }
-.diagnostics-windows { list-style: none; padding: 0; }
-.diagnostics-windows li + li, .diagnostics-metrics > div + div { border-top: 1px solid var(--border); padding-top: .75rem; margin-top: .75rem; }
-.diagnostics-windows h3 { margin-bottom: .25rem; }
-.diagnostics-windows meter { width: 100%; height: .75rem; accent-color: var(--link); }
-.diagnostics-metrics dt { color: var(--muted); }
-.diagnostics-metrics dd { margin: .25rem 0 0; }
-`;
-}

package/src/server/handoffs/html.ts

@@ -1,42 +0,0 @@
-import { Effect } from "effect";
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import type { Handoff, HandoffPreview } from "#browser/handoffs/schema.ts";
-import { fileUrl } from "#files/url.ts";
-import type { RenderFailed } from "#render/failed.ts";
-import { metadataParse } from "#server/metadata/parse.ts";
-import type { Highlighter } from "#server/render/Highlighter.ts";
-import { renderMarkdown } from "#server/render/markdown.ts";
-
-export function promptHtml(id: string, prompt: string) {
-	return `<div class="handoff-copy"><label>Prompt for your existing agent session<textarea id="handoff-prompt-${escapeHtml(id)}" readonly rows="3">${escapeHtml(prompt)}</textarea></label><button type="button" data-handoff-copy="handoff-prompt-${escapeHtml(id)}">Copy tiny prompt</button><p role="status" data-copy-status>Copy and paste this into your agent session. Preparing a file does not notify an agent.</p></div>`;
-}
-function receiptNote(h: Handoff["handoff"]) {
-	if (!(h.by || h.note)) {
-		return "";
-	}
-	return `<p>${escapeHtml(h.by ?? "Attribution not recorded")}${h.note ? ` · ${escapeHtml(h.note)}` : ""}</p>`;
-}
-export const handoffHistoryHtml = Effect.fn("WorkBoard.handoffHistoryHtml")(function* (
-	records: readonly Handoff[],
-	current?: HandoffPreview,
-): Effect.fn.Return<string[], RenderFailed, Highlighter> {
-	return yield* Effect.forEach(records, (record) =>
-		Effect.gen(function* () {
-			const h = record.handoff;
-			const goal = yield* renderMarkdown(h.goal, { file: h.source, safe: true });
-			const constraints = yield* renderMarkdown(h.constraints, { file: h.source, safe: true });
-			const next = yield* renderMarkdown(h.nextAction, { file: h.source, safe: true });
-			const same = current?.reviewedRevision === h.reviewedRevision && current.source === h.source;
-			return `<article id="${escapeHtml(record.id)}"><h3><a href="${fileUrl(record.file)}">${escapeHtml(record.id)}</a> · ${escapeHtml(h.recipient)}</h3><p><b>Receipt: ${escapeHtml(h.state)}</b>${h.state === "requested" ? " — prepared; receipt not confirmed" : ""}. Execution and acceptance are not recorded by this state.</p><p>${same ? "Current reviewed source" : "Earlier or unavailable reviewed source; recheck before acting"} · <a href="${fileUrl(h.source)}">${escapeHtml(h.source)}</a> · <code>${h.reviewedRevision}</code></p>${receiptNote(h)}<h4>Goal</h4>${goal}<h4>Constraints</h4>${constraints || "<p>None recorded.</p>"}<h4>Next action</h4>${next}${promptHtml(record.id, record.prompt)}<details><summary>Exact reviewed source snapshot</summary><pre>${escapeHtml(record.context)}</pre></details></article>`;
-		}),
-	);
-});
-export const handoffFormHtml = Effect.fn("WorkBoard.handoffFormHtml")(function* (
-	source: HandoffPreview,
-	enabled: boolean,
-): Effect.fn.Return<string, RenderFailed, Highlighter> {
-	const parsed = metadataParse(source.context);
-	const background = yield* renderMarkdown(parsed.body, { file: source.source, safe: true });
-	const goal = /^#\s+(?<title>.+)$/mu.exec(parsed.body)?.groups?.title ?? source.item;
-	return `<section class="response-context">${background}</section><details><summary>Exact source being reviewed</summary><pre>${escapeHtml(source.context)}</pre></details><form id="handoff-form" data-item="${escapeHtml(source.item)}" data-source="${escapeHtml(source.source)}" data-revision="${source.reviewedRevision}" data-question="${source.id}" data-writable="${enabled}"><label>Recipient — local agent label<input name="recipient" required maxlength="200"></label><label>Goal<textarea name="goal" required maxlength="8192" rows="3">${escapeHtml(goal)}</textarea></label><label>Constraints (optional)<textarea name="constraints" maxlength="8192" rows="4"></textarea></label><label>Next action<textarea name="nextAction" required maxlength="8192" rows="3">${escapeHtml(parsed.fields.nextAction ?? "")}</textarea></label><p>The file includes the full reviewed source and its declared acceptance criteria. Preparing it does not change the item or start an agent. Drafts use the existing 30-day/2-MiB workspace store.</p><button id="handoff-preview" type="button" disabled>Preview Markdown</button><pre id="handoff-preview-content" hidden></pre><button id="handoff-submit" type="submit" disabled>Prepare handoff</button><button id="handoff-clear" type="button" disabled>Clear workspace drafts</button><p id="handoff-status" role="status">${enabled ? "JavaScript is required to prepare a handoff." : "Read-only mode. Restart with --responses to enable local writes."}</p><section id="handoff-prepared" hidden></section></form>`;
-});

package/src/server/handoffs/page.ts

@@ -1,51 +0,0 @@
-import { Effect, type FileSystem, type Path, type PlatformError } from "effect";
-import type { HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import type { Changes } from "#server/files/changes.ts";
-import { handoffFormHtml, handoffHistoryHtml } from "#server/handoffs/html.ts";
-import { HandoffsService } from "#server/handoffs/Service.ts";
-import { respond } from "#server/http/respond.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { Highlighter } from "#server/render/Highlighter.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-
-function unknownHistory(files: readonly string[]) {
-	return files.length > 0
-		? `<p role="status">Some handoff history is unavailable: ${files.map(escapeHtml).join(", ")}. Missing records do not establish that no receipt exists.</p>`
-		: "";
-}
-export function handoffPage(changes: Changes, home: string | undefined, enabled: boolean, index?: Effect.Success<ReturnType<typeof searchSnapshot>>) {
-	return Effect.fn("WorkBoard.handoffPage")(function* (
-		request: HttpServerRequest.HttpServerRequest,
-	): Effect.fn.Return<
-		HttpServerResponse.HttpServerResponse,
-		PlatformError.PlatformError,
-		FileSystem.FileSystem | Path.Path | Highlighter | HandoffsService
-	> {
-		const service = yield* HandoffsService;
-		const item = new URL(request.url, "http://127.0.0.1").searchParams.get("item") ?? "";
-		const files = yield* changes.files;
-		const snapshot = index ? yield* index : undefined;
-		function layout(body: string, status = 200) {
-			return respond(
-				shell("Handoff", navHtml(files, "", home, snapshot), body, changes.realRoot, false, undefined, "handoff", snapshot),
-				"text/html",
-				status,
-			);
-		}
-		return yield* Effect.gen(function* () {
-			const source = yield* Effect.result(service.locate(item));
-			const current = source._tag === "Success" ? source.success : undefined;
-			const reading = yield* service.read(item);
-			const history = yield* handoffHistoryHtml(reading.records, current);
-			const form = current
-				? yield* handoffFormHtml(current, enabled)
-				: `<p role="status">Source unavailable: ${escapeHtml(String(source._tag === "Failure" ? source.failure : ""))}. Existing handoffs remain readable.</p>`;
-			return layout(
-				`<section class="response-panel"><h1>Agent handoff · ${escapeHtml(item)}</h1><p>Prepare a Markdown file, then copy a tiny prompt into your existing agent session. Sessions may poll or wait for human answers. Agents record receipt with ordinary file edits.</p>${form}<section id="handoff-history"><h2>Prepared handoffs</h2>${unknownHistory(reading.unknown)}${history.join("") || "<p>No readable handoff is recorded for this item.</p>"}</section></section>`,
-				current || reading.records.length > 0 ? 200 : 409,
-			);
-		}).pipe(Effect.catch((error) => Effect.succeed(layout(`<h1>Handoff unavailable</h1><p>${escapeHtml(String(error))}</p>`, 409))));
-	});
-}

package/src/server/history/baseline.ts

@@ -1,43 +0,0 @@
-import { Option, Schema } from "effect";
-import { Baseline } from "#history/schema.ts";
-import type { Snapshot } from "#server/search/snapshot.ts";
-import { MAX_AGE, MAX_BYTES } from "./limits.ts";
-
-const JsonBaseline = Schema.fromJsonString(Baseline);
-function byteLength(text: string): number {
-	return new TextEncoder().encode(text).length;
-}
-
-export function readBaseline(raw: string | null, now: number) {
-	if (raw === null) {
-		return { baseline: undefined, discard: false, reason: "No previous snapshot. Start remembering changes to compare future source observations." };
-	}
-	if (byteLength(raw) > MAX_BYTES) {
-		return { baseline: undefined, discard: true, reason: "Remembered snapshot exceeds 2 MiB; history is unavailable." };
-	}
-	const decoded = Schema.decodeUnknownOption(JsonBaseline, { onExcessProperty: "error" })(raw);
-	if (Option.isNone(decoded)) {
-		return { baseline: undefined, discard: true, reason: "Remembered snapshot is invalid or unsupported; history is unavailable." };
-	}
-	const elapsed = now - Date.parse(decoded.value.recordedAt);
-	if (elapsed < 0) {
-		return { baseline: undefined, discard: true, reason: "Remembered observation is in the future; history is unavailable." };
-	}
-	if (elapsed >= MAX_AGE) {
-		return { baseline: undefined, discard: true, reason: "Remembered snapshot expired after 30 days; start again to establish a new baseline." };
-	}
-	return { baseline: decoded.value, discard: false, reason: "" };
-}
-
-export function observeBaseline(snapshot: Snapshot, now: number): string | undefined {
-	if (snapshot.unavailable.length > 0) {
-		return undefined;
-	}
-	const baseline: Baseline = {
-		documents: snapshot.documents.map((document) => ({ file: document.file, source: (document.parsed.raw ?? "") + document.parsed.body })),
-		recordedAt: new Date(now).toISOString(),
-		version: 1,
-	};
-	const raw = Schema.encodeSync(JsonBaseline)(baseline);
-	return byteLength(raw) <= MAX_BYTES ? raw : undefined;
-}

package/src/server/history/compare.ts

@@ -1,54 +0,0 @@
-import type { Baseline } from "#history/schema.ts";
-import { type HistoryDocument, historyDocuments, historyIdentities } from "./documents.ts";
-import { historyFields } from "./fields.ts";
-
-export interface SourceChange {
-	readonly after?: HistoryDocument;
-	readonly before?: HistoryDocument;
-	readonly kind: "added" | "removed" | "changed";
-	readonly reasons: readonly string[];
-}
-
-export function compareHistory(baseline: Baseline, current: Baseline) {
-	const before = historyDocuments(baseline);
-	const after = historyDocuments(current);
-	const oldIds = historyIdentities(before);
-	const newIds = historyIdentities(after);
-	const paired = new Set<HistoryDocument>();
-	const remaining = new Set(after);
-	const changes: SourceChange[] = [];
-	function pair(old: HistoryDocument, next: HistoryDocument) {
-		paired.add(old);
-		remaining.delete(next);
-		if (old.source !== next.source || old.file !== next.file) {
-			changes.push({ after: next, before: old, kind: "changed", reasons: historyFields(old, next) });
-		}
-	}
-	for (const [id, old] of oldIds) {
-		const next = newIds.get(id);
-		if (old && next) {
-			pair(old, next);
-		}
-	}
-	const byFile = new Map([...remaining].map((document) => [document.file, document]));
-	for (const old of before) {
-		if (paired.has(old)) {
-			continue;
-		}
-		const next = byFile.get(old.file);
-		if (next) {
-			pair(old, next);
-		} else {
-			changes.push({ before: old, kind: "removed", reasons: ["Source absent from the complete current observation"] });
-		}
-	}
-	for (const next of remaining) {
-		changes.push({ after: next, kind: "added", reasons: ["Source added since the remembered observation"] });
-	}
-	const issues = [
-		...[...oldIds].filter(([, document]) => !document).map(([id]) => `Duplicate ID ${id} in remembered sources; no identity winner selected.`),
-		...[...newIds].filter(([, document]) => !document).map(([id]) => `Duplicate ID ${id} in current sources; no identity winner selected.`),
-	];
-	changes.sort((a, b) => (a.after?.file ?? a.before?.file ?? "").localeCompare(b.after?.file ?? b.before?.file ?? "", "en"));
-	return { changes, issues, newIds };
-}

package/src/server/history/documents.ts

@@ -1,21 +0,0 @@
-import type { Baseline } from "#history/schema.ts";
-import { metadataParse, type ParsedMetadata } from "#server/metadata/parse.ts";
-
-export interface HistoryDocument {
-	readonly file: string;
-	readonly parsed: ParsedMetadata;
-	readonly source: string;
-}
-export function historyDocuments(baseline: Baseline): readonly HistoryDocument[] {
-	return baseline.documents.map((document) => ({ ...document, parsed: metadataParse(document.source) }));
-}
-export function historyIdentities(documents: readonly HistoryDocument[]): ReadonlyMap<string, HistoryDocument | undefined> {
-	const ids = new Map<string, HistoryDocument | undefined>();
-	for (const document of documents) {
-		const id = document.parsed.fields.id;
-		if (id) {
-			ids.set(id, ids.has(id) ? undefined : document);
-		}
-	}
-	return ids;
-}

package/src/server/history/fields.ts

@@ -1,32 +0,0 @@
-import type { Metadata } from "#metadata/schema.ts";
-import type { HistoryDocument } from "./documents.ts";
-
-const labels: ReadonlyArray<readonly [keyof Metadata, string]> = [
-	["attention", "Recorded attention requests changed"],
-	["criteria", "Criteria changed"],
-	["evidence", "Recorded evidence changed (not verified acceptance)"],
-	["id", "Item ID changed"],
-	["items", "Declared board membership changed"],
-	["kind", "Item kind changed"],
-	["nextAction", "Next action changed"],
-	["owner", "Recorded owner changed (not authorship)"],
-	["relationships", "Explicit relationships changed"],
-	["status", "Recorded status changed (not acceptance)"],
-];
-
-export function historyFields(before: HistoryDocument, after: HistoryDocument): readonly string[] {
-	const changes = labels.flatMap(([field, label]) =>
-		JSON.stringify(before.parsed.fields[field]) === JSON.stringify(after.parsed.fields[field]) ? [] : [label],
-	);
-	if (before.parsed.body !== after.parsed.body) {
-		const decision = before.parsed.fields.kind === "decision" || after.parsed.fields.kind === "decision";
-		changes.push(decision ? "Decision Markdown changed" : "Markdown body changed");
-	}
-	if (changes.length === 0 && before.source !== after.source) {
-		changes.push("Other frontmatter content or source formatting changed; no further interpretation");
-	}
-	if (before.file !== after.file) {
-		changes.unshift("Source path changed for the same unique item ID");
-	}
-	return changes;
-}

package/src/server/history/html.ts

@@ -1,23 +0,0 @@
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import { fileUrl } from "#files/url.ts";
-import type { Baseline } from "#history/schema.ts";
-import { compareHistory, type SourceChange } from "./compare.ts";
-
-function source(label: string, text: string, key: string): string {
-	return `<details data-key="${escapeHtml(key)}:${label}" data-history-source="${label.toLowerCase()}"><summary>${label} source (plain text)</summary><pre class="history-source">${escapeHtml(text)}</pre></details>`;
-}
-function changeHtml(change: SourceChange): string {
-	const file = change.after?.file ?? change.before?.file ?? "";
-	const key = change.before ? `before:${change.before.file}` : `added:${file}`;
-	return `<article class="history-change" data-key="${escapeHtml(key)}"><h2>${change.kind}: ${escapeHtml(file)}</h2>${change.before && change.after && change.before.file !== file ? `<p>Previously ${escapeHtml(change.before.file)}</p>` : ""}<ul>${change.reasons.map((reason) => `<li>${escapeHtml(reason)}</li>`).join("")}</ul>${change.after ? `<a href="${escapeHtml(fileUrl(change.after.file))}">Read current source</a>` : "<p>Removed source; no current document link.</p>"}${change.before ? source("Remembered", change.before.source, key) : ""}${change.after ? source("Current", change.after.source, key) : ""}</article>`;
-}
-export function historyHtml(before: Baseline, current: Baseline): string {
-	const result = compareHistory(before, current);
-	const counts = ["added", "removed", "changed"]
-		.map((kind) => `${result.changes.filter((change) => change.kind === kind).length} ${kind}`)
-		.join(" · ");
-	return `<p>Compared with your observation at <time>${escapeHtml(before.recordedAt)}</time>.</p><p role="status">${counts}</p>${result.changes.length === 0 ? "<p>No source changes since that observation.</p>" : ""}${result.issues.length > 0 ? `<aside aria-label="Identity limitations"><ul>${result.issues.map((issue) => `<li>${escapeHtml(issue)}</li>`).join("")}</ul><p>Ambiguous identities are compared by source path only.</p></aside>` : ""}${result.changes.map(changeHtml).join("")}`;
-}
-export function changesHtml(): string {
-	return `<section class="history"><h1>Changes since seen</h1><p>Compare current Markdown with one observation you explicitly remember in this browser. This is an observed source comparison, not an event journal, Git history, authorship, or verified acceptance.</p><p>Remembered source can include old or deleted content. One snapshot per workspace, up to 2 MiB, expires after 30 days and is removed on your next workspace visit. Mark seen replaces it; Clear forgets it. No source writes or cloud storage.</p><div class="history-controls"><button id="history-mark" type="button" disabled>Start remembering changes</button><button id="history-clear" type="button" disabled>Clear remembered history</button><span id="history-storage" role="status"></span></div><noscript><p>Remembering and comparing changes requires JavaScript and browser storage. Markdown, Overview and Work remain readable.</p></noscript><div id="changes-content" aria-live="polite"><p>No comparison has been loaded.</p></div></section><style>.history-controls{display:flex;flex-wrap:wrap;gap:.6rem;align-items:center}.history-change{border-top:1px solid var(--border);padding:1rem 0}.history-source{white-space:pre-wrap;overflow-wrap:anywhere;max-height:32rem;overflow:auto}.history h2{overflow-wrap:anywhere}</style>`;
-}

package/src/server/history/limits.ts

@@ -1,2 +0,0 @@
-export const MAX_BYTES = 2 * 1024 * 1024;
-export const MAX_AGE = 30 * 24 * 60 * 60 * 1000;

package/src/server/history/response.ts

@@ -1,23 +0,0 @@
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import type { HistoryOutput } from "#history/schema.ts";
-import type { Snapshot } from "#server/search/snapshot.ts";
-import { observeBaseline, readBaseline } from "./baseline.ts";
-import { historyHtml } from "./html.ts";
-
-export function historyResponse(raw: string | null, now: number, snapshot?: Snapshot): HistoryOutput {
-	const prior = readBaseline(raw, now);
-	const output: HistoryOutput = { discardBaseline: prior.discard, html: `<p>${escapeHtml(prior.reason)}</p>`, reason: prior.reason, snapshot: null };
-	if (snapshot === undefined) {
-		return output;
-	}
-	const currentRaw = observeBaseline(snapshot, now);
-	if (currentRaw === undefined) {
-		const reason =
-			snapshot.unavailable.length > 0
-				? "Current workspace observation is incomplete; no comparison or removals are inferred. Your valid remembered snapshot is preserved."
-				: "Complete current snapshot exceeds 2 MiB; no comparison or partial history is retained.";
-		return { ...output, html: `<p role="status">${escapeHtml(reason)}</p>`, reason };
-	}
-	const current = readBaseline(currentRaw, now).baseline;
-	return { ...output, html: prior.baseline && current ? historyHtml(prior.baseline, current) : output.html, snapshot: currentRaw };
-}

package/src/server/http/changesPage.ts

@@ -1,15 +0,0 @@
-import { Effect } from "effect";
-import type { Changes } from "#server/files/changes.ts";
-import { changesHtml } from "#server/history/html.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { respond } from "./respond.ts";
-
-export function changesPage(changes: Changes, home: string | undefined, index?: Effect.Success<ReturnType<typeof searchSnapshot>>) {
-	return Effect.fn("WorkBoard.changesPage")(function* () {
-		const snapshot = index ? yield* index : undefined;
-		const nav = navHtml(yield* changes.files, "", home, snapshot);
-		return respond(shell("Changes", nav, changesHtml(), changes.realRoot, true, undefined, "changes", snapshot), "text/html");
-	});
-}

package/src/server/http/inbox.ts

@@ -1,27 +0,0 @@
-import { Clock, Effect } from "effect";
-import { inboxHtml } from "#server/attention/inboxHtml.ts";
-import type { Changes } from "#server/files/changes.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { respond } from "./respond.ts";
-
-export function inbox(index: Effect.Success<ReturnType<typeof searchSnapshot>>, changes: Changes, home: string | undefined) {
-	return Effect.fn("WorkBoard.inbox")(function* () {
-		const snapshot = yield* index;
-		return respond(
-			shell(
-				"Inbox",
-				navHtml(yield* changes.files, "", home, snapshot),
-				inboxHtml(snapshot, false, yield* Clock.currentTimeMillis),
-				changes.realRoot,
-				true,
-				undefined,
-				"inbox",
-				snapshot,
-			),
-			"text/html",
-			snapshot.unavailable.length > 0 ? 503 : 200,
-		);
-	});
-}

package/src/server/http/overview.ts

@@ -1,19 +0,0 @@
-import { Effect } from "effect";
-import { overviewHtml } from "#server/attention/overviewHtml.ts";
-import type { Changes } from "#server/files/changes.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { respond } from "./respond.ts";
-
-export function overview(index: Effect.Success<ReturnType<typeof searchSnapshot>>, changes: Changes, home: string | undefined) {
-	return Effect.fn("WorkBoard.overview")(function* () {
-		const snapshot = yield* index;
-		const nav = navHtml(yield* changes.files, "", home, snapshot);
-		return respond(
-			shell("Overview", nav, overviewHtml(snapshot), changes.realRoot, true, undefined, "overview", snapshot),
-			"text/html",
-			snapshot.unavailable.length > 0 ? 503 : 200,
-		);
-	});
-}

package/src/server/http/readPage.ts

@@ -1,13 +0,0 @@
-import type { Effect } from "effect";
-import { HttpServerRequest, type HttpServerResponse } from "effect/unstable/http";
-
-export function readPage<E, R>(
-	routes: Readonly<Record<string, (request: HttpServerRequest.HttpServerRequest) => Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>>>,
-	fallback: (request: HttpServerRequest.HttpServerRequest) => Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>,
-) {
-	return (url: string) => {
-		const request = HttpServerRequest.fromWeb(new Request(`http://127.0.0.1${url}`));
-		const path = new URL(url, "http://127.0.0.1").pathname;
-		return (routes[path] ?? fallback)(request);
-	};
-}

package/src/server/http/start.ts

@@ -1,27 +0,0 @@
-import { Effect } from "effect";
-import type { Changes } from "#server/files/changes.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import { startHtml } from "#server/page/startHtml.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { respond } from "./respond.ts";
-
-export function start(changes: Changes, home: string | undefined, index?: Effect.Success<ReturnType<typeof searchSnapshot>>) {
-	return Effect.fn("WorkBoard.start")(function* () {
-		const files = yield* changes.files;
-		const snapshot = index ? yield* index : undefined;
-		return respond(
-			shell(
-				"Getting started",
-				navHtml(files, "", home, snapshot),
-				startHtml(files.length === 0),
-				changes.realRoot,
-				false,
-				undefined,
-				"start",
-				snapshot,
-			),
-			"text/html",
-		);
-	});
-}

package/src/server/http/work.ts

@@ -1,42 +0,0 @@
-import { Effect } from "effect";
-import type { HttpServerRequest } from "effect/unstable/http";
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import type { Changes } from "#server/files/changes.ts";
-import { navHtml } from "#server/page/nav.ts";
-import { shell } from "#server/page/shell.ts";
-import type { searchSnapshot } from "#server/search/snapshot.ts";
-import { stateOf } from "#server/views/state.ts";
-import { workHtml } from "#server/views/workHtml.ts";
-import { respond } from "./respond.ts";
-
-export function work(index: Effect.Success<ReturnType<typeof searchSnapshot>>, changes: Changes, home: string | undefined) {
-	return Effect.fn("WorkBoard.work")(function* (request: HttpServerRequest.HttpServerRequest) {
-		const snapshot = yield* index;
-		const nav = navHtml(yield* changes.files, "", home, snapshot);
-		if (snapshot.unavailable.length > 0) {
-			return respond(
-				shell(
-					"Work",
-					nav,
-					`<h1>Workspace incomplete</h1><p class="empty">Could not read ${escapeHtml(snapshot.unavailable.join(", "))}. Work identity and view counts cannot be validated. Read available source files or retry when the workspace is readable.</p>`,
-					changes.realRoot,
-					true,
-					undefined,
-					true,
-					snapshot,
-				),
-				"text/html",
-				503,
-			);
-		}
-		const result = yield* workHtml(snapshot, stateOf(request.url)).pipe(
-			Effect.catch(() =>
-				Effect.succeed({
-					html: '<h1>Work unavailable</h1><p class="empty">The selected source could not be rendered. Read its Markdown file or retry.</p>',
-					status: 500,
-				}),
-			),
-		);
-		return respond(shell("Work", nav, result.html, changes.realRoot, true, undefined, true, snapshot), "text/html", result.status);
-	});
-}

package/src/server/page/attentionDetails.ts

@@ -1,26 +0,0 @@
-import { escapeHtml } from "#browser/escapeHtml.ts";
-import { managedRequestReceipt } from "#server/attention/managedRequestReceipt.ts";
-import { attentionSource } from "#server/attention/requests.ts";
-import { identityUrl } from "#server/metadata/links.ts";
-import type { MetadataModel } from "#server/metadata/model.ts";
-import type { ParsedMetadata } from "#server/metadata/parse.ts";
-import { referenceHtml } from "./metadataLinks.ts";
-
-export function attentionDetails(parsed: ParsedMetadata, file: string, model: MetadataModel): string {
-	const requests = parsed.fields.attention ?? [];
-	if (requests.length === 0) {
-		return "";
-	}
-	return `<h3>Recorded attention requests</h3><p>Open/closed is source state. Closing a request does not establish acceptance or record an answer.</p><ul>${requests
-		.map((request, index) => {
-			const receipt = managedRequestReceipt({ file, parsed }, request, model);
-			const acknowledged = receipt
-				? `<p>Managed request acknowledged: ${receipt.disposition}. Source state remains ${escapeHtml(request.state)}. This receipt does not establish acceptance.</p><p>Reviewed question: ${referenceHtml(receipt.question, receipt.question, model)}</p>`
-				: "";
-			const respond = receipt
-				? ""
-				: `<a href="/_board/respond?item=${encodeURIComponent(parsed.fields.id ?? "")}&amp;request=${encodeURIComponent(request.id)}">Respond to this request</a> · `;
-			return `<li id="${attentionSource({ file, parsed }, index)}" tabindex="-1"><b>${escapeHtml(request.kind)} · ${escapeHtml(request.id)} · ${escapeHtml(request.state)}</b>${acknowledged}<p>${escapeHtml(request.reason)}</p><p>Response needed from: ${request.responseFrom.map(escapeHtml).join(", ")}</p><p>Recorded to unblock: ${request.unblocks.map((target) => referenceHtml(target, target, model)).join(", ")}</p><p>${respond}<a href="${identityUrl(parsed.fields.id ?? "")}">Reviewed item</a></p><p>Source: ${escapeHtml(file)}:${parsed.lines[`attention.${index}`] ?? parsed.lines.attention ?? 2}</p></li>`;
-		})
-		.join("")}</ul>`;
-}