Skip to content

docs(ruby-gem): sync NativeFeed and entry resolution for gem 0.28.0 - #1249

Merged
gildesmarais merged 5 commits into
mainfrom
docs/gem-0.28.0-sync
Aug 29, 2026
Merged

docs(ruby-gem): sync NativeFeed and entry resolution for gem 0.28.0#1249
gildesmarais merged 5 commits into
mainfrom
docs/gem-0.28.0-sync

Conversation

@gildesmarais

Copy link
Copy Markdown
Member

What changed

  • Document auto_source.scraper.native_feed (native RSS/Atom) and auto_source.entry_resolution on Auto Source.
  • Describe entry URL resolution and request-budget slots under strategy: auto on Strategy; note Botasaurus timeout_phase on RequestTimedOut.
  • Sync MCP inspect_url payload (surface_category, nested sst, scraper_eligibility) and next_step when alternate_feeds is present.
  • Extend CLI --explain / status.to_h with entry_url, scrape_url, entry_resolution.
  • Align AI agent workflow guidance with current next_step behavior.

Why

Upcoming gem 0.28.0 (html2rssv0.27.2..HEAD) adds NativeFeed promotion and weak-entry URL resolution; public docs were missing those contracts.

Risk

  • Low — documentation only in html2rss.github.io.
  • Gem VERSION is still 0.27.2; docs describe the unreleased HEAD contracts.

Review map

Review map: whole PR is small — start at src/content/docs/ruby-gem/reference/auto-source.mdx.

Validation

  • make lint
  • make build

Sync auto-source tiers and schema toggles with v0.27.2..HEAD (native RSS/Atom promotion + weak-entry tournament).
Describe NativeFeed/entry-resolution steps in the auto chain, request-budget impact, and Botasaurus timeout_phase diagnostics.
Alternate feeds now route to scrape_url; document surface_category and nested sst fields for agents.
Document --explain / status.to_h entry_url scrape_url entry_resolution and additive migration bullets.
Forward-facing rewrite of NativeFeed/entry-resolution/MCP Status docs; drop the temporary 0.28.0 backward-compat section and restore scraper_eligibility on inspect.
@gildesmarais
gildesmarais merged commit 6290117 into mainAug 29, 2026
5 checks passed
@gildesmarais
gildesmarais deleted the docs/gem-0.28.0-sync branch August 29, 2026 12:45
Sign up for freeto 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

@gildesmarais