keep-skill 0.8.1__py3-none-any.whl → 0.9.0__py3-none-any.whl

keep/api.py

@@ -534,13 +534,17 @@ class Keeper:
         summary: Optional[str] = None,
         source_tags: Optional[dict[str, str]] = None,  # Deprecated alias
         collection: Optional[str] = None,
-        lazy: bool = False
     ) -> Item:
         """
         Insert or update a document in the store.
 
         Fetches the document, generates embeddings and summary, then stores it.
 
+        **Summary behavior:**
+        - If summary is provided, use it (skips auto-summarization)
+        - For large content, summarization is async (truncated placeholder
+          stored immediately, real summary generated in background)
+
         **Update behavior:**
         - Summary: Replaced with user-provided or newly generated summary
         - Tags: Merged - existing tags are preserved, new tags override
@@ -553,9 +557,6 @@ class Keeper:
             summary: User-provided summary (skips auto-summarization if given)
             source_tags: Deprecated alias for 'tags'
             collection: Target collection (uses default if None)
-            lazy: If True, use truncated placeholder summary and queue for
-                  background processing. Use `process_pending()` to generate
-                  real summaries later. Ignored if summary is provided.
 
         Returns:
             The stored Item with merged tags and new summary
@@ -615,17 +616,14 @@ class Keeper:
                 )
                 summary = summary[:max_len]
             final_summary = summary
-        elif lazy:
-            # Truncated placeholder for lazy mode
+        else:
+            # Large content: async summarization (truncated placeholder now, real summary later)
             if len(doc.content) > max_len:
                 final_summary = doc.content[:max_len] + "..."
+                # Queue for background processing
+                self._pending_queue.enqueue(id, coll, doc.content)
             else:
                 final_summary = doc.content
-            # Queue for background processing
-            self._pending_queue.enqueue(id, coll, doc.content)
-        else:
-            # Auto-generate summary
-            final_summary = self._get_summarization_provider().summarize(doc.content)
 
         # Build tags: existing → config → env → user (later wins on collision)
         merged_tags = {**existing_tags}
@@ -686,8 +684,8 @@ class Keeper:
                     tags=old_doc.tags,
                 )
 
-        # Spawn background processor if lazy (only if summary wasn't user-provided and content changed)
-        if lazy and summary is None and not content_unchanged:
+        # Spawn background processor if content was queued (large content, no user summary, content changed)
+        if summary is None and len(doc.content) > max_len and not content_unchanged:
             self._spawn_processor()
 
         # Return the stored item
@@ -703,7 +701,6 @@ class Keeper:
         tags: Optional[dict[str, str]] = None,
         source_tags: Optional[dict[str, str]] = None,  # Deprecated alias
         collection: Optional[str] = None,
-        lazy: bool = False
     ) -> Item:
         """
         Store inline content directly (without fetching from a URI).
@@ -713,7 +710,8 @@ class Keeper:
         **Smart summary behavior:**
         - If summary is provided, use it (skips auto-summarization)
         - If content is short (≤ max_summary_length), use content verbatim
-        - Otherwise, generate summary via summarization provider
+        - For large content, summarization is async (truncated placeholder
+          stored immediately, real summary generated in background)
 
         **Update behavior (when id already exists):**
         - Summary: Replaced with user-provided, content, or generated summary
@@ -728,9 +726,6 @@ class Keeper:
             tags: User-provided tags to merge with existing tags
             source_tags: Deprecated alias for 'tags'
             collection: Target collection (uses default if None)
-            lazy: If True and content is long, use truncated placeholder summary
-                  and queue for background processing. Ignored if content is
-                  short or summary is provided.
 
         Returns:
             The stored Item with merged tags and new summary
@@ -794,14 +789,11 @@ class Keeper:
         elif len(content) <= max_len:
             # Content is short enough - use verbatim (smart summary)
             final_summary = content
-        elif lazy:
-            # Content is long and lazy mode - truncated placeholder
+        else:
+            # Content is long - async summarization (truncated placeholder now, real summary later)
             final_summary = content[:max_len] + "..."
             # Queue for background processing
             self._pending_queue.enqueue(id, coll, content)
-        else:
-            # Content is long - generate summary
-            final_summary = self._get_summarization_provider().summarize(content)
 
         # Build tags: existing → config → env → user (later wins on collision)
         merged_tags = {**existing_tags}
@@ -860,8 +852,8 @@ class Keeper:
                     tags=old_doc.tags,
                 )
 
-        # Spawn background processor if lazy and content was queued (only if content changed)
-        if lazy and summary is None and len(content) > max_len and not content_unchanged:
+        # Spawn background processor if content was queued (large content, no user summary, content changed)
+        if summary is None and len(content) > max_len and not content_unchanged:
             self._spawn_processor()
 
         # Return the stored item
@@ -1366,14 +1358,14 @@ class Keeper:
 
     def get_now(self) -> Item:
         """
-        Get the current working context.
+        Get the current working intentions.
 
         A singleton document representing what you're currently working on.
         If it doesn't exist, creates one with default content and tags from
         the bundled system now.md file.
 
         Returns:
-            The current context Item (never None - auto-creates if missing)
+            The current intentions Item (never None - auto-creates if missing)
         """
         item = self.get(NOWDOC_ID)
         if item is None:
@@ -1394,13 +1386,13 @@ class Keeper:
         tags: Optional[dict[str, str]] = None,
     ) -> Item:
         """
-        Set the current working context.
+        Set the current working intentions.
 
-        Updates the singleton context with new content. Uses remember()
+        Updates the singleton intentions with new content. Uses remember()
         internally with the fixed NOWDOC_ID.
 
         Args:
-            content: New content for the current context
+            content: New content for the current intentions
             tags: Optional additional tags to apply
 
         Returns:

keep/cli.py

@@ -251,7 +251,7 @@ def main_callback(
     )] = None,
 ):
     """Reflective memory with semantic search."""
-    # If no subcommand provided, show the current context (now)
+    # If no subcommand provided, show the current intentions (now)
     if ctx.invoked_subcommand is None:
         from .api import NOWDOC_ID
         kp = _get_keeper(None, "default")
@@ -683,10 +683,6 @@ def update(
         "--summary",
         help="User-provided summary (skips auto-summarization)"
     )] = None,
-    lazy: Annotated[bool, typer.Option(
-        "--lazy",
-        help="Fast mode: use truncated summary, queue for later processing"
-    )] = False,
 ):
     """
     Add or update a document in the store.
