wordpress-agent-kit 0.2.1 → 0.2.2

package/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+          run_install: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check formatting
+        run: pnpm run format:check
+
+      - name: Run lint
+        run: pnpm run lint:check
+
+      - name: Type check
+        run: pnpm run check
+
+      - name: Run tests
+        run: pnpm run test:run
+
+      - name: Build
+        run: pnpm run build

package/.husky/pre-commit

@@ -0,0 +1,7 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+pnpm exec biome check --write .
+git add -A
+pnpm run lint:check
+pnpm run test:run

package/CLI_REVIEW.md

@@ -0,0 +1,250 @@
+# WordPress Agent Kit CLI - Accessibility & Agent-Friendly Review
+
+**Date**: 2026-06-08  
+**Version**: 0.2.1
+
+---
+
+## Executive Summary
+
+The current CLI is functional for **human developers** using interactive prompts (`@clack/prompts`), but lacks features for **programmatic/agent usage**:
+
+- ❌ No JSON output mode
+- ❌ No machine-readable result objects
+- ❌ No programmatic API (only CLI entrypoint)
+- ❌ No non-interactive "headless" mode for all commands
+- ❌ No structured logging/event streaming
+- ❌ Exit codes not consistently semantic
+
+---
+
+## Current Architecture
+
+```
+src/
+├── cli.ts                    # Entry point, Commander setup
+├── commands/
+│   ├── install.ts           # Non-interactive (args + flags only) ✓
+│   ├── setup.ts             # Interactive (prompts only) ✗
+│   ├── sync-skills.ts       # Non-interactive (args + flags only) ✓
+│   └── run-playground.ts    # Non-interactive ✓
+├── lib/
+│   ├── installer.ts         # Core logic (pure functions) ✓
+│   └── triage-mapper.ts     # Pure mappers ✓
+└── utils/
+    ├── paths.ts             # Path resolution
+    └── run.ts              # Command runner
+```
+
+**Good**: Core logic (`installKit`, mappers) is pure and testable.  
+**Gap**: `setup.ts` couples interactive prompts with business logic.
+
+---
+
+## Recommendations
+
+### 1. Add JSON Output Mode (--json)
+
+**Goal**: Every command outputs structured JSON to stdout when requested.
+
+```bash
+# Success
+wp-agent-kit install /path/to/project --platform github --json
+# {"success":true,"targetDir":"/path/to/project","platform":"github","filesCopied":["AGENTS.md",".github/..."],"durationMs":142}
+
+# Failure
+wp-agent-kit install /nonexistent --json
+# {"success":false,"error":"E_NOT_FOUND","message":"Target directory does not exist","code":"ENOENT"}
+```
+
+**Implementation**:
+- Add `--json` / `--output json` global flag in `cli.ts`
+- Create `OutputFormatter` utility: `json`, `human`, `quiet`
+- Return structured result objects from all command actions
+- Separate stdout (JSON) from stderr (human diagnostics)
+
+### 2. Add Machine-Readable Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments / usage |
+| 3 | Target not found / ENOENT |
+| 4 | Permission denied / EACCES |
+| 5 | Already exists (without --force) |
+| 6 | Git/submodule error |
+| 7 | Network/fetch error |
+| 8 | Validation failed |
+| 130 | Cancelled (SIGINT) |
+
+### 3. Extract Programmatic API
+
+Expose core functions for direct import by agents/scripts:
+
+```typescript
+// src/api.ts (new)
+export interface InstallOptions {
+  targetDir: string;
+  platform: Platform;
+  force?: boolean;
+  dryRun?: boolean;
+}
+
+export interface InstallResult {
+  success: boolean;
+  targetDir: string;
+  platform: Platform;
+  filesCreated: string[];
+  filesSkipped: string[];
+  errors: string[];
+  durationMs: number;
+}
+
+export async function installKit(options: InstallOptions): Promise<InstallResult>;
+export async function syncSkills(options: SyncOptions): Promise<SyncResult>;
+export async function runTriage(targetDir: string): Promise<TriageResult>;
+export async function configureAgentsMd(options: ConfigureOptions): Promise<ConfigureResult>;
+```
+
+**Benefits**:
+- Agents can import and call directly: `import { installKit } from 'wordpress-agent-kit'`
+- No subprocess overhead
+- Full TypeScript types
+- Testable in isolation
+
+### 4. Make `setup` Command Headless-Capable
+
+Current `setup.ts` is prompt-driven. Add non-interactive mode:
+
+```bash
+# Full non-interactive (requires all flags)
+wp-agent-kit setup /path/to/project \
+  --project-type plugin \
+  --tech-stack gutenberg,rest-api,composer \
+  --platform github \
+  --yes \
+  --json
+
+# Hybrid: run triage, apply detected values, no prompts
+wp-agent-kit setup /path/to/project --auto --json
+```
+
+**Flag Matrix for `setup`**:
+| Flag | Description |
+|------|-------------|
+| `--project-type <type>` | plugin \| theme \| block-theme \| site \| blocks \| other |
+| `--tech-stack <list>` | Comma-separated: gutenberg,interactivity,rest-api,wpcli,composer,phpstan,npm,playground |
+| `--platform <platform>` | github \| cursor \| claude \| agent \| pi |
+| `--package-manager <pm>` | npm \| pnpm \| yarn |
+| `--auto` | Run triage, apply detected values, skip prompts |
+| `--yes` / `-y` | Accept all confirmations (requires other flags) |
+| `--reset` | Overwrite existing |
+| `--dry-run` | Show what would be done |
+
+### 5. Add Structured Logging / Event Stream
+
+For long-running operations (sync-skills, playground), emit NDJSON events:
+
+```bash
+wp-agent-kit sync-skills --json-stream
+# {"event":"start","phase":"clone","timestamp":"..."}
+# {"event":"progress","phase":"fetch","message":"Fetching tags...","timestamp":"..."}
+# {"event":"complete","phase":"install","result":{"skillsSynced":42,"timestamp":"..."}}
+```
+
+**Events**: `start`, `progress`, `phase-change`, `warning`, `complete`, `error`
+
+### 6. Add Dry-Run / Preview Mode
+
+```bash
+wp-agent-kit install /path --dry-run --json
+# {"wouldCopy":[{"src":"AGENTS.template.md","dest":"/path/AGENTS.md"},{"src":".github/...","dest":"/path/.github/..."}],"wouldCreateDirs":[]}
+
+wp-agent-kit setup /path --dry-run --auto --json
+# {"wouldInstall":true,"detectedType":"plugin","detectedTech":["gutenberg","npm"],"wouldModify":["AGENTS.md"]}
+```
+
+### 7. Add Shell Completion (Modern CLI Standard)
+
+```bash
+# Generate completion scripts
+wp-agent-kit completion bash > /etc/bash_completion.d/wp-agent-kit
+wp-agent-kit completion zsh > ~/.zsh/completions/_wp-agent-kit
+wp-agent-kit completion fish > ~/.config/fish/completions/wp-agent-kit.fish
+```
+
+Commander.js supports this natively: `program.enablePositionalOptions().addHelpCommand().configureOutput({ writeOut: ... })`
+
+### 8. Add `--version` JSON Output
+
+```bash
+wp-agent-kit --version --json
+# {"name":"wp-agent-kit","version":"0.2.1","node":"20.18.0","platform":"linux"}
+```
+
+---
+
+## Priority Matrix
+
+| Priority | Feature | Effort | Impact |
+|----------|---------|--------|--------|
+| **P0** | JSON output (`--json`) | Low | High |
+| **P0** | Semantic exit codes | Low | High |
+| **P0** | Programmatic API export | Medium | High |
+| **P1** | Headless `setup` mode | Medium | High |
+| **P1** | Dry-run/preview | Low | Medium |
+| **P2** | NDJSON event streaming | Medium | Medium |
+| **P2** | Shell completions | Low | Medium |
+| **P3** | Man page generation | Low | Low |
+
+---
+
+## Example: Agent-Friendly Workflow
+
+```bash
+# 1. Agent detects WordPress project
+wp-agent-kit setup /workspace/my-plugin --auto --json
+# {"success":true,"applied":{"projectType":"plugin","techStack":["gutenberg","npm"]},"filesModified":["AGENTS.md"]}
+
+# 2. Agent syncs latest skills
+wp-agent-kit sync-skills --json
+# {"success":true,"skillsSynced":47,"source":"WordPress/agent-skills@trunk"}
+
+# 3. Agent installs for specific platform (e.g., Cursor)
+wp-agent-kit install /workspace/my-plugin --platform cursor --json
+# {"success":true,"platform":"cursor","targetDir":"/workspace/my-plugin","filesCreated":[".cursor/...","AGENTS.md"]}
+```
+
+---
+
+## Implementation Notes
+
+### Minimal Changes for P0
+
+1. **cli.ts**: Add global `--json` flag, result formatter
+2. **commands/*.ts**: Return structured results instead of `process.exit()`
+3. **lib/installer.ts**: Return `InstallResult` object (already close)
+4. **package.json**: Add `"exports": { ".": "./dist/cli.js", "./api": "./dist/api.js" }`
+
+### Testing Strategy
+
+```typescript
+// tests/api/install.api.test.ts
+import { installKit } from '../../src/api.js';
+
+it('returns structured result on success', async () => {
+  const result = await installKit({ targetDir: '/tmp/test', platform: 'github' });
+  expect(result.success).toBe(true);
+  expect(result.filesCreated).toContain('AGENTS.md');
+});
+```
+
+---
+
+## References
+
+- [Commander.js JSON output patterns](https://github.com/tj/commander.js/blob/master/Examples/options-json.ts)
+- [CLI Guidelines - Output](https://clig.dev/#output)
+- [12-factor CLI apps](https://medium.com/@jdxcode/12-factor-cli-apps-dd3c227a0e46)
+- [GitHub CLI `gh` JSON patterns](https://cli.github.com/manual/gh_help_formatting)

package/README.md

@@ -3,9 +3,10 @@
 [![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg?style=flat-square)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/Written%20in-TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
-[![Version](https://img.shields.io/badge/version-0.2.0-blue?style=flat-square)](package.json)
+[![Version](https://img.shields.io/badge/version-0.2.2-blue?style=flat-square)](package.json)
+[![Node](https://img.shields.io/badge/node-%3E%3D20.18-green?style=flat-square)](package.json)
 
-**WordPress-focused AI agent starter kit** for GitHub Copilot, Claude, and other LLM coding agents. Includes instructions, specialized WordPress skills, and workflow automation aligned with industry standards.
+**WordPress-focused AI agent starter kit** for GitHub Copilot, Cursor, Claude, and other LLM coding agents. Includes instructions, specialized WordPress skills, and workflow automation aligned with industry standards.
 
 Maintained by [Kyle Brodeur](https://brodeur.me).
 
@@ -13,106 +14,178 @@ Maintained by [Kyle Brodeur](https://brodeur.me).
 
 ### Option 1: CLI (Recommended)
 
-Run the interactive setup wizard:
-
+#### Interactive Setup Wizard
 ```bash
 npx wp-agent-kit setup
 # or
 pnpm dlx wp-agent-kit setup
 ```
 
-This will:
-- Detect your WordPress project type
-- Install `AGENTS.md` and skills into your project
-- Configure for your tech stack
+#### Non-Interactive (CI/Agent-Friendly)
+```bash
+# Auto-detect project type and tech stack
+pnpm dlx wp-agent-kit setup --auto --json
 
-### Option 2: Pre-built Bundles
+# Or specify explicitly (for full automation)
+pnpm dlx wp-agent-kit setup --project-type plugin --tech-stack gutenberg,rest-api,composer --platform github --yes --json
+```
 
-Download a bundle from the [latest release](https://github.com/kylebrodeur/wordpress-agent-kit/releases):
+#### Install Only (No Configuration)
+```bash
+# For GitHub Copilot / VS Code
+pnpm dlx wp-agent-kit@latest install --platform github
+
+# For Cursor IDE
+pnpm dlx wp-agent-kit@latest install --platform cursor
+
+# For Pi Coding Agent (recommended)
+pnpm dlx wp-agent-kit@latest install --platform pi
+
+# For generic .agent workflows
+pnpm dlx wp-agent-kit@latest install --platform agent
+```
 
-- **`wordpress-agent-kit-github.tar.gz`** - For GitHub Copilot
-- **`wordpress-agent-kit-claude.tar.gz`** - For Claude
-- **`wordpress-agent-kit-agent.tar.gz`** - For generic `.agent` workflows
-- **`wordpress-agent-kit-cursor.tar.gz`** - For Cursor IDE
+### Option 2: Pre-built Bundles
 
-Extract into your WordPress project root:
+Download from the [latest release](https://github.com/kylebrodeur/wordpress-agent-kit/releases):
+- `wordpress-agent-kit-github.tar.gz` — GitHub Copilot
+- `wordpress-agent-kit-cursor.tar.gz` — Cursor IDE
+- `wordpress-agent-kit-claude.tar.gz` — Claude
+- `wordpress-agent-kit-agent.tar.gz` — Generic `.agent`
 
 ```bash
 cd /path/to/your-wordpress-project
 tar -xzf wordpress-agent-kit-github.tar.gz
 ```
 
-This interactive setup helps you:
-- **Automatically detect** your project type and technologies.
-- Customize `AGENTS.md` for your tech stack.
-- Configure workflow instructions.
-- Set up prompt templates.
+## Agent-Friendly Features (v0.2.2+)
 
-Use the `--reset` flag if you need to re-run the setup on an existing project:
+### Structured JSON Output (`--json`)
+All commands output machine-readable JSON for programmatic use:
+```bash
+wp-agent-kit install --platform github --json
+# {"success":true,"data":{"targetDir":"/path","platform":"github","filesCreated":[...],"durationMs":35}}
+```
 
+### Headless/Non-Interactive Mode
 ```bash
-pnpm setup -- /path/to/your-wp-project --reset
+# Auto-detection
+wp-agent-kit setup --auto --json
+
+# Explicit config (CI/CD ready)
+wp-agent-kit setup --project-type plugin --tech-stack gutenberg,rest-api --platform github --yes --json
 ```
 
-The setup will analyze your project first and either:
-- Auto-configure if confident.
-- Pre-fill smart defaults if partially detected.
-- Ask questions if detection is unclear.
+### Dry-Run Preview (`--dry-run`)
+```bash
+wp-agent-kit install --platform github --dry-run --json
+wp-agent-kit setup --project-type plugin --dry-run --json
+```
+
+### Upgrade Existing Installations
+```bash
+# Check for updates
+wp-agent-kit upgrade --check-only --json
 
-## Who This Is For
+# Apply upgrade
+wp-agent-kit upgrade --force --json
+```
 
-- **WordPress plugin/theme developers** who want AI agents to understand WordPress conventions (hooks, sanitization, Settings API, block registration, etc.).
-- **Teams adopting GitHub Copilot or Claude** for WordPress codebases.
-- **Anyone building custom WordPress workflows** who needs agents to follow WordPress Coding Standards, security best practices, and core APIs.
+### Programmatic API
+```typescript
+import { installKitApi, syncSkillsApi, runTriageApi, configureAgentsMdApi } from 'wordpress-agent-kit/api';
 
-## What You Get
+await installKitApi({ targetDir: '/path', platform: 'github', force: true });
+await syncSkillsApi({ ref: 'trunk' });
+const triage = await runTriageApi({ targetDir: '/path' });
+await configureAgentsMdApi({ targetDir: '/path', platform: 'github', config: { projectType: 'plugin', techStack: ['gutenberg'] }});
+```
 
-- **Agent Skills**: WordPress-specific knowledge modules (blocks, Interactivity API, REST API, WP-CLI, performance, security, theme.json, Playground, PHPStan, etc.).
-- **Instructions & Workflows**: Pre-built guidance for common WordPress dev cycles.
-- **AGENTS.md**: Single-file agent onboarding that loads skills on demand.
-- **Sync Scripts**: Pull latest skills from official [WordPress/agent-skills](https://github.com/WordPress/agent-skills) repository.
+### Semantic Exit Codes
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Not found (ENOENT) |
+| 4 | Permission denied |
+| 5 | Already exists (use --force) |
+| 6 | Git error |
+| 7 | Network error |
+| 8 | Validation failed |
+| 130 | Cancelled (SIGINT) |
+
+## Platform Comparison
+
+| Platform | Target Dir | Interactive? | Best For |
+|----------|------------|--------------|----------|
+| `pi` | `.pi/agent/skills/` | ❌ | **Pi Coding Agent** |
+| `github` | `.github/skills/` | ❌ | GitHub Copilot, VS Code |
+| `cursor` | `.cursor/skills/` | ❌ | Cursor IDE |
+| `agent` | `.agent/skills/` | ❌ | Generic `.agent` workflows |
+| `claude` | `.claude/skills/` | ✅ | Claude Code (interactive) |
+
+## Commands Reference
+
+| Command | Description |
+|---------|-------------|
+| `install [dir] --platform <p> [--force] [--dry-run] [--json]` | Install kit to target directory |
+| `setup [dir] [--auto] [--project-type] [--tech-stack] [--yes] [--json]` | Interactive or headless setup |
+| `sync-skills [ref] [--dry-run] [--json]` | Sync skills from WordPress/agent-skills |
+| `playground [--port] [--no-auto-mount] [--json]` | Run local WordPress Playground |
+| `upgrade [dir] [--platform] [--force] [--check-only] [--json]` | Upgrade existing installation |
 
 ## Development
 
-This project uses a TypeScript-based CLI for all operations.
-
 ### Build CLI
-
 ```bash
 pnpm build
 ```
 
-### Build Release Bundles
-
+### Run Tests
 ```bash
-pnpm sync:skills  # Sync latest WordPress skills first
-pnpm build:bundles
+pnpm test:run
 ```
 
-This generates four platform-specific bundles in `dist/bundles/`:
-- `wordpress-agent-kit-github.tar.gz`
-- `wordpress-agent-kit-claude.tar.gz`
-- `wordpress-agent-kit-agent.tar.gz`
-- `wordpress-agent-kit-cursor.tar.gz`
+### Lint & Format
+```bash
+pnpm run lint:check    # Check only
+pnpm run lint          # Auto-fix
+pnpm run format:check  # Check formatting
+pnpm run format        # Auto-format
+```
 
-### Run Tests
+### Build Release Bundles
+```bash
+pnpm sync:skills
+pnpm build:bundles
+```
 
+### Pre-Publish (Runs All Checks)
 ```bash
-pnpm test
+pnpm run prepublishOnly
 ```
 
 ## Customization
 
-**Quick method:** Run the interactive setup.
+**Quick method:** Run the interactive or headless setup.
 
 **Manual method:** Edit files directly:
-
 1. Edit `AGENTS.md` to match your project's tech stack and conventions.
 2. Run WordPress project triage (via `wp-project-triage` skill) to generate tailored instructions.
 3. Update `.github/instructions/wordpress-workflow.instructions.md` with your workflow.
 4. Keep prompts in `.github/prompts/` accurate for your plugin/theme.
 
+## CI/CD Integration
+
+```yaml
+# GitHub Actions example
+- name: Install WordPress Agent Kit
+  run: pnpm dlx wordpress-agent-kit@latest install --platform github --json
+```
+
 ## Credits
 
 - **[AGENTS.md](https://agentskills.io)** - The agent configuration standard.
 - **[AgentSkills.io](https://agentskills.io)** - The open directory of agent skills.
+- **[WordPress/agent-skills](https://github.com/WordPress/agent-skills)** - Upstream skills repository.

package/biome.json

@@ -0,0 +1,39 @@
+{
+	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"include": ["src/**/*.ts", "tests/**/*.ts", "scripts/**/*.ts"],
+		"ignoreUnknown": true
+	},
+	"organizeImports": {
+		"enabled": true
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"suspicious": {
+				"noExplicitAny": "warn"
+			},
+			"correctness": {
+				"noUnusedVariables": "error"
+			}
+		}
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineWidth": 100
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "single",
+			"trailingCommas": "es5",
+			"semicolons": "always"
+		}
+	}
+}

