keep-skill 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

keep/store.py

@@ -49,13 +49,14 @@ class ChromaStore:
     pluggable backends (SQLite+faiss, Postgres+pgvector, etc.)
     """
     
-    def __init__(self, store_path: Path, embedding_dimension: int):
+    def __init__(self, store_path: Path, embedding_dimension: Optional[int] = None):
         """
         Initialize or open a ChromaDb store.
-        
+
         Args:
             store_path: Directory for persistent storage
-            embedding_dimension: Expected dimension of embeddings (for validation)
+            embedding_dimension: Expected dimension of embeddings (for validation).
+                Can be None for read-only access; will be set on first write.
         """
         try:
             import chromadb
@@ -131,7 +132,10 @@ class ChromaStore:
             summary: Human-readable summary (stored as document)
             tags: All tags (source + system + generated)
         """
-        if len(embedding) != self._embedding_dimension:
+        # Validate or set embedding dimension
+        if self._embedding_dimension is None:
+            self._embedding_dimension = len(embedding)
+        elif len(embedding) != self._embedding_dimension:
             raise ValueError(
                 f"Embedding dimension mismatch: expected {self._embedding_dimension}, "
                 f"got {len(embedding)}"
@@ -222,6 +226,40 @@ class ChromaStore:
         )
         return True
 
+    def update_tags(self, collection: str, id: str, tags: dict[str, str]) -> bool:
+        """
+        Update tags of an existing item without changing embedding or summary.
+
+        Args:
+            collection: Collection name
+            id: Item identifier
+            tags: New tags dict (replaces existing)
+
+        Returns:
+            True if item was updated, False if not found
+        """
+        coll = self._get_collection(collection)
+
+        # Get existing item
+        existing = coll.get(ids=[id], include=["metadatas"])
+        if not existing["ids"]:
+            return False
+
+        # Update timestamp
+        now = datetime.now(timezone.utc).isoformat()
+        tags = dict(tags)  # Copy to avoid mutating input
+        tags["_updated"] = now
+        tags["_updated_date"] = now[:10]
+
+        # Convert to metadata format
+        metadata = self._tags_to_metadata(tags)
+
+        coll.update(
+            ids=[id],
+            metadatas=[metadata],
+        )
+        return True
+
     # -------------------------------------------------------------------------
     # Read Operations
     # -------------------------------------------------------------------------
@@ -340,27 +378,33 @@ class ChromaStore:
         collection: str,
         query: str,
         limit: int = 10,
+        where: dict[str, Any] | None = None,
     ) -> list[StoreResult]:
         """
         Query by full-text search on document content (summaries).
-        
+
         Args:
             collection: Collection name
             query: Text to search for
             limit: Maximum results to return
-            
+            where: Optional metadata filter (Chroma where clause)
+
         Returns:
             List of matching results
         """
         coll = self._get_collection(collection)
-        
+
         # Chroma's where_document does substring matching
-        result = coll.get(
-            where_document={"$contains": query},
-            limit=limit,
-            include=["documents", "metadatas"],
-        )
-        
+        get_params = {
+            "where_document": {"$contains": query},
+            "limit": limit,
+            "include": ["documents", "metadatas"],
+        }
+        if where:
+            get_params["where"] = where
+
+        result = coll.get(**get_params)
+
         results = []
         for i, id in enumerate(result["ids"]):
             results.append(StoreResult(
@@ -368,7 +412,7 @@ class ChromaStore:
                 summary=result["documents"][i] or "",
                 tags=self._metadata_to_tags(result["metadatas"][i]),
             ))
-        
+
         return results
     
     # -------------------------------------------------------------------------

