wile 0.6.9 → 1.0.0

package/README.md

@@ -26,7 +26,7 @@ This creates:
 Set `WILE_REPO_SOURCE=local` in `.wile/secrets/.env` to run against the current directory without GitHub.
 When `WILE_REPO_SOURCE=local`, GitHub credentials are optional.
 Set `WILE_MAX_ITERATIONS` in `.wile/secrets/.env` to change the default loop limit (default: 25).
-Set `CODING_AGENT=OC` to use OpenCode (OpenRouter), `CODING_AGENT=GC` to use Gemini CLI, otherwise `CODING_AGENT=CC` uses Claude Code.
+Set `CODING_AGENT=CX` to use Codex CLI, `CODING_AGENT=OC` to use OpenCode (OpenRouter), `CODING_AGENT=GC` to use Gemini CLI, otherwise `CODING_AGENT=CC` uses Claude Code.
 
 ## Run Wile
 

package/dist/agent/.env.example

@@ -9,6 +9,7 @@
 # - CC = Claude Code (default)
 # - GC = Gemini CLI (Google account OAuth)
 # - OC = OpenCode (OpenRouter)
+# - CX = Codex CLI (ChatGPT subscription)
 CODING_AGENT=CC
 
 # =============================================================================
@@ -47,6 +48,19 @@ CC_CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-xxxxx
 # Get one at: https://aistudio.google.com/app/apikey
 # GEMINI_API_KEY=your-key
 
+# =============================================================================
+# REQUIRED - Codex CLI Authentication (CX only, choose ONE)
+# =============================================================================
+
+# OPTION 1: ChatGPT login (RECOMMENDED - uses your ChatGPT subscription)
+# Run: codex login (or codex login --device-auth)
+# Then base64 encode ~/.codex/auth.json and paste here
+# CODEX_AUTH_JSON_B64=eyJ...
+
+# OPTION 2: API key (uses API credits - pay per token)
+# Get one at: https://platform.openai.com/api-keys
+# CODEX_API_KEY=sk-openai-xxxxx
+
 # =============================================================================
 # GitHub Authentication (required when WILE_REPO_SOURCE=github)
 # =============================================================================
@@ -83,6 +97,9 @@ CC_CLAUDE_MODEL=sonnet
 # Gemini model name (default: auto-gemini-3)
 # GEMINI_MODEL=auto-gemini-3
 
+# Codex model name (defaults to Codex CLI default)
+# CODEX_MODEL=gpt-5.1-codex
+
 # =============================================================================
 # PROJECT ENVIRONMENT VARIABLES
 # =============================================================================

package/dist/agent/Dockerfile

@@ -34,7 +34,7 @@ JSON
 RUN cd /opt/agent-browser \
     && bun add agent-browser \
     && node /opt/agent-browser/node_modules/agent-browser/scripts/postinstall.js \
-    && ln -s /opt/agent-browser/node_modules/agent-browser/bin/agent-browser /usr/local/bin/agent-browser
+    && ln -s /opt/agent-browser/node_modules/agent-browser/bin/agent-browser.js /usr/local/bin/agent-browser
 
 # Create non-root user
 RUN useradd -m -s /bin/bash wile \
@@ -63,11 +63,14 @@ RUN npm install -g opencode-ai@latest
 # https://www.npmjs.com/package/@google/gemini-cli
 RUN npm install -g @google/gemini-cli
 
+# Install Codex CLI
+# https://www.npmjs.com/package/@openai/codex
+RUN npm install -g @openai/codex
+
 # 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
+# Install Chromium dependencies for Playwright
 RUN apt-get update && apt-get install -y \
     libnss3 \
     libnspr4 \
