@tekmidian/pai 0.6.6 → 0.7.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tekmidian/pai",
+  "displayName": "PAI Knowledge OS",
+  "description": "Personal AI Infrastructure — persistent memory, session continuity, and knowledge graph for Claude Code",
+  "version": "0.7.0",
+  "author": "Matthias Nott",
+  "license": "MIT",
+  "homepage": "https://github.com/mnott/PAI",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mnott/PAI"
+  },
+  "keywords": [
+    "memory",
+    "knowledge-os",
+    "session-continuity",
+    "mcp",
+    "personal-ai",
+    "hooks",
+    "skills",
+    "zettelkasten"
+  ],
+  "engines": {
+    "claude-code": ">=1.0.0",
+    "node": ">=20.0.0"
+  },
+  "setup": "pai setup",
+  "mcp": {
+    "server": "dist/daemon-mcp/index.mjs",
+    "daemon": "dist/daemon/index.mjs"
+  },
+  "hooks": "plugins/core/hooks/hooks.json",
+  "skills": [
+    "plugins/core/skills/",
+    "plugins/productivity/skills/",
+    "plugins/observability/skills/",
+    "plugins/zettelkasten/skills/",
+    "plugins/creative/skills/"
+  ],
+  "templates": [
+    "templates/claude-md.template.md",
+    "templates/pai-skill.template.md",
+    "templates/agent-prefs.example.md"
+  ],
+  "userExtensions": {
+    "hooks": "user-extensions/hooks/",
+    "skills": "user-extensions/skills/",
+    "prompts": "src/daemon-mcp/prompts/custom/"
+  }
+}

package/PLUGIN-ARCHITECTURE.md

