forked from gsd-build/get-shit-done
-
Notifications
You must be signed in to change notification settings - Fork 1
Add Windows support with CI/CD testing #3
Copy link
Copy link
Open
Labels
Description
Summary
nForma currently only supports macOS and Linux. Windows is explicitly listed as unsupported in the README and compatibility table. This issue tracks adding first-class Windows support.
Current state
- CI matrix:
ubuntu-latest+macos-latestonly (ci.yml, ci-install.yml, release.yml) package.jsonengines:>=18.0.0, noosrestriction- README: "Works on macOS and Linux." — Windows row says "No"
- Codebase: No
process.platformchecks anywhere. Several bash scripts inscripts/(release.sh, secret-audit.sh, publish.sh) assume Unix
Requirements
CI/CD (high priority)
- Add
windows-latesttoci.ymltest matrix (Node 18, 20, 22) - Add
windows-latesttoci-install.ymlinstall test matrix - Add
windows-latesttorelease.ymlpre-release test job - Verify
npm run test:cipasses on Windows - Verify
npm run test:tuipasses on Windows (blessed + node-pty compatibility) - Verify
npm run test:installpasses on Windows - Verify
npm run test:formalpasses on Windows (Java/TLA+/Alloy availability)
Codebase fixes (expected)
- Audit all
path.join()/path.resolve()usage for hardcoded/separators - Replace bash-specific
scripts/with cross-platform alternatives (or skip on Windows) - Test
node-pty/blessed-xtermnative addon rebuild on Windows - Verify keychain/secrets integration works on Windows (macOS
securityCLI won't exist) - Test MCP server spawning (
child_process.spawn) with Windows paths - Verify hook installation paths work on Windows (
~/.claude/→%USERPROFILE%\.claude\)
Documentation
- Update README compatibility table: Windows → "Yes"
- Update "Works on macOS and Linux" → "Works on macOS, Linux, and Windows"
- Document any Windows-specific prerequisites (e.g., Visual Studio Build Tools for node-pty)
Acceptance criteria
- All three CI workflows pass on
windows-latestwith Node 18, 20, 22 npx @nforma.ai/nformainstalls and runs the TUI on Windows- Sessions can spawn Claude Code inside the TUI on Windows
- Quorum agent MCP servers start and respond to health checks on Windows
Notes
The biggest risk is node-pty (native addon for terminal emulation in the TUI Sessions module). It requires Visual Studio Build Tools on Windows. Consider whether to make Sessions an optional feature on Windows or bundle a prebuilt binary.
Reactions are currently unavailable