@shivaedev/work-board 0.11.0 → 0.13.0

package/src/server/views/projection.ts

@@ -0,0 +1,59 @@
+import type { Snapshot } from "#server/search/snapshot.ts";
+import { filterItems, type Item, itemsOf } from "./items.ts";
+import type { State } from "./state.ts";
+
+export interface Projection {
+	readonly boards: readonly Item[];
+	readonly issues: readonly string[];
+	readonly items: readonly Item[];
+	readonly rows: readonly Item[];
+	readonly selected: Item | undefined;
+	readonly selectedOutside: boolean;
+	readonly title: string;
+	readonly validBoard: boolean;
+}
+function boardItems(board: Item, items: readonly Item[], snapshot: Snapshot) {
+	const references = board.document.parsed.fields.items ?? [];
+	const byId = new Map(items.map((item) => [item.id, item]));
+	const issues: string[] = [];
+	const found: Item[] = [];
+	for (const id of new Set(references)) {
+		const item = byId.get(id);
+		if (item) {
+			found.push(item);
+		} else {
+			issues.push(`${id}: ${(snapshot.model.ids.get(id)?.length ?? 0) > 1 ? "ambiguous ID" : "missing or invalid ID"}`);
+		}
+		if (references.filter((reference) => reference === id).length > 1) {
+			issues.push(`${id}: repeated membership, shown once`);
+		}
+	}
+	return { found, issues };
+}
+export function projectItems(snapshot: Snapshot, state: State): Projection {
+	const known = itemsOf(snapshot);
+	const boards = known.filter((item) => item.document.parsed.fields.kind === "board");
+	const board = boards.find((item) => item.id === state.board);
+	const membership = board ? boardItems(board, known, snapshot) : undefined;
+	const items = membership?.found ?? known.filter((item) => item.document.parsed.fields.kind !== "board");
+	const rows = filterItems(items, state);
+	const selected = known.find((item) => item.id === state.item);
+	const issues =
+		membership?.issues
+		?? [...snapshot.model.ids]
+			.filter(([, documents]) => documents.length > 1)
+			.map(([id]) => `${id}: ambiguous ID; open its source files to correct the declaration`);
+	const sourceIssues = board
+		? (snapshot.model.diagnostics.get(board.document.file) ?? []).map((problem) => `${board.document.file}:${problem.line}: ${problem.message}`)
+		: [];
+	return {
+		boards,
+		issues: [...issues, ...sourceIssues],
+		items,
+		rows,
+		selected,
+		selectedOutside: selected !== undefined && !rows.some((item) => item.id === selected.id),
+		title: board?.title ?? "All work",
+		validBoard: !state.board || board !== undefined,
+	};
+}

package/src/server/views/projectionQueries.ts

@@ -0,0 +1,78 @@
+import { Effect } from "effect";
+import { NotFound } from "@shivaedev/platform/errors/taxonomy.ts";
+import type { BoardProjection, InboxProjection, OverviewProjection, WorkProjection } from "#browser/views/schema.ts";
+import { stateOf } from "#browser/views/state.ts";
+import { inboxItems } from "#server/attention/inbox.ts";
+import { attentionRequests } from "#server/attention/requests.ts";
+import { identityUrl, referenceTarget } from "#server/metadata/links.ts";
+import { boardOf, countsOf } from "#server/render/board.ts";
+import type { HandlerOptions } from "#server/rpc/HandlerOptions.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+import type { Item } from "./items.ts";
+import { projectItems } from "./projection.ts";
+
+export function projectionQueries({ index, document }: { readonly index: HandlerOptions["index"]; readonly document: HandlerOptions["document"] }) {
+	function read(url: string) {
+		return document ? document(url) : Effect.fail(new NotFound({ message: "The document is missing." }));
+	}
+	return {
+		board: (url: string) => Effect.map(read(url), (data): BoardProjection => ({ counts: countsOf(boardOf(data.source)), document: data })),
+		inbox: () => Effect.map(index, inboxProjection),
+		overview: () => Effect.map(index, overviewProjection),
+		work: (url: string) =>
+			Effect.gen(function* () {
+				const snapshot = yield* index;
+				const state = stateOf(url);
+				const projection = projectItems(snapshot, state);
+				const waiting = new Map(
+					inboxItems(snapshot)
+						.filter((entry) => !entry.problem)
+						.map((entry) => [entry.id, entry.reason]),
+				);
+				function toItem({ document: source, id, title }: Item) {
+					return { file: source.file, id, metadata: source.parsed.fields, title, waiting: waiting.get(id) };
+				}
+				const selected = projection.selected ? yield* read(identityUrl(projection.selected.id)) : undefined;
+				return {
+					boards: projection.boards.map(toItem),
+					issues: projection.issues,
+					items: projection.items.map(toItem),
+					rows: projection.rows.map(toItem),
+					selected,
+					selectedOutside: projection.selectedOutside,
+					selectionProblem: !state.item || selected ? undefined : selectionProblem(snapshot, state.item),
+					state,
+					title: projection.title,
+					validBoard: projection.validBoard,
+				} satisfies WorkProjection;
+			}),
+	};
+}
+function inboxProjection(snapshot: Snapshot): InboxProjection {
+	return {
+		complete: snapshot.unavailable.length === 0,
+		items: inboxItems(snapshot).map(({ document, ...item }) => ({ ...item, file: document.file })),
+		sourceIssues: snapshot.model.documents.some((document) => (snapshot.model.diagnostics.get(document.file)?.length ?? 0) > 0),
+	};
+}
+function overviewProjection(snapshot: Snapshot): OverviewProjection {
+	const projection = attentionRequests(snapshot);
+	return {
+		...projection,
+		entries: projection.entries.map(({ document, request, ...entry }) => ({
+			...entry,
+			file: document.file,
+			id: request.id,
+			kind: request.kind,
+			reason: request.reason,
+			responseFrom: request.responseFrom,
+			unblocks: request.unblocks.map((target) => ({ href: referenceTarget(target, snapshot.model), label: target })),
+		})),
+		inboxCount: inboxItems(snapshot).length,
+		unavailable: snapshot.unavailable,
+	};
+}
+
+function selectionProblem(snapshot: Snapshot, item: string) {
+	return (snapshot.model.ids.get(item)?.length ?? 0) > 1 ? "has a duplicate ID" : "is missing or its identity changed";
+}

