@fias/arche-sdk 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/arche-sdk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "SDK for building FIAS platform plugin arches",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/default/AGENTS.md

@@ -259,17 +259,21 @@ This opens the FIAS platform in your browser. If you're already signed in, the A
 
 ### Step 2: Start development
 
+**With real AI (recommended — requires login first):**
 ```bash
 npm start              # Starts both Vite + dev harness with real AI (uses credits)
 ```
 
-Or for offline development without credits (AI calls return canned responses):
-
+**Without AI (offline, for UI-only work):**
 ```bash
-npm run start:mock     # Starts both Vite + dev harness with mock AI
+npm run start:mock     # Starts both Vite + dev harness with mock responses
 ```
 
-Open http://localhost:3200 in your browser.
+`npm start` will fail with "Not logged in" if `npx fias-dev login` hasn't been run. If that happens, run the login command first, then retry `npm start`.
+
+**IMPORTANT:** Always tell the user to open **http://localhost:3200** in their browser to see the plugin running. Port 3200 is the dev harness that wraps the plugin in the platform iframe. Port 3100 is just the raw Vite server and won't work correctly on its own.
+
+**IMPORTANT:** `npm start` uses real AI and costs credits. `npm run start:mock` returns canned responses and does NOT call real AI models. If the user wants actual AI-powered features to work during testing, they MUST use `npm start` (not `start:mock`).
 
 **Advanced:** If you prefer separate terminals, use `npm run dev` (Vite on port 3100) and `npm run dev:harness` or `npm run dev:mock` (harness on port 3200) independently.
 

package/templates/default/CLAUDE.md

@@ -259,17 +259,21 @@ This opens the FIAS platform in your browser. If you're already signed in, the A
 
 ### Step 2: Start development
 
+**With real AI (recommended — requires login first):**
 ```bash
 npm start              # Starts both Vite + dev harness with real AI (uses credits)
 ```
 
-Or for offline development without credits (AI calls return canned responses):
-
+**Without AI (offline, for UI-only work):**
 ```bash
-npm run start:mock     # Starts both Vite + dev harness with mock AI
+npm run start:mock     # Starts both Vite + dev harness with mock responses
 ```
 
-Open http://localhost:3200 in your browser.
+`npm start` will fail with "Not logged in" if `npx fias-dev login` hasn't been run. If that happens, run the login command first, then retry `npm start`.
+
+**IMPORTANT:** Always tell the user to open **http://localhost:3200** in their browser to see the plugin running. Port 3200 is the dev harness that wraps the plugin in the platform iframe. Port 3100 is just the raw Vite server and won't work correctly on its own.
+
+**IMPORTANT:** `npm start` uses real AI and costs credits. `npm run start:mock` returns canned responses and does NOT call real AI models. If the user wants actual AI-powered features to work during testing, they MUST use `npm start` (not `start:mock`).
 
 **Advanced:** If you prefer separate terminals, use `npm run dev` (Vite on port 3100) and `npm run dev:harness` or `npm run dev:mock` (harness on port 3200) independently.
 

package/templates/default/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "start": "vite & sleep 2 && fias-dev --live",
+    "start": "fias-dev check-auth && vite & sleep 2 && fias-dev --live",
     "start:mock": "vite & sleep 2 && fias-dev",
     "dev": "vite",
     "build": "vite build",