Implements the hub side of the shared reuse-event schema (already drafted in WP-0018-T01, schemas/reuse-event.schema.json): a SQLite reuse_events table, POST /v1/reuse-events (token-auth), GET /v1/reuse-events?capability_id= (read-only). reuse_surface/plan_check.py: refactored record_outcome around a new shared post_or_fallback_reuse_event() helper -- tries the hub first, falls back to the local JSONL only on failure/unreachability, never both. New record_manual_reuse_event() backs a new CLI command, reuse-surface record-reuse, for retroactive facts recorded outside plan-check. Privacy/scope (repo slugs and capability ids only, no code, no secrets) is enforced structurally via the schema's additionalProperties: false, not just by convention. 21 new pytest cases, 145 total pass. Live-verified against a real running hub instance: POST/GET /v1/reuse-events directly, record-reuse and plan-check --record-outcome both posting successfully to the hub, and -- after actually killing the hub process -- confirmed the fallback path writes correctly to the local JSONL instead of erroring. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
109 lines
No EOL
3.2 KiB
Python
109 lines
No EOL
3.2 KiB
Python
from __future__ import annotations
|
|
|
|
import json
|
|
import os
|
|
import urllib.error
|
|
import urllib.request
|
|
from typing import Any
|
|
|
|
|
|
def service_base_url(explicit: str | None = None) -> str:
|
|
base = (explicit or os.environ.get("REUSE_SURFACE_URL", "")).rstrip("/")
|
|
if not base:
|
|
raise ValueError(
|
|
"service URL not configured; set REUSE_SURFACE_URL or pass --base-url"
|
|
)
|
|
return base
|
|
|
|
|
|
def service_token() -> str | None:
|
|
return os.environ.get("REUSE_SURFACE_TOKEN")
|
|
|
|
|
|
def _request(
|
|
method: str,
|
|
url: str,
|
|
*,
|
|
token: str | None = None,
|
|
body: dict[str, Any] | None = None,
|
|
) -> tuple[int, Any]:
|
|
headers = {"Accept": "application/json", "User-Agent": "reuse-surface/0.1"}
|
|
data = None
|
|
if body is not None:
|
|
headers["Content-Type"] = "application/json"
|
|
data = json.dumps(body).encode("utf-8")
|
|
if token:
|
|
headers["Authorization"] = f"Bearer {token}"
|
|
request = urllib.request.Request(url, data=data, headers=headers, method=method)
|
|
try:
|
|
with urllib.request.urlopen(request, timeout=30) as response:
|
|
raw = response.read().decode("utf-8")
|
|
return response.status, json.loads(raw) if raw else None
|
|
except urllib.error.HTTPError as exc:
|
|
raw = exc.read().decode("utf-8")
|
|
try:
|
|
payload = json.loads(raw) if raw else {"message": exc.reason}
|
|
except json.JSONDecodeError:
|
|
payload = {"message": raw or exc.reason}
|
|
return exc.code, payload
|
|
|
|
|
|
def hub_status(base_url: str | None = None) -> tuple[int, Any]:
|
|
return _request("GET", f"{service_base_url(base_url)}/health")
|
|
|
|
|
|
def hub_list(base_url: str | None = None) -> tuple[int, Any]:
|
|
return _request("GET", f"{service_base_url(base_url)}/v1/repos")
|
|
|
|
|
|
def hub_show(repo: str, base_url: str | None = None) -> tuple[int, Any]:
|
|
return _request("GET", f"{service_base_url(base_url)}/v1/repos/{repo}")
|
|
|
|
|
|
def hub_register(payload: dict[str, Any], base_url: str | None = None) -> tuple[int, Any]:
|
|
token = service_token()
|
|
if not token:
|
|
raise ValueError("REUSE_SURFACE_TOKEN is required for register")
|
|
return _request(
|
|
"POST",
|
|
f"{service_base_url(base_url)}/v1/repos",
|
|
token=token,
|
|
body=payload,
|
|
)
|
|
|
|
|
|
def hub_update(
|
|
repo: str, payload: dict[str, Any], base_url: str | None = None
|
|
) -> tuple[int, Any]:
|
|
token = service_token()
|
|
if not token:
|
|
raise ValueError("REUSE_SURFACE_TOKEN is required for update")
|
|
return _request(
|
|
"PATCH",
|
|
f"{service_base_url(base_url)}/v1/repos/{repo}",
|
|
token=token,
|
|
body=payload,
|
|
)
|
|
|
|
|
|
def hub_record_reuse_event(
|
|
payload: dict[str, Any], base_url: str | None = None
|
|
) -> tuple[int, Any]:
|
|
token = service_token()
|
|
if not token:
|
|
raise ValueError("REUSE_SURFACE_TOKEN is required for record-reuse")
|
|
return _request(
|
|
"POST",
|
|
f"{service_base_url(base_url)}/v1/reuse-events",
|
|
token=token,
|
|
body=payload,
|
|
)
|
|
|
|
|
|
def hub_list_reuse_events(
|
|
capability_id: str | None = None, base_url: str | None = None
|
|
) -> tuple[int, Any]:
|
|
url = f"{service_base_url(base_url)}/v1/reuse-events"
|
|
if capability_id:
|
|
url += f"?capability_id={capability_id}"
|
|
return _request("GET", url) |