This repository has been archived on 2026-09-17. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
nixos-config/docs/intent/board-card-three-links.md
pijukka 05575df408 docs: commit backlog of already-resolved intent/review corpus files
board-agent's own README documents docs/intent/ and docs/research-intent/
as tracked corpus directories, and docs/review/<slug>.md as the reviewer's
persisted report per card - but the pipeline only writes these files to
the checkout, it never commits them itself. This had built up a backlog
of intent/review docs for cards already marked deployed or archiviert in
the live board state, which were sitting uncommitted in the working tree.

Adds that backlog as-is: the originating intents, their reviewer reports,
the research-intent/research pair for the board UX evaluation, and one
standalone process-retrospective report (board-review-pipeline-context-
overhead.md, same genre as the two already-tracked audit reports in
docs/review/). No code changes.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T7UVrKsttMP9a6FiGFna9b
2026-09-10 12:06:53 +02:00

61 lines
2.8 KiB
Markdown

# Intent: Drei getrennte Links auf der Karte statt ein Klickbereich
## Ziel
Eine Board-Karte soll am Ende drei einzeln klickbare Elemente zeigen,
die je nach Baustand der Karte nach und nach erscheinen ("bei jedem
Schritt nimmt die Karte was mit"):
1. **Intent-Element** — immer vorhanden (jede Intent-Karte hat einen
Intent-Text). Öffnet das bestehende Intent-Modal.
2. **Commit-Anzeige** — nur sichtbar, sobald `card.commit_hash` gesetzt
ist. Reiner Text (kein Link, kein Forgejo-Bezug), gekürzter Hash
(7 Zeichen) -- entspricht dem bereits bestehenden
`<span class="commit-hash">`, nur eigenständig statt Teil eines
überlagerten Klickbereichs.
3. **Review-Element** — nur sichtbar, sobald `card.review_report`
gesetzt ist. Öffnet das bestehende Review-Modal.
Aktuell überlagern sich auf der Karte zwei Klick-Handler auf demselben
Element (`el` in `renderCard()`), einer für Intent, einer für Review,
je nachdem ob `review_report` gesetzt ist — das ist kein sauberer,
einzeln bedienbarer Link pro Artefakt, sondern ein einziger,
mehrdeutiger Klickbereich.
## Auftrag an den Builder
Genau eine Datei, genau diese Änderung:
`hosts/blunix/localServices/board-agent/board.html`, in `renderCard()`:
die beiden bestehenden `click`/`keydown`-Handler auf dem gesamten
Karten-Element `el` (einer für `showIntent`, einer für `showReview`)
entfernen. Stattdessen drei getrennte Kind-Elemente in der Karte
anlegen:
- Intent-Element: immer, wenn `card.source === "intent"` (Text z. B.
"Intent"), öffnet per Klick `showIntent(card)`.
- Commit-Anzeige: nur wenn `card.commit_hash` gesetzt ist -- reiner
Text, kein Link, kein `href`; ersetzt die bisherige
`<span class="commit-hash">` funktional 1:1 (gleicher gekürzter
Hash), nur jetzt als eigenständiges, nicht mit den Klick-Handlern der
anderen beiden Elemente überlagertes Element.
- Review-Element: nur wenn `card.review_report` gesetzt ist (Text z. B.
"Review"), öffnet per Klick `showReview(card)`.
Jedes dieser drei Elemente ist einzeln fokussierbar/klickbar (eigenes
`tabIndex`/`role`/Klick-Handler), keine geteilten Klick-Handler mehr
auf dem übergeordneten Karten-Element.
Ändere keine andere Datei. Bestehende CSS-Klassen (z. B.
`.commit-hash`, `.has-review`) wiederverwenden oder minimal anpassen,
keine größere Stilüberarbeitung. Kein Forgejo-/Repo-Link -- das würde
voraussetzen, dass der Commit bereits gepusht ist, bevor die Karte ihn
anzeigt, und ist hier bewusst nicht Teil des Auftrags.
## Erwartetes Ergebnis
Eine frisch angelegte Karte zeigt nur das Intent-Element. Nach einem
Builder-Commit kommt die Commit-Anzeige dazu (reiner Text). Nach einem
abgeschlossenen Review kommt das Review-Element dazu. Alle drei sind
unabhängig voneinander bedienbar, ohne dass ein Klick auf eines
versehentlich ein anderes mit auslöst.