sign-off-axi 0.4.9 → 0.5.0

package/README.md

@@ -1,382 +1,111 @@
-<p align="center"><b>▶ <a href="https://umeranjum17.github.io/sign-off/">Try it live</a></b> — the real board on demo data: tap an answer and watch it save. No install, nothing leaves your browser.</p>
-
-<p align="center">
-  <img src="docs/media/demo-tap.gif" width="300" alt="Tap Yes on a demo question, see it saved, and read the saved answer back">
-</p>
-
 <p align="center">
-  <img src="docs/logo.svg" width="72" height="72" alt="sign-off logo">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark.svg">
+    <img src="docs/logo.svg" width="96" height="96" alt="sign-off logo: a white check mark on a blue tile">
+  </picture>
 </p>
 
 <h1 align="center">sign-off</h1>
 
-<p align="center"><b>One calm page for every question the programs working for you need answered.</b><br>Yes or no, pick-one, mock-ups, proof photos, short videos, sign-in links: each lands on a board on your own machine, you answer with one tap, and the answer is saved for the asker to read.</p>
+<p align="center"><b>One calm page for every question the programs working for you need answered.</b><br>Agents ask; you answer with one tap on your own machine; the answer is saved for the asker to read. Proof of finished work lands on the same page, so you check it instead of taking anyone's word.</p>
+
+<p align="center"><b>▶ <a href="https://umeranjum17.github.io/sign-off/demo/">Try it live</a></b>: the real board on demo data. No install, nothing leaves your browser. · <a href="https://umeranjum17.github.io/sign-off/">Website</a></p>
 
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/media/hero-dark.gif">
-    <img src="docs/media/hero.gif" width="420" alt="Ask, tap, answer: an agent raises a yes/no question, you tap Yes on your phone, the agent reads the saved answer">
+    <source media="(prefers-color-scheme: dark)" srcset="docs/media/desk-today-dark.webp">
+    <img src="docs/media/desk-today.webp" alt="The board at desk width: Today with what needs you, what was proven and a list of waiting asks">
   </picture>
 </p>
 
-## One-minute quick start
-
-```sh
-npm install -g sign-off-axi
-sign-off-axi raise \
-  --title "Keep the weekly \
-digest?" \
-  --why "The paid plan \
-renews Monday." \
-  --outcome yes="It keeps \
-going out." \
-  --outcome no="It stops \
-this week." \
-  --recommend yes \
-  --recommend-reason "Readers \
-still open it." \
-  --default yes
-sign-off-axi open
-```
-
-Open the printed URL, click **Yes**, then read the answer back the way an
-agent would:
+## Install in 3 steps
 
 ```sh
-sign-off-axi answers \
-  --key keep-the-weekly-digest
+npm install -g sign-off-axi          # 1. install from npm
+npx -y sign-off-axi init             # 2. in your project: set up .sign-off/ and the agent skill
+sign-off-axi open                    # 3. start the board and open the printed link
 ```
 
