bra0 / Docs / Guides / Investigation
Guide

Investigation

A data-centric framework for investigative work — journalism, disinformation analysis, civic inquiry, research integrity. Turn heterogeneous sources into defensible findings: source-first ingestion, strong source identity, three-valued verdicts, audit-forward delivery — all in one governed model. Local-first, sovereign. Une infrastructure data-centric pour le travail d'investigation — journalisme, analyse de la désinformation, enquête citoyenne, intégrité scientifique. Transformer des sources hétérogènes en conclusions opposables : ingestion source-first, identité forte des sources, verdicts à trois valeurs, livraison audit-forward — le tout dans un seul modèle gouverné. Local-first, souverain.

Who this guide is for À qui s'adresse ce guide
  • Investigative journalists and fact-checking desks turning raw material into findings that must survive contestation.Journalistes d'investigation et cellules de fact-checking transformant des matériaux bruts en conclusions devant résister à la contestation.
  • Disinformation and media-forensics analysts who need to re-identify the same source across multiple investigations.Analystes de la désinformation et de la média-forensique qui doivent réidentifier une même source à travers plusieurs enquêtes.
  • Civic, militant and educational inquiry — including media-literacy programmes building investigation as a teachable, traceable practice.Enquête citoyenne, militante et éducative — y compris les programmes d'éducation aux médias qui font de l'investigation une pratique enseignable et traçable.
  • Research-integrity and source-verification teams that require every conclusion to carry its evidence and its provenance.Équipes d'intégrité scientifique et de vérification des sources exigeant que chaque conclusion porte sa preuve et sa provenance.

The problem Le problème

An investigation collects heterogeneous material — documents, images, testimonies, datasets — and must turn it into conclusions that hold up when challenged. Each source must be identifiable, each conclusion must carry its evidence and its verdict, and the whole chain must be reconstructable long after publication. Spreadsheets, shared folders and prose notes cannot hold that chain without semantic anchoring. Une investigation collecte des matériaux hétérogènes — documents, images, témoignages, jeux de données — et doit les transformer en conclusions qui tiennent face à la contestation. Chaque source doit être identifiable, chaque conclusion doit porter sa preuve et son verdict, et toute la chaîne doit être reconstructible bien après publication. Tableurs, dossiers partagés et notes en prose ne tiennent pas cette chaîne sans ancrage sémantique.

?
Source identity under contestation Identité des sources sous contestation

The same document or image resurfaces across investigations. Without a strong, scheme-qualified identifier, no tool can tell whether two captures are the same source — or flag a likely duplicate. Un même document ou une même image réapparaît d'une enquête à l'autre. Sans identifiant fort, qualifié par schéma, aucun outil ne peut dire si deux captures sont la même source — ni signaler un doublon probable.

2 → 3
The binary-verdict trap Le piège du verdict binaire

True / false collapses the honest third state. A claim may be substantiated, falsified, or genuinely inconclusive — and erasing the third option manufactures false certainty. Vrai / faux écrase l'honnête troisième état. Une allégation peut être étayée, infirmée, ou réellement non concluante — et effacer la troisième option fabrique une fausse certitude.

P12
Audit-forward delivery Livraison audit-forward

A published finding may be challenged in court or in public. The dossier — which source, which step, signed off by whom — must be reconstructable, not reassembled from memory. Une conclusion publiée peut être contestée en justice ou dans l'espace public. Le dossier — quelle source, quelle étape, validé par qui — doit être reconstructible, pas reconstitué de mémoire.

How bra0 addresses this Comment bra0 répond

The Investigation framework (KIF) is a generic knowledge-space model with six pivot classes, each dual-anchored to BFO 2020 and to the W3C Provenance Ontology. It consumes a cross-domain source-binding layer for source identity, and is realized as a governed Knowledge Space that declares the public referentials it consumes. Le framework d'investigation (KIF) est un modèle générique de knowledge space à six classes pivots, chacune doublement ancrée sur BFO 2020 et sur la W3C Provenance Ontology. Il consomme une couche transverse de liaison de sources pour l'identité, et se réalise comme un Knowledge Space gouverné qui déclare les référentiels publics qu'il consomme.

Challenge bra0 capability Standard Layer
Source-first ingestion floorPlancher d'ingestion source-first kif:RawSource specialises srcb:ExternalSource. Before any extraction, a source must satisfy the inherited Tier-1 floor: identifier, creation date, and capture time. No finding is built on an unanchored source.kif:RawSource spécialise srcb:ExternalSource. Avant toute extraction, une source doit satisfaire le plancher Tier-1 hérité : identifiant, date de création, heure de capture. Aucune conclusion ne se bâtit sur une source non ancrée. srcb / PROV-O SL
Strong cross-investigation source identityIdentité forte des sources entre enquêtes Source binding reuses W3C ADMS: a source may carry an adms:Identifier with a notation and a scheme agency. Duplicate detection is an advisory SPARQL query — it surfaces likely collisions without ever blocking ingestion.La liaison de sources réutilise W3C ADMS : une source peut porter un adms:Identifier avec une notation et une agence de schéma. La détection de doublons est une requête SPARQL consultative — elle révèle les collisions probables sans jamais bloquer l'ingestion. W3C ADMS SL
Three-valued verdictsVerdicts à trois valeurs Every kif:Finding carries a verdict drawn from a three-valued SKOS scheme: Substantiated, Falsified, Inconclusive. The honest third state is first-class, not lost between true and false.Chaque kif:Finding porte un verdict tiré d'un schéma SKOS à trois valeurs : Étayé, Infirmé, Non concluant. L'honnête troisième état est de premier rang, pas perdu entre le vrai et le faux. SKOS SL
Provenance of every stepProvenance de chaque étape GOV-3 — PROV-O activity logging. An Investigation is a BFO Process aligned with a PROV Activity; every source and finding is a prov:Entity. Who captured what, when, under whose authority — recorded, not narrated.GOV-3 — Journalisation d'activités PROV-O. Une Investigation est un BFO Process aligné sur une PROV Activity ; chaque source et chaque conclusion est une prov:Entity. Qui a capturé quoi, quand, sous quelle autorité — consigné, pas raconté. PROV-O CP
Lifecycle and confidentiality kept orthogonalCycle de vie et confidentialité maintenus orthogonaux GOV-4 — SHACL validation gates. A finding's delivery state (kif:hasLifecycleState) and its confidentiality (kif:hasConfidentialityState) are two axes that never collapse. A public verdict and a confidential source coexist without contradiction.GOV-4 — Portiques de validation SHACL. L'état de livraison d'une conclusion (kif:hasLifecycleState) et sa confidentialité (kif:hasConfidentialityState) sont deux axes qui ne se confondent jamais. Un verdict public et une source confidentielle coexistent sans contradiction. SHACL 1.2 CP
Declared referential consumptionConsommation de référentiels déclarée Each realized investigation is a governed Knowledge Space that declares every public referential it consumes via bra0t:referentialBaseConsumed. What an investigation stands on is itself queryable.Chaque investigation réalisée est un Knowledge Space gouverné qui déclare chaque référentiel public consommé via bra0t:referentialBaseConsumed. Ce sur quoi une enquête s'appuie est lui-même interrogeable. bra0t / SHACL CP
Agentic AI in the loopIA agentique dans la boucle Agent Service Contracts (asc:) — an AI-mediated step (e.g. drafting a finding from contextualized sources) runs only if its contract permits the action under the active governance rules, and a human attestation is required before the output is accepted.Agent Service Contracts (asc:) — une étape médiée par IA (par ex. rédiger une conclusion à partir de sources contextualisées) ne s'exécute que si son contrat autorise l'action sous les règles de gouvernance actives, et une attestation humaine est requise avant acceptation de la sortie. bra0:asc CP
Data sovereigntySouveraineté des données DP-3 — Local-first persistence. SPARQL runs in the browser via Rust/WASM, with P2P E2E-encrypted sync. Sensitive sources and confidential findings do not transit through a cloud service.DP-3 — Persistance local-first. SPARQL s'exécute dans le navigateur via Rust/WASM, avec synchronisation P2P chiffrée E2E. Sources sensibles et conclusions confidentielles ne transitent par aucun service cloud. CRDT DP

