@tekmidian/pai 0.6.6 → 0.7.1

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/lib/project-utils/session-notes.ts

@@ -215,6 +215,21 @@ export function sanitizeForFilename(str: string): string {
     .substring(0, 50);
 }
 
+/**
+ * Return true if the candidate string should be rejected as a meaningful name.
+ * Rejects file paths, shebangs, timestamps, and "[object Object]" artifacts.
+ */
+function isMeaninglessCandidate(text: string): boolean {
+  const t = text.trim();
+  if (!t) return true;
+  if (t.startsWith('/')) return true;                          // file path
+  if (t.startsWith('#!')) return true;                         // shebang
+  if (t.includes('[object Object]')) return true;              // serialization artifact
+  if (/^\d{4}-\d{2}-\d{2}(T[\d:.Z+-]+)?$/.test(t)) return true; // ISO timestamp
+  if (/^\d{1,2}:\d{2}(:\d{2})?(\s*(AM|PM))?$/i.test(t)) return true; // time-only
+  return false;
+}
+
 /**
  * Extract a meaningful name from session note content and summary.
  * Looks at Work Done section headers, bold text, and summary.
@@ -228,7 +243,7 @@ export function extractMeaningfulName(noteContent: string, summary: string): str
     const subheadings = workDoneSection.match(/### ([^\n]+)/g);
     if (subheadings && subheadings.length > 0) {
       const firstHeading = subheadings[0].replace('### ', '').trim();
-      if (firstHeading.length > 5 && firstHeading.length < 60) {
+      if (!isMeaninglessCandidate(firstHeading) && firstHeading.length > 5 && firstHeading.length < 60) {
         return sanitizeForFilename(firstHeading);
       }
     }
@@ -236,23 +251,27 @@ export function extractMeaningfulName(noteContent: string, summary: string): str
     const boldMatches = workDoneSection.match(/\*\*([^*]+)\*\*/g);
     if (boldMatches && boldMatches.length > 0) {
       const firstBold = boldMatches[0].replace(/\*\*/g, '').trim();
-      if (firstBold.length > 3 && firstBold.length < 50) {
+      if (!isMeaninglessCandidate(firstBold) && firstBold.length > 3 && firstBold.length < 50) {
         return sanitizeForFilename(firstBold);
       }
     }
 
     const numberedItems = workDoneSection.match(/^\d+\.\s+\*\*([^*]+)\*\*/m);
-    if (numberedItems) return sanitizeForFilename(numberedItems[1]);
+    if (numberedItems && !isMeaninglessCandidate(numberedItems[1])) {
+      return sanitizeForFilename(numberedItems[1]);
+    }
   }
 
-  if (summary && summary.length > 5 && summary !== 'Session completed.') {
+  if (summary && summary.length > 5 && summary !== 'Session completed.' && !isMeaninglessCandidate(summary)) {
     const cleanSummary = summary
       .replace(/[^\w\s-]/g, ' ')
       .trim()
       .split(/\s+/)
       .slice(0, 5)
       .join(' ');
-    if (cleanSummary.length > 3) return sanitizeForFilename(cleanSummary);
+    if (cleanSummary.length > 3 && !isMeaninglessCandidate(cleanSummary)) {
+      return sanitizeForFilename(cleanSummary);
+    }
   }
 
   return '';

package/src/hooks/ts/session-start/load-project-context.ts

@@ -239,36 +239,20 @@ async function main() {
   if (notesDir) {  // notesDir is always set now (local or central)
     const currentNotePath = getCurrentNotePath(notesDir);
 
-    // Determine if we need a new note
-    let needsNewNote = false;
+    // Only create a new note if there is truly no note at all.
+    // A completed note is still used — it will be updated or continued.
+    // This prevents duplicate notes at month boundaries and on every compaction.
     if (!currentNotePath) {
-      needsNewNote = true;
+      // Defensive: ensure projectName is a usable string
+      const safeProjectName = (typeof projectName === 'string' && projectName.trim().length > 0)
+        ? projectName.trim()
+        : 'Untitled Session';
       console.error('\nNo previous session notes found - creating new one');
-    } else {
-      // Check if the existing note is completed
-      try {
-        const content = readFileSync(currentNotePath, 'utf-8');
-        if (content.includes('**Status:** Completed') || content.includes('**Completed:**')) {
-          needsNewNote = true;
-          console.error(`\nPrevious note completed - creating new one`);
-          const summaryMatch = content.match(/## Next Steps\n\n([^\n]+)/);
-          if (summaryMatch) {
-            console.error(`   Previous: ${summaryMatch[1].substring(0, 60)}...`);
-          }
-        } else {
-          console.error(`\nContinuing session note: ${basename(currentNotePath)}`);
-        }
-      } catch {
-        needsNewNote = true;
-      }
-    }
-
-    // Create new note if needed
-    if (needsNewNote) {
-      activeNotePath = createSessionNote(notesDir, projectName);
+      activeNotePath = createSessionNote(notesDir, String(safeProjectName));
       console.error(`Created: ${basename(activeNotePath)}`);
     } else {
       activeNotePath = currentNotePath!;
+      console.error(`\nUsing existing session note: ${basename(activeNotePath)}`);
       // Show preview of current note
       try {
         const content = readFileSync(activeNotePath, 'utf-8');