@tekmidian/pai 0.59.0 → 0.60.1

package/plugins/core/hooks/hooks.json

@@ -1,49 +1,54 @@
 {
-  "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": "SessionStart",
-      "matcher": "resume|compact",
-      "command": "${PAI_DIR}/Hooks/mcp-deferred-reminder.mjs",
-      "description": "Heal stale deferred MCP tool handles on resumed sessions: ToolSearch-and-retry instead of trusting a stale disconnect conclusion"
-    },
-    {
-      "event": "PreToolUse",
-      "matcher": "Bash",
-      "command": "${PAI_DIR}/Hooks/security-validator.mjs",
-      "description": "Validate shell commands against security rules before execution"
-    },
-    {
-      "event": "PreToolUse",
-      "matcher": "mcp__",
-      "command": "${PAI_DIR}/Hooks/mcp-deferred-gate.mjs",
-      "description": "Correct deferred MCP tool calls: ToolSearch remedy instead of a false 'MCP server disconnected' report"
-    },
-    {
-      "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"
-    }
-  ]
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/load-core-context.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/load-project-context.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/initialize-session.mjs" }
+        ]
+      },
+      {
+        "matcher": "resume|compact",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/mcp-deferred-reminder.mjs" }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/security-validator.mjs" }
+        ]
+      },
+      {
+        "matcher": "mcp__",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/mcp-deferred-gate.mjs" }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/stop-hook.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/pai-session-stop.sh" }
+        ]
+      }
+    ]
+  }
 }

package/plugins/core/plugin.json

@@ -3,8 +3,5 @@
   "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"]
+  "hooks": "./hooks/hooks.json"
 }

package/plugins/creative/plugin.json

@@ -2,9 +2,5 @@
   "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"]
+  "version": "0.7.0"
 }

package/plugins/observability/hooks/hooks.json

@@ -1,75 +1,90 @@
 {
-  "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"
-    }
-  ]
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SessionStart" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/inject-observations.mjs" }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type UserPromptSubmit" }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PreToolUse" }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PostToolUse" }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/observe.mjs" }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-tool-output.mjs" }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type Stop" }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/subagent-stop-hook.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SubagentStop" }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-session-summary.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type SessionEnd" }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/capture-all-events.mjs --event-type PreCompact" }
+        ]
+      }
+    ]
+  }
 }

package/plugins/observability/plugin.json

@@ -3,9 +3,5 @@
   "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"]
+  "hooks": "./hooks/hooks.json"
 }

package/plugins/productivity/hooks/hooks.json

@@ -1,22 +1,25 @@
 {
-  "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"
-    },
-    {
-      "event": "UserPromptSubmit",
-      "command": "${PAI_DIR}/Hooks/worker-supervision.mjs",
-      "description": "Surface daemon worker supervision events (finished/failed/stalled) for this session's workers"
-    }
-  ]
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/sync-todo-to-md.mjs" }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/cleanup-session-files.mjs" }
+        ]
+      },
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/worker-supervision.mjs" }
+        ]
+      }
+    ]
+  }
 }

package/plugins/productivity/plugin.json

@@ -3,9 +3,6 @@
   "displayName": "PAI Productivity",
   "description": "Planning, journaling, reviewing, research, sharing, and cross-session task routing",
   "version": "0.7.0",
-  "tier": "free",
-  "required": false,
-  "depends": ["core"],
-  "hooks": "hooks/hooks.json",
-  "skills": ["Plan", "Review", "Journal", "Research", "Share", "Createskill", "Reconstruct", "Tasks"]
+  "hooks": "./hooks/hooks.json",
+  "skills": ["./skills/"]
 }

package/plugins/semantic-search/plugin.json

@@ -2,20 +2,5 @@
   "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"
-  }
+  "version": "0.7.0"
 }

package/plugins/ui/hooks/hooks.json

@@ -1,17 +1,20 @@
 {
-  "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"
-    }
-  ]
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/update-tab-titles.mjs" }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "${PAI_DIR}/Hooks/update-tab-on-action.mjs" }
+        ]
+      }
+    ]
+  }
 }

package/plugins/ui/plugin.json

@@ -3,9 +3,5 @@
   "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"]
+  "hooks": "./hooks/hooks.json"
 }

