Release 2.8.0
Project explanation and Git history commands, consistent project naming, five README translations, and the adapter foundation for future project targets.
Added
- fsd explain summarizes the project stack and slices. fsd explain --tour writes ONBOARDING.md; use --force to replace an existing file. App/shared segments are shown separately and excluded from the total slice count.
- fsd history samples the last 50 Git commits, counts changed-file touches by layer, ranks the most-touched slices and prints a timeline. Use --limit <n> to change the sample size. App/shared segments are excluded from slice ranking.
- Project-target flags and target-aware framework selection. Web is the only implemented creation target; multi-web, mobile and universal are not yet available.
- README translations in Russian, Simplified Chinese, Spanish, Brazilian Portuguese and Japanese, plus a GitHub star link after successful project creation.
Changed
- Framework adapter contract v2, adapter-derived capabilities and a shared family-generator interface. The public plugin API remains a proposal, not an implemented plugin system.
Fixed
- New projects use their own normalized package name and titles instead of inheriting the template identity. --package-name sets a package name independently of the project folder.
- History classification supports Windows junctions, symlinked checkouts and projects nested in a repository. The CLI entry point retains its executable permission.
Compatibility
- Published npm gitHead: 6496a11077b28d51d42a987bc26c8cbb577ba9ce; tagged v2.8.0. Node.js 22.12.0 or later remains required.
- 262 local CLI tests passed. Published-artifact smoke passed for React/Vite and Next.js with npm locally and on Ubuntu; other artifact combinations are not certified by that smoke.
Use this version
bash
npx create-fsd-architecture@2.8.0Installing a newer CLI alone does not migrate an existing project. Review compatibility notes, then use the documented upgrade command.