Reference

CLI Reference — topo

"Topo" is French for terrain survey — systematic reconnaissance of what is actually there. Every topo command executes a SPARQL operation against a local Oxigraph store. No server, no network. P4 (SPARQL-First, CLI-First, UI-Optional) applied. « Topo » désigne un relevé de terrain — reconnaissance systématique de ce qui existe réellement. Chaque commande topo exécute une opération SPARQL sur un store Oxigraph local. Aucun serveur, aucun réseau. P4 (SPARQL-First, CLI-First, UI-Optional) appliqué.

Shipped commands Commandes livrées

topo import <file.ttl> [--base <iri>]

DP-1Shipped

Load a Turtle, JSON-LD, or N-Triples file into the local Oxigraph store. Supports multiple files via --data flag. The store lives in memory for the duration of the session — no persistent state, no side effects. Charge un fichier Turtle, JSON-LD ou N-Triples dans le store Oxigraph local. Supporte plusieurs fichiers via le flag --data. Le store vit en mémoire le temps de la session — pas d'état persistant, pas d'effets de bord.

$ pnpm topo import si-model.ttl
# Loaded 142 triples from si-model.ttl

$ pnpm topo import data.ttl --data shapes.ttl --data vocab.ttl
# Loaded 3 files into the same store

topo query <file.rq | "SELECT ..."> [--data <file>] [--format <tsv|csv|turtle>]

DP-2Shipped

Execute a SPARQL query against loaded data. Accepts a .rq file or an inline SPARQL string. Supports SELECT, CONSTRUCT, ASK, DESCRIBE. Output defaults to TSV (tab-separated values) for SELECT, Turtle for CONSTRUCT. Exécute une requête SPARQL sur les données chargées. Accepte un fichier .rq ou une chaîne SPARQL inline. Supporte SELECT, CONSTRUCT, ASK, DESCRIBE. Sortie par défaut : TSV pour SELECT, Turtle pour CONSTRUCT.

# From a file
$ pnpm topo query queries/01-obsolete-apps.rq --data si-model.ttl

# Inline SPARQL
$ pnpm topo query "SELECT (COUNT(*) AS ?n) WHERE { ?s ?p ?o }" --data data.ttl

# Multiple data files
$ pnpm topo query analysis.rq --data model.ttl --data vocab.ttl --data shapes.ttl

topo gaps <data.ttl> [--shapes <shapes.ttl>] [--data <extra>] [--quiet]

NS-1Shipped

Detect knowledge gaps by running a suite of diagnostic SPARQL queries against the data. Default queries check for: agents without capabilities, orphan capabilities, agents without policies, unscoped agents, missing labels, disconnected entities, missing provenance, unreferenced shapes, and dangling collaboration URIs. Custom queries can be loaded from a .rq file via --shapes. Détecte les lacunes de connaissances en exécutant une suite de requêtes SPARQL diagnostiques sur les données. Les requêtes par défaut vérifient : agents sans capacités, capacités orphelines, agents sans politique, agents non scopés, labels manquants, entités déconnectées, provenance manquante, shapes non référencées et URIs de collaboration pendantes.

$ pnpm topo gaps ontologies/governance/agents/all-agents.ttl \
    --data ontologies/governance/agent-service-contract.ttl

# Gap report:
# Q1: Agents without capabilities     — 0 findings
# Q2: Orphan capabilities             — 2 findings
# Q3: Agents without policy            — 0 findings
# ...
# Q9c: Dangling collaboration URIs    — 1 finding

MCP Server

bra0 also exposes its capabilities as an MCP (Model Context Protocol) server with 14 tools. This enables AI agents (Claude, etc.) to query, validate, and modify bra0 Knowledge Spaces programmatically via the standard MCP protocol. bra0 expose également ses capacités comme un serveur MCP (Model Context Protocol) avec 14 outils. Cela permet aux agents IA (Claude, etc.) d'interroger, valider et modifier les Knowledge Spaces bra0 programmatiquement via le protocole MCP standard.

`sparql_query`	Execute SPARQL SELECT/ASK/CONSTRUCT
`sparql_update`	Execute SPARQL INSERT/DELETE
`shacl_validate`	Validate data against SHACL shapes
`rdf_import`	Load Turtle/JSON-LD/N-Triples
`rdf_export`	Export store as Turtle
`entity_create`	Create typed entity with properties
`knowledge_gaps`	Run gap detection queries
`provenance_export`	Export PROV-O activity log
`kg_context`	Extract context subgraph around an entity
`kg_blast_radius`	Compute change impact radius
`kg_ranked_context`	Ranked context extraction (by centrality)
`code_graph`	Build code knowledge graph (bra4Code)
`code_blast_radius`	Code change impact analysis
`code_review_context`	Extract review-relevant code context

Planned commands Commandes planifiées

`topo validate`	GOV-4 SHACL/ShEx validation via rudof
`topo export`	DP-4 Export KnowledgeSpace (Turtle/JSON-LD/TriG)
`topo materialize`	SL-3 OWL 2 RL forward-chaining materialization
`topo reflect`	TP-4 Multi-phase SPARQL analysis (continuous reflection)
`topo provenance`	GOV-3 Export PROV-O provenance log
`topo catalog`	GOV-5 Generate DCAT catalog from KnowledgeSpace
`topo did create`	DP-5 Generate sovereign DID (NextGraph)
`topo grounding`	NS-2 Compute Grounding Index (symbolic coverage)

Global options Options globales

`--data <file>`	Load additional data file (repeatable)Charger un fichier de données additionnel (répétable)
`--format <fmt>`	Output format: `tsv` (default), `csv`, `turtle`, `jsonld`Format de sortie : `tsv` (défaut), `csv`, `turtle`, `jsonld`
`--quiet`	Machine-readable output only (no headers, no decoration)Sortie machine uniquement (pas d'en-têtes, pas de décoration)
`--base <iri>`	Base IRI for relative URIs in imported dataIRI de base pour les URIs relatifs dans les données importées