@te-river/opencode-team-mode 1.5.11 → 1.5.12

package/dist/tm/memory.d.ts

@@ -1,24 +1,50 @@
 /**
- * tm_memory — project/global memory mirror (Qoder-inspired, re-implemented
- * from mechanism analysis; no code reused).
+ * tm_memory — THREE-layer memory store (global / project / session),
+ * Qoder-inspired, re-implemented from mechanism analysis; no code reused.
  *
  * Design: memories are plain Markdown files with a small YAML-ish
- * frontmatter (title / usage_scenario / keywords) — git-diffable, human-
- * editable, injectable into context without any database.  The store lives
- * under the git-aware base (<repo>/.git/opencode-team/memories/ or tmpdir
- * fallback), mirroring the run-store philosophy: never pollute the working
- * tree, TTL-free (memories are long-lived by design; forget is explicit).
+ * frontmatter (title / usage_scenario / keywords / supersedes / created_at /
+ * updated_at / expires) — git-diffable, human-editable, injectable into
+ * context without any database.  The store lives under the git-aware base
+ * (<repo>/.git/opencode-team/memories/ or tmpdir fallback), mirroring the
+ * run-store philosophy: never pollute the working tree.
  *
  * Layout:
  *   GLOBAL  (user-level, follows you across projects):
  *     <globalRoot>/<category>/<title>.md      — default ~/.opencode-team/memories/global/
  *   PROJECT (repo-level, per checkout):
  *     <storeBase>/memories/projects/<project-slug>/<category>/<title>.md
+ *   SESSION (per ctx.sessionID — EPHEMERAL by default):
+ *     in-process Map keyed by the session id; nothing touches the disk
+ *     unless TM_MEMORY_SESSION_PERSIST=1, which mirrors every session entry
+ *     to <storeBase>/memories/sessions/<sid>/<category>/<title>.md with an
+ *     `expires:` frontmatter line.  Expired entries die on a lazy per-call
+ *     sweep AND a startup sweep (never read back after the TTL).
+ *   COMPACT backups (rollback path, never walked — dot-dirs are skipped):
+ *     <storeBase>/memories/.compact-backup/<UTC ts>/<scope>/<rel path>
+ *
+ * Precedence: session > project > global.  search scores every layer it is
+ * asked to walk; same-title lower-layer entries are shadowed by the highest
+ * layer that carries them, and project gets a +2 / session a +3 near-tie
+ * weight so a layer's entries rank first.
+ *
+ * Bloat control (the root cause this tier fixes: near-identical memories
+ * piling up as separate files):
+ *   - add NEVER creates a second entry that duplicates an existing one in
+ *     the same scope+category: identity is `category + sorted(stopword-
+ *     stripped title tokens)` OR a Jaccard(title∪keywords tokens) ≥ 0.6 —
+ *     either match MERGES into the existing file (content takes the new
+ *     value, keywords union, `supersedes:` grows, updated_at refreshes).
+ *   - over cfg.memoryMaxEntries per scope, add fails with a compact/forget
+ *     hint instead of growing the store.
+ *   - cfg.memoryStaleDays > 0 tags search hits `[stale Nd]`.
+ *   - action "compact" groups the existing duplicates: dry-run by default,
+ *     `apply: true` merges for real after moving originals to the backup dir.
  *
  * The project slug is derived from the workspace path (drive letter + path
  * segments dashed, lowercased) so two checkouts never share a memory set.
- * Injection is PULL-based for now: agents search via this tool; the lead
- * distills relevant memories into dispatches (see SHARED_RULES).
+ * Injection is PULL-based: agents search via this tool; the lead distills
+ * relevant memories into dispatches (see SHARED_RULES).
  */
 import type { ToolResult } from "../types.js";
 import { type TmConfig } from "./config.js";
@@ -28,17 +54,56 @@ export declare const MEMORY_TITLE_MAX = 120;
 export declare const MEMORY_CONTENT_MAX = 4000;
 export declare const MEMORY_SEARCH_RESULTS = 5;
 export declare const MEMORY_EXCERPT_MAX = 600;
