agnes-the-ai-analyst/app/api/catalog.py

122 lines
4.1 KiB
Python

"""Catalog endpoints — table profiles, metrics."""
import json
import os
import re
from pathlib import Path
from fastapi import APIRouter, Depends, HTTPException
import duckdb
import yaml
from app.auth.dependencies import get_current_user, _get_db
from src.repositories.profiles import ProfileRepository
from src.rbac import can_access_table
router = APIRouter(prefix="/api/catalog", tags=["catalog"])
def _get_data_dir() -> Path:
return Path(os.environ.get("DATA_DIR", "./data"))
@router.get("/profile/{table_name}")
async def get_table_profile(
table_name: str,
user: dict = Depends(get_current_user),
conn: duckdb.DuckDBPyConnection = Depends(_get_db),
):
"""Get profiler data for a specific table."""
repo = ProfileRepository(conn)
profile = repo.get(table_name)
if not profile:
# Fallback: try loading from profiles.json on disk
profiles_path = _get_data_dir() / "src_data" / "metadata" / "profiles.json"
if profiles_path.exists():
try:
all_profiles = json.loads(profiles_path.read_text())
tables = all_profiles.get("tables", all_profiles)
if table_name in tables:
return tables[table_name]
except Exception:
pass
raise HTTPException(status_code=404, detail=f"Profile not found for '{table_name}'")
return profile
@router.get("/tables")
async def list_catalog_tables(
user: dict = Depends(get_current_user),
conn: duckdb.DuckDBPyConnection = Depends(_get_db),
):
"""List all available tables from table_registry."""
from src.repositories.table_registry import TableRegistryRepository
repo = TableRegistryRepository(conn)
all_tables = repo.list_all()
# Filter by user's accessible tables (admin sees all)
if user.get("role") != "admin":
all_tables = [t for t in all_tables if can_access_table(user, t["id"], conn)]
tables = [
{
"id": t["id"],
"name": t["name"],
"description": t.get("description"),
"source_type": t.get("source_type"),
"sync_strategy": t.get("sync_strategy"),
"query_mode": t.get("query_mode", "local"),
}
for t in all_tables
]
return {"tables": tables, "count": len(tables)}
@router.get("/metrics/{metric_path:path}")
async def get_metric(
metric_path: str,
user: dict = Depends(get_current_user),
):
"""Get a metric YAML definition parsed as structured JSON."""
if not re.match(r"^[a-z_]+/[a-z_]+\.yml$", metric_path):
raise HTTPException(status_code=400, detail="Invalid metric path")
docs_dir = _get_data_dir() / "docs" / "metrics"
file_path = docs_dir / metric_path
if not file_path.is_file():
raise HTTPException(status_code=404, detail="Metric file not found")
# Security: ensure path doesn't escape docs dir
if not file_path.resolve().is_relative_to(docs_dir.resolve()):
raise HTTPException(status_code=400, detail="Invalid path")
try:
content = yaml.safe_load(file_path.read_text())
return content
except Exception as e:
raise HTTPException(status_code=500, detail=f"Error parsing metric: {e}")
@router.post("/profile/{table_name}/refresh")
async def refresh_profile(
table_name: str,
user: dict = Depends(get_current_user),
conn: duckdb.DuckDBPyConnection = Depends(_get_db),
):
"""Re-generate profile for a table on demand."""
from src.profiler import profile_table, TableInfo
data_dir = _get_data_dir()
extracts_dir = data_dir / "extracts"
candidates = list(extracts_dir.rglob(f"data/{table_name}.parquet"))
if not candidates:
raise HTTPException(status_code=404, detail=f"No parquet for '{table_name}'")
try:
table_info = TableInfo(name=table_name, table_id=table_name)
profile = profile_table(table_info, candidates[0], [], {}, {})
ProfileRepository(conn).save(table_name, profile)
return {"status": "ok", "table": table_name, "columns": len(profile.get("columns", {}))}
except Exception as e:
raise HTTPException(status_code=500, detail=f"Profile failed: {e}")