package/plugins/zettelkasten/plugin.json

@@ -2,18 +2,5 @@
   "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"
-  ]
+  "version": "0.7.0"
 }

package/src/hooks/session-autosave.sh

@@ -31,8 +31,10 @@ SENTINEL="${TMPDIR:-/tmp}/pai-autosave-hook-${SENTINEL_KEY}"
 
 if [ -f "$SENTINEL" ]; then
   NOW=$(date +%s)
-  # stat is not portable: BSD/macOS uses -f %m, GNU/Linux uses -c %Y.
-  LAST=$(stat -f %m "$SENTINEL" 2>/dev/null || stat -c %Y "$SENTINEL" 2>/dev/null || echo 0)
+  # stat is not portable: GNU/Linux uses -c %Y, BSD/macOS uses -f %m. GNU
+  # first — BSD's `-f %m` reads as "filesystem status" on GNU and silently
+  # succeeds on the wrong thing instead of failing over.
+  LAST=$(stat -c %Y "$SENTINEL" 2>/dev/null || stat -f %m "$SENTINEL" 2>/dev/null || echo 0)
   if [ $((NOW - LAST)) -lt "$MIN_GAP_SECONDS" ]; then
     exit 0
   fi

package/src/hooks/session-stop.sh

@@ -68,7 +68,7 @@ OLD_LOCK_DIR="$HOME/.config/pai/.session-stop.lock"
 mkdir -p "$(dirname "$LOCK_DIR")" 2>/dev/null || true
 
 if [ -d "$OLD_LOCK_DIR" ] && [ ! -d "$LOCK_DIR" ]; then
-  OLD_LOCK_AGE=$(( $(date +%s) - $(stat -f %m "$OLD_LOCK_DIR" 2>/dev/null || echo 0) ))
+  OLD_LOCK_AGE=$(( $(date +%s) - $(stat -c %Y "$OLD_LOCK_DIR" 2>/dev/null || stat -f %m "$OLD_LOCK_DIR" 2>/dev/null || echo 0) ))
   if [ "$OLD_LOCK_AGE" -le 600 ]; then
     echo "pai: honoring in-flight lock at old location $OLD_LOCK_DIR" >&2
     LOCK_DIR="$OLD_LOCK_DIR"
@@ -78,7 +78,7 @@ fi
 # A crashed run must not wedge this forever: treat a lock older than 10 minutes
 # as abandoned. Longer than any observed tail, shorter than a working session.
 if [ -d "$LOCK_DIR" ]; then
-  LOCK_AGE=$(( $(date +%s) - $(stat -f %m "$LOCK_DIR" 2>/dev/null || echo 0) ))
+  LOCK_AGE=$(( $(date +%s) - $(stat -c %Y "$LOCK_DIR" 2>/dev/null || stat -f %m "$LOCK_DIR" 2>/dev/null || echo 0) ))
   [ "$LOCK_AGE" -gt 600 ] && rmdir "$LOCK_DIR" 2>/dev/null
 fi
 

package/src/hooks/ts/capture-all-events.ts

