bigpowers 2.75.1 → 2.75.2

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.75.1",
+  "version": "2.75.2",
   "description": "77 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.75.2](https://github.com/danielvm-git/bigpowers/compare/v2.75.1...v2.75.2) (2026-07-07)
+
+
+### Bug Fixes
+
+* **ci:** enforce blocking OKF validation and close bug audit gaps ([e502c62](https://github.com/danielvm-git/bigpowers/commit/e502c62583024df36bed086d8e44a871907632cd))
+
 ## [2.75.1](https://github.com/danielvm-git/bigpowers/compare/v2.75.0...v2.75.1) (2026-07-07)
 
 

package/bin/bigspec

@@ -1,2 +1,36 @@
 #!/usr/bin/env bash
-if [[ "$1" == "--with-wiki" ]]; then echo "wiki enabled"; fi
+# story: e48s10
+# bigspec — minimal project bootstrap helper
+
+print_wiki_setup() {
+  cat <<'EOF'
+Wiki publishing enabled.
+
+1. Create a GitHub Wiki for this repository (or use the .wiki.git remote).
+2. Configure CI secrets: WIKI_PAT (repo scope for wiki push).
+3. Set WIKI_REPO_URL to the wiki clone URL (e.g. https://github.com/org/repo.wiki.git).
+4. Dry-run locally: bash kernel/src/publish-to-wiki.sh --dry-run
+5. Publish on merge: .github/workflows/publish-wiki.yml (gates on validate-okf first).
+
+See docs/references/okf.md for OKF bundle layout and CI integration.
+EOF
+}
+
+case "${1:-}" in
+  init)
+    if [[ "${2:-}" == "--with-wiki" ]]; then
+      print_wiki_setup
+      exit 0
+    fi
+    echo "Usage: bigspec init [--with-wiki]"
+    exit 1
+    ;;
+  --with-wiki)
+    print_wiki_setup
+    exit 0
+    ;;
+  *)
+    echo "Usage: bigspec init [--with-wiki]"
+    exit 1
+    ;;
+esac

package/kernel/src/publish-to-wiki.sh

@@ -3,23 +3,138 @@
 # publish-to-wiki.sh — publish OKF bundles to a .wiki.git repository
 set -euo pipefail
 
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+HEADER="$ROOT/kernel/templates/wiki/header.md"
+EPICS_SRC="$ROOT/specs/epics-wiki"
+ADR_SRC="$ROOT/specs/adr-wiki"
+
 usage() {
   echo "Usage: $0 [--dry-run]"
-  echo "Publishes OKF concept bundles from specs/epics-wiki and specs/adr-wiki to the configured .wiki.git repository, rewriting links to wiki slug format."
+  echo "Publishes OKF concept bundles from specs/epics-wiki and specs/adr-wiki"
+  echo "to the configured wiki git repository, rewriting links to wiki slug format."
   exit 0
 }
 
