# Teddy

Modular, provider-agnostic AI assistant for WordPress 8+ built on the native **WordPress AI Client** and **Abilities API**.

## Features

User-facing catalog: **[`docs/06-features.md`](docs/06-features.md)** · Quick how-to: **[`docs/07-user-guide.md`](docs/07-user-guide.md)**

**On by default:** Teddy Copilot, visitor chat (widget / shortcode / block), SEO assistant, Teddy Writer, WooCommerce tools, streaming, English + Vietnamese.

**Shipped, off by default:** Knowledge / RAG, Agent Pipeline (Observability + Security UI), Workflows, Extension SDK, **Facebook Messenger** (Channels).

**OpenClaw:** MCP bridge in `mcp-server/` + buyer wizard in `openclaw/` (`teddy-openclaw setup`). Docs: [`docs/modules/mcp-bridge/openclaw-onboarding.md`](docs/modules/mcp-bridge/openclaw-onboarding.md).

**Not in GA:** Enterprise items (multisite fleet, external vector DB, SSO/SIEM) — see features doc §8. Instagram / Zalo / Page publish — see `docs/modules/channels/PHASE-2.md`.

## Requirements

- WordPress **6.9+** with AI Client package
- PHP **8.2+**
- MySQL/MariaDB
- Node.js 18+ (build only)
- Composer (PHP dependencies)

## Development

```bash
cd wp-content/plugins/teddy
composer install
npm install
npm run build          # webpack + CSS + i18n
composer test:unit
composer test:integration
composer phpstan
composer test:coverage # Domain coverage gate (pcov optional)
```

### E2E (requires Laragon/site PHP with mysqli, PHP 8.2+)

```bash
C:\Users\vinhnx\laragon\bin\php\php-8.5.7-Win32-vs17-x64\php.exe tests/e2e-all.php
```

Playwright admin smoke (needs password):

```bash
set TEDDY_E2E_USER=vinhnx
set TEDDY_E2E_PASS=your-password
npm run test:e2e:playwright
```

## Release

One command (build JS/CSS/i18n + production Composer + ZIP):

```bash
npm run release:full   # → release/teddy.zip
```

Manual steps (same result):

```bash
npm run build
composer install --no-dev --optimize-autoloader
npm run release
```

## Documentation

| Doc | Purpose |
|-----|---------|
| [`docs/README.md`](docs/README.md) | Index |
| [`docs/06-features.md`](docs/06-features.md) | Feature catalog |
| [`docs/07-user-guide.md`](docs/07-user-guide.md) | End-user guide |
| [`docs/08-enterprise-roadmap.md`](docs/08-enterprise-roadmap.md) | Enterprise development (E0–E4) |
| [`docs/01`](docs/01-vision-prompt.md)–[`05`](docs/05-ai-coding-rules.md) | Vision / architecture / roadmap |
| [`docs/EXTENSION_GUIDE.md`](docs/EXTENSION_GUIDE.md) | Extension SDK |
| [`docs/modules/`](docs/modules/) | Per-module notes |

## License

GPL-2.0-or-later