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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory-seed
-Version: 2.2.3
+Version: 2.3.0
 Summary: Portable local memory seed for file-reading AI coding agents
 Author: Jean Nathan Tshibuyi
 License: MIT
@@ -200,7 +200,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.2`.
+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:
 

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

@@ -179,7 +179,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.2`.
+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:
 

{memory_seed-2.2.3 → 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.2"
+VERSION = "2.3"
 MEMORY_DIR_NAME = ".memory-seed"
 LEGACY_MEMORY_DIR_NAME = ".AGENTS"
 BACKUP_IGNORE_ENTRY = ".memory-seed/backups/"
@@ -517,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():
@@ -677,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.3 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/agent-rules.md

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.2
+memory-system-version: 2.3
 tags:
   - memory-seed
   - agent-rules
@@ -292,12 +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.
-- **Use `>>` shell redirection or Python append mode (`open(f, 'a')`) to write entries — do not use an editor replace/insert operation.** Replace/insert requires selecting an anchor line; if a prior edit already added content after that anchor, the new entry lands mid-file instead of at the end. Append mode writes to the physical end of the file unconditionally, with no anchor needed.
+- **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. The `>>` / append-mode discipline makes this invariant mechanical rather than reliant on careful anchor selection.
+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.3 → memory_seed-2.3.0}/memory_seed/seed/.memory-seed/hooks/session-log-check.py

@@ -56,11 +56,12 @@ 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: use >> shell "
-        f"redirection or Python append mode (open(f, 'a')) to move the "
-        f"out-of-order entry to the end of the file with the current "
-        f"clock time — do not use an editor replace/insert operation. "
-        f"Do not reorder existing entries unless the user asks for a repair."
+        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:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 ---
-memory-system-version: 2.2
+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.3 → memory_seed-2.3.0}/memory_seed/seed/CLAUDE.md

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

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

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

{memory_seed-2.2.3 → 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.3
+Version: 2.3.0
 Summary: Portable local memory seed for file-reading AI coding agents
 Author: Jean Nathan Tshibuyi
 License: MIT
@@ -200,7 +200,7 @@ GEMINI.md
 
 ## Current Version
 
-The current reusable control-plane version is `2.2`.
+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:
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory-seed"
-version = "2.2.3"
+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.3 → 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.2")
+        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.2",
+            "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.2", "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.2", "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.2",
+            "memory-system-version: 2.3",
             (cwd / "AGENTS.md").read_text(encoding="utf-8"),
         )
         self.assertIn(
-            "memory-system-version: 2.2",
+            "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.2", "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.2", 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.2", 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)