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-show-commit-on-card.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

44 lines
2 KiB
Markdown

# Intent: Commit-Hash auf der Karte anzeigen
## Ziel
Eine Board-Karte soll nach einem abgeschlossenen Review-Lauf zusätzlich
zu Intent-Text und Review-Bericht auch den zugehörigen Commit-Hash
zeigen. Aktuell kennt die Pipeline den Commit-Hash intern (er fließt
bereits von `completion_watcher.py` über den Review-Job-Payload bis in
den Review-Bericht-Text), er landet aber nirgends als eigenes Feld im
Karten-State und wird im Board-UI nirgends angezeigt.
## Auftrag an den Builder
Genau drei gezielte Änderungen, in genau diesen drei Dateien, sonst
keine:
1. `hosts/blunix/localServices/board-agent/worker.py`: im
`job_type == "review"`-Zweig von `process_job()` beim bestehenden
Aufruf
`update_state(slug, "done", job_id, phase="review", review_decision=decision, review_report=report_path)`
zusätzlich das Keyword-Argument
`commit_hash=payload.get("commit_hash", "")` übergeben.
2. `hosts/blunix/localServices/board-agent/trigger.py`: in
`merged_board()` in **beiden** Dict-Literalen (dem für Karten mit
vorhandener Intent-Datei und dem Fallback-Zweig für Karten ohne
Intent-Datei) je eine Zeile `"commit_hash": stored.get("commit_hash"),`
ergänzen, direkt neben den bestehenden `stored.get(...)`-Einträgen
wie `"review_report": stored.get("review_report"),`.
3. `hosts/blunix/localServices/board-agent/board.html`: in
`renderCard()` unterhalb des Titel-Elements, falls `card.commit_hash`
gesetzt ist, ein kleines zusätzliches Element mit dem auf 7 Zeichen
gekürzten Hash einfügen (eigene CSS-Klasse, monospace, dezenter Stil
passend zum bestehenden Kartendesign).
Ändere keine andere Datei, füge keine neuen Abhängigkeiten hinzu und
erweitere das API-Feld nicht über die drei genannten Stellen hinaus.
## Erwartetes Ergebnis
Der Commit enthält ausschließlich diese drei Dateien. Nach einem
Review-Lauf zeigt die betroffene Karte im Board-UI ihren Commit-Hash
(gekürzt) sichtbar an, ohne dass ein Modal geöffnet werden muss.