@andresmassello/uscha 1.56.1 → 1.60.1

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

@@ -67,6 +67,17 @@ than inventing a step. Keep the CONTENT in the conversation's language and the l
   `review_trigger`, `experiment_valid`, `experiment_missing`, and `expired`; top-level
   `adr_experiments` summarizes open/malformed/expired experiments. This is advisory
   visibility for measured hypotheses, not readiness scoring.
+- **Fast-path (ADR-003):** `dashboard --json` carries `fast_path` — the latest verdict per
+  repo straight from the ledger, or null when none was requested. The template degrades when
+  absent, like every other field.
+- **Spec-drift (ADR-005):** `dashboard --json` carries `spec_drift` — the latest advisory
+  run (per-document verdicts: SPEC_STALE / CLEAN / UNMAPPED / UNTRACKED) — only when a run
+  exists in the ledger; a virgin ledger keeps the exact prior schema. Advisory visibility of
+  the spec-maintenance tax, never readiness input.
+- **Modes card:** the template draws one card for both modes — fast-path verdict chips per
+  repo (ALLOW green / ESCALATED amber / DENY red) and spec-drift rows per document, labeled
+  advisory. The card is hidden entirely when neither key exists (absent block = identical
+  view, same rule as the JSON).
 - **Session telemetry (optional, vendor-reported):** if `.uscha/telemetry.jsonl` exists,
   the skill aggregates it and MERGES a `telemetry` object into `DATA`. This is the ONE
   panel that is **narrated by the vendor (Claude Code), not measured by the engine** —

package/uscha-kit/skills/uscha-mirador/mirador-watch.ps1

@@ -1,22 +1,22 @@
-# mirador-watch.ps1 -- live second-screen mirador (uscha-kit 1.34.0), Windows.
-# Regenerates mirador.html every N seconds from the current ledger; the page is rendered
-# with a meta-refresh at the same interval, so a browser open on it updates on its own.
-#
-# Usage (run in a spare terminal, from the project root):
-#   powershell -NoProfile -File <kit>\.claude\skills\uscha-mirador\mirador-watch.ps1 [-Interval 30]
-# then open mirador.html in a browser on your second screen. Ctrl-C to stop.
-#
-# Overridable via env: ENGINE, LEDGER, TEMPLATE, OUT, PYTHON.
-param([int]$Interval = 30)
-$here     = Split-Path -Parent $MyInvocation.MyCommand.Path
-$engine   = if ($env:ENGINE)   { $env:ENGINE }   else { Join-Path $here "..\uscha-devloop\qa_ledger.py" }
-$ledger   = if ($env:LEDGER)   { $env:LEDGER }   else { "QA-LEDGER.json" }
-$template = if ($env:TEMPLATE) { $env:TEMPLATE } else { Join-Path $here "mirador.template.html" }
-$out      = if ($env:OUT)      { $env:OUT }      else { "mirador.html" }
-$py       = if ($env:PYTHON)   { $env:PYTHON }   else { "python" }
-Write-Host "mirador-watch: regenerating $out every ${Interval}s (Ctrl-C to stop). Open $out in a browser."
-while ($true) {
-  & $py (Join-Path $here "mirador-render.py") --engine $engine --ledger $ledger --template $template --out $out --refresh $Interval --no-open
-  if ($LASTEXITCODE -ne 0) { Write-Host "mirador-watch: render failed (ledger missing? run uscha-devloop first) -- retrying" }
-  Start-Sleep -Seconds $Interval
-}
+# mirador-watch.ps1 -- live second-screen mirador (uscha-kit 1.34.0), Windows.
+# Regenerates mirador.html every N seconds from the current ledger; the page is rendered
+# with a meta-refresh at the same interval, so a browser open on it updates on its own.
+#
+# Usage (run in a spare terminal, from the project root):
+#   powershell -NoProfile -File <kit>\.claude\skills\uscha-mirador\mirador-watch.ps1 [-Interval 30]
+# then open mirador.html in a browser on your second screen. Ctrl-C to stop.
+#
+# Overridable via env: ENGINE, LEDGER, TEMPLATE, OUT, PYTHON.
+param([int]$Interval = 30)
+$here     = Split-Path -Parent $MyInvocation.MyCommand.Path
+$engine   = if ($env:ENGINE)   { $env:ENGINE }   else { Join-Path $here "..\uscha-devloop\qa_ledger.py" }
+$ledger   = if ($env:LEDGER)   { $env:LEDGER }   else { "QA-LEDGER.json" }
+$template = if ($env:TEMPLATE) { $env:TEMPLATE } else { Join-Path $here "mirador.template.html" }
+$out      = if ($env:OUT)      { $env:OUT }      else { "mirador.html" }
+$py       = if ($env:PYTHON)   { $env:PYTHON }   else { "python" }
+Write-Host "mirador-watch: regenerating $out every ${Interval}s (Ctrl-C to stop). Open $out in a browser."
+while ($true) {
+  & $py (Join-Path $here "mirador-render.py") --engine $engine --ledger $ledger --template $template --out $out --refresh $Interval --no-open
+  if ($LASTEXITCODE -ne 0) { Write-Host "mirador-watch: render failed (ledger missing? run uscha-devloop first) -- retrying" }
+  Start-Sleep -Seconds $Interval
+}

package/uscha-kit/skills/uscha-mirador/mirador.template.html

