stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
5d5e80b2e443d61f74451920405b4e894ef28b4e
git.stella-ops.org/src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Disassembly.Abstractions/AGENTS.md
master 5d5e80b2e4 stabilize tests
2026-02-01 21:37:40 +02:00

1.7 KiB
Raw Blame History

Disassembly Abstractions Charter

Mission

Define the platform-agnostic disassembly interfaces and models for binary analysis. Enable multiple disassembly backends (Iced, B2R2) to be plugged in without changing consuming code.

Responsibilities

  • Maintain IDisassemblyPlugin interface defining disassembly capabilities
  • Define IDisassemblyService for coordinated plugin selection and fallback
  • Provide format-neutral models: DisassembledInstruction, BinaryInfo, SymbolInfo, CodeRegion
  • Keep interfaces stable to minimize breaking changes for plugin implementations
  • Ensure deterministic output contracts

Key Paths

  • IDisassemblyPlugin.cs - Plugin contract with capability reporting
  • IDisassemblyService.cs - Service coordinating multiple plugins
  • Models/BinaryInfo.cs - Binary metadata (format, architecture, ABI)
  • Models/DisassembledInstruction.cs - Decoded instruction with operands
  • Models/SymbolInfo.cs - Function/symbol metadata
  • Models/CpuArchitecture.cs - Supported architecture enum

Coordination

  • Disassembly plugin implementers (Iced, B2R2)
  • Normalization pipeline consumers
  • Scanner team for binary vulnerability analysis

Required Reading

  • docs/modules/binary-index/architecture.md
  • docs-archived/implplan/2026-01-02-completed-sprints/SPRINT_20260102_001_BE_binary_delta_signatures.md

Working Agreement

  1. Update task status to DOING/DONE in sprint file when starting/finishing work.
  2. Review this charter and Required Reading before coding.
  3. Keep models immutable and serialization-friendly.
  4. Add capability flags to IDisassemblyPlugin rather than extending interface.
  5. Document all public types with XML doc comments.