add: public-ready features including auto-initialization, MIT license, and updated documentation with PAI credits

Author: fpr1m3

.gitignore

@@ -8,3 +8,4 @@ dist
 .opencode/scratchpad
 bun.lockb
 .jules
+.claude/

.jules/sentinel.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fprime
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE

@@ -2,6 +2,10 @@
 
 A native OpenCode plugin that implements the **Personal AI Infrastructure (PAI)** logic, replacing legacy hook scripts with a cohesive, lifecycle-aware system.
 
+## Credits & Inspiration
+
+This project is an OpenCode-compatible clone of the hook system from **Dan Miessler's** [Personal AI Infrastructure (PAI)](https://github.com/danielmiessler/Personal_AI_Infrastructure) project. A massive shout out to Dan for the architectural vision and the original PAI patterns that this plugin brings to the OpenCode ecosystem.
+
 ## Features
 
 ### 1. Identity & Context Injection
@@ -33,44 +37,35 @@ The plugin centers around the `PAI_DIR` environment variable.
 | `ENGINEER_NAME` | Your name/identity | `Engineer` |
 | `DA_COLOR` | UI color theme for your DA | `blue` |
 
-## Installation
-
-The easiest way to install the plugin and initialize your PAI infrastructure is using the setup script:
+## Quick Start
 
-```bash
-curl -sSL https://raw.githubusercontent.com/fpr1m3/opencode-pai-plugin/main/setup.sh | bash
-```
-
-Or, if you have already cloned the repository:
+Add the plugin to your global `opencode.json` configuration file (typically located at `~/.config/opencode/opencode.json`). OpenCode will automatically install the plugin from GitHub on its next startup.
 
