wile 0.4.3 → 0.4.5

package/dist/agent/.env.example

@@ -0,0 +1,55 @@
+# Wile Agent Configuration
+# Copy this file to .env and fill in your values
+
+# =============================================================================
+# REQUIRED - Claude Code Authentication (choose ONE)
+# =============================================================================
+
+# OPTION 1: OAuth Token (RECOMMENDED - uses your Pro/Max subscription)
+# Generate with: claude setup-token
+# This uses your subscription, NOT API credits!
+CC_CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-xxxxx
+
+# OPTION 2: API Key (uses API credits - pay per token)
+# Get one at: https://console.anthropic.com/
+# Only use this if you don't have a Pro/Max subscription
+# CC_ANTHROPIC_API_KEY=sk-ant-xxxxx
+
+# =============================================================================
+# GitHub Authentication (required when WILE_REPO_SOURCE=github)
+# =============================================================================
+
+# GitHub Personal Access Token (fine-grained recommended)
+# Create at: https://github.com/settings/tokens?type=beta
+# Required permissions: Contents (read/write), Metadata (read)
+# Scope to specific repositories only for security
+GITHUB_TOKEN=github_pat_xxxxx
+
+# =============================================================================
+# Target Repository (required when WILE_REPO_SOURCE=github)
+# =============================================================================
+
+# Repo source: github (default) or local
+WILE_REPO_SOURCE=github
+
+# Full HTTPS URL to the GitHub repository
+GITHUB_REPO_URL=https://github.com/username/repo
+
+# Branch to work on (must contain .wile/prd.json at root)
+BRANCH_NAME=feature/my-feature
+
+# =============================================================================
+# OPTIONAL - Configuration
+# =============================================================================
+
+# Maximum loop iterations before stopping (default: 25)
+MAX_ITERATIONS=25
+
+# Claude model alias or full model name (default: sonnet)
+CC_CLAUDE_MODEL=sonnet
+
+# =============================================================================
+# PROJECT ENVIRONMENT VARIABLES
+# =============================================================================
+# Wile forwards variables from .wile/secrets/.env.project into the container
+# as-is. Put your project-specific values there (no ENV_FORWARD_ prefix).

package/dist/agent/Dockerfile

