git.stella-ops.org/src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Disassembly.Iced/AGENTS.md

Iced Disassembly Plugin Charter

Mission

Provide high-performance x86/x86-64 disassembly via Iced library. Serve as the primary plugin for Intel/AMD binary analysis due to superior speed.

Responsibilities

• Implement IDisassemblyPlugin using Iced library
• Support ELF, PE formats on x86 and x86-64 architectures
• Provide fast-path disassembly for Intel/AMD binaries
• Map Iced instruction models to abstraction layer

Key Paths

• IcedDisassemblyPlugin.cs - Main plugin implementation
• IcedInstructionMapper.cs - Map Iced types to abstraction models
• ElfLoader.cs / PeLoader.cs - Format-specific binary loading

Dependencies

• Iced (NuGet, MIT license) - Fast x86/x86-64 disassembler
• StellaOps.BinaryIndex.Disassembly.Abstractions

Coordination

• Disassembly.Abstractions for interface contracts
• DisassemblyService for plugin registration (preferred for x86/x86-64)
• B2R2 plugin as fallback for unsupported features
• Normalization pipeline for X64 instructions

Required Reading

• Iced documentation: https://github.com/icedland/iced
• docs/implplan/SPRINT_20260102_001_BE_binary_delta_signatures.md

Working Agreement

1. Update task status in sprint file when starting/finishing work.
2. Iced should be preferred plugin for x86/x86-64 due to performance.
3. Report capabilities accurately (no ARM, MIPS, etc.).
4. Handle malformed binaries gracefully without crashing.
5. Keep Iced NuGet version pinned for reproducible builds.