{"id":46332530,"url":"https://github.com/dosadi/hydra","last_synced_at":"2026-03-04T18:02:30.635Z","repository":{"id":325355455,"uuid":"1086849301","full_name":"dosadi/hydra","owner":"dosadi","description":"Hydra open source 3d voxel raycasting circuit","archived":false,"fork":false,"pushed_at":"2025-11-30T08:46:54.000Z","size":1863,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-01T18:10:11.408Z","etag":null,"topics":["3d-graphics","fpga","graphics-accelerator","hardware","pcie","raycaster","rtl","sdl2","systemverilog","verilator","voxel"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dosadi.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-31T02:03:39.000Z","updated_at":"2025-11-30T08:46:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dosadi/hydra","commit_stats":null,"previous_names":["dosadi/hydra"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/dosadi/hydra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dosadi%2Fhydra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dosadi%2Fhydra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dosadi%2Fhydra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dosadi%2Fhydra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dosadi","download_url":"https://codeload.github.com/dosadi/hydra/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dosadi%2Fhydra/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30088339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T15:40:14.053Z","status":"ssl_error","status_checked_at":"2026-03-04T15:40:13.655Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graphics","fpga","graphics-accelerator","hardware","pcie","raycaster","rtl","sdl2","systemverilog","verilator","voxel"],"created_at":"2026-03-04T18:02:21.687Z","updated_at":"2026-03-04T18:02:30.617Z","avatar_url":"https://github.com/dosadi.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Integration Overview\n\nThis directory contains GitHub-specific configuration files for the Hydra project.\n\n## Files in This Directory\n\n### Issue \u0026 PR Templates\n- **`ISSUE_TEMPLATE/bug_report.yml`** - Structured bug report template with component selection, reproduction steps, and environment details\n- **`ISSUE_TEMPLATE/feature_request.yml`** - Feature request template with problem statement, proposed solution, and use cases\n- **`ISSUE_TEMPLATE/config.yml`** - Issue template configuration with links to documentation\n- **`pull_request_template.md`** - PR template with testing checklist, component marking, and reviewer guidance\n\n### Automation \u0026 Security\n- **`dependabot.yml`** - Automatic dependency updates for GitHub Actions and Python packages\n- **`CODEOWNERS`** - Automatic reviewer assignment based on file paths\n- **`SECURITY.md`** - Security vulnerability reporting policy and disclosure guidelines\n\n### CI/CD\n- **`workflows/ci.yml`** - Comprehensive CI workflow with Linux, QEMU, cocotb, and FreeBSD jobs\n\n### Documentation \u0026 Configuration\n- **`REPOSITORY_SETTINGS.md`** - Recommended GitHub repository settings (branch protection, required checks, etc.)\n- **`labels.yml`** - Recommended label structure for issue/PR management\n- **`README.md`** - This file\n\n## Quick Start for Maintainers\n\n### 1. Configure Repository Settings\nFollow the checklist in `REPOSITORY_SETTINGS.md` to set up:\n- Branch protection for `main`\n- Required status checks\n- Dependabot alerts\n- Private vulnerability reporting\n\n### 2. Apply Label Structure (Optional)\nUse the label definitions in `labels.yml`:\n```bash\n# Using github-label-sync (install from npm)\nnpm install -g github-label-sync\ngithub-label-sync --access-token $GITHUB_TOKEN owner/hydra .github/labels.yml\n```\n\nOr apply labels manually via GitHub UI.\n\n### 3. Enable Branch Protection\nIn repository Settings → Branches:\n- Add rule for `main` branch\n- Require PR reviews (1 approval minimum)\n- Require status checks: `linux`, `cocotb`, `freebsd-kmod`\n- Block force pushes and deletions\n\n### 4. Test Issue/PR Templates\n- Create a test issue to verify templates render correctly\n- Open a test PR to verify the PR template appears\n- Ensure CODEOWNERS triggers review requests\n\n## For Contributors\n\n### Reporting Bugs\nUse the bug report template - it will guide you through:\n- Selecting the affected component\n- Providing reproduction steps\n- Including environment details\n- Attaching logs or screenshots\n\n### Requesting Features\nUse the feature request template to describe:\n- The problem you're trying to solve\n- Your proposed solution\n- Relevant use cases\n\n### Opening Pull Requests\nThe PR template will remind you to:\n- Run the test suite (`./scripts/hydra_dev_loop.sh`)\n- Mark which components are affected\n- Provide screenshots for visual changes\n- Update documentation if needed\n\n### Security Issues\n**Do not open public issues for security vulnerabilities.**\nInstead, follow the process in `SECURITY.md`:\n- Use GitHub's private vulnerability reporting\n- Or email maintainers directly with \"SECURITY\" in subject\n\n## Maintenance Notes\n\n### Dependabot PRs\nDependabot will automatically create PRs for:\n- GitHub Actions updates (weekly on Monday)\n- Python dependency updates (weekly on Monday)\n\nReview and merge these PRs after CI passes.\n\n### CI Workflow Updates\nWhen modifying workflows:\n- Test changes on a feature branch first\n- Ensure required checks still pass\n- Update `REPOSITORY_SETTINGS.md` if required checks change\n\n### Label Management\nPeriodically review labels:\n- Archive unused labels\n- Add new labels for emerging patterns\n- Update `labels.yml` to reflect changes\n\n## Integration Status\n\n✅ **Completed:**\n- Issue templates (bug report, feature request)\n- Pull request template\n- CODEOWNERS file (configured with @dosadi)\n- Security policy\n- Dependabot configuration\n- Label structure definition\n- CI workflow consolidation (removed redundant workflows)\n- Repository settings guide\n\n⚠️ **Requires Manual Configuration:**\n- Applying branch protection rules (requires admin access via GitHub UI)\n- Creating labels via GitHub UI or sync tool\n- Enabling required status checks in branch protection\n\n## Resources\n\n- [GitHub Documentation](https://docs.github.com)\n- [Branch Protection Rules](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)\n- [CODEOWNERS](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners)\n- [Dependabot](https://docs.github.com/en/code-security/dependabot)\n- [Issue Templates](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdosadi%2Fhydra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdosadi%2Fhydra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdosadi%2Fhydra/lists"}