-```bash
-./setup.sh
+```json
+{
+  "plugins": [
+    "github:fpr1m3/opencode-pai-plugin"
+  ]
+}
 ```
 
-## Manual Installation
-
-```bash
-bun add github:fpr1m3/opencode-pai-plugin
-```
+Upon first run, the plugin will automatically:
+1. Detect or create your `PAI_DIR` (default: `$XDG_CONFIG_HOME/opencode`).
+2. Initialize the required directory structure for skills and history.
+3. Create a default `SKILL.md` core identity if one does not exist.
 
 ## Development & Testing
 
-We provide scripts to verify the installation flow in a pristine environment:
+We provide scripts to verify the plugin in a pristine environment:
 
 *   `./scripts/create-test-env.sh`: Creates a fresh, isolated OpenCode project for testing.
-*   `./scripts/test-full-flow.sh`: Runs a complete E2E installation and verification.
-
-
-## Usage
+*   `./scripts/test-full-flow.sh`: Runs a complete E2E verification of the plugin lifecycle.
 
-Register the plugin in your `.opencode/plugins.ts` (or equivalent):
+## Roadmap / TODO
 
-```typescript
-import { PAIPlugin } from "@opencode-ai/opencode-pai";
-
-export default PAIPlugin;
-```
+- [ ] **Voice Server Integration**: Implementation of the PAI voice notification server to provide audible feedback on task completion.
+- [ ] **Enhanced Agent Mapping**: More granular tracking of subagent state transitions.
 
 ---
 
-**Note**: This plugin is designed to work with the PAI ecosystem and requires a valid `PAI_DIR` structure to function fully.
+**Note**: This plugin is designed to work with the PAI ecosystem. While it auto-initializes a basic structure, you can customize your identity by editing `$PAI_DIR/skills/core/SKILL.md`.

README.md

@@ -1,55 +1,19 @@
 #!/bin/bash
-# test-full-flow.sh - End-to-end test for PAI Plugin setup
+# test-full-flow.sh - End-to-end test for PAI Plugin Auto-Initialization
 
 set -e
 
 REPO_ROOT=$(pwd)
 TEST_DIR="/tmp/opencode-full-test-$(date +%s)"
 
-# --- Cleanup ---
-cleanup() {
-    echo "🧹 Cleaning up test directory..."
-    rm -rf "$TEST_DIR"
-}
-# trap cleanup EXIT # Uncomment if you want auto-cleanup
-
 # 1. Establish Pristine Environment
 ./scripts/create-test-env.sh "$TEST_DIR"
 
-# 2. Preparation for Setup
-# We override the package to point to the local repo for the test
-export PLUGIN_PACKAGE_OVERRIDE="$REPO_ROOT"
+# 2. Preparation
 export PAI_DIR="$TEST_DIR/local-pai"
 
-cd "$TEST_DIR"
-
-echo "🛠️ Running setup script inside test environment..."
-export PAI_NON_INTERACTIVE="true"
-"$REPO_ROOT/setup.sh"
-
-# 3. Verification
-echo "🔍 Verifying installation artifacts..."
-
-if [ ! -f ".opencode/plugins/pai.ts" ]; then
-    echo "❌ Error: Plugin registration file (.opencode/plugins/pai.ts) not found."
-    exit 1
-fi
-
-if [ ! -f "local-pai/skills/core/SKILL.md" ]; then
-    echo "❌ Error: PAI identity file (local-pai/skills/core/SKILL.md) not found."
-    exit 1
-fi
-
-if ! grep -q "Personal AI Infrastructure" local-pai/skills/core/SKILL.md; then
-    echo "❌ Error: SKILL.md content is invalid or empty."
-    exit 1
-fi
-
-# Check if dependencies were added to package.json
-if ! grep -q "opencode-pai-plugin" package.json; then
-    echo "❌ Error: Plugin not found in package.json dependencies."
-    exit 1
-fi
+echo "🛠️ Verifying auto-initialization via plugin lifecycle..."
+cd "$REPO_ROOT"
+bun scripts/verify-auto-init.ts
 
 echo "✅ End-to-end verification successful!"
-echo "📍 Test project remains at: $TEST_DIR"

scripts/test-full-flow.sh

@@ -0,0 +1,52 @@
+import { join } from "path";
+import { existsSync, rmSync, mkdirSync } from "fs";
+
+async function testAutoInit() {
+  console.log("🧪 Testing PAI Plugin Auto-Initialization...");
+  
+  const worktree = "/tmp/pai-auto-init-test";
+  if (existsSync(worktree)) rmSync(worktree, { recursive: true });
+  mkdirSync(worktree, { recursive: true });
+
+  // Point PAI_DIR to a temporary location
+  const testPaiDir = join(worktree, "pai-home");
+  process.env.PAI_DIR = testPaiDir;
+
+  console.log(`📍 Test PAI_DIR: ${testPaiDir}`);
+
+  // 1. Initialize Plugin (Dynamic import to pick up env changes)
+  const { PAIPlugin } = await import("../src/index");
+  await PAIPlugin({ worktree } as any);
+  
+  // 2. Verify Directories
+  const expectedDirs = [
+    join(testPaiDir, 'skills', 'core'),
+    join(testPaiDir, 'history', 'raw-outputs'),
+    join(testPaiDir, 'history', 'sessions'),
+  ];
+
+  for (const dir of expectedDirs) {
+    if (existsSync(dir)) {
+      console.log(`✅ Directory exists: ${dir}`);
+    } else {
+      console.error(`❌ Directory missing: ${dir}`);
+      process.exit(1);
+    }
+  }
+
+  // 3. Verify SKILL.md
+  const skillPath = join(testPaiDir, 'skills', 'core', 'SKILL.md');
+  if (existsSync(skillPath)) {
+    console.log(`✅ SKILL.md created at ${skillPath}`);
+  } else {
+    console.error(`❌ SKILL.md missing!`);
+    process.exit(1);
+  }
+
+  console.log("✨ Auto-Initialization verification successful!");
+}
+
+testAutoInit().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

scripts/verify-auto-init.ts

@@ -4,7 +4,44 @@ import { Logger } from './lib/logger';
 import { PAI_DIR } from './lib/paths';
 import { validateCommand } from './lib/security';
 import { join } from 'path';
-import { existsSync, readFileSync } from 'fs';
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
+
+/**
+ * Ensure the PAI directory structure exists.
+ */
+function ensurePAIStructure() {
+  const dirs = [
+    join(PAI_DIR, 'skills', 'core'),
+    join(PAI_DIR, 'history', 'raw-outputs'),
+    join(PAI_DIR, 'history', 'sessions'),
+    join(PAI_DIR, 'history', 'system-logs'),
+  ];
+
+  for (const dir of dirs) {
+    if (!existsSync(dir)) {
+      try {
+        mkdirSync(dir, { recursive: true });
+        console.log(`PAI: Created directory ${dir}`);
+      } catch (e) {
+        console.error(`PAI: Failed to create directory ${dir}:`, e);
+      }
+    }
+  }
+
+  const coreSkillPath = join(PAI_DIR, 'skills', 'core', 'SKILL.md');
+  if (!existsSync(coreSkillPath)) {
+    const defaultSkill = `# PAI Core Identity
+You are {{DA}}, a Personal AI Infrastructure. 
+Your primary engineer is {{ENGINEER_NAME}}.
+`;
+    try {
+      writeFileSync(coreSkillPath, defaultSkill, 'utf-8');
+      console.log(`PAI: Created default SKILL.md at ${coreSkillPath}`);
+    } catch (e) {
+      console.error(`PAI: Failed to create default SKILL.md:`, e);
+    }
+  }
+}
 
 /**
  * Check if an event should be skipped to prevent recursive logging.
@@ -63,6 +100,9 @@ export const PAIPlugin: Plugin = async ({ worktree }) => {
   let logger: Logger | null = null;
   let currentSessionId: string | null = null;
 
+  // Auto-initialize PAI infrastructure if needed
+  ensurePAIStructure();
+  
   // Load CORE skill content from $PAI_DIR/skills/core/SKILL.md
   let coreSkillContent = '';
   const coreSkillPath = join(PAI_DIR, 'skills', 'core', 'SKILL.md');