bigpowers 2.83.0 → 2.83.2

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.83.0",
+  "version": "2.83.2",
   "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,17 @@
+## [2.83.2](https://github.com/danielvm-git/bigpowers/compare/v2.83.1...v2.83.2) (2026-07-24)
+
+
+### Bug Fixes
+
+* **install:** stop setup from running dev-maintenance regen ([2d89ee2](https://github.com/danielvm-git/bigpowers/commit/2d89ee26a71b9004cf69ad25ce55a9f5b0699018))
+
+## [2.83.1](https://github.com/danielvm-git/bigpowers/compare/v2.83.0...v2.83.1) (2026-07-24)
+
+
+### Bug Fixes
+
+* **install:** resolve EEXIST errors during update by cleaning old symlinks first ([8a9a81f](https://github.com/danielvm-git/bigpowers/commit/8a9a81fa949489c594c2078d847d0e4d8e3e8b12))
+
 # [2.83.0](https://github.com/danielvm-git/bigpowers/compare/v2.82.4...v2.83.0) (2026-07-24)
 
 

package/bin/setup.js

@@ -232,14 +232,27 @@ async function main() {
     process.exit(0);
   }
 
-  // ── Step 4: Install ───────────────────────────────────────────────────
+  // ── Step 4: Clean old symlinks ─────────────────────────────────────────
   const s = await spinner();
   s.start('Preparing installation...');
   await sleep(200);
 
+  // Uninstall existing symlinks for selected tools before reinstalling
+  if (hasExisting) {
+    s.message('Cleaning old symlinks...');
+    for (const toolId of selectedTools) {
+      try {
+        uninstallTool(toolId, ROOT);
+      } catch {
+        // Ignore errors during cleanup — tool might not be installed yet
+      }
+    }
+    await sleep(100);
+  }
+
   s.message('Syncing skills...');
   try {
-    runInherited('bash scripts/sync-skills.sh');
+    runInherited('bash scripts/sync-skills.sh --distribute-only');
   } catch {
     s.error('Sync failed.');
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.83.0",
+  "version": "2.83.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/install-helpers.js

@@ -18,9 +18,9 @@ function linkSkills(skillsDir, targetDir) {
     const src = path.join(skillsDir, entry.name);
     const dst = path.join(targetDir, entry.name);
 
+    // Remove existing symlink or directory
     try {
-      const stat = fs.lstatSync(dst);
-      if (stat.isSymbolicLink()) fs.unlinkSync(dst);
+      fs.rmSync(dst, { force: true, recursive: true });
     } catch {}
 
     fs.symlinkSync(src, dst);
@@ -33,17 +33,17 @@ function linkDir(src, dst) {
       `Link source missing: ${src} (run bash scripts/sync-skills.sh first)`
     );
   }
+  // Remove existing symlink or directory
   try {
-    const stat = fs.lstatSync(dst);
-    if (stat.isSymbolicLink()) fs.unlinkSync(dst);
+    fs.rmSync(dst, { force: true, recursive: true });
   } catch {}
   fs.symlinkSync(src, dst);
 }
 
 function linkFile(src, dst) {
+  // Remove existing symlink or file
   try {
-    const stat = fs.lstatSync(dst);
-    if (stat.isSymbolicLink()) fs.unlinkSync(dst);
+    fs.rmSync(dst, { force: true });
   } catch {}
   fs.symlinkSync(src, dst);
 }
@@ -73,9 +73,9 @@ function linkHook(src, dst) {
       `Hook source missing: ${src} (expected under repo skills/ or scripts/hooks/; fix path or restore file)`
     );
   }
+  // Remove existing symlink or file
   try {
-    const stat = fs.lstatSync(dst);
-    if (stat.isSymbolicLink()) fs.unlinkSync(dst);
+    fs.rmSync(dst, { force: true });
   } catch {}
   fs.symlinkSync(src, dst);
   try { fs.chmodSync(src, 0o755); } catch {}

package/scripts/sync-skills.sh

@@ -17,25 +17,33 @@
 # Run this after adding or updating any skill. Symlinks carry changes through automatically.
 #
 # Flags:
-#   --okf          Generate specs/skills-wiki/ OKF concept bundle from SKILL.md frontmatter
-#   --opencode <p> Sync to bigpowers-opencode repo
+#   --okf              Generate specs/skills-wiki/ OKF concept bundle from SKILL.md frontmatter
+#   --opencode <p>     Sync to bigpowers-opencode repo
+#   --distribute-only  Render skills to target tool directories only — skip
+#                       lockfile/index/README/reference-table/OKF-wiki regen.
+#                       Used by bin/setup.js: end-user installs never carry
+#                       specs/ or docs/ (see .npmignore), so that dev-only
+#                       maintenance step has nothing to operate on.
 set -euo pipefail
 source "$(dirname "${BASH_SOURCE[0]}")/lib/python-env.sh"
 
 OKF_MODE=0
 OPN_TARGET=""
+DISTRIBUTE_ONLY=0
 
 for arg in "$@"; do
   case "$arg" in
     --okf) OKF_MODE=1 ;;
     --opencode=*) OPN_TARGET="${arg#*=}" ;;
     --opencode) shift; OPN_TARGET="$1" ;;
+    --distribute-only) DISTRIBUTE_ONLY=1 ;;
     --help|-h)
-      echo "Usage: sync-skills.sh [--okf] [--opencode <path>]"
+      echo "Usage: sync-skills.sh [--okf] [--opencode <path>] [--distribute-only]"
       echo ""
