@pcircle/memesh 2.8.11 → 2.9.1

package/scripts/hooks/post-commit.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+
+/**
+ * PostCommit Hook - Auto-save commit context to MeMesh Knowledge Graph
+ *
+ * Registered as a PostToolUse hook. Detects git commit commands and
+ * saves the commit details (message, files changed, diff summary)
+ * to the MeMesh knowledge graph for future recall.
+ *
+ * Commit saving runs silently. Plan progress prints a timeline to stderr.
+ */
+
+import {
+  MEMESH_DB_PATH,
+  readStdin,
+  sqliteBatchEntity,
+  getDateString,
+  logError,
+  logMemorySave,
+  queryActivePlans,
+  matchCommitToStep,
+  addObservation,
+  updateEntityMetadata,
+  updateEntityTag,
+  createRelation,
+  renderTimeline,
+} from './hook-utils.js';
+import fs from 'fs';
+import { execFileSync } from 'child_process';
+
+// ============================================================================
+// Git Commit Detection
+// ============================================================================
+
+/**
+ * Check if a Bash tool call is a git commit
+ * @param {Object} toolData - Normalized tool data
+ * @returns {boolean}
+ */
+function isGitCommit(toolData) {
+  if (toolData.toolName !== 'Bash') return false;
+  if (!toolData.success) return false;
+
+  const cmd = toolData.arguments?.command || '';
+  return /git\s+commit\s/.test(cmd) && !cmd.includes('--amend');
+}
+
+// ============================================================================
+// Git Info Extraction
+// ============================================================================
+
+/**
+ * Extract latest commit details using git CLI
+ * @returns {{ hash: string, subject: string, body: string, filesChanged: string[], diffStat: string } | null}
+ */
+function getLatestCommitInfo() {
+  try {
+    // Get commit hash and message
+    const logOutput = execFileSync('git', [
+      'log', '-1',
+      '--format=%H%n%s%n%b',
+    ], { encoding: 'utf-8', timeout: 5000 }).trim();
+
+    const lines = logOutput.split('\n');
+    const hash = lines[0] || '';
+    const subject = lines[1] || '';
+    const body = lines.slice(2).join('\n').trim();
+
+    // Get files changed
+    const diffNameOnly = execFileSync('git', [
+      'diff-tree', '--no-commit-id', '--name-only', '-r', 'HEAD',
+    ], { encoding: 'utf-8', timeout: 5000 }).trim();
+
+    const filesChanged = diffNameOnly ? diffNameOnly.split('\n').filter(Boolean) : [];
+
+    // Get diff stat (compact summary)
+    const diffStat = execFileSync('git', [
+      'diff-tree', '--no-commit-id', '--stat', 'HEAD',
+    ], { encoding: 'utf-8', timeout: 5000 }).trim();
+
+    return { hash, subject, body, filesChanged, diffStat };
+  } catch (error) {
+    logError('getLatestCommitInfo', error);
+    return null;
+  }
+}
+
+// ============================================================================
+// MeMesh KG Save
+// ============================================================================
+
+/**
+ * Save commit context to MeMesh knowledge graph.
+ * Uses sqliteBatchEntity for performance (3 spawns instead of 8+).
+ * @param {Object} commitInfo - Commit details
+ * @returns {boolean} True if saved
+ */
+function saveCommitToKG(commitInfo) {
+  try {
+    if (!fs.existsSync(MEMESH_DB_PATH)) {
+      return false;
+    }
+
+    const { hash, subject, body, filesChanged, diffStat } = commitInfo;
+    const shortHash = hash.substring(0, 7);
+    const entityName = `Commit ${shortHash}: ${subject}`;
+
+    // Build observations
+    const observations = [];
+    observations.push(`Commit: ${shortHash} - ${subject}`);
+
+    if (body) {
+      observations.push(`Details: ${body.substring(0, 200)}`);
+    }
+
+    if (filesChanged.length > 0) {
+      const fileList = filesChanged.length <= 10
+        ? filesChanged.join(', ')
+        : `${filesChanged.slice(0, 10).join(', ')} (+${filesChanged.length - 10} more)`;
+      observations.push(`Files changed (${filesChanged.length}): ${fileList}`);
+    }
+
+    // Group files by directory for context
+    if (filesChanged.length > 0) {
+      const dirs = {};
+      filesChanged.forEach(f => {
+        const dir = f.split('/').slice(0, 2).join('/');
+        dirs[dir] = (dirs[dir] || 0) + 1;
+      });
+      const areaSummary = Object.entries(dirs)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([dir, count]) => `${dir} (${count})`)
+        .join(', ');
+      observations.push(`Areas: ${areaSummary}`);
+    }
+
+    if (diffStat) {
+      const statLines = diffStat.split('\n');
+      const summaryLine = statLines[statLines.length - 1]?.trim();
+      if (summaryLine) {
+        observations.push(`Stats: ${summaryLine}`);
+      }
+    }
+
+    // Batch: entity + observations + tags in 2 process spawns (was 8+)
+    const metadata = JSON.stringify({
+      hash: shortHash,
+      fullHash: hash,
+      filesCount: filesChanged.length,
+      source: 'post-commit-hook',
+    });
+
+    const tags = ['commit', 'auto-tracked', `date:${getDateString()}`, 'scope:project'];
+
+    const entityId = sqliteBatchEntity(
+      MEMESH_DB_PATH,
+      { name: entityName, type: 'commit', metadata },
+      observations,
+      tags
+    );
+
+    if (entityId === null) return false;
+
+    logMemorySave(`Commit saved: ${shortHash} - ${subject} (${filesChanged.length} files)`);
+    return true;
+  } catch (error) {
+    logError('saveCommitToKG', error);
+    return false;
+  }
+}
+
+// ============================================================================
+// Plan Progress Tracking (Beta)
+// ============================================================================
+
+/**
+ * Match commit to active plan steps and update progress.
+ * Prints Style B timeline to stderr (visible to user).
+ * @param {Object} commitInfo - Commit details from git
+ * @param {boolean} commitEntitySaved - Whether commit entity was saved to KG
+ */
+function updatePlanProgress(commitInfo, commitEntitySaved = false) {
+  try {
+    const activePlans = queryActivePlans(MEMESH_DB_PATH);
+    if (activePlans.length === 0) return;
+
+    const { hash, subject, filesChanged } = commitInfo;
+    const shortHash = hash.substring(0, 7);
+    const commitEntityName = `Commit ${shortHash}: ${subject}`;
+
+    for (const plan of activePlans) {
+      const stepsDetail = plan.metadata?.stepsDetail;
+      if (!stepsDetail || stepsDetail.length === 0) continue;
+
+      const matchResult = matchCommitToStep(
+        { subject, filesChanged },
+        stepsDetail
+      );
+
+      if (!matchResult) continue;
+
+      const { step: matched, confidence } = matchResult;
+
+      // Update step as completed
+      const updatedSteps = stepsDetail.map(s =>
+        s.number === matched.number
+          ? { ...s, completed: true, commitHash: shortHash, date: getDateString(), confidence }
+          : s
+      );
+      const rawCompleted = updatedSteps.filter(s => s.completed).length;
+      const newCompleted = Math.min(rawCompleted, plan.metadata.totalSteps);
+
+      // Update entity metadata
+      updateEntityMetadata(MEMESH_DB_PATH, plan.name, {
+        ...plan.metadata,
+        completed: newCompleted,
+        stepsDetail: updatedSteps,
+        status: newCompleted >= plan.metadata.totalSteps ? 'completed' : 'active',
+      });
+
+      // Add completion observation
+      addObservation(MEMESH_DB_PATH, plan.name,
+        `\u2705 Step ${matched.number} completed by ${shortHash} (${getDateString()})`
+      );
+
+      // Create relation: commit → plan (only if commit entity exists in KG)
+      if (commitEntitySaved) {
+        createRelation(MEMESH_DB_PATH, commitEntityName, plan.name, 'depends_on');
+      }
+
+      // If all steps completed, swap tag and create lesson_learned
+      if (newCompleted === plan.metadata.totalSteps) {
+        updateEntityTag(MEMESH_DB_PATH, plan.name, 'active', 'completed');
+        addObservation(MEMESH_DB_PATH, plan.name,
+          `\ud83c\udf89 Plan completed on ${getDateString()}`
+        );
+
+        // Auto-create lesson_learned entity for the completed plan
+        const planName = plan.name.replace('Plan: ', '');
+        const completedSteps = updatedSteps.filter(s => s.completed);
+        const lessonObs = [
+          `Plan "${planName}" completed (${plan.metadata.totalSteps} steps)`,
+          `Steps: ${completedSteps.map(s => s.description).join(', ')}`,
+          `Commits: ${completedSteps.filter(s => s.commitHash).map(s => s.commitHash).join(', ')}`,
+        ];
+        sqliteBatchEntity(MEMESH_DB_PATH,
+          { name: `Lesson: ${planName} completed`, type: 'lesson_learned', metadata: '{}' },
+          lessonObs,
+          ['lesson', 'plan-completion', `plan:${planName}`, 'scope:project']
+        );
+      }
+
+      // Print timeline to stderr (visible to user — stdout goes to transcript)
+      const timelinePlan = {
+        ...plan,
+        metadata: { ...plan.metadata, completed: newCompleted, stepsDetail: updatedSteps },
+        _lastCommit: shortHash,
+        _matchConfidence: confidence,
+      };
+      console.error('\n' + renderTimeline(timelinePlan, matched.number) + '\n');
+
+      logMemorySave(`Plan progress: ${plan.name} ${newCompleted}/${plan.metadata.totalSteps}`);
+    }
+  } catch (error) {
+    logError('updatePlanProgress', error);
+  }
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function postCommit() {
+  try {
+    const input = await readStdin(3000);
+    if (!input || input.trim() === '') {
+      process.exit(0);
+    }
+
+    const rawData = JSON.parse(input);
+    const toolData = {
+      toolName: rawData.tool_name || rawData.toolName || 'unknown',
+      arguments: rawData.tool_input || rawData.arguments || {},
+      success: rawData.success !== false,
+    };
+
+    // Only act on successful git commits
+    if (!isGitCommit(toolData)) {
+      process.exit(0);
+    }
+
+    // Extract commit info and save
+    const commitInfo = getLatestCommitInfo();
+    if (commitInfo) {
+      const saved = saveCommitToKG(commitInfo);
+      updatePlanProgress(commitInfo, saved);
+    }
+
+    process.exit(0);
+  } catch (error) {
+    logError('PostCommit', error);
+    process.exit(0); // Never block Claude Code on hook errors
+  }
+}
+
+postCommit();