@andresmassello/uscha 1.40.1

package/uscha-kit/CHANGELOG-1.34.0.md

@@ -0,0 +1,55 @@
+# uscha-kit 1.34.0 — mirador: project name + live second-screen view (2026-07-05)
+
+Two operator asks: (1) the project name, clear at the top; (2) a mirador you can **watch on a
+second screen** while you keep coding in the terminal with the agent. Smoke suite: 195/195.
+
+## Project name (from config, shown at the top)
+
+- `dashboard` emits `project` from `uscha.config.json`'s `"project"` (or `"name"`); if unset, it
+  falls back to the joined repo names (truth-pass — no invented name). This is the ONE engine
+  touch this release: a project name is human-set config metadata, not vendor/LLM data, so the
+  engine stays model-agnostic.
+- `uscha-discovery` asks the project name **first** and writes it to the config.
+- The mirador template shows it as a **prominent title** at the top.
+
+## Live second-screen view
+
+- **`mirador-render.py`** (standalone, in the skill folder): runs `dashboard --json`, merges the
+  sidecar telemetry (in the adapter, NEVER the engine), injects `const DATA`, writes
+  `mirador.html`. `--refresh N` injects a `<meta http-equiv="refresh">`.
+- **`mirador-watch.sh` / `.ps1`**: re-render every N seconds (default 30) from the current
+  ledger. Open `mirador.html` on a second monitor; it reloads on its own. **No server.**
+- Honest limit: as live as the **ledger** — the picture changes at the dev-loop's measured
+  checkpoints (snapshots, gates, `readiness --record`), not per keystroke.
+
+## Watch-safe telemetry (gotcha fix)
+
+`telemetry-extract.py` now **upserts by session** (default key = transcript basename): a refresh
+loop re-runs the extractor without duplicating the session's line, so the aggregated totals
+never inflate. (Without this, watch mode would over-count tokens every tick.)
+
+## Boundary intact
+
+Telemetry is still vendor-narrated, merged ONLY by the adapter (`mirador-render.py`), never by
+`qa_ledger.py`; shown, never gated, never fed into readiness. The template still degrades (no
+sidecar → no strip).
+
+## Truth-pass fix: skill-count drift (doctor + plugin)
+
+When `uscha-mirador` shipped (1.32.0), two registries were not updated (caught here):
+- `doctor`'s `USCHA_SKILLS` list was missing `uscha-mirador` → it reported `7/7` for 8 skills.
+- `plugin.json` / `marketplace.json` **descriptions** said "7 skills / 24 subcommands" (the
+  plugin *install* was fine — it points at the skills directory — but the prose was stale).
+Both fixed (8 skills / 25 subcommands), and **mechanized** so it can't drift again: smoke
+**T57** asserts `USCHA_SKILLS` equals the `uscha-*` skill directories on disk. (The doc-version
+gate T52 covers versions; T57 now covers the skill roster.)
+
+## Smoke (T54 upsert + T55 project + T56 render + T57 skill-roster)
+
+Extractor re-run → still ONE line (upsert); config `project` → dashboard emits it, absent →
+repo-name fallback; `mirador-render.py` → `mirador.html` carrying the project name, merged
+telemetry, and the meta-refresh; the doctor's skill list matches the skills on disk.
+
+The fresh review also caught two robustness gaps in `mirador-render.py` (unguarded `json.loads`
+and template read) — now they return a clean error instead of a traceback (it runs in a watch
+loop, so a clean non-zero is what the loop expects).

package/uscha-kit/CHANGELOG-1.35.0.md

@@ -0,0 +1,30 @@
+# CHANGELOG 1.35.0 — execution policy routing
+
+## La idea
+
+Uscha ya medía el estado, y Mirador ya mostraba telemetría observada de modelo/tiempo/tokens. Faltaba una capa distinta: **la política de ejecución** que le dice al operador qué está haciendo el método en cada fase y qué tier/modelo/effort conviene usar.
+
+## Nuevo
+
+- `defaults.execution_policy` en `uscha.config.json`:
+  - `default`: tier/model/effort base.
+  - `phases.<idea|disc|spec|adr|build|qa|verify|prod>`: `method`, `tier`, `model`, `effort`, `uncorrelated`.
+- Nuevo subcomando read-only:
+  - `qa_ledger.py execution-policy --phase qa`
+  - `qa_ledger.py execution-policy --json`
+- `dashboard --json` agrega:
+  - `execution_policy` top-level.
+  - `phase.execution` en cada nodo del trail.
+- Mirador renderiza un panel **Execution policy** con metodología/tier/model/effort por fase.
+- `uscha-devloop` ahora exige imprimir una línea antes de arrancar cada fase para que el humano vea la intención del método y la selección de modelo/effort.
+
+## Doctrina
+
+Esto **no** es un gate y **no** entra al score de readiness. Es metadata de orquestación/costo/riesgo. La regla sigue intacta: facts block, guesses advise; la política guía la ejecución, la evidencia decide.
+
+## Smoke
+
+- `bash uscha-kit/tests/smoke-engine.sh`: 199 ok / 0 fail.
+- Nuevos checks:
+  - T58: `execution-policy` devuelve metodología/model/effort y `dashboard` lo expone sin contaminar readiness.
+  - T59: `mirador-render` preserva el panel bird's-eye de execution_policy.