package/src/server/views/remainingQueries.ts

@@ -0,0 +1,74 @@
+import { Clock, Effect } from "effect";
+import { Conflict, NotFound } from "@shivaedev/platform/errors/taxonomy.ts";
+import type { Diagnostics } from "#diagnostics/source.ts";
+import type { HandoffsService } from "#server/handoffs/Service.ts";
+import { identityUrl } from "#server/metadata/links.ts";
+import { metadataParse } from "#server/metadata/parse.ts";
+import { startTemplates } from "#server/page/startTemplates.ts";
+import type { Responses } from "#server/responses/service.ts";
+import type { HandlerOptions } from "#server/rpc/HandlerOptions.ts";
+import { resultProjection } from "./resultProjection.ts";
+export function remainingQueries(
+	{ changes, document, index, writable }: HandlerOptions,
+	services: {
+		readonly diagnostics: typeof Diagnostics.Service;
+		readonly responses: typeof Responses.Service;
+		readonly handoffs: typeof HandoffsService.Service;
+	},
+) {
+	function read(url: string) {
+		return document ? document(url) : Effect.fail(new NotFound({ message: "The document is missing." }));
+	}
+	return {
+		diagnostics: () =>
+			Effect.gen(function* () {
+				return { now: yield* Clock.currentTimeMillis, sources: yield* services.diagnostics.read() };
+			}),
+		handoff: (url: string) =>
+			Effect.gen(function* () {
+				const item = new URL(url, "http://127.0.0.1").searchParams.get("item") ?? "";
+				const service = services.handoffs;
+				const result = yield* Effect.result(service.locate(item));
+				const source = result._tag === "Success" ? result.success : undefined;
+				const parsed = metadataParse(source?.context ?? "");
+				return {
+					background: parsed.body,
+					goal: /^#\s+(?<title>.+)$/mu.exec(parsed.body)?.groups?.title ?? item,
+					item,
+					nextAction: parsed.fields.nextAction ?? "",
+					reading: yield* service.read(item),
+					source,
+					unavailable: result._tag === "Failure" ? String(result.failure) : undefined,
+					writable: writable === true,
+				};
+			}),
+		respond: (url: string) =>
+			Effect.gen(function* () {
+				const params = new URL(url, "http://127.0.0.1").searchParams;
+				const service = services.responses;
+				const preview = yield* service.locate(params.get("item") ?? "", params.get("request") ?? "");
+				yield* service.read(preview.id).pipe(Effect.catch((error) => (error._tag === "NotFound" ? Effect.void : Effect.fail(error))));
+				const responses = yield* service.history(preview);
+				const data = yield* read(identityUrl(preview.item));
+				const request = data.requests.find((entry) => entry.id === preview.request);
+				if (!request) {
+					return yield* Effect.fail(new Conflict({ message: "The response request is unavailable." }));
+				}
+				return { document: data, request: { ...request, preview, responses } };
+			}),
+		result: (url: string) =>
+			Effect.gen(function* () {
+				const item = new URL(url, "http://127.0.0.1").searchParams.get("item") ?? "";
+				const data = yield* index;
+				const matches = data.model.ids.get(item);
+				const result = matches?.length === 1 ? matches[0] : undefined;
+				if (result?.parsed.fields.kind !== "result" || data.unavailable.length > 0) {
+					return yield* Effect.fail(
+						new Conflict({ message: "Choose one uniquely identified, readable result. Missing or ambiguous work is not accepted." }),
+					);
+				}
+				return yield* resultProjection(result, data, yield* read(identityUrl(item)));
+			}),
+		start: () => Effect.map(changes.files, (files) => ({ empty: files.length === 0, templates: startTemplates })),
+	};
+}