Capability domain — the investigation spine Domaine de capacité — la colonne vertébrale de l'investigation

Six pivot classes carry an investigation from request to published finding. The brief frames the question; sources enter under a source-first floor, then gain context; findings carry a verdict and a delivery state; the whole is anchored in a chronotopic context. Six classes pivots mènent une investigation de la demande à la conclusion publiée. Le brief cadre la question ; les sources entrent sous un plancher source-first, puis gagnent un contexte ; les conclusions portent un verdict et un état de livraison ; l'ensemble est ancré dans un contexte chronotopique.

1 · Brief A request to investigate, emitted by an agent via an intake channel, satisfiable by one or more investigations.Une demande d'enquête, émise par un agent via un canal d'intake, satisfaite par une ou plusieurs investigations.
kif:InvestigationBrief
2 · Raw source Material ingested as received, under the Tier-1 floor (identifier, creation, capture time).Matériau ingré tel que reçu, sous le plancher Tier-1 (identifiant, création, heure de capture).
kif:RawSource
3 · Contextualized The same source enriched with temporal, spatial and event anchoring.La même source enrichie d'un ancrage temporel, spatial et événementiel.
kif:ContextualizedSource
4 · Finding A claim assessed against the sources, carrying a three-valued verdict and a delivery state.Une allégation appréciée au regard des sources, portant un verdict à trois valeurs et un état de livraison.
kif:Finding
5 · Context The chronotopic bundle anchoring the investigation in time, space and related events.Le faisceau chronotopique ancrant l'investigation dans le temps, l'espace et les événements liés.
kif:InvestigationContext
Function How KIF holds it Standard
Brief intakeRéception du brief An InvestigationBrief is emitted by an agent (kif:emittedBy), possibly via an intake channel (kif:emittedVia), and satisfied by one or many investigations (kif:satisfiedBy). Its lifecycle runs Emitted → Registered → Acknowledged → Accepted / Refused / Merged.Un InvestigationBrief est émis par un agent (kif:emittedBy), éventuellement via un canal (kif:emittedVia), et satisfait par une ou plusieurs investigations (kif:satisfiedBy). Son cycle de vie : Émis → Enregistré → Accusé → Accepté / Refusé / Fusionné. SKOS / PROV-O
Source ingestion (source-first)Ingestion des sources (source-first) A RawSource specialises the cross-domain srcb:ExternalSource and inherits its Tier-1 mandatory floor. The floor is checked before any KIF-side metadata extraction or finding generation begins.Une RawSource spécialise le srcb:ExternalSource transverse et hérite de son plancher Tier-1 obligatoire. Le plancher est vérifié avant toute extraction de métadonnées KIF ou génération de conclusion. srcb / SHACL
ContextualizationContextualisation A ContextualizedSource is the same source enriched with investigation-specific anchoring — temporal, spatial, event — linked from the raw source by a functional kif:contextualizedAs. The raw capture and its contextualized reading stay distinct.Une ContextualizedSource est la même source enrichie d'un ancrage propre à l'enquête — temporel, spatial, événementiel — reliée depuis la source brute par un kif:contextualizedAs fonctionnel. La capture brute et sa lecture contextualisée restent distinctes. SKOS / OWL
Analysis and verdictAnalyse et verdict A Finding is produced by the investigation (kif:hasFinding) and carries a verdict from the three-valued scheme — Substantiated, Falsified, Inconclusive. The verdict is a SKOS concept, queryable and auditable.Une Finding est produite par l'investigation (kif:hasFinding) et porte un verdict du schéma à trois valeurs — Étayé, Infirmé, Non concluant. Le verdict est un concept SKOS, interrogeable et auditable. SKOS / SPARQL
Audit-forward delivery ratchetCliquet de livraison audit-forward A second lifecycle axis ratchets a finding Drafted → Signed → Licensed → Published. Each transition is a PROV-O delta: what changed, when, signed off by whom — the dossier compiles itself.Un second axe de cycle de vie fait cliquer une conclusion Rédigée → Signée → Licenciée → Publiée. Chaque transition est un délta PROV-O : ce qui a changé, quand, validé par qui — le dossier se compile de lui-même. PROV-O / SHACL
Confidentiality (orthogonal axis)Confidentialité (axe orthogonal) Confidential / Internal / Public is carried by kif:hasConfidentialityState, never folded into the lifecycle. A finding can be Published while one of its sources stays Confidential — the two axes are validated independently.Confidentiel / Interne / Public est porté par kif:hasConfidentialityState, jamais replié dans le cycle de vie. Une conclusion peut être Publiée tandis qu'une de ses sources reste Confidentielle — les deux axes sont validés indépendamment. SHACL 1.2