@@ -0,0 +1,365 @@
+# PAI Plugin Architecture
+
+Technical reference for PAI's modular plugin system, cross-platform support, user extensions, and monetization tiers.
+
+---
+
+## Overview
+
+PAI is structured as a modular plugin system with 8 named modules organized into 3 pricing tiers. The architecture supports Claude Code (full integration), Cursor (MCP only), and Gemini CLI (MCP only).
+
+```
+PAI Knowledge OS
+├── Core (free, required)
+│   ├── Memory engine (keyword search, SQLite)
+│   ├── Session management
+│   ├── Project registry
+│   ├── 5 essential hooks
+│   └── 3 essential skills
+├── Free Extensions
+│   ├── Productivity (Plan, Review, Journal, Research, Share)
+│   ├── UI Customization (tab titles, statusline, tab colors)
+│   └── Context Preservation (compression, relay, checkpoint)
+├── Pro Extensions
+│   ├── Semantic Search (pgvector, reranking, hybrid)
+│   └── Observability (capture, classify, summarize)
+└── Enterprise Extensions
+    ├── Zettelkasten Intelligence (6 graph operations)
+    └── Creative Studio (art, story, voice/prosody)
+```
+
+---
+
+## Module System
+
+### Module Manifest
+
+Each module has a `plugins/<module>/plugin.json` that declares:
+
+```json
+{
+  "name": "pai-core",
+  "displayName": "PAI Core",
+  "description": "Core memory engine, session management, and project registry",
+  "version": "0.7.0",
+  "tier": "free",
+  "required": true,
+  "depends": [],
+  "hooks": "hooks/hooks.json",
+  "skills": ["Sessions", "Route", "Name"]
+}
+```
+
+### Module Inventory
+
+| Module | Tier | Hooks | Skills | Description |
+|--------|------|-------|--------|-------------|
+| `core` | free | 6 | 3 | Memory engine, sessions, projects, security |
+| `productivity` | free | 2 | 6 | Plan, Review, Journal, Research, Share, Createskill |
+| `ui` | free | 2 | 0 | Tab titles, statusline, tab coloring |
+| `context-preservation` | free | 3 | 0 | Context compression and relay |
+| `semantic-search` | pro | 0 | 0 | pgvector, reranking, hybrid search |
+| `observability` | pro | 13 | 2 | Event capture, classification, summaries |
+| `zettelkasten` | enterprise | 0 | 5 | Graph operations, vault intelligence |
+| `creative` | enterprise | 0 | 2 | Art direction, story, voice/prosody |
+
+### Hook Distribution
+
+Total: 26 hook registrations across 6 modules.
+
+**Core (6):** load-core-context, load-project-context, initialize-session, security-validator, stop-hook, pai-session-stop.sh
+
+**Productivity (2):** sync-todo-to-md, cleanup-session-files
+
+**UI (2):** update-tab-titles, update-tab-on-action
+
+**Context Preservation (3):** context-compression-hook, pai-pre-compact.sh, post-compact-inject
+
+**Observability (13):** capture-all-events (7 events), observe, inject-observations, capture-tool-output, capture-session-summary, subagent-stop-hook
+
+### Skill Distribution
+
+Total: 18 skills across 5 modules.
+
+**Core (3):** Sessions, Route, Name
+
+**Productivity (6):** Plan, Review, Journal, Research, Share, Createskill
+
+**Observability (2):** Observability, SearchHistory
+
+**Zettelkasten (5):** VaultConnect, VaultContext, VaultEmerge, VaultOrphans, VaultTrace
+
+**Creative (2):** Art, StoryExplanation
+
+---
+
+## Directory Structure
+
+```
+PAI/
+├── .claude-plugin/
+│   └── plugin.json              # Claude Code plugin manifest
+├── .cursor/
+│   └── plugin.json              # Cursor plugin manifest
+├── gemini-extension.json        # Gemini CLI extension manifest
+├── pai-plugin.json              # Canonical module manifest (build reads this)
+│
+├── plugins/                     # Module definitions
+│   ├── core/
+│   │   ├── plugin.json          # Module metadata
+│   │   ├── hooks/
+│   │   │   └── hooks.json       # Core hook definitions
+│   │   └── skills/              # (populated by build symlinks)
+│   ├── productivity/
+│   │   ├── plugin.json
+│   │   ├── hooks/
+│   │   │   └── hooks.json
+│   │   └── skills/
+│   ├── ui/
+│   │   ├── plugin.json
+│   │   └── hooks/
+│   │       └── hooks.json
+│   ├── context-preservation/
+│   │   ├── plugin.json
+│   │   └── hooks/
+│   │       └── hooks.json
+│   ├── semantic-search/
+│   │   └── plugin.json
+│   ├── observability/
+│   │   ├── plugin.json
+│   │   ├── hooks/
+│   │   │   └── hooks.json
+│   │   └── skills/
+│   ├── zettelkasten/
+│   │   ├── plugin.json
+│   │   └── skills/
+│   └── creative/
+│       ├── plugin.json
+│       └── skills/
+│
+├── user-extensions/             # User customization point (gitignored)
+│   ├── README.md
+│   ├── hooks/
+│   │   └── .gitkeep
+│   └── skills/
+│       └── .gitkeep
+│
+├── src/                         # Source code (unchanged)
+├── dist/                        # Build output (unchanged)
+├── templates/                   # Setup templates (unchanged)
+└── scripts/                     # Build scripts
+```
+
+---
+
+## Cross-Platform Support
+
+### Claude Code (Full Integration)
+
+Claude Code gets the complete PAI experience:
+
+| Capability | Support |
+|------------|---------|
+| MCP Tools (9) | Full |
+| MCP Resources (11) | Full |
+| MCP Prompts (18) | Full |
+| Hooks (26 registrations) | Full |
+| Skills (18 SKILL.md stubs) | Full |
+| Statusline | Full |
+| Tab management | Full |
+
+Manifest: `.claude-plugin/plugin.json`
+
+### Cursor (MCP Only)
+
+Cursor supports MCP servers but not Claude Code's hook or skill system:
+
+| Capability | Support |
+|------------|---------|
+| MCP Tools (9) | Full |
+| MCP Resources | Not supported |
+| MCP Prompts | Not supported |
+| Hooks | Not supported |
+| Skills | Not supported (use Cursor Rules instead) |
+
+Manifest: `.cursor/plugin.json`
+
+To use PAI with Cursor, add to `.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "pai": {
+      "command": "node",
+      "args": ["/path/to/PAI/dist/daemon-mcp/index.mjs"]
+    }
+  }
+}
+```
+
+### Gemini CLI (MCP Only)
+
+Gemini CLI supports MCP servers via extensions:
+
+| Capability | Support |
+|------------|---------|
+| MCP Tools (9) | Full |
+| Hooks | Not supported |
+| Skills | Not supported |
+
+Manifest: `gemini-extension.json`
+
+### Codex (Future)
+
+OpenAI's Codex supports MCP. When available, a `codex-extension.json` can follow the same pattern.
+
+---
+
+## User Extensions
+
+PAI provides three extension points that survive git pull and PAI updates.
+
+### Custom Skills
+
+Create `user-extensions/skills/MySkill/SKILL.md`:
+
+```markdown
+---
+name: MySkill
+description: "What the skill does. USE WHEN user says 'trigger phrase'."
+---
+
+## My Skill Instructions
+
+Your skill content here...
+```
+
+Run `bun run build` to deploy. The build script discovers and symlinks custom skills into `~/.claude/skills/`.
+
+### Custom Hooks
+
+Create `user-extensions/hooks/my-hook.ts` or `user-extensions/hooks/my-hook.sh`:
+
+TypeScript hooks are compiled during build. Shell hooks are symlinked directly. Register in `~/.claude/settings.json` under the appropriate hook event.
+
+### Custom MCP Prompts
+
+Create `src/daemon-mcp/prompts/custom/my-prompt.ts`:
+
+```typescript
+export const myPrompt = {
+  description: "What the prompt does",
+  content: `## My Prompt
+USE WHEN user says 'trigger phrase'...
+Your prompt content here...`,
+};
+```
+
+Run `bun run build` to generate the skill stub.
+
+### Extension Safety
+
+| Location | Gitignored | PAI Updates | Discovery |
+|----------|------------|-------------|-----------|
+| `user-extensions/skills/` | Yes | Never touched | Build sync |
+| `user-extensions/hooks/` | Yes | Never touched | Build compile |
+| `src/daemon-mcp/prompts/custom/` | Yes | Never touched | Build generate |
+| `~/.claude/skills/user/` | N/A (outside repo) | Never touched | Claude Code scanner |
+
+---
+
+## Monetization Architecture
+
+### Tier Model
+
+| Tier | Price | Modules |
+|------|-------|---------|
+| Free | $0 | core, productivity, ui, context-preservation |
+| Pro | $9/mo or $79/yr | Free + semantic-search, observability |
+| Enterprise | $29/mo or $249/yr | Pro + zettelkasten, creative |
+
+### Gating Strategy (Future)
+
+The tier annotations in `pai-plugin.json` are structural markers for future license gating. The planned approach:
+
+1. License key stored in `~/.config/pai/license.json`
+2. Signed JWT for offline validation (no phone-home)
+3. Checked at daemon startup and premium MCP tool invocation
+4. Graceful degradation: premium features return "upgrade required" message
+5. `pai license activate <key>` CLI command
+
+Currently (v0.7.0): all features ship as free. Tier annotations are informational only.
+
+### What Justifies Each Tier
+
+**Pro** ($9/mo):
+- Semantic search is a significant infrastructure requirement (PostgreSQL + pgvector)
+- Cross-encoder reranking adds meaningful relevance improvement
+- Observability provides professional-grade session tracking
+- The value: "Your AI remembers better and you can see what it learned"
+
+**Enterprise** ($29/mo):
+- Zettelkasten requires Obsidian + significant graph computation
+- 6 specialized operations (explore, surprise, converse, themes, health, suggest)
+- Creative studio for specialized content creation workflows
+- The value: "Your knowledge graph is actively maintained by AI"
+
+---
+
+## Build System Integration
+
+The existing build system continues to work unchanged:
+
+```bash
+bun run build
+# = tsdown (compile TS)
+# + node scripts/build-hooks.mjs --sync (compile hooks, symlink to ~/.claude/Hooks/)
+# + node scripts/build-skill-stubs.mjs --sync (generate skills, symlink to ~/.claude/skills/)
+```
+
+The plugin manifests (`pai-plugin.json`, `.claude-plugin/plugin.json`, etc.) are static JSON files maintained alongside the codebase. They declare the module structure but do not participate in the build process.
+
+Future enhancement: a `scripts/build-plugin-manifest.mjs` that generates manifests from the module plugin.json files, ensuring version consistency.
+
+---
+
+## Migration Path
+
+### From Pre-Plugin PAI (v0.6.x)
+
+No migration needed. The plugin architecture is purely additive:
+
+1. All existing symlinks continue to work
+2. `~/.claude/settings.json` hook registrations unchanged
+3. MCP server registration unchanged
+4. User skills in `~/.claude/skills/user/` unchanged
+5. Custom prompts in `src/daemon-mcp/prompts/custom/` unchanged
+
+### For New Users
+
+`pai setup` handles everything. The setup wizard installs all modules by default. Users can selectively disable modules later.
+
+---
+
+## Future Roadmap
+
+### Phase 1 (v0.7.0 — Current)
+- Module manifest system
+- Cross-platform manifests
+- User extension points
+- Tier annotations (no enforcement)
+
+### Phase 2 (v0.8.0)
+- `pai plugins list` — show installed modules and tiers
+- `pai plugins enable/disable <module>` — selective module activation
+- Build system reads `pai-plugin.json` to generate platform manifests
+
+### Phase 3 (v0.9.0)
+- License validation system
+- `pai license activate <key>` command
+- Graceful tier gating with upgrade prompts
+
+### Phase 4 (v1.0.0)
+- Plugin marketplace integration
+- Third-party plugin support
+- Plugin dependency resolution
+- Community plugin repository