-if [[ "${1:-}" == "--help" ]]; then
+wiki_slug_from_file() {
+  local base
+  base="$(basename "$1")"
+  base="${base%.okf.md}"
+  base="${base%.md}"
+  echo "$base"
+}
+
+rewrite_links() {
+  sed -E \
+    -e 's/\]\(([^)]*)\.okf\.md\)/](\1)/g' \
+    -e 's/\]\(([^)]*)\.md\)/](\1)/g' \
+    -e 's/\]\(specs\/[^)]+\/([^/)]+)\)/](\1)/g'
+}
+
+stage_bundle() {
+  local src="$1" section="$2" dest_root="$3"
+  local slug dest_dir dest_file
+  slug="$(wiki_slug_from_file "$src")"
+  dest_dir="$dest_root/$section"
+  dest_file="$dest_dir/${slug}.md"
+  mkdir -p "$dest_dir"
+  {
+    if [[ -f "$HEADER" ]]; then cat "$HEADER"; echo ""; fi
+    rewrite_links < "$src"
+  } > "$dest_file"
+  echo "$section/$slug.md"
+}
+
+collect_sources() {
+  local dir="$1"
+  if [[ -d "$dir" ]]; then
+    find "$dir" -maxdepth 1 -name '*.okf.md' -type f | sort
+  fi
+}
+
+publish_bundles() {
+  local dest_root="$1"
+  local -a pages=()
+  local src
+
+  rm -rf "$dest_root"
+  mkdir -p "$dest_root"
+
+  while IFS= read -r src; do
+    [[ -n "$src" ]] || continue
+    pages+=("$(stage_bundle "$src" "Epics" "$dest_root")")
+  done < <(collect_sources "$EPICS_SRC")
+
+  while IFS= read -r src; do
+    [[ -n "$src" ]] || continue
+    pages+=("$(stage_bundle "$src" "ADRs" "$dest_root")")
+  done < <(collect_sources "$ADR_SRC")
+
+  if [[ -f "$ROOT/kernel/templates/wiki/_Sidebar.md" ]]; then
+    cp "$ROOT/kernel/templates/wiki/_Sidebar.md" "$dest_root/_Sidebar.md"
+    pages+=("_Sidebar.md")
+  fi
+
+  printf '%s\n' "${pages[@]}"
+}
+
+push_to_wiki() {
+  local staged_root="$1"
+  local wiki_repo="${WIKI_REPO_URL:-}"
+  local work_dir="${WIKI_WORK_DIR:-}"
+
+  if [[ -z "$wiki_repo" ]]; then
+    echo "publish-to-wiki: WIKI_REPO_URL is not set — cannot push" >&2
+    return 1
+  fi
+
+  if [[ -z "$work_dir" ]]; then
+    work_dir="$(mktemp -d)"
+    trap 'rm -rf "$work_dir"' EXIT
+  fi
+
+  if [[ -d "$work_dir/.git" ]]; then
+    git -C "$work_dir" pull --rebase origin master 2>/dev/null || git -C "$work_dir" pull --rebase origin main
+  else
+    git clone "$wiki_repo" "$work_dir"
+  fi
+
+  rsync -a --delete "$staged_root/" "$work_dir/"
+  git -C "$work_dir" add -A
+  if git -C "$work_dir" diff --cached --quiet; then
+    echo "publish-to-wiki: no wiki changes to push"
+    return 0
+  fi
+  git -C "$work_dir" -c user.name="bigpowers-bot" -c user.email="bot@bigpowers.local" \
+    commit -m "chore(wiki): sync OKF bundles from main"
+  git -C "$work_dir" push origin HEAD
+}
+
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
   usage
 fi
 
 DRY_RUN=0
 if [[ "${1:-}" == "--dry-run" ]]; then
   DRY_RUN=1
-  echo "[Dry Run] Would publish OKF bundles to wiki."
+fi
+
+STAGING="$(mktemp -d)"
+trap 'rm -rf "$STAGING"' EXIT
+
+mapfile -t PAGES < <(publish_bundles "$STAGING")
+PAGE_COUNT="${#PAGES[@]}"
+
+if [[ "$PAGE_COUNT" -eq 0 ]]; then
+  echo "publish-to-wiki: no OKF bundles found under specs/epics-wiki or specs/adr-wiki" >&2
+  exit 1
+fi
+
+echo "publish-to-wiki: pages: $PAGE_COUNT"
+printf '  - %s\n' "${PAGES[@]}"
+
+if [[ "$DRY_RUN" -eq 1 ]]; then
+  echo "publish-to-wiki: dry-run complete (staged under $STAGING)"
   exit 0
 fi
 
-# Logic to map OKF kinds to wiki sections, render markdown, rewrite relative links, and push
-echo "publish-to-wiki: Rewriting links and publishing to wiki..."
-exit 0
+push_to_wiki "$STAGING"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.75.1",
+  "version": "2.75.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/generate-adr-wiki.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# story: e48s01
 # story: e45s01 e45s06
 # generate-adr-wiki.sh — emit OKF concept bundles from specs/adr/*.md
 set -euo pipefail

package/scripts/generate-epics-wiki.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# story: e48s01
 # story: e45s01 e45s06
 # generate-epics-wiki.sh — emit OKF concept bundles from specs/epics/*/epic.yaml
 set -euo pipefail

package/scripts/lib/validate-okf-kinds.sh

