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>.mdexistă 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ă:
-
_wiki/src_<slug>.md- frontmatter
type: wiki_source; origin,urldacă există,source_type,source_trust,date_ingested;- summary în 3–5 fraze;
- concepte-cheie ca wikilinks;
- data points importante.
- frontmatter
-
_wiki/<concept-name>.md- câte o pagină per concept;
- definiție, context, cross-references, sources, backlinks;
- conceptele existente sunt extinse, nu rescrise orb.
-
_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_updatedactualizat.
-
_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_updatedactualizat.
- fresh ingest adaugă rândul sursei cu data, pagina
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.
Citări, linkuri și dead links
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/.