core-runtime 0.1.1__py3-none-any.whl

api/cli/fix_client.py

@@ -0,0 +1,101 @@
+# src/api/cli/fix_client.py
+
+"""Fix namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/fix/* and /v1/actions. Accessed via the facade as
+`core_api_client.fix`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 8ae59396-5ea3-4b83-8753-d2a0b1eadb27
+class FixClient:
+    """Sub-client for /fix/* and /actions endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: fb719d93-d058-4517-8818-7e86a12ad43c
+    async def list_fix_commands(self) -> dict:
+        """GET /v1/fix/commands — list registered fix commands."""
+        return await self._facade._request("GET", "/v1/fix/commands")
+
+    # ID: 5e2aa721-01af-4244-8d23-f0e72909cd17
+    async def list_actions(self) -> dict:
+        """GET /v1/actions — list all registered atomic actions."""
+        return await self._facade._request("GET", "/v1/actions")
+
+    # ID: 4a4c82b7-63fe-4076-b07f-3b6d55c0a265
+    async def run_fix(
+        self,
+        fix_id: str,
+        target_files: list[str] | None = None,
+        write: bool = False,
+        params: dict[str, Any] | None = None,
+    ) -> dict:
+        """POST /v1/fix/run/{fix_id} — dispatch a registered fix action.
+
+        `params` carries action-specific kwargs (e.g. fix.docstrings's
+        `limit`); forwarded to ActionExecutor as **kwargs.
+        """
+        return await self._facade._request(
+            "POST",
+            f"/v1/fix/run/{fix_id}",
+            json={
+                "target_files": target_files or [],
+                "write": write,
+                "params": params or {},
+            },
+        )
+
+    # ID: fa36d0ec-f588-43dc-a46e-2a1b1ced8799
+    async def fix_all(self, write: bool = False) -> dict:
+        """POST /v1/fix/all — run the curated flow.fix_code sequence."""
+        return await self._facade._request(
+            "POST",
+            "/v1/fix/all",
+            json={"write": write},
+        )
+
+    # ID: 861f09ab-deef-4c29-9870-6d21c4b3a4ba
+    async def fix_modularity(
+        self,
+        write: bool = False,
+        params: dict[str, Any] | None = None,
+    ) -> dict:
+        """POST /v1/fix/modularity — trigger modularity remediation.
+
+        `params` carries kwargs forwarded to
+        will.self_healing.ModularityRemediationService.remediate_batch
+        (e.g. `min_score`, `limit`).
+        """
+        return await self._facade._request(
+            "POST",
+            "/v1/fix/modularity",
+            json={"write": write, "params": params or {}},
+        )
+
+    # ID: 4691876d-3fd5-4449-a038-0894480f286f
+    async def fix_ir(self, kind: str) -> dict:
+        """POST /v1/fix/ir — scaffold an IR YAML file (triage or log)."""
+        return await self._facade._request(
+            "POST",
+            "/v1/fix/ir",
+            json={"kind": kind},
+        )
+
+    # ID: 037af02f-fbaf-4da8-8746-c8b9a28b4432
+    async def get_fix_run(self, run_id: str) -> dict:
+        """GET /v1/fix/runs/{run_id} — fetch a fix run's status and result."""
+        return await self._facade._request("GET", f"/v1/fix/runs/{run_id}")

api/cli/inspect_client.py

@@ -0,0 +1,143 @@
+# src/api/cli/inspect_client.py
+
+"""Inspect namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/status/*, /v1/decisions/*, /v1/refusals/*, /v1/analysis/*,
+/v1/components, /v1/search/*. Accessed via the facade as
+`core_api_client.inspect`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 90a0cd13-bae3-49f4-b7e6-156ed056fd8a
+class InspectClient:
+    """Sub-client for read-only introspection endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: a89090e1-2710-41cc-ab63-444d2f79a527
+    async def status_db(self) -> dict:
+        """GET /v1/status/db — DB connection and schema state."""
+        return await self._facade._request("GET", "/v1/status/db")
+
+    # ID: 7b664840-00e9-4877-accd-e4e46662213b
+    async def status_drift(self, scope: str = "all") -> dict:
+        """GET /v1/status/drift — consolidated drift snapshot."""
+        return await self._facade._request(
+            "GET", "/v1/status/drift", params={"scope": scope}
+        )
+
+    # ID: d810fc7f-d21e-4200-8678-9ba090ae36de
+    async def decisions_list(
+        self,
+        session_id: str | None = None,
+        agent: str | None = None,
+        pattern: str | None = None,
+        limit: int = 50,
+    ) -> dict:
+        """GET /v1/decisions — recent decision traces."""
+        params: dict[str, Any] = {"limit": limit}
+        if session_id is not None:
+            params["session_id"] = session_id
+        if agent is not None:
+            params["agent"] = agent
+        if pattern is not None:
+            params["pattern"] = pattern
+        return await self._facade._request("GET", "/v1/decisions", params=params)
+
+    # ID: 423afac1-a466-4fd7-b94a-66aad65daf4b
+    async def decisions_patterns(self, days: int = 7) -> dict:
+        """GET /v1/decisions/patterns — pattern classification stats."""
+        return await self._facade._request(
+            "GET", "/v1/decisions/patterns", params={"days": days}
+        )
+
+    # ID: c1576944-7180-424c-bc89-33e8eb3db2c2
+    async def refusals_list(
+        self,
+        refusal_type: str | None = None,
+        session_id: str | None = None,
+        limit: int = 50,
+    ) -> dict:
+        """GET /v1/refusals — recent constitutional refusals."""
+        params: dict[str, Any] = {"limit": limit}
+        if refusal_type is not None:
+            params["type"] = refusal_type
+        if session_id is not None:
+            params["session"] = session_id
+        return await self._facade._request("GET", "/v1/refusals", params=params)
+
+    # ID: 38395049-6fb9-4799-b2b6-8628a3c356a5
+    async def refusals_stats(self, days: int = 7) -> dict:
+        """GET /v1/refusals/stats — refusal statistics by type."""
+        return await self._facade._request(
+            "GET", "/v1/refusals/stats", params={"days": days}
+        )
+
+    # ID: 9527b482-c9c3-4504-b2e4-cc2ccfcc1108
+    async def analysis_clusters(self, limit: int = 25) -> dict:
+        """GET /v1/analysis/clusters — semantic capability clusters."""
+        return await self._facade._request(
+            "GET", "/v1/analysis/clusters", params={"limit": limit}
+        )
+
+    # ID: 4d56c093-8ded-41c4-bac5-5ef25c89b44e
+    async def analysis_duplicates(self, threshold: float = 0.85) -> dict:
+        """GET /v1/analysis/duplicates — semantic code duplication candidates."""
+        return await self._facade._request(
+            "GET",
+            "/v1/analysis/duplicates",
+            params={"threshold": threshold},
+            timeout=300.0,
+        )
+
+    # ID: ac51a548-13b9-4f27-95d3-b0e1b393ea32
+    async def analysis_common_knowledge(self, limit: int = 25) -> dict:
+        """GET /v1/analysis/common-knowledge — DRY-violation candidates."""
+        return await self._facade._request(
+            "GET", "/v1/analysis/common-knowledge", params={"limit": limit}
+        )
+
+    # ID: 2ee57341-aa70-482d-beca-b32d17fe8c02
+    async def analysis_command_tree(self) -> dict:
+        """GET /v1/analysis/command-tree — introspected CLI command hierarchy."""
+        return await self._facade._request("GET", "/v1/analysis/command-tree")
+
+    # ID: ddb23eeb-0bcf-4bdf-9d19-a5e1ed6aa1b7
+    async def analysis_test_targets(self) -> dict:
+        """GET /v1/analysis/test-targets — SIMPLE/COMPLEX test target classification."""
+        return await self._facade._request("GET", "/v1/analysis/test-targets")
+
+    # ID: e677a202-2558-4dd1-9a98-12391ce721d2
+    async def inspect_components(self, filter_type: str | None = None) -> dict:
+        """GET /v1/components — V2 component inventory (ADR-057 D5)."""
+        params: dict[str, Any] = {}
+        if filter_type is not None:
+            params["type"] = filter_type
+        return await self._facade._request("GET", "/v1/components", params=params)
+
+    # ID: 28f208bc-36bf-4335-b245-a02d2eecacdd
+    async def inspect_search_capabilities(self, q: str, limit: int = 10) -> dict:
+        """GET /v1/search/capabilities — semantic capability search (ADR-057 D5)."""
+        return await self._facade._request(
+            "GET", "/v1/search/capabilities", params={"q": q, "limit": limit}
+        )
+
+    # ID: e94ca5cb-534b-4d96-bc2a-a18ab6caf63f
+    async def inspect_search_commands(self, q: str, limit: int = 25) -> dict:
+        """GET /v1/search/commands — fuzzy substring search over the CLI registry (ADR-057 D5)."""
+        return await self._facade._request(
+            "GET", "/v1/search/commands", params={"q": q, "limit": limit}
+        )

api/cli/integration_client.py

@@ -0,0 +1,42 @@
+# src/api/cli/integration_client.py
+
+"""Integration namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/integrate and /v1/lint. Accessed via the facade as
+`core_api_client.integration`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: c3f4b99b-4a50-4b27-ae4a-124e80158523
+class IntegrationClient:
+    """Sub-client for /integrate and /lint endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: 6ffecf82-ab85-4571-abb0-c666da7a7b6a
+    async def integrate(self, commit_message: str) -> dict:
+        """POST /v1/integrate — stage, format, lint, and commit working-tree changes."""
+        return await self._facade._request(
+            "POST",
+            "/v1/integrate",
+            json={"commit_message": commit_message},
+            timeout=300.0,
+        )
+
+    # ID: 0c7ef9a9-17ca-4003-90c1-d390297efb16
+    async def lint(self) -> dict:
+        """POST /v1/lint — run black --check and ruff check on src/ and tests/."""
+        return await self._facade._request("POST", "/v1/lint", timeout=300.0)

api/cli/integrity_client.py

@@ -0,0 +1,45 @@
+# src/api/cli/integrity_client.py
+
+"""Integrity namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/integrity/* (ADR-055 D6 follow-up, #353). Accessed via the
+facade as `core_api_client.integrity`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 6f3a9345-83a9-4199-a52f-4d032e2883a1
+class IntegrityClient:
+    """Sub-client for /integrity/* endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: 6afef209-3b8c-4dfd-93da-006cb0576106
+    async def baseline(self, label: str = "default") -> dict:
+        """POST /v1/integrity/baseline — SHA256-fingerprint src/."""
+        return await self._facade._request(
+            "POST",
+            "/v1/integrity/baseline",
+            json={"label": label},
+        )
+
+    # ID: deeb12f0-a8e1-4b5e-81da-d3fa945dcbf8
+    async def verify(self, label: str = "default") -> dict:
+        """POST /v1/integrity/verify — diff src/ against a named baseline."""
+        return await self._facade._request(
+            "POST",
+            "/v1/integrity/verify",
+            json={"label": label},
+        )

api/cli/proposals_client.py

@@ -0,0 +1,101 @@
+# src/api/cli/proposals_client.py
+
+"""Proposals namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/proposals/*. Accessed via the facade as
+`core_api_client.proposals`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 8472ad98-79a0-4b7e-91bf-1dda947c3d0a
+class ProposalsClient:
+    """Sub-client for /proposals/* endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: 3bc55abf-2046-473c-9f77-9e0db3525a02
+    async def create_proposal(
+        self,
+        goal: str,
+        actions: list[dict] | None = None,
+        files: list[str] | None = None,
+        created_by: str = "cli_operator",
+        write: bool = True,
+    ) -> dict:
+        """POST /v1/proposals — create a new proposal (dry-run when write=False)."""
+        return await self._facade._request(
+            "POST",
+            "/v1/proposals",
+            json={
+                "goal": goal,
+                "actions": actions or [],
+                "files": files or [],
+                "created_by": created_by,
+                "write": write,
+            },
+        )
+
+    # ID: 0c3fd55c-ae4a-477b-9f59-2fe5c64ccc2c
+    async def list_proposals(
+        self,
+        status: str | None = None,
+        limit: int = 50,
+    ) -> dict:
+        """GET /v1/proposals — list proposals, optionally filtered by status."""
+        params: dict = {"limit": limit}
+        if status is not None:
+            params["status"] = status
+        return await self._facade._request("GET", "/v1/proposals", params=params)
+
+    # ID: c45e1e26-7004-4961-a912-fcc6bf58997a
+    async def get_proposal(self, proposal_id: str) -> dict:
+        """GET /v1/proposals/{id} — fetch a single proposal by id."""
+        return await self._facade._request("GET", f"/v1/proposals/{proposal_id}")
+
+    # ID: bd72561f-494c-43d1-80f5-b0b3bf13a143
+    async def approve_proposal(
+        self,
+        proposal_id: str,
+        approved_by: str,
+        approval_authority: str,
+    ) -> dict:
+        """POST /v1/proposals/{id}/approve — authorize a proposal for execution."""
+        return await self._facade._request(
+            "POST",
+            f"/v1/proposals/{proposal_id}/approve",
+            json={
+                "approved_by": approved_by,
+                "approval_authority": approval_authority,
+            },
+        )
+
+    # ID: 0d896778-608e-4ae5-93e2-449c9d2421a7
+    async def reject_proposal(self, proposal_id: str, reason: str) -> dict:
+        """POST /v1/proposals/{id}/reject — reject a proposal with a reason."""
+        return await self._facade._request(
+            "POST",
+            f"/v1/proposals/{proposal_id}/reject",
+            json={"reason": reason},
+        )
+
+    # ID: 181068f0-dc97-4d46-95b3-b8bb9c2f3d86
+    async def execute_proposal(self, proposal_id: str, write: bool = False) -> dict:
+        """POST /v1/proposals/{id}/execute — execute an approved proposal."""
+        return await self._facade._request(
+            "POST",
+            f"/v1/proposals/{proposal_id}/execute",
+            json={"write": write},
+        )

api/cli/quality_client.py

@@ -0,0 +1,83 @@
+# src/api/cli/quality_client.py
+
+"""Quality namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/quality/*. Accessed via the facade as `core_api_client.quality`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 2e3200fc-86e0-4f95-9a1b-83b2ccfd2ec6
+class QualityClient:
+    """Sub-client for /quality/* endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: 4f8fbaeb-0a08-45b9-b38a-dab3039b56c0
+    async def quality_imports(self, target_files: list[str] | None = None) -> dict:
+        """POST /v1/quality/imports — synchronous import-resolution check."""
+        return await self._facade._request(
+            "POST",
+            "/v1/quality/imports",
+            json={"target_files": target_files or []},
+        )
+
+    # ID: 49bfd745-751c-4e87-8fc5-175acca51511
+    async def quality_body_ui(self, target_files: list[str] | None = None) -> dict:
+        """POST /v1/quality/body-ui — synchronous Body-layer UI contract check."""
+        return await self._facade._request(
+            "POST",
+            "/v1/quality/body-ui",
+            json={"target_files": target_files or []},
+        )
+
+    # ID: 48a167ac-14f3-4b84-9b73-94eaf4a430d0
+    async def quality_policy_coverage(self) -> dict:
+        """POST /v1/quality/policy-coverage — sync constitutional policy-coverage audit.
+
+        Returns the flattened PolicyCoverageReport: {report_id,
+        generated_at_utc, repo_root, summary, records, exit_code}.
+        """
+        return await self._facade._request(
+            "POST", "/v1/quality/policy-coverage", json={}
+        )
+
+    # ID: b1809257-a30c-4629-b064-dcad6b592c5d
+    async def quality_lint(self, fix: bool = False) -> dict:
+        """POST /v1/quality/lint — async ruff lint run (fix=true applies --fix)."""
+        return await self._facade._request(
+            "POST",
+            "/v1/quality/lint",
+            json={"fix": fix},
+        )
+
+    # ID: 762057fc-0a60-4c1c-afb6-f9e3502d5f90
+    async def quality_tests(self, path: str | None = None) -> dict:
+        """POST /v1/quality/tests — async pytest run."""
+        return await self._facade._request(
+            "POST",
+            "/v1/quality/tests",
+            json={"path": path},
+        )
+
+    # ID: bd7db7b5-4e78-4ddb-82ed-8c5b6eda3742
+    async def quality_system(self) -> dict:
+        """POST /v1/quality/system — async lint + tests + audit bundle."""
+        return await self._facade._request("POST", "/v1/quality/system", json={})
+
+    # ID: aea726cc-5ef4-493b-9068-db8cb6b08f9c
+    async def quality_gates(self) -> dict:
+        """POST /v1/quality/gates — async six-gate quality bundle."""
+        return await self._facade._request("POST", "/v1/quality/gates", json={})

api/cli/refactor_client.py

@@ -0,0 +1,82 @@
+# src/api/cli/refactor_client.py
+
+"""Refactor namespace sub-client for CoreApiClient (issue #360).
+
+Covers /v1/refactor/*. Accessed via the facade as
+`core_api_client.refactor`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+
+if TYPE_CHECKING:
+    from api.cli.client import CoreApiClient
+
+
+# ID: 784ad541-c8a0-4d7c-baac-7788034b5a7d
+class RefactorClient:
+    """Sub-client for /refactor/* endpoints.
+
+    Constructed by and bound to a CoreApiClient facade; uses
+    `self._facade._request` for HTTP and `self._facade._poll_at_path`
+    for polling.
+    """
+
+    def __init__(self, facade: CoreApiClient) -> None:
+        self._facade = facade
+
+    # ID: ebcc6da1-83a3-421d-943a-db1933bda593
+    async def refactor_threshold(self) -> dict:
+        """GET /v1/refactor/threshold — constitutional modularity threshold."""
+        return await self._facade._request("GET", "/v1/refactor/threshold")
+
+    # ID: dd32d723-a1e2-465a-95ae-ad6ff6692418
+    async def refactor_score(self, file: str) -> dict:
+        """GET /v1/refactor/score?file= — per-file modularity score."""
+        return await self._facade._request(
+            "GET", "/v1/refactor/score", params={"file": file}
+        )
+
+    # ID: d2f20f4b-514b-45a2-b088-85183a6b67a2
+    async def refactor_candidates(
+        self,
+        min_score: float | None = None,
+        limit: int = 50,
+    ) -> dict:
+        """GET /v1/refactor/candidates — files exceeding modularity threshold."""
+        params: dict[str, Any] = {"limit": limit}
+        if min_score is not None:
+            params["min_score"] = min_score
+        return await self._facade._request(
+            "GET", "/v1/refactor/candidates", params=params, timeout=300.0
+        )
+
+    # ID: d271251e-04de-44f3-933c-ba5d3c87bef6
+    async def refactor_stats(self) -> dict:
+        """GET /v1/refactor/stats — aggregate modularity distribution."""
+        return await self._facade._request("GET", "/v1/refactor/stats", timeout=300.0)
+
+    # ID: b134eb49-2581-4db0-abd7-1fc4cffac28a
+    async def refactor_autonomous(self, goal: str, write: bool = False) -> dict:
+        """POST /v1/refactor/autonomous — trigger A3 autonomous refactor cycle."""
+        return await self._facade._request(
+            "POST",
+            "/v1/refactor/autonomous",
+            json={"goal": goal, "write": write},
+        )
+
+    # ID: 2914d738-7f45-407c-970f-2eb8767dd4eb
+    async def get_refactor_run(self, run_id: str) -> dict:
+        """GET /v1/refactor/runs/{run_id} — fetch a refactor_runs row."""
+        return await self._facade._request("GET", f"/v1/refactor/runs/{run_id}")
+
+    # ID: 63614394-1f03-4643-b5bf-bdf7603b80fa
+    async def poll_refactor_run(
+        self, run_id: str, timeout_seconds: float = 1800.0
+    ) -> dict:
+        """Poll a refactor run until terminal. A3 loops can take minutes."""
+        return await self._facade._poll_at_path(
+            f"/v1/refactor/runs/{run_id}", timeout_seconds=timeout_seconds
+        )