+/** Layered precedence: session > project > global — (a) same-title entries in
+ *  a lower layer are shadowed by the highest layer carrying them, (b) session
+ *  entries get a +3 and project entries a +2 near-tie weight (matches
+ *  category ×2 in the scoring grammar). */
+export declare const MEMORY_PROJECT_SCOPE_BONUS = 2;
+export declare const MEMORY_SESSION_SCOPE_BONUS = 3;
+/** Near-duplicate merge threshold on title∪keywords token sets. */
+export declare const MEMORY_DEDUP_JACCARD = 0.6;
+/** Per-list frontmatter caps (kept stable so merges cannot grow unbounded). */
+export declare const MEMORY_KEYWORDS_MAX = 10;
+export declare const MEMORY_SCENARIOS_MAX = 8;
+export declare const MEMORY_SUPERSEDES_MAX = 50;
+/** Default session id when the host ctx carries no sessionID. */
+export declare const MEMORY_DEFAULT_SESSION_ID = "default";
 /** Seeded category taxonomy (Qoder's seven, reused as the starting point). */
 export declare const MEMORY_CATEGORIES: readonly string[];
+/** The three memory layers. */
+export type MemoryScope = "project" | "global" | "session";
+export declare const MEMORY_SCOPES: readonly MemoryScope[];
+/** Layer precedence: session > project > global (also drives same-title shadowing). */
+export declare const MEMORY_ALL_SCOPES: MemoryScope[];
 /** Path → project slug ("D:\Github\App" -> "d-github-app"). */
 export declare function projectSlug(directory: string): string;
 /** Title → safe file stem (collapsed dashes, capped). */
 export declare function titleSlug(title: string): string;
+/** Session id → path-safe dir name. */
+export declare function sessionIdSlug(sid: unknown): string;
+/**
+ * Deterministic tokenizer: latin/digit runs + one token per CJK glyph
+ * (Chinese titles have no whitespace, so glyph tokens are what make the
+ * Jaccard signal work).  Stopwords removed.
+ */
+export declare function memoryTokens(text: unknown): string[];
+/**
+ * Identity key of a memory: category + the sorted token set of its title.
+ * Two entries with the same key in the same scope+category are the same fact.
+ */
+export declare function memoryDedupKey(category: string, title: string): string;
+/** Jaccard similarity of two token sets; empty-vs-empty is 0 (no signal). */
+export declare function memoryJaccard(a: string[], b: string[]): number;
 export declare function renderMemoryMarkdown(m: {
     title: string;
     usageScenario: string[];
     keywords: string[];
     content: string;
+    /** Forward-compatible extras — old readers ignore unknown keys. */
+    supersedes?: string[];
+    createdAt?: number | null;
+    updatedAt?: number | null;
+    expiresAt?: number | null;
 }): string;
 /** Parse a memory file; null when the file is not ours (foreign md). */
 export declare function parseMemoryMarkdown(raw: string, filePath: string): {
@@ -48,16 +113,27 @@ export declare function parseMemoryMarkdown(raw: string, filePath: string): {
     content: string;
     filePath: string;
     category: string;
+    supersedes: string[];
+    createdAt: number | null;
+    updatedAt: number | null;
+    expiresAt: number | null;
 } | null;
 export interface MemoryHit {
     title: string;
     category: string;
-    scope: "project" | "global";
+    scope: MemoryScope;
     filePath: string;
     keywords: string[];
     usageScenario: string[];
     content: string;
     score: number;
+    /** Merge / staleness / TTL bookkeeping (additive — older readers ignore). */
+    slug: string;
+    createdAt: number;
+    updatedAt: number;
+    expiresAt: number | null;
+    supersedes: string[];
+    sid: string;
 }
 /**
  * Substring scoring — no embeddings, deterministic: title ×5, keywords ×4,
@@ -80,6 +156,8 @@ export declare function buildTmMemoryTool(deps: {
     cfg: TmConfig;
     pipelines: TmPipelines;
     args?: Record<string, unknown>;
+    /** Clock seam for tests (TTL / staleness); defaults to Date.now. */
+    now?: () => number;
 }): {
     description: string;
     args: Record<string, unknown>;

package/dist/tm/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tm/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,kBAAkB,OAAO,CAAA;AACtC,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAQ9C,CAAA;AAID,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AA0BD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,MAAM,CAST;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,IAAI,CA8BP;AAID,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AA2BD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACpG,KAAK,EAAE,MAAM,GACZ,MAAM,CAiBR;AAqCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB;;mDAE+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,QAAQ,CAAA;IACb,SAAS,EAAE,WAAW,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,GAAG;IACF,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACjF,CA6HA"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tm/memory.ts"],"names":[],"mappings":"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"}