builder-trend-scout

A local trend scout for open-source builders.

It turns configured public developer-tool signals into a short scored report of repo ideas. It keeps source failures visible, remembers weak repeats through a negative cache, and writes both Markdown and deterministic JSON for review.

Quick Start

python builder_trend_scout.py scan --offline --fixtures testdata\fixtures --config testdata\configs\happy.json --negative-cache testdata\negative-cache.json --out scout-report --now 2026-07-05T21:18:00-07:00

Windows wrapper:

.\builder-trend-scout.cmd scan --offline --fixtures testdata\fixtures --config testdata\configs\happy.json --negative-cache testdata\negative-cache.json --out scout-report --overwrite

Sources

The MVP supports fixture-backed adapters for GitHub search, HN Algolia/RSS, V2EX public topics, and RSS feeds. Network mode is intentionally narrow in this local version; fixture mode is the supported repeatable path.

Reports

Each scan writes:

• report.md
• report.json
• source-capability.json
• negative-cache.proposed.json

Source capability records show throttled, missing, flaky, empty, stale, partial, and fixture-backed source states. Ranked candidates are capped at five and default to three.

Examples

See examples\happy.config.json for a small fixture-backed config and examples\report\report.md for a generated sample report.

Limits

This tool does not create repositories, post publicly, scrape private sources, use paid APIs, or make launch decisions. It ranks public signals only.

Support

After publication, use GitHub issues for bug reports, docs gaps, and source adapter requests.

Development

Run no-network checks:

python tests.py

License

MIT. See LICENSE.