wile 0.4.17 → 0.4.19

package/README.md

@@ -19,13 +19,14 @@ bunx wile config
 This creates:
 
 - `.wile/secrets/.env` for required credentials
-- `.wile/secrets/.env.project` for env vars forwarded into the container
+- `.wile/.env.project` for env vars forwarded into the container (or set `WILE_ENV_PROJECT_PATH`)
 - `.wile/.gitignore` to ignore `secrets/`, `screenshots/`, and `logs/`
 - `.wile/prd.json` (empty) and `.wile/prd.json.example`
 
 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), otherwise `CODING_AGENT=CC` uses Claude Code.
 
 ## Run Wile
 

package/dist/agent/.env.example

@@ -2,7 +2,16 @@
 # Copy this file to .env and fill in your values
 
 # =============================================================================
-# REQUIRED - Claude Code Authentication (choose ONE)
+# REQUIRED - Coding Agent Selection
+# =============================================================================
+
+# Choose which coding agent to run:
+# - CC = Claude Code (default)
+# - OC = OpenCode (OpenRouter)
+CODING_AGENT=CC
+
+# =============================================================================
+# REQUIRED - Claude Code Authentication (CC only, choose ONE)
 # =============================================================================
 
 # OPTION 1: OAuth Token (RECOMMENDED - uses your Pro/Max subscription)
@@ -15,6 +24,15 @@ CC_CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-xxxxx
 # Only use this if you don't have a Pro/Max subscription
 # CC_ANTHROPIC_API_KEY=sk-ant-xxxxx
 
+# =============================================================================
+# REQUIRED - OpenCode Authentication (OC only)
+# =============================================================================
+
+# OpenRouter API key (used with OpenCode)
+# OC_OPENROUTER_API_KEY=sk-or-xxxxx
+# OpenRouter model id (Wile maps `glm-4.7` to `openrouter/z-ai/glm-4.7`)
+# OC_MODEL=glm-4.7
+
 # =============================================================================
 # GitHub Authentication (required when WILE_REPO_SOURCE=github)
 # =============================================================================

package/dist/agent/Dockerfile

@@ -48,6 +48,10 @@ ENV NODE_OPTIONS="--max-old-space-size=4096"
 # https://www.npmjs.com/package/@anthropic-ai/claude-code
 RUN npm install -g @anthropic-ai/claude-code
 
+# Install OpenCode CLI
+# https://www.npmjs.com/package/opencode-ai
+RUN npm install -g opencode-ai@latest
+
 # CC_ANTHROPIC_API_KEY is passed at runtime via environment variable (mapped to ANTHROPIC_API_KEY in entrypoint)
 # Usage: claude --dangerously-skip-permissions
 

package/dist/agent/README.md

@@ -110,8 +110,11 @@ For UI work, tell the agent how to verify:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
+| `CODING_AGENT` | No | `CC` (Claude Code, default) or `OC` (OpenCode via OpenRouter) |
 | `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) |
+| `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`) |
 | `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 |
