Spec — API Meta KG

Base path

/api/meta-kg

Endpoints V0

POST /api/meta-kg/search

Recherche des nœuds candidats.

POST /api/meta-kg/expand

Expansion bornée autour de nœuds.

POST /api/meta-kg/context-pack

Endpoint principal.

Request :

{
  "query": "ajouter workspace_id dans la recherche documentaire",
  "scope": {
    "source_app": "developpement",
    "workspace": "Aurora Nexus"
  },
  "budget_tokens": 20000,
  "format": "json"
}

Response :

{
  "summary": "...",
  "recommended_files": [],
  "endpoints": [],
  "tables": [],
  "qdrant_collections": [],
  "tests": [],
  "risks": [],
  "evidence": [],
  "recommended_commands": []
}

POST /api/meta-kg/impact

Analyse d’impact.

GET /api/meta-kg/nodes/{node_id}

Retourne détail nœud.

GET /api/meta-kg/edges/{edge_id}/evidence

Retourne preuve relation.

POST /api/meta-kg/repositories/scan

Lance scan/indexation.

GET /api/meta-kg/index-jobs/{job_id}

Statut job.

Auth & permissions

• Scan/rebuild : admin.
• Search/context-pack : utilisateur authentifié avec scope.
• Les filtres source_app/workspace/project doivent être appliqués.
• Les secrets et valeurs sensibles ne doivent jamais être retournés.