@andresmassello/uscha 1.66.0 → 1.67.0

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.66.0** <!-- uscha:version --> · [uscha.dev](https://uscha.dev) ·
+**Kit v1.67.0** <!-- 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)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andresmassello/uscha",
-  "version": "1.66.0",
+  "version": "1.67.0",
   "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-mirador/mirador.template.html

@@ -665,8 +665,8 @@ function renderModes(){
      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 fp=DATA.fast_path,sd=DATA.spec_drift,cr=DATA.clean_room;
+  if(!fp&&!sd&&!cr){card.hidden=true;return;}
   const host=$("#modes");host.replaceChildren();
   const parts=[];
   if(fp){
@@ -677,6 +677,16 @@ function renderModes(){
         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(cr){
+    const cls={GREEN:"st-done",RED:"st-block"};
+    Object.keys(cr).forEach(r=>{const e=cr[r]||{};
+      const sha=(e.ref||"").slice(0,8)||"?";
+      const wall=(typeof e.wall_ms==="number")?(" · "+(e.wall_ms/1000).toFixed(1)+"s"):"";
+      append(host,append(node("div","spec"),node("span","id","clean-room"),
+        node("span","t",r+" @ "+sha+wall),
+        node("span","chip "+(cls[e.status]||"st-prog"),String(e.status||"?"))));});
+    parts.push("clean-room ×"+Object.keys(cr).length);
+  }
   if(sd){
     const cls={SPEC_STALE:"st-block",CLEAN:"st-done",UNMAPPED:"st-todo",UNTRACKED:"st-todo"};
     const res=sd.results||[];

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

@@ -100,6 +100,11 @@ nothing and gates nothing.
 `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.
 
+**Clean-room (ADR-008):** if the ledger carries `clean_room` runs, add ONE line with the
+latest run per repo: `clean-room: GREEN @ <sha8> (12.3s)` / `RED @ <sha8>`. When the gate is
+declared (`mode: "final"`) and the latest run does not match the current HEAD, append
+`(stale for gate)`. Absent key → no line.
+
 **Roundtrip (ADR-009 slice 2):** if the ledger carries a `roundtrip` run, add ONE line:
 `roundtrip: N/M promoted traceable by uscha-spec id (advisory)`. Absent key → no line —
 silence is honest when the loop was never measured.

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.66.0",
+  "version": "1.67.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, 35 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.66.0",
+  "version": "1.67.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.66.0 <!-- uscha:version --> · **[uscha.dev](https://uscha.dev)**
+**Kit version:** v1.67.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`,

package/uscha-kit/VERSION

@@ -1 +1 @@
-uscha-kit 1.66.0
+uscha-kit 1.67.0

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

@@ -665,8 +665,8 @@ function renderModes(){
      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 fp=DATA.fast_path,sd=DATA.spec_drift,cr=DATA.clean_room;
+  if(!fp&&!sd&&!cr){card.hidden=true;return;}
   const host=$("#modes");host.replaceChildren();
   const parts=[];
   if(fp){
@@ -677,6 +677,16 @@ function renderModes(){
         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(cr){
+    const cls={GREEN:"st-done",RED:"st-block"};
+    Object.keys(cr).forEach(r=>{const e=cr[r]||{};
+      const sha=(e.ref||"").slice(0,8)||"?";
+      const wall=(typeof e.wall_ms==="number")?(" · "+(e.wall_ms/1000).toFixed(1)+"s"):"";
+      append(host,append(node("div","spec"),node("span","id","clean-room"),
+        node("span","t",r+" @ "+sha+wall),
+        node("span","chip "+(cls[e.status]||"st-prog"),String(e.status||"?"))));});
+    parts.push("clean-room ×"+Object.keys(cr).length);
+  }
   if(sd){
     const cls={SPEC_STALE:"st-block",CLEAN:"st-done",UNMAPPED:"st-todo",UNTRACKED:"st-todo"};
     const res=sd.results||[];

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

@@ -100,6 +100,11 @@ nothing and gates nothing.
 `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.
 
+**Clean-room (ADR-008):** if the ledger carries `clean_room` runs, add ONE line with the
+latest run per repo: `clean-room: GREEN @ <sha8> (12.3s)` / `RED @ <sha8>`. When the gate is
+declared (`mode: "final"`) and the latest run does not match the current HEAD, append
+`(stale for gate)`. Absent key → no line.
+
 **Roundtrip (ADR-009 slice 2):** if the ledger carries a `roundtrip` run, add ONE line:
 `roundtrip: N/M promoted traceable by uscha-spec id (advisory)`. Absent key → no line —
 silence is honest when the loop was never measured.

package/uscha-kit/uscha.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.66.0",
+  "version": "1.67.0",
   "project": null,
   "defaults": {
     "coverage_threshold": 60,