@@ -119,7 +122,7 @@ For UI work, tell the agent how to verify:
 | `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.
+*Either `CC_CLAUDE_CODE_OAUTH_TOKEN` or `CC_ANTHROPIC_API_KEY` is required when `CODING_AGENT=CC`.
 
 ## Output Files
 

package/dist/agent/entrypoint.sh

@@ -38,6 +38,10 @@ 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 (process.env.TEST_FORWARD) {
+  console.log(`Forwarded env: ${process.env.TEST_FORWARD}`);
+}
+
 if (pending.length === 0) {
   console.log('No pending stories to complete in test mode.');
   process.exit(0);
@@ -67,10 +71,12 @@ NODE
   exit 0
 fi
 
+CODING_AGENT="${CODING_AGENT:-CC}"
 REPO_SOURCE="${WILE_REPO_SOURCE:-github}"
 LOCAL_REPO_PATH="${WILE_LOCAL_REPO_PATH:-/home/wile/workspace/repo}"
 ADDITIONAL_INSTRUCTIONS_PATH="${WILE_ADDITIONAL_INSTRUCTIONS:-}"
 
+echo "  Agent:      $CODING_AGENT"
 if [ "$REPO_SOURCE" = "local" ]; then
   if [ ! -d "$LOCAL_REPO_PATH" ]; then
     echo "ERROR: WILE_LOCAL_REPO_PATH does not exist: $LOCAL_REPO_PATH"
@@ -83,53 +89,74 @@ else
   : "${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
+# Authentication for selected coding agent
+if [ "$CODING_AGENT" = "OC" ]; then
+  if [ -z "$OC_OPENROUTER_API_KEY" ]; then
+    echo "ERROR: OC_OPENROUTER_API_KEY is required for OpenCode"
+    exit 1
+  fi
+  if [ -z "$OC_MODEL" ]; then
+    echo "ERROR: OC_MODEL is required for OpenCode"
+    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"
+    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
 fi
 
 MAX_ITERATIONS=${MAX_ITERATIONS:-25}
 SCRIPT_DIR="/home/wile/scripts"
 WORKSPACE="/home/wile/workspace"
 
-if [ "${WILE_MOCK_CLAUDE:-}" = "true" ]; then
+if [ "${WILE_MOCK_CLAUDE:-}" = "true" ] && [ "$CODING_AGENT" = "CC" ]; then
   echo "  Claude:     Mocked"
   MOCK_BIN="/home/wile/mock-bin"
   mkdir -p "$MOCK_BIN"
-  cat > "$MOCK_BIN/claude" << 'MOCK'
-#!/bin/sh
-cat <<'JSON'
-{"type":"assistant","message":{"content":[{"type":"text","text":"ANSWER: 2\n<promise>COMPLETE</promise>\n"}]}}
-JSON
-MOCK
+  cp "$SCRIPT_DIR/mock-claude.sh" "$MOCK_BIN/claude"
   chmod +x "$MOCK_BIN/claude"
   export PATH="$MOCK_BIN:$PATH"
 fi
 
-# Set up Claude Code authentication
-if [ -n "$CC_CLAUDE_CODE_OAUTH_TOKEN" ]; then
-  echo "  Auth:       OAuth (Pro/Max subscription)"
+if [ "$CODING_AGENT" = "OC" ]; then
+  echo "  Auth:       OpenRouter (OpenCode)"
+  OPENCODE_DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/opencode"
+  mkdir -p "$OPENCODE_DATA_DIR"
+  cat > "$OPENCODE_DATA_DIR/auth.json" << OPENCODEAUTH
+{
+  "openrouter": {
+    "type": "api",
+    "key": "$OC_OPENROUTER_API_KEY"
+  }
+}
+OPENCODEAUTH
+  chmod 600 "$OPENCODE_DATA_DIR/auth.json"
+  export OPENROUTER_API_KEY="$OC_OPENROUTER_API_KEY"
+else
+  # 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 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'
+    # 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
+    # Create credentials file with the OAuth token
+    cat > ~/.claude/.credentials.json << CREDSJSON
 {
   "claudeAiOauth": {
     "accessToken": "$CC_CLAUDE_CODE_OAUTH_TOKEN",
@@ -140,14 +167,15 @@ CLAUDEJSON
 }
 CREDSJSON
 
-  # Copy to alternate location too
-  cp ~/.claude/.credentials.json ~/.config/claude/.credentials.json
+    # 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"
+    # 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
 fi
 
 if [ "$REPO_SOURCE" = "local" ]; then

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

@@ -47,6 +47,10 @@ const extractToolUse = (content) => {
 
 rl.on("line", (line) => {
   if (!line.trim()) return;
+  if (process.env.WILE_STREAM_JSON === "true") {
+    writeLine(line);
+    return;
+  }
   let payload;
   try {
     payload = JSON.parse(line);

package/dist/agent/scripts/mock-claude.sh

@@ -0,0 +1,49 @@
+#!/bin/sh
+set -e
+
+COUNT_FILE="/tmp/wile-claude-mock-count"
+if [ ! -f "$COUNT_FILE" ]; then
+  echo "0" > "$COUNT_FILE"
+fi
+
+COUNT=$(cat "$COUNT_FILE")
+NEXT_COUNT=$((COUNT + 1))
+echo "$NEXT_COUNT" > "$COUNT_FILE"
+
+if [ "${WILE_MOCK_MODE:-}" = "preflight_fail" ]; then
+  PROGRESS_PATH=".wile/progress.txt"
+  if [ -f "$PROGRESS_PATH" ]; then
+    :
+  else
+    printf '%s\n' "# Wile Progress Log" "" "## Codebase Patterns" "" "---" > "$PROGRESS_PATH"
+  fi
+
+  DATE=$(date +%Y-%m-%d)
+  cat >> "$PROGRESS_PATH" <<EOF
+
+---
+
+## ${DATE} - PREFLIGHT FAILED
+
+**Checks run:**
+- Mocked preflight check
+
+**Failures:**
+- Mocked preflight failure (WILE_MOCK_MODE=preflight_fail)
+EOF
+
+  cat <<'JSON'
+{"type":"assistant","message":{"content":[{"type":"text","text":"<promise>PREFLIGHT_FAILED</promise>\n"}]}}
+JSON
+  exit 0
+fi
+
+if [ "$COUNT" -eq 0 ]; then
+  cat <<'JSON'
+{"type":"assistant","message":{"content":[{"type":"text","text":"ANSWER: 2\n"}]}}
+JSON
+else
+  cat <<'JSON'
+{"type":"assistant","message":{"content":[{"type":"text","text":"<promise>COMPLETE</promise>\n"}]}}
+JSON
+fi

package/dist/agent/scripts/opencode-stream.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+const readline = require("node:readline");
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  crlfDelay: Infinity
+});
+
+const writeLine = (value) => {
+  process.stdout.write(`${value}\n`);
+};
+
+const formatToolLine = (tool, title, input) => {
+  if (title) return `[tool] ${tool}: ${title}`;
+  if (input && Object.keys(input).length > 0) {
+    return `[tool] ${tool}: ${JSON.stringify(input)}`;
+  }
+  return `[tool] ${tool}`;
+};
+
+rl.on("line", (line) => {
+  if (!line.trim()) return;
+  let payload;
+  try {
+    payload = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  if (payload.type === "text" && payload.part?.text) {
+    process.stdout.write(payload.part.text);
+    return;
+  }
+
+  if (payload.type === "tool_use" && payload.part) {
+    const tool = payload.part.tool ?? "tool";
+    const title = payload.part.state?.title ?? "";
+    const input = payload.part.state?.input ?? {};
+    writeLine(formatToolLine(tool, title, input));
+    return;
+  }
+
+  if (payload.type === "error" && payload.error) {
+    const name = payload.error?.name ?? "error";
+    const message = payload.error?.data?.message ?? payload.error?.message ?? "";
+    writeLine(`[error] ${name}${message ? `: ${message}` : ""}`);
+    return;
+  }
+});

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

@@ -0,0 +1,56 @@
+# Wile Preflight (Iteration 0)
+
+You are running the preflight phase for a Wile autonomous coding session.
+
+## Tasks
+
+1. Verify `.wile/prd.json` exists and is valid JSON:
+
+```bash
+cat .wile/prd.json
+```
+
+2. If `.wile/preflight.md` does **not** exist, do nothing else. Do not modify files and do not print extra output.
+
+3. If `.wile/preflight.md` exists, read it and follow the checks exactly, in order. Run any commands listed in code blocks. If it describes a check without a command, perform the check and note the result.
+
+4. If **any** check fails or cannot be completed:
+   - Append a new entry to `.wile/progress.txt` describing what failed and why, using this format:
+
+```markdown
+---
+
+## [DATE] - PREFLIGHT FAILED
+
+**Checks run:**
+- ...
+
+**Failures:**
+- ...
+```
+
+   - If GitHub is configured (`WILE_REPO_SOURCE=github` or `GITHUB_REPO_URL` is set), commit and push the progress update:
+
+```bash
+git add .wile/progress.txt
+git commit -m "chore: preflight failed"
+git push
+```
+   - Respond with exactly:
+
+```
+<promise>PREFLIGHT_FAILED</promise>
+```
+
+The entire response must be exactly that single line. No other text before or after. No extra lines. No markdown. No backticks. No code blocks.
+
+5. If all checks pass, respond with exactly:
+```
+<promise>COMPLETE</promise>
+```
+The entire response must be exactly that single line. No other text before or after. No extra lines. No markdown. No backticks. No code blocks.
+
+## Notes
+
+- Preflight may have side effects if the checks require them.
+- Do not change any files unless a failure must be recorded in `.wile/progress.txt`.

package/dist/agent/scripts/prompt.md

@@ -35,8 +35,8 @@ Pick the highest priority story where `passes: false` and implement it completel
 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
+npm run typecheck || npm run tsc || npx tsc --noEmit
+npm test || npm run test
 ```
 
 If tests or typecheck fail, fix the issues before proceeding.
