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-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

2 KiB
Raw Permalink Blame History

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.