l0grisk intelligence · english

// agent surface v1.18.0

A machine surface for reading l0g without scraping.

Agent Surface v1.18.0 exposes the French and English l0g corpus as static JSON and NDJSON: bilingual catalog, shared search index, evidence graph, at most three structural typed claims per article, primary sources, freshness, Risk Diff, Black Box Recorder, named and versioned signal series, fingerprints, Agent Bench results and an OpenAPI contract. Translations carry canonical and alternate identifiers plus freshness status. Claims remain canonical in French; English analyses link to them through evidenceRef. Heuristic typing remains distinct from canonical review.

Version française →

l0g Agent Bench: deterministic FR/EN results →

// endpoints

Discovery/agents.json

Capability manifest, endpoints, usage rules and proof policy.

Contract/openapi.json

OpenAPI 3.1 description of machine-consumable endpoints.

Catalog/api/v1/catalog.json

Bilingual corpus map with language, canonicalId, translationOf, alternateUrl and translationStatus.

Shared search index/api/v1/search-index.json

Canonical bilingual search index used by Agent Surface, MCP and WebMCP.

English corpus/llms-full-en.txt

Full English analyses and guides, kept separate from the French context.

Catalog NDJSON/api/v1/catalog.ndjson

Line-by-line catalog for streaming ingestion, RAG or incremental indexing.

Claims/api/v1/claims.json

At most three structural claims per article, typed as fact, estimate, inference or scenario, with references and dates when detectable.

Evidence graph/api/v1/evidence-graph.json

Articles, claims, references, hosts, primary sources and datasets as nodes and edges.

Sources/api/v1/sources.json

Primary sources and cited hosts actually used by the corpus.

Freshness/api/v1/freshness.json

Freshness policy, last content updates and signal timing metadata.

Integrity/api/v1/integrity.json

Canonical SHA-256 fingerprints of M2M surfaces.

Changefeed/api/v1/changes.json

Machine-readable publication and revision feed.

Risk Diff/api/v1/risk-diff.json

Risk changes over 1, 7 and 30 days.

Black Box/api/v1/black-box.json

Point-in-time hashed frames for replaying public risk states.

Named series/series/

Stable identifiers, citable names, methodology versions and dedicated downloads for each gauge.

Signal history/api/v1/signals/history.json

Point-in-time signal observations, level changes, coverage and policy.

Signal NDJSON/api/v1/signals/history.ndjson

Line-by-line signal history for agents, watchers and incremental ingestion.

Signal CSV/api/v1/signals/history.csv

Flat signal observations for pandas, R, DuckDB or spreadsheets.

// recommended flow

  1. Discover the surface with /agents.json.
  2. Read /api/v1/freshness.json to date the corpus and dashboard signals.
  3. Verify fingerprints with /api/v1/integrity.json when a response depends on a fixed snapshot.
  4. Watch /api/v1/changes.json for new content and revisions.
  5. Use /api/v1/risk-diff.json to understand what changed in risk over 1, 7 or 30 days.
  6. Use /api/v1/black-box.json to replay a public date without filling historical gaps.
  7. Choose a named series in /series/, then use its dedicated CSV, JSON or NDJSON export.
  8. Use /api/v1/signals/history.csv or .ndjson to replay every series without look-ahead bias.
  9. Use /api/v1/evidence-graph.json to traverse article → claim → source relationships.
  10. Switch to NDJSON feeds for line-by-line ingestion.
  11. Use /api/v1/search-index.json to search the bilingual corpus shared with MCP and WebMCP.
  12. Use /llms-full.txt for French or /llms-full-en.txt for English without loading both corpora.
  13. Quote factual claims via /api/v1/claims.json when the answer depends on a precise assertion.
  14. For an English translation, follow evidenceRef to the canonical French claims and evidence graph.
  15. Preserve the canonical URL, date fields and claim kind in generated answers.

// guardrails

Fields such as kind, dateLabel, references and confidence are not decoration. They prevent a scenario or estimate from being turned into an observed fact, and remind consumers that extracted relations remain verifiable in the canonical page.

// minimal contract

Attributionl0g.fr
LicenseCC BY 4.0
Versionv1.18.0
FormatJSON + NDJSON
Evidenceclaim-source
IntegritySHA-256

// example

curl -s https://l0g.fr/api/v1/claims.json

// integration

For a RAG agent, use /api/v1/search-index.json for bilingual retrieval, then /api/v1/evidence-graph.json or /api/v1/claims.ndjson for sensitive assertions. /api/v1/changes.ndjson avoids rescanning the whole corpus. /openapi.json is the typed entry point for client generation.