@series-inc/stowkit-cli 0.1.31 → 0.6.15

package/dist/cli.js

@@ -12,23 +12,59 @@ import { renameAsset, moveAsset, deleteAsset, setStringId } from './asset-comman
 import { inspectPack } from './inspect.js';
 const args = process.argv.slice(2);
 const thisDir = path.dirname(fileURLToPath(import.meta.url));
+const STOWKIT_PACKAGES = [
+    { name: '@series-inc/stowkit-cli', monorepoFolder: 'stowkit-cli' },
+    { name: '@series-inc/stowkit-packer-gui', monorepoFolder: 'stowkit-packer-gui' },
+    { name: '@series-inc/stowkit-editor', monorepoFolder: 'stowkit-editor' },
+];
+function getInstalledVersion(packageName, monorepoFolder) {
+    const candidates = [
+        path.resolve(thisDir, `../../${monorepoFolder}/package.json`),
+        path.resolve(thisDir, `../node_modules/${packageName}/package.json`),
+        path.resolve(thisDir, `../../../${packageName}/package.json`),
+    ];
+    // CLI itself
+    if (packageName === '@series-inc/stowkit-cli') {
+        candidates.unshift(path.resolve(thisDir, '../package.json'));
+    }
+    for (const p of candidates) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(p, 'utf-8'));
+            return pkg.version;
+        }
+        catch { /* not found */ }
+    }
+    return null;
+}
 function checkForUpdate() {
     try {
-        const pkg = JSON.parse(fs.readFileSync(path.resolve(thisDir, '../package.json'), 'utf-8'));
-        const localVersion = pkg.version;
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), 3000);
-        fetch('https://registry.npmjs.org/@series-inc/stowkit-cli/latest', { signal: controller.signal })
-            .then(res => res.json())
-            .then((data) => {
+        const checks = STOWKIT_PACKAGES.map(({ name, monorepoFolder }) => {
+            const local = getInstalledVersion(name, monorepoFolder);
+            if (!local)
+                return Promise.resolve();
+            return fetch(`https://registry.npmjs.org/${name}/latest`, { signal: controller.signal })
+                .then(res => res.json())
+                .then((data) => {
+                const latest = data.version;
+                if (latest && latest !== local) {
+                    return `  ${name}: ${local} → ${latest}`;
+                }
+                return null;
+            })
+                .catch(() => null);
+        });
+        Promise.all(checks).then(results => {
             clearTimeout(timeout);
-            const latest = data.version;
-            if (latest && latest !== localVersion) {
-                console.log(`\n  Update available: ${localVersion} → ${latest}`);
+            const updates = results.filter(Boolean);
+            if (updates.length > 0) {
+                console.log(`\n  Updates available:`);
+                for (const u of updates)
+                    console.log(u);
                 console.log(`  Run: stowkit update\n`);
             }
-        })
-            .catch(() => { clearTimeout(timeout); });
+        }).catch(() => { clearTimeout(timeout); });
     }
     catch {
         // Can't read package.json or fetch — skip silently
@@ -114,20 +150,27 @@ async function main() {
                 });
                 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.');
+                const { execSync } = await import('node:child_process');
+                let anyUpdated = false;
+                for (const { name, monorepoFolder } of STOWKIT_PACKAGES) {
+                    const installed = getInstalledVersion(name, monorepoFolder);
+                    if (!installed)
+                        continue; // not installed, skip
+                    const res = await fetch(`https://registry.npmjs.org/${name}/latest`);
+                    const data = await res.json();
+                    const latest = data.version;
+                    if (latest === installed) {
+                        console.log(`  ${name}: ${installed} (up to date)`);
+                    }
+                    else {
+                        console.log(`  ${name}: ${installed} → ${latest}`);
+                        execSync(`npm install -g ${name}@latest`, { stdio: 'inherit' });
+                        anyUpdated = true;
+                    }
                 }
-                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}.`);
+                if (!anyUpdated) {
+                    console.log('All packages are up to date.');
                 }
                 // Refresh skill files if in a StowKit project
                 const configExists = existsSync(path.resolve(projectDir, '.felicityproject'));

package/dist/index.d.ts

@@ -26,3 +26,4 @@ export { startServer } from './server.js';
 export type { ServerOptions } from './server.js';
 export { initProject } from './init.js';
 export { cleanupProject } from './cleanup.js';
+export { syncRuntimeAssets } from './sync-runtime-assets.js';

package/dist/index.js

@@ -33,3 +33,5 @@ export { startServer } from './server.js';
 export { initProject } from './init.js';
 // Cleanup
 export { cleanupProject } from './cleanup.js';
+// Runtime asset sync
+export { syncRuntimeAssets } from './sync-runtime-assets.js';

package/dist/orchestrator.js

@@ -11,6 +11,7 @@ import { readStowmat, stowmatToMaterialConfig } from './app/stowmat-io.js';
 import { readCacheBlobs, writeCacheBlobs, buildCacheStamp, isCacheValid, } from './app/process-cache.js';
 import { buildPack, processExtractedAnimations, validatePackDependencies } from './pipeline.js';
 import { WorkerPool } from './workers/worker-pool.js';
+import { syncRuntimeAssets } from './sync-runtime-assets.js';
 export async function scanProject(projectDir, opts) {
     const config = await readProjectConfig(projectDir);
     const scan = await scanDirectory(config.srcArtDir);
@@ -46,6 +47,8 @@ export async function fullBuild(projectDir, opts) {
         console.log(`Project: ${config.projectName}`);
     if (verbose)
         console.log(`Source dir: ${config.srcArtDir}`);
+    // 0. Sync WASM/Basis/Draco from node_modules → public/stowkit/
+    syncRuntimeAssets(projectDir, verbose);
     // 1. Scan
     const scan = await scanDirectory(config.srcArtDir);
     if (verbose)

package/dist/server.js

@@ -10,6 +10,7 @@ import { detectAssetType, readStowmeta, writeStowmeta, stowmetaToAssetSettings,
 import { readStowmat, writeStowmat, stowmatToMaterialConfig, materialConfigToStowmat } from './app/stowmat-io.js';
 import { readCacheBlobs, writeCacheBlobs, buildCacheStamp, isCacheValid, } from './app/process-cache.js';
 import { buildPack, validatePackDependencies, processExtractedAnimations } from './pipeline.js';
+import { syncRuntimeAssets } from './sync-runtime-assets.js';
 import { parseGlb, pbrToMaterialConfig } from './encoders/glb-loader.js';
 import { WorkerPool } from './workers/worker-pool.js';
 async function scanPrefabFiles(dir, prefix) {
@@ -1577,6 +1578,7 @@ export async function startServer(opts = {}) {
     }
     // Open project if specified (skip if already loaded — e.g. stowkit editor starts two servers)
     if (opts.projectDir && (!projectConfig || projectConfig.projectDir !== opts.projectDir)) {
+        syncRuntimeAssets(opts.projectDir);
         await openProject(opts.projectDir);
         queueProcessing({ force: opts.force });
     }

package/dist/sync-runtime-assets.d.ts

@@ -0,0 +1,11 @@
+interface SyncResult {
+    wasm: boolean;
+    basis: boolean;
+    draco: boolean;
+}
+/**
+ * Copy stowkit_reader.wasm, basis/, and draco/ decoders from node_modules
+ * into `<projectDir>/public/stowkit/`.
+ */
+export declare function syncRuntimeAssets(projectDir: string, verbose?: boolean): SyncResult;
+export {};

package/dist/sync-runtime-assets.js

@@ -0,0 +1,65 @@
+/**
+ * Sync WASM, Basis, and Draco runtime assets from node_modules to public/stowkit/.
+ *
+ * Postinstall scripts are unreliable for keeping these in sync (they don't re-run
+ * on transitive dep updates). This module is called by `stowkit build` and
+ * `stowkit serve/packer/editor` so the files are always fresh.
+ */
+import { existsSync, mkdirSync, readdirSync, copyFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/**
+ * Copy stowkit_reader.wasm, basis/, and draco/ decoders from node_modules
+ * into `<projectDir>/public/stowkit/`.
+ */
+export function syncRuntimeAssets(projectDir, verbose = false) {
+    const dest = join(projectDir, 'public', 'stowkit');
+    const result = { wasm: false, basis: false, draco: false };
+    // ── WASM ────────────────────────────────────────────────────────────────────
+    const wasmCandidates = [
+        join(projectDir, 'node_modules', '@series-inc', 'stowkit-reader', 'dist', 'stowkit_reader.wasm'),
+    ];
+    for (const src of wasmCandidates) {
+        if (existsSync(src)) {
+            mkdirSync(dest, { recursive: true });
+            copyFileSync(src, join(dest, 'stowkit_reader.wasm'));
+            result.wasm = true;
+            if (verbose)
+                console.log('  Synced stowkit_reader.wasm → public/stowkit/');
+            break;
+        }
+    }
+    // ── Basis & Draco decoders ──────────────────────────────────────────────────
+    const loaderCandidates = [
+        join(projectDir, 'node_modules', '@series-inc', 'stowkit-three-loader', 'public'),
+    ];
+    for (const loaderPublic of loaderCandidates) {
+        if (!existsSync(loaderPublic))
+            continue;
+        // Guard against recursive copy
+        const srcAbs = resolve(loaderPublic);
+        const destAbs = resolve(dest);
+        if (destAbs.startsWith(srcAbs + '/') || destAbs.startsWith(srcAbs + '\\') || destAbs === srcAbs)
+            continue;
+        for (const subdir of ['basis', 'draco']) {
+            const src = join(loaderPublic, subdir);
+            if (!existsSync(src))
+                continue;
+            const subdirDest = join(dest, subdir);
+            mkdirSync(subdirDest, { recursive: true });
+            for (const file of readdirSync(src)) {
+                if (statSync(join(src, file)).isFile()) {
+                    copyFileSync(join(src, file), join(subdirDest, file));
+                }
+            }
+            result[subdir] = true;
+            if (verbose)
+                console.log(`  Synced ${subdir}/ → public/stowkit/${subdir}/`);
+        }
+        break;
+    }
+    if (result.wasm || result.basis || result.draco) {
+        const parts = [result.wasm && 'WASM', result.basis && 'Basis', result.draco && 'Draco'].filter(Boolean);
+        console.log(`Synced runtime assets (${parts.join(', ')}) → public/stowkit/`);
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/stowkit-cli",
-  "version": "0.1.31",
+  "version": "0.6.15",
   "type": "module",
   "bin": {
     "stowkit": "./dist/cli.js"
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "@series-inc/stowkit-packer-gui": "^0.1.17",
-    "@series-inc/stowkit-editor": "^0.1.3",
+    "@series-inc/stowkit-editor": "^0.1.4",
     "draco3d": "^1.5.7",
     "fbx-parser": "^2.1.3",
     "@strangeape/ffmpeg-audio-wasm": "^0.1.0",

package/skill.md

@@ -37,7 +37,8 @@ A StowKit project has a `.felicityproject` JSON file at its root:
 
 ```bash
 stowkit init [dir]              # Scaffold a new project (interactive menu: pipeline only or with 3D engine)
