@fias/arche-sdk 1.2.0 → 1.3.0

package/package.json

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

package/templates/default/AGENTS.md

@@ -249,29 +249,32 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-### Step 1: Authenticate (one-time)
+### Starting Development
 
 ```bash
-npx fias-dev login           # Opens browser to sign in, saves API key automatically
+npm start              # Starts both Vite + dev harness
 ```
 
-This opens the FIAS platform in your browser. If you're already signed in, the API key is created and saved automatically. If not, you'll need to sign in (or sign up for a FIAS account if you don't have one — an invite code is required for new accounts). The URL is also printed in the terminal if the browser doesn't open automatically.
+This starts the plugin in **mock mode** (free, offline). Open **http://localhost:3200** in your browser to see the plugin running inside the harness.
 
-### Step 2: Start development
+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.
 
-```bash
-npm start              # Starts both Vite + dev harness with real AI (uses credits)
-```
+### Switching to Live Mode (Real AI)
 
-Or for offline development without credits (AI calls return canned responses):
+In the harness toolbar, click the **MOCK** badge to switch to **LIVE** mode. If you haven't authenticated yet, a login popup will open automatically. Sign in with your FIAS account and the harness will switch to live mode.
 
-```bash
-npm run start:mock     # Starts both Vite + dev harness with mock AI
-```
+You can choose between **Staging** and **Production** environments using the dropdown in the toolbar. Each environment requires separate authentication.
 
-Open http://localhost:3200 in your browser.
+**IMPORTANT:** Live mode uses real AI and costs credits. Mock mode returns canned responses and does NOT call real AI models. If you want actual AI-powered features to work during testing, you MUST switch to live mode.
 
-**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.
+### CLI Authentication (Alternative)
+
+You can also authenticate via the command line:
+
+```bash
+npx fias-dev login                    # Authenticate with staging (default)
+npx fias-dev login --env production   # Authenticate with production
+```
 
 ### Browsing Available Entities
 

package/templates/default/CLAUDE.md

@@ -249,29 +249,32 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-### Step 1: Authenticate (one-time)
+### Starting Development
 
 ```bash
-npx fias-dev login           # Opens browser to sign in, saves API key automatically
+npm start              # Starts both Vite + dev harness
 ```
 
-This opens the FIAS platform in your browser. If you're already signed in, the API key is created and saved automatically. If not, you'll need to sign in (or sign up for a FIAS account if you don't have one — an invite code is required for new accounts). The URL is also printed in the terminal if the browser doesn't open automatically.
+This starts the plugin in **mock mode** (free, offline). Open **http://localhost:3200** in your browser to see the plugin running inside the harness.
 
-### Step 2: Start development
+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.
 
-```bash
-npm start              # Starts both Vite + dev harness with real AI (uses credits)
-```
+### Switching to Live Mode (Real AI)
 
-Or for offline development without credits (AI calls return canned responses):
+In the harness toolbar, click the **MOCK** badge to switch to **LIVE** mode. If you haven't authenticated yet, a login popup will open automatically. Sign in with your FIAS account and the harness will switch to live mode.
 
-```bash
-npm run start:mock     # Starts both Vite + dev harness with mock AI
-```
+You can choose between **Staging** and **Production** environments using the dropdown in the toolbar. Each environment requires separate authentication.
 
-Open http://localhost:3200 in your browser.
+**IMPORTANT:** Live mode uses real AI and costs credits. Mock mode returns canned responses and does NOT call real AI models. If you want actual AI-powered features to work during testing, you MUST switch to live mode.
 
-**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.
+### CLI Authentication (Alternative)
+
+You can also authenticate via the command line:
+
+```bash
+npx fias-dev login                    # Authenticate with staging (default)
+npx fias-dev login --env production   # Authenticate with production
+```
 
 ### Browsing Available Entities
 

package/templates/default/package.json

@@ -3,13 +3,11 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "start": "vite & sleep 2 && fias-dev --live",
-    "start:mock": "vite & sleep 2 && fias-dev",
+    "start": "vite & sleep 2 && fias-dev",
     "dev": "vite",
     "build": "vite build",
     "validate": "tsc --noEmit",
-    "dev:harness": "fias-dev --live",
-    "dev:mock": "fias-dev",
+    "dev:harness": "fias-dev",
     "submit": "fias-dev submit"
   },
   "dependencies": {