@andresmassello/uscha 1.51.1 → 1.51.3

package/README.md

@@ -7,6 +7,9 @@ never what was claimed.
 
 > The tool executes · the method governs · evidence decides · the human approves.
 
+**[uscha.dev](https://uscha.dev)** — the method, the five rules, the skills, the library
+(essay, 2-day dev course, reference, paper).
+
 ```bash
 npx --yes @andresmassello/uscha@latest install --target claude
 npx --yes @andresmassello/uscha@latest doctor  --target claude
@@ -23,7 +26,9 @@ 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.51.1** <!-- uscha:version --> · [changelog](uscha-kit/CHANGELOG-1.51.1.md)
+**Kit v1.51.3** <!-- uscha:version --> · [uscha.dev](https://uscha.dev) ·
+[changelog](https://github.com/andresmassello/uscha/blob/main/uscha-kit/CHANGELOG-1.51.3.md)
+(the per-release changelogs live in the repo, not in the npm tarball)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andresmassello/uscha",
-  "version": "1.51.1",
+  "version": "1.51.3",
   "description": "Spec-driven development for LLM coding agents: 9 skills + a stdlib evidence engine. Facts block, guesses advise; the human approves.",
   "bin": {
     "uscha": "bin/uscha.js",
@@ -13,6 +13,7 @@
     "!uscha-kit/**/__pycache__/",
     "!uscha-kit/**/*.pyc",
     "!uscha-kit/**/*.pyo",
+    "!uscha-kit/CHANGELOG-*.md",
     "README.md",
     "LICENSE"
   ],
@@ -20,7 +21,7 @@
     "type": "git",
     "url": "git+https://github.com/andresmassello/uscha.git"
   },
-  "homepage": "https://github.com/andresmassello/uscha#readme",
+  "homepage": "https://uscha.dev",
   "bugs": {
     "url": "https://github.com/andresmassello/uscha/issues"
   },

package/uscha-kit/.claude/skills/uscha-mirador/SKILL.md

@@ -76,7 +76,8 @@ wires the JSON the engine emits into the template. Read-only.
 
 4. **Render `mirador.html`** with the standalone renderer — it runs `dashboard --json`,
    merges the sidecar telemetry if present, injects `const DATA`, writes the file, prints its
-   absolute path (`OPEN IT: ...`), and opens it in the default browser. From the project root,
+   absolute path (`OPEN IT: ...`), and opens it in the default browser **the first time it
+   creates the file** (see step 5 — a re-render updates the open tab instead). From the project root,
    with no long paths — `--engine` and `--template` default to the renderer's sibling skill
    files (kit 1.41.2):
    ```bash
@@ -87,9 +88,15 @@ wires the JSON the engine emits into the template. Read-only.
    time-lapse feeds from `qa_ledger.py readiness --record` — since kit 1.47.0 the dev-loop
    records at every pass close, so history accumulates without extra ceremony.
 
-5. **Where to look:** the renderer already opened `mirador.html` and printed its absolute path
-   on the `OPEN IT:` line — surface that path to the operator. Pass `--no-open` to write the
-   file without opening a browser (headless/CI, or the watch loop below, which passes it).
+5. **Where to look:** the renderer opens `mirador.html` **once — only the first time it is
+   created** — and always prints its absolute path on the `OPEN IT:` line; surface that path to
+   the operator. Re-rendering (this skill invoked again on a later pass, or the watch loop)
+   rewrites the SAME file, and the page's built-in auto-refresh reloads the already-open tab in
+   place, so a re-render never spawns a new browser tab. On a fresh session the file is already
+   on disk, so nothing pops — open the printed path once, or pass `--open` (`uscha mirador
+   --open`) to force a reopen when you closed the tab. `--no-open` suppresses opening
+   everywhere and wins over `--open` (headless/CI, or the watch loop, which passes it);
+   `--refresh 0` writes a frozen snapshot with no auto-reload.
 
 ## For a human at a terminal: `uscha mirador`
 

package/uscha-kit/.claude/skills/uscha-mirador/mirador-render.py

@@ -94,10 +94,13 @@ def main():
                     help="path to mirador.template.html (default: the sibling template)")
     ap.add_argument("--out", default="mirador.html")
     ap.add_argument("--sidecar", default=os.path.join(".uscha", "telemetry.jsonl"))
-    ap.add_argument("--refresh", type=int, default=0,
-                    help="if >0, the page auto-reloads every N seconds (live second-screen view)")
+    ap.add_argument("--refresh", type=int, default=10,
+                    help="auto-reload the open tab every N seconds so a SINGLE tab stays live "
+                         "(0 = frozen snapshot; default 10)")
     ap.add_argument("--no-open", action="store_true",
                     help="write the file but do not open it in a browser")
+    ap.add_argument("--open", dest="force_open", action="store_true",
+                    help="open the browser even if the file already existed (the tab was closed)")
     args = ap.parse_args()
 
     try:
@@ -127,10 +130,12 @@ def main():
     out = re.sub(r"/\*MIRADOR_DATA_START\*/.*?/\*MIRADOR_DATA_END\*/",
                  lambda m: payload, tpl, count=1, flags=re.S)
     if args.refresh and args.refresh > 0:
-        # opt-in live reload: a meta-refresh, injected only when watching
+        # a meta-refresh so the ONE open tab reloads itself in place (on by default) --
+        # pass --refresh 0 for a frozen snapshot
         out = out.replace("</head>",
                           f'<meta http-equiv="refresh" content="{args.refresh}">\n</head>', 1)
-    live = bool(args.refresh and args.refresh > 0)
+    # capture BEFORE writing: auto-open fires only when the mirador is FIRST materialized
+    pre_existed = os.path.exists(args.out)
     with open(args.out, "w", encoding="utf-8") as f:
         f.write(out)
     score = (data.get("readiness") or {}).get("score")
@@ -139,10 +144,13 @@ def main():
     print(f"[mirador-render]   readiness {score} | telemetry {'on' if tel else 'off'} | "
           f"refresh {args.refresh or 'off'}")
     print(f"[mirador-render]   OPEN IT:  {out_abs}")
-    # Auto-open only a ONE-SHOT view. In live mode (--refresh) the page carries its own
-    # meta-refresh and reloads in the SAME tab, so opening on every render cycle would
-    # spawn a new browser tab each time (kit 1.41.3). Open it once by hand and let it live.
-    if not args.no_open and not live:
+    # Auto-open ONLY the first time the file is created. Repeated renders (the agent per
+    # pass, or a watch loop) rewrite the SAME file, and the meta-refresh reloads the already-
+    # open tab in place -- so a re-render never spawns a new browser tab (kit 1.51.2; 1.41.3
+    # gated this on --refresh, which spammed a tab per one-shot re-render). `pre_existed`
+    # tracks the FILE, not a live tab, so --open forces a reopen when the tab was closed;
+    # --no-open suppresses everywhere and wins over it. The OPEN IT path is always printed.
+    if not args.no_open and (args.force_open or not pre_existed):
         _open_best_effort(out_abs)
     return 0
 

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

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "uscha",
-  "version": "1.51.1",
+  "version": "1.51.3",
   "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, 29 subcommands + universal installer + npm/npx router). Facts block, guesses advise; the human approves.",
   "author": {
     "name": "Andres Massello",
     "url": "https://github.com/andresmassello"
   },
