droste-memory 1.0.0__py3-none-any.whl

core/__init__.py

@@ -0,0 +1,6 @@
+"""Core package for Droste-Memory."""
+
+from .droste_engine import DrosteConceptEngine, DrosteNode
+from .droste_ingester import DrosteProjectIngester
+
+__all__ = ["DrosteConceptEngine", "DrosteNode", "DrosteProjectIngester"]

core/droste_cli.py

@@ -0,0 +1,409 @@
+"""Command line interface for Droste-Memory."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+from urllib import error, request
+
+
+ROOT = Path(__file__).resolve().parents[1]
+if str(ROOT) not in sys.path:
+    sys.path.insert(0, str(ROOT))
+LOCAL_PACKAGES = ROOT / ".python-packages"
+if LOCAL_PACKAGES.exists():
+    sys.path.insert(0, str(LOCAL_PACKAGES))
+
+from core.droste_engine import DEFAULT_DB_PATH, DrosteConceptEngine
+from core.droste_ingester import DrosteProjectIngester, droste_zoom_query
+
+
+VERSION = "v1.0-Alpha-Sharded"
+VISUALIZER_CAMERA_URL = "http://127.0.0.1:5000/api/camera"
+
+RESET = "\033[0m"
+GREEN = "\033[92m"
+CYAN = "\033[96m"
+WHITE = "\033[97m"
+DIM = "\033[2m"
+
+
+RADIAL_ART = r"""
+                  .-----------------------.
+             .----'           |           '----.
+         .---'          .-----+-----.          '---.
+       .'          .----'     |     '----.          '.
+      /        .---'      .---+---.      '---.        \
+     /      .-'        .-'    |    '-.        '-.      \
+    |     .'        .-'   .---+---.   '-.        '.     |
+    |    /        .'    .'    |    '.    '.        \    |
+    |   |        |     |   .--+--.   |     |        |   |
+    | --+--------+-----+---+  @  +---+-----+--------+-- |
+    |   |        |     |   '--+--'   |     |        |   |
+    |    \        '.    '.    |    .'    .'        /    |
+    |     '.        '-.   '---+---'   .-'        .'     |
+     \      '-.        '-.    |    .-'        .-'      /
+      \        '---.      '---+---'      .---'        /
+       '.          '----.     |     .----'          .'
+         '---.          '-----+-----'          .---'
+             '----.           |           .----'
+                  '-----------------------'
+"""
+
+
+def _wants_color(enabled: bool | None = None) -> bool:
+    if enabled is not None:
+        return enabled
+    if os.environ.get("NO_COLOR"):
+        return False
+    return sys.stdout.isatty()
+
+
+def _paint(text: str, color: str, enabled: bool) -> str:
+    return f"{color}{text}{RESET}" if enabled else text
+
+
+def print_splash(color: bool | None = None) -> None:
+    enabled = _wants_color(color)
+    art_lines = RADIAL_ART.strip("\n").splitlines()
+    for index, line in enumerate(art_lines):
+        print(_paint(line, CYAN if index % 2 == 0 else GREEN, enabled))
+    print()
+    print(_paint("DROSTE-MEMORY // RIGID FRACTAL RADIAL LAYOUT", WHITE, enabled))
+    print(_paint(f"Local Graph Engine {VERSION}", WHITE, enabled))
+    print()
+    print(_paint("Commands", CYAN, enabled))
+    print("  droste index <path> [--reset]")
+    print("  droste status")
+    print("  droste zoom <symbol_name>")
+    print("  droste context [query] --budget 1500")
+    print()
+    print(_paint("Fast path: droste context hub_core --budget 1000 | clip", DIM, enabled))
+
+
+def print_compact_header(color: bool | None = None) -> None:
+    enabled = _wants_color(color)
+    print(_paint(f"DROSTE-MEMORY {VERSION}", WHITE, enabled))
+    print(_paint("Rigid Fractal Radial Layout", CYAN, enabled))
+
+
+def _human_bytes(size: int) -> str:
+    units = ("B", "KB", "MB", "GB", "TB")
+    value = float(size)
+    for unit in units:
+        if value < 1024 or unit == units[-1]:
+            if unit == "B":
+                return f"{int(value)} {unit}"
+            return f"{value:.2f} {unit}"
+        value /= 1024
+    return f"{size} B"
+
+
+def _load_meta(db_path: Path) -> dict[str, Any]:
+    if not db_path.exists():
+        return {"storage": "missing", "error": None}
+    try:
+        return json.loads(db_path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        return {"storage": "corrupt", "error": str(exc)}
+    except OSError as exc:
+        return {"storage": "unreadable", "error": str(exc)}
+
+
+def _storage_label(db_path: Path) -> str:
+    meta = _load_meta(db_path)
+    storage = meta.get("storage")
+    if storage == "sharded":
+        return "Sharded"
+    if storage in {"missing", "corrupt", "unreadable"}:
+        return str(storage).title()
+    if isinstance(meta.get("nodes"), list) and meta.get("nodes"):
+        return "Legacy inline (migrates on next graph save)"
+    return "Inline empty"
+
+
+def _shard_stats(db_path: Path) -> dict[str, Any]:
+    shard_dir = db_path.parent / ".droste" / "nodes"
+    if not shard_dir.exists():
+        return {"path": str(shard_dir), "count": 0, "bytes": 0}
+    files = [path for path in shard_dir.glob("*.json") if path.is_file()]
+    return {
+        "path": str(shard_dir),
+        "count": len(files),
+        "bytes": sum(path.stat().st_size for path in files),
+    }
+
+
+def _engine(db_path: Path | None = None) -> DrosteConceptEngine:
+    return DrosteConceptEngine(db_path=db_path or DEFAULT_DB_PATH)
+
+
+def command_status(args: argparse.Namespace) -> int:
+    engine = _engine(args.db)
+    migration = engine.ensure_sharded_storage()
+    nodes = engine.all_nodes()
+    links = engine.all_links()
+    symbol_count = sum(1 for node in nodes if node.node_type == "symbol")
+    syntax_link_count = sum(1 for link in links if link.type == "syntax_dependency")
+    shard_stats = _shard_stats(engine.db_path)
+
+    payload = {
+        "storage": _storage_label(engine.db_path),
+        "database": str(engine.db_path),
+        "node_count": len(nodes),
+        "symbol_count": symbol_count,
+        "link_count": len(links),
+        "syntax_link_count": syntax_link_count,
+        "shard_dir": shard_stats["path"],
+        "shard_count": shard_stats["count"],
+        "shard_bytes": shard_stats["bytes"],
+        "migration": migration,
+    }
+    if args.json:
+        print(json.dumps(payload, indent=2, ensure_ascii=False))
+        return 0
+
+    print_compact_header()
+    print("status")
+    print(f"  migration:     {migration['status']}")
+    print(f"  storage:       {payload['storage']}")
+    print(f"  database:      {payload['database']}")
+    print(f"  live nodes:    {payload['node_count']}")
+    print(f"  symbols:       {payload['symbol_count']}")
+    print(f"  links:         {payload['link_count']}")
+    print(f"  syntax links:  {payload['syntax_link_count']}")
+    print(f"  shard dir:     {payload['shard_dir']}")
+    print(f"  shard files:   {payload['shard_count']}")
+    print(f"  shard cache:   {_human_bytes(int(payload['shard_bytes']))}")
+    return 0
+
+
+def _post_visualizer_camera(camera: dict[str, Any], url: str) -> tuple[bool, str]:
+    payload = {
+        "x": camera.get("x", 0.0),
+        "y": camera.get("y", 0.0),
+        "zoom_level": camera.get("zoom", 1.0),
+    }
+    body = json.dumps(payload).encode("utf-8")
+    req = request.Request(
+        url,
+        data=body,
+        headers={"Content-Type": "application/json"},
+        method="POST",
+    )
+    try:
+        with request.urlopen(req, timeout=1.5) as response:
+            return True, f"HTTP {response.status}"
+    except (OSError, error.URLError, error.HTTPError) as exc:
+        return False, str(exc)
+
+
+def _open_editor(source_path: str | None, line_start: int | None) -> tuple[bool, str]:
+    if not source_path:
+        return False, "no source_path on focused node"
+    line = max(1, int(line_start or 1))
+    target = f"{source_path}:{line}"
+    code = shutil.which("code")
+    if code:
+        subprocess.Popen([code, "--goto", target])
+        return True, f"code --goto {target}"
+    return False, target
+
+
+def command_zoom(args: argparse.Namespace) -> int:
+    engine = _engine(args.db)
+    result = droste_zoom_query(args.symbol_name, engine=engine)
+    if result.get("status") != "focused":
+        print(f"not found: {args.symbol_name}", file=sys.stderr)
+        return 2
+
+    node = result["focused_node"]
+    camera = result["camera"]
+    print(f"focused: {node['title']}")
+    print(f"  node:   {node['id']}")
+    print(f"  type:   {node['node_type']}")
+    print(f"  source: {node.get('source_path') or '(none)'}")
+    print(f"  line:   {node.get('line_start') or '(none)'}")
+    print(f"  camera: x={camera['x']:.4f} y={camera['y']:.4f} zoom={camera['zoom']:.2f}")
+
+    if not args.no_visualizer:
+        ok, message = _post_visualizer_camera(camera, args.visualizer_url)
+        status = "sent" if ok else "not sent"
+        print(f"  visualizer: {status} ({message})")
+
+    if not args.no_open:
+        opened, message = _open_editor(node.get("source_path"), node.get("line_start"))
+        status = "opened" if opened else "fallback"
+        print(f"  editor: {status} ({message})")
+    return 0
+
+
+def command_context(args: argparse.Namespace) -> int:
+    engine = _engine(args.db)
+    ingester = DrosteProjectIngester(engine)
+    result = ingester.get_context(args.query, budget=args.budget)
+    if args.json:
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+        return 0
+    print(result.get("compiled_context", ""))
+    return 0
+
+
+def command_index(args: argparse.Namespace) -> int:
+    from core import treesitter_extract
+
+    path = Path(args.path).expanduser()
+    if not path.is_dir():
+        print(f"not a directory: {path}", file=sys.stderr)
+        return 2
+
+    engine = _engine(args.db)
+    ingester = DrosteProjectIngester(engine)
+    result = ingester.index_project(
+        str(path),
+        reset=args.reset,
+        max_files=args.max_files,
+        max_symbols=args.max_symbols,
+    )
+    if args.json:
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+        return 0
+
+    stats = result["stats"]
+    ts_on = result.get("treesitter_available", treesitter_extract.available())
+    print_compact_header()
+    print(f"indexed {path}")
+    print(f"  files:         {stats['file_count']}")
+    print(f"  symbols:       {stats['symbol_count']}")
+    print(f"  links:         {stats['link_count']}")
+    print(f"  syntax edges:  {result.get('syntax_dependency_links', 0)}")
+    print(f"  reused files:  {result.get('reused_files', 0)}")
+    print(f"  embeddings:    {engine.projector.backend}")
+    if ts_on:
+        print("  tree-sitter:   on (polyglot call-graph active)")
+    else:
+        print("  tree-sitter:   OFF — non-Python files degrade to symbols "
+              "without causal edges")
+        print("                 fix: pip install tree-sitter-language-pack",
+              file=sys.stderr)
+    return 0
+
+
+def command_view(args: argparse.Namespace) -> int:
+    """Export the live graph for the chosen root and open the fractal cockpit —
+    the one-command 'wow': index, then `droste view`."""
+    import http.server
+    import importlib.util
+    import socketserver
+    import threading
+    import webbrowser
+
+    vis_dir = ROOT / "visualizer"
+    spec = importlib.util.spec_from_file_location(
+        "droste_export_graph", str(vis_dir / "export_graph.py"))
+    exporter = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(exporter)
+    try:
+        counts = exporter.export(args.root, vis_dir / "graph.json")
+    except SystemExit as exc:
+        print(exc, file=sys.stderr)
+        return 2
+
+    engine = _engine(args.db)
+    nodes = engine.all_nodes()
+    links = engine.all_links()
+    (vis_dir / "status.json").write_text(json.dumps({
+        "node_count": len(nodes),
+        "symbol_count": sum(1 for n in nodes if n.node_type == "symbol"),
+        "link_count": len(links),
+        "syntax_link_count": sum(1 for l in links if l.type == "syntax_dependency"),
+        "counts": counts,
+    }, ensure_ascii=False), encoding="utf-8")
+
+    def handler(*a, **k):
+        return http.server.SimpleHTTPRequestHandler(*a, directory=str(vis_dir), **k)
+
+    socketserver.TCPServer.allow_reuse_address = True
+    httpd = socketserver.TCPServer(("127.0.0.1", args.port), handler)
+    url = f"http://127.0.0.1:{args.port}/cockpit.html?web=1"
+    print_compact_header()
+    print(f"view  ->  {url}")
+    print(f"  project: {counts['symbol']} symbols / {counts['edge']} causal edges "
+          f"across {counts['file']} files")
+    print("  Ctrl+C to stop")
+    if not args.no_open:
+        threading.Timer(0.6, lambda: webbrowser.open(url)).start()
+    try:
+        httpd.serve_forever()
+    except KeyboardInterrupt:
+        print("\nstopped")
+    finally:
+        httpd.server_close()
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="droste",
+        description="Droste-Memory cyberpunk graph CLI.",
+    )
+    parser.add_argument("--db", type=Path, default=DEFAULT_DB_PATH, help=argparse.SUPPRESS)
+    parser.add_argument("--version", action="version", version=f"droste {VERSION}")
+    sub = parser.add_subparsers(dest="command")
+
+    index = sub.add_parser("index", help="Index a project into the local graph.")
+    index.add_argument("path", help="Project root directory to index.")
+    index.add_argument("--reset", action="store_true",
+                       help="Wipe this root's prior nodes before indexing.")
+    index.add_argument("--max-files", type=int, default=2000)
+    index.add_argument("--max-symbols", type=int, default=20000)
+    index.add_argument("--json", action="store_true", help="Emit the full index result JSON.")
+    index.set_defaults(func=command_index)
+
+    status = sub.add_parser("status", help="Show local graph health.")
+    status.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
+    status.set_defaults(func=command_status)
+
+    zoom = sub.add_parser("zoom", help="Focus a symbol in editor and visualizer.")
+    zoom.add_argument("symbol_name")
+    zoom.add_argument("--no-open", action="store_true", help="Do not launch the editor.")
+    zoom.add_argument(
+        "--no-visualizer",
+        action="store_true",
+        help="Do not POST camera coordinates to the local visualizer.",
+    )
+    zoom.add_argument("--visualizer-url", default=VISUALIZER_CAMERA_URL)
+    zoom.set_defaults(func=command_zoom)
+
+    context = sub.add_parser("context", help="Emit compressed LLM context.")
+    context.add_argument("query", nargs="?", default="project")
+    context.add_argument("--budget", type=int, default=1500)
+    context.add_argument("--json", action="store_true", help="Emit full context payload JSON.")
+    context.set_defaults(func=command_context)
+
+    view = sub.add_parser("view", help="Open the fractal visualizer on the live graph.")
+    view.add_argument("--root", default=None, help="Indexed root to view (default: most recent).")
+    view.add_argument("--port", type=int, default=7878)
+    view.add_argument("--no-open", action="store_true", help="Serve without opening a browser.")
+    view.set_defaults(func=command_view)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if not args.command:
+        print_splash()
+        return 0
+    return int(args.func(args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())