-stowkit init --with-engine      # Scaffold with 3D engine pre-installed
+stowkit init --with-engine      # Scaffold with 3D engine pre-installed (@series-inc/rundot-3d-engine + three)
+stowkit init --no-engine        # Scaffold without 3D engine (skip interactive prompt)
 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
@@ -559,6 +560,17 @@ The CLI always re-extracts GLB containers on every build, so changes to `preserv
 - **true:** The original scene graph node hierarchy is preserved with local transforms (position, rotation, scale) per node. Use this for complex multi-part models where you need individual nodes at runtime (e.g. a vehicle with doors, a character with attachable accessories).
 - Skinned meshes are always excluded from hierarchy preservation regardless of this setting.
 
+### Inspecting built packs
+
+Use `stowkit inspect` to examine the contents of a built `.stow` pack file:
+
+```bash
+stowkit inspect public/cdn-assets/default.stow       # Show manifest (asset names, types, sizes)
+stowkit inspect public/cdn-assets/default.stow -v     # Verbose — includes metadata details per asset
+```
+
+This is useful for verifying build output, checking which assets ended up in which pack, and debugging asset loading issues at runtime.
+
 ### Other common tasks
 
 - **Add a texture:** Place PNG/JPG into `assets/`, run `stowkit build`. The CLI auto-generates the `.stowmeta`. Do NOT create it yourself.
@@ -572,6 +584,9 @@ The CLI always re-extracts GLB containers on every build, so changes to `preserv
 - **Move an asset:** `stowkit move textures/hero.png characters` (moves to `characters/hero.png`, updates GLB child refs if container)
 - **Delete an asset:** `stowkit delete textures/unused.png` (removes source + .stowmeta + .stowcache, cascades for GLB containers)
 - **Change an asset's stringId:** `stowkit set-id textures/hero.png hero_diffuse`
+- **Inspect a built pack:** `stowkit inspect public/cdn-assets/default.stow` (shows manifest; add `-v` for detailed metadata)
 - **Check project health:** Run `stowkit status`
 - **Full rebuild:** `stowkit build --force`
 - **Clean orphaned files:** `stowkit clean`
+- **Set up with engine:** `stowkit init --with-engine` (installs `@series-inc/rundot-3d-engine` + `three`)
+- **Update CLI + skill files:** `stowkit update`