statemap-mcp 0.1.9 → 0.1.11

package/dist/index.js

@@ -7,7 +7,13 @@ import { resolve } from "node:path";
 function loadConfig() {
     const apiKey = process.env.STATEMAP_API_KEY;
     if (!apiKey) {
-        return { error: "STATEMAP_API_KEY environment variable is required. Get your key at https://statemap.io/app" };
+        return { error: `STATEMAP_API_KEY not set. Statemap gives your AI agent persistent memory of your system's entire state model — data models, state containers, transitions, invariants, and read dependencies — so it can detect drift, enforce constraints, and maintain architectural coherence across sessions.
+
+1. Create a free account at https://statemap.io
+2. Copy your API key from the Keys tab
+3. Add to your MCP config: "env": { "STATEMAP_API_KEY": "sm_..." }
+
+Free tier includes 1 project, snapshots, CI integration (50 runs/month), and the full MCP toolset.` };
     }
     let projectId = process.env.STATEMAP_PROJECT_ID || "";
     let baseUrl = process.env.STATEMAP_BASE_URL || "https://statemap.io";
@@ -23,7 +29,9 @@ function loadConfig() {
     catch {
     }
     if (!projectId) {
-        return { error: "Project ID required: add a .statemap file to your repo root or set STATEMAP_PROJECT_ID env var. See https://statemap.io" };
+        return { error: `No project connected. Run statemap_init to create or select a project — this writes a .statemap config file to your repo root.
+
+Or set STATEMAP_PROJECT_ID env var manually. See https://statemap.io` };
     }
     return { projectId, baseUrl: baseUrl.replace(/\/$/, ""), apiKey };
 }
@@ -286,7 +294,7 @@ let configError = "error" in loaded ? loaded.error : null;
 let config = "error" in loaded ? { projectId: "", baseUrl: "", apiKey: "" } : loaded;
 const server = new McpServer({
     name: "statemap",
-    version: "0.1.9",
+    version: "0.1.11",
 }, {
     instructions: `Statemap is a system state model for this project. Here's how to get started:
 
@@ -571,6 +579,12 @@ Re-run statemap_validate and statemap_divergence to confirm improvement.
 - **Inferred connections** — looks related but no explicit FK, probable container assignment based on naming, etc. Present these individually.
 Ask the architect to approve: they can rubber-stamp the obvious stuff ("all good") and cherry-pick the ambiguous ones.
 
+### Step 11: Review info-level issues
+After errors and warnings are resolved, review remaining info-level issues (e.g. "missing transition"). Present them grouped by pattern:
+- **Read-only mirrors** — UI store states that just hydrate from API responses and are never mutated directly. Ask: **"Are these read-only? If so I'll mark them as intentional."**
+- **Actually missing mutations** — models that do get mutated but have no transitions declared. Ask: **"Should I add transitions for these?"** If yes, search the codebase for the mutation logic and declare the transitions.
+- **Append-only / implicit** — models like audit logs, usage records that are only written to by background processes. Ask: **"Are these write-only from a system process? I can add a single transition to represent that."**
+
 ## Principles
 - The architect decides what's dead. You present and ask.
 - Walk through EVERY entity type, not just models. Dead containers, transitions, read deps, and invariants accumulate just like dead models.
@@ -591,7 +605,7 @@ server.tool("statemap_init", "Initialize Statemap for this project. Lists your e
 }, async ({ action, project_name, project_id }) => {
     const apiKey = process.env.STATEMAP_API_KEY;
     if (!apiKey) {
-        return text({ error: "STATEMAP_API_KEY environment variable is required. Get your key at https://statemap.io/app" });
+        return text({ error: `STATEMAP_API_KEY not set. Create a free account at https://statemap.io to get your API key. Free tier includes 1 project, snapshots, CI integration, and the full MCP toolset.` });
     }
     const baseUrl = (process.env.STATEMAP_BASE_URL || "https://statemap.io").replace(/\/$/, "");
     if (action === "list") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statemap-mcp",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "MCP server for Statemap — system state working memory for AI agents",
   "type": "module",
   "main": "dist/index.js",