@andresmassello/uscha 1.94.1 → 1.95.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.94.1** <!-- uscha:version --> · [uscha.dev](https://uscha.dev) ·
+**Kit v1.95.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)
 
@@ -85,7 +85,7 @@ automatic tool can perform: a human verdict.
    from the compiled code: 0.828 measured (12 archetypes) — names AND behaviour
 ```
 
-**What each arrow is, in the engine (kit 1.94.1, 53 subcommands, all measured):**
+**What each arrow is, in the engine (kit 1.95.0, 53 subcommands, all measured):**
 
 | Leg | Subcommands | What it establishes |
 |---|---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andresmassello/uscha",
-  "version": "1.94.1",
+  "version": "1.95.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-devloop/qa_ledger.py

@@ -7053,11 +7053,10 @@ def _struct_distance(a, b):
 
 
 def _oracle_hash(arm_dir):
-    try:
-        with open(os.path.join(arm_dir, "oracle", "ORACLE.json"), "rb") as fh:
-            return hashlib.sha256(fh.read()).hexdigest()
-    except OSError:
-        return None
+    # the arm's withheld oracle, hashed by exact bytes -- an arm whose oracle differs by one
+    # byte is a different experiment (cmd_lang_compare refuses the pair). Same rule, and now the
+    # same code, as a manifest unit: `_sha256_file`.
+    return _sha256_file(os.path.join(arm_dir, "oracle", "ORACLE.json"))
 
 
 def cmd_lang_compare(args):
@@ -7548,11 +7547,18 @@ DEFAULT_STATIC_ZERO_AT = 10  # gated-open count at which the static dimension hi
 BANDS = [(95, "READY"), (80, "RELEASE CANDIDATE"), (50, "IN PROGRESS"), (0, "NOT READY")]
 
 
-def _band(score):
-    for floor, label in BANDS:
+def _banded(score, bands):
+    """The label of the highest floor the score reaches. Every band table ends at floor 0, so
+    the last row IS the default -- named once here instead of being restated as a trailing
+    `return` in four callers, where it read as a fifth band nobody could reach (1.95.0)."""
+    for floor, label in bands:
         if score >= floor:
             return label
-    return "NOT READY"
+    return bands[-1][1]
+
+
+def _band(score):
+    return _banded(score, BANDS)
 
 
 _AC_ID = re.compile(r"(?i)^[*_`]*\s*AC[-_]?0*(\d+)\b[*_`]*[\s.:—–·-]*")
@@ -9216,7 +9222,9 @@ def cmd_top(args):
 
     total = len(obligations)
     done, fail, quar = _n("MEASURED_PASS"), _n("MEASURED_FAIL"), _n("QUARANTINE")
-    unmeasured = _n("UNMEASURED") + _n("TRACED")
+    # TRACED/TAGGED are declared in TOP_STATES for the renderer and NEVER assigned above
+    # (v0.1 has no source for either), so only UNMEASURED can carry a count here.
+    unmeasured = _n("UNMEASURED")
     pct = _top_pct(done, total)
     # INV-TOP-06 (ADR-038): DONE never publishes 100% while the seal is MEASURED broken --
     # every criterion green against evidence that no longer belongs to this code state is
@@ -9780,17 +9788,11 @@ _FUNC_RE = re.compile(
 
 
 def _simplicity_band(score):
-    for floor, label in SIMPLICITY_BANDS:
-        if score >= floor:
-            return label
-    return "OVERBUILT"
+    return _banded(score, SIMPLICITY_BANDS)
 
 
 def _rebuild_band(score):
-    for floor, label in REBUILD_BANDS:
-        if score >= floor:
-            return label
-    return "DIVERGE"
+    return _banded(score, REBUILD_BANDS)
 
 
 def _test_file_set(repo_path, repo_type):
@@ -10349,10 +10351,7 @@ _WASTE_COMMENT = ("//", "#", "*", "--", "/*", "*/", '"""', "'''", ";;", "<!--")
 
 
 def _waste_band(score):
-    for floor, label in WASTE_BANDS:
-        if score >= floor:
-            return label
-    return "WASTEFUL"
+    return _banded(score, WASTE_BANDS)
 
 
 def _path_allowed(rel, allow_paths):

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.94.1",
+  "version": "1.95.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, 53 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.94.1",
+  "version": "1.95.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.94.1 <!-- uscha:version --> · **[uscha.dev](https://uscha.dev)**
+**Kit version:** v1.95.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.94.1
+uscha-kit 1.95.0

package/uscha-kit/skills/uscha-devloop/qa_ledger.py

@@ -7053,11 +7053,10 @@ def _struct_distance(a, b):
 
 
 def _oracle_hash(arm_dir):
-    try:
-        with open(os.path.join(arm_dir, "oracle", "ORACLE.json"), "rb") as fh:
-            return hashlib.sha256(fh.read()).hexdigest()
-    except OSError:
-        return None
+    # the arm's withheld oracle, hashed by exact bytes -- an arm whose oracle differs by one
+    # byte is a different experiment (cmd_lang_compare refuses the pair). Same rule, and now the
+    # same code, as a manifest unit: `_sha256_file`.
+    return _sha256_file(os.path.join(arm_dir, "oracle", "ORACLE.json"))
 
 
 def cmd_lang_compare(args):
@@ -7548,11 +7547,18 @@ DEFAULT_STATIC_ZERO_AT = 10  # gated-open count at which the static dimension hi
 BANDS = [(95, "READY"), (80, "RELEASE CANDIDATE"), (50, "IN PROGRESS"), (0, "NOT READY")]
 
 
-def _band(score):
-    for floor, label in BANDS:
+def _banded(score, bands):
+    """The label of the highest floor the score reaches. Every band table ends at floor 0, so
+    the last row IS the default -- named once here instead of being restated as a trailing
+    `return` in four callers, where it read as a fifth band nobody could reach (1.95.0)."""
+    for floor, label in bands:
         if score >= floor:
             return label
-    return "NOT READY"
+    return bands[-1][1]
+
+
+def _band(score):
+    return _banded(score, BANDS)
 
 
 _AC_ID = re.compile(r"(?i)^[*_`]*\s*AC[-_]?0*(\d+)\b[*_`]*[\s.:—–·-]*")
@@ -9216,7 +9222,9 @@ def cmd_top(args):
 
     total = len(obligations)
     done, fail, quar = _n("MEASURED_PASS"), _n("MEASURED_FAIL"), _n("QUARANTINE")
-    unmeasured = _n("UNMEASURED") + _n("TRACED")
+    # TRACED/TAGGED are declared in TOP_STATES for the renderer and NEVER assigned above
+    # (v0.1 has no source for either), so only UNMEASURED can carry a count here.
+    unmeasured = _n("UNMEASURED")
     pct = _top_pct(done, total)
     # INV-TOP-06 (ADR-038): DONE never publishes 100% while the seal is MEASURED broken --
     # every criterion green against evidence that no longer belongs to this code state is
@@ -9780,17 +9788,11 @@ _FUNC_RE = re.compile(
 
 
 def _simplicity_band(score):
-    for floor, label in SIMPLICITY_BANDS:
-        if score >= floor:
-            return label
-    return "OVERBUILT"
+    return _banded(score, SIMPLICITY_BANDS)
 
 
 def _rebuild_band(score):
-    for floor, label in REBUILD_BANDS:
-        if score >= floor:
-            return label
-    return "DIVERGE"
+    return _banded(score, REBUILD_BANDS)
 
 
 def _test_file_set(repo_path, repo_type):
@@ -10349,10 +10351,7 @@ _WASTE_COMMENT = ("//", "#", "*", "--", "/*", "*/", '"""', "'''", ";;", "<!--")
 
 
 def _waste_band(score):
-    for floor, label in WASTE_BANDS:
-        if score >= floor:
-            return label
-    return "WASTEFUL"
+    return _banded(score, WASTE_BANDS)
 
 
 def _path_allowed(rel, allow_paths):

package/uscha-kit/uscha.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.94.1",
+  "version": "1.95.0",
   "project": null,
   "defaults": {
     "coverage_threshold": 60,