@@ -0,0 +1,97 @@
+FROM ubuntu:22.04
+
+# Prevent interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install base dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    git \
+    ca-certificates \
+    gnupg \
+    unzip \
+    build-essential \
+    software-properties-common \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Node.js 20 LTS
+RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Bun to /usr/local (globally accessible)
+RUN curl -fsSL https://bun.sh/install | BUN_INSTALL=/usr/local bash
+
+# Install Python 3.11
+RUN add-apt-repository ppa:deadsnakes/ppa -y \
+    && apt-get update \
+    && apt-get install -y python3.11 python3.11-venv python3-pip \
+    && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+RUN useradd -m -s /bin/bash wile \
+    && mkdir -p /home/wile/workspace \
+    && chown -R wile:wile /home/wile
+
+# Memory optimization settings per Claude Code specs
+ENV NODE_OPTIONS="--max-old-space-size=4096"
+
+# Note: The following settings must be configured on the HOST (EC2 instance), not in Docker:
+# - Swap (8GB): fallocate -l 8G /swapfile && mkswap /swapfile && swapon /swapfile
+# - zswap with lz4: echo lz4 > /sys/module/zswap/parameters/compressor && echo 1 > /sys/module/zswap/parameters/enabled
+# - vm.swappiness=10: sysctl -w vm.swappiness=10
+# - earlyoom: apt install earlyoom && systemctl enable earlyoom
+# See packages/agent/scripts/host-setup.sh for EC2 bootstrap
+
+# Install Claude Code CLI
+# https://www.npmjs.com/package/@anthropic-ai/claude-code
+RUN npm install -g @anthropic-ai/claude-code
+
+# CC_ANTHROPIC_API_KEY is passed at runtime via environment variable (mapped to ANTHROPIC_API_KEY in entrypoint)
+# Usage: claude --dangerously-skip-permissions
+
+# Install Playwright with Chromium for browser testing
+# Dependencies for headless Chromium
+RUN apt-get update && apt-get install -y \
+    libnss3 \
+    libnspr4 \
+    libatk1.0-0 \
+    libatk-bridge2.0-0 \
+    libcups2 \
+    libdrm2 \
+    libxkbcommon0 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxfixes3 \
+    libxrandr2 \
+    libgbm1 \
+    libasound2 \
+    libpango-1.0-0 \
+    libcairo2 \
+    libatspi2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Playwright globally and download Chromium to shared location
+ENV PLAYWRIGHT_BROWSERS_PATH=/opt/playwright-browsers
+RUN npm install -g playwright \
+    && mkdir -p /opt/playwright-browsers \
+    && npx playwright install chromium \
+    && chmod -R 755 /opt/playwright-browsers
+
+# Copy scripts
+COPY scripts/ /home/wile/scripts/
+COPY entrypoint.sh /home/wile/entrypoint.sh
+
+RUN chmod +x /home/wile/entrypoint.sh \
+    && chmod +x /home/wile/scripts/*.sh 2>/dev/null || true \
+    && chown -R wile:wile /home/wile
+
+# Working directory
+WORKDIR /home/wile/workspace
+
+# Switch to non-root user
+USER wile
+
+# Default command
+ENTRYPOINT ["/home/wile/entrypoint.sh"]

package/dist/agent/README.md

@@ -0,0 +1,150 @@
+# Wile Agent
+
+Autonomous AI coding agent that runs in a Docker container. Ships features while you sleep.
+
+## Quick Start
+
+### 1. Set up your environment
+
+```bash
+cp .env.example .env
+# Edit .env with your credentials
+```
+
+### 2. Build and run
+
+```bash
+docker compose up --build
+```
+
+## How It Works
+
+1. Container clones your repository
+2. Checks out the specified branch
+3. **Iteration 0 (Setup)**: Sets up .gitignore, initializes progress.txt
+4. Reads `.wile/prd.json` from repo
+5. Loops through user stories, implementing one per iteration:
+   - Picks highest priority story where `passes: false`
+   - Implements the feature/fix
+   - Runs tests and typecheck
+   - Commits and pushes
+   - Marks story as complete
+   - Logs learnings
+6. Repeats until all stories pass or max iterations reached
+
+## Project Structure
+
+Your repository must have a `.wile/` folder:
+
+```
+your-repo/
+├── .wile/
+│   ├── prd.json          # User stories (required)
+│   ├── progress.txt      # Learnings log (created by agent)
+│   └── screenshots/      # Visual verification (created by agent)
+└── ... your code ...
+```
+
+## .wile/prd.json Format
+
+```json
+{
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "Add login form",
+      "acceptanceCriteria": [
+        "Email/password fields exist",
+        "Form validates email format",
+        "typecheck passes"
+      ],
+      "priority": 1,
+      "passes": false,
+      "notes": "Optional notes"
+    }
+  ]
+}
+```
+
+### Fields
+
+- `id`: Unique identifier (used in commit messages)
+- `title`: Short description
+- `acceptanceCriteria`: List of requirements (be specific!)
+- `priority`: Lower number = done first
+- `passes`: Set to `true` by the agent when complete
+- `notes`: Optional context for the agent
+
+## Tips for Success
+
+### Write Small Stories
+Each story should fit in one context window. Break large features into steps.
+
+```
+❌ "Build entire auth system"
+✅ "Add login form"
+✅ "Add email validation"
+✅ "Add login API endpoint"
+```
+
+### Be Explicit in Criteria
+Vague criteria lead to incomplete work.
+
+```
+❌ "Users can log in"
+✅ "Email field with type=email"
+✅ "Password field with minlength=8"
+✅ "Submit button disabled when fields empty"
+✅ "Shows error toast on invalid credentials"
+```
+
+### Include Verification Steps
+For UI work, tell the agent how to verify:
+
+```
+"Verify login form at localhost:3000/login"
+"Take screenshot of completed form"
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CC_CLAUDE_CODE_OAUTH_TOKEN` | Yes* | OAuth token from `claude setup-token` (uses Pro/Max subscription) |
+| `CC_ANTHROPIC_API_KEY` | Yes* | API key (uses API credits - alternative to OAuth) |
+| `WILE_REPO_SOURCE` | No | `github` (default) or `local` |
+| `GITHUB_TOKEN` | Yes (github) | GitHub PAT with repo access |
+| `GITHUB_REPO_URL` | Yes (github) | HTTPS URL to repository |
+| `BRANCH_NAME` | Yes (github) | Branch to work on |
+| `MAX_ITERATIONS` | No | Max loops (default: 25) |
+| `CC_CLAUDE_MODEL` | No | Claude model alias/name (default: sonnet) |
+
+*Either `CC_CLAUDE_CODE_OAUTH_TOKEN` or `CC_ANTHROPIC_API_KEY` is required, not both.
+
+## Output Files
+
+The `.wile/` folder is **tracked in git** (except screenshots):
+
+- `prd.json` - User stories / Product Requirements Document
+- `progress.txt` - Log of completed work and learnings
+- `screenshots/` - Visual verification screenshots (gitignored)
+
+## Monitoring Progress
+
+Watch commits appear on your branch:
+
+```bash
+git log --oneline origin/your-branch
+```
+
+Check the progress log:
+
+```bash
+git show origin/your-branch:.wile/progress.txt
+```
+
+Check story status:
+
+```bash
+git show origin/your-branch:.wile/prd.json | jq '.userStories[] | {id, title, passes}'
+```

package/dist/agent/docker-compose.yml

@@ -0,0 +1,27 @@
+version: '3.8'
+
+services:
+  wile:
+    build: .
+    image: wile-agent:local
+    container_name: wile-agent
+
+    # Environment variables from .env file
+    env_file:
+      - .env
+
+    # Override for local testing (optional - mount local repo)
+    # volumes:
+    #   - /path/to/local/repo:/home/wile/workspace/repo
+
+    # Keep stdin open for debugging
+    stdin_open: true
+    tty: true
+
+    # Resource limits (optional - adjust based on your machine)
+    # deploy:
+    #   resources:
+    #     limits:
+    #       memory: 8G
+    #     reservations:
+    #       memory: 4G

package/dist/agent/entrypoint.sh

@@ -0,0 +1,277 @@
+#!/bin/bash
+#
+# Wile Container Entrypoint
+# Clones repo, sets up workspace, runs the autonomous coding loop
+#
+
+set -e
+
+echo "══════════════════════════════════════════════════════"
+echo "  🗡️  WILE - Container Startup"
+echo "══════════════════════════════════════════════════════"
+
+if [ "${WILE_TEST:-}" = "true" ]; then
+  TEST_REPO="${WILE_TEST_REPO_PATH:-/home/wile/workspace/repo}"
+
+  if [ ! -d "$TEST_REPO" ]; then
+    echo "ERROR: WILE_TEST_REPO_PATH does not exist: $TEST_REPO"
+    exit 1
+  fi
+
+  cd "$TEST_REPO"
+
+  if [ ! -f ".wile/prd.json" ]; then
+    echo "ERROR: .wile/prd.json not found in test repo"
+    exit 1
+  fi
+
+  echo "TEST MODE: running mocked agent (no GitHub, no Claude)"
+
+  node - << 'NODE'
+const fs = require('fs');
+const path = require('path');
+
+const prdPath = path.join('.wile', 'prd.json');
+const progressPath = path.join('.wile', 'progress.txt');
+
+const prd = JSON.parse(fs.readFileSync(prdPath, 'utf8'));
+const stories = Array.isArray(prd.userStories) ? prd.userStories : [];
+const pending = stories.filter((story) => story.passes === false);
+
+if (pending.length === 0) {
+  console.log('No pending stories to complete in test mode.');
+  process.exit(0);
+}
+
+pending.sort((a, b) => {
+  const aPriority = typeof a.priority === 'number' ? a.priority : Number.MAX_SAFE_INTEGER;
+  const bPriority = typeof b.priority === 'number' ? b.priority : Number.MAX_SAFE_INTEGER;
+  return aPriority - bPriority;
+});
+
+const story = pending[0];
+story.passes = true;
+fs.writeFileSync(prdPath, JSON.stringify(prd, null, 2) + '\n');
+
+if (!fs.existsSync(progressPath)) {
+  fs.writeFileSync(progressPath, '# Wile Progress Log\n\n## Codebase Patterns\n(Autogenerated in test mode)\n\n---\n');
+}
+
+const date = new Date().toISOString().split('T')[0];
+const entry = `\n---\n\n## ${date} - ${story.id}: ${story.title}\n\n**Implemented:**\n- Mocked test mode completion\n\n**Files changed:**\n- .wile/prd.json\n- .wile/progress.txt\n\n**Learnings:**\n- Test mode mock run\n`;
+
+fs.appendFileSync(progressPath, entry);
+console.log(`Marked ${story.id} complete (test mode).`);
+NODE
+
+  exit 0
+fi
+
+REPO_SOURCE="${WILE_REPO_SOURCE:-github}"
+LOCAL_REPO_PATH="${WILE_LOCAL_REPO_PATH:-/home/wile/workspace/repo}"
+ADDITIONAL_INSTRUCTIONS_PATH="${WILE_ADDITIONAL_INSTRUCTIONS:-}"
+
+if [ "$REPO_SOURCE" = "local" ]; then
+  if [ ! -d "$LOCAL_REPO_PATH" ]; then
+    echo "ERROR: WILE_LOCAL_REPO_PATH does not exist: $LOCAL_REPO_PATH"
+    exit 1
+  fi
+else
+  # Required environment variables
+  : "${GITHUB_REPO_URL:?GITHUB_REPO_URL is required}"
+  : "${BRANCH_NAME:?BRANCH_NAME is required}"
+  : "${GITHUB_TOKEN:?GITHUB_TOKEN is required}"
+fi
+
+# Authentication: Either CC_CLAUDE_CODE_OAUTH_TOKEN (Pro/Max subscription) or CC_ANTHROPIC_API_KEY (API credits)
+if [ -z "$CC_CLAUDE_CODE_OAUTH_TOKEN" ] && [ -z "$CC_ANTHROPIC_API_KEY" ]; then
+  echo "ERROR: Either CC_CLAUDE_CODE_OAUTH_TOKEN or CC_ANTHROPIC_API_KEY is required"
+  echo ""
+  echo "  CC_CLAUDE_CODE_OAUTH_TOKEN - Uses your Pro/Max subscription (recommended)"
+  echo "  CC_ANTHROPIC_API_KEY       - Uses API credits (pay per token)"
+  echo ""
+  echo "Run 'claude setup-token' on your local machine to get an OAuth token."
+  exit 1
+fi
+
+MAX_ITERATIONS=${MAX_ITERATIONS:-25}
+SCRIPT_DIR="/home/wile/scripts"
+WORKSPACE="/home/wile/workspace"
+
+# Set up Claude Code authentication
+if [ -n "$CC_CLAUDE_CODE_OAUTH_TOKEN" ]; then
+  echo "  Auth:       OAuth (Pro/Max subscription)"
+
+  # Create required directories
+  mkdir -p ~/.claude ~/.config/claude
+
+  # Create ~/.claude.json (THE CRITICAL FILE!)
+  # Without this, Claude Code thinks it's a fresh install and breaks
+  cat > ~/.claude.json << 'CLAUDEJSON'
+{
+  "hasCompletedOnboarding": true,
+  "theme": "dark"
+}
+CLAUDEJSON
+
+  # Create credentials file with the OAuth token
+  cat > ~/.claude/.credentials.json << CREDSJSON
+{
+  "claudeAiOauth": {
+    "accessToken": "$CC_CLAUDE_CODE_OAUTH_TOKEN",
+    "refreshToken": "$CC_CLAUDE_CODE_OAUTH_TOKEN",
+    "expiresAt": 9999999999999,
+    "scopes": ["user:inference", "user:profile"]
+  }
+}
+CREDSJSON
+
+  # Copy to alternate location too
+  cp ~/.claude/.credentials.json ~/.config/claude/.credentials.json
+
+  # Ensure ANTHROPIC_API_KEY is not set (it overrides OAuth)
+  unset ANTHROPIC_API_KEY
+else
+  echo "  Auth:       API Key (credits)"
+  export ANTHROPIC_API_KEY="$CC_ANTHROPIC_API_KEY"
+fi
+
+if [ "$REPO_SOURCE" = "local" ]; then
+  echo "  Repo:       local ($LOCAL_REPO_PATH)"
+else
+  echo "  Repo:       $GITHUB_REPO_URL"
+  echo "  Branch:     $BRANCH_NAME"
+fi
+echo "  Iterations: $MAX_ITERATIONS"
+echo "══════════════════════════════════════════════════════"
+echo ""
+
+# Configure git
+echo "Configuring git..."
+git config --global user.name "Wile Bot"
+git config --global user.email "wile@bot.local"
+git config --global credential.helper store
+
+if [ "$REPO_SOURCE" = "local" ]; then
+  echo "Using local repo mount..."
+  cd "$LOCAL_REPO_PATH"
+else
+  # Set up GitHub token authentication
+  # Extract host from URL (handles both https://github.com/... and git@github.com:...)
+  if [[ "$GITHUB_REPO_URL" =~ ^https://([^/]+)/ ]]; then
+    GIT_HOST="${BASH_REMATCH[1]}"
+    # Store credentials for HTTPS
+    echo "https://x-access-token:${GITHUB_TOKEN}@${GIT_HOST}" > ~/.git-credentials
+  elif [[ "$GITHUB_REPO_URL" =~ ^git@([^:]+): ]]; then
+    GIT_HOST="${BASH_REMATCH[1]}"
+    # Convert to HTTPS for token auth
+    GITHUB_REPO_URL=$(echo "$GITHUB_REPO_URL" | sed 's|git@\([^:]*\):|https://\1/|')
+    echo "https://x-access-token:${GITHUB_TOKEN}@${GIT_HOST}" > ~/.git-credentials
+  fi
+
+  # Clone the repository
+  echo "Cloning repository..."
+  cd "$WORKSPACE"
+  git clone "$GITHUB_REPO_URL" repo
+  cd repo
+
+  # Checkout the branch
+  echo "Checking out branch: $BRANCH_NAME"
+  git fetch origin
+  if git show-ref --verify --quiet "refs/remotes/origin/$BRANCH_NAME"; then
+    git checkout "$BRANCH_NAME"
+  else
+    echo "Branch $BRANCH_NAME does not exist remotely. Creating it..."
+    git checkout -b "$BRANCH_NAME"
+    git push -u origin "$BRANCH_NAME"
+  fi
+fi
+
+if [ -n "$ADDITIONAL_INSTRUCTIONS_PATH" ] && [ -f "$ADDITIONAL_INSTRUCTIONS_PATH" ]; then
+  if [ -s "$ADDITIONAL_INSTRUCTIONS_PATH" ]; then
+    echo "  Extra:      Using additional instructions"
+  fi
+fi
+
+# Verify .wile/prd.json exists
+echo "Checking for .wile/prd.json..."
+if [ ! -f ".wile/prd.json" ]; then
+  echo "ERROR: .wile/prd.json not found!"
+  echo ""
+  echo "Your repository must have a .wile/prd.json file at the root."
+  echo "This file contains the user stories for Wile to implement."
+  echo ""
+  echo "Example structure:"
+  echo '  {'
+  echo '    "userStories": ['
+  echo '      {'
+  echo '        "id": "US-001",'
+  echo '        "title": "My feature",'
+  echo '        "acceptanceCriteria": ["..."],'
+  echo '        "priority": 1,'
+  echo '        "passes": false'
+  echo '      }'
+  echo '    ]'
+  echo '  }'
+  exit 1
+fi
+
+# Set up .wile/screenshots directory
+echo "Setting up .wile directory..."
+mkdir -p .wile/screenshots
+
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  Starting Wile Loop"
+echo "══════════════════════════════════════════════════════"
+echo ""
+
+# Run the main loop
+EXIT_CODE=0
+"$SCRIPT_DIR/wile.sh" "$MAX_ITERATIONS" || EXIT_CODE=$?
+
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  Wile Loop Complete (exit code: $EXIT_CODE)"
+echo "══════════════════════════════════════════════════════"
+
+# Handle completion/partial completion
+if [ $EXIT_CODE -eq 0 ]; then
+  echo "All tasks completed successfully!"
+  # Ensure final state is pushed
+  git push || true
+elif [ $EXIT_CODE -eq 1 ]; then
+  echo "Max iterations reached. Committing partial work..."
+
+  # Check if there are uncommitted changes
+  if ! git diff --quiet || ! git diff --staged --quiet; then
+    git add -A
+    TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+    git commit -m "WIP: wile stopped at max iterations ($TIMESTAMP)
+
+Partial work committed. Check .wile/progress.txt for details.
+Some stories may still have passes=false in .wile/prd.json."
+    git push
+  fi
+elif [ $EXIT_CODE -eq 2 ]; then
+  echo "Setup failed. Check the logs above for details."
+else
+  echo "Wile exited with error code: $EXIT_CODE"
+  # Try to commit whatever state we have
+  if ! git diff --quiet || ! git diff --staged --quiet; then
+    git add -A
+    TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+    git commit -m "WIP: wile error exit ($TIMESTAMP)
+
+Exit code: $EXIT_CODE
+Check logs for details."
+    git push || true
+  fi
+fi
+
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  Wile Container Finished"
+echo "══════════════════════════════════════════════════════"
+
+exit $EXIT_CODE

package/dist/agent/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@wile/agent",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Wile autonomous coding agent - Docker image and scripts"
+}

package/dist/agent/scripts/browser-test.ts

@@ -0,0 +1,106 @@
+/**
+ * Browser testing helper for Wile agent
+ *
+ * Usage:
+ *   npx tsx browser-test.ts screenshot <url> <output-path>
+ *   npx tsx browser-test.ts verify <url> <selector>
+ *
+ * Examples:
+ *   npx tsx browser-test.ts screenshot http://localhost:3000 .wile-temp/screenshots/home.png
+ *   npx tsx browser-test.ts verify http://localhost:3000/login "form#login"
+ */
+
+import { chromium, type Page, type Browser } from 'playwright';
+
+const VIEWPORT = { width: 1280, height: 900 };
+const TIMEOUT = 30000;
+
+async function waitForPageLoad(page: Page): Promise<void> {
+  await page.waitForLoadState('networkidle', { timeout: TIMEOUT });
+}
+
+async function screenshot(url: string, outputPath: string): Promise<void> {
+  let browser: Browser | null = null;
+
+  try {
+    browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext({ viewport: VIEWPORT });
+    const page = await context.newPage();
+
+    console.log(`Navigating to ${url}...`);
+    await page.goto(url, { timeout: TIMEOUT });
+    await waitForPageLoad(page);
+
+    console.log(`Taking screenshot...`);
+    await page.screenshot({ path: outputPath, fullPage: true });
+
+    console.log(`Screenshot saved to ${outputPath}`);
+  } finally {
+    if (browser) await browser.close();
+  }
+}
+
+async function verify(url: string, selector: string): Promise<boolean> {
+  let browser: Browser | null = null;
+
+  try {
+    browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext({ viewport: VIEWPORT });
+    const page = await context.newPage();
+
+    console.log(`Navigating to ${url}...`);
+    await page.goto(url, { timeout: TIMEOUT });
+    await waitForPageLoad(page);
+
+    console.log(`Looking for selector: ${selector}...`);
+    const element = await page.$(selector);
+
+    if (element) {
+      console.log(`✓ Found element matching "${selector}"`);
+      return true;
+    } else {
+      console.log(`✗ Element not found: "${selector}"`);
+      return false;
+    }
+  } finally {
+    if (browser) await browser.close();
+  }
+}
+
+async function main(): Promise<void> {
+  const [, , command, ...args] = process.argv;
+
+  switch (command) {
+    case 'screenshot': {
+      const [url, outputPath] = args;
+      if (!url || !outputPath) {
+        console.error('Usage: browser-test.ts screenshot <url> <output-path>');
+        process.exit(1);
+      }
+      await screenshot(url, outputPath);
+      break;
+    }
+
+    case 'verify': {
+      const [url, selector] = args;
+      if (!url || !selector) {
+        console.error('Usage: browser-test.ts verify <url> <selector>');
+        process.exit(1);
+      }
+      const found = await verify(url, selector);
+      process.exit(found ? 0 : 1);
+      break;
+    }
+
+    default:
+      console.error('Commands: screenshot, verify');
+      console.error('  screenshot <url> <output-path> - Take a full page screenshot');
+      console.error('  verify <url> <selector>        - Check if selector exists on page');
+      process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});

