@shivaedev/work-board 0.12.0 → 0.14.0

package/dist/server/views/workHtml.d.ts

@@ -1,15 +0,0 @@
-import { Effect } from "effect";
-import type { Snapshot } from "#server/search/snapshot.ts";
-export declare const workHtml: (snapshot: Snapshot, state: {
-    readonly board: string;
-    readonly item: string;
-    readonly owner: string;
-    readonly query: string;
-    readonly sort: "owner" | "status" | "title";
-    readonly status: string;
-    readonly view: "board" | "table";
-}) => Effect.Effect<{
-    html: string;
-    status: number;
-}, import("../../render/failed.ts").RenderFailed, "WorkBoard/Highlighter">;
-//# sourceMappingURL=workHtml.d.ts.map

package/dist/server/views/workHtml.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workHtml.d.ts","sourceRoot":"","sources":["../../../src/server/views/workHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAS3D,eAAO,MAAM,QAAQ;;;;;;;;;;;0EA+BnB,CAAC"}

package/dist/server/views/workHtml.js

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

package/dist/server/views/workHtml.js.map

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

package/dist/server/views/workStyle.d.ts

@@ -1,2 +0,0 @@
-export declare function workStyle(): string;
-//# sourceMappingURL=workStyle.d.ts.map

package/dist/server/views/workStyle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workStyle.d.ts","sourceRoot":"","sources":["../../../src/server/views/workStyle.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,IAAI,MAAM,CAgBlC"}

package/dist/server/views/workStyle.js

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

package/dist/server/views/workStyle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workStyle.js","sourceRoot":"","sources":["../../../src/server/views/workStyle.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS;IACxB,OAAO;;;;;;;;;;;;;;CAcP,CAAC;AACF,CAAC"}

package/dist/server/views/workTable.d.ts

@@ -1,4 +0,0 @@
-import type { Item } from "./items.ts";
-import { type State } from "./state.ts";
-export declare function workTable(items: readonly Item[], state: State, waiting?: ReadonlyMap<string, string>): string;
-//# sourceMappingURL=workTable.d.ts.map

package/dist/server/views/workTable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workTable.d.ts","sourceRoot":"","sources":["../../../src/server/views/workTable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,KAAK,KAAK,EAAW,MAAM,YAAY,CAAC;AAgBjD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAAG,MAAM,CAOxH"}

package/dist/server/views/workTable.js

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

package/dist/server/views/workTable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workTable.js","sourceRoot":"","sources":["../../../src/server/views/workTable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAc,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjD,SAAS,GAAG,CAAC,IAAU,EAAE,KAAY,EAAE,OAAoC;IAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG;QACd,MAAM,CAAC,IAAI;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;QACnG,MAAM,CAAC,KAAK;QACZ,MAAM,CAAC,UAAU;KACjB,CAAC;IACF,OAAO,kBAAkB,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE;4BAC5D,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;GACzM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAsB,EAAE,KAAY,EAAE,OAAO,GAAgC,IAAI,GAAG,EAAE;IAC/G,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,qDAAqD,CAAC;IAC9D,CAAC;IACD,OAAO,8GAA8G,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;cAC9H,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;UAC/G,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC;AAC1F,CAAC"}

package/docs/delivery/change-history-examples.md

