@series-inc/stowkit-cli 0.1.23 → 0.1.24

package/dist/cli.js

@@ -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)
@@ -96,7 +97,7 @@ async function main() {
     try {
         switch (command) {
             case 'init':
-                await initProject(projectDir);
+                await initProject(projectDir, { update: args.includes('--update') });
                 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.24",
   "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,7 @@ 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 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 +506,18 @@ PerfLogger.enable();
 PerfLogger.disable();
 ```
 
+## Updating 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:
+
+```bash
+stowkit init --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.
+
+**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`.
+
 ## Common Tasks for AI Agents
 
 ### Adding a GLB model (recommended 3D workflow)