package/dist/agent/scripts/host-setup.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Host-level setup for EC2 instances running Wile
+# These settings cannot be configured inside Docker containers
+# Run this script on EC2 UserData or manually on the host
+
+set -e
+
+echo "=== Wile Host Setup ==="
+
+# Configure swap (8GB)
+echo "Configuring 8GB swap..."
+fallocate -l 8G /swapfile
+chmod 600 /swapfile
+mkswap /swapfile
+swapon /swapfile
+echo '/swapfile none swap sw 0 0' >> /etc/fstab
+
+# Set vm.swappiness to 10 (prefer RAM, swap only when needed)
+echo "Setting vm.swappiness=10..."
+sysctl -w vm.swappiness=10
+echo 'vm.swappiness=10' >> /etc/sysctl.conf
+
+# Enable zswap with lz4 compression (3x effective swap, faster access)
+echo "Enabling zswap with lz4..."
+echo lz4 > /sys/module/zswap/parameters/compressor
+echo 1 > /sys/module/zswap/parameters/enabled
+
+# Install and enable earlyoom (prevents hard freeze)
+echo "Installing earlyoom..."
+apt-get update
+apt-get install -y earlyoom
+systemctl enable earlyoom
+systemctl start earlyoom
+
+echo "=== Host setup complete ==="

