@shivaedev/work-board 0.12.0 → 0.14.0

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/runtime.dom.test.ts`, `src/client/page/sidebarScript.dom.test.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/navigationScript.dom.test.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/navigationScript.dom.test.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/responses/draftOwnership.dom.spec.ts` |
-| [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`; `page.test.ts` and `liveRefresh.dom.spec.ts` cover navigation, rendering and native polling/pause/resume. These fixtures do not establish live account authorization.
-
-The static handoff, response and question forms use `effect-form` for Schema decoding, field messages and submission snapshots. The unchanged form and draft regressions above preserve reviewed context and durable storage. `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`; `LegacyMain` hosts the configured home board and the remaining workspace views. The shell and hosted pages share the native atom registry and live connection. The server retains the existing layout as a no-JavaScript fallback; `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 page query. 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.12.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": {
@@ -26,7 +26,12 @@
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
     },
-    "#*.css": "./src/*.css"
+    "#*.css": "./src/*.css",
+    "#client/react/Age": {
+      "types": "./dist/client/react/Age.d.ts",
+      "source": "./src/client/react/Age.tsx",
+      "default": "./dist/client/react/Age.js"
+    }
   },
   "exports": {
     "./*.ts": {
@@ -73,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,
@@ -118,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",
@@ -130,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",
@@ -142,12 +156,6 @@
       "import": "./dist/diagnostics/source.js",
       "default": "./dist/diagnostics/source.js"
     },
-    "./diagnostics/script.ts": {
-      "types": "./dist/client/diagnostics/script.d.ts",
-      "source": "./src/client/diagnostics/script.ts",
-      "import": "./dist/client/diagnostics/script.js",
-      "default": "./dist/client/diagnostics/script.js"
-    },
     "./diagnostics/resetLabel.ts": {
       "types": "./dist/diagnostics/resetLabel.d.ts",
       "source": "./src/diagnostics/resetLabel.ts",
@@ -178,24 +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/script.ts": {
-      "types": "./dist/client/history/script.d.ts",
-      "source": "./src/client/history/script.ts",
-      "import": "./dist/client/history/script.js",
-      "default": "./dist/client/history/script.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",
@@ -226,96 +216,6 @@
       "import": "./dist/server/page/*.js",
       "default": "./dist/server/page/*.js"
     },
-    "./page/sidebarScript.ts": {
-      "types": "./dist/client/page/sidebarScript.d.ts",
-      "source": "./src/client/page/sidebarScript.ts",
-      "import": "./dist/client/page/sidebarScript.js",
-      "default": "./dist/client/page/sidebarScript.js"
-    },
-    "./page/searchResultsScript.ts": {
-      "types": "./dist/client/page/searchResultsScript.d.ts",
-      "source": "./src/client/page/searchResultsScript.ts",
-      "import": "./dist/client/page/searchResultsScript.js",
-      "default": "./dist/client/page/searchResultsScript.js"
-    },
-    "./page/swap.ts": {
-      "types": "./dist/client/page/scripts.d.ts",
-      "source": "./src/client/page/scripts.ts",
-      "import": "./dist/client/page/scripts.js",
-      "default": "./dist/client/page/scripts.js"
-    },
-    "./page/visualViewport.ts": {
-      "types": "./dist/client/page/visualViewport.d.ts",
-      "source": "./src/client/page/visualViewport.ts",
-      "import": "./dist/client/page/visualViewport.js",
-      "default": "./dist/client/page/visualViewport.js"
-    },
-    "./page/stateScript.ts": {
-      "types": "./dist/client/page/stateScript.d.ts",
-      "source": "./src/client/page/stateScript.ts",
-      "import": "./dist/client/page/stateScript.js",
-      "default": "./dist/client/page/stateScript.js"
-    },
-    "./page/searchScript.ts": {
-      "types": "./dist/client/page/searchScript.d.ts",
-      "source": "./src/client/page/searchScript.ts",
-      "import": "./dist/client/page/searchScript.js",
-      "default": "./dist/client/page/searchScript.js"
-    },
-    "./page/visualScript.ts": {
-      "types": "./dist/client/page/visualScript.d.ts",
-      "source": "./src/client/page/visualScript.ts",
-      "import": "./dist/client/page/visualScript.js",
-      "default": "./dist/client/page/visualScript.js"
-    },
-    "./page/itemContextScript.ts": {
-      "types": "./dist/client/page/itemContextScript.d.ts",
-      "source": "./src/client/page/itemContextScript.ts",
-      "import": "./dist/client/page/itemContextScript.js",
-      "default": "./dist/client/page/itemContextScript.js"
-    },
-    "./page/libraryScript.ts": {
-      "types": "./dist/client/page/libraryScript.d.ts",
-      "source": "./src/client/page/libraryScript.ts",
-      "import": "./dist/client/page/libraryScript.js",
-      "default": "./dist/client/page/libraryScript.js"
-    },
-    "./page/ageScript.ts": {
-      "types": "./dist/client/page/ageScript.d.ts",
-      "source": "./src/client/page/ageScript.ts",
-      "import": "./dist/client/page/ageScript.js",
-      "default": "./dist/client/page/ageScript.js"
-    },
-    "./page/navigationScript.ts": {
-      "types": "./dist/client/page/navigationScript.d.ts",
-      "source": "./src/client/page/navigationScript.ts",
-      "import": "./dist/client/page/navigationScript.js",
-      "default": "./dist/client/page/navigationScript.js"
-    },
-    "./page/readingStateScript.ts": {
-      "types": "./dist/client/page/readingStateScript.d.ts",
-      "source": "./src/client/page/readingStateScript.ts",
-      "import": "./dist/client/page/readingStateScript.js",
-      "default": "./dist/client/page/readingStateScript.js"
-    },
-    "./page/formReadingScript.ts": {
-      "types": "./dist/client/page/formReadingScript.d.ts",
-      "source": "./src/client/page/formReadingScript.ts",
-      "import": "./dist/client/page/formReadingScript.js",
-      "default": "./dist/client/page/formReadingScript.js"
-    },
-    "./page/diagrams.ts": {
-      "types": "./dist/client/page/scripts.d.ts",
-      "source": "./src/client/page/scripts.ts",
-      "import": "./dist/client/page/scripts.js",
-      "default": "./dist/client/page/scripts.js"
-    },
-    "./page/client.ts": {
-      "types": "./dist/client/page/runtime.d.ts",
-      "source": "./src/client/page/runtime.ts",
-      "import": "./dist/client/page/runtime.js",
-      "default": "./dist/client/page/runtime.js"
-    },
     "./responses/*.ts": {
       "types": "./dist/server/responses/*.d.ts",
       "source": "./src/server/responses/*.ts",
@@ -346,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",
@@ -394,12 +300,6 @@
       "import": "./dist/server/views/*.js",
       "default": "./dist/server/views/*.js"
     },
-    "./views/savedScript.ts": {
-      "types": "./dist/client/views/savedScript.d.ts",
-      "source": "./src/client/views/savedScript.ts",
-      "import": "./dist/client/views/savedScript.js",
-      "default": "./dist/client/views/savedScript.js"
-    },
     "./browser/escapeHtml.ts": {
       "types": "./dist/browser/escapeHtml.d.ts",
       "source": "./src/browser/escapeHtml.ts",
@@ -413,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",
@@ -484,24 +378,11 @@
       "import": "./dist/client/document/*.js",
       "default": "./dist/client/document/*.js"
     },
-    "./rpc/server.ts": {
-      "types": "./dist/server/rpc/transport.d.ts",
-      "source": "./src/server/rpc/transport.ts",
-      "import": "./dist/server/rpc/transport.js",
-      "default": "./dist/server/rpc/transport.js"
-    },
-    "./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"
-    },
+    "./rpc/server.ts": null,
+    "./rpc/HandlerOptions.ts": null,
+    "./rpc/PageUrl.ts": null,
+    "./http/boardRoutes.ts": null,
+    "./http/rpcPolicy.ts": null,
     "./page/escape.ts": {
       "types": "./dist/browser/escapeHtml.d.ts",
       "source": "./src/browser/escapeHtml.ts",
@@ -518,7 +399,29 @@
       "source": "./src/browser/document/ReadingContext.ts",
       "import": "./dist/browser/document/ReadingContext.js",
       "default": "./dist/browser/document/ReadingContext.js"
-    }
+    },
+    "./diagnostics/script.ts": null,
+    "./history/script.ts": null,
+    "./page/sidebarScript.ts": null,
+    "./page/searchResultsScript.ts": null,
+    "./page/swap.ts": null,
+    "./page/visualViewport.ts": null,
+    "./page/stateScript.ts": null,
+    "./page/searchScript.ts": null,
+    "./page/visualScript.ts": null,
+    "./page/itemContextScript.ts": null,
+    "./page/libraryScript.ts": null,
+    "./page/ageScript.ts": null,
+    "./page/navigationScript.ts": null,
+    "./page/readingStateScript.ts": null,
+    "./page/formReadingScript.ts": null,
+    "./page/diagrams.ts": null,
+    "./page/client.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"
@@ -537,13 +440,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@shivaedev/effect-contract": "0.4.1",
-    "@shivaedev/effect-service": "0.2.0",
-    "@shivaedev/platform": "0.6.1",
+    "@shivaedev/effect-contract": "0.5.0",
+    "@shivaedev/effect-service": "0.3.0",
+    "@shivaedev/platform": "0.8.0",
     "mdast-util-directive": "3.1.1",
-    "mermaid": "11.17.2",
-    "react": "19.2.8",
-    "react-dom": "19.2.8",
+    "mermaid": "12.1.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
     "react-markdown": "10.1.0",
     "rehype-raw": "7.0.0",
     "remark-directive": "4.0.0",
@@ -555,38 +458,38 @@
     "yaml": "2.9.1"
   },
   "devDependencies": {
-    "@effect/atom-react": "4.0.0-rc.112",
-    "@effect/platform-node": "4.0.0-rc.112",
-    "@effect/platform-node-shared": "4.0.0-rc.112",
-    "@shivaedev/effect-form": "0.2.1",
-    "@shivaedev/effect-react": "0.2.2",
-    "@shivaedev/effect-test": "0.3.2",
-    "@shivaedev/quality": "0.19.0",
+    "@effect/atom-react": "4.0.4",
+    "@effect/platform-node": "4.0.4",
+    "@effect/platform-node-shared": "4.0.4",
+    "@shivaedev/effect-form": "0.4.0",
+    "@shivaedev/effect-react": "0.4.0",
+    "@shivaedev/effect-test": "0.4.0",
+    "@shivaedev/quality": "0.20.0",
     "@tailwindcss/vite": "4.3.3",
     "@tanstack/react-router": "1.170.41",
     "@types/hast": "3.0.5",
     "@types/mdast": "4.0.4",
     "@types/node": "24.19.1",
-    "@types/react": "19.2.18",
-    "@types/react-dom": "19.2.4",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
     "@typescript/native": "npm:typescript@7.0.2",
-    "@vitejs/plugin-react": "6.1.1",
+    "@vitejs/plugin-react": "6.1.2",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
-    "effect": "4.0.0-rc.112",
+    "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",
-    "vite": "8.3.2",
-    "vitest": "4.1.11"
+    "vite": "8.3.3",
+    "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@effect/platform-node": "4.0.0-rc.112",
-    "@effect/platform-node-shared": "4.0.0-rc.112",
-    "effect": "4.0.0-rc.112"
+    "@effect/platform-node": "4.0.4",
+    "@effect/platform-node-shared": "4.0.4",
+    "effect": "4.0.4"
   },
   "engines": {
     "node": ">=24"

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/diagnostics/schema.ts

@@ -0,0 +1,18 @@
+import { Schema } from "effect";
+export const UsageWindow = Schema.Struct({
+	resetsAt: Schema.NullOr(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(8_640_000_000_000))),
+	usedPercent: Schema.Number.check(Schema.isFinite(), Schema.isGreaterThanOrEqualTo(0)),
+	windowDurationMins: Schema.NullOr(Schema.Int.check(Schema.isGreaterThan(0))),
+});
+export type UsageWindow = typeof UsageWindow.Type;
+export const CodexLimits = Schema.Struct({ primary: Schema.NullOr(UsageWindow), secondary: Schema.NullOr(UsageWindow) });
+export type CodexLimits = typeof CodexLimits.Type;
+const Count = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+export const GithubWindow = Schema.Struct({ limit: Count, remaining: Count, reset: Count.check(Schema.isLessThanOrEqualTo(8_640_000_000_000)) });
+export type GithubWindow = typeof GithubWindow.Type;
+export const GithubLimits = Schema.Struct({ core: GithubWindow, graphql: GithubWindow });
+export type GithubLimits = typeof GithubLimits.Type;
+
+export type Observation<A> =
+	| { readonly state: "ready"; readonly observedAt: number; readonly value: A }
+	| { readonly state: "not-configured" | "error"; readonly observedAt: number; readonly cause: string };

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;