@tekmidian/pai 0.15.0 → 0.17.0

package/dist/hooks/inject-observations.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/hooks/ts/session-start/inject-observations.ts", "../../src/hooks/ts/lib/project-utils/paths.ts", "../../src/hooks/ts/lib/pai-paths.ts"],
+  "sources": ["../../../src/hooks/ts/session-start/inject-observations.ts", "../../../src/hooks/ts/lib/project-utils/paths.ts", "../../../src/hooks/ts/lib/pai-paths.ts"],
   "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * inject-observations.ts\n *\n * SessionStart hook that injects recent project observation context into Claude's\n * session as a <system-reminder>. Provides progressive disclosure of recent activity\n * so Claude has immediate awareness of what has been happening in this project.\n *\n * Flow:\n * 1. Read session data (session_id, cwd) from stdin\n * 2. Call daemon via IPC: observation_recent with { cwd, limit: 25 }\n *    (daemon resolves project_id from cwd internally via registry lookup)\n * 3. Format as progressive disclosure context block\n * 4. Output to stdout as <system-reminder> (injected into session by Claude Code)\n *\n * Silent on any failure \u2014 never blocks session start.\n */\n\nimport { connect } from 'net';\nimport { randomUUID } from 'crypto';\nimport { isProbeSession } from '../lib/project-utils.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ninterface HookData {\n  session_id?: string;\n  cwd?: string;\n  hook_event_name?: string;\n}\n\ninterface ObservationRow {\n  id: number;\n  session_id: string;\n  project_id: number | null;\n  project_slug: string | null;\n  type: string;\n  title: string;\n  narrative: string | null;\n  created_at: string; // ISO string after JSON serialization\n}\n\ninterface ObservationRecentResult {\n  rows: ObservationRow[];\n  project_slug?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Inline IPC client \u2014 mirrors the pattern in observe.ts\n// Hooks can't import from src/daemon/ at runtime, so we inline this.\n// ---------------------------------------------------------------------------\n\nasync function callDaemon(method: string, params: Record<string, unknown>): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(() => reject(new Error('timeout')), 5000);\n    let buffer = '';\n\n    try {\n      const socket = connect('/tmp/pai.sock', () => {\n        socket.write(JSON.stringify({ id: randomUUID(), method, params }) + '\\n');\n      });\n\n      socket.on('data', (chunk: Buffer) => {\n        buffer += chunk.toString();\n        const nl = buffer.indexOf('\\n');\n        if (nl !== -1) {\n          clearTimeout(timeout);\n          try {\n            const response = JSON.parse(buffer.slice(0, nl));\n            socket.destroy();\n            if (response.ok) resolve(response.result);\n            else reject(new Error(response.error ?? 'daemon error'));\n          } catch (e) {\n            socket.destroy();\n            reject(e);\n          }\n        }\n      });\n\n      socket.on('error', () => {\n        clearTimeout(timeout);\n        reject(new Error('daemon unavailable'));\n      });\n    } catch {\n      clearTimeout(timeout);\n      reject(new Error('daemon unavailable'));\n    }\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Time formatting\n// ---------------------------------------------------------------------------\n\nfunction timeAgo(date: Date): string {\n  const diffMs = Date.now() - date.getTime();\n  const diffSec = Math.floor(diffMs / 1000);\n  const diffMin = Math.floor(diffSec / 60);\n  const diffHour = Math.floor(diffMin / 60);\n  const diffDay = Math.floor(diffHour / 24);\n\n  if (diffSec < 60) return 'just now';\n  if (diffMin < 60) return `${diffMin}m ago`;\n  if (diffHour < 24) return `${diffHour}h ago`;\n  if (diffDay < 7) return `${diffDay}d ago`;\n\n  // Older than a week: show date string\n  return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });\n}\n\n// ---------------------------------------------------------------------------\n// Type label\n// ---------------------------------------------------------------------------\n\nfunction typeLabel(type: string): string {\n  switch (type) {\n    case 'change':    return '[change]';\n    case 'discovery': return '[discovery]';\n    case 'decision':  return '[decision]';\n    case 'bugfix':    return '[bugfix]';\n    case 'feature':   return '[feature]';\n    case 'refactor':  return '[refactor]';\n    default:          return `[${type}]`;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Truncate\n// ---------------------------------------------------------------------------\n\nfunction truncate(s: string, maxLen: number): string {\n  return s.length > maxLen ? s.slice(0, maxLen - 1) + '\\u2026' : s;\n}\n\n// ---------------------------------------------------------------------------\n// Format observations as progressive disclosure context\n// ---------------------------------------------------------------------------\n\nfunction formatContext(\n  projectSlug: string,\n  observations: ObservationRow[]\n): string {\n  if (observations.length === 0) return '';\n\n  // Count distinct sessions\n  const sessionSet = new Set(observations.map(o => o.session_id));\n  const sessionCount = sessionSet.size;\n\n  // Most recent observation\n  const newest = new Date(observations[0].created_at);\n  const lastActivity = timeAgo(newest);\n\n  // Timeline: show most recent 15, keep titles to 80 chars\n  const timelineObs = observations.slice(0, 15);\n  const timeline = timelineObs\n    .map(o => {\n      const t = timeAgo(new Date(o.created_at));\n      const label = typeLabel(o.type);\n      const title = truncate(o.title, 80);\n      return `- [${t}] ${label} ${title}`;\n    })\n    .join('\\n');\n\n  const showingNote = observations.length > 15\n    ? `(showing most recent 15 of ${observations.length}, use observation_search for more)`\n    : `(showing ${observations.length} observation${observations.length !== 1 ? 's' : ''})`;\n\n  const lines: string[] = [\n    `<system-reminder>`,\n    `OBSERVATION CONTEXT (auto-injected)`,\n    ``,\n    `## Recent Activity (${projectSlug})`,\n    `${observations.length} observations across ${sessionCount} session${sessionCount !== 1 ? 's' : ''} | Last activity: ${lastActivity}`,\n    ``,\n    `### Recent Timeline`,\n    timeline,\n    showingNote,\n    `</system-reminder>`,\n  ];\n\n  return lines.join('\\n');\n}\n\n// ---------------------------------------------------------------------------\n// Main\n// ---------------------------------------------------------------------------\n\nasync function main() {\n  try {\n    // Skip probe/health-check sessions\n    if (isProbeSession()) {\n      process.exit(0);\n    }\n\n    // Skip subagent sessions \u2014 they don't need observation context\n    const claudeProjectDir = process.env.CLAUDE_PROJECT_DIR || '';\n    const isSubagent = claudeProjectDir.includes('/.claude/agents/') ||\n                       process.env.CLAUDE_AGENT_TYPE !== undefined;\n    if (isSubagent) {\n      process.exit(0);\n    }\n\n    // Read hook data from stdin\n    let hookData: HookData = {};\n    try {\n      const chunks: Buffer[] = [];\n      for await (const chunk of process.stdin) {\n        chunks.push(chunk as Buffer);\n      }\n      const raw = Buffer.concat(chunks).toString('utf-8').trim();\n      if (raw) {\n        hookData = JSON.parse(raw);\n      }\n    } catch {\n      // Non-fatal \u2014 fall back to process.cwd()\n    }\n\n    const cwd = hookData.cwd || process.cwd();\n\n    // Fetch recent observations for this cwd \u2014 daemon resolves the project internally\n    let observations: ObservationRow[];\n    let projectSlug: string;\n\n    try {\n      const result = await callDaemon('observation_recent', { cwd, limit: 25 }) as ObservationRecentResult;\n      observations = result?.rows ?? [];\n      projectSlug = result?.project_slug ?? '';\n    } catch {\n      // Daemon unavailable or Postgres not configured \u2014 silent exit\n      process.exit(0);\n    }\n\n    if (!observations || observations.length === 0 || !projectSlug) {\n      // No data or no matching project \u2014 nothing to inject\n      process.exit(0);\n    }\n\n    // Format and output\n    const context = formatContext(projectSlug, observations);\n    if (context) {\n      // Output to stdout \u2014 Claude Code captures this and injects into session context\n      console.log(context);\n    }\n\n    process.exit(0);\n  } catch {\n    // Never block session start\n    process.exit(0);\n  }\n}\n\nmain();\n", "/**\n * Path utilities \u2014 encoding, Notes/Sessions directory discovery and creation.\n */\n\nimport { existsSync, mkdirSync, readdirSync, renameSync } from 'fs';\nimport { join, basename } from 'path';\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 * Directories known to be automated health-check / probe sessions.\n * Hooks should exit early for these to avoid registry clutter and wasted work.\n */\nconst PROBE_CWD_PATTERNS = [\n  '/CodexBar/ClaudeProbe',\n  '/ClaudeProbe',\n];\n\n/**\n * Check if the current working directory belongs to a probe/health-check session.\n * Returns true if hooks should skip this session entirely.\n */\nexport function isProbeSession(cwd?: string): boolean {\n  const dir = cwd || process.cwd();\n  return PROBE_CWD_PATTERNS.some(pattern => dir.includes(pattern));\n}\n\n/**\n * Encode a path the same way Claude Code does:\n * - Replace / with -\n * - Replace . with -\n * - Replace space with -\n */\nexport function encodePath(path: string): string {\n  return path\n    .replace(/\\//g, '-')\n    .replace(/\\./g, '-')\n    .replace(/ /g, '-');\n}\n\n/** Get the project directory for a given working directory. */\nexport function getProjectDir(cwd: string): string {\n  const encoded = encodePath(cwd);\n  return join(PROJECTS_DIR, encoded);\n}\n\n/** Get the Notes directory for a project (central location). */\nexport function getNotesDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'Notes');\n}\n\n/**\n * Find Notes directory \u2014 checks local first, falls back to central.\n * Does NOT create the directory.\n */\nexport function findNotesDir(cwd: string): { path: string; isLocal: boolean } {\n  const cwdBasename = basename(cwd).toLowerCase();\n  if (cwdBasename === 'notes' && existsSync(cwd)) {\n    return { path: cwd, isLocal: true };\n  }\n\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  return { path: getNotesDir(cwd), isLocal: false };\n}\n\n/** Get the sessions/ directory for a project (stores .jsonl transcripts). */\nexport function getSessionsDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'sessions');\n}\n\n/** Get the sessions/ directory from a project directory path. */\nexport function getSessionsDirFromProjectDir(projectDir: string): string {\n  return join(projectDir, 'sessions');\n}\n\n// ---------------------------------------------------------------------------\n// Directory creation helpers\n// ---------------------------------------------------------------------------\n\n/** Ensure the Notes directory exists for a project. @deprecated Use ensureNotesDirSmart() */\nexport function ensureNotesDir(cwd: string): string {\n  const notesDir = getNotesDir(cwd);\n  if (!existsSync(notesDir)) {\n    mkdirSync(notesDir, { recursive: true });\n    console.error(`Created Notes directory: ${notesDir}`);\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 */\nexport function ensureNotesDirSmart(cwd: string): { path: string; isLocal: boolean } {\n  const found = findNotesDir(cwd);\n  if (found.isLocal) return found;\n  if (!existsSync(found.path)) {\n    mkdirSync(found.path, { recursive: true });\n    console.error(`Created central Notes directory: ${found.path}`);\n  }\n  return found;\n}\n\n/** Ensure the sessions/ directory exists for a project. */\nexport function ensureSessionsDir(cwd: string): string {\n  const sessionsDir = getSessionsDir(cwd);\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n  return sessionsDir;\n}\n\n/** Ensure the sessions/ directory exists (from project dir path). */\nexport function ensureSessionsDirFromProjectDir(projectDir: string): string {\n  const sessionsDir = getSessionsDirFromProjectDir(projectDir);\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n  return sessionsDir;\n}\n\n/**\n * Move all .jsonl session files from project root to sessions/ subdirectory.\n * Returns the number of files moved.\n */\nexport function moveSessionFilesToSessionsDir(\n  projectDir: string,\n  excludeFile?: string,\n  silent = false\n): number {\n  const sessionsDir = ensureSessionsDirFromProjectDir(projectDir);\n\n  if (!existsSync(projectDir)) return 0;\n\n  const files = readdirSync(projectDir);\n  let movedCount = 0;\n\n  for (const file of files) {\n    if (file.endsWith('.jsonl') && file !== excludeFile) {\n      const sourcePath = join(projectDir, file);\n      const destPath = join(sessionsDir, file);\n      try {\n        renameSync(sourcePath, destPath);\n        if (!silent) console.error(`Moved ${file} \u2192 sessions/`);\n        movedCount++;\n      } catch (error) {\n        if (!silent) console.error(`Could not move ${file}: ${error}`);\n      }\n    }\n  }\n\n  return movedCount;\n}\n\n// ---------------------------------------------------------------------------\n// CLAUDE.md / TODO.md discovery\n// ---------------------------------------------------------------------------\n\n/** Find TODO.md \u2014 check local first, fallback to central. */\nexport function findTodoPath(cwd: string): string {\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)) return path;\n  }\n\n  return join(getNotesDir(cwd), 'TODO.md');\n}\n\n/** Find CLAUDE.md \u2014 returns the FIRST found path. */\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 in priority order.\n */\nexport function findAllClaudeMdPaths(cwd: string): string[] {\n  const foundPaths: string[] = [];\n\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)) foundPaths.push(path);\n  }\n\n  return foundPaths;\n}\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": ["join", "join", "resolve"]

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/hooks/ts/session-start/load-core-context.ts", "../../src/hooks/ts/lib/pai-paths.ts", "../../src/hooks/ts/lib/project-utils/paths.ts"],
+  "sources": ["../../../src/hooks/ts/session-start/load-core-context.ts", "../../../src/hooks/ts/lib/pai-paths.ts", "../../../src/hooks/ts/lib/project-utils/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';\nimport { isProbeSession } from '../lib/project-utils';\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    // Skip probe/health-check sessions (e.g. CodexBar ClaudeProbe)\n    if (isProbeSession()) {\n      console.error('Probe session detected - 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", "/**\n * Path utilities \u2014 encoding, Notes/Sessions directory discovery and creation.\n */\n\nimport { existsSync, mkdirSync, readdirSync, renameSync } from 'fs';\nimport { join, basename } from 'path';\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 * Directories known to be automated health-check / probe sessions.\n * Hooks should exit early for these to avoid registry clutter and wasted work.\n */\nconst PROBE_CWD_PATTERNS = [\n  '/CodexBar/ClaudeProbe',\n  '/ClaudeProbe',\n];\n\n/**\n * Check if the current working directory belongs to a probe/health-check session.\n * Returns true if hooks should skip this session entirely.\n */\nexport function isProbeSession(cwd?: string): boolean {\n  const dir = cwd || process.cwd();\n  return PROBE_CWD_PATTERNS.some(pattern => dir.includes(pattern));\n}\n\n/**\n * Encode a path the same way Claude Code does:\n * - Replace / with -\n * - Replace . with -\n * - Replace space with -\n */\nexport function encodePath(path: string): string {\n  return path\n    .replace(/\\//g, '-')\n    .replace(/\\./g, '-')\n    .replace(/ /g, '-');\n}\n\n/** Get the project directory for a given working directory. */\nexport function getProjectDir(cwd: string): string {\n  const encoded = encodePath(cwd);\n  return join(PROJECTS_DIR, encoded);\n}\n\n/** Get the Notes directory for a project (central location). */\nexport function getNotesDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'Notes');\n}\n\n/**\n * Find Notes directory \u2014 checks local first, falls back to central.\n * Does NOT create the directory.\n */\nexport function findNotesDir(cwd: string): { path: string; isLocal: boolean } {\n  const cwdBasename = basename(cwd).toLowerCase();\n  if (cwdBasename === 'notes' && existsSync(cwd)) {\n    return { path: cwd, isLocal: true };\n  }\n\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  return { path: getNotesDir(cwd), isLocal: false };\n}\n\n/** Get the sessions/ directory for a project (stores .jsonl transcripts). */\nexport function getSessionsDir(cwd: string): string {\n  return join(getProjectDir(cwd), 'sessions');\n}\n\n/** Get the sessions/ directory from a project directory path. */\nexport function getSessionsDirFromProjectDir(projectDir: string): string {\n  return join(projectDir, 'sessions');\n}\n\n// ---------------------------------------------------------------------------\n// Directory creation helpers\n// ---------------------------------------------------------------------------\n\n/** Ensure the Notes directory exists for a project. @deprecated Use ensureNotesDirSmart() */\nexport function ensureNotesDir(cwd: string): string {\n  const notesDir = getNotesDir(cwd);\n  if (!existsSync(notesDir)) {\n    mkdirSync(notesDir, { recursive: true });\n    console.error(`Created Notes directory: ${notesDir}`);\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 */\nexport function ensureNotesDirSmart(cwd: string): { path: string; isLocal: boolean } {\n  const found = findNotesDir(cwd);\n  if (found.isLocal) return found;\n  if (!existsSync(found.path)) {\n    mkdirSync(found.path, { recursive: true });\n    console.error(`Created central Notes directory: ${found.path}`);\n  }\n  return found;\n}\n\n/** Ensure the sessions/ directory exists for a project. */\nexport function ensureSessionsDir(cwd: string): string {\n  const sessionsDir = getSessionsDir(cwd);\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n  return sessionsDir;\n}\n\n/** Ensure the sessions/ directory exists (from project dir path). */\nexport function ensureSessionsDirFromProjectDir(projectDir: string): string {\n  const sessionsDir = getSessionsDirFromProjectDir(projectDir);\n  if (!existsSync(sessionsDir)) {\n    mkdirSync(sessionsDir, { recursive: true });\n    console.error(`Created sessions directory: ${sessionsDir}`);\n  }\n  return sessionsDir;\n}\n\n/**\n * Move all .jsonl session files from project root to sessions/ subdirectory.\n * Returns the number of files moved.\n */\nexport function moveSessionFilesToSessionsDir(\n  projectDir: string,\n  excludeFile?: string,\n  silent = false\n): number {\n  const sessionsDir = ensureSessionsDirFromProjectDir(projectDir);\n\n  if (!existsSync(projectDir)) return 0;\n\n  const files = readdirSync(projectDir);\n  let movedCount = 0;\n\n  for (const file of files) {\n    if (file.endsWith('.jsonl') && file !== excludeFile) {\n      const sourcePath = join(projectDir, file);\n      const destPath = join(sessionsDir, file);\n      try {\n        renameSync(sourcePath, destPath);\n        if (!silent) console.error(`Moved ${file} \u2192 sessions/`);\n        movedCount++;\n      } catch (error) {\n        if (!silent) console.error(`Could not move ${file}: ${error}`);\n      }\n    }\n  }\n\n  return movedCount;\n}\n\n// ---------------------------------------------------------------------------\n// CLAUDE.md / TODO.md discovery\n// ---------------------------------------------------------------------------\n\n/** Find TODO.md \u2014 check local first, fallback to central. */\nexport function findTodoPath(cwd: string): string {\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)) return path;\n  }\n\n  return join(getNotesDir(cwd), 'TODO.md');\n}\n\n/** Find CLAUDE.md \u2014 returns the FIRST found path. */\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 in priority order.\n */\nexport function findAllClaudeMdPaths(cwd: string): string[] {\n  const foundPaths: string[] = [];\n\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)) foundPaths.push(path);\n  }\n\n  return foundPaths;\n}\n"],
   "mappings": "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",
   "names": ["readFileSync", "existsSync", "join", "join", "join", "join", "existsSync", "readFileSync"]

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

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
 // src/hooks/ts/session-start/load-project-context.ts
