memorix 1.1.7 → 1.1.9

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';
+}

package/src/hooks/rules/memorix-agent-rules.md

@@ -4,9 +4,9 @@ You have access to Memorix memory tools. Follow these rules to maintain persiste
 
 ## Use Memory When Useful
 
-At the beginning of a coding task, use Memorix when prior project context would materially help the task. A session bind is not required for every conversation.
+At the beginning of non-trivial coding work, use Memorix Memory Autopilot before local progress notes or broad file exploration. A session bind is not required for every conversation.
 
-1. For starting or continuing code work, call `memorix_project_context` with the user's actual task. Memorix will choose a task-lensed brief (bugfix, feature, release, onboarding, refactor, docs, test, or general). Treat its "Start here" files as the first code or docs to inspect.
+1. Default first step for non-trivial coding work: call `memorix_project_context` with the user's actual task before progress files, dev-log reads, ad-hoc file reads, or git archaeology. Memorix will choose a task-lensed brief (bugfix, feature, release, onboarding, refactor, docs, test, or general). Treat its "Start here" files as the first code or docs to inspect.
 2. If the MCP tool is not visible yet but the client supports tool discovery or dynamic loading, search/select `memorix_project_context` first. Run `memorix context --task "<task>"` only after MCP is unavailable, disabled, or not discoverable, and pass the user's real task text. Do not skip memory, wait indefinitely on MCP startup, or hand-write tool-call syntax.
 3. Use `memorix_context_pack` when you need structured refs and freshness for code-bound memories.
 4. For broad memory graph questions, call `memorix_graph_context` to get a compact background packet.