bigpowers 2.88.3 → 2.88.5

package/.gemini/extensions/bigpowers/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.88.3",
+  "version": "2.88.5",
   "description": "81 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "gemini-extension"

package/.mcp.json

@@ -2,8 +2,8 @@
   "mcpServers": {
     "bigpowers-mcp": {
       "command": "node",
-      "args": ["bigpowers-mcp/build/index.js"],
-      "cwd": "${workspaceFolder}"
+      "args": ["${OMP_PLUGIN_ROOT}/bigpowers-mcp/build/index.js"],
+      "cwd": "${OMP_PLUGIN_ROOT}"
     }
   }
 }

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.88.3",
+  "version": "2.88.5",
   "description": "81 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.88.5](https://github.com/danielvm-git/bigpowers/compare/v2.88.4...v2.88.5) (2026-09-13)
+
+
+### Bug Fixes
+
+* **docs:** prefix generated site links with base path ([#127](https://github.com/danielvm-git/bigpowers/issues/127)) ([c24ffd4](https://github.com/danielvm-git/bigpowers/commit/c24ffd43d7237d6e8be57f702389bce0e2bad690))
+
+## [2.88.4](https://github.com/danielvm-git/bigpowers/compare/v2.88.3...v2.88.4) (2026-09-13)
+
+
+### Bug Fixes
+
+* **mcp:** start bigpowers-mcp from OMP plugin installs ([#123](https://github.com/danielvm-git/bigpowers/issues/123)) ([#125](https://github.com/danielvm-git/bigpowers/issues/125)) ([1194dc1](https://github.com/danielvm-git/bigpowers/commit/1194dc158ab191ec3be32b55b8b4400a7ddcf277))
+
 ## [2.88.3](https://github.com/danielvm-git/bigpowers/compare/v2.88.2...v2.88.3) (2026-09-13)
 
 

package/bigpowers-mcp/build/config.js

@@ -16,7 +16,13 @@ export function getRepoRoot() {
     return cwd;
 }
 function isRepoRoot(dir) {
-    return (fs.existsSync(path.join(dir, "skills")) && fs.existsSync(path.join(dir, "specs")));
+    if (fs.existsSync(path.join(dir, "skills")) &&
+        fs.existsSync(path.join(dir, "specs"))) {
+        return true;
+    }
+    // Published npm package ships skills/ but excludes specs/ (.npmignore).
+    return (fs.existsSync(path.join(dir, "skills")) &&
+        fs.existsSync(path.join(dir, "bigpowers-mcp", "build", "index.js")));
 }
 export function getSkillsDir(repoRoot) {
     return path.join(repoRoot, "skills");

package/bigpowers-mcp/build/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,iFAAiF;AACjF,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAEhC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAExD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,CACL,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,SAAS;IACT,SAAS;IACT,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,iFAAiF;AACjF,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAEhC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAExD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,wEAAwE;IACxE,OAAO,CACL,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,SAAS;IACT,SAAS;IACT,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC"}

package/bigpowers-mcp/src/config.ts

@@ -19,8 +19,16 @@ export function getRepoRoot(): string {
 }
 
 function isRepoRoot(dir: string): boolean {
+  if (
+    fs.existsSync(path.join(dir, "skills")) &&
+    fs.existsSync(path.join(dir, "specs"))
+  ) {
+    return true;
+  }
+  // Published npm package ships skills/ but excludes specs/ (.npmignore).
   return (
-    fs.existsSync(path.join(dir, "skills")) && fs.existsSync(path.join(dir, "specs"))
+    fs.existsSync(path.join(dir, "skills")) &&
+    fs.existsSync(path.join(dir, "bigpowers-mcp", "build", "index.js"))
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.88.3",
+  "version": "2.88.5",
   "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {
@@ -59,7 +59,13 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "picocolors": "^1.1.1"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.0",
+    "picocolors": "^1.1.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "zod": "^3.24.2"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",

package/scripts/lib/golden-suite-gates.sh

@@ -66,6 +66,7 @@ GOLDEN_GATES=(
   "install-helpers:bash scripts/test-install-helpers.sh:false"
   "project-runtime:bash scripts/test-project-runtime.sh:false"
   "omp-extension:bash scripts/validate-omp-extension.sh:false"
+  "mcp-package:bash scripts/validate-mcp-package.sh:false"
   "import-boundaries:bash scripts/check-import-boundaries.sh:false"
   "skill-catalog:bash scripts/validate-skill-catalog.sh:false"
   "specs-parse:bash scripts/validate-specs-yaml.sh:false"

package/scripts/mcp-smoke.ts

@@ -0,0 +1,67 @@
+// story: e32s06
+// Simulates OMP spawning bigpowers-mcp from the installed plugin root (#123).
+// Verifies Node resolves @modelcontextprotocol/sdk from the root package graph
+// and the server reaches its startup log line without module-not-found.
+
+import { readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const manifest = JSON.parse(readFileSync(join(repoRoot, ".mcp.json"), "utf8")) as {
+  mcpServers?: Record<string, { args?: string[]; cwd?: string }>;
+};
+const server = manifest.mcpServers?.["bigpowers-mcp"];
+if (!server) throw new Error("bigpowers-mcp entry missing from .mcp.json");
+
+const entry = join(repoRoot, "bigpowers-mcp/build/index.js");
+const started = await new Promise<{ ok: boolean; detail: string }>((resolve) => {
+  const child = spawn("node", [entry], {
+    cwd: repoRoot,
+    stdio: ["ignore", "pipe", "pipe"],
+    env: { ...process.env, OMP_PLUGIN_ROOT: repoRoot },
+  });
+
+  let stderr = "";
+  const timer = setTimeout(() => {
+    child.kill("SIGTERM");
+    resolve({ ok: false, detail: `timeout waiting for startup (stderr: ${stderr.trim()})` });
+  }, 5000);
+
+  child.stderr.on("data", (chunk: Buffer) => {
+    stderr += chunk.toString();
+    if (stderr.includes("bigpowers-mcp started")) {
+      clearTimeout(timer);
+      child.kill("SIGTERM");
+      resolve({ ok: true, detail: "bigpowers-mcp started" });
+    }
+  });
+
+  child.on("exit", (code, signal) => {
+    if (stderr.includes("ERR_MODULE_NOT_FOUND")) {
+      clearTimeout(timer);
+      resolve({ ok: false, detail: stderr.trim() });
+      return;
+    }
+    if (signal === "SIGTERM" && stderr.includes("bigpowers-mcp started")) return;
+    clearTimeout(timer);
+    resolve({
+      ok: false,
+      detail: `exit code=${code ?? "null"} signal=${signal ?? "null"} stderr=${stderr.trim()}`,
+    });
+  });
+});
+
+if (!started.ok) {
+  throw new Error(started.detail);
+}
+
+console.log(
+  JSON.stringify({
+    pluginRoot: repoRoot,
+    entry,
+    ompPluginRootInManifest: server.cwd?.includes("OMP_PLUGIN_ROOT") ?? false,
+    startup: started.detail,
+  }),
+);

package/scripts/test-install-helpers.js

@@ -229,6 +229,8 @@ try {
       '.gemini/extensions/bigpowers/hooks/before-tool-git-guard.sh',
       '.cursor/rules',
       '.pi/skills',
+      '.mcp.json',
+      'bigpowers-mcp/build/index.js',
       'skills/audit-code/SKILL.md',
       'docs/templates/ci/github/test-build-release-node.yml',
     ];
@@ -256,6 +258,8 @@ try {
       maxBuffer: 16 * 1024 * 1024,
     });
     for (const tpl of [
+      '.mcp.json',
+      'bigpowers-mcp/build/index.js',
       'docs/templates/ci/github/test-build-release-node.yml',
       'docs/templates/ci/github/test-build-release-rust.yml',
       'docs/templates/ci/github/test-build-release-python.yml',

package/scripts/validate-mcp-package.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# story: e32s06
+# MCP package integrity guard — shipped .mcp.json must start from OMP plugin installs
+# and root package.json must declare bigpowers-mcp runtime dependencies.
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO_ROOT"
+
+ERRORS=0
+
+fail() {
+  echo "FAIL: $*"
+  ERRORS=$((ERRORS + 1))
+}
+
+pass() {
+  echo "ok  : $*"
+}
+
+MCP_JSON="$REPO_ROOT/.mcp.json"
+echo "--- [MCP] shipped .mcp.json OMP compatibility ---"
+if [[ ! -f "$MCP_JSON" ]]; then
+  fail ".mcp.json missing at repo root"
+else
+  if grep -q 'workspaceFolder' "$MCP_JSON" 2>/dev/null; then
+    fail ".mcp.json uses workspaceFolder — not valid in OMP env expansion (#123)"
+  else
+    pass ".mcp.json does not reference workspaceFolder"
+  fi
+  if grep -q 'OMP_PLUGIN_ROOT' "$MCP_JSON" 2>/dev/null; then
+    pass ".mcp.json references OMP_PLUGIN_ROOT for plugin installs"
+  else
+    fail ".mcp.json must reference OMP_PLUGIN_ROOT for OMP plugin cwd/args"
+  fi
+fi
+
+echo "--- [MCP] root runtime dependencies ---"
+for dep in "@modelcontextprotocol/sdk" "unified" "remark-parse" "zod"; do
+  if node -e "const p=require('./package.json'); process.exit(p.dependencies?.['$dep'] ? 0 : 1)"; then
+    pass "root dependencies include $dep"
+  else
+    fail "root dependencies missing $dep (bigpowers-mcp runtime)"
+  fi
+done
+
+echo "--- [MCP] built server entry ---"
+if [[ -f "$REPO_ROOT/bigpowers-mcp/build/index.js" ]]; then
+  pass "bigpowers-mcp/build/index.js exists"
+else
+  fail "bigpowers-mcp/build/index.js missing — run cd bigpowers-mcp && npm run build"
+fi
+
+echo "--- [MCP] runtime load smoke (scripts/mcp-smoke.ts) ---"
+if ! command -v node >/dev/null 2>&1; then
+  echo "warn: node unavailable — skipping runtime load smoke"
+elif [[ ! -f "$REPO_ROOT/scripts/mcp-smoke.ts" ]]; then
+  fail "scripts/mcp-smoke.ts not found"
+else
+  SMOKE_ERR=$(mktemp)
+  if node "$REPO_ROOT/scripts/mcp-smoke.ts" >/dev/null 2>"$SMOKE_ERR"; then
+    pass "MCP server loads from simulated OMP plugin root"
+  else
+    fail "MCP smoke failed — $(head -3 "$SMOKE_ERR" 2>/dev/null | tr '\n' ' ')"
+  fi
+  rm -f "$SMOKE_ERR"
+fi
+
+echo "---"
+if [[ "$ERRORS" -eq 0 ]]; then
+  echo "MCP package validation passed"
+else
+  echo "MCP package validation FAILED ($ERRORS error(s))"
+  exit 1
+fi