bigpowers 2.47.0 → 2.49.0

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.47.0",
+  "version": "2.49.0",
   "description": "72 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,22 @@
+# [2.49.0](https://github.com/danielvm-git/bigpowers/compare/v2.48.0...v2.49.0) (2026-07-03)
+
+
+### Features
+
+* **e31:** golden suite runner — deterministic gate orchestrator ([#45](https://github.com/danielvm-git/bigpowers/issues/45)) ([e59ad3d](https://github.com/danielvm-git/bigpowers/commit/e59ad3d2d467c82bb9bf7517b8f07b897d7deb4b))
+
+# [2.48.0](https://github.com/danielvm-git/bigpowers/compare/v2.47.0...v2.48.0) (2026-07-03)
+
+
+### Bug Fixes
+
+* **e31:** rename pass/fail to g04_pass/g04_fail to avoid symbol collision ([34d0ce8](https://github.com/danielvm-git/bigpowers/commit/34d0ce89c4a26915786bd9b45379e7f2c289cc06))
+
+
+### Features
+
+* **e31:** wire npm run compliance as pre-release CI gate ([#44](https://github.com/danielvm-git/bigpowers/issues/44)) ([cd40e33](https://github.com/danielvm-git/bigpowers/commit/cd40e3305a568f429c9221dd9cc360ee7139626d))
+
 # [2.47.0](https://github.com/danielvm-git/bigpowers/compare/v2.46.0...v2.47.0) (2026-07-03)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.47.0",
+  "version": "2.49.0",
   "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-g04-selftest.sh

@@ -19,8 +19,8 @@ NC='\033[0m' # No Color
 PASS=0
 FAIL=0
 
-pass()  { echo -e "${GREEN}PASS${NC} $*"; PASS=$((PASS + 1)); }
-fail()  { echo -e "${RED}FAIL${NC} $*"; FAIL=$((FAIL + 1)); }
+g04_pass()  { echo -e "${GREEN}PASS${NC} $*"; PASS=$((PASS + 1)); }
+g04_fail()  { echo -e "${RED}FAIL${NC} $*"; FAIL=$((FAIL + 1)); }
 
 # ── Task 1: Target directory existence ────────────────────────────────
 
@@ -32,9 +32,9 @@ TARGETS=(
 
 for dir in "${TARGETS[@]}"; do
   if [[ -d "$dir" ]]; then
-    pass "directory exists: $dir"
+    g04_pass "directory exists: $dir"
   else
-    fail "directory not found: $dir"
+    g04_fail "directory not found: $dir"
   fi
 done
 
@@ -51,7 +51,7 @@ check_count() {
   local pattern="${3:-*.md}"
 
   if [[ ! -d "$dir" ]]; then
-    fail "$label: directory not found (skipping count)"
+    g04_fail "$label: directory not found (skipping count)"
     return
   fi
 
@@ -65,9 +65,9 @@ check_count() {
   fi
 
   if [[ "$count" -eq "$EXPECTED" ]]; then
-    pass "$label: $count artifacts (expected $EXPECTED)"
+    g04_pass "$label: $count artifacts (expected $EXPECTED)"
   else
-    fail "$label: expected $EXPECTED artifacts, got $count"
+    g04_fail "$label: expected $EXPECTED artifacts, got $count"
   fi
 }
 
@@ -81,7 +81,7 @@ LOCKFILE="skills-lock.json"
 INDEXFILE="SKILL-INDEX.md"
 
 if [[ ! -f "$LOCKFILE" ]]; then
-  fail "lockfile not found: $LOCKFILE"
+  g04_fail "lockfile not found: $LOCKFILE"
 else
   # Parse lockfile: count top-level keys (skill names)
   if command -v jq &>/dev/null; then
@@ -99,20 +99,20 @@ else
 fi
 
 if [[ ! -f "$INDEXFILE" ]]; then
-  fail "index not found: $INDEXFILE"
+  g04_fail "index not found: $INDEXFILE"
 else
   # Count skill entries from SKILL-INDEX.md header (e.g., "**Skills:** 72")
   index_count=$(grep '\*\*Skills:\*\*' "$INDEXFILE" 2>/dev/null | sed 's/.*\*\*Skills:\*\*[[:space:]]*//' | grep -oE '[0-9]+') || {
-    fail "index parse error: $INDEXFILE"
+    g04_fail "index parse error: $INDEXFILE"
     index_count=""
   }
 fi
 
 if [[ -n "${lock_count:-}" && -n "${index_count:-}" ]]; then
   if [[ "$lock_count" -eq "$index_count" ]]; then
-    pass "lockfile ($lock_count) matches SKILL-INDEX ($index_count)"
+    g04_pass "lockfile ($lock_count) matches SKILL-INDEX ($index_count)"
   else
-    fail "lockfile ($lock_count) != SKILL-INDEX ($index_count)"
+    g04_fail "lockfile ($lock_count) != SKILL-INDEX ($index_count)"
   fi
 fi
 

package/scripts/run-golden-suite.sh

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# run-golden-suite.sh — Deterministic golden suite runner
+#
+# Runs compliance → G-04 self-test in order, captures results,
+# writes timestamped YAML report. Supports --dry-run and --baseline.
+#
+# Usage:
+#   bash scripts/run-golden-suite.sh              # run all gates
+#   bash scripts/run-golden-suite.sh --dry-run    # print plan only
+#   bash scripts/run-golden-suite.sh --baseline   # run + pin baseline
+
+set -euo pipefail
+
+REPORT_DIR="specs/benchmarks/reports"
+BASELINE_FILE="$REPORT_DIR/BASELINE-GOLDEN.yaml"
+DRY_RUN=false
+BASELINE_MODE=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run) DRY_RUN=true ;;
+    --baseline) BASELINE_MODE=true ;;
+    *) echo "Unknown flag: $arg"; echo "Usage: run-golden-suite.sh [--dry-run] [--baseline]"; exit 2 ;;
+  esac
+done
+
+# ── Gate definitions ──────────────────────────────────────────────────
+# Each gate: name, command, optional: true (won't fail suite if missing)
+GATES=(
+  "compliance:npm run compliance:false"
+  "g04-selftest:bash scripts/golden-g04-selftest.sh:true"
+)
+
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[0;33m'
+NC='\033[0m'
+
+# ── Dry run ───────────────────────────────────────────────────────────
+
+if $DRY_RUN; then
+  echo "Golden Suite — DRY RUN"
+  echo "Gates (in order):"
+  for gate in "${GATES[@]}"; do
+    IFS=':' read -r name cmd optional <<< "$gate"
+    echo "  - $name: $cmd"
+  done
+  echo "Report: $REPORT_DIR/GOLDEN-YYYY-MM-DD.yaml"
+  echo "OK (dry run)"
+  exit 0
+fi
+
+# ── Setup ─────────────────────────────────────────────────────────────
+
+mkdir -p "$REPORT_DIR"
+
+TODAY=$(date +%Y-%m-%d)
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+GIT_COMMIT=$(git rev-parse HEAD 2>/dev/null || echo "unknown")
+
+if $BASELINE_MODE; then
+  REPORT_FILE="$BASELINE_FILE"
+else
+  REPORT_FILE="$REPORT_DIR/GOLDEN-${TODAY}.yaml"
+fi
+
+# ── Run gates ─────────────────────────────────────────────────────────
+
+PASS_COUNT=0
+FAIL_COUNT=0
+SKIP_COUNT=0
+GATE_RESULTS=()
+
+for gate in "${GATES[@]}"; do
+  IFS=':' read -r name cmd is_optional <<< "$gate"
+
+  echo -n "[$name] "
+
+  # Check if command exists (for scripts)
+  main_cmd=$(echo "$cmd" | awk '{print $1}')
+  if [[ "$main_cmd" == "bash" ]]; then
+    script_path=$(echo "$cmd" | awk '{print $2}')
+    if [[ ! -f "$script_path" ]]; then
+      if [[ "$is_optional" == "true" ]]; then
+        echo -e "${YELLOW}SKIP${NC} (script not yet implemented)"
+        GATE_RESULTS+=("  - name: $name")
+        GATE_RESULTS+=("    exit_code: skipped")
+        GATE_RESULTS+=("    duration_seconds: 0")
+        GATE_RESULTS+=("    status: skipped")
+        GATE_RESULTS+=("    note: script not found: $script_path")
+        (( SKIP_COUNT += 1 ))
+        continue
+      else
+        echo -e "${RED}FAIL${NC} (script not found: $script_path)"
+        GATE_RESULTS+=("  - name: $name")
+        GATE_RESULTS+=("    exit_code: 127")
+        GATE_RESULTS+=("    duration_seconds: 0")
+        GATE_RESULTS+=("    status: fail")
+        GATE_RESULTS+=("    error: script not found: $script_path")
+        (( FAIL_COUNT += 1 ))
+        continue
+      fi
+    fi
+  fi
+
+  # Run the gate and capture output
+  START_TIME=$(date +%s%N)
+  GATE_OUTPUT=$(eval "$cmd" 2>&1) && GATE_EXIT=$? || GATE_EXIT=$?
+  END_TIME=$(date +%s%N)
+  DURATION_MS=$(( (END_TIME - START_TIME) / 1000000 ))
+  DURATION_SEC=$(echo "scale=2; $DURATION_MS / 1000" | bc 2>/dev/null || echo "0")
+
+  if [[ "$GATE_EXIT" -eq 0 ]]; then
+    echo -e "${GREEN}PASS${NC} (${DURATION_SEC}s)"
+    GATE_RESULTS+=("  - name: $name")
+    GATE_RESULTS+=("    exit_code: 0")
+    GATE_RESULTS+=("    duration_seconds: $DURATION_SEC")
+    GATE_RESULTS+=("    status: pass")
+    (( PASS_COUNT += 1 ))
+  else
+    echo -e "${RED}FAIL${NC} (${DURATION_SEC}s, exit $GATE_EXIT)"
+    GATE_RESULTS+=("  - name: $name")
+    GATE_RESULTS+=("    exit_code: $GATE_EXIT")
+    GATE_RESULTS+=("    duration_seconds: $DURATION_SEC")
+    GATE_RESULTS+=("    status: fail")
+    (( FAIL_COUNT += 1 ))
+  fi
+done
+
+# ── Summary ───────────────────────────────────────────────────────────
+
+TOTAL=$((PASS_COUNT + FAIL_COUNT + SKIP_COUNT))
+if [[ "$FAIL_COUNT" -gt 0 ]]; then
+  OVERALL="fail"
+else
+  OVERALL="pass"
+fi
+
+echo ""
+echo "──────────────────────────────────────────"
+echo -e "Suite: ${PASS_COUNT}/${TOTAL} passed"
+if [[ "$SKIP_COUNT" -gt 0 ]]; then
+  echo -e "       ${SKIP_COUNT} skipped (scripts not yet implemented)"
+fi
+echo -e "Overall: ${OVERALL}"
+echo "Report: $REPORT_FILE"
+echo "──────────────────────────────────────────"
+
+# ── Write report ──────────────────────────────────────────────────────
+
+PASS_RATE=$(echo "scale=2; $PASS_COUNT / $TOTAL" | bc 2>/dev/null || echo "0")
+
+cat > "$REPORT_FILE" << YAML_EOF
+timestamp: "$TIMESTAMP"
+git_commit: "$GIT_COMMIT"
+suite: "golden-deterministic"
+mode: "$([ "$BASELINE_MODE" = true ] && echo 'baseline' || echo 'daily')"
+gates:
+$(printf '%s\n' "${GATE_RESULTS[@]}")
+summary:
+  total: $TOTAL
+  passed: $PASS_COUNT
+  failed: $FAIL_COUNT
+  skipped: $SKIP_COUNT
+  pass_rate: $PASS_RATE
+  overall: "$OVERALL"
+YAML_EOF
+
+# ── Size budget (placeholder for e31s04) ──────────────────────────────
+
+if $BASELINE_MODE; then
+  echo "" >> "$REPORT_FILE"
+  echo "# Skill byte counts (baseline for e31s04 size budget)" >> "$REPORT_FILE"
+  echo "skill_sizes:" >> "$REPORT_FILE"
+  for skill_md in skills/*/SKILL.md; do
+    skill_name=$(basename "$(dirname "$skill_md")")
+    skill_bytes=$(wc -c < "$skill_md" | tr -d ' ')
+    echo "  $skill_name: $skill_bytes" >> "$REPORT_FILE"
+  done
+  echo "Baseline pinned: $REPORT_FILE"
+fi
+
+if [[ "$OVERALL" == "fail" ]]; then
+  exit 1
+fi
+exit 0