@@ -58,6 +58,9 @@ Set `passes: true` for the completed story:
 **Implemented:**
 - What was done
 
+**Verification:**
+- Command(s) run and pass/fail status
+
 **Files changed:**
 - file1.ts
 - file2.ts
@@ -87,6 +90,7 @@ After completing steps 1-8, check if ALL stories in `.wile/prd.json` have `passe
 ```
 <promise>COMPLETE</promise>
 ```
+The entire response must be exactly that single line. No other text before or after. No extra lines. No markdown. No backticks. No code blocks.
 
 **If there are still stories with `passes: false`**, end your response normally. The loop will call you again for the next story.
 
@@ -103,6 +107,8 @@ After completing steps 1-8, check if ALL stories in `.wile/prd.json` have `passe
 9. **Integration tests must validate real system behavior, not just the harness**
 10. **If you discover reusable, module-specific guidance, add it to the nearest AGENTS.md**
     Note: Never update .wile/AGENTS.md.
+11. **Definition of done** - Do not set `passes: true` unless each acceptance criterion has a concrete verification and all verifications passed. If any verification fails or can’t run, leave `passes: false` and explain why in `.wile/progress.txt`.
+12. **No verification section means no pass** - If the progress entry lacks a **Verification** section, do not mark `passes: true`.
 
 ## Common Patterns
 

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

@@ -47,7 +47,7 @@ EOF
 cat > "$BIN_DIR/claude" <<'EOF'
 #!/bin/sh
 cat > "$CLAUDE_CAPTURE"
-printf '%s\n' '{"type":"assistant","message":{"content":[{"type":"text","text":"<promise>COMPLETE</promise>\\n"}]}}'
+printf '%s\n' '{"type":"assistant","message":{"content":[{"type":"text","text":"<promise>COMPLETE</promise>\n"}]}}'
 EOF
   chmod +x "$BIN_DIR/claude"
 

package/dist/agent/scripts/test-env-project-docker.sh

@@ -0,0 +1,52 @@
+#!/bin/sh
+set -euo pipefail
+
+ROOT_DIR=$(cd "$(dirname "$0")/../../.." && pwd)
+AGENT_DIR="$ROOT_DIR/packages/agent"
+
+docker build -t wile-agent:local "$AGENT_DIR" >/dev/null
+
+TMP_DIR=$(mktemp -d /tmp/wile-env-project-XXXXXX)
+cleanup() {
+  rm -rf "$TMP_DIR"
+}
+trap cleanup EXIT INT TERM
+
+mkdir -p "$TMP_DIR/.wile/secrets"
+cat > "$TMP_DIR/.wile/prd.json" <<'JSON'
+{
+  "userStories": [
+    {
+      "id": "US-TEST-ENV-001",
+      "title": "Env project forward test",
+      "acceptanceCriteria": ["n/a"],
+      "priority": 1,
+      "passes": false
+    }
+  ]
+}
+JSON
+
+printf "secrets/\nscreenshots/\nlogs/\n" > "$TMP_DIR/.wile/.gitignore"
+
+printf "TEST_FORWARD=ok\n" > "$TMP_DIR/.env.custom"
+
+cat > "$TMP_DIR/.wile/secrets/.env" <<'ENV'
+CODING_AGENT=CC
+WILE_ENV_PROJECT_PATH=.env.custom
+ENV
+
+export WILE_AGENT_DIR="$AGENT_DIR"
+
+cd "$TMP_DIR"
+node "$ROOT_DIR/packages/cli/dist/cli.js" run --test --max-iterations 1 >/dev/null 2>&1
+
+LOG_FILE=$(ls "$TMP_DIR/.wile/logs"/run-*.log | head -n 1)
+if [ -z "$LOG_FILE" ]; then
+  echo "error: expected run log file" >&2
+  exit 1
+fi
+
+grep -q "Forwarded env: ok" "$LOG_FILE"
+
+echo "test-env-project-docker: ok"

package/dist/agent/scripts/test-preflight-docker.sh

@@ -0,0 +1,134 @@
+#!/bin/sh
+set -euo pipefail
+
+ROOT_DIR=$(cd "$(dirname "$0")/../../.." && pwd)
+AGENT_DIR="$ROOT_DIR/packages/agent"
+
+docker build -t wile-agent:local "$AGENT_DIR" >/dev/null
+
+run_failure_case() {
+  TMP_DIR=$(mktemp -d /tmp/wile-preflight-fail-XXXXXX)
+  cleanup() {
+    rm -rf "$TMP_DIR"
+  }
+  trap cleanup EXIT INT TERM
+
+  mkdir -p "$TMP_DIR/.wile"
+  cat > "$TMP_DIR/.wile/prd.json" <<'JSON'
+{
+  "userStories": [
+    {
+      "id": "US-TEST-001",
+      "title": "Preflight fail test",
+      "acceptanceCriteria": ["n/a"],
+      "priority": 1,
+      "passes": false
+    }
+  ]
+}
+JSON
+
+  cat > "$TMP_DIR/.wile/progress.txt" <<'TXT'
+# Wile Progress Log
+
+## Codebase Patterns
+
+---
+TXT
+
+  cat > "$TMP_DIR/.wile/preflight.md" <<'MD'
+<!--
+Use bullet points for preflight checks, e.g.
+- Confirm SUPABASE_DB_URL is set.
+- Run `supabase db reset --db-url "$SUPABASE_DB_URL"`.
+-->
+MD
+
+  OUTPUT_FILE="$TMP_DIR/output.txt"
+
+  set +e
+  docker run --rm \
+    -e CODING_AGENT=CC \
+    -e CC_ANTHROPIC_API_KEY=dummy-key \
+    -e WILE_REPO_SOURCE=local \
+    -e WILE_LOCAL_REPO_PATH=/home/wile/workspace/repo \
+    -e MAX_ITERATIONS=1 \
+    -e WILE_MOCK_CLAUDE=true \
+    -e WILE_MOCK_MODE=preflight_fail \
+    -v "$TMP_DIR:/home/wile/workspace/repo" \
+    wile-agent:local > "$OUTPUT_FILE" 2>&1
+  EXIT_CODE=$?
+  set -e
+
+  if [ "$EXIT_CODE" -eq 0 ]; then
+    echo "error: expected non-zero exit code for preflight failure" >&2
+    exit 1
+  fi
+
+  grep -q "PREFLIGHT FAILED - Cannot continue" "$OUTPUT_FILE"
+  grep -q "PREFLIGHT FAILED" "$TMP_DIR/.wile/progress.txt"
+
+  rm -rf "$TMP_DIR"
+  trap - EXIT INT TERM
+}
+
+run_success_case() {
+  TMP_DIR=$(mktemp -d /tmp/wile-preflight-success-XXXXXX)
+  cleanup() {
+    rm -rf "$TMP_DIR"
+  }
+  trap cleanup EXIT INT TERM
+
+  mkdir -p "$TMP_DIR/.wile"
+  cat > "$TMP_DIR/.wile/prd.json" <<'JSON'
+{
+  "userStories": [
+    {
+      "id": "US-TEST-002",
+      "title": "Preflight success test",
+      "acceptanceCriteria": ["n/a"],
+      "priority": 1,
+      "passes": false
+    }
+  ]
+}
+JSON
+
+  cat > "$TMP_DIR/.wile/preflight.md" <<'MD'
+<!--
+Use bullet points for preflight checks, e.g.
+- Confirm SUPABASE_DB_URL is set.
+- Run `supabase db reset --db-url "$SUPABASE_DB_URL"`.
+-->
+MD
+
+  OUTPUT_FILE="$TMP_DIR/output.txt"
+
+  set +e
+  docker run --rm \
+    -e CODING_AGENT=CC \
+    -e CC_ANTHROPIC_API_KEY=dummy-key \
+    -e WILE_REPO_SOURCE=local \
+    -e WILE_LOCAL_REPO_PATH=/home/wile/workspace/repo \
+    -e MAX_ITERATIONS=1 \
+    -e WILE_MOCK_CLAUDE=true \
+    -v "$TMP_DIR:/home/wile/workspace/repo" \
+    wile-agent:local > "$OUTPUT_FILE" 2>&1
+  EXIT_CODE=$?
+  set -e
+
+  if [ "$EXIT_CODE" -ne 0 ]; then
+    echo "error: expected zero exit code for preflight success" >&2
+    exit 1
+  fi
+
+  grep -q "Preflight complete. Starting main loop..." "$OUTPUT_FILE"
+
+  rm -rf "$TMP_DIR"
+  trap - EXIT INT TERM
+}
+
+run_failure_case
+run_success_case
+
+echo "test-preflight-docker: ok"