package/uscha-kit/CHANGELOG-1.36.0.md

@@ -0,0 +1,33 @@
+# CHANGELOG 1.36.0 — discovery intake: production findings + spec-doubt
+
+## La idea
+
+Uscha no puede terminar en el merge si la realidad vuelve con evidencia. Dos señales antes quedaban fuera del ledger: un bug encontrado en producción y una SPEC que el builder descubre dudosa o equivocada. Este release les da una entrada formal al siguiente ciclo de discovery.
+
+## Nuevo
+
+- `qa_ledger.py production-finding`:
+  - crea `PF-001`, `PF-002`, ... con `repo`, `severity`, `source`, `title`, `evidence`.
+  - `--resolve --id PF-001 --note "..."` registra que el hallazgo entró al próximo ciclo.
+- `qa_ledger.py spec-doubt`:
+  - crea `SD-001`, `SD-002`, ... con `kind` (`spec-doubt`, `spec-wrong`, `ambiguous`, `missing-acceptance`), `repo`, `severity`, `note`, `evidence`.
+  - `--resolve --id SD-001 --decision "SPEC amended"` registra la revisión humana.
+- `readiness --json` agrega `discovery_intake` y facts:
+  - `production_findings_open`
+  - `spec_doubts_open`
+- La vista default de `readiness` habla solo cuando importa: imprime una línea si hay production findings o spec-doubts abiertos.
+- `phase` deriva `escalated` si hay `spec-doubt` abierto o production finding gateado abierto; no hay `pr-ready` mientras la SPEC esté dudosa o la producción haya devuelto una señal severa.
+- `dashboard --json` transporta `discovery_intake` para Mirador/adapters.
+
+## Doctrina
+
+- Production finding = hecho de campo. Entra al ledger, no a una nota perdida.
+- SPEC-WRONG/spec-doubt = escape hatch legítimo del builder. El agente NO decide silenciosamente entre desviarse de la SPEC o transcribir una mentira.
+- Resolver exige un acto registrado: feedback incorporado, SPEC amendada, o revisión humana explícita.
+
+## Smoke
+
+- `bash uscha-kit/tests/smoke-engine.sh`: 207 ok / 0 fail.
+- Nuevos checks:
+  - T60: production finding crea PF-001, aparece en `discovery_intake`, avisa en readiness default, y se limpia al resolver.
+  - T61: spec-doubt crea SD-001, aparece en `discovery_intake`, `phase` deriva `escalated`, y se limpia al resolver.

package/uscha-kit/CHANGELOG-1.37.0.md

@@ -0,0 +1,41 @@
+# CHANGELOG 1.37.0 ? ADR experiments: visible hypotheses
+
+Decision #10 from the deferred analysis is implemented narrowly: an ADR can now say
+`Status: Experiment` when the decision is a bounded hypothesis that needs real feedback.
+
+## What changed
+
+- `dashboard --json` now preserves both ADR layers:
+  - legacy `status` remains the coarse Mirador bucket (`done` / `prog` / `todo`);
+  - `adr_status` preserves the authored ADR status (`accepted`, `proposed`, `experiment`, etc.).
+- Experimental ADRs carry advisory metadata:
+  - `experiment_valid`
+  - `experiment_missing`
+  - `review_by`
+  - `review_trigger`
+  - `feedback_signal`
+  - `expired`
+- Top-level `adr_experiments` summarizes `open`, `malformed`, `expired`, and `ids`.
+- Mirador renders experiment ADRs as `experiment`, `experiment invalid`, or `experiment overdue`.
+- `Status: Experiment` is intentionally **not** readiness scoring and **not** a hard PR gate.
+
+## Required sections for `Status: Experiment`
+
+An experiment ADR must include:
+
+- `Hypothesis`
+- `Feedback Signal`
+- `Review By` or `Review Trigger`
+- `Promote Criteria`
+- `Rollback / Supersede Criteria`
+
+Missing/expired metadata is visible/advisory so the operator does not confuse a hypothesis with
+an accepted decision.
+
+## Smoke
+
+- Full smoke: `209 ok ? 0 fail`.
+- New T62 covers:
+  - valid experiment ADR exposed in `dashboard --json`;
+  - malformed/expired experiment counted as advisory;
+  - Mirador renders `experiment` without changing readiness.

package/uscha-kit/CHANGELOG-1.38.0.md

@@ -0,0 +1,11 @@
+# uscha-kit 1.38.0 ? contract closure loop
+
+## Added
+
+- `spec-change-request`: records a human contract-change bridge from evidence/doubt to SPEC/ADR amendment, surfaces it in `readiness --json`, and derives `phase=escalated` while open.
+- `golden-diff --labels golden-labels.json --json`: reports approved fixture intent as `intended`, `observed-accidental`, or `unknown` without weakening byte comparison.
+- `summary --json` now includes `post_merge_calibration` counts for production findings, SPEC doubts, and SPEC change requests so retros can calibrate the method from real reopen signals.
+
+## Verification
+
+- Smoke target: 216/216 green.

package/uscha-kit/CHANGELOG-1.39.0.md