@@ -278,6 +278,11 @@ svg{display:block;width:100%;height:auto}
         The verdict above is all you need to look at. These roll up into it; they're here if you want to dig.
       </p>
     </div>
+
+    <div class="card col6" id="card-modes" hidden>
+      <h2>Fast-path &middot; Spec-drift <span class="n" id="modes-n">&mdash;</span></h2>
+      <div class="speclist" id="modes"></div>
+    </div>
   </section>
 
   <section class="telemetry" id="telemetry" hidden>
@@ -654,6 +659,39 @@ function renderTelemetry(){
   if(sec)sec.hidden=false;
 }
 
+function renderModes(){
+  /* fast_path: latest measured verdict per repo (ADR-003). spec_drift: latest advisory
+     run (ADR-005) -- advisory means it never feeds readiness; this card only makes the
+     ledger fact visible. BOTH keys are conditional in dashboard --json, so a project
+     that never used either sees no card at all (absent block = identical view). */
+  const card=$("#card-modes");if(!card)return;
+  const fp=DATA.fast_path,sd=DATA.spec_drift;
+  if(!fp&&!sd){card.hidden=true;return;}
+  const host=$("#modes");host.replaceChildren();
+  const parts=[];
+  if(fp){
+    const cls={ALLOW:"st-done",ESCALATED:"st-prog",DENY:"st-block"};
+    Object.keys(fp).forEach(r=>{const e=fp[r]||{};
+      append(host,append(node("div","spec"),node("span","id","fast-path"),
+        node("span","t",r+(e.intent?(" — "+e.intent):"")),
+        node("span","chip "+(cls[e.verdict]||"st-todo"),String(e.verdict||"?"))));});
+    parts.push(Object.keys(fp).length+" repo"+(Object.keys(fp).length>1?"s":""));
+  }
+  if(sd){
+    const cls={SPEC_STALE:"st-block",CLEAN:"st-done",UNMAPPED:"st-todo",UNTRACKED:"st-todo"};
+    const res=sd.results||[];
+    res.forEach(d=>{const extra=d.verdict==="SPEC_STALE"
+        ?(" — "+(d.newer_files_total||0)+" file(s) newer than the spec"):"";
+      append(host,append(node("div","spec"),node("span","id","spec-drift"),
+        node("span","t",String(d.file||"")+extra),
+        node("span","chip "+(cls[d.verdict]||"st-todo"),String(d.verdict||"?"))));});
+    const stale=res.filter(d=>d.verdict==="SPEC_STALE").length;
+    parts.push(stale?stale+" stale spec"+(stale>1?"s":""):"no drift measured");
+    host.appendChild(emptyHint("spec-drift is ADVISORY (ADR-005): it prompts a human look, it never gates."));
+  }
+  $("#modes-n").textContent=parts.join(" · ");
+  card.hidden=false;
+}
 /* ==== status story: cómo viene / qué lo traba / qué sigue — all from measured DATA ==== */
 function renderStatus(){
   const sec=$("#status");if(!sec)return;
@@ -741,7 +779,7 @@ function applySnapshot(i){
 scrub.addEventListener("input",()=>applySnapshot(+scrub.value));
 
 /* ==== init ==== */
-renderStatus();renderAcceptance();renderAdrs();renderInv();renderHeat();renderLoops();renderSubs();renderExecutionPolicy();renderTelemetry();
+renderStatus();renderModes();renderAcceptance();renderAdrs();renderInv();renderHeat();renderLoops();renderSubs();renderExecutionPolicy();renderTelemetry();
 $("#asof").textContent=snaps.length?snaps[snaps.length-1].date:"no history yet (readiness --record)";
 renderTrail(null);
 </script>

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

@@ -86,6 +86,14 @@ Line guide:
   WHEN the evidence was captured — facts do not move without new evidence. If the
   field is absent (nothing recorded yet), omit the line; never guess a timestamp.
 
+**Fast-path mode (ADR-003):** if the ledger carries `fast_path` entries, add ONE line to the
+block with the latest verdict per repo (`fast-path: ALLOW (intent...)` / `ESCALATED`). Absent
+entries → no line at all: silence is honest when no mode was requested.
+
+**Spec-drift (ADR-005):** if the ledger carries a `spec_drift` run, add ONE line:
+`spec-drift: N stale / M docs (advisory)` — or `spec-drift: no drift measured` when zero are
+stale. Always label it advisory; it never explains a blocked phase. Absent key → no line.
+
 ## Degradation (honest, specific)
 
 - `measured` missing entirely → print: *"No measurement recorded yet — the trail

package/uscha-kit/uscha.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.56.1",
+  "version": "1.60.1",
   "project": null,
   "defaults": {
     "coverage_threshold": 60,
@@ -40,6 +40,21 @@
       "blocker_critical": 65,
       "escalation": 75
     },
+    "fast_path": {
+      "enabled": true,
+      "max_files_changed": 3,
+      "max_loc_delta": 80,
+      "protected_paths": [
+        "**/migrations/**",
+        "**/*.approved",
+        "db/**"
+      ],
+      "require_asserting_test": true,
+      "forbid_when_golden_touched": false
+    },
+    "spec_drift": {
+      "max_lag_days": 30
+    },
     "static_gate_zero_at": 10,
     "constitution_file": "CONSTITUTION.md",
     "rebuild": {