@bongos/core 1.21.176 → 1.21.178

package/scripts/gds/rename-goals.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/rename-goals.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/rename-goals.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'rename-goals.js');

package/scripts/gds/seed-adopt-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-adopt-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-adopt-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-adopt-tasks.js');

package/scripts/gds/seed-api-contract-goal-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-api-contract-goal-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-api-contract-goal-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-api-contract-goal-tasks.js');

package/scripts/gds/seed-board-room-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-board-room-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-board-room-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-board-room-tasks.js');

package/scripts/gds/seed-bongos-app-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-app-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-app-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-app-tasks.js');

package/scripts/gds/seed-bongos-coreB-tranche1-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-coreB-tranche1-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-coreB-tranche1-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-coreB-tranche1-tasks.js');

package/scripts/gds/seed-bongos-coreB-tranche2-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-coreB-tranche2-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-coreB-tranche2-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-coreB-tranche2-tasks.js');

package/scripts/gds/seed-bongos-goal-hierarchy-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-goal-hierarchy-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-goal-hierarchy-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-goal-hierarchy-tasks.js');

package/scripts/gds/seed-bongos-module-system-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-module-system-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-module-system-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-module-system-tasks.js');

package/scripts/gds/seed-bongos-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-bongos-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-tasks.js');

package/scripts/gds/seed-bongos-v1-seo-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bongos-v1-seo-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bongos-v1-seo-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bongos-v1-seo-tasks.js');

package/scripts/gds/seed-bv1-community-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bv1-community-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bv1-community-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bv1-community-tasks.js');

package/scripts/gds/seed-bv1-privacy-invites-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bv1-privacy-invites-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bv1-privacy-invites-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bv1-privacy-invites-tasks.js');

package/scripts/gds/seed-bv1-profile-page-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bv1-profile-page-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bv1-profile-page-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bv1-profile-page-tasks.js');

package/scripts/gds/seed-bv1-r01-delta-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bv1-r01-delta-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bv1-r01-delta-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bv1-r01-delta-tasks.js');

package/scripts/gds/seed-bv2-tweak-mode-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-bv2-tweak-mode-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-bv2-tweak-mode-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-bv2-tweak-mode-tasks.js');

package/scripts/gds/seed-gds-v4-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-gds-v4-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-gds-v4-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-gds-v4-tasks.js');

package/scripts/gds/seed-governance-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-governance-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-governance-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-governance-tasks.js');

package/scripts/gds/seed-medusa-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-medusa-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-medusa-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-medusa-tasks.js');

package/scripts/gds/seed-module-upstreaming.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-module-upstreaming.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-module-upstreaming.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-module-upstreaming.js');

package/scripts/gds/seed-productization-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-productization-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-productization-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-productization-tasks.js');

package/scripts/gds/seed-project-admin-console-tasks.js

@@ -1,6 +0,0 @@
-// scripts/gds/seed-project-admin-console-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-project-admin-console-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-project-admin-console-tasks.js');

package/scripts/gds/seed-provisioning-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-provisioning-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-provisioning-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-provisioning-tasks.js');

package/scripts/gds/seed-strict-versioning-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-strict-versioning-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-strict-versioning-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-strict-versioning-tasks.js');

package/scripts/gds/seed-v2-world-tasks.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/seed-v2-world-tasks.js — @bongos-forwarder (task 1004848). Generated by
-// scripts/bongos/codemod-rename-scripts-gds.js; do not edit.
-// The real script is scripts/bongos/seed-v2-world-tasks.js. This forwarder keeps callers that still name
-// the old path working, and warns once so they get repointed. Task 1003706 removes it.
-'use strict';
-require('../bongos/forwarder.js').forward(module, 'seed-v2-world-tasks.js');

package/scripts/migrate_cost_ledger.sh

