etchmem 0.1.2__tar.gz → 0.1.3__tar.gz

{etchmem-0.1.2 → etchmem-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etchmem
-Version: 0.1.2
+Version: 0.1.3
 Summary: A pluggable, embeddable reconsolidating skill memory engine for AI agents
 Author: Andrey Olishchuk
 License: MIT

{etchmem-0.1.2 → etchmem-0.1.3}/etchmem/consolidate/worker.py

@@ -25,6 +25,7 @@ from __future__ import annotations
 import json
 import time
 from dataclasses import dataclass, field
+from datetime import datetime, timezone
 from typing import Any
 
 from etchmem.config import Config
@@ -53,6 +54,9 @@ accurate knowledge article from a set of raw signal fragments.
 ## Instructions
 - Write a single, cohesive knowledge article that captures all key facts.
 - Do NOT invent facts not present in the fragments.
+- Each fragment may be prefixed with a timestamp like `[21 Jun 2025, 15:25 UTC]`.
+  Preserve these timestamps verbatim inline, anchoring the facts they precede,
+  e.g. "As of 21 Jun 2025, 15:25 UTC, the deployment was rolled back."
 - At the end of the article, output a JSON block on its own line:
   {{"tags": {{"access_level": "...", "topic": "...", "product": "..."}}}}
 
@@ -74,6 +78,9 @@ accurate and incorporates the new information.
 - Preserve ALL load-bearing facts from the existing article.
 - Incorporate relevant new information from the fresh context.
 - Remove outdated claims only when the fresh context explicitly supersedes them.
+- Fresh context fragments may be prefixed with a timestamp like `[21 Jun 2025, 15:25 UTC]`.
+  Preserve these timestamps verbatim inline, anchoring the facts they precede.
+  Also carry forward any timestamps already present in the existing article.
 - At the end, output a JSON block on its own line:
   {{"tags": {{"access_level": "...", "topic": "...", "product": "..."}}}}
 
@@ -93,6 +100,13 @@ Reply with exactly one word: YES or NO.
 """
 
 
+def _stamp(ts: float) -> str:
+    """Format a Unix timestamp as a human-readable UTC string, e.g. '21 Jun 2025, 15:25 UTC'."""
+    if not ts:
+        return "unknown time"
+    return datetime.fromtimestamp(ts, tz=timezone.utc).strftime("%-d %b %Y, %H:%M UTC")
+
+
 def _parse_synthesis_output(raw: str) -> tuple[str, dict]:
     """Split LLM output into (article_text, tags_dict)."""
     lines = raw.strip().split("\n")
@@ -351,8 +365,10 @@ class Worker:
                     return [item]
             return []
 
-        # Synthesize
-        fragments = "\n\n---\n\n".join(d.content for d in cluster.deposits)
+        # Synthesize — prefix each fragment with its absolute UTC timestamp
+        fragments = "\n\n---\n\n".join(
+            f"[{_stamp(d.created_at)}]\n{d.content}" for d in cluster.deposits
+        )
         prompt = _FORMATION_PROMPT.format(fragments=fragments)
         raw = self._connector.complete(prompt)
         article_text, tags = _parse_synthesis_output(raw)
@@ -396,8 +412,10 @@ class Worker:
                             current_articles[r.id] = item
                             break
 
-        # Fresh deposit content for the cluster
-        fresh_texts = [d.content for d in cluster.deposits]
+        # Fresh deposit content for the cluster — prefix with absolute UTC timestamps
+        fresh_texts = [
+            f"[{_stamp(d.created_at)}]\n{d.content}" for d in cluster.deposits
+        ]
         snapshots = [re.relational_snapshot for re in cluster.recall_events]
         all_fresh = fresh_texts + snapshots
         fresh_combined = "\n\n---\n\n".join(t for t in all_fresh if t.strip())

{etchmem-0.1.2 → etchmem-0.1.3}/etchmem/recall/recaller.py

@@ -18,6 +18,7 @@ from __future__ import annotations
 
 import time
 import uuid
+from datetime import datetime, timezone
 from typing import Any
 
 from etchmem.config import Config
@@ -87,13 +88,23 @@ class Recaller:
         merged = self._merge(injected_results, relational_results, top_k)
 
         # ── 4. Emit recall-event into buffer ──────────────────────────────
-        relational_snapshot = "\n\n".join(r.content for r in relational_results)
+        # Stamp each relational hit so time context survives into the snapshot
+        relational_snapshot = "\n\n".join(
+            f"[{self._stamp(r.created_at)}]\n{r.content}" for r in relational_results
+        )
         self._emit_recall_event(query, relational_snapshot, skill, hint)
 
         return merged
 
     # ── Helpers ───────────────────────────────────────────────────────────
 
+    @staticmethod
+    def _stamp(ts: float) -> str:
+        """Format a Unix timestamp as a human-readable UTC string."""
+        if not ts:
+            return "unknown time"
+        return datetime.fromtimestamp(ts, tz=timezone.utc).strftime("%-d %b %Y, %H:%M UTC")
+
     def _merge(
         self,
         injected: list[SearchResult],

{etchmem-0.1.2 → etchmem-0.1.3}/etchmem.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etchmem
-Version: 0.1.2
+Version: 0.1.3
 Summary: A pluggable, embeddable reconsolidating skill memory engine for AI agents
 Author: Andrey Olishchuk
 License: MIT

{etchmem-0.1.2 → etchmem-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "etchmem"
-version = "0.1.2"
+version = "0.1.3"
 description = "A pluggable, embeddable reconsolidating skill memory engine for AI agents"
 readme = "README.md"
 license = { text = "MIT" }