agent-memory-git 0.1.13__tar.gz → 0.1.15__tar.gz

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-memory-git
-Version: 0.1.13
+Version: 0.1.15
 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.13 → agent_memory_git-0.1.15}/pyproject.toml

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

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/pyproject.toml.orig

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

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/src/agent_memory/PROTOCOL.md

@@ -1,6 +1,6 @@
 # Shared memory
 
-You have a persistent memory that Claude Code and Codex share. Every memory is one Markdown file in a git repository. At the start of each session a hook injects a block titled "Shared memory index": it lists the memories relevant to the current folder and repository, and gives the memories directory, this session's staging directory and the path of the `mem` command. If the active profile changes while the session runs, a new index arrives with your next message and replaces the earlier one: from then on use only its memories and paths. If that block is missing, the memory system is not active in this session; ignore this section.
+You have a persistent memory that Claude Code and Codex share. Every memory is one Markdown file in a git repository. At the start of each session a hook injects a block titled "Shared memory index": it lists the memories relevant to the current folder and repository, and gives the memories directory, this session's staging directory and the path of the `mem` command. When the conversation holds more than one index, only the latest counts: use its memories and paths, its staging directory above all. A new one arrives with your next message when the active profile changes, and a session resumed, forked or continued from another starts with that session's index still in view. If that block is missing, the memory system is not active in this session; ignore this section.
 
 ## Reading
 

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/src/agent_memory/capture.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 from . import frontmatter, gitsync, sessions, workdir
 from .context import detect
-from .store import memories_dir, normalize, read, staging_dir
+from .store import load_all, memories_dir, normalize, read, staging_dir
 from .util import atomic_write, id_path, log, new_id, now, now_iso
 
 SESSION_FILE = ".session.json"
@@ -124,6 +124,49 @@ def promote(data_dir, sdir, session=None):
     return count
 
 
+PLACE_KEYS = ("cwd", "original_cwd", "git_root", "git_remote", "git_branch", "git_commit")
+
+
+def relocated(source, ctx):
+    """`source` moved to the project `ctx` points at (a context from relocate()), in the order _source() writes."""
+    items = [(k, v) for k, v in source.items() if k not in PLACE_KEYS]
+    place = [(k, ctx[k]) for k in PLACE_KEYS if k != "git_commit" and ctx.get(k)]
+    at = next((i for i, (k, _) in enumerate(items) if k == "transcript"), len(items))
+    return dict(items[:at] + place + items[at:])
+
+
+def rehome(data_dir, session):
+    """Move this session's `here` memories still filed under its throwaway folder to the project it worked in.
+
+    promote() decides from the transcript so far, which finds nothing when a memory is written before the
+    session touches a project folder on this machine; each later turn tries again. Returns how many moved.
+    """
+    ctx = session.get("ctx") or {}
+    tool, sid = session.get("tool"), session.get("session_id")
+    if not sid or not workdir.is_throwaway(ctx.get("cwd")):
+        return 0
+    left = [
+        m
+        for m in load_all(data_dir)
+        if m["scope"] == "here"
+        and m["source"].get("session_id") == sid
+        and m["source"].get("tool") == tool
+        and workdir.is_throwaway(m["source"].get("cwd"))
+        and not m["source"].get("original_cwd")
+    ]
+    if not left:
+        return 0
+    moved = relocate(ctx, session.get("transcript_path") or sessions.transcript_path(tool, sid))
+    if not moved.get("original_cwd"):
+        return 0  # still no project to point at
+    for m in left:
+        path = memories_dir(data_dir) / m["rel"]
+        meta, body = read(path)
+        meta["source"] = relocated(meta["source"], moved)
+        atomic_write(path, frontmatter.join(meta, body))
+    return len(left)
+
+
 def stamp_updates(data_dir):
     """Set `updated` on tracked memory files that were edited in place."""
     r = gitsync.git(data_dir, "status", "--porcelain", "-z", "--", "memories")
@@ -175,6 +218,7 @@ def flush(data_dir, sdir, final=False, lock_timeout=5.0):
             return False
         session = read_session(sdir)
         n = promote(data_dir, sdir, session)
+        rehome(data_dir, session)
         committed = commit(data_dir, session)
         if final and Path(sdir).is_dir() and not any(Path(sdir).glob("*.md")):
             shutil.rmtree(sdir, ignore_errors=True)
@@ -183,6 +227,31 @@ def flush(data_dir, sdir, final=False, lock_timeout=5.0):
         return committed
 
 
