Skip to content
Merged
Next Next commit
chore(FIX-890): add changeset for filesystem nested-layout store change
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WdNcANsuBvoc3iw6JXNKyX
  • Loading branch information
claude committed Jul 16, 2026
commit 13fbcbebcf0b8324a78140ee7d2c8d6b20aa075c
6 changes: 6 additions & 0 deletions .changeset/fix-890-filesystem-nested-layout.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
"@flow-state-dev/engine": minor
"@flow-state-dev/cli": minor
---

The filesystem content and state stores now persist each resource as a real nested file: a key like `concepts/flow-state-dev/overview` lands at `concepts/flow-state-dev/overview.md` (content) or `.json` (state), so the store directory is a browsable, diffable file tree instead of flat percent-encoded names with no extension. The store API is unchanged. A store directory written in the old flat layout is detected and refused with a clear error rather than silently misread — move it aside or delete it to upgrade. Filesystem-backed keys narrow slightly on this backend: an empty path segment or a Windows reserved device name is rejected loudly, and on case-insensitive volumes keys differing only in case can still collide.