bigpowers 2.80.0 → 2.81.0

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.80.0",
+  "version": "2.81.0",
   "description": "80 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,10 @@
+# [2.81.0](https://github.com/danielvm-git/bigpowers/compare/v2.80.0...v2.81.0) (2026-07-23)
+
+
+### Features
+
+* **e54s02:** advisory catalog drift-detection gate ([7761f75](https://github.com/danielvm-git/bigpowers/commit/7761f75ed2312d419f3e28f192385304e36e83f2))
+
 # [2.80.0](https://github.com/danielvm-git/bigpowers/compare/v2.79.1...v2.80.0) (2026-07-23)
 
 

package/CLAUDE.md

@@ -65,7 +65,7 @@ Stack: Markdown / Bash (documentation-based; skills integrate with Claude Code,
 | Compliance | `npm run compliance` |
 | Verification Gates | `bash scripts/run-verification-gates.sh` |
 | Traceability | `bash scripts/trace-stories.sh --strict` | grep for story tags (traceability check) |
-| Preflight | `npm run compliance && bash scripts/run-verification-gates.sh && bash scripts/sync-skills.sh && bash scripts/trace-stories.sh --strict` | Full local green stack before forward work |
+| Preflight | `npm run compliance && bash scripts/run-verification-gates.sh && bash scripts/sync-skills.sh && bash scripts/trace-stories.sh --strict && bash scripts/check-catalog-drift.sh` | Full local green stack before forward work. Trailing step is advisory only (e54s02 catalog-freeze drift check) — it always exits 0 and can never break this chain. |
 | CI | `gh pr checks` | Remote CI green when a PR is open |
 
 ### Pre-Merge Checklist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.80.0",
+  "version": "2.81.0",
   "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-catalog-drift.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# story: e54s02
+# check-catalog-drift.sh — advisory (Confirm-gate) diff of the live skill
+# catalog against e54s01's frozen baseline. ALWAYS exits 0: this warns during
+# the freeze window, it never blocks Preflight (never add to GOLDEN_GATES).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/lib/skill-common.sh"
+source "$SCRIPT_DIR/lib/python-env.sh"
+
+resolve_repo_root
+cd "$REPO_ROOT"
+
+BASELINE="$(ls -1 "$REPO_ROOT"/specs/tech-architecture/CATALOG-BASELINE-*.yaml 2>/dev/null | sort | tail -1 || true)"
+
+if [[ -z "$BASELINE" ]]; then
+  echo "no baseline found, skipping drift check"
+  exit 0
+fi
+
+"$PYTHON" - "$BASELINE" "$SKILLS_ROOT" <<'PY'
+import sys, glob, os, re
+import yaml
+
+baseline_path, skills_root = sys.argv[1], sys.argv[2]
+baseline = yaml.safe_load(open(baseline_path)) or {}
+base_by_name = {s["name"]: s for s in baseline.get("skills") or []}
+
+EXCEPTION_MARKER = "freeze-exception"
+
+def has_exception(skill_md):
+    if not os.path.isfile(skill_md):
+        return False
+    with open(skill_md, encoding="utf-8") as f:
+        return EXCEPTION_MARKER in f.read()
+
+def parse_live(skill_md):
+    text = open(skill_md, encoding="utf-8").read()
+    fm = re.search(r"^---\n(.*?)\n---", text, re.S | re.M)
+    fields = {}
+    if fm:
+        for line in fm.group(1).splitlines():
+            m = re.match(r"^(phase|effort|model):\s*(.+)$", line)
+            if m:
+                fields[m.group(1)] = m.group(2).strip()
+    return fields
+
+live_by_name = {}
+for skill_md in sorted(glob.glob(os.path.join(skills_root, "*", "SKILL.md"))):
+    name = os.path.basename(os.path.dirname(skill_md))
+    live_by_name[name] = {"path": skill_md, **parse_live(skill_md)}
+
+warnings = []
+
+for name, live in live_by_name.items():
+    if name not in base_by_name:
+        if not has_exception(live["path"]):
+            warnings.append(f"WARNING: addition — new skill '{name}' not in frozen baseline")
+        continue
+    base = base_by_name[name]
+    for field in ("phase", "effort", "model"):
+        base_val = base.get(field)
+        base_val = None if base_val in ("null", None) else str(base_val)
+        live_val = live.get(field)
+        if base_val != live_val:
+            if not has_exception(live["path"]):
+                warnings.append(
+                    f"WARNING: structural change — '{name}' field '{field}' "
+                    f"changed from {base_val!r} to {live_val!r}"
+                )
+
+for name, base in base_by_name.items():
+    if name not in live_by_name:
+        warnings.append(f"WARNING: removal — skill '{name}' present in baseline but missing from live catalog")
+
+for w in warnings:
+    print(w)
+PY
+
+exit 0