package/src/server/views/resultProjection.ts

@@ -0,0 +1,45 @@
+import { Effect } from "effect";
+import type { Document } from "#browser/document/schema.ts";
+import type { ResultProjection } from "#browser/views/ResultProjection.ts";
+import type { MetadataDocument } from "#server/metadata/model.ts";
+import { readResponses } from "#server/responses/read.ts";
+import { malformedResponse, questionFrom, revisionOf } from "#server/responses/records.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+import { resultTargets } from "./resultTargets.ts";
+export const resultProjection = Effect.fn("WorkBoard.resultProjection")(function* (
+	result: MetadataDocument,
+	data: Snapshot,
+	document: Document,
+): Effect.fn.Return<ResultProjection> {
+	const revision = revisionOf((result.parsed.raw ?? "") + result.parsed.body);
+	const criteria = resultTargets(result, data, document);
+	const questions = data.documents.flatMap((entry) => {
+		const question = questionFrom(entry);
+		return question && question.question.item === result.parsed.fields.id ? [question] : [];
+	});
+	const read = readResponses(Effect.succeed(data));
+	const readings = yield* Effect.forEach(questions, (question) => Effect.result(read(question.id)));
+	const feedbackUnknown =
+		data.unavailable.length > 0
+		|| data.documents.some((entry) => malformedResponse(entry) || (entry.parsed.fields.kind === "question" && !questionFrom(entry)))
+		|| readings.some((entry) => entry._tag === "Failure");
+	function file(id: string) {
+		return data.model.ids.get(id)?.[0]?.file ?? `responses/${id}.md`;
+	}
+	const feedback = feedbackUnknown
+		? []
+		: readings.flatMap((entry) =>
+				entry._tag === "Success"
+					? entry.success.responses.map((response) => ({
+							matching: entry.success.question.question.reviewedRevision === revision && entry.success.question.question.source === result.file,
+							question: entry.success.question,
+							questionFile: file(entry.success.question.id),
+							response,
+							responseFile: file(response.id),
+							supersedesFile: response.response.supersedes ? file(response.response.supersedes) : undefined,
+						}))
+					: [],
+			);
+	feedback.sort((a, b) => b.response.response.recordedAt - a.response.response.recordedAt || a.response.id.localeCompare(b.response.id));
+	return { document, feedback, feedbackUnknown, revision, targets: criteria };
+});

package/src/server/views/resultTargets.ts

@@ -0,0 +1,34 @@
+import type { Document } from "#browser/document/schema.ts";
+import type { ResultProjection } from "#browser/views/ResultProjection.ts";
+import { referenceTarget } from "#server/metadata/links.ts";
+import type { MetadataDocument } from "#server/metadata/model.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+export function resultTargets(result: MetadataDocument, data: Snapshot, document: Document): ResultProjection["targets"] {
+	const targets = new Set(result.parsed.fields.relationships?.map((entry) => entry.target));
+	if (result.parsed.fields.id) {
+		targets.add(result.parsed.fields.id);
+	}
+	function link(label: string, target: string) {
+		return { href: referenceTarget(target, data.model), label };
+	}
+	function criterionRow(id: string, entry: { readonly id: string; readonly text: string }) {
+		const reference = `${id}#${entry.id}`;
+		const claims = referenceTarget(reference, data.model)
+			? (result.parsed.fields.evidence ?? []).flatMap((claim, index) => {
+					if (claim.criterion !== reference) {
+						return [];
+					}
+					const resolved = document.reading?.evidenceSources[index];
+					return [{ ...claim, problem: resolved?.problem ?? "", source: { href: resolved?.href, label: claim.source } }];
+				})
+			: [];
+		return { claims, link: link(entry.text, reference), text: entry.text };
+	}
+	return [...targets].map((target) => {
+		const [id = "", criterion] = target.split("#");
+		const source = data.model.ids.get(id)?.[0];
+		const available = Boolean(source && referenceTarget(target, data.model));
+		const entries = available ? (source?.parsed.fields.criteria ?? []).filter((entry) => !criterion || entry.id === criterion) : [];
+		return { available, criteria: entries.map((entry) => criterionRow(id, entry)), link: link(target, target), status: source?.parsed.fields.status };
+	});
+}

package/src/server/views/state.ts

