Ghid Operator Wednesday Ingest — Compilator Wiki LLM

ingest este capacitatea care ia material brut din _raw/sources/ și îl compilează în _wiki/: o pagină de sursă, pagini de concepte, linkuri, backlinkuri, index și jurnal de ingest. Materia primă rămâne plată și neatinsă; wiki-ul este stratul organizat. Ordine, nu grădinărit decorativ.

Context

Nevermore și toate proiectele lui sunt personale, private, passion work și noncommercial. Ghidul acesta descrie operarea internă a sistemului, atât. Restul ar fi contaminare.

Unde pui sursele brute

Pune fișierele în _raw/sources/.

Reguli:

  • directorul rămâne flat;
  • nu sorta manual sursele pe foldere;
  • nu muta material brut în _wiki/;
  • _wiki/ se scrie doar prin workflow-ul /ingest.

Cum îl invoci

Folosește una dintre formele:

  • /ingest
  • /ingest <nume-sursă>
  • ingest <nume-sursă>
  • „ingest the new source”

Dacă dai un nume, Wednesday alege fișierul respectiv din _raw/sources/. Dacă nu dai nume, alege cel mai nou fișier din _raw/sources/ care nu apare deja în _wiki/ingest_log.md, ignorând README.md.

Dacă nu există nicio sursă nouă, mesajul terminal canonic este: No new sources in _raw/sources/. Asta înseamnă că queue-ul e gol: nu s-a ales nicio sursă, nu s-a scris nimic în _wiki/, iar operatorul poate fie să adauge o sursă nouă, fie să invoce explicit un re-ingest pe o sursă existentă.

Fresh ingest vs re-ingest

Fresh ingest:

  • nu există încă _wiki/src_<slug>.md;
  • sursa nu apare în _wiki/ingest_log.md;
  • workflow-ul creează pagina de sursă și conceptele necesare.

Re-ingest:

  • _wiki/src_<slug>.md există deja sau sursa e deja în log;
  • workflow-ul actualizează paginile existente;
  • nu creează duplicate. Sistemul are voie să fie obsesiv, nu amnezic.

Trust boundary: source_trust: low

Carantină strictă

Dacă frontmatter-ul sursei brute conține source_trust: low, sursa rămâne raw și este carantinată înainte de orice Hermes dispatch.

Efecte obligatorii:

  • zero scrieri în _wiki/;
  • zero pagină src_<slug>.md;
  • zero concepte create sau actualizate;
  • zero index/log update de ingest normal;
  • sursa brută rămâne neatinsă până la review explicit și promovare de trust de către operator.

Doar operatorul poate elibera o sursă low-trust prin review explicit și schimbarea trustului. Până atunci, ingestul se oprește. Fără excepții creative; acelea sunt doar buguri cu parfum.

Ce scrie ingestul

Pentru o sursă eligibilă, workflow-ul scrie sau actualizează:

  1. _wiki/src_<slug>.md

    • frontmatter type: wiki_source;
    • origin, url dacă există, source_type, source_trust, date_ingested;
    • summary în 3–5 fraze;
    • concepte-cheie ca wikilinks;
    • data points importante.
  2. _wiki/<concept-name>.md

    • câte o pagină per concept;
    • definiție, context, cross-references, sources, backlinks;
    • conceptele existente sunt extinse, nu rescrise orb.
  3. _wiki/index.md

    • concepte noi în harta A–Z;
    • fresh ingest adaugă un rând nou în tabela de surse;
    • re-ingest actualizează rândul existent al sursei și nu creează un al doilea rând;
    • last_updated actualizat.
  4. _wiki/ingest_log.md

    • fresh ingest adaugă rândul sursei cu data, pagina src_, concepte create și concepte actualizate;
    • re-ingest actualizează intrarea existentă pentru sursa respectivă și nu creează duplicat;
    • last_updated actualizat.

Idempotency

Ingestul este idempotent: aceeași sursă nu produce clone. Dacă pagina de sursă sau intrarea din log există deja, rulează ca re-ingest și actualizează conținutul existent.

Semnal practic:

  • +created în report înseamnă pagini/concepte noi;
  • ~updated înseamnă pagini/concepte existente extinse;
  • absența duplicatelor este comportamentul corect.

Conceptele trebuie să citeze pagina-sursă src_<slug> printr-un wikilink în secțiunea ## Sources. Afirmațiile vin din surse; dacă apare ceva nesusținut de sursă, trebuie marcat clar.

Regula de dead-link este brutală și utilă: orice wikilink către o pagină care nu există încă trebuie rezolvat imediat prin crearea unei pagini stub cu frontmatter și ## Definition marcat TBD. Wiki-ul nu cară linkuri moarte. Le îngroapă pe loc.

Backlinkurile se mențin la fiecare ingest: dacă pagina conceptului A trimite la B, pagina B primește backlink către A.

Cum citești reportul final

Reportul ar trebui să spună concret:

  • pagina de sursă scrisă sau actualizată;
  • concepte create cu +;
  • concepte actualizate cu ~;
  • stuburi create pentru dead-link resolution;
  • dacă ingestul s-a oprit din cauza source_trust: low.

Interpretare rapidă:

  • dacă vezi quarantined, nu s-a scris nimic în _wiki/;
  • dacă vezi doar ~updated, a fost re-ingest curat;
  • dacă vezi +created, wiki-ul a primit concepte sau stuburi noi;
  • dacă reportul nu menționează indexul și logul, cere verificare. Tăcerea în sisteme e rar virtute; de obicei e mucegai.

Checklist operator

Înainte:

  • sursa e în _raw/sources/;
  • frontmatter-ul are trust corect;
  • pentru low-trust, accepți că ingestul se oprește.

După:

  • verifică reportul;
  • pentru fresh ingest, caută _wiki/src_<slug>.md;
  • pentru re-ingest, caută ~updated și lipsa duplicatelor;
  • pentru low-trust, confirmă că nu există scrieri noi în _wiki/.