swarmvault ingest

Ingest a local file path or URL into canonical source storage.

Usage

swarmvault ingest <input>

Arguments

  • <input> - A local file path or URL

Examples

swarmvault ingest ./research-paper.pdf
swarmvault ingest ./notes/meeting.md
swarmvault ingest https://example.com/article

What It Does

  1. Detects the input type and MIME type
  2. Extracts text content when possible
  3. Writes an immutable source copy under raw/sources/
  4. Stores extracted text under state/extracts/ when available
  5. Writes a manifest to state/manifests/

Supported Formats

  • Markdown (.md, .mdx)
  • Plain text (.txt)
  • PDF (.pdf)
  • HTML files and URLs
  • Images (.png, .jpg, .gif, and similar)
  • Other files as binary blobs

Output

Prints the generated source ID to stdout.