@@ -265,7 +265,7 @@ okf_scan_dir() {
       validate_bundle "$f"
       count=$((count + 1))
     fi
-  done < <(find "$dir" -maxdepth 1 -name '*.md' -print0 2>/dev/null || true)
+  done < <(find "$dir" -maxdepth 1 \( -name '*.okf.md' -o -name 'registry.okf.md' \) -print0 2>/dev/null || true)
   if [ "$count" -eq 0 ]; then
     printf "${YELLOW}SKIP${NC} no OKF bundles found in %s\n" "$dir"
   fi

package/scripts/sync-bugs-registry.sh

@@ -77,6 +77,7 @@ for e in entries:
     bundle = f"""---
 okf_kind: concept
 okf_version: "0.1"
+type: Bug
 id: "{bug_id}"
 title: "{title_escaped}"
 category: bug

package/tests/test-epic-status-drift.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# story: BUG-001
+# Regression test: epic.yaml status matches execution-status.yaml for completed epics
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+EXEC_STATUS="$REPO_ROOT/specs/execution-status.yaml"
+EPICS_ROOT="$REPO_ROOT/specs/epics"
+
+if [[ ! -f "$EXEC_STATUS" ]]; then
+  echo "FAIL: missing $EXEC_STATUS"
+  exit 1
+fi
+
+FAILURES=0
+
+while IFS= read -r line; do
+  [[ "$line" =~ ^[[:space:]]*(e[0-9]+):[[:space:]]*done[[:space:]]*$ ]] || continue
+  epic_id="${BASH_REMATCH[1]}"
+
+  # e37 is redesigned as Reach — execution-status may say done while capsule stays planned
+  [[ "$epic_id" == "e37" ]] && continue
+
+  epic_yaml=""
+  for candidate in \
+    "$EPICS_ROOT/$epic_id"*/epic.yaml \
+    "$EPICS_ROOT/archive/$epic_id"*/epic.yaml; do
+    if [[ -f "$candidate" ]]; then
+      epic_yaml="$candidate"
+      break
+    fi
+  done
+
+  if [[ -z "$epic_yaml" ]]; then
+    echo "WARN: no epic.yaml found for $epic_id (execution-status: done)"
+    continue
+  fi
+
+  yaml_status="$(grep -m1 '^status:' "$epic_yaml" | sed 's/^status:[[:space:]]*//' | tr -d '"')"
+  if [[ "$yaml_status" != "done" ]]; then
+    echo "FAIL: $epic_id epic.yaml status='$yaml_status' but execution-status.yaml says done ($epic_yaml)"
+    FAILURES=$((FAILURES + 1))
+  fi
+done < "$EXEC_STATUS"
+
+if [[ "$FAILURES" -gt 0 ]]; then
+  echo "FAIL: $FAILURES epic status drift(s)"
+  exit 1
+fi
+
+echo "PASS: epic.yaml status aligned with execution-status for completed epics"
+exit 0

package/tests/test-okf-generators.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# story: e48s01
+# story: e48s03
+# Regression tests for OKF bundle generators (e48 audit gap closure)
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "=== OKF generator regression tests ==="
+
+require_min_count() {
+  local dir="$1" min="$2" label="$3"
+  local count
+  count="$(find "$dir" -maxdepth 1 -name '*.okf.md' -type f 2>/dev/null | wc -l | tr -d ' ')"
+  if [[ "$count" -lt "$min" ]]; then
+    echo "FAIL: expected at least $min $label bundles in $dir, got $count"
+    exit 1
+  fi
+  echo "  $label: $count bundles"
+}
+
+echo "→ generate-epics-wiki.sh"
+bash "$REPO_ROOT/scripts/generate-epics-wiki.sh" >/dev/null
+require_min_count "$REPO_ROOT/specs/epics-wiki" 1 "epic"
+bash "$REPO_ROOT/scripts/validate-okf.sh" --dir "$REPO_ROOT/specs/epics-wiki"
+
+if ! grep -q '^tier:' "$REPO_ROOT/specs/epics-wiki/e48.okf.md"; then
+  echo "FAIL: e48.okf.md missing tier: field (e48s06)"
+  exit 1
+fi
+
+echo "→ generate-adr-wiki.sh"
+bash "$REPO_ROOT/scripts/generate-adr-wiki.sh" >/dev/null
+require_min_count "$REPO_ROOT/specs/adr-wiki" 1 "adr"
+bash "$REPO_ROOT/scripts/validate-okf.sh" --dir "$REPO_ROOT/specs/adr-wiki"
+
+echo "→ sync-bugs-registry.sh"
+bash "$REPO_ROOT/scripts/sync-bugs-registry.sh" >/dev/null
+require_min_count "$REPO_ROOT/specs/bugs" 1 "bug"
+bash "$REPO_ROOT/scripts/validate-okf.sh" --dir "$REPO_ROOT/specs/bugs"
+
+echo "→ publish-to-wiki.sh --dry-run"
+OUTPUT="$(bash "$REPO_ROOT/kernel/src/publish-to-wiki.sh" --dry-run)"
+if [[ "$OUTPUT" != *"pages:"* ]]; then
+  echo "FAIL: publish-to-wiki dry-run missing page manifest"
+  echo "$OUTPUT"
+  exit 1
+fi
+
+echo "PASS: OKF generators and publish-to-wiki dry-run"
+exit 0