@@ -1,178 +0,0 @@
-#!/usr/bin/env bash
-# scripts/migrate_cost_ledger.sh
-#
-# One-shot (idempotent) migration: fold any per-worktree
-# art/iterations/cost_ledger.jsonl files into the shared location at
-# ~/.config/otb/iterations/cost_ledger.jsonl, then rebuild cost_summary.json
-# from the merged ledger.
-#
-# Per GDS #140 (2026-05-10 Lars decision): the ledger lives next to
-# pms-session.json + GOOGLE_AI_STUDIO_KEY in $HOME so it survives worktree churn
-# the way the API key does.
-#
-# Safe to re-run: appends only ledger rows not already present in the shared
-# file (matched by (ts, model, kind, tile, attempt, cost_usd, notes) tuple).
-# Per-worktree files are renamed to *.migrated-<timestamp> instead of deleted,
-# so nothing is destroyed.
-#
-# Usage:
-#   scripts/migrate_cost_ledger.sh                  # search standard locations
-#   scripts/migrate_cost_ledger.sh <ledger> [...]   # explicit files to fold in
-#   OTB_LEDGER_DIR=/tmp/foo scripts/migrate_cost_ledger.sh   # override target
-
-set -euo pipefail
-
-SHARED_DIR="${OTB_LEDGER_DIR:-$HOME/.config/otb/iterations}"
-SHARED_LEDGER="$SHARED_DIR/cost_ledger.jsonl"
-SHARED_SUMMARY="$SHARED_DIR/cost_summary.json"
-
-mkdir -p "$SHARED_DIR"
-touch "$SHARED_LEDGER"
-
-# Build candidate list: explicit args win, otherwise sweep common locations.
-declare -a CANDIDATES=()
-if [ "$#" -gt 0 ]; then
-    CANDIDATES=("$@")
-else
-    # Repo root (this script lives in <root>/scripts/).
-    SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-    REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-    # 1. The current repo's per-worktree ledger.
-    [ -f "$REPO_ROOT/art/iterations/cost_ledger.jsonl" ] && \
-        CANDIDATES+=("$REPO_ROOT/art/iterations/cost_ledger.jsonl")
-
-    # 2. Any sibling worktrees of this repo.
-    if [ -d "$REPO_ROOT/.claude/worktrees" ]; then
-        while IFS= read -r p; do
-            CANDIDATES+=("$p")
-        done < <(find "$REPO_ROOT/.claude/worktrees" -mindepth 2 -maxdepth 4 \
-                      -type f -name cost_ledger.jsonl 2>/dev/null)
-    fi
-fi
-
-# De-dup the candidate list AND drop the shared-ledger path itself if it snuck in.
-# (Stays portable to macOS default bash 3.2 — no associative arrays.)
-SHARED_REAL="$(cd "$SHARED_DIR" && pwd)/cost_ledger.jsonl"
-SEEN_LIST=""
-FILTERED=()
-for c in "${CANDIDATES[@]+"${CANDIDATES[@]}"}"; do
-    [ -f "$c" ] || continue
-    REAL="$(cd "$(dirname "$c")" && pwd)/$(basename "$c")"
-    [ "$REAL" = "$SHARED_REAL" ] && continue
-    case "$SEEN_LIST" in
-        *"|$REAL|"*) continue ;;
-    esac
-    SEEN_LIST="$SEEN_LIST|$REAL|"
-    FILTERED+=("$REAL")
-done
-
-if [ "${#FILTERED[@]}" -eq 0 ]; then
-    echo "No per-worktree cost_ledger.jsonl files to migrate."
-    echo "Shared ledger: $SHARED_LEDGER"
-    # Still rebuild the summary so a fresh shared dir gets a summary file.
-    python3 "$(dirname "$0")/../modules/art-pipeline/pipeline/cost_ledger.py" status >/dev/null || true
-    exit 0
-fi
-
-echo "Migrating to: $SHARED_LEDGER"
-for f in "${FILTERED[@]}"; do echo "  source: $f"; done
-
-# Python does the dedup + merge + summary rebuild. Keeps the bash side simple
-# and gives us proper JSON-aware comparison.
-python3 - "$SHARED_LEDGER" "$SHARED_SUMMARY" "${FILTERED[@]}" <<'PYEOF'
-import json, os, sys, time
-from pathlib import Path
-
-shared_ledger = Path(sys.argv[1])
-shared_summary = Path(sys.argv[2])
-sources = [Path(p) for p in sys.argv[3:]]
-
-def row_key(r: dict) -> tuple:
-    # Identity: (ts, model, kind, tile, attempt, cost_usd, notes).
-    # No `id` column exists today, so dedup by content tuple.
-    return (
-        r.get("ts", ""),
-        r.get("model", ""),
-        r.get("kind", ""),
-        r.get("tile", ""),
-        r.get("attempt", 0),
-        round(float(r.get("cost_usd", 0.0)), 6),
-        r.get("notes", ""),
-    )
-
-existing_keys: set = set()
-if shared_ledger.exists():
-    with shared_ledger.open() as f:
-        for line in f:
-            line = line.strip()
-            if not line:
-                continue
-            try:
-                existing_keys.add(row_key(json.loads(line)))
-            except Exception:
-                pass
-
-added = 0
-skipped_dup = 0
-skipped_bad = 0
-ts_suffix = time.strftime("%Y%m%dT%H%M%S")
-
-with shared_ledger.open("a") as out:
-    for src in sources:
-        if not src.exists():
-            continue
-        with src.open() as f:
-            for line in f:
-                line_stripped = line.strip()
-                if not line_stripped:
-                    continue
-                try:
-                    row = json.loads(line_stripped)
-                except Exception:
-                    skipped_bad += 1
-                    continue
-                k = row_key(row)
-                if k in existing_keys:
-                    skipped_dup += 1
-                    continue
-                existing_keys.add(k)
-                out.write(line if line.endswith("\n") else line_stripped + "\n")
-                added += 1
-        # Rename source so a re-run doesn't re-process it AND nothing is destroyed.
-        try:
-            src.rename(src.with_suffix(src.suffix + f".migrated-{ts_suffix}"))
-            print(f"  archived: {src} → {src.name}.migrated-{ts_suffix}")
-        except OSError as e:
-            print(f"  warn: could not rename {src}: {e}", file=sys.stderr)
-
-# Rebuild summary from the merged ledger.
-total = 0.0
-n = 0
-with shared_ledger.open() as f:
-    for line in f:
-        line = line.strip()
-        if not line:
-            continue
-        try:
-            total += float(json.loads(line).get("cost_usd", 0.0))
-            n += 1
-        except Exception:
-            pass
-
-HARD_STOP = 80.00
-shared_summary.parent.mkdir(parents=True, exist_ok=True)
-shared_summary.write_text(json.dumps({
-    "total_usd": round(total, 4),
-    "calls": n,
-    "hard_stop_usd": HARD_STOP,
-    "remaining_usd": round(HARD_STOP - total, 4),
-    "updated_at": time.strftime("%Y-%m-%dT%H:%M:%S"),
-}, indent=2))
-
-print(f"\nMerged: {added} new rows, {skipped_dup} duplicates skipped, {skipped_bad} malformed lines skipped.")
-print(f"Shared ledger now: {n} rows, ${total:.4f} spent of ${HARD_STOP:.2f} cap.")
-PYEOF
-
-echo
-echo "Done. Verify with: python3 modules/art-pipeline/pipeline/cost_ledger.py status"

