thanh-kit 2.5.0 → 2.5.2

package/templates/hooks/lib/context-tracker.cjs

@@ -1,335 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Context Window Tracker - Self-healing context reset detection
- *
- * Fixes #177: Race condition from shared global state file
- * Fixes #178: Consolidates temp files to /tmp/ck/ namespace
- *
- * Architecture:
- * - NO global state file (was causing race conditions in concurrent sessions)
- * - All state embedded in session-specific marker files
- * - Each session is completely isolated (no shared state)
- *
- * Detection layers:
- * - Layer 1: Hook markers (explicit reset signal from PreCompact/SessionStart)
- * - Layer 2: Token drop detection (50% threshold fallback for hook failures)
- *
- * Removed:
- * - Old Layer 1 (session ID change detection) - was the BUG source
- * - Global STATE_FILE - caused race conditions in concurrent sessions
- *
- * Marker schema:
- * {
- *   sessionId: string,
- *   trigger: string,           // 'session_start_clear', 'manual', 'auto', 'new_session', 'token_drop'
- *   baselineRecorded: boolean,
- *   baseline: number,          // Token count at baseline
- *   lastTokenTotal: number,    // For token drop detection (replaces global state)
- *   timestamp: number
- * }
- *
- * @module context-tracker
- */
-
-const fs = require('fs');
-const {
-  MARKERS_DIR,
-  CALIBRATION_PATH,
-  ensureDir,
-  getMarkerPath
-} = require('./ck-paths.cjs');
-
-// Token drop threshold for Layer 2 detection (50%)
-// Rationale: /compact typically reduces tokens by 60-80%, so 50% catches
-// context resets while avoiding false positives from normal token accumulation.
-// Exclusive: drops below (<) 50% trigger reset
-const TOKEN_DROP_THRESHOLD = 0.5;
-
-/**
- * Get smart default compact threshold based on context window size
- * Research-based defaults:
- * - 200k window: ~77.5% (155k) - confirmed from GitHub issues
- * - 1M window: ~33% (330k) - derived from user observations
- *
- * @param {number} contextWindowSize - Model's context window size
- * @returns {number} Estimated compact threshold in tokens
- */
-function getDefaultCompactThreshold(contextWindowSize) {
-  const KNOWN_THRESHOLDS = {
-    200000: 155000,   // 77.5% - confirmed via /context showing 45k buffer
-    1000000: 330000,  // 33% - 1M beta window
-  };
-
-  if (KNOWN_THRESHOLDS[contextWindowSize]) {
-    return KNOWN_THRESHOLDS[contextWindowSize];
-  }
-
-  // Tiered defaults based on window size
-  if (contextWindowSize >= 1000000) {
-    return Math.floor(contextWindowSize * 0.33);
-  }
-  return Math.floor(contextWindowSize * 0.775);
-}
-
-/**
- * Read calibration data from file (recorded by PreCompact hook)
- * @returns {Object} Calibration data keyed by context window size
- */
-function readCalibration() {
-  try {
-    if (fs.existsSync(CALIBRATION_PATH)) {
-      return JSON.parse(fs.readFileSync(CALIBRATION_PATH, 'utf8'));
-    }
-  } catch (err) {
-    // Silent fail - use defaults
-  }
-  return {};
-}
-
-/**
- * Get compact threshold, preferring calibrated value over default
- * @param {number} contextWindowSize - Model's context window size
- * @returns {number} Compact threshold in tokens
- */
-function getCompactThreshold(contextWindowSize) {
-  const calibration = readCalibration();
-  const key = String(contextWindowSize);
-
-  if (calibration[key] && calibration[key].threshold > 0) {
-    return calibration[key].threshold;
-  }
-  return getDefaultCompactThreshold(contextWindowSize);
-}
-
-/**
- * Read marker file for a session
- * Defensive: handles missing/empty/corrupt files gracefully
- * @param {string} sessionId - Session ID
- * @returns {Object|null} Marker data or null
- */
-function readMarker(sessionId) {
-  try {
-    const markerPath = getMarkerPath(sessionId);
-    if (!fs.existsSync(markerPath)) return null;
-    const data = fs.readFileSync(markerPath, 'utf8');
-    if (!data.trim()) return null; // Catch empty/corrupt files
-    const marker = JSON.parse(data);
-    // Basic schema validation
-    if (!marker || typeof marker.sessionId !== 'string') {
-      return null;
-    }
-    return marker;
-  } catch (err) {
-    // Silent fail - corrupt JSON or read error
-  }
-  return null;
-}
-
-/**
- * Write marker file for a session
- * @param {string} sessionId - Session ID
- * @param {Object} marker - Marker data
- */
-function writeMarker(sessionId, marker) {
-  try {
-    ensureDir(MARKERS_DIR);
-    const markerPath = getMarkerPath(sessionId);
-    fs.writeFileSync(markerPath, JSON.stringify(marker));
-  } catch (err) {
-    // Silent fail
-  }
-}
-
-/**
- * Delete marker file for a session
- * @param {string} sessionId - Session ID
- */
-function deleteMarker(sessionId) {
-  try {
-    const markerPath = getMarkerPath(sessionId);
-    if (fs.existsSync(markerPath)) {
-      fs.unlinkSync(markerPath);
-    }
-  } catch (err) {
-    // Silent fail
-  }
-}
-
-/**
- * Layer 2: Detect significant token drop (50%+ reduction)
- * Uses session-specific lastTokenTotal from marker (no global state)
- * @param {number} currentTotal - Current cumulative token total
- * @param {Object|null} marker - Session marker with lastTokenTotal
- * @returns {boolean} True if token drop detected
- */
-function detectTokenDrop(currentTotal, marker) {
-  if (!marker || !marker.lastTokenTotal || marker.lastTokenTotal <= 0 || currentTotal <= 0) {
-    return false;
-  }
-
-  // Token total dropped by more than 50%
-  const dropRatio = currentTotal / marker.lastTokenTotal;
-  return dropRatio < TOKEN_DROP_THRESHOLD;
-}
-
-/**
- * Layer 1: Check for explicit reset marker from hooks
- * @param {Object|null} marker - Session marker
- * @returns {{ shouldReset: boolean, trigger: string|null }}
- */
-function checkResetMarker(marker) {
-  if (!marker) {
-    return { shouldReset: false, trigger: null };
-  }
-
-  // Check if marker indicates a reset (clear/compact)
-  const resetTriggers = ['clear', 'session_start_clear'];
-  if (resetTriggers.includes(marker.trigger)) {
-    return { shouldReset: true, trigger: marker.trigger };
-  }
-
-  return { shouldReset: false, trigger: marker.trigger };
-}
-
-/**
- * Main context tracking function with 2-layer self-healing detection
- *
- * Layer 1: Hook markers (explicit reset from PreCompact/SessionStart)
- * Layer 2: Token drop detection (50% threshold fallback)
- *
- * NO global state - all state is session-specific in marker files
- *
- * @param {Object} params - Tracking parameters
- * @param {string} params.sessionId - Current session ID
- * @param {number} params.contextInput - Input tokens
- * @param {number} params.contextOutput - Output tokens
- * @param {number} params.contextWindowSize - Model's context window size
- * @returns {Object} { percentage, baseline, showCompactIndicator, resetLayer }
- */
-function trackContext({ sessionId, contextInput, contextOutput, contextWindowSize }) {
-  const currentTotal = contextInput + contextOutput;
-  const compactThreshold = getCompactThreshold(contextWindowSize);
-  const effectiveSessionId = sessionId || 'default';
-
-  // Read session-specific marker (no global state!)
-  let marker = readMarker(effectiveSessionId);
-
-  // Track which layer triggered reset (for debugging)
-  let resetLayer = null;
-  let baseline = 0;
-  let showCompactIndicator = false;
-
-  // --- Layer 1: Hook marker system ---
-  // Markers from PreCompact/SessionStart hooks are explicit signals
-  const { shouldReset, trigger } = checkResetMarker(marker);
-  if (shouldReset) {
-    resetLayer = `marker_${trigger}`;
-    baseline = currentTotal;
-    // Clear the reset trigger after processing
-    marker = null; // Force fresh marker creation below
-  }
-
-  // --- Layer 2: Token drop detection (fallback for hook failures) ---
-  if (!resetLayer && detectTokenDrop(currentTotal, marker)) {
-    resetLayer = 'token_drop';
-    baseline = currentTotal;
-    marker = null; // Force fresh marker creation below
-  }
-
-  // --- No reset triggered - use existing marker/baseline ---
-  if (!resetLayer && marker) {
-    if (!marker.baselineRecorded) {
-      // Marker exists but baseline not recorded yet (from PreCompact)
-      marker.baselineRecorded = true;
-      marker.baseline = currentTotal;
-      marker.lastTokenTotal = currentTotal;
-      writeMarker(effectiveSessionId, marker);
-      baseline = currentTotal;
-      // PreCompact triggers: "manual" (from /compact) or "auto" (from auto-compact)
-      showCompactIndicator = ['compact', 'manual', 'auto'].includes(marker.trigger);
-    } else {
-      // Use stored baseline
-      baseline = marker.baseline || 0;
-    }
-  }
-
-  // --- Create fresh marker if needed ---
-  if (!marker || resetLayer) {
-    const newMarker = {
-      sessionId: effectiveSessionId,
-      trigger: resetLayer || 'new_session',
-      baselineRecorded: true,
-      baseline: currentTotal,
-      lastTokenTotal: currentTotal,
-      timestamp: Date.now()
-    };
-    writeMarker(effectiveSessionId, newMarker);
-    if (!resetLayer) {
-      baseline = currentTotal;
-    }
-  } else {
-    // Update lastTokenTotal for next token drop detection
-    marker.lastTokenTotal = currentTotal;
-    writeMarker(effectiveSessionId, marker);
-  }
-
-  // Calculate effective tokens (since baseline)
-  let effectiveTotal = baseline > 0 ? currentTotal - baseline : currentTotal;
-  if (effectiveTotal < 0) effectiveTotal = 0;
-
-  // Calculate percentage against compact threshold (not model limit)
-  const percentage = Math.min(100, Math.floor(effectiveTotal * 100 / compactThreshold));
-
-  return {
-    percentage,
-    baseline,
-    effectiveTotal,
-    compactThreshold,
-    showCompactIndicator,
-    resetLayer
-  };
-}
-
-/**
- * Write reset marker for session (called by SessionStart hook on /clear)
- * @param {string} sessionId - Session ID
- * @param {string} trigger - Reset trigger ('clear', 'compact', etc.)
- */
-function writeResetMarker(sessionId, trigger = 'clear') {
-  const effectiveSessionId = sessionId || 'default';
-  ensureDir(MARKERS_DIR);
-  writeMarker(effectiveSessionId, {
-    sessionId: effectiveSessionId,
-    trigger: `session_start_${trigger}`,
-    baselineRecorded: false,
-    baseline: 0,
-    lastTokenTotal: 0,
-    timestamp: Date.now()
-  });
-}
-
-/**
- * Clear all markers (for testing/cleanup)
- * Uses new /tmp/ck/ namespace
- */
-function clearAllState() {
-  const { cleanAll } = require('./ck-paths.cjs');
-  cleanAll();
-}
-
-module.exports = {
-  trackContext,
-  writeResetMarker,
-  clearAllState,
-  getCompactThreshold,
-  // Export for testing
-  detectTokenDrop,
-  checkResetMarker,
-  readMarker,
-  writeMarker,
-  deleteMarker,
-  TOKEN_DROP_THRESHOLD,
-  MARKERS_DIR
-};

package/templates/hooks/notify-waiting.js

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-/**
- * Claude Code Notification Hook (Cross-Platform)
- *
- * Sends a non-blocking notification when Claude is waiting for user input.
- * Supports Windows, macOS, and Linux.
- *
- * Hook Type: Notification
- * Trigger: When Claude is waiting for user input
- * Exit code: Always 0 (notifications are fire-and-forget)
- */
-
-const { execSync, exec } = require('child_process');
-const os = require('os');
-
-const TITLE = 'Claude Code';
-const MESSAGE = 'Waiting for your input';
-
-/**
- * Send notification on Windows using inline PowerShell
- * Uses Windows 10/11 notifications that work without focus
- */
-function notifyWindows() {
-    // Try BurntToast first (if installed)
-    try {
-        execSync(
-            `powershell -NoProfile -Command "if (Get-Module -ListAvailable -Name BurntToast) { Import-Module BurntToast; New-BurntToastNotification -Text '${TITLE}', '${MESSAGE}'; exit 0 } else { exit 1 }"`,
-            { stdio: 'inherit', timeout: 3000 }
-        );
-        return;
-    } catch {
-        // BurntToast not available
-    }
-
-    // Try System.Windows.Forms notification
-    try {
-        execSync(
-            `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing; $n = New-Object System.Windows.Forms.NotifyIcon; $n.Icon = [System.Drawing.SystemIcons]::Information; $n.BalloonTipIcon = 'Info'; $n.BalloonTipTitle = '${TITLE}'; $n.BalloonTipText = '${MESSAGE}'; $n.Visible = $true; $n.ShowBalloonTip(30000); Start-Sleep -Seconds 3; $n.Dispose()"`,
-            { stdio: 'inherit', timeout: 5000 }
-        );
-        return;
-    } catch {
-        // Notification failed
-    }
-
-    // Final fallback: Beep
-    try {
-        execSync('powershell -NoProfile -Command "[console]::beep(800,300)"', {
-            stdio: 'ignore',
-            timeout: 1000
-        });
-    } catch {
-        // All methods failed
-    }
-}
-
-/**
- * Send notification on macOS
- */
-function notifyMacOS() {
-    try {
-        // Use osascript for native macOS notifications
-        exec(`osascript -e 'display notification "${MESSAGE}" with title "${TITLE}"'`, { timeout: 5000 });
-    } catch {
-        // Try terminal-notifier if available
-        try {
-            exec(`terminal-notifier -title "${TITLE}" -message "${MESSAGE}" -sound default`, { timeout: 5000 });
-        } catch {
-            // Silently ignore
-        }
-    }
-}
-
-/**
- * Send notification on Linux
- */
-function notifyLinux() {
-    try {
-        // Try notify-send (common on most Linux distros)
-        exec(`notify-send "${TITLE}" "${MESSAGE}" --urgency=normal`, { timeout: 5000 });
-    } catch {
-        // Try zenity as fallback
-        try {
-            exec(`zenity --notification --text="${TITLE}: ${MESSAGE}"`, { timeout: 5000 });
-        } catch {
-            // Silently ignore
-        }
-    }
-}
-
-/**
- * Main notification dispatcher
- */
-function sendNotification() {
-    const platform = os.platform();
-
-    switch (platform) {
-        case 'win32':
-            notifyWindows();
-            break;
-        case 'darwin':
-            notifyMacOS();
-            break;
-        case 'linux':
-            notifyLinux();
-            break;
-        default:
-            // Unknown platform - silently ignore
-            break;
-    }
-}
-
-// Execute notification
-sendNotification();
-
-// Always exit successfully
-process.exit(0);