@@ -715,15 +711,15 @@ def update(
         parsed_tags = {**frontmatter_tags, **parsed_tags}  # CLI tags override
         # Use content-addressed ID for stdin text (enables versioning)
         doc_id = id or _text_content_id(content)
-        item = kp.remember(content, id=doc_id, summary=summary, tags=parsed_tags or None, lazy=lazy)
+        item = kp.remember(content, id=doc_id, summary=summary, tags=parsed_tags or None)
     elif source and _URI_SCHEME_PATTERN.match(source):
         # URI mode: fetch from URI (ID is the URI itself)
-        item = kp.update(source, tags=parsed_tags or None, summary=summary, lazy=lazy)
+        item = kp.update(source, tags=parsed_tags or None, summary=summary)
     elif source:
         # Text mode: inline content (no :// in source)
         # Use content-addressed ID for text (enables versioning)
         doc_id = id or _text_content_id(source)
-        item = kp.remember(source, id=doc_id, summary=summary, tags=parsed_tags or None, lazy=lazy)
+        item = kp.remember(source, id=doc_id, summary=summary, tags=parsed_tags or None)
     else:
         typer.echo("Error: Provide content, URI, or '-' for stdin", err=True)
         raise typer.Exit(1)
@@ -760,15 +756,15 @@ def now(
     )] = None,
 ):
     """
-    Get or set the current working context.
+    Get or set the current working intentions.
 
-    With no arguments, displays the current context.
+    With no arguments, displays the current intentions.
     With content, replaces it.
 
     \b
     Examples:
-        keep now                         # Show current context
-        keep now "What's important now"  # Update context
+        keep now                         # Show current intentions
+        keep now "What's important now"  # Update intentions
         keep now -f context.md           # Read content from file
         keep now --reset                 # Reset to default from system
         keep now -V 1                    # Previous version
@@ -891,7 +887,7 @@ def now(
         item = kp.set_now(new_content, tags=parsed_tags or None)
         typer.echo(_format_item(item, as_json=_get_json_output()))
     else:
-        # Get current context with version navigation and similar items
+        # Get current intentions with version navigation and similar items
         item = kp.get_now()
         version_nav = kp.get_version_nav(NOWDOC_ID, None, collection=collection)
         similar_items = kp.get_similar_for_display(NOWDOC_ID, limit=3, collection=collection)

{keep_skill-0.8.1.dist-info → keep_skill-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keep-skill
-Version: 0.8.1
+Version: 0.9.0
 Summary: Reflective memory - remember and search documents by meaning
 Project-URL: Homepage, https://github.com/hughpyle/keep
 Project-URL: Repository, https://github.com/hughpyle/keep
@@ -68,7 +68,7 @@ keep find "what's the rate limit?"
 
 # Track what you're working on
 keep now "Debugging auth flow"
-keep now -V 1                    # Previous context
+keep now -V 1                    # Previous intentions
 ```
 
 ---
@@ -131,9 +131,9 @@ keep get ID --history                  # All versions
 keep list --tag project=myapp          # Find by tag
 keep list --tags=                      # List all tag keys
 
-# Current context
+# Current intentions
 keep now                               # Show what you're working on
-keep now "Fixing login bug"            # Update context
+keep now "Fixing login bug"            # Update intentions
 ```
 
 ### Python API

{keep_skill-0.8.1.dist-info → keep_skill-0.9.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
 keep/__init__.py,sha256=yBK7jvbQmx9fRBGanICNgrQdyCQHzt5bNPp098Qvh9E,1621
 keep/__main__.py,sha256=3Uu70IhIDIjh8OW6jp9jQQ3dF2lKdJWi_3FtRIQMiMY,104
-keep/api.py,sha256=V_w4ahhgmgk10ehjs5JAvTct8wOvL8xsvW-nko_9Yjw,64858
+keep/api.py,sha256=3DHqgIsX7Fu6SwpxHwOnCA5ao0S9DlPschfK4WlN_Hs,64538
 keep/chunking.py,sha256=neAXOLSvVwbUxapbqq7nZrbSNSzMXuhxj-ODoOSodsU,11830
-keep/cli.py,sha256=SAB4LEZrX08sDVBxYD1s_zo2WXTYJBwhZswlQdjVkQ8,46024
+keep/cli.py,sha256=m3yokiLUbz1SWUD2IQEhI1WieY3IKVdpLV-f8Nd-BP8,45859
 keep/config.py,sha256=hWjiJDg2u6p8IJpksXe0ngVxQNcKHKRFKUDJQBFlG7I,16226
 keep/context.py,sha256=CNpjmrv6eW2kV1E0MO6qAQfhYKRlfzAL--6v4Mj1nFY,71
 keep/document_store.py,sha256=UswqKIGSc5E-r7Tg9k0g5-byYnuar3e9FieQ7WNod9k,29109
@@ -26,8 +26,8 @@ keep/providers/embeddings.py,sha256=zi8GyitKexdbCJyU1nLrUhGt_zzPn3udYrrPZ5Ak8Wo,
 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.8.1.dist-info/METADATA,sha256=ClBi2sP1kofuCjyjM1UsO8Yo_ouw-XxhLPIpMyDcVjE,6042
-keep_skill-0.8.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-keep_skill-0.8.1.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
-keep_skill-0.8.1.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
-keep_skill-0.8.1.dist-info/RECORD,,
+keep_skill-0.9.0.dist-info/METADATA,sha256=nzvsFdQRS659llg52q-GkZv9CPKF9jX9hx-cP5i-c6k,6051
+keep_skill-0.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+keep_skill-0.9.0.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
+keep_skill-0.9.0.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
+keep_skill-0.9.0.dist-info/RECORD,,