@@ -0,0 +1,14 @@
+# uscha-kit 1.39.0 ? universal machine installer
+
+## Added
+
+- `install-uscha.py`: one stdlib machine installer for Codex and Claude.
+  - Codex target creates a personal local plugin at `~/plugins/uscha` and updates `~/.agents/plugins/marketplace.json`.
+  - Claude target installs global skills/hooks under `~/.claude`.
+  - Supports `install`, `doctor`, `version`, `init`, `--dry-run`, testable `--home`, and `--mode copy|link`.
+- Codex plugin manifest at `.codex-plugin/plugin.json` for plugin-first adoption.
+- Skill fallback examples now include Codex plugin/raw-skill install paths, not only `~/.claude`.
+
+## Verification
+
+- Smoke target: 222/222 green.

package/uscha-kit/CHANGELOG-1.4.0.md

@@ -0,0 +1,68 @@
+# dev-loop-kit 1.4.0 — adapter `type: python` (2026-07-02)
+
+El desbloqueante del dogfooding: el engine ahora mide repos Python (pytest + ruff +
+mypy + coverage.py). Diseño: `docs/HANDOFF_python-adapter_dev-loop-kit.md` +
+`docs/HANDOFF_python-adapter_ADDENDUM.md` (los 2 bugs A1/A2 de la revisión están
+incorporados). Smoke suite: 24/24 (17 existentes maven/flutter intactos + 7 python).
+
+## Engine (qa_ledger.py)
+
+- **`python_coverage()`** — Cobertura `coverage.xml` (`pytest --cov --cov-report=xml`),
+  atributos `lines-covered`/`lines-valid`; primer match gana (`coverage.xml`,
+  `reports/coverage.xml`). Reporte ausente o ilegible ⇒ `report_found: False`
+  (UNMEASURED — jamás un número inventado).
+- **`python_test_count()`** — JUnit XML de `pytest --junitxml`. **Maneja el root
+  ENVUELTO** (`<testsuites><testsuite …>`, familia xunit2 del pytest moderno) además
+  del root plano — leer atributos del wrapper contaría 0 en silencio (ADDENDUM A2).
+- **`parse_ruff()`** — `ruff check --output-format=json`; severidades: `S<dígito>`
+  (bandit/security, anclado para no pisar SIM/SLF/SLOT) y `E9*`/`F82*` (errores
+  reales) → HIGH, `B<dígito>` (bugbear) → MEDIUM, resto → LOW. **`code: null`**
+  (syntax error del ruff moderno ≥0.5) → HIGH siempre — sin esto, la rotura real
+  pasaba el gate como LOW en silencio (hallazgo del review de contexto fresco).
+- **`parse_mypy()`** — salida de texto (`file:line: error: msg [code]`);
+  error → HIGH, warning → MEDIUM, note → INFO.
+- **`ingest-gate`** — branch por `type` del repo: python busca `reports/ruff.json` /
+  `reports/mypy.txt` (o `--ruff`/`--mypy` explícitos); combinado se loguea como
+  `python-qa-gate`. Mismo contrato de ausencia que Java.
+- **Guard UNMEASURED ampliado** (ADDENDUM A1): `static_unmeasured` ahora aplica a
+  `maven` Y `python` — un repo python cuyos linters nunca corrieron puntúa 0.0 en la
+  dimensión static, no 1.0 (habría reintroducido "el silencio es éxito" justo en el
+  repo del dogfooding).
+- **LOC python**: test = `tests/`/`test/` en el path o `test_*.py`/`*_test.py`;
+  prod = el resto de los `.py` (src layout o paquete raíz). `SKIP_DIRS` suma
+  `.venv`, `venv`, `.tox`, `__pycache__`, `.mypy_cache`, `.ruff_cache`,
+  `.pytest_cache` (sin esto, el LOC contaría el virtualenv entero).
+- `_rel_src()` reconoce paths repo-relativos `src/...` (como los emiten ruff/mypy)
+  para IDs de finding estables. **Nota de migración**: si un linter Java emitía paths
+  relativos `src/...` (poco común — checkstyle/PMD suelen emitir absolutos), sus
+  finding-IDs cambian en 1.4.0; un ledger no debería cruzar el upgrade — re-baselinear
+  con un ingest fresco después de actualizar.
+- `SOURCE_EXT`: `"python": {".py"}`; `.py` también en `generic`.
+
+## Ya cubierto sin cambios (ADDENDUM A3)
+
+- simplicity-check: `.py` ya estaba en `_SIMPLICITY_CODE_EXT`.
+- gate-check: ya reconocía `test_*.py`, `def test_`, `# noqa`, `# type: ignore`.
+
+## Config / docs
+
+- `dev-loop.config.json`: `test_command_python` + repo de ejemplo `data-lib`; version 1.4.0.
+- Kit README: tabla de reportes Python; SKILL.md y docs actualizan
+  `maven|flutter` → `maven|flutter|python`; refs de versión vigente → 1.4.0 (ES+EN).
+
+## Smoke (tests/smoke-engine.sh)
+
+- `repo-c` (`type: python`) con fixtures sintéticos: Cobertura 8/10 → 80.0%,
+  junit ENVUELTO → 5 tests, LOC prod=3/test=2, ruff 2 findings (1 gateado),
+  mypy 1 error (gateado), UNMEASURED pre-ingest → medido post-ingest.
+
+## Criterio pendiente (fase piloto)
+
+Criterio 2 del HANDOFF — dry-run de solo lectura contra el repo piloto real
+(coverage ±0.1 vs pytest-cov, test count exacto, ruff/mypy en 0 sin UNMEASURED).
+Se corre desde la sesión del proyecto piloto consumiendo este kit.
+
+## Diferido consciente (sin cambios desde 1.3.0)
+
+- rebuild: densidad de asserts por test-file en la firma.
+- Perfiles A-E mecanizados (`--profile`).