@@ -0,0 +1,12 @@
+import { fieldFilter as filter, stateOf as readState, viewUrl as urlOf, State as ViewState } from "#browser/views/state.ts";
+export const State = ViewState;
+export type State = typeof State.Type;
+export function stateOf(url: string): State {
+	return readState(url);
+}
+export function viewUrl(state: State, changes: Partial<State> = {}, hash = ""): string {
+	return urlOf(state, changes, hash);
+}
+export function fieldFilter(value: string | undefined): string {
+	return filter(value);
+}

package/src/server/views/tools.ts

@@ -0,0 +1,11 @@
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import { type State, viewUrl } from "./state.ts";
+
+export function viewTools(state: State): string {
+	const layouts = ["board", "table"] as const;
+	return `<nav class="view-layouts" aria-label="Work layout">${layouts.map((view) => `<a href="${escapeHtml(viewUrl(state, { view }, "work-results"))}"${state.view === view ? ' aria-current="page"' : ""}>${view === "board" ? "Board" : "Table"}</a>`).join("")}</nav>
+ <section id="saved-work-views" class="saved-work-views" aria-label="Saved local views" data-url="${escapeHtml(viewUrl(state, { item: "" }))}">
+ <form id="save-work-view"><label for="view-name">View name</label><input id="view-name" maxlength="60" placeholder="Name this view" required><button type="submit" disabled>Save view</button></form>
+ <div class="view-picker"><label for="saved-view">Saved views</label><select id="saved-view" disabled><option value="">No saved views</option></select><a id="open-saved-view" hidden>Open</a><button id="remove-saved-view" type="button" disabled>Remove</button><button id="clear-saved-views" type="button" disabled>Clear all</button></div>
+ <p id="saved-view-status" role="status">Save board, filters, sort, and layout locally. Item selection stays in the URL. Saving requires JavaScript.</p></section>`;
+}

package/src/server/views/workCards.ts

@@ -0,0 +1,27 @@
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import type { Item } from "./items.ts";
+import { type State, viewUrl } from "./state.ts";
+
+function card(item: Item, state: State, waiting: ReadonlyMap<string, string>): string {
+	const fields = item.document.parsed.fields;
+	const selected = item.id === state.item;
+	return `<article class="work-card" data-key="item:${escapeHtml(item.id)}" data-item="${escapeHtml(item.id)}"${selected ? ' data-selected="true"' : ""}>
+ ${waiting.has(item.id) ? `<span class="waiting-badge" title="${escapeHtml(waiting.get(item.id) ?? "")}">Waiting on you</span>` : ""}
+ <p class="work-kind">${escapeHtml(fields.kind ?? "Kind not recorded")}</p>
+ <h3><a href="${escapeHtml(viewUrl(state, { item: item.id }, "work-detail"))}"${selected ? ' aria-current="true"' : ""}>${escapeHtml(item.title)}</a></h3>
+ <p class="work-id">${escapeHtml(item.id)}</p><p class="work-owner">Owner: ${escapeHtml(fields.owner ?? "Not recorded")}</p>
+ ${fields.nextAction ? `<p class="work-next">Next: ${escapeHtml(fields.nextAction)}</p>` : ""}</article>`;
+}
+export function workCards(items: readonly Item[], state: State, waiting: ReadonlyMap<string, string> = new Map()): string {
+	if (items.length === 0) {
+		return '<p class="empty">No work matches these filters.</p>';
+	}
+	const columns = Map.groupBy(items, (item) => item.document.parsed.fields.status);
+	return `<div class="work-columns">${[...columns]
+		.map(
+			([status, rows]) => `<section class="work-column" data-key="status:${escapeHtml(status ?? "")}"
+ aria-label="${escapeHtml(status ?? "Status not recorded")}"><h2>${escapeHtml(status ?? "Status not recorded")} <span class="work-count">${rows.length}</span></h2>
+ ${rows.map((item) => card(item, state, waiting)).join("")}</section>`,
+		)
+		.join("")}</div>`;
+}

package/src/server/views/workControls.ts

