Prepare repository for submodule embedding

[SWORDIntel]

Summary

• streamline root documentation and add a dedicated integration guide for submodule consumers
• move legacy root documents into docs/archive to declutter the entrypoint
• add a unified public API module to simplify decoder use from parent projects

Testing

• cargo fmt

---

Codex Task

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.