Agent
Sub-agent that decides what to do with incomplete textbook references in the registry. Takes a JSON list of candidates (refs with year=0000 or title=empty, plus their siblings = other refs with same lastname) and returns JSON decisions (mergeinto, complete, or blocked). Invoked by /paper-trail:resolve-textbooks slash…
Command
Troisième passe du pipeline cible refondu. Lance la cascade PDF (8 sources : Crossref OA + arXiv + OpenAlex + Unpaywall + HAL + CORE + archive.org + WebSearch ; jusqu'à 11 avec les sources étendues opt-in) ciblée sur les refs d'un SOTA donné. Différent de pipeline run qui itère sur TOUTES les refs actives — acquire ne…
Command
Batch audit of every SOTA in the vault. For each SOTA, identifies refs that are page1validated (technical OK) but not yet sotacitedconfirmed (content audited), and launches audit-sota on those SOTAs. Returns a per-SOTA summary at the end.
Command
Per-citation audit of an academic article (LaTeX or Markdown). Produces RECEIPTS.md classifying each citation as VALID/ADJUST/INVALID/UNVERIFIABLE. Optional --warn inserts inline warnings in a .bak copy of the source.
Command
Audit a SOTA's bibliography. Classify each cited ref by validation state. Optional --purge removes citations to retracted refs from the SOTA (with .bak backup).
Command
Acquire PDFs via the 8-source cascade (11 with opt-in extended sources) for a single ref by slug, or a batch filtered by state. Validates page 1 anti-homonymy on each download.
Command
Inspect a single reference in detail (identity, PDF status, acquisition history with verdicts, citation context in vault, state transitions) and decide its fate. Offers actionable decisions based on the ref's current state.
Command
Audit the registry via the 19 mechanical invariants (I1-I19). Reports ERROR/WARN/INFO violations. Optional auto-fix for safe ones (I4 path, I6 sha256, I9 attempts).
Command
Première passe du pipeline cible refondu (read-only). Produit un rapport d'identification : pour chaque mention citée dans le SOTA, indique si la fiche existe déjà au registre, son état actuel, si elle a un PDF, et l'action recommandée (réutiliser / créer / passer en revue). Ne modifie ni le SOTA ni le registre.
Command
Batch INGEST across the entire vault. Scans all SOTAs, identifies those with bibliographic sections containing free-text citations, then runs /paper-trail:ingest on each one sequentially. Reports per-SOTA summary at the end. The single batch entry point to make a legacy vault fully conform to the paper-trail pipeline.
Command
Ingest the citations of one SOTA into the registry. Extracts bibliographic sections, parses citations via the citation-parser sub-agent, resolves DOI via Crossref/S2, deduplicates against the registry, creates new candidate refs, and substitutes free-text citations with [[wikilinks]]. Required first step to make a…
Command
Injecte une URL OA connue (HAL, dépôt uni, NIME, page perso) pour une ref dont la cascade automatique a échoué, puis relance l'acquisition + validation page 1.
Command
Dernière passe du pipeline cible refondu. Insère les wikilinks finaux dans le SOTA (vers PDF si validé, sinon vers ancre dans une section ## Statut des sources régénérée idempotemment en bas du fichier). Présuppose que les passes identify/purge/acquire ont été lancées.
Command
Start writing an academic paper (IMRaD structure) on a topic, with anti-hallucination citation verification at every step. Builds on existing audited SOTAs.
Command
Create a new State-of-the-Art review on a topic, guaranteed without hallucinated citations. Inverted workflow (research → acquire PDFs → read → write), refuses to write from memory.
Command
Nettoie les wikilinks invalides d'un SOTA (vers refs retracted, refs 0000 orphelines, suffixes numériques 234, fichiers techniques 20ATLAS/, 30DEV/, .canvas, slugs non-bibliographiques). Opère uniquement sur le SOTA, jamais sur le registre. Backup git auto avant --apply.
Command
Re-evaluate refs in state awaitingrtfmocr via rtfm check. Transitions to page1validated if OCR succeeded, or needsreacquisition if OCR failed.
Command
Local-only per-citation audit (no remote API). Reads the cited PDFs from the local registry, generates RECEIPTS.md. Faster than audit-article (no Crossref / paper-search calls).
Command
Nettoyage historique du registre des fiches bibliographiques (les 900 fiches existantes). Cible les vieilles fiches mal nommées (0000, untitled) ET les duplicates avec suffixes numériques (foo2020bar2, 234) qui sont des artefacts de runs INGEST passés. Délègue les décisions au sub-agent textbook-resolver. Les merge…
Command
Resolve incomplete textbook references in the registry. Reads candidates via pipeline resolve-textbooks --list, invokes the textbook-resolver sub-agent to produce a decisions JSON (mergeinto / complete / blocked), and applies via pipeline resolve-textbooks --apply-from. Fully automated cleanup pass after INGEST.
Command
Review and arbitrate problematic references (cascade-exhausted, unresolved UID, awaiting OCR). Generates an up-to-date report, walks through cases by category, and applies arbitration decisions to the registry.
Command
Search the validated registry for references matching a topic (author, title, year, slug). Returns only refs in state page1validated or sotacitedconfirmed by default — i.e. references that have been technically validated (PDF acquired, page 1 OK) or fully audited (content validated against PDF). Used by sota-writer /…
Command
Show the registry status — count of refs per FSM state. Read-only, fast (< 5s).
Hook
Runs before the agent uses a tool for Write and Edit tool calls, executing precheck_sota_wikilinks.py and pre_save_sota_check.py via python3 (2 commands). From roomi-fields/paper-trail.