@pcircle/memesh 2.9.2 → 2.9.4

package/scripts/hooks/pre-tool-use.js

@@ -125,11 +125,21 @@ function mergeResponses(responses) {
 // Routing Config
 // ============================================================================
 
+/** Module-level cache for routing config (30-second TTL) */
+let _routingConfigCache = null;
+let _routingConfigTimestamp = 0;
+const ROUTING_CONFIG_TTL_MS = 30_000;
+
 /**
  * Load routing config with fallback defaults.
  * Creates default config if file doesn't exist.
+ * Results are cached for 30 seconds to avoid repeated file I/O.
  */
 function loadRoutingConfig() {
+  const now = Date.now();
+  if (_routingConfigCache && (now - _routingConfigTimestamp) < ROUTING_CONFIG_TTL_MS) {
+    return _routingConfigCache;
+  }
   const defaults = {
     version: 1,
     modelRouting: {
@@ -156,7 +166,10 @@ function loadRoutingConfig() {
   try {
     if (fs.existsSync(ROUTING_CONFIG_FILE)) {
       const config = JSON.parse(fs.readFileSync(ROUTING_CONFIG_FILE, 'utf-8'));
-      return { ...defaults, ...config };
+      const merged = { ...defaults, ...config };
+      _routingConfigCache = merged;
+      _routingConfigTimestamp = now;
+      return merged;
     }
   } catch (error) {
     logError('loadRoutingConfig', error);
@@ -173,6 +186,8 @@ function loadRoutingConfig() {
     // Non-critical — works with in-memory defaults
   }
 
+  _routingConfigCache = defaults;
+  _routingConfigTimestamp = now;
   return defaults;
 }
 
@@ -185,10 +200,24 @@ function loadRoutingConfig() {
  * @param {string} entry - Log entry
  * @param {Object} config - Routing config
  */
+const AUDIT_LOG_MAX_BYTES = 1_048_576; // 1 MB
+const AUDIT_LOG_KEEP_LINES = 500;
+
 function auditLog(entry, config) {
   if (!config.auditLog) return;
 
   try {
+    // Rotate if log exceeds 1 MB: keep only the last 500 lines
+    if (fs.existsSync(ROUTING_AUDIT_LOG)) {
+      const stat = fs.statSync(ROUTING_AUDIT_LOG);
+      if (stat.size > AUDIT_LOG_MAX_BYTES) {
+        const content = fs.readFileSync(ROUTING_AUDIT_LOG, 'utf-8');
+        const lines = content.split('\n');
+        const truncated = lines.slice(-AUDIT_LOG_KEEP_LINES).join('\n');
+        fs.writeFileSync(ROUTING_AUDIT_LOG, truncated);
+      }
+    }
+
     const timestamp = new Date().toISOString();
     const line = `[${timestamp}] ${entry}\n`;
     fs.appendFileSync(ROUTING_AUDIT_LOG, line);

package/scripts/hooks/session-start-recall-utils.js

@@ -0,0 +1,40 @@
+/**
+ * Session-Start Recall Utilities
+ *
+ * Utility functions for proactive memory recall during session start.
+ * Builds search queries from project context and formats recall results.
+ */
+
+/**
+ * Build FTS5 search query from project name and recent commits.
+ * Strips conventional commit prefixes (fix:, feat(scope):, etc.)
+ * @param {string} projectName
+ * @param {string[]} recentCommits
+ * @returns {string}
+ */
+export function buildSessionRecallQuery(projectName, recentCommits = []) {
+  const parts = [projectName];
+  if (recentCommits.length > 0) {
+    const cleaned = recentCommits
+      .map(msg => msg.replace(/^(fix|feat|chore|refactor|perf|docs|test|style|ci)\(?[^)]*\)?:\s*/i, '').trim())
+      .filter(msg => msg.length > 0);
+    parts.push(...cleaned);
+  }
+  return parts.join(' ').trim();
+}
+
+/**
+ * Format recall results for hook output display.
+ * Shows max 2 observations per entity.
+ * @param {Array<{name: string, observations: string[], similarity: number}>} results
+ * @returns {string} Formatted output (empty string if no results)
+ */
+export function formatRecallOutput(results) {
+  if (!results || results.length === 0) return '';
+  const lines = results.map(r => {
+    const pct = Math.round(r.similarity * 100);
+    const obs = r.observations.slice(0, 2).join('; ');
+    return `  - ${r.name} (${pct}%): ${obs}`;
+  });
+  return lines.join('\n');
+}

package/scripts/hooks/session-start.js

@@ -27,8 +27,10 @@ import {
   queryActivePlans,
   renderTimelineCompact,
 } from './hook-utils.js';
+import { buildSessionRecallQuery, formatRecallOutput } from './session-start-recall-utils.js';
 import fs from 'fs';
 import path from 'path';
+import { execFileSync } from 'child_process';
 
 // ============================================================================
 // File Paths
@@ -444,6 +446,67 @@ function displayActivePlans() {
   }
 }
 
+/**
+ * Proactive memory recall — queries KG for memories related to current project.
+ * Uses project name + last 3 git commits as search query.
+ */
+function recallProactiveMemories() {
+  try {
+    const projectName = path.basename(process.cwd());
+
+    let recentCommits = [];
+    try {
+      const gitOutput = execFileSync('git', ['log', '--oneline', '-3', '--format=%s'], {
+        timeout: 3000,
+        encoding: 'utf-8',
+        cwd: process.cwd(),
+      });
+      recentCommits = gitOutput.trim().split('\n').filter(Boolean);
+    } catch {
+      // Not a git repo or no commits
+    }
+
+    const query = buildSessionRecallQuery(projectName, recentCommits);
+    if (!query) return;
+
+    // Build FTS5 tokens
+    const ftsTokens = query.split(/\s+/)
+      .filter(t => t.length > 2)
+      .slice(0, 10)
+      .map(t => `"${t.replace(/"/g, '""')}"*`)
+      .join(' OR ');
+
+    if (!ftsTokens) return;
+
+    const sql = `
+      SELECT e.name, e.type,
+        (SELECT json_group_array(content) FROM observations o WHERE o.entity_id = e.id) as observations_json
+      FROM entities e
+      JOIN entities_fts ON entities_fts.rowid = e.id
+      WHERE entities_fts MATCH ?
+      ORDER BY bm25(entities_fts, 10.0, 5.0)
+      LIMIT 5
+    `;
+
+    const result = sqliteQueryJSON(MEMESH_DB_PATH, sql, [ftsTokens]);
+    if (!result || result.length === 0) return;
+
+    const formatted = result.map(r => ({
+      name: r.name,
+      observations: JSON.parse(r.observations_json || '[]').filter(Boolean).slice(0, 3),
+      similarity: 0.5,
+    }));
+
+    const output = formatRecallOutput(formatted);
+    if (output) {
+      console.log('\n  Proactive Memory Recall:');
+      console.log(output);
+    }
+  } catch (error) {
+    logError('proactive-recall', error);
+  }
+}
+
 function sessionStart() {
   console.log('\n🚀 Smart-Agents Session Started\n');
 
@@ -458,6 +521,9 @@ function sessionStart() {
   const recalledMemory = recallRecentKeyPoints();
   displayRecalledMemory(recalledMemory);
 
+  // Proactive memory recall (project context + recent commits)
+  recallProactiveMemories();
+
   // Display active plans (beta)
   displayActivePlans();
 

package/scripts/hooks/templates/planning-template.md

@@ -0,0 +1,46 @@
+## Required Plan Sections
+
+Your plan MUST include all of the following sections. Incomplete plans will be rejected.
+
+### 1. System Design Description (SDD)
+- Component architecture and responsibilities
+- Data flow between components
+- Interface contracts (input/output types)
+- Dependencies and integration points
+
+### 2. Behavior-Driven Design (BDD)
+For EACH feature, write Gherkin scenarios:
+
+```gherkin
+Scenario: [descriptive name]
+  Given [precondition]
+  When [action]
+  Then [expected outcome]
+```
+
+Cover: happy path, error path, edge cases.
+
+### 3. Edge Case Handling
+
+| Edge Case | How Handled | Test Coverage |
+|-----------|------------|---------------|
+| [case] | [strategy] | [yes/no] |
+
+Include at minimum: empty input, null/undefined, boundary values, concurrent access, timeout, large data.
+
+### 4. Dry-Run Test Plan
+Before dispatching heavy tasks, verify:
+- [ ] Core function compiles (`tsc --noEmit` or `node --check`)
+- [ ] Unit test for critical path passes
+- [ ] Integration point verified with real call
+- [ ] No regressions in existing tests
+
+### 5. Risk Assessment
+
+| Risk | Probability | Impact | Mitigation |
+|------|------------|--------|------------|
+| [risk] | High/Med/Low | High/Med/Low | [strategy] |
+
+---
+
+**IMPORTANT**: After completing this plan, present it to the user and wait for explicit approval before proceeding to implementation. Do NOT auto-execute.

package/scripts/postinstall-new.js

@@ -284,7 +284,14 @@ ${chalk.dim('Need help? Open an issue: https://github.com/PCIRCLE-AI/claude-code
   );
 
   // Exit with appropriate code
-  process.exit(allSuccess ? 0 : 0); // Non-fatal warnings still exit 0
+  // Critical failures (MCP config, plugin registration) → exit 1
+  // Non-critical failures (skills, symlink already exists) → exit 0
+  const hasCriticalFailure = !results.mcpConfigured && results.mode !== 'local';
+  const hasPluginFailure = !results.pluginEnabled;
+  if (hasCriticalFailure || hasPluginFailure) {
+    process.exit(1);
+  }
+  process.exit(0);
 }
 
 // ============================================================================