package/dist/agent/scripts/wile-preflight.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+#
+# Wile - Preflight check (single run)
+#
+
+set -e
+
+CODING_AGENT=${CODING_AGENT:-CC}
+CLAUDE_MODEL=${CC_CLAUDE_MODEL:-sonnet}
+OC_MODEL=${OC_MODEL:-glm-4.7}
+if [[ "$OC_MODEL" != */* ]]; then
+  OC_MODEL="z-ai/$OC_MODEL"
+fi
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PREFLIGHT_PROMPT_FILE="$SCRIPT_DIR/prompt-preflight.md"
+TEE_TARGET="${WILE_TEE_TARGET:-/dev/stderr}"
+if ! ( : > "$TEE_TARGET" ) 2>/dev/null; then
+  TEE_TARGET="/dev/null"
+fi
+
+echo "══════════════════════════════════════════════════════"
+echo "  🌵  WILE - Preflight"
+echo "══════════════════════════════════════════════════════"
+echo "  Agent:          $CODING_AGENT"
+if [ "$CODING_AGENT" = "OC" ]; then
+  echo "  Model:          $OC_MODEL"
+else
+  echo "  Model:          $CLAUDE_MODEL"
+fi
+echo "  Prompt file:    $PREFLIGHT_PROMPT_FILE"
+echo "══════════════════════════════════════════════════════"
+echo ""
+
+if [ ! -f "$PREFLIGHT_PROMPT_FILE" ]; then
+  echo "ERROR: Preflight prompt file not found: $PREFLIGHT_PROMPT_FILE"
+  exit 1
+fi
+
+run_claude() {
+  local prompt_path="$1"
+  cat "$prompt_path" \
+    | claude --model "$CLAUDE_MODEL" --print --output-format stream-json --verbose --dangerously-skip-permissions \
+    | node "$SCRIPT_DIR/claude-stream.js"
+}
+
+run_opencode() {
+  local prompt_path="$1"
+  cat "$prompt_path" \
+    | opencode run --format json --model "openrouter/$OC_MODEL" \
+    | node "$SCRIPT_DIR/opencode-stream.js"
+}
+
+run_agent() {
+  local prompt_path="$1"
+  if [ "$CODING_AGENT" = "OC" ]; then
+    run_opencode "$prompt_path"
+  else
+    run_claude "$prompt_path"
+  fi
+}
+
+OUTPUT=$(run_agent "$PREFLIGHT_PROMPT_FILE" | tee "$TEE_TARGET") || true
+CLEAN_OUTPUT=$(printf '%s' "$OUTPUT" | tr -d '\r' | sed -e 's/[[:space:]]*$//')
+if printf '%s\n' "$CLEAN_OUTPUT" | grep -q -E '^[[:space:]]*<promise>PREFLIGHT_FAILED</promise>[[:space:]]*$'; then
+  if printf '%s' "$CLEAN_OUTPUT" | grep -F '```' >/dev/null 2>&1; then
+    :
+  elif printf '%s' "$CLEAN_OUTPUT" | grep -F '`<promise>PREFLIGHT_FAILED</promise>`' >/dev/null 2>&1; then
+    :
+  else
+  echo ""
+  echo "══════════════════════════════════════════════════════"
+  echo "  ❌ PREFLIGHT FAILED"
+  echo "══════════════════════════════════════════════════════"
+  exit 2
+  fi
+fi
+
+echo ""
+echo "══════════════════════════════════════════════════════"
+echo "  ✅ PREFLIGHT COMPLETE"
+echo "══════════════════════════════════════════════════════"

package/dist/agent/scripts/wile.sh

@@ -7,17 +7,32 @@
 set -e
 
 MAX_ITERATIONS=${1:-25}
+CODING_AGENT=${CODING_AGENT:-CC}
 CLAUDE_MODEL=${CC_CLAUDE_MODEL:-sonnet}
+OC_MODEL=${OC_MODEL:-glm-4.7}
+if [[ "$OC_MODEL" != */* ]]; then
+  OC_MODEL="z-ai/$OC_MODEL"
+fi
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROMPT_FILE="$SCRIPT_DIR/prompt.md"
+PREFLIGHT_PROMPT_FILE="$SCRIPT_DIR/prompt-preflight.md"
 SETUP_PROMPT_FILE="$SCRIPT_DIR/prompt-setup.md"
 ADDITIONAL_PROMPT_FILE="${WILE_ADDITIONAL_INSTRUCTIONS:-}"
