memory-seed 2.2.1__tar.gz → 2.3.0__tar.gz

{memory_seed-2.2.1 → memory_seed-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory-seed
-Version: 2.2.1
+Version: 2.3.0
 Summary: Portable local memory seed for file-reading AI coding agents
 Author: Jean Nathan Tshibuyi
 License: MIT
@@ -136,7 +136,7 @@ The result is a lightweight memory workflow you can understand, commit, review,
 | Agent or client | Support path |
 | --- | --- |
 | Codex | Starts from `AGENTS.md`; can use MCP when the client supports stdio MCP servers. |
-| Claude Code | Starts from `CLAUDE.md`; can register `memory-seed-mcp` through `uvx`. |
+| Claude Code | Starts from `CLAUDE.md`; MCP server auto-registered via `uvx --from memory-seed`. |
 | Gemini CLI | Starts from `GEMINI.md`. |
 | Other file-reading agents | Start from `AGENTS.md` and follow nearest `.memory-seed/` runtime discovery. |
 | MCP-capable clients | Use `memory_search` and `memory_get_chunk` through `memory-seed-mcp --stdio`. |
@@ -200,7 +200,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.0`.
+The current reusable control-plane version is `2.3`.
 
 Legacy `.AGENTS/` projects remain supported as a fallback during migration.
 
@@ -304,7 +304,7 @@ When `--force` creates backups, Memory Seed adds `.memory-seed/backups/` to the
 
 The `update` command refreshes routing files, reusable runtime procedure files, and generic skill templates by version, sourcing them **from the installed package** rather than from PyPI — upgrade the package first to get newer templates (see [Updating](#updating)). Before replacing stale reusable control-plane files, it backs them up under `.memory-seed/backups/<timestamp>/` and archives their old version under `.memory-seed/archive/<old-version>/` or `.memory-seed/archive/unknown-<timestamp>/` when the old version is missing. Generated local memory files such as `index.md`, `policy.md`, and sessions are preserved.
 
-Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files that already have the current `memory-system-version` and preserves existing `.memory-seed/` runtime files.
+Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files already at the current `memory-system-version` or newer — so a stale installed tool never downgrades a project — and preserves existing `.memory-seed/` runtime files.
 
 The `compact` command summarises recent session activity from the nearest runtime so an agent can identify durable facts to promote into `index.md`, `policy.md`, or skills:
 
@@ -365,7 +365,7 @@ For the version distinction (`pip show memory-seed` reports the package version;
 
 Memory Seed also includes a lightweight MCP server that lets agents search local session memory through structured tool calls instead of shelling out to broad compact summaries.
 
-**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed.
+**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `uvx --from memory-seed memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed. The `uvx --from` form is used so the command works regardless of whether `~/.local/bin` is on the agent's PATH.
 
 If you are configuring the server manually, run it over stdio:
 

{memory_seed-2.2.1 → memory_seed-2.3.0}/README.md

@@ -115,7 +115,7 @@ The result is a lightweight memory workflow you can understand, commit, review,
 | Agent or client | Support path |
 | --- | --- |
 | Codex | Starts from `AGENTS.md`; can use MCP when the client supports stdio MCP servers. |
-| Claude Code | Starts from `CLAUDE.md`; can register `memory-seed-mcp` through `uvx`. |
+| Claude Code | Starts from `CLAUDE.md`; MCP server auto-registered via `uvx --from memory-seed`. |
 | Gemini CLI | Starts from `GEMINI.md`. |
 | Other file-reading agents | Start from `AGENTS.md` and follow nearest `.memory-seed/` runtime discovery. |
 | MCP-capable clients | Use `memory_search` and `memory_get_chunk` through `memory-seed-mcp --stdio`. |
@@ -179,7 +179,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.0`.
+The current reusable control-plane version is `2.3`.
 
 Legacy `.AGENTS/` projects remain supported as a fallback during migration.
 
@@ -283,7 +283,7 @@ When `--force` creates backups, Memory Seed adds `.memory-seed/backups/` to the
 
 The `update` command refreshes routing files, reusable runtime procedure files, and generic skill templates by version, sourcing them **from the installed package** rather than from PyPI — upgrade the package first to get newer templates (see [Updating](#updating)). Before replacing stale reusable control-plane files, it backs them up under `.memory-seed/backups/<timestamp>/` and archives their old version under `.memory-seed/archive/<old-version>/` or `.memory-seed/archive/unknown-<timestamp>/` when the old version is missing. Generated local memory files such as `index.md`, `policy.md`, and sessions are preserved.
 
-Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files that already have the current `memory-system-version` and preserves existing `.memory-seed/` runtime files.
+Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files already at the current `memory-system-version` or newer — so a stale installed tool never downgrades a project — and preserves existing `.memory-seed/` runtime files.
 
 The `compact` command summarises recent session activity from the nearest runtime so an agent can identify durable facts to promote into `index.md`, `policy.md`, or skills:
 
@@ -344,7 +344,7 @@ For the version distinction (`pip show memory-seed` reports the package version;
 
 Memory Seed also includes a lightweight MCP server that lets agents search local session memory through structured tool calls instead of shelling out to broad compact summaries.
 
-**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed.
+**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `uvx --from memory-seed memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed. The `uvx --from` form is used so the command works regardless of whether `~/.local/bin` is on the agent's PATH.
 
 If you are configuring the server manually, run it over stdio:
 

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/core.py

@@ -10,7 +10,7 @@ from pathlib import Path
 
 PACKAGE_ROOT = Path(__file__).resolve().parent
 SEED_ROOT = PACKAGE_ROOT / "seed"
-VERSION = "2.1"
+VERSION = "2.3"
 MEMORY_DIR_NAME = ".memory-seed"
 LEGACY_MEMORY_DIR_NAME = ".AGENTS"
 BACKUP_IGNORE_ENTRY = ".memory-seed/backups/"
@@ -128,9 +128,10 @@ _CODEX_RETRIEVAL_COMMAND = "python3 .memory-seed/hooks/memory-retrieval-check.py
 _CURSOR_RETRIEVAL_COMMAND = "python3 .memory-seed/hooks/memory-retrieval-check.py --cursor"
 _GEMINI_RETRIEVAL_COMMAND = "python3 .memory-seed/hooks/memory-retrieval-check.py --gemini"
 
-_MCP_SERVER_COMMAND = "memory-seed-mcp"
-_MCP_SERVER_ARGS = ["--stdio"]
+_MCP_SERVER_COMMAND = "uvx"
+_MCP_SERVER_ARGS = ["--from", "memory-seed", "memory-seed-mcp", "--stdio"]
 _MCP_SERVER_KEY = "memory-seed"
+_OWN_MCP_COMMANDS = {"uvx", "memory-seed-mcp"}
 
 BOOTSTRAP_GENERATED_FILES = [
     ".memory-seed/index.md",
@@ -364,7 +365,8 @@ def _merge_claude_mcp(target_root: Path) -> bool:
     existing = data.get("mcpServers", {}).get(_MCP_SERVER_KEY, {})
     if existing == expected:
         return False
-    if existing and existing.get("command") != _MCP_SERVER_COMMAND:
+    is_ours = existing.get("command") in _OWN_MCP_COMMANDS or "memory-seed-mcp" in existing.get("args", [])
+    if existing and not is_ours:
         return False  # a different server is using this key; don't overwrite
 
     data.setdefault("mcpServers", {})[_MCP_SERVER_KEY] = expected
@@ -393,7 +395,8 @@ def _merge_cursor_mcp(target_root: Path) -> bool:
     existing = data.get("mcpServers", {}).get(_MCP_SERVER_KEY, {})
     if existing == expected:
         return False
-    if existing and existing.get("command") != _MCP_SERVER_COMMAND:
+    is_ours = existing.get("command") in _OWN_MCP_COMMANDS or "memory-seed-mcp" in existing.get("args", [])
+    if existing and not is_ours:
         return False  # a different server is using this key; don't overwrite
 
     data.setdefault("mcpServers", {})[_MCP_SERVER_KEY] = expected
@@ -422,7 +425,8 @@ def _merge_gemini_mcp(target_root: Path) -> bool:
     existing = data.get("mcpServers", {}).get(_MCP_SERVER_KEY, {})
     if existing == expected:
         return False
-    if existing and existing.get("command") != _MCP_SERVER_COMMAND:
+    is_ours = existing.get("command") in _OWN_MCP_COMMANDS or "memory-seed-mcp" in existing.get("args", [])
+    if existing and not is_ours:
         return False  # a different server is using this key; don't overwrite
 
     data.setdefault("mcpServers", {})[_MCP_SERVER_KEY] = expected
@@ -513,7 +517,9 @@ def update_project(cwd: str | Path = ".", dry_run: bool = False) -> InitResult:
         if _is_runtime_local_file(seed_file.destination) and destination.exists():
             continue
 
-        if destination.exists() and _read_memory_system_version(destination) == VERSION:
+        if destination.exists() and _version_at_least(
+            _read_memory_system_version(destination), VERSION
+        ):
             continue
 
         if destination.exists():
@@ -673,6 +679,21 @@ def _read_memory_system_version(path: Path) -> str | None:
     return match.group(1)
 
 
+def _version_tuple(version: str | None) -> tuple[int, ...]:
+    """Dotted version -> int tuple. Missing/unparseable -> (-1,) so it always
+    compares older than any real version and is upgraded forward."""
+    if not version:
+        return (-1,)
+    try:
+        return tuple(int(part) for part in version.strip().split("."))
+    except ValueError:
+        return (-1,)
+
+
+def _version_at_least(actual: str | None, minimum: str) -> bool:
+    return _version_tuple(actual) >= _version_tuple(minimum)
+
+
 def _is_runtime_local_file(destination: str) -> bool:
     reusable_runtime_files = {
         f"{MEMORY_DIR_NAME}/agent-rules.md",

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/agent-rules.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - agent-rules
@@ -292,11 +292,12 @@ Deferring or batching session log writes is a discipline failure, not an accepta
 The session file is strictly append-only and must stay in ascending time order. To guarantee this without ever reordering:
 
 - Append every new entry to the **end** of the day's file. Never insert an entry above an existing one.
+- **Append each entry at the physical end of the file; never insert above an existing entry.** That is the rule; the mechanism is up to your tools. The common failure is anchor-based edit tools — if you target a line you wrote earlier, a later edit may already sit below it, so the new entry lands mid-file. Avoid it by confirming the *actual* last line immediately before appending (for example, read the file's tail); never reuse an anchor from memory. With a POSIX shell or Python, append mode (`>> file`, `open(f, 'a')`) sidesteps anchors entirely — write UTF-8 (some shells, for example PowerShell `>>`, default to other encodings).
 - The entry heading timestamp is the **actual current clock time** at the moment you write it. Read it from the system clock; never reuse a time from your context, memory, or an earlier message, and never backdate it to when the work happened.
 - Because entries are always appended with the current time, file order, write order, and timestamp order are identical. No manual reordering is ever needed or allowed.
 - If you are recording work that completed earlier in the session (you forgot, or you are catching up), still stamp the heading with the current time. If the original work time matters, state it in the entry body — do not move the entry above newer ones and do not rewrite earlier headings.
 
-This is the invariant the "do not rewrite old session entries" rule protects: out-of-order or backdated entries force a human to manually re-sort the log, which is exactly what append-only is meant to prevent.
+This is the invariant the "do not rewrite old session entries" rule protects: out-of-order or backdated entries force a human to manually re-sort the log, which is exactly what append-only is meant to prevent. Confirming the real last line before each append — or using append mode where your environment supports it — makes this invariant mechanical rather than reliant on a remembered anchor.
 
 Detailed work logs belong in the nearest active runtime. Add a parent/root summary only when sub-project work changes parent-visible topology, shared design, release behavior, policy inheritance, cross-project dependencies, risks, or active priorities. Do not mirror sub-project logs into root memory.
 

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/hooks/session-log-check.py

@@ -16,16 +16,34 @@ if not d.exists():
 today = datetime.now().strftime("%Y-%m-%d")
 messages = []
 
-# Staleness check: nudge a session write if nothing was logged recently.
+# Read today's entry timestamps once — used by both checks below.
+# File mtime is intentionally not used: a git commit touching the session
+# file would defeat a mtime-based staleness check.
+heading_re = re.compile(r"^## (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2})\b")
+today_file = d / f"{today}.md"
+stamps = []
+if today_file.exists():
+    for line in today_file.read_text(encoding="utf-8").splitlines():
+        m = heading_re.match(line)
+        if m:
+            stamps.append(f"{m.group(1)} {m.group(2)}")
+
+# Staleness check: the most recent timestamped entry heading must be within
+# the last 15 minutes.
 cutoff = datetime.now() - timedelta(minutes=15)
-recent = [
-    f for f in d.glob("*.md")
-    if datetime.fromtimestamp(f.stat().st_mtime) > cutoff
-]
-if not recent:
+latest = None
+for stamp in stamps:
+    try:
+        t = datetime.strptime(stamp, "%Y-%m-%d %H:%M")
+        if latest is None or t > latest:
+            latest = t
+    except ValueError:
+        pass
+
+if latest is None or latest < cutoff:
     messages.append(
         f"SESSION LOG REMINDER: No .memory-seed/sessions/ entry has been "
-        f"updated in the last 15 minutes. If you completed meaningful work "
+        f"written in the last 15 minutes. If you completed meaningful work "
         f"this turn, append an entry to .memory-seed/sessions/{today}.md "
         f"now — before this turn ends. "
         f"For decisions, use DRAFT labels: "
@@ -34,22 +52,17 @@ if not recent:
     )
 
 # Chronology check: today's entry headings must be in non-decreasing time order.
-heading_re = re.compile(r"^## (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2})\b")
-today_file = d / f"{today}.md"
-if today_file.exists():
-    stamps = []
-    for line in today_file.read_text(encoding="utf-8").splitlines():
-        m = heading_re.match(line)
-        if m:
-            stamps.append(f"{m.group(1)} {m.group(2)}")
-    if any(stamps[i] < stamps[i - 1] for i in range(1, len(stamps))):
-        messages.append(
-            f"SESSION LOG ORDER WARNING: Entries in "
-            f".memory-seed/sessions/{today}.md are not in ascending time "
-            f"order. The log is append-only: append new entries at the end "
-            f"with the current clock time, never backdated. Do not reorder "
-            f"existing entries unless the user asks for a repair."
-        )
+if any(stamps[i] < stamps[i - 1] for i in range(1, len(stamps))):
+    messages.append(
+        f"SESSION LOG ORDER WARNING: Entries in "
+        f".memory-seed/sessions/{today}.md are not in ascending time "
+        f"order. The log is append-only. To repair: move the out-of-order "
+        f"entry to the physical end of the file with the current clock "
+        f"time; confirm the actual last line before appending rather than "
+        f"reusing a remembered anchor (append mode like >> or open(f, 'a') "
+        f"avoids the problem where supported). Do not reorder existing "
+        f"entries unless the user asks for a repair."
+    )
 
 if not messages:
     sys.exit(0)

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/project-bootstrap.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - project-bootstrap

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/code_search.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/data_architecture.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/index.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill-registry

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/local_compilation.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/memory_consolidation.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/memory_doctor.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/release_publishing.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/skills/security_triage.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - memory-seed
   - skill

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/AGENTS.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - agent-entry
   - ai-memory
@@ -46,7 +46,8 @@ When initialized memory files exist, start here:
 2. Read the active `.memory-seed/index.md` for topology, active state, and inheritance rules.
 3. Read parent `.memory-seed/policy.md` only when the active index says policy is inherited.
 4. Read the active `.memory-seed/policy.md` for behavioral constraints and local overrides.
-5. Load files from `.memory-seed/skills/` only when the task matches a listed skill.
+5. Read `.memory-seed/skills/index.md` as the deterministic skill trigger registry.
+6. Load full files from `.memory-seed/skills/` only when the trigger registry matches the task.
 
 Do not read skills preemptively. Skills are lazy-loaded execution runbooks.
 

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/CLAUDE.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - agent-entry
   - ai-memory

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed/seed/GEMINI.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.1
+memory-system-version: 2.3
 tags:
   - agent-entry
   - ai-memory

{memory_seed-2.2.1 → memory_seed-2.3.0}/memory_seed.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory-seed
-Version: 2.2.1
+Version: 2.3.0
 Summary: Portable local memory seed for file-reading AI coding agents
 Author: Jean Nathan Tshibuyi
 License: MIT
@@ -136,7 +136,7 @@ The result is a lightweight memory workflow you can understand, commit, review,
 | Agent or client | Support path |
 | --- | --- |
 | Codex | Starts from `AGENTS.md`; can use MCP when the client supports stdio MCP servers. |
-| Claude Code | Starts from `CLAUDE.md`; can register `memory-seed-mcp` through `uvx`. |
+| Claude Code | Starts from `CLAUDE.md`; MCP server auto-registered via `uvx --from memory-seed`. |
 | Gemini CLI | Starts from `GEMINI.md`. |
 | Other file-reading agents | Start from `AGENTS.md` and follow nearest `.memory-seed/` runtime discovery. |
 | MCP-capable clients | Use `memory_search` and `memory_get_chunk` through `memory-seed-mcp --stdio`. |
@@ -200,7 +200,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.0`.
+The current reusable control-plane version is `2.3`.
 
 Legacy `.AGENTS/` projects remain supported as a fallback during migration.
 
@@ -304,7 +304,7 @@ When `--force` creates backups, Memory Seed adds `.memory-seed/backups/` to the
 
 The `update` command refreshes routing files, reusable runtime procedure files, and generic skill templates by version, sourcing them **from the installed package** rather than from PyPI — upgrade the package first to get newer templates (see [Updating](#updating)). Before replacing stale reusable control-plane files, it backs them up under `.memory-seed/backups/<timestamp>/` and archives their old version under `.memory-seed/archive/<old-version>/` or `.memory-seed/archive/unknown-<timestamp>/` when the old version is missing. Generated local memory files such as `index.md`, `policy.md`, and sessions are preserved.
 
-Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files that already have the current `memory-system-version` and preserves existing `.memory-seed/` runtime files.
+Use `update --dry-run` to list the reusable control-plane targets without writing files. Current behavior is conservative but broad: dry-run lists bundled seed paths rather than calculating which files are missing or version-mismatched. The real `update` command skips files already at the current `memory-system-version` or newer — so a stale installed tool never downgrades a project — and preserves existing `.memory-seed/` runtime files.
 
 The `compact` command summarises recent session activity from the nearest runtime so an agent can identify durable facts to promote into `index.md`, `policy.md`, or skills:
 
@@ -365,7 +365,7 @@ For the version distinction (`pip show memory-seed` reports the package version;
 
 Memory Seed also includes a lightweight MCP server that lets agents search local session memory through structured tool calls instead of shelling out to broad compact summaries.
 
-**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed.
+**Auto-registration:** `memory-seed init` and `memory-seed update` automatically register `uvx --from memory-seed memory-seed-mcp --stdio` in each supported vendor's config — `.claude/settings.json` (Claude Code), `.cursor/mcp.json` (Cursor), and `.gemini/settings.json` (Gemini CLI). No manual config is needed for projects initialised with Memory Seed. The `uvx --from` form is used so the command works regardless of whether `~/.local/bin` is on the agent's PATH.
 
 If you are configuring the server manually, run it over stdio:
 

{memory_seed-2.2.1 → memory_seed-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory-seed"
-version = "2.2.1"
+version = "2.3.0"
 description = "Portable local memory seed for file-reading AI coding agents"
 readme = "README.md"
 requires-python = ">=3.11"

{memory_seed-2.2.1 → memory_seed-2.3.0}/tests/test_memory_seed.py

@@ -23,7 +23,17 @@ class MemorySeedTests(unittest.TestCase):
         return path
 
     def test_version_reads_reusable_control_plane_version(self):
-        self.assertEqual(get_version(), "2.1")
+        self.assertEqual(get_version(), "2.3")
+
+    def test_version_at_least_orders_versions_numerically(self):
+        from memory_seed.core import _version_at_least
+
+        self.assertTrue(_version_at_least("2.2", "2.2"))   # equal
+        self.assertTrue(_version_at_least("2.3", "2.2"))   # newer
+        self.assertTrue(_version_at_least("2.10", "2.9"))  # multi-digit, not string compare
+        self.assertFalse(_version_at_least("2.1", "2.2"))  # older
+        self.assertFalse(_version_at_least(None, "2.2"))   # missing -> treat as older
+        self.assertFalse(_version_at_least("garbage", "2.2"))  # unparseable -> older
 
     def test_init_dry_run_reports_seed_files_without_writing(self):
         cwd = self.make_project()
@@ -90,7 +100,7 @@ class MemorySeedTests(unittest.TestCase):
         self.assertTrue(result.backed_up[0].startswith(".memory-seed/backups/"))
         self.assertEqual((cwd / result.backed_up[0]).read_text(encoding="utf-8"), "existing")
         self.assertIn(
-            "memory-system-version: 2.1",
+            "memory-system-version: 2.3",
             (cwd / "AGENTS.md").read_text(encoding="utf-8"),
         )
         self.assertIn(".memory-seed/backups/", (cwd / ".gitignore").read_text(encoding="utf-8"))
@@ -111,7 +121,7 @@ class MemorySeedTests(unittest.TestCase):
         init_project(cwd=cwd)
         gemini = cwd / "GEMINI.md"
         gemini.write_text(
-            gemini.read_text(encoding="utf-8").replace("2.1", "1.1"),
+            gemini.read_text(encoding="utf-8").replace("2.3", "1.1"),
             encoding="utf-8",
         )
         (cwd / "CLAUDE.md").unlink()
@@ -128,7 +138,7 @@ class MemorySeedTests(unittest.TestCase):
         )
         self.assertEqual(
             result.version_mismatches,
-            [{"file": "GEMINI.md", "expected": "2.1", "actual": "1.1"}],
+            [{"file": "GEMINI.md", "expected": "2.3", "actual": "1.1"}],
         )
 
     def test_doctor_distinguishes_bootstrap_completeness_from_control_plane_health(self):
@@ -211,11 +221,11 @@ class MemorySeedTests(unittest.TestCase):
         self.assertIn("CLAUDE.md", result.created)
         self.assertTrue(any(path.endswith("/AGENTS.md") for path in result.backed_up))
         self.assertIn(
-            "memory-system-version: 2.1",
+            "memory-system-version: 2.3",
             (cwd / "AGENTS.md").read_text(encoding="utf-8"),
         )
         self.assertIn(
-            "memory-system-version: 2.1",
+            "memory-system-version: 2.3",
             (cwd / "CLAUDE.md").read_text(encoding="utf-8"),
         )
         self.assertEqual(
@@ -229,7 +239,7 @@ class MemorySeedTests(unittest.TestCase):
         init_project(cwd=cwd)
         agents = cwd / "AGENTS.md"
         agents.write_text(
-            agents.read_text(encoding="utf-8").replace("2.1", "1.4"),
+            agents.read_text(encoding="utf-8").replace("2.3", "1.4"),
             encoding="utf-8",
         )
 
@@ -241,6 +251,26 @@ class MemorySeedTests(unittest.TestCase):
         self.assertTrue(archived.exists())
         self.assertIn("memory-system-version: 1.4", archived.read_text(encoding="utf-8"))
 
+    def test_update_does_not_downgrade_newer_control_plane_files(self):
+        cwd = self.make_project()
+        init_project(cwd=cwd)
+        agents = cwd / "AGENTS.md"
+        # Simulate a project on a newer control plane than this tool ships.
+        agents.write_text(
+            agents.read_text(encoding="utf-8").replace(
+                f"memory-system-version: {get_version()}",
+                "memory-system-version: 9.9",
+            ),
+            encoding="utf-8",
+        )
+
+        result = update_project(cwd=cwd)
+
+        # The newer file must be left untouched: no overwrite, no archive.
+        self.assertIn("memory-system-version: 9.9", agents.read_text(encoding="utf-8"))
+        self.assertNotIn("AGENTS.md", result.created)
+        self.assertFalse(any("AGENTS.md" in archived for archived in result.archived))
+
     def test_update_archives_unknown_version_control_plane_files_under_timestamped_folder(self):
         cwd = self.make_project()
         init_project(cwd=cwd)
@@ -313,14 +343,14 @@ class MemorySeedTests(unittest.TestCase):
         self.assertTrue(
             any(path.endswith("/.memory-seed/agent-rules.md") for path in result.backed_up)
         )
-        self.assertIn("memory-system-version: 2.1", rules.read_text(encoding="utf-8"))
+        self.assertIn("memory-system-version: 2.3", rules.read_text(encoding="utf-8"))
 
     def test_control_plane_files_report_current_version(self):
         for seed_file in SEED_FILES:
             if not seed_file.source.suffix == ".md":
                 continue
             content = seed_file.source.read_text(encoding="utf-8")
-            self.assertIn("memory-system-version: 2.1", content, seed_file.destination)
+            self.assertIn("memory-system-version: 2.3", content, seed_file.destination)
 
     def test_seed_files_use_memory_seed_runtime(self):
         destinations = sorted(seed_file.destination for seed_file in SEED_FILES)
@@ -593,6 +623,51 @@ class SessionLogOrderingHookTests(unittest.TestCase):
         )
         self.assertNotIn("ORDER WARNING", self._run(cwd))
 
+    def test_staleness_fires_when_no_session_file(self):
+        cwd = self.make_project()
+        out = self._run(cwd)
+        self.assertIn("SESSION LOG REMINDER", out)
+
+    def test_staleness_fires_when_last_entry_is_old(self):
+        import datetime
+
+        cwd = self.make_project()
+        today = datetime.date.today().isoformat()
+        (cwd / ".memory-seed" / "sessions" / f"{today}.md").write_text(
+            f"## {today} 01:00 - old entry\n\ntext\n",
+            encoding="utf-8",
+        )
+        self.assertIn("SESSION LOG REMINDER", self._run(cwd))
+
+    def test_staleness_silent_when_recent_entry(self):
+        import datetime
+
+        cwd = self.make_project()
+        now = datetime.datetime.now()
+        today = now.strftime("%Y-%m-%d")
+        recent_time = now.strftime("%H:%M")
+        (cwd / ".memory-seed" / "sessions" / f"{today}.md").write_text(
+            f"## {today} {recent_time} - recent entry\n\ntext\n",
+            encoding="utf-8",
+        )
+        self.assertNotIn("SESSION LOG REMINDER", self._run(cwd))
+
+    def test_staleness_not_defeated_by_file_mtime(self):
+        import datetime
+        import os
+
+        cwd = self.make_project()
+        today = datetime.date.today().isoformat()
+        session_file = cwd / ".memory-seed" / "sessions" / f"{today}.md"
+        session_file.write_text(
+            f"## {today} 01:00 - old entry\n\ntext\n",
+            encoding="utf-8",
+        )
+        # Touch the file to update mtime to now — simulating what git commit does.
+        os.utime(session_file, None)
+        # Staleness check should still fire because the entry heading is old.
+        self.assertIn("SESSION LOG REMINDER", self._run(cwd))
+
 
 class McpMergeTests(unittest.TestCase):
     def make_project(self):
@@ -609,8 +684,8 @@ class McpMergeTests(unittest.TestCase):
         data = json.loads((cwd / ".claude" / "settings.json").read_text())
         self.assertIn("memory-seed", data["mcpServers"])
         entry = data["mcpServers"]["memory-seed"]
-        self.assertEqual(entry["command"], "memory-seed-mcp")
-        self.assertEqual(entry["args"], ["--stdio"])
+        self.assertEqual(entry["command"], "uvx")
+        self.assertEqual(entry["args"], ["--from", "memory-seed", "memory-seed-mcp", "--stdio"])
         self.assertEqual(entry["type"], "stdio")
 
     def test_init_installs_mcp_for_cursor(self):
@@ -622,8 +697,8 @@ class McpMergeTests(unittest.TestCase):
         data = json.loads((cwd / ".cursor" / "mcp.json").read_text())
         self.assertIn("memory-seed", data["mcpServers"])
         entry = data["mcpServers"]["memory-seed"]
-        self.assertEqual(entry["command"], "memory-seed-mcp")
-        self.assertEqual(entry["args"], ["--stdio"])
+        self.assertEqual(entry["command"], "uvx")
+        self.assertEqual(entry["args"], ["--from", "memory-seed", "memory-seed-mcp", "--stdio"])
         self.assertNotIn("type", entry)
 
     def test_init_installs_mcp_for_gemini(self):
@@ -635,8 +710,8 @@ class McpMergeTests(unittest.TestCase):
         data = json.loads((cwd / ".gemini" / "settings.json").read_text())
         self.assertIn("memory-seed", data["mcpServers"])
         entry = data["mcpServers"]["memory-seed"]
-        self.assertEqual(entry["command"], "memory-seed-mcp")
-        self.assertEqual(entry["args"], ["--stdio"])
+        self.assertEqual(entry["command"], "uvx")
+        self.assertEqual(entry["args"], ["--from", "memory-seed", "memory-seed-mcp", "--stdio"])
 
     def test_mcp_merges_are_idempotent(self):
         from memory_seed.core import (
@@ -669,7 +744,9 @@ class McpMergeTests(unittest.TestCase):
         self.assertTrue(result)
 
         data = json.loads(settings.read_text())
-        self.assertEqual(data["mcpServers"]["memory-seed"]["args"], ["--stdio"])
+        entry = data["mcpServers"]["memory-seed"]
+        self.assertEqual(entry["command"], "uvx")
+        self.assertEqual(entry["args"], ["--from", "memory-seed", "memory-seed-mcp", "--stdio"])
 
     def test_mcp_merge_preserves_unrelated_mcp_server(self):
         import json