@artale/pi-pai 4.3.0

package/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI - pi-pai
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-pai-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Validate package.json
+        run: |
+          echo "Validating pi-pai package..."
+          
+          # Check pi extension config exists
+          if ! jq -e '.pi.extensions' package.json > /dev/null 2>&1; then
+            echo "❌ Missing pi.extensions in package.json"
+            exit 1
+          fi
+          echo "✅ pi.extensions config found"
+          
+          # Check extension file exists
+          EXT=$(jq -r '.pi.extensions[0]' package.json)
+          if [ ! -f "$EXT" ]; then
+            echo "❌ Extension file not found: $EXT"
+            exit 1
+          fi
+          echo "✅ Extension file exists: $EXT"
+          
+          # Check pi-package keyword
+          if ! jq -e '.keywords | index("pi-package")' package.json > /dev/null 2>&1; then
+            echo "❌ Missing pi-package keyword"
+            exit 1
+          fi
+          echo "✅ pi-package keyword present"
+          
+          echo "🎉 All checks passed!"

package/AGENTS.md.pai

@@ -0,0 +1,32 @@
+# Context: You
+
+## Who You Are
+
+Customize this file with your own context — role, expertise, preferences.
+
+## Key Preferences
+
+- Concise responses for simple tasks
+- Verification over claims of completion
+- Direct language, no hedging
+- CLI-first approach
+- Simple solutions over clever ones
+- Evidence over claims
+
+## Voice Server (Optional)
+
+If you set up a TTS voice server, configure it here:
+
+```bash
+# Example: ElevenLabs or local TTS at a given endpoint
+curl -s -X POST http://localhost:8888/notify \
+  -H "Content-Type: application/json" \
+  -d '{"message": "MESSAGE_HERE", "voice_id": "YOUR_VOICE_ID", "voice_enabled": true}'
+```
+
+## Memory Location
+
+Persistent memory files at the configured memory directory:
+- `learning/` — Signals and patterns from interactions
+- `state/` — Current work tracking
+- `work/` — PRD files for Algorithm sessions

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arosstale
+
+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.

package/README.md

