keep-skill 0.10.0__py3-none-any.whl → 0.11.0__py3-none-any.whl

keep/__init__.py

@@ -40,7 +40,7 @@ if not os.environ.get("KEEP_VERBOSE"):
 from .api import Keeper, NOWDOC_ID
 from .types import Item, filter_non_system_tags, SYSTEM_TAG_PREFIX, INTERNAL_TAGS
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"
 __all__ = [
     "Keeper",
     "Item",

keep/cli.py

@@ -25,6 +25,7 @@ VERSION_SUFFIX_PATTERN = re.compile(r'@V\{(\d+)\}$')
 _URI_SCHEME_PATTERN = re.compile(r'^[a-zA-Z][a-zA-Z0-9+.-]*://')
 
 from .api import Keeper, _text_content_id
+from .config import get_tool_directory
 from .document_store import VersionInfo
 from .types import Item
 from .logging_config import configure_quiet_mode, enable_debug_mode
@@ -809,6 +810,7 @@ def now(
     With no arguments, displays the current intentions.
     With content, replaces it.
 
+    \b
     Tags behave differently based on mode:
     - With content: -t sets tags on the update
     - Without content: -t filters version history
@@ -1271,12 +1273,146 @@ def init(
 
 
 
+def _get_config_value(kp: Keeper, path: str):
+    """
+    Get config value by dotted path.
+
+    Special paths (not in TOML):
+        file - config file location
+        tool - package directory (SKILL.md location)
+        store - store path
+        collections - list of collections
+
+    Dotted paths into config:
+        providers - all provider config
+        providers.embedding - embedding provider name
+        providers.summarization - summarization provider name
+        embedding.* - embedding config details
+        summarization.* - summarization config details
+        tags - default tags
+    """
+    cfg = kp._config
+
+    # Special built-in paths (not in TOML)
+    if path == "file":
+        return str(cfg.config_path) if cfg else None
+    if path == "tool":
+        return str(get_tool_directory())
+    if path == "store":
+        return str(kp._store_path)
+    if path == "collections":
+        return kp.list_collections()
+
+    # Provider shortcuts
+    if path == "providers":
+        if cfg:
+            return {
+                "embedding": cfg.embedding.name,
+                "summarization": cfg.summarization.name,
+                "document": cfg.document.name,
+            }
+        return None
+    if path == "providers.embedding":
+        return cfg.embedding.name if cfg else None
+    if path == "providers.summarization":
+        return cfg.summarization.name if cfg else None
+    if path == "providers.document":
+        return cfg.document.name if cfg else None
+
+    # Tags shortcut
+    if path == "tags":
+        return cfg.default_tags if cfg else {}
+
+    # Dotted path into config attributes
+    if not cfg:
+        raise typer.BadParameter(f"No config loaded, cannot access: {path}")
+
+    parts = path.split(".")
+    value = cfg
+    for part in parts:
+        if hasattr(value, part):
+            value = getattr(value, part)
+        elif hasattr(value, "params") and part in value.params:
+            # Provider config params
+            value = value.params[part]
+        elif isinstance(value, dict) and part in value:
+            value = value[part]
+        else:
+            raise typer.BadParameter(f"Unknown config path: {path}")
+
+    # Return name for provider objects
+    if hasattr(value, "name") and hasattr(value, "params"):
+        return value.name
+    return value
+
+
+# Settings that may not be configured but are available
+AVAILABLE_SETTINGS = {
+    "tags": {
+        "description": "Default tags applied to all operations",
+        "example": {"project": "myproject", "topic": "mytopic"},
+    },
+}
+
+
+def _format_config_with_defaults(kp: Keeper) -> str:
+    """Format config output with commented defaults for unused settings."""
+    cfg = kp._config
+    config_path = cfg.config_path if cfg else None
+    store_path = kp._store_path
+    lines = []
+
+    # Show paths
+    lines.append(f"file: {config_path}")
+    lines.append(f"tool: {get_tool_directory()}")
+    if cfg and cfg.config_dir and cfg.config_dir.resolve() != store_path.resolve():
+        lines.append(f"store: {store_path}")
+    else:
+        lines.append(f"store: {store_path}")
+
+    lines.append(f"collections: {kp.list_collections()}")
+
+    if cfg:
+        lines.append("")
+        lines.append("providers:")
+        lines.append(f"  embedding: {cfg.embedding.name}")
+        lines.append(f"  summarization: {cfg.summarization.name}")
+        lines.append(f"  document: {cfg.document.name}")
+
+        # Show configured tags if any
+        if cfg.default_tags:
+            lines.append("")
+            lines.append("tags:")
+            for key, value in cfg.default_tags.items():
+                lines.append(f"  {key}: {value}")
+        else:
+            # Show commented example for tags
+            lines.append("")
+            lines.append("# tags:")
+            lines.append("#   project: myproject")
+            lines.append("#   topic: mytopic")
+
+    return "\n".join(lines)
+
+
 @app.command()
 def config(
+    path: Annotated[Optional[str], typer.Argument(
+        help="Config path to get (e.g., 'file', 'tool', 'store', 'providers.embedding')"
+    )] = None,
     store: StoreOption = None,
 ):
     """
-    Show current configuration and store location.
+    Show configuration. Optionally get a specific value by path.
+
+    \b
+    Examples:
+        keep config              # Show all config
+        keep config file         # Config file location
+        keep config tool         # Package directory (SKILL.md location)
+        keep config store        # Store path
+        keep config providers    # All provider config
+        keep config providers.embedding  # Embedding provider name
     """
     kp = _get_keeper(store, "default")
 
@@ -1284,28 +1420,42 @@ def config(
     config_path = cfg.config_path if cfg else None
     store_path = kp._store_path
 
+    # If a specific path is requested, return just that value
+    if path:
+        try:
+            value = _get_config_value(kp, path)
+        except typer.BadParameter as e:
+            typer.echo(str(e), err=True)
+            raise typer.Exit(1)
+
+        if _get_json_output():
+            typer.echo(json.dumps({path: value}, indent=2))
+        else:
+            # Raw output for shell scripting
+            if isinstance(value, (list, dict)):
+                typer.echo(json.dumps(value))
+            else:
+                typer.echo(value)
+        return
+
+    # Full config output
     if _get_json_output():
         result = {
+            "file": str(config_path) if config_path else None,
+            "tool": str(get_tool_directory()),
             "store": str(store_path),
-            "config": str(config_path) if config_path else None,
             "collections": kp.list_collections(),
+            "providers": {
+                "embedding": cfg.embedding.name if cfg else None,
+                "summarization": cfg.summarization.name if cfg else None,
+                "document": cfg.document.name if cfg else None,
+            },
         }
-        if cfg:
-            result["embedding"] = cfg.embedding.name
-            result["summarization"] = cfg.summarization.name
+        if cfg and cfg.default_tags:
+            result["tags"] = cfg.default_tags
         typer.echo(json.dumps(result, indent=2))
     else:
-        # Show paths
-        typer.echo(f"Config: {config_path}")
-        if cfg and cfg.config_dir and cfg.config_dir.resolve() != store_path.resolve():
-            typer.echo(f"Store:  {store_path}")
-
-        typer.echo(f"Collections: {kp.list_collections()}")
-
-        if cfg:
-            typer.echo(f"\nProviders:")
-            typer.echo(f"  Embedding: {cfg.embedding.name}")
-            typer.echo(f"  Summarization: {cfg.summarization.name}")
+        typer.echo(_format_config_with_defaults(kp))
 
 
 @app.command("process-pending")

keep/config.py

@@ -5,6 +5,7 @@ The configuration is stored as a TOML file in the store directory.
 It specifies which providers to use and their parameters.
 """
 
+import importlib.resources
 import os
 import platform
 import tomllib
@@ -22,6 +23,33 @@ CONFIG_VERSION = 3  # Bumped for document versioning support
 SYSTEM_DOCS_VERSION = 3  # Increment when bundled system docs content changes
 
 
+def get_tool_directory() -> Path:
+    """
+    Return directory containing SKILL.md (package root).
+
+    For installed package: SKILL.md is at the same level as the keep/ package.
+    For development: it's at the repository root.
+    """
+    # Get the keep package location
+    keep_pkg = importlib.resources.files("keep")
+    pkg_path = Path(str(keep_pkg))
+
+    # SKILL.md is one level up from the package
+    tool_dir = pkg_path.parent
+
+    # Verify SKILL.md exists there
+    if (tool_dir / "SKILL.md").exists():
+        return tool_dir
+
+    # Fallback: check if we're in a development install
+    # where SKILL.md might be at repository root
+    if pkg_path.name == "keep" and (pkg_path.parent / "SKILL.md").exists():
+        return pkg_path.parent
+
+    # Last resort: return the package parent anyway
+    return tool_dir
+
+
 @dataclass
 class ProviderConfig:
     """Configuration for a single provider."""

keep/data/system/library.md

@@ -13,8 +13,8 @@ The content, as well as the format, is relevant to the practice of this skill.
 The library files are located in the `docs/library/` directory of the keep package.
 To construct URIs for these files:
 
-1. **In a cloned repo:** Use `file://$PWD/docs/library/{filename}`
-2. **With installed package:** Use Python to find the path:
+1. **From shell:** Use `file://$(keep config tool)/docs/library/{filename}`
+2. **In Python:**
    ```python
    from importlib.resources import files
    library_path = files("keep").parent / "docs" / "library"

{keep_skill-0.10.0.dist-info → keep_skill-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keep-skill
-Version: 0.10.0
+Version: 0.11.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

{keep_skill-0.10.0.dist-info → keep_skill-0.11.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-keep/__init__.py,sha256=-KvH6aY6B2n2kKGSizYqoQK38FWOa5lEfzYyRst33lU,1622
+keep/__init__.py,sha256=Z9SmBjE91Ip02X-w1qAYEFwsHlzGkvqGcm5BN7qhw0A,1622
 keep/__main__.py,sha256=3Uu70IhIDIjh8OW6jp9jQQ3dF2lKdJWi_3FtRIQMiMY,104
 keep/api.py,sha256=GGMY6w2a1b-Yve1aWz35dhZuSA9Va5Whe6M1Ek87yw4,65105
 keep/chunking.py,sha256=neAXOLSvVwbUxapbqq7nZrbSNSzMXuhxj-ODoOSodsU,11830
-keep/cli.py,sha256=Kwm5kwBiFH92BlKIHRaNN3UTSRexEclgcaPtk3SGpSs,49922
-keep/config.py,sha256=UTDjhUPiGVbBBmkGFgprE_3B8OC13HgtX18cix-NLCc,16226
+keep/cli.py,sha256=82gXDpunX5LpzfKdrRidpPirnurFDZ6pPVBWdXAhwPc,54836
+keep/config.py,sha256=YJ4IN85Y8HqrOxV2qTkGCMOuBcGNLDf0V2FK4KsZD-4,17079
 keep/context.py,sha256=CNpjmrv6eW2kV1E0MO6qAQfhYKRlfzAL--6v4Mj1nFY,71
 keep/document_store.py,sha256=UswqKIGSc5E-r7Tg9k0g5-byYnuar3e9FieQ7WNod9k,29109
 keep/errors.py,sha256=G9e5FbdfeugyfHOuL_SPZlM5jgWWnwsX4hM7IzanBZc,857
@@ -17,7 +17,7 @@ keep/data/__init__.py,sha256=C1YARrudHwK2Bmlxkh7dZlIaNJ5m5WrSTglCdG8e3T0,24
 keep/data/system/__init__.py,sha256=Rp92_sBO3kscuWXJomo0HKeHfU-N4BgBeT3-5El0Mcg,28
 keep/data/system/conversations.md,sha256=jE53wYSUyu5uPFNtO1Tu6w4f5QxqLei7muxLF_kZE2s,9837
 keep/data/system/domains.md,sha256=EHE6zU2-lx7UeLqyOTmoWl1WVlvgRq3_QnFb_EZceEY,5584
-keep/data/system/library.md,sha256=rmA4LBtgGOI5vEB9ohjhrLptWNIRvjQCfxuHxY3D4LU,7471
+keep/data/system/library.md,sha256=KFDRN7YCPwxttghcb-ts6je9fd2Mlysk_5H6vrwmgX0,7438
 keep/data/system/now.md,sha256=GyQo_LizSIVKbj5q52q4ErV-nxz8rzUOlkILjgNu25s,388
 keep/providers/__init__.py,sha256=6AwJYc6cF1ZT6BcU_6ATyeWk7MHohdVU2-ccqDSvCHU,1094
 keep/providers/base.py,sha256=qUpVbgLHH4zdvimcM0YMyJnExF7WJ7_U0w_sslpPhSI,15897
@@ -27,8 +27,8 @@ keep/providers/embeddings.py,sha256=zi8GyitKexdbCJyU1nLrUhGt_zzPn3udYrrPZ5Ak8Wo,
 keep/providers/llm.py,sha256=Pcq1fK7NXBzdVrQegjmAFmuHdZXpQraApr8M6O6hJFE,11680
 keep/providers/mlx.py,sha256=xQTXM9kYWUhfqpRVPNCDyF2nkOo50ZYs5DxHELbFB4g,8707
 keep/providers/summarization.py,sha256=MlVTcYipaqp2lT-QYnznp0AMuPVG36QfcTQnvY7Gb-Q,3409
-keep_skill-0.10.0.dist-info/METADATA,sha256=jMADwUfBCyw8r7OIcOJUdpxEEheYRlXqBIAf7VVO6eM,6238
-keep_skill-0.10.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-keep_skill-0.10.0.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
-keep_skill-0.10.0.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
-keep_skill-0.10.0.dist-info/RECORD,,
+keep_skill-0.11.0.dist-info/METADATA,sha256=AWE9565tLR2SJH-sPkdALnoGZVAj9o5OzZMY18Ux-TA,6238
+keep_skill-0.11.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+keep_skill-0.11.0.dist-info/entry_points.txt,sha256=W8yiI4kNeW0IC8ji4EHRWrvdhFxzaqTIePUhJAJAMOo,39
+keep_skill-0.11.0.dist-info/licenses/LICENSE,sha256=zsm0tpvtyUkevcjn5BIvs9jAho8iwxq3Ax9647AaOSg,1086
+keep_skill-0.11.0.dist-info/RECORD,,