jetic-cli 0.2.3 → 0.2.4

package/README.md

@@ -95,10 +95,39 @@ Jetic comes with a built-in **Model Context Protocol (MCP)** server so your edit
 ```
 *(On Windows, use `"command": ["cmd", "/c", "jetic", "mcp"]`)*
 
-### Recommended Agent Prompts:
-> 1. *"Run `jetic_get_session_phase` and guide me through building the API model for this project."*  
-> 2. *"Scan the backend, check endpoint completeness, fill missing descriptions/tags, and run `jetic_verify_model`."*  
-> 3. *"What workflow or integration test would you like to simulate against local environment?"*
+### 💬 Example Prompts for AI IDE
+
+Use these prompt templates with your editor's AI assistant (opencode, Antigravity, Cursor, Claude Code, VS Code) to manage initialization, model creation, and workflow simulation:
+
+#### 🚀 Phase 1: Initialize Project (`init`)
+> **Session Health & Quickstart:**  
+> *"Call `jetic_get_session_phase`. If the model is not initialized, run `jetic_init` to scaffold `.jetic/` and guide me through setting up the API."*
+
+> **Fresh Repository Scaffold:**  
+> *"Initialize Jetic in this workspace (`jetic_init`), configure project metadata for our TypeScript backend, and verify that `.jetic/model.json` exists."*
+
+#### 📐 Phase 2 & 3: Create & Verify Model (`create model`)
+> **Automated AST Scan & Verification:**  
+> *"Scan our backend codebase (`jetic_scan`) to populate endpoints. Then run `jetic_verify_model` to highlight any missing descriptions, schemas, or tags."*
+
+> **Model Completeness & Audit:**  
+> *"Run `jetic_verify_model`. Update every endpoint with missing descriptions or tags using `jetic_update_endpoint`, and re-verify until the model status is 100% complete and valid."*
+
+> **Selective AI Re-Modelling via Change Log (`changes.json`):**  
+> *"Check recent file changes (`jetic_get_changes`). Re-analyse ONLY those modified files to update `.jetic/model.json` instead of reading the entire codebase, then clear the change log (`jetic_clear_changes`)."*
+
+#### ⚡ Phase 4: Create & Run Workflows (`create workflow`)
+> **Scaffold & Create Workflow:**  
+> *"Scaffold a user onboarding workflow (`jetic_scaffold_workflow`) with `POST /api/auth/register` and `GET /api/users/me`. Automatically inject the auth token, validate the workflow, and save it to `.jetic/workflows/user-onboarding.json`."*
+
+> **Advanced Workflow with Conditions & Retry Logic:**  
+> *"Build an order fulfillment workflow. Step 1: Login. Step 2: Create Order. Step 3: Payment (add step condition `if {{workflow:userRole}} equals "admin"` and `retry` up to 3 times on failure). Validate (`jetic_validate_workflow`) and save it."*
+
+> **Human Input Workflow (2FA / OTP):**  
+> *"Build a sensitive transfer workflow that requires human 2FA. Scaffold the steps, use `{{human:otp_code}}` for the verification payload, set `retry: { "times": 2, "delayMs": 1000 }`, and save to `.jetic/workflows/transfer.json`."*
+
+#### 🎯 All-in-One Master Prompt
+> *"Run `jetic_get_session_phase` and follow the Jetic 4-Phase protocol: 1. Initialize `.jetic/` if missing. 2. Scan the source code and verify the model until all endpoint descriptions are complete. 3. Ask me what integration scenario I want to test, then scaffold, validate, and save the workflow."*
 
 ---
 
@@ -111,9 +140,9 @@ Jetic comes with a built-in **Model Context Protocol (MCP)** server so your edit
 | `jetic inspect` | Inspect summary metrics or specific endpoint schemas in terminal |
 | `jetic simulate endpoint` | Test live HTTP endpoints against local/staging server |
 | `jetic simulate workflow` | Execute multi-step stateful workflows from `.jetic/workflows/` |
-| `jetic dev` | Launch local **Jetic Studio** dashboard UI on port `8787` |
+| `jetic dev` | Launch local **Jetic Studio** dashboard UI on port `8787` with real-time SSE file watcher & `changes.json` live stream |
 | `jetic memory` | View, set, or clear runtime variable memory (`.jetic/memory.json`) |
-| `jetic mcp` | Start stdio MCP server for AI IDE integration |
+| `jetic mcp` | Start stdio MCP server for AI IDE integration (includes `jetic_get_changes` & `jetic_clear_changes`) |
 
 ---
 
@@ -123,12 +152,15 @@ Run `jetic dev` to open the local web developer studio:
 
 - **Behavioral Model (`/model`)**: Explore endpoints, request/response schemas, and AST source code lines.
 - **AI Simulations (`/simulations`)**: Visual step-by-step workflow runner with real-time SSE execution logs.
+- **Files Changes (`/changes`)**: Real-time SSE stream observer for `.jetic/changes.json` — track modified source files live without browser reloads.
 - **Memory Inspector (`/memory`)**: Edit captured tokens, fake test data, and session variables.
 - **Visual Traces (`/traces`)**: Interactive node-graph execution visualizer powered by ReactFlow.
 
 ---
 
-## 📄 Behavioral Model Preview (`.jetic/model.json`)
+## 📄 Artifact Schemas
+
+### `.jetic/model.json` (Behavioral Model)
 
 ```json
 {
@@ -156,6 +188,24 @@ Run `jetic dev` to open the local web developer studio:
 }
 ```
 
+### `.jetic/changes.json` (File Changes Tracking Log)
+
+```json
+{
+  "version": 1,
+  "watchedSince": "2026-09-18T10:00:00.000Z",
+  "projectRoot": "C:/projects/my-api",
+  "changes": [
+    {
+      "filePath": "src/routes/user.routes.ts",
+      "absolutePath": "C:/projects/my-api/src/routes/user.routes.ts",
+      "changedAt": "2026-09-18T14:20:00.000Z",
+      "eventType": "change"
+    }
+  ]
+}
+```
+
 ---
 
 <p align="center">