Wiki Ingest

File path (e.g. raw/papers/llama2.md): use #tool:read/readFile. URL: use #tool:web/fetch to retrieve full content, then save a clean markdown copy to raw/<category>/<slug>.md. Ask the user which category fits (raw/articles/, raw/papers/, raw/notes/).

Step 2 — Catalogue first (structure before content)

Before writing any files, show the plan and wait for confirmation:

📋 Ingest plan for: [Source Title]
  New pages:
    - wiki/sources/slug.md
    - wiki/entities/Name.md (new)
    - wiki/concepts/Name.md (new)
  Pages to update:
    - wiki/entities/ExistingName.md (add appearance)
  Contradictions detected: [none | list]
Proceed? (say "yes" or trim the list)

Step 3 — Analyse

Extract from the source:

• Core thesis — what does this source fundamentally claim?
• Key claims — specific, falsifiable assertions + their line numbers in the raw file
• Concepts — ideas, frameworks, methods introduced or used
• Entities — people, companies, projects, products named
• Connections — what does this relate to in the existing wiki?
• Contradictions — does anything conflict with existing wiki pages?

Step 4 — Write source page

Create wiki/sources/<slug>.md using the Source page format in references/schema.md.

Every Key Claim must have a [raw/path/file.md:LINE] citation. No exceptions.

Step 5 — Entity pages

For each significant entity:

• Exists → add Appearances entry, update facts if enriched.
• Doesn't exist → create wiki/entities/<n>.md.

Step 6 — Concept pages

For each significant concept:

• Exists → add source reference, enrich definition if warranted.
• Doesn't exist → create wiki/concepts/<n>.md. For complex concepts, include a Mermaid diagram.

Step 7 — Cross-linking

• Add [[NewSourceSlug]] to any existing pages that cover topics this source touches.
• Symmetry check: if this source page links to page B, does B link back?
• Log any mentioned concepts that lack their own page.

Step 8 — Update overview

Revise wiki/overview.md to reflect how this source changes the current synthesis. Rewrite relevant sections — don't just append.

Step 9 — Update index

Add all new pages to wiki/index.md under the right sections. Update the page count and date.

Step 10 — Log

## [YYYY-MM-DD HH:MM] ingest | <Title>
- Files created: wiki/sources/<slug>.md, [entity/concept pages]
- Files updated: wiki/index.md, wiki/overview.md, [others]
- Contradictions flagged: [none | list]

Draft-first rule

If you're inferring a relationship not explicitly stated in the source, write it to wiki/drafts/<slug>.md and surface it to the user — don't assert it as verified.