shellbrain 0.1.53__tar.gz → 0.1.55__tar.gz

{shellbrain-0.1.53 → shellbrain-0.1.55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.53
+Version: 0.1.55
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -28,7 +28,7 @@ ShellBrain gives AI agents memory, so they can store and reuse what they learn o
 curl -L shellbrain.ai/install | bash
 ```
 
-**Works for Codex, Claude Code, and Cursor.**
+**Works for Codex, Claude Code, and Cursor.** The installer runs `shellbrain init` for you. Repos register themselves on first use.
 
 Requirements.
 - macOS or Linux, Python 3.11+, Docker for the managed local Postgres+pgvector runtime.
@@ -38,6 +38,9 @@ Requirements.
 ```bash
 shellbrain upgrade
 ```
+
+You can also run `curl -L shellbrain.ai/upgrade | bash`. Manual alternative: `pipx upgrade shellbrain && shellbrain init`.
+
 ---
 
 ## Recall in one command
@@ -113,10 +116,10 @@ ShellBrain keeps memory grounded in evidence and narrow in scope. Agents request
 
 ## Use ShellBrain
 
-Use ShellBrain with your preferred agent. Then work as usual.
+Use Shellbrain with your preferred agent. Then work as usual.
 
 - **Claude Code:** Use `/shellbrain` to recall context at task boundaries.
-- **Codex:** Use `$shellbrain` to recall context at task boundaries.
+- **Codex:** Use $shellbrain to recall context at task boundaries.
 - **Cursor:** Use `/shellbrain` to recall context at task boundaries.
 
 ---

{shellbrain-0.1.53 → shellbrain-0.1.55}/README.md

@@ -14,7 +14,7 @@ ShellBrain gives AI agents memory, so they can store and reuse what they learn o
 curl -L shellbrain.ai/install | bash
 ```
 
-**Works for Codex, Claude Code, and Cursor.**
+**Works for Codex, Claude Code, and Cursor.** The installer runs `shellbrain init` for you. Repos register themselves on first use.
 
 Requirements.
 - macOS or Linux, Python 3.11+, Docker for the managed local Postgres+pgvector runtime.
@@ -24,6 +24,9 @@ Requirements.
 ```bash
 shellbrain upgrade
 ```
+
+You can also run `curl -L shellbrain.ai/upgrade | bash`. Manual alternative: `pipx upgrade shellbrain && shellbrain init`.
+
 ---
 
 ## Recall in one command
@@ -99,10 +102,10 @@ ShellBrain keeps memory grounded in evidence and narrow in scope. Agents request
 
 ## Use ShellBrain
 
-Use ShellBrain with your preferred agent. Then work as usual.
+Use Shellbrain with your preferred agent. Then work as usual.
 
 - **Claude Code:** Use `/shellbrain` to recall context at task boundaries.
-- **Codex:** Use `$shellbrain` to recall context at task boundaries.
+- **Codex:** Use $shellbrain to recall context at task boundaries.
 - **Cursor:** Use `/shellbrain` to recall context at task boundaries.
 
 ---

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/entrypoints/cli/parser/builder.py

@@ -38,7 +38,6 @@ _TOP_LEVEL_HELP = dedent(
         - Bootstrap or repair with `shellbrain init`.
         - Upgrade with `shellbrain upgrade`.
         - Check health with `shellbrain admin doctor`.
-        - Review usage with `shellbrain metrics`.
 
       Working agents:
         - Use `shellbrain recall` for normal task context.
@@ -68,7 +67,6 @@ _TOP_LEVEL_HELP = dedent(
       Humans:
       shellbrain init
       shellbrain upgrade
-      shellbrain metrics
       shellbrain admin doctor
       shellbrain admin migrate
 
@@ -386,15 +384,6 @@ _BACKFILL_TOKEN_USAGE_HELP = dedent(
     """
 )
 
-_METRICS_HELP = dedent(
-    """\
-    Generate lightweight metrics snapshots, write local artifacts, and open one browser dashboard that switches repos with arrow keys.
-
-    Example:
-      shellbrain metrics
-    """
-)
-
 _INSTALL_CLAUDE_HOOK_HELP = dedent(
     """\
     Install or update the repo-local Claude Code SessionStart hook used as an explicit repo-local override.
@@ -499,14 +488,6 @@ def build_parser() -> argparse.ArgumentParser:
         formatter_class=_HelpFormatter,
     )
 
-    subparsers.add_parser(
-        "metrics",
-        help="Browse Shellbrain metrics across repos.",
-        description="Generate local metrics snapshots and open one browser dashboard for all repos.",
-        epilog=_METRICS_HELP,
-        formatter_class=_HelpFormatter,
-    )
-
     read_parser = subparsers.add_parser(
         "read",
         help="Read Shellbrain context without mutating state.",

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/entrypoints/cli/runner.py

@@ -89,15 +89,6 @@ def main(
 
         return run_upgrade_command(run_upgrade_command=runtime.run_upgrade_command)
 
-    if args.command == "metrics":
-        from app.entrypoints.cli.handlers.human.metrics import run_metrics_command
-
-        return run_metrics_command(
-            args,
-            warn_or_fail_on_unsafe_app_role=runtime.warn_or_fail_on_unsafe_app_role,
-            run_metrics_dashboard=runtime.run_metrics_dashboard,
-        )
-
     if args.command == "admin":
         from app.entrypoints.cli.handlers.human.admin import run_admin_command
 

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/entrypoints/cli/runtime.py

@@ -31,5 +31,4 @@ class CliRuntime(Protocol):
     init_success_presenter_context: Callable[[], dict[str, Any]]
     run_upgrade_command: Callable[[], int]
     warn_or_fail_on_unsafe_app_role: Callable[[], None]
-    run_metrics_dashboard: Callable[..., object]
     admin_dependencies: Any

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/infrastructure/db/admin/provisioning/docker_prerequisites.py

@@ -21,8 +21,12 @@ def ensure_docker_runtime_available() -> None:
         check=False,
     )
     if completed.returncode != 0:
+        detail = completed.stderr.strip() or completed.stdout.strip()
+        if not detail:
+            detail = f"docker info exited with status {completed.returncode}"
         raise InitDependencyError(
-            "Shellbrain init requires the Docker daemon to be running and reachable."
+            "Shellbrain requires a reachable Docker daemon for managed-local runtime operations. "
+            f"docker info failed: {detail}"
         )
 
 

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/infrastructure/host_apps/inner_agents/prompt.py

@@ -77,7 +77,7 @@ shellbrain --no-sync --repo-root "<repo_root>" concept show --help
 
 Do not run `shellbrain recall`.
 Do not write memories, concepts, scenarios, files, settings, or database data.
-Do not run `admin`, `init`, `upgrade`, or `metrics` commands.
+Do not run `admin`, `init`, or `upgrade` commands.
 
 # PROTOCOL
 1. Read `query`, `repo_root`, and the budgets from the payload.
@@ -456,7 +456,7 @@ Do not edit files.
 Do not run a formatter that writes files.
 Do not commit or push.
 Do not run `shellbrain recall` or `shellbrain snapshot`.
-Do not run `admin`, `init`, `upgrade`, or `metrics` commands.
+Do not run `admin`, `init`, or `upgrade` commands.
 Do not write directly to the database.
 Do not use `graph_patches`.
 Do not use a write command that this prompt does not list.
@@ -712,7 +712,7 @@ shellbrain --repo-root "<repo_root>" concept update --help
 ```
 
 Forbidden: `shellbrain events`, `shellbrain scenario record`, `shellbrain
-recall`, `shellbrain snapshot`, admin/init/upgrade/metrics, direct DB writes,
+recall`, `shellbrain snapshot`, admin/init/upgrade, direct DB writes,
 editing files, formatters, commits, pushes, and any write command not listed
 above.
 
@@ -864,7 +864,7 @@ def render_build_context_prompt(request: InnerAgentRunRequest) -> str:
             "shellbrain concept add",
             "shellbrain concept update",
             "shellbrain scenario record",
-            "any admin, init, upgrade, metrics, or durable write command",
+            "any admin, init, upgrade, or durable write command",
         ],
         "output_contract": {
             "brief": {

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/startup/cli.py

@@ -13,7 +13,6 @@ def build_cli_runtime():
 
     from app.startup import create_policy
     from app.startup import episode_sync_launcher
-    from app.startup import metrics as startup_metrics
     from app.startup import operation_dependencies
     from app.startup import read_policy
     from app.startup import repo_context
@@ -63,7 +62,6 @@ def build_cli_runtime():
         init_success_presenter_context=runtime_admin.init_success_presenter_context,
         run_upgrade_command=run_upgrade_command,
         warn_or_fail_on_unsafe_app_role=warn_or_fail_on_unsafe_app_role,
-        run_metrics_dashboard=startup_metrics.run_metrics_dashboard,
         admin_dependencies=build_admin_command_dependencies(),
     )
 

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/startup/cli_runtime.py

@@ -35,5 +35,4 @@ class CliRuntime:
     init_success_presenter_context: Callable[[], dict[str, Any]]
     run_upgrade_command: Callable[[], int]
     warn_or_fail_on_unsafe_app_role: Callable[[], None]
-    run_metrics_dashboard: Callable[..., object]
     admin_dependencies: AdminCommandDependencies

{shellbrain-0.1.53 → shellbrain-0.1.55}/app/startup/runtime_admin.py

@@ -172,11 +172,23 @@ def ensure_managed_runtime_ready() -> None:
         return
     if config.runtime_mode != RUNTIME_MODE_MANAGED_LOCAL:
         return
+    if _postgres_is_ready(config.database.admin_dsn):
+        return
     ensure_managed_runtime_available()
     managed_runtime.ensure_existing_managed_container_running(config)
     wait_for_postgres(config.database.admin_dsn, timeout_seconds=15)
 
 
+def _postgres_is_ready(admin_dsn: str) -> bool:
+    """Return whether the configured PostgreSQL runtime accepts connections."""
+
+    try:
+        wait_for_postgres(admin_dsn, timeout_seconds=0)
+    except InitConflictError:
+        return False
+    return True
+
+
 def _build_fresh_machine_config() -> MachineConfig:
     """Construct a fresh machine config for managed-local mode."""
 

{shellbrain-0.1.53 → shellbrain-0.1.55}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shellbrain"
-version = "0.1.53"
+version = "0.1.55"
 description = "Repo-scoped Shellbrain CLI with explicit evidence-backed writes."
 readme = "README.md"
 requires-python = ">=3.11"

{shellbrain-0.1.53 → shellbrain-0.1.55}/shellbrain.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.53
+Version: 0.1.55
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -28,7 +28,7 @@ ShellBrain gives AI agents memory, so they can store and reuse what they learn o
 curl -L shellbrain.ai/install | bash
 ```
 
-**Works for Codex, Claude Code, and Cursor.**
+**Works for Codex, Claude Code, and Cursor.** The installer runs `shellbrain init` for you. Repos register themselves on first use.
 
 Requirements.
 - macOS or Linux, Python 3.11+, Docker for the managed local Postgres+pgvector runtime.
@@ -38,6 +38,9 @@ Requirements.
 ```bash
 shellbrain upgrade
 ```
+
+You can also run `curl -L shellbrain.ai/upgrade | bash`. Manual alternative: `pipx upgrade shellbrain && shellbrain init`.
+
 ---
 
 ## Recall in one command
@@ -113,10 +116,10 @@ ShellBrain keeps memory grounded in evidence and narrow in scope. Agents request
 
 ## Use ShellBrain
 
-Use ShellBrain with your preferred agent. Then work as usual.
+Use Shellbrain with your preferred agent. Then work as usual.
 
 - **Claude Code:** Use `/shellbrain` to recall context at task boundaries.
-- **Codex:** Use `$shellbrain` to recall context at task boundaries.
+- **Codex:** Use $shellbrain to recall context at task boundaries.
 - **Cursor:** Use `/shellbrain` to recall context at task boundaries.
 
 ---

{shellbrain-0.1.53 → shellbrain-0.1.55}/shellbrain.egg-info/SOURCES.txt

@@ -63,8 +63,6 @@ app/core/ports/host_apps/inner_agents.py
 app/core/ports/local_state/__init__.py
 app/core/ports/local_state/session_state_store.py
 app/core/ports/local_state/shadow_git.py
-app/core/ports/reporting/__init__.py
-app/core/ports/reporting/metrics.py
 app/core/ports/system/__init__.py
 app/core/ports/system/clock.py
 app/core/ports/system/idgen.py
@@ -130,8 +128,6 @@ app/core/use_cases/memories/update/request.py
 app/core/use_cases/memories/update/result.py
 app/core/use_cases/metrics/__init__.py
 app/core/use_cases/metrics/analyze_agent_behavior.py
-app/core/use_cases/metrics/build_snapshot.py
-app/core/use_cases/metrics/generate_dashboard.py
 app/core/use_cases/retrieval/__init__.py
 app/core/use_cases/retrieval/concept_seed_retrieval.py
 app/core/use_cases/retrieval/context_pack_pipeline.py
@@ -178,7 +174,6 @@ app/entrypoints/cli/handlers/human/__init__.py
 app/entrypoints/cli/handlers/human/admin.py
 app/entrypoints/cli/handlers/human/admin_dependencies.py
 app/entrypoints/cli/handlers/human/init.py
-app/entrypoints/cli/handlers/human/metrics.py
 app/entrypoints/cli/handlers/human/upgrade.py
 app/entrypoints/cli/handlers/internal_agent/__init__.py
 app/entrypoints/cli/handlers/internal_agent/concepts/__init__.py
@@ -207,7 +202,6 @@ app/entrypoints/cli/parser/builder.py
 app/entrypoints/cli/presenters/__init__.py
 app/entrypoints/cli/presenters/init.py
 app/entrypoints/cli/presenters/json.py
-app/entrypoints/cli/presenters/metrics.py
 app/entrypoints/cli/request_parsing/__init__.py
 app/entrypoints/cli/request_parsing/concepts.py
 app/entrypoints/cli/request_parsing/episodes.py
@@ -265,8 +259,6 @@ app/infrastructure/db/runtime/models/views.py
 app/infrastructure/db/runtime/queries/__init__.py
 app/infrastructure/db/runtime/queries/agent_behavior.py
 app/infrastructure/db/runtime/queries/analytics.py
-app/infrastructure/db/runtime/queries/metrics.py
-app/infrastructure/db/runtime/queries/metrics_adapter.py
 app/infrastructure/db/runtime/queries/model_usage_backfill.py
 app/infrastructure/db/runtime/repos/__init__.py
 app/infrastructure/db/runtime/repos/relational/__init__.py
@@ -340,12 +332,6 @@ app/infrastructure/process/episode_sync/launcher.py
 app/infrastructure/process/episode_sync/lock_file.py
 app/infrastructure/process/episode_sync/poller.py
 app/infrastructure/process/episode_sync/status_store.py
-app/infrastructure/reporting/__init__.py
-app/infrastructure/reporting/metrics/__init__.py
-app/infrastructure/reporting/metrics/artifacts.py
-app/infrastructure/reporting/metrics/browser.py
-app/infrastructure/reporting/metrics/pager.py
-app/infrastructure/reporting/metrics/render_html.py
 app/infrastructure/system/__init__.py
 app/infrastructure/system/clock.py
 app/infrastructure/system/id_generator.py
@@ -389,7 +375,6 @@ app/startup/host_hooks.py
 app/startup/internal_agent_config.py
 app/startup/internal_agents.py
 app/startup/knowledge_builder.py
-app/startup/metrics.py
 app/startup/migrations.py
 app/startup/model_usage_backfill.py
 app/startup/operation_dependencies.py

shellbrain-0.1.53/app/core/ports/reporting/__init__.py

@@ -1 +0,0 @@
-"""Reporting and artifact output ports."""

shellbrain-0.1.53/app/core/ports/reporting/metrics.py

@@ -1,32 +0,0 @@
-"""Ports for metrics dashboard generation."""
-
-from __future__ import annotations
-
-from pathlib import Path
-from typing import Any, Protocol
-
-
-class MetricsHtmlRenderer(Protocol):
-    """Render metrics snapshots to HTML."""
-
-    def render_metrics_dashboard(self, snapshot: dict[str, Any]) -> str: ...
-
-    def render_metrics_browser_dashboard(
-        self, snapshots: list[dict[str, Any]]
-    ) -> str: ...
-
-
-class MetricsArtifactWriter(Protocol):
-    """Persist rendered metrics artifacts."""
-
-    def write_metrics_artifacts(
-        self, *, repo_id: str, snapshot: dict[str, Any], html: str
-    ) -> dict[str, Path | str]: ...
-
-    def write_metrics_index_artifact(self, *, html: str) -> Path | str: ...
-
-
-class MetricsDashboardBrowser(Protocol):
-    """Open a generated metrics dashboard when possible."""
-
-    def open_metrics_dashboard(self, path: Path) -> bool: ...