docs/developer.md

Developer Guide

This guide describes how to extend ARIA by adding new analysis services and wiring them into the build pipeline.

1. Adding a New Analysis Service

1. Create a new service under services/, e.g., services/security_scanner_service.py.
2. Define a class implementing the analysis logic:

   class SecurityScannerService:
       def build(self, repo_name: str, repo_path: str = None, files: list = None) -> None:
           # Perform analysis and save results using snapshot_store
           from backend.dependencies import snapshot_store
   
           snapshot_store.save(repo_name, "security_issues", {"issues": []})
   

2. Registering the Service in the DAG

Open backend/dependencies.py and register your service class on the analysis_registry singleton:

# Import your new service class
from services.security_scanner_service import SecurityScannerService

# Register in DAG
analysis_registry.register(
    "Security Scan",
    SecurityScannerService,
    dependencies=["Symbol Index"],  # Run after Symbol Index completes
    outputs=["security_issues"],
)

The ExecutionScheduler will automatically place your task in the correct execution stage, and the ParallelExecutionRunner will schedule it concurrently. No manual threading or stage management is needed!