[sf624]

Step P5 of docs/design/panel-redesign.md ("In short" on every line).

What users see

The panel's Meaning view (VS Code and the web page) starts with one sentence that says what the line does, labelled "In short" / 「ひとことで」, above the problems. The Reading view has none. Examples (sample.sh):

• set -euo pipefail → "Turns on errexit, nounset and pipefail, the usual strict mode."
• workdir=$(mktemp -d) → "Sets workdir to output of $(mktemp -d)."
• make build > build.log 2>&1 || exit 1 → "Runs make, with stdout (fd 1) to build.log, stderr (fd 2) to where stdout (fd 1) goes; if that fails, runs exit with status 1; under set -e, a command that fails before the last one does not stop the script."
• while read -r line; do → "Reads input.txt one line at a time, running line 29 for each line."
• done < input.txt → "done ends the while loop of line 28: reads input.txt …"
• grep -i error app.log | sort | uniq -c | sort -rn | head -n 3 → 「grep の出力の各行の出現回数を数え、多い順に回数つきで並べる（上位 3 行）。終了ステータスは最後に失敗したコマンドのもの（なければ 0）。」

How

• LineExplanation.sentence (marked text), when ExplainOptions.sentence asks for it; src/linesentence.ts composes it from the tree, CommandSaid (src/explain/commands.ts: the command's names, the summary Token.summary also comes from, the options given), P4's argvWords (values, targets, a loop's words, with placeholders), and the status model. Texts: src/messages-sentence.ts (ja, en).
• Idioms with a sentence of their own: idiomSaid in src/idioms.ts (strict mode, EXIT trap, quiet command -v, while read … done < f, endless loop, sort | uniq -c | sort -rn [| head], echo … >&2).
• Rules: a clause about the status model carries its manual section (3.2.3, 4.3.1) and is dropped when a problem of the line cites it (problemSections; host problems via ExplainOptions.hostProblems). Code spans name single words only. A variable whose attributes change what is stored (CHANGING, now exported from src/semantics/walk/temporaries.ts) gets "what x gives".
• Plan changes (written into the plan): set -e is said only where it does other than stop the script (said on every line it was noise); variableFrom was not needed.
• Fixed on the way: a bare coproc made statusModel.status throw.
• Nit: the Japanese HEALTHCHECK note says 2 is reserved.

Explanation changes (test/snapshot.ts)

None: the corpus' explanations are byte-identical (keyed by input; only the 5 new snippets are added). The sentence is only built when asked for.

Tests

• test/linesentence.test.ts: 145 shapes in en and ja; over sample.sh and the fixtures: every line with code has a sentence, none states set -e/a pipeline status where a problem cites it, no code span is a stretch of more than one word, none is a row's text, Japanese spacing; every snippet and lines cut while typed without failing; assignment values against bash on the argv capture's runs.
• test/web-sentence.test.ts: the web panel at 390 and 1280 px, en and ja (closing word, a problem line, a long line), hidden in Reading.
• Full npm test locally: 10524 passing.

🤖 Generated with Claude Code

[github-actions]

Web preview removed: the pull request is closed.