@zilliz/memsearch-opencode 0.3.11 → 0.3.13

package/context.ts

@@ -0,0 +1,128 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+
+/**
+ * Summarize the N most recent daily .md files for cold-start context.
+ * Extracts recent non-empty session sections so empty SessionStart headings
+ * do not crowd out useful context.
+ */
+function recentMemoryPreviewLines(content: string, maxLines: number): string[] {
+  const sections: string[][] = [];
+  let current: string[] = [];
+  let hasBody = false;
+
+  const flush = () => {
+    if (current.length > 0 && hasBody) {
+      sections.push(current);
+    }
+    current = [];
+    hasBody = false;
+  };
+
+  for (const rawLine of content.split("\n")) {
+    const line = rawLine.trimEnd();
+    if (/^##\s/.test(line)) {
+      flush();
+      current = [line];
+      continue;
+    }
+    if (/^#{3,4}\s/.test(line)) {
+      current.push(line);
+      continue;
+    }
+    if (line.startsWith("- ") || line.startsWith("[User]") || line.startsWith("[Assistant]")) {
+      current.push(line);
+      hasBody = true;
+    }
+  }
+
+  flush();
+  return sections.flat().slice(-maxLines);
+}
+
+export function isDailyJournalFile(file: string): boolean {
+  return /^\d{4}-\d{2}-\d{2}\.md$/.test(file);
+}
+
+export function getRecentMemories(
+  memDir: string,
+  count = 2,
+  maxLinesPerFile = 30
+): string {
+  if (!existsSync(memDir)) return "";
+
+  const files = readdirSync(memDir)
+    .filter(isDailyJournalFile)
+    .sort()
+    .slice(-count);
+
+  if (files.length === 0) return "";
+
+  const summary: string[] = [];
+  for (const file of files) {
+    try {
+      const content = readFileSync(join(memDir, file), "utf-8");
+      const lines = recentMemoryPreviewLines(content, maxLinesPerFile);
+      if (lines.length > 0) {
+        summary.push(`[${file}]`, ...lines);
+      }
+    } catch { /* skip */ }
+  }
+
+  if (summary.length === 0) {
+    return `You have ${files.length} past memory file(s). Use the memory_search tool when the user's question could benefit from historical context.`;
+  }
+
+  return `Recent memories (use memory_search for full search):\n${summary.join("\n")}`;
+}
+
+/** Shell-escape a string for safe use inside single quotes. */
+export function shellEscape(s: string): string {
+  return s.replace(/'/g, "'\\''");
+}
+
+export function getSkillCandidateHint(memsearchDir: string, memsearchCmd: string): string {
+  try {
+    const result = spawnSync(
+      "bash",
+      [
+        "-c",
+        `MEMSEARCH_DIR='${shellEscape(memsearchDir)}' ${memsearchCmd} skills status --hint`,
+      ],
+      { encoding: "utf-8", timeout: 5000 }
+    );
+    if (result.status !== 0) return "";
+    return (result.stdout || "").trim().split("\n")[0] || "";
+  } catch {
+    return "";
+  }
+}
+
+/** Marks the start of memsearch's injected block within a system message. */
+export const MEMSEARCH_SYSTEM_MARKER = "[memsearch] Memory available.";
+
+/**
+ * Merge memsearch's memory context into an `output.system` array without
+ * growing it. Some backends (litellm/vllm serving e.g. Qwen models) reject a
+ * multi-entry `output.system` array with "system message must be first", so
+ * the memory block is folded into the first entry instead of pushed as a new
+ * one. If a memsearch block from a previous transform call is already present
+ * (identified by MEMSEARCH_SYSTEM_MARKER), it is replaced in place rather than
+ * appended again, so repeated calls against the same output stay idempotent.
+ */
+export function mergeSystemMemoryContext(
+  system: string[] | undefined,
+  memoryText: string
+): string[] {
+  if (!Array.isArray(system) || system.length === 0) {
+    return [memoryText];
+  }
+  const result = [...system];
+  const existing = result[0];
+  const markerIndex = existing.indexOf(MEMSEARCH_SYSTEM_MARKER);
+  const base =
+    markerIndex === -1 ? existing : existing.slice(0, markerIndex).replace(/\n+$/, "");
+  result[0] = base ? `${base}\n\n${memoryText}` : memoryText;
+  return result;
+}

package/index.ts

@@ -18,7 +18,6 @@ import {
   readFileSync,
   existsSync,
   mkdirSync,
-  readdirSync,
   realpathSync,
   unlinkSync,
   writeFileSync,
@@ -26,6 +25,14 @@ import {
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
+import {
+  getRecentMemories,
+  getSkillCandidateHint,
+  MEMSEARCH_SYSTEM_MARKER,
+  mergeSystemMemoryContext,
+  shellEscape,
+} from "./context.ts";
+
 const PLUGIN_DIR = dirname(realpathSync(fileURLToPath(import.meta.url)));
 
 // ---------------------------------------------------------------------------
@@ -70,114 +77,6 @@ function deriveCollectionName(projectDir: string): string {
   }
 }
 
-/**
- * Summarize the N most recent daily .md files for cold-start context.
- * Extracts recent non-empty session sections so empty SessionStart headings
- * do not crowd out useful context.
- */
-function recentMemoryPreviewLines(content: string, maxLines: number): string[] {
-  const sections: string[][] = [];
-  let current: string[] = [];
-  let hasBody = false;
-
-  const flush = () => {
-    if (current.length > 0 && hasBody) {
-      sections.push(current);
-    }
-    current = [];
-    hasBody = false;
-  };
-
-  for (const rawLine of content.split("\n")) {
-    const line = rawLine.trimEnd();
-    if (/^##\s/.test(line)) {
-      flush();
-      current = [line];
-      continue;
-    }
-    if (/^#{3,4}\s/.test(line)) {
-      current.push(line);
-      continue;
-    }
-    if (line.startsWith("- ") || line.startsWith("[User]") || line.startsWith("[Assistant]")) {
-      current.push(line);
-      hasBody = true;
-    }
-  }
-
-  flush();
-  return sections.flat().slice(-maxLines);
-}
-
-export function isDailyJournalFile(file: string): boolean {
-  return /^\d{4}-\d{2}-\d{2}\.md$/.test(file);
-}
-
-export function getRecentMemories(
-  memDir: string,
-  count = 2,
-  maxLinesPerFile = 30
-): string {
-  if (!existsSync(memDir)) return "";
-
-  const files = readdirSync(memDir)
-    .filter(isDailyJournalFile)
-    .sort()
-    .slice(-count);
-
-  if (files.length === 0) return "";
-
-  const summary: string[] = [];
-  for (const file of files) {
-    try {
-      const content = readFileSync(join(memDir, file), "utf-8");
-      const lines = recentMemoryPreviewLines(content, maxLinesPerFile);
-      if (lines.length > 0) {
-        summary.push(`[${file}]`, ...lines);
-      }
-    } catch { /* skip */ }
-  }
-
-  if (summary.length === 0) {
-    return `You have ${files.length} past memory file(s). Use the memory_search tool when the user's question could benefit from historical context.`;
-  }
-
-  return `Recent memories (use memory_search for full search):\n${summary.join("\n")}`;
-}
-
-/** Shell-escape a string for safe use inside single quotes. */
-function shellEscape(s: string): string {
-  return s.replace(/'/g, "'\\''");
-}
-
-/** Marks the start of memsearch's injected block within a system message. */
-export const MEMSEARCH_SYSTEM_MARKER = "[memsearch] Memory available.";
-
-/**
- * Merge memsearch's memory context into an `output.system` array without
- * growing it. Some backends (litellm/vllm serving e.g. Qwen models) reject a
- * multi-entry `output.system` array with "system message must be first", so
- * the memory block is folded into the first entry instead of pushed as a new
- * one. If a memsearch block from a previous transform call is already present
- * (identified by MEMSEARCH_SYSTEM_MARKER), it is replaced in place rather than
- * appended again, so repeated calls against the same output stay idempotent.
- */
-export function mergeSystemMemoryContext(
-  system: string[] | undefined,
-  memoryText: string
-): string[] {
-  if (!Array.isArray(system) || system.length === 0) {
-    return [memoryText];
-  }
-  const result = [...system];
-  const existing = result[0];
-  const markerIndex = existing.indexOf(MEMSEARCH_SYSTEM_MARKER);
-  const base =
-    markerIndex === -1 ? existing : existing.slice(0, markerIndex).replace(/\n+$/, "");
-  result[0] = base ? `${base}\n\n${memoryText}` : memoryText;
-  return result;
-}
-
 /**
  * Start the capture daemon as a background process.
  * The daemon polls OpenCode's SQLite for completed turns and writes to daily .md files.
@@ -277,6 +176,7 @@ const MemsearchPlugin: Plugin = async ({ project, directory, worktree }) => {
   const collectionName = deriveCollectionName(projectDir);
   const memsearchDir = join(projectDir, ".memsearch");
   const memoryDir = join(memsearchDir, "memory");
+  const skillCandidateHint = getSkillCandidateHint(memsearchDir, memsearchCmd);
   const home = process.env.HOME || "~";
 
   // Skip capture/recall in child processes to prevent recursion
@@ -433,10 +333,12 @@ const MemsearchPlugin: Plugin = async ({ project, directory, worktree }) => {
           "experimental.chat.system.transform": async (_input: any, output: any) => {
             try {
               const context = getRecentMemories(memoryDir);
-              if (context) {
+              if (context || skillCandidateHint) {
                 const memoryText =
                   `${MEMSEARCH_SYSTEM_MARKER} You have access to memory_search, ` +
-                  `memory_get, and memory_transcript tools for recalling past sessions.\n\n${context}`;
+                  `memory_get, and memory_transcript tools for recalling past sessions.` +
+                  `${skillCandidateHint ? `\n${skillCandidateHint}` : ""}` +
+                  `${context ? `\n\n${context}` : ""}`;
                 output.system = mergeSystemMemoryContext(output.system, memoryText);
               }
             } catch { /* ignore */ }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zilliz/memsearch-opencode",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "memsearch plugin for OpenCode — semantic memory search across sessions",
   "type": "module",
   "main": "index.ts",
@@ -8,6 +8,7 @@
     ".": "./index.ts"
   },
   "files": [
+    "context.ts",
     "index.ts",
     "scripts/*.py",
     "scripts/*.sh",

package/skills/memory-config/SKILL.md

@@ -93,6 +93,8 @@ Check index health:
 
 ```bash
 memsearch stats
+STATE_DIR="${MEMSEARCH_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.memsearch}"
+test -f "$STATE_DIR/.index-state.json" && cat "$STATE_DIR/.index-state.json"
 ```
 
 OpenCode transcript recall reads from OpenCode's SQLite database, while captured MemSearch memory lives as markdown under `.memsearch/memory/`.
@@ -121,8 +123,16 @@ Only these low-risk local indexing keys are honored from project config:
 - `embedding.batch_size`
 - `chunking.max_chunk_size`
 - `chunking.overlap_lines`
+- `indexing.ignore_files`
+- `indexing.exclude`
 - `watch.debounce_ms`
 
+Index exclusions are opt-in for compatibility. Missing or empty
+`indexing.ignore_files` and `indexing.exclude` keep the old scan-all behavior;
+new files created by `memsearch config init` explicitly write
+`ignore_files = [".gitignore"]`. Each directory passed to index/watch is its own
+root, and ignore discovery never walks into parent directories.
+
 Trusted settings are ignored or rejected in project config. Put these in global
 config (`~/.memsearch/config.toml`) or pass explicit CLI flags instead:
 
@@ -208,6 +218,11 @@ Model guidance:
 
 Advanced maintenance runs after the plugin wakes it, only when enabled, journal input changed, and `min_interval_hours` elapsed. `PROJECT.md` and `USER.md` are maintenance artifacts by default and are not automatically indexed.
 
+If indexing seems silent or search looks stale, check `.memsearch/.index-state.json`
+for `status`, `last_error`, and `failed_files`. `status: degraded` means the
+scan completed but one or more files failed; `status: error` means the index run
+did not complete.
+
 If advanced maintenance or `memory_to_skill` seems silent, check
 `.memsearch/.maintenance-state.json` for `<plugin>.<task>.last_error` and
 `last_failed_at`; background hook errors may not surface in the chat.

package/skills/memory-to-skill/SKILL.md

@@ -47,10 +47,16 @@ captured automatically going forward) — do not force it.
 ## B. Review & install candidates (1→2)
 
 ```bash
+memsearch skills status          # pending candidate versions needing install
 memsearch skills list            # add -j for sources / installed paths
 git -C .memsearch/skill-candidates log --oneline -5 2>/dev/null || true
 ```
 
+`skills status` compares each candidate's current `SKILL.md` content hash with
+the hash recorded by the last `skills install`. It does not inspect live agent
+skill directories. A pending installed skill means the candidate source evolved
+after the last deliberate install; reinstall only after reviewing the candidate.
+
 Before recommending or installing, skim the candidate's body: if a step looks uncertain or loosely summarized, re-check it against the source (open the transcript if needed) or flag it to the user and let them decide — installing copies the candidate as-is, so this is the last chance to catch a wrong step.
 When showing candidates, mention the store's recent git history when it helps
 explain whether a candidate is new, evolved, removed, or re-created.