@@ -1,46 +0,0 @@
-# Local change history — step 08 contract
-
-This contract defines retained browser data and the meaning of “last looked”. Markdown files remain authoritative and are never written by the Changes view. Implementation and reader acceptance are tracked only in the roadmap.
-
-## One explicit review baseline per workspace
-
-The Changes view compares the current readable workspace with one snapshot the reader marked seen. First visit says **No previous snapshot**; **Start remembering changes** records the current workspace. Reading a diff or receiving a live update does not silently acknowledge it. **Mark current workspace seen** replaces the baseline after review. The view is **Changes since seen**.
-
-Browser storage is scoped by origin and workspace. Retain at most one snapshot, for at most 30 days, with at most 2 MiB of serialized data per workspace. It contains file paths and source text (including any recorded item IDs): old or deleted prose can therefore remain locally until replaced, cleared or expired. There is no server history, event journal, author identity, remote storage or synchronization.
-
-The private, versioned browser record has this shape:
-
-```json
-{
-  "version": 1,
-  "recorded_at": "2026-10-05T19:45:00Z",
-  "documents": [
-    {
-      "file": "items/search.md",
-      "source": "---\nid: work.search\nstatus: in-review\n---\n# Search\n"
-    }
-  ]
-}
-```
-
-The recorded time names the browser baseline observation, not when a source was written, who authored it or when a decision was accepted. Decode stored and HTTP boundary data with Schema; an invalid/unsupported record establishes no history.
-
-**Clear remembered history** removes the snapshot and stays off until the reader starts again. Expiry makes comparison unavailable at 30 days; stored data is removed on the next workspace visit (or a periodic check while the page remains open). On insufficient storage, an oversized workspace or an incomplete index, report why comparison is unavailable. Never silently truncate a baseline or interpret unreadable files as deletions. If persistence is blocked, a disclosed page-only baseline can still compare live source edits; reload cannot pretend that baseline survived. Ordinary source reading stays usable.
-
-## Concrete comparison examples
-
-| Recorded baseline → current source | Reader sees |
-| --- | --- |
-| `work.search` status `in-review` → `done` | Recorded status changed; no inferred acceptance |
-| Criterion evidence gains a record | Recorded evidence changed, with current source link and before/after plain text |
-| Decision options/rationale changes | Decision content changed; no invented new ruling |
-| Unchanged source repeatedly touched | No content change; activity is not progress |
-| New file after the baseline | Source added, with current source link |
-| Known file absent from a complete current index | Source removed; old source remains readable as retained text |
-| Same unique explicit item ID moves to another file | Source path changed for that item; compare its recorded content |
-| Plain file moves without a durable identity | Show old path removed/new path added; no claimed rename or authorship |
-| Duplicate item IDs at either observation | Do not choose an identity winner; disclose ambiguity |
-| First visit, clear, expiry or corrupt storage | History unavailable; no invented additions or progress |
-| One current file cannot be read | Comparison unavailable; no alleged removal |
-
-The browser owns its baseline. A same-origin, loopback-only private POST query validates the versioned record and compares it with the current observation; it does not retain server history or write source files. Old and current source are escaped plain text, never rendered as executable Markdown assets. A snapshot is an observation of readable files, not an atomic filesystem transaction or a verified Git revision. Revisions used to detect source changes must not be confused with recorded Git evidence.

package/docs/experience.md