@@ -0,0 +1,38 @@
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import type { Item } from "./items.ts";
+import type { Projection } from "./projection.ts";
+import { fieldFilter, type State, viewUrl } from "./state.ts";
+
+function option(value: string, title: string, current: string): string {
+	return `<option value="${escapeHtml(value)}"${value === current ? " selected" : ""}>${escapeHtml(title)}</option>`;
+}
+function fieldOptions(items: readonly Item[], field: "owner" | "status", current: string): string {
+	const values = new Map(
+		items.map((item) => {
+			const value = item.document.parsed.fields[field];
+			return [fieldFilter(value), value ?? `${field === "owner" ? "Owner" : "Status"} not recorded`];
+		}),
+	);
+	if (current && !values.has(current)) {
+		values.set(current, `${current.startsWith("value:") ? current.slice(6) : current} (no current matches)`);
+	}
+	return (
+		option("", `All ${field === "owner" ? "owners" : "statuses"}`, current)
+		+ [...values]
+			.sort((a, b) => a[1].localeCompare(b[1], "en"))
+			.map(([value, label]) => option(value, label, current))
+			.join("")
+	);
+}
+export function workControls(projection: Projection, state: State): string {
+	const boards = option("", "All work", state.board) + projection.boards.map((board) => option(board.id, board.title, state.board)).join("");
+	const unavailable = state.board && !projection.validBoard ? option(state.board, `${state.board} (unavailable)`, state.board) : "";
+	return `<form id="work-filters" class="work-filters" action="/_board/work#work-results" method="get">
+ <input type="hidden" name="view" value="${state.view}"><input type="hidden" name="item" value="${escapeHtml(state.item)}">
+ <label><span>Board</span><select name="board" id="work-board">${boards}${unavailable}</select></label>
+ <label><span>Status</span><select name="status" id="work-status">${fieldOptions(projection.items, "status", state.status)}</select></label>
+ <label><span>Owner</span><select name="owner" id="work-owner">${fieldOptions(projection.items, "owner", state.owner)}</select></label>
+ <label><span>Find work</span><input name="q" id="work-query" type="search" value="${escapeHtml(state.query)}" maxlength="200"></label>
+ <label><span>Sort by</span><select name="sort" id="work-sort">${["title", "owner", "status"].map((sort) => option(sort, sort.charAt(0).toUpperCase() + sort.slice(1), state.sort)).join("")}</select></label>
+ <button type="submit">Apply</button><a href="${escapeHtml(viewUrl(state, { owner: "", query: "", status: "" }, "work-results"))}">Clear filters</a></form>`;
+}

package/src/server/views/workDetail.ts

@@ -0,0 +1,28 @@
+import { Effect } from "effect";
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import { documentHeadings } from "#render/documentHeadings.ts";
+import { identityUrl } from "#server/metadata/links.ts";
+import { metadataHtml } from "#server/page/metadata.ts";
+import { renderMarkdown } from "#server/render/markdown.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+import type { Projection } from "./projection.ts";
+import { type State, viewUrl } from "./state.ts";
+
+export const workDetail = Effect.fn("WorkBoard.workDetail")(function* (projection: Projection, state: State, snapshot: Snapshot) {
+	if (!state.item) {
+		return "";
+	}
+	const close = `<a class="detail-close" href="${escapeHtml(viewUrl(state, { item: "" }, "work-results"))}">Close detail</a>`;
+	const selected = projection.selected;
+	if (!selected) {
+		const ambiguous = (snapshot.model.ids.get(state.item)?.length ?? 0) > 1;
+		return `<aside id="work-detail" class="work-detail" tabindex="-1" aria-label="Selected work">${close}<h2>Item unavailable</h2><p>${escapeHtml(state.item)} ${ambiguous ? "has a duplicate ID" : "is missing or its identity changed"}. No source was selected.</p><a href="${escapeHtml(identityUrl(state.item))}">Inspect item identity</a></aside>`;
+	}
+	const { document } = selected;
+	const prose = yield* renderMarkdown(document.parsed.body, { file: document.file, headings: documentHeadings() });
+	return `<aside id="work-detail" class="work-detail" data-key="detail:${escapeHtml(selected.id)}" tabindex="-1" aria-label="Selected work">
+ <header>${close}<a href="${escapeHtml(identityUrl(selected.id))}">Open document</a></header>
+ ${projection.selectedOutside ? '<p class="detail-notice" role="status">This selected item is outside the current board or filters.</p>' : ""}
+ <p class="meta">Source: ${escapeHtml(document.file)}</p>${metadataHtml(document.parsed, document.file, snapshot.model)}
+ <article class="doc">${prose}</article></aside>`;
+});

package/src/server/views/workHtml.ts

