eai-cli 0.0.0-bootstrap.0

package/resources/gofer/bash-scripts/install-optional-tools.sh

@@ -0,0 +1,270 @@
+#!/usr/bin/env bash
+
+set -u
+
+WORKSPACE_PATH=""
+TOOLS_CSV=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --workspace-path)
+      WORKSPACE_PATH="${2:-}"
+      shift 2
+      ;;
+    --tools)
+      TOOLS_CSV="${2:-}"
+      shift 2
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      shift
+      ;;
+  esac
+done
+
+if [[ -z "$WORKSPACE_PATH" ]]; then
+  WORKSPACE_PATH="$(pwd)"
+fi
+
+if [[ -z "$TOOLS_CSV" ]]; then
+  echo "No tools selected. Nothing to install."
+  exit 0
+fi
+
+IFS=',' read -r -a TOOLS <<< "$TOOLS_CSV"
+
+REPO_ROOT="$WORKSPACE_PATH"
+
+HAS_FAILURE=0
+
+log_info() {
+  printf '[gofer] %s\n' "$1"
+}
+
+log_warn() {
+  printf '[gofer] WARNING: %s\n' "$1"
+}
+
+log_error() {
+  printf '[gofer] ERROR: %s\n' "$1" >&2
+}
+
+has_command() {
+  command -v "$1" >/dev/null 2>&1
+}
+
+run_command() {
+  local description="$1"
+  shift
+
+  log_info "$description"
+  if "$@"; then
+    return 0
+  fi
+
+  HAS_FAILURE=1
+  log_error "Failed: $description"
+  return 1
+}
+
+detect_js_package_manager() {
+  if [[ -f "$REPO_ROOT/bun.lockb" ]]; then
+    echo "bun"
+    return
+  fi
+
+  if [[ -f "$REPO_ROOT/pnpm-lock.yaml" ]]; then
+    echo "pnpm"
+    return
+  fi
+
+  if [[ -f "$REPO_ROOT/yarn.lock" ]]; then
+    echo "yarn"
+    return
+  fi
+
+  if [[ -f "$REPO_ROOT/package.json" ]]; then
+    echo "npm"
+    return
+  fi
+
+  echo ""
+}
+
+install_repo_package() {
+  local package_manager="$1"
+  local package_name="$2"
+
+  case "$package_manager" in
+    npm)
+      run_command "Installing $package_name with npm" npm install --save-dev "$package_name"
+      ;;
+    pnpm)
+      run_command "Installing $package_name with pnpm" pnpm add --save-dev "$package_name"
+      ;;
+    yarn)
+      run_command "Installing $package_name with yarn" yarn add --dev "$package_name"
+      ;;
+    bun)
+      run_command "Installing $package_name with bun" bun add --dev "$package_name"
+      ;;
+    *)
+      HAS_FAILURE=1
+      log_warn "No supported JS package manager detected for $package_name"
+      ;;
+  esac
+}
+
+install_playwright_browsers() {
+  if [[ ! -f "$REPO_ROOT/package.json" ]]; then
+    log_warn "Skipping Playwright browser install because package.json was not found"
+    return
+  fi
+
+  (
+    cd "$REPO_ROOT" || exit 1
+    run_command "Installing Playwright browsers" npx playwright install
+  )
+}
+
+install_with_npm_global() {
+  local package_name="$1"
+
+  if ! has_command npm; then
+    HAS_FAILURE=1
+    log_warn "npm is required to install $package_name globally"
+    return
+  fi
+
+  run_command "Installing $package_name globally with npm" npm install --global "$package_name"
+}
+
+install_gh_cli() {
+  if has_command gh; then
+    log_info "GitHub CLI is already installed"
+    return
+  fi
+
+  if [[ "$OSTYPE" == darwin* ]]; then
+    if has_command brew; then
+      run_command "Installing GitHub CLI with Homebrew" brew install gh
+      return
+    fi
+  fi
+
+  if has_command apt-get; then
+    run_command "Updating apt package index for GitHub CLI" sudo apt-get update
+    run_command "Installing GitHub CLI with apt-get" sudo apt-get install --yes gh
+    return
+  fi
+
+  if has_command dnf; then
+    run_command "Installing GitHub CLI with dnf" sudo dnf install --assumeyes gh
+    return
+  fi
+
+  if has_command yum; then
+    run_command "Installing GitHub CLI with yum" sudo yum install --assumeyes gh
+    return
+  fi
+
+  if has_command zypper; then
+    run_command "Installing GitHub CLI with zypper" sudo zypper --non-interactive install gh
+    return
+  fi
+
+  HAS_FAILURE=1
+  log_warn "No supported package manager found to install GitHub CLI"
+}
+
+install_azure_cli() {
+  if has_command az; then
+    log_info "Azure CLI is already installed"
+    return
+  fi
+
+  if [[ "$OSTYPE" == darwin* ]]; then
+    if has_command brew; then
+      run_command "Installing Azure CLI with Homebrew" brew install azure-cli
+      return
+    fi
+  fi
+
+  if has_command apt-get; then
+    run_command "Installing Azure CLI using Microsoft Debian installer" bash -c "curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash"
+    return
+  fi
+
+  if has_command dnf; then
+    run_command "Registering Microsoft package feed for Azure CLI" sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+    run_command "Installing Microsoft package feed for Azure CLI" bash -c 'sudo dnf install --assumeyes "https://packages.microsoft.com/config/rhel/$(rpm -E %rhel)/packages-microsoft-prod.rpm"'
+    run_command "Installing Azure CLI with dnf" sudo dnf install --assumeyes azure-cli
+    return
+  fi
+
+  if has_command yum; then
+    run_command "Registering Microsoft package feed for Azure CLI" sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+    run_command "Installing Microsoft package feed for Azure CLI" bash -c 'sudo yum install --assumeyes "https://packages.microsoft.com/config/rhel/$(rpm -E %rhel)/packages-microsoft-prod.rpm"'
+    run_command "Installing Azure CLI with yum" sudo yum install --assumeyes azure-cli
+    return
+  fi
+
+  HAS_FAILURE=1
+  log_warn "No supported package manager found to install Azure CLI"
+}
+
+log_info "Workspace: $REPO_ROOT"
+log_info "Selected tools: $TOOLS_CSV"
+
+PACKAGE_MANAGER="$(detect_js_package_manager)"
+
+for tool in "${TOOLS[@]}"; do
+  case "$tool" in
+    stryker)
+      install_repo_package "$PACKAGE_MANAGER" "@stryker-mutator/core"
+      ;;
+    playwright)
+      install_repo_package "$PACKAGE_MANAGER" "@playwright/test"
+      install_playwright_browsers
+      ;;
+    claude)
+      install_with_npm_global "@anthropic-ai/claude-code"
+      ;;
+    codex)
+      install_with_npm_global "@openai/codex-cli"
+      ;;
+    copilot)
+      install_with_npm_global "@github/copilot"
+      ;;
+    gemini)
+      install_with_npm_global "@google/gemini-cli"
+      ;;
+    gh)
+      install_gh_cli
+      ;;
+    az)
+      install_azure_cli
+      ;;
+    "")
+      ;;
+    *)
+      HAS_FAILURE=1
+      log_warn "Unknown tool id: $tool"
+      ;;
+  esac
+done
+
+log_info "Suggested next steps:"
+log_info "  claude login"
+log_info "  codex login"
+log_info "  copilot login"
+log_info "  gemini auth login"
+log_info "  gh auth login"
+log_info "  az login"
+
+if [[ "$HAS_FAILURE" -ne 0 ]]; then
+  log_warn "Optional tool installation completed with warnings or failures"
+  exit 1
+fi
+
+log_info "Optional tool installation complete"

