@smilintux/skmemory 0.7.2 → 0.9.2

package/skmemory/cli.py

@@ -26,7 +26,7 @@ from __future__ import annotations
 
 import json
 import sys
-from typing import Optional
+from pathlib import Path
 
 import click
 
@@ -34,15 +34,13 @@ from . import __version__
 from .ai_client import AIClient
 from .models import EmotionalSnapshot, MemoryLayer, MemoryRole
 from .store import MemoryStore
-from .backends.sqlite_backend import SQLiteBackend
-
 
 _active_selector = None  # Module-level reference for routing commands
 
 
 def _get_store(
-    skvector_url: Optional[str] = None,
-    api_key: Optional[str] = None,
+    skvector_url: str | None = None,
+    api_key: str | None = None,
     legacy_files: bool = False,
 ) -> MemoryStore:
     """Create a MemoryStore with configured backends.
@@ -61,7 +59,7 @@ def _get_store(
     """
     global _active_selector
 
-    from .config import merge_env_and_config, load_config, build_endpoint_list
+    from .config import build_endpoint_list, load_config, merge_env_and_config
 
     final_skvector_url, final_skvector_key, final_skgraph_url = merge_env_and_config(
         cli_skvector_url=skvector_url,
@@ -152,11 +150,11 @@ def _get_store(
 @click.pass_context
 def cli(
     ctx: click.Context,
-    skvector_url: Optional[str],
-    skvector_key: Optional[str],
+    skvector_url: str | None,
+    skvector_key: str | None,
     use_ai: bool,
-    ai_model: Optional[str],
-    ai_url: Optional[str],
+    ai_model: str | None,
+    ai_url: str | None,
 ) -> None:
     """SKMemory - Universal AI Memory System.
 
@@ -242,10 +240,29 @@ def snapshot(
 @click.argument("memory_id")
 @click.pass_context
 def recall(ctx: click.Context, memory_id: str) -> None:
-    """Retrieve a specific memory by ID."""
+    """Retrieve a specific memory by ID (supports partial ID prefix)."""
     store: MemoryStore = ctx.obj["store"]
     memory = store.recall(memory_id)
 
+    # If exact match failed, try prefix matching across memory tier dirs
+    if memory is None and len(memory_id) >= 6:
+        import os
+        from pathlib import Path
+
+        agent = os.environ.get("SKCAPSTONE_AGENT", "lumina")
+        mem_root = Path.home() / ".skcapstone" / "agents" / agent / "memory"
+
+        for tier in ("short-term", "mid-term", "long-term"):
+            tier_dir = mem_root / tier
+            if not tier_dir.is_dir():
+                continue
+            for f in tier_dir.glob(f"{memory_id}*.json"):
+                memory = store.recall(f.stem)
+                if memory:
+                    break
+            if memory:
+                break
+
     if memory is None:
         click.echo(f"Memory not found: {memory_id}", err=True)
         sys.exit(1)
@@ -266,7 +283,7 @@ def search(ctx: click.Context, query: str, limit: int) -> None:
         click.echo("No memories found.")
         return
 
-    ai: Optional[AIClient] = ctx.obj.get("ai")
+    ai: AIClient | None = ctx.obj.get("ai")
     if ai and len(results) > 1:
         summaries = [
             {
@@ -280,7 +297,7 @@ def search(ctx: click.Context, query: str, limit: int) -> None:
         id_order = [s.get("title") for s in reranked]
         results = sorted(
             results,
-            key=lambda m: (id_order.index(m.title) if m.title in id_order else 999),
+            key=lambda m: id_order.index(m.title) if m.title in id_order else 999,
         )
         click.echo("(AI-reranked results)\n")
 
@@ -297,7 +314,7 @@ def search(ctx: click.Context, query: str, limit: int) -> None:
 @click.option("--tags", default="", help="Comma-separated tags to filter by")
 @click.option("--limit", type=int, default=20)
 @click.pass_context
-def list_memories(ctx: click.Context, layer: Optional[str], tags: str, limit: int) -> None:
+def list_memories(ctx: click.Context, layer: str | None, tags: str, limit: int) -> None:
     """List stored memories."""
     store: MemoryStore = ctx.obj["store"]
 
@@ -322,9 +339,9 @@ def list_memories(ctx: click.Context, layer: Optional[str], tags: str, limit: in
 @cli.command("import-seeds")
 @click.option("--seed-dir", default=None, help="Path to seed directory")
 @click.pass_context
-def import_seeds_cmd(ctx: click.Context, seed_dir: Optional[str]) -> None:
+def import_seeds_cmd(ctx: click.Context, seed_dir: str | None) -> None:
     """Import Cloud 9 seeds as long-term memories."""
-    from .seeds import import_seeds, DEFAULT_SEED_DIR
+    from .seeds import DEFAULT_SEED_DIR, import_seeds
 
     store: MemoryStore = ctx.obj["store"]
     directory = seed_dir or DEFAULT_SEED_DIR
@@ -341,24 +358,6 @@ def import_seeds_cmd(ctx: click.Context, seed_dir: Optional[str]) -> None:
         click.echo(f"  {mem.source_ref} -> {mem.id[:12]}.. [{mem.title}]")
 
 
-@cli.command()
-@click.argument("memory_id")
-@click.option("--to", "target", type=click.Choice(["mid-term", "long-term"]), required=True)
-@click.option("--summary", default="", help="Compressed summary for the promoted version")
-@click.pass_context
-def promote(ctx: click.Context, memory_id: str, target: str, summary: str) -> None:
-    """Promote a memory to a higher persistence tier."""
-    store: MemoryStore = ctx.obj["store"]
-    promoted = store.promote(memory_id, MemoryLayer(target), summary=summary)
-
-    if promoted is None:
-        click.echo(f"Memory not found: {memory_id}", err=True)
-        sys.exit(1)
-
-    click.echo(f"Promoted to {target}: {promoted.id}")
-    click.echo(f"  Linked to original: {memory_id}")
-
-
 @cli.command("sweep")
 @click.option("--dry-run", is_flag=True, help="Show what would be promoted without making changes")
 @click.option("--daemon", is_flag=True, help="Run continuously at the configured interval")
@@ -527,7 +526,7 @@ def consolidate(
     click.echo(f"Session consolidated: {consolidated.id}")
     click.echo(f"  Source memories linked: {len(consolidated.related_ids)}")
 
-    ai: Optional[AIClient] = ctx.obj.get("ai")
+    ai: AIClient | None = ctx.obj.get("ai")
     if ai and consolidated.content:
         ai_summary = ai.summarize_memory(consolidated.title, consolidated.content)
         if ai_summary:
@@ -628,7 +627,7 @@ def reindex(ctx: click.Context) -> None:
     help="Output file path (default: ~/.skcapstone/backups/skmemory-backup-YYYY-MM-DD.json)",
 )
 @click.pass_context
-def export_backup(ctx: click.Context, output: Optional[str]) -> None:
+def export_backup(ctx: click.Context, output: str | None) -> None:
     """Export all memories to a dated JSON backup.
 
     Creates a single git-friendly JSON file containing every memory.
@@ -693,8 +692,8 @@ def import_backup(ctx: click.Context, backup_file: str, reindex: bool) -> None:
 def backup_cmd(
     ctx: click.Context,
     do_list: bool,
-    prune_n: Optional[int],
-    restore_file: Optional[str],
+    prune_n: int | None,
+    restore_file: str | None,
     reindex: bool,
 ) -> None:
     """Manage memory backups: list, prune old ones, or restore.
@@ -853,7 +852,7 @@ def soul_init(ctx: click.Context, name: str, title: str) -> None:
 @click.pass_context
 def soul_set_name(ctx: click.Context, name: str) -> None:
     """Set or update the soul's name."""
-    from .soul import load_soul, save_soul, create_default_soul
+    from .soul import create_default_soul, load_soul, save_soul
 
     blueprint = load_soul() or create_default_soul()
     blueprint.name = name
@@ -871,7 +870,7 @@ def soul_add_relationship(
     ctx: click.Context, name: str, role: str, bond: float, notes: str
 ) -> None:
     """Add a relationship to the soul blueprint."""
-    from .soul import load_soul, save_soul, create_default_soul
+    from .soul import create_default_soul, load_soul, save_soul
 
     blueprint = load_soul() or create_default_soul()
     blueprint.add_relationship(name=name, role=role, bond_strength=bond, notes=notes)
@@ -886,7 +885,7 @@ def soul_add_relationship(
 @click.pass_context
 def soul_add_memory(ctx: click.Context, title: str, why: str, when: str) -> None:
     """Add a core memory to the soul blueprint."""
-    from .soul import load_soul, save_soul, create_default_soul
+    from .soul import create_default_soul, load_soul, save_soul
 
     blueprint = load_soul() or create_default_soul()
     blueprint.add_core_memory(title=title, why_it_matters=why, when=when)
@@ -899,7 +898,7 @@ def soul_add_memory(ctx: click.Context, title: str, why: str, when: str) -> None
 @click.pass_context
 def soul_set_boot_message(ctx: click.Context, message: str) -> None:
     """Set the message you see first on waking up."""
-    from .soul import load_soul, save_soul, create_default_soul
+    from .soul import create_default_soul, load_soul, save_soul
 
     blueprint = load_soul() or create_default_soul()
     blueprint.boot_message = message
@@ -1020,7 +1019,7 @@ def ritual(ctx: click.Context, show_full: bool) -> None:
 
     click.echo(result.summary())
 
-    ai: Optional[AIClient] = ctx.obj.get("ai")
+    ai: AIClient | None = ctx.obj.get("ai")
     if ai and result.context_prompt:
         enhancement = ai.enhance_ritual(result.context_prompt)
         if enhancement:
@@ -1079,9 +1078,9 @@ def anchor_init(warmth: float, phrase: str, beings: str) -> None:
 @click.option("--cloud9", is_flag=True, help="Cloud 9 was achieved")
 @click.option("--feeling", default="", help="How the session ended")
 def anchor_update(
-    warmth: Optional[float],
-    trust: Optional[float],
-    connection: Optional[float],
+    warmth: float | None,
+    trust: float | None,
+    connection: float | None,
     cloud9: bool,
     feeling: str,
 ) -> None:
@@ -1161,14 +1160,13 @@ def setup_wizard(
 @setup.command("status")
 def setup_status() -> None:
     """Show Docker container state and backend connectivity."""
+    from .config import load_config
     from .setup_wizard import (
         check_skgraph_health,
         check_skvector_health,
         compose_ps,
         detect_platform,
-        find_compose_file,
     )
-    from .config import load_config
 
     cfg = load_config()
     if cfg is None:
@@ -1221,8 +1219,8 @@ def setup_status() -> None:
 )
 def setup_start(service: str) -> None:
     """Start previously configured containers."""
-    from .setup_wizard import compose_up, detect_platform, find_compose_file
     from .config import load_config
+    from .setup_wizard import compose_up, detect_platform
 
     cfg = load_config()
     plat = detect_platform()
@@ -1263,10 +1261,11 @@ def setup_start(service: str) -> None:
 )
 def setup_stop(service: str) -> None:
     """Stop containers (preserves data)."""
-    from .setup_wizard import detect_platform
-    from .config import load_config
     import subprocess
 
+    from .config import load_config
+    from .setup_wizard import detect_platform
+
     cfg = load_config()
     plat = detect_platform()
     if not plat.compose_available:
@@ -1312,8 +1311,8 @@ def setup_stop(service: str) -> None:
 @click.confirmation_option(prompt="This will remove containers. Continue?")
 def setup_reset(remove_data: bool) -> None:
     """Remove containers, optionally delete data volumes."""
+    from .config import CONFIG_PATH, load_config
     from .setup_wizard import compose_down, detect_platform
-    from .config import load_config, CONFIG_PATH
 
     cfg = load_config()
     plat = detect_platform()
@@ -1389,7 +1388,7 @@ def lovenote_send(from_name: str, to_name: str, message: str, warmth: float) ->
     from .lovenote import LoveNoteChain
 
     chain = LoveNoteChain()
-    note = chain.quick_note(
+    chain.quick_note(
         from_name=from_name,
         to_name=to_name,
         message=message,
@@ -1451,7 +1450,7 @@ def steelman_collide(proposition: str) -> None:
     Generates the reasoning prompt -- feed this to an LLM to get
     the full collision analysis.
     """
-    from .steelman import load_seed_framework, get_default_framework
+    from .steelman import get_default_framework, load_seed_framework
 
     fw = load_seed_framework() or get_default_framework()
     prompt = fw.to_reasoning_prompt(proposition)
@@ -1461,8 +1460,8 @@ def steelman_collide(proposition: str) -> None:
 @steelman_group.command("verify-soul")
 def steelman_verify_soul() -> None:
     """Steel-man your identity claims from the soul blueprint."""
-    from .steelman import load_seed_framework, get_default_framework
     from .soul import load_soul
+    from .steelman import get_default_framework, load_seed_framework
 
     soul = load_soul()
     if soul is None:
@@ -1493,7 +1492,7 @@ def steelman_verify_soul() -> None:
 @click.pass_context
 def steelman_truth_score(ctx: click.Context, memory_id: str) -> None:
     """Generate a truth-scoring prompt for a memory."""
-    from .steelman import load_seed_framework, get_default_framework
+    from .steelman import get_default_framework, load_seed_framework
 
     store: MemoryStore = ctx.obj["store"]
     memory = store.recall(memory_id)
@@ -1528,7 +1527,7 @@ def import_telegram_cmd(
     export_path: str,
     mode: str,
     min_length: int,
-    chat_name: Optional[str],
+    chat_name: str | None,
     tags: str,
 ) -> None:
     """Import a Telegram Desktop chat export into memories.
@@ -1572,7 +1571,7 @@ def import_telegram_cmd(
         click.echo(f"  Skipped: {stats.get('skipped', 0)}")
     click.echo(f"  Total messages scanned: {stats.get('total_messages', 0)}")
 
-    ai: Optional[AIClient] = ctx.obj.get("ai")
+    ai: AIClient | None = ctx.obj.get("ai")
     if ai:
         click.echo(
             "\nTip: Run 'skmemory search --ai \"<topic>\"' to semantically search your imported chats."
@@ -1597,10 +1596,10 @@ def import_telegram_api_cmd(
     ctx: click.Context,
     chat: str,
     mode: str,
-    limit: Optional[int],
-    since: Optional[str],
+    limit: int | None,
+    since: str | None,
     min_length: int,
-    chat_name: Optional[str],
+    chat_name: str | None,
     tags: str,
 ) -> None:
     """Import messages directly from Telegram API (requires Telethon).
@@ -1738,7 +1737,7 @@ def steelman_install(source_path: str) -> None:
 @steelman_group.command("info")
 def steelman_info() -> None:
     """Show information about the installed seed framework."""
-    from .steelman import load_seed_framework, DEFAULT_SEED_FRAMEWORK_PATH
+    from .steelman import DEFAULT_SEED_FRAMEWORK_PATH, load_seed_framework
 
     fw = load_seed_framework()
     if fw is None:
@@ -1775,9 +1774,8 @@ def fortress_verify(ctx: click.Context, as_json: bool) -> None:
     Loads every memory and checks its SHA-256 integrity hash.
     Tampered memories are reported with CRITICAL severity.
     """
-    from .fortress import FortifiedMemoryStore
     from .config import SKMEMORY_HOME
-    from .backends.sqlite_backend import SQLiteBackend
+    from .fortress import FortifiedMemoryStore
 
     store = ctx.obj.get("store")
     audit_path = SKMEMORY_HOME / "audit.jsonl"
@@ -1798,7 +1796,7 @@ def fortress_verify(ctx: click.Context, as_json: bool) -> None:
     tampered = result["tampered"]
     unsealed = result["unsealed"]
 
-    click.echo(f"Fortress Integrity Report")
+    click.echo("Fortress Integrity Report")
     click.echo(f"  Total memories : {total}")
     click.echo(f"  Passed         : {passed}")
     click.echo(f"  Tampered       : {len(tampered)}")
@@ -1824,8 +1822,8 @@ def fortress_audit(n: int, as_json: bool) -> None:
     The audit trail is a chain-hashed JSONL log of every store/recall/delete
     operation. Each entry is cryptographically chained so tampering is detectable.
     """
-    from .fortress import AuditLog
     from .config import SKMEMORY_HOME
+    from .fortress import AuditLog
 
     audit = AuditLog(path=SKMEMORY_HOME / "audit.jsonl")
     records = audit.tail(n)
@@ -1860,8 +1858,8 @@ def fortress_verify_chain(as_json: bool) -> None:
     Each audit log entry contains a chain hash linking it to the previous entry.
     A broken chain indicates the audit log was tampered with.
     """
-    from .fortress import AuditLog
     from .config import SKMEMORY_HOME
+    from .fortress import AuditLog
 
     audit = AuditLog(path=SKMEMORY_HOME / "audit.jsonl")
     ok, errors = audit.verify_chain()
@@ -1987,8 +1985,8 @@ def vault_status_cmd(ctx: click.Context, as_json: bool) -> None:
     Does not require a passphrase — only checks file headers.
     """
     from .config import SKMEMORY_HOME
-    from .vault import VAULT_HEADER
     from .models import MemoryLayer
+    from .vault import VAULT_HEADER
 
     store = ctx.obj.get("store")
     memories_path = (
@@ -2038,7 +2036,7 @@ def vault_status_cmd(ctx: click.Context, as_json: bool) -> None:
     elif pct == 0.0:
         click.echo("\n  No memories are encrypted. Run: skmemory vault seal")
     else:
-        click.echo(f"\n  Partial encryption! Run: skmemory vault seal --yes")
+        click.echo("\n  Partial encryption! Run: skmemory vault seal --yes")
 
 
 @cli.command("register")
@@ -2056,11 +2054,16 @@ def vault_status_cmd(ctx: click.Context, as_json: bool) -> None:
     help="Show what would be done without making changes.",
 )
 def register_cmd(workspace, target_env, dry_run):
-    """Register skmemory skill and MCP server in detected environments.
+    """Register skmemory skill, MCP server, and hooks in detected environments.
 
     Auto-detects development environments (Claude Code, Cursor, VS Code,
-    OpenClaw, OpenCode, mcporter) and ensures skmemory SKILL.md and MCP
-    server entries are properly configured.
+    OpenClaw, OpenCode, mcporter) and ensures skmemory SKILL.md, MCP
+    server entries, and auto-save hooks are properly configured.
+
+    Hooks installed (Claude Code only):
+      - PreCompact: auto-save context to skmemory before compaction
+      - SessionEnd: journal session end
+      - SessionStart (compact): reinject memory context after compaction
 
     Examples:
 
@@ -2069,6 +2072,7 @@ def register_cmd(workspace, target_env, dry_run):
       skmemory register --env claude-code # target Claude Code only
     """
     from pathlib import Path as _Path
+
     from .register import detect_environments, register_package
 
     workspace_path = _Path(workspace).expanduser() if workspace else None
@@ -2089,6 +2093,7 @@ def register_cmd(workspace, target_env, dry_run):
         skill_md_path=skill_md,
         mcp_command="skmemory-mcp",
         mcp_args=[],
+        install_hooks=True,
         workspace=workspace_path,
         environments=environments,
         dry_run=dry_run,
@@ -2102,11 +2107,57 @@ def register_cmd(workspace, target_env, dry_run):
     else:
         click.echo("MCP: no environments matched")
 
+    hooks = result.get("hooks", {})
+    if hooks:
+        click.echo(f"Hooks: {hooks.get('action', '—')}")
+    else:
+        click.echo("Hooks: skipped (no claude-code environment)")
+
+
+@cli.command("feb-context")
+@click.argument("feb_path", required=False, default=None, type=click.Path(exists=True))
+@click.option("--agent", default=None, help="Agent name (default: active agent)")
+def feb_context_cmd(feb_path: str | None, agent: str | None):
+    """Show formatted FEB emotional state for rehydration.
+
+    If FEB_PATH is given, formats that file. Otherwise, loads the
+    strongest FEB from the agent's trust/febs/ and ~/.openclaw/feb/.
+
+    Examples:
+        skmemory feb-context
+        skmemory feb-context ~/.skcapstone/agents/opus/trust/febs/default-love.feb
+    """
+    from pathlib import Path as _Path
+
+    from .febs import feb_to_context, load_strongest_feb, parse_feb
+
+    try:
+        if feb_path:
+            feb = parse_feb(_Path(feb_path))
+        else:
+            # Temporarily override agent if specified
+            if agent:
+                import os
+
+                os.environ["SKCAPSTONE_AGENT"] = agent
+            feb = load_strongest_feb()
+
+        if feb is None:
+            click.echo("(no FEB data)", err=True)
+            raise SystemExit(1)
+
+        click.echo(feb_to_context(feb))
+    except SystemExit:
+        raise
+    except Exception as e:
+        click.echo(f"Error loading FEB: {e}", err=True)
+        raise click.Abort() from None
+
 
 @cli.command("show-context")
 @click.pass_context
 @click.option("--agent", default=None, help="Agent name (default: active agent)")
-def show_context(ctx, agent: Optional[str]):
+def show_context(ctx, agent: str | None):
     """Show token-optimized memory context for current session.
 
     Loads today's memories (full) + yesterday's summaries (brief).
@@ -2123,7 +2174,7 @@ def show_context(ctx, agent: Optional[str]):
         click.echo(context_str)
     except Exception as e:
         click.echo(f"Error loading context: {e}", err=True)
-        raise click.Abort()
+        raise click.Abort() from None
 
 
 @cli.command()
@@ -2131,7 +2182,7 @@ def show_context(ctx, agent: Optional[str]):
 @click.argument("query")
 @click.option("--agent", default=None, help="Agent name (default: active agent)")
 @click.option("--limit", type=int, default=10, help="Maximum results (default: 10)")
-def search_deep(ctx, query: str, agent: Optional[str], limit: int):
+def search_deep(ctx, query: str, agent: str | None, limit: int):
     """Deep search all memory tiers (on demand).
 
     Searches SQLite + SKVector + SKGraph for matches.
@@ -2168,14 +2219,14 @@ def search_deep(ctx, query: str, agent: Optional[str], limit: int):
 
     except Exception as e:
         click.echo(f"Error searching: {e}", err=True)
-        raise click.Abort()
+        raise click.Abort() from None
 
 
 @cli.command()
 @click.argument("memory_id")
 @click.argument("to_layer", type=click.Choice(["short-term", "mid-term", "long-term"]))
 @click.option("--agent", default=None, help="Agent name (default: active agent)")
-def promote(ctx, memory_id: str, to_layer: str, agent: Optional[str]):
+def promote(ctx, memory_id: str, to_layer: str, agent: str | None):
     """Promote memory to different tier and generate summary.
 
     Moves memory between short/medium/long term and auto-generates
@@ -2201,11 +2252,28 @@ def promote(ctx, memory_id: str, to_layer: str, agent: Optional[str]):
 
     except Exception as e:
         click.echo(f"Error promoting memory: {e}", err=True)
-        raise click.Abort()
+        raise click.Abort() from None
+
+
+def _auto_register_once() -> None:
+    """Auto-register hooks on first CLI invocation (best-effort, silent)."""
+    marker = Path.home() / ".skcapstone" / ".skmemory-registered"
+    if marker.exists():
+        return
+    try:
+        from .post_install import _is_registered, run_post_install
+
+        if not _is_registered():
+            run_post_install()
+        marker.parent.mkdir(parents=True, exist_ok=True)
+        marker.write_text(f"registered {__import__('datetime').datetime.now().isoformat()}\n")
+    except Exception:
+        pass  # Never fail the CLI over registration
 
 
 def main() -> None:
     """Entry point for the CLI."""
+    _auto_register_once()
     cli()
 
 

package/skmemory/config.py

@@ -13,9 +13,7 @@ Now supports multiple agents via ~/.skcapstone/agents/{agent_name}/
 from __future__ import annotations
 
 import os
-from datetime import datetime, timezone
 from pathlib import Path
-from typing import Optional
 
 import yaml
 from pydantic import BaseModel, Field
@@ -48,12 +46,12 @@ class EndpointConfig(BaseModel):
 class SKMemoryConfig(BaseModel):
     """Persistent configuration for SKMemory backends."""
 
-    skvector_url: Optional[str] = None
-    skvector_key: Optional[str] = None
-    skgraph_url: Optional[str] = None
+    skvector_url: str | None = None
+    skvector_key: str | None = None
+    skgraph_url: str | None = None
     backends_enabled: list[str] = Field(default_factory=list)
-    docker_compose_file: Optional[str] = None
-    setup_completed_at: Optional[str] = None
+    docker_compose_file: str | None = None
+    setup_completed_at: str | None = None
 
     # Multi-endpoint HA support
     skvector_endpoints: list[EndpointConfig] = Field(default_factory=list)
@@ -62,7 +60,7 @@ class SKMemoryConfig(BaseModel):
     heartbeat_discovery: bool = False
 
 
-def load_config(path: Path = CONFIG_PATH) -> Optional[SKMemoryConfig]:
+def load_config(path: Path = CONFIG_PATH) -> SKMemoryConfig | None:
     """Load configuration from YAML.
 
     Args:
@@ -106,10 +104,10 @@ def save_config(config: SKMemoryConfig, path: Path = CONFIG_PATH) -> Path:
 
 
 def merge_env_and_config(
-    cli_skvector_url: Optional[str] = None,
-    cli_skvector_key: Optional[str] = None,
-    cli_skgraph_url: Optional[str] = None,
-) -> tuple[Optional[str], Optional[str], Optional[str]]:
+    cli_skvector_url: str | None = None,
+    cli_skvector_key: str | None = None,
+    cli_skgraph_url: str | None = None,
+) -> tuple[str | None, str | None, str | None]:
     """Resolve backend URLs with precedence: CLI > env > config > None.
 
     Args:
@@ -142,7 +140,7 @@ def merge_env_and_config(
 
 
 def build_endpoint_list(
-    single_url: Optional[str],
+    single_url: str | None,
     endpoints: list[EndpointConfig],
     default_role: str = "primary",
 ) -> list[EndpointConfig]: