@vc-shell/vc-app-skill 2.0.0-alpha.33 → 2.0.0-alpha.34

package/CHANGELOG.md

@@ -1,18 +1,44 @@
-# [2.0.0-alpha.33](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.32...v2.0.0-alpha.33) (2026-04-14)
+# [2.0.0-alpha.34](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.33...v2.0.0-alpha.34) (2026-04-22)
 
 
 ### Bug Fixes
 
-* **vc-app-skill:** add VC_SHELL_MIGRATE_CLI env override for local testing ([010d2f2](https://github.com/VirtoCommerce/vc-shell/commit/010d2f2ecb29d31d9134406bcd18e46e5883208b))
-* **vc-app-skill:** resolve migrate CLI from project node_modules before npx fallback ([82a8156](https://github.com/VirtoCommerce/vc-shell/commit/82a81563f7fdb94a94a7b8a80796ecffc671a39c))
-* **vc-app-skill:** resolve migrate CLI locally in dev mode, fallback to npx ([89888a0](https://github.com/VirtoCommerce/vc-shell/commit/89888a06cc0b4a1519f46f070ee06ebb0d82fd09))
+* **datatable:** normalise date-range filter values to YYYY-MM-DD ([d89864a](https://github.com/VirtoCommerce/vc-shell/commit/d89864aa635e7479137fb0ad501197adf335f99e))
+* **migrate:** datatable prompt forbids 'removed filters for green build' shortcut ([af5ae8e](https://github.com/VirtoCommerce/vc-shell/commit/af5ae8e4259b435729e6cea9e4c61d74b41d3952))
+* **migrate:** use-data-table-pagination prompt — per-file scope skip ([8949f01](https://github.com/VirtoCommerce/vc-shell/commit/8949f01da97b69c15fc6e3a2fca951608731979c))
+
+
+### chore
+
+* **scripts:** normalize yarn scripts per industry standards ([1cdd0cb](https://github.com/VirtoCommerce/vc-shell/commit/1cdd0cb517d2436ef2a509c6b6c358f6a48630d1))
+
+
+### Features
+
+* **migrate:** add use-data-table-pagination-audit + AI migration prompt ([0c2e7b6](https://github.com/VirtoCommerce/vc-shell/commit/0c2e7b6efba387d9fafe04e5bdcd21ea20500259))
+* **migrate:** expand v2 migration tooling — icon/asset/audit prompts and blade-event cleanup ([f4788d4](https://github.com/VirtoCommerce/vc-shell/commit/f4788d4d9c588157ca5c11facfe558a69c254c2e)), closes [#41](https://github.com/VirtoCommerce/vc-shell/issues/41)
 
 
+### BREAKING CHANGES
+
+* **scripts:** for external consumers: old script names
+(storybook-serve, build-framework, check-locales etc) are removed.
+Legacy aliases are deliberately not provided — they would perpetuate
+the non-standard naming this commit eliminates.
+# [2.0.0-alpha.33](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.32...v2.0.0-alpha.33) (2026-04-14)
+
+### Bug Fixes
+
+- **vc-app-skill:** add VC_SHELL_MIGRATE_CLI env override for local testing ([010d2f2](https://github.com/VirtoCommerce/vc-shell/commit/010d2f2ecb29d31d9134406bcd18e46e5883208b))
+- **vc-app-skill:** resolve migrate CLI from project node_modules before npx fallback ([82a8156](https://github.com/VirtoCommerce/vc-shell/commit/82a81563f7fdb94a94a7b8a80796ecffc671a39c))
+- **vc-app-skill:** resolve migrate CLI locally in dev mode, fallback to npx ([89888a0](https://github.com/VirtoCommerce/vc-shell/commit/89888a06cc0b4a1519f46f070ee06ebb0d82fd09))
+
 ### Features
 
-* **vc-app-skill:** add /vc-app migrate command with full migration pipeline ([35a8b11](https://github.com/VirtoCommerce/vc-shell/commit/35a8b119457b14f6f4626caf133476222afd6663))
-* **vc-app-skill:** add migration prompt knowledge base (nswag, widgets, form, blade-props, notifications) ([a0b0eb2](https://github.com/VirtoCommerce/vc-shell/commit/a0b0eb2a96521916a72bdbf787961c1c96f96f6d))
-* **vc-app-skill:** add migration-agent subagent prompt ([29ac155](https://github.com/VirtoCommerce/vc-shell/commit/29ac1550c8e3c9b71d5dbc2ade7ea86b4d40213f))
+- **vc-app-skill:** add /vc-app migrate command with full migration pipeline ([35a8b11](https://github.com/VirtoCommerce/vc-shell/commit/35a8b119457b14f6f4626caf133476222afd6663))
+- **vc-app-skill:** add migration prompt knowledge base (nswag, widgets, form, blade-props, notifications) ([a0b0eb2](https://github.com/VirtoCommerce/vc-shell/commit/a0b0eb2a96521916a72bdbf787961c1c96f96f6d))
+- **vc-app-skill:** add migration-agent subagent prompt ([29ac155](https://github.com/VirtoCommerce/vc-shell/commit/29ac1550c8e3c9b71d5dbc2ade7ea86b4d40213f))
+
 # [2.0.0-alpha.32](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.31...v2.0.0-alpha.32) (2026-04-02)
 
 **Note:** Version bump only for package @vc-shell/vc-app-skill
@@ -23,10 +49,10 @@
 
 # [2.0.0-alpha.30](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.29...v2.0.0-alpha.30) (2026-03-30)
 
-
 ### Features
 
-* **docs:** add documentation for usePopup and useResponsive composables ([342a50a](https://github.com/VirtoCommerce/vc-shell/commit/342a50ada1545637782e01f5452a60839aa90fd2))
+- **docs:** add documentation for usePopup and useResponsive composables ([342a50a](https://github.com/VirtoCommerce/vc-shell/commit/342a50ada1545637782e01f5452a60839aa90fd2))
+
 # [2.0.0-alpha.29](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.28...v2.0.0-alpha.29) (2026-03-26)
 
 **Note:** Version bump only for package @vc-shell/vc-app-skill
@@ -49,43 +75,42 @@
 
 # [2.0.0-alpha.24](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.23...v2.0.0-alpha.24) (2026-03-25)
 
-
 ### Features
 
-* **vc-app-skill:** add knowledge-stats script for knowledge base audit ([7a568fc](https://github.com/VirtoCommerce/vc-shell/commit/7a568fc57335d51349a644721c904586efd49273))
-* **vc-app-skill:** enrich knowledge base with When to Use sections, patterns, and sync-docs script ([c82ed63](https://github.com/VirtoCommerce/vc-shell/commit/c82ed639d748bdc8fd2d9c39435ee37baedd0563))
-* **vc-app:** add sidebar search bar for menu filtering ([72f17fc](https://github.com/VirtoCommerce/vc-shell/commit/72f17fc5b0e77e4e87457c5a29262345da50317d)), closes [#menu](https://github.com/VirtoCommerce/vc-shell/issues/menu) [#menu](https://github.com/VirtoCommerce/vc-shell/issues/menu)
-# [2.0.0-alpha.23](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.22...v2.0.0-alpha.23) (2026-03-23)
+- **vc-app-skill:** add knowledge-stats script for knowledge base audit ([7a568fc](https://github.com/VirtoCommerce/vc-shell/commit/7a568fc57335d51349a644721c904586efd49273))
+- **vc-app-skill:** enrich knowledge base with When to Use sections, patterns, and sync-docs script ([c82ed63](https://github.com/VirtoCommerce/vc-shell/commit/c82ed639d748bdc8fd2d9c39435ee37baedd0563))
+- **vc-app:** add sidebar search bar for menu filtering ([72f17fc](https://github.com/VirtoCommerce/vc-shell/commit/72f17fc5b0e77e4e87457c5a29262345da50317d)), closes [#menu](https://github.com/VirtoCommerce/vc-shell/issues/menu) [#menu](https://github.com/VirtoCommerce/vc-shell/issues/menu)
 
+# [2.0.0-alpha.23](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.22...v2.0.0-alpha.23) (2026-03-23)
 
 ### Bug Fixes
 
-* **vc-app-skill:** add menuItem to standalone details blades (isWorkspace entry point) ([6be54ad](https://github.com/VirtoCommerce/vc-shell/commit/6be54ad38613ea0de865ab1348236417da8a572d))
-* **vc-app-skill:** auto-run yarn install after project scaffold ([cb9ada3](https://github.com/VirtoCommerce/vc-shell/commit/cb9ada34579f89121de5648eee65b346bcd4d924))
-
+- **vc-app-skill:** add menuItem to standalone details blades (isWorkspace entry point) ([6be54ad](https://github.com/VirtoCommerce/vc-shell/commit/6be54ad38613ea0de865ab1348236417da8a572d))
+- **vc-app-skill:** auto-run yarn install after project scaffold ([cb9ada3](https://github.com/VirtoCommerce/vc-shell/commit/cb9ada34579f89121de5648eee65b346bcd4d924))
 
 ### Features
 
-* **vc-app-skill:** add platform URL prompt and update design plan structure ([7855830](https://github.com/VirtoCommerce/vc-shell/commit/78558303247107ff55d5b0aeb3f5fdf50cad16f8))
-# [2.0.0-alpha.22](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.21...v2.0.0-alpha.22) (2026-03-23)
+- **vc-app-skill:** add platform URL prompt and update design plan structure ([7855830](https://github.com/VirtoCommerce/vc-shell/commit/78558303247107ff55d5b0aeb3f5fdf50cad16f8))
 
+# [2.0.0-alpha.22](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.21...v2.0.0-alpha.22) (2026-03-23)
 
 ### Bug Fixes
 
-* **vc-app-skill:** clarify app.use ordering — after framework, before router ([97439e4](https://github.com/VirtoCommerce/vc-shell/commit/97439e4cfedcae81a6fc26721b91d79187e95f1a))
-* **vc-app-skill:** register generated modules in main.ts (import + app.use) ([e88d75e](https://github.com/VirtoCommerce/vc-shell/commit/e88d75e86ed0d4f69d3261d3d04e3b68bfb3baa5))
-# [2.0.0-alpha.21](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.20...v2.0.0-alpha.21) (2026-03-23)
+- **vc-app-skill:** clarify app.use ordering — after framework, before router ([97439e4](https://github.com/VirtoCommerce/vc-shell/commit/97439e4cfedcae81a6fc26721b91d79187e95f1a))
+- **vc-app-skill:** register generated modules in main.ts (import + app.use) ([e88d75e](https://github.com/VirtoCommerce/vc-shell/commit/e88d75e86ed0d4f69d3261d3d04e3b68bfb3baa5))
 
+# [2.0.0-alpha.21](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.20...v2.0.0-alpha.21) (2026-03-23)
 
 ### Bug Fixes
 
-* **vc-app-skill:** use [@alpha](https://github.com/alpha) dist-tag for create-vc-app commands ([09b4a27](https://github.com/VirtoCommerce/vc-shell/commit/09b4a273116d9b04c00ff1c6ad19af2d869bd394))
-# [2.0.0-alpha.20](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.18...v2.0.0-alpha.20) (2026-03-23)
+- **vc-app-skill:** use [@alpha](https://github.com/alpha) dist-tag for create-vc-app commands ([09b4a27](https://github.com/VirtoCommerce/vc-shell/commit/09b4a273116d9b04c00ff1c6ad19af2d869bd394))
 
+# [2.0.0-alpha.20](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.18...v2.0.0-alpha.20) (2026-03-23)
 
 ### Bug Fixes
 
-* **vc-app-skill:** use [@alpha](https://github.com/alpha) dist-tag for update command and version check hook ([cceaab9](https://github.com/VirtoCommerce/vc-shell/commit/cceaab926a3a51160d8994891bc88445bfb9a9aa))
+- **vc-app-skill:** use [@alpha](https://github.com/alpha) dist-tag for update command and version check hook ([cceaab9](https://github.com/VirtoCommerce/vc-shell/commit/cceaab926a3a51160d8994891bc88445bfb9a9aa))
+
 # [2.0.0-alpha.19](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.18...v2.0.0-alpha.19) (2026-03-23)
 
 **Note:** Version bump only for package @vc-shell/vc-app-skill
@@ -96,43 +121,42 @@
 
 # [2.0.0-alpha.17](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.16...v2.0.0-alpha.17) (2026-03-23)
 
-
 ### Bug Fixes
 
-* **vc-app-skill:** correct mock template in details-blade-generator ([04b7d43](https://github.com/VirtoCommerce/vc-shell/commit/04b7d43dc12cb66ad786f91017e48c4c30e889e9))
-* **vc-app-skill:** validate runtime arg and fix command listing ([f7169af](https://github.com/VirtoCommerce/vc-shell/commit/f7169afa56092be2e223a61c0edd5b73cd653d77))
-
+- **vc-app-skill:** correct mock template in details-blade-generator ([04b7d43](https://github.com/VirtoCommerce/vc-shell/commit/04b7d43dc12cb66ad786f91017e48c4c30e889e9))
+- **vc-app-skill:** validate runtime arg and fix command listing ([f7169af](https://github.com/VirtoCommerce/vc-shell/commit/f7169afa56092be2e223a61c0edd5b73cd653d77))
 
 ### Features
 
-* **vc-app-skill:** add /vc-app design command documentation ([3cc59b2](https://github.com/VirtoCommerce/vc-shell/commit/3cc59b29831da7f2f78900c7f61354165583813e))
-* **vc-app-skill:** add /vc-app design phases 1-6 (prompt → plan → execute → summary) ([b0bb44f](https://github.com/VirtoCommerce/vc-shell/commit/b0bb44f47e28fe9df147c5941a15e76b5ae3d2f8))
-* **vc-app-skill:** add /vc-app design to routing table and help ([8b2f53e](https://github.com/VirtoCommerce/vc-shell/commit/8b2f53e7d8643f8ab87f3fab82dc4dd8c8bd44da))
-* **vc-app-skill:** add /vc-app promote command with 5-phase flow ([a3b6da6](https://github.com/VirtoCommerce/vc-shell/commit/a3b6da658322a1e39ffb9808d0e80bf732f52ae8))
-* **vc-app-skill:** add blade-enhancer agent for surgical module modifications ([bc83681](https://github.com/VirtoCommerce/vc-shell/commit/bc83681c99accd3a25b48a5da1916810a6393aa0))
-* **vc-app-skill:** add design-specific error handling scenarios ([5381685](https://github.com/VirtoCommerce/vc-shell/commit/5381685b75a7eac82add64314cab8269518ba53f))
-* **vc-app-skill:** add enhance flow to /vc-app generate for existing modules ([2936bd6](https://github.com/VirtoCommerce/vc-shell/commit/2936bd60946d4c63207682908a8edbb8f137e448))
-* **vc-app-skill:** add entry-point and update commands ([ab9075f](https://github.com/VirtoCommerce/vc-shell/commit/ab9075f49b1bb2d93f56613758d038ef1ca09d09))
-* **vc-app-skill:** add existingModule context and append mode to generators ([3978c66](https://github.com/VirtoCommerce/vc-shell/commit/3978c66aff3b2526f51227c560371be425018ad2))
-* **vc-app-skill:** add module-analyzer agent for existing module introspection ([9eaff6b](https://github.com/VirtoCommerce/vc-shell/commit/9eaff6b3ca829ce41298c739f26ba6bdf93a2adb))
-* **vc-app-skill:** add multi-runtime installer ([00e656e](https://github.com/VirtoCommerce/vc-shell/commit/00e656e65bef05ebe8e7cb29cbf2efe64b991f5a))
-* **vc-app-skill:** add promote-agent subagent for mock-to-API transformation ([27484e3](https://github.com/VirtoCommerce/vc-shell/commit/27484e39c72e7b738e8db5846063e6388f7e06db))
-* **vc-app-skill:** add SessionStart update check hook ([72c5bcf](https://github.com/VirtoCommerce/vc-shell/commit/72c5bcf33d4f8ae826e7ed76d9228c42cfa846d4))
-* **vc-app-skill:** add uninstaller ([6a0507c](https://github.com/VirtoCommerce/vc-shell/commit/6a0507c9a5c755c0b4487c5625898c5c50c38986))
-* **vc-app-skill:** create package scaffold with README ([a2bbced](https://github.com/VirtoCommerce/vc-shell/commit/a2bbced57b2fbb62bb56ca38c679b0c42e7aee88))
-* **vc-app-skill:** migrate skill content from create-vc-app to standalone package ([1ac8945](https://github.com/VirtoCommerce/vc-shell/commit/1ac894510ca32cad22efb226117127f76085f85a))
-* **vc-app-skill:** update scaffold to skip --module-name for standalone ([c82066e](https://github.com/VirtoCommerce/vc-shell/commit/c82066e3c910676ada13f0cd8f1d7db72d81982a))
+- **vc-app-skill:** add /vc-app design command documentation ([3cc59b2](https://github.com/VirtoCommerce/vc-shell/commit/3cc59b29831da7f2f78900c7f61354165583813e))
+- **vc-app-skill:** add /vc-app design phases 1-6 (prompt → plan → execute → summary) ([b0bb44f](https://github.com/VirtoCommerce/vc-shell/commit/b0bb44f47e28fe9df147c5941a15e76b5ae3d2f8))
+- **vc-app-skill:** add /vc-app design to routing table and help ([8b2f53e](https://github.com/VirtoCommerce/vc-shell/commit/8b2f53e7d8643f8ab87f3fab82dc4dd8c8bd44da))
+- **vc-app-skill:** add /vc-app promote command with 5-phase flow ([a3b6da6](https://github.com/VirtoCommerce/vc-shell/commit/a3b6da658322a1e39ffb9808d0e80bf732f52ae8))
+- **vc-app-skill:** add blade-enhancer agent for surgical module modifications ([bc83681](https://github.com/VirtoCommerce/vc-shell/commit/bc83681c99accd3a25b48a5da1916810a6393aa0))
+- **vc-app-skill:** add design-specific error handling scenarios ([5381685](https://github.com/VirtoCommerce/vc-shell/commit/5381685b75a7eac82add64314cab8269518ba53f))
+- **vc-app-skill:** add enhance flow to /vc-app generate for existing modules ([2936bd6](https://github.com/VirtoCommerce/vc-shell/commit/2936bd60946d4c63207682908a8edbb8f137e448))
+- **vc-app-skill:** add entry-point and update commands ([ab9075f](https://github.com/VirtoCommerce/vc-shell/commit/ab9075f49b1bb2d93f56613758d038ef1ca09d09))
+- **vc-app-skill:** add existingModule context and append mode to generators ([3978c66](https://github.com/VirtoCommerce/vc-shell/commit/3978c66aff3b2526f51227c560371be425018ad2))
+- **vc-app-skill:** add module-analyzer agent for existing module introspection ([9eaff6b](https://github.com/VirtoCommerce/vc-shell/commit/9eaff6b3ca829ce41298c739f26ba6bdf93a2adb))
+- **vc-app-skill:** add multi-runtime installer ([00e656e](https://github.com/VirtoCommerce/vc-shell/commit/00e656e65bef05ebe8e7cb29cbf2efe64b991f5a))
+- **vc-app-skill:** add promote-agent subagent for mock-to-API transformation ([27484e3](https://github.com/VirtoCommerce/vc-shell/commit/27484e39c72e7b738e8db5846063e6388f7e06db))
+- **vc-app-skill:** add SessionStart update check hook ([72c5bcf](https://github.com/VirtoCommerce/vc-shell/commit/72c5bcf33d4f8ae826e7ed76d9228c42cfa846d4))
+- **vc-app-skill:** add uninstaller ([6a0507c](https://github.com/VirtoCommerce/vc-shell/commit/6a0507c9a5c755c0b4487c5625898c5c50c38986))
+- **vc-app-skill:** create package scaffold with README ([a2bbced](https://github.com/VirtoCommerce/vc-shell/commit/a2bbced57b2fbb62bb56ca38c679b0c42e7aee88))
+- **vc-app-skill:** migrate skill content from create-vc-app to standalone package ([1ac8945](https://github.com/VirtoCommerce/vc-shell/commit/1ac894510ca32cad22efb226117127f76085f85a))
+- **vc-app-skill:** update scaffold to skip --module-name for standalone ([c82066e](https://github.com/VirtoCommerce/vc-shell/commit/c82066e3c910676ada13f0cd8f1d7db72d81982a))
+
 # 2.0.0-alpha.16 (2026-03-23)
 
 Initial release of the vc-app-skill package.
 
 ### Features
 
-* **vc-app-skill:** scaffold standalone vc-shell projects (`/vc-app create`)
-* **vc-app-skill:** connect to VirtoCommerce platform and generate API clients (`/vc-app connect`)
-* **vc-app-skill:** add empty module skeletons (`/vc-app add-module`)
-* **vc-app-skill:** intent-driven module generation with list/details blades, composables, and locales (`/vc-app generate`)
-* **vc-app-skill:** enhance existing modules with surgical modifications — add columns, fields, toolbar actions, logic, blade links (`/vc-app generate` enhance flow)
-* **vc-app-skill:** promote prototype modules from mock data to real API clients (`/vc-app promote`)
-* **vc-app-skill:** 9 specialized subagents for code generation and transformation
-* **vc-app-skill:** framework knowledge base with component docs, patterns, and examples
+- **vc-app-skill:** scaffold standalone vc-shell projects (`/vc-app create`)
+- **vc-app-skill:** connect to VirtoCommerce platform and generate API clients (`/vc-app connect`)
+- **vc-app-skill:** add empty module skeletons (`/vc-app add-module`)
+- **vc-app-skill:** intent-driven module generation with list/details blades, composables, and locales (`/vc-app generate`)
+- **vc-app-skill:** enhance existing modules with surgical modifications — add columns, fields, toolbar actions, logic, blade links (`/vc-app generate` enhance flow)
+- **vc-app-skill:** promote prototype modules from mock data to real API clients (`/vc-app promote`)
+- **vc-app-skill:** 9 specialized subagents for code generation and transformation
+- **vc-app-skill:** framework knowledge base with component docs, patterns, and examples

package/README.md

@@ -7,12 +7,14 @@ An AI coding skill for scaffolding and generating VirtoCommerce Shell applicatio
 `vc-app-skill` installs a set of AI-readable skill files (markdown prompts, knowledge base, slash commands) into your AI coding tool's configuration directory. Once installed, your AI assistant gains deep knowledge of the VirtoCommerce Shell framework — enabling it to scaffold apps, connect to platform APIs, generate full UI modules, and follow framework conventions automatically.
 
 The skill covers:
+
 - Creating standalone apps from templates
 - Connecting to VirtoCommerce platform and generating typed API clients
 - Intent-driven module generation (list + details blades, composables, locales) with mock or API data
 - Enhancing existing modules with surgical modifications (add columns, fields, toolbar actions, logic, blade links)
 - Generating full multi-module applications from a free-text prompt (design command)
 - Promoting prototype modules from mock data to real API clients
+- Migrating existing apps to the latest `@vc-shell/framework` version (runs the CLI migrator, regenerates API clients, completes AI-assisted manual refactors)
 - Following vc-shell conventions: Vue 3 + TypeScript, Tailwind with `tw-` prefix, `<script setup>`, BEM class names
 
 ## Installation
@@ -58,6 +60,7 @@ Scaffold a new VirtoCommerce Shell application interactively.
 ```
 
 Prompts for:
+
 - App name and npm package name
 - Target directory
 
@@ -72,6 +75,7 @@ Connect to a VirtoCommerce platform instance and generate typed API clients.
 ```
 
 Walks through:
+
 1. Writing `.env` with platform URL
 2. Writing `.env.local` with auth credentials
 3. Generating NSwag API clients from the platform's Swagger endpoints
@@ -86,6 +90,7 @@ Add an empty module skeleton to the current project.
 ```
 
 Generates:
+
 - `src/modules/<name>/` directory with `index.ts`, `pages/`, `composables/`, `locales/`
 - Registers the module in the app's module list
 
@@ -98,6 +103,7 @@ Full intent-driven module generation. This is the main power feature — it walk
 ```
 
 **Create flow** (new module):
+
 - **Phase 1: Intent** — describe what the module does, pick blade types (list+details, list-only, details-only), configure menu entry
 - **Phase 2: Data Source** — select API entity, choose columns/fields, pick CRUD methods. If no API client exists, generates with mock data automatically
 - **Phase 3: Generation** — dispatches specialized agents to generate blades, composables, locales, and barrel files
@@ -105,6 +111,7 @@ Full intent-driven module generation. This is the main power feature — it walk
 
 **Enhance flow** (existing module):
 When the module already exists, generate detects it and switches to enhance mode:
+
 - **Phase E1: Module Analysis** — analyzes existing blades, composables, locales, API status
 - **Phase E2: Intent Parsing** — describe changes in free text, parsed into action plan
 - **Phase E3: Data Source** — only if new entity is involved
@@ -148,6 +155,28 @@ When you generate a module without an API client, it uses mock data with `// vc-
 - **Phase 4: Code Transformation** — replaces mock code with real API calls, renames fields, updates locales
 - **Phase 5: Cleanup** — type-checks, removes prototype marker on success
 
+### `/vc-app migrate`
+
+Fully automatic migration of an existing app to the latest `@vc-shell/framework` version. Runs the CLI migrator for mechanical transforms, regenerates API clients with the new Interface-style output, installs updated dependencies, and dispatches AI agents to complete manual refactors flagged in `MIGRATION_REPORT.md`.
+
+```
+/vc-app migrate
+```
+
+Flow:
+
+- **Step 1: Pre-flight** — verifies the project uses `@vc-shell/framework`; warns on uncommitted changes
+- **Step 2: CLI migrator** — runs `@vc-shell/migrate --update-deps` to apply mechanical transforms and align peer-dependency versions (including `@vc-shell/*`, ESLint, Vite, TypeScript, VueUse, `vue-router` and other curated peer deps)
+- **Step 2.5: API client regeneration** — adds `APP_TYPE_STYLE=Interface`, runs `generate-api-client`, verifies types compile
+- **Step 3: Install** — `yarn install` to refresh the lockfile
+- **Step 4: Parse report** — reads `MIGRATION_REPORT.md`, maps "Manual Migration Required" topics to migration prompts and patterns
+- **Step 5: AI migration** — dispatches `migration-agent` on affected files per topic (supports partial resume via `.vc-app-migrate-state.json`)
+- **Step 6: Verify** — runs `vue-tsc --noEmit` and `yarn build`, iteratively fixes type errors
+- **Step 6.5: Format** — runs Prettier across the project
+- **Step 7: Summary** — updates the report and prints a completion summary with remaining issues
+
+Handles topics: widgets, form management (`useBladeForm`), injection-key renames, NSwag class-to-interface, blade props simplification, notifications, VcTable → VcDataTable, icon replacements, assets API, pagination, and a manual-audit catch-all.
+
 ## Update
 
 ```bash
@@ -209,17 +238,18 @@ cli/vc-app-skill/
 
 The skill dispatches specialized agents for different tasks:
 
-| Agent | Purpose |
-|---|---|
-| `api-analyzer` | Discovers entities and CRUD methods in API client files |
-| `list-blade-generator` | Generates list blade + plural composable |
-| `details-blade-generator` | Generates details blade + singular composable |
-| `locales-generator` | Scans generated files for i18n keys, writes locale JSON |
-| `module-assembler` | Creates barrel files and registers module (create + append modes) |
-| `type-checker` | Runs vue-tsc, iteratively fixes type errors |
-| `promote-agent` | Transforms mock composables/blades/locales to use real API |
-| `module-analyzer` | Analyzes existing module structure (read-only) |
-| `blade-enhancer` | Surgical edits to existing blades/composables/locales |
+| Agent                     | Purpose                                                                    |
+| ------------------------- | -------------------------------------------------------------------------- |
+| `api-analyzer`            | Discovers entities and CRUD methods in API client files                    |
+| `list-blade-generator`    | Generates list blade + plural composable                                   |
+| `details-blade-generator` | Generates details blade + singular composable                              |
+| `locales-generator`       | Scans generated files for i18n keys, writes locale JSON                    |
+| `module-assembler`        | Creates barrel files and registers module (create + append modes)          |
+| `type-checker`            | Runs vue-tsc, iteratively fixes type errors                                |
+| `promote-agent`           | Transforms mock composables/blades/locales to use real API                 |
+| `migration-agent`         | Applies AI-assisted manual migrations on files flagged by the migrate flow |
+| `module-analyzer`         | Analyzes existing module structure (read-only)                             |
+| `blade-enhancer`          | Surgical edits to existing blades/composables/locales                      |
 
 ### Running locally
 
@@ -229,4 +259,4 @@ node cli/vc-app-skill/bin/install.cjs
 
 # Verify deployment
 ls ~/.claude/vc-app-skill/agents/
-```
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vc-shell/vc-app-skill",
-  "version": "2.0.0-alpha.33",
+  "version": "2.0.0-alpha.34",
   "description": "AI coding skill for scaffolding and generating VirtoCommerce Shell applications. Works with Claude Code, OpenCode, Gemini, Codex, Cursor.",
   "bin": "./bin/install.cjs",
   "files": [
@@ -19,9 +19,9 @@
     "vue3"
   ],
   "scripts": {
-    "sync-docs": "node bin/sync-docs.cjs",
-    "knowledge-stats": "node bin/knowledge-stats.cjs",
-    "sync-to-docs": "node bin/sync-to-docs.cjs"
+    "sync:docs": "node bin/sync-docs.cjs",
+    "knowledge:stats": "node bin/knowledge-stats.cjs",
+    "sync:to-docs": "node bin/sync-to-docs.cjs"
   },
   "publishConfig": {
     "access": "public",

package/runtime/VERSION

@@ -1 +1 @@
-2.0.0-alpha.33
+2.0.0-alpha.34

package/runtime/agents/api-analyzer.md

@@ -31,11 +31,13 @@ Use Glob to find all `*.ts` files in `apiClientDir`. Exclude `*.d.ts` files.
 Read each file and extract the following by regex/text scan:
 
 **Client classes** — match `class \w+Client`:
+
 ```
 Pattern: /class (\w+Client)\b/g
 ```
 
 **Search query types** — match NSwag search query class names:
+
 ```
 Patterns:
   /class (Search\w+Query)\b/g
@@ -43,42 +45,50 @@ Patterns:
 ```
 
 **Search result types** — match NSwag search result class names:
+
 ```
 Pattern: /class (Search\w+Result)\b/g
 ```
 
 **Create/Update commands**:
+
 ```
 Pattern: /class (Create\w+Command)\b/g
 Pattern: /class (Update\w+Command)\b/g
 ```
 
 **Entity types** — infer from client methods and command names:
+
 - From `Search<Entity>Query` → entity = `Entity`
 - From `Create<Entity>Command` → entity = `Entity`
 - Look for `class <Entity>\b` and `class <Entity>Details\b`
 
 **Delete methods** — match client method signatures:
+
 ```
 Pattern: /async delete(\w+)s?\(.*ids.*string/g
 ```
 
 **Search methods** — match client method signatures:
+
 ```
 Pattern: /async search(\w+)\(/g
 ```
 
 **Get methods**:
+
 ```
 Pattern: /async get(\w+)\(/g
 ```
 
 **Create methods**:
+
 ```
 Pattern: /async create(\w+)\(/g
 ```
 
 **Update methods**:
+
 ```
 Pattern: /async update(\w+)\(/g
 ```
@@ -86,15 +96,16 @@ Pattern: /async update(\w+)\(/g
 ### Step 3: Build entity model
 
 For each discovered entity, collect:
-- `clientClass`: the `*Client` class name (e.g., `VcmpSellerSecurityClient`)
-- `clientFile`: relative path from `apiClientDir` (e.g., `virtocommerce.marketplacevendor`)
+
+- `clientClass`: the `*Client` class name (e.g., `UserSecurityClient`)
+- `clientFile`: relative path from `apiClientDir` (e.g., `virtocommerce.mymodule`)
 - `entityName`: PascalCase entity name (e.g., `TeamMember`, `Order`)
 - `searchQueryClass`: `Search<Entity>Query` or `Search<Entity>sQuery` if found
 - `searchResultClass`: `Search<Entity>Result` if found
 - `entityClass`: `<Entity>` if found as a standalone class
 - `entityDetailsClass`: `<Entity>Details` if found
-- `searchMethod`: camelCase method name on client (e.g., `searchSellerUsers`)
-- `getMethod`: camelCase method name (e.g., `getSellerUser`) or null
+- `searchMethod`: camelCase method name on client (e.g., `searchUsers`)
+- `getMethod`: camelCase method name (e.g., `getUser`) or null
 - `createMethod`: camelCase method name or null
 - `updateMethod`: camelCase method name or null
 - `deleteMethod`: camelCase method name or null
@@ -108,26 +119,29 @@ If `entityHint` is provided, filter/rank results to prefer entities matching the
 Return the analysis result as structured JSON in your response. Do NOT write any files.
 
 Format:
+
 ```json
 {
   "apiClientDir": "<absolute path>",
   "entities": [
     {
-      "clientClass": "VcmpSellerSecurityClient",
-      "clientFile": "virtocommerce.marketplacevendor",
-      "entityName": "SellerUser",
-      "searchQueryClass": "SearchSellerUsersQuery",
-      "searchResultClass": "SearchSellerUsersResult",
-      "entityClass": "SellerUser",
+      "clientClass": "UserSecurityClient",
+      "clientFile": "virtocommerce.mymodule",
+      "entityName": "User",
+      "searchQueryClass": "SearchUsersQuery",
+      "searchResultClass": "SearchUsersResult",
+      "entityClass": "User",
       "entityDetailsClass": null,
-      "searchMethod": "searchSellerUsers",
-      "getMethod": "getSellerUser",
-      "createMethod": "createSellerUser",
-      "updateMethod": "updateSellerUser",
-      "deleteMethod": "deleteSellerUsers"
+      "searchMethod": "searchUsers",
+      "getMethod": "getUser",
+      "createMethod": "createUser",
+      "updateMethod": "updateUser",
+      "deleteMethod": "deleteUsers"
     }
   ],
-  "primaryEntity": { /* best match or first entity */ }
+  "primaryEntity": {
+    /* best match or first entity */
+  }
 }
 ```
 
@@ -138,6 +152,7 @@ Returns JSON in response text. Does NOT write files to disk.
 ## Self-Check
 
 Before completing, verify:
+
 - [ ] All `*.ts` files in `apiClientDir` were scanned (not just the first one)
 - [ ] `clientClass` ends with `Client`
 - [ ] `searchMethod`, `getMethod`, etc. are camelCase method names (not class names)

package/runtime/agents/blade-enhancer.md

@@ -29,6 +29,7 @@ description: Performs surgical edits on existing module files to add columns, fi
 ### Action Schema by Type
 
 **`add-column`:**
+
 ```json
 {
   "type": "add-column",
@@ -50,6 +51,7 @@ description: Performs surgical edits on existing module files to add columns, fi
 ```
 
 **`add-field`:**
+
 ```json
 {
   "type": "add-field",
@@ -68,6 +70,7 @@ description: Performs surgical edits on existing module files to add columns, fi
 ```
 
 **`add-logic`:**
+
 ```json
 {
   "type": "add-logic",
@@ -86,6 +89,7 @@ description: Performs surgical edits on existing module files to add columns, fi
 ```
 
 **`add-toolbar-action`:**
+
 ```json
 {
   "type": "add-toolbar-action",
@@ -102,6 +106,7 @@ description: Performs surgical edits on existing module files to add columns, fi
 ```
 
 **`link-blades`:**
+
 ```json
 {
   "type": "link-blades",
@@ -126,6 +131,7 @@ Before making edits, Read these files if paths are provided:
 2. From `index.md`, identify `.docs.md` files for any components referenced in the actions (VcColumn, VcInput, VcBlade, etc.) and Read them from `{docsRoot}/`
 
 Then, for EACH action:
+
 1. Read the `target` file to understand its current structure
 2. Read any composable files referenced by the target blade
 3. Scan `{targetDir}/locales/` for ALL `.json` files — these will ALL need locale key additions
@@ -167,10 +173,7 @@ Then, for EACH action:
    ```
 4. If `column.hasBodySlot` is true, use the open/close tag form with the provided `bodySlotTemplate`:
    ```vue
-   <VcColumn
-     id="{column.id}"
-     ...attributes...
-   >
+   <VcColumn id="{column.id}" ...attributes...>
      <template #body="{ data }">
        {column.bodySlotTemplate}
      </template>
@@ -181,6 +184,7 @@ Then, for EACH action:
 **Step 2: Add locale keys**
 
 For EVERY `.json` file in `{targetDir}/locales/`:
+
 1. Read the file
 2. Navigate to the table header key section (e.g., `{I18N_PREFIX}.PAGES.LIST.TABLE.HEADER`)
 3. Add the new key: `"{SCREAMING_SNAKE(column.id)}": "{column.title}"`
@@ -197,11 +201,7 @@ For EVERY `.json` file in `{targetDir}/locales/`:
    - If `section` is specified: narrow search to that form section
 3. Construct the form field element:
    ```vue
-   <{field.component}
-     :label="t('{I18N_PREFIX}.PAGES.DETAILS.FIELDS.{SCREAMING_SNAKE(field.name)}')"
-     v-model="item.{field.name}"
-     {...additional props from field.props}
-   />
+   <{field.component} :label="t('{I18N_PREFIX}.PAGES.DETAILS.FIELDS.{SCREAMING_SNAKE(field.name)}')" v-model="item.{field.name}" {...additional props from field.props} />
    ```
    Use `v-model` or `:modelValue` based on `field.bindingType`.
 4. Use the Edit tool to insert after the identified closing tag
@@ -216,6 +216,7 @@ For EVERY `.json` file in `{targetDir}/locales/`:
 **Step 3: Add locale keys**
 
 For EVERY `.json` file in `{targetDir}/locales/`:
+
 1. Read the file
 2. Navigate to the details fields key section (e.g., `{I18N_PREFIX}.PAGES.DETAILS.FIELDS`)
 3. Add the new key: `"{SCREAMING_SNAKE(field.name)}": "{field.label}"`
@@ -244,6 +245,7 @@ For EVERY `.json` file in `{targetDir}/locales/`:
 **Step 3: Add locale keys (if the logic introduces user-facing strings)**
 
 For EVERY `.json` file in `{targetDir}/locales/`:
+
 1. Add relevant locale keys following the module's existing key pattern
 2. Use the Edit tool for insertion
 
@@ -281,6 +283,7 @@ For EVERY `.json` file in `{targetDir}/locales/`:
 **Step 3: Add locale keys**
 
 For EVERY `.json` file in `{targetDir}/locales/`:
+
 1. Navigate to the toolbar key section (e.g., `{I18N_PREFIX}.PAGES.{PAGE_TYPE}.TOOLBAR`)
 2. Add the new key: `"{SCREAMING_SNAKE(action.id)}": "{action.label}"`
 3. If the toolbar section doesn't exist in the locale structure, create it
@@ -304,6 +307,7 @@ Based on `link.trigger`:
 - **`row-click`**: Ensure `@item-click` handler on `<VcDataTable>` calls the open blade function. If `@item-click` already exists, update its handler.
 
 - **`button`**: Add a `<VcButton>` at the appropriate location:
+
   ```vue
   <VcButton
     :label="t('{I18N_PREFIX}.PAGES.{PAGE_TYPE}.ACTIONS.{SCREAMING_SNAKE(link.destinationBlade)}')"
@@ -332,6 +336,7 @@ Based on `link.trigger`:
 **Step 4: Add locale keys**
 
 For EVERY `.json` file in `{targetDir}/locales/`:
+
 1. Add the button/link label key following the module's key pattern
 2. Use the Edit tool for insertion
 
@@ -346,6 +351,7 @@ If the target file has a non-standard structure (e.g., custom table component in
 ## Output Contract
 
 Report format:
+
 ```
 Status: DONE | DONE_WITH_CONCERNS | BLOCKED
 Actions applied: