Skip to content

Define the closing-summary contract (found / did / pending / need from you) as a shared renderer - #496

Open
CSalcedoDataBI wants to merge 1 commit into
mainfrom
issue-492-define-the-closing-summary-contract
Open

Define the closing-summary contract (found / did / pending / need from you) as a shared renderer#496
CSalcedoDataBI wants to merge 1 commit into
mainfrom
issue-492-define-the-closing-summary-contract

Conversation

@CSalcedoDataBI

Copy link
Copy Markdown
Owner

Closes #492

Reported first-hand by the product owner, a BI professional and not a
programmer: "para un usuario de BI que no es programador esta herramienta no
es nada amigable". Every command ends however its author felt like ending it,
so there is no fixed place to look for the only four things a user wants to
know: what I found, what I did, what is left, what I need from you.

Board-Summary.ps1 renders exactly those four, in that order, whatever order
the caller passes them in. Two rules make it readable rather than merely
present:

- An empty block says so out loud. A blank "what I need from you" reads
  identically to a summary that was cut off, so an empty block renders an
  explicit sentence instead of nothing.
- The order never changes. The value of a fixed shape is that the eye stops
  reading and starts scanning.

Two renderings from one source: plain text for the terminal, and markdown
carrying an [abios-summary] marker for PR bodies and issue comments.

Wording is Spanish and unaccented, matching the surface it joins (Board-Work
already prints "sesion", "Iniciados"). This file is the renderer, not the
place to change the console's language or encoding conventions.

Verified: 14 new tests, red before the script existed and green after; full
suite 1264 passed / 0 failed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@CSalcedoDataBI
CSalcedoDataBI force-pushed the issue-492-define-the-closing-summary-contract branch from 2f15eff to 5b16c24 Compare July 28, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define the closing-summary contract (found / did / pending / need from you) as a shared renderer

1 participant