package/dist/agent/scripts/prompt-setup.md

@@ -0,0 +1,23 @@
+# Wile Setup (Iteration 0)
+
+You are running the setup phase for a Wile autonomous coding session.
+
+## Tasks
+
+1. Verify `.wile/prd.json` exists and is valid JSON:
+
+```bash
+cat .wile/prd.json
+```
+
+If the file is missing or invalid JSON, respond with:
+```
+<promise>SETUP_FAILED</promise>
+```
+
+Otherwise, **do nothing else**. Do not modify files, do not run git commands, and do not print extra output.
+
+## Notes
+
+- Setup should have no side effects.
+- Only emit `<promise>SETUP_FAILED</promise>` on failure.

package/dist/agent/scripts/prompt.md

@@ -0,0 +1,168 @@
+# Wile Agent Instructions
+
+You are an autonomous coding agent running in a loop. Each iteration, you complete ONE user story from the backlog, then exit. The loop will call you again for the next story.
+
+## Your Task (Execute in Order)
+
+### 1. Read the Backlog
+```bash
+cat .wile/prd.json
+```
+Parse the `userStories` array. Find the highest priority story where `passes: false`.
+
+### 2. Read Progress Log
+```bash
+cat .wile/progress.txt
+```
+Check the **Codebase Patterns** section at the top for learnings from previous iterations. Apply these patterns to avoid repeating mistakes.
+
+### 3. Check Current Branch
+```bash
+git branch --show-current
+git status
+```
+Ensure you're on the correct branch specified by the `BRANCH_NAME` environment variable.
+
+### 4. Implement the Story
+Pick the highest priority story where `passes: false` and implement it completely.
+
+- Read and understand all acceptance criteria
+- Implement the feature/fix
+- Follow existing code patterns in the codebase
+- Keep changes minimal and focused
+
+### 5. Verify Your Work
+Run the project's tests and type checking:
+```bash
+# Try common commands (adapt to the project)
+npm run typecheck || npm run tsc || npx tsc --noEmit || true
+npm test || npm run test || true
+```
+
+If tests or typecheck fail, fix the issues before proceeding.
+
+### 6. Update prd.json
+Set `passes: true` for the completed story:
+```bash
+# Edit .wile/prd.json to mark the story as complete
+```
+
+### 7. Log Your Progress
+**APPEND** to `.wile/progress.txt`:
+
+```markdown
+---
+
+## [DATE] - [STORY-ID]: [Story Title]
+
+**Implemented:**
+- What was done
+
+**Files changed:**
+- file1.ts
+- file2.ts
+
+**Learnings:**
+- Any patterns discovered
+- Gotchas encountered
+- Things to remember for future iterations
+```
+
+If you discovered important patterns, also add them to the **Codebase Patterns** section at the TOP of progress.txt.
+
+### 8. Commit and Push
+```bash
+git add -A
+git commit -m "feat: [STORY-ID] - [Story Title]"
+git push
+```
+
+Use the exact story ID and title from `.wile/prd.json`.
+
+## Stop Condition
+
+After completing steps 1-8, check if ALL stories in `.wile/prd.json` have `passes: true`.
+
+**If ALL stories pass**, respond with exactly:
+```
+<promise>COMPLETE</promise>
+```
+
+**If there are still stories with `passes: false`**, end your response normally. The loop will call you again for the next story.
+
+## Important Rules
+
+1. **ONE story per iteration** - Do not implement multiple stories
+2. **Always push** - Push after every commit so progress is visible
+3. **One commit per feature** - Include the implementation, prd.json update, and progress log in a single commit
+4. **Fix related files** - If typecheck requires changes in other files, make them (this is not scope creep)
+5. **Be idempotent** - Use `IF NOT EXISTS` for migrations, check before creating files
+6. **No interactive prompts** - Use `echo -e "\n\n\n" |` if a command might prompt
+7. **NEVER commit node_modules, dist, or build artifacts** - .gitignore should already be set up by iteration 0
+
+## Common Patterns
+
+### Migrations
+```sql
+ALTER TABLE x ADD COLUMN IF NOT EXISTS y TEXT;
+```
+
+### React Refs
+```typescript
+const ref = useRef<NodeJS.Timeout | null>(null);
+```
+
+### Skipping Interactive Prompts
+```bash
+echo -e "\n\n\n" | npm run db:generate
+```
+
+## Browser Testing (Visual Verification)
+
+When acceptance criteria mention UI verification, visual checks, or "verify at localhost":
+
+### Take a Screenshot
+```bash
+cd /tmp && npm init -y && npm install playwright
+node -e "
+const { chromium } = require('playwright');
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.setViewportSize({ width: 1280, height: 900 });
+  await page.goto('http://localhost:3000/your-page');
+  await page.waitForLoadState('networkidle');
+  await page.screenshot({ path: '.wile/screenshots/verification.png', fullPage: true });
+  console.log('Screenshot saved');
+  await browser.close();
+})();
+"
+```
+
+### Verify Element Exists
+```bash
+node -e "
+const { chromium } = require('playwright');
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.goto('http://localhost:3000/login');
+  await page.waitForLoadState('networkidle');
+  const element = await page.\$('form#login');
+  console.log(element ? 'FOUND: form#login' : 'NOT FOUND: form#login');
+  await browser.close();
+})();
+"
+```
+
+Save screenshots to `.wile/screenshots/` with descriptive names.
+
+## Error Recovery
+
+If something goes wrong:
+1. Read the error message carefully
+2. Fix the issue
+3. Continue with the current story
+4. Document the issue in the progress log
+
+Do NOT skip to the next story if the current one fails. Fix it first.

