github OthmanAdi/planning-with-files v3.2.0
v3.2.0: v3 health audit (session-catchup + inject-plan Windows fixes, 0/0-phases guard)

4 hours ago

What changed:

  • session-catchup.py, the mechanism behind resuming a session after /clear, did nothing on Windows. Path sanitization never handled Windows-style paths, and three file reads had no explicit encoding, so the feature silently produced no output on Windows with no error. Both fixed.
  • inject-plan.sh's containment guard silently dropped plan re-injection and tamper detection on Windows paths reached through an 8.3 short name or the MSYS /tmp mount alias, again with no visible error. Fixed.
  • task_plan.md files without ### Phase headings were falsely reported as "0/0 phases complete" (#191, reported by @mixian939). Found and fixed the same defect in the canonical Claude Code scripts, Codex, Cursor, and GitHub Copilot's adapters, plus every synced IDE mirror.
  • The --template analytics flag (shipped v2.29.0) was silently falling back to default templates in every installed skill package. The analytics templates now ship where init-session.sh actually reads them (addresses #103).
  • Merged PR #187 (@Stephen-abc): Windows test-suite encoding fixes plus corrections to four installation guides that referenced folders removed in v2.24.0.
  • Merged PR #192 (@igorcosta): Autohand Code setup docs, now in the supported-IDEs table.
  • Added SECURITY.md and enabled GitHub private vulnerability reporting (closes #188, requested by @AvitalAviv).
  • Corrected AGENTS.md, which told agents to squash-merge contributor PRs in a way that reassigns their commit authorship. Also fixed a Windows-only Hermes adapter test failure and a templates/references mislabel in docs/codebuddy.md.

Verification: Python suite at 186 passed, 5 skipped, 0 failed. sync-ide-folders.py --verify clean. The long-running-session mechanism was re-tested end to end on Windows after the fixes; results are documented in docs/evals.md, Test 4.

Thanks: @mixian939 for the #191 diagnosis, @Stephen-abc and @igorcosta for their PRs, @AvitalAviv for flagging the missing security channel, and @mvanhorn for the original analytics templates this release finally ships correctly.

Don't miss a new planning-with-files release

NewReleases is sending notifications on new releases.