@@ -0,0 +1,45 @@
+import { Effect } from "effect";
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import { inboxItems } from "#server/attention/inbox.ts";
+import { identityUrl } from "#server/metadata/links.ts";
+import type { Snapshot } from "#server/search/snapshot.ts";
+import { projectItems } from "./projection.ts";
+import type { State } from "./state.ts";
+import { viewTools } from "./tools.ts";
+import { workCards } from "./workCards.ts";
+import { workControls } from "./workControls.ts";
+import { workDetail } from "./workDetail.ts";
+import { workTable } from "./workTable.ts";
+
+export const workHtml = Effect.fn("WorkBoard.workHtml")(function* (snapshot: Snapshot, state: State) {
+	const projection = projectItems(snapshot, state);
+	const waiting = new Map(
+		inboxItems(snapshot)
+			.filter((item) => !item.problem)
+			.map((item) => [item.id, item.reason]),
+	);
+	const controls = workControls(projection, state);
+	const tools = viewTools(state);
+	if (!projection.validBoard) {
+		return {
+			html: `<h1>Board unavailable</h1>${tools}${controls}<p class="empty">${escapeHtml(state.board)} is missing, has a duplicate ID, or is not a declared board. Choose another board or open its <a href="${escapeHtml(identityUrl(state.board))}">source identity</a>.</p>`,
+			status: 404,
+		};
+	}
+	const issues =
+		projection.issues.length > 0
+			? `<details class="view-issues"><summary>Source issues (${projection.issues.length})</summary><ul>${projection.issues.map((issue) => `<li>${escapeHtml(issue)}</li>`).join("")}</ul></details>`
+			: "";
+	const source = state.board ? `<a href="${escapeHtml(identityUrl(state.board))}">Board source</a>` : "";
+	const empty =
+		projection.items.length === 0
+			? '<p class="empty">No identified work is declared here. Keep reading ordinary files, or add item IDs and explicit board membership in their Markdown sources.</p>'
+			: "";
+	const detail = yield* workDetail(projection, state, snapshot);
+	return {
+		html: `<header class="work-head"><p class="work-eyebrow">WORK · ${state.view.toUpperCase()} VIEW</p><h1>${escapeHtml(projection.title)}</h1><p>Views use recorded fields. A section heading does not set an item's status.</p>${source}</header>
+ ${tools}${controls}${issues}<p class="work-total" role="status">${projection.rows.length} shown · ${projection.items.length} items in this view</p>
+ <div class="work-layout${state.item ? " has-detail" : ""}"><section id="work-results" tabindex="-1" aria-label="Work items">${empty}${state.view === "table" ? workTable(projection.rows, state, waiting) : workCards(projection.rows, state, waiting)}</section>${detail}</div>`,
+		status: 200,
+	};
+});

package/src/server/views/workStyle.ts

@@ -0,0 +1,18 @@
+export function workStyle(): string {
+	return `
+.work-head h1{margin:0 0 8px}.work-eyebrow{font:11px var(--mono);letter-spacing:.12em;color:var(--muted);margin:0 0 12px}.work-head>p:not(.work-eyebrow){color:var(--muted);font-size:.9rem;margin:0 0 12px}
+.work-filters{display:flex;flex-wrap:wrap;gap:12px;align-items:end;margin:24px 0 16px;padding:16px;border:1px solid var(--border);border-radius:10px;background:var(--surface)}
+.work-filters label{display:grid;gap:5px;font-size:12px;color:var(--muted);flex:1 1 130px;min-width:0}.work-filters input,.work-filters select{width:100%;min-width:0;font:inherit;font-size:14px;color:var(--text);background:var(--card);border:1px solid var(--border);border-radius:5px;padding:8px}
+.work-filters button{font:inherit;color:var(--text);background:var(--card);border:1px solid var(--border);border-radius:5px;padding:8px 12px}.work-filters>a{font-size:13px;padding:8px 0}.work-total{font-size:13px;color:var(--muted);margin:0 0 20px}
+.work-layout{display:grid;grid-template-columns:minmax(0,1fr);gap:24px;align-items:start}.work-layout.has-detail{grid-template-columns:minmax(0,1fr) minmax(300px,420px)}
+.work-columns{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,220px),1fr));gap:16px}.work-column{min-width:0}.work-column>h2{display:flex;justify-content:space-between;gap:12px;margin:0 0 12px;font-size:14px;overflow-wrap:anywhere}.work-count{font:12px var(--mono);color:var(--muted)}
+.work-card{padding:var(--card-space);margin-bottom:12px;border:1px solid var(--border);border-radius:10px;background:var(--card);overflow-wrap:anywhere}.work-card[data-selected="true"]{border-color:var(--link);box-shadow:0 0 0 1px var(--link)}.work-card h3{font-size:1rem;margin:6px 0}.work-card h3 a{text-decoration:none}.work-kind{font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted);margin:0}.work-id{font:11px var(--mono);color:var(--muted);margin:0 0 12px}.work-owner,.work-next{font-size:13px;margin:0 0 8px}.work-card>:last-child{margin-bottom:0}
+.work-detail .document-layout{display:flex;flex-direction:column;gap:16px}.work-detail .item-context{align-self:stretch}
+.work-detail{position:sticky;top:24px;max-height:calc(100vh - 48px);overflow:auto;min-width:0;padding:20px;border:1px solid var(--border);border-radius:12px;background:var(--card);scroll-margin-top:20px}.work-detail>header{display:flex;justify-content:space-between;gap:16px;font-size:13px;margin:0 0 16px}.work-detail .work-meta{padding:12px;font-size:13px}.work-detail .doc{font-size:.9rem}.work-detail .doc h1{font-size:1.5rem}.detail-notice{padding:10px;background:var(--surface);font-size:13px}.view-issues{margin:0 0 16px;padding:12px;background:var(--surface);border-radius:8px;font-size:13px;overflow-wrap:anywhere}
+.work-open{font-size:13px;white-space:nowrap}.work-open[aria-current="page"]{font-weight:700;text-decoration:underline}#work-results{scroll-margin-top:20px}
+.view-layouts{display:flex;gap:6px;margin:20px 0 12px}.view-layouts a{padding:5px 14px;border:1px solid var(--border);border-radius:6px;text-decoration:none;font-size:13px}.view-layouts a[aria-current="page"]{background:var(--surface);font-weight:600}
+.saved-work-views{display:flex;flex-wrap:wrap;gap:12px 24px;align-items:center;font-size:12px}.saved-work-views form,.view-picker{display:flex;align-items:center;flex-wrap:wrap;gap:8px;min-width:0}.saved-work-views input,.saved-work-views select{min-width:0;max-width:100%;padding:6px 10px;font:inherit;border:1px solid var(--border);border-radius:6px;background:var(--card);color:var(--text)}.saved-work-views>p{flex-basis:100%;margin:0;color:var(--muted)}
+.work-table-wrap{max-width:100%;overflow:auto}.work-table{display:table;width:100%;margin:0;font-size:13px;background:var(--card)}.work-table th,.work-table td{padding:calc(var(--card-space)/2);overflow-wrap:anywhere;min-width:100px}.work-table th{font-weight:500}.work-table tbody th{min-width:160px}.work-table .work-id{display:block;margin:6px 0 0}.work-table tr[data-selected="true"]>*{background:var(--surface);box-shadow:inset 0 -2px var(--link)}
+@media(max-width:1000px){.work-layout.has-detail{grid-template-columns:minmax(0,1fr)}.work-detail{position:static;max-height:none;grid-row:1}.work-filters{padding:12px;gap:10px}}
+`;
+}

