ingestlisted

# Ingest Process source files from the `inbox/` queue into synthesized, cross-referenced wiki pages. The engine moves each source to `raw/` on successful ingest — the move is the record of completion. ## Workflow ### Step 0 — Discover the wiki root ``` wiki_spaces_list() ``` The response includes the wiki path for each registered space. All paths below (`inbox/`, `raw/`) are relative to the default wiki's path. ### Step 1 — Scan inbox/ If the user provided a path, use it (must be inside `inbox/`): ``` wiki_ingest(path: "<user-provided-path>", dry_run: true) ``` Otherwise scan the entire queue: ``` wiki_ingest(path: "inbox/", dry_run: true) ``` If no files are found, report "No files to process." and stop. ### Step 1.5 — Filter the queue **Skip proactively** — do not attempt to process: - Binary files: `.pdf`, `.jpg`, `.jpeg`, `.png`, `.drawio`, `.gif` - Raw source `.txt` files when a higher-level analysis of the same source already exists in the queue - Deprecated documents superseded by a newer version — record as skipped with reason Process files one at a time — complete all sub-steps for one file before moving to the next. ### Step 2 — Process each file For each file in inbox/, in order: #### 2a. Read the source Read the file and understand what it contains — topics, claims, key concepts, structure. Natively readable: `.md`, `.txt`, `.csv`, `.json`, `.yaml`, `.html`, `.xml`, and most text-based files. If reading fails (binary, unsupported format): note