How victorzhong0110/gold-miner works
Gold Miner is a product-validation project for cross-language GitHub discovery, not an installable extension: the README explicitly says no extension exists and no product-effect conclusions have been reached. Its principal implemented workflow is an E1 search experiment that takes query tasks and settings, runs budgeted GitHub searches, merges candidate repositories, and writes evaluation records. The roadmap also covers open-ended discovery, translation and reading, recommendations, and optional shared discovery. Those are documented plans or experiments, not verified product runtime. Source excerpts support the E1 and H0 components shown; unsampled subsystems are represented only at documented directory or plan paths.
Main entry points: v0.4.md Product scope · e1_batch.py Batch orchestration · e1_minimal_runner.py Budgeted search · github_search.py GitHub search client
Components 24
Search validation
- Search tasks
experiments/E1-cross-language-search/queries.yaml - Run settings
experiments/E1-cross-language-search/run-settings.json - Batch orchestration
experiments/E1-cross-language-search/scripts/e1_batch.py - Budgeted search
experiments/E1-cross-language-search/scripts/e1_minimal_runner.py - GitHub search client
experiments/E1-cross-language-search/scripts/github_search.py - Candidate records
experiments/E1-cross-language-search/schemas/candidates.schema.json
Candidate signals
- Seed source parser
experiments/E1-cross-language-search/scripts/parse_hellogithub.py - README classifier
experiments/E1-cross-language-search/scripts/readme_lang.py - Metadata summary
experiments/E1-cross-language-search/scripts/h0_sample.py
Planned experience
- Product scope
docs/plan/v0.4.md - GitHub page experience
docs/plan/v0.4.md - Translation support
docs/research/2026-09-17-translation-and-discovery.md - Discovery assistance
docs/research/2026-09-17-translation-and-discovery.md - Local preferences
README.md - Opt-in shared entries
README.md
Research evaluation
- Open-ended discovery
experiments/E2-open-ended-discovery/protocol.md - Faithful reading
experiments/E3-faithful-reading - Discoverability probes
experiments/E8-discoverability - Glossary concepts
experiments/E9-glossary
Other components
- Project explorer
- GitHub Search API
- HelloGitHub issues
- Repository metadata
- User-provided model API
Connections 24
- Project explorer → Batch orchestration: starts run
- Search tasks → Batch orchestration: supplies tasks
- Run settings → Batch orchestration: configures run
- Batch orchestration → Budgeted search: runs variants
- Budgeted search → GitHub search client: requests search
- GitHub search client → GitHub Search API: queries repositories
- GitHub Search API → GitHub search client: returns results
- Budgeted search → Candidate records: emits candidates
- Batch orchestration → Candidate records: writes run outputs
- HelloGitHub issues → Seed source parser: provides Markdown
- Repository metadata → Metadata summary: provides repository data
- Metadata summary → README classifier: classifies README
- Project explorer → GitHub page experience: uses planned experience
- Product scope → GitHub page experience: specifies scope
- Product scope → Translation support: plans capability
- Product scope → Discovery assistance: plans capability
- Project explorer → Translation support: reads with assistance
- GitHub page experience → Local preferences: stores locally
- GitHub page experience → Opt-in shared entries: contributes by choice
- Discovery assistance → User-provided model API: may call
- Product scope → Open-ended discovery: defines experiment
- Product scope → Faithful reading: defines experiment
- Product scope → Discoverability probes: defines probes
- Product scope → Glossary concepts: tracks terminology