@@ -1,89 +0,0 @@
-# Work Board experience design
-
-The [north star](./north-star.md) states the intent and the [roadmap](./roadmap.md) owns status. This document describes the proposed experience, not current behavior.
-
-## Visual direction
-
-A calm workroom: warm paper, ink typography, dark evergreen navigation, precise rules, and restrained amber for attention. Let diagrams, evidence, and readable prose carry the page. Use system fonts so the experience works without downloads. Status always has a label; color alone does not communicate meaning.
-
-Documents keep a readable measure. Boards and evidence comparisons use available width. Dense work has a compact setting; initial orientation has breathing room. Motion explains an update and respects reduced-motion preferences.
-
-## Five connected scenes
-
-| Scene | Core question | Composition |
-| --- | --- | --- |
-| Overview | What needs me, and what changed? | Short project brief, attention cards, active work, meaningful activity |
-| Work | Where is each item, and what happens next? | Board/table over the same items, filters, persistent detail pane |
-| Decision room | Which choice should we make, and why? | Question, options, recommendation, consequences, anchored response |
-| Evidence | What supports this result? | Criteria beside artifacts, source revision, verified/claimed/missing distinctions |
-| Project brief | How does the whole plan fit together? | Narrative, metrics, roadmap, dependency sketch, related decisions |
-
-After `pnpm --filter @shivaedev/work-board build`, serve the package folder with a local static server and open `docs/mockups/index.html`. The prototype illustrates connected reading and coordination scenes. It is a design review artifact; use the roadmap and README to assess current behavior. All project names, counts, agent activity, timestamps, and evidence are fictional.
-
-## Navigation and interaction
-
-The sidebar provides project context and stable destinations. Global search finds documents, work items, and decisions; a result opens the relevant context. A work item opens beside its board rather than replacing it. A direct URL should restore selection and view when the underlying source still exists.
-
-Overview prioritizes explicit questions, blockers, and review requests. Each attention card states why it appears and the consequence of answering it. Unranked work remains available; the queue is not an opaque AI score.
-
-The decision room presents competing options with consequences and evidence. Recording a choice should display what will change and who receives the next handoff. A revision request stays attached to the exact proposal reviewed.
-
-Evidence separates a tool result from an agent's claim. A green check requires supporting evidence for the relevant revision. If a criterion has no evidence, show that gap. If the proposal changed after review, retain the decision context and ask for another review where needed.
-
-## Source and state boundaries
-
-Project files hold authored work. An index of those files may be cached and reconstructed. Personal UI preferences and last-viewed markers may live locally outside the authored documents. Their absence must not change project meaning.
-
-Optional metadata gives items stable identity, relationships, status, provenance, and acceptance criteria. The serialization format is a design decision, not fixed by these mockups. Ordinary Markdown remains readable. Legacy heading-based boards remain supported; missing fields are unknown rather than guessed.
-
-Human response writes need explicit reviewed identity/context, draft retention and clear save outcomes. Agents edit ordinary files and own the surrounding project Markdown. Follow the [ownership boundary](delivery/source-editing-examples.md); do not turn rare outside-editor races into a universal transaction requirement.
-
-## Essential states beyond the happy path
-
-| State | Intended experience |
-| --- | --- |
-| Empty workspace | Explain the folder model; offer a small local template |
-| Watching interrupted | Keep readable content, show freshness loss, catch up on reconnect |
-| File deleted/renamed | Preserve context and offer a resolvable location; do not silently redirect to unrelated work |
-| Invalid metadata/reference | Render readable prose and an actionable source diagnostic |
-| Stale external evidence | Show source revision and last check; never imply current verification |
-| Concurrent edit | Keep the user's draft and show the changed source before retrying |
-| Pending handoff | Distinguish requested, acknowledged, running, and returned |
-| Failed response/write | Retain input and explain whether anything was saved |
-| Paused live updates | Display paused state and pending changes; resume deliberately |
-
-These states need production designs and tests; the vision prototype does not implement the server, persistence, conflict handling, or real agent communication.
-
-## Prototype use
-
-The [prototype](./mockups/index.html) uses local CSS and JavaScript, no dependencies, and no external network requests. It is designed for direct file opening; environments that restrict file URLs can use a loopback static server:
-
-```sh
-python -m http.server 4782 --bind 127.0.0.1 --directory packages/work-board/docs/mockups
-```
-
-Then open `http://127.0.0.1:4782`. Navigation, board/table switch, filter chips, item detail, search, evidence tabs, and the decision response are illustrative interactions. All changes stay in memory and reset on reload. The response buttons simulate the interface only; they do not write files or contact an agent.
-
-On smaller screens, navigation wraps and the work layout becomes a vertical list; production should further tune touch navigation and accessibility with user tests. The prototype is a review artifact and is not an implementation starting point or a proposed framework/dependency choice.
-
-## Screen gallery
-
-These captures show the same fictional local prototype. The [combined board](mockups/images/vision-board.png) summarizes the visual direction; individual images preserve the detail for review.
-
-| Scene | Desktop | Mobile |
-| --- | --- | --- |
-| Overview | [Attention and activity](./mockups/images/overview.png) | [Narrow layout](./mockups/images/overview-mobile.png) |
-| Work | [Board and item context](./mockups/images/work.png) | [Stacked lanes](./mockups/images/work-mobile.png) |
-| Decision room | [Options and direction](./mockups/images/decision.png) | [Options on mobile](./mockups/images/decision-mobile.png) |
-| Evidence | [Artifacts and criteria](./mockups/images/evidence.png) | [Review on mobile](./mockups/images/evidence-mobile.png) |
-| Project brief | [Narrative and visual plan](./mockups/images/brief.png) | [Brief on mobile](./mockups/images/brief-mobile.png) |
-
-![Overview: work that needs your attention](./mockups/images/overview.png)
-
-![Work: board and selected item](./mockups/images/work.png)
-
-![Decision room: options and a contextual response](./mockups/images/decision.png)
-
-![Evidence: artifacts beside acceptance criteria](./mockups/images/evidence.png)
-
-![Project brief: a visual home for the plan](./mockups/images/brief.png)