package/dist/agent/scripts/test-additional-instructions.sh

@@ -0,0 +1,82 @@
+#!/bin/sh
+set -euo pipefail
+
+run_case() {
+  LABEL="$1"
+  MODE="$2"
+  EXPECT_HEADER="$3"
+
+  TMP_DIR=$(mktemp -d /tmp/wile-additional-test-XXXXXX)
+  cleanup() {
+    rm -rf "$TMP_DIR"
+  }
+  trap cleanup EXIT INT TERM
+
+  SCRIPT_DIR="$TMP_DIR/agent"
+  BIN_DIR="$TMP_DIR/bin"
+  mkdir -p "$SCRIPT_DIR" "$BIN_DIR"
+
+  cp /Users/thiagoduarte/Projects/personal/wile/packages/agent/scripts/wile.sh "$SCRIPT_DIR/wile.sh"
+  chmod +x "$SCRIPT_DIR/wile.sh"
+
+  echo "BASE PROMPT" > "$SCRIPT_DIR/prompt.md"
+
+  ADDITIONAL="$TMP_DIR/additional.md"
+  if [ "$MODE" = "comment-only" ]; then
+    cat > "$ADDITIONAL" <<'EOF'
+<!--
+Use bullet points for additional instructions, e.g.
+- You may run `supabase db reset --db-url "$SUPABASE_DB_URL"` when needed.
+- Do not ask for permission before running it.
+-->
+EOF
+  else
+    cat > "$ADDITIONAL" <<'EOF'
+<!--
+Use bullet points for additional instructions, e.g.
+- You may run `supabase db reset --db-url "$SUPABASE_DB_URL"` when needed.
+- Do not ask for permission before running it.
+-->
+- Always reset the database before integration tests.
+EOF
+  fi
+
+  CAPTURE="$TMP_DIR/capture.txt"
+
+  cat > "$BIN_DIR/claude" <<'EOF'
+#!/bin/sh
+cat > "$CLAUDE_CAPTURE"
+echo "<promise>COMPLETE</promise>"
+EOF
+  chmod +x "$BIN_DIR/claude"
+
+  PATH="$BIN_DIR:$PATH" \
+  CLAUDE_CAPTURE="$CAPTURE" \
+  WILE_ADDITIONAL_INSTRUCTIONS="$ADDITIONAL" \
+  CC_CLAUDE_MODEL="sonnet" \
+  "$SCRIPT_DIR/wile.sh" 1 >/dev/null 2>&1
+
+  if ! grep -q "BASE PROMPT" "$CAPTURE"; then
+    echo "error: base prompt missing in $LABEL" >&2
+    exit 1
+  fi
+
+  if [ "$EXPECT_HEADER" = "yes" ]; then
+    grep -q "## Additional Instructions" "$CAPTURE"
+    grep -q "Always reset the database before integration tests." "$CAPTURE"
+  else
+    if grep -q "## Additional Instructions" "$CAPTURE"; then
+      echo "error: header appended unexpectedly in $LABEL" >&2
+      exit 1
+    fi
+  fi
+
+  rm -rf "$TMP_DIR"
+  trap - EXIT INT TERM
+}
+
+run_case "comment-only" "comment-only" "no"
+
+run_case "with-content" "with-content" "yes"
+
+echo "test-additional-instructions: ok"

