Field harvest from a requirements-driven build: 26 instrument fixes, BUG-141 fix proven, BUG-142..154

bin/gate-check.sh

@@ -2690,7 +2690,9 @@ fi
 # the board shows the Sync/Drift FAIL rows, so it does not lie). Nothing overrides 2. A flag
 # must not be able to destroy a file this script did not write.
 INDEX="$PROJECT_DIR/index.html"
-PROJECT_NAME="$(basename "$PROJECT_DIR")"
+# Name the board after the resolved directory: `gate-check.sh . 2` from inside the project
+# titled it ". — Conversion Dashboard" (card-disbursement requirements-driven build, 2026-09-25).
+PROJECT_NAME="$(basename "$(cd "$PROJECT_DIR" 2>/dev/null && pwd -P || printf '%s' "$PROJECT_DIR")")"
 GC_SENTINEL="<!-- generated-by: mxcli-project-toolkit/bin/gate-check.sh -->"
 
 WRITE_HTML=1

bin/lib/closeout.sh

@@ -201,6 +201,16 @@ _co_plain_gate_needs() {
     *) echo "" ;;
   esac
 }
+# _co_owed <manifest modes> <entry mode> — does this project's entry mode owe the row? The same
+# test as artifact-check.sh's second pass, and the same rule: an unknown mode (young register, no
+# `Entry mode:` line yet) owes every row — louder, never quieter.
+#
+# WHY (2026-09-25, card-disbursement requirements-driven build). The three manifest loops below
+# ignored the modes column, so a requirements-driven Stage 0 PASS still said "still missing for
+# this stage: app-report" — a row only existing-app-change owes, which artifact-check.sh itself
+# reported as N/A on the same run.
+_co_owed() { [ -z "$2" ] && return 0; case ",$1," in *",$2,"*) return 0 ;; esac; return 1; }
+
 # mxtk_plain_verdict <stage> <verdict text> <project-dir> [register]
 # The "In plain words" paragraph under a gate line: status first, then every reason the
 # technical text carries that has a known plain translation, then what is still missing on
@@ -244,11 +254,13 @@ mxtk_plain_verdict() {
   case "$low" in *"unanswered"*|*"no blanks"*|*"blank"*)
     _co_say "a kickoff question is still blank" ;; esac
   # Missing mandatory artifacts for this stage, in plain names.
-  local id stage paths producer consumers modes absence miss=""
+  local id stage paths producer consumers modes absence miss="" mode
+  mode="$(_art_entry_mode "$reg" 2>/dev/null || true)"
   if [ -f "$ARTIFACT_TSV" ]; then
     while IFS=$'\t' read -r id stage paths producer consumers modes absence; do
       case "$id" in ''|'#'*|artifact) continue ;; esac
       [ "$stage" = "$st" ] && [ "$absence" != "optin" ] || continue
+      _co_owed "$modes" "$mode" || continue
       _art_waiver "$reg" "$id" "$stage" >/dev/null 2>&1 && continue
       _art_find "$root" "$paths"
       [ -z "$ART_HIT" ] && miss="$miss${miss:+; }$(_co_plain_artifact "$id")"
@@ -274,11 +286,16 @@ mxtk_closeout_report() {
 
   # ── Artifacts produced ──────────────────────────────────────────────────
   printf '**Artifacts produced** (rows of `bin/lib/artifact-manifest.tsv` for stage %s; presence only, never quality)\n' "$st"
-  local id stage paths producer consumers modes absence reason n_art=0 optin
+  local id stage paths producer consumers modes absence reason n_art=0 optin mode
+  mode="$(_art_entry_mode "$reg" 2>/dev/null || true)"
   if [ -f "$ARTIFACT_TSV" ]; then
     while IFS=$'\t' read -r id stage paths producer consumers modes absence; do
       case "$id" in ''|'#'*|artifact) continue ;; esac
       [ "$stage" = "$st" ] || continue
+      if ! _co_owed "$modes" "$mode"; then
+        [ "$absence" = "optin" ] || printf -- '- ⏭ `%s` — N/A: entry mode %s does not owe it\n' "$id" "$mode"
+        continue
+      fi
       optin=""
       if [ "$absence" = "optin" ]; then
         optin="$(_art_field "$reg" "opt-in artifact $id" 2>/dev/null || true)"
@@ -418,6 +435,7 @@ mxtk_closeout_report() {
     while IFS=$'\t' read -r id stage paths producer consumers modes absence; do
       case "$id" in ''|'#'*|artifact) continue ;; esac
       [ "$stage" = "$next" ] && [ "$absence" = "optin" ] || continue
+      _co_owed "$modes" "$mode" || continue
       n_opt=$((n_opt+1))
       optin="$(_art_field "$reg" "opt-in artifact $id" 2>/dev/null || true)"
       if [ -n "$optin" ]; then

bin/lib/images-to-md.py

@@ -564,6 +564,11 @@ def main(argv):
     def rel_project(p):
         return os.path.relpath(p, project).replace(os.sep, '/')
 
+    # A --out run must be re-checked with the same --out, or --check reads the default root.
+    default_out = os.path.join(project, 'analysis', 'knowledge-base', 'images')
+    out_flag = '' if os.path.normpath(images_out) == os.path.normpath(default_out) \
+        else ' --out %s' % rel_project(images_out)
+
     manifest_path = os.path.join(images_out, 'manifest.json')
     sha_to_id = {} if force else load_old_manifest(manifest_path)
     used_numbers = set(int(v.split('-')[1]) for v in sha_to_id.values())
@@ -756,8 +761,9 @@ def ingest(occ):
     print('  worklist: %s' % rel_project(worklist_path))
     print('Images to describe: %d%s' % (
         n_content,
-        (' — write analysis/knowledge-base/images/<id>.md per the template in '
-         'skills/image-transcription.md, then: bin/images-to-md.sh <p> --check') if n_content else ''))
+        (' — write %s/<id>.md per the template in '
+         'skills/image-transcription.md, then: bin/images-to-md.sh <p>%s --check'
+         % (rel_project(images_out), out_flag)) if n_content else ''))
 
     if do_check or do_inline:
         return run_check(project, images_out, entries, order, do_inline=(do_inline or do_check))
@@ -804,12 +810,16 @@ def run_check(project, images_out, entries, order, do_inline):
     for sha, ent in content:
         for loc in ent.locations:
             owners.setdefault(loc['source'], set()).add(ent.id)
+    # The --artifact path is the manifest this run actually wrote — under --out when one was
+    # given. It used to be the default root, hard-coded, so a `--out` run printed ledger marks
+    # citing a manifest that did not exist (2026-09-25, card-disbursement requirements-driven build).
+    rel_manifest = os.path.relpath(os.path.join(images_out, 'manifest.json'), project).replace(os.sep, '/')
     if owners:
         print('')
         print('  Coverage complete. Ledger marks owed, per source file:')
         for owner in sorted(owners):
-            print('    bin/source-ledger.sh mark <p> \'%s\' --artifact analysis/knowledge-base/images/manifest.json '
-                  '--evidence "<fill in>" --media %d --by <who>' % (owner, len(owners[owner])))
+            print('    bin/source-ledger.sh mark <p> \'%s\' --artifact %s '
+                  '--evidence "<fill in>" --media %d --by <who>' % (owner, rel_manifest, len(owners[owner])))
     return 0