memorix 1.4.3 → 1.4.4

package/src/git/hooks-path.ts

@@ -1,85 +1,85 @@
-/**
- * Git hooks path resolver — worktree-safe.
- *
- * In a normal repo:   .git is a directory  → hooks at .git/hooks/
- * In a git worktree:  .git is a FILE containing "gitdir: /path/to/actual/git/dir"
- *                     → hooks at that resolved path + /hooks/
- *
- * This utility ensures all hook install/uninstall/check operations
- * work correctly in both scenarios.
- */
-
-import { existsSync, readFileSync, statSync, mkdirSync } from 'node:fs';
-import path from 'node:path';
-
-/**
- * Resolve the actual .git directory path, following worktree indirection.
- *
- * @param projectRoot - The root of the working tree (where .git lives)
- * @returns Absolute path to the real git dir, or null if no .git found
- */
-export function resolveGitDir(projectRoot: string): string | null {
-  const dotGit = path.join(projectRoot, '.git');
-
-  if (!existsSync(dotGit)) return null;
-
-  const stat = statSync(dotGit);
-
-  if (stat.isDirectory()) {
-    // Normal repo — .git is a directory
-    return dotGit;
-  }
-
-  if (stat.isFile()) {
-    // Worktree — .git is a file: "gitdir: /path/to/actual/git/dir"
-    try {
-      const content = readFileSync(dotGit, 'utf-8').trim();
-      const match = content.match(/^gitdir:\s*(.+)$/);
-      if (match) {
-        const gitdir = match[1].trim();
-        // Resolve relative paths against the project root
-        const resolved = path.isAbsolute(gitdir)
-          ? gitdir
-          : path.resolve(projectRoot, gitdir);
-        if (existsSync(resolved)) {
-          return resolved;
-        }
-      }
-    } catch {
-      // Unreadable .git file — fall through
-    }
-  }
-
-  return null;
-}
-
-/**
- * Resolve the hooks directory for a project (read-only — does NOT create directories).
- * Handles both normal repos and git worktrees.
- *
- * @param projectRoot - The root of the working tree
- * @returns Object with hooksDir and hookPath for post-commit, or null if no .git found
- */
-export function resolveHooksDir(projectRoot: string): { hooksDir: string; hookPath: string } | null {
-  const gitDir = resolveGitDir(projectRoot);
-  if (!gitDir) return null;
-
-  const hooksDir = path.join(gitDir, 'hooks');
-
-  return {
-    hooksDir,
-    hookPath: path.join(hooksDir, 'post-commit'),
-  };
-}
-
-/**
- * Resolve hooks directory AND ensure it exists on disk.
- * Use this only in write paths (hook install / autoHook).
- */
-export function ensureHooksDir(projectRoot: string): { hooksDir: string; hookPath: string } | null {
-  const resolved = resolveHooksDir(projectRoot);
-  if (!resolved) return null;
-
-  mkdirSync(resolved.hooksDir, { recursive: true });
-  return resolved;
-}
+/**
+ * Git hooks path resolver — worktree-safe.
+ *
+ * In a normal repo:   .git is a directory  → hooks at .git/hooks/
+ * In a git worktree:  .git is a FILE containing "gitdir: /path/to/actual/git/dir"
+ *                     → hooks at that resolved path + /hooks/
+ *
+ * This utility ensures all hook install/uninstall/check operations
+ * work correctly in both scenarios.
+ */
+
+import { existsSync, readFileSync, statSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Resolve the actual .git directory path, following worktree indirection.
+ *
+ * @param projectRoot - The root of the working tree (where .git lives)
+ * @returns Absolute path to the real git dir, or null if no .git found
+ */
+export function resolveGitDir(projectRoot: string): string | null {
+  const dotGit = path.join(projectRoot, '.git');
+
+  if (!existsSync(dotGit)) return null;
+
+  const stat = statSync(dotGit);
+
+  if (stat.isDirectory()) {
+    // Normal repo — .git is a directory
+    return dotGit;
+  }
+
+  if (stat.isFile()) {
+    // Worktree — .git is a file: "gitdir: /path/to/actual/git/dir"
+    try {
+      const content = readFileSync(dotGit, 'utf-8').trim();
+      const match = content.match(/^gitdir:\s*(.+)$/);
+      if (match) {
+        const gitdir = match[1].trim();
+        // Resolve relative paths against the project root
+        const resolved = path.isAbsolute(gitdir)
+          ? gitdir
+          : path.resolve(projectRoot, gitdir);
+        if (existsSync(resolved)) {
+          return resolved;
+        }
+      }
+    } catch {
+      // Unreadable .git file — fall through
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Resolve the hooks directory for a project (read-only — does NOT create directories).
+ * Handles both normal repos and git worktrees.
+ *
+ * @param projectRoot - The root of the working tree
+ * @returns Object with hooksDir and hookPath for post-commit, or null if no .git found
+ */
+export function resolveHooksDir(projectRoot: string): { hooksDir: string; hookPath: string } | null {
+  const gitDir = resolveGitDir(projectRoot);
+  if (!gitDir) return null;
+
+  const hooksDir = path.join(gitDir, 'hooks');
+
+  return {
+    hooksDir,
+    hookPath: path.join(hooksDir, 'post-commit'),
+  };
+}
+
+/**
+ * Resolve hooks directory AND ensure it exists on disk.
+ * Use this only in write paths (hook install / autoHook).
+ */
+export function ensureHooksDir(projectRoot: string): { hooksDir: string; hookPath: string } | null {
+  const resolved = resolveHooksDir(projectRoot);
+  if (!resolved) return null;
+
+  mkdirSync(resolved.hooksDir, { recursive: true });
+  return resolved;
+}

package/src/hooks/pattern-detector.ts

@@ -1,173 +1,173 @@
-/**
- * Pattern Detector
- *
- * Analyzes text content to detect patterns worth remembering.
- * Inspired by mcp-memory-service's Smart Auto-Capture,
- * but works across all agents via the unified hooks system.
- */
-
-import type { DetectedPattern, PatternType } from './types.js';
-
-/** Minimum content length to consider for pattern detection */
-const MIN_CONTENT_LENGTH = 100;
-
-/** Pattern definitions with multilingual keywords */
-const PATTERNS: Array<{
-  type: PatternType;
-  keywords: RegExp[];
-  minLength: number;
-  baseConfidence: number;
-}> = [
-    {
-      type: 'decision',
-      keywords: [
-        /\b(decided|chose|will use|settled on|going with|picked|selected)\b/i,
-        /(决定|选择了|采用|确定用|最终选了)/,
-        /\b(architecture|approach|strategy|pattern|framework)\b/i,
-      ],
-      minLength: 100,
-      baseConfidence: 0.8,
-    },
-    {
-      type: 'error',
-      keywords: [
-        /\b(error|bug|fix(ed)?|resolv(ed|ing)|crash|fail(ed|ure)?|broken)\b/i,
-        /(错误|修复|报错|崩溃|失败|异常|解决了)/,
-        /\b(workaround|hotfix|patch|regression|stack\s*trace)\b/i,
-      ],
-      minLength: 100,
-      baseConfidence: 0.75,
-    },
-    {
-      type: 'gotcha',
-      keywords: [
-        /\b(gotcha|pitfall|trap|caveat|watch out|careful|beware|warning)\b/i,
-        /(坑|注意|陷阱|小心|踩坑|坑点)/,
-        /\b(don'?t|never|avoid|must not|不要|千万别|切记)\b/i,
-      ],
-      minLength: 80,
-      baseConfidence: 0.85,
-    },
-    {
-      type: 'configuration',
-      keywords: [
-        /\b(config(ured?|uration)?|setting|environment|\.env)\b/i,
-        /(配置|环境变量|端口配置|设置项|安装配置)/,
-        /\b(gradle|webpack|vite|tsconfig|package\.json|docker|nginx)\b/i,
-        /\b(port\s*[:=]|listen\s+\d|bind\s+\d|DATABASE_URL|API_KEY)\b/i,
-      ],
-      minLength: 80,
-      baseConfidence: 0.7,
-    },
-    {
-      type: 'learning',
-      keywords: [
-        /\b(learn(ed)?|discover(ed)?|realiz(ed)?|turns?\s*out|found\s*out|TIL)\b/i,
-        /(学到|发现|原来|才知道|了解到)/,
-        /\b(insight|understanding|clarif(ied|ication))\b/i,
-      ],
-      minLength: 150,
-      baseConfidence: 0.65,
-    },
-    {
-      type: 'implementation',
-      keywords: [
-        /\b(implement(ed)?|creat(ed|ing)|built|added|integrat(ed|ing))\b/i,
-        /(实现了|创建了|添加了|集成了|完成了)/,
-        /\b(refactor(ed)?|migrat(ed|ing)|upgrad(ed|ing))\b/i,
-      ],
-      minLength: 200,
-      baseConfidence: 0.5,
-    },
-    {
-      type: 'deployment',
-      keywords: [
-        /\b(deploy(ed|ing|ment)?|ship(ped|ping)?|releas(ed|ing)|publish(ed|ing)?)\b/i,
-        /(部署|发布|上线|迁移|运维)/,
-        /\b(docker|compose|container|kubernetes|k8s|helm)\b/i,
-        /\b(VPS|server|host(ing)?|cloud|AWS|Azure|GCP|Cloudflare)\b/i,
-        /\b(nginx|caddy|apache|reverse.?proxy|load.?balanc)\b/i,
-        /\b(SSL|TLS|cert(ificate)?|HTTPS|Let'?s?.?Encrypt|ACME)\b/i,
-        /\b(DNS|domain|A.?record|CNAME|nameserver|Cloudflare)\b/i,
-        /\b(CI\/CD|pipeline|GitHub.?Actions|Jenkins|GitLab.?CI)\b/i,
-        /\b(scp|rsync|ssh|sftp|systemd|systemctl|service)\b/i,
-        /(服务器|域名|证书|反向代理|负载均衡|镜像|容器)/,
-      ],
-      minLength: 80,
-      baseConfidence: 0.75,
-    },
-  ];
-
-/**
- * Detect patterns in text content.
- * Returns matched patterns sorted by confidence (highest first).
- */
-export function detectPatterns(content: string): DetectedPattern[] {
-  if (!content || content.length < MIN_CONTENT_LENGTH) {
-    return [];
-  }
-
-  const results: DetectedPattern[] = [];
-
-  for (const pattern of PATTERNS) {
-    if (content.length < pattern.minLength) continue;
-
-    const matchedKeywords: string[] = [];
-    let matchCount = 0;
-
-    for (const regex of pattern.keywords) {
-      const matches = content.match(new RegExp(regex.source, regex.flags + 'g'));
-      if (matches) {
-        matchCount += matches.length;
-        matchedKeywords.push(...matches.map((m) => m.trim()));
-      }
-    }
-
-    if (matchCount > 0) {
-      // Confidence increases with more keyword matches (up to 1.0)
-      const confidence = Math.min(1.0, pattern.baseConfidence + matchCount * 0.05);
-      results.push({
-        type: pattern.type,
-        confidence,
-        matchedKeywords: [...new Set(matchedKeywords)].slice(0, 5),
-      });
-    }
-  }
-
-  // Sort by confidence descending
-  results.sort((a, b) => b.confidence - a.confidence);
-
-  return results;
-}
-
-/**
- * Get the best (highest confidence) pattern from content.
- * Returns null if no pattern is detected or confidence is too low.
- */
-export function detectBestPattern(
-  content: string,
-  minConfidence = 0.5,
-): DetectedPattern | null {
-  const patterns = detectPatterns(content);
-  if (patterns.length === 0) return null;
-  if (patterns[0].confidence < minConfidence) return null;
-  return patterns[0];
-}
-
-/**
- * Map pattern type → Memorix observation type.
- */
-export function patternToObservationType(
-  pattern: PatternType,
-): string {
-  const map: Record<PatternType, string> = {
-    decision: 'decision',
-    error: 'problem-solution',
-    gotcha: 'gotcha',
-    configuration: 'what-changed',
-    learning: 'discovery',
-    implementation: 'what-changed',
-    deployment: 'what-changed',
-  };
-  return map[pattern] ?? 'discovery';
-}
+/**
+ * Pattern Detector
+ *
+ * Analyzes text content to detect patterns worth remembering.
+ * Inspired by mcp-memory-service's Smart Auto-Capture,
+ * but works across all agents via the unified hooks system.
+ */
+
+import type { DetectedPattern, PatternType } from './types.js';
+
+/** Minimum content length to consider for pattern detection */
+const MIN_CONTENT_LENGTH = 100;
+
+/** Pattern definitions with multilingual keywords */
+const PATTERNS: Array<{
+  type: PatternType;
+  keywords: RegExp[];
+  minLength: number;
+  baseConfidence: number;
+}> = [
+    {
+      type: 'decision',
+      keywords: [
+        /\b(decided|chose|will use|settled on|going with|picked|selected)\b/i,
+        /(决定|选择了|采用|确定用|最终选了)/,
+        /\b(architecture|approach|strategy|pattern|framework)\b/i,
+      ],
+      minLength: 100,
+      baseConfidence: 0.8,
+    },
+    {
+      type: 'error',
+      keywords: [
+        /\b(error|bug|fix(ed)?|resolv(ed|ing)|crash|fail(ed|ure)?|broken)\b/i,
+        /(错误|修复|报错|崩溃|失败|异常|解决了)/,
+        /\b(workaround|hotfix|patch|regression|stack\s*trace)\b/i,
+      ],
+      minLength: 100,
+      baseConfidence: 0.75,
+    },
+    {
+      type: 'gotcha',
+      keywords: [
+        /\b(gotcha|pitfall|trap|caveat|watch out|careful|beware|warning)\b/i,
+        /(坑|注意|陷阱|小心|踩坑|坑点)/,
+        /\b(don'?t|never|avoid|must not|不要|千万别|切记)\b/i,
+      ],
+      minLength: 80,
+      baseConfidence: 0.85,
+    },
+    {
+      type: 'configuration',
+      keywords: [
+        /\b(config(ured?|uration)?|setting|environment|\.env)\b/i,
+        /(配置|环境变量|端口配置|设置项|安装配置)/,
+        /\b(gradle|webpack|vite|tsconfig|package\.json|docker|nginx)\b/i,
+        /\b(port\s*[:=]|listen\s+\d|bind\s+\d|DATABASE_URL|API_KEY)\b/i,
+      ],
+      minLength: 80,
+      baseConfidence: 0.7,
+    },
+    {
+      type: 'learning',
+      keywords: [
+        /\b(learn(ed)?|discover(ed)?|realiz(ed)?|turns?\s*out|found\s*out|TIL)\b/i,
+        /(学到|发现|原来|才知道|了解到)/,
+        /\b(insight|understanding|clarif(ied|ication))\b/i,
+      ],
+      minLength: 150,
+      baseConfidence: 0.65,
+    },
+    {
+      type: 'implementation',
+      keywords: [
+        /\b(implement(ed)?|creat(ed|ing)|built|added|integrat(ed|ing))\b/i,
+        /(实现了|创建了|添加了|集成了|完成了)/,
+        /\b(refactor(ed)?|migrat(ed|ing)|upgrad(ed|ing))\b/i,
+      ],
+      minLength: 200,
+      baseConfidence: 0.5,
+    },
+    {
+      type: 'deployment',
+      keywords: [
+        /\b(deploy(ed|ing|ment)?|ship(ped|ping)?|releas(ed|ing)|publish(ed|ing)?)\b/i,
+        /(部署|发布|上线|迁移|运维)/,
+        /\b(docker|compose|container|kubernetes|k8s|helm)\b/i,
+        /\b(VPS|server|host(ing)?|cloud|AWS|Azure|GCP|Cloudflare)\b/i,
+        /\b(nginx|caddy|apache|reverse.?proxy|load.?balanc)\b/i,
+        /\b(SSL|TLS|cert(ificate)?|HTTPS|Let'?s?.?Encrypt|ACME)\b/i,
+        /\b(DNS|domain|A.?record|CNAME|nameserver|Cloudflare)\b/i,
+        /\b(CI\/CD|pipeline|GitHub.?Actions|Jenkins|GitLab.?CI)\b/i,
+        /\b(scp|rsync|ssh|sftp|systemd|systemctl|service)\b/i,
+        /(服务器|域名|证书|反向代理|负载均衡|镜像|容器)/,
+      ],
+      minLength: 80,
+      baseConfidence: 0.75,
+    },
+  ];
+
+/**
+ * Detect patterns in text content.
+ * Returns matched patterns sorted by confidence (highest first).
+ */
+export function detectPatterns(content: string): DetectedPattern[] {
+  if (!content || content.length < MIN_CONTENT_LENGTH) {
+    return [];
+  }
+
+  const results: DetectedPattern[] = [];
+
+  for (const pattern of PATTERNS) {
+    if (content.length < pattern.minLength) continue;
+
+    const matchedKeywords: string[] = [];
+    let matchCount = 0;
+
+    for (const regex of pattern.keywords) {
+      const matches = content.match(new RegExp(regex.source, regex.flags + 'g'));
+      if (matches) {
+        matchCount += matches.length;
+        matchedKeywords.push(...matches.map((m) => m.trim()));
+      }
+    }
+
+    if (matchCount > 0) {
+      // Confidence increases with more keyword matches (up to 1.0)
+      const confidence = Math.min(1.0, pattern.baseConfidence + matchCount * 0.05);
+      results.push({
+        type: pattern.type,
+        confidence,
+        matchedKeywords: [...new Set(matchedKeywords)].slice(0, 5),
+      });
+    }
+  }
+
+  // Sort by confidence descending
+  results.sort((a, b) => b.confidence - a.confidence);
+
+  return results;
+}
+
+/**
+ * Get the best (highest confidence) pattern from content.
+ * Returns null if no pattern is detected or confidence is too low.
+ */
+export function detectBestPattern(
+  content: string,
+  minConfidence = 0.5,
+): DetectedPattern | null {
+  const patterns = detectPatterns(content);
+  if (patterns.length === 0) return null;
+  if (patterns[0].confidence < minConfidence) return null;
+  return patterns[0];
+}
+
+/**
+ * Map pattern type → Memorix observation type.
+ */
+export function patternToObservationType(
+  pattern: PatternType,
+): string {
+  const map: Record<PatternType, string> = {
+    decision: 'decision',
+    error: 'problem-solution',
+    gotcha: 'gotcha',
+    configuration: 'what-changed',
+    learning: 'discovery',
+    implementation: 'what-changed',
+    deployment: 'what-changed',
+  };
+  return map[pattern] ?? 'discovery';
+}