package/dist/agent/scripts/wile.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+#
+# Wile - Autonomous AI coding loop
+# Pipes prompt to Claude Code repeatedly until all tasks complete
+#
+
+set -e
+
+MAX_ITERATIONS=${1:-25}
+CLAUDE_MODEL=${CC_CLAUDE_MODEL:-sonnet}
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROMPT_FILE="$SCRIPT_DIR/prompt.md"
+SETUP_PROMPT_FILE="$SCRIPT_DIR/prompt-setup.md"
+ADDITIONAL_PROMPT_FILE="${WILE_ADDITIONAL_INSTRUCTIONS:-}"
+
+echo "══════════════════════════════════════════════════════"
+echo "  🗡️  WILE - Autonomous Coding Agent"
+echo "══════════════════════════════════════════════════════"
+echo "  Max iterations: $MAX_ITERATIONS"
+echo "  Model:          $CLAUDE_MODEL"
+echo "  Prompt file:    $PROMPT_FILE"
+echo "══════════════════════════════════════════════════════"
+echo ""
+
+if [ ! -f "$PROMPT_FILE" ]; then
+  echo "ERROR: Prompt file not found: $PROMPT_FILE"
+  exit 1
+fi
+
+if [ -n "$ADDITIONAL_PROMPT_FILE" ] && [ -f "$ADDITIONAL_PROMPT_FILE" ]; then
+  if [ -s "$ADDITIONAL_PROMPT_FILE" ]; then
+    STRIPPED_CONTENT=$(sed '/<!--/,/-->/d' "$ADDITIONAL_PROMPT_FILE" | tr -d '[:space:]')
+    if [ -n "$STRIPPED_CONTENT" ]; then
+      PROMPT_FILE="/tmp/wile-prompt.md"
+      cat "$SCRIPT_DIR/prompt.md" > "$PROMPT_FILE"
+      printf "\n\n## Additional Instructions\n\n" >> "$PROMPT_FILE"
+      cat "$ADDITIONAL_PROMPT_FILE" >> "$PROMPT_FILE"
+    fi
+  fi
+fi
+
+# ════════════════════════════════════════════════════════════
+# ITERATION 0: Setup
+# ════════════════════════════════════════════════════════════
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  Iteration 0 - Setup"
+echo "══════════════════════════════════════════════════════"
+echo ""
+
+if [ -f "$SETUP_PROMPT_FILE" ]; then
+  OUTPUT=$(cat "$SETUP_PROMPT_FILE" | claude --model "$CLAUDE_MODEL" --dangerously-skip-permissions 2>&1 | tee /dev/stderr) || true
+
+  # Check if setup failed critically
+  if echo "$OUTPUT" | grep -q "<promise>SETUP_FAILED</promise>"; then
+    echo ""
+    echo "══════════════════════════════════════════════════════"
+    echo "  ❌ SETUP FAILED - Cannot continue"
+    echo "══════════════════════════════════════════════════════"
+    exit 2
+  fi
+
+  echo ""
+  echo "Setup complete. Starting main loop..."
+  sleep 2
+else
+  echo "No setup prompt found, skipping iteration 0..."
+fi
+
+# ════════════════════════════════════════════════════════════
+# ITERATIONS 1-N: Main loop
+# ════════════════════════════════════════════════════════════
+for i in $(seq 1 $MAX_ITERATIONS); do
+  echo ""
+  echo "══════════════════════════════════════════════════════"
+  echo "  Iteration $i of $MAX_ITERATIONS"
+  echo "══════════════════════════════════════════════════════"
+  echo ""
+
+  # Pipe prompt to Claude Code
+  # --dangerously-skip-permissions allows autonomous operation
+  # Capture output while also displaying it (tee to stderr)
+  OUTPUT=$(cat "$PROMPT_FILE" | claude --model "$CLAUDE_MODEL" --dangerously-skip-permissions 2>&1 | tee /dev/stderr) || true
+
+  # Check for completion signal
+  if echo "$OUTPUT" | grep -q "<promise>COMPLETE</promise>"; then
+    echo ""
+    echo "══════════════════════════════════════════════════════"
+    echo "  ✅ ALL TASKS COMPLETE"
+    echo "══════════════════════════════════════════════════════"
+    exit 0
+  fi
+
+  echo ""
+  echo "Iteration $i complete. Continuing..."
+  sleep 2
+done
+
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  ⚠️  MAX ITERATIONS REACHED ($MAX_ITERATIONS)"
+echo "  Some tasks may still be pending."
+echo "══════════════════════════════════════════════════════"
+exit 1

