refactor: complete action testing system overhaul

- Removed /scratch directory, now cloning pullfrogai/scratch as needed
- Implemented new play.ts testing system with local and Docker/act modes
- Added environment variable propagation to cloned test repositories
- Created minimal .act-dist approach to avoid pnpm symlink issues with Docker
- Migrated from dist/index.js to entry.cjs bundled output
- Added TypeScript fixture support with MainParams type safety
- Organized all test fixtures in fixtures/ directory
- Updated publish workflow to trigger on package.json changes
- Removed unnecessary INPUT_ANTHROPIC_API_KEY references
- Added comprehensive documentation for new testing system
- Fixed pre-commit hook to use entry.cjs instead of dist/

README.md

@@ -1,4 +1,70 @@
-# Pullfrog
+# Pullfrog Action
 
-A simple GitHub Action that prints a customizable message to the console.
+GitHub Action for running Claude Code and other agents via Pullfrog.
 
+## Quick Start
+
+```bash
+# Install dependencies
+pnpm install
+
+# Test with default prompt
+npm run play              # Run locally on your machine
+npm run play -- --act     # Run in Docker (simulates GitHub Actions)
+```
+
+## Testing with play.ts
+
+The `play.ts` script provides two ways to test the action:
+
+### Local Mode (Default)
+```bash
+npm run play                        # Uses fixtures/play.txt
+npm run play fixtures/complex.txt   # Custom prompt file
+```
+- Clones the scratch repository to `.temp`
+- Runs Claude Code directly on your machine
+- Fast iteration for development
+
+### Docker Mode (--act flag)
+```bash
+npm run play -- --act                        # Uses fixtures/play.txt
+npm run play fixtures/simple.txt -- --act    # Custom prompt file
+```
+- Builds fresh bundles with esbuild
+- Creates minimal distribution without node_modules
+- Runs in Docker container via `act`
+- Simulates GitHub Actions environment
+
+### Prompt Files
+
+Supports `.txt`, `.json`, and `.ts` files:
+```bash
+npm run play prompt.txt           # Plain text prompt
+npm run play config.json          # JSON configuration
+npm run play dynamic.ts           # TypeScript with default export
+```
+
+## Building
+
+```bash
+pnpm build        # Production build (bundles & removes node_modules)
+pnpm build:dev    # Development build (keeps node_modules)
+pnpm dev          # Watch mode
+```
+
+The action is bundled into `entry.cjs` with all dependencies included, eliminating runtime dependency on node_modules.
+
+## Architecture
+
+- **entry.cjs**: Bundled action entry point (self-contained)
+- **agents/**: Agent implementations (Claude, etc.)
+- **utils/**: Utilities for subprocess, act, and formatting
+- **fixtures/**: Test prompt files
+
+## Why No node_modules?
+
+pnpm uses symlinks that cause "invalid symlink" errors when `act` copies the action to Docker. Our solution:
+1. Bundle everything into `entry.cjs` 
+2. Remove node_modules after building
+3. Create minimal `.act-dist` for Docker testing