@runchr/gstack-antigravity 0.1.0

package/gstack-origin/scripts/skill-check.ts

@@ -0,0 +1,167 @@
+#!/usr/bin/env bun
+/**
+ * skill:check — Health summary for all SKILL.md files.
+ *
+ * Reports:
+ *   - Command validation (valid/invalid/snapshot errors)
+ *   - Template coverage (which SKILL.md files have .tmpl sources)
+ *   - Freshness check (generated files match committed files)
+ */
+
+import { validateSkill } from '../test/helpers/skill-parser';
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+
+const ROOT = path.resolve(import.meta.dir, '..');
+
+// Find all SKILL.md files
+const SKILL_FILES = [
+  'SKILL.md',
+  'browse/SKILL.md',
+  'qa/SKILL.md',
+  'qa-only/SKILL.md',
+  'ship/SKILL.md',
+  'review/SKILL.md',
+  'retro/SKILL.md',
+  'plan-ceo-review/SKILL.md',
+  'plan-eng-review/SKILL.md',
+  'setup-browser-cookies/SKILL.md',
+  'plan-design-review/SKILL.md',
+  'design-review/SKILL.md',
+  'gstack-upgrade/SKILL.md',
+  'document-release/SKILL.md',
+  'canary/SKILL.md',
+  'benchmark/SKILL.md',
+  'land-and-deploy/SKILL.md',
+  'setup-deploy/SKILL.md',
+  'cso/SKILL.md',
+].filter(f => fs.existsSync(path.join(ROOT, f)));
+
+let hasErrors = false;
+
+// ─── Skills ─────────────────────────────────────────────────
+
+console.log('  Skills:');
+for (const file of SKILL_FILES) {
+  const fullPath = path.join(ROOT, file);
+  const result = validateSkill(fullPath);
+
+  if (result.warnings.length > 0) {
+    console.log(`  \u26a0\ufe0f  ${file.padEnd(30)} — ${result.warnings.join(', ')}`);
+    continue;
+  }
+
+  const totalValid = result.valid.length;
+  const totalInvalid = result.invalid.length;
+  const totalSnapErrors = result.snapshotFlagErrors.length;
+
+  if (totalInvalid > 0 || totalSnapErrors > 0) {
+    hasErrors = true;
+    console.log(`  \u274c ${file.padEnd(30)} — ${totalValid} valid, ${totalInvalid} invalid, ${totalSnapErrors} snapshot errors`);
+    for (const inv of result.invalid) {
+      console.log(`      line ${inv.line}: unknown command '${inv.command}'`);
+    }
+    for (const se of result.snapshotFlagErrors) {
+      console.log(`      line ${se.command.line}: ${se.error}`);
+    }
+  } else {
+    console.log(`  \u2705 ${file.padEnd(30)} — ${totalValid} commands, all valid`);
+  }
+}
+
+// ─── Templates ──────────────────────────────────────────────
+
+console.log('\n  Templates:');
+const TEMPLATES = [
+  { tmpl: 'SKILL.md.tmpl', output: 'SKILL.md' },
+  { tmpl: 'browse/SKILL.md.tmpl', output: 'browse/SKILL.md' },
+];
+
+for (const { tmpl, output } of TEMPLATES) {
+  const tmplPath = path.join(ROOT, tmpl);
+  const outPath = path.join(ROOT, output);
+  if (!fs.existsSync(tmplPath)) {
+    console.log(`  \u26a0\ufe0f  ${output.padEnd(30)} — no template`);
+    continue;
+  }
+  if (!fs.existsSync(outPath)) {
+    hasErrors = true;
+    console.log(`  \u274c ${output.padEnd(30)} — generated file missing! Run: bun run gen:skill-docs`);
+    continue;
+  }
+  console.log(`  \u2705 ${tmpl.padEnd(30)} \u2192 ${output}`);
+}
+
+// Skills without templates
+for (const file of SKILL_FILES) {
+  const tmplPath = path.join(ROOT, file + '.tmpl');
+  if (!fs.existsSync(tmplPath) && !TEMPLATES.some(t => t.output === file)) {
+    console.log(`  \u26a0\ufe0f  ${file.padEnd(30)} — no template (OK if no $B commands)`);
+  }
+}
+
+// ─── Codex Skills ───────────────────────────────────────────
+
+const AGENTS_DIR = path.join(ROOT, '.agents', 'skills');
+if (fs.existsSync(AGENTS_DIR)) {
+  console.log('\n  Codex Skills (.agents/skills/):');
+  const codexDirs = fs.readdirSync(AGENTS_DIR).sort();
+  let codexCount = 0;
+  let codexMissing = 0;
+  for (const dir of codexDirs) {
+    const skillMd = path.join(AGENTS_DIR, dir, 'SKILL.md');
+    if (fs.existsSync(skillMd)) {
+      codexCount++;
+      const content = fs.readFileSync(skillMd, 'utf-8');
+      // Quick validation: must have frontmatter with name + description only
+      const hasClaude = content.includes('.claude/skills');
+      if (hasClaude) {
+        hasErrors = true;
+        console.log(`  \u274c ${dir.padEnd(30)} — contains .claude/skills reference`);
+      } else {
+        console.log(`  \u2705 ${dir.padEnd(30)} — OK`);
+      }
+    } else {
+      codexMissing++;
+      hasErrors = true;
+      console.log(`  \u274c ${dir.padEnd(30)} — SKILL.md missing`);
+    }
+  }
+  console.log(`  Total: ${codexCount} skills, ${codexMissing} missing`);
+} else {
+  console.log('\n  Codex Skills: .agents/skills/ not found (run: bun run gen:skill-docs --host codex)');
+}
+
+// ─── Freshness ──────────────────────────────────────────────
+
+console.log('\n  Freshness (Claude):');
+try {
+  execSync('bun run scripts/gen-skill-docs.ts --dry-run', { cwd: ROOT, stdio: 'pipe' });
+  console.log('  \u2705 All Claude generated files are fresh');
+} catch (err: any) {
+  hasErrors = true;
+  const output = err.stdout?.toString() || '';
+  console.log('  \u274c Claude generated files are stale:');
+  for (const line of output.split('\n').filter((l: string) => l.startsWith('STALE'))) {
+    console.log(`      ${line}`);
+  }
+  console.log('      Run: bun run gen:skill-docs');
+}
+
+console.log('\n  Freshness (Codex):');
+try {
+  execSync('bun run scripts/gen-skill-docs.ts --host codex --dry-run', { cwd: ROOT, stdio: 'pipe' });
+  console.log('  \u2705 All Codex generated files are fresh');
+} catch (err: any) {
+  hasErrors = true;
+  const output = err.stdout?.toString() || '';
+  console.log('  \u274c Codex generated files are stale:');
+  for (const line of output.split('\n').filter((l: string) => l.startsWith('STALE'))) {
+    console.log(`      ${line}`);
+  }
+  console.log('      Run: bun run gen:skill-docs --host codex');
+}
+
+console.log('');
+process.exit(hasErrors ? 1 : 0);

