start-vibing-stacks 2.24.0 → 2.25.0

package/README.md

@@ -6,7 +6,7 @@ Multi-stack AI workflow for **Claude Code** & **Cursor**. One command installs a
 npx start-vibing-stacks
 ```
 
-> Latest: **v2.24.0** — `migrate` is now smart and complete. Versioned hooks (`// @sv-version`), versioned commands, idempotent `settings.json` patcher, runtime dirs auto-creation, `.gitignore` update — all reachable via `npx start-vibing-stacks migrate --apply`. New `--force-hooks` flag overwrites legacy hooks (no `@sv-version`) with timestamped `.bak` backup. v2.23.0 → multi-instance coordination layer.
+> Latest: **v2.25.0** — `--force-hooks` (alias `--force-legacy`) now also covers legacy commands (`commands/*.md` without `version:` frontmatter), not just hooks. Single command rebuilds installs older than v2.23.0. v2.24.0 → smart migrate (versioned hooks/commands, idempotent `settings.json`, runtime dirs, `.gitignore`). v2.23.0 → multi-instance coordination layer.
 
 ---
 
@@ -133,7 +133,8 @@ Single-host coordination only. It does **not** replace `git` for cross-machine c
 npx start-vibing-stacks                                # setup or resume current project
 npx start-vibing-stacks migrate                        # dry run: skills + agents + hooks + commands + settings.json + runtime dirs
 npx start-vibing-stacks migrate --apply                # apply (idempotent; preserves customizations)
-npx start-vibing-stacks migrate --apply --force-hooks  # also overwrite legacy hooks (no @sv-version) — creates .bak
+npx start-vibing-stacks migrate --apply --force-legacy # also overwrite legacy hooks AND commands (no version) — creates .bak
+npx start-vibing-stacks migrate --apply --force-hooks  # alias for --force-legacy (back-compat)
 
 # flags: --force --no-claude --no-mcp --no-install --help --version
 ```
@@ -145,7 +146,7 @@ npx start-vibing-stacks migrate --apply --force-hooks  # also overwrite legacy h
 - **Runtime artefacts** — `.claude/state/{sessions,inbox,file-touches}/_archive` auto-created; `_state.README.md` staged.
 - **`.gitignore`** — `.claude/state/` appended if not already covered.
 
-Legacy hooks without `@sv-version` (anything older than v2.24.0) are reported as `needs-update-legacy` and skipped by default. Pass `--force-hooks` to overwrite them — each gets a timestamped `.bak`.
+Legacy files without versioning — hooks without `// @sv-version` AND commands without `version:` frontmatter (anything installed before the versioning landed) — are reported as `needs-update-legacy` and skipped by default. Pass `--force-legacy` (or its alias `--force-hooks`) to overwrite them — each gets a timestamped `.bak`. Skills and agents are intentionally **not** covered because users customize them; they stay in `modified-no-version` (advisory only).
 
 Global install: `npm i -g start-vibing-stacks` → `svs` (alias).
 

package/dist/index.js

