@shivaedev/work-board 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,161 @@
 # Changelog
 
+## 0.14.0 - 2026-10-16
+
+### Added
+
+- The typed Inbox query and headless `attention.projection(snapshot)` expose `you`, `agents`, `resolved` and `parked` lanes, with audience labels and separate source diagnostics.
+- `work-board mcp <dir>` serves the read-only `board_overview`, `needs_you` and `item` tools over stdio using Effect's MCP server. Tools query the running board's Unix socket for the same computed state as the browser and explain how to start a board when none answers.
+- Serve the same NDJSON RPC over `<dir>/board.sock` alongside the browser's TCP listener. Each directory has its own socket with owner-only access from creation; serialized startup replaces stale sockets and refuses a live or starting board, and shutdown removes the socket, including SIGINT and SIGTERM. Private bind paths use no more pathname bytes than the public socket path.
+- Add the `work-board.server` query returning `{ url, directory }` with the board's browser URL and absolute board directory on both transports. Export its `Server` schema from `@shivaedev/work-board/rpc/Server.ts`.
+- The typed `fleetItems` Board query reads current Fleet stages, waiting owners, PR URLs and persisted times through the Diagnostics daemon client, joins unique Board documents by ID, and returns `unavailable` with a reason for failed reads or a disabled (`fleetPort: null`) daemon. The shared `DiagnosticsContract` adds `daemon.fleetItems`, backed by `FleetItem`, `CompletedFleetItem` and `FleetItems` schemas. `FleetStage` and `FleetTimestamp` are also available through the diagnostics integration. Legacy stage entry and completion times remain unknown until an observed transition.
+- `FleetItemsProjection` describes the Board result. The shared `readDaemon(port, read)` transport and `daemonUnavailableReason(error, port)` explanation are available from `diagnostics/daemon.ts`.
+- The typed `goals` query returns open projects with counts of linked work by authored status, criterion-level work and recorded evidence counts, and open ask counts. Missing statuses stay not recorded and unlinked goals are explicit; progress has no computed completion percentage or overall success flag.
+- Project pages open with the goals query's done, in progress and planned counts and Inbox-aligned open-ask count before answer cards, followed by criteria with progress, linked work and recorded evidence before authored Markdown. Empty work groups, untargeted criteria labels and absent evidence stay quiet. Each work row has one held Fleet stage or authored status chip; missing status and PR stay blank.
+- The document query's optional `referenceDetails` record supplies each resolved reference's title and recorded status alongside the existing reference URLs.
+- Recognize `goal` and `report` item kinds in frontmatter and the portable metadata schema.
+- Document reading-context backlinks include optional `title` and `status` fields for consumers that render source references.
+- The command palette offers navigation to Today, Goals, Now, Library, System and active goals alongside appearance commands. Search results show item IDs, kinds and status chips.
+
+### Changed
+
+- Open requests show an answer card directly below the item header, using the existing response form and retained drafts. The separate respond link opens and focuses that card.
+- Managed decisions use the unblocked item's title, render their reason as Markdown, and show the complete question once, including unfenced multi-paragraph reasons. Page and card headings name the unblocked item. Generated identities stay in Source instead of the item header.
+- Decisions can use frontmatter options and a recommended choice. Answer cards lead with the recommendation and relevant PR actions, and directive choices use human labels. Decision and question headers show request state and omit missing fields. Response validation waits for an attempt, with the last saved local author label prefilled.
+- Typed document requests include optional `title` and `sourceOpen` fields; `DocumentViewProps` accepts an optional `answer` node below the header.
+- `documentHtml` accepts optional answer-card HTML, and `composerHtml` accepts an optional card title.
+- Open requests also show their answer cards under the headers of the items they unblock, preserving the request's reviewed source and choices.
+- Answer cards record with one action and keep author labels, draft tools and response details under More. Read-only cards show one line explaining how to enable answers.
+- The workspace has five views: Today, Goals, Now, Library and System. Retired destinations redirect to their current view; System lists running and waiting Fleet items by title, stage and PR beside provider limits.
+- Browser pages use Tailwind and shared React primitives and require JavaScript.
+- Goal and criterion `counts` now always contain `done`, `"in progress"` and `planned`, including zeros. Held Fleet stages override authored status; released stages fall back to authored status. Deferred and unrecorded work count as planned. `goals(snapshot, fleet?)` accepts an optional Fleet projection. Internal Inbox rows retain their `unblocks` targets for goal-specific counts; browser Inbox projections keep their existing shape.
+- Goals shows compact progress cards with next actions, positive open-ask counts and single-line done/total rows for linked criteria. Zero-count metadata stays quiet, and closed goals sit in one collapsed section.
+- Identified documents open with a sticky title, kind icon, status, owner, next action and header actions. Known Fleet items show their execution stage and PR link. Criteria, target titles and statuses, and backlinks grouped by kind appear in an open responsive rail; source location and raw frontmatter have a Source tab. Markdown uses a 68ch reading column with 16px prose.
+- Use a neutral light and dark Board shell, shared status chips with icons and semantic colours, and a single header settings popover for theme, density and live-update preferences.
+- Open Work on a Now board with fixed Fleet stage lanes, tasks only, one Fleet-derived state chip, and holder, PR and time in stage only when known. Disclose authored-status fallback when Fleet is unavailable; keep All work and Table as explicit choices. Queue Fleet-prepared or authored approved waiting tasks, use authored status only without a matching Fleet item, and collapse saved views and filters behind Filter on Now.
+- Exclude decision, question, response, result and request receipt records from Work lists. Keep status column order independent of row sorting and virtualize lists over 200 rows in bounded scrolling containers.
+- Keep Today, Goals, Now and Search in a bottom phone navigation bar, with Library and System in a More sheet. Use a compact sticky phone header and omit keyboard hints on touch devices.
+- Replace the sidebar file tree with counted destinations, pinned documents, active goal status bars and five recent documents. Browse document titles, kind/status filters, lazy folders and modification order in Library; generated Fleet records stay hidden until requested.
+- Open on Today with human asks, compact ask rows with option answers in popovers, compact goal progress with next actions clamped to two lines and collapsed criteria, and up to eight Fleet-held items with their stages and PR links. Keep configured home Markdown reachable as Workspace notes.
+
+### Fixed
+
+- Inbox, Overview and navigation badges share the maintainer lane count. Open requests for other labels remain visible under Waiting on agents, including requests without a registered question. Invalid managed requests remain source diagnostics rather than counted asks.
+- Share the navigation query between route loaders and the React shell instead of requesting the workspace tree again for each selected file. Document navigation shows the new document or a loading message as the URL changes, and returning before a read completes cannot display that late result over the returned page or overwrite its saved reading details.
+- Opening unchanged indexed documents reuses their parsed metadata and workspace model. Backlinks are resolved once per model instead of scanning every document's links on each open; the selected source is still read to detect edits before watcher notification.
+- Inbox and navigation counts reuse revision-scoped question, response and receipt indexes, instead of validating every response again for every question and document request. Source changes refresh those indexes and counts while preserving ambiguous and malformed history outcomes.
+- Goal criteria and linked-work tables include every identified implementing item, including results, decisions, questions and responses. The goals query returns these items alongside its counts, including links to closed projects.
+- Completed and closed project pages show query-derived progress bars and criterion counts. The goals query adds `closedGoals` with the same fields as active `goals`; active-goal navigation remains filtered to open projects.
+- Keep managed asks for closed or deferred target work in collapsed Inbox groups, group repeated active managed or registered asks by target item, and count only main-list rows in the Inbox badges without editing sources.
+- Add `resolved` and `parked` arrays and per-row `earlierAsks` to the Inbox query projection.
+- Criterion and recorded-evidence passage links leave their targets visible below the sticky item header.
+- Item backlinks show source titles and status, with file locations in tooltips. Criteria use one recorded-evidence count instead of repeating missing-evidence notices.
+- Source diagnostics recognize Fleet-owned frontmatter fields while continuing to report unowned fields.
+- Item links open the same document with or without a trailing slash on direct loads and in-app navigation, including IDs ending in `.md` and IDs that collide with a Markdown file path. Item URLs select identities rather than colliding files; unknown IDs show an explicit missing-item message.
+- Keep Files and Inbox controls named for assistive technology when their visible labels are hidden on narrow screens.
+- Print documents at full width when the Files sidebar is open.
+- Recognize planned, active and received statuses with neutral, working and recorded-response icons.
+- Restore the theme before the first paint and apply its background to the page root as well as the body.
+- Let every available Fleet stage decide the task lane despite inactive authored statuses, including prepared and human-waiting work. Keep Done limited to known completions in the last seven days.
+- Keep approved waiting tasks queued when Fleet addon fields are recognized without diagnostics.
+- Missing authored values stay blank across reading and work views, including PR links in System’s Fleet work. Provenance explanations use tooltips or Source records in the React views. Attention-request passage links reveal the Source tab before scrolling and focusing the record, including direct, search, same-document and Back navigation. Repeated source titles expand from one counted line, and each backlink source appears under its most specific kind.
+- Managed answer cards use the Inbox’s active request eligibility. Answer cards and needs-you summary chips stay hidden on closed work, even when a question retains an explicit open attention request.
+- Sidebar goal bars name their done count for assistive technology and hover; only Today and Now show navigation counts. Now lanes keep equal widths and single-line headers. Today’s in-progress work follows its human asks without a gap from the goals column, and one open ask uses the singular.
+- Track Today health through its Inbox, Goals and Fleet queries, and retry failed reads when reopening Today.
+- Search ranks items before headings and passages, open work before closed and deferred work, then title and ID matches before body matches and recently changed sources before older ones. Fleet records, including `fleet/status.md` and `responses/fleet-report.*`, require `records:`. Snippets omit structured metadata, each anchor appears once, and rows without a recorded status omit the status chip.
+- With `records:`, Fleet and ordinary item results share the same status, relevance and recency ordering before every heading and passage hit, including when only the item's body matches. Matching go-to commands replace item results with the same destination.
+
+### Breaking
+
+- Removed the browser-local comparison API: `workContract.queries.history`, `workContract.queries.overview`, `HistoryInput`, `HistoryOutput`, `OverviewProjection` and the `history/` entry points. The `page/board.ts` and `page/document.ts` server HTML entry points are removed.
+- `page/shell.ts` now exports `shell(title, workspace)` for the React bootstrap only. Removed the superseded server rendering and style exports listed below:
+  - `history/schema.ts`: `Baseline`, `HistoryInput`, `HistoryComparison`, `HistoryOutput`.
+  - `server/attention/inboxHtml.ts`: `inboxHtml`, `inboxStyle`.
+  - `server/attention/overviewHtml.ts`: `overviewHtml`.
+  - `server/attention/style.ts`: `attentionStyle`.
+  - `server/diagnostics/style.ts`: `diagnosticsStyle`.
+  - `server/document/answerCardsHtml.ts`: `answerCardsHtml`.
+  - `server/history/baseline.ts`: `readBaseline`, `observeBaseline`.
+  - `server/history/compare.ts`: `SourceChange`, `compareHistory`.
+  - `server/history/documents.ts`: `HistoryDocument`, `historyDocuments`, `historyIdentities`.
+  - `server/history/fields.ts`: `historyFields`.
+  - `server/history/html.ts`: `historyHtml`.
+  - `server/history/limits.ts`: `MAX_BYTES`, `MAX_AGE`.
+  - `server/history/response.ts`: `historyResponse`.
+  - `server/http/inbox.ts`: `inbox`.
+  - `server/http/overview.ts`: `overview`.
+  - `server/http/work.ts`: `work`.
+  - `server/page/attentionDetails.ts`: `attentionDetails`.
+  - `server/page/backlinksHtml.ts`: `backlinksHtml`.
+  - `server/page/boardHtml.ts`: `boardHtml`.
+  - `server/page/criteriaEvidence.ts`: `criteriaEvidence`.
+  - `server/page/documentHtml.ts`: `documentHtml`.
+  - `server/page/itemIntroduction.ts`: `itemIntroduction`.
+  - `server/page/itemStyles.ts`: `itemStyles`.
+  - `server/page/metadata.ts`: `metadataHtml`, `metadataStyles`.
+  - `server/page/metadataDetails.ts`: `metadataDetails`.
+  - `server/page/metadataLinks.ts`: `referenceHtml`, `sourceHtml`, `documentReference`, `valueHtml`.
+  - `server/page/nav.ts`: `navHtml`, `inboxCount`.
+  - `server/page/readingStyles.ts`: `readingStyles`.
+  - `server/page/readingTools.ts`: `readingTools`.
+  - `server/page/recordedEvidence.ts`: `recordedEvidence`.
+  - `server/page/searchDialog.ts`: `searchDialog`, `searchStyles`.
+  - `server/page/style.ts`: `style`.
+  - `server/page/updated.ts`: `updated`.
+  - `server/page/visualDialog.ts`: `visualDialog`, `visualStyles`.
+  - `server/page/workspaceStyles.ts`: `layout`, `theme`.
+  - `server/responses/authoredQuestionHtml.ts`: `authoredQuestionHtml`.
+  - `server/responses/composerHtml.ts`: `composerHtml`.
+  - `server/responses/optionControls.ts`: `optionControls`.
+  - `server/responses/templateHtml.ts`: `templateHtml`.
+  - `server/views/tools.ts`: `viewTools`.
+  - `server/views/workCards.ts`: `workCards`.
+  - `server/views/workControls.ts`: `workControls`.
+  - `server/views/workDetail.ts`: `workDetail`.
+  - `server/views/workHtml.ts`: `workHtml`.
+  - `server/views/workListStyle.ts`: `workListStyle`.
+  - `server/views/workStyle.ts`: `workStyle`.
+  - `server/views/workTable.ts`: `workTable`.
+  - `browser/navigation/html.ts`: `navigationHtml`.
+  - `server/responses/historyHtml.ts`: `historyHtml`.
+- The navigation query returns destination counts instead of `tree` and `records`; `NavigationFile` and `NavigationFolder` schemas are removed. The `Navigation` import at `browser/navigation/schema.ts` remains available. The Library query provides filtered documents and immediate folder children on demand.
+
+## 0.13.0 - 2026-10-13
+
+### Added
+
+- Native `workContract` projection queries: `board` and `work` take `{ url }`; `overview` and `inbox` take no payload. Their typed results carry source data, validated membership and explicit unavailable states, without page HTML.
+- Portable `BoardProjection`, `WorkProjection`, `OverviewProjection` and `InboxProjection` schemas and types in `browser/views/schema.ts`, with shared `State`, `stateOf`, `viewUrl` and `fieldFilter` exports in `browser/views/state.ts`. The existing server URL-state exports remain compatible.
+- `DocumentView` accepts optional `board` section counts to render source Markdown as a heading board with the shared reading plugins.
+
+### Changed
+
+- Draw `mermaid` diagrams with Mermaid 12. Flowchart, state, class, entity-relationship and requirement diagrams that set no `layout` now lay out with ELK in Mermaid's `neo` look, so existing diagrams can change shape and gain shadows.
+- Drawing diagrams now needs an ES2024 browser, such as Safari 17.4 or later.
+- Navigation chrome, search, reading preferences, favorites, recents and reading history run in the React client with the shared native query registry.
+- Changes, Diagnostics, Start, Respond, Handoff and Result render typed Board queries in React. Their URLs load the React shell and require JavaScript; live updates and contextual forms retain their shared native client.
+- Board RPC adds `start`, `diagnostics`, `respond`, `handoff` and `result` queries. History responses add a typed `comparison` with source changes and identity limitations.
+- The configured home board, Work board/table with filters and selected detail, Overview and Inbox render in React from projection queries. Existing URLs, saved local views, inline answers and live updates use the shared query registry. Home reads retain targeted invalidation and change highlighting; visual previews refresh and diagram drawings return with Back navigation.
+
+### Fixed
+
+- Response drafts use effect-form persistence and retain input across reloads and source revisions. Questionnaire recovery keeps one snapshot per prior context, so repeated remounts retain answers without growing the draft. Response and handoff drafts now expire after seven days with a 256 KiB limit per draft; Clear draft restores only the current form.
+- Retain response and handoff draft text, source-change notices and caret selection through query refresh and reload in React-owned forms.
+- Back navigation and reload report a missing saved passage after restoring reading state, without changing the restored scroll or focus.
+- Search retains its query across dismissal and reopening, and keyboard dismissal restores the original control's focus and text selection.
+- Search passages that share a heading URL remain distinct when refreshed results remove or reorder entries.
+- Search keeps a valid keyboard selection when refreshed results shrink, so Enter opens the remaining selected result.
+- Editing a search query immediately clears previous options, so Enter before the debounce completes cannot open an old result or command.
+- A successful document refresh clears the previous navigation failure without resetting the current reading position or focus.
+- Opening the current projection URL uses its typed query, including when retrying a failed view. Overview and Inbox keep their payload-free calls.
+
+### Breaking
+
+- Requires stable Effect 4.0.4 in place of 4.0.0-rc.112. Effect 4.0.4 moves the former `effect/unstable/*` modules to `effect/*` and renames constructors such as `Config.string` to `Config.String`. Install `@effect/platform-node` and `@effect/platform-node-shared` 4.0.4 alongside it.
+- Removed `listenOn` from `@shivaedev/work-board/serve.ts` and the `server` and `ServerOptions` exports from `@shivaedev/work-board/rpc/server.ts`. Use `serveBoard` from `@shivaedev/work-board/serve.ts` to run the loopback Board HTTP and RPC server through Platform's `appHost`; the port, routes and CLI flags stay the same.
+- Remove the legacy string-script browser runtime and its HTTP asset routes. Remove these package exports and their modules: `diagnostics/script.ts`, `history/script.ts`, `page/sidebarScript.ts`, `page/searchResultsScript.ts`, `page/swap.ts`, `page/visualViewport.ts`, `page/stateScript.ts`, `page/searchScript.ts`, `page/visualScript.ts`, `page/itemContextScript.ts`, `page/libraryScript.ts`, `page/ageScript.ts`, `page/navigationScript.ts`, `page/readingStateScript.ts`, `page/formReadingScript.ts`, `page/diagrams.ts`, `page/client.ts`, `views/savedScript.ts`. Use the Board React client and native browser client instead.
+- Remove the Board HTML `page` RPC and the superseded server renderers for these views. Read documents with `document` and returned-result data with `result`.
+
 ## 0.12.0 - 2026-10-12
 
 ### Added