Source-first, in practice Source-first, en pratique

No finding is built on an unanchored source. A raw source must satisfy its inherited floor before any extraction. Strong identity is added through W3C ADMS — a notation under a named scheme — so the same source can be recognised across investigations. Aucune conclusion ne se bâtit sur une source non ancrée. Une source brute doit satisfaire son plancher hérité avant toute extraction. L'identité forte s'ajoute via W3C ADMS — une notation sous un schéma nommé — pour qu'une même source soit reconnue d'une enquête à l'autre.

# A raw source under the Tier-1 floor, carrying a strong ADMS identifier (illustrative) @prefix kif: <https://schema.bra0.org/kif#> . @prefix srcb: <https://schema.bra0.org/cross-domain/source-binding#> . @prefix adms: <http://www.w3.org/ns/adms#> . @prefix skos: <http://www.w3.org/2004/02/skos/core#> . ex:source-0427 a kif:RawSource ; dcterms:identifier "src-0427" ; # Tier-1 floor dcterms:created "2026-06-12" ; prov:generatedAtTime "2026-06-12T09:14:00Z" ; adms:identifier [ # strong cross-investigation identity a adms:Identifier ; skos:notation "10.5555/report-2026" ; adms:schemeAgency "DOI" ] .
Dedup query — advisory, never blocking Requête de dédoublonnage — consultative, jamais bloquante

"List every notation+scheme carried by two or more distinct sources." The answer is a SPARQL result that surfaces likely duplicates for human review. It never raises a validation violation — an investigation may legitimately hold the same identifier twice. « Lister chaque notation+schéma porté par deux sources distinctes ou plus. » La réponse est un résultat SPARQL qui révèle les doublons probables pour revue humaine. Elle ne lève jamais de violation — une enquête peut légitimement porter deux fois le même identifiant.

Three-valued verdicts Verdicts à trois valeurs

A finding does not have to be true or false. It carries one of three verdicts, each a SKOS concept with an explicit definition — so the honest "we cannot yet conclude" is recorded rather than rounded away. Une conclusion n'a pas à être vraie ou fausse. Elle porte l'un de trois verdicts, chacun un concept SKOS avec une définition explicite — pour que l'honnête « nous ne pouvons pas encore conclure » soit consigné plutôt qu'arrondi.

Verdict Definition
Substantiated (Étayé) The claim or hypothesis is supported by evidence gathered during the investigation.L'allégation ou l'hypothèse est étayée par les preuves recueillies durant l'enquête.
Falsified (Infirmé) The claim or hypothesis is contradicted by evidence gathered during the investigation.L'allégation ou l'hypothèse est contredite par les preuves recueillies durant l'enquête.
Inconclusive (Non concluant) The evidence neither substantiates nor falsifies the claim. The third state is recorded, not hidden.Les preuves n'étayent ni n'infirment l'allégation. Le troisième état est consigné, pas masqué.

