@andresmassello/uscha 1.86.0 → 1.86.1

package/README.md

@@ -40,7 +40,7 @@ Requires **Python 3.8+** on the machine (the engine is Python stdlib — no pip
 runtime dependencies). The npm package is a thin router; the canonical installer is
 `uscha-kit/install-uscha.py`.
 
-**Kit v1.86.0** <!-- uscha:version --> · [uscha.dev](https://uscha.dev) ·
+**Kit v1.86.1** <!-- uscha:version --> · [uscha.dev](https://uscha.dev) ·
 [changelog](https://github.com/andresmassello/uscha/blob/main/uscha-kit/CHANGELOG.md)
 (the per-release changelogs live in the repo, not in the npm tarball)
 
@@ -85,7 +85,7 @@ automatic tool can perform: a human verdict.
    from the compiled code: 0.062 measured (12 archetypes) — names, not yet semantics
 ```
 
-**What each arrow is, in the engine (kit 1.86.0, 52 subcommands, all measured):**
+**What each arrow is, in the engine (kit 1.86.1, 52 subcommands, all measured):**
 
 | Leg | Subcommands | What it establishes |
 |---|---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andresmassello/uscha",
-  "version": "1.86.0",
+  "version": "1.86.1",
   "description": "Spec-driven development for LLM coding agents: 9 skills + a stdlib evidence engine. Facts block, guesses advise; the human approves.",
   "author": {
     "name": "Andres Massello",

package/uscha-kit/.claude/skills/uscha-devloop/qa_ledger.py

@@ -142,7 +142,7 @@ def _integrity_hash(data):
     return hashlib.sha256(blob.encode("utf-8")).hexdigest()
 
 
-def _load(path):
+def _load(path, what="ledger", flag="--ledger"):
     """Carga blindada (kit 1.13.0, Topic 34: los recursos compartidos mutables
     incluyen ARCHIVOS). JSON corrupto/truncado = hecho bloqueante con mensaje
     de recuperacion, no un traceback. Si el archivo trae campo integrity
@@ -153,6 +153,12 @@ def _load(path):
     try:
         with open(path, "r", encoding="utf-8") as fh:
             data = json.load(fh)
+    except FileNotFoundError:
+        # what/flag name the file kind and the flag that points at it (1.86.1 re-judge: a
+        # hardcoded "ledger ... --ledger" misled the very first command of a fresh clone,
+        # init --config, and rebuild --baseline).
+        hint = " -- run the dev loop first, or pass --ledger" if what == "ledger" else f" -- pass {flag}"
+        raise SystemExit(f"[qa_ledger] {what} '{path}' not found here{hint}")
     except json.JSONDecodeError as exc:
         raise SystemExit(
             f"[qa_ledger] {path} corrupto (JSON invalido: {exc}). Es un artefacto "
@@ -820,6 +826,24 @@ def _ac_tags(repo_path, repo_type):
     return tags, stale
 
 
+def _sum_ac_tags(ledger):
+    """One derivation of "how many green/red JUnit testcases does AC-n have, summed across
+    every configured repo" -- shared by cmd_readiness (which also keeps up to 8 example case
+    receipts per AC and the combined stale-report list) and cmd_top (which only needs
+    green/red). One place, so the two readouts of the same fact cannot silently disagree."""
+    ac_tags = {}
+    stale_reports = []
+    for rcfg in (ledger.get("config") or {}).get("repos", []):
+        rtags, rstale = _ac_tags(rcfg.get("path", "."), rcfg.get("type", "maven"))
+        for cid, v in rtags.items():
+            d = ac_tags.setdefault(cid, {"green": 0, "red": 0, "cases": []})
+            d["green"] += v["green"]
+            d["red"] += v["red"]
+            d["cases"] = (d["cases"] + v.get("cases", []))[:8]
+        stale_reports.extend(rstale)
+    return ac_tags, sorted(set(stale_reports))
+
+
 def junit_test_count(repo_path, extra_files=None):
     """JUnit-family XML: `pytest --junitxml=...` (python) and jest-junit /
     vitest --reporter=junit (node). Modern emitters WRAP the root:
@@ -1832,7 +1856,7 @@ def _validate_log_step_counts(args):
 
 
 def cmd_init(args):
-    cfg = _load(args.config)
+    cfg = _load(args.config, what="config", flag="--config")
     _validate_init_config(cfg)
     defaults = cfg.get("defaults", {})
     ledger = {
@@ -6892,6 +6916,9 @@ def cmd_facts(args):
             except OSError as exc:
                 problems.append((path, 0, "file", "unreadable: %s" % exc, ""))
                 continue
+            in_table = False
+            table_names = []
+            table_start = 0
             for n, line in enumerate(lines, 1):
                 # an HTML comment is not a published claim -- the first live run flagged a
                 # section marker (a comment reading "2 Skills") as a drifted count
@@ -6905,6 +6932,28 @@ def cmd_facts(args):
                         actual = _fact_value(facts, key)
                         if claimed != actual:
                             problems.append((path, n, key, claimed, actual))
+                # the parser-surface table (Subcommand/Subcomando header, one `<td class="t">`
+                # row per subcommand) is a claim too, just not a numeric one -- a row can go
+                # missing while the count beside it stays correct (the `top` row did, once).
+                if not in_table:
+                    if re.search(r"<th>Sub ?comm?ando?s?</th>", line, re.I):
+                        in_table, table_names, table_start = True, [], n
+                    continue
+                if "</table>" in line:
+                    in_table = False
+                    want = set(facts["subcommands"]["list"])
+                    got = set(table_names)
+                    for name in sorted(want - got):
+                        problems.append((path, table_start,
+                                         "subcommand table: %s" % name,
+                                         "absent", "present (engine subcommand list)"))
+                    for name in sorted(got - want):
+                        problems.append((path, table_start,
+                                         "subcommand table: %s" % name,
+                                         "present", "absent (not an engine subcommand)"))
+                    continue
+                for m in re.finditer(r'<td class="t">([^<]+)</td>', line):
+                    table_names.append(m.group(1).strip())
         if problems:
             print("FACTUAL DRIFT: %d claim(s) disagree with the derived facts"
                   % len(problems))
@@ -8133,16 +8182,10 @@ def cmd_top(args):
     acc_path = args.acceptance or (cfg.get("defaults") or {}).get("acceptance_file")
     acc_items, _acc_found = _parse_acceptance_items(acc_path, args.section)
 
-    # measured evidence: the SAME helper readiness closes criteria with (_ac_tags), summed
-    # across repos exactly as cmd_readiness sums it. Re-deriving it here would be the 1.48.1
-    # mirador sin (two derivations of one number, free to disagree).
-    ac_tags = {}
-    for rcfg in cfg.get("repos", []):
-        rtags, _stale = _ac_tags(rcfg.get("path", "."), rcfg.get("type", "maven"))
-        for cid, v in rtags.items():
-            d = ac_tags.setdefault(cid, {"green": 0, "red": 0})
-            d["green"] += v.get("green", 0)
-            d["red"] += v.get("red", 0)
+    # measured evidence: the SAME helper readiness closes criteria with (_ac_tags via
+    # _sum_ac_tags), summed across repos exactly as cmd_readiness sums it. Re-deriving it
+    # here would be the 1.48.1 mirador sin (two derivations of one number, free to disagree).
+    ac_tags, _stale = _sum_ac_tags(ledger)
 
     # quarantine: UNCURATED observations whose statement literally names an AC id. The link
     # is `canonical_match`, a heuristic TEXT match (_match_canonical) -- not a designed
@@ -8213,7 +8256,10 @@ def cmd_top(args):
             "cases_pass": (tag or {}).get("green", 0),
             "cases_total": (tag or {}).get("green", 0) + (tag or {}).get("red", 0),
             "trace": [],                  # no general AC->implementation map yet (ADR-035/5)
-            "quarantine_obs": obs,
+            # red/green evidence outranks the lateral QUARANTINE rung (the state ladder just
+            # above), so an OBS that merely NAMES this AC must not travel into the JSON once
+            # the criterion is already measured -- only a state of QUARANTINE ever carries it.
+            "quarantine_obs": obs if state == "QUARANTINE" else None,
             "ac": None,                   # contract slot with no second honest meaning here
             "age_hours": None})           # no first-seen timestamp exists (ADR-035/1)
 
@@ -8291,18 +8337,7 @@ def cmd_readiness(args):
     # cierra solo con >=1 testcase verde taggeado en los reportes JUnit ya
     # ingeridos (y 0 rojos). El checkbox es RELATO; el testcase es HECHO.
     ac_ids = [i for i in acc_items if i["id"]]
-    ac_tags = {}
-    stale_reports = []
-    for rcfg in ledger["config"].get("repos", []):
-        rtags, rstale = _ac_tags(rcfg.get("path", "."),
-                                 rcfg.get("type", "maven"))
-        for cid, v in rtags.items():
-            d = ac_tags.setdefault(cid, {"green": 0, "red": 0, "cases": []})
-            d["green"] += v["green"]
-            d["red"] += v["red"]
-            d["cases"] = (d["cases"] + v.get("cases", []))[:8]
-        stale_reports.extend(rstale)
-    stale_reports = sorted(set(stale_reports))
+    ac_tags, stale_reports = _sum_ac_tags(ledger)
 
     def _ac_closed(cid):
         d = ac_tags.get(cid)
@@ -8827,7 +8862,7 @@ def cmd_rebuild(args):
 
 
 def _rebuild_baseline(args):
-    cfg = _load(args.config)
+    cfg = _load(args.config, what="config", flag="--config")
     defaults = cfg.get("defaults", {})
     acc_default = args.acceptance or defaults.get("acceptance_file")
     tol = (args.coverage_tolerance if args.coverage_tolerance is not None
@@ -8853,7 +8888,7 @@ def _rebuild_baseline(args):
 
 
 def _rebuild_compare(args):
-    base = _load(args.baseline)
+    base = _load(args.baseline, what="baseline", flag="--baseline")
     tol = base.get("coverage_tolerance", DEFAULT_COVERAGE_TOLERANCE)
     acc_path = args.acceptance or base.get("acceptance_file")
     section = args.section if args.section is not None else base.get("section")

package/uscha-kit/.claude/skills/uscha-devloop/uscha_top.py

@@ -27,7 +27,6 @@ import subprocess
 import sys
 
 DEFAULT_LEDGER = "QA-LEDGER.json"
-DEFAULT_SIZE = (100, 32)
 FALLBACK_SIZE = (100, 32)
 
 # Lines the board always spends on chrome: the title, 3 rules, 4 KPI lines, the table
@@ -257,6 +256,9 @@ def load_state(state_path=None, ledger=DEFAULT_LEDGER, engine=None):
     if state_path:
         with open(state_path, "r", encoding="utf-8") as fh:
             return json.load(fh)
+    if not os.path.isfile(ledger):
+        raise RuntimeError("ledger '%s' not found here -- run the dev loop first, or pass "
+                           "--ledger" % ledger)
     eng = engine or engine_path()
     if not eng:
         raise RuntimeError("qa_ledger.py not found next to uscha_top.py")

package/uscha-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "uscha",
-  "version": "1.86.0",
+  "version": "1.86.1",
   "displayName": "Uscha",
   "description": "Spec-driven development for LLM coding agents: 9 skills (discovery, adr-refine, reverse-discovery, characterize, devloop, sysdoc, rubric, mirador, status) + a stdlib measurement engine (qa_ledger.py, 52 subcommands + universal installer + npm/npx router). Facts block, guesses advise; the human approves.",
   "author": {

package/uscha-kit/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "uscha",
-  "version": "1.86.0",
+  "version": "1.86.1",
   "description": "Uscha spec-driven development methodology for coding agents. Includes npm/npx router.",
   "author": {
     "name": "Andres Massello",

package/uscha-kit/README.md

@@ -1,6 +1,6 @@
 # uscha-kit
 
-**Kit version:** v1.86.0 <!-- uscha:version --> · **[uscha.dev](https://uscha.dev)**
+**Kit version:** v1.86.1 <!-- uscha:version --> · **[uscha.dev](https://uscha.dev)**
 
 Spec-driven orchestrator + multi-repo QA for Claude Code, with a deterministic ledger.
 **Nine skills** (`uscha-discovery`, `uscha-adr-refine`, `uscha-devloop`, `uscha-sysdoc`, `uscha-reverse-discovery`,

package/uscha-kit/VERSION

@@ -1 +1 @@
-uscha-kit 1.86.0
+uscha-kit 1.86.1

package/uscha-kit/install-uscha.py

@@ -758,10 +758,12 @@ def _open_best_effort(path):
         pass  # the renderer already printed the absolute path
 
 
-def _mirador_render_path():
-    """The mirador renderer inside this kit (either skill-tree layout)."""
-    for rel in (("skills", "uscha-mirador", "mirador-render.py"),
-                (".claude", "skills", "uscha-mirador", "mirador-render.py")):
+def _kit_script_path(skill_dir, filename):
+    """A script inside this kit, in either skill-tree layout (`skills/<skill_dir>/` or
+    `.claude/skills/<skill_dir>/`) -- the one resolution every sibling script lookup in this
+    file shares, and the same both-layouts precedent `uscha_top.py::engine_path()` uses on
+    its own side of the lookup."""
+    for rel in (("skills", skill_dir, filename), (".claude", "skills", skill_dir, filename)):
         candidate = KIT_ROOT.joinpath(*rel)
         if candidate.is_file():
             return candidate
@@ -772,7 +774,7 @@ def cmd_mirador(args):
     """`uscha mirador` — one command to render + open the project's dashboard.
     No paths, no python: the renderer self-resolves its engine/template siblings, and the
     ledger defaults to the QA-LEDGER.json convention in the current directory."""
-    render = _mirador_render_path()
+    render = _kit_script_path("uscha-mirador", "mirador-render.py")
     if render is None:
         print("[uscha mirador] mirador-render.py not found in the kit", file=sys.stderr)
         raise SystemExit(1)
@@ -807,26 +809,6 @@ def cmd_mirador(args):
         print("\n[uscha mirador] stopped")
 
 
-def _uscha_top_path():
-    """The `uscha top` renderer inside this kit (either skill-tree layout)."""
-    for rel in (("skills", "uscha-devloop", "uscha_top.py"),
-                (".claude", "skills", "uscha-devloop", "uscha_top.py")):
-        candidate = KIT_ROOT.joinpath(*rel)
-        if candidate.is_file():
-            return candidate
-    return None
-
-
-def _qa_ledger_path():
-    """The engine inside this kit (either skill-tree layout)."""
-    for rel in (("skills", "uscha-devloop", "qa_ledger.py"),
-                (".claude", "skills", "uscha-devloop", "qa_ledger.py")):
-        candidate = KIT_ROOT.joinpath(*rel)
-        if candidate.is_file():
-            return candidate
-    return None
-
-
 def cmd_top(args):
     """`uscha top` — the live terminal board of the project's ledger (ADR-031).
     Wired exactly like `mirador`: resolve the sibling script inside the kit and exec it with
@@ -837,7 +819,7 @@ def cmd_top(args):
               "--ledger" % args.ledger, file=sys.stderr)
         raise SystemExit(1)
     if args.json:
-        engine = _qa_ledger_path()
+        engine = _kit_script_path("uscha-devloop", "qa_ledger.py")
         if engine is None:
             print("[uscha top] qa_ledger.py not found in the kit", file=sys.stderr)
             raise SystemExit(1)
@@ -846,7 +828,7 @@ def cmd_top(args):
         if rc:
             raise SystemExit(rc)
         return
-    renderer = _uscha_top_path()
+    renderer = _kit_script_path("uscha-devloop", "uscha_top.py")
     if renderer is None:
         print("[uscha top] uscha_top.py not found in the kit", file=sys.stderr)
         raise SystemExit(1)

package/uscha-kit/reports/junit/.top-cases.json

@@ -1 +1 @@
-{"AC-T-01": true, "AC-T-02": true, "AC-T-03": true, "AC-T-10": true, "AC-T-04": true, "AC-T-05": true, "AC-T-06": true, "AC-T-09": true, "AC-T-24": true, "AC-T-19": true, "AC-T-23": true, "AC-T-21": true, "AC-T-08": true, "AC-T-07": true, "AC-T-18": true, "AC-T-20": true, "AC-T-22": true}
+{"AC-T-01": true, "AC-T-02": true, "AC-T-03": true, "AC-T-10": true, "AC-T-04": true, "AC-T-05": true, "AC-T-06": true, "AC-T-09": true, "AC-T-24": true, "reg-quarantine-obs-null-on-measured": true, "reg-spec-pin-null-outside-worktree": true, "reg-unreachable-repo-named-not-silent": true, "AC-T-19": true, "reg-empty-project-honest": true, "AC-T-23": true, "AC-T-21": true, "AC-T-08": true, "AC-T-07": true, "AC-T-18": true, "AC-T-20": true, "AC-T-22": true, "reg-ledger-not-found": true}

package/uscha-kit/skills/uscha-devloop/qa_ledger.py

@@ -142,7 +142,7 @@ def _integrity_hash(data):
     return hashlib.sha256(blob.encode("utf-8")).hexdigest()
 
 
-def _load(path):
+def _load(path, what="ledger", flag="--ledger"):
     """Carga blindada (kit 1.13.0, Topic 34: los recursos compartidos mutables
     incluyen ARCHIVOS). JSON corrupto/truncado = hecho bloqueante con mensaje
     de recuperacion, no un traceback. Si el archivo trae campo integrity
@@ -153,6 +153,12 @@ def _load(path):
     try:
         with open(path, "r", encoding="utf-8") as fh:
             data = json.load(fh)
+    except FileNotFoundError:
+        # what/flag name the file kind and the flag that points at it (1.86.1 re-judge: a
+        # hardcoded "ledger ... --ledger" misled the very first command of a fresh clone,
+        # init --config, and rebuild --baseline).
+        hint = " -- run the dev loop first, or pass --ledger" if what == "ledger" else f" -- pass {flag}"
+        raise SystemExit(f"[qa_ledger] {what} '{path}' not found here{hint}")
     except json.JSONDecodeError as exc:
         raise SystemExit(
             f"[qa_ledger] {path} corrupto (JSON invalido: {exc}). Es un artefacto "
@@ -820,6 +826,24 @@ def _ac_tags(repo_path, repo_type):
     return tags, stale
 
 
+def _sum_ac_tags(ledger):
+    """One derivation of "how many green/red JUnit testcases does AC-n have, summed across
+    every configured repo" -- shared by cmd_readiness (which also keeps up to 8 example case
+    receipts per AC and the combined stale-report list) and cmd_top (which only needs
+    green/red). One place, so the two readouts of the same fact cannot silently disagree."""
+    ac_tags = {}
+    stale_reports = []
+    for rcfg in (ledger.get("config") or {}).get("repos", []):
+        rtags, rstale = _ac_tags(rcfg.get("path", "."), rcfg.get("type", "maven"))
+        for cid, v in rtags.items():
+            d = ac_tags.setdefault(cid, {"green": 0, "red": 0, "cases": []})
+            d["green"] += v["green"]
+            d["red"] += v["red"]
+            d["cases"] = (d["cases"] + v.get("cases", []))[:8]
+        stale_reports.extend(rstale)
+    return ac_tags, sorted(set(stale_reports))
+
+
 def junit_test_count(repo_path, extra_files=None):
     """JUnit-family XML: `pytest --junitxml=...` (python) and jest-junit /
     vitest --reporter=junit (node). Modern emitters WRAP the root:
@@ -1832,7 +1856,7 @@ def _validate_log_step_counts(args):
 
 
 def cmd_init(args):
-    cfg = _load(args.config)
+    cfg = _load(args.config, what="config", flag="--config")
     _validate_init_config(cfg)
     defaults = cfg.get("defaults", {})
     ledger = {
@@ -6892,6 +6916,9 @@ def cmd_facts(args):
             except OSError as exc:
                 problems.append((path, 0, "file", "unreadable: %s" % exc, ""))
                 continue
+            in_table = False
+            table_names = []
+            table_start = 0
             for n, line in enumerate(lines, 1):
                 # an HTML comment is not a published claim -- the first live run flagged a
                 # section marker (a comment reading "2 Skills") as a drifted count
@@ -6905,6 +6932,28 @@ def cmd_facts(args):
                         actual = _fact_value(facts, key)
                         if claimed != actual:
                             problems.append((path, n, key, claimed, actual))
+                # the parser-surface table (Subcommand/Subcomando header, one `<td class="t">`
+                # row per subcommand) is a claim too, just not a numeric one -- a row can go
+                # missing while the count beside it stays correct (the `top` row did, once).
+                if not in_table:
+                    if re.search(r"<th>Sub ?comm?ando?s?</th>", line, re.I):
+                        in_table, table_names, table_start = True, [], n
+                    continue
+                if "</table>" in line:
+                    in_table = False
+                    want = set(facts["subcommands"]["list"])
+                    got = set(table_names)
+                    for name in sorted(want - got):
+                        problems.append((path, table_start,
+                                         "subcommand table: %s" % name,
+                                         "absent", "present (engine subcommand list)"))
+                    for name in sorted(got - want):
+                        problems.append((path, table_start,
+                                         "subcommand table: %s" % name,
+                                         "present", "absent (not an engine subcommand)"))
+                    continue
+                for m in re.finditer(r'<td class="t">([^<]+)</td>', line):
+                    table_names.append(m.group(1).strip())
         if problems:
             print("FACTUAL DRIFT: %d claim(s) disagree with the derived facts"
                   % len(problems))
@@ -8133,16 +8182,10 @@ def cmd_top(args):
     acc_path = args.acceptance or (cfg.get("defaults") or {}).get("acceptance_file")
     acc_items, _acc_found = _parse_acceptance_items(acc_path, args.section)
 
-    # measured evidence: the SAME helper readiness closes criteria with (_ac_tags), summed
-    # across repos exactly as cmd_readiness sums it. Re-deriving it here would be the 1.48.1
-    # mirador sin (two derivations of one number, free to disagree).
-    ac_tags = {}
-    for rcfg in cfg.get("repos", []):
-        rtags, _stale = _ac_tags(rcfg.get("path", "."), rcfg.get("type", "maven"))
-        for cid, v in rtags.items():
-            d = ac_tags.setdefault(cid, {"green": 0, "red": 0})
-            d["green"] += v.get("green", 0)
-            d["red"] += v.get("red", 0)
+    # measured evidence: the SAME helper readiness closes criteria with (_ac_tags via
+    # _sum_ac_tags), summed across repos exactly as cmd_readiness sums it. Re-deriving it
+    # here would be the 1.48.1 mirador sin (two derivations of one number, free to disagree).
+    ac_tags, _stale = _sum_ac_tags(ledger)
 
     # quarantine: UNCURATED observations whose statement literally names an AC id. The link
     # is `canonical_match`, a heuristic TEXT match (_match_canonical) -- not a designed
@@ -8213,7 +8256,10 @@ def cmd_top(args):
             "cases_pass": (tag or {}).get("green", 0),
             "cases_total": (tag or {}).get("green", 0) + (tag or {}).get("red", 0),
             "trace": [],                  # no general AC->implementation map yet (ADR-035/5)
-            "quarantine_obs": obs,
+            # red/green evidence outranks the lateral QUARANTINE rung (the state ladder just
+            # above), so an OBS that merely NAMES this AC must not travel into the JSON once
+            # the criterion is already measured -- only a state of QUARANTINE ever carries it.
+            "quarantine_obs": obs if state == "QUARANTINE" else None,
             "ac": None,                   # contract slot with no second honest meaning here
             "age_hours": None})           # no first-seen timestamp exists (ADR-035/1)
 
@@ -8291,18 +8337,7 @@ def cmd_readiness(args):
     # cierra solo con >=1 testcase verde taggeado en los reportes JUnit ya
     # ingeridos (y 0 rojos). El checkbox es RELATO; el testcase es HECHO.
     ac_ids = [i for i in acc_items if i["id"]]
-    ac_tags = {}
-    stale_reports = []
-    for rcfg in ledger["config"].get("repos", []):
-        rtags, rstale = _ac_tags(rcfg.get("path", "."),
-                                 rcfg.get("type", "maven"))
-        for cid, v in rtags.items():
-            d = ac_tags.setdefault(cid, {"green": 0, "red": 0, "cases": []})
-            d["green"] += v["green"]
-            d["red"] += v["red"]
-            d["cases"] = (d["cases"] + v.get("cases", []))[:8]
-        stale_reports.extend(rstale)
-    stale_reports = sorted(set(stale_reports))
+    ac_tags, stale_reports = _sum_ac_tags(ledger)
 
     def _ac_closed(cid):
         d = ac_tags.get(cid)
@@ -8827,7 +8862,7 @@ def cmd_rebuild(args):
 
 
 def _rebuild_baseline(args):
-    cfg = _load(args.config)
+    cfg = _load(args.config, what="config", flag="--config")
     defaults = cfg.get("defaults", {})
     acc_default = args.acceptance or defaults.get("acceptance_file")
     tol = (args.coverage_tolerance if args.coverage_tolerance is not None
@@ -8853,7 +8888,7 @@ def _rebuild_baseline(args):
 
 
 def _rebuild_compare(args):
-    base = _load(args.baseline)
+    base = _load(args.baseline, what="baseline", flag="--baseline")
     tol = base.get("coverage_tolerance", DEFAULT_COVERAGE_TOLERANCE)
     acc_path = args.acceptance or base.get("acceptance_file")
     section = args.section if args.section is not None else base.get("section")

package/uscha-kit/skills/uscha-devloop/uscha_top.py

@@ -27,7 +27,6 @@ import subprocess
 import sys
 
 DEFAULT_LEDGER = "QA-LEDGER.json"
-DEFAULT_SIZE = (100, 32)
 FALLBACK_SIZE = (100, 32)
 
 # Lines the board always spends on chrome: the title, 3 rules, 4 KPI lines, the table
@@ -257,6 +256,9 @@ def load_state(state_path=None, ledger=DEFAULT_LEDGER, engine=None):
     if state_path:
         with open(state_path, "r", encoding="utf-8") as fh:
             return json.load(fh)
+    if not os.path.isfile(ledger):
+        raise RuntimeError("ledger '%s' not found here -- run the dev loop first, or pass "
+                           "--ledger" % ledger)
     eng = engine or engine_path()
     if not eng:
         raise RuntimeError("qa_ledger.py not found next to uscha_top.py")

package/uscha-kit/uscha.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.86.0",
+  "version": "1.86.1",
   "project": null,
   "defaults": {
     "coverage_threshold": 60,