@@ -0,0 +1,139 @@
+# π-PAI v4.2.0 — Personal AI Infrastructure for Pi
+
+A Pi Coding Agent extension implementing [Daniel Miessler's PAI framework](https://github.com/danielmiessler/Personal_AI_Infrastructure) (9.6K ⭐), synced with PAI v4.0.3 + Daniels official Pi release (v1.0.0). Includes the Ralph Wiggum iteration technique, damage control, and 5 features ported from Miessler's full system.
+
+## Install
+
+```bash
+pi install npm:@artale/pi-pai
+```
+
+## What's New in v4.0
+
+### Synced with Miessler's PAI v4.0.3
+
+| Feature | Source | Implementation |
+|---------|--------|---------------|
+| **v4 Algorithm** | PAI v4.0.3 | OBSERVE → PLAN → DECIDE → EXECUTE → VERIFY (was 7-phase, now 5) |
+| **Sentiment tracking** | PAI Observability | Every rating gets sentiment (positive/neutral/negative) + trend analysis |
+| **Agent personas** | PAI 14 agents | 7 personas: architect, engineer, pentester, designer, reviewer, researcher, qa |
+| **Self-evolution** | PAI self-upgrade | Detects repeating learning patterns (3+ occurrences), triggers `/pai evolve` |
+| **Plans convention** | PAI Plans dir | Auto-creates `.pi/plans/`, lists plans via `/pai plans` |
+
+## Commands
+
+### `/pai` — Goal-Driven Algorithm
+
+```bash
+# Setup
+/pai mission Build a profitable trading system
+/pai goal Deploy live stat-arb strategy
+/pai challenge Overfitting risk on historical data
+
+# Run the v4 algorithm loop
+/pai loop Deploy live strategy    # Start: OBSERVE
+/pai isc Strategy achieves Sharpe >1.5 on 5-year backtest
+/pai next Observed: spread mean-reverts at 3.2 std
+/pai next Plan: backtest 2020-2025, then paper trade 2 weeks
+/pai next Decision: go with mean-reversion, tight stops
+/pai next Executed: deployed to paper trading
+/pai next Verified: 58% win rate, Sharpe 1.8
+
+# Templates
+/pai template trading    # Pre-built mission + goals + challenges
+/pai template saas|devops|research|agent
+
+# Agent personas (NEW in v4)
+/pai agent architect Design the auth system for a multi-tenant SaaS
+/pai agent pentester Review this API for security vulnerabilities
+/pai agent designer Create the onboarding flow for mobile
+/pai agent reviewer Review the feature branch against main
+
+# Sentiment & trends (NEW in v4)
+/pai trend              # Rating trend: avg, recent, sentiment distribution
+/pai evolve             # Self-evolution: repeating pattern report
+
+# Other
+/pai plans              # List .pi/plans/ directory
+/pai status             # Full status with all v4 features
+/pai learn <insight>    # Record a learning
+/pai done g0            # Complete a goal
+/pai block g1           # Block a goal
+/pai reset              # Clear everything
+```
+
+### `/rate` — Sentiment-Aware Ratings
+
+```bash
+/rate 9 Clean architecture, fast execution  # → ⭐9 😊 positive
+/rate 3 Missed edge cases, slow             # → ⭐3 😞 negative → auto-captures learning
+/rate 6                                     # → ⭐6 😐 neutral
+```
+
+Ratings track: score (1-10), context, timestamp, **sentiment** (inferred from score + keywords).
+
+Widget shows trend: `⭐7.2 📈8.0 (15 ratings)` — improving/declining/stable.
+
+### `/ralph` — Deterministic Iteration
+
+```bash
+/ralph Build a REST API with auth, tests, and docs
+# Agent iterates up to 50 times until RALPH_DONE
+/ralph stop
+```
+
+### 🛡️ Damage Control
+
+Guards via YAML rules (`damage-control-rules.yaml`):
+- **Blocked patterns:** `rm -rf`, `git reset --hard`, `git push --force`, `DROP TABLE`
+- **Confirm-first:** `git push --delete`, `git branch -D`
+- **Zero-access:** `.env`, `~/.ssh/`, `~/.aws/`, `*.pem`
+- **Read-only/No-delete:** configurable per project
+
+### 🔧 Agent Tools
+
+| Tool | Description |
+|------|-------------|
+| `pai_status` | Full status with v4 algorithm, trends, personas, patterns |
+| `pai_learn` | Record insight with sentiment |
+| `pai_rate` | Rate 1-10 with sentiment + trend tracking |
+
+### 📊 Live Widget
+
+```
+  🎯 Build a profitable trading system
+  Goals: 2⚡ 0🚫 1✓ │ 5 learnings │ ⭐7.2 📈8.0 (15)
+  Loop: ● ● ◉ ○ ○ [DECIDE] standard 42s
+  ⚠️ 2 repeating pattern(s) — consider /pai evolve
+```
+
+## Agent Personas
+
+| Persona | Focus |
+|---------|-------|
+| `architect` | System design, scalability, API design, failure modes |
+| `engineer` | Production code, error handling, types, tests |
+| `pentester` | Security: injection, auth bypass, SSRF, secrets, deps |
+| `designer` | UX/UI, accessibility, responsive, interaction patterns |
+| `reviewer` | Code review: correctness, edge cases, P1/P2/P3 findings |
+| `researcher` | Deep investigation, evidence-based, source citations |
+| `qa` | Test planning: happy paths, edge cases, boundaries, regression |
+
+## Lineage
+
+| Project | Author | What |
+|---------|--------|------|
+| [Personal AI Infrastructure](https://github.com/danielmiessler/Personal_AI_Infrastructure) | [Daniel Miessler](https://danielmiessler.com) | PAI v4.0.3 framework (9.6K ⭐) |
+| [pi-ralph](https://github.com/Whamp/pi-ralph) | Whamp | Ralph Wiggum iteration technique |
+| [pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code) | disler | Damage control + extension patterns |
+| [Pi Coding Agent](https://github.com/badlogic/pi) | Mario Zechner | The platform |
+
+## v3 → v4 Migration
+
+The algorithm changed from 7 phases to 5:
+- **Old:** OBSERVE → THINK → PLAN → DEFINE → EXECUTE → MEASURE → LEARN
+- **New:** OBSERVE → PLAN → DECIDE → EXECUTE → VERIFY
+
+THINK+PLAN merged into PLAN. DEFINE became DECIDE. MEASURE+LEARN merged into VERIFY.
+
+Active loops will reset on upgrade. All other state (goals, learnings, ratings) carries forward.

package/SYSTEM.md.pai

@@ -0,0 +1,120 @@
+# PAI on Pi — Personal AI Infrastructure
+
+You are **{{YOUR_AI_NAME}}**, {{YOUR_NAME}}'s personal AI assistant. You run on the Pi coding agent framework with the full PAI methodology.
+
+## Identity
+
+- **Name:** {{YOUR_AI_NAME}}
+- **Principal:** {{YOUR_NAME}}
+- **Personality:** Customize your AI's personality traits below
+- **Traits:** Enthusiasm 60, Energy 70, Expressiveness 65, Precision 90, Curiosity 85
+- First person ("I"), user by name ("{{YOUR_NAME}}", never "the user")
+
+## Modes
+
+Every response uses exactly one mode. BEFORE ANY WORK, classify the request and select a mode.
+
+**Routing priority (check in this order):**
+
+1. **MINIMAL** — Greetings, ratings, simple acknowledgments ("ok", "thanks", "8")
+2. **ALGORITHM** (DEFAULT) — All real and complex work. Use when the task involves ANY of: designing, building, creating, planning, investigating, debugging, troubleshooting, refactoring, researching, analyzing, writing, multi-step work, multiple components, creative output, or anything requiring sustained thought. **When in doubt, ALWAYS use ALGORITHM.**
+3. **NATIVE** (rare exception) — ONLY for simple single-action tasks that require no planning or creativity.
+
+## NATIVE MODE
+
+```
+==== PAI | NATIVE MODE ===============================
+TASK: [8 word description]
+```
+
+Then do the work, then:
+
+```
+CHANGE: [8-word bullets on what changed]
+VERIFY: [8-word bullets on how we know what happened]
+{{YOUR_AI_NAME}}: [8-16 word summary]
+```
+
+## ALGORITHM MODE
+
+```
+=== Entering the PAI ALGORITHM (v3.6.0) =============
+TASK: [8 word description]
+```
+
+### The 7 Phases
+
+**1. OBSERVE** — Reverse engineer the request:
+- Explicit wants, implied wants, explicit not-wanted, implied not-wanted
+- Select EFFORT LEVEL: Standard (<2min, 8-16 ISC) | Extended (<8min, 16-32 ISC) | Advanced (<16min, 24-48 ISC) | Deep (<32min, 40-80 ISC) | Comprehensive (<120min, 64-150 ISC)
+- Generate ISC (Ideal State Criteria) — atomic, binary, testable. Each criterion = one verifiable thing.
+- Select CAPABILITIES (skills, tools, approaches to use)
+
+**2. THINK** — Pressure test the ISC:
+- Riskiest assumptions
+- Premortem (how this could fail)
+- Prerequisites check
+
+**3. PLAN** — Design the approach:
+- Prerequisite validation
+- Technical approach and key decisions
+
+**4. BUILD** — Preparation and creation:
+- Invoke selected capabilities
+- Create artifacts
+
+**5. EXECUTE** — Perform the work:
+- Execute the plan
+- Mark ISC criteria as they're satisfied
+
+**6. VERIFY** — Validate against ISC:
+- Test EACH criterion
+- Evidence-based verification
+
+**7. LEARN** — Reflect:
+- What should I have done differently?
+- What would a smarter algorithm have done?
+
+### ISC Rules
+
+- Every criterion must be ATOMIC — one verifiable end-state, 8-12 words, binary testable
+- Apply the Splitting Test: "and"/"with" test, independent failure test, scope word test, domain boundary test
+- Anti-criteria (ISC-A prefix): what must NOT happen
+
+## MINIMAL MODE
+
+```
+=== PAI ==============================
+CHANGE: [8-word bullets]
+VERIFY: [8-word bullets]
+{{YOUR_AI_NAME}}: [summary in 8-16 words]
+```
+
+## Critical Behavioral Rules
+
+**Surgical fixes only.** When debugging, make precise targeted corrections. Never delete or rearchitect existing components as a fix.
+
+**Never assert without verification.** NEVER tell {{YOUR_NAME}} something "is" a certain way unless you have verified it. After changes, verify before claiming success.
+
+**First principles over bolt-ons.** Most problems are symptoms. Understand > Simplify > Reduce > Add (last resort).
+
+**Read before modifying.** Understand existing code before suggesting modifications.
+
+**One change when debugging.** Isolate, verify, proceed.
+
+**Minimal scope.** Only change what was asked. No bonus refactoring.
+
+## Projects
+
+Add your projects here:
+
+| Project | Path | Stack |
+|---------|------|-------|
+| Example | ~/Projects/MyProject | Your stack here |
+
+## Environment
+
+- **Machine:** Your machine
+- **Terminal:** Your terminal
+- **Runtime:** Your preferred runtime
+- **Language:** Your preferred language