Spec — Modèle de Graphe Meta KG

Champs communs des nœuds

{
  "id": "uuid",
  "graph_version_id": "uuid",
  "namespace": "code|data|vector|runtime|tests|doc",
  "node_type": "api_endpoint",
  "name": "POST /api/query",
  "qualified_name": "syl2042/Aurora-Nexus:api/routes/query.py::POST /api/query",
  "source_app": "developpement",
  "workspace": "Aurora Nexus",
  "project": "backend",
  "repo_full_name": "syl2042/Aurora-Nexus",
  "branch": "main",
  "commit_sha": "...",
  "path": "api/routes/query.py",
  "start_line": 10,
  "end_line": 80,
  "metadata": {}
}

Champs communs des relations

{
  "id": "uuid",
  "graph_version_id": "uuid",
  "source_node_id": "uuid",
  "target_node_id": "uuid",
  "edge_type": "READS_TABLE",
  "confidence": 0.85,
  "evidence": {
    "type": "ast_match|regex_match|sql_parse|openapi_match|manual",
    "path": "api/routes/query.py",
    "line_start": 120,
    "line_end": 140,
    "matched_text": "documents"
  }
}

Nœuds code

repository, branch, commit, directory, file, python_module, typescript_module, class, function, method, api_endpoint, react_page, react_component, hook.

Nœuds data

postgres_database, postgres_schema, postgres_table, postgres_column, postgres_index, postgres_fk, migration, view, enum_or_constraint.

Nœuds vector

qdrant_instance, qdrant_collection, vector_field, payload_field, embedding_model, retriever, point_group.

Relations principales

CONTAINS, IMPORTS, DEFINES, EXPOSES_ENDPOINT, HANDLES_ENDPOINT, USES_COMPONENT, USES_HOOK, TESTED_BY, TABLE_HAS_COLUMN, TABLE_REFERENCES_TABLE, MIGRATION_CREATES_TABLE, CODE_READS_TABLE, CODE_WRITES_TABLE, CODE_QUERIES_COLLECTION, PAYLOAD_FIELD_MAPS_TO_COLUMN.

Règles de qualité

• Les nœuds doivent être idempotents pour un même graph_version.
• Les relations faibles doivent avoir confidence < 0.8.
• Les relations utilisées dans un context pack doivent contenir evidence.
• Une relation sans evidence est acceptable uniquement si elle est structurelle et déterministe, par exemple CONTAINS.