@soleur/opencode 0.0.0-stage → 3.354.2

package/skills/model-launch-review/scripts/audit-models.sh

@@ -0,0 +1,501 @@
+#!/usr/bin/env bash
+# audit-models.sh — deterministic auditor for the per-Anthropic-model-release checklist.
+#
+# Modes:
+#   (default)   full audit report to stdout; every check group is named (no silent green).
+#   --detect    cron signal: exit 10 if config-class model-ID drift is found, 0 if clean.
+#               One-line summary to stdout. Used by the rule-audit.yml detection step.
+#   --fix       apply MECHANICAL model-ID swaps to config-class files only (auto-fix surface).
+#               pin / pricing / tier-map / dormant are FLAG-ONLY and never mutated here.
+#
+# Options:
+#   --root DIR  scan DIR instead of the git repo root (test harness uses this).
+#
+# Auto-fix surface = stale model IDs in config. Excluded from auto-fix (never mutated):
+#   test fixtures (*/test/*, *.test.*), archives (**/archive/**), spikes (*/spike/*),
+#   all of knowledge-base/** (docs/plans/specs/brainstorms/learnings — archival prose
+#   that never selects a model at runtime), community digests.
+# Source of truth for current IDs: the claude-api skill table + official docs.
+set -euo pipefail
+
+ROOT=""
+MODE="audit"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --root) ROOT="$2"; shift 2 ;;
+    --detect) MODE="detect"; shift ;;
+    --fix) MODE="fix"; shift ;;
+    *) echo "unknown arg: $1" >&2; exit 64 ;;
+  esac
+done
+if [[ -z "$ROOT" ]]; then
+  ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+fi
+ROOT="${ROOT%/}"   # normalize: trailing slash breaks rel() prefix-strip
+# A newline in ROOT would split the SDK-carve-out pattern built from it below: grep -E then
+# fails ("Unmatched (") and every `grep -vE "$EXCLUDE_RE" || true` swallows the error, so
+# --detect would print a clean verdict over a scan that excluded nothing. Refuse it up front.
+case "$ROOT" in
+  *$'\n'*)
+    echo "audit-models: refusing a --root containing a newline (it would corrupt the exclusion pattern)" >&2
+    exit 64
+    ;;
+esac
+
+# --- current landscape — update at each model launch ---
+# Each superseded id maps to the CURRENT same-tier id as "<stale>=<current>".
+# At each launch: (1) ADD a pair for the newly-superseded id, AND (2) RETARGET
+# every existing same-tier pair's RHS to the new current id. Step 2 is not
+# optional — `--fix` applies pairs sequentially, so a CHAINED map
+# (4-7=4-8 alongside 4-8=5) is order-dependent and lands on a stale id.
+# The SINGLE-HOP INVARIANT below enforces this mechanically: no target may
+# also appear as a source. Source of truth for current ids: the claude-api
+# skill table + https://platform.claude.com/docs/en/about-claude/models/overview.md
+# (pricing: https://platform.claude.com/docs/en/about-claude/pricing.md).
+AUTOFIX_PAIRS=(
+  "claude-opus-5=claude-opus-5-5"
+  "claude-opus-4-8=claude-opus-5-5"
+  "claude-opus-4-7=claude-opus-5-5"
+  "claude-opus-4-6=claude-opus-5-5"
+  "claude-sonnet-5=claude-sonnet-5-5"
+  "claude-sonnet-4-6=claude-sonnet-5-5"
+  "claude-sonnet-4-5=claude-sonnet-5-5"
+  "claude-fable-5=claude-fable-5-1"
+  # Haiku 5.5 launch, 2026-10-08. BOTH Haiku 4.5 spellings: the id boundary defined
+  # below makes the undated id a different token from the dated one, so one pair alone
+  # leaves the other spelling stale forever. Both RHS are the current id, so the
+  # single-hop invariant holds. No closing paren in comments here: the test parser
+  # reads this array up to the first one.
+  "claude-haiku-4-5-20251001=claude-haiku-5-5"
+  "claude-haiku-4-5=claude-haiku-5-5"
+)
+
+# SINGLE-HOP INVARIANT (fail-fast). A convergent map rewrites every stale id
+# in ONE pass; if any RHS is also an LHS, `--fix` leaves files on an
+# intermediate id and `--detect` re-flags them forever (a permanently-red
+# drift cron that auto-files issues it cannot fix). Cheap to assert, so assert
+# it on every invocation rather than trusting the editor to have retargeted.
+assert_single_hop() {
+  local p from to q other
+  for p in "${AUTOFIX_PAIRS[@]}"; do
+    to="${p#*=}"
+    for q in "${AUTOFIX_PAIRS[@]}"; do
+      other="${q%%=*}"
+      if [[ "$to" == "$other" ]]; then
+        from="${p%%=*}"
+        echo "audit-models: NON-CONVERGENT AUTOFIX_PAIRS — '${from}' maps to '${to}', which is itself a source id." >&2
+        echo "  Retarget every same-tier pair directly to the current id (no chaining)." >&2
+        exit 78
+      fi
+    done
+  done
+}
+assert_single_hop
+# The stale ids (LHS of each pair), '|'-joined for grep.
+autofix_from_re() {
+  local p out=""
+  for p in "${AUTOFIX_PAIRS[@]}"; do out="${out:+$out|}${p%%=*}"; done
+  printf '%s' "$out"
+}
+
+# RIGHT-BOUNDARY of a model id: the next char must not extend the id. Model ids
+# are [0-9A-Za-z-], so a bare alternation would match a PREFIX of a longer id.
+#
+# The `--fix` sed has been anchored since the script was created; SELECTION was
+# not. That asymmetry was ALREADY producing a permanently-red drift cron before
+# Fable 5.1 existed — measured on origin/main, a config file carrying the DATED
+# variant `claude-opus-4-7-20260101` reports `--detect` rc=10, `--fix` prints
+# "fixed" while changing nothing (the sed's boundary correctly declines), and
+# `--detect` re-flags it forever. Same input on this version: rc=0.
+#
+# So the general invariant is the one stated at the bottom of this comment
+# (selection and rewriting must share one boundary), and dated ids were its
+# standing violation. `claude-fable-5` is what made it unavoidable rather than
+# what created it: it was the first pair whose stale id is a strict PREFIX of
+# its own target (`claude-sonnet-5` and `claude-opus-5` now share that shape),
+# so the mismatch fires on the id that is CURRENT rather than only
+# on a longer variant nobody had written yet. `assert_single_hop` does NOT catch
+# either shape ('claude-fable-5-1' is not itself a source id).
+#
+# Selection and rewriting MUST use this one boundary, or they can disagree
+# again: the sed cannot fix what only the grep considers stale.
+ID_BOUNDARY='([^0-9A-Za-z-]|$)'
+
+# Anchored matcher — the ONLY pattern that may decide "this file is stale".
+autofix_match_re() { printf '%s%s' "($(autofix_from_re))" "$ID_BOUNDARY"; }
+
+FLAG_ONLY_STALE_RE='claude-3[._-]|claude-(opus|sonnet|haiku)-[0-9.]+-20250[0-9]+'
+
+DELETION_GUARD=20   # abort --fix if any file would lose more than this many lines
+
+# Path classes excluded from the config (auto-fix) surface. knowledge-base/** is
+# archival/historical prose (learnings, plans, brainstorms) — it never selects a
+# model at runtime, so a stale id there is not operational drift.
+# `\.generated\.` keeps the sweeper out of generated artifacts: those have a
+# generator that reads the TS registry (eval-harness/scripts/gen-models.sh), and
+# a blind sed here would make the generator no longer the sole writer — exactly
+# the second-SSOT the generator's own header promises does not exist.
+# SDK-PATH CARVE-OUT (Haiku 5.5 launch, 2026-10-08; #8643). These two scripts drive the
+# Agent SDK `query()`, whose model resolution lives in the SDK's BUNDLED CLI — pinned at
+# @anthropic-ai/claude-agent-sdk 0.3.284, which does not know `claude-haiku-5-5` (an
+# unknown id silently halves max_tokens, #6934). Auto-fixing them to the new id would
+# break two paid scripts, and leaving them selectable would make `--detect` exit 10
+# forever. They stay on `claude-haiku-4-5` until the SDK pin reaches 0.3.293, the first
+# release whose bundle carries the id. EXACT paths, never a directory: widening this to
+# apps/web-platform/scripts/ would hide a genuinely stale sibling. The exemption is per FILE
+# (every stale id, not only Haiku): these scripts run on the SDK-bundled CLI. It is SELF-EXPIRING:
+# model-launch-review.test.ts fails once the SDK pin reaches 0.3.293 and says to delete
+# this array and swap the two scripts.
+SDK_PATH_CARVEOUT=(
+  "apps/web-platform/scripts/sandbox-canary.mjs"
+  "apps/web-platform/scripts/plugin-root-sandbox-propagation-probe.mjs"
+)
+sdk_carveout_re() {
+  # ANCHORED at both ends: `^<root>/<path>$`. The left anchor matters because candidate
+  # paths are absolute under $ROOT, so an unanchored `/apps/…/x.mjs$` also exempts the same
+  # relative path nested under another prefix (vendor/…, .worktrees/…). $ROOT is escaped so
+  # a root containing regex metacharacters cannot alter the pattern.
+  local p out="" root_re
+  root_re="$(printf '%s' "$ROOT" | sed 's/[][\\.*^$+?(){}|]/\\&/g')"
+  for p in "${SDK_PATH_CARVEOUT[@]}"; do
+    p="${p//./\\.}"
+    out="${out:+$out|}^${root_re}/${p}\$"
+  done
+  printf '%s' "$out"
+}
+EXCLUDE_RE='(/node_modules/|/\.git/|/\.next/|/test/|/__tests__/|/spike/|/archive/|knowledge-base/|/community/|\.test\.|\.spec\.|\.generated\.|/model-launch-review/|'"$(sdk_carveout_re)"')'
+
+# Collect config-class files containing any auto-fixable stale ID.
+# Returns 2 (and prints to stderr) if the scan itself failed. That distinction
+# is load-bearing: `|| true` alone swallows grep's error exit (>=2: unreadable
+# dir, bad regex) as indistinguishable from its no-match exit (1), so --detect
+# would report a confident "none — config model IDs are current" from a scan
+# that never ran. A detector that cannot tell "clean" from "could not look" is
+# the failure mode #5100 exists to prevent.
+collect_config_hits() {
+  local re out rc
+  re="$(autofix_match_re)"
+  # -I (skip binary) is a CORRECTNESS flag, not an optimisation. Without it a
+  # compiled artifact under $ROOT is selectable: measured, a blob containing
+  # `claude-opus-4-7` between NULs was reported as a stale config file, the
+  # `[1]` re-scan could not read it back (`grep -o` on binary prints
+  # "binary file matches" to stderr and yields no stdout), and `--fix` would
+  # then `sed -i` the binary in place — a byte-patched artifact reported as
+  # `fixed:`. That path is now reachable by following this skill's own SKILL.md,
+  # which tells the operator to unpack `claude-code-linux-x64` and grep it.
+  # The auto-fix surface is config-class TEXT by definition, so a binary is
+  # never a legitimate hit and excluding it closes selection, display and
+  # rewrite in one place.
+  # `if out=$(cmd); then` rather than a bare capture: the exit code here is
+  # load-bearing (rc 1 = no match, rc >= 2 = the scan itself failed), so the
+  # `|| true` form lint-shell-capture-exit also accepts would flatten rc to 0
+  # and re-open the #5100 conflation this function exists to prevent. This form
+  # satisfies the lint AND keeps the discrimination.
+  if out="$(grep -rIEl "$re" "$ROOT" \
+    --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=.next \
+    --exclude-dir=test --exclude-dir=__tests__ --exclude-dir=spike --exclude-dir=archive \
+    --exclude-dir=community \
+    --exclude='*.test.*' --exclude='*.spec.*' 2>/dev/null)"; then
+    rc=0
+  else
+    rc=$?
+  fi
+  if (( rc >= 2 )); then
+    echo "audit-models: scan FAILED (grep rc=$rc) under '$ROOT' — refusing to report clean." >&2
+    return 2
+  fi
+  [[ -n "$out" ]] || return 0
+  printf '%s\n' "$out" | grep -vE "$EXCLUDE_RE" || true
+}
+
+rel() { echo "${1#"$ROOT"/}"; }
+
+# #8392 census: readers that index a FIXED content position of an Anthropic
+# response. A model swap that turns thinking on by default moves the text block
+# off position 0, and such a reader then returns empty forever with no error.
+#
+# Anchored on "$ROOT" and rc-discriminating for the same reason as
+# collect_config_hits: a cwd-relative grep under `--root DIR` would scan nothing,
+# exit 1, and print a clean verdict meaning "the scan ran nowhere" — the exact
+# vacuity class this census exists to catch.
+#
+# The pattern is carried ESCAPED (content\[0\]) so this script is not itself a
+# hit of the plan's AC2 census, which matches the plain text. Keep the escapes.
+collect_content_position_readers() {
+  local out rc
+  if out="$(grep -rIEn 'content\[0\]|content\?\.\[0\]' "$ROOT" \
+    --include='*.ts' --include='*.sh' --include='*.mjs' --include='*.js' \
+    --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=.next \
+    --exclude-dir=test --exclude-dir=__tests__ --exclude-dir=spike --exclude-dir=archive \
+    --exclude-dir=community \
+    --exclude='*.test.*' --exclude='*.spec.*' 2>/dev/null)"; then
+    rc=0
+  else
+    rc=$?
+  fi
+  if (( rc >= 2 )); then
+    echo "    UNKNOWN — census scan FAILED (grep rc=$rc) under '$ROOT'; NOT a pass."
+    return 0
+  fi
+  out="$(printf '%s\n' "$out" | grep -vE "$EXCLUDE_RE" || true)"
+  if [[ -z "${out//[[:space:]]/}" ]]; then
+    echo "    none — no fixed-position readers."
+  else
+    # NOT `sed "s|^$ROOT/|…|"`: $ROOT is a filesystem path that may legally contain
+    # `|` or `[`. Measured — a `|` makes sed exit "unknown option to 's'", the
+    # pipeline dies under pipefail and the census prints NEITHER a hit nor `none`
+    # (reads as empty); a `[` silently fails to strip and emits a bare absolute path
+    # with no HIT marker. Quoted-expansion strip, the technique rel() already uses.
+    while IFS= read -r line; do
+      [[ -n "$line" ]] && printf '    HIT: %s\n' "${line#"$ROOT"/}"
+    done <<< "$out"
+  fi
+}
+
+# Shared hits capture. `mapfile -t hits < <(collect_config_hits)` DISCARDS the
+# function's exit code, so a failed scan would fall straight through to the
+# "clean" branch in every mode — the exact absent-vs-could-not-look conflation
+# this script was fixed for. Route the capture through a file so the rc
+# survives, and give EVERY mode the same abort. One owning trap (ADR-129).
+_HITS_TMP="$(mktemp)"
+trap 'rm -f "$_HITS_TMP"' EXIT
+
+# Populates the global `hits` array, or aborts naming the mode that failed.
+load_hits() { # $1 = label for the failure line
+  if ! collect_config_hits > "$_HITS_TMP"; then
+    echo "$1: UNKNOWN — scan failed; treat as un-run, not clean."
+    exit 1
+  fi
+  mapfile -t hits < "$_HITS_TMP"
+}
+
+# ---------------- detect mode (cron) ----------------
+if [[ "$MODE" == "detect" ]]; then
+  load_hits "model-drift"
+  if [[ ${#hits[@]} -gt 0 ]]; then
+    echo "model-drift: ${#hits[@]} config file(s) carry a stale model ID (auto-fixable via /soleur:model-launch-review)."
+    for f in "${hits[@]}"; do echo "  - $(rel "$f")"; done
+    exit 10
+  fi
+  echo "model-drift: none (config model IDs current)."
+  exit 0
+fi
+
+# ---------------- fix mode (mechanical model-ID swaps only) ----------------
+if [[ "$MODE" == "fix" ]]; then
+  load_hits "model-fix"
+  for f in "${hits[@]}"; do
+    before=$(wc -l < "$f")
+    tmp="$(mktemp)"
+    cp "$f" "$tmp"
+    for pair in "${AUTOFIX_PAIRS[@]}"; do
+      from="${pair%%=*}"; to="${pair#*=}"
+      # anchored on the SAME boundary as selection (ID_BOUNDARY): preserve the
+      # trailing char so a longer/dated variant (claude-opus-4-7-20260101) or a
+      # successor that extends the stale id (claude-fable-5-1) is NOT corrupted
+      # by a prefix swap.
+      sed -i -E "s/${from}${ID_BOUNDARY}/${to}\1/g" "$f"
+    done
+    after=$(wc -l < "$f")
+    # deletion guard: a 1-for-1 ID swap must not change line count materially.
+    if (( before - after > DELETION_GUARD )); then
+      cp "$tmp" "$f"   # revert
+      rm -f "$tmp"
+      echo "ABORT: $(rel "$f") would lose $((before - after)) lines (> DELETION_GUARD=$DELETION_GUARD); reverted." >&2
+      exit 1
+    fi
+    rm -f "$tmp"
+    echo "fixed: $(rel "$f")"
+  done
+  exit 0
+fi
+
+# ---------------- audit mode (report; no silent green) ----------------
+echo "== model-launch-review audit =="
+echo "root: $ROOT"
+echo
+
+echo "[1] model-ID inventory (AUTO-FIX)"
+load_hits "  model-ID inventory"
+if [[ ${#hits[@]} -gt 0 ]]; then
+  echo "  stale config model IDs found (mechanical same-tier swap):"
+  for f in "${hits[@]}"; do
+    # Same anchored matcher as selection, then drop the boundary char the
+    # pattern had to capture (an end-of-line match captures nothing to drop),
+    # so the report names the id and not `claude-fable-5"`.
+    # `set -o pipefail` is in force, so a no-match here kills the script with no
+    # message. That silence is the wrong failure: the file is in `hits` BECAUSE
+    # the selector matched it, so an empty re-scan means selection and display
+    # have diverged — the exact class ID_BOUNDARY exists to prevent — and it
+    # must be named rather than mistaken for an ordinary abort.
+    # Trigger on EMPTINESS, not just on a non-zero rc. `grep -o` on a file it
+    # considers binary prints "binary file matches" to stderr, yields no stdout
+    # and exits 0 — so an rc-only guard stayed silent on the one realistic
+    # divergence and the report printed a bare `[]` while the audit exited 0
+    # (measured). Selection now skips binaries (-I), so this is a true internal
+    # invariant; keep both conditions so neither half can go quiet alone.
+    ids="$(grep -oE "$(autofix_match_re)" "$f" 2>/dev/null | sed -E 's/[^0-9A-Za-z-]+$//' | sort -u | tr '\n' ' ')" || true
+    if [[ -z "${ids// /}" ]]; then
+      echo "audit-models: INTERNAL — selector matched $(rel "$f") but the display re-scan found no id." >&2
+      echo "  selection and display disagree; they must share autofix_match_re." >&2
+      exit 70
+    fi
+    echo "    - $(rel "$f")  [${ids}]"
+  done
+  echo "  → run with --fix (each stale id → its current same-tier id), then open a CI-gated PR."
+else
+  echo "  none — config model IDs are current."
+fi
+# flag-only: very old families
+mapfile -t old < <(grep -rEl "$FLAG_ONLY_STALE_RE" "$ROOT" \
+  --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=.next 2>/dev/null \
+  | grep -vE "$EXCLUDE_RE" || true)
+if [[ ${#old[@]} -gt 0 ]]; then
+  echo "  FLAG (manual, too old for blind swap):"
+  for f in "${old[@]}"; do echo "    - $(rel "$f")"; done
+fi
+echo
+
+echo "[2] claude-code-action pin freshness (FLAG-ONLY)"
+mapfile -t pins < <(grep -rl 'anthropics/claude-code-action@' "$ROOT/.github" 2>/dev/null || true)
+if [[ ${#pins[@]} -gt 0 ]]; then
+  echo "  workflows pinning claude-code-action:"
+  for f in "${pins[@]}"; do
+    echo "    - $(rel "$f"): $(grep -oE 'claude-code-action@[a-f0-9]+ # v[0-9.]+' "$f" | head -1)"
+  done
+  # Compute the drift rather than telling a human to run a command
+  # (hr-no-dashboard-eyeball-pull-data-yourself). Best-effort: `gh` may be
+  # absent or unauthenticated in a cron sandbox, and that MUST read as
+  # UNKNOWN — never as "the pin is fresh".
+  if command -v gh >/dev/null 2>&1; then
+    _tip="$(gh api repos/anthropics/claude-code-action/releases --jq '.[0].tag_name' 2>/dev/null || true)"
+    _pin_sha="$(grep -ohE 'claude-code-action@[a-f0-9]{40}' "${pins[@]}" 2>/dev/null | head -1 | cut -d@ -f2)"
+    # These pins are annotated TAG objects, so git/tags resolves them. A pin
+    # produced by pin-github-action/Dependabot is a plain COMMIT sha, where
+    # git/tags 404s and commits/<sha> is the correct call — try both.
+    _pin_desc=""
+    if [[ -n "$_pin_sha" ]]; then
+      _pin_desc="$(gh api "repos/anthropics/claude-code-action/git/tags/$_pin_sha" --jq '"\(.tag) \(.tagger.date)"' 2>/dev/null \
+        || gh api "repos/anthropics/claude-code-action/commits/$_pin_sha" --jq '"(commit) \(.commit.committer.date)"' 2>/dev/null \
+        || true)"
+    fi
+    if [[ -n "$_tip" && -n "$_pin_desc" ]]; then
+      echo "    pinned: $_pin_desc    tip: $_tip"
+    else
+      echo "    pin freshness: UNKNOWN (GitHub API unreachable) — NOT a freshness pass."
+    fi
+  else
+    echo "    pin freshness: UNKNOWN (gh not on PATH) — NOT a freshness pass."
+  fi
+  echo "    bump a pin ONLY when coupled to a --model swap in the same workflow (#2540 invariant)."
+else
+  echo "  no claude-code-action pins under .github (or scanning a test root)."
+fi
+echo
+
+echo "[2b] pinned claude-code CLI knows the tier models (FLAG-ONLY)"
+# The `claude` CLI carries a BUNDLED per-model table. A model ID absent from it
+# is treated exactly like a garbage ID: the CLI silently falls back to HALF the
+# max_tokens (measured 64000 -> 32000, #6934), degrading every cron that passes
+# --model. This is invisible to the model-ID sweep, to tsc, and to the suite —
+# the argv is well-formed and the run succeeds. Grep the installed bundle when
+# present; absence of node_modules is UNKNOWN, never a pass.
+#
+# WHAT IS MEASURED: the INSTALLED tree, which is not necessarily the PIN. The
+# model table ships in the platform binary (@anthropic-ai/claude-code-linux-x64),
+# fetched by the stub's postinstall — the npm tarball for @anthropic-ai/claude-code
+# is a ~23 kB launcher that contains no model ids at all, so only an installed
+# (or separately unpacked platform) tree can answer this question.
+#
+# A stale node_modules therefore reports DRIFT against ids the PIN actually
+# knows. Observed 2026-09-03: node_modules held 2.1.142 while package.json
+# pinned 2.1.219, and this check reported `claude-opus-5` and `claude-sonnet-5`
+# ABSENT — both are present in 2.1.219. A false DRIFT here costs a needless
+# dependency bump; the same skew in the other direction (node_modules NEWER
+# than the pin) would report a false PASS, which is worse. So state the two
+# versions and refuse to call a mismatch a measurement of the pin.
+# SCOPE IS LOAD-BEARING: probe the PLATFORM BINARY, never the @anthropic-ai
+# scope. Measured 2026-09-03 in this repo: `claude-agent-sdk` and
+# `claude-agent-sdk-linux-x64` BOTH contain `claude-sonnet-5`, so a scope-wide
+# grep answers "ok present in the pinned CLI bundle" from the AGENT SDK while
+# claude-code lacks the id entirely — a false PASS on the exact #6934
+# degradation this check exists to catch. Read the version from the same
+# package we grep, or the printed version labels a measurement of a different
+# package (the stub carries no model ids, so its version is not the subject).
+_cli_pkg="$ROOT/apps/web-platform/node_modules/@anthropic-ai/claude-code-linux-x64"
+_cli_dir="$_cli_pkg"
+_cli_pinned="$(grep -oE '"@anthropic-ai/claude-code"[[:space:]]*:[[:space:]]*"[^"]+"' \
+  "$ROOT/apps/web-platform/package.json" 2>/dev/null | grep -oE '[0-9][^"]*' | head -1 || true)"
+_cli_installed="$(grep -oE '"version"[[:space:]]*:[[:space:]]*"[^"]+"' \
+  "$_cli_pkg/package.json" 2>/dev/null \
+  | head -1 | grep -oE '[0-9][^"]*' || true)"
+# Every arm names what it measured. The `elif` MUST require _cli_installed:
+# guarding on _cli_pinned alone printed "matches the package.json pin" on a
+# tree with no install at all (reproduced on a root carrying only
+# package.json), immediately above the UNKNOWN line that contradicts it — a
+# pass-shaped claim over a channel that was never read, which is the
+# absent-vs-could-not-look conflation collect_config_hits exists to prevent.
+if [[ -n "$_cli_pinned" && -n "$_cli_installed" && "$_cli_pinned" != "$_cli_installed" ]]; then
+  echo "    NOTE: measuring INSTALLED ${_cli_installed}, but package.json pins ${_cli_pinned}."
+  echo "          Findings below describe the installed tree, NOT the pin — reinstall before trusting them."
+elif [[ -n "$_cli_pinned" && -n "$_cli_installed" ]]; then
+  echo "    measuring installed tree @ ${_cli_installed} (matches the package.json pin)."
+elif [[ -n "$_cli_pinned" ]]; then
+  echo "    pin: ${_cli_pinned} / installed: (none) — comparison UNKNOWN, not a match."
+else
+  echo "    pin: UNKNOWN (could not read @anthropic-ai/claude-code from apps/web-platform/package.json)."
+fi
+if [[ -d "$_cli_dir" ]]; then
+  # `fable` included: the alternation must cover every tier that can appear in
+  # the scanned registries, or the one model whose id the pin lacks is the one
+  # model never checked. (Fable reaches Soleur as the harness `model: fable`
+  # ALIAS today, so no fable literal is in these files yet — this closes the
+  # gap for the launch where one lands.)
+  for _m in $(grep -ohE '"claude-(opus|sonnet|haiku|fable)-[0-9a-z-]+"' \
+                "$ROOT/apps/web-platform/server/inngest/model-tiers.ts" \
+                "$ROOT/apps/web-platform/server/inngest/leader-prompts/constants.ts" 2>/dev/null \
+              | tr -d '"' | sort -u); do
+    # -a: the linux-x64 CLI is a compiled binary; a text-mode grep silently
+    # reports zero hits for EVERY id, including known-good ones (a null result
+    # that reads exactly like a real one).
+    # Anchored on the SAME boundary as everything else: a fixed-string probe is
+    # unanchored on both sides, so a bundle carrying only `claude-opus-5-20260101`
+    # answered "ok present" for `claude-opus-5` AND for the bare tier
+    # `claude-opus` (measured). That is this PR's own prefix-shadowing class in
+    # the PRESENCE direction — a tier whose id the pin genuinely lacks reports
+    # green whenever any longer id sharing its prefix is in the blob.
+    # Left-anchored too (#8603), matching the CI twin
+    # apps/web-platform/test/server/inngest/claude-cli-pin-knows-models.test.ts:
+    # an id present only inside a longer token (the Bedrock provider form
+    # `us.anthropic.<id>`) is not an entry the model table resolves.
+    if grep -raqE "(^|[^0-9A-Za-z.-])${_m}${ID_BOUNDARY}" "$_cli_dir" 2>/dev/null; then
+      echo "    ok      $_m present in the pinned CLI bundle"
+    else
+      echo "    DRIFT   $_m ABSENT from ${_cli_pkg##*/} @ ${_cli_installed:-unknown} — bump @anthropic-ai/claude-code"
+    fi
+  done
+else
+  echo "    UNKNOWN (${_cli_pkg#"$ROOT"/} absent) — NOT a pass; run after install."
+fi
+echo
+
+echo "[3] pricing + tier-map + dormant work (FLAG-ONLY)"
+echo "  - pricing: compare apps/web-platform/server/inngest/functions/agent-on-spawn-requested.ts"
+echo "    MODEL_PRICING rows against the claude-api source-of-truth; never auto-edit (billing constant)."
+echo "  - tier-map: re-check cron model literals + ADR-053 / plugins/soleur/AGENTS.md policy vs new pricing."
+echo "    (workflow-model-pins.test.ts PIN_ALLOWLIST is a don't-mutate invariant, not a pricing surface.)"
+echo "  - dormant: gh issue list --state open -L 200 --search 'deferred model OR pricing'"
+echo "  - grok tier-map (item 6, agent-run): compare 'grok models' + docs.x.ai against TIER_MAPS.grok."
+echo "  - thinking-API shape: the REQUEST side sets no thinking params, but the CLI applies each"
+echo "    model row's default_effort: re-decide AUDIT_EFFORT (apps/web-platform/server/inngest/"
+echo "    model-tiers.ts) and update REVIEWED_DEFAULT_EFFORT in claude-cli-pin-knows-models.test.ts (#8603)."
+echo "    The RESPONSE side is NOT inert: a thinking-by-default model puts a thinking block"
+echo "    FIRST, so any reader indexing a fixed content position silently returns empty"
+echo "    and the model's answer is billed and discarded (#8392)."
+echo "    The BLOCKING guard is scripts/lint-anthropic-content-position.py, twin-"
+echo "    registered in scripts/test-all.sh so it gates every PR — this census does"
+echo "    NOT gate anything and is reachable only from this hand-run audit mode"
+echo "    (--detect and --fix both return before it). Advisory echo of the same scan:"
+collect_content_position_readers
+echo
+echo "== end audit =="