package/tests/artifact_staleness.mjs

@@ -1,207 +0,0 @@
-// tests/artifact_staleness.mjs
-//
-// Covers scripts/bongos/artifact-staleness.js (task 1001930, ADR 0110 pt.5) — the backstop
-// for the gitignored, deploy-generated navigation docs.
-//
-// ADR 0110 untracked docs/repo-map.md + docs/session-log-index.md to kill a merge-collision
-// class, and accepted a debt in writing: a deploy generator that breaks leaves a stale or
-// absent file with no blocking gate, alarming only via a ::ERROR:: line in journald. This
-// check is that backstop, so the properties worth pinning are the ones that decide whether
-// anyone will still be reading it in six months:
-//
-//   1. it distinguishes CANNOT-CHECK from FOUND-SOMETHING (a monitor that cries wolf when
-//      it is merely in the wrong place is one nobody reads — the exact ADR 0110 failure);
-//   2. absent and stale stay separate (they send a reader to two different places);
-//   3. the registry cannot silently fall behind the set of gitignored artifacts.
-//
-// `run`/`exists` are injected throughout, so nothing here touches a real generator, git
-// repo, or network. The end-to-end behaviour against the REAL generators was verified by
-// hand at ship time (fresh / absent / stale / both), which fakes cannot prove.
-//
-// Run:  node --test tests/artifact_staleness.mjs
-
-import { test } from 'node:test';
-import path from 'node:path';
-import assert from 'node:assert/strict';
-import { createRequire } from 'node:module';
-import { readFileSync, readdirSync } from 'node:fs';
-
-const require = createRequire(import.meta.url);
-const { ARTIFACTS, atMain, checkArtifact, check, report } = require('../scripts/bongos/artifact-staleness.js');
-
-const SHA = 'a'.repeat(40);
-const OTHER = 'b'.repeat(40);
-
-// A fake `run` for git: a table keyed by the git subcommand+args it is asked.
-function fakeGit({ head = SHA, main = SHA, porcelain = '', branch = 'main', fail = null } = {}) {
-  return (cmd, args) => {
-    const key = args.join(' ');
-    if (fail && key.includes(fail)) return { status: 1, stdout: '', stderr: 'boom' };
-    if (key === 'rev-parse HEAD') return { status: 0, stdout: `${head}\n` };
-    if (key === 'rev-parse origin/main') return { status: 0, stdout: `${main}\n` };
-    if (key === 'rev-parse --abbrev-ref HEAD') return { status: 0, stdout: `${branch}\n` };
-    if (key === 'status --porcelain') return { status: 0, stdout: porcelain };
-    return { status: 0, stdout: '' };
-  };
-}
-
-// ── the guard: when is a comparison even meaningful? ────────────────────────────
-
-test('at origin/main with a clean tree is comparable', () => {
-  assert.equal(atMain(fakeGit()).ok, true);
-});
-
-test('a feature branch is INCONCLUSIVE — the artifact would be judged against the wrong code', () => {
-  const r = atMain(fakeGit({ head: OTHER, branch: 'claude/some-task' }));
-  assert.equal(r.ok, false);
-  assert.match(r.reason, /claude\/some-task/);
-  assert.match(r.reason, /not origin\/main/);
-});
-
-test('a DIRTY tree is inconclusive — a generator regenerates from the working tree, not from main', () => {
-  // The real bug this caught: running the check against its own uncommitted source file
-  // reported repo-map.md stale when it in fact matched main.
-  const r = atMain(fakeGit({ porcelain: ' M scripts/bongos/artifact-staleness.js\n' }));
-  assert.equal(r.ok, false);
-  assert.match(r.reason, /not clean/);
-  assert.match(r.reason, /scripts\/(?:gds|bongos)\/artifact-staleness\.js/);
-});
-
-test('every porcelain status column is parsed whole — an unstaged " M" must not lose its first letter', () => {
-  // The SECOND bug this file caught: the reader trimmed the buffer, and an unstaged
-  // modification's leading space is significant, so the first line printed "cripts/…".
-  // One case per column shape, first-line position included, since only the first line
-  // was ever affected.
-  for (const line of [' M scripts/bongos/artifact-staleness.js', 'M  scripts/bongos/artifact-staleness.js', '?? scripts/bongos/artifact-staleness.js', 'A  scripts/bongos/artifact-staleness.js']) {
-    const r = atMain(fakeGit({ porcelain: `${line}\n` }));
-    assert.match(r.reason, /\(scripts\/(?:gds|bongos)\/artifact-staleness\.js\)/, `mangled the path for "${line}"`);
-  }
-});
-
-test('a long dirty list is truncated with a count rather than dumped', () => {
-  const porcelain = [' M a.js', ' M b.js', ' M c.js', ' M d.js', ' M e.js'].join('\n') + '\n';
-  const r = atMain(fakeGit({ porcelain }));
-  assert.match(r.reason, /a\.js, b\.js, c\.js, \+2 more/);
-});
-
-test('git being unable to answer is inconclusive, never a pass', () => {
-  assert.equal(atMain(fakeGit({ fail: 'rev-parse origin/main' })).ok, false);
-  assert.equal(atMain(fakeGit({ fail: 'status --porcelain' })).ok, false);
-  assert.equal(atMain(fakeGit({ fail: 'rev-parse HEAD' })).ok, false);
-});
-
-test('check() REFUSES rather than reporting a finding when the checkout is not comparable', () => {
-  assert.throws(
-    () => check({ run: fakeGit({ head: OTHER }), exists: () => true }),
-    (e) => e.inconclusive === true,
-    'an inconclusive run must be distinguishable from a finding',
-  );
-});
-
-// ── one artifact's verdict ──────────────────────────────────────────────────────
-
-const A = { rel: 'docs/repo-map.md', generator: 'gen-repo-map.js', what: 'the symbol skeleton' };
-const gen = (status, extra = {}) => () => ({ status, stdout: '', stderr: '', ...extra });
-
-test('generator exit 0 → fresh', () => {
-  assert.equal(checkArtifact(A, { run: gen(0), exists: () => true }).state, 'fresh');
-});
-
-test('generator exit 2 + file present → stale; + file absent → absent', () => {
-  assert.equal(checkArtifact(A, { run: gen(2), exists: () => true }).state, 'stale');
-  assert.equal(checkArtifact(A, { run: gen(2), exists: () => false }).state, 'absent');
-});
-
-test('a generator that cannot answer is UNKNOWN, never stale — it is not a finding about the artifact', () => {
-  const crashed = checkArtifact(A, { run: gen(1, { stderr: 'SyntaxError: bad\n' }), exists: () => true });
-  assert.equal(crashed.state, 'unknown');
-  assert.match(crashed.detail, /SyntaxError/);
-  const spawnFailed = checkArtifact(A, { run: () => ({ error: new Error('ENOENT') }), exists: () => true });
-  assert.equal(spawnFailed.state, 'unknown');
-});
-
-// ── the report a human actually reads ───────────────────────────────────────────
-
-const runFor = (byGenerator) => (cmd, args) => {
-  if (cmd === 'git') return fakeGit()(cmd, args);
-  // path.basename, not split('/') — the checker passes an ABSOLUTE generator path,
-  // which is backslash-separated on Windows, so this returned the whole path, matched
-  // no key in byGenerator, and every generator reported `status: undefined` -> "exit
-  // undefined". Three suites carried this same idiom (task 1003848).
-  const which = path.basename(String(args[0] || ''));
-  return { status: byGenerator[which], stdout: '', stderr: '' };
-};
-
-test('all fresh → one quiet line, and no alarm language', () => {
-  const r = check({ run: runFor({ 'gen-repo-map.js': 0, 'gen-session-index.js': 0 }), exists: () => true });
-  assert.equal(r.stale.length + r.absent.length, 0);
-  const text = report(r);
-  assert.match(text, /current/);
-  assert.ok(!text.includes('⚠'), 'a healthy run must not look like a finding');
-});
-
-test('absent and stale are reported as different things, not one blurred count', () => {
-  const r = check({
-    run: runFor({ 'gen-repo-map.js': 2, 'gen-session-index.js': 2 }),
-    exists: (p) => !String(p).endsWith('repo-map.md'), // repo-map gone, session-index present
-  });
-  assert.deepEqual(r.absent.map((a) => a.rel), ['docs/repo-map.md']);
-  assert.deepEqual(r.stale.map((a) => a.rel), ['docs/session-log-index.md']);
-  const text = report(r);
-  assert.match(text, /docs\/repo-map\.md — MISSING entirely/);
-  assert.match(text, /docs\/session-log-index\.md — out of date/);
-  assert.match(text, /deploy step/, 'the report must say where to go look');
-});
-
-test('an unchecked artifact is surfaced even when nothing is stale — unwatched must not read as healthy', () => {
-  const r = check({ run: runFor({ 'gen-repo-map.js': 0, 'gen-session-index.js': 1 }), exists: () => true });
-  assert.equal(r.stale.length + r.absent.length, 0);
-  assert.equal(r.unknown.length, 1);
-  assert.match(report(r), /Could not check 1 artifact/);
-});
-
-// ── the registry cannot fall behind reality ─────────────────────────────────────
-
-test('every registered artifact is really gitignored — a tracked file belongs to the PR gate instead', () => {
-  const ignore = readFileSync(new URL('../.gitignore', import.meta.url), 'utf8')
-    .split('\n').map((l) => l.trim());
-  for (const a of ARTIFACTS) {
-    assert.ok(ignore.includes(a.rel), `${a.rel} must be gitignored to belong in this check`);
-  }
-});
-
-test('every registered generator really exposes --check-whole — the contract this check is built on', () => {
-  for (const a of ARTIFACTS) {
-    const src = readFileSync(new URL(`../scripts/bongos/${a.generator}`, import.meta.url), 'utf8');
-    assert.match(src, /--check-whole/, `${a.generator} must support --check-whole`);
-  }
-});
-
-test('the two ADR 0110 artifacts are both covered, and the known exclusions stay deliberate', () => {
-  assert.deepEqual(ARTIFACTS.map((a) => a.rel).sort(), ['docs/repo-map.md', 'docs/session-log-index.md']);
-  // atlas.json and the diagram renders are gitignored + deploy-generated too, but neither
-  // can be answered by this mechanism (a timestamped payload; a render needing Chromium).
-  // The reasons are written out at ARTIFACTS — this asserts they were a decision, so that
-  // adding either later is a deliberate act rather than a silent widening.
-  const src = readFileSync(new URL('../scripts/bongos/artifact-staleness.js', import.meta.url), 'utf8');
-  assert.match(src, /atlas\.json/, 'the atlas exclusion must stay documented');
-  assert.match(src, /diagrams/, 'the diagram-render exclusion must stay documented');
-});
-
-test('this check must NOT be wired into CI — a fresh clone legitimately has none of these files', () => {
-  // The artifacts are gitignored, so a CI checkout never has them and this would be red on
-  // every single run — the "monitor nobody reads" failure ADR 0110 already has once. The
-  // mistake is an easy one to make by analogy with publish-watch.js, which IS a workflow
-  // (it reads git + the registry, so it is true anywhere). Assert no workflow invokes it.
-  const src = readFileSync(new URL('../scripts/bongos/artifact-staleness.js', import.meta.url), 'utf8');
-  assert.match(src, /NEVER in CI/, 'the file must state where it may run');
-
-  let names = [];
-  try { names = readdirSync(new URL('../.github/workflows', import.meta.url)); } catch { names = []; }
-  const callers = names.filter((n) => {
-    try {
-      return readFileSync(new URL(`../.github/workflows/${n}`, import.meta.url), 'utf8').includes('artifact-staleness');
-    } catch { return false; }
-  });
-  assert.deepEqual(callers, [], `no workflow may run this check; found: ${callers.join(', ')}`);
-});