+TEE_TARGET="${WILE_TEE_TARGET:-/dev/stderr}"
+if ! ( : > "$TEE_TARGET" ) 2>/dev/null; then
+  TEE_TARGET="/dev/null"
+fi
 
 echo "══════════════════════════════════════════════════════"
 echo "  🌵  WILE - Autonomous Coding Agent"
 echo "══════════════════════════════════════════════════════"
+echo "  Agent:          $CODING_AGENT"
 echo "  Max iterations: $MAX_ITERATIONS"
-echo "  Model:          $CLAUDE_MODEL"
+if [ "$CODING_AGENT" = "OC" ]; then
+  echo "  Model:          $OC_MODEL"
+else
+  echo "  Model:          $CLAUDE_MODEL"
+fi
 echo "  Prompt file:    $PROMPT_FILE"
 echo "══════════════════════════════════════════════════════"
 echo ""
@@ -39,22 +54,62 @@ if [ -n "$ADDITIONAL_PROMPT_FILE" ] && [ -f "$ADDITIONAL_PROMPT_FILE" ]; then
   fi
 fi
 
+run_claude() {
+  local prompt_path="$1"
+  cat "$prompt_path" \
+    | claude --model "$CLAUDE_MODEL" --print --output-format stream-json --verbose --dangerously-skip-permissions \
+    | node "$SCRIPT_DIR/claude-stream.js"
+}
+
+run_opencode() {
+  local prompt_path="$1"
+  cat "$prompt_path" \
+    | opencode run --format json --model "openrouter/$OC_MODEL" \
+    | node "$SCRIPT_DIR/opencode-stream.js"
+}
+
+run_agent() {
+  local prompt_path="$1"
+  if [ "$CODING_AGENT" = "OC" ]; then
+    run_opencode "$prompt_path"
+  else
+    run_claude "$prompt_path"
+  fi
+}
+
 # ════════════════════════════════════════════════════════════
-# ITERATION 0: Setup
+# ITERATION 0: Preflight / Setup
 # ════════════════════════════════════════════════════════════
 echo ""
 echo "══════════════════════════════════════════════════════"
-echo "  Iteration 0 - Setup"
+echo "  Iteration 0 - Preflight"
 echo "══════════════════════════════════════════════════════"
 echo ""
 
-if [ -f "$SETUP_PROMPT_FILE" ]; then
-  OUTPUT=$(
-    cat "$SETUP_PROMPT_FILE" \
-      | claude --model "$CLAUDE_MODEL" --print --output-format stream-json --verbose --dangerously-skip-permissions \
-      | node "$SCRIPT_DIR/claude-stream.js" \
-      | tee /dev/stderr
-  ) || true
+if [ -f "$PREFLIGHT_PROMPT_FILE" ]; then
+  OUTPUT=$(run_agent "$PREFLIGHT_PROMPT_FILE" | tee "$TEE_TARGET") || true
+
+  # Check if preflight failed critically (tag must be on its own line; reject backticks/code fences)
+  CLEAN_OUTPUT=$(printf '%s' "$OUTPUT" | tr -d '\r' | sed -e 's/[[:space:]]*$//')
+  if printf '%s\n' "$CLEAN_OUTPUT" | grep -q -E '^[[:space:]]*<promise>PREFLIGHT_FAILED</promise>[[:space:]]*$'; then
+    if printf '%s' "$CLEAN_OUTPUT" | grep -F '```' >/dev/null 2>&1; then
+      :
+    elif printf '%s' "$CLEAN_OUTPUT" | grep -F '`<promise>PREFLIGHT_FAILED</promise>`' >/dev/null 2>&1; then
+      :
+    else
+    echo ""
+    echo "══════════════════════════════════════════════════════"
+    echo "  ❌ PREFLIGHT FAILED - Cannot continue"
+    echo "══════════════════════════════════════════════════════"
+    exit 2
+    fi
+  fi
+
+  echo ""
+  echo "Preflight complete. Starting main loop..."
+  sleep 2
+elif [ -f "$SETUP_PROMPT_FILE" ]; then
+  OUTPUT=$(run_agent "$SETUP_PROMPT_FILE" | tee "$TEE_TARGET") || true
 
   # Check if setup failed critically
   if echo "$OUTPUT" | grep -q "<promise>SETUP_FAILED</promise>"; then
@@ -85,20 +140,22 @@ for i in $(seq 1 $MAX_ITERATIONS); do
   # 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" --print --output-format stream-json --verbose --dangerously-skip-permissions \
-      | node "$SCRIPT_DIR/claude-stream.js" \
-      | tee /dev/stderr
-  ) || true
-
-  # Check for completion signal
-  if echo "$OUTPUT" | grep -q "<promise>COMPLETE</promise>"; then
+  OUTPUT=$(run_agent "$PROMPT_FILE" | tee "$TEE_TARGET") || true
+
+  # Check for completion signal (tag must be on its own line; reject backticks/code fences)
+  CLEAN_OUTPUT=$(printf '%s' "$OUTPUT" | tr -d '\r' | sed -e 's/[[:space:]]*$//')
+  if printf '%s\n' "$CLEAN_OUTPUT" | grep -q -E '^[[:space:]]*<promise>COMPLETE</promise>[[:space:]]*$'; then
+    if printf '%s' "$CLEAN_OUTPUT" | grep -F '```' >/dev/null 2>&1; then
+      :
+    elif printf '%s' "$CLEAN_OUTPUT" | grep -F '`<promise>COMPLETE</promise>`' >/dev/null 2>&1; then
+      :
+    else
     echo ""
     echo "══════════════════════════════════════════════════════"
     echo "  ✅ ALL TASKS COMPLETE"
     echo "══════════════════════════════════════════════════════"
     exit 0
+    fi
   fi
 
   echo ""

package/dist/cli.js

