Update README Observations

Workflow

• Audit README.md against src/types.nim, src/environment.nim, and src/ffi.nim.
• Update README sections for features and observation layout.
• Call out any open questions.