bigpowers 2.76.1 → 2.76.2

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.76.1",
+  "version": "2.76.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.76.2](https://github.com/danielvm-git/bigpowers/compare/v2.76.1...v2.76.2) (2026-07-09)
+
+
+### Bug Fixes
+
+* **ci:** add orphan gitlink guard to prevent checkout failures ([#70](https://github.com/danielvm-git/bigpowers/issues/70)) ([4325ae9](https://github.com/danielvm-git/bigpowers/commit/4325ae9fd853defbb37d63c41317278b8882a6be))
+
 ## [2.76.1](https://github.com/danielvm-git/bigpowers/compare/v2.76.0...v2.76.1) (2026-07-09)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.76.1",
+  "version": "2.76.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/lib/check-orphan-gitlinks.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# check-orphan-gitlinks.sh — fail if git index has gitlinks without .gitmodules URLs
+# story: BUG-2026-07-09T033939-golden-g01-submodule-checkout
+set -euo pipefail
+
+check_orphan_gitlinks() {
+  local repo_root="${1:-.}"
+  local gitlinks orphans=0
+
+  cd "$repo_root"
+
+  while IFS= read -r path; do
+    [[ -z "$path" ]] && continue
+    if [[ ! -f .gitmodules ]] || ! git config -f .gitmodules --get "submodule.${path}.url" >/dev/null 2>&1; then
+      gitlinks+=("$path")
+      orphans=$((orphans + 1))
+    fi
+  done < <(git ls-files -s | awk '$1 == "160000" { $1=$2=$3=""; sub(/^ /, ""); print }')
+
+  if [[ "$orphans" -eq 0 ]]; then
+    echo "no orphan gitlinks"
+    return 0
+  fi
+
+  echo "orphan gitlink(s) without .gitmodules URL:" >&2
+  printf '  %s\n' "${gitlinks[@]}" >&2
+  return 1
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  check_orphan_gitlinks "$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+fi

package/scripts/validate-doctrine.sh

@@ -137,6 +137,17 @@ else
   done
 fi
 
+# ── CI: orphan gitlinks break actions/checkout submodule cleanup ───────────────
+echo "--- [CI] orphan gitlinks ---"
+# shellcheck source=lib/check-orphan-gitlinks.sh
+source "$REPO_ROOT/scripts/lib/check-orphan-gitlinks.sh"
+if check_orphan_gitlinks "$REPO_ROOT" >/dev/null; then
+  doctrine_pass "no orphan gitlinks"
+else
+  doctrine_fail "git index contains gitlink(s) without .gitmodules URL — breaks actions/checkout"
+  check_orphan_gitlinks "$REPO_ROOT" >&2 || true
+fi
+
 # ── CI: trace-stories wrapper smoke (REPO_ROOT must be set under set -u) ───────
 echo "--- [CI] trace-stories wrapper smoke ---"
 if bash "$REPO_ROOT/scripts/trace-stories.sh" --help >/dev/null 2>&1; then

package/tests/test-no-orphan-gitlinks.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# story: BUG-2026-07-09T033939-golden-g01-submodule-checkout
+# Regression: orphan gitlinks (160000) without .gitmodules URLs break actions/checkout.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# shellcheck source=../scripts/lib/check-orphan-gitlinks.sh
+source "$REPO_ROOT/scripts/lib/check-orphan-gitlinks.sh"
+
+# Clean tree must pass.
+if ! output="$(check_orphan_gitlinks "$REPO_ROOT")"; then
+  echo "FAIL: check_orphan_gitlinks failed on clean tree"
+  exit 1
+fi
+if [[ "$output" != "no orphan gitlinks" ]]; then
+  echo "FAIL: unexpected output: $output"
+  exit 1
+fi
+
+# Synthetic orphan: gitlink path with no .gitmodules entry must fail.
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+git -C "$tmpdir" init -q
+git -C "$tmpdir" config user.email "test@example.com"
+git -C "$tmpdir" config user.name "test"
+mkdir -p "$tmpdir/sub"
+echo "nested" >"$tmpdir/sub/file.txt"
+git -C "$tmpdir/sub" init -q
+git -C "$tmpdir/sub" add file.txt
+git -C "$tmpdir/sub" commit -qm "nested"
+git -C "$tmpdir" add sub
+if ! check_orphan_gitlinks "$tmpdir" >/dev/null 2>&1; then
+  echo "PASS: synthetic orphan gitlink correctly rejected"
+  exit 0
+fi
+
+echo "FAIL: check_orphan_gitlinks should reject orphan gitlink in synthetic repo"
+exit 1