@@ -87,11 +90,10 @@ RUN apt-get update && apt-get install -y \
     libatspi2.0-0 \
     && rm -rf /var/lib/apt/lists/*
 
-# Install Playwright globally and download Chromium to shared location
+# Download Chromium using the Playwright core version bundled with agent-browser
 ENV PLAYWRIGHT_BROWSERS_PATH=/opt/playwright-browsers
-RUN npm install -g playwright \
-    && mkdir -p /opt/playwright-browsers \
-    && npx playwright install chromium \
+RUN mkdir -p /opt/playwright-browsers \
+    && node /opt/agent-browser/node_modules/playwright-core/cli.js install chromium \
     && chmod -R 755 /opt/playwright-browsers
 
 # Copy scripts

package/dist/agent/README.md

@@ -22,24 +22,24 @@ docker compose up --build
 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`
+4. Reads `.wile/prd.json`
+5. Loops through stories, implementing one per iteration:
+   - Picks first runnable story in array order where `status: "pending"` and dependencies are done
    - Implements the feature/fix
    - Runs tests and typecheck
-   - Commits and pushes
-   - Marks story as complete
+   - Marks story as done
    - Logs learnings
-6. Repeats until all stories pass or max iterations reached
+   - Commits changes
+6. Repeats until all stories are done or max iterations reached
 
 ## Project Structure
 
-Your repository must have a `.wile/` folder:
+Your repository must have a `.wile/prd.json` file:
 
 ```
 your-repo/
 ├── .wile/
-│   ├── prd.json          # User stories (required)
+│   ├── prd.json          # Stories backlog (required)
 │   ├── progress.txt      # Learnings log (created by agent)
 │   └── screenshots/      # Visual verification (created by agent)
 └── ... your code ...
@@ -49,18 +49,18 @@ your-repo/
 
 ```json
 {
-  "userStories": [
+  "stories": [
     {
-      "id": "US-001",
+      "id": 1,
       "title": "Add login form",
+      "description": "Email/password form with validation",
       "acceptanceCriteria": [
         "Email/password fields exist",
         "Form validates email format",
         "typecheck passes"
       ],
-      "priority": 1,
-      "passes": false,
-      "notes": "Optional notes"
+      "dependsOn": [],
+      "status": "pending"
     }
   ]
 }
@@ -68,12 +68,12 @@ your-repo/
 
 ### Fields
 
-- `id`: Unique identifier (used in commit messages)
+- `id`: Unique numeric identifier
 - `title`: Short description
+- `description`: Additional context for implementation
 - `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
+- `dependsOn`: Array of prerequisite story IDs
+- `status`: `pending` or `done`
 
 ## Tips for Success
 
@@ -110,13 +110,15 @@ For UI work, tell the agent how to verify:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `CODING_AGENT` | No | `CC` (Claude Code, default), `GC` (Gemini CLI), or `OC` (OpenCode via OpenRouter) |
+| `CODING_AGENT` | No | `CC` (Claude Code, default), `GC` (Gemini CLI), `OC` (OpenCode via OpenRouter), or `CX` (Codex CLI) |
 | `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) |
 | `GEMINI_OAUTH_CREDS_B64` | Yes (GC)* | Base64 OAuth creds from `~/.gemini/oauth_creds.json` (uses Google account) |
 | `GEMINI_API_KEY` | Yes (GC)* | Gemini API key (uses API credits - alternative to OAuth) |
 | `OC_OPENROUTER_API_KEY` | Yes (OC) | OpenRouter API key for OpenCode |
 | `OC_MODEL` | Yes (OC) | OpenRouter model id (set `glm-4.7` to target `openrouter/z-ai/glm-4.7`) |
+| `CODEX_AUTH_JSON_B64` | Yes (CX)* | Base64 of `~/.codex/auth.json` from `codex login` (uses ChatGPT subscription) |
+| `CODEX_API_KEY` | Yes (CX)* | OpenAI API key (uses API credits - alternative to auth.json) |
 | `GEMINI_MODEL` | No (GC) | Gemini model name (default: `auto-gemini-3`) |
 | `WILE_REPO_SOURCE` | No | `github` (default) or `local` |
 | `GITHUB_TOKEN` | Yes (github) | GitHub PAT with repo access |
@@ -124,15 +126,17 @@ For UI work, tell the agent how to verify:
 | `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) |
+| `CODEX_MODEL` | No (CX) | Codex model name (defaults to Codex CLI default) |
 
 *Either `CC_CLAUDE_CODE_OAUTH_TOKEN` or `CC_ANTHROPIC_API_KEY` is required when `CODING_AGENT=CC`.  
-*Either `GEMINI_OAUTH_CREDS_B64` or `GEMINI_API_KEY` is required when `CODING_AGENT=GC`.
+*Either `GEMINI_OAUTH_CREDS_B64` or `GEMINI_API_KEY` is required when `CODING_AGENT=GC`.  
+*Either `CODEX_AUTH_JSON_B64` or `CODEX_API_KEY` is required when `CODING_AGENT=CX`.
 
 ## Output Files
 
-The `.wile/` folder is **tracked in git** (except screenshots):
+Tracked artifacts:
 
-- `prd.json` - User stories / Product Requirements Document
+- `.wile/prd.json` - Product requirements stories backlog
 - `progress.txt` - Log of completed work and learnings
 - `screenshots/` - Visual verification screenshots (gitignored)
 
@@ -153,5 +157,5 @@ 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}'
+git show origin/your-branch:.wile/prd.json | jq '.stories[] | {id, title, status}'
 ```

package/dist/agent/entrypoint.sh

@@ -15,6 +15,8 @@ if command -v sysctl >/dev/null 2>&1; then
   sysctl -w net.ipv6.conf.default.disable_ipv6=0 >/dev/null 2>&1 || true
 fi
 
+SCRIPT_DIR="/home/wile/scripts"
+
 if [ "${WILE_TEST:-}" = "true" ]; then
   TEST_REPO="${WILE_TEST_REPO_PATH:-/home/wile/workspace/repo}"
 
@@ -30,18 +32,19 @@ if [ "${WILE_TEST:-}" = "true" ]; then
     exit 1
   fi
 
+  bun "$SCRIPT_DIR/validate-prd.ts" --path .wile/prd.json >/dev/null
+
   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 prdPath = '.wile/prd.json';
+const progressPath = '.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);
+const stories = Array.isArray(prd.stories) ? prd.stories : [];
+const storyById = new Map(stories.map((story) => [story.id, story]));
+const pending = stories.filter((story) => story.status === 'pending');
 
 if (process.env.TEST_FORWARD) {
   console.log(`Forwarded env: ${process.env.TEST_FORWARD}`);
@@ -52,14 +55,20 @@ if (pending.length === 0) {
   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 =
+  stories.find(
+    (candidate) =>
+      candidate.status === 'pending' &&
+      Array.isArray(candidate.dependsOn) &&
+      candidate.dependsOn.every((depId) => storyById.get(depId)?.status === 'done')
+  ) || null;
+
+if (!story) {
+  console.error('No runnable pending stories in test mode.');
+  process.exit(1);
+}
 
-const story = pending[0];
-story.passes = true;
+story.status = 'done';
 fs.writeFileSync(prdPath, JSON.stringify(prd, null, 2) + '\n');
 
 if (!fs.existsSync(progressPath)) {
@@ -115,6 +124,16 @@ elif [ "$CODING_AGENT" = "GC" ]; then
     echo "Run 'gemini' locally and choose Login with Google to create ~/.gemini/oauth_creds.json."
     exit 1
   fi
+elif [ "$CODING_AGENT" = "CX" ]; then
+  if [ -z "$CODEX_AUTH_JSON_B64" ] && [ -z "$CODEX_AUTH_JSON_PATH" ] && [ -z "$CODEX_API_KEY" ] && [ -z "$OPENAI_API_KEY" ]; then
+    echo "ERROR: Either CODEX_AUTH_JSON_B64 (or CODEX_AUTH_JSON_PATH) or CODEX_API_KEY is required"
+    echo ""
+    echo "  CODEX_AUTH_JSON_B64   - Base64 of ~/.codex/auth.json from 'codex login' (recommended)"
+    echo "  CODEX_API_KEY         - OpenAI API key (pay per token)"
+    echo ""
+    echo "Run 'codex login' (or 'codex login --device-auth') locally, then base64 ~/.codex/auth.json."
+    exit 1
+  fi
 else
   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"
@@ -128,7 +147,6 @@ else
 fi
 
 MAX_ITERATIONS=${MAX_ITERATIONS:-25}
-SCRIPT_DIR="/home/wile/scripts"
 WORKSPACE="/home/wile/workspace"
 
 if [ "${WILE_MOCK_CLAUDE:-}" = "true" ] && [ "$CODING_AGENT" = "CC" ]; then
@@ -149,6 +167,15 @@ if [ "${WILE_MOCK_GEMINI:-}" = "true" ] && [ "$CODING_AGENT" = "GC" ]; then
   export PATH="$MOCK_BIN:$PATH"
 fi
 
+if [ "${WILE_MOCK_CODEX:-}" = "true" ] && [ "$CODING_AGENT" = "CX" ]; then
+  echo "  Codex:      Mocked"
+  MOCK_BIN="/home/wile/mock-bin"
+  mkdir -p "$MOCK_BIN"
+  cp "$SCRIPT_DIR/mock-codex.sh" "$MOCK_BIN/codex"
+  chmod +x "$MOCK_BIN/codex"
+  export PATH="$MOCK_BIN:$PATH"
+fi
+
 if [ "$CODING_AGENT" = "OC" ]; then
   if [ "$OC_PROVIDER" = "openrouter" ]; then
     echo "  Auth:       OpenRouter (OpenCode)"
@@ -212,6 +239,30 @@ JSON
 }
 JSON
   fi
+elif [ "$CODING_AGENT" = "CX" ]; then
+  CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+  export CODEX_HOME
+
+  if [ -n "$CODEX_AUTH_JSON_B64" ] || [ -n "$CODEX_AUTH_JSON_PATH" ]; then
+    echo "  Auth:       ChatGPT (subscription)"
+    mkdir -p "$CODEX_HOME"
+    if [ -n "$CODEX_AUTH_JSON_B64" ]; then
+      echo "$CODEX_AUTH_JSON_B64" | base64 -d > "$CODEX_HOME/auth.json"
+    else
+      cp "$CODEX_AUTH_JSON_PATH" "$CODEX_HOME/auth.json"
+    fi
+  else
+    echo "  Auth:       API Key (OpenAI)"
+    CODEX_API_KEY_VALUE="${CODEX_API_KEY:-$OPENAI_API_KEY}"
+    mkdir -p "$CODEX_HOME"
+    cat > "$CODEX_HOME/auth.json" << EOF
+{
+  "auth_mode": "apikey",
+  "OPENAI_API_KEY": "$CODEX_API_KEY_VALUE"
+}
+EOF
+  fi
+  chmod 600 "$CODEX_HOME/auth.json"
 else
   # Set up Claude Code authentication
   if [ -n "$CC_CLAUDE_CODE_OAUTH_TOKEN" ]; then
@@ -314,24 +365,28 @@ 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 "Your repository must have a .wile/prd.json file."
+  echo "This file contains the stories for Wile to implement."
   echo ""
   echo "Example structure:"
   echo '  {'
-  echo '    "userStories": ['
+  echo '    "stories": ['
   echo '      {'
-  echo '        "id": "US-001",'
+  echo '        "id": 1,'
   echo '        "title": "My feature",'
+  echo '        "description": "What this story delivers",'
   echo '        "acceptanceCriteria": ["..."],'
-  echo '        "priority": 1,'
-  echo '        "passes": false'
+  echo '        "dependsOn": [],'
+  echo '        "status": "pending"'
   echo '      }'
   echo '    ]'
   echo '  }'
   exit 1
 fi
 
+echo "Validating .wile/prd.json..."
+bun "$SCRIPT_DIR/validate-prd.ts" --path .wile/prd.json
+
 # Set up .wile/screenshots directory
 echo "Setting up .wile directory..."
 mkdir -p .wile/screenshots
@@ -390,7 +445,7 @@ elif [ $EXIT_CODE -eq 1 ]; then
     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."
+Some stories may still have status=\"pending\" in .wile/prd.json."
     git push
   fi
 elif [ $EXIT_CODE -eq 2 ]; then

package/dist/agent/scripts/claude-stream.ts

@@ -0,0 +1,159 @@
+#!/usr/bin/env bun
+import { createInterface } from "node:readline";
+
+type JsonObject = Record<string, unknown>;
+
+const isObject = (value: unknown): value is JsonObject =>
+  typeof value === "object" && value !== null;
+
+const getString = (obj: JsonObject, key: string): string | undefined => {
+  const value = obj[key];
+  return typeof value === "string" ? value : undefined;
+};
+
+const getObject = (obj: JsonObject, key: string): JsonObject | undefined => {
+  const value = obj[key];
+  return isObject(value) ? value : undefined;
+};
+
+const writeLine = (value: string): void => {
+  process.stdout.write(`${value}\n`);
+};
+
+const writeTextChunk = (text: string): void => {
+  process.stdout.write(text);
+  if (!text.endsWith("\n")) {
+    process.stdout.write("\n");
+  }
+};
+
+const extractText = (content: unknown): void => {
+  if (!Array.isArray(content)) {
+    return;
+  }
+
+  for (const rawChunk of content) {
+    if (!isObject(rawChunk)) {
+      continue;
+    }
+
+    const chunkType = getString(rawChunk, "type");
+    if (chunkType === "text") {
+      const text = getString(rawChunk, "text");
+      if (text) {
+        writeTextChunk(text);
+      }
+      continue;
+    }
+
+    if (chunkType === "thinking") {
+      const thinking = getString(rawChunk, "thinking");
+      if (thinking) {
+        writeLine(`[thinking] ${thinking}`);
+      }
+    }
+  }
+};
+
+const extractToolUse = (content: unknown): void => {
+  if (!Array.isArray(content)) {
+    return;
+  }
+
+  for (const rawChunk of content) {
+    if (!isObject(rawChunk) || getString(rawChunk, "type") !== "tool_use") {
+      continue;
+    }
+
+    const toolName = getString(rawChunk, "name") ?? "tool";
+    const input = getObject(rawChunk, "input");
+    const description = input ? getString(input, "description") ?? "" : "";
+    const command = input ? getString(input, "command") ?? "" : "";
+
+    if (description && command) {
+      writeLine(`[tool] ${toolName}: ${description} (${command})`);
+      continue;
+    }
+    if (command) {
+      writeLine(`[tool] ${toolName}: ${command}`);
+      continue;
+    }
+    if (description) {
+      writeLine(`[tool] ${toolName}: ${description}`);
+      continue;
+    }
+    writeLine(`[tool] ${toolName}`);
+  }
+};
+
+const rl = createInterface({
+  input: process.stdin,
+  crlfDelay: Infinity
+});
+
+rl.on("line", (line: string) => {
+  if (!line.trim()) {
+    return;
+  }
+
+  if (process.env.WILE_STREAM_JSON === "true") {
+    writeLine(line);
+    return;
+  }
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  if (!isObject(parsed)) {
+    return;
+  }
+
+  const payloadType = getString(parsed, "type");
+
+  if (payloadType === "system" && getString(parsed, "subtype") === "init") {
+    const model = getString(parsed, "model") ?? "unknown";
+    writeLine(`[system] model: ${model}`);
+    return;
+  }
+
+  if (payloadType === "assistant") {
+    const message = getObject(parsed, "message");
+    if (!message) {
+      return;
+    }
+    const content = message["content"];
+    extractToolUse(content);
+    extractText(content);
+    return;
+  }
+
+  if (payloadType === "user") {
+    const message = getObject(parsed, "message");
+    const content = message ? message["content"] : undefined;
+    if (!Array.isArray(content)) {
+      return;
+    }
+
+    for (const rawChunk of content) {
+      if (!isObject(rawChunk) || getString(rawChunk, "type") !== "tool_result") {
+        continue;
+      }
+
+      const toolUseId = getString(rawChunk, "tool_use_id") ?? "unknown";
+      const isError = rawChunk["is_error"] === true;
+      writeLine(`[tool-result] ${toolUseId} ${isError ? "error" : "ok"}`);
+    }
+    return;
+  }
+
+  if (payloadType === "result") {
+    const result = getString(parsed, "result");
+    if (result) {
+      writeLine(result);
+    }
+  }
+});