refactor(core): add shared runtime orchestration

AGENTS.md

@@ -22,9 +22,10 @@ See the [README.md](README.md) file for a project overview.
 - Run unit tests (Postgres): `just test-unit-postgres`
 - Run integration tests (SQLite): `just test-int-sqlite`
 - Run integration tests (Postgres): `just test-int-postgres`
-- Run impacted tests: `just testmon` (pytest-testmon; only tests affected by changed code)
+- Run impacted tests: `just fast-test` or `just testmon` (pytest-testmon; only tests affected by changed code)
 - Run MCP smoke test: `just test-smoke`
-- Fast local loop: `just fast-check` (default iteration flow)
+- Fast static check: `just fast-check` (fix, format, typecheck)
+- Fast test loop: `just fast-test` (pytest-testmon impacted tests)
 - Local consistency check: `just doctor`
 - Run all consolidated agent package checks: `just package-check`
 - Run Claude Code plugin checks: `just package-check-claude-code`
@@ -39,7 +40,7 @@ See the [README.md](README.md) file for a project overview.
 - Type check: `just typecheck` or `uv run ty check src tests test-int`
 - Type check (pyright): `just typecheck-pyright` or `uv run pyright`
 - Format: `just format` or `uv run ruff format .`
-- Run all code checks: `just check` (runs lint, format, typecheck, test)
+- Run all static code checks: `just check` (runs lint, format, typecheck)
 - Create db migration: `just migration "Your migration message"`
 - Run development MCP Inspector: `just run-inspector`
 
@@ -54,10 +55,11 @@ See the [README.md](README.md) file for a project overview.
 ### Code/Test/Verify Loop (fast path)
 
 1) **Code:** make changes.
-2) **Test:** `just fast-check` (lint/format/typecheck + pytest-testmon impacted tests for changed code).
-3) **Verify:** `just doctor` (end-to-end file ↔ DB loop in a temp project).
-4) **Package verify:** `just package-check` when changes touch `plugins/`, `skills/`, `integrations/`, package metadata, or release wiring.
-5) **Full gate (when needed):** `just test` or `just check` for SQLite + Postgres.
+2) **Check:** `just fast-check` (fix, format, typecheck; no tests).
+3) **Test:** `just fast-test` for pytest-testmon impacted tests, or a targeted `uv run pytest ...` command.
+4) **Verify:** `just doctor` (end-to-end file ↔ DB loop in a temp project).
+5) **Package verify:** `just package-check` when changes touch `plugins/`, `skills/`, `integrations/`, package metadata, or release wiring.
+6) **Full gate (when needed):** `just test` for SQLite + Postgres.
 
 Run `just test-smoke` when you specifically need the MCP smoke flow.
 

benchmarks/src/basic_memory_benchmarks/cli.py

@@ -153,7 +153,9 @@ def convert_structure_corpus(
         max_workers=max_workers,
     )
 
-    console.print(f"Structured ([green]{mode}[/green]): [cyan]{output_dir}[/cyan] ({doc_count} docs)")
+    console.print(
+        f"Structured ([green]{mode}[/green]): [cyan]{output_dir}[/cyan] ({doc_count} docs)"
+    )
     console.print(f"Extractor: [green]{extractor}[/green]")
     if cats:
         console.print(f"Filtered to categories: {sorted(cats)}")

benchmarks/src/basic_memory_benchmarks/models.py

@@ -177,8 +177,12 @@ class ProviderDiagnosis(BaseModel):
     truly_missed: int = 0
     # Derived shares over answerable questions (0.0 when answerable == 0):
     qa_accuracy: float = 0.0  # correct / answerable
-    retrieval_ceiling: float = 0.0  # (correct + retrieved_but_unused) / answerable — max QA if answerer were perfect
-    answerer_gap: float = 0.0  # retrieved_but_unused / answerable — headroom left on the table by the answerer
+    retrieval_ceiling: float = (
+        0.0  # (correct + retrieved_but_unused) / answerable — max QA if answerer were perfect
+    )
+    answerer_gap: float = (
+        0.0  # retrieved_but_unused / answerable — headroom left on the table by the answerer
+    )
     retrieval_gap: float = 0.0  # truly_missed / answerable — headroom that needs better retrieval
     answerer_failure_share: float = 0.0  # retrieved_but_unused / (answerable failures) — of what we got wrong, how much was the answerer
     recall_field: str = "recall_at_10"

benchmarks/src/basic_memory_benchmarks/scoring/diagnose.py

@@ -128,8 +128,6 @@ def diagnose_run(
             seen.add(case.provider)
             providers.append(case.provider)
     return [
-        diagnose_provider(
-            qa_cases, retrieval_rows, provider=provider, recall_field=recall_field
-        )
+        diagnose_provider(qa_cases, retrieval_rows, provider=provider, recall_field=recall_field)
         for provider in providers
     ]

benchmarks/test-int/test_compare_regression.py

@@ -3,7 +3,10 @@
 
 import pytest
 
-from basic_memory_benchmarks.reporting.compare import compare_provider_metric, load_retrieval_summary
+from basic_memory_benchmarks.reporting.compare import (
+    compare_provider_metric,
+    load_retrieval_summary,
+)
 
 
 def test_compare_provider_metric(tmp_path: Path) -> None:

benchmarks/test-int/test_runner_orchestration.py

@@ -21,7 +21,11 @@ def search(self, query: str, limit: int, run_config: RunConfig) -> list[SearchHi
         doc_id = self.mapping.get(query)
         if not doc_id:
             return []
-        return [SearchHit(source_doc_id=doc_id, source_path=f"docs/{doc_id}.md", text="match", score=1.0)]
+        return [
+            SearchHit(
+                source_doc_id=doc_id, source_path=f"docs/{doc_id}.md", text="match", score=1.0
+            )
+        ]
 
     def cleanup(self, run_config: RunConfig) -> None:
         _ = run_config