Skip to content

Architecture Decision Records

# Title Status
001 Technology Stack — Python + pyelftools + castxml Accepted — implemented
002 Multi-binary / release compare UX and architecture Accepted — implemented
003 Data Source Architecture — checks, instruments, and binary types (+ exploratory binary fingerprint extension) Accepted — implemented
004 Report Filtering, Deduplication, and Leaf-Change Mode Accepted — implemented
005 Application Compatibility Checking Accepted — implemented
006 Package-Level Comparison Accepted — implemented
007 BTF and CTF Debug Format Support Accepted — implemented
008 Full-Stack Dependency Validation Accepted — implemented
009 Verdict System and Exit Code Contract Accepted — implemented
010 Policy Profile System Accepted — implemented
011 ABI Change Classification Taxonomy Accepted — implemented
012 ABICC Drop-In Compatibility Layer Accepted — implemented
013 Suppression System Design Accepted — implemented
014 Output Format Strategy Accepted — implemented
015 Snapshot Serialization and Schema Versioning Accepted — implemented
016 Three-Tier Visibility Model Accepted — implemented
017 GitHub Action Design Accepted — implemented
018 Cross-Platform Binary Format Support Accepted — implemented
019 Testing Strategy and Parity Validation Accepted — implemented
020a Build-Context Aware Header Extraction Accepted — implemented
020b SYCL and Heterogeneous Computing Stack Support Accepted — implemented
021a Debug Artifact Resolution Subsystem Accepted — implemented
021b MCP Security Model Accepted — implemented
022 Baseline Registry and Snapshot Distribution Accepted — implemented
023 Bundle-Aware Multi-Binary ABI Analysis Accepted — implemented
024 Public ABI Surface Resolution and False-Positive Traceability Accepted — implemented
025 PR-Diff-Aware ABI Evaluation (Source Diff as Trigger and Localizer) Proposed
026 Source-Only Changes and the Evidence-Tier Boundary Accepted
027 API Surface Intelligence — Structure Metrics, Idiom Detection, Cross-Library Reasoning, Pattern-Aware Verdicts Accepted
028 Optional Source and Build Evidence Pack Architecture Accepted — implemented
029 Build Graph and Toolchain Context Capture Accepted — implemented
030 Source ABI Replay and Linked Source Surface Accepted — implemented
031 Source and Implementation Graph Augmentation Accepted — implemented
032 Evidence Extractor Plugin Interface and Security Model Accepted — implemented
033 CI Rollout, Performance, Caching, and Validation Strategy Accepted — implemented
034 Managed-Runtime and Non-C ABI Frontends Proposed
035 PR-Tier Source Intelligence and Cross-Source Validation Accepted — implemented (G19, D1–D10)
036 Report view-model and canonical report severity Accepted
037 CLI Interface Contract, Configuration Balance, and Extension Policy Accepted — implemented (G22)
Gap Analysis Decisions Needing Formal ADRs (historical snapshot, archived) Reference