-  "homepage": "https://github.com/andresmassello/uscha",
+  "homepage": "https://uscha.dev",
   "repository": "https://github.com/andresmassello/uscha",
   "license": "MIT",
   "keywords": [

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

@@ -1,12 +1,12 @@
 {
   "name": "uscha",
-  "version": "1.51.1",
+  "version": "1.51.3",
   "description": "Uscha spec-driven development methodology for coding agents. Includes npm/npx router.",
   "author": {
     "name": "Andres Massello",
     "url": "https://github.com/andresmassello"
   },
-  "homepage": "https://github.com/andresmassello/uscha",
+  "homepage": "https://uscha.dev",
   "repository": "https://github.com/andresmassello/uscha",
   "license": "MIT",
   "keywords": [

package/uscha-kit/INSTALL.md

@@ -3,6 +3,9 @@
 Uscha installs as a machine-level helper for coding agents. The recommended path
 is npm/npx because it works the same on a fresh Codex or Claude Code machine.
 
+The method itself — the paradigm, the five rules, the skills and the library — lives at
+**[uscha.dev](https://uscha.dev)**.
+
 ## Quick path
 
 ### Codex Desktop

package/uscha-kit/README.md

@@ -1,6 +1,6 @@
 # uscha-kit
 
-**Kit version:** v1.51.1 <!-- uscha:version -->
+**Kit version:** v1.51.3 <!-- 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.51.1
+uscha-kit 1.51.3

package/uscha-kit/install-uscha.py

@@ -760,8 +760,11 @@ def cmd_mirador(args):
         raise SystemExit(1)
     base = [sys.executable, str(render), "--ledger", args.ledger, "--out", args.out]
     if not args.watch:
-        # one-shot: the renderer writes the file and opens it (unless --no-open)
-        rc = subprocess.call(base + (["--no-open"] if args.no_open else []))
+        # one-shot: the renderer writes the file and opens it only when FIRST materializing it
+        # -- a re-render updates the already-open tab in place instead of spawning another
+        # (kit 1.51.2). --no-open suppresses; --open forces a reopen when the tab was closed.
+        extra = ["--no-open"] if args.no_open else (["--open"] if args.force_open else [])
+        rc = subprocess.call(base + extra)
         if rc:
             raise SystemExit(rc)
         return
@@ -788,7 +791,8 @@ def next_steps(target):
     if "codex" in picked: steps.append("Codex: restart or open a new thread, then install/use uscha from the Personal marketplace if needed.")
     if "claude" in picked: steps.append("Claude: restart Claude Code so global skills/hooks are reloaded.")
     if "pi" in picked: steps.append("pi: restart pi; the 9 uscha-* skills load from ~/.agents/skills. INV-GOLDEN-01 is advisory until the tool_call extension is installed (doctor reports golden_guard).")
-    return steps + ["Run: python install-uscha.py doctor --target %s" % target]
+    return steps + ["Run: python install-uscha.py doctor --target %s" % target,
+                    "Learn the method: https://uscha.dev"]
 
 
 def emit(data, as_json):
@@ -820,6 +824,8 @@ def build_parser():
     mirador.add_argument("--watch", action="store_true", help="live second-screen view: re-render every --interval seconds")
     mirador.add_argument("--interval", type=int, default=30)
     mirador.add_argument("--no-open", action="store_true", help="write the file but do not open a browser")
+    mirador.add_argument("--open", dest="force_open", action="store_true",
+                         help="open the browser even if mirador.html already existed (you closed the tab)")
     mirador.set_defaults(func=cmd_mirador)
     return parser
 

package/uscha-kit/skills/uscha-mirador/SKILL.md

@@ -76,7 +76,8 @@ wires the JSON the engine emits into the template. Read-only.
 
 4. **Render `mirador.html`** with the standalone renderer — it runs `dashboard --json`,
    merges the sidecar telemetry if present, injects `const DATA`, writes the file, prints its
-   absolute path (`OPEN IT: ...`), and opens it in the default browser. From the project root,
+   absolute path (`OPEN IT: ...`), and opens it in the default browser **the first time it
+   creates the file** (see step 5 — a re-render updates the open tab instead). From the project root,
    with no long paths — `--engine` and `--template` default to the renderer's sibling skill
    files (kit 1.41.2):
    ```bash
@@ -87,9 +88,15 @@ wires the JSON the engine emits into the template. Read-only.
    time-lapse feeds from `qa_ledger.py readiness --record` — since kit 1.47.0 the dev-loop
    records at every pass close, so history accumulates without extra ceremony.
 
-5. **Where to look:** the renderer already opened `mirador.html` and printed its absolute path
-   on the `OPEN IT:` line — surface that path to the operator. Pass `--no-open` to write the
-   file without opening a browser (headless/CI, or the watch loop below, which passes it).
+5. **Where to look:** the renderer opens `mirador.html` **once — only the first time it is
+   created** — and always prints its absolute path on the `OPEN IT:` line; surface that path to
+   the operator. Re-rendering (this skill invoked again on a later pass, or the watch loop)
+   rewrites the SAME file, and the page's built-in auto-refresh reloads the already-open tab in
+   place, so a re-render never spawns a new browser tab. On a fresh session the file is already
+   on disk, so nothing pops — open the printed path once, or pass `--open` (`uscha mirador
+   --open`) to force a reopen when you closed the tab. `--no-open` suppresses opening
+   everywhere and wins over `--open` (headless/CI, or the watch loop, which passes it);
+   `--refresh 0` writes a frozen snapshot with no auto-reload.
 
 ## For a human at a terminal: `uscha mirador`
 

package/uscha-kit/skills/uscha-mirador/mirador-render.py

@@ -94,10 +94,13 @@ def main():
                     help="path to mirador.template.html (default: the sibling template)")
     ap.add_argument("--out", default="mirador.html")
     ap.add_argument("--sidecar", default=os.path.join(".uscha", "telemetry.jsonl"))
-    ap.add_argument("--refresh", type=int, default=0,
-                    help="if >0, the page auto-reloads every N seconds (live second-screen view)")
+    ap.add_argument("--refresh", type=int, default=10,
+                    help="auto-reload the open tab every N seconds so a SINGLE tab stays live "
+                         "(0 = frozen snapshot; default 10)")
     ap.add_argument("--no-open", action="store_true",
                     help="write the file but do not open it in a browser")
+    ap.add_argument("--open", dest="force_open", action="store_true",
+                    help="open the browser even if the file already existed (the tab was closed)")
     args = ap.parse_args()
 
     try:
@@ -127,10 +130,12 @@ def main():
     out = re.sub(r"/\*MIRADOR_DATA_START\*/.*?/\*MIRADOR_DATA_END\*/",
                  lambda m: payload, tpl, count=1, flags=re.S)
     if args.refresh and args.refresh > 0:
-        # opt-in live reload: a meta-refresh, injected only when watching
+        # a meta-refresh so the ONE open tab reloads itself in place (on by default) --
+        # pass --refresh 0 for a frozen snapshot
         out = out.replace("</head>",
                           f'<meta http-equiv="refresh" content="{args.refresh}">\n</head>', 1)
-    live = bool(args.refresh and args.refresh > 0)
+    # capture BEFORE writing: auto-open fires only when the mirador is FIRST materialized
+    pre_existed = os.path.exists(args.out)
     with open(args.out, "w", encoding="utf-8") as f:
         f.write(out)
     score = (data.get("readiness") or {}).get("score")
@@ -139,10 +144,13 @@ def main():
     print(f"[mirador-render]   readiness {score} | telemetry {'on' if tel else 'off'} | "
           f"refresh {args.refresh or 'off'}")
     print(f"[mirador-render]   OPEN IT:  {out_abs}")
-    # Auto-open only a ONE-SHOT view. In live mode (--refresh) the page carries its own
-    # meta-refresh and reloads in the SAME tab, so opening on every render cycle would
-    # spawn a new browser tab each time (kit 1.41.3). Open it once by hand and let it live.
-    if not args.no_open and not live:
+    # Auto-open ONLY the first time the file is created. Repeated renders (the agent per
+    # pass, or a watch loop) rewrite the SAME file, and the meta-refresh reloads the already-
+    # open tab in place -- so a re-render never spawns a new browser tab (kit 1.51.2; 1.41.3
+    # gated this on --refresh, which spammed a tab per one-shot re-render). `pre_existed`
+    # tracks the FILE, not a live tab, so --open forces a reopen when the tab was closed;
+    # --no-open suppresses everywhere and wins over it. The OPEN IT path is always printed.
+    if not args.no_open and (args.force_open or not pre_existed):
         _open_best_effort(out_abs)
     return 0
 

package/uscha-kit/uscha.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.51.1",
+  "version": "1.51.3",
   "project": null,
   "defaults": {
     "coverage_threshold": 60,

package/uscha-kit/CHANGELOG-1.10.0.md

@@ -1,84 +0,0 @@
-# dev-loop-kit 1.10.0 — acceptance trazable: AC-n cierra por testcase MEDIDO (2026-07-02)
-
-Primera mejora del backlog PragProg (M2 de `docs/analisis-pragmatic-programmer.md`;
-Topic 50 "Do What Works" + la anécdota Jeffries/Sudoku + Tip 94 "Find Bugs Once").
-Ataca el modo de falla típico del agente: **pulir la métrica sin acercarse a la
-solución**. El readiness deja de estar dominado por coverage/tests-verdes y pasa a
-estar dominado por **criterios de aceptación cerrados con evidencia medida**.
-Smoke suite: 68/68.
-
-## La idea (measured beats narrated, ahora a nivel CRITERIO)
-
-- Cada criterio de `ACCEPTANCE.md` lleva un ID estable: `- [ ] AC-01 — cuando X
-  entonces Y`.
-- Un criterio cierra **MEDIDO** solo cuando existe ≥1 testcase VERDE cuyo nombre
-  lleva el tag (`test_ac1_x`, `testAC01X`, `"AC-01: ..."`) en los reportes JUnit
-  que el engine ya ingiere — y **ningún** testcase taggeado en rojo (evidencia
-  roja veta: fail-closed).
-- El checkbox es RELATO; el testcase es HECHO. Un `[x]` sin test verde se
-  reporta como `narrated_only` y NO cierra.
-
-## Engine (qa_ledger.py)
-
-- `_parse_acceptance_items()`: parser de checkboxes con ID opcional; IDs
-  normalizados por número (`AC-01 == AC_1 == ac1` — los nombres de test de
-  python/go no admiten `-`).
-- `_ac_tags()`: scan de NOMBRES de testcase en los reportes JUnit por type
-  (reusa el selector de ubicaciones vía `_junit_report_files()`, extraído para
-  no duplicar la lista — surefire/gradle per-clase, junit-family, dual-file
-  swift; flutter no emite JUnit → sus criterios no cierran medido, documentado).
-  Boundaries explícitos en el regex del tag: `\b` NO sirve (`_` es word char y
-  `test_ac1` quedaría invisible); soporta separador no-alfanumérico y camelCase.
-- `readiness`: nueva dimensión **acceptance** (dominante, peso 30) = criterios
-  cerrados medidos / criterios totales (un criterio sin ID no puede cerrar →
-  cuenta como abierto). Pesos default rebalanceados:
-  acceptance 30 · adr 15 · coverage 15 · static 20 · convergencia 10 ·
-  integración 10 — el techo a coverage/verde es el anti-Goodhart. JSON expone
-  `traceable/ids/measured_closed/narrated_only/measured_unchecked/untagged`;
-  warnings en texto para narrated-only y sin-IDs.
-- **Fallback legacy**: ACCEPTANCE sin ningún AC-ID → la dimensión cae al ratio
-  de checkboxes con warning (adopción incremental, no rotura retroactiva).
-- `spec-check --acceptance ACCEPTANCE.md`: la trazabilidad es estructura =
-  FACT → bloquea: archivo ausente, cero criterios, CERO criterios trazables,
-  IDs duplicados (normalizados). Criterios sueltos sin ID = advisory. Puede
-  correr solo (sin `--spec`).
-
-## Skills / docs
-
-- `discovery`: ACCEPTANCE se genera con AC-NN secuenciales, nunca reusados;
-  cada criterio pensado para ser cubrible por un test con nombre.
-- `dev-loop`: al escribir los tests de un criterio, el tag AC-n va en el nombre
-  del test; `spec-check --acceptance` al arrancar.
-
-## Hardening (review fresco pre-commit, 10 hallazgos aplicados)
-
-- `_ac_tags`: el tag ahora lee SOLO el nombre del testcase (nunca classname) —
-  un módulo/clase que matchea "ACn" por coincidencia (`test_ac3_flow.py`) ya no
-  contamina los OTROS tests del mismo archivo.
-- `_AC_ID`: tolera IDs markdown-formateados (`**AC-01**`, `` `AC-01` ``) — antes
-  degradaban en silencio a `id=None` y toda la trazabilidad caía a legacy.
-- `readiness`: IDs duplicados en ACCEPTANCE cuentan **una sola vez** (antes un
-  test verde podía cerrar "medido" tantos criterios como copias del ID).
-- `readiness`: config pre-1.10.0 con `readiness_weights` explícitos que no
-  conocían `acceptance` ya no la reciben inyectada por default — se excluye
-  (peso 0) con warning hasta que el usuario la agregue o taggee AC-IDs (si no,
-  duplicaba el peso de `adr` en silencio).
-- `readiness`: `--section` sin match ahora avisa (`0 criterios en scope`) en
-  vez de zonear en silencio adr+acceptance.
-- `readiness`: ledger sin `config.repos` ya no crashea (KeyError) — usa
-  `.get("repos", [])` como el resto del comando.
-- `spec-check --acceptance`: pipear un SPEC por stdin junto con `--acceptance`
-  ya no se descarta en silencio — se lee stdin salvo modo interactivo puro
-  acceptance-only.
-- `spec-check --acceptance --strict`: los criterios sin AC-ID ahora gatean
-  `--strict` (antes el verdict imprimía "OK" con advisories pendientes).
-- Documentado (no resuelto): reportes JUnit stale de maven/gradle pueden
-  vetear/cerrar un AC sin evidencia vigente — mismo límite que
-  `junit_test_count`, ahora con blast radius mayor. Mitigación real (mtime +
-  correlación con el árbol de fuentes) diferida.
-
-## Diferido consciente
-
-- El resto del backlog PragProg (M1 regression-capture, M3 ledger atómico,
-  M8 secret-scan, M9 tests fuera del presupuesto de simplicity, etc.) sigue en
-  `docs/analisis-pragmatic-programmer.md` — una mejora por release.

package/uscha-kit/CHANGELOG-1.11.0.md

@@ -1,67 +0,0 @@
-# dev-loop-kit 1.11.0 — tests fuera del presupuesto de simplicity (2026-07-03)
-
-Segunda mejora del backlog PragProg (M9 de `docs/analisis-pragmatic-programmer.md`;
-Topic 51: *"un buen proyecto puede tener MÁS código de test que de producción, y
-vale la pena"*). Elimina un **incentivo perverso activo**: el simplicity-check
-contaba las líneas de test junto a las de producción contra un único presupuesto —
-el gate castigaba escribir tests y empujaba al agente a testear menos para pasar.
-Smoke suite: 73/73.
-
-## La idea
-
-- Escribir tests **nunca** acerca un diff a OVERBUILT. Los archivos de test se
-  detectan, se cuentan y se **reportan aparte** (`test_lines_added`,
-  `test_files_changed`) — pero no gatean ninguna dimensión del score.
-- La otra dirección ya estaba protegida: **borrar** tests lo bloquea gate-check.
-  Con esto el incentivo queda alineado en ambas direcciones.
-
-## Engine (qa_ledger.py)
-
-- `_is_simplicity_test_file()`: clasificador type-agnóstico (el diff no trae
-  `repo_type`) — unión de las convenciones de los 9 stacks: dirs
-  `test/tests/__tests__/Tests/*.Tests`, source sets Gradle (`src/*Test/`),
-  `test_*.py`, `*_test.go`, `*.test.ts`/`*.spec.js` (multi-dot incluido),
-  `*Test.java`/`*Tests.cs` CamelCase **case-sensitive** — `backtest.cpp` /
-  `protest.cc` siguen contando como producción (misma trampa que ya evitan
-  dotnet/cpp en `_is_test_path`).
-- Dirección de fallo benigna y documentada: un falso positivo solo EXIME del
-  presupuesto — nunca bloquea ni borra nada.
-- `_simplicity_metrics()`: tercer estado de conteo (`prod`/`test`/fuera);
-  las líneas de test no alimentan `lines_added`, `net_lines`, `files_changed`,
-  `max_nesting`, `max_hunk_added` ni abstracciones. Output humano: línea
-  informativa "tests FUERA del presupuesto: +N líneas en M archivo(s)".
-
-## Smoke
-
-- **T32**: diff sintético 6 líneas prod + 302 de test → el presupuesto ve 6/1;
-  batería del clasificador (9 convenciones positivas + backtest/protest/Engine
-  negativas).
-- **T31** (edges 1.10.0, deuda del release anterior): batería de falsos
-  positivos del tag regex (`HVAC2`, `mac1`, `track12` no taggean), classname
-  jamás taggea, y semántica flaky de surefire (`<flakyFailure>` que pasó tras
-  retry = verde; `<failure>`+`<rerunFailure>` = rojo, veta).
-
-## Hardening (review fresco pre-commit)
-
-- El review detectó que gate-check tenía SU PROPIO clasificador de tests
-  (`_gc_is_test_file`) más débil: no reconocía `foo_test.go` (Go),
-  `*.Tests/*.cs` (dotnet), `*.spec.tsx` ni `__tests__/` — así que "borrar
-  tests lo bloquea gate-check" era overclaim para 4+ stacks. Fix: unión
-  fail-closed — gate-check reusa el clasificador compartido de los 9 stacks
-  MÁS sus sufijos legacy; solo se AMPLÍA qué cuenta como test, ningún path
-  antes protegido se desprotege.
-- `_GC_TESTDEF` ampliado con las definiciones de test que faltaban:
-  `func TestX` (Go), `[Fact]`/`[Theory]` (xunit), `#[test]` (rust),
-  `it(`/`test(`/`describe(` (js) — seguro porque TESTDEF solo se evalúa
-  dentro de archivos ya clasificados como test.
-- Smoke **T33**: borrado de tests Go/dotnet/JS → BLOCKER (antes invisible).
-- Corrección truth-pass en `dev-loop-kit/README.md`: los pesos documentados
-  de simplicity (`diff_size 30, nesting 25, abstraction 20...`) no coincidían
-  con el engine (`35/30/20/8/7`, abstraction advisory sin peso) — drift
-  pre-existente, alineado acá.
-
-## Diferido consciente
-
-- El resto del backlog PragProg (M1 regression-capture, M3 ledger atómico,
-  M8 secret-scan, etc.) sigue en `docs/analisis-pragmatic-programmer.md` —
-  una mejora por release.

package/uscha-kit/CHANGELOG-1.12.0.md

@@ -1,46 +0,0 @@
-# dev-loop-kit 1.12.0 — secret-scan en gate-check (2026-07-03)
-
-Tercera mejora del backlog PragProg (M8 de `docs/analisis-pragmatic-programmer.md`;
-Topic 43 *"Stay Safe Out There — nunca commitear secretos, API keys ni
-credenciales"*). Un secreto agregado al diff bloquea como HECHO, exactamente
-igual que hoy bloquea borrar tests o bajar thresholds. Python stdlib puro.
-Smoke suite: 79/79.
-
-## La idea (facts block, guesses advise — aplicado a secretos)
-
-- **Alta precisión = BLOCKER**: clave privada PEM, AWS access key (`AKIA…`),
-  GitHub token (`ghp_`/`github_pat_`), Slack (`xox?-`), Google API key
-  (`AIza…`), y archivos contenedores de claves (`.p12/.pfx/.jks/.keystore/.key`)
-  agregados o modificados — también en modo binario (línea `Binary files`,
-  que no trae `+++`).
-- **Genérico = advisory**: literales tipo `password = "…"` y JWTs — en
-  fixtures de test abundan placeholders y bloquearlos castigaría escribir
-  tests. `--strict` los gatea.
-- Solo se escanean líneas **agregadas**: sacar un secreto del código es bueno
-  y el diff que lo saca no debe frenarse. Borrar un `.p12` tampoco bloquea
-  (el lado `b/` del diff es `/dev/null` y no matchea).
-
-## Engine (qa_ledger.py)
-
-- `_GC_SECRETS_HARD` (lista etiquetada de patrones) + `_GC_SECRET_SOFT` +
-  `_GC_KEYFILE`, cableados al loop de `cmd_gate_check`: `secrets_added` suma
-  al veredicto hard, `secret_literals` al soft. JSON expone ambos.
-- Los patrones no se auto-matchean como source (verificado): después de
-  `-----BEGIN ` en el código viene `(?:RSA`, no `PRIVATE KEY`.
-- Límite conocido (corner self-hosting): los fixtures del smoke contienen la
-  AKIA de ejemplo canónica de AWS — un gate-check del diff del PROPIO kit
-  la flaggea. Correcto: el gate no exime archivos de test a propósito
-  (un secreto en un test sigue siendo un secreto).
-
-## Smoke
-
-- **T34**: AKIA agregada → BLOCKER · PEM privado → BLOCKER · `.p12` binario
-  agregado → BLOCKER · borrado de `.p12` → CLEAN · literal password →
-  REVIEW exit 0 / `--strict` exit 1.
-
-## Diferido consciente
-
-- Entropía/base64 genérico (detectores adivinos) NO entra: violaría
-  "facts block, guesses advise" — solo patrones con lectura inequívoca
-  bloquean. El resto del backlog PragProg sigue en
-  `docs/analisis-pragmatic-programmer.md`.

package/uscha-kit/CHANGELOG-1.13.0.md

@@ -1,33 +0,0 @@
-# dev-loop-kit 1.13.0 — ledger atómico: checksum de integridad (2026-07-03)
-
-Cuarta mejora del backlog PragProg (M3 de `docs/analisis-pragmatic-programmer.md`;
-Topic 34 *"los recursos compartidos mutables incluyen ARCHIVOS"*). Todo el
-edificio "measured beats narrated" se apoya en `QA-LEDGER.json` — y hasta hoy
-ese JSON podía corromperse o mutarse en silencio. Smoke suite: 85/85.
-
-## La idea
-
-- La **escritura ya era atómica** (write-temp + `os.replace`, desde antes) —
-  lo que faltaba era el otro lado: detectar al CARGAR que el archivo quedó
-  inconsistente.
-- `_save` ahora escribe un campo `integrity` con **sha256 canónico** del
-  contenido (claves ordenadas — el hash no depende del orden del dict).
-- `_load` **verifica** el checksum cuando el campo existe: una mutación externa
-  (edición a mano, merge accidental) o una escritura parcial **bloquea** con
-  mensaje de recuperación (`git checkout -- QA-LEDGER.json`). Aceptar una
-  edición externa deliberada = borrar el campo `integrity` (acto humano
-  explícito, mismo espíritu que INV-GOLDEN-01).
-- JSON corrupto/truncado = hecho bloqueante con mensaje claro, **no un
-  traceback crudo**.
-- **Legacy**: ledgers pre-1.13.0 sin `integrity` cargan sin verificar
-  (adopción incremental, no rotura retroactiva). `init` re-inicializa sobre
-  un ledger corrupto sin leerlo.
-
-## Diferido consciente
-
-- File-lock inter-proceso (la parte "opcional" de M3): omitido — stdlib
-  portable Windows/Linux no lo da barato (`fcntl` no existe en Windows) y el
-  loop es single-writer por diseño. Si aparece un caso real de escritura
-  concurrente, se re-evalúa.
-- El baseline de `rebuild` (artefacto aparte) no lleva checksum — mismo
-  candidato si el rebuild gana peso.

package/uscha-kit/CHANGELOG-1.14.0.md

@@ -1,42 +0,0 @@
-# dev-loop-kit 1.14.0 — plateau y stop-signal en readiness (2026-07-03)
-
-Quinta mejora del backlog PragProg (M6 de `docs/analisis-pragmatic-programmer.md`;
-Topic 37 *"Listen to Your Lizard Brain"* + Topic 5 *"Know When to Stop"*).
-La convergencia per-tool existía, pero el engine nunca decía las dos cosas que
-un senior sí dice: "esto no está convergiendo — el problema es de diseño" y
-"esto ya está — cortá". **ADVISORY puro: recomienda, jamás gatea.**
-Smoke suite: 89/89.
-
-## La idea
-
-- **stall-check**: findings gateados por CICLO de agente (suma sobre las tools
-  del ciclo). Si los últimos 3 ciclos muestran la serie plana o SUBIENDO — y
-  todavía hay findings — iterar más no está acercando la solución: el engine
-  deja de sugerir implícitamente "seguí iterando" y recomienda **volver a
-  ADR / re-planear con el humano**. Una serie bajando es progreso y no dispara.
-  Con `qa_tools_order` configurado solo cuentan ciclos **COMPLETOS** (todas las
-  tools logueadas) — un ciclo a medio correr suma parcial y podría enmascarar
-  o inventar el stall (hallazgo del review fresco, aplicado).
-- **stop-signal**: todos los repos convergieron, cero caps activos y cero
-  findings gateados abiertos — no queda ningún fact bloqueante. Lo que falte
-  es deuda medible (coverage/acceptance), no findings: **candidato a cortar e
-  ir a PR**, decisión del humano.
-
-## Engine (qa_ledger.py)
-
-- `_stall_series()` / `_is_stalled()` (ventana `STALL_WINDOW = 3`, constante:
-  es un advisory, no un gate parametrizable — cf. tensión ETC/M5, deliberado).
-- `readiness`: JSON expone `advice: {stalled_repos, stop_signal}`; el texto
-  imprime ambos avisos marcados "(advisory)".
-
-## Smoke
-
-- **T36**: serie 4→5→6 dispara stall · un ciclo 4 PARCIAL no contamina la
-  serie · serie 5→3→1 (progreso) NO dispara · repo único convergido con cero
-  facts bloqueantes emite `stop_signal: true`.
-
-## Diferido consciente
-
-- El stall mide findings gateados por ciclo, no el score de readiness
-  persistido por iteración (el ledger no guarda score histórico — si algún
-  día lo guarda, el detector puede leer el KPI directo).