brainpalace-cli 26.7.2__tar.gz → 26.7.3__tar.gz

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainpalace-cli
-Version: 26.7.2
+Version: 26.7.3
 Summary: BrainPalace CLI - Command-line interface for managing AI agent memory and knowledge retrieval
 License: MIT
 Keywords: brainpalace,rag,cli,ai-memory,llm-memory,semantic-search,ai-agent,claude-code,agent-memory

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/brainpalace_cli/cli.py

@@ -37,6 +37,7 @@ from .commands import (
     records_group,
     remember_command,
     reset_command,
+    rules_group,
     session_path_command,
     start_command,
     status_command,
@@ -152,6 +153,7 @@ cli.add_command(install_agent_command, name="install-agent")
 cli.add_command(install_session_hooks_command, name="install-session-hooks")
 cli.add_command(backfill_command, name="backfill-sessions")
 cli.add_command(records_group, name="records")
+cli.add_command(rules_group, name="rules")
 cli.add_command(extraction_group, name="extraction")
 cli.add_command(graph_group, name="graph")
 

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/brainpalace_cli/commands/__init__.py

@@ -25,6 +25,7 @@ from .recall import recall_command
 from .records import records_group
 from .remember import remember_command
 from .reset import reset_command
+from .rules import rules_group
 from .session_hooks import install_session_hooks_command
 from .sessions import session_path_command, submit_session_command
 from .start import start_command
@@ -64,6 +65,7 @@ __all__ = [
     "recall_command",
     "remember_command",
     "reset_command",
+    "rules_group",
     "session_path_command",
     "start_command",
     "submit_session_command",

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/brainpalace_cli/commands/records.py

@@ -59,6 +59,48 @@ def records_stats(url: str | None, json_output: bool) -> None:
         raise SystemExit(1) from e
 
 
+@records_group.command("recompute-salience")
+@click.option(
+    "--url",
+    envvar="BRAINPALACE_URL",
+    default=None,
+    help="BrainPalace server URL (default: from config or http://127.0.0.1:8000)",
+)
+@click.option(
+    "--metric", "-m", default=None, help="Restrict recompute to this metric only."
+)
+@click.option("--json", "json_output", is_flag=True, help="Output as JSON")
+def records_recompute_salience(
+    url: str | None, metric: str | None, json_output: bool
+) -> None:
+    """Re-score record salience with the registered scorer."""
+    resolved_url = url or get_server_url()
+    body: dict[str, str] = {}
+    if metric is not None:
+        body["metric"] = metric
+    try:
+        with DocServeClient(base_url=resolved_url) as client:
+            r = client._request("POST", "/records/recompute-salience", json=body)
+            if json_output:
+                import json as _json
+
+                click.echo(_json.dumps(r, indent=2))
+            else:
+                console.print(
+                    f"[green]Recomputed salience for {r['rescored']} record(s).[/]"
+                )
+    except ConnectionError as e:
+        exit_on_connection_error(e, base_url=resolved_url, json_output=json_output)
+    except ServerError as e:
+        if json_output:
+            import json as _json
+
+            click.echo(_json.dumps({"error": str(e), "detail": e.detail}))
+        else:
+            console.print(f"[red]Server Error ({e.status_code}):[/] {e.detail}")
+        raise SystemExit(1) from e
+
+
 @records_group.command("revalidate")
 @click.option(
     "--url",

brainpalace_cli-26.7.3/brainpalace_cli/commands/rules.py

@@ -0,0 +1,164 @@
+"""CLI subcommands for durable taught confidence rules (Phase 5 / CO-3)."""
+
+from __future__ import annotations
+
+import json as _json
+from typing import Any, Callable
+
+import click
+from rich.console import Console
+
+from ..client import (
+    ConnectionError,
+    DocServeClient,
+    ServerError,
+    exit_on_connection_error,
+)
+from ..config import get_server_url
+
+console = Console()
+
+
+def _url(url: str | None) -> str:
+    return url or get_server_url()
+
+
+_URL_OPT = click.option(
+    "--url",
+    envvar="BRAINPALACE_URL",
+    default=None,
+    help="BrainPalace server URL (default: from config or http://127.0.0.1:8000)",
+)
+_JSON_OPT = click.option("--json", "json_output", is_flag=True, help="Output as JSON")
+
+
+@click.group("rules")
+def rules_group() -> None:
+    """Manage durable taught confidence rules (compute-mode trust)."""
+
+
+def _run(
+    resolved_url: str,
+    json_output: bool,
+    fn: Callable[[DocServeClient], Any],
+) -> Any:
+    try:
+        with DocServeClient(base_url=resolved_url) as client:
+            return fn(client)
+    except ConnectionError as e:
+        exit_on_connection_error(e, base_url=resolved_url, json_output=json_output)
+    except ServerError as e:
+        if json_output:
+            click.echo(_json.dumps({"error": str(e), "detail": e.detail}))
+        else:
+            console.print(f"[red]Server Error ({e.status_code}):[/] {e.detail}")
+        raise SystemExit(1) from e
+
+
+@rules_group.command("list")
+@_URL_OPT
+@click.option("--all", "show_all", is_flag=True, help="Include retired rules")
+@_JSON_OPT
+def rules_list(url: str | None, show_all: bool, json_output: bool) -> None:
+    """List taught rules (active by default)."""
+    resolved = _url(url)
+
+    def _do(client: DocServeClient) -> None:
+        r = client._request("GET", "/rules", params={"active": not show_all})
+        if json_output:
+            click.echo(_json.dumps(r, indent=2))
+        else:
+            rules = r.get("rules") or []
+            if not rules:
+                console.print("[dim]no rules[/]")
+            for x in rules:
+                rng = f"[{x.get('value_min')}, {x.get('value_max')}]"
+                console.print(
+                    f"[bold]{x['id']}[/] {x['metric']} "
+                    f"{x.get('unit') or ''} {rng} -> {x['tier']} "
+                    f"(v{x['version']}{' RETIRED' if x['retired_at'] else ''})"
+                )
+
+    _run(resolved, json_output, _do)
+
+
+@rules_group.command("add")
+@_URL_OPT
+@click.option("--metric", "-m", required=True)
+@click.option(
+    "--tier",
+    "-t",
+    required=True,
+    type=click.Choice(["HIGH", "PROVISIONAL", "UNVERIFIED"]),
+)
+@click.option("--unit", "-u", default=None)
+@click.option("--min", "value_min", type=float, default=None)
+@click.option("--max", "value_max", type=float, default=None)
+@click.option("--owner", default="user")
+@_JSON_OPT
+def rules_add(
+    url: str | None,
+    metric: str,
+    tier: str,
+    unit: str | None,
+    value_min: float | None,
+    value_max: float | None,
+    owner: str,
+    json_output: bool,
+) -> None:
+    """Teach a confidence rule (promotes matching records)."""
+    resolved = _url(url)
+    body = {
+        "owner": owner,
+        "metric": metric,
+        "tier": tier,
+        "unit": unit,
+        "value_min": value_min,
+        "value_max": value_max,
+    }
+
+    def _do(client: DocServeClient) -> None:
+        r = client._request("POST", "/rules", json=body)
+        if json_output:
+            click.echo(_json.dumps(r, indent=2))
+        else:
+            console.print(f"[green]Rule added:[/] {r['id']}")
+
+    _run(resolved, json_output, _do)
+
+
+@rules_group.command("retire")
+@_URL_OPT
+@click.argument("rule_id")
+@_JSON_OPT
+def rules_retire(url: str | None, rule_id: str, json_output: bool) -> None:
+    """Retire (soft-delete) a taught rule."""
+    resolved = _url(url)
+
+    def _do(client: DocServeClient) -> None:
+        r = client._request("POST", f"/rules/{rule_id}/retire")
+        if json_output:
+            click.echo(_json.dumps(r, indent=2))
+        else:
+            console.print(
+                "[green]Retired.[/]"
+                if r.get("retired")
+                else "[yellow]No active rule with that id.[/]"
+            )
+
+    _run(resolved, json_output, _do)
+
+
+@rules_group.command("show")
+@_URL_OPT
+@click.argument("rule_id")
+@_JSON_OPT
+def rules_show(url: str | None, rule_id: str, json_output: bool) -> None:
+    """Show one taught rule by id."""
+    resolved = _url(url)
+
+    def _do(client: DocServeClient) -> None:
+        r = client._request("GET", f"/rules/{rule_id}")
+        click.echo(_json.dumps(r, indent=2))
+
+    _run(resolved, json_output, _do)

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/brainpalace_cli/commands/verify_docs.py

@@ -186,6 +186,22 @@ def _changed_paths(base: str) -> list[str]:
     return sorted(n for n in names if n)
 
 
+def _default_base() -> str:
+    """Base ref for the `--changed` / `--check` net diff. `main` (the historical
+    Click default) is WRONG for this repo: `stable` (the working branch) and
+    `main` (the squashed publish mirror) have UNRELATED histories, so `main...HEAD`
+    is empty and the affected set collapses to nothing — the `--check` gate then
+    trivially passes and prose drift builds up unseen.
+
+    The real done-boundary is the PREVIOUS release: the most recent `release:`
+    commit reachable from HEAD. `before-push` runs at RELEASING step 8, before the
+    new release commit is made at step 9, so this always resolves to the prior
+    release — i.e. exactly the changes THIS release ships. Falls back to `main`
+    when no release commit exists (a fresh repo / non-release history)."""
+    rel = _git("log", "-E", "--grep=^release:", "--format=%H", "-1")
+    return rel[0] if rel else "main"
+
+
 #: Docs that are NEITHER verified by Layer B NOR usable as grounding for another
 #: doc's claim — historical / frozen / scratch material that describes PAST or
 #: INTENDED state, so grounding live code against it is meaningless (false verdicts
@@ -1601,7 +1617,10 @@ def _render_report(summary: dict[str, Any]) -> str:
     help="Verify the net-diff affected set (done-boundary).",
 )
 @click.option(
-    "--base", default="main", help="Base ref for --changed net diff (default: main)."
+    "--base",
+    default=None,
+    help="Base ref for --changed net diff (default: the previous `release:` "
+    "commit; `main` is degenerate here — unrelated histories).",
 )
 @click.option(
     "--record",
@@ -1670,7 +1689,7 @@ def verify_docs_command(
     paths: tuple[str, ...],
     all_docs: bool,
     changed: bool,
-    base: str,
+    base: str | None,
     record_file: str | None,
     check_marker: bool,
     resettle: bool,
@@ -1711,6 +1730,8 @@ def verify_docs_command(
     lists CONTRADICTED + UNVERIFIABLE (PENDING stays silent).
     """
     _require_repo()
+    if base is None:
+        base = _default_base()
     if check_marker:
         # B5 process gate (advisory, opt-in for pre-push wiring): did verify-docs
         # run for THIS diff? Compares the current net-diff fingerprint to the one

{brainpalace_cli-26.7.2 → brainpalace_cli-26.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "brainpalace-cli"
-version = "26.7.2"
+version = "26.7.3"
 description = "BrainPalace CLI - Command-line interface for managing AI agent memory and knowledge retrieval"
 authors = ["bxw91"]
 readme = "README.md"