-import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync5, statSync } from "fs";
+import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
 import { join as join6, basename as basename4, dirname, resolve as resolve2 } from "path";
 import { homedir as homedir4 } from "os";
 import { execSync } from "child_process";
 
 // src/memory/wakeup.ts
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join, basename } from "node:path";
 import { homedir } from "node:os";
 var L1_TOKEN_BUDGET = 800;
@@ -68,10 +68,26 @@ function findSessionNotes(notesDir) {
     }
   };
   scanDir(notesDir);
+  const dateOf = (p) => basename(p).match(/(\d{4}-\d{2}-\d{2})/)?.[1] ?? "";
+  const numberOf = (p) => parseInt(basename(p).match(/^(\d+)/)?.[1] ?? "0", 10);
+  const mtimeOf = (p) => {
+    try {
+      return statSync(p).mtimeMs;
+    } catch {
+      return 0;
+    }
+  };
   result.sort((a, b) => {
-    const numA = parseInt(basename(a).match(/^(\d+)/)?.[1] ?? "0", 10);
-    const numB = parseInt(basename(b).match(/^(\d+)/)?.[1] ?? "0", 10);
-    return numB - numA;
+    const dateA = dateOf(a);
+    const dateB = dateOf(b);
+    if (dateA !== dateB) {
+      if (!dateA) return 1;
+      if (!dateB) return -1;
+      return dateB.localeCompare(dateA);
+    }
+    const byNumber = numberOf(b) - numberOf(a);
+    if (byNumber !== 0) return byNumber;
+    return mtimeOf(b) - mtimeOf(a);
   });
   return result;
 }