package/src/server/views/workTable.ts

@@ -0,0 +1,26 @@
+import { escapeHtml } from "#browser/escapeHtml.ts";
+import type { Item } from "./items.ts";
+import { type State, viewUrl } from "./state.ts";
+
+function row(item: Item, state: State, waiting: ReadonlyMap<string, string>): string {
+	const fields = item.document.parsed.fields;
+	const selected = item.id === state.item;
+	const values = [
+		fields.kind,
+		waiting.has(item.id) ? `Waiting on you · ${fields.status ?? "Status not recorded"}` : fields.status,
+		fields.owner,
+		fields.nextAction,
+	];
+	return `<tr data-item="${escapeHtml(item.id)}"${selected ? ' data-selected="true"' : ""}>
+ <th scope="row"><a href="${escapeHtml(viewUrl(state, { item: item.id }, "work-detail"))}"${selected ? ' aria-current="true"' : ""}>${escapeHtml(item.title)}</a><span class="work-id">${escapeHtml(item.id)}</span></th>
+ ${values.map((value) => `<td>${escapeHtml(value ?? "Not recorded")}</td>`).join("")}</tr>`;
+}
+
+export function workTable(items: readonly Item[], state: State, waiting: ReadonlyMap<string, string> = new Map()): string {
+	if (items.length === 0) {
+		return '<p class="empty">No work matches these filters.</p>';
+	}
+	return `<div class="work-table-wrap"><table class="work-table"><caption class="sr-only">Identified work, sorted by ${escapeHtml(state.sort)}</caption>
+ <thead><tr>${["Work", "Kind", "Status", "Owner", "Next action"].map((title) => `<th scope="col">${title}</th>`).join("")}</tr></thead>
+ <tbody>${items.map((item) => row(item, state, waiting)).join("")}</tbody></table></div>`;
+}

package/dist/attention/overviewHtml.d.ts

@@ -1,3 +0,0 @@
-import type { Snapshot } from "#search/snapshot.ts";
-export declare function overviewHtml(snapshot: Snapshot): string;
-//# sourceMappingURL=overviewHtml.d.ts.map

package/dist/attention/overviewHtml.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"overviewHtml.d.ts","sourceRoot":"","sources":["../../src/attention/overviewHtml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA4BvD"}

package/dist/attention/overviewHtml.js

