Skip to content

v0.5.1: Windows polish (shell syntax, README)#22

Merged
MasonStation merged 3 commits intomainfrom
windows-polish-v0.5.1
Apr 22, 2026
Merged

v0.5.1: Windows polish (shell syntax, README)#22
MasonStation merged 3 commits intomainfrom
windows-polish-v0.5.1

Conversation

@MasonStation
Copy link
Copy Markdown
Contributor

Windows polish pass before first npm publish. Keeps the first-run experience sane for Windows users.

Summary

  • cli(start): shell-aware env-var syntax (cli: print shell-specific env-var syntax for phantom start #21) — detect `$SHELL` / `$PSModulePath` / cfg(windows) and emit bash `export X=Y`, PowerShell `$env:X = "Y"`, or cmd `set X=Y`. Prints a one-line hint with the alternatives. Previously printed bash unconditionally.
  • docs: README Windows section (docs: add Windows setup section to README #12) — install, env-var syntax per shell, Smart App Control note, known gaps link.
  • chore: version 0.5.0 → 0.5.1 — workspace + npm + cli.js VERSION.

Test plan

  • CI green on `ubuntu-latest`
  • CI green on `macos-latest`
  • CI green on `windows-latest`
  • Manual Windows smoke test per PowerShell block in the plan after v0.5.1 binaries build

Release flow after merge

  1. Tag `v0.5.0` → wait — actually `v0.5.1`. Pushing the tag triggers `release.yml`.
  2. Smoke test the Windows binary.
  3. Co-founder adds npm maintainer, `npm publish` from `npm/`.

Closes #12, #21

MasonStation and others added 3 commits April 22, 2026 14:44
Detects the user's shell and emits one variant of the env-var
assignment the user needs to paste. First-match-wins rules:

  1. $SHELL contains bash/zsh/fish/sh -> export X=Y
  2. $PSModulePath is set              -> $env:X = "Y"
  3. cfg(windows)                      -> set X=Y
  4. fallback                          -> export X=Y

After the block, prints a one-line hint with the alternatives so
users can self-correct if detection misfires (Git Bash on Windows
correctly falls into case 1 via $SHELL).

Previously printed bash 'export X=Y' unconditionally, which failed
when pasted into PowerShell or cmd on Windows.

Closes #21

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Covers:
  - npx phantom-secrets init works unchanged
  - PowerShell / cmd / Git Bash export-syntax reference
  - SAC / Mark-of-the-Web troubleshooting
  - Known platform gaps (clipboard auto-clear, ARM64)

Closes #12

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
  - workspace 0.5.0 -> 0.5.1 (rolls through all 5 crates)
  - npm/package.json 0.5.0 -> 0.5.1
  - npm/bin/cli.js VERSION 0.5.0 -> 0.5.1
  - Cargo.lock refreshed via cargo update --workspace --offline
    (5 workspace entries only; no transitive dep changes)

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@MasonStation MasonStation merged commit 870d079 into main Apr 22, 2026
3 of 4 checks passed
@MasonStation MasonStation deleted the windows-polish-v0.5.1 branch April 22, 2026 18:45
@MasonStation MasonStation mentioned this pull request Apr 26, 2026
14 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add Windows setup section to README

1 participant