lukas/nixos-config
Archived
1
0
Fork 1
Code Issues Pull requests Releases Wiki Activity
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

2.8 KiB
Raw Permalink Blame History

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.