Add automated setup script and E2E verification suite

Author: fpr1m3

README.md

@@ -35,10 +35,32 @@ The plugin centers around the `PAI_DIR` environment variable.
 
 ## Installation
 
+The easiest way to install the plugin and initialize your PAI infrastructure is using the setup script:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/fpr1m3/opencode-pai-plugin/main/setup.sh | bash
+```
+
+Or, if you have already cloned the repository:
+
+```bash
+./setup.sh
+```
+
+## Manual Installation
+
 ```bash
 bun add github:fpr1m3/opencode-pai-plugin
 ```
 
+## Development & Testing
+
+We provide scripts to verify the installation flow 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
 
 Register the plugin in your `.opencode/plugins.ts` (or equivalent):

scripts/create-test-env.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# create-test-env.sh - Setup a pristine OpenCode test environment
+# Usage: ./scripts/create-test-env.sh [target_dir]
+
+set -e
+
+TARGET_DIR="${1:-/tmp/opencode-pristine-$(date +%s)}"
+PAI_TEST_DIR="$TARGET_DIR/local-pai"
+
+echo "🚀 Creating pristine OpenCode environment..."
+echo "📍 Project Root: $TARGET_DIR"
+echo "🏠 Local PAI_DIR: $PAI_TEST_DIR"
+
+mkdir -p "$TARGET_DIR"
+mkdir -p "$PAI_TEST_DIR"
+
+# Ensure we're absolute
+TARGET_DIR=$(cd "$TARGET_DIR" && pwd)
+PAI_TEST_DIR=$(cd "$PAI_TEST_DIR" && pwd)
+
+cd "$TARGET_DIR"
+
+# 1. Initialize Git (OpenCode needs a worktree)
+git init -q
+
+# 2. Create basic package.json
+cat > package.json <<EOF
+{
+  "name": "pristine-opencode-project",
+  "version": "1.0.0",
+  "description": "A fresh OpenCode project for testing PAI plugin",
+  "private": true
+}
+EOF
+
+# 3. Setup .opencode directory
+mkdir -p .opencode/plugins
+
+# 4. Create a dummy README
+echo "# Pristine Test Project" > README.md
+
+echo ""
+echo "✅ Pristine environment established."
+echo "------------------------------------------------"
+echo "To begin testing:"
+echo "export PAI_DIR=$PAI_TEST_DIR"
+echo "cd $TARGET_DIR"
+echo "------------------------------------------------"
+
+# Output the path for other scripts to capture
+echo "$TARGET_DIR" > /tmp/last_opencode_test_env

scripts/test-full-flow.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# test-full-flow.sh - End-to-end test for PAI Plugin setup
+
+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"
+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 "✅ End-to-end verification successful!"
+echo "📍 Test project remains at: $TEST_DIR"

setup.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# PAI Plugin Setup Script
+# Installs the PAI plugin into an OpenCode project
+
+set -e
+
+# --- Configuration ---
+PLUGIN_PACKAGE="${PLUGIN_PACKAGE_OVERRIDE:-github:fpr1m3/opencode-pai-plugin}"
+PAI_DIR_DEFAULT="$HOME/.claude"
+
+# --- UI Helpers ---
+info() { echo -e "\033[0;34m[PAI INFO]\033[0m $1"; }
+success() { echo -e "\033[0;32m[PAI SUCCESS]\033[0m $1"; }
+warn() { echo -e "\033[0;33m[PAI WARN]\033[0m $1"; }
+error() { echo -e "\033[0;31m[PAI ERROR]\033[0m $1"; exit 1; }
+
+# --- Logic ---
+
+info "Starting PAI Plugin installation..."
+
+# 1. Project Detection
+if [ ! -f "package.json" ]; then
+    error "No package.json found. Please run this script from the root of your OpenCode project."
+fi
+
+# 2. Dependency Installation
+info "Installing plugin package..."
+if command -v bun >/dev/null 2>&1; then
+    bun add "$PLUGIN_PACKAGE"
+elif command -v npm >/dev/null 2>&1; then
+    npm install "$PLUGIN_PACKAGE"
+else
+    error "Neither bun nor npm found. Please install a package manager."
+fi
+
+# 3. Plugin Registration
+info "Registering PAI Plugin..."
+mkdir -p .opencode/plugins
+
+PLUGIN_REG_FILE=".opencode/plugins/pai.ts"
+if [ -f "$PLUGIN_REG_FILE" ]; then
+    warn "$PLUGIN_REG_FILE already exists. Skipping registration."
+else
+    cat > "$PLUGIN_REG_FILE" <<EOF
+import { PAIPlugin } from "opencode-pai-plugin";
+
+export default PAIPlugin;
+EOF
+    success "Plugin registered in $PLUGIN_REG_FILE"
+fi
+
+# 4. PAI Infrastructure Check
+CURRENT_PAI_DIR="${PAI_DIR:-$PAI_DIR_DEFAULT}"
+CORE_SKILL_FILE="$CURRENT_PAI_DIR/skills/core/SKILL.md"
+info "Checking PAI infrastructure at $CURRENT_PAI_DIR..."
+
+if [ ! -f "$CORE_SKILL_FILE" ]; then
+    warn "PAI core identity not found at $CORE_SKILL_FILE"
+    # Auto-initialize if non-interactive or if user says yes
+    if [[ "$CI" == "true" ]] || [[ "$PAI_NON_INTERACTIVE" == "true" ]]; then
+        INITIALIZE_PAI="y"
+    else
+        read -p "Would you like to initialize a basic PAI structure now? (y/n) " -n 1 -r
+        echo ""
+        INITIALIZE_PAI=$REPLY
+    fi
+
+    if [[ $INITIALIZE_PAI =~ ^[Yy]$ ]]; then
+        mkdir -p "$CURRENT_PAI_DIR/skills/core"
+        mkdir -p "$CURRENT_PAI_DIR/history/raw-outputs"
+        mkdir -p "$CURRENT_PAI_DIR/history/sessions"
+        
+        cat > "$CORE_SKILL_FILE" <<EOF
+# PAI Core Identity
+You are {{DA}}, a Personal AI Infrastructure. 
+Your primary engineer is {{ENGINEER_NAME}}.
+EOF
+        info "Created default SKILL.md"
+        success "PAI structure initialized."
+    fi
+fi
+
+success "PAI Plugin installation complete!"
+info "You can now run 'opencode' to start using your Personal AI Infrastructure."