rmi-backend/app/_archive/legacy_2026_07/api_versioning.py
cryptorugmunch 628c1d2a10
Some checks failed
CI / build (push) Failing after 3s
refactor(rmi-backend,audit): mount Wave 3 + archive 136 dead-code files (P2.3)
PHASE 2.3 (AUDIT-2026-Q3.md):

Task 1 — Wire-in Wave 3 (1 router mounted, 2 deferred):
  - app.routers.unified_scanner_router mounted at /api/v2/scanner/* (2 routes:
    POST /api/v2/scanner/token/scan, POST /api/v2/scanner/wallet/scan).
    Refactored prefix from /api/v2 -> /api/v2/scanner to avoid future conflicts
    with the v1 /api/v1/scanner/ stub.
  - app.routers.unified_wallet_scanner DEFERRED (no router APIRouter attribute;
    library module consumed by unified_scanner_router via get_wallet_scanner()).
  - app.routers.admin_extensions DEFERRED (DORMANT per audit; 25 routes at
    /api/v1/admin/* would shadow /api/v1/admin/alerts_webhook).

Task 2 — Archive 136 dead-code files to app/_archive/legacy_2026_07/:
  - 73 routers in app/routers/ (reach graph showed zero reach into mount.py).
  - 63 flat app/*.py (domain modules never imported by live code).
  - 1 file RESTORED post-archive: app/routers/x402_bridge_health.py (caught by
    tests/unit/test_bridge_health.py which directly imports it; reach graph
    considered tests/ only as transitive reach — to be patched in next cycle).

Forced-LIVE (NOT archived per user directive):
  - app/ai_pipeline_v3.py  (3 importers in audit window, importers themselves DEAD)
  - app/splade_bm25.py       (LIVE via app.rag_service)
  - app/wallet_manager_v2.py (LIVE via x402_enforcement, x402_tools, sweep_all, sweep_now)
  - app/crypto_embeddings.py (NOT in audit ARCHIVE list; heavy import graph)

Verification (forward-import closure from mount.py + main.py + factory.py + lifespan.py):
  - imports = 348 app.* modules
  - reached = 194 files reachable from roots
  - archive set = audit_dead (186) - reached - forced_live (4) - test_live (1) = 136
  - Net delta: 136 files moved, 44,932 LOC reduction, 293->295 active routes (+2 from Wave 3)

pyproject.toml updates:
  - setuptools.packages.find: added exclude for app._archive*
  - ruff.extend-exclude: added "app/_archive/"
  - mypy.exclude: added "app/_archive/"

Smoke test: pytest tests/ — 817 passed, 3 pre-existing failures unchanged
(0 new failures; 0 routes lost; all 4 forced-LIVE files still importable).

Restoration: git mv app/_archive/legacy_2026_07/<name>.py <original-path>
and add the import to app/mount.py ROUTER_MODULES.

Refs: AUDIT-2026-Q3.md /home/dev/pry/rmi-final-deadcode-2026-07-06.md
2026-07-06 20:52:31 +02:00

49 lines
1.5 KiB
Python

"""API versioning router for RMI Backend."""
from fastapi import APIRouter, Request
router = APIRouter(prefix="", tags=["api-versioning"])
DEPRECATED_PATHS: dict[str, str] = {}
@router.get("/api/version")
async def api_version():
"""Return current API version info."""
return {
"versions": {"v1": {"status": "stable"}, "v2": {"status": "planned"}},
"current": "v1",
"docs": "/docs",
}
@router.get("/api")
async def api_root():
"""API root with version links."""
return {
"message": "RugMunch Intelligence API",
"versions": {"v1": "/api/v1/", "v2": "/api/v2/ (planned)"},
"docs": {"swagger": "/docs", "redoc": "/redoc", "openapi": "/openapi.json"},
"health": "/health",
"metrics": "/metrics",
}
def register_deprecation(path: str, new_path: str) -> None:
"""Register a deprecated path for sunset headers."""
DEPRECATED_PATHS[path] = new_path
def setup_deprecation_middleware(app):
"""Add deprecation headers middleware to the FastAPI app."""
@app.middleware("http")
async def _deprecation(request: Request, call_next):
path = request.url.path
if path in DEPRECATED_PATHS:
response = await call_next(request)
response.headers["Deprecation"] = "true"
response.headers["Sunset"] = "Sat, 01 Jan 2027 00:00:00 GMT"
response.headers["Link"] = f'<{DEPRECATED_PATHS[path]}>; rel="successor-version"'
return response
return await call_next(request)