@@ -8,9 +8,9 @@
 
 import { readFileSync, appendFileSync, mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
-import { historyDir, agentSessionsPath } from './lib/pai-paths';
-import { enrichEventWithAgentMetadata, isAgentSpawningCall } from './lib/metadata-extraction';
-import { isProbeSession } from './lib/project-utils';
+import { historyDir, agentSessionsPath } from './lib/pai-paths.js';
+import { enrichEventWithAgentMetadata, isAgentSpawningCall } from './lib/metadata-extraction.js';
+import { isProbeSession } from './lib/project-utils.js';
 import { writeJsonAtomic } from '../../config/json-store.js';
 
 interface HookEvent {

package/src/hooks/ts/lib/metadata-extraction.ts

@@ -52,10 +52,11 @@ export function extractAgentInstanceId(
   if (!result.agent_instance_id && toolInput?.prompt && typeof toolInput.prompt === 'string') {
     const promptMatch = toolInput.prompt.match(/\[AGENT_INSTANCE:\s*([^\]]+)\]/);
     if (promptMatch) {
-      result.agent_instance_id = promptMatch[1].trim();
+      const agentInstanceId = promptMatch[1].trim();
+      result.agent_instance_id = agentInstanceId;
 
       // Parse agent type and instance number from ID
-      const parts = result.agent_instance_id.match(/^([a-z-]+)-(\d+)$/);
+      const parts = agentInstanceId.match(/^([a-z-]+)-(\d+)$/);
       if (parts) {
         result.agent_type = parts[1];
         result.instance_number = parseInt(parts[2], 10);

package/src/hooks/ts/lib/pai-paths.test.ts

@@ -28,7 +28,7 @@ function resetNoticeFlag(): void {
 }
 
 function deprecationLines(writeSpy: ReturnType<typeof vi.spyOn>): string[] {
-  return writeSpy.mock.calls.map((c) => String(c[0])).filter((line) => line.includes("PAI_DIR is deprecated"));
+  return writeSpy.mock.calls.map((c: unknown[]) => String(c[0])).filter((line: string) => line.includes("PAI_DIR is deprecated"));
 }
 
 beforeEach(() => {

package/src/hooks/ts/lib/sleep-poll-gate.test.ts

@@ -0,0 +1,62 @@
+import { describe, it, expect } from "vitest";
+import { decideSleepPollGate, renderDecision, type SleepPollGateInput } from "./sleep-poll-gate.js";
+
+function decisionOf(input: SleepPollGateInput, env: Record<string, string | undefined> = {}) {
+  return JSON.parse(renderDecision(decideSleepPollGate(input, env))).hookSpecificOutput;
+}
+
+function bash(command: string, run_in_background?: boolean): SleepPollGateInput {
+  return { tool_name: "Bash", tool_input: { command, ...(run_in_background !== undefined ? { run_in_background } : {}) } };
+}
+
+describe("sleep-poll gate", () => {
+  it("denies a long sleep, standalone or buried in a compound command", () => {
+    for (const cmd of [
+      "sleep 590",
+      "sleep 2m",
+      "cd x && sleep 300",
+      "sleep 120; tail -5 f",
+      "while true; do sleep 90; done",
+      "for i in 1 2; do sleep 61; done",
+    ]) {
+      const out = decisionOf(bash(cmd));
+      expect(out.permissionDecision).toBe("deny");
+      expect(out.hookEventName).toBe("PreToolUse");
+      expect(out.permissionDecisionReason).toContain("do not sleep-poll");
+    }
+  });
+
+  it("allows a short sleep or a sleep lookalike", () => {
+    for (const cmd of ["sleep 30", "sleep 59; tail f", "echo sleep 500", "grep sleep file", "timeout 600 make"]) {
+      expect(decisionOf(bash(cmd)).permissionDecision).toBe("allow");
+    }
+  });
+
+  it("allows any command when run_in_background is true — a backgrounded sleep blocks nothing", () => {
+    expect(decisionOf(bash("sleep 590", true)).permissionDecision).toBe("allow");
+  });
+
+  it("lets a non-Bash tool through untouched", () => {
+    expect(
+      decisionOf({ tool_name: "Write", tool_input: { command: "sleep 590" } } as unknown as SleepPollGateInput)
+        .permissionDecision
+    ).toBe("allow");
+  });
+
+  it("interactive session: deny reason points at run_in_background and a bounded loop", () => {
+    const out = decisionOf(bash("sleep 590"), {});
+    expect(out.permissionDecisionReason).toContain("run_in_background: true");
+    expect(out.permissionDecisionReason).toContain("bounded loop under 60s");
+  });
+
+  it("worker session (PAI_WORKER=1): deny reason points at a foreground timeout and a kill -0 loop instead", () => {
+    const out = decisionOf(bash("sleep 590"), { PAI_WORKER: "1" });
+    expect(out.permissionDecisionReason).toContain("FOREGROUND with a Bash timeout up to 600000 ms");
+    expect(out.permissionDecisionReason).toContain("while kill -0 <pid> 2>/dev/null; do sleep 15; done");
+    expect(out.permissionDecisionReason).not.toContain("run_in_background: true");
+  });
+
+  it("names the exact offending duration in the reason", () => {
+    expect(decisionOf(bash("sleep 2m")).permissionDecisionReason).toContain("sleep 120s blocked");
+  });
+});