Cross-platform: macOS/Linux claimed but never built or run

[krishpinto]

Problem

Only built/tested on Windows (GNU toolchain). macOS/Linux are claimed but unverified.

Acceptance criteria

• Build on macOS and Linux (CI or manual).
• Path/config handling verified cross-platform.
• README states real support status honestly.