Skip to content

I3021 — The Knowledge screen shows each review command as code with what it does as a sentence

The Review panel of /ui/knowledge draws its six commands as an ordered prose list, each step a command in inline code followed by what it does as a sentence, instead of fact cards whose command is drawn as a bold headline value.

DONE wave 0 · p1 · implementation profile · parallel safe

Part of truthful-plan-surfaces — The plan's surfaces are inferred from delivery, and nothing they show is typed beside the repository.

Objective

The Review panel of /ui/knowledge draws its six commands as an ordered prose list, each step a command in inline code followed by what it does as a sentence, instead of fact cards whose command is drawn as a bold headline value.

Why

The published /ui/knowledge (majordomus.dev, v0.29.0) drew the review as mj-ui-facts cards: each command was a large bold monospaced value that overflowed its card at phone width, and what it does sat beneath it in small muted type, so the screen read as six headline numbers rather than a procedure.

Current state

review() renders a dl.mj-ui-facts with the command in dt and the explanation in dd.

Desired state

review() renders an ol.mj-ui-prose-list; each li is code.mj-ui-code with the command, then the explanation as a sentence; a crate test pins it.

Scope

  • apps/majordomus-cli/src/ui/knowledge.rs

Dependencies

None. This issue is a root of the graph.

Acceptance criteria

  • The Review panel holds an ol.mj-ui-prose-list with one li per review command, in the order a review takes them
  • Each command is inline code (mj-ui-code) and is followed by what it does as a sentence
  • The Review panel carries no mj-ui-fact card

Validation

  • cargo test --lib ui::knowledge
  • scripts/ui audit --only /ui/knowledge

Evidence required

  • knowledge_review_reads_as_steps

Evidence

coverstypecommandresultat commit
knowledge_review_reads_as_stepscivalidate run 39438896504 at master 9a5a9b77520: rust (1-3) jobs 118683336143 118683336062 118683336401 run cargo test, incl. ui::knowledge::the_review_is_steps_of_command_and_sentence (6f54b415353)success (the run's only red job is pages, which runs no test)a81b1e3

Timeline

started
2026-10-20T16:14:46Z
verified
—
completed
2026-10-20T16:25:42Z

Those three fields, the evidence above and the state of the dependencies are all the status is made of. There is no status field to disagree with them.

Canonical record: .ai/repo/project/issues/I3021.yaml. Read it back with majordomus plan show I3021.

Searches the titles and descriptions of every page this site publishes.