@fias/arche-sdk 1.1.7 → 1.1.9

package/package.json

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

package/templates/default/AGENTS.md

@@ -253,31 +253,28 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-```bash
-# Terminal 1: Start plugin dev server (Vite, port 3100)
-npm run dev
-
-# Terminal 2: Start dev harness (mock mode, port 3200)
-npm run dev:mock
+### Step 1: Authenticate (one-time)
 
-# Open http://localhost:3200 in browser
+```bash
+npx fias-dev login           # Opens browser to sign in, saves API key automatically
 ```
 
-### Authenticating with the FIAS Platform
+### Step 2: Start development
 
 ```bash
-npx fias-dev login           # Opens browser to authenticate (recommended)
-npx fias-dev login --key fias_sk_...  # Or paste an API key directly
+npm start              # Starts both Vite + dev harness with real AI (uses credits)
 ```
 
-Running `npx fias-dev login` opens your browser to the FIAS platform. After signing in, an API key is created automatically and saved to `~/.fias/credentials`. No manual key copying needed.
-
-### Testing with Real AI Entities (costs credits)
+Or for offline development without credits (AI calls return canned responses):
 
 ```bash
-npm run dev:harness          # Start harness in live mode (requires login first)
+npm run start:mock     # Starts both Vite + dev harness with mock AI
 ```
 
+Open http://localhost:3200 in your browser.
+
+**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.
+
 ### Browsing Available Entities
 
 ```bash

package/templates/default/CLAUDE.md

@@ -253,31 +253,28 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-```bash
-# Terminal 1: Start plugin dev server (Vite, port 3100)
-npm run dev
-
-# Terminal 2: Start dev harness (mock mode, port 3200)
-npm run dev:mock
+### Step 1: Authenticate (one-time)
 
-# Open http://localhost:3200 in browser
+```bash
+npx fias-dev login           # Opens browser to sign in, saves API key automatically
 ```
 
-### Authenticating with the FIAS Platform
+### Step 2: Start development
 
 ```bash
-npx fias-dev login           # Opens browser to authenticate (recommended)
-npx fias-dev login --key fias_sk_...  # Or paste an API key directly
+npm start              # Starts both Vite + dev harness with real AI (uses credits)
 ```
 
-Running `npx fias-dev login` opens your browser to the FIAS platform. After signing in, an API key is created automatically and saved to `~/.fias/credentials`. No manual key copying needed.
-
-### Testing with Real AI Entities (costs credits)
+Or for offline development without credits (AI calls return canned responses):
 
 ```bash
-npm run dev:harness          # Start harness in live mode (requires login first)
+npm run start:mock     # Starts both Vite + dev harness with mock AI
 ```
 
+Open http://localhost:3200 in your browser.
+
+**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.
+
 ### Browsing Available Entities
 
 ```bash

package/templates/default/package.json

@@ -3,6 +3,8 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
+    "start": "vite & fias-dev --live",
+    "start:mock": "vite & fias-dev",
     "dev": "vite",
     "build": "vite build",
     "validate": "tsc --noEmit",