package/gemini-extension.json

@@ -0,0 +1,26 @@
+{
+  "name": "@tekmidian/pai",
+  "displayName": "PAI Knowledge OS",
+  "description": "Personal AI Infrastructure — persistent memory and session continuity for AI coding assistants",
+  "version": "0.7.0",
+  "author": "Matthias Nott",
+  "license": "MIT",
+  "homepage": "https://github.com/mnott/PAI",
+  "mcpServers": {
+    "pai": {
+      "command": "node",
+      "args": ["dist/daemon-mcp/index.mjs"],
+      "description": "PAI Knowledge OS — federated memory search, project registry, session management. Provides 9 tools: memory_search, memory_get, project_info, project_list, session_list, registry_search, project_detect, project_health, project_todo."
+    }
+  },
+  "capabilities": {
+    "mcp": true,
+    "hooks": false,
+    "skills": false
+  },
+  "setup": {
+    "prerequisite": "Run 'pai setup' to configure storage backend, indexing, and daemon.",
+    "daemon": "Run 'pai daemon install' to start the background indexing service."
+  },
+  "notes": "Gemini CLI supports MCP servers. PAI's 9 MCP tools work fully. Hooks and skills are Claude Code-specific features that require Claude Code."
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekmidian/pai",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "PAI Knowledge OS — Personal AI Infrastructure with federated memory and project management",
   "type": "module",
   "main": "dist/index.mjs",
@@ -14,6 +14,11 @@
   "files": [
     "dist",
     "templates",
+    "plugins",
+    "user-extensions",
+    ".claude-plugin",
+    "pai-plugin.json",
+    "gemini-extension.json",
     "statusline-command.sh",
     "tab-color-command.sh",
     "scripts/build-hooks.mjs",
@@ -22,7 +27,8 @@
     "README.md",
     "LICENSE",
     "ARCHITECTURE.md",
-    "FEATURE.md"
+    "FEATURE.md",
+    "PLUGIN-ARCHITECTURE.md"
   ],
   "keywords": [
     "ai",

package/pai-plugin.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://pai.dev/schemas/plugin-manifest-v1.json",
+  "name": "@tekmidian/pai",
+  "displayName": "PAI Knowledge OS",
+  "description": "Personal AI Infrastructure — persistent memory, session continuity, and knowledge graph",
+  "version": "0.7.0",
+  "author": "Matthias Nott",
+  "license": "MIT",
+  "homepage": "https://github.com/mnott/PAI",
+  "repository": "https://github.com/mnott/PAI",
+
+  "modules": {
+    "core": {
+      "description": "Core memory engine, session management, project registry",
+      "tier": "free",
+      "required": true,
+      "hooks": "plugins/core/hooks/hooks.json",
+      "skills": ["Sessions", "Route", "Name"],
+      "mcp": {
+        "server": "dist/daemon-mcp/index.mjs",
+        "daemon": "dist/daemon/index.mjs",
+        "tools": [
+          "memory_search",
+          "memory_get",
+          "project_info",
+          "project_list",
+          "session_list",
+          "registry_search",
+          "project_detect",
+          "project_health",
+          "project_todo"
+        ],
+        "resources": [
+          "pai://constitution",
+          "pai://skill-system",
+          "pai://hook-system",
+          "pai://mcp-dev-guide",
+          "pai://terminal-tabs"
+        ]
+      },
+      "templates": [
+        "templates/claude-md.template.md",
+        "templates/pai-skill.template.md",
+        "templates/pai-project.template.md"
+      ]
+    },
+
+    "productivity": {
+      "description": "Planning, journaling, reviewing, research, and sharing workflows",
+      "tier": "free",
+      "required": false,
+      "depends": ["core"],
+      "hooks": "plugins/productivity/hooks/hooks.json",
+      "skills": ["Plan", "Review", "Journal", "Research", "Share", "Createskill"],
+      "templates": [
+        "templates/agent-prefs.example.md"
+      ]
+    },
+
+    "ui": {
+      "description": "Terminal tab titles, statusline, tab coloring, and visual customization",
+      "tier": "free",
+      "required": false,
+      "depends": ["core"],
+      "hooks": "plugins/ui/hooks/hooks.json",
+      "scripts": [
+        "statusline-command.sh",
+        "tab-color-command.sh"
+      ],
+      "templates": [
+        "templates/ai-steering-rules.template.md"
+      ]
+    },
+
+    "context-preservation": {
+      "description": "Context compression and relay across compaction cycles",
+      "tier": "free",
+      "required": false,
+      "depends": ["core"],
+      "hooks": "plugins/context-preservation/hooks/hooks.json"
+    },
+
+    "semantic-search": {
+      "description": "Vector search with pgvector, cross-encoder reranking, hybrid mode, recency boost",
+      "tier": "pro",
+      "required": false,
+      "depends": ["core"],
+      "features": [
+        "semantic_search_mode",
+        "hybrid_search_mode",
+        "cross_encoder_reranking",
+        "recency_boost",
+        "pgvector_storage"
+      ],
+      "requirements": {
+        "docker": true,
+        "postgresql": ">=15",
+        "pgvector": ">=0.5.0"
+      }
+    },
+
+    "observability": {
+      "description": "Automatic observation capture, classification, session summaries, and search history",
+      "tier": "pro",
+      "required": false,
+      "depends": ["core"],
+      "hooks": "plugins/observability/hooks/hooks.json",
+      "skills": ["Observability", "SearchHistory"],
+      "mcp": {
+        "resources": [
+          "pai://history-system"
+        ]
+      }
+    },
+
+    "zettelkasten": {
+      "description": "Luhmann-inspired vault intelligence — explore, surprise, converse, themes, health, suggest",
+      "tier": "enterprise",
+      "required": false,
+      "depends": ["core", "semantic-search"],
+      "skills": ["VaultConnect", "VaultContext", "VaultEmerge", "VaultOrphans", "VaultTrace"],
+      "features": [
+        "vault_indexer",
+        "zettel_explore",
+        "zettel_surprise",
+        "zettel_converse",
+        "zettel_themes",
+        "zettel_health",
+        "zettel_suggest"
+      ],
+      "requirements": {
+        "obsidian": true
+      }
+    },
+
+    "creative": {
+      "description": "Art direction, story explanation, voice/prosody configuration",
+      "tier": "enterprise",
+      "required": false,
+      "depends": ["core"],
+      "skills": ["Art", "StoryExplanation"],
+      "mcp": {
+        "resources": [
+          "pai://aesthetic",
+          "pai://prosody-guide",
+          "pai://prosody-agent-template",
+          "pai://voice",
+          "pai://prompting"
+        ]
+      },
+      "templates": [
+        "templates/voices.example.json"
+      ]
+    }
+  },
+
+  "tiers": {
+    "free": {
+      "description": "Core memory engine with keyword search, essential hooks, and productivity skills",
+      "price": 0,
+      "modules": ["core", "productivity", "ui", "context-preservation"]
+    },
+    "pro": {
+      "description": "Semantic search, observability suite, and advanced memory features",
+      "price": {
+        "monthly": 9,
+        "yearly": 79
+      },
+      "modules": ["core", "productivity", "ui", "context-preservation", "semantic-search", "observability"]
+    },
+    "enterprise": {
+      "description": "Full PAI — zettelkasten intelligence, creative studio, and all features",
+      "price": {
+        "monthly": 29,
+        "yearly": 249
+      },
+      "modules": ["core", "productivity", "ui", "context-preservation", "semantic-search", "observability", "zettelkasten", "creative"]
+    }
+  },
+
+  "userExtensions": {
+    "hooks": "user-extensions/hooks/",
+    "skills": "user-extensions/skills/",
+    "prompts": "src/daemon-mcp/prompts/custom/"
+  },
+
+  "platforms": {
+    "claude-code": {
+      "manifest": ".claude-plugin/plugin.json",
+      "hooks": true,
+      "skills": true,
+      "mcp": true,
+      "resources": true
+    },
+    "cursor": {
+      "manifest": ".cursor/plugin.json",
+      "hooks": false,
+      "skills": false,
+      "mcp": true,
+      "resources": false,
+      "notes": "Cursor supports MCP but not Claude Code hooks/skills"
+    },
+    "gemini-cli": {
+      "manifest": "gemini-extension.json",
+      "hooks": false,
+      "skills": false,
+      "mcp": true,
+      "resources": false,
+      "notes": "Gemini CLI supports MCP servers via extensions"
+    }
+  }
+}

package/plugins/context-preservation/hooks/hooks.json

@@ -0,0 +1,23 @@
+{
+  "module": "context-preservation",
+  "description": "Context compression and relay across compaction cycles",
+  "hooks": [
+    {
+      "event": "PreCompact",
+      "command": "${PAI_DIR}/Hooks/context-compression-hook.mjs",
+      "description": "Extract session state, save checkpoint, write temp file for relay to post-compact"
+    },
+    {
+      "event": "PreCompact",
+      "matcher": "",
+      "command": "${PAI_DIR}/Hooks/pai-pre-compact.sh",
+      "description": "Shell-level pre-compact processing"
+    },
+    {
+      "event": "SessionStart",
+      "matcher": "compact",
+      "command": "${PAI_DIR}/Hooks/post-compact-inject.mjs",
+      "description": "Read saved state from temp file and inject into post-compaction context"
+    }
+  ]
+}

package/plugins/context-preservation/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "pai-context-preservation",
+  "displayName": "PAI Context Preservation",
+  "description": "Context compression and relay across compaction cycles",
+  "version": "0.7.0",
+  "tier": "free",
+  "required": false,
+  "depends": ["core"],
+  "hooks": "hooks/hooks.json"
+}