@@ -161,6 +177,141 @@ ${essentialStory}`);
   return parts.join("\n\n");
 }
 
+// src/session/checkpoint-block.ts
+var MARKER_OPEN = "<!-- pai:checkpoint";
+var MARKER_CLOSE = "<!-- /pai:checkpoint -->";
+var CONTINUE_HEADING = "## Continue";
+function parseMarker(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith(MARKER_OPEN)) return null;
+  const attrs = {};
+  for (const m of trimmed.matchAll(/([a-zA-Z][\w-]*)="([^"]*)"/g)) {
+    attrs[m[1]] = m[2];
+  }
+  return {
+    authored: attrs.authored === "model" ? "model" : "auto",
+    session: attrs.session || void 0,
+    sessionId: attrs["session-id"] || void 0,
+    ts: attrs.ts || void 0
+  };
+}
+var BOILERPLATE_PATTERNS = [
+  /^##\s+Continue$/,
+  /^<!--\s*\/?pai:checkpoint/,
+  /^>\s*\*\*Last session:\*\*/,
+  /^>\s*\*\*Paused at:\*\*/,
+  /^>\s*Working directory:/,
+  /^>\s*Resume with:/,
+  /^>\s*_No checkpoint body was recorded/,
+  /^-{3,}$/
+];
+var BLANK_LINE = /^>?\s*$/;
+function extractSectionContent(lines) {
+  const kept = [];
+  for (const line of lines) {
+    const t = line.trim();
+    if (BOILERPLATE_PATTERNS.some((re) => re.test(t))) continue;
+    kept.push(line);
+  }
+  return trimBlankEdges(collapseBlankRuns(kept)).join("\n");
+}
+function trimBlankEdges(lines) {
+  let start = 0;
+  let end = lines.length;
+  while (start < end && BLANK_LINE.test(lines[start].trim())) start += 1;
+  while (end > start && BLANK_LINE.test(lines[end - 1].trim())) end -= 1;
+  return lines.slice(start, end);
+}
+function collapseBlankRuns(lines) {
+  const out = [];
+  let lastWasBlank = false;
+  for (const line of lines) {
+    const isBlank = BLANK_LINE.test(line.trim());
+    if (isBlank && lastWasBlank) continue;
+    out.push(line);
+    lastWasBlank = isBlank;
+  }
+  return out;
+}
+function locateContinue(content) {
+  const lines = content.split("\n");
+  const startIdx = lines.findIndex((l) => l.trim() === CONTINUE_HEADING);
+  if (startIdx === -1) return null;
+  let meta = null;
+  let markerIdx = -1;
+  for (let i = startIdx + 1; i < Math.min(startIdx + 6, lines.length); i++) {
+    const parsed = parseMarker(lines[i]);
+    if (parsed) {
+      meta = parsed;
+      markerIdx = i;
+      break;
+    }
+    if (lines[i].trim() !== "") break;
+  }
+  let endIdx = lines.length;
+  if (markerIdx !== -1) {
+    const closeIdx = lines.findIndex(
+      (l, i) => i > markerIdx && l.trim() === MARKER_CLOSE
+    );
+    if (closeIdx !== -1) {
+      endIdx = closeIdx + 1;
+    } else {
+      endIdx = heuristicEnd(lines, startIdx);
+    }
+  } else {
+    endIdx = heuristicEnd(lines, startIdx);
+  }
+  let trailingEnd = endIdx;
+  while (trailingEnd < lines.length && lines[trailingEnd].trim() === "") {
+    trailingEnd += 1;
+  }
+  if (trailingEnd < lines.length && lines[trailingEnd].trim() === "---") {
+    trailingEnd += 1;
+  } else {
+    trailingEnd = endIdx;
+  }
+  return {
+    startIdx,
+    endIdx: trailingEnd,
+    meta,
+    lines: lines.slice(startIdx, trailingEnd)
+  };
+}
+function heuristicEnd(lines, startIdx) {
+  for (let i = startIdx + 1; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (trimmed === "---" || /^##(?!#)/.test(trimmed) && trimmed !== CONTINUE_HEADING) {
+      return i;
+    }
+  }
+  return lines.length;
+}
+function readContinueCheckpoint(content) {
+  const found = locateContinue(content);
+  if (!found) return null;
+  const body = found.meta ? extractMarkedBody(found.lines) : extractSectionContent(found.lines);
+  if (!body) return null;
+  return { meta: found.meta, body, raw: found.lines.join("\n") };
+}
+function extractMarkedBody(lines) {
+  const markerIdx = lines.findIndex((l) => parseMarker(l) !== null);
+  if (markerIdx === -1) return extractSectionContent(lines);
+  const closeIdx = lines.findIndex(
+    (l, i) => i > markerIdx && l.trim() === MARKER_CLOSE
+  );
+  if (closeIdx === -1) return extractSectionContent(lines);
+  let bodyStart = markerIdx + 1;
+  while (bodyStart < closeIdx) {
+    const t = lines[bodyStart].trim();
+    if (BLANK_LINE.test(t) || t.startsWith(">")) {
+      bodyStart += 1;
+      continue;
+    }
+    break;
+  }
+  return trimBlankEdges(lines.slice(bodyStart, closeIdx)).join("\n");
+}
+
 // src/hooks/ts/lib/project-utils/paths.ts
 import { existsSync as existsSync3, mkdirSync, readdirSync as readdirSync2, renameSync } from "fs";
 import { join as join3, basename as basename2 } from "path";
@@ -573,7 +724,7 @@ async function main() {
       const jsonlFiles = files.filter((f) => f.endsWith(".jsonl")).map((f) => ({
         name: f,
         path: join6(projectDir, f),
-        mtime: statSync(join6(projectDir, f)).mtime.getTime()
+        mtime: statSync2(join6(projectDir, f)).mtime.getTime()
       })).sort((a, b) => b.mtime - a.mtime);
       if (jsonlFiles.length > 1) {
         const { mkdirSync: mkdirSync3, renameSync: renameSync3 } = await import("fs");
@@ -750,6 +901,37 @@ Session Commands:
 </system-reminder>
 `;
   console.log(reminder);
