cortexdb-cli 0.4.2__tar.gz → 0.5.0__tar.gz

{cortexdb_cli-0.4.2 → cortexdb_cli-0.5.0}/.gitignore

@@ -88,7 +88,14 @@ benchmarks/data_*/
 benchmarks/**/fast_results/
 data_*/
 *_data/
+*_data_20*/
 cortexdb_data*/
 server_results/
 *.log
 docker_build.log
+
+# local gate/bench data stores
+gate*_data_*/
+
+# Code-plane benchmark local run outputs (official results are committed deliberately)
+benchmarks/codeplane/runs/

{cortexdb_cli-0.4.2 → cortexdb_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cortexdb-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: Command-line interface for CortexDB — the long-term memory layer for AI.
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://cortexdb.ai/docs

{cortexdb_cli-0.4.2 → cortexdb_cli-0.5.0}/cortexdb_cli/__init__.py

@@ -1,3 +1,3 @@
 """CortexDB CLI — command-line interface for the v1 memory API."""
 
-__version__ = "0.4.2"
+__version__ = "0.5.0"

{cortexdb_cli-0.4.2 → cortexdb_cli-0.5.0}/cortexdb_cli/commands/audit.py

@@ -1,78 +1,78 @@
-"""cortexdb audit — GET /v1/audit/chain + POST /v1/audit/chain/verify."""
-
-from __future__ import annotations
-
-import click
-
-from cortexdb_cli.client import get_client
-from cortexdb_cli.errors import handle_errors
-from cortexdb_cli.output import console, escape, is_json_mode, print_json, spinner
-
-
-@click.group("audit")
-def audit_group() -> None:
-    """Audit log integrity — hash-chain status and verification."""
-
-
-@audit_group.command("chain")
-@click.option("--actor", help="Restrict chain stats to one actor's rows.")
-@click.pass_context
-@handle_errors
-def audit_chain(ctx: click.Context, actor: str | None) -> None:
-    """Show the audit hash-chain head + length (GET /v1/audit/chain).
-
-    Integrity metadata only — hashes and counts, never row content.
-    """
-    cfg = ctx.obj
-    params: dict[str, str] = {}
-    if actor:
-        params["actor"] = actor
-    with get_client(cfg) as client:
-        resp = client.get("/v1/audit/chain", params=params or None)
-        resp.raise_for_status()
-        data = resp.json()
-
-    if is_json_mode(cfg):
-        print_json(data)
-        return
-    console.print(f"Chain length: [bold]{data.get('length', 0)}[/bold] row(s)")
-    console.print(f"Head hash:    [dim]{escape(str(data.get('head_hash') or '(empty)'))}[/dim]")
-    legacy = data.get("legacy_rows", 0)
-    if legacy:
-        console.print(f"[dim]{legacy} legacy row(s) predate the chain.[/dim]")
-
-
-@audit_group.command("verify")
-@click.pass_context
-@handle_errors
-def audit_verify(ctx: click.Context) -> None:
-    """Walk the whole audit chain, recomputing every row hash
-    (POST /v1/audit/chain/verify)."""
-    cfg = ctx.obj
-    with get_client(cfg) as client:
-        if not is_json_mode(cfg):
-            with spinner("Verifying chain..."):
-                resp = client.post("/v1/audit/chain/verify", json={})
-        else:
-            resp = client.post("/v1/audit/chain/verify", json={})
-        resp.raise_for_status()
-        data = resp.json()
-
-    if is_json_mode(cfg):
-        print_json(data)
-        return
-    if data.get("valid"):
-        console.print(
-            f"[success]Chain valid[/success] — {data.get('length', 0)} row(s), "
-            f"head [dim]{escape(str(data.get('head_hash') or '(empty)'))}[/dim]"
-        )
-    else:
-        console.print(
-            f"[error]Chain BROKEN[/error] at row index "
-            f"[bold]{data.get('first_broken_index')}[/bold] "
-            f"of {data.get('length', 0)}."
-        )
-        raise SystemExit(1)
-    legacy = data.get("legacy_rows", 0)
-    if legacy:
-        console.print(f"[dim]{legacy} legacy row(s) predate the chain.[/dim]")
+"""cortexdb audit — GET /v1/audit/chain + POST /v1/audit/chain/verify."""
+
+from __future__ import annotations
+
+import click
+
+from cortexdb_cli.client import get_client
+from cortexdb_cli.errors import handle_errors
+from cortexdb_cli.output import console, escape, is_json_mode, print_json, spinner
+
+
+@click.group("audit")
+def audit_group() -> None:
+    """Audit log integrity — hash-chain status and verification."""
+
+
+@audit_group.command("chain")
+@click.option("--actor", help="Restrict chain stats to one actor's rows.")
+@click.pass_context
+@handle_errors
+def audit_chain(ctx: click.Context, actor: str | None) -> None:
+    """Show the audit hash-chain head + length (GET /v1/audit/chain).
+
+    Integrity metadata only — hashes and counts, never row content.
+    """
+    cfg = ctx.obj
+    params: dict[str, str] = {}
+    if actor:
+        params["actor"] = actor
+    with get_client(cfg) as client:
+        resp = client.get("/v1/audit/chain", params=params or None)
+        resp.raise_for_status()
+        data = resp.json()
+
+    if is_json_mode(cfg):
+        print_json(data)
+        return
+    console.print(f"Chain length: [bold]{data.get('length', 0)}[/bold] row(s)")
+    console.print(f"Head hash:    [dim]{escape(str(data.get('head_hash') or '(empty)'))}[/dim]")
+    legacy = data.get("legacy_rows", 0)
+    if legacy:
+        console.print(f"[dim]{legacy} legacy row(s) predate the chain.[/dim]")
+
+
+@audit_group.command("verify")
+@click.pass_context
+@handle_errors
+def audit_verify(ctx: click.Context) -> None:
+    """Walk the whole audit chain, recomputing every row hash
+    (POST /v1/audit/chain/verify)."""
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        if not is_json_mode(cfg):
+            with spinner("Verifying chain..."):
+                resp = client.post("/v1/audit/chain/verify", json={})
+        else:
+            resp = client.post("/v1/audit/chain/verify", json={})
+        resp.raise_for_status()
+        data = resp.json()
+
+    if is_json_mode(cfg):
+        print_json(data)
+        return
+    if data.get("valid"):
+        console.print(
+            f"[success]Chain valid[/success] — {data.get('length', 0)} row(s), "
+            f"head [dim]{escape(str(data.get('head_hash') or '(empty)'))}[/dim]"
+        )
+    else:
+        console.print(
+            f"[error]Chain BROKEN[/error] at row index "
+            f"[bold]{data.get('first_broken_index')}[/bold] "
+            f"of {data.get('length', 0)}."
+        )
+        raise SystemExit(1)
+    legacy = data.get("legacy_rows", 0)
+    if legacy:
+        console.print(f"[dim]{legacy} legacy row(s) predate the chain.[/dim]")

cortexdb_cli-0.5.0/cortexdb_cli/commands/code.py

@@ -0,0 +1,246 @@
+"""cortexdb code — the Code Intelligence Plane (plan T-904).
+
+Thin wrappers over ``/v1/code/*``: register repositories, inspect status,
+import compiler-tier (SCIP) indexes and coverage, export/import the
+hash-verified index bundle, pin snapshots, run GC, and print the earned
+capability matrix. Requires the "Code memory" feature bundle on the
+server (`CORTEX_CODE_PLANE=1`); with it off every command reports the
+503 the server returns.
+"""
+
+from __future__ import annotations
+
+import json
+import pathlib
+import sys
+
+import click
+
+from cortexdb_cli.client import get_client
+from cortexdb_cli.errors import handle_errors
+from cortexdb_cli.output import is_json_mode, spinner
+
+
+@click.group("code")
+def code_group() -> None:
+    """Code memory — repositories, imports, bundles, GC."""
+
+
+def _echo(cfg, payload) -> None:
+    if is_json_mode(cfg):
+        click.echo(json.dumps(payload, indent=2))
+    else:
+        click.echo(json.dumps(payload, indent=2))
+
+
+@code_group.command("add")
+@click.argument("name")
+@click.argument("path", type=click.Path(exists=True, file_okay=False))
+@click.pass_context
+@handle_errors
+def code_add(ctx: click.Context, name: str, path: str) -> None:
+    """Register + index a local repository (POST /v1/code/repos).
+
+    NAME is the repo handle used by every other verb; PATH is the local
+    checkout. Indexing runs synchronously and reports the fact counts.
+    """
+    cfg = ctx.obj
+    absolute = str(pathlib.Path(path).resolve())
+    with get_client(cfg) as client:
+        with spinner(f"Indexing {name}..."):
+            resp = client.post(
+                "/v1/code/repos", json={"name": name, "path": absolute}
+            )
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("status")
+@click.argument("name", required=False)
+@click.pass_context
+@handle_errors
+def code_status(ctx: click.Context, name: str | None) -> None:
+    """Repo status (GET /v1/code/repos[/NAME]) — snapshot, stats, scope."""
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        url = f"/v1/code/repos/{name}" if name else "/v1/code/repos"
+        resp = client.get(url)
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("import-scip")
+@click.argument("name")
+@click.argument("index_file", type=click.Path(exists=True, dir_okay=False))
+@click.pass_context
+@handle_errors
+def code_import_scip(ctx: click.Context, name: str, index_file: str) -> None:
+    """Import a compiler-tier .scip index (POST /v1/code/import/scip).
+
+    Produce one with scip-typescript / scip-go / rust-analyzer etc.;
+    documents are validated per-file against the repo snapshot and the
+    response lists exactly what was accepted and what was rejected why.
+    """
+    cfg = ctx.obj
+    payload = pathlib.Path(index_file).read_bytes()
+    with get_client(cfg) as client:
+        with spinner("Importing SCIP index..."):
+            resp = client.post(
+                f"/v1/code/import/scip?repo={name}",
+                content=payload,
+                headers={"Content-Type": "application/octet-stream"},
+            )
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("import-coverage")
+@click.argument("name")
+@click.argument("lcov_file", type=click.Path(exists=True, dir_okay=False))
+@click.pass_context
+@handle_errors
+def code_import_coverage(ctx: click.Context, name: str, lcov_file: str) -> None:
+    """Import an lcov coverage run (POST /v1/code/import/coverage) —
+    upgrades tests.for_change rows from static to observed."""
+    cfg = ctx.obj
+    lcov = pathlib.Path(lcov_file).read_text(encoding="utf-8", errors="replace")
+    with get_client(cfg) as client:
+        resp = client.post(
+            "/v1/code/import/coverage", json={"repo": name, "lcov": lcov}
+        )
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("export-index")
+@click.argument("name")
+@click.argument("out_file", type=click.Path(dir_okay=False))
+@click.pass_context
+@handle_errors
+def code_export_index(ctx: click.Context, name: str, out_file: str) -> None:
+    """Download the hash-verified index bundle (GET /v1/code/export-index)."""
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        with spinner("Exporting index..."):
+            resp = client.get(f"/v1/code/export-index?repo={name}")
+        resp.raise_for_status()
+        pathlib.Path(out_file).write_bytes(resp.content)
+    click.echo(f"Wrote {len(resp.content)} bytes to {out_file}")
+
+
+@code_group.command("import-index")
+@click.argument("name")
+@click.argument("bundle_file", type=click.Path(exists=True, dir_okay=False))
+@click.pass_context
+@handle_errors
+def code_import_index(ctx: click.Context, name: str, bundle_file: str) -> None:
+    """Restore a bundle (POST /v1/code/import-index). Every hash is
+    verified before any write; a tampered bundle is rejected whole."""
+    cfg = ctx.obj
+    payload = pathlib.Path(bundle_file).read_bytes()
+    with get_client(cfg) as client:
+        with spinner("Verifying and importing bundle..."):
+            resp = client.post(
+                f"/v1/code/import-index?repo={name}",
+                content=payload,
+                headers={"Content-Type": "application/octet-stream"},
+            )
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("pin")
+@click.argument("name")
+@click.argument("manifest_hash")
+@click.option("--label", default="", help="Human label for the pin")
+@click.option("--remove", is_flag=True, help="Remove the pin instead")
+@click.pass_context
+@handle_errors
+def code_pin(
+    ctx: click.Context, name: str, manifest_hash: str, label: str, remove: bool
+) -> None:
+    """Pin (or unpin) a snapshot manifest so GC always retains it."""
+    cfg = ctx.obj
+    body = {"repo": name, "manifest_hash": manifest_hash, "label": label}
+    with get_client(cfg) as client:
+        if remove:
+            resp = client.request("DELETE", "/v1/code/pins", json=body)
+        else:
+            resp = client.post("/v1/code/pins", json=body)
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("gc")
+@click.argument("name")
+@click.pass_context
+@handle_errors
+def code_gc(ctx: click.Context, name: str) -> None:
+    """Run one GC cycle (POST /v1/code/gc) — two-phase mark/delete;
+    the report lists every destructive step."""
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        with spinner("Collecting..."):
+            resp = client.post("/v1/code/gc", json={"repo": name})
+        resp.raise_for_status()
+        _echo(cfg, resp.json())
+
+
+@code_group.command("matrix")
+@click.pass_context
+@handle_errors
+def code_matrix(ctx: click.Context) -> None:
+    """Print the earned language-capability matrix (GET /v1/code/matrix).
+
+    Every column is earned by tests, never asserted — parse-only
+    languages say so.
+    """
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        resp = client.get("/v1/code/matrix")
+        resp.raise_for_status()
+        body = resp.json()
+        if is_json_mode(cfg):
+            click.echo(json.dumps(body, indent=2))
+            return
+        languages = body.get("languages", [])
+        if not isinstance(languages, list):
+            click.echo(json.dumps(body, indent=2))
+            return
+        for row in languages:
+            if not isinstance(row, dict):
+                continue
+            name = row.get("language", "?")
+            earned = [
+                key
+                for key in (
+                    "parse",
+                    "definitions",
+                    "imports",
+                    "calls",
+                    "inheritance",
+                    "references",
+                    "compiler_precise",
+                )
+                if row.get(key)
+            ]
+            click.echo(f"{name}: {', '.join(earned) or 'none'}")
+
+
+@code_group.command("watch")
+@click.argument("name")
+@click.pass_context
+@handle_errors
+def code_watch(ctx: click.Context, name: str) -> None:
+    """Watcher status for a repo. Server-side watch wiring reports
+    through repo status; this surfaces the same data."""
+    cfg = ctx.obj
+    with get_client(cfg) as client:
+        resp = client.get(f"/v1/code/repos/{name}")
+        resp.raise_for_status()
+        body = resp.json()
+        _echo(cfg, {"repo": name, "snapshot": body.get("snapshot"), "stats": body.get("stats")})
+
+
+if __name__ == "__main__":  # pragma: no cover
+    sys.exit(0)