@series-inc/stowkit-cli 0.1.23 → 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); });
@@ -38,6 +38,7 @@ function printUsage() {
     console.log(`
 Usage:
   stowkit init [dir]              Initialize a StowKit project
+  stowkit init --update [dir]     Update AI skill files to match installed CLI version
   stowkit build [dir]             Full build: scan + process + pack
   stowkit scan [dir]              Detect new assets, generate .stowmeta defaults
   stowkit process [dir]           Compress assets (respects cache)
@@ -48,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)
@@ -75,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';
@@ -96,7 +103,34 @@ async function main() {
     try {
         switch (command) {
             case 'init':
-                await initProject(projectDir);
+                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);

package/dist/init.d.ts

@@ -1 +1,4 @@
-export declare function initProject(projectDir: string): Promise<void>;
+export interface InitOptions {
+    update?: boolean;
+}
+export declare function initProject(projectDir: string, opts?: InitOptions): Promise<void>;

package/dist/init.js

@@ -1,10 +1,26 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
-export async function initProject(projectDir) {
+export async function initProject(projectDir, opts) {
     const absDir = path.resolve(projectDir);
-    // Check if already initialized
     const configPath = path.join(absDir, '.felicityproject');
+    const update = opts?.update ?? false;
+    if (update) {
+        // --update: only refresh AI skill files, project must already exist
+        try {
+            await fs.access(configPath);
+        }
+        catch {
+            console.error('No StowKit project found. Run `stowkit init` first.');
+            process.exit(1);
+        }
+        await copySkillFiles(absDir);
+        console.log('Updated AI skill files:');
+        console.log('  .claude/skills/stowkit/SKILL.md');
+        console.log('  .cursor/rules/stowkit.mdc');
+        return;
+    }
+    // Check if already initialized
     try {
         await fs.access(configPath);
         console.log(`Project already initialized at ${absDir}`);
@@ -49,7 +65,18 @@ export async function initProject(projectDir) {
     catch {
         await fs.writeFile(gitignorePath, stowkitIgnores + '\n');
     }
-    // Copy AI skill/rule files (CLI skill only — loader skills are installed locally with their packages)
+    // Copy AI skill/rule files
+    await copySkillFiles(absDir);
+    console.log(`Initialized StowKit project at ${absDir}`);
+    console.log(`  Source art dir: ${srcArtDir}/`);
+    console.log(`  Output dir:     public/cdn-assets/`);
+    console.log(`  Config:         .felicityproject`);
+    console.log(`  AI skills:      .claude/skills/stowkit/SKILL.md, .cursor/rules/stowkit.mdc`);
+    console.log('');
+    console.log('Drop your assets (PNG, JPG, FBX, WAV, etc.) into assets/');
+    console.log('Then run: stowkit build');
+}
+async function copySkillFiles(absDir) {
     const thisDir = path.dirname(fileURLToPath(import.meta.url));
     const skillSrc = path.resolve(thisDir, '../skill.md');
     try {
@@ -64,12 +91,4 @@ export async function initProject(projectDir) {
     catch {
         // Skill file not found in package — skip silently
     }
-    console.log(`Initialized StowKit project at ${absDir}`);
-    console.log(`  Source art dir: ${srcArtDir}/`);
-    console.log(`  Output dir:     public/cdn-assets/`);
-    console.log(`  Config:         .felicityproject`);
-    console.log(`  AI skills:      .claude/skills/stowkit/SKILL.md, .cursor/rules/stowkit.mdc`);
-    console.log('');
-    console.log('Drop your assets (PNG, JPG, FBX, WAV, etc.) into assets/');
-    console.log('Then run: npx stowkit build');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/stowkit-cli",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "type": "module",
   "bin": {
     "stowkit": "./dist/cli.js"
@@ -17,7 +17,7 @@
     "dev": "tsc --watch"
   },
   "dependencies": {
-    "@series-inc/stowkit-packer-gui": "^0.1.11",
+    "@series-inc/stowkit-packer-gui": "^0.1.12",
     "@series-inc/stowkit-editor": "^0.1.2",
     "draco3d": "^1.5.7",
     "fbx-parser": "^2.1.3",

package/skill.md

@@ -37,6 +37,9 @@ 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)
@@ -505,6 +508,20 @@ PerfLogger.enable();
 PerfLogger.disable();
 ```
 
+## Updating the CLI and This Skill File
+
+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 update
+```
+
+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.
+
+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
 
 ### Adding a GLB model (recommended 3D workflow)