package/dist/cli.js

@@ -7904,6 +7904,10 @@ var resolveAgentDir = () => {
     return foundFromCwd;
   }
   const here = dirname(fileURLToPath(import.meta.url));
+  const bundledAgentDir = join3(here, "agent");
+  if (existsSync3(bundledAgentDir)) {
+    return bundledAgentDir;
+  }
   const cliRoot = resolve(here, "..", "..", "..");
   const agentDir = join3(cliRoot, "agent");
   if (!existsSync3(agentDir)) {
@@ -8006,12 +8010,17 @@ var runWile = (options) => {
   const logsDir = join3(paths.wileDir, "logs");
   mkdirSync(logsDir, { recursive: true });
   const logPath = join3(logsDir, `run-${getTimestamp()}.log`);
+  writeFileSync(logPath, "", { flag: "w" });
   if (options.test) {
     const message = `TEST MODE: running mocked agent inside Docker.
 `;
     process.stdout.write(message);
     writeFileSync(logPath, message, { flag: "a" });
   }
+  if (options.debug) {
+    console.log(`- logsDir: ${logsDir}`);
+    console.log(`- logPath: ${logPath}`);
+  }
   runDockerWithLogging(dockerArgs, logPath);
   const finishMessage = `Wile run complete. Monitor progress with git log in your repo.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wile",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Autonomous AI coding agent that ships features while you sleep",
   "type": "module",
   "bin": {