package/plugins/core/hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "module": "core",
+  "description": "Essential lifecycle hooks for session management, context loading, and security",
+  "hooks": [
+    {
+      "event": "SessionStart",
+      "command": "${PAI_DIR}/Hooks/load-core-context.mjs",
+      "description": "Load PAI skill system and core configuration into session context"
+    },
+    {
+      "event": "SessionStart",
+      "command": "${PAI_DIR}/Hooks/load-project-context.mjs",
+      "description": "Detect project from CWD, load notes directory, TODO.md, and session note"
+    },
+    {
+      "event": "SessionStart",
+      "command": "${PAI_DIR}/Hooks/initialize-session.mjs",
+      "description": "Create numbered session note and register in PAI registry"
+    },
+    {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "command": "${PAI_DIR}/Hooks/security-validator.mjs",
+      "description": "Validate shell commands against security rules before execution"
+    },
+    {
+      "event": "Stop",
+      "command": "${PAI_DIR}/Hooks/stop-hook.mjs",
+      "description": "Write work items and summary to session note, send notification"
+    },
+    {
+      "event": "Stop",
+      "command": "${PAI_DIR}/Hooks/pai-session-stop.sh",
+      "description": "Shell-level session cleanup on stop"
+    }
+  ]
+}

package/plugins/core/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "pai-core",
+  "displayName": "PAI Core",
+  "description": "Core memory engine, session management, and project registry",
+  "version": "0.7.0",
+  "tier": "free",
+  "required": true,
+  "hooks": "hooks/hooks.json",
+  "skills": ["Sessions", "Route", "Name"]
+}

