@shivaedev/work-board 0.3.0 → 0.4.0

package/dist/page/style.js

@@ -1,3 +1,4 @@
+import { attentionStyle } from "#attention/style.ts";
 import { workStyle } from "#views/workStyle.ts";
 import { metadataStyles } from "./metadata.js";
 import { readingStyles } from "./readingStyles.js";
@@ -51,5 +52,5 @@ figure.diagram[data-state="failed"] .diagram-source { display: block; }
 figure.diagram[data-state="failed"]::after { content: attr(data-error); color: var(--danger); font-size: 0.875em; }
 @media (prefers-reduced-motion: reduce) { * { transition: none !important; animation: none !important; } }
 `;
-export const style = theme + layout + prose + board + diagrams + readingStyles() + searchStyles + metadataStyles + workStyle();
+export const style = theme + layout + prose + board + diagrams + readingStyles() + searchStyles + metadataStyles + workStyle() + attentionStyle();
 //# sourceMappingURL=style.js.map

package/dist/page/style.js.map

@@ -1 +1 @@
-{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/page/style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEF,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;CAOhB,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,EAAE,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,EAAE,CAAC"}
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/page/style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEF,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;CAOhB,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,EAAE,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC"}

package/dist/search/attentionEntries.d.ts

@@ -0,0 +1,4 @@
+import type { MetadataDocument } from "#metadata/model.ts";
+import type { Entry } from "./entries.ts";
+export declare function attentionEntries(document: MetadataDocument, href: string): readonly Entry[];
+//# sourceMappingURL=attentionEntries.d.ts.map

package/dist/search/attentionEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attentionEntries.d.ts","sourceRoot":"","sources":["../../src/search/attentionEntries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,EAAE,CAkB3F"}

package/dist/search/attentionEntries.js

@@ -0,0 +1,20 @@
+export function attentionEntries(document, href) {
+    const requests = document.parsed.fields.attention ?? [];
+    return requests.flatMap((request, index) => {
+        if (requests.filter((other) => other.id === request.id).length !== 1) {
+            return [];
+        }
+        const line = document.parsed.lines[`attention.${index}`] ?? document.parsed.lines.attention;
+        return [
+            {
+                file: document.file,
+                href: `${href}#attention-request-${encodeURIComponent(request.id)}`,
+                kind: "passage",
+                ...(line === undefined ? {} : { line }),
+                text: [request.reason, request.id, request.kind, request.state, ...request.responseFrom, ...request.unblocks].join(" "),
+                title: request.reason,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=attentionEntries.js.map