package/uscha-kit/CHANGELOG-1.40.0.md

@@ -0,0 +1,16 @@
+# uscha-kit 1.40.0
+
+## Added
+
+- Added npm/npx package router (`@andresmassello/uscha`) with `uscha` and `uscha-kit` CLI bins.
+- Added smoke coverage for the Node router delegating to the canonical Python installer.
+
+## Changed
+
+- Documented npm-first install commands for public adoption while keeping `install-uscha.py` as the source of truth.
+
+## Verification
+
+- `node bin/uscha.js version --json`
+- `npm pack --dry-run --json`
+- `bash uscha-kit/tests/smoke-engine.sh`

package/uscha-kit/CHANGELOG-1.40.1.md

@@ -0,0 +1,11 @@
+# uscha-kit 1.40.1
+
+## Fixed
+
+- Exclude Python bytecode artifacts (`__pycache__`, `*.pyc`, `*.pyo`) from the npm package tarball.
+- Strengthen the npm smoke check so package dry-run fails if Python bytecode artifacts would be published.
+
+## Verification
+
+- `npm publish --dry-run --access public`
+- `bash uscha-kit/tests/smoke-engine.sh`

package/uscha-kit/CHANGELOG-1.5.0.md

@@ -0,0 +1,64 @@
+# dev-loop-kit 1.5.0 — adapter `type: node` (TypeScript/JS) (2026-07-02)
+
+El adapter más barato del roadmap: reusa el parser lcov (Flutter) para coverage y el
+parser JUnit-envuelto (Python) para tests; lo único nuevo son los parsers de ESLint y
+tsc. Smoke suite: 31/31 (24 previos intactos + 7 node).
+
+## Engine (qa_ledger.py)
+
+- **`type: node`** — TypeScript/JS (jest o vitest sobre Node).
+- Coverage: `coverage/lcov.info` — **mismo parser que Flutter** (`flutter_coverage`,
+  docstring generalizado).
+- Test count: **`junit_test_count()`** (renombrado desde `python_test_count` — es de
+  familia JUnit, no de lenguaje): jest-junit / `vitest --reporter=junit`, root envuelto
+  `<testsuites>` soportado, first-location-wins.
+- **`parse_eslint()`** — `eslint --format json`: severity 2 (error) → HIGH,
+  1 (warn) → MEDIUM; reglas `security/*` con floor HIGH (como findsecbugs);
+  **`fatal: true`** (error de parseo) → HIGH siempre — la lección del `code: null`
+  de ruff (1.4.0). `ruleId: null` SIN fatal (directivas eslint-disable sin usar,
+  default de ESLint 9) sigue la severidad del mensaje — nunca un falso blocker.
+- **`parse_tsc()`** — `tsc --noEmit` texto (`file(line,col): error TSxxxx`):
+  error → HIGH (un type error es rotura real); paths Windows con drive soportados.
+  **Errores GLOBALES sin archivo** (TS18003/TS5023 — tsconfig roto) → HIGH con
+  ubicación `?`: un tsc que no chequeó NADA jamás lee como gate limpio.
+- IDs de finding node preservan el path repo-relativo (`_mk_id_rel`): los layouts
+  sin `src/` (app/pages con decenas de `page.tsx`/`index.ts`) no colisionan por
+  basename; los paths absolutos de eslint se relativizan a la base del repo.
+- `ingest-gate`: branch node (`reports/eslint.json` / `reports/tsc.txt`, o
+  `--eslint/--tsc`); combinado = `node-qa-gate`. Mismo contrato de ausencia.
+- Guard UNMEASURED ampliado: `maven`/`python`/`node`.
+- LOC node: test = `__tests__`/`tests`/`test` en el path o `*.test.*`/`*.spec.*`;
+  prod = el resto. `SOURCE_EXT` node: `.ts .tsx .js .jsx .mjs .cjs`.
+- `SKIP_DIRS` += `coverage` (el lcov-report HTML de jest contiene .js que
+  contaminaría el LOC), `.next`, `.turbo`. **Trade-off documentado**: el set es
+  global — un paquete fuente legítimamente llamado `coverage/` en cualquier type
+  queda fuera del LOC (métrica advisory; la detección de lcov es por glob y no
+  se afecta).
+- `LICENSE` (MIT) agregada al repo y copiada dentro de `dev-loop-kit/` para que
+  el zip la lleve.
+
+## Config / docs
+
+- `test_command_node` + repo de ejemplo `web-app`; version 1.5.0 (triple sync).
+- Kit README: tabla TypeScript/JS; SKILL.md types + `npm test`; docs ES/EN
+  actualizan tipos y versión vigente.
+
+## Smoke (tests/smoke-engine.sh)
+
+- `repo-d` (`type: node`): lcov 9/10 → 90.0%, junit envuelto → 7 tests,
+  LOC prod=4/test=2 (.ts vs .test.ts), eslint (security floor + null fatal HIGH,
+  prefer-const MEDIUM → reported=3 gated=2), tsc error → HIGH,
+  UNMEASURED pre-ingest → medido post-ingest.
+
+## Criterio pendiente (mismo contrato que el adapter python)
+
+El adapter node NO tiene todavía un repo real de dogfooding detrás — entra por decisión
+del autor pensando en el release público (audiencia TS/JS). El dry-run de solo lectura
+contra un repo TS/JS real (coverage vs jest, test count exacto, eslint/tsc) queda como
+criterio abierto — igual que el dry-run pendiente del adapter python (1.4.0).
+
+## Diferido consciente (sin cambios)
+
+- rebuild: densidad de asserts por test-file. Perfiles A-E mecanizados (`--profile`).
+- Roadmap de adapters: Go (golangci-lint emite formato checkstyle — reusable),
+  Rust (cargo-llvm-cov emite Cobertura — reusable). Entran cuando haya repo real.