package/plugins/creative/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "pai-creative",
+  "displayName": "PAI Creative Studio",
+  "description": "Art direction, story explanation, voice/prosody configuration",
+  "version": "0.7.0",
+  "tier": "enterprise",
+  "required": false,
+  "depends": ["core"],
+  "skills": ["Art", "StoryExplanation"]
+}

package/plugins/observability/hooks/hooks.json

@@ -0,0 +1,75 @@
+{
+  "module": "observability",
+  "description": "Automatic observation capture, event logging, tool output recording, and session summaries",
+  "hooks": [
+    {
+      "event": "SessionStart",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SessionStart",
+      "description": "Log SessionStart event to session timeline"
+    },
+    {
+      "event": "SessionStart",
+      "command": "${PAI_DIR}/Hooks/inject-observations.mjs",
+      "description": "Inject recent observation context (compact index + timeline)"
+    },
+    {
+      "event": "UserPromptSubmit",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type UserPromptSubmit",
+      "description": "Log UserPromptSubmit event to session timeline"
+    },
+    {
+      "event": "PreToolUse",
+      "matcher": "*",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PreToolUse",
+      "description": "Log PreToolUse event to session timeline"
+    },
+    {
+      "event": "PostToolUse",
+      "matcher": "*",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PostToolUse",
+      "description": "Log PostToolUse event to session timeline"
+    },
+    {
+      "event": "PostToolUse",
+      "matcher": "*",
+      "command": "${PAI_DIR}/Hooks/observe.mjs",
+      "description": "Classify tool calls into typed observations (decision/bugfix/feature/refactor/discovery/change)"
+    },
+    {
+      "event": "PostToolUse",
+      "matcher": "*",
+      "command": "${PAI_DIR}/Hooks/capture-tool-output.mjs",
+      "description": "Record tool inputs/outputs for observability dashboard"
+    },
+    {
+      "event": "Stop",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type Stop",
+      "description": "Log Stop event to session timeline"
+    },
+    {
+      "event": "SubagentStop",
+      "command": "${PAI_DIR}/Hooks/subagent-stop-hook.mjs",
+      "description": "Capture sub-agent completion for observability"
+    },
+    {
+      "event": "SubagentStop",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SubagentStop",
+      "description": "Log SubagentStop event to session timeline"
+    },
+    {
+      "event": "SessionEnd",
+      "command": "${PAI_DIR}/Hooks/capture-session-summary.mjs",
+      "description": "Generate final session summary and write to session note"
+    },
+    {
+      "event": "SessionEnd",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SessionEnd",
+      "description": "Log SessionEnd event to session timeline"
+    },
+    {
+      "event": "PreCompact",
+      "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PreCompact",
+      "description": "Log PreCompact event to session timeline"
+    }
+  ]
+}