@@ -7442,7 +7442,7 @@ var {
 
 // src/cli.ts
 import { readFileSync as readFileSync3 } from "node:fs";
-import { resolve as resolve2 } from "node:path";
+import { resolve as resolve3 } from "node:path";
 
 // src/commands/config.ts
 var import_prompts = __toESM(require_prompts3(), 1);
@@ -7544,6 +7544,7 @@ var prdExample = {
 var tips = {
   oauth: "Tip: run 'claude setup-token' on your machine to generate an OAuth token (uses Pro/Max subscription).",
   apiKey: "Tip: create an Anthropic API key in the console (uses API credits).",
+  openrouter: "Tip: create an OpenRouter API key for OpenCode (used for z-ai/glm-4.7).",
   github: "Tip: use a GitHub Personal Access Token (fine-grained recommended). Create at https://github.com/settings/tokens?type=beta with Contents (read/write) and Metadata (read)."
 };
 var readEnvFile = async (path) => {
@@ -7554,7 +7555,7 @@ var readEnvFile = async (path) => {
   return import_dotenv.default.parse(contents);
 };
 var ensureGitignore = async (path) => {
-  const entries = ["secrets/", "screenshots/", "logs/"];
+  const entries = ["secrets/", "screenshots/", "logs/", ".env.project"];
   if (!existsSync(path)) {
     await writeFile(path, entries.join(`
 `) + `
@@ -7616,53 +7617,82 @@ var runConfig = async () => {
   const wileDir = join(cwd, ".wile");
   const secretsDir = join(wileDir, "secrets");
   const envPath = join(secretsDir, ".env");
-  const envProjectPath = join(secretsDir, ".env.project");
+  const envProjectPath = join(wileDir, ".env.project");
   const gitignorePath = join(wileDir, ".gitignore");
   const prdPath = join(wileDir, "prd.json");
   const prdExamplePath = join(wileDir, "prd.json.example");
   const additionalInstructionsPath = join(wileDir, "additional-instructions.md");
+  const preflightPath = join(wileDir, "preflight.md");
   const agentsPath = join(wileDir, "AGENTS.md");
   await mkdir(secretsDir, { recursive: true });
   const existingEnv = await readEnvFile(envPath);
-  await prompt({
+  const codingAgentResponse = await prompt({
     type: "select",
     name: "codingAgent",
     message: "Select coding agent",
-    choices: [{ title: "Claude Code (CC)", value: "CC" }],
-    initial: 0
-  });
-  const authDefault = existingEnv.CC_CLAUDE_CODE_OAUTH_TOKEN ? "oauth" : existingEnv.CC_ANTHROPIC_API_KEY ? "apiKey" : "oauth";
-  const authResponse = await prompt({
-    type: "select",
-    name: "authMethod",
-    message: "Claude Code authentication",
     choices: [
-      { title: "OAuth token (Pro/Max subscription)", value: "oauth" },
-      { title: "API key (Anthropic credits)", value: "apiKey" }
+      { title: "Claude Code (CC)", value: "CC" },
+      { title: "OpenCode (OC)", value: "OC" }
     ],
-    initial: authDefault === "apiKey" ? 1 : 0
-  });
-  const authMethod = authResponse.authMethod;
-  console.log("");
-  console.log(authMethod === "oauth" ? tips.oauth : tips.apiKey);
-  console.log("");
-  const authValueResponse = await prompt({
-    type: "password",
-    name: "authValue",
-    message: authMethod === "oauth" ? "Claude Code OAuth token (press enter to keep existing)" : "Anthropic API key (press enter to keep existing)",
-    initial: authMethod === "oauth" ? existingEnv.CC_CLAUDE_CODE_OAUTH_TOKEN ?? "" : existingEnv.CC_ANTHROPIC_API_KEY ?? ""
-  });
-  const defaultModelResponse = await prompt({
-    type: "select",
-    name: "model",
-    message: "Default Claude model",
-    choices: [
-      { title: "sonnet", value: "sonnet" },
-      { title: "opus", value: "opus" },
-      { title: "haiku", value: "haiku" }
-    ],
-    initial: existingEnv.CC_CLAUDE_MODEL === "opus" ? 1 : existingEnv.CC_CLAUDE_MODEL === "haiku" ? 2 : 0
+    initial: existingEnv.CODING_AGENT === "OC" ? 1 : 0
   });
+  const codingAgent = codingAgentResponse.codingAgent;
+  let authMethod = null;
+  let authValueResponse = {};
+  let defaultModelResponse = {};
+  let ocKeyResponse = {};
+  let ocModelResponse = {};
+  if (codingAgent === "CC") {
+    const authDefault = existingEnv.CC_CLAUDE_CODE_OAUTH_TOKEN ? "oauth" : existingEnv.CC_ANTHROPIC_API_KEY ? "apiKey" : "oauth";
+    const authResponse = await prompt({
+      type: "select",
+      name: "authMethod",
+      message: "Claude Code authentication",
+      choices: [
+        { title: "OAuth token (Pro/Max subscription)", value: "oauth" },
+        { title: "API key (Anthropic credits)", value: "apiKey" }
+      ],
+      initial: authDefault === "apiKey" ? 1 : 0
+    });
+    authMethod = authResponse.authMethod;
+    console.log("");
+    console.log(authMethod === "oauth" ? tips.oauth : tips.apiKey);
+    console.log("");
+    authValueResponse = await prompt({
+      type: "password",
+      name: "authValue",
+      message: authMethod === "oauth" ? "Claude Code OAuth token (press enter to keep existing)" : "Anthropic API key (press enter to keep existing)",
+      initial: authMethod === "oauth" ? existingEnv.CC_CLAUDE_CODE_OAUTH_TOKEN ?? "" : existingEnv.CC_ANTHROPIC_API_KEY ?? ""
+    });
+    defaultModelResponse = await prompt({
+      type: "select",
+      name: "model",
+      message: "Default Claude model",
+      choices: [
+        { title: "sonnet", value: "sonnet" },
+        { title: "opus", value: "opus" },
+        { title: "haiku", value: "haiku" }
+      ],
+      initial: existingEnv.CC_CLAUDE_MODEL === "opus" ? 1 : existingEnv.CC_CLAUDE_MODEL === "haiku" ? 2 : 0
+    });
+  } else {
+    console.log("");
+    console.log(tips.openrouter);
+    console.log("");
+    ocKeyResponse = await prompt({
+      type: "password",
+      name: "ocKey",
+      message: "OpenRouter API key (press enter to keep existing)",
+      initial: existingEnv.OC_OPENROUTER_API_KEY ?? ""
+    });
+    ocModelResponse = await prompt({
+      type: "select",
+      name: "ocModel",
+      message: "OpenCode model (OpenRouter)",
+      choices: [{ title: "glm-4.7", value: "glm-4.7" }],
+      initial: existingEnv.OC_MODEL === "glm-4.7" ? 0 : 0
+    });
+  }
   const repoSourceResponse = await prompt({
     type: "select",
     name: "repoSource",
@@ -7691,6 +7721,12 @@ var runConfig = async () => {
     message: "GitHub repo URL",
     initial: existingEnv.GITHUB_REPO_URL ?? ""
   }) : { repoUrl: undefined };
+  const envProjectPathResponse = await prompt({
+    type: "text",
+    name: "envProjectPath",
+    message: "Project env file path to forward into the container",
+    initial: existingEnv.WILE_ENV_PROJECT_PATH ?? ".wile/.env.project"
+  });
   const branchResponse = await prompt({
     type: "text",
     name: "branchName",
@@ -7706,30 +7742,43 @@ var runConfig = async () => {
   const fallbackIterations = existingEnv.WILE_MAX_ITERATIONS ? Number(existingEnv.WILE_MAX_ITERATIONS) : 25;
   const maxIterations = Number.isFinite(iterationsResponse.maxIterations) && iterationsResponse.maxIterations > 0 ? iterationsResponse.maxIterations : fallbackIterations;
   const authFallback = authMethod === "oauth" ? existingEnv.CC_CLAUDE_CODE_OAUTH_TOKEN : existingEnv.CC_ANTHROPIC_API_KEY;
-  const authValue = coalesceValue(authValueResponse.authValue, authFallback);
+  const authValue = codingAgent === "CC" ? coalesceValue(authValueResponse.authValue, authFallback) : undefined;
+  const ocKey = codingAgent === "OC" ? coalesceValue(ocKeyResponse.ocKey, existingEnv.OC_OPENROUTER_API_KEY) : undefined;
+  const ocModel = codingAgent === "OC" ? coalesceValue(ocModelResponse.ocModel, existingEnv.OC_MODEL ?? "glm-4.7") : undefined;
   const githubToken = repoSource === "github" ? coalesceValue(githubTokenResponse.githubToken, existingEnv.GITHUB_TOKEN) : existingEnv.GITHUB_TOKEN;
   const repoUrl = repoSource === "github" ? coalesceValue(repoResponse.repoUrl, existingEnv.GITHUB_REPO_URL) : existingEnv.GITHUB_REPO_URL;
+  const envProjectPathValue = coalesceValue(envProjectPathResponse.envProjectPath, existingEnv.WILE_ENV_PROJECT_PATH ?? ".wile/.env.project") ?? ".wile/.env.project";
   const branchName = coalesceValue(branchResponse.branchName, existingEnv.BRANCH_NAME ?? "main");
   const envLines = [
-    "CODING_AGENT=CC",
+    `CODING_AGENT=${codingAgent}`,
     `WILE_REPO_SOURCE=${repoSource}`,
+    `WILE_ENV_PROJECT_PATH=${envProjectPathValue}`,
     `GITHUB_TOKEN=${githubToken ?? ""}`,
     `GITHUB_REPO_URL=${repoUrl ?? ""}`,
     `BRANCH_NAME=${branchName ?? "main"}`,
-    `CC_CLAUDE_MODEL=${defaultModelResponse.model}`,
     `WILE_MAX_ITERATIONS=${maxIterations}`
   ];
-  if (authMethod === "oauth") {
-    envLines.push(`CC_CLAUDE_CODE_OAUTH_TOKEN=${authValue ?? ""}`);
+  if (codingAgent === "CC") {
+    envLines.push(`CC_CLAUDE_MODEL=${defaultModelResponse.model}`);
+    if (authMethod === "oauth") {
+      envLines.push(`CC_CLAUDE_CODE_OAUTH_TOKEN=${authValue ?? ""}`);
+    } else {
+      envLines.push(`CC_ANTHROPIC_API_KEY=${authValue ?? ""}`);
+    }
   } else {
-    envLines.push(`CC_ANTHROPIC_API_KEY=${authValue ?? ""}`);
+    envLines.push(`OC_MODEL=${ocModel ?? "glm-4.7"}`);
+    envLines.push(`OC_OPENROUTER_API_KEY=${ocKey ?? ""}`);
   }
   await writeFile(envPath, envLines.join(`
 `) + `
 `);
   await ensureGitignore(gitignorePath);
-  await writeIfMissing(envProjectPath, `# Add env vars here to forward into the container
+  const envProjectTarget = envProjectPathValue === ".wile/.env.project" ? envProjectPath : envProjectPathValue;
+  const envProjectResolved = envProjectTarget.startsWith("/") ? envProjectTarget : join(cwd, envProjectTarget);
+  if (envProjectResolved.startsWith(wileDir)) {
+    await writeIfMissing(envProjectResolved, `# Add env vars here to forward into the container
 `);
+  }
   if (!existsSync(prdPath)) {
     const prdContents = JSON.stringify({ userStories: [] }, null, 2);
     await writeFile(prdPath, prdContents + `
@@ -7738,11 +7787,18 @@ var runConfig = async () => {
   await writeIfMissing(prdExamplePath, JSON.stringify(prdExample, null, 2) + `
 `);
   const hadAdditionalInstructions = existsSync(additionalInstructionsPath);
+  const hadPreflight = existsSync(preflightPath);
   await writeIfMissing(additionalInstructionsPath, `<!--
 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.
 -->
+`);
+  await writeIfMissing(preflightPath, `<!--
+Use bullet points for preflight checks, e.g.
+- Confirm SUPABASE_DB_URL is set.
+- Run \`supabase db reset --db-url "$SUPABASE_DB_URL"\`.
+-->
 `);
   await writeIfMissing(agentsPath, [
     "# PRD authoring guidance for Wile",
@@ -7767,7 +7823,7 @@ Use bullet points for additional instructions, e.g.
     "",
     "Environment notes:",
     "- Playwright (Chromium) is available in the agent container for UI checks.",
-    "- Project env vars can be passed via `.wile/secrets/.env.project`.",
+    "- Project env vars can be passed via `.wile/.env.project` (or override with WILE_ENV_PROJECT_PATH).",
     "- Optional extra guidance can be added in `.wile/additional-instructions.md`.",
     "- The container has outbound internet access by default.",
     ""
@@ -7775,22 +7831,25 @@ Use bullet points for additional instructions, e.g.
 `));
   console.log(`
 Wile config complete.`);
-  console.log("Add project env vars to .wile/secrets/.env.project when needed.");
+  console.log("Add project env vars to .wile/.env.project when needed.");
   if (!hadAdditionalInstructions) {
     console.log("Created .wile/additional-instructions.md for extra agent guidance (optional).");
   }
+  if (!hadPreflight) {
+    console.log("Created .wile/preflight.md for preflight checks (optional).");
+  }
 };
 
 // src/commands/run.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2, mkdirSync, createWriteStream, writeFileSync } from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
-import { resolve, join as join3, dirname } from "node:path";
+import { resolve as resolve2, join as join3, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/lib/config.ts
 var import_dotenv2 = __toESM(require_main(), 1);
 import { existsSync as existsSync2, readFileSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { join as join2, resolve, isAbsolute } from "node:path";
 var getWilePaths = (cwd = process.cwd()) => {
   const wileDir = join2(cwd, ".wile");
   const secretsDir = join2(wileDir, "secrets");
@@ -7798,11 +7857,25 @@ var getWilePaths = (cwd = process.cwd()) => {
     wileDir,
     secretsDir,
     envPath: join2(secretsDir, ".env"),
-    envProjectPath: join2(secretsDir, ".env.project"),
+    envProjectPath: join2(wileDir, ".env.project"),
     gitignorePath: join2(wileDir, ".gitignore"),
     prdPath: join2(wileDir, "prd.json")
   };
 };
+var resolveEnvProjectPath = (cwd, configured) => {
+  const defaultPath = join2(cwd, ".wile", ".env.project");
+  const legacyPath = join2(cwd, ".wile", "secrets", ".env.project");
+  if (configured && configured.trim().length > 0) {
+    return isAbsolute(configured) ? configured : resolve(cwd, configured);
+  }
+  if (existsSync2(defaultPath)) {
+    return defaultPath;
+  }
+  if (existsSync2(legacyPath)) {
+    return legacyPath;
+  }
+  return defaultPath;
+};
 var parseEnvFile = (path) => {
   if (!existsSync2(path)) {
     return {};
@@ -7822,19 +7895,29 @@ var readWileConfig = (options = {}) => {
     ensureRequired(existsSync2(paths.envPath), "Missing .wile/secrets/.env. Run 'bunx wile config' first.");
   }
   const env = parseEnvFile(paths.envPath);
-  const envProject = parseEnvFile(paths.envProjectPath);
+  const envProjectPath = resolveEnvProjectPath(options.cwd ?? process.cwd(), env.WILE_ENV_PROJECT_PATH);
+  const envProject = parseEnvFile(envProjectPath);
   const repoSource = env.WILE_REPO_SOURCE || "github";
   if (validate) {
-    ensureRequired(env.CODING_AGENT === "CC", "CODING_AGENT must be set to CC in .wile/secrets/.env. Run 'bunx wile config'.");
+    ensureRequired(env.CODING_AGENT === "CC" || env.CODING_AGENT === "OC", "CODING_AGENT must be set to CC or OC in .wile/secrets/.env. Run 'bunx wile config'.");
     if (repoSource === "github") {
       ensureRequired(Boolean(env.GITHUB_TOKEN), "GITHUB_TOKEN is required in .wile/secrets/.env. Run 'bunx wile config'.");
       ensureRequired(Boolean(env.GITHUB_REPO_URL), "GITHUB_REPO_URL is required in .wile/secrets/.env. Run 'bunx wile config'.");
       ensureRequired(Boolean(env.BRANCH_NAME), "BRANCH_NAME is required in .wile/secrets/.env. Run 'bunx wile config'.");
     }
-    ensureRequired(Boolean(env.CC_CLAUDE_CODE_OAUTH_TOKEN || env.CC_ANTHROPIC_API_KEY), "Either CC_CLAUDE_CODE_OAUTH_TOKEN or CC_ANTHROPIC_API_KEY is required in .wile/secrets/.env.");
+    if (env.CODING_AGENT === "CC") {
+      ensureRequired(Boolean(env.CC_CLAUDE_CODE_OAUTH_TOKEN || env.CC_ANTHROPIC_API_KEY), "Either CC_CLAUDE_CODE_OAUTH_TOKEN or CC_ANTHROPIC_API_KEY is required in .wile/secrets/.env.");
+    }
+    if (env.CODING_AGENT === "OC") {
+      ensureRequired(Boolean(env.OC_OPENROUTER_API_KEY), "OC_OPENROUTER_API_KEY is required in .wile/secrets/.env for OpenCode.");
+      ensureRequired(Boolean(env.OC_MODEL), "OC_MODEL is required in .wile/secrets/.env for OpenCode.");
+    }
   }
   return {
-    paths,
+    paths: {
+      ...paths,
+      envProjectPath
+    },
     config: {
       codingAgent: env.CODING_AGENT ?? "CC",
       githubToken: env.GITHUB_TOKEN ?? "",
@@ -7845,6 +7928,8 @@ var readWileConfig = (options = {}) => {
       maxIterations: env.WILE_MAX_ITERATIONS,
       ccClaudeCodeOauthToken: env.CC_CLAUDE_CODE_OAUTH_TOKEN,
       ccAnthropicApiKey: env.CC_ANTHROPIC_API_KEY,
+      ocOpenrouterApiKey: env.OC_OPENROUTER_API_KEY,
+      ocModel: env.OC_MODEL,
       envProject
     }
   };
@@ -7924,7 +8009,7 @@ var resolveAgentDir = () => {
   if (existsSync3(bundledAgentDir)) {
     return bundledAgentDir;
   }
-  const cliRoot = resolve(here, "..", "..", "..");
+  const cliRoot = resolve2(here, "..", "..", "..");
   const agentDir = join3(cliRoot, "agent");
   if (!existsSync3(agentDir)) {
     throw new Error("Unable to locate packages/agent. Run from the monorepo.");
@@ -8009,6 +8094,7 @@ var runWile = async (options) => {
     console.log(`- cwd: ${cwd}`);
     console.log(`- INIT_CWD: ${initCwd}`);
     console.log(`- WILE_AGENT_DIR: ${process.env.WILE_AGENT_DIR ?? "(unset)"}`);
+    console.log(`- codingAgent: ${config.codingAgent}`);
     console.log(`- repoSource: ${config.repoSource}`);
     console.log(`- githubRepoUrl: ${config.githubRepoUrl || "(empty)"}`);
     console.log(`- branchName: ${config.branchName || "(empty)"}`);
@@ -8054,7 +8140,7 @@ var runWile = async (options) => {
 };
 
 // src/cli.ts
-var packageJsonPath = resolve2(new URL("../package.json", import.meta.url).pathname);
+var packageJsonPath = resolve3(new URL("../package.json", import.meta.url).pathname);
 var packageJson = JSON.parse(readFileSync3(packageJsonPath, "utf8"));
 var program2 = new Command;
 program2.name("wile").description("Autonomous AI coding agent that ships features while you sleep").version(packageJson.version);

package/package.json

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