package/resources/gofer/bash-scripts/log-stage.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+# log-stage.sh - Log pipeline stage metrics for observability
+#
+# Usage: ./log-stage.sh STAGE [OPTIONS]
+#
+# Arguments:
+#   STAGE           The stage being logged (1_research, 2_specify, etc.)
+#
+# Options:
+#   --start         Log stage start (default if no completion options)
+#   --complete      Log stage completion
+#   --error MSG     Log stage error with message
+#   --tokens N      Token count for this stage
+#   --compactions N Number of context compactions
+#   --json          Output in JSON format
+#   --help          Show this help message
+#
+# Creates/appends to:
+#   - .specify/logs/pipeline.jsonl (stage metrics)
+#   - .specify/logs/quality-metrics.jsonl (quality data)
+#
+# Part of the Gofer observability system (Gap 8).
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Default options
+STAGE=""
+ACTION="start"
+TOKEN_COUNT=0
+COMPACTION_COUNT=0
+ERROR_MSG=""
+JSON_OUTPUT=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --start)
+            ACTION="start"
+            shift
+            ;;
+        --complete)
+            ACTION="complete"
+            shift
+            ;;
+        --error)
+            ACTION="error"
+            ERROR_MSG="$2"
+            shift 2
+            ;;
+        --tokens)
+            TOKEN_COUNT="$2"
+            shift 2
+            ;;
+        --compactions)
+            COMPACTION_COUNT="$2"
+            shift 2
+            ;;
+        --json)
+            JSON_OUTPUT=true
+            shift
+            ;;
+        --help)
+            head -25 "$0" | grep "^#" | sed 's/^# //' | sed 's/^#//'
+            exit 0
+            ;;
+        *)
+            if [[ -z "$STAGE" ]]; then
+                STAGE="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Validate stage
+if [[ -z "$STAGE" ]]; then
+    echo -e "${RED}Error: Stage name required${NC}"
+    echo "Usage: $0 STAGE [OPTIONS]"
+    exit 1
+fi
+
+# Get paths
+REPO_ROOT=$(get_repo_root)
+eval "$(get_feature_paths)"
+LOGS_DIR="$REPO_ROOT/.specify/logs"
+
+# Ensure logs directory exists
+mkdir -p "$LOGS_DIR"
+
+# Get timestamp
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Get feature name
+FEATURE_NAME=$(basename "$FEATURE_DIR" 2>/dev/null || echo "unknown")
+
+# Calculate duration for completion
+get_stage_duration() {
+    local stage="$1"
+    local pipeline_log="$LOGS_DIR/pipeline.jsonl"
+
+    if [[ -f "$pipeline_log" ]]; then
+        # Find the most recent start entry for this stage and feature
+        local start_time=$(grep "\"stage\":\"$stage\"" "$pipeline_log" | \
+            grep "\"feature\":\"$FEATURE_NAME\"" | \
+            grep "\"action\":\"start\"" | \
+            tail -1 | \
+            grep -oE '"timestamp":"[^"]+"' | \
+            grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}')
+
+        if [[ -n "$start_time" ]]; then
+            # Calculate duration (simplified - just return the difference in minutes)
+            local start_epoch=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$start_time" "+%s" 2>/dev/null || echo "0")
+            local now_epoch=$(date "+%s")
+            local diff=$((now_epoch - start_epoch))
+            local minutes=$((diff / 60))
+            echo "PT${minutes}M"
+            return
+        fi
+    fi
+    echo "PT0M"
+}
+
+# Log to pipeline.jsonl
+log_pipeline_event() {
+    local pipeline_log="$LOGS_DIR/pipeline.jsonl"
+    local duration=""
+
+    if [[ "$ACTION" == "complete" ]]; then
+        duration=$(get_stage_duration "$STAGE")
+    fi
+
+    local entry=$(cat <<EOF
+{"feature":"$FEATURE_NAME","stage":"$STAGE","action":"$ACTION","timestamp":"$TIMESTAMP","tokensUsed":$TOKEN_COUNT,"compactionEvents":$COMPACTION_COUNT,"duration":"$duration","error":"$ERROR_MSG"}
+EOF
+)
+
+    echo "$entry" >> "$pipeline_log"
+    echo "$entry"
+}
+
+# Get quality metrics
+get_quality_metrics() {
+    local test_coverage="0"
+    local lint_issues="0"
+    local type_errors="0"
+
+    # Try to get test coverage
+    if [[ -f "$REPO_ROOT/coverage/coverage-summary.json" ]]; then
+        test_coverage=$(grep -oE '"pct":[0-9.]+' "$REPO_ROOT/coverage/coverage-summary.json" | head -1 | grep -oE '[0-9.]+' || echo "0")
+    fi
+
+    # Try to count lint issues (from most recent lint run)
+    if command -v npm &> /dev/null && [[ -f "$REPO_ROOT/package.json" ]]; then
+        lint_issues=$(npm run lint 2>&1 | grep -cE "warning|error" || echo "0")
+    fi
+
+    echo "COVERAGE='$test_coverage'"
+    echo "LINT_ISSUES='$lint_issues'"
+}
+
+# Log quality metrics (only on stage complete)
+log_quality_metrics() {
+    if [[ "$ACTION" != "complete" ]]; then
+        return
+    fi
+
+    local quality_log="$LOGS_DIR/quality-metrics.jsonl"
+    eval "$(get_quality_metrics)"
+
+    local entry=$(cat <<EOF
+{"feature":"$FEATURE_NAME","stage":"$STAGE","timestamp":"$TIMESTAMP","testCoverage":"$COVERAGE","lintIssues":"$LINT_ISSUES"}
+EOF
+)
+
+    echo "$entry" >> "$quality_log"
+}
+
+# Main execution
+main() {
+    local result=$(log_pipeline_event)
+    log_quality_metrics
+
+    if $JSON_OUTPUT; then
+        echo "$result"
+    else
+        echo ""
+        case $ACTION in
+            start)
+                echo -e "${BLUE}📊 Stage Started${NC}"
+                echo "   Feature: $FEATURE_NAME"
+                echo "   Stage: $STAGE"
+                echo "   Time: $TIMESTAMP"
+                ;;
+            complete)
+                echo -e "${GREEN}📊 Stage Completed${NC}"
+                echo "   Feature: $FEATURE_NAME"
+                echo "   Stage: $STAGE"
+                echo "   Tokens: $TOKEN_COUNT"
+                echo "   Compactions: $COMPACTION_COUNT"
+                ;;
+            error)
+                echo -e "${RED}📊 Stage Error${NC}"
+                echo "   Feature: $FEATURE_NAME"
+                echo "   Stage: $STAGE"
+                echo "   Error: $ERROR_MSG"
+                ;;
+        esac
+        echo ""
+        echo "   Log: $LOGS_DIR/pipeline.jsonl"
+    fi
+}
+
+main

