bigpowers 2.59.0 → 2.59.2

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.59.0",
+  "version": "2.59.2",
   "description": "73 skills — 72 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "pi-package"

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.59.2](https://github.com/danielvm-git/bigpowers/compare/v2.59.1...v2.59.2) (2026-07-04)
+
+
+### Bug Fixes
+
+* **trace:** exclude .venv, site-packages, __pycache__ from trace-stories walker ([aff4b4f](https://github.com/danielvm-git/bigpowers/commit/aff4b4fc1b9b0acfd2940c5fd137c04285a834d9))
+
+## [2.59.1](https://github.com/danielvm-git/bigpowers/compare/v2.59.0...v2.59.1) (2026-07-04)
+
+
+### Bug Fixes
+
+* **trace:** replace hand-rolled YAML parser, add floor assertion, G-10 ([67f7c71](https://github.com/danielvm-git/bigpowers/commit/67f7c71a74deefac2fea461f161c9656b751b387))
+
 # [2.59.0](https://github.com/danielvm-git/bigpowers/compare/v2.58.9...v2.59.0) (2026-07-04)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.59.0",
+  "version": "2.59.2",
   "description": "72 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {

package/scripts/golden-g10-trace-anti-vacuity.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# golden-g10-trace-anti-vacuity.sh — Trace Engine Anti-Vacuity Self-Test (G-10)
+#
+# Proves that trace-stories.py CAN detect a degenerate matrix (floor assertion).
+# It is fed a fixture where specs/release-plan.yaml has valid YAML but produces
+# 0 stories — the --strict floor assertion MUST catch this and exit 2.
+#
+# If --strict exits 0 or 1 on this fixture, the trace engine is failing-open
+# (same bug class as BUG-2026-07-03-trace-engine-vacuous-gate).
+#
+# Usage: bash scripts/golden-g10-trace-anti-vacuity.sh
+# Exit 0: trace-stories.py correctly detected the degenerate fixture (exit 2)
+# Exit 1: trace-stories.py passed vacuously on the degenerate fixture (fail-open risk)
+
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+FIXTURE_DIR="$REPO_ROOT/specs/verifications/fixtures/trace-vacuous"
+TRACE_ENGINE="$REPO_ROOT/scripts/lib/trace-stories.py"
+
+echo "=== G-10: Trace Engine Anti-Vacuity Self-Test ==="
+echo "Fixture: $FIXTURE_DIR"
+echo ""
+
+if [[ ! -f "$FIXTURE_DIR/specs/release-plan.yaml" ]]; then
+  echo "ERROR: fixture not found: $FIXTURE_DIR/specs/release-plan.yaml"
+  exit 1
+fi
+
+MATRIX_JSON=$(mktemp)
+TRACE_MD=$(mktemp)
+OKF_DIR=$(mktemp -d)
+trap 'rm -f "$MATRIX_JSON" "$TRACE_MD"; rm -rf "$OKF_DIR"' EXIT
+
+set +e
+actual_output=$(python3 "$TRACE_ENGINE" "$FIXTURE_DIR" "$MATRIX_JSON" "$TRACE_MD" "$OKF_DIR" 1 "" 2>&1)
+actual_exit=$?
+set -e
+
+echo "$actual_output"
+echo ""
+
+if [[ $actual_exit -eq 2 ]]; then
+  echo -e "${GREEN}PASS${NC} trace-stories.py --strict correctly detected the degenerate fixture (exit 2)"
+  echo "G-10: PASS"
+  exit 0
+elif [[ $actual_exit -eq 0 ]]; then
+  echo -e "${RED}FAIL${NC} trace-stories.py --strict passed vacuously on a 0-story fixture (exit 0)"
+  echo "G-10: FAIL — fail-open risk (BUG-2026-07-03-trace-engine-vacuous-gate class)"
+  exit 1
+else
+  echo -e "${RED}FAIL${NC} trace-stories.py --strict exited $actual_exit (expected 2)"
+  echo "G-10: FAIL — unexpected exit code"
+  exit 1
+fi

package/scripts/lib/trace-stories.py

@@ -17,6 +17,7 @@ Oracle tiers (TEA-inspired):
 import json, os, re, subprocess, sys
 from pathlib import Path
 from datetime import datetime, timezone
+import yaml
 
 ROOT = Path(sys.argv[1])
 MATRIX_JSON = Path(sys.argv[2])
@@ -26,103 +27,21 @@ STRICT = int(sys.argv[5])
 MODE = sys.argv[6]
 
 # -----------------------------------------------------------------------
-# 1. Parse release-plan.yaml → story inventory
+# 1. Parse YAML files → story inventory
 # -----------------------------------------------------------------------
-def parse_simple_yaml(text: str) -> dict:
-    """Parse flat and one-level-nested YAML including lists of objects."""
-    root: dict = {}
-    stack: list = [(0, root, None, None)]
-    skip_until_indent = None
-    for i, raw in enumerate(text.splitlines()):
-        stripped = raw.strip()
-        if not stripped or stripped.startswith("#"):
-            continue
-        indent = len(raw) - len(raw.lstrip())
-        if skip_until_indent is not None:
-            if indent > skip_until_indent:
-                continue
-            else:
-                skip_until_indent = None
-        while len(stack) > 1:
-            if indent < stack[-1][0]:
-                stack.pop()
-            elif indent == stack[-1][0]:
-                if isinstance(stack[-1][1], list) and stripped.startswith("- "):
-                    break
-                elif isinstance(stack[-1][1], dict) and stripped.startswith("- "):
-                    entry_container = stack[-1][1]
-                    entry_parent = stack[-1][2]
-                    entry_key = stack[-1][3]
-                    if entry_parent is not None and entry_key is not None:
-                        if not isinstance(entry_parent.get(entry_key), list):
-                            entry_parent[entry_key] = []
-                            stack[-1] = (stack[-1][0], entry_parent[entry_key], entry_parent, entry_key)
-                            break
-                    stack.pop()
-                else:
-                    stack.pop()
-            else:
-                break
-        container = stack[-1][1]
-        parent_dict = stack[-1][2]
-        key_in_parent = stack[-1][3]
-        if stripped.startswith("- "):
-            inner = stripped[2:]
-            if isinstance(container, dict) and parent_dict is not None and key_in_parent is not None:
-                if not isinstance(parent_dict.get(key_in_parent), list):
-                    orig_indent = stack[-1][0]
-                    parent_dict[key_in_parent] = []
-                    container = parent_dict[key_in_parent]
-                    stack[-1] = (orig_indent, container, parent_dict, key_in_parent)
-            if ":" in inner:
-                k, _, v = inner.partition(":")
-                k = k.strip(); v = v.strip()
-                if v in ("|", ">", "|-", ">-", "|+", ">+"):
-                    item = {k: v}; container.append(item)
-                    skip_until_indent = indent; continue
-                item = {k: _yaml_scalar(v) if v else None}
-                container.append(item)
-                if v == "":
-                    stack.append((indent, item, container, k))
-            else:
-                container.append(_yaml_scalar(inner))
-            continue
-        if ":" not in stripped:
-            continue
-        key, _, val = stripped.partition(":")
-        key = key.strip(); val = val.strip()
-        if val in ("|", ">", "|-", ">-", "|+", ">+"):
-            if isinstance(container, list) and container:
-                container[-1][key] = val
-            elif isinstance(container, dict):
-                container[key] = val
-            skip_until_indent = indent; continue
-        if isinstance(container, list) and container:
-            container[-1][key] = _yaml_scalar(val) if val else None
-            if val == "":
-                nxt = {}; container[-1][key] = nxt
-                stack.append((indent, nxt, container[-1], key))
-        elif isinstance(container, dict):
-            if val == "":
-                nxt = {}; container[key] = nxt
-                stack.append((indent, nxt, container, key))
-            else:
-                container[key] = _yaml_scalar(val)
-    return root
+_MIN_STORY_BASELINE = 50  # floor assertion: --strict FAILs if story count drops below this
 
-def _yaml_scalar(val: str):
-    val = val.strip('"').strip("'")
-    if val in ("true", "false"): return val == "true"
-    if val in ("null", "~", ""): return None
-    try: return int(val)
-    except ValueError:
-        try: return float(val)
-        except ValueError: return val
+def _load_yaml(path: Path) -> dict:
+    """Load a YAML file with PyYAML. Exits with code 1 if parse fails."""
+    try:
+        with open(str(path), encoding="utf-8") as f:
+            return yaml.safe_load(f) or {}
+    except Exception as e:
+        print(f"trace-stories.py: ERROR parsing {path}: {e}", file=sys.stderr)
+        sys.exit(1)
 
-release_text = (ROOT / "specs" / "release-plan.yaml").read_text(encoding="utf-8")
-release = parse_simple_yaml(release_text)
-exec_text = (ROOT / "specs" / "execution-status.yaml").read_text(encoding="utf-8")
-exec_status = parse_simple_yaml(exec_text)
+release = _load_yaml(ROOT / "specs" / "release-plan.yaml")
+exec_status = _load_yaml(ROOT / "specs" / "execution-status.yaml")
 dev_status = exec_status.get("development_status", {})
 
 # -----------------------------------------------------------------------
@@ -141,7 +60,7 @@ for epic in epics:
     if capsule_dir:
         capsule_path = ROOT / "specs" / capsule_dir / "epic.yaml"
         if capsule_path.exists():
-            cap = parse_simple_yaml(capsule_path.read_text(encoding="utf-8"))
+            cap = _load_yaml(capsule_path)
             for s in cap.get("stories", []) or []:
                 if isinstance(s, dict):
                     sid = s.get("id", "")
@@ -153,7 +72,7 @@ for epic in epics:
     if file_key and not capsule_dir:
         legacy_path = ROOT / "specs" / file_key
         if legacy_path.exists():
-            leg = parse_simple_yaml(legacy_path.read_text(encoding="utf-8"))
+            leg = _load_yaml(legacy_path)
             for s in leg.get("stories", []) or []:
                 if isinstance(s, dict):
                     sid = s.get("id", "")
@@ -187,7 +106,7 @@ for line in result.stdout.splitlines():
 # -----------------------------------------------------------------------
 # 4. Oracle tiers
 # -----------------------------------------------------------------------
-EXCLUDE_DIRS = {".git", "node_modules", ".cursor", ".gemini", ".pi"}
+EXCLUDE_DIRS = {".git", "node_modules", ".cursor", ".gemini", ".pi", ".venv", "venv", ".tox", "__pycache__", "site-packages", ".mypy_cache", ".pytest_cache", ".ruff_cache"}
 EXCLUDE_PREFIXES = ("specs/archive/", "specs/codebase-wiki/")
 
 def _is_excluded(rel_path: str) -> bool:
@@ -362,6 +281,11 @@ for s in matrix_stories:
 # 8. Strict mode
 # -----------------------------------------------------------------------
 if STRICT:
+    # Floor assertion — anti-vacuity guard: if story count drops below baseline
+    # the matrix is degenerate and --strict must fail open.
+    if len(stories) < _MIN_STORY_BASELINE:
+        print(f"trace-stories.py: STRICT FAIL — story count {len(stories)} below baseline {_MIN_STORY_BASELINE}", file=sys.stderr)
+        sys.exit(2)
     if matrix_stories:
         wsjf_sorted = sorted(set(s["wsjf"] for s in matrix_stories), reverse=True)
         cutoff_idx = max(0, len(wsjf_sorted) // 4 - 1)

package/scripts/run-golden-suite.sh

@@ -34,6 +34,7 @@ GATES=(
   "g07-negative-path:bash scripts/golden-g07-negative-path.sh:false"
   "g08-anti-vacuity:bash scripts/golden-g08-anti-vacuity.sh:false"
   "g09-yaml-roundtrip:bash scripts/golden-g09-yaml-roundtrip.sh:false"
+  "g10-trace-anti-vacuity:bash scripts/golden-g10-trace-anti-vacuity.sh:false"
   "specs-parse:bash scripts/validate-specs-yaml.sh:false"
 )