Skip to content

feat: add llms.txt documentation index source - #1

Open
David Mireles (louzt) wants to merge 4 commits into
mainfrom
feat/llms-txt-support
Open

feat: add llms.txt documentation index source#1
David Mireles (louzt) wants to merge 4 commits into
mainfrom
feat/llms-txt-support

Conversation

@louzt

@louzt louzt commented Apr 23, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a dedicated llms-txt source type so documentation sites that publish a machine-readable index at llms.txt can be snapshotted without manually curating URL lists.

What this changes

  • adds llms-txt as a first-class source type
  • extracts URLs from both absolute links and Markdown-style relative links
  • keeps host/include/exclude filtering consistent with the existing source types
  • exports the extraction helper so it can be unit tested directly
  • adds an examples/iroh-llms.json config for https://docs.iroh.computer/llms.txt
  • adds a small node:test suite covering absolute URLs, relative links, and filter behavior

Verification

  • npm test
  • node src/cli.mjs run --config examples/iroh-llms.json
  • verified live snapshot generation against the Iroh docs index (54 pages discovered in the current run)

Add a dedicated llms-txt source type for documentation sites that publish an index at llms.txt, including relative Markdown link resolution, host/include/exclude filtering, and an end-to-end Iroh example.\n\nAlso exports the extraction helper for unit testing and adds a small node:test suite covering absolute URLs, relative links, and filtering behavior.
Add ready-made scraper configs for the stable Rust documentation surface and the docs.rs about/build pages, plus README notes so those presets are discoverable for future protocol/runtime research.
Add a ready-made Quinn docs snapshot preset and document it in the README so future SnapPipe/QUIC research can reproduce the local docs capture workflow.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant