wiki-ingestlisted

# wiki-ingest Integrate a new source into the wiki. A single ingest can touch **10–15 pages** — this compounding effect is the whole point. Knowledge is compiled once, not re-derived on every query. ## When to use - User provides a URL, file path, or pasted text to add to the wiki - User says "add this", "ingest this", "read this and update the wiki" ## Pre-flight (orientation guard) Before ingesting, read orientation files if not done this session: ``` read_file {wiki_path}/SCHEMA.md # ← conventions, tag taxonomy, policies read_file {wiki_path}/index.md read_file {wiki_path}/log.md # last 20 lines ``` **SCHEMA.md is authoritative.** Read its page creation policy, required frontmatter fields, tag taxonomy, and cross-reference policy — enforce those, not plugin defaults. ## Steps ### ① Capture raw source (+ images) **Save the source text:** - URL → fetch content as markdown, save to `raw/articles/{descriptive-name}.md` - PDF → extract text, save to `raw/papers/{descriptive-name}.md` - Pasted text → save to appropriate `raw/` subdirectory - Name descriptively: `raw/articles/karpathy-llm-wiki-2026.md` - Never overwrite existing raw files — append suffix if collision **Extract and save referenced images** (unless `--no-images`): - Scan the source for image references (markdown ``, HTML `<img>`, etc.) - Download each image to `raw/assets/{source-stem}-{image-name}` - Rewrite the saved raw source to reference local paths, not remote URLs - URLs rot; lo