agent-memory-git 0.1.12__tar.gz → 0.1.14__tar.gz

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-memory-git
-Version: 0.1.12
+Version: 0.1.14
 Summary: Shared, git-backed memory for Claude Code and Codex.
 Keywords: claude-code,codex,memory,agents,git
 Author: Shichao Song

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-memory-git"
-version = "0.1.12"
+version = "0.1.14"
 description = "Shared, git-backed memory for Claude Code and Codex."
 readme = "README.md"
 license = "MIT"

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "agent-memory-git"
-version = "0.1.12"
+version = "0.1.14"
 description = "Shared, git-backed memory for Claude Code and Codex."
 readme = "README.md"
 license = "MIT"

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/PROTOCOL.md

@@ -40,8 +40,8 @@ Write one file per memory into this session's staging directory, with a short ke
 ```markdown
 ---
 name: kebab-case-slug
-type: feedback
-scope: global
+type: project
+scope: here
 description: One line (under 150 characters) saying what this memory is; it becomes the index entry
 ---
 The fact itself, in one or two sentences.
@@ -70,6 +70,8 @@ Keep the body under about 1,500 characters. A memory is a conclusion, not a log:
 - `global`: in every session. Use it for who the user is and for preferences not tied to one project.
 - `here`: only in this folder, its parent and child folders, and other checkouts of the same git remote. When the index marks the location as a throwaway folder (a scratch workspace or a Codex per-thread folder), `here` memories are filed under the project folder this session worked in most, so use `here` for project facts there too.
 
+A `project` or `reference` memory is `here` unless it holds in every project you could work in; a fact about one project, its repository or its tools stays `here`, however important it seems. Most `user` and `feedback` memories are `global`.
+
 Leave out ids, dates and provenance (session, host, folder, git remote). When your turn ends a hook adds them, moves the file into the repository and commits it.
 
 ## Changing existing memories

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/ui.py

@@ -316,19 +316,15 @@ def embed(data_dir, texts):
 
 
 def closeness(vectors):
-    """Cosine similarity rescaled so a typical pair is 0 and the closest pair is 1.
+    """The cosine similarity of every pair of unit rows, as it is (below 0 reads as 0), and what a typical pair
+    scores: the median over pairs of different memories. Pairs at or below it are not listed as similar.
 
-    Embedding cosines bunch together (most unrelated pairs still score 0.3-0.5),
-    so the raw number says little; the rescaled one reads like a percentage.
+    It is not rescaled: rescaling made the closest pair 100% however far apart it was.
     """
-    raw = vectors @ vectors.T
-    off = raw[~np.eye(len(raw), dtype=bool)]
-    if not len(off):
-        return np.ones_like(raw)
-    lo, hi = np.percentile(off, 50), off.max()
-    sim = np.clip((raw - lo) / max(hi - lo, 1e-6), 0, 1)
+    sim = np.clip(vectors @ vectors.T, 0, 1)
+    off = sim[~np.eye(len(sim), dtype=bool)]
     np.fill_diagonal(sim, 1)
-    return sim
+    return sim, float(np.median(off)) if len(off) else 0.0
 
 
 # ------------------------------------------------------------ page data
@@ -366,13 +362,9 @@ def build(data_dir, semantic=True, vectors_out=None):
     x, vocab = vectorize(docs)
     forms = _display_forms(clean(t + " " + b) for t, b in docs)
     vectors = embed(data_dir, [prose(t, b) for t, b in docs]) if semantic else None
-    if vectors is not None:
-        sim, space = closeness(vectors), vectors
-        method = f"{MODEL['name']}, local"
-    else:
-        sim, space = np.clip(x @ x.T, 0, 1), x
-        np.fill_diagonal(sim, 1)
-        method = "keywords only (no local model)"
+    space = vectors if vectors is not None else x
+    sim, typical = closeness(space)
+    method = f"{MODEL['name']}, local" if vectors is not None else "keywords only (no local model)"
     if vectors_out is not None:
         vectors_out[:] = [space]
 
@@ -399,7 +391,7 @@ def build(data_dir, semantic=True, vectors_out=None):
                 "host": src.get("host") or "",
                 "created": m["created"],
                 "updated": m["updated"],
-                "similar": [{"i": j, "s": round(float(sim[i, j]), 3)} for j in order if sim[i, j] > 0],
+                "similar": [{"i": j, "s": round(float(sim[i, j]), 3)} for j in order if sim[i, j] > typical],
                 "keywords": [{"k": vocab[j], "t": forms.get(vocab[j], vocab[j])} for j in picks[i]],
                 "terms": [vocab[j] for j in np.flatnonzero(x[i])],
                 "issues": [message for _, message in lint.check(m, body, names)],

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/webui/app.css

@@ -559,6 +559,11 @@ button.hero-meta-item:hover .copy-hint, button.hero-meta-item:focus-visible .cop
 .doctor-line .i { width: 13px; height: 13px; }
 .doctor-sum .chev { transition: transform .15s; }
 .doctor-sum .chev.turned { transform: rotate(180deg); }
+.about { display: flex; justify-content: center; align-items: center; gap: 2px; margin-top: 4px; font-size: 12.5px; color: var(--ink-3); }
+.about .sep { margin: 0 4px; }
+.about a { display: inline-flex; height: 28px; align-items: center; gap: 4px; padding: 0 8px; border-radius: 999px; color: var(--ink-3); text-decoration: none; transition: background-color .15s, color .15s; }
+.about a:hover { background: var(--hover); color: var(--ink); }
+.about .i { width: 12px; height: 12px; }
 .checks { width: 100%; margin-top: 12px; padding: 16px 20px 18px; border-radius: var(--r-card); background: var(--panel); animation: rise .15s ease-out; }
 .checks-note { margin-bottom: 10px; font-size: 12px; color: var(--ink-3); }
 .checks-note code { font-size: 11.5px; color: var(--ink-2); }

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/webui/js/icons.js

@@ -16,6 +16,7 @@ const PATHS = {
   "arrow-left": `<path d="m12 19-7-7 7-7"/><path d="M19 12H5"/>`,
   "arrow-right": `<path d="M5 12h14"/><path d="m12 5 7 7-7 7"/>`,
   "arrow-up": `<path d="m5 12 7-7 7 7"/><path d="M12 19V5"/>`,
+  "arrow-up-right": `<path d="M7 7h10v10"/><path d="M7 17 17 7"/>`,
   "chart-column": `<path d="M3 3v16a2 2 0 0 0 2 2h16"/><path d="M18 17V9"/><path d="M13 17V5"/><path d="M8 17v-3"/>`,
   "check": `<path d="M20 6 9 17l-5-5"/>`,
   "chevron-down": `<path d="m6 9 6 6 6-6"/>`,

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/webui/js/views/insights.js

@@ -136,7 +136,7 @@ export function insightsPage() {
     <section class="card span2"><h2>Possible duplicates</h2><p class="card-note">Pairs that read alike; compare them side by side and keep one.</p>
       ${pairs.length ? pairs.map((p, i) => html`<div class="pair"><div class="pair-text"><span class="truncate">${p[0].description}</span><span class="truncate faint2">${p[1].description}</span></div>
         <span class="count">${Math.round(p[2] * 100)}%</span><button type="button" class="btn sm" data-act="compare" data-arg="${i}">Compare</button></div>`)
-        : html`<p class="card-note">No two memories are more than 45% alike.</p>`}
+        : html`<p class="card-note">No likely duplicates: no two memories are ${Math.round(DUPLICATE * 100)}% alike or more.</p>`}
     </section>
 
     <section class="card span2"><h2>Changes per week</h2>${chart("changes", changes, WHO, TOOL_COLORS, WHO_LABELS, `No memory changes in the past ${WEEKS} weeks.`)}</section>
@@ -153,9 +153,13 @@ export function insightsPage() {
   </div>`;
 }
 
