!WIP! !MVP! 🚀 PR: Convert PAI to Claude Code Plugin Architecture (MVP/RFC) !MVP! !WIP!

.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+"name": "PAI-marketplace",
+"description": "Marketplace for everything PAI",
+"owner": {
+"name": "evenromo"
+},
+"plugins": [
+{
+  "name": "pai-boilerplate",
+  "source": "./pai-plugin",
+  "description": "The boilerplate for PAI - The Open-source personal AI infrastructure for orchestrating your life and work"
+}
+]
+}

.gitignore

@@ -61,3 +61,30 @@ out/
 private/
 secrets/
 credentials/
+
+# User Configuration (use templates)
+settings.json
+.mcp.json
+*.local.json
+
+# Personal Data
+**/REDACTED*
+**/*secret*
+**/*private*
+**/*backup*
+
+# Voice Server
+voice-server/node_modules/
+voice-server/*.log
+voice-server/.env
+
+# Test Artifacts
+test-output/
+.claude-test/
+*.test.backup
+
+# Dependencies
+.bun/
+
+# Build outputs
+*.tsbuildinfo

CHANGELOG.md

@@ -0,0 +1,107 @@
+# Changelog
+
+All notable changes to PAI-Boilerplate will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Fixed
+- **Plugin Configuration**: Corrected hooks.json schema format with proper "hooks" wrapper object (cfec221)
+- **Path Migration**: Completed migration from `${PAI_DIR}` to `${CLAUDE_PLUGIN_ROOT}` in all hooks and scripts (9b71a38)
+  - Updated load-core-context.ts to use CLAUDE_PLUGIN_ROOT for PAI skill path
+  - Updated initialize-pai-session.ts to use CLAUDE_PLUGIN_ROOT for stop-hook path
+  - Updated load-dynamic-requirements.ts to use CLAUDE_PLUGIN_ROOT for command path
+  - Updated update-tab-titles.ts to use CLAUDE_PLUGIN_ROOT for hook script path
+- **Statusline Configuration**: Reverted statusline-command.sh to use `~/.claude/` directory as it displays user's global Claude Code setup, not plugin resources (fde9cb7)
+- **Hook Cleanup**: Added `process.exit(0)` to Stop and SubagentStop hooks to prevent hanging on open handles
+
+### Changed
+- **Documentation**: Updated INSTALL.md to remove deprecated PAI_DIR reference
+- **Documentation**: Updated CONTRIBUTING.md with correct hooks.json schema format and process.exit(0) guidance
+
+---
+
+## [0.7.0] - 2025-01-23 - Plugin Wrapper Release 🎉
+
+### Major Changes
+This release transforms PAI-Boilerplate into a proper Claude Code plugin with clean separation between plugin code and user configuration.
+
+### Added
+- **Plugin Structure**: Proper Claude Code plugin manifest with hooks registration
+- **Installation Automation**: `install.sh` and uninstall.sh scripts for guided setup
+- **Template System**: `settings.example.json` and `.mcp.example.json` templates
+- **Voice Configuration**: Optional voice notifications with `ENABLE_VOICE` flag
+- **Context Templates**: Template context files in `templates/context/`
+- **Comprehensive Documentation**:
+  - `INSTALL.md` - Detailed installation guide
+  - `QUICKSTART.md` - 5-minute getting started
+  - `CONTRIBUTING.md` - Developer guide
+  - `TESTING.md` - Test procedures
+- **Validation Scripts**: Installation verification tools
+- **Migration Script**: Automated variable migration
+
+### Changed
+- **BREAKING**: Migrated from `${PAI_DIR}` to `${CLAUDE_PLUGIN_ROOT}` (Claude Code standard)
+- **Configuration**: Moved user config out of plugin directory
+- **Hooks**: Registered via `hooks/hooks.json` instead of `settings.json`
+- **Voice System**: Made fully optional with graceful degradation
+- **Agent References**: Updated context paths to use plugin templates
+- **Documentation**: Updated all docs for plugin structure
+
+### Removed
+- `settings.json` from plugin (replaced with `settings.example.json`)
+- `.mcp.json` from plugin (replaced with `.mcp.example.json`)
+- Hardcoded personal configuration from plugin files
+
+### Fixed
+- Plugin now follows Claude Code standards
+- Proper path resolution for all components
+- Voice server failure no longer blocks execution
+- Installation no longer requires manual configuration
+
+### Migration Guide
+Users upgrading from 0.6.0:
+1. Backup `~/.claude/` directory
+2. Run `git pull` to get latest plugin code
+3. Update `~/.claude/settings.json` hooks to reference plugin location
+4. Replace `${PAI_DIR}` with `${CLAUDE_PLUGIN_ROOT}` in personal configs
+5. Add `ENABLE_VOICE` flag to control voice notifications
+
+---
+
+## [0.6.0] - 2025-10-XX - Repository Restructure
+
+### Changed
+- **BREAKING**: Moved all PAI infrastructure to `.claude/` directory
+- Repository now mirrors actual `~/.claude/` working system
+- Better separation between GitHub files and PAI infrastructure
+
+---
+
+## [0.5.0] - 2025-10-XX - Skills-Based Architecture
+
+### Changed
+- **BREAKING**: Migrated to pure Skills architecture
+- **Performance**: 92.5% token reduction (4000 → 300 tokens)
+- Zero hook overhead for context loading
+- On-demand context via skill invocation
+
+---
+
+## Version Comparison
+
+| Version | Architecture | Token Cost | Config Location | Voice | Distribution |
+|---------|-------------|------------|-----------------|-------|--------------|
+| 0.7.0 | Plugin wrapper | ~300 | User directory | Optional | ✅ Ready |
+| 0.6.0 | `.claude/` structure | ~300 | Mixed | Required | ❌ Personal |
+| 0.5.0 | Skills-based | ~300 | Repository | Required | ❌ Personal |
+
+---
+
+[0.7.0]: https://github.com/evenromo/PAI-Boilerplate/releases/tag/v0.7.0
+[0.6.0]: https://github.com/evenromo/PAI-Boilerplate/releases/tag/v0.6.0
+[0.5.0]: https://github.com/evenromo/PAI-Boilerplate/releases/tag/v0.5.0

README.md

@@ -28,15 +28,26 @@
 ## 🚀 **Recent Updates**
 
 > [!IMPORTANT]
-> **🔥 v0.6.0 MAJOR UPGRADE:** Repository completely restructured with `.claude/` directory!
+> **🎉 v0.7.0 PLUGIN WRAPPER RELEASE:** PAI-Boilerplate is now a proper Claude Code plugin!
 >
-> **BREAKING CHANGE - Repository Structure Changed:**
-> - All PAI infrastructure now lives in `.claude/` directory
-> - Repository now properly mirrors your actual `~/.claude/` working system
-> - Fixes major compatibility issues reported by users
-> - **Action Required:** New installations should copy `.claude/` to `~/.claude/`
+> **NEW - 5-Minute Installation:**
+> - ✅ Automated setup with `./install.sh`
+> - ✅ Template-based configuration (no personal data in repo)
+> - ✅ Voice notifications now optional and configurable
+> - ✅ Standards-compliant with `${CLAUDE_PLUGIN_ROOT}`
+> - ✅ Comprehensive documentation (INSTALL.md, QUICKSTART.md, CONTRIBUTING.md)
+>
+> **Quick Install:**
+> ```bash
+> cd pai-plugin && ./install.sh
+> ```
 >
-> [See full changelog below →](#-recent-updates)
+> [See full changelog →](./CHANGELOG.md)
+
+> [!NOTE]
+> **Previous v0.6.0:** Repository restructured with `.claude/` directory
+> - All PAI infrastructure now lives in `.claude/` directory
+> - Repository mirrors actual `~/.claude/` working system
 
 <details>
 <summary><strong>📅 Click to see all updates</strong></summary>

ai_docs/README.md

@@ -0,0 +1,17 @@
+# AI Docs
+
+> Resources to fetch and load into ai_docs/\*.md at runtime
+
+- https://docs.claude.com/en/docs/claude-code/headless
+- https://docs.claude.com/en/docs/claude-code/mcp
+- https://docs.claude.com/en/docs/claude-code/slash-commands
+- https://docs.claude.com/en/docs/claude-code/sub-agents
+- https://docs.claude.com/en/docs/claude-code/sub-agents.md
+- https://docs.claude.com/en/api/agent-sdk/typescript
+- https://docs.claude.com/en/docs/about-claude/models/overview
+- https://docs.claude.com/en/docs/claude-code/hooks
+- https://docs.claude.com/en/docs/claude-code/memory
+- https://docs.claude.com/en/docs/claude-code/skills
+- https://docs.claude.com/en/docs/claude-code/plugins
+- https://docs.claude.com/en/docs/claude-code/plugins-reference
+- https://docs.claude.com/en/docs/claude-code/cli-reference