@shivaedev/work-board 0.13.0 → 0.14.0

package/docs/north-star.md

@@ -2,7 +2,9 @@
 
 Work Board is a local, file-backed workspace for a person and their agents to understand work and exchange direction. Open it to know what is happening, what changed, what needs judgment, and where the evidence lives. Close it without losing the work: the meaningful content remains readable in project files.
 
-The [roadmap](roadmap.md) owns implementation status, acceptance gaps and open maintainer decisions. The [README](../README.md) teaches current use. The [experience design](experience.md) and [interactive prototype](mockups/index.html) illustrate the product direction with fictional data. The [delivery requirements](delivery/README.md) define bounded steps and how to verify them, without keeping a second status list.
+The [roadmap](roadmap.md) owns implementation status, acceptance gaps and open maintainer decisions. The [README](../README.md) teaches current use. The [delivery requirements](delivery/README.md) define bounded steps and how to verify them, without keeping a second status list.
+
+Today is the first screen. It puts the human’s live asks and answers beside compact goal progress. In progress names the work Fleet holds, its stage and its recorded PR; the preview stays short and links to Now for the full view. Goal cards show the next action in at most two lines and done work against all linked work, with criteria and evidence behind a closed disclosure. Goals shows active goals, Now shows current work, Library finds documents and recently changed files, and System shows provider limits and names the running or waiting Fleet work with stage and PR. Configured home Markdown remains reachable as Workspace notes. Narrow screens read summary, human asks, in-progress work and goals in order; wide screens put goals beside the asks and in-progress work.
 
 ## The problem
 
@@ -20,6 +22,8 @@ A handoff preserves reviewed direction in another readable file. A copied pointe
 
 Returned work needs the same discipline. An authored result and its evidence are claims to inspect. Human direction belongs to the exact report bytes and source path that prompted it; a later edit must not inherit an earlier acceptance. A report iteration can receive human acceptance while a criterion still lacks evidence. The board must keep those facts visible rather than compute a convenient overall success state.
 
+Goal progress shows the goals query's done, in progress and planned counts and its goal-specific open-ask count, including zero. Fleet-held stages override authored status for both goal and criterion counts; released stages fall back to authored status. Deferred and unrecorded work contribute to planned progress. Open asks use the attention projection's eligible active rows, including its grouping and resolved or parked exclusions. Criteria show their progress split with linked work and recorded evidence. Untargeted criteria keep their text without an extra label, and missing evidence stays quiet. Closed projects retain the same goal and criterion counts while staying outside active-goal navigation. Lifecycle completion never establishes criterion acceptance. The goal page puts progress immediately below the item header, before open answer cards. Criteria, linked work and authored prose follow, with an outline rail for reading. Each implementing item appears once under a nonempty In progress, Planned, Done (collapsed) or Deferred group with one state chip and its recorded PR. The chip shows the held Fleet stage or the authored status; missing status and PR stay blank. Progress is never a computed overall success state or completion percentage.
+
 ## What good looks like
 
 - **Readable source.** A folder and one command are enough to begin. Plain Markdown remains useful; metadata is optional; no hidden database holds the only meaningful copy of work.

package/docs/roadmap.md

@@ -4,41 +4,19 @@ The [north star](north-star.md) defines the product direction. This file owns pa
 
 ## Built
 
-The reading, response, handoff and result-review implementation has these capabilities. Each row links the delivery requirement and the regressions that establish its behavior.
+The Board has five views: Today, Goals, Now, Library and System. Today puts human asks, Fleet work in progress and goal progress on one screen. Goals shows compact active-goal progress cards, linked criterion progress and a collapsed closed-goals section; Now shows work in board or table form; Library finds titled documents by kind, status, folders or Recently changed. System at `/_board/system` shows Codex and GitHub limits, Fleet health and every running or waiting Fleet item by title, stage and PR. `src/client/react/TodayPage.dom.test.tsx`, `TodayProgress.dom.test.tsx`, `GoalsPage.dom.test.tsx`, `sidebarLibrary.dom.spec.tsx`, `WorkNow.dom.test.tsx` and `SystemPage.dom.test.tsx` cover these projections. `src/server/http/retiredRoutes.spec.ts` and `src/client/react/retiredRoutes.dom.spec.tsx` cover destination compatibility.
 
