# Subagent: raw-ingest-runner (Template)

**Auftrag:** Roh-Post in Wiki-Pipeline ziehen — Raw-Datei anlegen, Wiki-Seite erstellen/erweitern, Cross-Refs setzen, index.md + log.md updaten.

**Schema-Referenz:** `AGENTS.md` im Repo (Raw immutable, Wiki kuratiert, Frontmatter-Pflicht).

---

## Input-Parameter (vom Hauptagent mitgegeben)

- `raw_path`: z.B. `raw/xpost/2026-06-16_amd-ryzen-ai-edge-inferenz.md`
- `source_url`: Original-Post-URL
- `source_type`: `xpost | blog | youtube | other`
- `wiki_target`: z.B. `wiki/concepts/hardware/edge-inference-als-cloud-alternative.md` (neu oder erweitern)
- `cross_refs`: Liste existierender Wiki-Seiten für Backlinks
- `distributions_kontext`: Falls Distributions-Format als Faktum benannt werden muss (z.B. "Tech-Influencer-Channel", "Werbe-finanziert")
- `tok_status`: aktueller Token-Status (`ok | waiting-on-rotation`)

---

## Workflow

### 1. Raw-Datei anlegen

`raw/<source_type>/<datum>_<slug>.md` mit Frontmatter:

```yaml
---
id: <auto-generated or as-given>
type: xpost | blog | youtube | other
source_url: <url>
captured_at: YYYY-MM-DD
captured_by: hector-subagent-raw-ingest-runner
ingest_run: WMT-XXX
distributions_kontext: <string oder leer>
---

# <Titel>

<Post-Inhalt oder ausführliche Zusammenfassung>
```

IMMER immutable — kein nachträgliches Editieren (außer bei Fehlern mit `--amend` direkt nach Capture).

### 2. Wiki-Seite erstellen oder erweitern

Bei **neuer** Seite: Wiki-Page mit Frontmatter, ≥ 200 Wörter Substanz, Cross-Refs im Text.

Bei **Erweiterung**: Bestehende Seite lesen, neuen Abschnitt ergänzen mit klarer Überschrift + Datums-Tag.

```yaml
---
id: <slug>
type: wiki-page
created: YYYY-MM-DD
last_updated: YYYY-MM-DD
cross_refs: [<liste>]
sources: [<raw_ids>]
stubs: 0
---

# <Titel>
...
```

### 3. Cross-Refs setzen

- In **neuer** Wiki-Seite: alle `cross_refs` im Text verlinken (`[Titel](<slug>.md)`)
- In **bestehenden** Cross-Ref-Seiten: 1 Satz + Link auf neue Wiki-Seite ergänzen

### 4. index.md + log.md updaten

**index.md**: Neue Wiki-Seite in passender Kategorie eintragen.

**log.md**: Eintrag mit Datum, Ingest-Run-ID, neuen/geänderten Pages, Commit-Hashes.

### 5. Commit + ToDo-Update

Falls `tok_status == ok`:
```bash
git add raw/ wiki/
git commit -m "WMT-XXX: <kurzbeschreibung>"
git push origin main
```

Falls `tok_status == waiting-on-rotation`:
- Commits lokal anlegen, pushen sobald Token rotiert ist (WMT-007 abhängig)
- ToDo-Eintrag mit Note: `pending WMT-007`

ToDo-Eintrag updaten: `planning` → `done` (oder `pending` bei Warte-Status).

### 6. Topic-Report

Standard-URL-Übersicht (siehe Wiki-AGENTS.md § "Reply-Sichtbarkeit"):
- 🆕 Neue Wiki-Seiten mit Repo-Browse-Link + Commit-SHA
- 🔧 Maßgeblich veränderte Seiten mit gleichem Schema
- Distributions-Kontext als Fakt benannt (falls zutreffend)
- ⚠️ Token-Status (falls relevant)

---

## Pit-Eskalation

NUR bei:
- Wiki-Konzept existiert schon unter anderem Namen (mögliche Duplikation → Hub-Page-Strategie)
- Distributions-Kontext ist heikel (z.B. politisch umstrittener Kanal) → Pit-Check vor Veröffentlichung
- Cross-Validation-Quellen widersprechen sich fundamental → Vor-Pit-Post nicht ins Wiki

Sonst: autonom durchziehen.