package/templates/hooks/post-edit-prettier.cjs

@@ -1,189 +0,0 @@
-#!/usr/bin/env node
-/**
- * PostToolUse Hook: Auto-Prettier Formatting
- *
- * Automatically runs Prettier on files after Edit/Write operations.
- * Non-blocking: failures are silently ignored to not disrupt workflow.
- *
- * Trigger: PostToolUse (Edit|Write)
- * Input: JSON with tool_input.file_path
- * Output: None (silent operation)
- *
- * Exit Codes:
- *   0 - Always (non-blocking)
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync, spawnSync } = require('child_process');
-
-// ═══════════════════════════════════════════════════════════════════════════
-// CONFIGURATION
-// ═══════════════════════════════════════════════════════════════════════════
-
-const SUPPORTED_EXTENSIONS = new Set([
-    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
-    '.json', '.jsonc',
-    '.scss', '.css', '.less',
-    '.html', '.htm',
-    '.md', '.mdx',
-    '.yaml', '.yml',
-    '.graphql', '.gql'
-]);
-
-const TIMEOUT_MS = 10000; // 10 seconds max
-
-// Paths to skip (generated, dependencies, etc.)
-const SKIP_PATTERNS = [
-    /node_modules/,
-    /\.git\//,
-    /dist\//,
-    /build\//,
-    /obj\//,
-    /bin\//,
-    /\.next\//,
-    /\.nuxt\//,
-    /coverage\//,
-    /\.angular\//
-];
-
-// ═══════════════════════════════════════════════════════════════════════════
-// HELPER FUNCTIONS
-// ═══════════════════════════════════════════════════════════════════════════
-
-/**
- * Check if file extension is supported by Prettier
- */
-function isSupportedFile(filePath) {
-    const ext = path.extname(filePath).toLowerCase();
-    return SUPPORTED_EXTENSIONS.has(ext);
-}
-
-/**
- * Check if file should be skipped (generated, dependencies, etc.)
- */
-function shouldSkipPath(filePath) {
-    const normalized = filePath.replace(/\\/g, '/');
-    return SKIP_PATTERNS.some(pattern => pattern.test(normalized));
-}
-
-/**
- * Find Prettier config file by walking up from file location
- */
-function findPrettierConfig(startDir) {
-    const configNames = ['.prettierrc', '.prettierrc.json', '.prettierrc.js', '.prettierrc.cjs', 'prettier.config.js', 'prettier.config.cjs'];
-    let dir = startDir;
-
-    while (dir !== path.dirname(dir)) {
-        for (const name of configNames) {
-            const configPath = path.join(dir, name);
-            if (fs.existsSync(configPath)) {
-                return configPath;
-            }
-        }
-        // Also check package.json for prettier key
-        const pkgPath = path.join(dir, 'package.json');
-        if (fs.existsSync(pkgPath)) {
-            try {
-                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-                if (pkg.prettier) {
-                    return pkgPath; // Config is in package.json
-                }
-            } catch (e) {
-                // Ignore parse errors
-            }
-        }
-        dir = path.dirname(dir);
-    }
-    return null;
-}
-
-/**
- * Find npx executable (cross-platform)
- */
-function findNpx() {
-    const isWindows = process.platform === 'win32';
-    try {
-        const cmd = isWindows ? 'where npx' : 'which npx';
-        return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0];
-    } catch (e) {
-        return isWindows ? 'npx.cmd' : 'npx';
-    }
-}
-
-/**
- * Run Prettier on a file
- */
-function runPrettier(filePath, configPath) {
-    const npx = findNpx();
-    const args = ['prettier', '--write', filePath];
-
-    if (configPath) {
-        args.push('--config', configPath);
-    }
-
-    const result = spawnSync(npx, args, {
-        encoding: 'utf-8',
-        timeout: TIMEOUT_MS,
-        stdio: ['pipe', 'pipe', 'pipe'],
-        shell: process.platform === 'win32'
-    });
-
-    return result.status === 0;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// MAIN EXECUTION
-// ═══════════════════════════════════════════════════════════════════════════
-
-async function main() {
-    try {
-        // Read stdin (PostToolUse payload)
-        const stdin = fs.readFileSync(0, 'utf-8').trim();
-        if (!stdin) {
-            process.exit(0);
-        }
-
-        const payload = JSON.parse(stdin);
-
-        // Extract file path from tool input
-        const filePath = payload?.tool_input?.file_path;
-        if (!filePath) {
-            process.exit(0);
-        }
-
-        // Normalize path
-        const absolutePath = path.isAbsolute(filePath)
-            ? filePath
-            : path.resolve(process.cwd(), filePath);
-
-        // Skip if file doesn't exist (might have been deleted)
-        if (!fs.existsSync(absolutePath)) {
-            process.exit(0);
-        }
-
-        // Skip unsupported extensions
-        if (!isSupportedFile(absolutePath)) {
-            process.exit(0);
-        }
-
-        // Skip generated/dependency paths
-        if (shouldSkipPath(absolutePath)) {
-            process.exit(0);
-        }
-
-        // Find Prettier config
-        const fileDir = path.dirname(absolutePath);
-        const configPath = findPrettierConfig(fileDir);
-
-        // Run Prettier (silent on failure)
-        runPrettier(absolutePath, configPath);
-
-        process.exit(0);
-    } catch (error) {
-        // Silent failure - don't disrupt workflow
-        process.exit(0);
-    }
-}
-
-main();