package/uscha-kit/CHANGELOG-1.6.0.md

@@ -0,0 +1,57 @@
+# dev-loop-kit 1.6.0 — adapter `type: go` (2026-07-02)
+
+Tercer adapter consecutivo donde el costo baja porque el engine habla FORMATOS, no
+lenguajes: el linter reusa `parse_checkstyle` (golangci-lint emite checkstyle) y los
+tests reusan `junit_test_count` (gotestsum emite JUnit). Lo único nuevo: el parser del
+cover profile nativo de Go. Smoke suite: 37/37 (31 previos intactos + 6 go).
+
+## Engine (qa_ledger.py)
+
+- **`type: go`**.
+- **`go_coverage()`** — cover profile nativo (`go test -coverprofile=coverage.out`):
+  formato `import/path/file.go:S.C,E.C numStatements hitCount`; cobertura por
+  **SENTENCIAS** (la convención Go, no líneas). First match: `coverage.out`,
+  `cover.out`, `reports/coverage.out`. Profile vacío (solo línea `mode:`) → 0.0
+  fail-closed, nunca un verde inventado.
+- Test count: **reusa `junit_test_count`** vía `gotestsum --junitfile` (root envuelto
+  ya soportado).
+- Linter: **reusa `parse_checkstyle` parametrizado** (`tool="golangci"`) — golangci-lint
+  `--out-format checkstyle`; error→HIGH, warning→MEDIUM; gosec entra por el mismo
+  reporte si está habilitado en la config del linter. Los IDs de finding llevan
+  `golangci:` (los de Java siguen `checkstyle:` — sin migración de IDs).
+- `ingest-gate`: branch go (`reports/golangci.xml` / `golangci.xml`, o `--golangci`);
+  combinado = `go-qa-gate`. Mismo contrato de ausencia.
+- Guard UNMEASURED: `maven`/`python`/`node`/`go`.
+- LOC go: test = sufijo `_test.go` (la convención — los tests viven junto al código);
+  prod = el resto. `SKIP_DIRS` += `vendor` (dependencias vendorizadas explotarían el
+  LOC) y `testdata` (fixtures no compilables).
+
+## Config / docs
+
+- `test_command_go` (gotestsum + coverprofile) + repo de ejemplo `api-svc`;
+  version 1.6.0 (triple sync).
+- Kit README: tabla Go; SKILL.md types + `go test`; docs ES/EN tipos y versión.
+
+## Smoke (tests/smoke-engine.sh)
+
+- `repo-e` (`type: go`): cover profile 3/5 sentencias → 60.0%, gotestsum junit → 4
+  tests, LOC prod=4/test=2 (`_test.go` junto al código), golangci checkstyle
+  (error gateado HIGH + warning MEDIUM), UNMEASURED pre-ingest → medido post-ingest.
+
+## Nota estructural (regla de tres cumplida)
+
+Con 5 types, los dispatchers siguen siendo ifs de 3 ramas y cada adapter nuevo reusó
+parsers existentes — la presión para refactorizar `type` → perfiles de reporte
+(cobertura+junit+linters como config, no código) existe pero todavía no duele. Si
+entra un 6º type o un type necesita MEZCLAR formatos, ese es el momento.
+
+## Criterio pendiente (mismo contrato que python/node)
+
+Dry-run de solo lectura contra un repo Go real — el adapter entra sin repo de
+dogfooding detrás, mismo criterio abierto que 1.4.0/1.5.0.
+
+## Diferido consciente (sin cambios)
+
+- rebuild: densidad de asserts por test-file. Perfiles A-E mecanizados (`--profile`).
+- Rust: cargo-llvm-cov emite Cobertura (reusa `python_coverage`) + cargo-nextest emite
+  JUnit — entra cuando haya repo real.

package/uscha-kit/CHANGELOG-1.7.0.md

