{"id":50786993,"url":"https://github.com/maskdotdev/heimdall","last_synced_at":"2026-06-12T08:33:02.512Z","repository":{"id":355959121,"uuid":"1230316191","full_name":"maskdotdev/heimdall","owner":"maskdotdev","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-14T19:07:28.000Z","size":5760,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-14T21:12:50.493Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maskdotdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2026-05-05T22:05:40.000Z","updated_at":"2026-05-14T19:07:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/maskdotdev/heimdall","commit_stats":null,"previous_names":["maskdotdev/heimdall"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maskdotdev/heimdall","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maskdotdev%2Fheimdall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maskdotdev%2Fheimdall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maskdotdev%2Fheimdall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maskdotdev%2Fheimdall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maskdotdev","download_url":"https://codeload.github.com/maskdotdev/heimdall/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maskdotdev%2Fheimdall/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34236551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-06-12T08:33:01.846Z","updated_at":"2026-06-12T08:33:02.506Z","avatar_url":"https://github.com/maskdotdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Heimdall\n\nHeimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.\n\n## Repository Layout\n\n```txt\napps/\n  web/                    User-facing review dashboard.\n\nservices/\n  api/                    API and control-plane service.\n  workflows/              Temporal workflow definitions and worker service.\n\nworkers/\n  code-intel/       Clone, diff, parsing, graph, and related-file worker.\n  review/           LLM agents, context packing, validation, and ranking worker.\n  scanner/          Semgrep, CodeQL, secrets, and deterministic scanner worker.\n  publisher/        GitHub and GitLab publishing worker.\n  indexer/              Optional high-performance indexer for later.\n\ncontracts/\n  proto/                   Internal cross-language Protobuf contracts.\n  openapi/                 Public and internal HTTP API contracts.\n  schemas/                 LLM and event JSON schemas.\n  generated/               Generated Go, TypeScript, and Python contract outputs.\n\npackages/\n  ts-api-client/            Typed frontend API client.\n  ui/                       Shared frontend UI components.\n\ninfra/\n  docker/                  Container definitions.\n  k8s/                     Kubernetes base manifests and overlays.\n  terraform/               Cloud infrastructure modules and environments.\n  temporal/                Task queue and worker configuration.\n  migrations/              Database migrations.\n\ntools/\n  scripts/                 Reusable repository automation scripts.\n  dev/                     Local development helpers.\n  ci/                      CI-only helpers.\n\ndocs/\n  architecture/            System design and pipeline documentation.\n  decisions/               Architecture decision records.\n  runbooks/                Operational response guides.\n\ntests/\n  fixtures/                Repository, diff, and provider fixtures.\n  integration/             Cross-service integration tests.\n  evals/                   Review-quality evaluation datasets and runners.\n```\n\n## Boundary Rules\n\n- `apps/` contains user-facing applications only.\n- `services/` contains durable backend and control-plane services.\n- `workers/` contains asynchronous execution pools.\n- `contracts/` defines shared API, event, model, and generated contract artifacts.\n- `packages/` contains frontend-only shared packages unless a future package has a documented owner.\n- `infra/` contains deployment and environment setup.\n- `tests/` contains integration fixtures and review-quality evals.\n\nKeep service and worker boundaries explicit. Do not let the web app invent its own versions of review runs, diffs, context bundles, findings, or provider references.\n\n## Review Pipeline\n\n```txt\napps/web\n  User selects a repository and change request.\n\nservices/api\n  Creates a review run, stores state, and starts a workflow.\n\nservices/workflows\n  Orchestrates durable review steps.\n\nworkers/code-intel\n  Clones the repository, parses the diff, builds code graph context, and finds related files.\n\nworkers/scanner\n  Runs deterministic static-analysis and secret-scanning tools.\n\nworkers/review\n  Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.\n\nservices/api\n  Serves review state and findings back to the web app.\n\nworkers/publisher\n  Publishes approved comments back to GitHub or GitLab.\n```\n\n## Documentation Entry Points\n\n- [Architecture overview](docs/architecture/overview.md)\n- [Review pipeline](docs/architecture/review-pipeline.md)\n- [Context bundle](docs/architecture/context-bundle.md)\n- [Finding validation](docs/architecture/finding-validation.md)\n- [Code intelligence](docs/architecture/code-intelligence.md)\n- [VCS integration](docs/architecture/vcs-integration.md)\n- [Sandboxing](docs/architecture/sandboxing.md)\n- [Scaling](docs/architecture/scaling.md)\n- [Tech stack](docs/tech-stack.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaskdotdev%2Fheimdall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaskdotdev%2Fheimdall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaskdotdev%2Fheimdall/lists"}