thanh-kit 2.5.0 → 2.5.1

package/templates/hooks/workflow-router.cjs

@@ -1,326 +0,0 @@
-#!/usr/bin/env node
-/**
- * Workflow Router - UserPromptSubmit Hook
- *
- * Automatically detects user intent from prompts and injects workflow instructions.
- * Works with workflows.json configuration for customizable workflow definitions.
- *
- * Features:
- * - Pattern-based intent detection
- * - Configurable workflow sequences
- * - Override support (prefix with "quick:" to skip)
- * - Confidence-based confirmation for high-impact workflows
- *
- * Exit Codes:
- *   0 - Success (non-blocking)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ═══════════════════════════════════════════════════════════════════════════
-// CONFIGURATION LOADING
-// ═══════════════════════════════════════════════════════════════════════════
-
-function loadWorkflowConfig() {
-  const configPaths = [
-    path.join(process.cwd(), '.claude', 'workflows.json'),
-    path.join(require('os').homedir(), '.claude', 'workflows.json')
-  ];
-
-  for (const configPath of configPaths) {
-    if (fs.existsSync(configPath)) {
-      try {
-        return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-      } catch (e) {
-        console.error(`[workflow-router] Failed to parse ${configPath}: ${e.message}`);
-      }
-    }
-  }
-
-  // Return default config if no file found
-  return getDefaultConfig();
-}
-
-function getDefaultConfig() {
-  return {
-    settings: {
-      enabled: true,
-      confirmHighImpact: true,
-      showDetection: true,
-      allowOverride: true,
-      overridePrefix: 'quick:'
-    },
-    workflows: {
-      feature: {
-        name: 'Feature Implementation',
-        triggerPatterns: ['\\b(implement|add|create|build)\\b'],
-        excludePatterns: ['\\b(fix|bug|error)\\b'],
-        sequence: ['plan', 'cook', 'test', 'code-review'],
-        confirmFirst: true,
-        priority: 10
-      },
-      bugfix: {
-        name: 'Bug Fix',
-        triggerPatterns: ['\\b(bug|fix|error|broken|issue)\\b'],
-        excludePatterns: [],
-        sequence: ['debug', 'plan', 'fix', 'test'],
-        confirmFirst: false,
-        priority: 20
-      },
-      documentation: {
-        name: 'Documentation',
-        triggerPatterns: ['\\b(doc|document|readme)\\b'],
-        excludePatterns: ['\\b(implement|fix)\\b'],
-        sequence: ['docs-update', 'watzup'],
-        confirmFirst: false,
-        priority: 30
-      }
-    },
-    commandMapping: {
-      plan: { claude: '/plan' },
-      cook: { claude: '/cook' },
-      test: { claude: '/test' },
-      fix: { claude: '/fix' },
-      debug: { claude: '/debug' },
-      'code-review': { claude: '/review/codebase' },
-      'docs-update': { claude: '/docs/update' },
-      watzup: { claude: '/watzup' }
-    }
-  };
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// INTENT DETECTION
-// ═══════════════════════════════════════════════════════════════════════════
-
-function detectIntent(userPrompt, config) {
-  const { workflows, settings } = config;
-
-  // Check for override prefix
-  if (settings.allowOverride && settings.overridePrefix) {
-    const lowerPrompt = userPrompt.toLowerCase().trim();
-    if (lowerPrompt.startsWith(settings.overridePrefix.toLowerCase())) {
-      return { skipped: true, reason: 'override_prefix' };
-    }
-  }
-
-  // Check for explicit command invocation (skip detection)
-  if (/^\/\w+/.test(userPrompt.trim())) {
-    return { skipped: true, reason: 'explicit_command' };
-  }
-
-  // Score each workflow
-  const scores = [];
-
-  for (const [workflowId, workflow] of Object.entries(workflows)) {
-    let score = 0;
-    let matchedPatterns = [];
-    let excludeMatched = false;
-
-    // Check exclude patterns first
-    if (workflow.excludePatterns && workflow.excludePatterns.length > 0) {
-      for (const pattern of workflow.excludePatterns) {
-        try {
-          if (new RegExp(pattern, 'i').test(userPrompt)) {
-            excludeMatched = true;
-            break;
-          }
-        } catch (e) {
-          // Invalid regex, skip
-        }
-      }
-    }
-
-    if (excludeMatched) continue;
-
-    // Check trigger patterns
-    if (workflow.triggerPatterns && workflow.triggerPatterns.length > 0) {
-      for (const pattern of workflow.triggerPatterns) {
-        try {
-          const regex = new RegExp(pattern, 'i');
-          if (regex.test(userPrompt)) {
-            score += 10;
-            matchedPatterns.push(pattern);
-          }
-        } catch (e) {
-          // Invalid regex, skip
-        }
-      }
-    }
-
-    if (score > 0) {
-      scores.push({
-        workflowId,
-        workflow,
-        score,
-        matchedPatterns,
-        adjustedScore: score - (workflow.priority || 50) // Lower priority number = higher preference
-      });
-    }
-  }
-
-  if (scores.length === 0) {
-    return { detected: false };
-  }
-
-  // Sort by adjusted score (highest first)
-  scores.sort((a, b) => b.adjustedScore - a.adjustedScore);
-
-  const best = scores[0];
-  const confidence = Math.min(100, best.score * 10);
-
-  return {
-    detected: true,
-    workflowId: best.workflowId,
-    workflow: best.workflow,
-    confidence,
-    matchedPatterns: best.matchedPatterns,
-    alternatives: scores.slice(1, 3).map(s => s.workflowId)
-  };
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// OUTPUT GENERATION
-// ═══════════════════════════════════════════════════════════════════════════
-
-function buildWorkflowInstructions(detection, config) {
-  const { workflow, workflowId, confidence, alternatives } = detection;
-  const { settings, commandMapping } = config;
-
-  const lines = [];
-
-  // Header
-  lines.push('');
-  lines.push('## Workflow Detected');
-  lines.push('');
-
-  // Detection info
-  lines.push(`**Intent:** ${workflow.name} (${confidence}% confidence)`);
-  if (workflow.description) {
-    lines.push(`**Description:** ${workflow.description}`);
-  }
-
-  // Workflow sequence
-  const sequenceDisplay = workflow.sequence.map(step => {
-    const cmd = commandMapping[step];
-    return cmd?.claude || `/${step}`;
-  }).join(' → ');
-
-  lines.push(`**Workflow:** ${sequenceDisplay}`);
-  lines.push('');
-
-  // Instructions
-  if (workflow.confirmFirst && settings.confirmHighImpact) {
-    lines.push('### Instructions (MUST FOLLOW)');
-    lines.push('');
-    lines.push('1. **FIRST:** Announce the detected workflow to the user:');
-    lines.push(`   > "Detected: **${workflow.name}** workflow. I will follow: ${sequenceDisplay}"`);
-    lines.push('');
-    lines.push('2. **ASK:** "Proceed with this workflow? (yes/no/quick)"');
-    lines.push('   - "yes" → Execute full workflow');
-    lines.push('   - "no" → Ask what they want instead');
-    lines.push('   - "quick" → Skip workflow, handle directly');
-    lines.push('');
-    lines.push('3. **THEN:** Execute each step in sequence, using the appropriate slash command');
-    lines.push('');
-  } else {
-    lines.push('### Instructions (MUST FOLLOW)');
-    lines.push('');
-    lines.push('1. **ANNOUNCE:** Tell the user:');
-    lines.push(`   > "Detected: **${workflow.name}** workflow. Following: ${sequenceDisplay}"`);
-    lines.push('');
-    lines.push('2. **EXECUTE:** Follow the workflow sequence, using each slash command in order');
-    lines.push('');
-  }
-
-  // Step details
-  lines.push('### Workflow Steps');
-  lines.push('');
-  workflow.sequence.forEach((step, index) => {
-    const cmd = commandMapping[step];
-    const claudeCmd = cmd?.claude || `/${step}`;
-    lines.push(`${index + 1}. \`${claudeCmd}\` - ${getStepDescription(step)}`);
-  });
-  lines.push('');
-
-  // Alternatives
-  if (alternatives && alternatives.length > 0) {
-    lines.push(`*Alternative workflows detected: ${alternatives.join(', ')}*`);
-    lines.push('');
-  }
-
-  // Override hint
-  if (settings.allowOverride && settings.overridePrefix) {
-    lines.push(`*To skip workflow detection, prefix your message with "${settings.overridePrefix}"*`);
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-function getStepDescription(step) {
-  const descriptions = {
-    plan: 'Create implementation plan',
-    cook: 'Implement the feature',
-    code: 'Execute existing plan',
-    test: 'Run tests and verify',
-    fix: 'Apply fixes',
-    debug: 'Investigate and diagnose',
-    'code-review': 'Review code quality',
-    'dual-pass-review': 'Dual-pass review (first pass + conditional second pass)',
-    'docs-update': 'Update documentation',
-    watzup: 'Summarize changes',
-    scout: 'Explore codebase',
-    investigate: 'Deep dive analysis'
-  };
-  return descriptions[step] || `Execute ${step}`;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// MAIN EXECUTION
-// ═══════════════════════════════════════════════════════════════════════════
-
-async function main() {
-  try {
-    const stdin = fs.readFileSync(0, 'utf-8').trim();
-    if (!stdin) process.exit(0);
-
-    const payload = JSON.parse(stdin);
-    const userPrompt = payload.prompt || '';
-
-    if (!userPrompt.trim()) process.exit(0);
-
-    const config = loadWorkflowConfig();
-
-    // Check if workflow detection is enabled
-    if (!config.settings?.enabled) process.exit(0);
-
-    // Detect intent
-    const detection = detectIntent(userPrompt, config);
-
-    // Skip if no workflow detected or skipped
-    if (detection.skipped) {
-      if (config.settings.showDetection) {
-        console.log(`<!-- Workflow detection skipped: ${detection.reason} -->`);
-      }
-      process.exit(0);
-    }
-
-    if (!detection.detected) {
-      process.exit(0);
-    }
-
-    // Generate and output instructions
-    const instructions = buildWorkflowInstructions(detection, config);
-    console.log(instructions);
-
-    process.exit(0);
-  } catch (error) {
-    // Non-blocking - just log and exit
-    console.error(`<!-- Workflow router error: ${error.message} -->`);
-    process.exit(0);
-  }
-}
-
-main();

package/templates/hooks/write-compact-marker.cjs

@@ -1,159 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * PreCompact Hook: Write session-specific marker file when conversation is compacted
- * Also records calibration data for accurate compact threshold estimation
- *
- * Fixes #178: Uses /tmp/ck/ namespace for temp files
- *
- * Features:
- * - Session-specific markers for concurrent conversation support
- * - Calibration recording for self-improving threshold accuracy
- */
-
-const fs = require('fs');
-const {
-  MARKERS_DIR,
-  CALIBRATION_PATH,
-  DEBUG_DIR,
-  ensureDir,
-  getMarkerPath,
-  getDebugLogPath
-} = require('./lib/ck-paths.cjs');
-
-/**
- * Read existing calibration data
- * @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 - start fresh
-  }
-  return {};
-}
-
-/**
- * Write calibration data
- * @param {Object} data - Calibration data to save
- */
-function writeCalibration(data) {
-  try {
-    ensureDir(MARKERS_DIR); // Ensure parent dir exists
-    fs.writeFileSync(CALIBRATION_PATH, JSON.stringify(data, null, 2));
-  } catch (err) {
-    // Silent fail - calibration is optional
-  }
-}
-
-/**
- * Update calibration with new compact observation
- * Uses exponential moving average to smooth out variations
- *
- * @param {number} contextWindowSize - Model's context window size
- * @param {number} tokensAtCompact - Total tokens when compact triggered
- */
-function updateCalibration(contextWindowSize, tokensAtCompact) {
-  if (!contextWindowSize || !tokensAtCompact || tokensAtCompact <= 0) {
-    return;
-  }
-
-  const calibration = readCalibration();
-  const key = String(contextWindowSize);
-
-  // EMA alpha: 0.3 gives 70% weight to historical average, 30% to new observation
-  // Chosen to smooth out variations while adapting to pattern changes within ~3-4 observations
-  const CALIBRATION_ALPHA = 0.3;
-
-  if (calibration[key]) {
-    const alpha = CALIBRATION_ALPHA;
-    const oldThreshold = calibration[key].threshold;
-    const newThreshold = Math.floor(alpha * tokensAtCompact + (1 - alpha) * oldThreshold);
-
-    calibration[key] = {
-      threshold: newThreshold,
-      samples: calibration[key].samples + 1,
-      lastUpdated: Date.now(),
-      lastObserved: tokensAtCompact
-    };
-  } else {
-    // First observation for this window size
-    calibration[key] = {
-      threshold: tokensAtCompact,
-      samples: 1,
-      lastUpdated: Date.now(),
-      lastObserved: tokensAtCompact
-    };
-  }
-
-  writeCalibration(calibration);
-}
-
-/**
- * Append debug info to session-specific log file
- */
-function debugLog(sessionId, message) {
-  try {
-    ensureDir(DEBUG_DIR);
-    const logPath = getDebugLogPath(sessionId);
-    const timestamp = new Date().toISOString();
-    fs.appendFileSync(logPath, `[${timestamp}] ${message}\n`);
-  } catch (err) {
-    // Silent fail
-  }
-}
-
-// Read JSON from stdin (PreCompact payload)
-let input = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => input += chunk);
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(input);
-
-    // Use 'default' as fallback (must match statusline.cjs)
-    const sessionId = data.session_id || 'default';
-
-    // Log received payload for debugging
-    debugLog(sessionId, `PreCompact payload: ${JSON.stringify(data)}`);
-
-    // Ensure marker directory exists
-    ensureDir(MARKERS_DIR);
-
-    // Write session-specific marker for statusline detection
-    // baselineRecorded: false means statusline should record cumulative baseline on first read
-    const markerPath = getMarkerPath(sessionId);
-    const marker = {
-      sessionId: sessionId,
-      trigger: data.trigger || 'unknown',
-      baselineRecorded: false,  // Statusline will record cumulative total as baseline
-      baseline: 0,              // Will be set by statusline on first read
-      lastTokenTotal: 0,        // For token drop detection
-      timestamp: Date.now()
-    };
-    fs.writeFileSync(markerPath, JSON.stringify(marker));
-
-    debugLog(sessionId, `Baseline marker created at ${markerPath}`);
-
-    // Record calibration data for threshold learning
-    const contextInput = data.context_window?.total_input_tokens || 0;
-    const contextOutput = data.context_window?.total_output_tokens || 0;
-    const contextSize = data.context_window?.context_window_size || 0;
-
-    if (contextSize > 0) {
-      const tokensAtCompact = contextInput + contextOutput;
-      updateCalibration(contextSize, tokensAtCompact);
-      debugLog(sessionId, `Calibration updated: ${contextSize} -> ${tokensAtCompact}`);
-    } else {
-      debugLog(sessionId, `No context_window data in payload`);
-    }
-
-  } catch (err) {
-    debugLog('error', `Error: ${err.message}`);
-    // Silent fail - don't break the compact
-  }
-});