@@ -0,0 +1,74 @@
+# dev-loop-kit 1.7.0 — adapters `type: rust` y `type: dotnet` (2026-07-02)
+
+> Publicado junto con 1.8.0 y 1.9.0 en un único commit (no existe commit
+> standalone de 1.7.0); la suite final de ese commit es 63/63. Los fixes que
+> el review fresco de este adapter encontró (blocker de clippy incluido)
+> están aplicados y documentados en CHANGELOG-1.9.0.
+
+Dos adapters en un release porque ambos REUSAN la infraestructura existente:
+coverage vía Cobertura (`cobertura_coverage`, renombrado desde `python_coverage`) y
+tests vía `junit_test_count`. Nuevo de verdad: `parse_clippy` (JSONL de cargo) y
+`parse_sarif` (SARIF v2 — el formato universal de análisis estático). Incluye los
+fixes del review fresco de 1.6.0.
+
+## Rust (`type: rust`)
+
+- Coverage: `cargo llvm-cov --cobertura --output-path reports/coverage.xml` —
+  **reusa `cobertura_coverage`** sin cambios.
+- Tests: cargo-nextest con reporter junit — **reusa `junit_test_count`**.
+- **`parse_clippy()`** — `cargo clippy --message-format=json` (JSON Lines):
+  `error`→HIGH, `warning`→MEDIUM; **`code: null`** (error de compilación de rustc,
+  no un lint) → HIGH siempre — la lección del ruff/tsc, tercera aplicación.
+  Los IDs preservan el path del span primario (`_mk_id_rel`).
+- LOC: `tests/` = integración; los tests inline `#[cfg(test)]` cuentan como prod
+  (limitación documentada de la clasificación por path). `target/` ya estaba en
+  SKIP_DIRS (cargo y maven comparten el nombre).
+
+## C#/.NET (`type: dotnet`)
+
+- Coverage: coverlet.msbuild → Cobertura — **reusa `cobertura_coverage`**.
+- Tests: `dotnet test --logger "junit;LogFilePath=reports/junit.xml"`
+  (JUnitXml.TestLogger) — **reusa `junit_test_count`**.
+- **`parse_sarif()`** — SARIF v2 (Roslyn vía `dotnet build /p:ErrorLog=...`):
+  `error`→HIGH, `warning`→MEDIUM, `note`→INFO. El parser sirve para CUALQUIER
+  herramienta que emita SARIF (semgrep, CodeQL, etc.) — inversión, no solo .NET.
+- LOC: proyectos `*.Tests/` y archivos `*Test(s).cs` = test. SKIP_DIRS += `obj`,
+  `TestResults`.
+
+## Fixes del review fresco de 1.6.0 (incluidos acá)
+
+- **BLOCKER**: la tabla Go del kit README había pisado el heading `## Instalación`
+  — restaurado.
+- **HIGH**: el comando documentado de golangci-lint usaba el flag v1
+  (`--out-format`), **eliminado en golangci-lint v2** (2025) — documentado el flag
+  v2 (`--output.checkstyle.path=...`) con fallback v1.
+- **MEDIUM**: gotestsum pone `errors` SOLO en el root `<testsuites>` (un paquete
+  que no compila tenía errors>0 invisibles) — `junit_test_count` ahora toma
+  `max(root, suma de hijos)` por contador.
+- **LOW**: `go_coverage` dedupea bloques repetidos (perfiles `-coverpkg` merged);
+  IDs de golangci preservan el path repo-relativo (basename colisionaba en repos
+  Go idiomáticos); nota de severidades de golangci en README.
+
+## Trade-off documentado (global, igual que `coverage/` en 1.5.0)
+
+`vendor/`, `testdata/`, `obj/`, `TestResults/` en SKIP_DIRS son globales: un paquete
+fuente legítimamente llamado así en OTRO type queda fuera del LOC (métrica advisory;
+la detección de reportes es por glob/paths y no se afecta).
+
+## Nota estructural (regla de tres, re-evaluada en el 7º type)
+
+Siete types y los dispatchers siguen siendo ifs por FORMATO (jacoco / cobertura /
+lcov / cover-profile · surefire / junit / aproximado). El refactor a perfiles
+declarativos sigue sin pagar: no eliminaría los parsers (el costo real) y agregaría
+indirección. Se re-evalúa si un type necesita MEZCLAR formatos por config.
+
+## Criterio pendiente (mismo contrato que python/node/go)
+
+Dry-run de solo lectura contra repos Rust/.NET reales — ambos adapters entran sin
+repo de dogfooding detrás.
+
+## Diferido consciente (sin cambios)
+
+- rebuild: densidad de asserts. Perfiles A-E mecanizados.
+- C++: viable (gcovr emite Cobertura/lcov — parsers existentes; gtest/catch2 emiten
+  JUnit; clang-tidy necesitaría un parser tipo mypy) — entra cuando haya repo real.

package/uscha-kit/CHANGELOG-1.8.0.md

