Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Repository files navigation

Heimdall

Heimdall is an automated code review system. The repository is structured as a monorepo with strong service boundaries.

Repository Layout

apps/
web/ User-facing review dashboard.
services/
api/ API and control-plane service.
workflows/ Temporal workflow definitions and worker service.
workers/
code-intel/ Clone, diff, parsing, graph, and related-file worker.
review/ LLM agents, context packing, validation, and ranking worker.
scanner/ Semgrep, CodeQL, secrets, and deterministic scanner worker.
publisher/ GitHub and GitLab publishing worker.
indexer/ Optional high-performance indexer for later.
contracts/
proto/ Internal cross-language Protobuf contracts.
openapi/ Public and internal HTTP API contracts.
schemas/ LLM and event JSON schemas.
generated/ Generated Go, TypeScript, and Python contract outputs.
packages/
ts-api-client/ Typed frontend API client.
ui/ Shared frontend UI components.
infra/
docker/ Container definitions.
k8s/ Kubernetes base manifests and overlays.
terraform/ Cloud infrastructure modules and environments.
temporal/ Task queue and worker configuration.
migrations/ Database migrations.
tools/
scripts/ Reusable repository automation scripts.
dev/ Local development helpers.
ci/ CI-only helpers.
docs/
architecture/ System design and pipeline documentation.
decisions/ Architecture decision records.
runbooks/ Operational response guides.
tests/
fixtures/ Repository, diff, and provider fixtures.
integration/ Cross-service integration tests.
evals/ Review-quality evaluation datasets and runners.

Boundary Rules

  • apps/ contains user-facing applications only.
  • services/ contains durable backend and control-plane services.
  • workers/ contains asynchronous execution pools.
  • contracts/ defines shared API, event, model, and generated contract artifacts.
  • packages/ contains frontend-only shared packages unless a future package has a documented owner.
  • infra/ contains deployment and environment setup.
  • tests/ contains integration fixtures and review-quality evals.

Keep 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.

Review Pipeline

apps/web
User selects a repository and change request.
services/api
Creates a review run, stores state, and starts a workflow.
services/workflows
Orchestrates durable review steps.
workers/code-intel
Clones the repository, parses the diff, builds code graph context, and finds related files.
workers/scanner
Runs deterministic static-analysis and secret-scanning tools.
workers/review
Builds context bundles, runs reviewer agents, validates findings, deduplicates findings, and ranks output.
services/api
Serves review state and findings back to the web app.
workers/publisher
Publishes approved comments back to GitHub or GitLab.

Documentation Entry Points

About

Automated code review system with code-intel, scanner, review, validation, and publishing workers.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages