@tekmidian/pai 0.6.5 → 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/dist/hooks/capture-session-summary.mjs

@@ -73,7 +73,17 @@ async function main() {
     if (!input || input.trim() === "") {
       process.exit(0);
     }
-    const data = JSON.parse(input);
+    if (!process.env.__PAI_HOOK_BG) {
+      const { spawn } = await import("child_process");
+      const child = spawn(process.execPath, [process.argv[1], "--background"], {
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, __PAI_HOOK_BG: "1", __PAI_HOOK_INPUT: input }
+      });
+      child.unref();
+      process.exit(0);
+    }
+    const data = JSON.parse(process.env.__PAI_HOOK_INPUT || input);
     const now = /* @__PURE__ */ new Date();
     const timestamp = now.toISOString().replace(/:/g, "").replace(/\..+/, "").replace("T", "-");
     const yearMonth = timestamp.substring(0, 7);
@@ -99,7 +109,10 @@ async function analyzeSession(conversationId, yearMonth) {
   let toolsUsed = /* @__PURE__ */ new Set();
   try {
     if (existsSync2(rawOutputsDir)) {
-      const files = readdirSync(rawOutputsDir).filter((f) => f.endsWith(".jsonl"));
+      const todayPrefix = (/* @__PURE__ */ new Date()).toISOString().substring(0, 10);
+      const files = readdirSync(rawOutputsDir).filter(
+        (f) => f.endsWith(".jsonl") && f.startsWith(todayPrefix)
+      );
       for (const file of files) {
         const filePath = join2(rawOutputsDir, file);
         const content = readFileSync2(filePath, "utf-8");

package/dist/hooks/capture-session-summary.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/ts/session-end/capture-session-summary.ts", "../../src/hooks/ts/lib/pai-paths.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * SessionEnd Hook - Captures session summary for UOCS\n *\n * Generates a session summary document when a Claude Code session ends,\n * documenting what was accomplished during the session.\n */\n\nimport { writeFileSync, mkdirSync, existsSync, readFileSync, readdirSync } from 'fs';\nimport { join } from 'path';\nimport { PAI_DIR, HISTORY_DIR } from '../lib/pai-paths';\n\ninterface SessionData {\n  conversation_id: string;\n  timestamp: string;\n  [key: string]: any;\n}\n\nasync function main() {\n  try {\n    // Read input from stdin\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk);\n    }\n    const input = Buffer.concat(chunks).toString('utf-8');\n    if (!input || input.trim() === '') {\n      process.exit(0);\n    }\n\n    const data: SessionData = JSON.parse(input);\n\n    // Generate timestamp for filename\n    const now = new Date();\n    const timestamp = now.toISOString()\n      .replace(/:/g, '')\n      .replace(/\\..+/, '')\n      .replace('T', '-'); // YYYY-MM-DD-HHMMSS\n\n    const yearMonth = timestamp.substring(0, 7); // YYYY-MM\n\n    // Try to extract session info from raw outputs\n    const sessionInfo = await analyzeSession(data.conversation_id, yearMonth);\n\n    // Generate filename\n    const filename = `${timestamp}_SESSION_${sessionInfo.focus}.md`;\n\n    // Ensure directory exists\n    const sessionDir = join(HISTORY_DIR, 'sessions', yearMonth);\n    if (!existsSync(sessionDir)) {\n      mkdirSync(sessionDir, { recursive: true });\n    }\n\n    // Generate session document\n    const sessionDoc = formatSessionDocument(timestamp, data, sessionInfo);\n\n    // Write session file\n    writeFileSync(join(sessionDir, filename), sessionDoc);\n\n    // Also store structured summary via daemon IPC for the observations system\n    await storeStructuredSummary(data.conversation_id, sessionInfo);\n\n    // Exit successfully\n    process.exit(0);\n  } catch (error) {\n    // Silent failure - don't disrupt workflow\n    console.error(`[UOCS] SessionEnd hook error: ${error}`);\n    process.exit(0);\n  }\n}\n\nasync function analyzeSession(conversationId: string, yearMonth: string): Promise<any> {\n  // Try to read raw outputs for this session\n  const rawOutputsDir = join(HISTORY_DIR, 'raw-outputs', yearMonth);\n\n  let filesChanged: string[] = [];\n  let commandsExecuted: string[] = [];\n  let toolsUsed: Set<string> = new Set();\n\n  try {\n    if (existsSync(rawOutputsDir)) {\n      const files = readdirSync(rawOutputsDir).filter(f => f.endsWith('.jsonl'));\n\n      for (const file of files) {\n        const filePath = join(rawOutputsDir, file);\n        const content = readFileSync(filePath, 'utf-8');\n        const lines = content.split('\\n').filter(l => l.trim());\n\n        for (const line of lines) {\n          try {\n            const entry = JSON.parse(line);\n            if (entry.session === conversationId) {\n              toolsUsed.add(entry.tool);\n\n              // Extract file changes\n              if (entry.tool === 'Edit' || entry.tool === 'Write') {\n                if (entry.input?.file_path) {\n                  filesChanged.push(entry.input.file_path);\n                }\n              }\n\n              // Extract bash commands\n              if (entry.tool === 'Bash' && entry.input?.command) {\n                commandsExecuted.push(entry.input.command);\n              }\n            }\n          } catch (e) {\n            // Skip invalid JSON lines\n          }\n        }\n      }\n    }\n  } catch (error) {\n    // Silent failure\n  }\n\n  return {\n    focus: 'general-work',\n    filesChanged: [...new Set(filesChanged)].slice(0, 10), // Unique, max 10\n    commandsExecuted: commandsExecuted.slice(0, 10), // Max 10\n    toolsUsed: Array.from(toolsUsed),\n    duration: 0 // Unknown\n  };\n}\n\nfunction formatSessionDocument(timestamp: string, data: SessionData, info: any): string {\n  const date = timestamp.substring(0, 10); // YYYY-MM-DD\n  const time = timestamp.substring(11).replace(/-/g, ':'); // HH:MM:SS\n  const da = process.env.DA || 'PAI';\n\n  return `---\ncapture_type: SESSION\ntimestamp: ${new Date().toISOString()}\nsession_id: ${data.conversation_id}\nduration_minutes: ${info.duration}\nexecutor: ${da}\n---\n\n# Session: ${info.focus}\n\n**Date:** ${date}\n**Time:** ${time}\n**Session ID:** ${data.conversation_id}\n\n---\n\n## Session Overview\n\n**Focus:** General development work\n**Duration:** ${info.duration > 0 ? `${info.duration} minutes` : 'Unknown'}\n\n---\n\n## Tools Used\n\n${info.toolsUsed.length > 0 ? info.toolsUsed.map((t: string) => `- ${t}`).join('\\n') : '- None recorded'}\n\n---\n\n## Files Modified\n\n${info.filesChanged.length > 0 ? info.filesChanged.map((f: string) => `- \\`${f}\\``).join('\\n') : '- None recorded'}\n\n**Total Files Changed:** ${info.filesChanged.length}\n\n---\n\n## Commands Executed\n\n${info.commandsExecuted.length > 0 ? '```bash\\n' + info.commandsExecuted.join('\\n') + '\\n```' : 'None recorded'}\n\n---\n\n## Notes\n\nThis session summary was automatically generated by the UOCS SessionEnd hook.\n\nFor detailed tool outputs, see: \\`\\${PAI_DIR}/History/raw-outputs/${timestamp.substring(0, 7)}/\\`\n\n---\n\n**Session Outcome:** Completed\n**Generated:** ${new Date().toISOString()}\n`;\n}\n\nasync function storeStructuredSummary(\n  sessionId: string,\n  info: { focus: string; filesChanged: string[]; commandsExecuted: string[]; toolsUsed: string[]; duration: number }\n): Promise<void> {\n  try {\n    const cwd = process.cwd();\n    const net = await import('net');\n\n    await new Promise<void>((resolve, _reject) => {\n      const client = net.createConnection('/tmp/pai.sock', () => {\n        const msg = JSON.stringify({\n          id: 1,\n          method: 'session_summary_store',\n          params: {\n            session_id: sessionId,\n            cwd,\n            request: null,      // We don't have the original request\n            investigated: null,\n            learned: null,\n            completed: info.filesChanged.length > 0\n              ? `Modified ${info.filesChanged.length} file(s): ${info.filesChanged.slice(0, 5).join(', ')}`\n              : null,\n            next_steps: null,\n            observation_count: 0,   // Will be filled by daemon from actual count\n          }\n        }) + '\\n';\n        client.write(msg);\n      });\n\n      client.on('data', () => { client.end(); resolve(); });\n      client.on('error', () => resolve());  // Silent failure\n      setTimeout(() => { client.destroy(); resolve(); }, 3000);\n    });\n  } catch {\n    // Silent failure \u2014 don't disrupt session end\n  }\n}\n\nmain();\n", "/**\n * PAI Path Resolution - Single Source of Truth\n *\n * This module provides consistent path resolution across all PAI hooks.\n * It handles PAI_DIR detection whether set explicitly or defaulting to ~/.claude\n *\n * ALSO loads .env file from PAI_DIR so all hooks get environment variables\n * without relying on Claude Code's settings.json injection.\n *\n * Usage in hooks:\n *   import { PAI_DIR, HOOKS_DIR, SKILLS_DIR } from './lib/pai-paths';\n */\n\nimport { homedir } from 'os';\nimport { resolve, join } from 'path';\nimport { existsSync, readFileSync } from 'fs';\n\n/**\n * Load .env file and inject into process.env\n * Must run BEFORE PAI_DIR resolution so .env can set PAI_DIR if needed\n */\nfunction loadEnvFile(): void {\n  // Check common locations for .env\n  const possiblePaths = [\n    resolve(process.env.PAI_DIR || '', '.env'),\n    resolve(homedir(), '.claude', '.env'),\n  ];\n\n  for (const envPath of possiblePaths) {\n    if (existsSync(envPath)) {\n      try {\n        const content = readFileSync(envPath, 'utf-8');\n        for (const line of content.split('\\n')) {\n          const trimmed = line.trim();\n          // Skip comments and empty lines\n          if (!trimmed || trimmed.startsWith('#')) continue;\n\n          const eqIndex = trimmed.indexOf('=');\n          if (eqIndex > 0) {\n            const key = trimmed.substring(0, eqIndex).trim();\n            let value = trimmed.substring(eqIndex + 1).trim();\n\n            // Remove surrounding quotes if present\n            if ((value.startsWith('\"') && value.endsWith('\"')) ||\n                (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n              value = value.slice(1, -1);\n            }\n\n            // Expand $HOME and ~ in values\n            value = value.replace(/\\$HOME/g, homedir());\n            value = value.replace(/^~(?=\\/|$)/, homedir());\n\n            // Only set if not already defined (env vars take precedence)\n            if (process.env[key] === undefined) {\n              process.env[key] = value;\n            }\n          }\n        }\n        // Found and loaded, don't check other paths\n        break;\n      } catch {\n        // Silently continue if .env can't be read\n      }\n    }\n  }\n}\n\n// Load .env FIRST, before any other initialization\nloadEnvFile();\n\n/**\n * Smart PAI_DIR detection with fallback\n * Priority:\n * 1. PAI_DIR environment variable (if set)\n * 2. ~/.claude (standard location)\n */\nexport const PAI_DIR = process.env.PAI_DIR\n  ? resolve(process.env.PAI_DIR)\n  : resolve(homedir(), '.claude');\n\n/**\n * Common PAI directories\n */\nexport const HOOKS_DIR = join(PAI_DIR, 'Hooks');\nexport const SKILLS_DIR = join(PAI_DIR, 'Skills');\nexport const AGENTS_DIR = join(PAI_DIR, 'Agents');\nexport const HISTORY_DIR = join(PAI_DIR, 'History');\nexport const COMMANDS_DIR = join(PAI_DIR, 'Commands');\n\n/**\n * Validate PAI directory structure on first import\n * This fails fast with a clear error if PAI is misconfigured\n */\nfunction validatePAIStructure(): void {\n  if (!existsSync(PAI_DIR)) {\n    console.error(`PAI_DIR does not exist: ${PAI_DIR}`);\n    console.error(`   Expected ~/.claude or set PAI_DIR environment variable`);\n    process.exit(1);\n  }\n\n  if (!existsSync(HOOKS_DIR)) {\n    console.error(`PAI hooks directory not found: ${HOOKS_DIR}`);\n    console.error(`   Your PAI_DIR may be misconfigured`);\n    console.error(`   Current PAI_DIR: ${PAI_DIR}`);\n    process.exit(1);\n  }\n}\n\n// Run validation on module import\n// This ensures any hook that imports this module will fail fast if paths are wrong\nvalidatePAIStructure();\n\n/**\n * Helper to get history file path with date-based organization\n */\nexport function getHistoryFilePath(subdir: string, filename: string): string {\n  const now = new Date();\n  const tz = process.env.TIME_ZONE || Intl.DateTimeFormat().resolvedOptions().timeZone;\n  const localDate = new Date(now.toLocaleString('en-US', { timeZone: tz }));\n  const year = localDate.getFullYear();\n  const month = String(localDate.getMonth() + 1).padStart(2, '0');\n\n  return join(HISTORY_DIR, subdir, `${year}-${month}`, filename);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * SessionEnd Hook - Captures session summary for UOCS\n *\n * Generates a session summary document when a Claude Code session ends,\n * documenting what was accomplished during the session.\n */\n\nimport { writeFileSync, mkdirSync, existsSync, readFileSync, readdirSync } from 'fs';\nimport { join } from 'path';\nimport { PAI_DIR, HISTORY_DIR } from '../lib/pai-paths';\n\ninterface SessionData {\n  conversation_id: string;\n  timestamp: string;\n  [key: string]: any;\n}\n\nasync function main() {\n  try {\n    // Read input from stdin FIRST \u2014 this must complete before CC's abort signal fires.\n    // Then fork the heavy work into a detached child so CC can't kill it.\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk);\n    }\n    const input = Buffer.concat(chunks).toString('utf-8');\n    if (!input || input.trim() === '') {\n      process.exit(0);\n    }\n\n    // Fork: re-exec ourselves with --background flag and pipe the stdin data via env.\n    // This detaches the heavy work (JSONL scan, IPC) from CC's abort signal.\n    if (!process.env.__PAI_HOOK_BG) {\n      const { spawn } = await import('child_process');\n      const child = spawn(process.execPath, [process.argv[1], '--background'], {\n        detached: true,\n        stdio: 'ignore',\n        env: { ...process.env, __PAI_HOOK_BG: '1', __PAI_HOOK_INPUT: input },\n      });\n      child.unref();\n      process.exit(0); // Return immediately \u2014 CC sees success, abort signal is harmless\n    }\n\n    // Background mode: we're detached, safe from abort signals\n    const data: SessionData = JSON.parse(process.env.__PAI_HOOK_INPUT || input);\n\n    // Generate timestamp for filename\n    const now = new Date();\n    const timestamp = now.toISOString()\n      .replace(/:/g, '')\n      .replace(/\\..+/, '')\n      .replace('T', '-'); // YYYY-MM-DD-HHMMSS\n\n    const yearMonth = timestamp.substring(0, 7); // YYYY-MM\n\n    // Try to extract session info from raw outputs\n    const sessionInfo = await analyzeSession(data.conversation_id, yearMonth);\n\n    // Generate filename\n    const filename = `${timestamp}_SESSION_${sessionInfo.focus}.md`;\n\n    // Ensure directory exists\n    const sessionDir = join(HISTORY_DIR, 'sessions', yearMonth);\n    if (!existsSync(sessionDir)) {\n      mkdirSync(sessionDir, { recursive: true });\n    }\n\n    // Generate session document\n    const sessionDoc = formatSessionDocument(timestamp, data, sessionInfo);\n\n    // Write session file\n    writeFileSync(join(sessionDir, filename), sessionDoc);\n\n    // Also store structured summary via daemon IPC for the observations system\n    await storeStructuredSummary(data.conversation_id, sessionInfo);\n\n    // Exit successfully\n    process.exit(0);\n  } catch (error) {\n    // Silent failure - don't disrupt workflow\n    console.error(`[UOCS] SessionEnd hook error: ${error}`);\n    process.exit(0);\n  }\n}\n\nasync function analyzeSession(conversationId: string, yearMonth: string): Promise<any> {\n  // Try to read raw outputs for this session\n  const rawOutputsDir = join(HISTORY_DIR, 'raw-outputs', yearMonth);\n\n  let filesChanged: string[] = [];\n  let commandsExecuted: string[] = [];\n  let toolsUsed: Set<string> = new Set();\n\n  try {\n    if (existsSync(rawOutputsDir)) {\n      // Only scan today's file \u2014 not the entire month (which can be 400MB+).\n      // JSONL filenames are prefixed with YYYY-MM-DD.\n      const todayPrefix = new Date().toISOString().substring(0, 10);\n      const files = readdirSync(rawOutputsDir).filter(\n        f => f.endsWith('.jsonl') && f.startsWith(todayPrefix)\n      );\n\n      for (const file of files) {\n        const filePath = join(rawOutputsDir, file);\n        const content = readFileSync(filePath, 'utf-8');\n        const lines = content.split('\\n').filter(l => l.trim());\n\n        for (const line of lines) {\n          try {\n            const entry = JSON.parse(line);\n            if (entry.session === conversationId) {\n              toolsUsed.add(entry.tool);\n\n              // Extract file changes\n              if (entry.tool === 'Edit' || entry.tool === 'Write') {\n                if (entry.input?.file_path) {\n                  filesChanged.push(entry.input.file_path);\n                }\n              }\n\n              // Extract bash commands\n              if (entry.tool === 'Bash' && entry.input?.command) {\n                commandsExecuted.push(entry.input.command);\n              }\n            }\n          } catch (e) {\n            // Skip invalid JSON lines\n          }\n        }\n      }\n    }\n  } catch (error) {\n    // Silent failure\n  }\n\n  return {\n    focus: 'general-work',\n    filesChanged: [...new Set(filesChanged)].slice(0, 10), // Unique, max 10\n    commandsExecuted: commandsExecuted.slice(0, 10), // Max 10\n    toolsUsed: Array.from(toolsUsed),\n    duration: 0 // Unknown\n  };\n}\n\nfunction formatSessionDocument(timestamp: string, data: SessionData, info: any): string {\n  const date = timestamp.substring(0, 10); // YYYY-MM-DD\n  const time = timestamp.substring(11).replace(/-/g, ':'); // HH:MM:SS\n  const da = process.env.DA || 'PAI';\n\n  return `---\ncapture_type: SESSION\ntimestamp: ${new Date().toISOString()}\nsession_id: ${data.conversation_id}\nduration_minutes: ${info.duration}\nexecutor: ${da}\n---\n\n# Session: ${info.focus}\n\n**Date:** ${date}\n**Time:** ${time}\n**Session ID:** ${data.conversation_id}\n\n---\n\n## Session Overview\n\n**Focus:** General development work\n**Duration:** ${info.duration > 0 ? `${info.duration} minutes` : 'Unknown'}\n\n---\n\n## Tools Used\n\n${info.toolsUsed.length > 0 ? info.toolsUsed.map((t: string) => `- ${t}`).join('\\n') : '- None recorded'}\n\n---\n\n## Files Modified\n\n${info.filesChanged.length > 0 ? info.filesChanged.map((f: string) => `- \\`${f}\\``).join('\\n') : '- None recorded'}\n\n**Total Files Changed:** ${info.filesChanged.length}\n\n---\n\n## Commands Executed\n\n${info.commandsExecuted.length > 0 ? '```bash\\n' + info.commandsExecuted.join('\\n') + '\\n```' : 'None recorded'}\n\n---\n\n## Notes\n\nThis session summary was automatically generated by the UOCS SessionEnd hook.\n\nFor detailed tool outputs, see: \\`\\${PAI_DIR}/History/raw-outputs/${timestamp.substring(0, 7)}/\\`\n\n---\n\n**Session Outcome:** Completed\n**Generated:** ${new Date().toISOString()}\n`;\n}\n\nasync function storeStructuredSummary(\n  sessionId: string,\n  info: { focus: string; filesChanged: string[]; commandsExecuted: string[]; toolsUsed: string[]; duration: number }\n): Promise<void> {\n  try {\n    const cwd = process.cwd();\n    const net = await import('net');\n\n    await new Promise<void>((resolve, _reject) => {\n      const client = net.createConnection('/tmp/pai.sock', () => {\n        const msg = JSON.stringify({\n          id: 1,\n          method: 'session_summary_store',\n          params: {\n            session_id: sessionId,\n            cwd,\n            request: null,      // We don't have the original request\n            investigated: null,\n            learned: null,\n            completed: info.filesChanged.length > 0\n              ? `Modified ${info.filesChanged.length} file(s): ${info.filesChanged.slice(0, 5).join(', ')}`\n              : null,\n            next_steps: null,\n            observation_count: 0,   // Will be filled by daemon from actual count\n          }\n        }) + '\\n';\n        client.write(msg);\n      });\n\n      client.on('data', () => { client.end(); resolve(); });\n      client.on('error', () => resolve());  // Silent failure\n      setTimeout(() => { client.destroy(); resolve(); }, 3000);\n    });\n  } catch {\n    // Silent failure \u2014 don't disrupt session end\n  }\n}\n\nmain();\n", "/**\n * PAI Path Resolution - Single Source of Truth\n *\n * This module provides consistent path resolution across all PAI hooks.\n * It handles PAI_DIR detection whether set explicitly or defaulting to ~/.claude\n *\n * ALSO loads .env file from PAI_DIR so all hooks get environment variables\n * without relying on Claude Code's settings.json injection.\n *\n * Usage in hooks:\n *   import { PAI_DIR, HOOKS_DIR, SKILLS_DIR } from './lib/pai-paths';\n */\n\nimport { homedir } from 'os';\nimport { resolve, join } from 'path';\nimport { existsSync, readFileSync } from 'fs';\n\n/**\n * Load .env file and inject into process.env\n * Must run BEFORE PAI_DIR resolution so .env can set PAI_DIR if needed\n */\nfunction loadEnvFile(): void {\n  // Check common locations for .env\n  const possiblePaths = [\n    resolve(process.env.PAI_DIR || '', '.env'),\n    resolve(homedir(), '.claude', '.env'),\n  ];\n\n  for (const envPath of possiblePaths) {\n    if (existsSync(envPath)) {\n      try {\n        const content = readFileSync(envPath, 'utf-8');\n        for (const line of content.split('\\n')) {\n          const trimmed = line.trim();\n          // Skip comments and empty lines\n          if (!trimmed || trimmed.startsWith('#')) continue;\n\n          const eqIndex = trimmed.indexOf('=');\n          if (eqIndex > 0) {\n            const key = trimmed.substring(0, eqIndex).trim();\n            let value = trimmed.substring(eqIndex + 1).trim();\n\n            // Remove surrounding quotes if present\n            if ((value.startsWith('\"') && value.endsWith('\"')) ||\n                (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n              value = value.slice(1, -1);\n            }\n\n            // Expand $HOME and ~ in values\n            value = value.replace(/\\$HOME/g, homedir());\n            value = value.replace(/^~(?=\\/|$)/, homedir());\n\n            // Only set if not already defined (env vars take precedence)\n            if (process.env[key] === undefined) {\n              process.env[key] = value;\n            }\n          }\n        }\n        // Found and loaded, don't check other paths\n        break;\n      } catch {\n        // Silently continue if .env can't be read\n      }\n    }\n  }\n}\n\n// Load .env FIRST, before any other initialization\nloadEnvFile();\n\n/**\n * Smart PAI_DIR detection with fallback\n * Priority:\n * 1. PAI_DIR environment variable (if set)\n * 2. ~/.claude (standard location)\n */\nexport const PAI_DIR = process.env.PAI_DIR\n  ? resolve(process.env.PAI_DIR)\n  : resolve(homedir(), '.claude');\n\n/**\n * Common PAI directories\n */\nexport const HOOKS_DIR = join(PAI_DIR, 'Hooks');\nexport const SKILLS_DIR = join(PAI_DIR, 'Skills');\nexport const AGENTS_DIR = join(PAI_DIR, 'Agents');\nexport const HISTORY_DIR = join(PAI_DIR, 'History');\nexport const COMMANDS_DIR = join(PAI_DIR, 'Commands');\n\n/**\n * Validate PAI directory structure on first import\n * This fails fast with a clear error if PAI is misconfigured\n */\nfunction validatePAIStructure(): void {\n  if (!existsSync(PAI_DIR)) {\n    console.error(`PAI_DIR does not exist: ${PAI_DIR}`);\n    console.error(`   Expected ~/.claude or set PAI_DIR environment variable`);\n    process.exit(1);\n  }\n\n  if (!existsSync(HOOKS_DIR)) {\n    console.error(`PAI hooks directory not found: ${HOOKS_DIR}`);\n    console.error(`   Your PAI_DIR may be misconfigured`);\n    console.error(`   Current PAI_DIR: ${PAI_DIR}`);\n    process.exit(1);\n  }\n}\n\n// Run validation on module import\n// This ensures any hook that imports this module will fail fast if paths are wrong\nvalidatePAIStructure();\n\n/**\n * Helper to get history file path with date-based organization\n */\nexport function getHistoryFilePath(subdir: string, filename: string): string {\n  const now = new Date();\n  const tz = process.env.TIME_ZONE || Intl.DateTimeFormat().resolvedOptions().timeZone;\n  const localDate = new Date(now.toLocaleString('en-US', { timeZone: tz }));\n  const year = localDate.getFullYear();\n  const month = String(localDate.getMonth() + 1).padStart(2, '0');\n\n  return join(HISTORY_DIR, subdir, `${year}-${month}`, filename);\n}\n"],
+  "mappings": "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",
   "names": ["existsSync", "readFileSync", "join", "join", "existsSync", "readFileSync", "resolve"]
 }

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.5",
+  "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/src/hooks/ts/session-end/capture-session-summary.ts

@@ -19,7 +19,8 @@ interface SessionData {
 
 async function main() {
   try {
-    // Read input from stdin
+    // Read input from stdin FIRST — this must complete before CC's abort signal fires.
+    // Then fork the heavy work into a detached child so CC can't kill it.
     const chunks: Buffer[] = [];
     for await (const chunk of process.stdin) {
       chunks.push(chunk);
@@ -29,7 +30,21 @@ async function main() {
       process.exit(0);
     }
 
-    const data: SessionData = JSON.parse(input);
+    // Fork: re-exec ourselves with --background flag and pipe the stdin data via env.
+    // This detaches the heavy work (JSONL scan, IPC) from CC's abort signal.
+    if (!process.env.__PAI_HOOK_BG) {
+      const { spawn } = await import('child_process');
+      const child = spawn(process.execPath, [process.argv[1], '--background'], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, __PAI_HOOK_BG: '1', __PAI_HOOK_INPUT: input },
+      });
+      child.unref();
+      process.exit(0); // Return immediately — CC sees success, abort signal is harmless
+    }
+
+    // Background mode: we're detached, safe from abort signals
+    const data: SessionData = JSON.parse(process.env.__PAI_HOOK_INPUT || input);
 
     // Generate timestamp for filename
     const now = new Date();
@@ -80,7 +95,12 @@ async function analyzeSession(conversationId: string, yearMonth: string): Promis
 
   try {
     if (existsSync(rawOutputsDir)) {
-      const files = readdirSync(rawOutputsDir).filter(f => f.endsWith('.jsonl'));
+      // Only scan today's file — not the entire month (which can be 400MB+).
+      // JSONL filenames are prefixed with YYYY-MM-DD.
+      const todayPrefix = new Date().toISOString().substring(0, 10);
+      const files = readdirSync(rawOutputsDir).filter(
+        f => f.endsWith('.jsonl') && f.startsWith(todayPrefix)
+      );
 
       for (const file of files) {
         const filePath = join(rawOutputsDir, file);

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
+```