package/resources/gofer/bash-scripts/mark-task-complete.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# Mark a task as complete in tasks.md
+#
+# Usage: mark-task-complete.sh <feature-dir> <task-id>
+# Example: mark-task-complete.sh .specify/specs/025-ai-usage-tracking T001
+
+set -euo pipefail
+
+FEATURE_DIR="${1:-.}"
+TASK_ID="${2:-}"
+
+if [[ -z "$TASK_ID" ]]; then
+  echo "ERROR: Task ID required"
+  echo "Usage: $0 <feature-dir> <task-id>"
+  echo "Example: $0 .specify/specs/025-ai-usage-tracking T001"
+  exit 1
+fi
+
+TASKS_FILE="$FEATURE_DIR/tasks.md"
+
+if [[ ! -f "$TASKS_FILE" ]]; then
+  echo "ERROR: tasks.md not found at $TASKS_FILE"
+  exit 1
+fi
+
+# Match common Gofer task formats:
+# - [ ] T001 Description
+# - [ ] #T001 Description
+# - [ ] **T001**: Description
+TASK_PATTERN="^[[:space:]]*-[[:space:]]+\\[[ Xx!bB>-]\\][[:space:]]+(\\*\\*${TASK_ID}\\*\\*:?([[:space:]]+|$)|#${TASK_ID}\\b|${TASK_ID}\\b)"
+COMPLETED_PATTERN="^[[:space:]]*-[[:space:]]+\\[[Xx]\\][[:space:]]+(\\*\\*${TASK_ID}\\*\\*:?([[:space:]]+|$)|#${TASK_ID}\\b|${TASK_ID}\\b)"
+
+if ! grep -Eq "$TASK_PATTERN" "$TASKS_FILE"; then
+  echo "ERROR: Task $TASK_ID not found in $TASKS_FILE"
+  exit 1
+fi
+
+if grep -Eq "$COMPLETED_PATTERN" "$TASKS_FILE"; then
+  echo "✓ Task $TASK_ID already marked complete"
+  exit 0
+fi
+
+# Mark task complete while preserving the rest of the line. Use awk instead of
+# sed capture groups so this stays portable across BSD and GNU userlands.
+awk -v task_id="$TASK_ID" '
+  BEGIN { changed = 0 }
+  {
+    line = $0
+    if (!changed && line ~ /^[[:space:]]*-[[:space:]]+\[[ Xx!bB>-]\][[:space:]]+/) {
+      rest = line
+      sub(/^[[:space:]]*-[[:space:]]+\[[ Xx!bB>-]\][[:space:]]+/, "", rest)
+      matches_task = rest ~ ("^\\*\\*" task_id "\\*\\*:?([[:space:]]+|$)") ||
+        rest ~ ("^#" task_id "([^[:alnum:]_]|$)") ||
+        rest ~ ("^" task_id "([^[:alnum:]_]|$)")
+      if (matches_task) {
+        sub(/\[[ Xx!bB>-]\]/, "[X]", line)
+        changed = 1
+      }
+    }
+    print line
+  }
+' "$TASKS_FILE" > "$TASKS_FILE.tmp" && mv "$TASKS_FILE.tmp" "$TASKS_FILE"
+
+# Update task count in frontmatter if present
+COMPLETED=$(grep -E -c "^[[:space:]]*-[[:space:]]+\\[[Xx]\\]" "$TASKS_FILE" || true)
+INCOMPLETE=$(grep -E -c "^[[:space:]]*-[[:space:]]+\\[[[:space:]]\\]" "$TASKS_FILE" || true)
+TOTAL=$((COMPLETED + INCOMPLETE))
+
+if [[ "$TOTAL" -gt 0 ]] && grep -q "^tasksCompleted:" "$TASKS_FILE"; then
+  sed -i.backup "s/^tasksCompleted:.*/tasksCompleted: $COMPLETED\/$TOTAL ($((COMPLETED * 100 / TOTAL))%)/" "$TASKS_FILE"
+  rm -f "$TASKS_FILE.backup"
+fi
+
+echo "✓ Marked $TASK_ID as complete ($COMPLETED/$TOTAL tasks done)"