Skip to content

docs(stormtest): Windows/cross-platform pathing heads-up (stacked on #510)#512

Merged
dsarno merged 1 commit into
mainfrom
claude/outstanding-repo-issues-AHLFv
Jun 1, 2026
Merged

docs(stormtest): Windows/cross-platform pathing heads-up (stacked on #510)#512
dsarno merged 1 commit into
mainfrom
claude/outstanding-repo-issues-AHLFv

Conversation

@dsarno

@dsarno dsarno commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a Windows / cross-platform pathing heads-up for stormtest — a docs callout in docs/STRESS_TESTING.md plus a one-line pointer in AGENTS.md. No code changes.

The harness logic is already platform-agnostic (in-editor res://_stormtest/… scratch paths use Godot's virtual filesystem; the host-side report path goes through tempfile.gettempdir() / os.path.join). What's POSIX-only is the invocation — so the note flags, for agents running it on Windows:

  • venv interpreter: .venv\Scripts\python.exe, not .venv/bin/python
  • script/serve-this-worktree is bash → Git Bash / WSL, or start the --reload server by hand
  • $TMPDIR%TEMP%, with a forward-slash tip for an explicit SS_REPORT

The note advertises its own removal once the runner is made resilient, tracked in #509.

⚠️ Stacked on #510 — merge after it

docs/STRESS_TESTING.md and the AGENTS.md stress section are introduced by #510 (the stormtest harness), which isn't on main yet. This branch is based on test/stormtest-harness, so until #510 merges this PR's diff will also show #510's harness files; once #510 lands in main, the diff here collapses to just the ~23-line note. Please merge #510 first, then this.

Context: this is the rescued note from the now-closed integration branch #506 — kept off #510 itself to leave that PR clean, per request.

https://claude.ai/code/session_01Jq5X4ivngAf1N6r5UX2BVw


Generated by Claude Code

Reads/writes concurrency is platform-agnostic and works on Windows, but
reload churn (SS_RELOAD=1, the default) currently does not. Against a
plugin-managed server the harness wedges past CALL_TIMEOUT when the server
is killed mid-reload under load (#513); the documented "run the server
externally" mitigation also fails on Windows because serve-this-worktree is
bash-only and a hand-started --reload server gets killed by the reload (#514).
The editor itself survives reloads. Also documents the POSIX->Windows
invocation differences (venv path, $TMPDIR -> %TEMP%). Resilience tracked
in #509.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dsarno dsarno force-pushed the claude/outstanding-repo-issues-AHLFv branch from 28da13a to fb6bad9 Compare June 1, 2026 23:35
@dsarno dsarno merged commit 58b9468 into main Jun 1, 2026
15 checks passed
@dsarno dsarno deleted the claude/outstanding-repo-issues-AHLFv branch June 1, 2026 23:37
@codecov

codecov Bot commented Jun 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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.

1 participant