+/** Cosine similarity at or above which two memories may say the same thing. Set from pairs that were merged as
+ *  duplicates (0.69-0.70 with the embedding model) and related ones that were not (0.63 and below). */
+const DUPLICATE = 0.65;
+
 /** The pairs shown under Possible duplicates, so Compare can find its pair by position. */
 export function duplicatePairs() {
   const M = app.M, pairs = [];
-  M.forEach((m, i) => m.similar.forEach((s) => { if (s.i > i && s.s >= 0.45 && M[s.i]) pairs.push([m, M[s.i], s.s]); }));
+  M.forEach((m, i) => m.similar.forEach((s) => { if (s.i > i && s.s >= DUPLICATE && M[s.i]) pairs.push([m, M[s.i], s.s]); }));
   return pairs.sort((a, b) => b[2] - a[2]).slice(0, 5);
 }

{agent_memory_git-0.1.12 → agent_memory_git-0.1.14}/src/agent_memory/webui/js/views/settings.js

@@ -123,6 +123,15 @@ function doctor() {
   </section>`;
 }
 
+// ---------------------------------------------------------------- where agent-memory lives
+
+/** The project's site and repository, as [project.urls] in pyproject.toml has them. */
+const LINKS = [["Website", "https://ki-seki.github.io/agent-memory/"], ["GitHub", "https://github.com/Ki-Seki/agent-memory"]];
+
+function about() {
+  return html`<nav class="about" aria-label="agent-memory">${LINKS.map(([text, href], i) => html`${i ? html`<span class="sep">·</span>` : ""}<a${attrs({ href, target: "_blank", rel: "noopener noreferrer" })}>${text}${icon("arrow-up-right")}</a>`)}</nav>`;
+}
+
 export function settingsPage() {
-  return html`<div class="settings">${hero()}${prefs()}${doctor()}</div>`;
+  return html`<div class="settings">${hero()}${prefs()}${doctor()}${about()}</div>`;
 }