thanh-kit 2.5.0

package/templates/hooks/workflow-router.cjs

@@ -0,0 +1,326 @@
+#!/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

@@ -0,0 +1,159 @@
+#!/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
+  }
+});

package/templates/memory/session-log.md

@@ -0,0 +1,186 @@
+
+## Session Ended - 2025-12-20T12:20:50.962Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-20T12:29:41.467Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-20T16:19:14.363Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-20T16:25:25.086Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-20T16:36:47.738Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-23T13:05:47.890Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T08:13:36.265Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T08:19:15.569Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T08:30:36.642Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T08:54:32.981Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T11:34:08.922Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T11:38:41.978Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T11:53:15.159Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T11:59:04.430Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T12:06:44.071Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T12:24:11.940Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T12:33:52.403Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T12:55:29.114Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T12:57:58.800Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:07:26.337Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:14:21.188Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:23:50.461Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:35:31.708Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:45:59.379Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:47:15.154Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-24T22:58:17.355Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-28T02:19:43.058Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-28T03:47:18.977Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-28T06:43:05.591Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-28T06:53:44.627Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---
+
+## Session Ended - 2025-12-28T08:25:50.147Z
+- Branch: main
+- Directory: C:\GitSources\EasyPlatform
+
+---