open-memex 0.6.2 → 0.7.0-alpha.2

package/src/store/db.ts

@@ -35,6 +35,7 @@ CREATE TABLE IF NOT EXISTS memories (
   importance   TEXT NOT NULL DEFAULT 'normal',
   status       TEXT NOT NULL DEFAULT 'active',
   tags         TEXT NOT NULL DEFAULT '',
+  aliases      TEXT NOT NULL DEFAULT '',
   content      TEXT NOT NULL,
   cjk          TEXT NOT NULL DEFAULT '',
   content_hash TEXT NOT NULL DEFAULT '',
@@ -62,6 +63,7 @@ const FTS_SCHEMA = `
 CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
   content,
   tags,
+  aliases,
   type,
   cjk,
   scope_key UNINDEXED,
@@ -71,25 +73,25 @@ CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
 );
 
 CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
-  INSERT INTO memories_fts(rowid, content, tags, type, cjk, scope_key)
-  VALUES (new.rowid, new.content, new.tags, new.type, new.cjk, new.scope_key);
+  INSERT INTO memories_fts(rowid, content, tags, aliases, type, cjk, scope_key)
+  VALUES (new.rowid, new.content, new.tags, new.aliases, new.type, new.cjk, new.scope_key);
 END;
 
 CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
-  INSERT INTO memories_fts(memories_fts, rowid, content, tags, type, cjk, scope_key)
-  VALUES ('delete', old.rowid, old.content, old.tags, old.type, old.cjk, old.scope_key);
+  INSERT INTO memories_fts(memories_fts, rowid, content, tags, aliases, type, cjk, scope_key)
+  VALUES ('delete', old.rowid, old.content, old.tags, old.aliases, old.type, old.cjk, old.scope_key);
 END;
 
 CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
-  INSERT INTO memories_fts(memories_fts, rowid, content, tags, type, cjk, scope_key)
-  VALUES ('delete', old.rowid, old.content, old.tags, old.type, old.cjk, old.scope_key);
-  INSERT INTO memories_fts(rowid, content, tags, type, cjk, scope_key)
-  VALUES (new.rowid, new.content, new.tags, new.type, new.cjk, new.scope_key);
+  INSERT INTO memories_fts(memories_fts, rowid, content, tags, aliases, type, cjk, scope_key)
+  VALUES ('delete', old.rowid, old.content, old.tags, old.aliases, old.type, old.cjk, old.scope_key);
+  INSERT INTO memories_fts(rowid, content, tags, aliases, type, cjk, scope_key)
+  VALUES (new.rowid, new.content, new.tags, new.aliases, new.type, new.cjk, new.scope_key);
 END;
 `;
 
 /** Current index schema version. Bump when TABLE_SCHEMA/FTS_SCHEMA change. */
-const SCHEMA_VERSION = 6;
+const SCHEMA_VERSION = 7;
 
 function userVersion(d: AnyDatabase): number {
   const row = d.prepare("PRAGMA user_version").get() as { user_version: number };

package/src/store/lifecycle.ts

@@ -206,6 +206,7 @@ export interface SupersedeInput {
   body: string;
   type?: string;
   tags?: string[];
+  aliases?: string[];
   source?: string;
 }
 
@@ -232,6 +233,8 @@ export function supersede(
     id: ulid(),
     type: input.type ?? oldMf.fm.type,
     tags: input.tags ?? oldMf.fm.tags,
+    // D61: aliases carry forward unless the caller replaces them.
+    aliases: input.aliases ?? oldMf.fm.aliases,
     source: input.source ?? oldMf.fm.source,
     status: "active",
     created_at: now,

package/src/store/markdown.ts

@@ -53,6 +53,13 @@ export interface Frontmatter {
   importance: Importance;
   status: MemoryStatus;
   tags: string[];
+  /**
+   * D61: capture-time aliases — alternate phrasings / other-language
+   * equivalents of this memory, indexed alongside the body so a
+   * differently-worded question still matches (retrieval layer 3).
+   * Optional and additive: files without it parse unchanged.
+   */
+  aliases?: string[];
   source: string;
   created_at: string; // RFC 3339, never bare epoch (§3)
   updated_at: string; // RFC 3339
@@ -232,6 +239,14 @@ export function normalizeFrontmatter(
     tags: Array.isArray(raw.tags)
       ? raw.tags.filter((t): t is string => typeof t === "string")
       : [],
+    ...(Array.isArray(raw.aliases)
+      ? (() => {
+          const aliases = normalizeAliases(
+            raw.aliases.filter((a): a is string => typeof a === "string"),
+          );
+          return aliases.length > 0 ? { aliases } : {};
+        })()
+      : {}),
     source: typeof raw.source === "string" ? raw.source : "",
     created_at: msToRfc3339(timeToMs(raw.created_at)),
     updated_at: msToRfc3339(timeToMs(raw.updated_at)),
@@ -254,12 +269,41 @@ export function normalizeFrontmatter(
   };
 }
 
+/**
+ * D61: normalize capture-time aliases — trim, drop empties, dedupe
+ * (case-insensitive), cap at 4. Bad aliases are noise, never an error.
+ * Shared by the tool ops, the CLI, and frontmatter parsing.
+ */
+export function normalizeAliases(input?: string[]): string[] {
+  if (!input) return [];
+  const seen = new Set<string>();
+  const out: string[] = [];
+  for (const a of input) {
+    const t = a.trim();
+    if (!t) continue;
+    const k = t.toLowerCase();
+    if (seen.has(k)) continue;
+    seen.add(k);
+    out.push(t);
+    if (out.length >= 4) break;
+  }
+  return out;
+}
+
 export function isTaxonomyType(t: string): boolean {
   return TAXONOMY.has(t);
 }
 
 export function serialize(fm: Frontmatter, body: string): string {
-  const yml = yaml.dump(fm, { lineWidth: -1, quotingType: '"' });
+  // D61: an empty aliases list is noise in the file — drop the key entirely
+  // rather than relying on the YAML dumper to skip an undefined value
+  // (parse only sets the field when non-empty; keep both ends consistent).
+  let out: Frontmatter = fm;
+  if (fm.aliases && fm.aliases.length === 0) {
+    out = { ...fm };
+    delete out.aliases;
+  }
+  const yml = yaml.dump(out, { lineWidth: -1, quotingType: '"' });
   return `---\n${yml}---\n\n${body.trimEnd()}\n`;
 }
 

package/src/store/sync.ts

@@ -14,8 +14,8 @@ import { projectRoot, paths } from "../paths.ts";
 import { loadConfig } from "../config.ts";
 
 const UPSERT_SQL = `
-  INSERT INTO memories (id, scope_key, scope, visibility, project_name, type, role, importance, status, tags, content, cjk, content_hash, superseded_by, source, file_path, mtime_ms, created_at, updated_at, review_state)
-  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  INSERT INTO memories (id, scope_key, scope, visibility, project_name, type, role, importance, status, tags, aliases, content, cjk, content_hash, superseded_by, source, file_path, mtime_ms, created_at, updated_at, review_state)
+  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   ON CONFLICT(id) DO UPDATE SET
     scope_key    = excluded.scope_key,
     scope        = excluded.scope,
@@ -26,6 +26,7 @@ const UPSERT_SQL = `
     importance   = excluded.importance,
     status       = excluded.status,
     tags         = excluded.tags,
+    aliases      = excluded.aliases,
     content      = excluded.content,
     cjk          = excluded.cjk,
     content_hash = excluded.content_hash,
@@ -62,6 +63,7 @@ export function upsertFromFile(mf: MemoryFile): void {
 function writeRow(mf: MemoryFile, mtimeMs: number): void {
   const { fm, body, filePath } = mf;
   const tags = (fm.tags ?? []).join(",");
+  const aliases = (fm.aliases ?? []).join(",");
   db().prepare(UPSERT_SQL).run(
     fm.id,
     fm.scope_key,
@@ -73,8 +75,9 @@ function writeRow(mf: MemoryFile, mtimeMs: number): void {
     fm.importance,
     fm.status,
     tags,
+    aliases,
     body,
-    cjkIndexText(body + "\n" + tags),
+    cjkIndexText(body + "\n" + tags + "\n" + aliases),
     contentHash(body),
     fm.superseded_by ?? null,
     fm.source ?? "",

package/src/tools/ops.ts

@@ -18,6 +18,7 @@ import {
   ulid,
   msToRfc3339,
   MEMORY_TYPE_TAXONOMY,
+  normalizeAliases,
   type Frontmatter,
 } from "../store/markdown.ts";
 import { upsertFromFile, deleteFromIndex } from "../store/sync.ts";
@@ -62,9 +63,9 @@ export async function withOutboxNote(
 /** LLM-facing tool descriptions, shared by the opencode plugin and the MCP server. */
 export const TOOL_DESCRIPTIONS = {
   memory_add:
-    "Save a fact, preference, decision, or note to persistent local memory. Call this PROACTIVELY whenever the user shares something worth remembering across sessions — project conventions, tool choices, personal preferences, decisions made, error fixes and their causes. Do not wait to be asked. Keep each memory to one self-contained statement. Default scope is the current project; use the personal scope for facts about the user that apply across all projects.",
+    "Save a fact, preference, decision, or note to persistent local memory. Call this PROACTIVELY whenever the user shares something worth remembering across sessions — project conventions, tool choices, personal preferences, decisions made, error fixes and their causes. Worth saving: decisions and their reasons, preferences, conventions, gotchas, approaches tried and abandoned. Not worth saving: one-off task details or anything re-derivable from the code. Do not wait to be asked. For facts you infer yourself rather than the user stating, propose them first and save only on approval. Keep each memory to one self-contained statement; attach aliases when the parameter is available. Default scope is the current project; use the personal scope for facts about the user that apply across all projects.",
   memory_search:
-    "Search persistent memory by keyword (BM25 full-text). Returns matching memories from the current project and/or personal scope. Call before asking the user about past decisions, conventions, or preferences they may have told you before — try a few keyword variants, including the user's own language, when the first search comes up empty.",
+    "Search persistent memory by keyword (BM25 full-text). Returns matching memories from the current project and/or personal scope. Call before asking the user about past decisions, conventions, or preferences they may have told you before. Search well: break the question into its concepts and try 2–3 phrasings per concept — synonyms, the user's other language, shorter keyword forms — and check the other scope too, before concluding nothing is stored.",
   memory_list:
     "List memories in a scope, newest first. Useful for browsing what is remembered, or verifying that a save landed.",
   memory_supersede:
@@ -92,6 +93,13 @@ export const scopeArg = z
     "Memory scope. `project` = tied to this repo. `personal` = global across all your projects. `user` is a deprecated alias of `personal`. Default: project.",
   );
 
+export const aliasesArg = z
+  .array(z.string())
+  .optional()
+  .describe(
+    "Optional: alternate phrasings of this fact — synonyms, another way a question might be worded, equivalents in the user's other language (e.g. 节假日 for 'public holidays'). They are indexed with the memory so differently-worded questions still match. Only used when the install has capture aliases enabled (init default). Send at most 4; extras and blanks are dropped silently, never an error.",
+  );
+
 export const memoryAddArgs = {
   content: z.string().min(1).describe("The fact to remember. One idea per memory."),
   type: z
@@ -100,6 +108,7 @@ export const memoryAddArgs = {
     .describe("Category of memory. Default: fact."),
   scope: scopeArg,
   tags: z.array(z.string()).optional().describe("Optional tags for filtering."),
+  aliases: aliasesArg,
   source: z
     .string()
     .optional()
@@ -138,6 +147,7 @@ export const memorySupersedeArgs = {
     .optional()
     .describe("Category of the new memory. Defaults to the old memory's type."),
   tags: z.array(z.string()).optional().describe("Optional tags for the new memory."),
+  aliases: aliasesArg,
 };
 export type MemorySupersedeArgs = z.infer<z.ZodObject<typeof memorySupersedeArgs>>;
 
@@ -210,6 +220,7 @@ function buildFrontmatter(
   body: {
     type: Frontmatter["type"];
     tags: string[];
+    aliases?: string[];
     source: Frontmatter["source"];
   },
 ): Frontmatter {
@@ -226,6 +237,7 @@ function buildFrontmatter(
     importance: "normal",
     status: "active",
     tags: body.tags,
+    ...(body.aliases && body.aliases.length > 0 ? { aliases: body.aliases } : {}),
     source: body.source,
     created_at: rfc,
     updated_at: rfc,
@@ -265,6 +277,15 @@ export async function addMemory(
   const fm = buildFrontmatter(s, {
     type: args.type ?? "fact",
     tags: args.tags ?? [],
+    // D61: aliases are stored only when the install enables them (init
+    // asks once, default on); normalize caps at 4 and drops junk silently.
+    // Aliases pass through the same redaction as content (write-path
+    // invariant) — an alias carrying a token gets masked, not stored raw.
+    aliases: cfg.captureAliases
+      ? normalizeAliases(
+          (args.aliases ?? []).map((a) => redact(a, cfg.redactPatterns).content),
+        )
+      : [],
     source: args.source ?? "tool",
   });
   const { filePath } = writeMemoryFile(fm, redacted);
@@ -335,6 +356,14 @@ export async function supersedeMemory(
       body: redacted,
       type: args.type,
       tags: args.tags,
+      // D61: explicit aliases replace the carried-over ones, only when
+      // the install enables capture aliases. Same redaction as content.
+      aliases:
+        cfg.captureAliases && args.aliases !== undefined
+          ? normalizeAliases(
+              args.aliases.map((a) => redact(a, cfg.redactPatterns).content),
+            )
+          : undefined,
       source: "tool",
     });
     upsertFromFile(oldMf);