@farazirfan/costar-server-executor 1.0.0

package/scripts/install.sh

@@ -0,0 +1,311 @@
+#!/usr/bin/env bash
+# CoStar Server Executor - One-Line Installer
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/farazirfan47/costar-server-executor/main/scripts/install.sh | bash
+#
+# Or with options:
+#   curl -fsSL ... | bash -s -- --non-interactive
+#
+# This script:
+#   1. Checks/installs Node.js >= 18
+#   2. Installs costar-server-executor via npm
+#   3. Installs Chromium for browser automation
+#   4. Runs 'costar setup' interactively
+#   5. Optionally installs as a system service
+#
+set -euo pipefail
+
+# ─── Constants ──────────────────────────────────────────────────
+
+PACKAGE_NAME="@farazirfan/costar-server-executor"
+MIN_NODE_VERSION=18
+COSTAR_DIR="${COSTAR_STATE_DIR:-$HOME/.costar}"
+NON_INTERACTIVE=false
+SKIP_BROWSER=false
+SKIP_SERVICE=false
+
+# ─── Colors ─────────────────────────────────────────────────────
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+# ─── Helpers ────────────────────────────────────────────────────
+
+log()   { echo -e "${BLUE}[costar]${NC} $*"; }
+ok()    { echo -e "${GREEN}  ✓${NC} $*"; }
+warn()  { echo -e "${YELLOW}  !${NC} $*"; }
+err()   { echo -e "${RED}  ✗${NC} $*"; }
+fatal() { err "$*"; exit 1; }
+
+# ─── Parse Arguments ───────────────────────────────────────────
+
+for arg in "$@"; do
+  case "$arg" in
+    --non-interactive) NON_INTERACTIVE=true ;;
+    --skip-browser) SKIP_BROWSER=true ;;
+    --skip-service) SKIP_SERVICE=true ;;
+    --npm-token=*) NPM_TOKEN="${arg#--npm-token=}" ;;
+    --help|-h)
+      echo "CoStar Server Executor Installer"
+      echo ""
+      echo "Usage: curl -fsSL <url>/install.sh | bash [-s -- OPTIONS]"
+      echo ""
+      echo "Options:"
+      echo "  --npm-token=<TOK>  npm auth token (required for private package)"
+      echo "  --non-interactive  Skip interactive prompts"
+      echo "  --skip-browser     Skip Chromium installation"
+      echo "  --skip-service     Skip service installation prompt"
+      echo "  --help             Show this help"
+      echo ""
+      echo "Environment Variables:"
+      echo "  NPM_TOKEN              npm auth token (alternative to --npm-token)"
+      echo "  USER_ID                CoStar user ID (for --non-interactive)"
+      echo "  SUPABASE_URL           Supabase project URL"
+      echo "  SUPABASE_SERVICE_KEY   Supabase service role key"
+      echo "  ANTHROPIC_API_KEY      Anthropic API key"
+      exit 0
+      ;;
+  esac
+done
+
+# ─── Banner ─────────────────────────────────────────────────────
+
+echo ""
+echo -e "${BOLD}╔═══════════════════════════════════════════════════════╗${NC}"
+echo -e "${BOLD}║     CoStar Server Executor - Installer                ║${NC}"
+echo -e "${BOLD}║  24/7 Autonomous AI Agent for Dual-Executor System    ║${NC}"
+echo -e "${BOLD}╚═══════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# ─── OS Detection ───────────────────────────────────────────────
+
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+
+case "$OS" in
+  Darwin) PLATFORM="macOS" ;;
+  Linux)  PLATFORM="Linux" ;;
+  *)      fatal "Unsupported OS: $OS. CoStar supports macOS and Linux." ;;
+esac
+
+log "Detected: $PLATFORM ($ARCH)"
+
+# ─── Step 1: Check/Install Node.js ─────────────────────────────
+
+log "Step 1/5: Checking Node.js..."
+
+check_node_version() {
+  if command -v node &>/dev/null; then
+    local version
+    version="$(node --version | sed 's/^v//')"
+    local major
+    major="$(echo "$version" | cut -d. -f1)"
+    if [ "$major" -ge "$MIN_NODE_VERSION" ]; then
+      ok "Node.js v$version (>= $MIN_NODE_VERSION required)"
+      return 0
+    else
+      warn "Node.js v$version found, but >= $MIN_NODE_VERSION required"
+      return 1
+    fi
+  else
+    warn "Node.js not found"
+    return 1
+  fi
+}
+
+install_node() {
+  log "Installing Node.js via nvm..."
+  
+  # Install nvm if not present
+  if [ ! -d "$HOME/.nvm" ]; then
+    log "Installing nvm..."
+    curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
+    
+    # Source nvm
+    export NVM_DIR="$HOME/.nvm"
+    # shellcheck disable=SC1091
+    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+  else
+    export NVM_DIR="$HOME/.nvm"
+    # shellcheck disable=SC1091
+    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+    ok "nvm already installed"
+  fi
+  
+  # Install latest LTS
+  log "Installing Node.js LTS..."
+  nvm install --lts
+  nvm use --lts
+  ok "Node.js $(node --version) installed"
+}
+
+if ! check_node_version; then
+  if [ "$NON_INTERACTIVE" = true ]; then
+    install_node
+  else
+    echo ""
+    read -rp "  Install Node.js? (y/n) [y]: " install_node_answer
+    install_node_answer="${install_node_answer:-y}"
+    if [ "${install_node_answer,,}" = "y" ]; then
+      install_node
+    else
+      fatal "Node.js >= $MIN_NODE_VERSION is required. Install from https://nodejs.org"
+    fi
+  fi
+fi
+
+# ─── Step 2: Install CoStar package ────────────────────────────
+
+log "Step 2/5: Installing CoStar Server Executor..."
+
+NPM_TOKEN="${NPM_TOKEN:-}"
+
+# Set up npm auth for private package
+if [ -n "$NPM_TOKEN" ]; then
+  log "Configuring npm auth for private package..."
+  npm config set //registry.npmjs.org/:_authToken "$NPM_TOKEN"
+  ok "npm auth configured"
+fi
+
+# Verify npm can access the package
+if ! npm view "$PACKAGE_NAME" version &>/dev/null 2>&1; then
+  if [ -z "$NPM_TOKEN" ]; then
+    fatal "Cannot access $PACKAGE_NAME. This is a private package - provide --npm-token=<TOKEN> or set NPM_TOKEN env var."
+  else
+    fatal "Cannot access $PACKAGE_NAME. Check that your npm token has read access."
+  fi
+fi
+
+if command -v costar &>/dev/null; then
+  ok "CoStar already installed, updating..."
+  npm install -g "$PACKAGE_NAME@latest"
+else
+  npm install -g "$PACKAGE_NAME"
+fi
+
+ok "CoStar $(costar --version 2>/dev/null || echo 'v1.0.0') installed"
+
+# ─── Step 3: Install Chromium ───────────────────────────────────
+
+log "Step 3/5: Installing Chromium for browser automation..."
+
+if [ "$SKIP_BROWSER" = true ]; then
+  warn "Skipping Chromium installation (--skip-browser)"
+else
+  # Check for existing browser
+  BROWSER_FOUND=false
+
+  if [ "$PLATFORM" = "macOS" ]; then
+    for app in "Google Chrome" "Chromium" "Brave Browser" "Microsoft Edge"; do
+      if [ -d "/Applications/${app}.app" ]; then
+        ok "Found: $app"
+        BROWSER_FOUND=true
+        break
+      fi
+    done
+  else
+    for bin in google-chrome google-chrome-stable chromium chromium-browser; do
+      if command -v "$bin" &>/dev/null; then
+        ok "Found: $bin"
+        BROWSER_FOUND=true
+        break
+      fi
+    done
+  fi
+
+  if [ "$BROWSER_FOUND" = false ]; then
+    log "Installing Chromium via Playwright..."
+    
+    # Install Playwright Chromium with system dependencies
+    if [ "$PLATFORM" = "Linux" ]; then
+      # On Linux, install system dependencies first
+      if command -v apt-get &>/dev/null; then
+        log "Installing system dependencies..."
+        sudo apt-get update -qq
+        sudo apt-get install -y -qq \
+          libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 \
+          libcups2 libdrm2 libdbus-1-3 libxkbcommon0 \
+          libatspi2.0-0 libxcomposite1 libxdamage1 \
+          libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 \
+          libasound2 libwayland-client0 2>/dev/null || true
+      fi
+    fi
+    
+    npx playwright install chromium --with-deps 2>/dev/null || {
+      warn "Playwright Chromium install failed. Browser tool may not work."
+      warn "Install manually: npx playwright install chromium --with-deps"
+    }
+    ok "Chromium installed"
+  fi
+fi
+
+# ─── Step 4: Create directories ────────────────────────────────
+
+log "Step 4/5: Setting up CoStar directories..."
+
+mkdir -p "$COSTAR_DIR"
+mkdir -p "$COSTAR_DIR/logs"
+mkdir -p "$COSTAR_DIR/sessions"
+mkdir -p "$COSTAR_DIR/workspace"
+
+ok "Created: ~/.costar/"
+ok "Created: ~/.costar/logs/"
+ok "Created: ~/.costar/sessions/"
+ok "Created: ~/.costar/workspace/"
+
+# ─── Step 5: Run Setup ─────────────────────────────────────────
+
+log "Step 5/5: Running setup..."
+
+if [ "$NON_INTERACTIVE" = true ]; then
+  costar setup --non-interactive
+else
+  costar setup
+fi
+
+# ─── Install Service ────────────────────────────────────────────
+
+if [ "$SKIP_SERVICE" = false ]; then
+  if [ "$NON_INTERACTIVE" = true ]; then
+    # Non-interactive: auto-install service (the whole point of a 24/7 sandbox)
+    log "Installing as system service (auto-start on boot)..."
+    costar service install
+  else
+    echo ""
+    read -rp "  Install as system service (auto-start on boot)? (y/n) [y]: " install_service
+    install_service="${install_service:-y}"
+    if [ "${install_service,,}" = "y" ]; then
+      costar service install
+    fi
+  fi
+fi
+
+# ─── Done ───────────────────────────────────────────────────────
+
+echo ""
+echo -e "${BOLD}╔═══════════════════════════════════════════════════════╗${NC}"
+echo -e "${BOLD}║  Installation Complete!                                ║${NC}"
+echo -e "${BOLD}╚═══════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "  ${BOLD}Quick Start:${NC}"
+echo "    costar start            Start the agent (foreground)"
+echo "    costar service install  Install as background service"
+echo "    costar status           Check system status"
+echo "    costar doctor           Verify dependencies"
+echo ""
+echo -e "  ${BOLD}Configuration:${NC}"
+echo "    costar setup            Re-run setup wizard"
+echo "    costar config           View current config"
+echo "    Edit:  ~/.costar/.env"
+echo ""
+echo -e "  ${BOLD}Service Management:${NC}"
+echo "    costar service install    Install auto-start service"
+echo "    costar service uninstall  Remove service"
+echo "    costar service restart    Restart service"
+echo "    costar service logs       View logs"
+echo ""

