@andresmassello/uscha 1.56.0 → 1.59.0

package/uscha-kit/.claude/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/.claude/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/.claude-plugin/plugin.json

@@ -1,9 +1,9 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "uscha",
-  "version": "1.56.0",
+  "version": "1.59.0",
   "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.",
+  "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, 31 subcommands + universal installer + npm/npx router). Facts block, guesses advise; the human approves.",
   "author": {
     "name": "Andres Massello",
     "url": "https://github.com/andresmassello"

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

@@ -1,6 +1,6 @@
 {
   "name": "uscha",
-  "version": "1.56.0",
+  "version": "1.59.0",
   "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.56.0 <!-- uscha:version --> · **[uscha.dev](https://uscha.dev)**
+**Kit version:** v1.59.0 <!-- 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`,
@@ -38,6 +38,59 @@ uscha-kit/
    └─ uscha-rubric/                      # (optional) rubric grading — thin adapter; the core is agnostic
 ```
 
+## Fast-path (ADR-003) — measured entry for trivial changes
+
+A one-line fix should not pay the ceremony of a schema migration. `fastpath-eval` grants the
+shortcut from **measured signals**, never from anyone's opinion of "small":
+
+```bash
+python qa_ledger.py fastpath-eval --repo <name> --json            # dry-run: verdict only
+python qa_ledger.py fastpath-eval --repo <name> --intent "fix: x" # records it in the ledger
+```
+
+Config (`defaults.fast_path`; absent block = feature off, behavior identical to earlier
+releases): `max_files_changed` (3) and `max_loc_delta` (80) measured from
+`git diff --numstat` against the merge-base with `origin/main` (fallback `main`) **plus
+untracked files** — a new file is still a change; `protected_paths` globs deny regardless of
+size; `require_asserting_test` caps readiness while a fast-path run has no measured test.
+
+**Fail-closed:** no git, no resolvable base, no config → `DENY` with the reason named.
+"Could not measure" never grants the shortcut. **Escalation:** re-running `fastpath-eval`
+mid-run (the devloop does, before the PR step) with thresholds now exceeded flips the run to
+`ESCALATED` through the standard escalation machinery — the derived phase blocks `pr-ready`
+and readiness is capped until a human runs `resolve-escalation`, after producing the ADR +
+ACCEPTANCE the change turned out to deserve. **The override is asymmetric (INV-RIGOR-02):**
+you can always force the full path; nothing can force `ALLOW` over a measured `DENY`.
+
+## Spec-drift (ADR-005) — the spec maintenance tax, made visible
+
+Specs rot silently: the code moves and `SPEC.md` stays where it was. `spec-drift` detects
+that lag **mechanically** — and reports it as **advisory, never a gate**, because whether an
+older spec still covers newer code is a relevance judgment, and a guess advises.
+
+```bash
+python qa_ledger.py spec-drift --repo <name> --json   # advisory report; exit 0 always
+```
+
+Map specs to code with a `governs:` glob list in the frontmatter of `SPEC.md` and each
+`docs/adr/*.md`:
+
+```markdown
+---
+governs:
+  - src/payments/**
+  - db/**
+---
+```
+
+Per document: **`SPEC_STALE`** when governed code outran the spec by more than
+`defaults.spec_drift.max_lag_days` (default 30), listing the newer files; **`CLEAN`** when it
+did not; **`UNMAPPED`** when there is no `governs:` frontmatter *or its globs match nothing*
+— absence of a mapping is absence of measurement, not "no drift"; **`UNTRACKED`** when the
+spec has no commit date to compare. The latest run lands in the ledger (`spec_drift`) so the
+mirador can surface it. No readiness impact, no exit-code gate: a stale spec is a prompt for
+a human conversation, not a blocked pipeline.
+
 ## End-to-end flow
 
 `uscha-discovery` is the front for something new (you only have the idea); `uscha-adr-refine` is the front

package/uscha-kit/VERSION

@@ -1 +1 @@
-uscha-kit 1.56.0
+uscha-kit 1.59.0

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

@@ -0,0 +1 @@
+{"AC-FP-01": true, "AC-FP-11": true, "AC-FP-07": true, "AC-FP-06": true, "AC-FP-05": true, "AC-FP-02": true, "AC-FP-03": true, "AC-FP-09": true, "AC-FP-10": true, "AC-FP-08": true}

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

@@ -0,0 +1 @@
+{"AC-SD-01": true, "AC-SD-03": true, "AC-SD-02": true, "AC-SD-04": true}

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

@@ -169,6 +169,27 @@ install `hooks/block-approved-writes.py` as a `PreToolUse` hook in
 `settings.json`, and add `*.approved.* binary` to `.gitattributes` (ships in
 `templates/.gitattributes`) so line endings can't lie in the byte-compare.
 
+## Phase 0a — Fast-path check (ADR-003; run FIRST, before planning ceremony)
+
+If `defaults.fast_path` exists in config, run the measured classifier before demanding a
+full spec package:
+
+```bash
+python qa_ledger.py fastpath-eval --repo <name> --json          # dry-run first
+```
+
+- **ALLOW** and the operator wants the shortcut: re-run with
+  `--intent "<one sentence: what and why>"` to record it, then skip Phase 0's full-package
+  demand. The micro-contract replaces it: the recorded INTENT plus at least one new/modified
+  asserting test (readiness stays capped until that test shows up in measured evidence).
+- **DENY**: state WHICH measured signal denied it — echo the engine's breakdown verbatim.
+  The skill wires; it never computes and never argues with the verdict. Proceed with the
+  normal full path. The operator may always choose the full path over an ALLOW; nothing —
+  operator, agent or flag — can force ALLOW over a DENY (INV-RIGOR-02).
+- **Re-evaluate before the PR step** (same command, same intent): thresholds exceeded mid-run
+  flip the run to `ESCALATED` — the derived phase blocks pr-ready and readiness is capped.
+  Produce the ADR + ACCEPTANCE the change turned out to deserve, then `resolve-escalation`.
+
 ## Phase 0 — Plan (ADR-first)
 
 - **Read `CONSTITUTION.md` first (if present).** It lists the project invariants no SPEC