package/gstack-origin/setup

@@ -0,0 +1,269 @@
+#!/usr/bin/env bash
+# gstack setup — build browser binary + register skills with Claude Code / Codex
+set -e
+
+if ! command -v bun >/dev/null 2>&1; then
+  echo "Error: bun is required but not installed." >&2
+  echo "Install it: curl -fsSL https://bun.sh/install | bash" >&2
+  exit 1
+fi
+
+GSTACK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SKILLS_DIR="$(dirname "$GSTACK_DIR")"
+BROWSE_BIN="$GSTACK_DIR/browse/dist/browse"
+
+IS_WINDOWS=0
+case "$(uname -s)" in
+  MINGW*|MSYS*|CYGWIN*|Windows_NT) IS_WINDOWS=1 ;;
+esac
+
+# ─── Parse --host flag ─────────────────────────────────────────
+HOST="claude"
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --host) HOST="$2"; shift 2 ;;
+    --host=*) HOST="${1#--host=}"; shift ;;
+    *) shift ;;
+  esac
+done
+
+case "$HOST" in
+  claude|codex|auto) ;;
+  *) echo "Unknown --host value: $HOST (expected claude, codex, or auto)" >&2; exit 1 ;;
+esac
+
+# For auto: detect which agents are installed
+INSTALL_CLAUDE=0
+INSTALL_CODEX=0
+if [ "$HOST" = "auto" ]; then
+  command -v claude >/dev/null 2>&1 && INSTALL_CLAUDE=1
+  command -v codex >/dev/null 2>&1 && INSTALL_CODEX=1
+  # If neither found, default to claude
+  if [ "$INSTALL_CLAUDE" -eq 0 ] && [ "$INSTALL_CODEX" -eq 0 ]; then
+    INSTALL_CLAUDE=1
+  fi
+elif [ "$HOST" = "claude" ]; then
+  INSTALL_CLAUDE=1
+elif [ "$HOST" = "codex" ]; then
+  INSTALL_CODEX=1
+fi
+
+ensure_playwright_browser() {
+  if [ "$IS_WINDOWS" -eq 1 ]; then
+    # On Windows, Bun can't launch Chromium due to broken pipe handling
+    # (oven-sh/bun#4253). Use Node.js to verify Chromium works instead.
+    (
+      cd "$GSTACK_DIR"
+      node -e "const { chromium } = require('playwright'); (async () => { const b = await chromium.launch(); await b.close(); })()" 2>/dev/null
+    )
+  else
+    (
+      cd "$GSTACK_DIR"
+      bun --eval 'import { chromium } from "playwright"; const browser = await chromium.launch(); await browser.close();'
+    ) >/dev/null 2>&1
+  fi
+}
+
+# 1. Build browse binary if needed (smart rebuild: stale sources, package.json, lock)
+NEEDS_BUILD=0
+if [ ! -x "$BROWSE_BIN" ]; then
+  NEEDS_BUILD=1
+elif [ -n "$(find "$GSTACK_DIR/browse/src" -type f -newer "$BROWSE_BIN" -print -quit 2>/dev/null)" ]; then
+  NEEDS_BUILD=1
+elif [ "$GSTACK_DIR/package.json" -nt "$BROWSE_BIN" ]; then
+  NEEDS_BUILD=1
+elif [ -f "$GSTACK_DIR/bun.lock" ] && [ "$GSTACK_DIR/bun.lock" -nt "$BROWSE_BIN" ]; then
+  NEEDS_BUILD=1
+fi
+
+if [ "$NEEDS_BUILD" -eq 1 ]; then
+  echo "Building browse binary..."
+  (
+    cd "$GSTACK_DIR"
+    bun install
+    bun run build
+  )
+  # Safety net: write .version if build script didn't (e.g., git not available during build)
+  if [ ! -f "$GSTACK_DIR/browse/dist/.version" ]; then
+    git -C "$GSTACK_DIR" rev-parse HEAD > "$GSTACK_DIR/browse/dist/.version" 2>/dev/null || true
+  fi
+fi
+
+if [ ! -x "$BROWSE_BIN" ]; then
+  echo "gstack setup failed: browse binary missing at $BROWSE_BIN" >&2
+  exit 1
+fi
+
+# 2. Ensure Playwright's Chromium is available
+if ! ensure_playwright_browser; then
+  echo "Installing Playwright Chromium..."
+  (
+    cd "$GSTACK_DIR"
+    bunx playwright install chromium
+  )
+
+  if [ "$IS_WINDOWS" -eq 1 ]; then
+    # On Windows, Node.js launches Chromium (not Bun — see oven-sh/bun#4253).
+    # Ensure playwright is importable by Node from the gstack directory.
+    if ! command -v node >/dev/null 2>&1; then
+      echo "gstack setup failed: Node.js is required on Windows (Bun cannot launch Chromium due to a pipe bug)" >&2
+      echo "  Install Node.js: https://nodejs.org/" >&2
+      exit 1
+    fi
+    echo "Windows detected — verifying Node.js can load Playwright..."
+    (
+      cd "$GSTACK_DIR"
+      # Bun's node_modules already has playwright; verify Node can require it
+      node -e "require('playwright')" 2>/dev/null || npm install --no-save playwright
+    )
+  fi
+fi
+
+if ! ensure_playwright_browser; then
+  if [ "$IS_WINDOWS" -eq 1 ]; then
+    echo "gstack setup failed: Playwright Chromium could not be launched via Node.js" >&2
+    echo "  This is a known issue with Bun on Windows (oven-sh/bun#4253)." >&2
+    echo "  Ensure Node.js is installed and 'node -e \"require('playwright')\"' works." >&2
+  else
+    echo "gstack setup failed: Playwright Chromium could not be launched" >&2
+  fi
+  exit 1
+fi
+
+# 3. Ensure ~/.gstack global state directory exists
+mkdir -p "$HOME/.gstack/projects"
+
+# ─── Helper: link Claude skill subdirectories into a skills parent directory ──
+link_claude_skill_dirs() {
+  local gstack_dir="$1"
+  local skills_dir="$2"
+  local linked=()
+  for skill_dir in "$gstack_dir"/*/; do
+    if [ -f "$skill_dir/SKILL.md" ]; then
+      skill_name="$(basename "$skill_dir")"
+      # Skip node_modules
+      [ "$skill_name" = "node_modules" ] && continue
+      target="$skills_dir/$skill_name"
+      # Create or update symlink; skip if a real file/directory exists
+      if [ -L "$target" ] || [ ! -e "$target" ]; then
+        ln -snf "gstack/$skill_name" "$target"
+        linked+=("$skill_name")
+      fi
+    fi
+  done
+  if [ ${#linked[@]} -gt 0 ]; then
+    echo "  linked skills: ${linked[*]}"
+  fi
+}
+
+# ─── Helper: link generated Codex skills into a skills parent directory ──
+# Installs from .agents/skills/gstack-* (the generated Codex-format skills)
+# instead of source dirs (which have Claude paths).
+link_codex_skill_dirs() {
+  local gstack_dir="$1"
+  local skills_dir="$2"
+  local agents_dir="$gstack_dir/.agents/skills"
+  local linked=()
+
+  if [ ! -d "$agents_dir" ]; then
+    echo "  warning: no .agents/skills/ directory found — run 'bun run build' first" >&2
+    return 1
+  fi
+
+  for skill_dir in "$agents_dir"/gstack*/; do
+    if [ -f "$skill_dir/SKILL.md" ]; then
+      skill_name="$(basename "$skill_dir")"
+      target="$skills_dir/$skill_name"
+      # Create or update symlink
+      if [ -L "$target" ] || [ ! -e "$target" ]; then
+        ln -snf "$skill_dir" "$target"
+        linked+=("$skill_name")
+      fi
+    fi
+  done
+  if [ ${#linked[@]} -gt 0 ]; then
+    echo "  linked skills: ${linked[*]}"
+  fi
+}
+
+# ─── Helper: create .agents/skills/gstack/ sidecar symlinks ──────────
+# Codex/Gemini/Cursor read skills from .agents/skills/. We link runtime
+# assets (bin/, browse/dist/, review/, qa/, etc.) so skill templates can
+# resolve paths like $SKILL_ROOT/review/design-checklist.md.
+create_agents_sidecar() {
+  local repo_root="$1"
+  local agents_gstack="$repo_root/.agents/skills/gstack"
+  mkdir -p "$agents_gstack"
+
+  # Sidecar directories that skills reference at runtime
+  for asset in bin browse review qa; do
+    local src="$GSTACK_DIR/$asset"
+    local dst="$agents_gstack/$asset"
+    if [ -d "$src" ] || [ -f "$src" ]; then
+      if [ -L "$dst" ] || [ ! -e "$dst" ]; then
+        ln -snf "$src" "$dst"
+      fi
+    fi
+  done
+
+  # Sidecar files that skills reference at runtime
+  for file in ETHOS.md; do
+    local src="$GSTACK_DIR/$file"
+    local dst="$agents_gstack/$file"
+    if [ -f "$src" ]; then
+      if [ -L "$dst" ] || [ ! -e "$dst" ]; then
+        ln -snf "$src" "$dst"
+      fi
+    fi
+  done
+}
+
+# 4. Install for Claude (default)
+SKILLS_BASENAME="$(basename "$SKILLS_DIR")"
+if [ "$INSTALL_CLAUDE" -eq 1 ]; then
+  if [ "$SKILLS_BASENAME" = "skills" ]; then
+    link_claude_skill_dirs "$GSTACK_DIR" "$SKILLS_DIR"
+    echo "gstack ready (claude)."
+    echo "  browse: $BROWSE_BIN"
+  else
+    echo "gstack ready (claude)."
+    echo "  browse: $BROWSE_BIN"
+    echo "  (skipped skill symlinks — not inside .claude/skills/)"
+  fi
+fi
+
+# 5. Install for Codex
+if [ "$INSTALL_CODEX" -eq 1 ]; then
+  CODEX_SKILLS="$HOME/.codex/skills"
+  CODEX_GSTACK="$CODEX_SKILLS/gstack"
+  mkdir -p "$CODEX_SKILLS"
+
+  # Symlink gstack source for runtime assets (bin/, browse/dist/)
+  if [ -L "$CODEX_GSTACK" ] || [ ! -e "$CODEX_GSTACK" ]; then
+    ln -snf "$GSTACK_DIR" "$CODEX_GSTACK"
+  fi
+  # Install generated Codex-format skills (not Claude source dirs)
+  link_codex_skill_dirs "$GSTACK_DIR" "$CODEX_SKILLS"
+
+  echo "gstack ready (codex)."
+  echo "  browse: $BROWSE_BIN"
+  echo "  codex skills: $CODEX_SKILLS"
+fi
+
+# 6. Create .agents/ sidecar symlinks (useful for Codex/Gemini/Cursor workspace-local)
+if [ "$INSTALL_CODEX" -eq 1 ]; then
+  # Detect repo root: if we're inside a skills directory, go up two levels
+  if [ "$SKILLS_BASENAME" = "skills" ]; then
+    REPO_ROOT="$(dirname "$SKILLS_DIR")"
+  else
+    REPO_ROOT="$GSTACK_DIR"
+  fi
+  create_agents_sidecar "$REPO_ROOT"
+fi
+
+# 7. First-time welcome + legacy cleanup
+if [ ! -d "$HOME/.gstack" ]; then
+  mkdir -p "$HOME/.gstack"
+  echo "  Welcome! Run /gstack-upgrade anytime to stay current."
+fi
+rm -f /tmp/gstack-latest-version