package/plugins/observability/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "pai-observability",
+  "displayName": "PAI Observability Suite",
+  "description": "Automatic observation capture, classification, session summaries, and search history",
+  "version": "0.7.0",
+  "tier": "pro",
+  "required": false,
+  "depends": ["core"],
+  "hooks": "hooks/hooks.json",
+  "skills": ["Observability", "SearchHistory"]
+}

package/plugins/productivity/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "module": "productivity",
+  "description": "Hooks for TODO sync, session cleanup, and productivity workflows",
+  "hooks": [
+    {
+      "event": "PostToolUse",
+      "matcher": "TodoWrite",
+      "command": "${PAI_DIR}/Hooks/sync-todo-to-md.mjs",
+      "description": "Sync Claude's internal TODO list to Notes/TODO.md on every TodoWrite"
+    },
+    {
+      "event": "UserPromptSubmit",
+      "command": "${PAI_DIR}/Hooks/cleanup-session-files.mjs",
+      "description": "Clean up stale temp files between user prompts"
+    }
+  ]
+}

package/plugins/productivity/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "pai-productivity",
+  "displayName": "PAI Productivity",
+  "description": "Planning, journaling, reviewing, research, and sharing workflows",
+  "version": "0.7.0",
+  "tier": "free",
+  "required": false,
+  "depends": ["core"],
+  "hooks": "hooks/hooks.json",
+  "skills": ["Plan", "Review", "Journal", "Research", "Share", "Createskill"]
+}

package/plugins/semantic-search/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "pai-semantic-search",
+  "displayName": "PAI Semantic Search",
+  "description": "Vector search with pgvector, cross-encoder reranking, hybrid mode, recency boost",
+  "version": "0.7.0",
+  "tier": "pro",
+  "required": false,
+  "depends": ["core"],
+  "features": [
+    "semantic_search_mode",
+    "hybrid_search_mode",
+    "cross_encoder_reranking",
+    "recency_boost",
+    "pgvector_storage"
+  ],
+  "requirements": {
+    "docker": true,
+    "postgresql": ">=15",
+    "pgvector": ">=0.5.0"
+  }
+}

package/plugins/ui/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "module": "ui",
+  "description": "Terminal tab titles, statusline updates, and visual feedback hooks",
+  "hooks": [
+    {
+      "event": "UserPromptSubmit",
+      "command": "${PAI_DIR}/Hooks/update-tab-titles.mjs",
+      "description": "Set terminal tab title from session context"
+    },
+    {
+      "event": "PostToolUse",
+      "matcher": "*",
+      "command": "${PAI_DIR}/Hooks/update-tab-on-action.mjs",
+      "description": "Update terminal tab title based on current tool activity"
+    }
+  ]
+}

package/plugins/ui/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "pai-ui",
+  "displayName": "PAI UI Customization",
+  "description": "Terminal tab titles, statusline, tab coloring, and visual customization",
+  "version": "0.7.0",
+  "tier": "free",
+  "required": false,
+  "depends": ["core"],
+  "hooks": "hooks/hooks.json",
+  "scripts": ["statusline-command.sh", "tab-color-command.sh"]
+}