@@ -0,0 +1,46 @@
+# dev-loop-kit 1.8.0 — adapter `type: cpp` (2026-07-02)
+
+> Publicado junto con 1.7.0 y 1.9.0 en un único commit (no existe commit
+> standalone de 1.8.0); la suite final de ese commit es 63/63. Los fixes que el
+> review fresco de este adapter encontró están aplicados y documentados en
+> CHANGELOG-1.9.0.
+
+Séptimo lenguaje, UN parser nuevo: clang-tidy. Coverage vía gcovr→Cobertura (reusa
+`cobertura_coverage`) y tests vía ctest `--output-junit`/GoogleTest (reusa
+`junit_test_count` — el fixture de smoke usa el root PLANO `<testsuite>` para
+ejercitar la rama que los demás types no tocan).
+
+## Engine (qa_ledger.py)
+
+- **`type: cpp`** — extensiones `.cpp .cc .cxx .c .h .hpp .hh .hxx`.
+- Coverage: `gcovr --cobertura reports/coverage.xml` — **reusa `cobertura_coverage`**.
+- Tests: `ctest --test-dir build --output-junit ../reports/junit.xml` (CMake ≥3.21;
+  root plano) o `--gtest_output=xml:` (root envuelto) — **reusa `junit_test_count`**,
+  ambas formas de root ya soportadas.
+- **`parse_clang_tidy()`** — texto (`file:line:col: warning: msg [check-a,check-b]`):
+  error→HIGH, warning→MEDIUM; checks de seguridad (`cert-*`, o que contengan
+  `security`) con floor HIGH — misma disciplina que findsecbugs/eslint-security.
+  Líneas sin `[check]` (diagnósticos crudos del compilador) → rule `diagnostic`.
+  IDs con path preservado (`_mk_id_rel`).
+- `ingest-gate`: branch cpp (`reports/clang-tidy.txt`, o `--clang-tidy`);
+  combinado = `cpp-qa-gate`. Mismo contrato de ausencia.
+- Guard UNMEASURED: los 7 types linteables.
+- LOC: `test`/`tests` en el path, prefijo `test_` o sufijos `_test.cpp/.cc/.cxx`,
+  `Test.cpp`. `SKIP_DIRS` += `cmake-build-debug`, `cmake-build-release`, `_deps`
+  (FetchContent) — mismo trade-off global documentado.
+
+## Nota honesta sobre C++
+
+El ecosistema no tiene UNA convención de build (CMake/Bazel/make) — el kit no la
+elige: pide que los REPORTES existan (Cobertura + JUnit + texto de clang-tidy) y el
+cómo se generan vive en el adapter por-repo (`CLAUDE.md` del proyecto). Es el
+contrato de siempre, explícito.
+
+## Criterio pendiente (mismo contrato que python/node/go/rust/dotnet)
+
+Dry-run de solo lectura contra un repo C++ real — entra sin repo de dogfooding.
+
+## Diferido consciente
+
+- rebuild: densidad de asserts. Perfiles A-E mecanizados. cppcheck (`--xml`) como
+  segundo linter cpp si un repo real lo pide.

package/uscha-kit/CHANGELOG-1.9.0.md