package/dist/search/attentionEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attentionEntries.js","sourceRoot":"","sources":["../../src/search/attentionEntries.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAAC,QAA0B,EAAE,IAAY;IACxE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACxD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAC1C,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5F,OAAO;YACN;gBACC,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,GAAG,IAAI,sBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;gBACnE,IAAI,EAAE,SAAS;gBACf,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvH,KAAK,EAAE,OAAO,CAAC,MAAM;aACrB;SACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/search/metadataEntries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadataEntries.d.ts","sourceRoot":"","sources":["../../src/search/metadataEntries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAM1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,gBAAgB,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,KAAK,EAAE,CAgCzI"}
+{"version":3,"file":"metadataEntries.d.ts","sourceRoot":"","sources":["../../src/search/metadataEntries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAM1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,gBAAgB,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,KAAK,EAAE,CAiCzI"}

package/dist/search/metadataEntries.js

@@ -1,5 +1,6 @@
 import { fileUrl } from "#files/url.ts";
 import { identityUrl } from "#metadata/links.ts";
+import { attentionEntries } from "./attentionEntries.js";
 function itemUrl(document, model) {
     const id = document.parsed.fields.id;
     return model.unavailable.length === 0 && id && model.ids.get(id)?.length === 1 ? identityUrl(id) : fileUrl(document.file);
@@ -19,6 +20,7 @@ export function metadataEntries(entries, documents, model) {
         };
     });
     for (const document of documents) {
+        enriched.push(...attentionEntries(document, itemUrl(document, model)));
         const criteria = document.parsed.fields.criteria ?? [];
         for (const [index, criterion] of criteria.entries()) {
             if (criteria.filter((item) => item.id === criterion.id).length !== 1) {

package/dist/search/metadataEntries.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadataEntries.js","sourceRoot":"","sources":["../../src/search/metadataEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,SAAS,OAAO,CAAC,QAA0B,EAAE,KAAoB;IAChE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3H,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,OAAyB,EAAE,SAAsC,EAAE,KAAoB;IACtH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,OAAO;YACN,GAAG,KAAK;YACR,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;YAC9B,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACpH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACrD,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,SAAS;YACV,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC1F,QAAQ,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE;gBACjF,IAAI,EAAE,SAAS;gBACf,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,KAAK,EAAE,SAAS,CAAC,IAAI;aACrB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}
+{"version":3,"file":"metadataEntries.js","sourceRoot":"","sources":["../../src/search/metadataEntries.ts"],"names":[],"mappings":"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"}

package/dist/search/snapshot.d.ts

@@ -1,4 +1,4 @@
-import { Effect, FileSystem, Path } from "effect";
+import { Effect, FileSystem } from "effect";
 import type { Changes } from "#files/changes.ts";
 import { type MetadataDocument, metadataModel } from "#metadata/model.ts";
 import { type Entry } from "./entries.ts";
@@ -9,5 +9,5 @@ export interface Snapshot {
     readonly revision: number;
     readonly unavailable: readonly string[];
 }
-export declare const searchSnapshot: (root: string, home: string | undefined, changes: Changes) => Effect.Effect<Effect.Effect<Snapshot, import("effect/PlatformError").PlatformError, FileSystem.FileSystem | Path.Path>, never, never>;
+export declare const searchSnapshot: (root: string, home: string | undefined, changes: Changes) => Effect.Effect<Effect.Effect<Snapshot, import("effect/PlatformError").PlatformError, FileSystem.FileSystem | import("effect/Path").Path>, never, never>;
 //# sourceMappingURL=snapshot.d.ts.map

package/dist/search/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/search/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAU,IAAI,EAAkB,MAAM,QAAQ,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,KAAK,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,cAAc,CAAC;AAGrD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,cAAc,qMA2CzB,CAAC"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/search/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAA0B,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,KAAK,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,cAAc,CAAC;AAGrD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,cAAc,sNA0CzB,CAAC"}

package/dist/search/snapshot.js

@@ -1,5 +1,5 @@
-import { Effect, FileSystem, Option, Path, Ref, Semaphore } from "effect";
-import { within } from "#files/list.ts";
+import { Effect, FileSystem, Option, Ref, Semaphore } from "effect";
+import { markdownPath } from "#files/markdownPath.ts";
 import { metadataModel } from "#metadata/model.ts";
 import { metadataParse } from "#metadata/parse.ts";
 import { entriesOf } from "./entries.js";
@@ -14,15 +14,14 @@ export const searchSnapshot = Effect.fn("WorkBoard.searchSnapshot")(function* (r
             return hit;
         }
         const fs = yield* FileSystem.FileSystem;
-        const path = yield* Path.Path;
         const files = yield* changes.files;
         const entries = [];
         const documents = [];
         const unavailable = [];
         for (const file of files) {
             const found = yield* Effect.option(Effect.gen(function* () {
-                const real = yield* fs.realPath(path.join(root, file.path));
-                if (!within(changes.realRoot, path.sep, real)) {
+                const real = yield* markdownPath(root, changes.realRoot, file.path);
+                if (real === undefined) {
                     return undefined;
                 }
                 const source = yield* fs.readFileString(real);

package/dist/search/snapshot.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/work-board",
-  "version": "0.3.0",
+  "version": "0.4.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": {
@@ -15,7 +15,7 @@
   "sideEffects": false,
   "type": "module",
   "imports": {
-    "#test/*": "./test/*",
+    "#test/*": "./src/test-support/*",
     "#*.ts": {
       "source": "./src/*.ts",
       "types": "./dist/*.d.ts",
@@ -39,6 +39,7 @@
     "src",
     "!src/**/*.test.ts",
     "!src/**/*.spec.ts",
+    "!src/**/test-support",
     "CHANGELOG.md",
     "README.md"
   ],
@@ -51,7 +52,7 @@
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",
     "@effect/platform-node-shared": "4.0.0-rc.112",
-    "@shivaedev/quality": "0.9.0",
+    "@shivaedev/quality": "0.14.0",
     "@types/hast": "3.0.5",
     "@types/mdast": "4.0.4",
     "@types/node": "24.10.1",
@@ -59,7 +60,7 @@
     "effect": "4.0.0-rc.112",
     "happy-dom": "20.11.2",
     "typescript": "npm:@typescript/typescript6@6.0.2",
-    "vitest": "4.1.9"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",

package/src/attention/overviewHtml.ts

@@ -0,0 +1,44 @@
+import { fileUrl } from "#files/url.ts";
+import { escapeHtml } from "#page/escape.ts";
+import { referenceHtml } from "#page/metadataLinks.ts";
+import type { Snapshot } from "#search/snapshot.ts";
+import { type AttentionEntry, attentionRequests } from "./requests.ts";
+
+function card(entry: AttentionEntry, snapshot: Snapshot): string {
+	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: Snapshot): string {
+	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>`;
+}

package/src/attention/requests.ts

@@ -0,0 +1,64 @@
+import { identityUrl, referenceTarget } from "#metadata/links.ts";
+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;
+}
+
+function requestsFor(document: MetadataDocument, snapshot: Snapshot, title: string): readonly AttentionEntry[] {
+	const { fields, lines } = document.parsed;
+	const itemId = fields.id;
+	if (!itemId || snapshot.unavailable.length > 0 || snapshot.model.ids.get(itemId)?.length !== 1) {
+		return [];
+	}
+	const requests = fields.attention ?? [];
+	return requests.flatMap((request, index) => {
+		if (
+			request.state !== "open"
+			|| requests.filter((other) => other.id === request.id).length !== 1
+			|| request.unblocks.some((target) => !referenceTarget(target, snapshot.model))
+		) {
+			return [];
+		}
+		return [
+			{
+				document,
+				href: `${identityUrl(itemId)}#attention-request-${encodeURIComponent(request.id)}`,
+				itemId,
+				line: lines[`attention.${index}`] ?? lines.attention ?? 2,
+				request,
+				title,
+			},
+		];
+	});
+}
+
+export function attentionRequests(snapshot: Snapshot) {
+	const titles = new Map(snapshot.entries.filter((entry) => entry.kind === "document").map((entry) => [entry.file, entry.title]));
+	const issues: SourceIssue[] = snapshot.documents.flatMap((source) =>
+		(snapshot.model.diagnostics.get(source.file) ?? source.parsed.diagnostics).map((problem) => ({ ...problem, file: source.file })),
+	);
+	const entries = snapshot.documents.flatMap((source) => requestsFor(source, snapshot, titles.get(source.file) ?? source.file));
+	const collator = new Intl.Collator("en", { numeric: true, sensitivity: "base" });
+	entries.sort((a, b) => collator.compare(a.title, b.title) || a.itemId.localeCompare(b.itemId) || a.request.id.localeCompare(b.request.id));
+	return { complete: snapshot.unavailable.length === 0, entries, issues };
+}
+
+export function attentionSource(document: MetadataDocument, index: number): string {
+	const requests = document.parsed.fields.attention ?? [];
+	const id = requests[index]?.id;
+	return id && requests.filter((request) => request.id === id).length === 1 ? `attention-request-${id}` : `attention-record-${index}`;
+}

package/src/attention/style.ts

@@ -0,0 +1,9 @@
+export function attentionStyle(): string {
+	return `
+.attention-total{margin:24px 0 8px;font-weight:600}.attention-order,.attention-footnote{font-size:13px;color:var(--muted);margin:0 0 24px;overflow-wrap:anywhere}
+.attention-groups{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px;align-items:start}.attention-group{min-width:0}.attention-group>h2{display:flex;justify-content:space-between;gap:12px;font-size:16px;margin:0 0 16px}.attention-group>h2>span{font:12px var(--mono);color:var(--muted)}
+.attention-card{border:1px solid var(--border);border-radius:10px;padding:var(--card-space);background:var(--card);margin:0 0 16px;overflow-wrap:anywhere}.attention-card h3{font-size:1rem;margin:6px 0}.attention-card h3 a{text-decoration:none}.attention-card dl{font-size:13px;margin:16px 0}.attention-card dt{color:var(--muted);margin-top:12px}.attention-card dd{margin:4px 0}.attention-source{font-size:12px}.attention-reason{font-size:14px;margin:0}.attention-footnote{margin-top:24px}.attention-incomplete{padding:16px;border:1px solid var(--danger);border-radius:8px;margin:24px 0;overflow-wrap:anywhere}
+[id^="attention-request-"],[id^="attention-record-"]{scroll-margin-top:20px}
+@media(max-width:1100px){.attention-groups{grid-template-columns:minmax(0,1fr)}}
+`;
+}

package/src/board.ts

@@ -4,8 +4,10 @@ import { watchChanges } from "#files/changes.ts";
 import { type HomeMissing, homeIn } from "#files/home.ts";
 import { ASSETS, MERMAID_ROUTE, type MermaidMissing, mermaidFile, mermaidRoot } from "#http/assets.ts";
 import { events } from "#http/events.ts";
+import { changesPage, history } from "#http/history.ts";
 import { identity } from "#http/identity.ts";
 import { loopbackOnly } from "#http/loopback.ts";
+import { overview } from "#http/overview.ts";
 import { page } from "#http/page.ts";
 import { respond } from "#http/respond.ts";
 import { search } from "#http/search.ts";
@@ -29,9 +31,9 @@ const routes = (options: BoardOptions) =>
 			const mermaid = yield* mermaidRoot();
 			const changes = yield* watchChanges(options.root);
 			const context = yield* Effect.context<Services>();
-			const serve = <E>(route: HttpRouter.PathInput, handler: Handler<E>) =>
+			const serve = <E>(route: HttpRouter.PathInput, handler: Handler<E>, method: "GET" | "POST" = "GET") =>
 				router.add(
-					"GET",
+					method,
 					route,
 					loopbackOnly((request) => Effect.provideContext(handler(request), context)),
 				);
@@ -39,6 +41,9 @@ const routes = (options: BoardOptions) =>
 			const index = yield* searchSnapshot(options.root, home, changes);
 			yield* serve("/_board/search", search(index));
 			yield* serve("/_board/work", work(index, changes, home));
+			yield* serve("/_board/overview", overview(index, changes, home));
+			yield* serve("/_board/changes", changesPage(changes, home));
+			yield* serve("/_board/history", history(index), "POST");
 			for (const [route, body, contentType] of ASSETS) {
 				yield* serve(route, () => Effect.succeed(respond(body, contentType)));
 			}

package/src/cli.ts

@@ -4,7 +4,7 @@ import { Effect, Layer, Option, Path } from "effect";
 import { Argument, Command, Flag } from "effect/unstable/cli";
 import { HOST, serveBoard } from "./serve.ts";
 
-const VERSION = "0.3.0";
+const VERSION = "0.4.0";
 
 const serve = Effect.fn("WorkBoard.serve")(function* (input: { readonly dir: string; readonly port: number; readonly home: Option.Option<string> }) {
 	const path = yield* Path.Path;

package/src/files/changes.ts

@@ -1,5 +1,6 @@
-import { Data, Deferred, Effect, FileSystem, Option, Path, type PlatformError, PubSub, Ref, Schedule, Stream } from "effect";
-import { isMarkdown, listMarkdown, type MarkdownFile } from "./list.ts";
+import { Deferred, Effect, FileSystem, Option, Path, type PlatformError, PubSub, Ref, Schedule } from "effect";
+import { listMarkdown, type MarkdownFile } from "./list.ts";
+import { watchDirectories } from "./watchDirectories.ts";
 
 export type Change = { readonly _tag: "Changed"; readonly paths: readonly string[] } | { readonly _tag: "Watching"; readonly watching: boolean };
 
@@ -16,10 +17,6 @@ interface Cached {
 	readonly generation: number;
 }
 
-class WatchEnded extends Data.TaggedError("WatchEnded") {}
-
-const SETTLE = "100 millis";
-const BATCH = 256;
 const BACKLOG = 16;
 const RETRY = Schedule.min([Schedule.exponential("100 millis"), Schedule.spaced("5 seconds")]);
 
@@ -33,7 +30,6 @@ export const watchChanges = Effect.fn("WorkBoard.watchChanges")(function* (root:
 	const cached = yield* Ref.make(Option.none<Cached>());
 	const settled = yield* Deferred.make<void>();
 	const stale = Ref.update(generation, (count) => count + 1);
-	const relative = (changed: string) => (path.isAbsolute(changed) ? path.relative(root, changed) : changed).split(path.sep).join("/");
 	const setWatching = (now: boolean) =>
 		Effect.andThen(
 			Effect.flatMap(Ref.getAndSet(watching, now), (was) =>
@@ -41,15 +37,7 @@ export const watchChanges = Effect.fn("WorkBoard.watchChanges")(function* (root:
 			),
 			Deferred.succeed(settled, undefined),
 		);
-	const watchOnce = fs.watch(root, { recursive: true }).pipe(
-		Stream.tap(() => stale),
-		Stream.map((event) => relative(event.path)),
-		Stream.filter(isMarkdown),
-		Stream.groupedWithin(BATCH, SETTLE),
-		Stream.runForEach((paths) => PubSub.publish(events, { _tag: "Changed", paths: [...new Set(paths)] })),
-		Effect.andThen(Effect.fail(new WatchEnded())),
-	);
-	const attempt = Effect.scoped(Effect.andThen(Effect.forkScoped(Effect.delay(setWatching(true), SETTLE)), watchOnce));
+	const attempt = watchDirectories(root, realRoot, stale, setWatching, (paths) => PubSub.publish(events, { _tag: "Changed", paths }));
 	yield* attempt.pipe(
 		Effect.sandbox,
 		Effect.tapError((cause) => Effect.andThen(setWatching(false), Effect.logWarning("Watching the folder failed; retrying", cause))),

package/src/files/home.ts

@@ -20,6 +20,10 @@ export const homeIn = Effect.fn("WorkBoard.homeIn")(function* (root: string, hom
 		return yield* missing;
 	}
 	const files = yield* listMarkdown(root, realRoot);
+	const logical = path.relative(root, path.resolve(root, home)).split(path.sep).join("/");
+	if (files.some((file) => file.path === logical)) {
+		return logical;
+	}
 	const relative = path.relative(realRoot, real.value).split(path.sep).join("/");
 	if (files.some((file) => file.path === relative)) {
 		return relative;

package/src/files/list.ts

@@ -17,14 +17,14 @@ const byFolder = (left: string, right: string): number => folderOf(left).localeC
 
 type Listing = Effect.Effect<readonly MarkdownFile[], PlatformError.PlatformError>;
 
-export const listMarkdown = Effect.fn("WorkBoard.listMarkdown")(function* (root: string, realRoot: string) {
+export const scanMarkdown = Effect.fn("WorkBoard.scanMarkdown")(function* (root: string, realRoot: string) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
-	const visited = new Set<string>();
-	const entry = (relative: string): Listing =>
+	const roots: Array<{ readonly real: string; readonly relative: string }> = [{ real: realRoot, relative: "" }];
+	const entry = (relative: string, boundary: string, ancestors: ReadonlySet<string>, parent: string): Listing =>
 		Effect.gen(function* () {
 			const real = yield* Effect.option(fs.realPath(path.join(root, relative)));
-			if (Option.isNone(real) || !within(realRoot, path.sep, real.value)) {
+			if (Option.isNone(real)) {
 				return [];
 			}
 			const info = yield* Effect.option(fs.stat(real.value));
@@ -32,24 +32,35 @@ export const listMarkdown = Effect.fn("WorkBoard.listMarkdown")(function* (root:
 				return [];
 			}
 			if (info.value.type === "Directory") {
-				return yield* Effect.orElseSucceed(folder(relative, real.value), () => []);
+				return yield* directory(relative, real.value, boundary, ancestors, real.value !== path.join(parent, path.basename(relative)));
 			}
 			const modified = Option.match(info.value.mtime, { onNone: () => 0, onSome: (date) => date.getTime() });
-			return info.value.type === "File" && relative.endsWith(".md") ? [{ modified, path: relative }] : [];
+			return info.value.type === "File" && relative.endsWith(".md") && within(boundary, path.sep, real.value) ? [{ modified, path: relative }] : [];
 		});
-	const folder = (relative: string, real: string): Listing =>
+	function directory(relative: string, real: string, boundary: string, ancestors: ReadonlySet<string>, alias: boolean): Listing {
+		if (ancestors.has(real) || within(real, path.sep, realRoot)) {
+			return Effect.succeed([]);
+		}
+		const linked = !within(boundary, path.sep, real);
+		if (alias) {
+			roots.push({ real, relative });
+		}
+		return Effect.orElseSucceed(folder(relative, real, linked ? real : boundary, ancestors), () => []);
+	}
+	const folder = (relative: string, real: string, boundary: string, ancestors: ReadonlySet<string>): Listing =>
 		Effect.gen(function* () {
-			if (visited.has(real)) {
-				return [];
-			}
-			visited.add(real);
+			const branch = new Set([...ancestors, real]);
 			const names = yield* fs.readDirectory(real);
 			const found = yield* Effect.forEach(
 				names.filter((name) => !skipped(name)),
-				(name) => entry(relative === "" ? name : `${relative}/${name}`),
+				(name) => entry(relative === "" ? name : `${relative}/${name}`, boundary, branch, real),
 			);
 			return found.flat();
 		});
-	const files = yield* folder("", realRoot);
-	return files.toSorted((left, right) => byFolder(left.path, right.path));
+	const files = yield* folder("", realRoot, realRoot, new Set());
+	return { files: files.toSorted((left, right) => byFolder(left.path, right.path)), roots };
+});
+
+export const listMarkdown = Effect.fn("WorkBoard.listMarkdown")(function* (root: string, realRoot: string) {
+	return (yield* scanMarkdown(root, realRoot)).files;
 });

package/src/files/markdownPath.ts

@@ -0,0 +1,31 @@
+import { Effect, FileSystem, Option, Path } from "effect";
+import { isMarkdown, within } from "./list.ts";
+
+export const markdownPath = Effect.fn("WorkBoard.markdownPath")(function* (root: string, realRoot: string, relative: string) {
+	if (!isMarkdown(relative) || relative.split("/").some((segment) => segment === "" || segment === "..")) {
+		return undefined;
+	}
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const segments = relative.split("/");
+	const ancestors = new Set([realRoot]);
+	let boundary = realRoot;
+	for (let index = 0; index < segments.length; index += 1) {
+		const real = yield* Effect.option(fs.realPath(path.join(root, ...segments.slice(0, index + 1))));
+		if (Option.isNone(real)) {
+			return undefined;
+		}
+		if (index === segments.length - 1) {
+			return within(boundary, path.sep, real.value) ? real.value : undefined;
+		}
+		const info = yield* Effect.option(fs.stat(real.value));
+		if (Option.isNone(info) || info.value.type !== "Directory" || ancestors.has(real.value) || within(real.value, path.sep, realRoot)) {
+			return undefined;
+		}
+		ancestors.add(real.value);
+		if (!within(boundary, path.sep, real.value)) {
+			boundary = real.value;
+		}
+	}
+	return undefined;
+});

package/src/files/watchDirectories.ts

@@ -0,0 +1,60 @@
+import { Data, Deferred, Effect, FileSystem, Option, Path, Stream } from "effect";
+import { isMarkdown, scanMarkdown } from "./list.ts";
+
+class WatchEnded extends Data.TaggedError("WatchEnded") {}
+
+const SETTLE = "100 millis";
+const BATCH = 256;
+
+export const watchDirectories = Effect.fn("WorkBoard.watchDirectories")(function* (
+	root: string,
+	realRoot: string,
+	stale: Effect.Effect<void>,
+	setWatching: (watching: boolean) => Effect.Effect<unknown>,
+	publish: (paths: readonly string[]) => Effect.Effect<unknown>,
+) {
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const cycle = Effect.scoped(
+		Effect.gen(function* () {
+			const { roots } = yield* scanMarkdown(root, realRoot);
+			const topology = yield* Deferred.make<void>();
+			// Node's recursive watcher can miss replacement of directory symlinks.
+			const parents = yield* Effect.forEach(
+				roots.filter((folder) => folder.relative !== ""),
+				(folder) =>
+					Effect.map(fs.realPath(path.dirname(path.join(root, folder.relative))), (real) => ({ real, relative: path.dirname(folder.relative) })),
+			);
+			const watched = [...roots.map((folder) => ({ ...folder, recursive: true })), ...parents.map((folder) => ({ ...folder, recursive: false }))];
+			const streams = watched.map((folder) =>
+				fs.watch(folder.real, { recursive: folder.recursive }).pipe(
+					Stream.map((event) => {
+						const local = path.isAbsolute(event.path) ? path.relative(folder.real, event.path) : event.path;
+						return path.join(folder.relative, local).split(path.sep).join("/");
+					}),
+				),
+			);
+			const watch = Stream.mergeAll(streams, { concurrency: "unbounded" }).pipe(
+				Stream.tap(() => stale),
+				Stream.tap((relative) =>
+					Effect.gen(function* () {
+						const info = yield* Effect.option(fs.stat(path.join(root, relative)));
+						const removedLink = roots.some((folder) => folder.relative === relative || folder.relative.startsWith(`${relative}/`));
+						if (Option.match(info, { onNone: () => removedLink, onSome: (value) => value.type === "Directory" })) {
+							yield* Effect.forkScoped(Effect.delay(Deferred.succeed(topology, undefined), SETTLE));
+						}
+					}),
+				),
+				Stream.filter(isMarkdown),
+				Stream.interruptWhen(Deferred.await(topology)),
+				Stream.groupedWithin(BATCH, SETTLE),
+				Stream.runForEach((paths) => publish([...new Set(paths)])),
+				Effect.andThen(Effect.flatMap(Deferred.isDone(topology), (changed) => (changed ? Effect.void : Effect.fail(new WatchEnded())))),
+			);
+			yield* Effect.forkScoped(Effect.delay(setWatching(true), SETTLE));
+			yield* watch;
+			yield* setWatching(false);
+		}),
+	);
+	yield* Effect.forever(cycle);
+});

package/src/history/baseline.ts

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