One framework, many domains Un seul framework, plusieurs domaines

The same six pivots and two orthogonal axes hold across investigative work, whatever the terrain. The model was checked for genericity against a wide span of investigation domains — none required a new pivot class: Les mêmes six pivots et deux axes orthogonaux tiennent à travers le travail d'investigation, quel que soit le terrain. Le modèle a été vérifié pour sa généricité sur un large éventail de domaines d'enquête — aucun n'a exigé de nouvelle classe pivot :

First realized instance Première instance réalisée

The Forum Action Modernités (FAM) investigation knowledge space is the first realized instance built on this framework — the empirical precedent that confirmed the six pivots hold end to end before the framework was generalised. Le knowledge space d'investigation du Forum Action Modernités (FAM) est la première instance réalisée sur ce framework — le précédent empirique qui a confirmé que les six pivots tiennent de bout en bout avant la généralisation du modèle.

Grounding Ancrage

Each pivot class is dual-anchored: to BFO 2020 for its ontological category (process, continuant) and to the W3C Provenance Ontology for its evidentiary role (activity, entity). The process design draws on Ciampi's 2018 canon of cooperative knowledge creation, and the data model was validated against a collaborative image-verification architecture used in production media work. Source binding reuses W3C ADMS rather than minting a local identifier vocabulary — nothing is reinvented where an open standard already holds. Chaque classe pivot est doublement ancrée : sur BFO 2020 pour sa catégorie ontologique (process, continuant) et sur la W3C Provenance Ontology pour son rôle probatoire (activity, entity). La conception du processus s'appuie sur le canon 2018 de Ciampi sur la création coopérative de connaissance, et le modèle de données a été validé contre une architecture collaborative de vérification d'images utilisée en production. La liaison de sources réutilise W3C ADMS plutôt que de créer un vocabulaire local d'identifiants — rien n'est réinventé là où un standard ouvert tient déjà.

Key invariant for investigation Invariant clé pour l'investigation

No finding is built on an unanchored source. Every raw source satisfies its Tier-1 floor before any extraction; every finding carries a three-valued verdict and an audit-forward delivery state; lifecycle and confidentiality stay orthogonal and are validated independently. The dossier behind any published conclusion is the queryable state of the graph — reconstructable at any timestamp, not reassembled from memory. Aucune conclusion ne se bâtit sur une source non ancrée. Chaque source brute satisfait son plancher Tier-1 avant toute extraction ; chaque conclusion porte un verdict à trois valeurs et un état de livraison audit-forward ; cycle de vie et confidentialité restent orthogonaux et sont validés indépendamment. Le dossier derrière toute conclusion publiée est l'état interrogeable du graphe — reconstructible à tout instant, pas reconstitué de mémoire.

See also Voir aussi

Knowledge Space — the fundamental unit of organization, and the governance boundary for an investigation.
3-Layer Architecture — how governance (Control Plane), meaning (Semantic Layer), and storage (Data Plane) separate cleanly.
Ingestion paths (drill-down) — how typed sources enter the graph through SHACL gates.
SHACL Shapes — the validation gates that enforce the source-first floor at ingestion.
Capability Reference — the full capability map, including GOV-3, GOV-4, DP-3.
Terminology Server — the bra0 schema namespace, including asc: for Agent Service Contracts.
Knowledge Space — l'unité fondamentale d'organisation, et la frontière de gouvernance d'une investigation.
Architecture 3 couches — comment gouvernance (Control Plane), sens (Semantic Layer) et stockage (Data Plane) se séparent proprement.
Voies d'ingestion (drill-down) — comment les sources typées entrent dans le graphe via les portiques SHACL.
SHACL Shapes — les portiques de validation qui appliquent le plancher source-first à l'ingestion.
Référence des capacités — la carte complète des capacités, incluant GOV-3, GOV-4, DP-3.
Serveur de terminologies — le namespace de schéma bra0, incluant asc: pour les Agent Service Contracts.

