Correct assembler CLI documentation to describe ELF object output #146

Current evidence

Audit baseline: Whale a254da9e after #131 (2026-09-22). docs/cli/asm.md still says AMD64 is fully supported and that whale asm produces raw .bin data, despite the command writing ObjectFile ELF64 bytes. #24 updated README, leaving this separate CLI page stale.

Whale docs/cli/asm.md

Whale src/commands/asm.rs

Scope

Difficulty: easy.

Update the assembler CLI page to describe relocatable ELF64 output, the supported instruction subset, current architecture limitations, and real output/debug options. Verify examples against the current CLI.

Completion criteria

• Examples use an object suffix and identify ELF relocatable output.
• No full-AMD64 or raw-binary capability is claimed.
• Documented flags and examples match actual help and successful invocations.

Dependencies and boundaries

Backlog index: #12. This issue owns only the bounded work described above. Tests must run without an external assembler dependency.

Suggested start: follow the linked implementation, add the smallest failing regression, then run the affected crate tests and the documented workspace checks.