Windows port implementation tracking

[coneilen]

Goal

Deliver a native Windows x64 port of GraphCode while preserving the shared Swift
orchestration model, persistent terminal sessions, POSIX remote-host support, and the
application's terminal-first visual identity.

Provider streams

• Winghostty host extraction: https://github.com/coneilen/winghostty
• zmx Windows backend: https://github.com/coneilen/zmx

Execution rules

• Red/green/refactor TDD for every feature and bug fix.
• Dedicated worktree per task.
• Green, DCO-signed commits cherry-picked individually into the Windows integration branch.
• Provider commits pinned before GraphCode consumes them.
• Existing macOS behavior remains green throughout.

Durable task registry

• win-bootstrap — validation matrix, forks, tracking, worktree conventions
• win-tdd-harness — RED/GREEN/REGRESSION evidence and deterministic fixtures
• win-contracts — platform/protocol/provider/remote contracts
• win-swift-platform — shared Swift package, paths, process, shell
• win-protocol-dualstack — v1 compatibility and v2 correlation/subscriptions
• win-daemon-pipe — Windows daemon and CLI
• win-wing-baseline / win-wing-host-api / win-wing-* — terminal host extraction
• win-zmx-rebase / win-zmx-platform / win-zmx-* — real zmx Windows backend
• win-remote-spike / win-remote-bridge / win-remote-e2e — POSIX remote parity
• win-terminal-gate — two complete persistent terminal surfaces
• win-shell-scaffold — native Zig/Win32 GraphCode shell
• win-sidebar / win-canvas / win-workspace / win-forms / win-attention-worktree
• win-ui-integrate — visual, keyboard, DPI, IME, and accessibility integration
• win-packaging / win-hardening / win-final-pr

Each task update should record repository, branch/worktree, base SHA, owner, RED command
and failure, GREEN command and result, regression command, provider pin, PR, integration
commit, blockers, and next dependency.

[coneilen]

Bootstrap update

• win-bootstrap: complete
  • DCO-corrected investigation commit: fa16278
  • Windows validation matrix: 9c6d804
  • Winghostty fork: https://github.com/coneilen/winghostty
  • zmx fork: https://github.com/coneilen/zmx
• win-tdd-harness: complete
  • TDD enforcement and durable plan: 9d0584c

TDD evidence

• RED: Tools/windows/Tests/ValidationRunner.Tests.ps1 failed because the runner/task did not exist; Tools/tdd/Tests/TddEvidence.Tests.ps1 failed because the validator did not exist.
• GREEN: both focused contracts pass.
• REGRESSION: Tools/windows/validate.ps1 -Task all passes on Windows with Swift 6.3.3; privacy and DCO range checks pass.

Next dependency: win-contracts.

[scgopi]

[graphcode-fixer] Classified as enhancement (out of scope for automated bug fixing): this is a tracking issue for a native Windows x64 port — a new platform capability spanning many work streams, not a report of broken behaviour in the current macOS app.

---

Generated by Claude Code

[coneilen]

Contract-base update

• win-contracts: complete
• Integrated GraphCode contract base: ece55b6

TDD evidence

• RED: swift-contracts failed because wire/platform types were absent; focused tests also caught version-1 envelopes, mixed-kind fields, ignored untracked Swift sources, and validation tasks deleting another task's resources.
• GREEN: 11 contract tests pass for frozen v1 decoding, strict v2 envelopes, negotiation, bounded framing, process requests, and remote bridge-state validation.
• REGRESSION: Tools/windows/validate.ps1 -Task all, privacy checks, concurrent validation isolation, and DCO range checks pass.

Provider/foundation branches must record ece55b6 as CONTRACT_BASE.

[coneilen]

Integrated win-visual-baseline as c13fbde. RED/GREEN visual contract, manifest validator, privacy, formatting, and deterministic fixture tests pass. Remote-spike branch is rebasing onto this commit before integration.