+TOOLS = ("claude-code", "codex")  # the prefixes of staging folder names: <tool>-<session id>
+
+
+def adopt(sdir):
+    """Session info for a staging folder that has none, from its name and that session's transcript.
+
+    An agent can write into a staging folder that is not its session's own, such as the one named in the older
+    index of a session it was continued from; the folder it makes has no .session.json, and without this the
+    memories in it are committed with no provenance at all. They are credited to the folder's session.
+    """
+    name = Path(sdir).name
+    tool = next((t for t in TOOLS if name.startswith(t + "-")), None)
+    if not tool:
+        return
+    sid = name[len(tool) + 1 :]
+    transcript = sessions.transcript_path(tool, sid)
+    info = {"tool": tool, "session_id": sid, "transcript_path": transcript}
+    folder = sessions.cwd(tool, sid, transcript)
+    if folder:
+        ctx = detect(folder)
+        ctx.pop("git_commit", None)  # HEAD now, not what the session saw
+        info["ctx"] = ctx
+    write_session(sdir, info)
+
+
 def recover_orphans(data_dir, keep=None):
     """Promote staging dirs left by sessions that ended without a final flush."""
     root = staging_dir(data_dir)
@@ -196,6 +265,8 @@ def recover_orphans(data_dir, keep=None):
         age = time.time() - (marker.stat().st_mtime if marker.exists() else sdir.stat().st_mtime)
         has_files = any(sdir.glob("*.md"))
         if has_files and age > ORPHAN_AGE:
+            if not marker.exists():
+                adopt(sdir)
             committed |= flush(data_dir, sdir, final=True, lock_timeout=1.0)
         elif not has_files and age > STALE_AGE:
             shutil.rmtree(sdir, ignore_errors=True)

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/src/agent_memory/cli.py

@@ -129,12 +129,7 @@ def cmd_relocate(args):
         if args.dry_run:
             continue
         meta, body = store.read(mdir / m["rel"])
-        source = dict(meta.get("source") or {})
-        for key in ("cwd", "git_root", "git_remote", "git_branch"):
-            source.pop(key, None)
-            if ctx.get(key):
-                source[key] = ctx[key]
-        source["original_cwd"] = ctx["original_cwd"]
+        source = capture.relocated(dict(meta.get("source") or {}), ctx)
         if transcript:
             source.setdefault("transcript", transcript)
         meta["source"] = source

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/src/agent_memory/sessions.py

@@ -53,6 +53,26 @@ def transcript_path(tool, session_id):
     return str(hits[0]) if hits else ""
 
 
+def cwd(tool, session_id, transcript=None):
+    """The folder a session ran in: Codex's thread record, or the first Claude transcript line that names one."""
+    if tool == "codex":
+        return _codex_thread(session_id, "cwd")
+    try:
+        with open(transcript, encoding="utf-8", errors="replace") as f:
+            for raw in f:
+                if '"cwd"' not in raw:
+                    continue
+                try:
+                    found = json.loads(raw).get("cwd")
+                except ValueError:
+                    continue
+                if found:
+                    return found
+    except (OSError, TypeError):
+        pass
+    return ""
+
+
 def title(tool, session_id, transcript=None):
     if tool == "codex":
         name = _codex_title(session_id)

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/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.13 → agent_memory_git-0.1.15}/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.13 → agent_memory_git-0.1.15}/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.13 → agent_memory_git-0.1.15}/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.13 → agent_memory_git-0.1.15}/src/agent_memory/webui/js/views/list.js

@@ -52,7 +52,7 @@ function facet(def) {
       ${options.map((o) => {
         const on = values.includes(o.value);
         return html`<button type="button" role="menuitemcheckbox" class="${cx("menu-item", !o.count && !on && "faint")}"${attrs({ "aria-checked": String(on), "data-act": "toggle", "data-arg": `${def.key}:${o.value}`, "data-key": `${def.key}:${o.value}` })}>
-          <span class="tick">${on ? icon("check", "", 3) : ""}</span><span class="grow">${o.label}</span><span class="count">${o.count}</span></button>`;
+          <span class="tick">${on ? icon("check", "", 3) : ""}</span><span class="grow truncate"${attrs({ title: o.label })}>${o.label}</span><span class="count">${o.count}</span></button>`;
       })}
     </div>
     ${values.length ? html`<div class="menu-foot"><button type="button" class="menu-wide" data-act="setList" data-arg="${def.key}">Clear ${def.label.toLowerCase()}</button></div>` : ""}`;
@@ -73,7 +73,7 @@ function added() {
       ${opts.map((o) => {
         const on = v === o.value;
         return html`<button type="button" role="radio" class="${cx("menu-item", !o.count && !on && "faint")}"${attrs({ "aria-checked": String(on), "data-act": "setAdded", "data-arg": on ? "" : o.value })}>
-          <span class="radio">${on ? html`<i></i>` : ""}</span><span class="grow">${o.label}</span><span class="count">${o.count}</span></button>`;
+          <span class="radio">${on ? html`<i></i>` : ""}</span><span class="grow truncate"${attrs({ title: o.label })}>${o.label}</span><span class="count">${o.count}</span></button>`;
       })}
     </div>
     <div class="menu-range">

{agent_memory_git-0.1.13 → agent_memory_git-0.1.15}/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>`;
 }