package/scripts/postinstall.js

@@ -0,0 +1,135 @@
+/**
+ * CoStar Server Executor - Postinstall Script
+ * 
+ * Runs after npm install to:
+ * 1. Ensure the CLI entry point is executable
+ * 2. Attempt to install Playwright Chromium (for browser tool)
+ * 3. Create ~/.costar directory
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+function getRepoRoot() {
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  return path.resolve(here, "..");
+}
+
+function ensureExecutable(targetPath) {
+  if (process.platform === "win32") return;
+  if (!fs.existsSync(targetPath)) return;
+  try {
+    const mode = fs.statSync(targetPath).mode & 0o777;
+    if (mode & 0o100) return;
+    fs.chmodSync(targetPath, 0o755);
+    console.log(`[postinstall] Made executable: ${targetPath}`);
+  } catch (err) {
+    console.warn(`[postinstall] chmod failed: ${err}`);
+  }
+}
+
+function createCoStarDir() {
+  const dir = process.env.COSTAR_STATE_DIR || path.join(os.homedir(), ".costar");
+  const subdirs = [dir, path.join(dir, "logs"), path.join(dir, "sessions")];
+
+  for (const d of subdirs) {
+    if (!fs.existsSync(d)) {
+      try {
+        fs.mkdirSync(d, { recursive: true });
+        console.log(`[postinstall] Created: ${d}`);
+      } catch (err) {
+        console.warn(`[postinstall] Could not create ${d}: ${err}`);
+      }
+    }
+  }
+}
+
+function installPlaywrightBrowsers() {
+  // Only attempt if not in CI/test environment
+  if (process.env.CI === "true" || process.env.VITEST === "true" || process.env.NODE_ENV === "test") {
+    console.log("[postinstall] Skipping browser install in CI/test environment");
+    return;
+  }
+
+  // Check if Playwright is available
+  try {
+    const result = spawnSync("npx", ["playwright", "--version"], {
+      stdio: "pipe",
+      encoding: "utf-8",
+      timeout: 10_000,
+    });
+
+    if (result.status !== 0) {
+      console.log("[postinstall] Playwright not available, skipping browser install");
+      return;
+    }
+  } catch {
+    console.log("[postinstall] Could not check Playwright, skipping browser install");
+    return;
+  }
+
+  // Check if Chromium is already installed
+  console.log("[postinstall] Checking for Chromium...");
+
+  // Check system browsers first
+  const systemBrowsers = process.platform === "darwin"
+    ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"]
+    : ["/usr/bin/google-chrome", "/usr/bin/chromium", "/usr/bin/chromium-browser"];
+
+  for (const browser of systemBrowsers) {
+    if (fs.existsSync(browser)) {
+      console.log(`[postinstall] System browser found: ${browser}`);
+      return;
+    }
+  }
+
+  // Install Playwright Chromium
+  console.log("[postinstall] Installing Chromium via Playwright (this may take a minute)...");
+  console.log("[postinstall] To skip, set COSTAR_SKIP_BROWSER=1");
+
+  if (process.env.COSTAR_SKIP_BROWSER === "1") {
+    console.log("[postinstall] Browser install skipped (COSTAR_SKIP_BROWSER=1)");
+    return;
+  }
+
+  const installResult = spawnSync("npx", ["playwright", "install", "chromium"], {
+    stdio: "inherit",
+    timeout: 300_000, // 5 min
+  });
+
+  if (installResult.status === 0) {
+    console.log("[postinstall] Chromium installed successfully");
+  } else {
+    console.warn("[postinstall] Chromium install failed. Browser tool may not work.");
+    console.warn("[postinstall] Install manually: npx playwright install chromium --with-deps");
+  }
+}
+
+// ─── Main ──────────────────────────────────────────────────────
+
+try {
+  const skip =
+    process.env.COSTAR_SKIP_POSTINSTALL === "1" ||
+    process.env.VITEST === "true" ||
+    process.env.NODE_ENV === "test";
+
+  if (!skip) {
+    const repoRoot = getRepoRoot();
+
+    // Make CLI entry executable
+    ensureExecutable(path.join(repoRoot, "dist", "cli.js"));
+    ensureExecutable(path.join(repoRoot, "costar.mjs"));
+
+    // Create config directory
+    createCoStarDir();
+
+    // Install Chromium (optional, may fail gracefully)
+    installPlaywrightBrowsers();
+  }
+} catch (err) {
+  // Postinstall should never fail the npm install
+  console.warn(`[postinstall] Warning: ${err}`);
+}

package/skills/commit/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: commit
+description: Create git commits with proper formatting and commit messages. Follows Conventional Commits standard.
+homepage: https://www.conventionalcommits.org/
+metadata:
+  emoji: "📝"
+  requires:
+    bins: ["git"]
+---
+
+# Commit Skill
+
+Create well-formatted git commits following best practices.
+
+## Usage
+
+Before committing:
+1. Check git status to see what's changed
+2. Review the diff to understand changes
+3. Stage only related files together
+4. Write clear, concise commit messages
+
+## Commit Message Format
+
+Follow Conventional Commits:
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+Types:
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `style`: Formatting (no code change)
+- `refactor`: Code refactoring
+- `test`: Adding tests
+- `chore`: Maintenance
+
+## Examples
+
+Simple commit:
+```bash
+git add src/tools/new-tool.ts
+git commit -m "feat(tools): add new-tool for API calls"
+```
+
+Commit with body:
+```bash
+git commit -m "fix(auth): handle expired tokens
+
+Tokens are now refreshed automatically when they expire.
+Previously this would cause auth failures.
+
+Fixes #123"
+```
+
+## Best Practices
+
+1. **Atomic commits**: Each commit should be a single logical change
+2. **Clear messages**: Describe what and why, not how
+3. **Present tense**: "Add feature" not "Added feature"
+4. **Imperative mood**: "Fix bug" not "Fixes bug"
+5. **Reference issues**: Include issue numbers when relevant
+6. **Review before commit**: Always check `git diff --staged`

package/skills/review-pr/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: review-pr
+description: Review pull requests using GitHub CLI. Check code changes, CI status, and provide feedback.
+homepage: https://cli.github.com/manual/gh_pr
+metadata:
+  emoji: "👀"
+  requires:
+    bins: ["gh"]
+  install:
+    - id: brew
+      kind: brew
+      formula: gh
+      bins: ["gh"]
+      label: "Install GitHub CLI (brew)"
+    - id: apt
+      kind: apt
+      package: gh
+      bins: ["gh"]
+      label: "Install GitHub CLI (apt)"
+---
+
+# Review PR Skill
+
+Review pull requests efficiently using GitHub CLI.
+
+## Viewing PRs
+
+**List open PRs:**
+```bash
+gh pr list
+```
+
+**View specific PR:**
+```bash
+gh pr view 123
+```
+
+**View PR diff:**
+```bash
+gh pr diff 123
+```
+
+**Checkout PR locally:**
+```bash
+gh pr checkout 123
+```
+
+## Checking CI Status
+
+**View checks:**
+```bash
+gh pr checks 123
+```
+
+**Watch checks (live updates):**
+```bash
+gh pr checks 123 --watch
+```
+
+## Reviewing
+
+**View review comments:**
+```bash
+gh pr view 123 --comments
+```
+
+**Leave review comment:**
+```bash
+gh pr review 123 --comment --body "LGTM!"
+```
+
+**Request changes:**
+```bash
+gh pr review 123 --request-changes --body "Please fix..."
+```
+
+**Approve:**
+```bash
+gh pr review 123 --approve
+```
+
+## Best Practices
+
+1. **Check CI first**: Ensure tests pass before detailed review
+2. **Review diff**: Look at `gh pr diff` for context
+3. **Test locally**: Check out the PR if needed
+4. **Constructive feedback**: Be specific and helpful
+5. **Approve or request changes**: Don't leave hanging PRs
+
+## Advanced
+
+**View specific files:**
+```bash
+gh pr diff 123 --name-only
+```
+
+**Check review status:**
+```bash
+gh pr view 123 --json reviewDecision
+```
+
+**Merge after approval:**
+```bash
+gh pr merge 123 --squash
+```