bigpowers 2.82.3 → 2.83.0

package/scripts/lib/install-helpers.js

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 // story: e60s01
+// story: e61s02
+// story: e64s02
+// story: e76s02
+// story: e69s02
+// story: e74s02
 // install-helpers.js — symlink helpers for bigpowers setup
 
 const fs = require('fs');
@@ -23,6 +28,11 @@ function linkSkills(skillsDir, targetDir) {
 }
 
 function linkDir(src, dst) {
+  if (!fs.existsSync(src)) {
+    throw new Error(
+      `Link source missing: ${src} (run bash scripts/sync-skills.sh first)`
+    );
+  }
   try {
     const stat = fs.lstatSync(dst);
     if (stat.isSymbolicLink()) fs.unlinkSync(dst);
@@ -38,8 +48,31 @@ function linkFile(src, dst) {
   fs.symlinkSync(src, dst);
 }
 
+function linkRenderedSkills(renderedDir, targetDir) {
+  if (!fs.existsSync(renderedDir)) return;
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const entry of fs.readdirSync(renderedDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    if (!fs.existsSync(path.join(renderedDir, entry.name, 'SKILL.md'))) continue;
+    linkDir(path.join(renderedDir, entry.name), path.join(targetDir, entry.name));
+  }
+}
+
+function bridgeHermesConfig(configPath) {
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  if (fs.existsSync(configPath)) {
+    const existing = fs.readFileSync(configPath, 'utf8');
+    if (/^instructions:/m.test(existing)) return;
+  }
+  fs.writeFileSync(configPath, 'instructions: AGENTS.md\n');
+}
+
 function linkHook(src, dst) {
-  if (!fs.existsSync(src)) return;
+  if (!fs.existsSync(src)) {
+    throw new Error(
+      `Hook source missing: ${src} (expected under repo skills/ or scripts/hooks/; fix path or restore file)`
+    );
+  }
   try {
     const stat = fs.lstatSync(dst);
     if (stat.isSymbolicLink()) fs.unlinkSync(dst);
@@ -63,9 +96,14 @@ function installGlobal(tool, repoRoot) {
       const hooksDir = path.join(homeDir, '.claude', 'hooks');
       fs.mkdirSync(hooksDir, { recursive: true });
       linkHook(
-        path.join(repoRoot, 'guard-git', 'scripts', 'block-dangerous-git.sh'),
+        path.join(repoRoot, 'skills', 'guard-git', 'scripts', 'block-dangerous-git.sh'),
         path.join(hooksDir, 'block-dangerous-git.sh')
       );
+      // story: e63 — hook sources SCRIPT_DIR/lib/git-guardrails-core.sh
+      linkDir(
+        path.join(repoRoot, 'skills', 'guard-git', 'scripts', 'lib'),
+        path.join(hooksDir, 'lib')
+      );
       linkHook(
         path.join(repoRoot, 'scripts', 'hooks', 'rtk-rewrite.sh'),
         path.join(hooksDir, 'rtk-rewrite.sh')
@@ -77,6 +115,18 @@ function installGlobal(tool, repoRoot) {
       const extDst = path.join(homeDir, '.gemini', 'config', 'plugins', 'bigpowers');
       fs.mkdirSync(path.dirname(extDst), { recursive: true });
       linkDir(extSrc, extDst);
+      const hooksSrc = path.join(extSrc, 'hooks');
+      const hooksDst = path.join(homeDir, '.gemini', 'hooks');
+      fs.mkdirSync(hooksDst, { recursive: true });
+      for (const hookFile of [
+        'session-start',
+        'run-hook.cmd',
+        'before-tool-git-guard.sh',
+        'before-tool-rtk.sh',
+        'before-tool-token-mgmt.sh',
+      ]) {
+        linkHook(path.join(hooksSrc, hookFile), path.join(hooksDst, hookFile));
+      }
       break;
     }
     case 'pi': {
@@ -85,6 +135,46 @@ function installGlobal(tool, repoRoot) {
       linkSkills(skillsDir, targetDir);
       break;
     }
+    case 'hermes': {
+      const renderedDir = path.join(repoRoot, '.hermes', 'skills');
+      const targetDir = path.join(homeDir, '.hermes', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      bridgeHermesConfig(path.join(homeDir, '.hermes', 'config.yaml'));
+      const hookSrc = path.join(repoRoot, 'scripts', 'hooks', 'hermes', 'gateway', 'session-log');
+      const hookDst = path.join(homeDir, '.hermes', 'hooks', 'session-log');
+      if (fs.existsSync(hookSrc)) {
+        fs.mkdirSync(path.dirname(hookDst), { recursive: true });
+        linkDir(hookSrc, hookDst);
+      }
+      break;
+    }
+    case 'zcode': {
+      const renderedDir = path.join(repoRoot, '.zcode', 'skills');
+      const targetDir = path.join(homeDir, '.zcode', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      const agentsSrc = path.join(repoRoot, 'AGENTS.md');
+      const agentsDst = path.join(homeDir, '.zcode', 'AGENTS.md');
+      fs.mkdirSync(path.dirname(agentsDst), { recursive: true });
+      linkFile(agentsSrc, agentsDst);
+      break;
+    }
+    case 'mimo': {
+      const renderedDir = path.join(repoRoot, '.mimocode', 'skills');
+      const targetDir = path.join(homeDir, '.mimocode', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      const agentsSrc = path.join(repoRoot, 'AGENTS.md');
+      const agentsDst = path.join(homeDir, '.mimocode', 'AGENTS.md');
+      fs.mkdirSync(path.dirname(agentsDst), { recursive: true });
+      linkFile(agentsSrc, agentsDst);
+      break;
+    }
+    case 'antigravity':
+    case 'agy': {
+      const renderedDir = path.join(repoRoot, '.agents', 'skills');
+      const targetDir = path.join(homeDir, '.gemini', 'antigravity-cli', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      break;
+    }
     case 'cursor': {
       const rulesSrc = path.join(repoRoot, '.cursor', 'rules');
       const rulesDst = path.join(homeDir, '.cursor', 'rules');
@@ -126,6 +216,45 @@ function installLocal(tool, repoRoot) {
       linkSkills(skillsDir, targetDir);
       break;
     }
+    case 'hermes': {
+      const renderedDir = path.join(repoRoot, '.hermes', 'skills');
+      const targetDir = path.join(cwd, '.hermes', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      bridgeHermesConfig(path.join(cwd, '.hermes', 'config.yaml'));
+      break;
+    }
+    case 'zcode': {
+      const renderedDir = path.join(repoRoot, '.zcode', 'skills');
+      const targetDir = path.join(cwd, '.zcode', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      const agentsSrc = path.join(repoRoot, 'AGENTS.md');
+      const agentsDst = path.join(cwd, '.zcode', 'AGENTS.md');
+      fs.mkdirSync(path.dirname(agentsDst), { recursive: true });
+      linkFile(agentsSrc, agentsDst);
+      break;
+    }
+    case 'mimo': {
+      const renderedDir = path.join(repoRoot, '.mimocode', 'skills');
+      const targetDir = path.join(cwd, '.mimocode', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      const agentsSrc = path.join(repoRoot, 'AGENTS.md');
+      const agentsDst = path.join(cwd, '.mimocode', 'AGENTS.md');
+      fs.mkdirSync(path.dirname(agentsDst), { recursive: true });
+      linkFile(agentsSrc, agentsDst);
+      break;
+    }
+    case 'antigravity':
+    case 'agy': {
+      const renderedDir = path.join(repoRoot, '.agents', 'skills');
+      const targetDir = path.join(cwd, '.agents', 'skills');
+      linkRenderedSkills(renderedDir, targetDir);
+      const agentsSrc = path.join(repoRoot, 'AGENTS.md');
+      const agentsDst = path.join(cwd, 'AGENTS.md');
+      if (!fs.existsSync(agentsDst)) {
+        linkFile(agentsSrc, agentsDst);
+      }
+      break;
+    }
     case 'cursor': {
       const rulesSrc = path.join(repoRoot, '.cursor', 'rules');
       const rulesDst = path.join(cwd, '.cursor', 'rules');
@@ -155,7 +284,7 @@ function uninstallTool(toolId, repoRoot) {
         for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
           if (!entry.isSymbolicLink()) continue;
           const target = fs.readlinkSync(path.join(skillsDir, entry.name));
-          if (target.includes('bigpowers')) {
+          if (target.startsWith(repoRoot)) {
             removeSymlink(path.join(skillsDir, entry.name));
           }
         }
@@ -163,10 +292,20 @@ function uninstallTool(toolId, repoRoot) {
       const hooksDir = path.join(homeDir, '.claude', 'hooks');
       removeSymlink(path.join(hooksDir, 'block-dangerous-git.sh'));
       removeSymlink(path.join(hooksDir, 'rtk-rewrite.sh'));
+      removeSymlink(path.join(hooksDir, 'lib'));
       break;
     }
     case 'gemini':
       removeSymlink(path.join(homeDir, '.gemini', 'config', 'plugins', 'bigpowers'));
+      for (const hookFile of [
+        'session-start',
+        'run-hook.cmd',
+        'before-tool-git-guard.sh',
+        'before-tool-rtk.sh',
+        'before-tool-token-mgmt.sh',
+      ]) {
+        removeSymlink(path.join(homeDir, '.gemini', 'hooks', hookFile));
+      }
       break;
     case 'pi': {
       const skillsDir = path.join(homeDir, '.pi', 'agent', 'skills');
@@ -174,7 +313,63 @@ function uninstallTool(toolId, repoRoot) {
         for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
           if (!entry.isSymbolicLink()) continue;
           const target = fs.readlinkSync(path.join(skillsDir, entry.name));
-          if (target.includes('bigpowers')) {
+          if (target.startsWith(repoRoot)) {
+            removeSymlink(path.join(skillsDir, entry.name));
+          }
+        }
+      }
+      break;
+    }
+    case 'hermes': {
+      const skillsDir = path.join(homeDir, '.hermes', 'skills');
+      if (fs.existsSync(skillsDir)) {
+        for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+          if (!entry.isSymbolicLink()) continue;
+          const target = fs.readlinkSync(path.join(skillsDir, entry.name));
+          if (target.startsWith(repoRoot) || target.includes('.hermes/skills')) {
+            removeSymlink(path.join(skillsDir, entry.name));
+          }
+        }
+      }
+      removeSymlink(path.join(homeDir, '.hermes', 'hooks', 'session-log'));
+      break;
+    }
+    case 'zcode': {
+      const skillsDir = path.join(homeDir, '.zcode', 'skills');
+      if (fs.existsSync(skillsDir)) {
+        for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+          if (!entry.isSymbolicLink()) continue;
+          const target = fs.readlinkSync(path.join(skillsDir, entry.name));
+          if (target.includes('bigpowers') || target.includes('.zcode/skills')) {
+            removeSymlink(path.join(skillsDir, entry.name));
+          }
+        }
+      }
+      removeSymlink(path.join(homeDir, '.zcode', 'AGENTS.md'));
+      break;
+    }
+    case 'mimo': {
+      const skillsDir = path.join(homeDir, '.mimocode', 'skills');
+      if (fs.existsSync(skillsDir)) {
+        for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+          if (!entry.isSymbolicLink()) continue;
+          const target = fs.readlinkSync(path.join(skillsDir, entry.name));
+          if (target.includes('bigpowers') || target.includes('.mimocode/skills')) {
+            removeSymlink(path.join(skillsDir, entry.name));
+          }
+        }
+      }
+      removeSymlink(path.join(homeDir, '.mimocode', 'AGENTS.md'));
+      break;
+    }
+    case 'antigravity':
+    case 'agy': {
+      const skillsDir = path.join(homeDir, '.gemini', 'antigravity-cli', 'skills');
+      if (fs.existsSync(skillsDir)) {
+        for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+          if (!entry.isSymbolicLink()) continue;
+          const target = fs.readlinkSync(path.join(skillsDir, entry.name));
+          if (target.includes('bigpowers') || target.includes('.agents/skills')) {
             removeSymlink(path.join(skillsDir, entry.name));
           }
         }

package/scripts/lib/sync-render.sh

@@ -54,6 +54,49 @@ render_gemini_command() {
   } > "$GEMINI_COMMANDS/$IR_NAME.toml"
 }
 
+render_gemini_hooks_manifest() {
+  local hookdir="${GEMINI_HOOKS_DIR:-$GEMINI_EXT_DIR/hooks}"
+  mkdir -p "$hookdir"
+  cat > "$hookdir/hooks-manifest.json" <<'JSON'
+{
+  "schema_version": 1,
+  "target": "gemini",
+  "config_path": "~/.gemini/settings.json",
+  "events_total": 11,
+  "events": [
+    "BeforeTool",
+    "AfterTool",
+    "BeforeAgent",
+    "AfterAgent",
+    "BeforeModel",
+    "BeforeToolSelection",
+    "AfterModel",
+    "SessionStart",
+    "SessionEnd",
+    "Notification",
+    "PreCompress"
+  ],
+  "shipped_hooks": [
+    {
+      "event": "SessionStart",
+      "script": "session-start",
+      "matcher": "startup|clear|compact",
+      "wave": "a",
+      "status": "shipped"
+    },
+    {
+      "event": "BeforeTool",
+      "script": "before-tool-git-guard.sh",
+      "matcher": "run_shell_command",
+      "wave": "a",
+      "status": "template"
+    }
+  ],
+  "polyglot_launcher": "run-hook.cmd"
+}
+JSON
+}
+
 render_pi_skill() {
   mkdir -p "$PI_SKILLS/$IR_NAME"
   {

package/scripts/lib/target-contracts.sh

@@ -42,6 +42,16 @@ assert_gemini_ext_exists() {
   return 1
 }
 
+assert_gemini_hooks_manifest() {
+  local id="$1"
+  if GEMINI_EXT_DIR=".gemini/extensions/bigpowers" bash scripts/adapters/gemini.sh --validate-hooks >/dev/null 2>&1; then
+    echo "PASS $id:gemini_hooks_manifest"
+    return 0
+  fi
+  echo "FAIL $id:gemini_hooks_manifest — hook templates invalid"
+  return 1
+}
+
 assert_pi_skills_nonempty() {
   local id="$1"
   if [[ -d .pi/skills ]] && [[ -n "$(ls -A .pi/skills 2>/dev/null)" ]]; then
@@ -62,6 +72,16 @@ assert_aider_bridge() {
   return 0
 }
 
+assert_agy_skills_nonempty() {
+  local id="$1"
+  if [[ -d .agents/skills ]] && [[ -n "$(ls -A .agents/skills 2>/dev/null)" ]]; then
+    echo "PASS $id:agy_skills_nonempty"
+    return 0
+  fi
+  echo "FAIL $id:agy_skills_nonempty — .agents/skills empty"
+  return 1
+}
+
 run_contract() {
   local id="$1"
   local contract="$2"
@@ -70,7 +90,9 @@ run_contract() {
     symlink_claude_md) assert_symlink_claude_md "$id" ;;
     cursor_rules_nonempty) assert_cursor_rules_nonempty "$id" ;;
     gemini_ext_exists) assert_gemini_ext_exists "$id" ;;
+    gemini_hooks_manifest) assert_gemini_hooks_manifest "$id" ;;
     pi_skills_nonempty) assert_pi_skills_nonempty "$id" ;;
+    agy_skills_nonempty) assert_agy_skills_nonempty "$id" ;;
     aider_bridge) assert_aider_bridge "$id" ;;
     *) echo "SKIP $id:$contract — unknown contract"; return 0 ;;
   esac

package/scripts/lib/trace-matrix.py

@@ -103,7 +103,7 @@ import subprocess
 result = subprocess.run(
     ["grep", "-rn", "--include=*.md", "--include=*.sh", "--include=*.py",
      "--include=*.js", "--include=*.ts", "--include=*.yaml", "--include=*.yml",
-     "-E", r"story:\s*e\d{2}s\d{2}", str(ROOT)],
+     "-E", r"story:\s*e[0-9]{2}s[0-9]{2}", str(ROOT)],
     capture_output=True, text=True, cwd=str(ROOT)
 )
 

package/scripts/lib/trace-stories.py

@@ -79,7 +79,7 @@ for epic in epics:
 result = subprocess.run(
     ["grep", "-rn", "--include=*.md", "--include=*.sh", "--include=*.py",
      "--include=*.js", "--include=*.ts", "--include=*.yaml", "--include=*.yml",
-     "-E", r"story:\s*e\d{2}s\d{2}", str(ROOT)],
+     "-E", r"story:\s*e[0-9]{2}s[0-9]{2}", str(ROOT)],
     capture_output=True, text=True, cwd=str(ROOT))
 
 tag_inventory: list[dict] = []

package/scripts/targets.yaml

@@ -29,6 +29,7 @@ targets:
       file: GEMINI.md
     contracts:
       - gemini_ext_exists
+      - gemini_hooks_manifest
 
   - id: pi
     name: pi Agent
@@ -79,12 +80,15 @@ targets:
   - id: agy
     name: Antigravity agy (proprietary beta)
     tier: opt_in
-    skill: null
+    skill:
+      adapter: agy
+      output: .agents/skills
     context:
       adapter: agy
       mode: symlink
       file: CLAUDE.md
     contracts:
+      - agy_skills_nonempty
       - symlink_claude_md
 
   # Wave B (e37s10) — skills-dir adapters
@@ -128,6 +132,32 @@ targets:
     contracts:
       - agents_md_exists
 
+  - id: zcode
+    name: ZCode
+    tier: opt_in
+    skill:
+      adapter: zcode
+      output: .zcode/skills
+    context:
+      adapter: zcode
+      mode: symlink
+      file: AGENTS.md
+    contracts:
+      - agents_md_exists
+
+  - id: mimo
+    name: MiMo Code
+    tier: opt_in
+    skill:
+      adapter: mimo
+      output: .mimocode/skills
+    context:
+      adapter: mimo
+      mode: symlink
+      file: AGENTS.md
+    contracts:
+      - agents_md_exists
+
   # Wave C (e37s11)
   - id: qwen
     name: Qwen (Alibaba)

package/scripts/test-agy-hub.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# story: e74s02
+# Regression tests for Antigravity CLI install hub wiring (Wave B).
+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-agy-hub.sh ==="
+
+INSTALL_SH="$REPO_ROOT/scripts/install.sh"
+HELPERS_JS="$REPO_ROOT/scripts/lib/install-helpers.js"
+SETUP_JS="$REPO_ROOT/bin/setup.js"
+TARGETS_YAML="$REPO_ROOT/scripts/targets.yaml"
+
+grep -q 'install_agy()' "$INSTALL_SH" && pass 'install.sh: install_agy()' || fail 'install.sh: missing install_agy()'
+grep -q 'install_antigravity()' "$INSTALL_SH" && pass 'install.sh: install_antigravity alias' || fail 'install.sh: missing install_antigravity()'
+grep -q 'uninstall_agy()' "$INSTALL_SH" && pass 'install.sh: uninstall_agy()' || fail 'install.sh: missing uninstall_agy()'
+grep -q 'uninstall_antigravity()' "$INSTALL_SH" && pass 'install.sh: uninstall_antigravity alias' || fail 'install.sh: missing uninstall_antigravity()'
+grep -q 'AGY_SKILLS_DIR=' "$INSTALL_SH" && pass 'install.sh: AGY_SKILLS_DIR' || fail 'install.sh: missing AGY_SKILLS_DIR'
+grep -q 'antigravity-cli/skills' "$INSTALL_SH" && pass 'install.sh: antigravity-cli path' || fail 'install.sh: missing antigravity-cli path'
+grep -q 'install_agy' "$INSTALL_SH" && grep -q 'uninstall_agy' "$INSTALL_SH" && pass 'install.sh: dispatch wired' || fail 'install.sh: dispatch missing agy'
+! grep -q '\.gemini/extensions/bigpowers' <<< "$(sed -n '/install_agy/,/^}/p' "$INSTALL_SH")" \
+  && pass 'install.sh: no gemini extension path' || fail 'install.sh: touches gemini extension path'
+
+DRY_OUT="$(bash "$INSTALL_SH" --dry-run 2>&1)"
+echo "$DRY_OUT" | grep -q 'Antigravity CLI →' && pass 'dry-run: Antigravity CLI section' || fail 'dry-run: missing Antigravity CLI section'
+DRY_UNINSTALL="$(bash "$INSTALL_SH" --dry-run --uninstall 2>&1)"
+echo "$DRY_UNINSTALL" | grep -q 'Antigravity CLI →' && pass 'dry-run uninstall: Antigravity CLI section' || fail 'dry-run uninstall: missing Antigravity CLI section'
+
+grep -q "case 'antigravity'" "$HELPERS_JS" && pass 'install-helpers: antigravity case' || fail 'install-helpers: missing antigravity case'
+grep -q "case 'agy'" "$HELPERS_JS" && pass 'install-helpers: agy case' || fail 'install-helpers: missing agy case'
+grep -q "'antigravity-cli', 'skills'" "$HELPERS_JS" && pass 'install-helpers: antigravity-cli global path' || fail 'install-helpers: missing antigravity-cli path'
+grep -q "'\\.agents', 'skills'" "$HELPERS_JS" && pass 'install-helpers: .agents/skills local path' || fail 'install-helpers: missing .agents/skills path'
+
+SETUP_SRC="$(cat "$SETUP_JS")"
+echo "$SETUP_SRC" | grep -q "SUPPORTED_IDS = new Set" && pass 'setup.js: SUPPORTED_IDS set' || fail 'setup.js: missing SUPPORTED_IDS'
+echo "$SETUP_SRC" | grep -q "'antigravity'" && pass 'setup.js: antigravity in TOOLS/SUPPORTED_IDS' || fail 'setup.js: antigravity missing'
+echo "$SETUP_SRC" | grep -q "'agy'" && pass 'setup.js: agy in SUPPORTED_IDS' || fail 'setup.js: agy missing from SUPPORTED_IDS'
+echo "$SETUP_SRC" | grep -q 'antigravity-cli/skills' && pass 'setup.js: antigravity-cli global path' || fail 'setup.js: wrong antigravity global path'
+echo "$SETUP_SRC" | grep -q "'\\.agents/skills'" && pass 'setup.js: .agents/skills local path' || fail 'setup.js: wrong antigravity local path'
+
+grep -q 'id: agy' "$TARGETS_YAML" && pass 'targets.yaml: agy row' || fail 'targets.yaml: missing agy row'
+grep -q 'adapter: agy' "$TARGETS_YAML" && pass 'targets.yaml: agy adapter' || fail 'targets.yaml: missing agy adapter'
+grep -q 'output: .agents/skills' "$TARGETS_YAML" && pass 'targets.yaml: agy output path' || fail 'targets.yaml: missing agy output'
+grep -q 'agy_skills_nonempty' "$TARGETS_YAML" && pass 'targets.yaml: agy contract' || fail 'targets.yaml: missing agy contract'
+
+grep -q 'install_agy()' "$REPO_ROOT/scripts/verify-install.sh" && pass 'verify-install: install_agy assertion' || fail 'verify-install: missing install_agy assertion'
+
+bash -n "$INSTALL_SH" && pass 'bash -n install.sh' || fail 'bash -n install.sh'
+node --check "$HELPERS_JS" && pass 'node --check install-helpers.js' || fail 'node --check install-helpers.js'
+node --check "$SETUP_JS" && pass 'node --check setup.js' || fail 'node --check setup.js'
+
+echo "test-agy-hub: $PASS passed, $FAIL failed"
+[[ "$FAIL" -eq 0 ]] || exit 1

package/scripts/test-gemini-adapter.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# story: e64s01
+# Validates Gemini adapter hook templates and stdin render path.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+GEMINI_EXT="$REPO_ROOT/.gemini/extensions/bigpowers"
+
+echo "=== test-gemini-adapter.sh ==="
+
+# Test 1: validate hook templates via adapter CLI
+echo "Test 1: validate_hook_templates"
+GEMINI_EXT_DIR="$GEMINI_EXT" GEMINI_HOOKS_DIR="$GEMINI_EXT/hooks" \
+  bash "$REPO_ROOT/scripts/adapters/gemini.sh" --validate-hooks
+
+# Test 2: event count
+echo "Test 2: hook event count"
+COUNT="$(GEMINI_EXT_DIR="$GEMINI_EXT" bash "$REPO_ROOT/scripts/adapters/gemini.sh" --list-hook-events | wc -l | tr -d ' ')"
+if [[ "$COUNT" != "11" ]]; then
+  echo "FAIL: expected 11 events, got $COUNT"
+  exit 1
+fi
+
+# Test 3: HOOKS.md documents all events
+echo "Test 3: HOOKS.md coverage"
+for ev in BeforeTool AfterTool BeforeAgent AfterAgent BeforeModel BeforeToolSelection AfterModel SessionStart SessionEnd Notification PreCompress; do
+  grep -q "$ev" "$GEMINI_EXT/hooks/HOOKS.md" || { echo "FAIL: HOOKS.md missing $ev"; exit 1; }
+done
+
+# Test 4: stdin render smoke (fallback path without sync-render sourced)
+echo "Test 4: stdin render smoke"
+TMP_SKILL="$GEMINI_EXT/skills/_test-gemini-adapter"
+TMP_CMD="$GEMINI_EXT/commands/prompts/_test-gemini-adapter.md"
+rm -rf "$TMP_SKILL" "$TMP_CMD"
+echo '{"name":"_test-gemini-adapter","model":"","description":"adapter test","body":"test body"}' | \
+  GEMINI_SKILLS="$GEMINI_EXT/skills" GEMINI_COMMANDS="$GEMINI_EXT/commands" \
+  bash "$REPO_ROOT/scripts/adapters/gemini.sh"
+if [[ ! -f "$TMP_SKILL/SKILL.md" ]] || [[ ! -f "$TMP_CMD" ]]; then
+  echo "FAIL: gemini adapter did not render test skill"
+  exit 1
+fi
+rm -rf "$TMP_SKILL" "$TMP_CMD"
+
+# Test 5: render_hooks_manifest delegates to render_gemini_hooks_manifest override
+# (subshell invocation — adapters are subprocess-invoked, not sourced, per Tests 1-4 above)
+echo "Test 5: render_hooks_manifest"
+GEMINI_EXT_DIR="$GEMINI_EXT" bash -c "
+  source '$REPO_ROOT/scripts/lib/skill-common.sh' 2>/dev/null || true
+  source '$REPO_ROOT/scripts/lib/sync-render.sh'
+  source '$REPO_ROOT/scripts/adapters/gemini.sh'
+  render_hooks_manifest
+"
+grep -q '"events_total": 11' "$GEMINI_EXT/hooks/hooks-manifest.json" || {
+  echo "FAIL: hooks-manifest.json invalid after render"
+  exit 1
+}
+
+# Test 6: before-tool-git-guard gemini JSON shape
+echo "Test 6: before-tool-git-guard gemini mode"
+OUT="$(echo '{"tool_input":{"command":"git reset --hard"}}' | \
+  bash "$GEMINI_EXT/hooks/before-tool-git-guard.sh")"
+echo "$OUT" | jq -e '.decision == "deny"' >/dev/null || {
+  echo "FAIL: git guard did not deny dangerous reset --hard"
+  echo "$OUT"
+  exit 1
+}
+
+echo "PASS: test-gemini-adapter.sh"
+exit 0

package/scripts/test-gemini-hub.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# story: e64s02
+# Regression tests for Gemini install hub wiring (Wave B).
+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-gemini-hub.sh ==="
+
+INSTALL_SH="$REPO_ROOT/scripts/install.sh"
+HELPERS_JS="$REPO_ROOT/scripts/lib/install-helpers.js"
+SETUP_JS="$REPO_ROOT/bin/setup.js"
+TARGETS_YAML="$REPO_ROOT/scripts/targets.yaml"
+
+grep -q 'install_gemini()' "$INSTALL_SH" && pass 'install.sh: install_gemini()' || fail 'install.sh: missing install_gemini()'
+grep -q 'uninstall_gemini()' "$INSTALL_SH" && pass 'install.sh: uninstall_gemini()' || fail 'install.sh: missing uninstall_gemini()'
+grep -q 'GEMINI_HOOKS_SRC=' "$INSTALL_SH" && pass 'install.sh: GEMINI_HOOKS_SRC' || fail 'install.sh: missing GEMINI_HOOKS_SRC'
+grep -q 'before-tool-git-guard.sh' "$INSTALL_SH" && pass 'install.sh: Wave A git-guard hook' || fail 'install.sh: missing before-tool-git-guard.sh'
+grep -q 'before-tool-rtk.sh' "$INSTALL_SH" && pass 'install.sh: Wave A rtk hook' || fail 'install.sh: missing before-tool-rtk.sh'
+grep -q 'install_gemini' "$INSTALL_SH" && grep -q 'uninstall_gemini' "$INSTALL_SH" && pass 'install.sh: dispatch wired' || fail 'install.sh: dispatch missing gemini'
+
+DRY_OUT="$(bash "$INSTALL_SH" --dry-run 2>&1)"
+echo "$DRY_OUT" | grep -q 'Gemini CLI →' && pass 'dry-run: Gemini CLI section' || fail 'dry-run: missing Gemini CLI section'
+echo "$DRY_OUT" | grep -q 'before-tool-git-guard.sh' && pass 'dry-run: git-guard hook symlink' || fail 'dry-run: missing git-guard hook'
+DRY_UNINSTALL="$(bash "$INSTALL_SH" --dry-run --uninstall 2>&1)"
+echo "$DRY_UNINSTALL" | grep -q 'Gemini CLI →' && pass 'dry-run uninstall: Gemini CLI section' || fail 'dry-run uninstall: missing Gemini CLI section'
+
+grep -q "case 'gemini'" "$HELPERS_JS" && pass 'install-helpers: gemini global case' || fail 'install-helpers: missing gemini global case'
+grep -q 'before-tool-git-guard.sh' "$HELPERS_JS" && pass 'install-helpers: gemini hook wiring' || fail 'install-helpers: missing gemini hook wiring'
+
+SETUP_SRC="$(cat "$SETUP_JS")"
+echo "$SETUP_SRC" | grep -q "SUPPORTED_IDS = new Set" && pass 'setup.js: SUPPORTED_IDS set' || fail 'setup.js: missing SUPPORTED_IDS'
+echo "$SETUP_SRC" | grep -q "'gemini'" "$SETUP_JS" && pass 'setup.js: gemini in TOOLS' || fail 'setup.js: gemini missing from TOOLS'
+echo "$SETUP_SRC" | grep -q "'gemini'" && echo "$SETUP_SRC" | grep -q "SUPPORTED_IDS" \
+  && grep -q "'gemini'" <<< "$(sed -n "/SUPPORTED_IDS = new Set/,/);/p" "$SETUP_JS")" \
+  && pass 'setup.js: gemini in SUPPORTED_IDS' || fail 'setup.js: gemini not in SUPPORTED_IDS'
+
+grep -q 'id: gemini' "$TARGETS_YAML" && pass 'targets.yaml: gemini row' || fail 'targets.yaml: missing gemini row'
+grep -q 'adapter: gemini' "$TARGETS_YAML" && pass 'targets.yaml: gemini adapter' || fail 'targets.yaml: missing gemini adapter'
+grep -q 'gemini_hooks_manifest' "$TARGETS_YAML" && pass 'targets.yaml: gemini_hooks_manifest contract' || fail 'targets.yaml: missing gemini_hooks_manifest'
+
+grep -q 'install_gemini()' "$REPO_ROOT/scripts/verify-install.sh" && pass 'verify-install: install_gemini assertion' || fail 'verify-install: missing install_gemini assertion'
+grep -q 'gemini_hooks_manifest' "$REPO_ROOT/scripts/verify-install.sh" && pass 'verify-install: gemini hook contract' || fail 'verify-install: missing gemini hook contract'
+
+bash -n "$INSTALL_SH" && pass 'bash -n install.sh' || fail 'bash -n install.sh'
+node --check "$HELPERS_JS" && pass 'node --check install-helpers.js' || fail 'node --check install-helpers.js'
+node --check "$SETUP_JS" && pass 'node --check setup.js' || fail 'node --check setup.js'
+
+echo "test-gemini-hub: $PASS passed, $FAIL failed"
+[[ "$FAIL" -eq 0 ]] || exit 1