package/plugins/zettelkasten/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "pai-zettelkasten",
+  "displayName": "PAI Zettelkasten Intelligence",
+  "description": "Luhmann-inspired vault intelligence with graph operations and Obsidian integration",
+  "version": "0.7.0",
+  "tier": "enterprise",
+  "required": false,
+  "depends": ["core", "semantic-search"],
+  "skills": ["VaultConnect", "VaultContext", "VaultEmerge", "VaultOrphans", "VaultTrace"],
+  "features": [
+    "vault_indexer",
+    "zettel_explore",
+    "zettel_surprise",
+    "zettel_converse",
+    "zettel_themes",
+    "zettel_health",
+    "zettel_suggest"
+  ]
+}

package/user-extensions/README.md

@@ -0,0 +1,87 @@
+# PAI User Extensions
+
+This directory is your personal extension point for PAI. Files here are gitignored
+and will never be overwritten by PAI updates.
+
+## Adding Custom Skills
+
+Create a skill directory with a SKILL.md file:
+
+```
+user-extensions/skills/MySkill/SKILL.md
+```
+
+SKILL.md format:
+
+```markdown
+---
+name: MySkill
+description: "What the skill does. USE WHEN user says 'trigger phrase'."
+---
+
+## My Skill Instructions
+
+Your skill content here...
+```
+
+After creating, run `bun run build` or `pai setup` to symlink it into
+`~/.claude/skills/` where Claude Code discovers it.
+
+## Adding Custom Hooks
+
+Create a TypeScript or shell hook:
+
+```
+user-extensions/hooks/my-hook.ts
+user-extensions/hooks/my-hook.sh
+```
+
+TypeScript hooks are compiled during `bun run build` and deployed to
+`~/.claude/Hooks/`. Shell hooks are symlinked directly.
+
+Hook input format (stdin JSON):
+```json
+{
+  "session_id": "...",
+  "transcript_path": "...",
+  "cwd": "...",
+  "hook_event_name": "SessionStart|PreToolUse|PostToolUse|Stop|..."
+}
+```
+
+After creating, register in `~/.claude/settings.json` under the appropriate
+hook event, or run `pai setup` to auto-register.
+
+## Adding Custom MCP Prompts
+
+Create a prompt file in the custom prompts directory:
+
+```
+src/daemon-mcp/prompts/custom/my-prompt.ts
+```
+
+Format:
+```typescript
+export const myPrompt = {
+  description: "What the prompt does",
+  content: `## My Prompt
+
+USE WHEN user says 'trigger phrase'...
+
+### Instructions
+Your prompt content here...`,
+};
+```
+
+Run `bun run build` to generate the skill stub and symlink.
+
+## Directory Structure
+
+```
+user-extensions/
+├── hooks/          # Custom hook scripts (.ts or .sh)
+│   └── .gitkeep
+├── skills/         # Custom skill directories (each with SKILL.md)
+│   └── .gitkeep
+└── README.md       # This file
+```