@@ -1,41 +0,0 @@
-import { fileUrl } from "#files/url.ts";
-import { escapeHtml } from "#page/escape.ts";
-import { referenceHtml } from "#page/metadataLinks.ts";
-import { attentionRequests } from "./requests.js";
-function card(entry, snapshot) {
-    const { request } = entry;
-    return `<article class="attention-card" data-key="attention:${escapeHtml(entry.itemId)}:${escapeHtml(request.id)}" data-attention-item="${escapeHtml(entry.itemId)}" data-request="${escapeHtml(request.id)}">
-<p class="work-kind">${escapeHtml(request.kind)} request</p><h3><a href="${escapeHtml(entry.href)}">${escapeHtml(entry.title)}</a></h3>
-<p class="work-id">${escapeHtml(entry.itemId)} / ${escapeHtml(request.id)}</p><p class="attention-reason">${escapeHtml(request.reason)}</p>
-<dl><dt>Response needed from</dt><dd>${request.responseFrom.map(escapeHtml).join(", ")}</dd><dt>Recorded to unblock</dt><dd>${request.unblocks.map((target) => referenceHtml(target, target, snapshot.model)).join(", ")}</dd></dl>
-<a class="attention-source" href="${escapeHtml(fileUrl(entry.document.file))}#attention-request-${encodeURIComponent(request.id)}">Source: ${escapeHtml(entry.document.file)}:${entry.line}</a></article>`;
-}
-export function overviewHtml(snapshot) {
-    const projection = attentionRequests(snapshot);
-    const header = '<header class="work-head"><p class="work-eyebrow">WORKSPACE · OVERVIEW</p><h1>What needs a response?</h1><p>Choose a recorded request to read its context, reasoning and evidence.</p><a href="/_board/work?view=board">Browse all work</a></header>';
-    const issues = projection.issues.length > 0
-        ? `<details class="view-issues" data-key="attention-issues"><summary>Unclassified requests and source issues (${projection.issues.length})</summary><p>Ambiguous or invalid requests stay outside the queues. Read their original sources.</p><ul>${projection.issues.map((issue) => `<li><a href="${escapeHtml(fileUrl(issue.file))}">${escapeHtml(issue.file)}:${issue.line}</a> — ${escapeHtml(issue.message)}</li>`).join("")}</ul></details>`
-        : "";
-    if (!projection.complete) {
-        return `${header}<p class="attention-incomplete" role="status">Workspace incomplete. Could not read ${snapshot.unavailable.map(escapeHtml).join(", ")}. Requests are not counted or classified until the index is complete.</p>${issues}`;
-    }
-    let summary = "All quiet — no explicit open requests recorded.";
-    if (projection.entries.length > 0) {
-        summary = `${projection.entries.length} validated open request${projection.entries.length === 1 ? "" : "s"}`;
-    }
-    else if (projection.issues.length > 0) {
-        summary = "No validated open requests. Check unresolved source issues before treating this workspace as quiet.";
-    }
-    const groups = [
-        { empty: "No open decision requests.", kind: "decision", title: "Decisions" },
-        { empty: "No open review requests.", kind: "review", title: "Reviews" },
-        { empty: "No open blocker requests.", kind: "blocker", title: "Blockers" },
-    ]
-        .map((group) => {
-        const entries = projection.entries.filter((entry) => entry.request.kind === group.kind);
-        return `<section class="attention-group" aria-labelledby="attention-${group.kind}"><h2 id="attention-${group.kind}" tabindex="-1">${group.title}<span>${entries.length}</span></h2>${entries.length > 0 ? entries.map((entry) => card(entry, snapshot)).join("") : `<p class="empty">${group.empty}</p>`}</section>`;
-    })
-        .join("");
-    return `${header}<p class="attention-total" role="status">${summary}</p><p class="attention-order">Decisions, reviews, then blockers. Within each group: source title, item ID, request ID. Recipients are recorded labels.</p>${issues}<div class="attention-groups">${groups}</div><p class="attention-footnote">These are authored requests. Closing one does not verify evidence or record an answer. Status, owner, file activity and finished runs do not create requests.</p>`;
-}
-//# sourceMappingURL=overviewHtml.js.map

package/dist/attention/overviewHtml.js.map

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

package/dist/attention/requests.d.ts

@@ -1,24 +0,0 @@
-import type { MetadataDocument } from "#metadata/model.ts";
-import type { Metadata } from "#metadata/schema.ts";
-import type { Snapshot } from "#search/snapshot.ts";
-export type Request = NonNullable<Metadata["attention"]>[number];
-export interface AttentionEntry {
-    readonly document: MetadataDocument;
-    readonly href: string;
-    readonly itemId: string;
-    readonly line: number;
-    readonly request: Request;
-    readonly title: string;
-}
-export interface SourceIssue {
-    readonly file: string;
-    readonly line: number;
-    readonly message: string;
-}
-export declare function attentionRequests(snapshot: Snapshot): {
-    complete: boolean;
-    entries: AttentionEntry[];
-    issues: SourceIssue[];
-};
-export declare function attentionSource(document: MetadataDocument, index: number): string;
-//# sourceMappingURL=requests.d.ts.map

package/dist/attention/requests.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/attention/requests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AA8BD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ;;;;EASnD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjF"}