{keep_skill-0.1.0.dist-info → keep_skill-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keep-skill
-Version: 0.1.0
+Version: 0.2.0
 Summary: Semantic memory - remember and search documents by meaning
 Project-URL: Homepage, https://github.com/hughpyle/keep
 Project-URL: Repository, https://github.com/hughpyle/keep
@@ -57,7 +57,7 @@ Description-Content-Type: text/markdown
 
 ## What is this?
 
-A practice tool for agents who want to develop judgment.
+An agent skill.  A practice tool for agents who want to develop judgment.
 
 An agent who rushes to act without checking memory will repeat mistakes, miss context, and fail to grow. An agent who reflects — before, during, after — becomes skillful. This library provides the mirror: persistent semantic memory that lets you ask "what do I already know?" before acting, and "what did I learn?" after.
 
@@ -65,16 +65,12 @@ For the full practice guide, see **[SKILL.md](SKILL.md)**.
 
 Technically: semantic search using embeddings, backed by ChromaDB, with tag-based organization and recency decay. Available as CLI and Python API.
 
-```python
-from keep import Keeper
-
-kp = Keeper()
-
+```bash
 # Before acting: what do I already know?
-results = kp.find("how should we handle auth?")
+keep find "how should we handle auth?"
 
 # After learning: capture it for future you
-kp.remember("User prefers OAuth2 with PKCE for authentication")
+keep update "User prefers OAuth2 with PKCE for authentication"
 ```
 
 **The practice:**
@@ -144,18 +140,32 @@ pip install keep-skill
 ```bash
 keep init
 # ⚠️  Remember to add .keep/ to .gitignore
+
+# Index a file
+keep update path/to/document.md --tag project=myapp
+
+# Store inline content
+keep update "Important: rate limit is 100 req/min" --tag topic=api
+
+# Semantic search
+keep find "what's the rate limit?"
+
+# Tag lookup
+keep tag topic=api
 ```
 
+### Python API
+
 ```python
 from keep import Keeper
 
 kp = Keeper()
 
 # Index a file
-kp.update("file:///path/to/document.md", source_tags={"project": "myapp"})
+kp.update("file:///path/to/document.md", tags={"project": "myapp"})
 
-# Remember inline content
-kp.remember("Important: rate limit is 100 req/min", source_tags={"topic": "api"})
+# Store inline content (API method)
+kp.remember("Important: rate limit is 100 req/min", tags={"topic": "api"})
 
 # Semantic search
 results = kp.find("what's the rate limit?", limit=5)
@@ -206,7 +216,7 @@ See [docs/OPENCLAW-INTEGRATION.md](docs/OPENCLAW-INTEGRATION.md) for details.
 - **[docs/REFERENCE.md](docs/REFERENCE.md)** — Complete API reference
 - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** — How it works under the hood
 - **[docs/OPENCLAW-INTEGRATION.md](docs/OPENCLAW-INTEGRATION.md)** — OpenClaw integration guide
-- **[patterns/](patterns/)** — Domain and conversation patterns
+- **[docs/system/](docs/system/)** — Domain and conversation patterns
 
 ---
 
@@ -239,7 +249,7 @@ An agent without memory reacts to each moment as if it were new. An agent with m
 **Current**: v0.1.0 — Early draft
 
 **Working:**
-- ✅ Core indexing (`update`, `remember`)
+- ✅ Core indexing (`update` with URI, text, or stdin modes)
 - ✅ Semantic search (`find`, `find_similar`)
 - ✅ Tag queries and full-text search
 - ✅ Embedding cache for performance
@@ -274,7 +284,11 @@ MIT
 
 ## Contributing
 
-This is an early draft. Issues and PRs welcome, especially for:
+This project is published on [PyPI as `keep-skill`](https://pypi.org/project/keep-skill/).
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on versioning and backward compatibility.
+
+Issues and PRs welcome, especially for:
 - Additional provider implementations
 - Performance improvements
 - Documentation clarity

keep_skill-0.2.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+keep/__init__.py,sha256=371SMehsuIYYX8AfbaPplhF-YJa8qcpoUyGTOcX9Iwg,1581
+keep/__main__.py,sha256=3Uu70IhIDIjh8OW6jp9jQQ3dF2lKdJWi_3FtRIQMiMY,104
+keep/api.py,sha256=xM0VPzSNdeXp94fbuEzq1K1L7EZ_Ojy3U1UOMhQrgXo,48158
+keep/chunking.py,sha256=neAXOLSvVwbUxapbqq7nZrbSNSzMXuhxj-ODoOSodsU,11830
+keep/cli.py,sha256=Gl_0Ap5FWWPD7Hwj3FoGEgN3e0yyW8YeIVx75gk1KzY,25209
+keep/config.py,sha256=wRTKcvpQdZQQl7vAr5RKgIbSjkgYpPc_w78qmXdmtmU,15833
+keep/context.py,sha256=CNpjmrv6eW2kV1E0MO6qAQfhYKRlfzAL--6v4Mj1nFY,71
+keep/document_store.py,sha256=1WhlF6hpshVXp2MGGF-zBJi6pSmS-tMHFmwG3EwaXik,17515
+keep/errors.py,sha256=G9e5FbdfeugyfHOuL_SPZlM5jgWWnwsX4hM7IzanBZc,857
+keep/indexing.py,sha256=dpPYo3WXnIhFDWinz5ZBZVk7_qumeNpP4EpOIY0zMbs,6063
+keep/logging_config.py,sha256=IGwkgIyg-TfYaT4MnoCXfmjeHAe_wsB_XQ1QhVT_ro8,3503
+keep/paths.py,sha256=Dv7pM6oo2QgjL6sj5wPjhuMOK2wqUkfd4Kz08TwJ1ps,3331
+keep/pending_summaries.py,sha256=KRQ2AGQNnKlDBoVbOF7tkSv1oTmlimWtJzxQ3YcaVKY,5472
+keep/store.py,sha256=txaydUIrhbB-S-cSlSszxOVlAg0kJXmS_Mnit6jzR3c,14483
+keep/types.py,sha256=f6uOSYsYt6mj1ulKn2iRkooi__dWCiOQFPD6he2eID4,2149
+keep/providers/__init__.py,sha256=GFX_12g9OdjmpFUkTekOQBOWvcRW2Ae6yidfVVW2SiI,1095
+keep/providers/base.py,sha256=7Ug4Kj9fK2Dq4zDcZjn-GKsoZBOAlB9b-FMk969ER-g,14590
+keep/providers/documents.py,sha256=EXeSy5i3RUL0kciIC6w3ldAEfbTIyC5fgfzC_WAI0iY,8211
+keep/providers/embedding_cache.py,sha256=hUuQuP8MeXQdEr0eYqHesH-5wX1kRpumJQQ3o1_DI_A,8601
+keep/providers/embeddings.py,sha256=zi8GyitKexdbCJyU1nLrUhGt_zzPn3udYrrPZ5Ak8Wo,9081
+keep/providers/llm.py,sha256=BxROKOklKbkGsHcSADPNNgWQExgSN6Bg4KPQIxVuB3U,12441
+keep/providers/mlx.py,sha256=aNl00r9tGi5tCGj2ArYH7CmDHtL1jLjVzb1rofU1DAo,9050
+keep/providers/summarization.py,sha256=MlVTcYipaqp2lT-QYnznp0AMuPVG36QfcTQnvY7Gb-Q,3409
+keep_skill-0.2.0.dist-info/METADATA,sha256=mQtDWzLbEX_L6aKoM807zxph0y4J6IP45zGXQIvHuFU,9305
+keep_skill-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+keep_skill-0.2.0.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
+keep_skill-0.2.0.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
+keep_skill-0.2.0.dist-info/RECORD,,

keep_skill-0.1.0.dist-info/RECORD

@@ -1,26 +0,0 @@
-keep/__init__.py,sha256=NwdXFUPjU-allCi_LrNP0wx_vosyISRkbMvzjfjoLWE,1683
-keep/__main__.py,sha256=3Uu70IhIDIjh8OW6jp9jQQ3dF2lKdJWi_3FtRIQMiMY,104
-keep/api.py,sha256=x-RgHCTiSLiEfrD7SaUief8oNvZfWsapS4HvF4Skf40,23236
-keep/chunking.py,sha256=neAXOLSvVwbUxapbqq7nZrbSNSzMXuhxj-ODoOSodsU,11830
-keep/cli.py,sha256=Y1qAkAERNhY4rbYeQAYXyDnY-L5_zO02OuANEQnNR-Y,14288
-keep/config.py,sha256=afRHZUxU7gpguCAVItZSeb_Q6Nm7vukBdXtd8X3NoKQ,10662
-keep/context.py,sha256=iQGjkOkDeYEba01JqJ54yMTEDxbhT34ijoaURnOXMRo,4627
-keep/indexing.py,sha256=NsiiGvkMJ4tUl7_PJw0aLBl9mKunMVy1M8csSHkd9Pw,6062
-keep/logging_config.py,sha256=gFi-PEPLucztChHByOHEVjt-v6erK76p1EZAlOCHSHk,2453
-keep/paths.py,sha256=_iLYeuqcsAz-PtNhBqtvhOoncc8XxlSq-fahszYMJaU,1662
-keep/pending_summaries.py,sha256=Py0Q6tuq_eTUfTFs0-KEEolYW4oOaYMTF7It9BjLGo4,5165
-keep/store.py,sha256=iIUvl4w7bn_JFWCjmMt7TW8c2JM6gJ1s3kDW6FOSuHs,13074
-keep/types.py,sha256=f6uOSYsYt6mj1ulKn2iRkooi__dWCiOQFPD6he2eID4,2149
-keep/providers/__init__.py,sha256=GFX_12g9OdjmpFUkTekOQBOWvcRW2Ae6yidfVVW2SiI,1095
-keep/providers/base.py,sha256=7Ug4Kj9fK2Dq4zDcZjn-GKsoZBOAlB9b-FMk969ER-g,14590
-keep/providers/documents.py,sha256=EXeSy5i3RUL0kciIC6w3ldAEfbTIyC5fgfzC_WAI0iY,8211
-keep/providers/embedding_cache.py,sha256=JzJmprYk2v5vv5eF9vO1Yegt7VdHkSQguReqvEtOCrM,8360
-keep/providers/embeddings.py,sha256=vB-Ffio4oEHBnu-xCX9SJpN1x661koJiRWYlZps7Jwo,7632
-keep/providers/llm.py,sha256=BxROKOklKbkGsHcSADPNNgWQExgSN6Bg4KPQIxVuB3U,12441
-keep/providers/mlx.py,sha256=9g7Rfl04jL_aWoY9C-OEtjCwhG6zlEWHwFpYGTSHArA,9022
-keep/providers/summarization.py,sha256=MlVTcYipaqp2lT-QYnznp0AMuPVG36QfcTQnvY7Gb-Q,3409
-keep_skill-0.1.0.dist-info/METADATA,sha256=gSyRYmNdU5N-elV6Z6PN5QTIIRo25eTfBea7AQvKwP8,8892
-keep_skill-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-keep_skill-0.1.0.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
-keep_skill-0.1.0.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
-keep_skill-0.1.0.dist-info/RECORD,,