docs: add stub package and binary distribution flow documentation

- Document CI/CD build matrix for 6 platform/arch combinations
- Explain GitHub release storage and versioning
- Detail npm package structure and postinstall mechanism
- Document platform detection and binary download logic
- Add update mechanism for stub vs CLI updates
- Include security considerations and local development workflow
- Provide troubleshooting guide for common issues

Author: jdalton