@@ -0,0 +1,112 @@
+# dev-loop-kit 1.9.0 — adapters `type: gradle` (Kotlin/JVM) y `type: swift` + fixes de los reviews 1.7.0/1.8.0 (2026-07-02)
+
+Los dos adapters más baratos hasta ahora: **CERO parsers nuevos**. Todo es reuso
+de formatos ya soportados en paths nuevos. Nota clave: **Kotlin sobre Maven ya
+funcionaba con `type: maven`** (`.kt` está en SOURCE_EXT maven desde 1.0) —
+`gradle` cubre el caso común Gradle. Smoke suite: 63/63.
+
+## Engine (qa_ledger.py)
+
+### `type: gradle` (Kotlin/JVM + Java-sobre-Gradle)
+
+- Extensiones `.kt .kts .java`. LOC: `src/main` = prod; `src/test` y source
+  sets custom (`src/*Test`: integrationTest, functionalTest) = test.
+- Coverage: **reusa el parser JaCoCo de maven** (`_jacoco_line_counter`) en los
+  paths Gradle (`build/reports/jacoco/test/jacocoTestReport.xml`).
+- Tests: **reusa la suma per-clase de surefire** — `maven_test_count` y
+  `gradle_test_count` ahora comparten `_perclass_xml_count()`; los
+  `build/test-results/**/TEST-*.xml` de Gradle son el mismo formato.
+- Linter: **detekt** emite formato checkstyle — `parse_checkstyle(tool="detekt")`
+  parametrizado, igual que golangci. `--detekt` explícito o por type;
+  combinado = `gradle-qa-gate`.
+
+### `type: swift`
+
+- Extensión `.swift`. LOC: convención SwiftPM (`Sources/` prod, `Tests/` +
+  `*Tests.swift`/`*Test.swift` test).
+- Coverage: **reusa el parser lcov** (Flutter/node) — `llvm-cov export
+  -format=lcov` sobre el `.profdata` de `swift test --enable-code-coverage`.
+- Tests: **reusa `junit_test_count`** — `swift test --xunit-output
+  reports/junit.xml` emite JUnit directo; el archivo hermano
+  `junit-swift-testing.xml` (Swift Testing) se SUMA (ver fixes 1.9.0).
+- Linter: **SwiftLint** también emite checkstyle —
+  `parse_checkstyle(tool="swiftlint")`. `--swiftlint` o por type;
+  combinado = `swift-qa-gate`.
+
+## Fixes del review fresco de 1.7.0 (rust/dotnet)
+
+- **BLOCKER — clippy contaba los summaries de rustc como HIGH fantasma**:
+  `1 warning emitted` / `aborting due to N previous errors` son diagnósticos
+  REALES (level warning/error, `code:null`, `spans:[]`) que el branch code-null
+  convertía en `compile-error` HIGH — el gate rust no podía converger nunca con
+  un solo warning MEDIUM vivo. Fix: diagnósticos SIN primary span se saltean
+  ANTES del check de code (los compile errors reales siempre traen span).
+  Además dedupe por finding ID (cargo re-emite por target lib/bin/test).
+- **SARIF**: Roslyn `ErrorLog` emite **v1** salvo `,version=2` — se documenta el
+  comando correcto Y el parser gana fallback v1 (`resultFile`/`analysisTarget`);
+  resultados suprimidos (`suppressions`/`suppressionStates`) se ignoran (un
+  `#pragma warning disable` no puede gatear un build limpio); URIs absolutas
+  `file:///` se relativizan contra el repo (IDs estables entre máquinas).
+- **Paths dotnet**: `LogFilePath`/`CoverletOutput` relativos resuelven contra el
+  PROYECTO DE TEST, no la raíz — comando de ejemplo ahora ancla con `$PWD` y el
+  README lo advierte (+ `MergeWith` para multi-proyecto).
+- **Junit de nextest**: no existe sin `[profile.default.junit]` en
+  `.config/nextest.toml` + copy desde `target/nextest/default/junit.xml` —
+  documentado y agregado al `test_command_rust`.
+- **Regla 5 saldada**: los fixes de 1.6.0 que entraron sin check propio ahora
+  tienen smoke — junit root-max (gotestsum errors solo en root), dedupe de
+  bloques del cover profile (-coverpkg), y el summary/dup de clippy (T20/T25).
+
+## Fixes del review fresco de 1.8.0 (cpp)
+
+- **`backtest.cpp` ya no cuenta como test LOC**: el sufijo bare `test.cpp`
+  (lowercased) tragaba `backtest/protest/contest.cpp`; ahora el patrón CamelCase
+  gtest (`FooTest.cpp`) se matchea case-sensitive, como hace dotnet con
+  `Test.cs`. Smoke T25 lo pinnea.
+- **`cmake-build-<perfil>` de CLion**: el skip ahora es por prefijo
+  (`cmake-build-*`), no solo debug/release — el README ya lo prometía y el
+  código no lo cumplía.
+- **clang-tidy con paths absolutos**: se relativizan contra el repo
+  (`_node_rel`), IDs estables entre checkouts; extensiones `.tpp/.ipp/.inl/
+  .mm/.cu` entran al regex (un cert-* en un template header ya no desaparece
+  en silencio).
+
+## Fixes del review fresco de 1.9.0 (gradle/swift)
+
+- **detekt y SwiftLint imprimen paths ABSOLUTOS por default** — el branch
+  isabs de `parse_checkstyle` colapsaba esos IDs a basename (colisiones entre
+  módulos Gradle y archivos homónimos Swift, corrompiendo fixed/new/oscillation
+  que se computan sobre sets de IDs). Fix: `parse_checkstyle` gana `base` y
+  relativiza SIEMPRE para tools no-java (`_node_rel`), igual que
+  eslint/tsc/clang-tidy; `golangci` también lo recibe. `_node_rel` dejó de
+  depender de `os.path.isabs` (su veredicto para paths `/posix` en Windows
+  cambió entre versiones de Python): intenta `relpath` y descarta si escapa
+  del repo. Smokes T27/T28 ahora usan paths absolutos (el default real) y
+  asserten IDs repo-relativos.
+- **Swift Testing era invisible**: `--xunit-output` escribe XCTest en
+  `junit.xml` y Swift Testing en un SEGUNDO `junit-swift-testing.xml` que el
+  counter no leía — un paquete Swift 6 (donde Swift Testing es el default)
+  medía `tests=0` con `report_found=True` y un failure real no disparaba el
+  veto "measured beats narrated": fail-open en la garantía central. Fix:
+  `junit_test_count` gana `extra_files` (reportes full-run de sets DISJUNTOS
+  que SÍ se suman) y el dispatch swift pasa ambos archivos. Smoke con failure
+  real en el archivo swift-testing.
+- **detekt fuera del test command**: su default `maxIssues: 0` corta el build
+  con UN finding — la corrida de tests leería roja aunque los tests pasen,
+  mezclando el gate de lint (que tiene su canal propio) con el de tests.
+  `test_command_gradle` queda `./gradlew test jacocoTestReport`.
+- **Source sets custom de Gradle**: `src/integrationTest/`, `src/functionalTest/`
+  (cualquier `src/*Test`) ahora cuentan como test LOC, no prod.
+- README swift: variante Linux de `llvm-cov` (sin `xcrun`) + path del binario
+  de tests documentados.
+
+## Contrato de siempre
+
+Reporte ausente = el gate no corrió (jamás acredita fixes). Guard UNMEASURED:
+los 9 types linteables. Criterio pendiente por adapter: dry-run de solo lectura
+contra un repo real de cada lenguaje.
+
+## Diferido consciente
+
+- rebuild: densidad de asserts. Perfiles A-E mecanizados. Android (Gradle +
+  variantes) queda explícitamente FUERA de `type: gradle` hasta un repo real.