@series-inc/stowkit-cli 0.1.31 → 0.6.14

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.14",
   "type": "module",
   "bin": {
     "stowkit": "./dist/cli.js"

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`