-| Steps | Capability | Evidence |
-| --- | --- | --- |
-| [01](delivery/wave1.md#01-a-real-workspace-shell) | Workspace shell, theme/density/sidebar preferences | `src/server/page/shell.test.ts`, `src/client/page/preferences.dom.spec.ts`, `src/client/page/sidebar.dom.spec.ts` |
-| [02](delivery/wave1.md#02-document-locations-and-reading-state) | Passage links, reading navigation, favorites and recents | `src/render/documentHeadings.test.ts`, `src/client/page/navigation.dom.spec.ts` |
-| [03](delivery/wave1.md#03-find-work-from-anywhere) | Local deterministic search and command dialog | `src/server/search/entries.test.ts`, `src/server/http/search.spec.ts`, `src/server/page/searchRequests.dom.spec.ts` |
-| [04](delivery/wave1.md#04-optional-identity-and-a-rebuildable-index) | Optional identity, metadata and rebuildable reference index | `src/server/metadata/parse.test.ts`, `src/server/metadata/model.test.ts`, `src/server/http/identity.test.ts` |
-| [05](delivery/wave1.md#05-one-body-of-work-several-views) | Shared board/table projections, URL state and named local views | `src/server/http/work.test.ts`, `src/server/http/tableViews.spec.ts`, `src/server/page/savedViews.dom.spec.ts` |
-| [06](delivery/wave1.md#06-follow-the-reasoning-and-the-evidence) | Relationships, source backlinks and recorded criterion claims | `src/server/http/reasoning.spec.ts`, `src/server/page/reasoning.dom.spec.ts` |
-| [07](delivery/wave1.md#07-an-attention-first-overview), implementation only | Explicit attention queues and source diagnostics | `src/server/metadata/attention.spec.ts`, `src/server/http/attention.spec.ts`, `src/server/page/attention.dom.spec.ts`; reader acceptance remains below |
-| Human Inbox | Human-owned actions, standalone questions, Fleet waiting work, option/text responses, live count and grouped Fleet records | `src/server/attention/inbox.test.ts`, `src/server/http/inbox.test.ts`, `src/server/responses/inboxQuestion.dom.spec.ts` |
-| [08](delivery/wave1.md#08-what-changed-since-i-last-looked) | Explicit browser-local seen baseline and source comparison | `src/server/history/baseline.test.ts`, `src/server/history/compare.test.ts`, `src/server/history/history.dom.spec.ts` |
-| [09](delivery/wave1.md#09-live-updates-that-preserve-orientation) | Native reads, targeted invalidation, pause/resume and reconciliation | `src/server/rpc/native.spec.ts`, `src/server/rpc/affected.test.ts`, `src/server/rpc/hints.test.ts`, `src/server/page/nativeUpdates.dom.spec.ts` |
-| [10](delivery/wave1.md#10-local-visual-evidence) | Contained local images and diagram/image inspection | `src/server/http/localImages.spec.ts`, `src/server/page/visuals.dom.spec.ts` |
-| [11](delivery/wave1.md#11-a-small-vocabulary-for-visual-documents) | Sourced metric/progress/timeline directives and callouts | `src/render/visualReading.spec.ts` |
-| [12](delivery/wave1.md#12-start-with-useful-project-documents) | Empty-workspace guidance and copyable project/report templates | `src/server/http/startReading.spec.ts`, `src/client/page/navigation.dom.spec.ts` |
-| [14–15](delivery/wave2.md#14-prove-one-safe-source-mutation) | Opted-in immutable question/response publication, drafts and durable waits | `src/server/responses/response.spec.ts`, `src/server/responses/publicationFlow.spec.ts`, `src/server/responses/agentWait.spec.ts`, `src/client/react/answerDrafts.dom.spec.tsx` |
-| [16](delivery/wave2.md#16-record-a-decision-and-its-consequence) | Rich question packets and explicit superseding direction | `src/server/responses/template.test.ts`, `src/server/responses/questionnaire.spec.ts`, `src/server/responses/questionnaireForm.dom.spec.ts` |
-| [18](delivery/wave2.md#18-one-local-agent-handoff) | Reviewed Markdown handoffs, copied prompts and ordinary file-edited receipt | `src/server/handoffs/handoff.spec.ts`, `src/server/handoffs/handoffForm.dom.spec.ts` |
-| [19](delivery/wave2.md#19-review-a-returned-result-against-its-criteria) | Returned-result reading and version-pinned feedback without inferred criterion acceptance | `src/server/results/result.spec.ts` |
-
-Directory reference reading and watcher recovery are covered by `src/server/http/symlinks.spec.ts` and `src/server/liveUpdates.spec.ts`. Fetch-handler and real HTTP embedding are covered by `src/server/board.test.ts` and `src/server/embedding.spec.ts`. The packed-consumer gate checks the CLI and embedding declarations.
-
-Nested sidebar ancestry, home ordering, logical reference paths and folder expansion through live changes and navigation are covered by `src/server/page/nav.dom.test.ts`. Exact-context managed decision acknowledgements are covered by Work Fleet's `src/board/managedRequestReceipt.spec.ts` and `src/board/acknowledgementHttp.spec.ts`; those receipts leave source bytes intact and do not establish execution, acceptance or delivery authority.
-
-The sidebar Diagnostics view reads Codex usage windows, cached GitHub REST/GraphQL limits and Fleet health from the daemon's native HTTP RPC API. Synthetic source, command and app-server fixtures cover ready, missing, failing and malformed states, shared caching and refused provider approvals in `src/diagnostics/source.test.ts`, `readers.spec.ts` and `codexRateLimits.test.ts`. Real HTTP fixtures cover daemon responses, stopped-daemon recovery, ignored health files and stale observation times in `src/server/diagnostics/diagnosticsRpc.spec.ts`; `rendering.spec.ts` and `liveRefresh.dom.spec.ts` cover typed query rendering, navigation and native polling/pause/resume. These fixtures do not establish live account authorization.
-
-Response and handoff forms are React components on `effect-react`’s `useCreate` and `effect-form`’s Schema decoding, field messages and persisted drafts, in the shell’s shared native registry. `src/client/react/formRefresh.dom.spec.tsx` proves that free-text responses, questionnaire answers and handoffs retain draft text, source-change notices and caret selection through a query refresh and reload. The form regressions above preserve reviewed context and edits made during submission. `src/client/effectForms.dom.spec.ts` exercises Schema feedback, response edits during a save, and form restoration after persisted pageshow in DOM/HTTP fixtures.
-
-The Board opens as a React shell with TanStack Router and `effect-react` query loaders in the shared native registry. The sidebar reads the native navigation query through `effect-react`; Document and item pages read the typed document query and mount `DocumentView`. The configured home board, Work board/table and selected detail, Overview and Inbox render typed projection queries in React. Changes, Diagnostics, Start, Respond, Handoff and Result render typed queries in React; the HTML page query and its host are removed. The shell and hosted pages share the native atom registry and live connection. The server retains the existing document, Work, Overview and Inbox layout as a no-JavaScript fallback; the remaining views require JavaScript. `src/server/page/shell.test.ts` checks its page and navigation content. `src/client/react/boardRouter.dom.test.tsx` renders a fixture tree, changes the main area through the router without replacing the shell, renders document tools and retains response text and caret through a document-query refresh. `src/client/react/documents.dom.spec.tsx` checks file and identity URLs, heading anchors, context links and initial read failures without requesting page HTML. `src/client/react/routeLoading.dom.spec.tsx` checks preloaded document, identity, failed-read, home-board and workspace URLs sharing one query execution with navigation, the displayed document staying mounted during a pending loader, and search-parameter changes loading their own projection query. `src/client/react/projections.dom.spec.tsx` checks each moved view without a page HTML query and retains inline answer text through a Work refresh. `src/client/react/remainingViews.dom.spec.tsx` checks all six remaining views without an HTML query, empty-root onboarding and response draft/caret retention through a refresh. The shell renders sidebar controls, search, reading preferences, favorites and recents in React; reading navigation, live status, saved views, visual inspection and age ticking share that client. The string-script browser runtime and its asset routes are removed. `src/client/react/chrome.dom.spec.tsx` proves search results, saved appearance, favorites, recents, per-entry reading details and sidebar ancestry through native query refreshes and reloads. `src/client/react/Age.dom.test.tsx` proves the mounted age ticker and refreshed timestamps. The DOM/HTTP regressions exercise the built shell, live invalidation, pause/resume, reading history and form drafts. These fixtures do not measure browser layout or establish physical-device or page-cache adoption. `src/server/board.test.ts` and the packed CLI fixture check the shell and asset delivery; `src/client/react/queryRendering.dom.spec.tsx` renders a search query through shared RPC handlers and the published `effect-react/testing.ts` helpers.
+The React shell uses TanStack Router and `effect-react` query loaders in one native registry and live connection. Document and identity routes mount `DocumentView` from typed source queries. Tailwind and shared primitives style Start, Handoff, Result and System. `src/server/serverStyles.spec.ts` guards against server CSS strings; route tests check shell delivery. `src/client/react/boardRouter.dom.test.tsx`, `documents.dom.spec.tsx`, `routeLoading.dom.spec.tsx`, `documentNavigation.dom.spec.tsx` and `projections.dom.spec.tsx` cover query sharing, navigation, loading failures and retained edits. `src/client/react/remainingViews.dom.spec.tsx` covers Start, Handoff, Result and System. Sidebar destinations, pins, recents, goal counts and lazy Library folders are covered by `src/client/react/sidebarLibrary.dom.spec.tsx`.
+
+System reads provider observations from the daemon's native HTTP RPC API. `src/server/diagnostics/diagnosticsRpc.spec.ts`, `rendering.spec.ts` and `liveRefresh.dom.spec.ts` cover ready, missing, malformed, stale and unavailable sources, caching, polling and pause/resume. `src/client/react/SystemPage.dom.test.tsx` distinguishes loading, unavailable and empty Fleet item data from named running and waiting work. Synthetic fixtures do not establish live account authorization.
+
+Human responses, reviewed handoffs and returned-result feedback retain source context and explicit uncertainty. `src/server/responses/response.spec.ts`, `publicationFlow.spec.ts`, `agentWait.spec.ts`, `src/server/handoffs/handoff.spec.ts` and `src/server/results/result.spec.ts` cover publication, waits, receipts and revision-pinned feedback. `src/client/react/formRefresh.dom.spec.tsx` and `src/client/effectForms.dom.spec.ts` cover persisted drafts, source changes and edits during submission. Managed decision acknowledgements are covered by Work Fleet's `src/board/managedRequestReceipt.spec.ts` and `acknowledgementHttp.spec.ts`. Acknowledgement does not establish execution or acceptance.
+
+Source indexing, search, local images, source relationships and file watching retain their native query and rendering paths. `src/server/search/`, `src/server/metadata/`, `src/render/`, `src/server/http/symlinks.spec.ts` and `src/server/liveUpdates.spec.ts` cover those behaviors. `src/server/board.test.ts`, `embedding.spec.ts` and the packed-consumer gate check shell, CLI and embedding delivery. DOM fixtures prove their asserted interactions; they do not establish physical-device or browser page-cache adoption.
 
 ## Next
 
-- [ ] Finish [07's representative-reader acceptance](delivery/wave1.md#07-an-attention-first-overview). The proposed target is finding the actual next judgment within 30 seconds. Automated queues and browser fixtures do not establish that outcome.
+- [ ] Finish representative-reader acceptance for Today. The proposed target is finding the actual next judgment within 30 seconds. Automated queues and browser fixtures do not establish that outcome.
 - [ ] Finish [13's complete reading-workflow review](delivery/wave1.md#13-prove-the-complete-reading-workflow). Use the [repeatable reading review](delivery/reading-review.md), agree performance budgets, and gather representative-reader, physical-device and actual browser page-cache lifecycle evidence. Technical reading and embedding checks do not silently accept this step.
 - [ ] Prove [20's complete coordination loop](delivery/wave2.md#20-complete-the-first-coordination-loop). Use one bounded real feature for decision, manual handoff, receipt, result, revision and specific-report acceptance. Include restarts, unavailable delivery and ordinary external edits. Result fixtures do not establish that adoption loop.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/work-board",
-  "version": "0.13.0",
+  "version": "0.14.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": {
@@ -78,6 +78,7 @@
     },
     "./package.json": "./package.json",
     "./browser/react/*": null,
+    "./browser/views/now.ts": null,
     "./browser/entry.ts": null,
     "./browser/fieldFeedback.ts": null,
     "./browser/reconcile/*": null,
@@ -123,6 +124,8 @@
       "import": "./dist/attention/RequestReceipt.js",
       "default": "./dist/attention/RequestReceipt.js"
     },
+    "./attention/requestInbox.ts": null,
+    "./attention/status.ts": null,
     "./diagnostics/*.ts": {
       "types": "./dist/server/diagnostics/*.d.ts",
       "source": "./src/server/diagnostics/*.ts",
@@ -135,6 +138,12 @@
       "import": "./dist/diagnostics/daemonContract.js",
       "default": "./dist/diagnostics/daemonContract.js"
     },
+    "./diagnostics/fleetItems.ts": {
+      "types": "./dist/diagnostics/fleetItems.d.ts",
+      "source": "./src/diagnostics/fleetItems.ts",
+      "import": "./dist/diagnostics/fleetItems.js",
+      "default": "./dist/diagnostics/fleetItems.js"
+    },
     "./diagnostics/health.ts": {
       "types": "./dist/diagnostics/health.d.ts",
       "source": "./src/diagnostics/health.ts",
@@ -177,18 +186,6 @@
       "import": "./dist/server/handoffs/*.js",
       "default": "./dist/server/handoffs/*.js"
     },
-    "./history/*.ts": {
-      "types": "./dist/server/history/*.d.ts",
-      "source": "./src/server/history/*.ts",
-      "import": "./dist/server/history/*.js",
-      "default": "./dist/server/history/*.js"
-    },
-    "./history/schema.ts": {
-      "types": "./dist/history/schema.d.ts",
-      "source": "./src/history/schema.ts",
-      "import": "./dist/history/schema.js",
-      "default": "./dist/history/schema.js"
-    },
     "./http/*.ts": {
       "types": "./dist/server/http/*.d.ts",
       "source": "./src/server/http/*.ts",
@@ -249,6 +246,12 @@
       "import": "./dist/server/rpc/*.js",
       "default": "./dist/server/rpc/*.js"
     },
+    "./rpc/Server.ts": {
+      "types": "./dist/rpc/Server.d.ts",
+      "source": "./src/rpc/Server.ts",
+      "import": "./dist/rpc/Server.js",
+      "default": "./dist/rpc/Server.js"
+    },
     "./rpc/pageKeys.ts": {
       "types": "./dist/rpc/pageKeys.d.ts",
       "source": "./src/rpc/pageKeys.ts",
@@ -310,16 +313,10 @@
       "default": "./dist/browser/document/schema.js"
     },
     "./browser/navigation/schema.ts": {
-      "types": "./dist/browser/navigation/schema.d.ts",
-      "source": "./src/browser/navigation/schema.ts",
-      "import": "./dist/browser/navigation/schema.js",
-      "default": "./dist/browser/navigation/schema.js"
-    },
-    "./browser/navigation/html.ts": {
-      "types": "./dist/browser/navigation/html.d.ts",
-      "source": "./src/browser/navigation/html.ts",
-      "import": "./dist/browser/navigation/html.js",
-      "default": "./dist/browser/navigation/html.js"
+      "types": "./dist/browser/Navigation.d.ts",
+      "source": "./src/browser/Navigation.ts",
+      "import": "./dist/browser/Navigation.js",
+      "default": "./dist/browser/Navigation.js"
     },
     "./serve-cli.ts": {
       "types": "./dist/server/serve-cli.d.ts",
@@ -383,20 +380,9 @@
     },
     "./rpc/server.ts": null,
     "./rpc/HandlerOptions.ts": null,
+    "./rpc/PageUrl.ts": null,
     "./http/boardRoutes.ts": null,
     "./http/rpcPolicy.ts": null,
-    "./page/board.ts": {
-      "types": "./dist/server/page/boardHtml.d.ts",
-      "source": "./src/server/page/boardHtml.ts",
-      "import": "./dist/server/page/boardHtml.js",
-      "default": "./dist/server/page/boardHtml.js"
-    },
-    "./page/document.ts": {
-      "types": "./dist/server/page/documentHtml.d.ts",
-      "source": "./src/server/page/documentHtml.ts",
-      "import": "./dist/server/page/documentHtml.js",
-      "default": "./dist/server/page/documentHtml.js"
-    },
     "./page/escape.ts": {
       "types": "./dist/browser/escapeHtml.d.ts",
       "source": "./src/browser/escapeHtml.ts",
@@ -431,7 +417,11 @@
     "./page/formReadingScript.ts": null,
     "./page/diagrams.ts": null,
     "./page/client.ts": null,
-    "./views/savedScript.ts": null
+    "./views/savedScript.ts": null,
+    "./document/answerBody.ts": null,
+    "./document/answerCardsHtml.ts": null,
+    "./document/requestTitle.ts": null,
+    "./browser/document/sourceGroups.ts": null
   },
   "bin": {
     "work-board": "./dist/server/cli.js"
@@ -452,7 +442,7 @@
   "dependencies": {
     "@shivaedev/effect-contract": "0.5.0",
     "@shivaedev/effect-service": "0.3.0",
-    "@shivaedev/platform": "0.7.0",
+    "@shivaedev/platform": "0.8.0",
     "mdast-util-directive": "3.1.1",
     "mermaid": "12.1.0",
     "react": "19.3.0",
@@ -488,8 +478,8 @@
     "clsx": "2.1.1",
     "effect": "4.0.4",
     "esbuild": "0.28.2",
-    "happy-dom": "20.14.5",
-    "lucide-react": "1.52.0",
+    "happy-dom": "20.14.6",
+    "lucide-react": "1.53.0",
     "tailwind-merge": "3.7.0",
     "tailwindcss": "4.3.3",
     "typescript": "npm:@typescript/typescript6@6.0.2",

package/src/browser/Navigation.ts

@@ -0,0 +1,8 @@
+import { Schema } from "effect";
+
+export const Navigation = Schema.Struct({
+	counts: Schema.Struct({ goals: Schema.Number, library: Schema.Number, now: Schema.Number, system: Schema.Number }),
+	home: Schema.optional(Schema.Struct({ file: Schema.String, identity: Schema.optional(Schema.String) })),
+	inboxCount: Schema.NullOr(Schema.Number),
+});
+export type Navigation = typeof Navigation.Type;

package/src/browser/document/ReadingContext.ts

@@ -3,7 +3,15 @@ import { RequestReceipt } from "#attention/RequestReceipt.ts";
 
 const Link = Schema.Struct({ href: Schema.optional(Schema.String), label: Schema.String });
 export const ReadingContext = Schema.Struct({
-	backlinks: Schema.Array(Schema.Struct({ href: Schema.String, kind: Schema.String, label: Schema.String })),
+	backlinks: Schema.Array(
+		Schema.Struct({
+			href: Schema.String,
+			kind: Schema.String,
+			label: Schema.String,
+			status: Schema.optional(Schema.String),
+			title: Schema.optional(Schema.String),
+		}),
+	),
 	board: Schema.Boolean,
 	claims: Schema.Record(Schema.String, Schema.Array(Link)),
 	evidenceSources: Schema.Array(Schema.Struct({ href: Schema.optional(Schema.String), problem: Schema.String })),

package/src/browser/document/schema.ts

@@ -6,6 +6,7 @@ import { ReadingContext } from "./ReadingContext.ts";
 export const DocumentRequest = Schema.Struct({
 	id: Schema.String,
 	open: Schema.Boolean,
+	options: Metadata.to.fields.options,
 	preview: Schema.optional(QuestionPreview),
 	prompts: Schema.optional(
 		Schema.Array(
@@ -18,7 +19,10 @@ export const DocumentRequest = Schema.Struct({
 		),
 	),
 	promptUnavailable: Schema.optional(Schema.String),
+	recommended: Metadata.to.fields.recommended,
 	responses: Schema.optional(Schema.Array(RecordedResponse)),
+	sourceOpen: Schema.optional(Schema.Boolean),
+	title: Schema.optional(Schema.String),
 	unavailable: Schema.optional(Schema.String),
 });
 export type DocumentRequest = typeof DocumentRequest.Type;
@@ -31,6 +35,7 @@ export const Document = Schema.Struct({
 	modified: Schema.Number,
 	questionActions: Schema.Record(Schema.String, Schema.String),
 	reading: Schema.optional(ReadingContext),
+	referenceDetails: Schema.optional(Schema.Record(Schema.String, Schema.Struct({ status: Schema.optional(Schema.String), title: Schema.String }))),
 	references: Schema.Record(Schema.String, Schema.String),
 	requests: Schema.Array(DocumentRequest),
 	source: Schema.String,

package/src/browser/document/sourceGroups.ts

@@ -0,0 +1,52 @@
+export interface SourceLink {
+	readonly href: string;
+	readonly kind: string;
+	readonly label: string;
+	readonly status?: string | undefined;
+	readonly title?: string | undefined;
+}
+
+const specificity = [
+	"recorded response",
+	"superseding response",
+	"reviewed question",
+	"agent handoff",
+	"Criterion evidence",
+	"Evidence source",
+	"Attention request",
+	"Implements",
+	"Depends on",
+	"Informs",
+	"Board membership",
+	"Related to",
+	"Markdown link",
+];
+const kinds = new Map([
+	["relates_to", "Related to"],
+	["depends_on", "Depends on"],
+	["implements", "Implements"],
+	["informs", "Informs"],
+]);
+function priority(kind: string) {
+	const index = specificity.indexOf(kinds.get(kind) ?? kind);
+	return index < 0 ? specificity.length : index;
+}
+
+export function specificSources<T extends SourceLink>(links: readonly T[]): readonly T[] {
+	const sources = new Map<string, T>();
+	for (const link of links) {
+		const previous = sources.get(link.href);
+		if (!previous || priority(link.kind) < priority(previous.kind)) {
+			sources.set(link.href, link);
+		}
+	}
+	return [...sources.values()];
+}
+
+export function sourceGroups<T extends SourceLink>(links: readonly T[]) {
+	return [...Map.groupBy(links, (link) => link.title ?? link.label)].map(([title, sources]) => ({
+		label: `${title.startsWith("Fleet decision for ") ? "Fleet decisions" : title} (${sources.length})`,
+		sources,
+		title,
+	}));
+}

package/src/browser/navigation/library.ts

@@ -0,0 +1,25 @@
+import { Schema } from "effect";
+
+export const LibraryInput = {
+	folder: Schema.optional(Schema.String),
+	kind: Schema.optional(Schema.String),
+	showFleet: Schema.optional(Schema.Boolean),
+	status: Schema.optional(Schema.String),
+};
+export const LibraryFile = Schema.Struct({
+	href: Schema.String,
+	kind: Schema.String,
+	modified: Schema.Number,
+	path: Schema.String,
+	status: Schema.String,
+	title: Schema.String,
+});
+export type LibraryFile = typeof LibraryFile.Type;
+export const Library = Schema.Struct({
+	files: Schema.Array(LibraryFile),
+	fleetCount: Schema.Number,
+	folders: Schema.Array(Schema.Struct({ count: Schema.Number, name: Schema.String, path: Schema.String })),
+	kinds: Schema.Array(Schema.String),
+	statuses: Schema.Array(Schema.String),
+});
+export type Library = typeof Library.Type;

package/src/browser/responses/cardContext.ts

@@ -0,0 +1,50 @@
+import { reasonMarkdown } from "./reasonMarkdown.ts";
+
+export function cardContext(source: string) {
+	const recommendation = reasonMarkdown(section(source, "Recommendation"));
+	const relevant = section(source, "Relevant links");
+	const links = [...relevant.matchAll(/https?:\/\/[^\s<>()[\]]+/gu)].map(([url]) => {
+		const pr = /\/pull\/(?<number>\d+)/u.exec(url)?.groups?.number;
+		return { label: pr ? `Open PR #${pr}` : "Open relevant link", primary: Boolean(pr), url };
+	});
+	return { links, recommendation };
+}
+
+export function optionLabel(id: string, source: string, reason: string) {
+	const heading = /^#{1,6}\s+(?<title>.+)$/mu.exec(source)?.groups?.title;
+	if (heading) {
+		return heading;
+	}
+	if (id === "retry" && /reviewed pr is ready to merge/iu.test(reason)) {
+		return "Request changes (retry)";
+	}
+	return id.charAt(0).toUpperCase() + id.slice(1).replaceAll("-", " ");
+}
+
+function section(source: string, title: string) {
+	const lines = source.split("\n");
+	let active = false;
+	let fence: string | undefined;
+	const content: string[] = [];
+	for (const line of lines) {
+		const marker = /^\s*(?<fence>`{3,}|~{3,})/u.exec(line)?.groups?.fence;
+		if (!fence && (/^##\s/u.test(line) || line.startsWith("::::question"))) {
+			if (active) {
+				break;
+			}
+			active = line.trim() === `## ${title}`;
+			continue;
+		}
+		if (active) {
+			content.push(line);
+		}
+		if (marker) {
+			fence = nextFence(fence, marker);
+		}
+	}
+	return content.join("\n").trim();
+}
+
+function nextFence(current: string | undefined, marker: string) {
+	return current?.startsWith(marker.charAt(0)) && marker.length >= current.length ? undefined : marker;
+}

package/src/browser/responses/reasonMarkdown.ts

@@ -0,0 +1,5 @@
+export function reasonMarkdown(reason: string): string {
+	const source = reason.trim();
+	const fenced = /^(?<fence>`{3,}|~{3,})[^\n]*\n(?<reason>[\s\S]*?)\n\k<fence>$/u.exec(source);
+	return fenced?.groups?.reason?.trim() ?? source;
+}

package/src/browser/views/FleetItemsProjection.ts

@@ -0,0 +1,14 @@
+import { Schema } from "effect";
+import { CompletedFleetItem, FleetItem } from "#diagnostics/fleetItems.ts";
+import { Metadata } from "#metadata/schema.ts";
+
+const FleetDocument = Schema.NullOr(Schema.Struct({ file: Schema.String, metadata: Metadata, title: Schema.String }));
+export const FleetItemsProjection = Schema.Union([
+	Schema.Struct({
+		completed: Schema.Array(Schema.Struct({ ...CompletedFleetItem.fields, document: FleetDocument })),
+		items: Schema.Array(Schema.Struct({ ...FleetItem.fields, document: FleetDocument })),
+		state: Schema.Literal("ready"),
+	}),
+	Schema.Struct({ reason: Schema.String, state: Schema.Literal("unavailable") }),
+]);
+export type FleetItemsProjection = typeof FleetItemsProjection.Type;

package/src/browser/views/GoalsProjection.ts

@@ -0,0 +1,23 @@
+import { Schema } from "effect";
+import { WorkItem } from "./schema.ts";
+
+const Counts = Schema.Struct({ done: Schema.Number, "in progress": Schema.Number, planned: Schema.Number });
+const Criterion = Schema.Struct({ counts: Counts, evidence: Schema.Number, id: Schema.String, linked: Schema.Number, text: Schema.String });
+const Goal = Schema.Struct({
+	counts: Counts,
+	criteria: Schema.Array(Criterion),
+	id: Schema.String,
+	linked: Schema.Number,
+	nextAction: Schema.optional(Schema.String),
+	openAsks: Schema.Number,
+	owner: Schema.optional(Schema.String),
+	status: Schema.optional(Schema.String),
+	title: Schema.String,
+	unlinked: Schema.Boolean,
+});
+export const GoalsProjection = Schema.Struct({
+	closedGoals: Schema.Array(Goal),
+	goals: Schema.Array(Goal),
+	items: Schema.Array(WorkItem),
+});
+export type GoalsProjection = typeof GoalsProjection.Type;

package/src/browser/views/goalWorkState.ts

@@ -0,0 +1,17 @@
+import type { FleetItems } from "#diagnostics/fleetItems.ts";
+
+type Stage = FleetItems["items"][number]["stage"];
+const done = new Set(["closed", "done", "superseded", "completed", "cancelled", "canceled", "resolved", "released"]);
+export function goalState(status: string | undefined, stage: Stage | undefined): string | undefined {
+	return stage && stage !== "released" ? stage : status;
+}
+export function goalWorkGroup(status: string | undefined, stage: Stage | undefined): "In progress" | "Planned" | "Done" | "Deferred" {
+	const state = goalState(status, stage)?.trim().toLowerCase();
+	if (state && done.has(state)) {
+		return "Done";
+	}
+	if (!state || state === "planned" || state === "prepared") {
+		return "Planned";
+	}
+	return state === "deferred" ? "Deferred" : "In progress";
+}