memorix 1.4.3 → 1.4.5

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/installers/index.ts

@@ -360,6 +360,9 @@ const AGENT_SKILL_DIRS: Partial<Record<AgentName, { project: string; global?: st
   kiro: { project: path.join('.kiro', 'skills'), global: path.join('.kiro', 'skills') },
   opencode: { project: path.join('.opencode', 'skills'), global: path.join('.config', 'opencode', 'skills') },
   trae: { project: path.join('.trae', 'skills'), global: path.join('.trae', 'skills') },
+  // DSH's user skill root is <harness home>/skills; the global root below is
+  // resolved to $DSH_HOME (or ~/.dsh) for dsh by installOfficialSkillsForAgent.
+  dsh: { project: path.join('.dsh', 'skills'), global: 'skills' },
 };
 
 const PACKAGE_OWNED_HOOK_AGENTS = new Set<AgentName>(['openclaw', 'hermes', 'omp']);
@@ -384,7 +387,11 @@ async function installOfficialSkillsForAgent(
   const relativeDir = global ? dirs?.global : dirs?.project;
   if (!relativeDir) return [];
 
-  const root = global ? os.homedir() : projectRoot;
+  const root = global
+    ? (agent === 'dsh'
+      ? (process.env.DSH_HOME?.trim() || path.join(os.homedir(), '.dsh'))
+      : os.homedir())
+    : projectRoot;
   const skillPaths: string[] = [];
   for (const skillEntry of OFFICIAL_MEMORIX_SKILLS) {
     const skillPath = path.join(root, relativeDir, skillEntry.name, 'SKILL.md');
@@ -626,6 +633,9 @@ export function getProjectConfigPath(agent: AgentName, projectRoot: string): str
     case 'trae':
       // Trae has no hooks system — only rules (.trae/rules/project_rules.md)
       return path.join(projectRoot, '.trae', 'rules', 'project_rules.md');
+    case 'dsh':
+      // DeepSeek Harness has no hooks system — only guidance (AGENTS.md)
+      return path.join(projectRoot, 'AGENTS.md');
     case 'opencode':
       // OpenCode uses plugin files for hooks
       return path.join(projectRoot, '.opencode', 'plugins', 'memorix.js');
@@ -684,6 +694,9 @@ export function getGlobalConfigPath(agent: AgentName): string {
       return path.join(home, '.omp', 'agent', 'packages', 'memorix', 'extensions', 'memorix.js');
     case 'trae':
       return path.join(home, '.trae', 'rules', 'project_rules.md');
+    case 'dsh':
+      // DSH reads the user-global AGENTS.md from its harness home.
+      return path.join(process.env.DSH_HOME?.trim() || path.join(home, '.dsh'), 'AGENTS.md');
     default:
       return path.join(home, '.memorix', 'hooks.json');
   }
@@ -709,6 +722,9 @@ export function getAgentRulesPath(agent: AgentName, root: string, global = false
         return path.join(root, '.gemini', 'GEMINI.md');
       case 'trae':
         return path.join(root, '.trae', 'rules', 'project_rules.md');
+      case 'dsh':
+        // The user-global AGENTS.md lives in the harness home DSH reads.
+        return path.join(process.env.DSH_HOME?.trim() || path.join(root, '.dsh'), 'AGENTS.md');
       default:
         return path.join(root, '.agent', 'rules', 'memorix.md');
     }
@@ -734,6 +750,8 @@ export function getAgentRulesPath(agent: AgentName, root: string, global = false
       return path.join(root, 'GEMINI.md');
     case 'trae':
       return path.join(root, '.trae', 'rules', 'project_rules.md');
+    case 'dsh':
+      return path.join(root, 'AGENTS.md');
     default:
       return path.join(root, '.agent', 'rules', 'memorix.md');
   }
@@ -842,6 +860,13 @@ export async function detectInstalledAgents(): Promise<AgentName[]> {
     agents.push('trae');
   } catch { /* not installed */ }
 
+  // Check for DeepSeek Harness (its home dir or an explicit DSH_HOME)
+  const dshDir = process.env.DSH_HOME?.trim() || path.join(home, '.dsh');
+  try {
+    await fs.access(dshDir);
+    agents.push('dsh');
+  } catch { /* not installed */ }
+
   return agents;
 }
 
@@ -947,6 +972,22 @@ export async function installHooks(
           generated: { note: 'Trae has no hooks system, only rules (.trae/rules/project_rules.md) installed' },
         };
       }
+    case 'dsh':
+      // DeepSeek Harness has no hook system — install AGENTS.md guidance and
+      // skills; the MCP row is installed by `memorix setup --agent dsh`.
+      {
+        const rulesPath = await installAgentRules(agent, projectRoot, global);
+        const skillPaths = await installOfficialSkillsForAgent(agent, projectRoot, global);
+        return {
+          agent,
+          configPath: rulesPath,
+          events: [],
+          generated: {
+            note: 'DeepSeek Harness has no hook system — installed AGENTS.md guidance and skills; the MCP row is installed by `memorix setup --agent dsh`.',
+            ...(skillPaths.length > 0 ? { skillPaths, skillPath: skillPaths[0] } : {}),
+          },
+        };
+      }
     case 'opencode': {
       // OpenCode uses JS plugin files for hooks
       const pluginContent = generateOpenCodePlugin();
@@ -1127,7 +1168,7 @@ async function installAgentRules(agent: AgentName, projectRoot: string, global =
   try {
     await fs.mkdir(path.dirname(rulesPath), { recursive: true });
 
-    if (agent === 'claude' || agent === 'codex' || agent === 'opencode' || agent === 'antigravity' || agent === 'gemini-cli') {
+    if (agent === 'claude' || agent === 'codex' || agent === 'opencode' || agent === 'antigravity' || agent === 'gemini-cli' || agent === 'dsh') {
       // For shared context files (CLAUDE.md / AGENTS.md / GEMINI.md), append rather than overwrite.
       try {
         const existing = await fs.readFile(rulesPath, 'utf-8');

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