@@ -33,7 +33,7 @@ const FLAGS = {
     help: args.includes('--help') || args.includes('-h'),
     version: args.includes('--version') || args.includes('-v'),
     apply: args.includes('--apply'),
-    forceHooks: args.includes('--force-hooks'),
+    forceHooks: args.includes('--force-hooks') || args.includes('--force-legacy'),
 };
 if (FLAGS.version) {
     console.log(PKG_VERSION);
@@ -53,7 +53,9 @@ if (FLAGS.help) {
   ${chalk.bold('Options:')}
     --force           Overwrite existing configuration (default command)
     --apply           Apply updates (migrate command)
-    --force-hooks     Overwrite legacy hooks without @sv-version (migrate; creates .bak)
+    --force-legacy    Overwrite legacy hooks (no @sv-version) AND legacy commands
+                      (no version: frontmatter) — each gets a timestamped .bak
+    --force-hooks     Alias for --force-legacy (kept for back-compat)
     --no-claude       Skip Claude Code installation
     --no-mcp          Skip MCP server selection
     --no-install      Skip dependency installation

package/dist/migrate.js

@@ -187,7 +187,20 @@ export function planMigration(projectDir, opts) {
             if (!bundledVersion)
                 continue;
             const installedVersion = parseFrontmatterVersion(target);
-            const status = !existsSync(target) ? 'missing' : statusFromSemver(bundledVersion, installedVersion);
+            let status;
+            if (!existsSync(target)) {
+                status = 'missing';
+            }
+            else if (installedVersion === null) {
+                // Commands are canonical infra files (slash-command routes). When the
+                // installed copy lacks `version:` frontmatter it predates versioned
+                // commands — treat as legacy so `--force-hooks` can heal it (same
+                // .bak machinery as legacy hooks). Skills/agents stay manual-review.
+                status = 'needs-update-legacy';
+            }
+            else {
+                status = statusFromSemver(bundledVersion, installedVersion);
+            }
             items.push({ kind: 'command', name, source, target, bundledVersion, installedVersion, status });
         }
     }
@@ -363,7 +376,7 @@ export async function runMigrate(projectDir, opts) {
     };
     summary('MISSING', grouped.missing);
     summary('OUTDATED', grouped.outdated);
-    summary('NEEDS UPDATE — legacy hooks (no @sv-version tag)', grouped['needs-update-legacy']);
+    summary('NEEDS UPDATE — legacy (hooks without @sv-version, commands without version: frontmatter)', grouped['needs-update-legacy']);
     summary('AHEAD (installed newer than bundled — kept)', grouped.ahead);
     summary('UNVERSIONED (manual review)', grouped['modified-no-version']);
     summary('CURRENT', grouped.current);
@@ -415,8 +428,9 @@ export async function runMigrate(projectDir, opts) {
             todo.push('runtime artefacts');
         ui.info(`Run with --apply to update: ${todo.join(' + ')}.`);
         if (grouped['needs-update-legacy'].length > 0 && !opts.forceHooks) {
-            ui.info(`${grouped['needs-update-legacy'].length} legacy hook(s) without @sv-version detected. ` +
-                `Use --force-hooks to update them with a .bak backup.`);
+            ui.info(`${grouped['needs-update-legacy'].length} legacy file(s) detected (hooks without @sv-version, ` +
+                `commands without \`version:\` frontmatter). Use --force-legacy (alias --force-hooks) to ` +
+                `update them with a .bak backup.`);
         }
         return;
     }
@@ -453,7 +467,7 @@ export async function runMigrate(projectDir, opts) {
         ui.success('gitignore: appended .claude/state/');
     console.log('');
     ui.success(`Migration complete: ${updated} file(s), ${settingsApply.added.length} settings entry(ies)` +
-        (legacyUpdated > 0 ? `, ${legacyUpdated} legacy hook(s) overwritten with backup` : ''));
+        (legacyUpdated > 0 ? `, ${legacyUpdated} legacy file(s) overwritten with backup` : ''));
     if (grouped['modified-no-version'].length > 0) {
         console.log('');
         ui.warn(`${grouped['modified-no-version'].length} unversioned local skill/agent/command(s) skipped — review manually.`);
@@ -463,8 +477,9 @@ export async function runMigrate(projectDir, opts) {
     }
     if (grouped['needs-update-legacy'].length > 0 && !opts.forceHooks) {
         console.log('');
-        ui.warn(`${grouped['needs-update-legacy'].length} legacy hook(s) without @sv-version were skipped. ` +
-            `Re-run with --force-hooks to update them (each gets a .bak backup).`);
+        ui.warn(`${grouped['needs-update-legacy'].length} legacy file(s) skipped (hooks without @sv-version, ` +
+            `commands without \`version:\` frontmatter). Re-run with --force-legacy ` +
+            `(alias --force-hooks) to update them (each gets a .bak backup).`);
         for (const it of grouped['needs-update-legacy'].slice(0, 10)) {
             console.log(`    ${relative(projectDir, it.target)}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "start-vibing-stacks",
-  "version": "2.24.0",
+  "version": "2.25.0",
   "description": "AI-powered multi-stack dev workflow for Claude Code. Supports PHP, Node.js, Python and more.",
   "type": "module",
   "bin": {