bigpowers 2.73.0 → 2.73.2

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.73.0",
+  "version": "2.73.2",
   "description": "75 skills — 73 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.73.2](https://github.com/danielvm-git/bigpowers/compare/v2.73.1...v2.73.2) (2026-07-06)
+
+
+### Bug Fixes
+
+* **ci:** close BUG-2026-07-04-python-interpreter-fragility — python-env.sh resolver verified ([1f4fd30](https://github.com/danielvm-git/bigpowers/commit/1f4fd301f9ec19b2eb60100d43d79ac57891bed6))
+
+## [2.73.1](https://github.com/danielvm-git/bigpowers/compare/v2.73.0...v2.73.1) (2026-07-06)
+
+
+### Bug Fixes
+
+* **ci:** skip unimplemented P0 stories in trace --strict gate ([e7a56bf](https://github.com/danielvm-git/bigpowers/commit/e7a56bfd94d5dbebf0f7736383e2c381016616b9))
+
 # [2.73.0](https://github.com/danielvm-git/bigpowers/compare/v2.72.1...v2.73.0) (2026-07-06)
 
 

package/audit-independent-unwaived-2026-07-06.md

@@ -0,0 +1,49 @@
+# Independent Compliance Audit (Unwaived Mode)
+
+**Date**: 2026-07-06
+**Mode**: Strict (All waivers disabled)
+**Target**: `specs/verifications/features/`
+**Result**: GATE: FAIL
+
+## Summary of Execution
+I executed the verification gates by temporarily bypassing `waivers.yaml` to run an independent compliance audit against the `bigpowers` principles and conventions without any exceptions. The `audit-compliance.sh` and `validate-doctrine.sh` scripts were successfully executed.
+
+## Failed Verification Steps & Offending Scripts
+
+By disabling the waivers, I isolated **4 failing verification steps**. Below is the mapping of each failure to its offending files and corresponding `bigpowers` skills:
+
+### 1. Unique Public Symbols (`grep` < 5 results)
+**Feature**: `akita.feature` (sourced from `conventions.feature`)
+- **Reason**: Duplicate function names across multiple files (e.g., `agent_dry_run`, `assign_tier`, `cleanup`, `emit_json`, `fail`, `parse_frontmatter`, `pass`, `show_help`, `usage`). 
+- **Affected Core/Skills**: Common shared scripts and lifecycle utilities.
+
+### 2. Context Window Constraint (< 300 lines)
+**Feature**: `akita.feature`
+- **Reason**: Scripts exceeding the 300-line limit for agent context windows.
+- **Offending Files**:
+  - `scripts/sync-skills.sh` (Mapped to: `craft-skill`, `evolve-skill`, `maintain-wiki`)
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/run-verification-gates.sh` (Core harness)
+  - `scripts/validate-okf.sh` (Core harness)
+  - `scripts/audit-compliance.sh` (Core harness / `audit-code`)
+  - `scripts/run-golden-suite.sh` (Core harness)
+  - `scripts/lib/trace-matrix.py` (Mapped to: `gate-trace`)
+  - `scripts/lib/trace-stories.py` (Mapped to: `trace-requirement`)
+
+### 3. Newspaper Metaphor (< 500 lines)
+**Feature**: `cleancode.feature`
+- **Reason**: Critical scripts exceeding the absolute 500-line hard cap.
+- **Offending Files**:
+  - `scripts/sync-skills.sh` (Mapped to: `craft-skill`, `evolve-skill`)
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/lib/trace-matrix.py` (Mapped to: `gate-trace`)
+
+### 4. Boolean Encapsulation (G28)
+**Feature**: `cleancode.feature`
+- **Reason**: Complex, multi-clause bash conditional logic not encapsulated in named functions.
+- **Offending Files**:
+  - `scripts/migrate-version.sh` (Mapped to: `migrate-spec`)
+  - `scripts/check-spec-version-gap.sh` (Mapped to: `plan-release`)
+
+## Restoration
+After the test run concluded, the original `waivers.yaml` was restored to preserve environment integrity. No actual code modifications were made.

package/package.json

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

package/scripts/check-blind-spots.sh

@@ -11,6 +11,9 @@
 
 set -euo pipefail
 source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
+source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
+
 
 BLIND_SPOTS_JSON="$REPO_ROOT/specs/blind-spots.json"
 EXEC_STATUS="$REPO_ROOT/specs/execution-status.yaml"

package/scripts/lib/trace-stories.py

@@ -30,6 +30,7 @@ MODE = sys.argv[6]
 # 1. Parse YAML files → story inventory
 # -----------------------------------------------------------------------
 _MIN_STORY_BASELINE = 50  # floor assertion: --strict FAILs if story count drops below this
+_STRICT_UNIMPLEMENTED_STATUSES = frozenset({"backlog", "todo", "planned"})
 
 def _load_yaml(path: Path) -> dict:
     """Load a YAML file with PyYAML. Exits with code 1 if parse fails."""
@@ -290,10 +291,10 @@ if STRICT:
         wsjf_sorted = sorted(set(s["wsjf"] for s in matrix_stories), reverse=True)
         cutoff_idx = max(0, len(wsjf_sorted) // 4 - 1)
         p0_threshold = wsjf_sorted[cutoff_idx] if cutoff_idx < len(wsjf_sorted) else 0
-        # Only flag non-backlog stories — backlog stories haven't been implemented yet
+        # Only flag stories expected to have implementation — skip backlog/todo/planned
         uncovered_p0 = [s["id"] for s in matrix_stories
             if s["wsjf"] >= p0_threshold and len(s["links"]) == 0
-            and s["status"] != "backlog"]
+            and s["status"] not in _STRICT_UNIMPLEMENTED_STATUSES]
         if uncovered_p0:
             print(f"trace-stories.sh: STRICT FAIL — P0 stories with 0% coverage: {', '.join(uncovered_p0)}", file=sys.stderr)
             sys.exit(2)

package/scripts/sync-bugs-registry.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
-# story: e45s03
 # sync-bugs-registry.sh — rebuild specs/bugs/registry.yaml + OKF concept bundles
 set -euo pipefail
 source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
 source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
 BUGS="$REPO_ROOT/specs/bugs"
 mkdir -p "$BUGS"
 
@@ -18,6 +18,8 @@ repo_root = Path(sys.argv[2])
 # ---- Phase 1: Build registry.yaml ----
 entries = []
 for path in sorted(bugs_dir.glob("BUG-*.md")):
+    if ".okf" in path.name:
+        continue
     text = path.read_text(encoding="utf-8")
     if not text.startswith("---"):
         continue

package/scripts/test-trace-strict.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# test-trace-strict.sh — strict mode must not block unimplemented P0 stories
+#
+# Covers BUG-2026-07-06T205700:
+#   - todo/planned/backlog P0 stories with 0 links do not fail --strict
+#   - done P0 stories with 0 links still fail --strict
+#
+# Usage: bash scripts/test-trace-strict.sh
+
+set -euo pipefail
+source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
+source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
+resolve_repo_root
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+TRACE_ENGINE="$REPO_ROOT/scripts/lib/trace-stories.py"
+FAILURES=0
+
+pass() { echo -e "${GREEN}PASS${NC} $1"; }
+fail() { echo -e "${RED}FAIL${NC} $1"; FAILURES=$((FAILURES + 1)); }
+
+run_strict() {
+  local root="$1"
+  local matrix_json
+  local trace_md
+  local okf_dir
+  matrix_json=$(mktemp)
+  trace_md=$(mktemp)
+  okf_dir=$(mktemp -d)
+  set +e
+  local output
+  output=$($PYTHON "$TRACE_ENGINE" "$root" "$matrix_json" "$trace_md" "$okf_dir" 1 "" 2>&1)
+  local exit_code=$?
+  set -e
+  rm -f "$matrix_json" "$trace_md"
+  rm -rf "$okf_dir"
+  printf '%s\n' "$output"
+  return "$exit_code"
+}
+
+write_fixture() {
+  local root="$1"
+  local done_story="${2:-}"
+
+  mkdir -p "$root/specs/epics/e99-test"
+  cat >"$root/specs/release-plan.yaml" <<'EOF'
+release:
+  version: "1.0.0"
+  codename: "Strict Test"
+  status: "proposed"
+epics:
+  - id: e99
+    title: "Strict Test Epic"
+    wsjf: 5.0
+    bcps: 51
+    mode: capsule
+    status: proposed
+    capsule_dir: epics/e99-test
+EOF
+
+  {
+    echo "stories:"
+    for i in $(seq 1 51); do
+      sid=$(printf 'e99s%02d' "$i")
+      printf '  - id: %s\n    title: "Story %d"\n    bcp: 1\n' "$sid" "$i"
+    done
+  } >"$root/specs/epics/e99-test/epic.yaml"
+
+  {
+    echo "development_status:"
+    for i in $(seq 1 51); do
+      sid=$(printf 'e99s%02d' "$i")
+      if [[ -n "$done_story" && "$sid" == "$done_story" ]]; then
+        echo "  $sid: done"
+      else
+        echo "  $sid: todo"
+      fi
+    done
+  } >"$root/specs/execution-status.yaml"
+}
+
+echo "=== trace-strict: integration (real repo) ==="
+set +e
+bash "$REPO_ROOT/scripts/trace-stories.sh" --strict --json >/dev/null 2>&1
+repo_exit=$?
+set -e
+if [[ $repo_exit -eq 0 ]]; then
+  pass "trace-stories.sh --strict exits 0 on repo"
+else
+  fail "trace-stories.sh --strict exits $repo_exit on repo (expected 0)"
+fi
+
+echo ""
+echo "=== trace-strict: fixture — all todo P0, 0 links ==="
+FIXTURE_ROOT=$(mktemp -d)
+trap 'rm -rf "$FIXTURE_ROOT"' EXIT
+write_fixture "$FIXTURE_ROOT"
+set +e
+todo_output=$(run_strict "$FIXTURE_ROOT")
+todo_exit=$?
+set -e
+if [[ $todo_exit -eq 0 ]]; then
+  pass "strict passes when P0 stories are todo with 0 links"
+else
+  fail "strict exits $todo_exit on all-todo fixture (expected 0)"
+  echo "$todo_output"
+fi
+
+echo ""
+echo "=== trace-strict: fixture — done P0 with 0 links ==="
+write_fixture "$FIXTURE_ROOT" "e99s01"
+set +e
+done_output=$(run_strict "$FIXTURE_ROOT")
+done_exit=$?
+set -e
+if [[ $done_exit -eq 2 ]] && grep -q "P0 stories with 0% coverage" <<<"$done_output"; then
+  pass "strict fails when a done P0 story has 0 links"
+else
+  fail "strict exits $done_exit on done-dark fixture (expected 2 with P0 message)"
+  echo "$done_output"
+fi
+
+echo ""
+if [[ $FAILURES -eq 0 ]]; then
+  echo "test-trace-strict: PASS"
+  exit 0
+fi
+echo "test-trace-strict: FAIL ($FAILURES failure(s))"
+exit 1