Glossary Glossaire

Plain-language definitions of the technical terms used throughout this guide. Définitions en langage clair des termes techniques employés dans ce guide.

Term Definition
KIF KS Investigation Framework — a generic knowledge-space model for investigative work, with six pivot classes dual-anchored to BFO 2020 and PROV-O. It is consumed by realized investigation knowledge spaces.KS Investigation Framework — modèle générique de knowledge space pour le travail d'investigation, à six classes pivots doublement ancrées sur BFO 2020 et PROV-O. Il est consommé par les knowledge spaces d'investigation réalisés.
Pivot class One of the six core classes that carry an investigation: InvestigationBrief, Investigation, RawSource, ContextualizedSource, Finding, InvestigationContext.L'une des six classes centrales qui portent une investigation : InvestigationBrief, Investigation, RawSource, ContextualizedSource, Finding, InvestigationContext.
Source-first floorPlancher source-first A mandatory minimum every raw source must satisfy before any extraction: identifier, creation date, capture time. Inherited from the cross-domain source-binding layer.Un minimum obligatoire que chaque source brute doit satisfaire avant toute extraction : identifiant, date de création, heure de capture. Hérité de la couche transverse de liaison de sources.
Three-valued verdictVerdict à trois valeurs A SKOS scheme of exactly three verdicts a finding may carry — Substantiated, Falsified, Inconclusive — preserving the honest third state instead of forcing true/false.Un schéma SKOS de trois verdicts exactement qu'une conclusion peut porter — Étayé, Infirmé, Non concluant — préservant l'honnête troisième état plutôt que d'imposer vrai/faux.
Orthogonal axesAxes orthogonaux Lifecycle state (delivery progression) and confidentiality state (who may see it) are two independent axes that never collapse into one. A finding can be Published while a source stays Confidential.L'état de cycle de vie (progression de livraison) et l'état de confidentialité (qui peut voir) sont deux axes indépendants qui ne se confondent jamais. Une conclusion peut être Publiée tandis qu'une source reste Confidentielle.
PROV-O W3C Provenance Ontology — a standard vocabulary for recording who did what, when, with which input, under whose authority. Every source and finding is a queryable provenance record.W3C Provenance Ontology — vocabulaire standard pour consigner qui a fait quoi, quand, avec quelle entrée, sous quelle autorité. Chaque source et conclusion est un enregistrement de provenance interrogeable.
BFO 2020 Basic Formal Ontology — an ISO/IEC top-level ontology used to categorise each pivot as a process or a continuant, giving the model a stable upper grounding.Basic Formal Ontology — ontologie de haut niveau ISO/IEC utilisée pour catégoriser chaque pivot comme process ou continuant, donnant au modèle un ancrage supérieur stable.
W3C ADMS Asset Description Metadata Schema — a W3C vocabulary reused to attach a strong identifier (notation + scheme agency) to a source, so the same source is recognisable across investigations.Asset Description Metadata Schema — vocabulaire W3C réutilisé pour attacher un identifiant fort (notation + agence de schéma) à une source, afin qu'elle soit reconnaissable d'une enquête à l'autre.
asc: (Agent Service Contract) An RDF-typed contract binding an AI agent's action: typed inputs, typed outputs, governance rules that must hold for the action to be permitted, and the human attestation required before the output is accepted.Contrat typé RDF qui borne l'action d'un agent IA : entrées typées, sorties typées, règles de gouvernance qui doivent tenir pour autoriser l'action, et attestation humaine requise avant acceptation de la sortie.
rudof Open-source Rust SHACL/ShEx validator. The validation engine bra0 calls at ingestion and on every graph mutation; no JavaScript alternative is used.Validateur SHACL/ShEx open-source écrit en Rust. Moteur de validation appelé par bra0 à l'ingestion et à chaque mutation du graphe ; aucune alternative JavaScript n'est utilisée.