heropen 1.2.0__py3-none-any.whl

heropen/__init__.py

@@ -0,0 +1,39 @@
+"""
+heropen — Persistent memory for AI agents.
+
+Self-hosted, MCP-native memory system with vector + FTS + LIKE search,
+automatic backup, crash recovery, and multi-agent isolation.
+"""
+
+__version__ = "1.1.0"
+__all__ = [
+    "add_entry", "update_entry",
+    "search_vector", "search_fts", "search_graph",
+    "search_by_date", "search_by_tag", "search_recent",
+    "auto_backup", "integrity_check", "startup_self_heal",
+    "init_db", "conn", "db_path",
+    "get_embedding", "cosine_similarity",
+    "capture_session_content",
+    "AGENTS",
+]
+
+from heropen.core import (
+    add_entry,
+    update_entry,
+    search_vector,
+    search_fts,
+    search_graph,
+    search_by_date,
+    search_by_tag,
+    search_recent,
+    auto_backup,
+    integrity_check,
+    startup_self_heal,
+    init_db,
+    conn,
+    db_path,
+    get_embedding,
+    cosine_similarity,
+    capture_session_content,
+    AGENTS,
+)

heropen/cli.py

@@ -0,0 +1,143 @@
+"""
+heropen.cli — Command-line interface for HeroPen.
+
+Usage:
+    heropen --help
+    heropen install      # new in v1.2.0
+    heropen init ...
+    heropen recall ...
+    heropen add ...
+    heropen bootstrap ...
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from heropen.core import HERO_PEN_DIR
+
+
+def main():
+    args = sys.argv[1:]
+    if not args:
+        print_help()
+        return
+
+    cmd = args[0].lower()
+
+    # ── Install wizard (v1.2.0) ────────────────────────
+    if cmd in ("install", "setup"):
+        # Lazy import to avoid loading rich unless needed
+        from heropen.install import cmd_install
+        cmd_install(args[1:])
+        return
+
+    # ── Existing commands (all lazy-loaded) ─────────────
+    if cmd == "init":
+        from heropen.cli_commands import cmd_init
+        cmd_init(args[1:])
+    elif cmd == "recall":
+        from heropen.cli_commands import cmd_recall
+        cmd_recall(args[1:])
+    elif cmd == "add":
+        from heropen.cli_commands import cmd_add
+        cmd_add(args[1:])
+    elif cmd == "bootstrap":
+        from heropen.cli_commands import cmd_bootstrap
+        cmd_bootstrap(args[1:])
+    elif cmd == "health":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd == "search":
+        from heropen.cli_commands import cmd_recall
+        cmd_recall(args[1:])
+    elif cmd == "list":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd == "embed":
+        from heropen.cli_commands import cmd_embed
+        cmd_embed(args[1:])
+    elif cmd == "backup":
+        from heropen.cli_commands import cmd_export
+        cmd_export(args[1:])
+    elif cmd == "restore":
+        from heropen.cli_commands import cmd_import
+        cmd_import(args[1:])
+    elif cmd == "mcp":
+        from heropen.mcp_server import main as mcp_main
+        mcp_main()
+    elif cmd in ("--help", "-h", "help"):
+        print_help()
+    elif cmd in ("--version", "-V", "version"):
+        from heropen.core import __version__
+        print(f"heropen {__version__}")
+    elif cmd == "status":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd in ("entities",):
+        from heropen.cli_commands import cmd_entities
+        cmd_entities(args[1:])
+    elif cmd in ("capture",):
+        from heropen.cli_commands import cmd_capture
+        cmd_capture(args[1:])
+    elif cmd in ("sync",):
+        from heropen.cli_commands import cmd_sync
+        cmd_sync(args[1:])
+    elif cmd in ("init-all",):
+        from heropen.cli_commands import cmd_init_all
+        cmd_init_all(args[1:])
+    elif cmd in ("export",):
+        from heropen.cli_commands import cmd_export
+        cmd_export(args[1:])
+    elif cmd in ("import",):
+        from heropen.cli_commands import cmd_import
+        cmd_import(args[1:])
+    elif cmd in ("delete",):
+        from heropen.cli_commands import cmd_delete
+        cmd_delete(args[1:])
+    else:
+        print(f"heropen: unknown command '{cmd}'")
+        print_help()
+        sys.exit(1)
+
+
+def print_help():
+    help_text = f"""
+HeroPen v1.2.0 — AI Agent Long-term Memory System
+
+Usage:
+    heropen <command> [options]
+
+Commands:
+    install         Interactive install wizard (NEW in v1.2.0)
+    init            Initialize agent memory database
+    add             Add a new memory entry
+    recall          Search and recall memories
+    search          Search memories (alias for recall)
+    list            List memory stats (alias for status)
+    status          Database statistics
+    entities        View knowledge graph
+    bootstrap       Agent memory startup summary
+    capture         Auto-capture key sentences from stdin
+    sync            Sync from diary.md to database
+    embed           Generate embeddings for existing entries
+    backup          Export memories to JSON
+    restore         Import memories from JSON backup
+    delete          Delete a memory entry
+    health          Check system health (alias for status)
+    mcp             Start MCP server
+    help            Show this help message
+    version         Show version
+
+Options:
+    -h, --help     Show this help message
+    -V, --version  Show version
+
+Data directory: {HERO_PEN_DIR}
+"""
+    print(help_text.strip())
+
+
+if __name__ == "__main__":
+    main()