@tekmidian/pai 0.3.1 → 0.4.0

package/dist/hooks/initialize-session.mjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/hooks/ts/session-start/initialize-session.ts
+import { existsSync as existsSync3, statSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
+import { tmpdir } from "os";
+
+// src/hooks/ts/lib/pai-paths.ts
+import { homedir } from "os";
+import { resolve, join } from "path";
+import { existsSync, readFileSync } from "fs";
+function loadEnvFile() {
+  const possiblePaths = [
+    resolve(process.env.PAI_DIR || "", ".env"),
+    resolve(homedir(), ".claude", ".env")
+  ];
+  for (const envPath of possiblePaths) {
+    if (existsSync(envPath)) {
+      try {
+        const content = readFileSync(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+          const trimmed = line.trim();
+          if (!trimmed || trimmed.startsWith("#")) continue;
+          const eqIndex = trimmed.indexOf("=");
+          if (eqIndex > 0) {
+            const key = trimmed.substring(0, eqIndex).trim();
+            let value = trimmed.substring(eqIndex + 1).trim();
+            if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+              value = value.slice(1, -1);
+            }
+            value = value.replace(/\$HOME/g, homedir());
+            value = value.replace(/^~(?=\/|$)/, homedir());
+            if (process.env[key] === void 0) {
+              process.env[key] = value;
+            }
+          }
+        }
+        break;
+      } catch {
+      }
+    }
+  }
+}
+loadEnvFile();
+var PAI_DIR = process.env.PAI_DIR ? resolve(process.env.PAI_DIR) : resolve(homedir(), ".claude");
+var HOOKS_DIR = join(PAI_DIR, "Hooks");
+var SKILLS_DIR = join(PAI_DIR, "Skills");
+var AGENTS_DIR = join(PAI_DIR, "Agents");
+var HISTORY_DIR = join(PAI_DIR, "History");
+var COMMANDS_DIR = join(PAI_DIR, "Commands");
+function validatePAIStructure() {
+  if (!existsSync(PAI_DIR)) {
+    console.error(`PAI_DIR does not exist: ${PAI_DIR}`);
+    console.error(`   Expected ~/.claude or set PAI_DIR environment variable`);
+    process.exit(1);
+  }
+  if (!existsSync(HOOKS_DIR)) {
+    console.error(`PAI hooks directory not found: ${HOOKS_DIR}`);
+    console.error(`   Your PAI_DIR may be misconfigured`);
+    console.error(`   Current PAI_DIR: ${PAI_DIR}`);
+    process.exit(1);
+  }
+}
+validatePAIStructure();
+
+// src/hooks/ts/lib/project-utils.ts
+import { existsSync as existsSync2, mkdirSync, readdirSync, readFileSync as readFileSync2, writeFileSync, renameSync } from "fs";
+import { join as join2, basename } from "path";
+var PROJECTS_DIR = join2(PAI_DIR, "projects");
+function isWhatsAppEnabled() {
+  try {
+    const { homedir: homedir2 } = __require("os");
+    const settingsPath = join2(homedir2(), ".claude", "settings.json");
+    if (!existsSync2(settingsPath)) return false;
+    const settings = JSON.parse(readFileSync2(settingsPath, "utf-8"));
+    const enabled = settings.enabledMcpjsonServers || [];
+    return enabled.includes("whazaa");
+  } catch {
+    return false;
+  }
+}
+async function sendNtfyNotification(message, retries = 2) {
+  if (isWhatsAppEnabled()) {
+    console.error(`WhatsApp (Whazaa) enabled in MCP config \u2014 skipping ntfy`);
+    return true;
+  }
+  const topic = process.env.NTFY_TOPIC;
+  if (!topic) {
+    console.error("NTFY_TOPIC not set and WhatsApp not active \u2014 notifications disabled");
+    return false;
+  }
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const response = await fetch(`https://ntfy.sh/${topic}`, {
+        method: "POST",
+        body: message,
+        headers: {
+          "Title": "Claude Code",
+          "Priority": "default"
+        }
+      });
+      if (response.ok) {
+        console.error(`ntfy.sh notification sent (WhatsApp inactive): "${message}"`);
+        return true;
+      } else {
+        console.error(`ntfy.sh attempt ${attempt + 1} failed: ${response.status}`);
+      }
+    } catch (error) {
+      console.error(`ntfy.sh attempt ${attempt + 1} error: ${error}`);
+    }
+    if (attempt < retries) {
+      await new Promise((resolve2) => setTimeout(resolve2, 1e3));
+    }
+  }
+  console.error("ntfy.sh notification failed after all retries");
+  return false;
+}
+
+// src/hooks/ts/session-start/initialize-session.ts
+var DEBOUNCE_MS = 2e3;
+var LOCKFILE = join3(tmpdir(), "pai-session-start.lock");
+function shouldDebounce() {
+  try {
+    if (existsSync3(LOCKFILE)) {
+      const lockContent = readFileSync3(LOCKFILE, "utf-8");
+      const lockTime = parseInt(lockContent, 10);
+      const now = Date.now();
+      if (now - lockTime < DEBOUNCE_MS) {
+        return true;
+      }
+    }
+    writeFileSync2(LOCKFILE, Date.now().toString());
+    return false;
+  } catch (error) {
+    try {
+      writeFileSync2(LOCKFILE, Date.now().toString());
+    } catch {
+    }
+    return false;
+  }
+}
+async function testStopHook() {
+  const stopHookPath = join3(PAI_DIR, "hooks/stop-hook.ts");
+  console.error("\nTesting stop-hook configuration...");
+  if (!existsSync3(stopHookPath)) {
+    console.error("Stop-hook NOT FOUND at:", stopHookPath);
+    return false;
+  }
+  try {
+    const stats = statSync(stopHookPath);
+    const isExecutable = (stats.mode & 73) !== 0;
+    if (!isExecutable) {
+      console.error("Stop-hook exists but is NOT EXECUTABLE");
+      return false;
+    }
+    console.error("Stop-hook found and is executable");
+    const daName = process.env.DA || "AI Assistant";
+    const tabTitle = `${daName} Ready`;
+    process.stderr.write(`\x1B]0;${tabTitle}\x07`);
+    process.stderr.write(`\x1B]2;${tabTitle}\x07`);
+    process.stderr.write(`\x1B]30;${tabTitle}\x07`);
+    console.error(`Set initial tab title: "${tabTitle}"`);
+    return true;
+  } catch (e) {
+    console.error("Error checking stop-hook:", e);
+    return false;
+  }
+}
+async function main() {
+  try {
+    const claudeProjectDir = process.env.CLAUDE_PROJECT_DIR || "";
+    const isSubagent = claudeProjectDir.includes("/.claude/agents/") || process.env.CLAUDE_AGENT_TYPE !== void 0;
+    if (isSubagent) {
+      console.error("Subagent session detected - skipping session initialization");
+      process.exit(0);
+    }
+    if (shouldDebounce()) {
+      console.error("Debouncing duplicate SessionStart event");
+      process.exit(0);
+    }
+    if (isWhatsAppEnabled()) {
+      console.error("WhatsApp (Whazaa) enabled in MCP config");
+      console.log(`<system-reminder>
+WHATSAPP MODE ACTIVE \u2014 Whazaa MCP server is enabled. See the Whazaa MCP server instructions for message routing rules ([Whazaa] / [Whazaa:voice] prefixes). ntfy.sh is automatically skipped.
+</system-reminder>`);
+    }
+    const stopHookOk = await testStopHook();
+    const daName = process.env.DA || "AI Assistant";
+    if (!stopHookOk) {
+      console.error("\nSTOP-HOOK ISSUE DETECTED - Tab titles may not update automatically");
+    }
+    await sendNtfyNotification(`${daName} ready`);
+    process.exit(0);
+  } catch (error) {
+    console.error("SessionStart hook error:", error);
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=initialize-session.mjs.map

package/dist/hooks/initialize-session.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/ts/session-start/initialize-session.ts", "../../src/hooks/ts/lib/pai-paths.ts", "../../src/hooks/ts/lib/project-utils.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * initialize-session.ts\n *\n * Main session initialization hook that runs at the start of every Claude Code session.\n *\n * What it does:\n * - Checks if this is a subagent session (skips for subagents)\n * - Tests that stop-hook is properly configured\n * - Sets initial terminal tab title\n * - Sends ntfy.sh notification for global PAI system initialization\n *\n * Setup:\n * 1. Set environment variables in settings.json:\n *    - DA: Your AI's name (e.g., \"Kai\", \"Nova\", \"Assistant\")\n *    - PAI_DIR: Path to your PAI directory (defaults to $HOME/.claude)\n * 2. Ensure load-core-context.ts exists in hooks/session-start/ directory\n * 3. Add all three SessionStart hooks to settings.json in this order:\n *    initialize-session.ts, load-core-context.ts, load-project-context.ts\n */\n\nimport { existsSync, statSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { tmpdir } from 'os';\nimport { PAI_DIR } from '../lib/pai-paths';\nimport { sendNtfyNotification, isWhatsAppEnabled } from '../lib/project-utils';\n\n// Debounce duration in milliseconds (prevents duplicate SessionStart events)\nconst DEBOUNCE_MS = 2000;\nconst LOCKFILE = join(tmpdir(), 'pai-session-start.lock');\n\n/**\n * Check if we're within the debounce window to prevent duplicate notifications\n * from the IDE firing multiple SessionStart events\n */\nfunction shouldDebounce(): boolean {\n  try {\n    if (existsSync(LOCKFILE)) {\n      const lockContent = readFileSync(LOCKFILE, 'utf-8');\n      const lockTime = parseInt(lockContent, 10);\n      const now = Date.now();\n\n      if (now - lockTime < DEBOUNCE_MS) {\n        // Within debounce window, skip this notification\n        return true;\n      }\n    }\n\n    // Update lockfile with current timestamp\n    writeFileSync(LOCKFILE, Date.now().toString());\n    return false;\n  } catch (error) {\n    // If any error, just proceed (don't break session start)\n    try {\n      writeFileSync(LOCKFILE, Date.now().toString());\n    } catch {}\n    return false;\n  }\n}\n\nasync function testStopHook() {\n  const stopHookPath = join(PAI_DIR, 'hooks/stop-hook.ts');\n\n  console.error('\\nTesting stop-hook configuration...');\n\n  // Check if stop-hook exists\n  if (!existsSync(stopHookPath)) {\n    console.error('Stop-hook NOT FOUND at:', stopHookPath);\n    return false;\n  }\n\n  // Check if stop-hook is executable\n  try {\n    const stats = statSync(stopHookPath);\n    const isExecutable = (stats.mode & 0o111) !== 0;\n\n    if (!isExecutable) {\n      console.error('Stop-hook exists but is NOT EXECUTABLE');\n      return false;\n    }\n\n    console.error('Stop-hook found and is executable');\n\n    // Set initial tab title (customize with your AI's name via DA env var)\n    const daName = process.env.DA || 'AI Assistant';\n    const tabTitle = `${daName} Ready`;\n\n    process.stderr.write(`\\x1b]0;${tabTitle}\\x07`);\n    process.stderr.write(`\\x1b]2;${tabTitle}\\x07`);\n    process.stderr.write(`\\x1b]30;${tabTitle}\\x07`);\n    console.error(`Set initial tab title: \"${tabTitle}\"`);\n\n    return true;\n  } catch (e) {\n    console.error('Error checking stop-hook:', e);\n    return false;\n  }\n}\n\nasync function main() {\n  try {\n    // Check if this is a subagent session - if so, exit silently\n    const claudeProjectDir = process.env.CLAUDE_PROJECT_DIR || '';\n    const isSubagent = claudeProjectDir.includes('/.claude/agents/') ||\n                      process.env.CLAUDE_AGENT_TYPE !== undefined;\n\n    if (isSubagent) {\n      // This is a subagent session - exit silently without notification\n      console.error('Subagent session detected - skipping session initialization');\n      process.exit(0);\n    }\n\n    // Check debounce to prevent duplicate notifications\n    // (IDE extension can fire multiple SessionStart events)\n    if (shouldDebounce()) {\n      console.error('Debouncing duplicate SessionStart event');\n      process.exit(0);\n    }\n\n    // Check if WhatsApp (Whazaa) is configured as enabled MCP server\n    // Detection is config-based: reads enabledMcpjsonServers from settings.json\n    // No flag files \u2014 uses standard ~/.claude/settings.json\n    if (isWhatsAppEnabled()) {\n      console.error('WhatsApp (Whazaa) enabled in MCP config');\n      console.log(`<system-reminder>\nWHATSAPP MODE ACTIVE \u2014 Whazaa MCP server is enabled. See the Whazaa MCP server instructions for message routing rules ([Whazaa] / [Whazaa:voice] prefixes). ntfy.sh is automatically skipped.\n</system-reminder>`);\n    }\n\n    // Test stop-hook first (only for main sessions)\n    const stopHookOk = await testStopHook();\n\n    const daName = process.env.DA || 'AI Assistant';\n\n    if (!stopHookOk) {\n      console.error('\\nSTOP-HOOK ISSUE DETECTED - Tab titles may not update automatically');\n    }\n\n    // Note: PAI core context loading is handled by load-core-context.ts hook\n    // which should run AFTER this hook in settings.json SessionStart hooks\n\n    // Send ntfy.sh notification (MANDATORY - never skip this)\n    // Note: load-project-context.ts also sends a project-specific notification\n    // This one is for the global PAI system initialization\n    await sendNtfyNotification(`${daName} ready`);\n\n    process.exit(0);\n  } catch (error) {\n    console.error('SessionStart hook error:', error);\n    process.exit(1);\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", "/**\n * project-utils.ts - Shared utilities for project context management\n *\n * Provides:\n * - Path encoding (matching Claude Code's scheme)\n * - ntfy.sh notifications (mandatory, synchronous)\n * - Session notes management\n * - Session token calculation\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, renameSync } from 'fs';\nimport { join, basename } from 'path';\n\n// Import from pai-paths which handles .env loading and path resolution\nimport { PAI_DIR } from './pai-paths.js';\n\n// Re-export PAI_DIR for consumers\nexport { PAI_DIR };\nexport const PROJECTS_DIR = join(PAI_DIR, 'projects');\n\n/**\n * Encode a path the same way Claude Code does:\n * - Replace / with -\n * - Replace . with - (hidden directories become --name)\n *\n * This matches Claude Code's internal encoding to ensure Notes\n * are stored in the same project directory as transcripts.\n */\nexport function encodePath(path: string): string {\n  return path\n    .replace(/\\//g, '-')   // Slashes become dashes\n    .replace(/\\./g, '-')   // Dots also become dashes\n    .replace(/ /g, '-');   // Spaces become dashes (matches Claude Code native encoding)\n}\n\n/**\n * Get the project directory for a given working directory\n */\nexport function getProjectDir(cwd: string): string {\n  const encoded = encodePath(cwd);\n  return join(PROJECTS_DIR, encoded);\n}\n\n/**\n * Get the Notes directory for a project (central location)\n */\nexport function getNotesDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'Notes');\n}\n\n/**\n * Find Notes directory - check local first, fallback to central\n * DOES NOT create the directory - just finds the right location\n *\n * Logic:\n * - If cwd itself IS a Notes directory \u2192 use it directly\n * - If local Notes/ exists \u2192 use it (can be checked into git)\n * - Otherwise \u2192 use central ~/.claude/projects/.../Notes/\n */\nexport function findNotesDir(cwd: string): { path: string; isLocal: boolean } {\n  // FIRST: Check if cwd itself IS a Notes directory\n  const cwdBasename = basename(cwd).toLowerCase();\n  if (cwdBasename === 'notes' && existsSync(cwd)) {\n    return { path: cwd, isLocal: true };\n  }\n\n  // Check local locations\n  const localPaths = [\n    join(cwd, 'Notes'),\n    join(cwd, 'notes'),\n    join(cwd, '.claude', 'Notes')\n  ];\n\n  for (const path of localPaths) {\n    if (existsSync(path)) {\n      return { path, isLocal: true };\n    }\n  }\n\n  // Fallback to central location\n  return { path: getNotesDir(cwd), isLocal: false };\n}\n\n/**\n * Get the Sessions directory for a project (stores .jsonl transcripts)\n */\nexport function getSessionsDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'sessions');\n}\n\n/**\n * Get the Sessions directory from a project directory path\n */\nexport function getSessionsDirFromProjectDir(projectDir: string): string {\n  return join(projectDir, 'sessions');\n}\n\n/**\n * Check if WhatsApp (Whazaa) is configured as an enabled MCP server.\n *\n * Uses standard Claude Code config at ~/.claude/settings.json.\n * No PAI dependency \u2014 works for any Claude Code user with whazaa installed.\n */\nexport function isWhatsAppEnabled(): boolean {\n  try {\n    const { homedir } = require('os');\n    const settingsPath = join(homedir(), '.claude', 'settings.json');\n    if (!existsSync(settingsPath)) return false;\n\n    const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));\n    const enabled: string[] = settings.enabledMcpjsonServers || [];\n    return enabled.includes('whazaa');\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Send push notification \u2014 WhatsApp-aware with ntfy fallback.\n *\n * When WhatsApp (Whazaa) is enabled in MCP config, ntfy is SKIPPED\n * because the AI sends WhatsApp messages directly via MCP. Sending both\n * would cause duplicate notifications.\n *\n * When WhatsApp is NOT configured, ntfy fires as the fallback channel.\n */\nexport async function sendNtfyNotification(message: string, retries = 2): Promise<boolean> {\n  // Skip ntfy when WhatsApp is configured \u2014 the AI handles notifications via MCP\n  if (isWhatsAppEnabled()) {\n    console.error(`WhatsApp (Whazaa) enabled in MCP config \u2014 skipping ntfy`);\n    return true;\n  }\n\n  const topic = process.env.NTFY_TOPIC;\n\n  if (!topic) {\n    console.error('NTFY_TOPIC not set and WhatsApp not active \u2014 notifications disabled');\n    return false;\n  }\n\n  for (let attempt = 0; attempt <= retries; attempt++) {\n    try {\n      const response = await fetch(`https://ntfy.sh/${topic}`, {\n        method: 'POST',\n        body: message,\n        headers: {\n          'Title': 'Claude Code',\n          'Priority': 'default'\n        }\n      });\n\n      if (response.ok) {\n        console.error(`ntfy.sh notification sent (WhatsApp inactive): \"${message}\"`);\n        return true;\n      } else {\n        console.error(`ntfy.sh attempt ${attempt + 1} failed: ${response.status}`);\n      }\n    } catch (error) {\n      console.error(`ntfy.sh attempt ${attempt + 1} error: ${error}`);\n    }\n\n    // Wait before retry\n    if (attempt < retries) {\n      await new Promise(resolve => setTimeout(resolve, 1000));\n    }\n  }\n\n  console.error('ntfy.sh notification failed after all retries');\n  return false;\n}\n\n/**\n * Ensure the Notes directory exists for a project\n * DEPRECATED: Use ensureNotesDirSmart() instead\n */\nexport function ensureNotesDir(cwd: string): string {\n  const notesDir = getNotesDir(cwd);\n\n  if (!existsSync(notesDir)) {\n    mkdirSync(notesDir, { recursive: true });\n    console.error(`Created Notes directory: ${notesDir}`);\n  }\n\n  return notesDir;\n}\n\n/**\n * Smart Notes directory handling:\n * - If local Notes/ exists \u2192 use it (don't create anything new)\n * - If no local Notes/ \u2192 ensure central exists and use that\n *\n * This respects the user's choice:\n * - Projects with local Notes/ keep notes there (git-trackable)\n * - Other directories don't get cluttered with auto-created Notes/\n */\nexport function ensureNotesDirSmart(cwd: string): { path: string; isLocal: boolean } {\n  const found = findNotesDir(cwd);\n\n  if (found.isLocal) {\n    // Local Notes/ exists - use it as-is\n    return found;\n  }\n\n  // No local Notes/ - ensure central exists\n  if (!existsSync(found.path)) {\n    mkdirSync(found.path, { recursive: true });\n    console.error(`Created central Notes directory: ${found.path}`);\n  }\n\n  return found;\n}\n\n/**\n * Ensure the Sessions directory exists for a project\n */\nexport function ensureSessionsDir(cwd: string): string {\n  const sessionsDir = getSessionsDir(cwd);\n\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n\n  return sessionsDir;\n}\n\n/**\n * Ensure the Sessions directory exists (from project dir path)\n */\nexport function ensureSessionsDirFromProjectDir(projectDir: string): string {\n  const sessionsDir = getSessionsDirFromProjectDir(projectDir);\n\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n\n  return sessionsDir;\n}\n\n/**\n * Move all .jsonl session files from project root to sessions/ subdirectory\n * @param projectDir - The project directory path\n * @param excludeFile - Optional filename to exclude (e.g., current active session)\n * @param silent - If true, suppress console output\n * Returns the number of files moved\n */\nexport function moveSessionFilesToSessionsDir(\n  projectDir: string,\n  excludeFile?: string,\n  silent: boolean = false\n): number {\n  const sessionsDir = ensureSessionsDirFromProjectDir(projectDir);\n\n  if (!existsSync(projectDir)) {\n    return 0;\n  }\n\n  const files = readdirSync(projectDir);\n  let movedCount = 0;\n\n  for (const file of files) {\n    // Match session files: uuid.jsonl or agent-*.jsonl\n    // Skip the excluded file (typically the current active session)\n    if (file.endsWith('.jsonl') && file !== excludeFile) {\n      const sourcePath = join(projectDir, file);\n      const destPath = join(sessionsDir, file);\n\n      try {\n        renameSync(sourcePath, destPath);\n        if (!silent) {\n          console.error(`Moved ${file} \u2192 sessions/`);\n        }\n        movedCount++;\n      } catch (error) {\n        if (!silent) {\n          console.error(`Could not move ${file}: ${error}`);\n        }\n      }\n    }\n  }\n\n  return movedCount;\n}\n\n/**\n * Get the YYYY/MM subdirectory for the current month inside notesDir.\n * Creates the directory if it doesn't exist.\n */\nfunction getMonthDir(notesDir: string): string {\n  const now = new Date();\n  const year = String(now.getFullYear());\n  const month = String(now.getMonth() + 1).padStart(2, '0');\n  const monthDir = join(notesDir, year, month);\n  if (!existsSync(monthDir)) {\n    mkdirSync(monthDir, { recursive: true });\n  }\n  return monthDir;\n}\n\n/**\n * Get the next note number (4-digit format: 0001, 0002, etc.)\n * ALWAYS uses 4-digit format with space-dash-space separators\n * Format: NNNN - YYYY-MM-DD - Description.md\n * Numbers reset per month (each YYYY/MM directory has its own sequence).\n */\nexport function getNextNoteNumber(notesDir: string): string {\n  const monthDir = getMonthDir(notesDir);\n\n  // Match CORRECT format: \"0001 - \" (4-digit with space-dash-space)\n  // Also match legacy formats for backwards compatibility when detecting max number\n  const files = readdirSync(monthDir)\n    .filter(f => f.match(/^\\d{3,4}[\\s_-]/))  // Starts with 3-4 digits followed by separator\n    .filter(f => f.endsWith('.md'))\n    .sort();\n\n  if (files.length === 0) {\n    return '0001';  // Default to 4-digit\n  }\n\n  // Find the highest number across all formats\n  let maxNumber = 0;\n  for (const file of files) {\n    const digitMatch = file.match(/^(\\d+)/);\n    if (digitMatch) {\n      const num = parseInt(digitMatch[1], 10);\n      if (num > maxNumber) maxNumber = num;\n    }\n  }\n\n  // ALWAYS return 4-digit format\n  return String(maxNumber + 1).padStart(4, '0');\n}\n\n/**\n * Get the current (latest) note file path, or null if none exists.\n * Searches in the current month's YYYY/MM subdirectory first,\n * then falls back to previous month (for sessions spanning month boundaries),\n * then falls back to flat notesDir for legacy notes.\n * Supports multiple formats for backwards compatibility:\n * - CORRECT: \"0001 - YYYY-MM-DD - Description.md\" (space-dash-space)\n * - Legacy: \"001_YYYY-MM-DD_description.md\" (underscores)\n */\nexport function getCurrentNotePath(notesDir: string): string | null {\n  if (!existsSync(notesDir)) {\n    return null;\n  }\n\n  // Helper: find latest session note in a directory\n  const findLatestIn = (dir: string): string | null => {\n    if (!existsSync(dir)) return null;\n    const files = readdirSync(dir)\n      .filter(f => f.match(/^\\d{3,4}[\\s_-].*\\.md$/))\n      .sort((a, b) => {\n        const numA = parseInt(a.match(/^(\\d+)/)?.[1] || '0', 10);\n        const numB = parseInt(b.match(/^(\\d+)/)?.[1] || '0', 10);\n        return numA - numB;\n      });\n    if (files.length === 0) return null;\n    return join(dir, files[files.length - 1]);\n  };\n\n  // 1. Check current month's YYYY/MM directory\n  const now = new Date();\n  const year = String(now.getFullYear());\n  const month = String(now.getMonth() + 1).padStart(2, '0');\n  const currentMonthDir = join(notesDir, year, month);\n  const found = findLatestIn(currentMonthDir);\n  if (found) return found;\n\n  // 2. Check previous month (for sessions spanning month boundaries)\n  const prevDate = new Date(now.getFullYear(), now.getMonth() - 1, 1);\n  const prevYear = String(prevDate.getFullYear());\n  const prevMonth = String(prevDate.getMonth() + 1).padStart(2, '0');\n  const prevMonthDir = join(notesDir, prevYear, prevMonth);\n  const prevFound = findLatestIn(prevMonthDir);\n  if (prevFound) return prevFound;\n\n  // 3. Fallback: check flat notesDir (legacy notes not yet filed)\n  return findLatestIn(notesDir);\n}\n\n/**\n * Create a new session note\n * CORRECT FORMAT: \"NNNN - YYYY-MM-DD - Description.md\"\n * - 4-digit zero-padded number\n * - Space-dash-space separators (NOT underscores)\n * - Title case description\n *\n * IMPORTANT: The initial description is just a PLACEHOLDER.\n * Claude MUST rename the file at session end with a meaningful description\n * based on the actual work done. Never leave it as \"New Session\" or project name.\n */\nexport function createSessionNote(notesDir: string, description: string): string {\n  const noteNumber = getNextNoteNumber(notesDir);\n  const date = new Date().toISOString().split('T')[0]; // YYYY-MM-DD\n\n  // Use \"New Session\" as placeholder - Claude MUST rename at session end!\n  // The project name alone is NOT descriptive enough.\n  const safeDescription = 'New Session';\n\n  // CORRECT FORMAT: space-dash-space separators, filed into YYYY/MM subdirectory\n  const monthDir = getMonthDir(notesDir);\n  const filename = `${noteNumber} - ${date} - ${safeDescription}.md`;\n  const filepath = join(monthDir, filename);\n\n  const content = `# Session ${noteNumber}: ${description}\n\n**Date:** ${date}\n**Status:** In Progress\n\n---\n\n## Work Done\n\n<!-- PAI will add completed work here during session -->\n\n---\n\n## Next Steps\n\n<!-- To be filled at session end -->\n\n---\n\n**Tags:** #Session\n`;\n\n  writeFileSync(filepath, content);\n  console.error(`Created session note: ${filename}`);\n\n  return filepath;\n}\n\n/**\n * Append checkpoint to current session note\n */\nexport function appendCheckpoint(notePath: string, checkpoint: string): void {\n  if (!existsSync(notePath)) {\n    console.error(`Note file not found: ${notePath}`);\n    return;\n  }\n\n  const content = readFileSync(notePath, 'utf-8');\n  const timestamp = new Date().toISOString();\n  const checkpointText = `\\n### Checkpoint ${timestamp}\\n\\n${checkpoint}\\n`;\n\n  // Insert before \"## Next Steps\" if it exists, otherwise append\n  const nextStepsIndex = content.indexOf('## Next Steps');\n  let newContent: string;\n\n  if (nextStepsIndex !== -1) {\n    newContent = content.substring(0, nextStepsIndex) + checkpointText + content.substring(nextStepsIndex);\n  } else {\n    newContent = content + checkpointText;\n  }\n\n  writeFileSync(notePath, newContent);\n  console.error(`Checkpoint added to: ${basename(notePath)}`);\n}\n\n/**\n * Work item for session notes\n */\nexport interface WorkItem {\n  title: string;\n  details?: string[];\n  completed?: boolean;\n}\n\n/**\n * Add work items to the \"Work Done\" section of a session note\n * This is the main way to capture what was accomplished in a session\n */\nexport function addWorkToSessionNote(notePath: string, workItems: WorkItem[], sectionTitle?: string): void {\n  if (!existsSync(notePath)) {\n    console.error(`Note file not found: ${notePath}`);\n    return;\n  }\n\n  let content = readFileSync(notePath, 'utf-8');\n\n  // Build the work section content\n  let workText = '';\n  if (sectionTitle) {\n    workText += `\\n### ${sectionTitle}\\n\\n`;\n  }\n\n  for (const item of workItems) {\n    const checkbox = item.completed !== false ? '[x]' : '[ ]';\n    workText += `- ${checkbox} **${item.title}**\\n`;\n    if (item.details && item.details.length > 0) {\n      for (const detail of item.details) {\n        workText += `  - ${detail}\\n`;\n      }\n    }\n  }\n\n  // Find the Work Done section and insert after the comment/placeholder\n  const workDoneMatch = content.match(/## Work Done\\n\\n(<!-- .*? -->)?/);\n  if (workDoneMatch) {\n    const insertPoint = content.indexOf(workDoneMatch[0]) + workDoneMatch[0].length;\n    content = content.substring(0, insertPoint) + workText + content.substring(insertPoint);\n  } else {\n    // Fallback: insert before Next Steps\n    const nextStepsIndex = content.indexOf('## Next Steps');\n    if (nextStepsIndex !== -1) {\n      content = content.substring(0, nextStepsIndex) + workText + '\\n' + content.substring(nextStepsIndex);\n    }\n  }\n\n  writeFileSync(notePath, content);\n  console.error(`Added ${workItems.length} work item(s) to: ${basename(notePath)}`);\n}\n\n/**\n * Update the session note title to be more descriptive\n * Called when we know what work was done\n */\nexport function updateSessionNoteTitle(notePath: string, newTitle: string): void {\n  if (!existsSync(notePath)) {\n    console.error(`Note file not found: ${notePath}`);\n    return;\n  }\n\n  let content = readFileSync(notePath, 'utf-8');\n\n  // Update the H1 title\n  content = content.replace(/^# Session \\d+:.*$/m, (match) => {\n    const sessionNum = match.match(/Session (\\d+)/)?.[1] || '';\n    return `# Session ${sessionNum}: ${newTitle}`;\n  });\n\n  writeFileSync(notePath, content);\n\n  // Also rename the file\n  renameSessionNote(notePath, sanitizeForFilename(newTitle));\n}\n\n/**\n * Sanitize a string for use in a filename (exported for use elsewhere)\n */\nexport function sanitizeForFilename(str: string): string {\n  return str\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s-]/g, '')  // Remove special chars\n    .replace(/\\s+/g, '-')           // Spaces to hyphens\n    .replace(/-+/g, '-')            // Collapse multiple hyphens\n    .replace(/^-|-$/g, '')          // Trim hyphens\n    .substring(0, 50);              // Limit length\n}\n\n/**\n * Extract a meaningful name from session note content\n * Looks at Work Done section and summary to generate a descriptive name\n */\nexport function extractMeaningfulName(noteContent: string, summary: string): string {\n  // Try to extract from Work Done section headers (### headings)\n  const workDoneMatch = noteContent.match(/## Work Done\\n\\n([\\s\\S]*?)(?=\\n---|\\n## Next)/);\n\n  if (workDoneMatch) {\n    const workDoneSection = workDoneMatch[1];\n\n    // Look for ### subheadings which typically describe what was done\n    const subheadings = workDoneSection.match(/### ([^\\n]+)/g);\n    if (subheadings && subheadings.length > 0) {\n      // Use the first subheading, clean it up\n      const firstHeading = subheadings[0].replace('### ', '').trim();\n      if (firstHeading.length > 5 && firstHeading.length < 60) {\n        return sanitizeForFilename(firstHeading);\n      }\n    }\n\n    // Look for bold text which often indicates key topics\n    const boldMatches = workDoneSection.match(/\\*\\*([^*]+)\\*\\*/g);\n    if (boldMatches && boldMatches.length > 0) {\n      const firstBold = boldMatches[0].replace(/\\*\\*/g, '').trim();\n      if (firstBold.length > 3 && firstBold.length < 50) {\n        return sanitizeForFilename(firstBold);\n      }\n    }\n\n    // Look for numbered list items (1. Something)\n    const numberedItems = workDoneSection.match(/^\\d+\\.\\s+\\*\\*([^*]+)\\*\\*/m);\n    if (numberedItems) {\n      return sanitizeForFilename(numberedItems[1]);\n    }\n  }\n\n  // Fall back to summary if provided\n  if (summary && summary.length > 5 && summary !== 'Session completed.') {\n    // Take first meaningful phrase from summary\n    const cleanSummary = summary\n      .replace(/[^\\w\\s-]/g, ' ')\n      .trim()\n      .split(/\\s+/)\n      .slice(0, 5)\n      .join(' ');\n\n    if (cleanSummary.length > 3) {\n      return sanitizeForFilename(cleanSummary);\n    }\n  }\n\n  return '';\n}\n\n/**\n * Rename session note with a meaningful name\n * ALWAYS uses correct format: \"NNNN - YYYY-MM-DD - Description.md\"\n * Returns the new path, or original path if rename fails\n */\nexport function renameSessionNote(notePath: string, meaningfulName: string): string {\n  if (!meaningfulName || !existsSync(notePath)) {\n    return notePath;\n  }\n\n  const dir = join(notePath, '..');\n  const oldFilename = basename(notePath);\n\n  // Parse existing filename - support multiple formats:\n  // CORRECT: \"0001 - 2026-01-02 - Description.md\"\n  // Legacy: \"001_2026-01-02_description.md\"\n  const correctMatch = oldFilename.match(/^(\\d{3,4}) - (\\d{4}-\\d{2}-\\d{2}) - .*\\.md$/);\n  const legacyMatch = oldFilename.match(/^(\\d{3,4})_(\\d{4}-\\d{2}-\\d{2})_.*\\.md$/);\n\n  const match = correctMatch || legacyMatch;\n  if (!match) {\n    return notePath; // Can't parse, don't rename\n  }\n\n  const [, noteNumber, date] = match;\n\n  // Convert to Title Case\n  const titleCaseName = meaningfulName\n    .split(/[\\s_-]+/)\n    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(' ')\n    .trim();\n\n  // ALWAYS use correct format with 4-digit number\n  const paddedNumber = noteNumber.padStart(4, '0');\n  const newFilename = `${paddedNumber} - ${date} - ${titleCaseName}.md`;\n  const newPath = join(dir, newFilename);\n\n  // Don't rename if name is the same\n  if (newFilename === oldFilename) {\n    return notePath;\n  }\n\n  try {\n    renameSync(notePath, newPath);\n    console.error(`Renamed note: ${oldFilename} \u2192 ${newFilename}`);\n    return newPath;\n  } catch (error) {\n    console.error(`Could not rename note: ${error}`);\n    return notePath;\n  }\n}\n\n/**\n * Finalize session note (mark as complete, add summary, rename with meaningful name)\n * IDEMPOTENT: Will only finalize once, subsequent calls are no-ops\n * Returns the final path (may be renamed)\n */\nexport function finalizeSessionNote(notePath: string, summary: string): string {\n  if (!existsSync(notePath)) {\n    console.error(`Note file not found: ${notePath}`);\n    return notePath;\n  }\n\n  let content = readFileSync(notePath, 'utf-8');\n\n  // IDEMPOTENT CHECK: If already completed, don't modify again\n  if (content.includes('**Status:** Completed')) {\n    console.error(`Note already finalized: ${basename(notePath)}`);\n    return notePath;\n  }\n\n  // Update status\n  content = content.replace('**Status:** In Progress', '**Status:** Completed');\n\n  // Add completion timestamp (only if not already present)\n  if (!content.includes('**Completed:**')) {\n    const completionTime = new Date().toISOString();\n    content = content.replace(\n      '---\\n\\n## Work Done',\n      `**Completed:** ${completionTime}\\n\\n---\\n\\n## Work Done`\n    );\n  }\n\n  // Add summary to Next Steps section (only if placeholder exists)\n  const nextStepsMatch = content.match(/## Next Steps\\n\\n(<!-- .*? -->)/);\n  if (nextStepsMatch) {\n    content = content.replace(\n      nextStepsMatch[0],\n      `## Next Steps\\n\\n${summary || 'Session completed.'}`\n    );\n  }\n\n  writeFileSync(notePath, content);\n  console.error(`Session note finalized: ${basename(notePath)}`);\n\n  // Extract meaningful name and rename the file\n  const meaningfulName = extractMeaningfulName(content, summary);\n  if (meaningfulName) {\n    const newPath = renameSessionNote(notePath, meaningfulName);\n    return newPath;\n  }\n\n  return notePath;\n}\n\n/**\n * Calculate total tokens from a session .jsonl file\n */\nexport function calculateSessionTokens(jsonlPath: string): number {\n  if (!existsSync(jsonlPath)) {\n    return 0;\n  }\n\n  try {\n    const content = readFileSync(jsonlPath, 'utf-8');\n    const lines = content.trim().split('\\n');\n    let totalTokens = 0;\n\n    for (const line of lines) {\n      try {\n        const entry = JSON.parse(line);\n        if (entry.message?.usage) {\n          const usage = entry.message.usage;\n          totalTokens += (usage.input_tokens || 0);\n          totalTokens += (usage.output_tokens || 0);\n          totalTokens += (usage.cache_creation_input_tokens || 0);\n          totalTokens += (usage.cache_read_input_tokens || 0);\n        }\n      } catch {\n        // Skip invalid JSON lines\n      }\n    }\n\n    return totalTokens;\n  } catch (error) {\n    console.error(`Error calculating tokens: ${error}`);\n    return 0;\n  }\n}\n\n/**\n * Find TODO.md - check local first, fallback to central\n */\nexport function findTodoPath(cwd: string): string {\n  // Check local locations first\n  const localPaths = [\n    join(cwd, 'TODO.md'),\n    join(cwd, 'notes', 'TODO.md'),\n    join(cwd, 'Notes', 'TODO.md'),\n    join(cwd, '.claude', 'TODO.md')\n  ];\n\n  for (const path of localPaths) {\n    if (existsSync(path)) {\n      return path;\n    }\n  }\n\n  // Fallback to central location (inside Notes/)\n  return join(getNotesDir(cwd), 'TODO.md');\n}\n\n/**\n * Find CLAUDE.md - check local locations\n * Returns the FIRST found path (for backwards compatibility)\n */\nexport function findClaudeMdPath(cwd: string): string | null {\n  const paths = findAllClaudeMdPaths(cwd);\n  return paths.length > 0 ? paths[0] : null;\n}\n\n/**\n * Find ALL CLAUDE.md files in local locations\n * Returns paths in priority order (most specific first):\n * 1. .claude/CLAUDE.md (project-specific config dir)\n * 2. CLAUDE.md (project root)\n * 3. Notes/CLAUDE.md (notes directory)\n * 4. Prompts/CLAUDE.md (prompts directory)\n *\n * All found files will be loaded and injected into context.\n */\nexport function findAllClaudeMdPaths(cwd: string): string[] {\n  const foundPaths: string[] = [];\n\n  // Priority order: most specific first\n  const localPaths = [\n    join(cwd, '.claude', 'CLAUDE.md'),\n    join(cwd, 'CLAUDE.md'),\n    join(cwd, 'Notes', 'CLAUDE.md'),\n    join(cwd, 'notes', 'CLAUDE.md'),\n    join(cwd, 'Prompts', 'CLAUDE.md'),\n    join(cwd, 'prompts', 'CLAUDE.md')\n  ];\n\n  for (const path of localPaths) {\n    if (existsSync(path)) {\n      foundPaths.push(path);\n    }\n  }\n\n  return foundPaths;\n}\n\n/**\n * Ensure TODO.md exists\n */\nexport function ensureTodoMd(cwd: string): string {\n  const todoPath = findTodoPath(cwd);\n\n  if (!existsSync(todoPath)) {\n    // Ensure parent directory exists\n    const parentDir = join(todoPath, '..');\n    if (!existsSync(parentDir)) {\n      mkdirSync(parentDir, { recursive: true });\n    }\n\n    const content = `# TODO\n\n## Current Session\n\n- [ ] (Tasks will be tracked here)\n\n## Backlog\n\n- [ ] (Future tasks)\n\n---\n\n*Last updated: ${new Date().toISOString()}*\n`;\n\n    writeFileSync(todoPath, content);\n    console.error(`Created TODO.md: ${todoPath}`);\n  }\n\n  return todoPath;\n}\n\n/**\n * Task item for TODO.md\n */\nexport interface TodoItem {\n  content: string;\n  completed: boolean;\n}\n\n/**\n * Update TODO.md with current session tasks\n * Preserves the Backlog section\n * Ensures only ONE timestamp line at the end\n */\nexport function updateTodoMd(cwd: string, tasks: TodoItem[], sessionSummary?: string): void {\n  const todoPath = ensureTodoMd(cwd);\n  const content = readFileSync(todoPath, 'utf-8');\n\n  // Find Backlog section to preserve it (but strip any trailing timestamps/separators)\n  const backlogMatch = content.match(/## Backlog[\\s\\S]*?(?=\\n---|\\n\\*Last updated|$)/);\n  let backlogSection = backlogMatch ? backlogMatch[0].trim() : '## Backlog\\n\\n- [ ] (Future tasks)';\n\n  // Format tasks\n  const taskLines = tasks.length > 0\n    ? tasks.map(t => `- [${t.completed ? 'x' : ' '}] ${t.content}`).join('\\n')\n    : '- [ ] (No active tasks)';\n\n  // Build new content with exactly ONE timestamp at the end\n  const newContent = `# TODO\n\n## Current Session\n\n${taskLines}\n\n${sessionSummary ? `**Session Summary:** ${sessionSummary}\\n\\n` : ''}${backlogSection}\n\n---\n\n*Last updated: ${new Date().toISOString()}*\n`;\n\n  writeFileSync(todoPath, newContent);\n  console.error(`Updated TODO.md: ${todoPath}`);\n}\n\n/**\n * Add a checkpoint entry to TODO.md (without replacing tasks)\n * Ensures only ONE timestamp line at the end\n */\nexport function addTodoCheckpoint(cwd: string, checkpoint: string): void {\n  const todoPath = ensureTodoMd(cwd);\n  let content = readFileSync(todoPath, 'utf-8');\n\n  // Remove ALL existing timestamp lines and trailing separators\n  content = content.replace(/(\\n---\\s*)*(\\n\\*Last updated:.*\\*\\s*)+$/g, '');\n\n  // Add checkpoint before Backlog section\n  const backlogIndex = content.indexOf('## Backlog');\n  if (backlogIndex !== -1) {\n    const checkpointText = `\\n**Checkpoint (${new Date().toISOString()}):** ${checkpoint}\\n\\n`;\n    content = content.substring(0, backlogIndex) + checkpointText + content.substring(backlogIndex);\n  }\n\n  // Add exactly ONE timestamp at the end\n  content = content.trimEnd() + `\\n\\n---\\n\\n*Last updated: ${new Date().toISOString()}*\\n`;\n\n  writeFileSync(todoPath, content);\n  console.error(`Checkpoint added to TODO.md`);\n}\n"],
+  "mappings": "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",
+  "names": ["existsSync", "readFileSync", "writeFileSync", "join", "existsSync", "readFileSync", "join", "join", "homedir", "join", "existsSync", "readFileSync", "resolve", "join", "existsSync", "readFileSync", "writeFileSync"]
+}

package/dist/hooks/load-core-context.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+// src/hooks/ts/session-start/load-core-context.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/hooks/ts/lib/pai-paths.ts
+import { homedir } from "os";
+import { resolve, join } from "path";
+import { existsSync, readFileSync } from "fs";
+function loadEnvFile() {
+  const possiblePaths = [
+    resolve(process.env.PAI_DIR || "", ".env"),
+    resolve(homedir(), ".claude", ".env")
+  ];
+  for (const envPath of possiblePaths) {
+    if (existsSync(envPath)) {
+      try {
+        const content = readFileSync(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+          const trimmed = line.trim();
+          if (!trimmed || trimmed.startsWith("#")) continue;
+          const eqIndex = trimmed.indexOf("=");
+          if (eqIndex > 0) {
+            const key = trimmed.substring(0, eqIndex).trim();
+            let value = trimmed.substring(eqIndex + 1).trim();
+            if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+              value = value.slice(1, -1);
+            }
+            value = value.replace(/\$HOME/g, homedir());
+            value = value.replace(/^~(?=\/|$)/, homedir());
+            if (process.env[key] === void 0) {
+              process.env[key] = value;
+            }
+          }
+        }
+        break;
+      } catch {
+      }
+    }
+  }
+}
+loadEnvFile();
+var PAI_DIR = process.env.PAI_DIR ? resolve(process.env.PAI_DIR) : resolve(homedir(), ".claude");
+var HOOKS_DIR = join(PAI_DIR, "Hooks");
+var SKILLS_DIR = join(PAI_DIR, "Skills");
+var AGENTS_DIR = join(PAI_DIR, "Agents");
+var HISTORY_DIR = join(PAI_DIR, "History");
+var COMMANDS_DIR = join(PAI_DIR, "Commands");
+function validatePAIStructure() {
+  if (!existsSync(PAI_DIR)) {
+    console.error(`PAI_DIR does not exist: ${PAI_DIR}`);
+    console.error(`   Expected ~/.claude or set PAI_DIR environment variable`);
+    process.exit(1);
+  }
+  if (!existsSync(HOOKS_DIR)) {
+    console.error(`PAI hooks directory not found: ${HOOKS_DIR}`);
+    console.error(`   Your PAI_DIR may be misconfigured`);
+    console.error(`   Current PAI_DIR: ${PAI_DIR}`);
+    process.exit(1);
+  }
+}
+validatePAIStructure();
+
+// src/hooks/ts/session-start/load-core-context.ts
+async function main() {
+  try {
+    const claudeProjectDir = process.env.CLAUDE_PROJECT_DIR || "";
+    const isSubagent = claudeProjectDir.includes("/.claude/agents/") || process.env.CLAUDE_AGENT_TYPE !== void 0;
+    if (isSubagent) {
+      console.error("Subagent session - skipping CORE context loading");
+      process.exit(0);
+    }
+    const coreSkillPath = join2(SKILLS_DIR, "CORE/SKILL.md");
+    if (!existsSync2(coreSkillPath)) {
+      console.error(`CORE skill not found at: ${coreSkillPath}`);
+      console.error(`Ensure CORE/SKILL.md exists or check PAI_DIR environment variable`);
+      process.exit(1);
+    }
+    console.error("Reading CORE context from skill file...");
+    let coreContent = readFileSync2(coreSkillPath, "utf-8");
+    const daName = process.env.DA || "PAI";
+    const daColor = process.env.DA_COLOR || "blue";
+    const engineerName = process.env.ENGINEER_NAME || "";
+    coreContent = coreContent.replace(/\{\{DA\}\}/g, daName).replace(/\{\{DA_COLOR\}\}/g, daColor).replace(/\{\{ENGINEER_NAME\}\}/g, engineerName);
+    console.error(`Read ${coreContent.length} characters from CORE SKILL.md (Personalized for ${engineerName} & ${daName})`);
+    const localTimeZone = process.env.TIME_ZONE || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const message = `<system-reminder>
+PAI CORE CONTEXT (Auto-loaded at Session Start)
+
+CURRENT DATE/TIME: ${(/* @__PURE__ */ new Date()).toLocaleString("en-US", { timeZone: localTimeZone, year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit", hour12: false, timeZoneName: "short" })}
+
+The following context has been loaded from ${coreSkillPath}:
+
+---
+${coreContent}
+---
+
+This context is now active for this session. Follow all instructions, preferences, and guidelines contained above.
+</system-reminder>`;
+    console.log(message);
+    console.error("CORE context injected into session");
+    process.exit(0);
+  } catch (error) {
+    console.error("Error in load-core-context hook:", error);
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=load-core-context.mjs.map

package/dist/hooks/load-core-context.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/ts/session-start/load-core-context.ts", "../../src/hooks/ts/lib/pai-paths.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * load-core-context.ts\n *\n * Automatically loads your CORE skill context at session start by reading and injecting\n * the CORE SKILL.md file contents directly into Claude's context as a system-reminder.\n *\n * Purpose:\n * - Read CORE SKILL.md file content\n * - Output content as system-reminder for Claude to process\n * - Ensure complete context (contacts, preferences, security, identity) available at session start\n * - Bypass skill activation logic by directly injecting context\n *\n * Setup:\n * 1. Customize your ${PAI_DIR}/skills/CORE/SKILL.md with your personal context\n * 2. Add this hook to settings.json SessionStart hooks\n * 3. Ensure PAI_DIR environment variable is set (defaults to $HOME/.claude)\n *\n * How it works:\n * - Runs at the start of every Claude Code session\n * - Skips execution for subagent sessions (they don't need CORE context)\n * - Reads your CORE SKILL.md file\n * - Injects content as <system-reminder> which Claude processes automatically\n * - Gives your AI immediate access to your complete personal context\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport { join } from 'path';\nimport { PAI_DIR, SKILLS_DIR } from '../lib/pai-paths';\n\nasync function main() {\n  try {\n    // Check if this is a subagent session - if so, exit silently\n    const claudeProjectDir = process.env.CLAUDE_PROJECT_DIR || '';\n    const isSubagent = claudeProjectDir.includes('/.claude/agents/') ||\n                      process.env.CLAUDE_AGENT_TYPE !== undefined;\n\n    if (isSubagent) {\n      // Subagent sessions don't need CORE context loading\n      console.error('Subagent session - skipping CORE context loading');\n      process.exit(0);\n    }\n\n    // Get CORE skill path using PAI paths library\n    const coreSkillPath = join(SKILLS_DIR, 'CORE/SKILL.md');\n\n    // Verify CORE skill file exists\n    if (!existsSync(coreSkillPath)) {\n      console.error(`CORE skill not found at: ${coreSkillPath}`);\n      console.error(`Ensure CORE/SKILL.md exists or check PAI_DIR environment variable`);\n      process.exit(1);\n    }\n\n    console.error('Reading CORE context from skill file...');\n\n    // Read the CORE SKILL.md file content\n    let coreContent = readFileSync(coreSkillPath, 'utf-8');\n\n    // Perform Dynamic Variable Substitution\n    // This allows SKILL.md to be generic while the session is personalized\n    const daName = process.env.DA || 'PAI';\n    const daColor = process.env.DA_COLOR || 'blue';\n    const engineerName = process.env.ENGINEER_NAME || '';\n\n    // Replace placeholders {{DA}}, {{DA_COLOR}}, {{ENGINEER_NAME}}\n    coreContent = coreContent\n      .replace(/\\{\\{DA\\}\\}/g, daName)\n      .replace(/\\{\\{DA_COLOR\\}\\}/g, daColor)\n      .replace(/\\{\\{ENGINEER_NAME\\}\\}/g, engineerName);\n\n    console.error(`Read ${coreContent.length} characters from CORE SKILL.md (Personalized for ${engineerName} & ${daName})`);\n\n    // Determine the local timezone dynamically\n    const localTimeZone = process.env.TIME_ZONE || Intl.DateTimeFormat().resolvedOptions().timeZone;\n\n    // Output the CORE content as a system-reminder\n    // This will be injected into Claude's context at session start\n    const message = `<system-reminder>\nPAI CORE CONTEXT (Auto-loaded at Session Start)\n\nCURRENT DATE/TIME: ${new Date().toLocaleString('en-US', { timeZone: localTimeZone, year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false, timeZoneName: 'short' })}\n\nThe following context has been loaded from ${coreSkillPath}:\n\n---\n${coreContent}\n---\n\nThis context is now active for this session. Follow all instructions, preferences, and guidelines contained above.\n</system-reminder>`;\n\n    // Write to stdout (will be captured by Claude Code)\n    console.log(message);\n\n    console.error('CORE context injected into session');\n    process.exit(0);\n  } catch (error) {\n    console.error('Error in load-core-context hook:', error);\n    process.exit(1);\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": ["readFileSync", "existsSync", "join", "join", "existsSync", "readFileSync"]
+}