package/dist/cli.js

@@ -1,19 +1,90 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
 import { Command } from 'commander';
-import { createRequire } from 'module';
 import { installCommand } from './commands/install.js';
+import { runPlaygroundCommand } from './commands/run-playground.js';
 import { setupCommand } from './commands/setup.js';
 import { syncSkillsCommand } from './commands/sync-skills.js';
-import { runPlaygroundCommand } from './commands/run-playground.js';
+import { upgradeCommand } from './commands/upgrade.js';
+import { ExitCode } from './utils/exit-codes.js';
+import { createFormatter } from './utils/output.js';
+import { OutputFormatter } from './utils/output.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 const program = new Command();
+// Global options for all commands
 program
     .name('wp-agent-kit')
     .description('Utilities for WordPress Agent Kit')
-    .version(version);
+    .version(version)
+    .option('--json', 'Output JSON result to stdout', false)
+    .option('--quiet', 'Suppress all output except errors', false)
+    .option('--ndjson', 'Output NDJSON progress events (for long operations)', false)
+    .option('--dry-run', 'Preview actions without executing', false)
+    .configureHelp({
+    sortSubcommands: true,
+});
+// Add commands
 program.addCommand(installCommand);
 program.addCommand(setupCommand);
 program.addCommand(syncSkillsCommand);
 program.addCommand(runPlaygroundCommand);