-That is the whole loop: the agent raises, you tap, the agent reads.
-Every question says why it is asked, what each answer does, which one the
-agent recommends and why, and what happens if you stay quiet; a question
-that does not is refused before it reaches you (see
-[the question standard](docs/contract.md#ask-schema-1)). The
-board is the default one (`~/.sign-off/decisions.json`); name a file after
-any command to use another board.
-
-## What you can ask
-
-One line on what the agent runs, one screenshot of what you see. The full
-reference for each kind lives in [docs/question-kinds.md](docs/question-kinds.md);
-the message rules are in [docs/contract.md](docs/contract.md).
-
-### Yes or no
-
-```sh
-sign-off-axi raise \
-  --title "Keep the weekly \
-digest?" \
-  --about "Open rate held \
-steady at about a third \
-for two months." \
-  --why "The paid plan \
-renews Monday." \
-  --outcome yes="It keeps \
-going out each Monday." \
-  --outcome no="It stops \
-after this week." \
-  --recommend yes \
-  --recommend-reason "Readers \
-still open it." \
-  --default yes \
-  --silent-by 2026-10-19T09:00Z
-```
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-yes-no-dark.webp">
-  <img src="docs/media/kind-yes-no.webp" alt="A yes/no question with the recommended Yes marked">
-</picture>
-
-*A yes/no ask. The recommended answer is marked.*
-
-### Pick one, with a recommendation
+Then ask your first question, the way an agent would, and answer it on the board:
 
 ```sh
 sign-off-axi raise \
-  --title "When should \
-the new settings \
-page go out?" \
-  --about "No new \
-bug reports for three \
-weeks." \
-  --why "Support is fully \
-staffed on Friday." \
-  --option today=Today \
-  --option friday=Friday \
-  --option next-week="Next \
-week" \
-  --outcome today="It goes \
-out now." \
-  --outcome friday="It goes \
-out with support on hand." \
-  --outcome next-week="It \
-waits a week." \
-  --recommend friday \
-  --recommend-reason "Support \
-can answer questions." \
-  --default next-week
-```
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-pick-one-dark.webp">
-  <img src="docs/media/kind-pick-one.webp" alt="A pick-one question with three options and Friday recommended">
-</picture>
-
-*Pick one of three. Friday is recommended; silence means next week.*
-
-### Design pick, with mocks A/B/C
-
-```sh
-sign-off-axi post \
-  --type design \
-  --title "Pick the settings \
-layout" \
-  --option a="Layout A" \
-  --option b="Layout B" \
-  --option c="Layout C" \
-  --mock a=mocks/a.html \
-  --mock b=mocks/b.html \
-  --mock c=mocks/c.html \
-  --tradeoff "A is fastest \
-to tap; B shows both \
-choices; C fits small \
-screens." \
-  --recommend b
-```
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-design-dark.webp">
-  <img src="docs/media/kind-design.webp" alt="Three mock-ups side by side in phone frames with Pick buttons, Layout B recommended">
-</picture>
-
-*Three layouts side by side. Layout B is recommended.*
-
-### Proof update, with Pass / Fail / Needs work
-
-```sh
-sign-off-axi post \
-  --type evidence \
-  --title "Settings page \
-loads in a second" \
-  --about "Umer opens \
-the new page on a phone." \
-  --media shot-light.png \
-  --media shot-dark.png
+  --title "Keep the weekly digest?" \
+  --why "The paid plan renews Monday." \
+  --outcome yes="It keeps going out." --outcome no="It stops this week." \
+  --recommend yes --recommend-reason "Readers still open it." --default yes
+sign-off-axi answers --key keep-the-weekly-digest   # read the tap back
 ```
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-evidence-dark.webp">
-  <img src="docs/media/kind-evidence.webp" alt="Evidence update 1 with two captures and Pass, Fail, Needs work buttons">
-</picture>
+You need Node 22.5 or newer. `init` installs the skill for each coding agent it finds on your `PATH`; `sign-off-axi --help` lists every command, and every command takes `--help`.
 
-*Proof of a fix, with two captures. Pass, Fail, or Needs work.*
+## The board
 
-Evidence lists every update, never in **Waiting on you**: a passed run shows a tick, and a plain update that links no run, a failed run or an unchecked run says its honest result, each with its verdicts and Dismiss on the update's own screen. **Proven today** counts every update filed today, each with its own result. Updates are grouped by the project named in the run's proof line, `verify-<project>: ...` (trimmed, compared without case); a proof line with no such prefix goes under **Other**.
+Four places, in the bar at the bottom of a phone and the sidebar on a desk.
 
-### Explainer video, with chapters
+<table>
+  <tr>
+    <td align="center" width="25%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-today-dark.webp"><img src="docs/media/phone-today.webp" alt="Today: counts of what needs you, what was proven and new reports, then the waiting asks"></picture><br><b>Today</b><br>What needs you, what was proven, what is new.</td>
+    <td align="center" width="25%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-decide-dark.webp"><img src="docs/media/phone-decide.webp" alt="Decide: one card per ask that waits on you, filtered by type"></picture><br><b>Decide</b><br>Every ask that waits on you, one tap each.</td>
+    <td align="center" width="25%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-evidence-dark.webp"><img src="docs/media/phone-evidence.webp" alt="Evidence: a capture of the finished work with its result, grouped by project"></picture><br><b>Evidence</b><br>Proof that a change works, with its honest result.</td>
+    <td align="center" width="25%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-reports-dark.webp"><img src="docs/media/phone-reports.webp" alt="Reports: explainer pages you asked for"></picture><br><b>Reports</b><br>Explainers you asked for, to read.</td>
+  </tr>
+</table>
 
-```sh
-sign-off-axi post \
-  --type explainer \
-  --title "Is the new \
-sign-in clear?" \
-  --about "Two steps: \
-password, then a code." \
-  --media explainer.mp4 \
-  --chapter 0:00=Start \
-  --chapter 0:02="The tap"
-```
+### Evidence is not a decision
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-explainer-dark.webp">
-  <img src="docs/media/kind-explainer.webp" alt="An explainer card with a video player, chapter buttons and Yes/No">
-</picture>
+**Decide** holds only real asks: things an agent cannot do without your answer. **Evidence** holds proof (screenshots or a short recording of the running product) with the result of the check that made it: Passed, Not run, Failed, Did not finish or Could not check. A proof update is never counted as something that needs you; you can give it a verdict (Pass, Fail or Needs work) or dismiss it. **Today** counts the two separately: what needs you, and what was proven today.
 
-*A short video with chapters, then Yes or No.*
+### Plans and reports, on their own pages
 
-### Explainer page, to read
+<table>
+  <tr>
+    <td align="center" width="33%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-plan-dark.webp"><img src="docs/media/phone-plan.webp" alt="A plan page: the idea in one picture, then each section to approve or change"></picture><br><b>Plan</b><br>Approve or change each section, answer each decision, send it all back at once.</td>
+    <td align="center" width="33%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-report-dark.webp"><img src="docs/media/phone-report.webp" alt="A report page: the answer first, then a diagram to tap through"></picture><br><b>Report</b><br>An explainer page: the answer first, then a diagram and steps to tap through.</td>
+    <td align="center" width="33%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-signin-dark.webp"><img src="docs/media/phone-signin.webp" alt="A sign-in card: the service, what it unlocks, who waits and the time left"></picture><br><b>Sign-in</b><br>An agent needs you to log in: tap Open, then it carries on.</td>
+  </tr>
+</table>
 
-```sh
-sign-off-axi report init \
-  .sign-off/mocks/sign-in
-d=mocks/sign-in
-sign-off-axi post \
-  --type report \
-  --title "Sign-in now \
-takes 2 steps" \
-  --about "Why the code \
-step moved first." \
-  --view $d/index.html \
-  --preview $d/preview.svg
-```
+A plan is what an agent wants to do before it starts. A report is an explanation you asked for. Both open over the board, and the board, not the agent's page, owns the answer buttons. A **sign-in card** goes to the top of Decide with the service, what it unlocks, who is waiting and the time left on the link; the agent closes it with `sign-off-axi signin done`.
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-report-dark.webp">
-  <img src="docs/media/kind-report.webp" alt="An explainer page: the answer in one sentence, a diagram, steps to tap through, folded details">
-</picture>
-
-*An explainer page to tap through and read.*
-
-### Diagram
-
-```sh
-sign-off-axi post \
-  --type diagram \
-  --title "Is this the \
-sign-in flow?" \
-  --about "Password first, \
-then a code, then in." \
-  --view flow.svg \
-  --recommend yes
-```
+### It keeps only what matters
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-diagram-dark.webp">
-  <img src="docs/media/kind-diagram.webp" alt="A question shown with a three-box flow diagram at card width">
-</picture>
+A board that fills up with noise stops being read, so the rules sit at the door.
 
-*A question drawn as a three-box flow.*
+- A question must say why it is asked, what each answer does, which one the agent recommends and what happens if you stay quiet; one that does not is refused with the fix ([the question standard](docs/contract.md#ask-schema-1)).
+- One decision is one card: raising the same question again changes nothing, and `--merge <key>` folds an older card into the better-asked one.
+- Proof posted as a Pass/Fail question is refused, and proof that is mostly text, a placeholder or a test card is refused too: proof goes to Evidence, as a capture of the real product; a report must be a page to tap, not a wall of words.
+- **Dismiss** hides a card from the board, **Undo** brings it back (`sign-off-axi dismiss <key>` and `restore <key>` do the same from a shell).
 
-### Interactive page
-
-```sh
-sign-off-axi post \
-  --type interactive \
-  --title "How many \
-testers approved?" \
-  --about "Tap the counter \
-to add yourself." \
-  --view counter.html \
-  --option yes=Yes \
-  --option no="Needs \
-work" \
-  --recommend yes
-```
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-interactive-dark.webp">
-  <img src="docs/media/kind-interactive.webp" alt="A question with a sandboxed counter page to tap">
-</picture>
-
-*A live counter to tap, in a sandboxed page.*
-
-### Sign-in link
-
-```sh
-sign-off-axi post \
-  --type signin \
-  --service "npm" \
-  --link \
-https://example.com/abc123 \
-  --unlocks "Publish \
-the release" \
-  --waits "Umer" \
-  --expires 15m \
-  --key npm-login
-```
-
-Later, when it worked:
-
-```sh
-sign-off-axi signin done \
-  --key npm-login
-```
-
-To hide a card as the Dismiss button does, or bring it back: `sign-off-axi dismiss <key>` and `sign-off-axi restore <key>`.
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-signin-dark.webp">
-  <img src="docs/media/kind-signin.webp" alt="A sign-in card on top with an Open button, what it unlocks, who waits and the time left">
-</picture>
-
-*A sign-in card: what it unlocks, who waits, the time left.*
-
-### Release gate
-
-```sh
-sign-off-axi post \
-  --kind gate \
-  --from gate.json
-```
-
-A `gate.json` holds a run for the user: Approve or Fix first.
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-gate-dark.webp">
-  <img src="docs/media/kind-gate.webp" alt="A gate question with Approve recommended and Fix first">
-</picture>
-
-*A held run: Approve it or Fix first.*
-
-### Retro finding
-
-```sh
-sign-off-axi post \
-  --kind finding \
-  --from finding.json
-```
-
-A `finding.json` asks the user to Apply or Skip a proposed fix.
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/kind-finding-dark.webp">
-  <img src="docs/media/kind-finding.webp" alt="A finding question with Apply recommended and Skip">
-</picture>
-
-*A retro fix to Apply or Skip.*
-
-## On your phone
-
-The same board on a phone, light and dark.
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/phone-dark.webp">
-  <img src="docs/media/phone-light.webp" width="320" alt="Board summary on a phone in light mode">
-</picture>
-
-*The summary, the waiting list, and the answers, in a phone frame.*
-
-## On your screen
-
-The waiting list and the summary at desk width, light and dark.
+## What you can ask
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/desktop-dark.webp">
-  <img src="docs/media/desktop-light.webp" alt="Board summary at desk width in light mode">
-</picture>
+One line on what the agent runs per kind; the full reference is [docs/question-kinds.md](docs/question-kinds.md) and the message rules are in [docs/contract.md](docs/contract.md).
 
-*Everything in one glance: waiting, evidence, explainers, answered.*
+| Kind | The agent runs | You see |
+|---|---|---|
+| Yes or no, pick one | `raise --title ... --recommend ...` | buttons, the recommended one first |
+| Design pick (mocks A/B/C) | `post --type design --mock a=... --mock b=... --link a=<url>` | mocks side by side, an Open live link under each option that has a `--link`, a note on any part |
+| Proof update | `post --type evidence --media shot.png` | the capture, its result, Pass / Fail / Needs work |
+| Explainer video | `post --type explainer --media clip.mp4 --chapter 0:00=Start` | a player with chapter buttons, then Yes or No |
+| Report page | `report init <folder>`, then `post --type report --view ...` | a page to tap through |
+| Diagram, interactive page | `post --type diagram --view flow.svg` | the picture on the card; interactive pages run sandboxed |
+| Plan | `post --kind plan --from plan.json` | sections to approve or change, decisions to answer |
+| Sign-in link | `post --type signin --service npm --link <url> --unlocks ...` | an Open button and the time left |
 
 ## How agents use it
 
-Every item records who filed it, and that agent gets the answer as an
-event, by itself: the agent raises with `--filer my-agent` and blocks on
-`sign-off-axi wait --filer my-agent`, which returns only that filer's
-answers, each once, and the card shows **Seen by agent**. An agent that
-cannot block can be woken instead: an `on_answer:` line in the
-`config.yaml` beside the board names a command the board runs for every
-answer. A `notify:` block in that config can send an HTTP POST when a card
-enters Waiting on you, with its bearer token read from a named environment
-variable, or, with `receiver: muxr`, from the muxr host's `notify-token`
-file; `sign-off-axi notify test` sends a test notice. The full reference, with the worked example, is in
-[docs/commands.md](docs/commands.md).
-
-Every command takes `--help` and prints compact output with next-step hints.
-sign-off itself calls no model and inherits the calling agent's model routing.
+Every item records who filed it. The agent raises with `--filer my-agent`, then blocks on `sign-off-axi wait --filer my-agent`, which returns that filer's answers, each once, and the card shows **Seen by agent**. An agent that cannot block can be woken instead: an `on_answer:` line in the `config.yaml` beside the board names a command the board runs for every answer, and a `notify:` block can send an HTTP POST when a card enters Decide. The worked examples are in [docs/commands.md](docs/commands.md).
 
-## Install
+sign-off itself calls no model and inherits the calling agent's model routing. The shipped skill is deliberately thin: it tells the agent how to write a good card and defers to `sign-off-axi --help` for every flag, so an installed copy never goes stale.
 
-```sh
-npm install -g sign-off-axi
-```
+## Works alone, or with its siblings
 
-In a project folder, one command sets up `.sign-off/` and installs the
-skill for each coding agent on your `PATH`:
+sign-off stands alone: the CLI and the skill need no other tool and no supervisor. They connect through one small written contract ([docs/contract.md](docs/contract.md)):
 
-```sh
-npx -y sign-off-axi init
-```
+- **done-done** (verification) posts its proof as Evidence and holds a run for your Approve or Fix first as a gate.
+- **learn-from-mistakes** (retros) posts each proposed change as a finding for you to Apply or Skip.
+- **first-draft** (design) writes its review links into a design card, shown as real links to open the mock-up.
+- **An agent supervisor**, such as Firstmate, or a lone agent in a terminal: both post the same asks, plans and reports and read the same answers.
 
 ## Docs and reference
 
@@ -397,12 +126,14 @@ npm pack
 ```
 
 - `npm test`: full journeys
-- `npm run build:skill`: skill stub
-- `npm run build:demo`: demo site (Try it live)
+- `npm run build:skill`: writes the skill from `src/skill.ts`
+- `npm run build:demo`: the website (`site/`) and the demo board at `/demo/`, built into `demo-dist/`
 - `npm pack`: tarball
 
 A release is a merged version-bump PR: CI publishes the new version to npm.
 
+Change what a user sees or runs, and update this README, the skill (`src/skill.ts`), the website (`site/index.html`) and any screenshot they show in the same PR.
+
 ### Test runs never touch your board
 
 With no board named, a bare command uses the nearest `.sign-off/` that

package/dist/cli.js

@@ -28,8 +28,8 @@ const AGENTS = {
     'gemini-cli': { bin: 'gemini', dir: '.agents/skills', home: join(homedir(), '.gemini', 'skills') },
 };
 const TOP_HELP = `usage: sign-off-axi [command] [board.json] [flags]
-commands[20]:
-  (none)=list, raise, post, answers, wait, poll, open, status, stop, serve, export, init, report, signin, dismiss, restore, doctor, notify, validate, help
+commands[21]:
+  (none)=list, raise, post, answers, wait, poll, open, status, stop, serve, export, init, report, signin, dismiss, restore, refile, doctor, notify, validate, help
 board: the nearest .sign-off/ board (the walk's bounds and SIGN_OFF_HOME: README, "Test runs never touch your board"), else ~/.sign-off/decisions.json; a board file given always wins
 flags: --full and --json on list, answers and wait, --events on wait, --json on status, --filer on post, raise and wait, --help on every command, -v/--version
 examples:
@@ -176,7 +176,7 @@ Runs the board in the foreground until Ctrl-C; --port 0 picks a free port, and i
 examples:
   sign-off-axi serve --port 0
 `,
-    post: `usage: sign-off-axi post [board.json] [--type decision|design|diagram|interactive] --title "<question>" [--key <key>] [--about <text>] [--option <value>=<label>]... [--mock <value>=<path>]... [--view <path>] [--tradeoff <text>] [--recommend <value>] [--default <value>] [--close done|release] [--filer <id>]
+    post: `usage: sign-off-axi post [board.json] [--type decision|design|diagram|interactive] --title "<question>" [--key <key>] [--about <text>] [--option <value>=<label>]... [--mock <value>=<path>]... [--link <value>=<url>]... [--view <path>] [--tradeoff <text>] [--recommend <value>] [--default <value>] [--close done|release] [--filer <id>]
        sign-off-axi post [board.json] --type evidence --title "<what this shows>" --about "<short note>" --media <file>... [--link <commit or URL>] [--detail <text>] [--filer <id>]
        sign-off-axi post [board.json] --from <board file> --replace [--filer <id>]
        sign-off-axi post [board.json] --kind <kind> --from <message.json|-> [--filer <id>]
@@ -197,6 +197,7 @@ Listing --option needs --recommend <value>, on every type: the option you would
 SIGN_OFF_FILER sets it for every command; with neither, the Claude Code session id is saved when there is one.
 --type design is a pick between up to 6 options shown side by side, each with an optional board-relative mock file
 (.html, .svg, .png, .jpg, .jpeg, .webp, 5 MB or less), a --tradeoff line and a --recommend badge.
+One --link <value>=<url> per option (http or https) draws an Open link under that option's mock, outside its sandboxed frame; the option needs a --mock.
 One .html page can hold every variant: --mock a=mocks/<key>/index.html?variant=a and so on; the page reads ?variant= to show one.
 An .html mock or view loads the css, scripts, images and fonts beside it by relative name, from its own folder only.
 After the user picks, answers --key <key> --json holds the pick and note; "rounds" holds an ask for another round.
@@ -218,8 +219,9 @@ and played on the card. --about is its short summary; up to ${CHAPTERS_MAX} --ch
 --view is the page and --preview its picture on the card, beside it, both from the board file's folder; \`sign-off-axi report init <folder>\` makes them.
 The page must be filled (no FILL: line left), with a viewport tag, dark mode, a picture, something to tap, its detail folded, nothing from the web, and no block over about five lines on a phone.
 Merges, PR outcomes, receipts and status notes are not reports: post proof of a change as evidence.
+A proof is never an ask: a new ask that offers Pass and Fail is refused. sign-off-axi refile <key> --media <file> re-files an old one as evidence.
 --type signin asks the user to sign in, at the top of what waits: the service, one Open button for the http(s) --link, what it unlocks,
-who waits, and the time left until --expires (an ISO date-time, or 90s, 15m, 2h, 1d from now). After that time the card says the link expired.
+who waits, and the time left until --expires (an ISO date-time, or 90s, 15m, 2h, 1d from now). After that time the card leaves the board on its own.
 No output prints the link. Post again with the same --key and a new --link or --expires to put a new link on the same card; it waits again.
 When the sign-in is done, run \`sign-off-axi signin done [board.json] --key <key>\`: the card leaves the open list and shows as done.
 For a link that expires fast, give --start, the command that prints a new sign-in link, as a JSON list such as '["npm", "login", "--auth-type=web"]'.
@@ -256,6 +258,11 @@ restore <key> [board.json] brings it back. Find the key with \`sign-off-axi list
 examples:
   sign-off-axi dismiss ship-the-new-sign-in-screen-this-week
   sign-off-axi restore ship-the-new-sign-in-screen-this-week
+`,
+    refile: `usage: sign-off-axi refile <key> [board.json] --media <file>... [--link <commit or URL>]
+Re-files a proof that was posted as a Pass/Fail ask as an evidence update, which never waits on the user: posts --type evidence with the ask's title and note and your capture, then dismisses the ask.
+examples:
+  sign-off-axi refile sign-in-looks-right --media sign-in.png --link https://github.com/acme/app/pull/12
 `,
     restore: `usage: sign-off-axi restore <key> [board.json]
 Brings back a card that dismiss hid. See \`sign-off-axi dismiss --help\`.
@@ -808,11 +815,15 @@ const mockFile = (path) => path.split('?')[0];
 /** Posts an item. `raise` is the alias for `post --type decision`: same flags as before, same output. */
 function post(args, cmd = 'post') {
     const typed = cmd === 'post' ? { replace: { type: 'boolean' }, kind: { type: 'string' }, type: { type: 'string' }, tradeoff: { type: 'string' }, mock: { type: 'string', multiple: true },
-        media: { type: 'string', multiple: true }, link: { type: 'string' }, view: { type: 'string' }, preview: { type: 'string' }, chapter: { type: 'string', multiple: true },
+        media: { type: 'string', multiple: true }, link: { type: 'string', multiple: true }, view: { type: 'string' }, preview: { type: 'string' }, chapter: { type: 'string', multiple: true },
         ...Object.fromEntries(SIGNIN_FIELDS.map((f) => [f, { type: 'string' }])) } : {};
     const { file, named, values, on } = parse(cmd, args, { from: { type: 'string' }, filer: { type: 'string' }, ...typed,
         ...Object.fromEntries(RAISE_FIELDS.map((f) => [f, { type: 'string', multiple: MANY.includes(f) }])) });
     const given = [...RAISE_FIELDS, 'type', 'tradeoff', 'mock', 'media', 'link', 'view', 'preview', 'chapter', ...SIGNIN_FIELDS].filter((f) => values[f] !== undefined);
+    // Only a design takes --link more than once (one per option); any other type keeps its one item link, the last given.
+    const optionLinks = values.link ?? [];
+    if (values.type !== 'design' && optionLinks.length)
+        values.link = optionLinks.at(-1);
     if (values.kind !== undefined) {
         const odd = [...given, ...(values.replace ? ['replace'] : [])][0];
         if (odd)
@@ -844,8 +855,8 @@ function post(args, cmd = 'post') {
         throw fail(`--type must be decision, design, evidence, diagram, interactive, explainer, report or signin`, 'VALIDATION_ERROR', 'Run `sign-off-axi post --help`');
     if (type === 'evidence' || type === 'explainer')
         return postMedia(file, named, on, values, type, filer);
-    if (values.media !== undefined || values.link !== undefined || values.chapter !== undefined)
-        throw fail('--media, --link and --chapter need --type evidence or explainer', 'VALIDATION_ERROR', 'Run `sign-off-axi post --help`');
+    if (values.media !== undefined || (type !== 'design' && values.link !== undefined) || values.chapter !== undefined)
+        throw fail('--media, --link and --chapter need --type evidence or explainer (--link also goes on --type design, one per option)', 'VALIDATION_ERROR', 'Run `sign-off-axi post --help`');
     if (type !== 'design' && (values.tradeoff !== undefined || values.mock !== undefined))
         throw fail('--tradeoff and --mock need --type design', 'VALIDATION_ERROR', 'Run `sign-off-axi post --help`');
     const view = type === 'diagram' || type === 'interactive';
@@ -897,8 +908,12 @@ function post(args, cmd = 'post') {
         if (info && (!info.isFile() || info.size > MOCK_BYTES)) {
             throw fail(`--mock ${path} must be a file of 5 MB or less`, 'VALIDATION_ERROR', 'Shrink the mock, or point --mock at the screenshot of the variant');
         }
-        return { value: m.slice(0, at), path };
+        const value = m.slice(0, at), link = optionLinks.find((l) => l.startsWith(`${value}=`));
+        return { value, path, ...(link && { link: link.slice(value.length + 1) }) };
     });
+    const lost = optionLinks.find((l) => !mocks?.some((m) => l.startsWith(`${m.value}=`)));
+    if (type === 'design' && lost !== undefined)
+        throw fail(`--link ${lost} must be <value>=<url> with a --mock for that value`, 'VALIDATION_ERROR', 'sign-off-axi post --type design --title "<question>" --option a=A --option b=B --mock a=mocks/a.html --link a=https://example.com/a --recommend a');
     return storeIncoming(file, named, on, buildIncoming(values, { type, tradeoff: values.tradeoff, mocks }, filer, file), filer);
 }
 const SIGNIN_FIELDS = ['service', 'unlocks', 'waits', 'expires', 'start'];
@@ -999,6 +1014,21 @@ function dismiss(restoring) {
         });
     };
 }
+/** refile <key> [board.json] --media <file>...: an old proof posted as a Pass/Fail ask becomes an evidence update (title and note kept), and the ask is dismissed. */
+async function refile(args) {
+    const at = args.findIndex((a) => !a.startsWith('-') && !existsSync(a) && !a.endsWith('.json')), key = args[at];
+    if (at < 0)
+        throw fail('refile needs a card key', 'VALIDATION_ERROR', 'sign-off-axi refile <key> --media shot.png');
+    const { file, named, on, values } = parse('refile', args.filter((_, i) => i !== at), { media: { type: 'string', multiple: true }, link: { type: 'string' }, filer: { type: 'string' } });
+    const old = board(file).find((x) => x.key === key);
+    if (!old)
+        throw fail(`no card with key ${key} on ${tilde(file)}`, 'NOT_FOUND', `Run \`sign-off-axi list${on} --full\` to see the keys`);
+    if (!waits(old) || !['pass', 'fail'].every((v) => old.options.some((o) => o.value === v)))
+        throw fail(`${key} is not a waiting Pass/Fail ask`, 'VALIDATION_ERROR', 'refile takes a proof still waiting on the user as a Pass/Fail ask');
+    const posted = await postMedia(file, named, on, { title: old.title, about: old.about?.trim() || old.title, media: values.media, link: values.link ?? old.link }, 'evidence', filerOf(values, true));
+    locked(`${file}.lock`, () => appendDismissed(file, [key], true));
+    return posted;
+}
 /** For a program that feeds the board: the --from file, checked like any post, becomes the whole board, items and top-level fields. Answers stay.
  * With a filer it replaces only that filer's items (and items with no filer it names by key); every other item and top-level field stays. */
 function replace(file, named, on, from, filer) {
@@ -1406,6 +1436,10 @@ function storeIncoming(file, named, on, { incoming, raw }, filer, exact = false)
     return locked(`${file}.lock`, () => {
         const current = board(file), items = existsSync(file) ? readItems(file).items : [], saved = readAnswers(file), now = new Date().toISOString();
         checkMerges(incoming, [...current.filter((c) => !incoming.some((d) => d.key === c.key)), ...incoming], current);
+        // Proof is evidence: a new ask that offers Pass and Fail would sit in Waiting on you as an ask, so it is refused.
+        const proof = incoming.find((d) => d.type === 'decision' && !d.kind && !current.some((c) => c.key === d.key) && ['pass', 'fail'].every((v) => d.options.some((o) => o.value === v)));
+        if (proof)
+            throw fail(`key ${proof.key} offers Pass and Fail: a proof is not an ask and would wait on you`, 'VALIDATION_ERROR', 'Post it with sign-off-axi post --type evidence --title "<what this shows>" --about "<short note>" --media <file>');
         const raised = incoming.map((d, i) => {
             const had = current.find((c) => c.key === d.key);
             // A contract message refused for its key exits 2 like any other refusal (contract section 4); raise --title keeps exit 1.
@@ -2218,6 +2252,9 @@ async function exportBoard(args) {
     return toon({ board: tilde(parsed.file), exported: tilde(out), items: frozen.decisions.length, inlined: Object.keys(files).length, ...(missing && { missing }) }, [`Open ${tilde(out)} in a browser: one read-only file, no server needed`]);
 }
 const page = readFileSync(new URL('../web/index.html', import.meta.url));
+/** The board's favicon, home-screen icon and install manifest, served beside the page; see web/icon.svg. */
+const ICONS = Object.fromEntries([['icon.svg', 'image/svg+xml'], ['apple-touch-icon.png', 'image/png'], ['icon-192.png', 'image/png'], ['icon-512.png', 'image/png'], ['icon-maskable-512.png', 'image/png'], ['manifest.webmanifest', 'application/manifest+json']]
+    .map(([name, type]) => [`/${name}`, { type, bytes: readFileSync(new URL(`../web/${name}`, import.meta.url)) }]));
 /** Added to each design mock page and plan page so the person can point at a part of it; see web/point.js. */
 const pointer = Buffer.from(`<script>${readFileSync(new URL('../web/point.js', import.meta.url), 'utf8')}</script>`);
 const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
@@ -2374,10 +2411,22 @@ function under(root, rel) {
         throw new EvidenceError('mock path escapes the board folder');
     return actual;
 }
-function contained(path, missing = 'A picture or recording of the proof is missing.') {
+/** The folder holding a run's record: --evidence-root, else the app folder done-done keeps it in (~/.done-done/evidence/<app>); '' when no folder holds it. */
+function rootOf(runId) {
+    if (evidenceRoot)
+        return evidenceRoot;
+    const store = join(homedir(), '.done-done', 'evidence');
+    try {
+        return readdirSync(store).map((app) => join(store, app)).find((dir) => existsSync(join(dir, '.done-done', 'runs', `${runId}.json`))) ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+function contained(evidence, path, missing = 'A picture or recording of the proof is missing.') {
     let root, actual;
     try {
-        root = realpathSync(evidenceRoot);
+        root = realpathSync(evidence);
         actual = realpathSync(resolve(root, path));
     }
     catch {
@@ -2388,12 +2437,13 @@ function contained(path, missing = 'A picture or recording of the proof is missi
     return actual;
 }
 /** A linked run as the board checked it; the reason a check failed is a plain sentence for the card.
- * With no --evidence-root the board cannot check a run at all, so the card shows no result rather than one that blames the run. */
+ * With no --evidence-root the board looks in done-done's own folder for the app; a run it finds nowhere cannot be checked, so the card shows no result rather than one that blames the run. */
 function evidenceCard(link) {
-    if (!evidenceRoot)
+    const root = rootOf(link.run_id);
+    if (!root)
         return null;
     try {
-        const recordPath = contained(`.done-done/runs/${link.run_id}.json`, 'The proof for this run is missing.');
+        const recordPath = contained(root, `.done-done/runs/${link.run_id}.json`, 'The proof for this run is missing.');
         if (statSync(recordPath).size > 1_000_000)
             throw new EvidenceError('The proof for this run is too large to read.');
         const run = JSON.parse(readFileSync(recordPath, 'utf8'));
@@ -2408,7 +2458,7 @@ function evidenceCard(link) {
             const type = mediaTypes[extname(f.path ?? '').toLowerCase()];
             if (!type)
                 return [];
-            const path = contained(f.path);
+            const path = contained(root, f.path);
             if (statSync(path).size > 20_000_000)
                 throw new EvidenceError('A picture or recording of the proof is too large.');
             const bytes = readFileSync(path);
@@ -2471,7 +2521,7 @@ async function route(req) {
         const card = evidenceCard(decision.evidence);
         if (card?.status !== 'verified' || !card.media.some((m) => m.path === path))
             return [404, { error: 'Evidence is unavailable' }];
-        const actual = contained(path), type = mediaTypes[extname(path).toLowerCase()];
+        const actual = contained(rootOf(runId), path), type = mediaTypes[extname(path).toLowerCase()];
         return [200, { media: readFileSync(actual), type }];
     }
     if (req.method === 'GET' && req.url?.startsWith('/api/media?')) {
@@ -2778,6 +2828,9 @@ const server = createServer(async (req, res) => {
         if (given !== null)
             return res.writeHead(303, { location: '/', 'set-cookie': `${cookie}=${token}; Path=/; HttpOnly; SameSite=Lax; Max-Age=31536000` }).end();
     }
+    const icon = req.method === 'GET' ? ICONS[req.url ?? ''] : undefined;
+    if (icon)
+        return res.writeHead(200, { 'content-type': icon.type, 'cache-control': 'public, max-age=86400' }).end(icon.bytes);
     if (req.method === 'GET' && req.url === '/favicon.ico')
         return res.writeHead(204).end();
     if (req.method === 'GET' && req.url === '/') {
@@ -2817,7 +2870,7 @@ await runAxiCli({
     topLevelHelp: TOP_HELP,
     getCommandHelp: (cmd) => HELP[cmd],
     home: axi('list', list),
-    commands: { list: axi('list', list), raise: axi('raise', (args) => post(args, 'raise')), post: axi('post', post), answers: axi('answers', answers), wait: axi('wait', wait), poll: axi('poll', poll), open: axi('open', open), status: axi('status', status), stop: axi('stop', stop), serve: axi('serve', serve), export: axi('export', exportBoard), init: axi('init', init), report: axi('report', report), signin: axi('signin', signin), dismiss: axi('dismiss', dismiss(false)), restore: axi('restore', dismiss(true)), doctor: axi('doctor', doctor), notify: axi('notify', notify), validate, help: ([name, ...rest]) => {
+    commands: { list: axi('list', list), raise: axi('raise', (args) => post(args, 'raise')), post: axi('post', post), answers: axi('answers', answers), wait: axi('wait', wait), poll: axi('poll', poll), open: axi('open', open), status: axi('status', status), stop: axi('stop', stop), serve: axi('serve', serve), export: axi('export', exportBoard), init: axi('init', init), report: axi('report', report), signin: axi('signin', signin), dismiss: axi('dismiss', dismiss(false)), restore: axi('restore', dismiss(true)), refile: axi('refile', refile), doctor: axi('doctor', doctor), notify: axi('notify', notify), validate, help: ([name, ...rest]) => {
             if (rest.length || (name && !HELP[name]))
                 throw fail(`unknown command or argument: ${[name, ...rest].join(' ')}`, 'VALIDATION_ERROR', 'Run `sign-off-axi --help` to see the commands');
             return name ? HELP[name] : TOP_HELP;

package/dist/store.js

@@ -26,6 +26,8 @@ const STORED = {
 };
 export const CHAPTERS_MAX = 12;
 const isText = (v) => typeof v === 'string';
+/** An http(s) link of up to 500 characters with no spaces: an item's `link` (besides a commit hash) and a design option's. */
+const HTTP_LINK = /^https?:\/\/\S{1,500}$/u;
 export const isKey = (v) => isText(v) && /^[A-Za-z0-9._-]{1,128}$/.test(v);
 const ONE_OF = { close: ['done', 'release'], area: ['waiting', 'evidence', 'reports', 'answered'] };
 /** What a step uses or can stop on: an AI model, a store, a gate, a hard fail. */
@@ -135,7 +137,7 @@ export function loadDecisions(path, board) {
         if (d.type === 'evidence' && !(Number.isInteger(d.number) && d.number >= 1))
             throw bad('number', 'must be a whole number from 1');
         const signin = d.type === 'signin';
-        if (d.link !== undefined && !(isText(d.link) && /^(https?:\/\/\S{1,500}|[a-f0-9]{7,40})$/u.test(d.link)) && !signin)
+        if (d.link !== undefined && !(isText(d.link) && (HTTP_LINK.test(d.link) || /^[a-f0-9]{7,40}$/u.test(d.link))) && !signin)
             throw bad('link', 'must be an http(s) link or a commit hash');
         // A sign-in is a link to open, what it unlocks and who waits; its answer is the `signin done` its poster saves, so the user gets no buttons.
         if (signin) {
@@ -205,6 +207,8 @@ export function loadDecisions(path, board) {
                 || !d.mocks.every((m) => isKey(m?.value) && isText(m?.path) && m.path.trim() && m.path.length <= 256 && /^[^?#]+(\.html\?variant=[A-Za-z0-9._-]{1,64})?$/i.test(m.path))) {
                 throw bad('mocks', 'must list up to 6 items, each an option value and a board-relative mock path (an .html page may end in ?variant=<name>)');
             }
+            if (!d.mocks.every((m) => m.link === undefined || (isText(m.link) && HTTP_LINK.test(m.link))))
+                throw bad('mocks', 'a link must be an http(s) link with no spaces');
             const targets = d.mocks.map((m) => m.value);
             if (new Set(targets).size < targets.length)
                 throw bad('mocks', 'option values must be unique');
@@ -216,7 +220,7 @@ export function loadDecisions(path, board) {
             key: d.key, title: d.title, about: d.about, detail: d.detail, options: options.map((o) => ({ value: o.value, label: o.label, ...(o.outcome && { outcome: o.outcome }) })),
             ...(d.why && { why: d.why }), ...(d.recommend_reason && { recommend_reason: d.recommend_reason }), ...(d.silent_by && { silent_by: d.silent_by }), ...(d.merges && { merges: [...d.merges] }), ...(d.proof && { proof: d.proof }),
             recommend_value: d.recommend_value, default_if_silent: d.default_if_silent, close: d.close ?? 'done', evidence: d.evidence,
-            type: plan ? 'plan' : d.type ?? 'decision', tradeoff: d.tradeoff, link: d.link, mocks: d.mocks?.map((m) => ({ value: m.value, path: m.path })),
+            type: plan ? 'plan' : d.type ?? 'decision', tradeoff: d.tradeoff, link: d.link, mocks: d.mocks?.map((m) => ({ value: m.value, path: m.path, ...(m.link !== undefined && { link: m.link }) })),
             ...(views && { view: d.view }), ...(report && views && { preview: d.preview }), ...(d.reply && { reply: true }), ...(d.filer && { filer: d.filer }), ...(d.area && { area: d.area }),
             ...(signin && { unlocks: d.unlocks, waits: d.waits, ...(d.expires && { expires: d.expires }), ...(d.start && { start: [...d.start] }) }),
             ...(d.group && { group: d.group }), ...(d.filed && { filed: d.filed }), ...(d.decided && { decided: d.decided }),

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "sign-off-axi",
-  "version": "0.4.9",
+  "version": "0.5.0",
   "description": "One review board for evidence, quick yes/no decisions and retro changes.",
   "type": "module",
   "bin": { "sign-off-axi": "dist/cli.js" },
   "files": ["dist", "!dist/skill.js", "web", "fixtures/contract"],
   "engines": { "node": ">=22.5" },
   "license": "MIT",
+  "homepage": "https://umeranjum17.github.io/sign-off/",
   "repository": { "type": "git", "url": "git+https://github.com/umeranjum17/sign-off.git" },
   "keywords": ["axi", "agent", "cli", "toon", "decisions", "review"],
   "scripts": {

package/web/icon.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" width="1024" height="1024">
+<defs>
+<linearGradient id="l" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#6A93FF"/><stop offset="1" stop-color="#2C48D3"/></linearGradient>
+<linearGradient id="d" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#2C2C2E"/><stop offset="1" stop-color="#0B0B0C"/></linearGradient>
+<linearGradient id="h" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#fff" stop-opacity=".28"/><stop offset=".35" stop-color="#fff" stop-opacity="0"/></linearGradient>
+</defs>
+<path d="M1024,512L1024,646L1024,688L1023,719L1022,745L1021,766L1019,785L1018,802L1016,818L1014,832L1011,845L1009,858L1006,869L1003,880L999,890L995,900L991,909L987,918L982,926L977,934L972,941L967,948L961,955L955,961L948,967L941,972L934,977L926,982L918,987L909,991L900,995L890,999L880,1003L869,1006L858,1009L845,1011L832,1014L818,1016L802,1018L785,1019L766,1021L745,1022L719,1023L688,1024L646,1024L512,1024L378,1024L336,1024L305,1023L279,1022L258,1021L239,1019L222,1018L206,1016L192,1014L179,1011L166,1009L155,1006L144,1003L134,999L124,995L115,991L106,987L98,982L90,977L83,972L76,967L69,961L63,955L57,948L52,941L47,934L42,926L37,918L33,909L29,900L25,890L21,880L18,869L15,858L13,845L10,832L8,818L6,802L5,785L3,766L2,745L1,719L0,688L0,646L0,512L0,378L0,336L1,305L2,279L3,258L5,239L6,222L8,206L10,192L13,179L15,166L18,155L21,144L25,134L29,124L33,115L37,106L42,98L47,90L52,83L57,76L63,69L69,63L76,57L83,52L90,47L98,42L106,37L115,33L124,29L134,25L144,21L155,18L166,15L179,13L192,10L206,8L222,6L239,5L258,3L279,2L305,1L336,0L378,0L512,0L646,0L688,0L719,1L745,2L766,3L785,5L802,6L818,8L832,10L845,13L858,15L869,18L880,21L890,25L900,29L909,33L918,37L926,42L934,47L941,52L948,57L955,63L961,69L967,76L972,83L977,90L982,98L987,106L991,115L995,124L999,134L1003,144L1006,155L1009,166L1011,179L1014,192L1016,206L1018,222L1019,239L1021,258L1022,279L1023,305L1024,336L1024,378Z" fill="url(#l)"/>
+<path d="M1024,512L1024,646L1024,688L1023,719L1022,745L1021,766L1019,785L1018,802L1016,818L1014,832L1011,845L1009,858L1006,869L1003,880L999,890L995,900L991,909L987,918L982,926L977,934L972,941L967,948L961,955L955,961L948,967L941,972L934,977L926,982L918,987L909,991L900,995L890,999L880,1003L869,1006L858,1009L845,1011L832,1014L818,1016L802,1018L785,1019L766,1021L745,1022L719,1023L688,1024L646,1024L512,1024L378,1024L336,1024L305,1023L279,1022L258,1021L239,1019L222,1018L206,1016L192,1014L179,1011L166,1009L155,1006L144,1003L134,999L124,995L115,991L106,987L98,982L90,977L83,972L76,967L69,961L63,955L57,948L52,941L47,934L42,926L37,918L33,909L29,900L25,890L21,880L18,869L15,858L13,845L10,832L8,818L6,802L5,785L3,766L2,745L1,719L0,688L0,646L0,512L0,378L0,336L1,305L2,279L3,258L5,239L6,222L8,206L10,192L13,179L15,166L18,155L21,144L25,134L29,124L33,115L37,106L42,98L47,90L52,83L57,76L63,69L69,63L76,57L83,52L90,47L98,42L106,37L115,33L124,29L134,25L144,21L155,18L166,15L179,13L192,10L206,8L222,6L239,5L258,3L279,2L305,1L336,0L378,0L512,0L646,0L688,0L719,1L745,2L766,3L785,5L802,6L818,8L832,10L845,13L858,15L869,18L880,21L890,25L900,29L909,33L918,37L926,42L934,47L941,52L948,57L955,63L961,69L967,76L972,83L977,90L982,98L987,106L991,115L995,124L999,134L1003,144L1006,155L1009,166L1011,179L1014,192L1016,206L1018,222L1019,239L1021,258L1022,279L1023,305L1024,336L1024,378Z" fill="none" stroke="url(#h)" stroke-width="6" transform="translate(512 512) scale(.994) translate(-512 -512)"/>
+<g fill="none" stroke="#FFFFFF" stroke-width="96" stroke-linecap="round" stroke-linejoin="round"><path d="M281 520 L443 682 L743 342"/></g>
+</svg>

package/web/index.html

@@ -4,6 +4,11 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
 <title>Dashboard · sign-off</title>
+<link rel="icon" href="icon.svg" type="image/svg+xml">
+<link rel="apple-touch-icon" href="apple-touch-icon.png">
+<link rel="manifest" href="manifest.webmanifest">
+<meta name="theme-color" content="#F5F5F7" media="(prefers-color-scheme: light)">
+<meta name="theme-color" content="#000000" media="(prefers-color-scheme: dark)">
 <style>
   /* Spacious, Apple grade. A phone reads white tiles on a grey grouped page; a desk reads grey tiles on a white page (the 60rem block swaps them).
      Dark is its own scale: a black page with #161617 tiles. --accent is the blue for text, links and focus; --action is the blue a button is filled with. */
@@ -553,6 +558,8 @@
   .choices.many button { flex: 1 1 auto; max-width: 100%; padding: 0.5rem 1rem; }
   .note label { display: block; color: var(--muted); font-size: 0.875rem; margin-top: 0.5rem; }
   .tradeoff { margin: 0; max-width: 70ch; }
+  .option-link { display: inline-flex; align-items: center; min-height: 2.75rem; font-size: 0.9375rem; color: var(--accent); }
+  .fd-links { margin: 0; display: flex; flex-wrap: wrap; align-items: center; gap: 0 1rem; font-size: 0.9375rem; color: var(--muted); } .fd-links a { min-height: 2.75rem; display: inline-flex; align-items: center; color: var(--accent); }
   /* Dismiss: a quiet round x at the corner of a card or the end of a row. */
   .x { flex: none; display: grid; place-items: center; width: 2.75rem; min-height: 2.75rem; padding: 0; margin: -0.5rem 0 -0.5rem auto; border: 0; border-radius: 50%;
     background: none; color: var(--muted); font-size: 1.5rem; line-height: 1.25; }
@@ -636,7 +643,8 @@
     grid-auto-columns: min(85%, calc(var(--tall) * 9 / 19.5)); gap: 0.5rem 0.875rem; margin: -0.25rem; padding: 0.25rem 0.25rem 0.5rem;
     overflow-x: auto; overscroll-behavior-x: contain; scroll-snap-type: x mandatory; scroll-padding: 0 0.25rem; }
   .mock { display: grid; grid-row: span 3; grid-template-rows: subgrid; margin: 0; min-width: 0; scroll-snap-align: start; }
-  .mock > button { grid-row: 3; }
+  .mock > button, .mock > .under { grid-row: 3; }
+  .mock .under { display: grid; align-content: start; justify-items: start; } .mock .under button { justify-self: stretch; }
   .mock:has([aria-pressed="true"]) .shot { border-color: var(--accent); }
   /* A frame draws the mock at about phone width (1.7 times the frame) at that fraction, cropped from the top. */
   .shot { position: relative; display: block; overflow: hidden; aspect-ratio: 9 / 19.5; background: #fff;
@@ -975,7 +983,7 @@
     const merged = !saved && !state.dismissed?.includes(d.key) ? (d.merges ?? []).filter((k) => state.decisions.some((x) => x.key === k) && !answerOf(k)).length : 0;
     if (design) {
       return el('article', { class: 'row design', id: `item-${d.key}` }, lead,
-        d.tradeoff ? el('p', { class: 'tradeoff', dir: 'auto' }, el('strong', {}, 'Trade-off '), d.tradeoff) : '',
+        firstDraft(d).text ? el('p', { class: 'tradeoff', dir: 'auto' }, el('strong', {}, 'Trade-off '), firstDraft(d).text) : '', firstDraftLinks(d),
         mockCards(d, ro ? [] : buttons), annotations(d), silent ? el('p', { class: 'silent' }, silent) : '', ro ? '' : other(d, saved, err), err);
     }
     // Yes/No rows keep the two fixed buttons they always had; any other choice set wraps; answers that say what they do stack.
@@ -1260,6 +1268,16 @@
     return el('div', { class: 'rung' }, body, el('a', { class: 'meta', ...open, 'aria-label': `Open the ${name} full size, ${d.title}` }, 'Open full size'));
   }
 
+  /** first-draft's `post` ends a design's trade-off with `Open in first-draft: <label> <url> · <label> <url>`: those urls, and the text before them. */
+  const firstDraft = (d) => {
+    const at = (d.tradeoff ?? '').search(/(?:^|\s)Open in first-draft: /), tail = at < 0 ? '' : d.tradeoff.slice(at).replace(/^\s*Open in first-draft: /, '');
+    const links = tail.split(' · ').map((p) => /^(.*?)\s*(https?:\/\/\S+)$/.exec(p.trim())).filter(Boolean).map(([, label, href]) => ({ label: label || href, href }));
+    return links.length ? { text: d.tradeoff.slice(0, at).trim(), links } : { text: d.tradeoff, links: [] };
+  };
+  /** Real links on the card itself: a link inside a mock is blocked by the frame's sandbox. */
+  const firstDraftLinks = (d) => { const { links } = firstDraft(d);
+    return links.length ? el('p', { class: 'fd-links' }, 'Open in first-draft ', ...links.map((l) => el('a', { href: l.href, target: '_blank', rel: 'noopener' }, l.label))) : ''; };
+
   /** One phone frame per option, the recommended one first: its label and Recommended badge, the mock (tap opens it full size) and its Pick button. */
   function mockCards(d, buttons) {
     const rec = (i) => d.options[i].value === d.recommend_value, order = d.options.map((_, i) => i).sort((a, b) => rec(b) - rec(a));
@@ -1274,7 +1292,9 @@
         el('figcaption', {}, el('span', { class: 'label', dir: 'auto' }, o.label), rec(i) ? el('span', { class: 'badge' }, 'Recommended') : ''),
         // A mock file that is gone has a null hash: the option says so in place of an empty frame.
         m && m.hash !== null ? el('a', { class: 'shot', href: url, target: '_blank', rel: 'noopener', 'aria-label': `Open mock ${o.label} full size` }, view)
-          : el('p', { class: 'shot none' }, 'No mock for this option'), buttons[i] ?? '');
+          : el('p', { class: 'shot none' }, 'No mock for this option'),
+        // The option's own link sits on the card, where a tap opens a tab: a link inside the sandboxed frame cannot.
+        m?.link ? el('div', { class: 'under' }, el('a', { class: 'option-link', href: m.link, target: '_blank', rel: 'noopener', 'aria-label': `Open ${o.label} live` }, 'Open live'), buttons[i] ?? '') : buttons[i] ?? '');
     }));
   }
 
@@ -1371,6 +1391,8 @@
   const icon = (a) => { const s = el('span', { class: `icon i-${a}`, 'aria-hidden': 'true' }); s.innerHTML = `<svg viewBox="0 0 24 24"><path d="${ICONS[a]}"/></svg>`; return s; };
   // A design with only screen notes (answer 'screens') still waits for its design-wide verdict.
   const isAnswered = (d) => Object.hasOwn(state.answers, d.key) && !(d.type === 'design' && state.answers[d.key].answer === 'screens');
+  /** A sign-in whose link has expired has nothing left to open: it leaves the board until its poster posts a new link on the same key. */
+  const lapsed = (d) => d.type === 'signin' && !d.start && !!d.expires && Date.parse(d.expires) <= Date.now() && !isAnswered(d);
   /** Each item lives in one area: answered items, then the area the item names, then evidence updates (never an ask, whatever their result), then what is only to read (explainers, pages with nothing to answer), then the open asks.
    *  A plan has no options but waits for its send-back. */
   const area = (d) => {
@@ -1428,7 +1450,7 @@
   }
   /** Today at a glance, in a few short sentences: what needs you and what was proven in full colour, when the soonest ask closes and the new reports quieter. */
   function glance(by) {
-    const n = by.waiting.length, proven = filedToday(by.evidence).length, fresh = filedToday(by.reports).length;
+    const n = by.waiting.length, proven = by.provenToday.length, fresh = filedToday(by.reports).length;
     const soonest = by.waiting.map((d) => d.silent_by).filter(Boolean).sort((x, y) => Date.parse(x) - Date.parse(y))[0];
     const lines = [[n ? `${n} ${n === 1 ? 'decision needs' : 'decisions need'} you.` : 'Nothing needs you.', 1], [soonest && `The soonest closes at ${when(soonest)}.`],
       [proven && `${proven} ${proven === 1 ? 'update' : 'updates'} filed.`, 1], [fresh && `${fresh} new ${fresh === 1 ? 'report is' : 'reports are'} waiting.`]];
@@ -1472,8 +1494,7 @@
   }
 
   /** Proven today on Today: a swipeable row of today's updates, each with its own result and capture; a wide screen sets them three across. */
-  function proven(items) {
-    const fresh = filedToday(items);
+  function proven(items, fresh) {
     return el('section', { class: 'i-evidence wide' }, el('div', { class: 'sec-head' }, el('h2', {}, 'Proven today'), items.length ? el('a', { href: '#evidence' }, 'See all') : ''),
       fresh.length ? el('div', { class: 'ev-scroll-row' }, ...fresh.slice(0, 3).map((d) => withX(d, evCard(d)))) : el('p', { class: 'empty' }, 'Nothing proven today yet.'));
   }
@@ -2002,12 +2023,12 @@
     const quiet = opts.find((o) => o.value === d.default_if_silent);
     const silent = quiet ? [icon('clock'), el('span', {}, el('b', {}, 'If you stay quiet:'), ` ${quiet.outcome ?? quiet.label}${d.silent_by ? ` At ${when(d.silent_by)}. ${left(d.silent_by)}.` : ''}`)] : '';
     const head = el('div', { class: 'lead' }, badge(d), el('h2', { dir: 'auto' }, headline(d)));
-    const why = unchecked(d) || d.why || d.tradeoff || d.about;
+    const why = unchecked(d) || d.why || (d.tradeoff && firstDraft(d).text) || d.about;
     const back = el('a', { class: 'later', href: '#waiting' }, 'Later'), gone = xBtn(d, 'Dismiss');
     if (gone) gone.addEventListener('click', () => (location.hash = to));
     const page = el('section', { class: 'decide' }, hero || (preview ? el('div', { class: 'decide-preview' }, preview) : ''),
       ...(d.mocks?.length ? [annotations(d)] : []), head,
-      why ? el('p', { class: 'why', dir: 'auto' }, why) : '',
+      why ? el('p', { class: 'why', dir: 'auto' }, why) : '', firstDraftLinks(d),
       ...(live && opts.length ? [el('p', { class: 'pick-label' }, typeOf(d) === 'yes-no' ? 'YES OR NO' : 'PICK ONE'),
         el('ul', { class: 'pick-list', 'aria-label': d.title }, ...optionButtons.map((b) => el('li', {}, b)))] : []),
       err,
@@ -2035,9 +2056,11 @@
     const gone = new Set(state.dismissed ?? []), open = state.decisions.filter((d) => !gone.has(d.key) && !isAnswered(d));
     const openKeys = new Set(open.map((d) => d.key));
     const merged = new Set(open.flatMap((d) => d.merges ?? []).filter((k) => openKeys.has(k)));
-    for (const d of [...state.decisions].reverse()) if (!gone.has(d.key) && !merged.has(d.key)) by[area(d)].push(d);
+    for (const d of [...state.decisions].reverse()) if (!gone.has(d.key) && !merged.has(d.key) && !lapsed(d)) by[area(d)].push(d);
     by.evidence.sort((x, y) => (Date.parse(y.filed) || 0) - (Date.parse(x.filed) || 0));
     by.designs = [...state.decisions].reverse().filter((d) => d.kind === 'design' && !gone.has(d.key));
+    // Proven today counts every update filed today that is not dismissed, answered or not: a verdict moves it off Evidence, not out of today's count.
+    by.provenToday = filedToday(state.decisions.filter((d) => d.type === 'evidence' && !gone.has(d.key))).sort((x, y) => (Date.parse(y.filed) || 0) - (Date.parse(x.filed) || 0));
     // Waiting on you reads newest first unless the viewer chose oldest first. A sign-in blocks someone now, so sign-ins come first either way.
     let latest = -Infinity;
     const inFileOrder = by.waiting.slice().reverse().map((d, i) => { const t = Date.parse(d.filed); if (!Number.isNaN(t)) latest = t; return { d, t: latest, i }; });
@@ -2086,8 +2109,8 @@
       : at === 'designs' ? [...designGroups(by.designs)] : at === 'evidence' ? evidenceGroups(by.evidence) : at === 'reports' && !state.readonly ? [by.reports.some((d) => d.steps) ? el('p', { class: 'card legend' }, ...Object.keys(MARKS).map((m) => el('span', {}, el('span', { class: `mk mk-${m}` }), MARKS[m]))) : '',
         ...(by.reports.length ? reportGroups(by.reports) : [el('p', { class: 'empty' }, EMPTY.reports)]), notes(by.notes)] : at === 'answered' && by.answered.length ? done(by.answered) : at ? [at === 'waiting' ? filters(by.waiting) : '', by[at].length ? el('div', { class: `list in-${at}${state.readonly ? ' readonly' : ''}` }, ...(at === 'waiting' ? shown : by[at]).map(row))
       : el('p', { class: 'empty' }, at === 'answered' && state.decisions.some((d) => gone.has(d.key) && isAnswered(d)) ? 'All done items cleared.' : EMPTY[at])] : [search(), glance(by),
-      el('div', { class: 'tiles' }, tile('waiting', by.waiting.length, 'Need you'), tile('evidence', filedToday(by.evidence).length, 'Proven today'), tile('reports', filedToday(by.reports).length, 'New report')),
-      el('div', { class: 'areas' }, waitingSection(by.waiting, by.answered, by.designs), proven(by.evidence), newReport(by.reports)), ...(state.leash ? leash() : []),
+      el('div', { class: 'tiles' }, tile('waiting', by.waiting.length, 'Need you'), tile('evidence', by.provenToday.length, 'Proven today'), tile('reports', filedToday(by.reports).length, 'New report')),
+      el('div', { class: 'areas' }, waitingSection(by.waiting, by.answered, by.designs), proven(by.evidence, by.provenToday), newReport(by.reports)), ...(state.leash ? leash() : []),
       ...(FROZEN || state.readonly || state.answers_only ? [] : [ask()])]));
     readPage(key ? state.decisions.find((d) => d.key === key && !gone.has(d.key) && (at === 'reports' && reads(d) || at === 'designs' && d.kind === 'design' || at === 'evidence' && d.type === 'evidence' || d.type === 'plan' && area(d) === at)) : undefined, at);
     if (at === 'decide') document.querySelector('#board .decide')?.prepend(bulkBar(bulk));

package/web/manifest.webmanifest

@@ -0,0 +1,14 @@
+{
+  "name": "sign-off",
+  "short_name": "sign-off",
+  "description": "One calm page for every question the programs working for you need answered.",
+  "start_url": "./",
+  "display": "standalone",
+  "background_color": "#F5F5F7",
+  "theme_color": "#0071E3",
+  "icons": [
+    { "src": "icon-192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "icon-512.png", "sizes": "512x512", "type": "image/png" },
+    { "src": "icon-maskable-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
+  ]
+}