ai-spector 0.4.8 → 0.4.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spector",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "Cursor-first documentation workflow: traceability graph, SRS/basic/detail design templates, and ai-spector CLI",
   "type": "module",
   "license": "MIT",
@@ -59,6 +59,7 @@
   },
   "dependencies": {
     "@types/mdast": "^4.0.4",
+    "ai-spector": "^0.4.8",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^12.1.0",

package/scaffold/cursor/skills/ai-spector-generate-prototype/references/runbook.md

@@ -260,9 +260,23 @@ npx ai-spector prototype sync --json
 
 Output includes each screen's `screenDoc → uri` mapping.
 
+### Vite base path — required before first build
+
+Vite defaults to `base: '/'`, generating absolute asset URLs (`/assets/app.js`). When `dist/` is deployed to a subdirectory, all asset requests resolve from the server root and return 403/404.
+
+**Set `base: './'` in `vite.config.ts` before building:**
+
+```ts
+export default defineConfig({
+  base: './',   // relative paths — works at any subdirectory depth
+})
+```
+
 ### Full SPA workflow
 
 ```bash
+# 0. Ensure vite.config.ts has base: './'  ← required or assets will 403
+
 # 1. Build the SPA
 cd frontend && npm run build && cd ..
 

package/scaffold/cursor/skills/ai-spector-generate-prototype/references/stack-picker.md

@@ -21,6 +21,28 @@ Skip when:
 | SvelteKit | `svelte` | `spa` | `routes/<slug>/+page.svelte` per screen |
 | Angular | `angular` | `spa` | component per screen |
 
+## Required: relative base path for Vite-based stacks (vue, react, svelte)
+
+> Vite defaults to `base: '/'` which generates **absolute** asset URLs (`/assets/app.js`). When the built `dist/` is served from a subdirectory (e.g. `/project-id/1.4/dist/`), all asset requests hit the server root and return 403/404.
+
+**Always set `base: './'` in `vite.config.ts` before the first build:**
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  base: './',   // relative paths — works at any subdirectory depth
+})
+```
+
+After adding this, rebuild and resync:
+
+```bash
+npm run build
+npx ai-spector prototype sync --clean
+```
+
+When the agent sets up a Vite-based stack (vue / react / svelte), it **must** write or verify `base: './'` in `vite.config.ts` before generating any other files. Flag it explicitly to the user if the config is missing or set to `'/'`.
+
 ## Step 1 — Check stored stack
 
 Read `.ai-spector/.docflow/config/prototype.config.json`. If `techStack` is set, skip this entire flow.