+  if (existsSync6(todoPath)) {
+    try {
+      const checkpoint = readContinueCheckpoint(readFileSync5(todoPath, "utf-8"));
+      if (checkpoint) {
+        const from = checkpoint.meta?.session ? `
+From session: ${checkpoint.meta.session}` : "";
+        const when = checkpoint.meta?.ts ? `
+Paused at: ${checkpoint.meta.ts}` : "";
+        const resume = checkpoint.meta?.sessionId ? `
+Resume that session with: claude --resume ${checkpoint.meta.sessionId}` : "";
+        console.log(`
+<system-reminder>
+HANDOVER FROM THE PREVIOUS SESSION
+
+Source: ${todoPath} (## Continue)${from}${when}${resume}
+
+${checkpoint.body}
+
+---
+This is recorded state, not a new instruction. Do not start acting on it
+unprompted. If the user says "go", "continue", or "weiter", resume from here.
+</system-reminder>
+`);
+        console.error(`Injected pause checkpoint (${checkpoint.body.length} chars)`);
+      } else {
+        console.error("No pause checkpoint body in TODO.md \u2014 nothing to hand over");
+      }
+    } catch (error) {
+      console.error("Checkpoint injection failed:", error);
+    }
+  }
   for (const { path, content } of claudeMdContents) {
     const claudeMdReminder = `
 <system-reminder>