-program.parse(process.argv);
+program.addCommand(upgradeCommand);
+// Global error handler
+program.exitOverride((err) => {
+    if (err.code === 'commander.helpDisplayed' || err.code === 'commander.versionDisplayed') {
+        process.exit(ExitCode.OK);
+    }
+    if (err.code === 'commander.unknownOption' || err.code === 'commander.invalidArgument') {
+        const formatter = createFormatter({ json: true }, 'wp-agent-kit', version);
+        const result = formatter.fail({
+            code: 'INVALID_ARGS',
+            message: err.message,
+            exitCode: ExitCode.INVALID_ARGS,
+        });
+        process.exit(OutputFormatter.getExitCode(result));
+    }
+    throw err;
+});
+// Custom help with examples
+program.addHelpText('after', `
+Examples:
+  $ wp-agent-kit install --platform github
+  $ wp-agent-kit setup --auto --json
+  $ wp-agent-kit sync-skills --ref trunk --ndjson
+  $ wp-agent-kit install --platform pi --dry-run --json
+  $ wp-agent-kit upgrade --check-only --json
+
+Programmatic API:
+  import { installKit, syncSkills, runTriage } from 'wordpress-agent-kit/api';
+
+For more info: https://github.com/kylebrodeur/wordpress-agent-kit
+`);
+try {
+    program.parse(process.argv);
+}
+catch (error) {
+    // Handle errors from commands that use process.exit
+    const err = error;
+    if (err.exitCode !== undefined) {
+        process.exit(err.exitCode);
+    }
+    // Fallback for unexpected errors
+    const formatter = createFormatter({ json: true }, 'wp-agent-kit', version);
+    const result = formatter.fail({
+        code: 'UNEXPECTED_ERROR',
+        message: error instanceof Error ? error.message : 'Unknown error',
+        exitCode: ExitCode.ERROR,
+    });
+    process.exit(OutputFormatter.getExitCode(result));
+}
+// Handle unhandled rejections
+process.on('unhandledRejection', (reason) => {
+    const formatter = createFormatter({ json: true }, 'wp-agent-kit', version);
+    const result = formatter.fail({
+        code: 'UNHANDLED_REJECTION',
+        message: reason instanceof Error ? reason.message : String(reason),
+        exitCode: ExitCode.ERROR,
+    });
+    process.exit(OutputFormatter.getExitCode(result));
+});