2026.9.30.1: a build names each package when it does work, one status row with a screen of dots, --play-game, Finished from one minute, and one lock entry per identity (#743)

Build output design revision 3 (.agents/docs/2026-09-30-build-output-refinement-design.md), from a report on `mcpp build` in the xlings repository with 2026.9.29.5.

A package is named once, when it does work: Compiling at its first step that is not a dependency scan, or Cached with its units when the global cache places them; nothing is folded. A package inside the project is named by its short name, version and directory, any other by its identity and source, and the name's colour states the source. The cache pass runs through the report. One status row, aligned with the verbs and drawn half a second into the command, leaves in one write that overwrites the old rows in place, with autowrap off for the row; it states the last steps running once ninja has none left to start. Its screen of 24 braille cells (mcpp.ui.dots_screen) plays the chomper, the snake, the stack or the ions; MCPP_PROGRESS names one, or plain, or off. --play-game[=snake|stack|runner] plays a game on the screen from the keyboard, in the terminal's foreground only, and the terminal's mode is restored on exit and on a signal. A build program has a line when it runs or fails, and a failure names its package. Finished states how the time was spent from one minute, names the longest compile by its source file, and states the profile's descriptor on the fast path as well, from the step record's header. The step record is version 2.

A bare key of a path or git dependency states only the short name, and a contradicting namespace is reported once per consumer manifest. A planned build leaves a committed mcpp.lock unchanged: the lock holds one entry per identity again.

The Windows resource script moves to docs/res, the packaging and release scripts to tools, and the empty cdb.json is removed. The bundled xlings is 2026.9.30.1.

Author: speak-agent

.agents/docs/2026-09-29-build-progress-display-design.md

@@ -6,6 +6,9 @@ status: landed
 # Build progress: each step's line states its outcome, and one status line states the build
 
 - Status: landed (revision 2). Implemented in #742, released as 2026.9.29.5
+  (the parts listed in section 6 of
+  `2026-09-30-build-output-refinement-design.md` are replaced by revision 3,
+  #743, 2026.9.30.1)
 - Date: 2026-09-29
 - Origin: the cross-verification of #742 on the validation project (run
   36562019799). `mcpp build --workspace` printed its last `Compiling` line at

.agents/docs/2026-09-30-build-output-refinement-design.md

@@ -18,7 +18,7 @@ superseded_by: 2026-09-07-....md  # when status is superseded
 ---
 ```
 
-318 records.
+319 records.
 
 ## By subject
 
@@ -30,6 +30,7 @@ Records that declare one. Everything else is listed by date below.
 
 ### design
 
+- [Build output, revision 3: every package that does work is named, the live display is one line drawn in one write, and a repeated warning is stated once per file](2026-09-30-build-output-refinement-design.md) — landed
 - [The workspace as the unit of build: one graph per configuration, one scheduler, product directories, and a reusable graph module](2026-09-29-workspace-build-graph-design.md) — landed
 - [Build progress: each step's line states its outcome, and one status line states the build](2026-09-29-build-progress-display-design.md) — landed
 - [An ecosystem design for mcpp and xlings: one authority per fact, and the work that follows from it](2026-09-28-ecosystem-design-and-optimisation-plan.md) — landed
@@ -109,6 +110,7 @@ Records that declare one. Everything else is listed by date below.
 
 ### 2026-09
 
+- [Build output, revision 3: every package that does work is named, the live display is one line drawn in one write, and a repeated warning is stated once per file](2026-09-30-build-output-refinement-design.md) — landed
 - [The workspace as the unit of build: one graph per configuration, one scheduler, product directories, and a reusable graph module](2026-09-29-workspace-build-graph-design.md) — landed
 - [Build progress: each step's line states its outcome, and one status line states the build](2026-09-29-build-progress-display-design.md) — landed
 - [Two days of mcpp and xlings: a review of what merged, what is known, and what is open](2026-09-28-ecosystem-review-of-two-days-of-mcpp-and-xlings.md) — active

.agents/docs/README.md

@@ -25,7 +25,7 @@ inputs:
     # `package.name`, so one of the two was simply unreachable — and which one
     # depended on the machine, which is why CI failed on `compat:lua` on
     # Windows and `mcpplibs.capi:lua` on Linux. Never pin below that.
-    default: '2026.9.29.1'
+    default: '2026.9.30.1'
   cache-target:
     description: also restore/save target/ (build artifacts + BMIs)
     required: false

.github/actions/bootstrap-mcpp/action.yml

@@ -15,7 +15,7 @@ inputs:
     # Floor imposed by the index, not a routine bump — see
     # .github/actions/bootstrap-mcpp/action.yml for why 0.4.69 is required
     # (two packages named `lua` in one repo need openxlings/xlings#381).
-    default: '2026.9.29.1'
+    default: '2026.9.30.1'
   image:
     description: >
       The runner label the job runs on (macos-15, xcode-27). It is part of the

.github/actions/setup-macos-llvm/action.yml

@@ -100,7 +100,7 @@ fi
 # The two xmake source lists must actually carry the glob. Asserted by content
 # rather than by trusting the loop above: a renamed pattern would leave every
 # per-module check passing while compiling nothing.
-for f in scripts/bootstrap-macos.sh .github/workflows/bootstrap-macos.yml \
+for f in tools/bootstrap-macos.sh .github/workflows/bootstrap-macos.yml \
          bench/projects/mcpp/xmake.lua; do
     [[ -f "$f" ]] || { bad "$f is missing"; continue; }
     grep -qF 'modules/*/src/**.cppm' "$f" \
@@ -109,7 +109,7 @@ done
 
 # The vendored json header is reached through a private include dir. Its path
 # appears in three places and has already moved once.
-for f in scripts/bootstrap-macos.sh .github/workflows/bootstrap-macos.yml \
+for f in tools/bootstrap-macos.sh .github/workflows/bootstrap-macos.yml \
          bench/projects/mcpp/xmake.lua; do
     grep -qF 'modules/libs/src/json' "$f" \
         || bad "$f does not add the json include dir (modules/libs/src/json)"

.github/tools/check_modules_wiring.sh

@@ -58,7 +58,7 @@ jobs:
           TRIGGER: ${{ github.event_name }}
           MANUAL_PUBLISH: ${{ inputs.publish }}
           # Repository variable, absent until a human has watched one publish
-          # succeed. See "Arming the automatic triggers" in scripts/aur/README.md.
+          # succeed. See "Arming the automatic triggers" in tools/aur/README.md.
           AUTOPUBLISH: ${{ vars.AUR_AUTOPUBLISH }}
         run: |
           args=(
@@ -67,7 +67,7 @@ jobs:
             --summary "$GITHUB_STEP_SUMMARY"
           )
           [[ -z "$REQUESTED_TAG" ]] || args+=(--tag "$REQUESTED_TAG")
-          python3 scripts/aur/reconcile_mcpp_bin.py "${args[@]}"
+          python3 tools/aur/reconcile_mcpp_bin.py "${args[@]}"
 
           # An unattended push to a third-party service must be ARMED, not
           # inherited from a merge. `schedule` fires every six hours off the
@@ -102,7 +102,7 @@ jobs:
           install -dm700 "$HOME/.ssh"
           install -m600 /dev/null "$HOME/.ssh/aur"
           printf '%s\n' "$AUR_SSH_PRIVATE_KEY" > "$HOME/.ssh/aur"
-          install -m600 scripts/aur/aur.archlinux.org.known_hosts "$HOME/.ssh/known_hosts"
+          install -m600 tools/aur/aur.archlinux.org.known_hosts "$HOME/.ssh/known_hosts"
           ssh-keygen -lf "$HOME/.ssh/known_hosts" -E sha256 \
             | grep -F 'SHA256:RFzBCUItH9LZS0cKB5UE6ceAYhBD5C8GeOBip8Z11+4'
           install -m600 /dev/null "$HOME/.ssh/config"
@@ -145,7 +145,7 @@ jobs:
           # EVERY OTHER NON-ZERO CODE STILL FAILS. A refused downgrade (3) and
           # a permanent error (2) are this repository's problem and stay red.
           set +e
-          python3 scripts/aur/reconcile_mcpp_bin.py "${args[@]}"
+          python3 tools/aur/reconcile_mcpp_bin.py "${args[@]}"
           rc=$?
           set -e
           if [[ "$rc" == "75" ]]; then

.github/workflows/aur-publish.yml

@@ -17,7 +17,7 @@ jobs:
       # Dormant (workflow_dispatch only), but kept in step with the rest —
       # check_version_pins.sh holds it there. Floor: 0.4.69, below which the
       # index cannot resolve two packages that share a short name.
-      XLINGS_VERSION: '2026.9.29.1'
+      XLINGS_VERSION: '2026.9.30.1'
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/bootstrap-macos.yml

@@ -152,7 +152,7 @@ jobs:
         env:
           XLINGS_NON_INTERACTIVE: '1'
         run: |
-          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.29.1
+          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.30.1
           echo "$HOME/.xlings/subos/current/bin" >> "$GITHUB_PATH"
 
       - name: Install mcpp and config mirror
@@ -315,7 +315,7 @@ jobs:
 
       - name: Install xlings + mcpp
         run: |
-          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.29.1
+          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.30.1
           # Deliberately NOT writing to $GITHUB_PATH here. On container
           # images that declare no PATH in their config (opensuse/
           # tumbleweed), appending a single dir to GITHUB_PATH makes the
@@ -416,7 +416,7 @@ jobs:
           #             (older ones carry minos=15 and refuse to start).
           #   v0.4.51+: in-process sha256 — this image has no sha256sum
           #             binary, so pinned fetches failed before it.
-          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.29.1
+          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.30.1
           echo "$HOME/.xlings/subos/current/bin" >> "$GITHUB_PATH"
 
       - name: Install mcpp and config mirror

.github/workflows/ci-fresh-install.yml

@@ -384,7 +384,7 @@ jobs:
 
       - name: Bootstrap xlings + released mcpp
         run: |
-          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.29.1
+          curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash -s v2026.9.30.1
           export PATH="$HOME/.xlings/subos/current/bin:$PATH"
           xlings update
           xlings install mcpp -y -g