@series-inc/stowkit-cli 0.1.24 → 0.1.25

package/dist/cli.js

@@ -24,7 +24,7 @@ function checkForUpdate() {
             const latest = data.version;
             if (latest && latest !== localVersion) {
                 console.log(`\n  Update available: ${localVersion} → ${latest}`);
-                console.log(`  Run: npm install -g @series-inc/stowkit-cli\n`);
+                console.log(`  Run: stowkit update\n`);
             }
         })
             .catch(() => { clearTimeout(timeout); });
@@ -49,6 +49,8 @@ Usage:
   stowkit move <path> <folder>    Move an asset to a different folder
   stowkit delete <path>           Delete an asset and its sidecar files
   stowkit set-id <path> <id>      Change an asset's stringId
+  stowkit update                  Update CLI to latest version and refresh skill files
+  stowkit version                 Show installed version
   stowkit packer [dir]            Open the packer GUI
   stowkit editor [dir]            Open the level editor
   stowkit serve [dir]             Start API server only (no GUI)
@@ -76,6 +78,10 @@ function resolveAppDir(packageName, monorepoFolder) {
     }
     return null;
 }
+function getVersion() {
+    const pkg = JSON.parse(fs.readFileSync(path.resolve(thisDir, '../package.json'), 'utf-8'));
+    return pkg.version;
+}
 function openBrowser(url) {
     import('node:child_process').then(({ exec }) => {
         const cmd = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
@@ -99,6 +105,33 @@ async function main() {
             case 'init':
                 await initProject(projectDir, { update: args.includes('--update') });
                 break;
+            case 'update': {
+                const currentVersion = getVersion();
+                console.log(`Current version: ${currentVersion}`);
+                console.log('Checking for updates...');
+                const res = await fetch('https://registry.npmjs.org/@series-inc/stowkit-cli/latest');
+                const data = await res.json();
+                const latest = data.version;
+                if (latest === currentVersion) {
+                    console.log('Already on the latest version.');
+                }
+                else {
+                    console.log(`Updating: ${currentVersion} → ${latest}`);
+                    const { execSync } = await import('node:child_process');
+                    execSync('npm install -g @series-inc/stowkit-cli@latest', { stdio: 'inherit' });
+                    console.log(`Updated to ${latest}.`);
+                }
+                // Refresh skill files if in a StowKit project
+                const configExists = existsSync(path.resolve(projectDir, '.felicityproject'));
+                if (configExists) {
+                    await initProject(projectDir, { update: true });
+                }
+                break;
+            }
+            case 'version':
+            case '--version':
+                console.log(getVersion());
+                break;
             case 'build':
                 await fullBuild(projectDir, opts);
                 break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/stowkit-cli",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "type": "module",
   "bin": {
     "stowkit": "./dist/cli.js"

package/skill.md

@@ -38,6 +38,8 @@ A StowKit project has a `.felicityproject` JSON file at its root:
 ```bash
 stowkit init [dir]              # Scaffold a new project (creates .felicityproject, assets/, public/cdn-assets/)
 stowkit init --update [dir]     # Update AI skill files to match installed CLI version
+stowkit update                  # Update CLI to latest version and refresh skill files
+stowkit version                 # Show installed version
 stowkit build [dir]             # Full build: scan + process + pack
 stowkit scan [dir]              # Detect new assets and generate .stowmeta defaults
 stowkit process [dir]           # Compress assets (respects cache)
@@ -506,17 +508,19 @@ PerfLogger.enable();
 PerfLogger.disable();
 ```
 
-## Updating This Skill File
+## Updating the CLI and This Skill File
 
-This skill file is bundled with the `@series-inc/stowkit-cli` package. When the CLI is updated to a newer version, the local copy of this file may become outdated. To refresh it:
+This skill file is bundled with the `@series-inc/stowkit-cli` package. To update the CLI to the latest version and refresh this file in one step:
 
 ```bash
-stowkit init --update
+stowkit update
 ```
 
-This overwrites `.claude/skills/stowkit/SKILL.md` and `.cursor/rules/stowkit.mdc` with the version shipped in the currently installed CLI. It does not touch the project config, directories, or any asset files.
+This updates the global CLI install, then overwrites `.claude/skills/stowkit/SKILL.md` and `.cursor/rules/stowkit.mdc` with the version shipped in the new CLI. It does not touch the project config, directories, or any asset files.
 
-**When to run this:** After upgrading the CLI (`npm install -g @series-inc/stowkit-cli@latest`), or if you notice this skill file is missing documentation for commands that exist in `stowkit --help`.
+To refresh skill files without updating the CLI: `stowkit init --update`
+
+**When to run this:** If you notice this skill file is missing documentation for commands that exist in `stowkit --help`, or if the user asks you to update StowKit.
 
 ## Common Tasks for AI Agents