-      echo "  --okf        Generate specs/skills-wiki/ OKF concept bundle"
-      echo "  --opencode   Sync skills to bigpowers-opencode repo"
-      echo "  --help       Show this message"
+      echo "  --okf              Generate specs/skills-wiki/ OKF concept bundle"
+      echo "  --opencode         Sync skills to bigpowers-opencode repo"
+      echo "  --distribute-only  Render skills only — skip dev-maintenance regen"
+      echo "  --help             Show this message"
       exit 0
       ;;
     *) echo "sync-skills: unknown flag: $arg" >&2; exit 2 ;;
@@ -96,5 +104,10 @@ if [[ "$OKF_MODE" -eq 1 ]]; then
   bash "$REPO_ROOT/scripts/okf-post-sync.sh"
 fi
 
+if [[ "$DISTRIBUTE_ONLY" -eq 1 ]]; then
+  echo "sync-skills: $skill_count skills synced (--distribute-only: dev-maintenance regen skipped)"
+  exit 0
+fi
+
 sync_post_run "$skill_count" "$opencode_count"
 exit 0

package/scripts/test-install-distribute-only.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# story: BUG-2026-07-24-installer-runs-dev-maintenance-pipeline
+# Regression test: bigpowers setup must not run bigpowers' own dev-maintenance
+# regen (lockfile, SKILL-INDEX, OKF wikis) against an end-user install.
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PASS=0
+FAIL=0
+
+pass() { echo "PASS: $1"; PASS=$((PASS + 1)); }
+fail() { echo "FAIL: $1" >&2; FAIL=$((FAIL + 1)); }
+
+echo "=== test-install-distribute-only.sh ==="
+
+SYNC_SH="$REPO_ROOT/scripts/sync-skills.sh"
+SETUP_JS="$REPO_ROOT/bin/setup.js"
+
+grep -q -- '--distribute-only' "$SYNC_SH" && pass 'sync-skills.sh: --distribute-only flag defined' \
+  || fail 'sync-skills.sh: missing --distribute-only flag'
+grep -q "sync-skills.sh --distribute-only" "$SETUP_JS" && pass 'setup.js: invokes sync-skills.sh with --distribute-only' \
+  || fail 'setup.js: does not pass --distribute-only'
+
+hash_of() { [[ -f "$1" ]] && shasum -a 256 "$1" | awk '{print $1}' || echo "absent"; }
+listing_of() { [[ -d "$1" ]] && (find "$1" -maxdepth 1 -type f | sort) || echo "absent"; }
+
+LOCK_BEFORE=$(hash_of "$REPO_ROOT/skills-lock.json")
+INDEX_BEFORE=$(hash_of "$REPO_ROOT/SKILL-INDEX.md")
+SEARCH_INDEX_BEFORE=$(hash_of "$REPO_ROOT/specs/SKILL-SEARCH-INDEX_LATEST.md")
+EPICS_WIKI_BEFORE=$(listing_of "$REPO_ROOT/specs/epics-wiki")
+
+OUT="$(cd "$REPO_ROOT" && bash scripts/sync-skills.sh --distribute-only 2>&1)"
+echo "$OUT" | grep -q -- '--distribute-only: dev-maintenance regen skipped' \
+  && pass 'sync-skills.sh --distribute-only: confirmation message printed' \
+  || fail 'sync-skills.sh --distribute-only: missing confirmation message'
+echo "$OUT" | grep -q 'Generating OKF wikis' \
+  && fail 'sync-skills.sh --distribute-only: still generated OKF wikis' \
+  || pass 'sync-skills.sh --distribute-only: no OKF wiki generation'
+echo "$OUT" | grep -q 'regenerate-lockfile' \
+  && fail 'sync-skills.sh --distribute-only: still regenerated lockfile' \
+  || pass 'sync-skills.sh --distribute-only: no lockfile regen'
+
+[[ "$(hash_of "$REPO_ROOT/skills-lock.json")" == "$LOCK_BEFORE" ]] \
+  && pass 'skills-lock.json untouched' || fail 'skills-lock.json was modified'
+[[ "$(hash_of "$REPO_ROOT/SKILL-INDEX.md")" == "$INDEX_BEFORE" ]] \
+  && pass 'SKILL-INDEX.md untouched' || fail 'SKILL-INDEX.md was modified'
+[[ "$(hash_of "$REPO_ROOT/specs/SKILL-SEARCH-INDEX_LATEST.md")" == "$SEARCH_INDEX_BEFORE" ]] \
+  && pass 'SKILL-SEARCH-INDEX_LATEST.md untouched' || fail 'SKILL-SEARCH-INDEX_LATEST.md was modified'
+[[ "$(listing_of "$REPO_ROOT/specs/epics-wiki")" == "$EPICS_WIKI_BEFORE" ]] \
+  && pass 'specs/epics-wiki/ untouched' || fail 'specs/epics-wiki/ was modified'
+
+[[ -f "$REPO_ROOT/.cursor/rules/fix-bug.mdc" ]] && pass 'skills still distributed (.cursor/rules populated)' \
+  || fail 'skill distribution did not run'
+
+bash -n "$SYNC_SH" && pass 'bash -n sync-skills.sh' || fail 'bash -n sync-skills.sh'
+node --check "$SETUP_JS" && pass 'node --check setup.js' || fail 'node --check setup.js'
+
+echo "test-install-distribute-only: $PASS passed, $FAIL failed"
+[[ "$FAIL" -eq 0 ]] || exit 1