@fias/arche-sdk 1.2.1 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/arche-sdk",
-  "version": "1.2.1",
+  "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,33 +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.
 
-**With real AI (recommended — requires login first):**
-```bash
-npm start              # Starts both Vite + dev harness with real AI (uses credits)
-```
+### Switching to Live Mode (Real AI)
 
-**Without AI (offline, for UI-only work):**
-```bash
-npm run start:mock     # Starts both Vite + dev harness with mock 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.
 
-`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`.
+You can choose between **Staging** and **Production** environments using the dropdown in the toolbar. Each environment requires separate authentication.
 
-**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:** 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.
 
-**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`).
+### CLI Authentication (Alternative)
 
-**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.
+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,33 +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.
 
-**With real AI (recommended — requires login first):**
-```bash
-npm start              # Starts both Vite + dev harness with real AI (uses credits)
-```
+### Switching to Live Mode (Real AI)
 
-**Without AI (offline, for UI-only work):**
-```bash
-npm run start:mock     # Starts both Vite + dev harness with mock 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.
 
-`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`.
+You can choose between **Staging** and **Production** environments using the dropdown in the toolbar. Each environment requires separate authentication.
 
-**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:** 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.
 
-**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`).
+### CLI Authentication (Alternative)
 
-**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.
+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": "fias-dev check-auth && 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": {