schemeog-mcp 3.6.0 → 3.6.2

package/README.md

@@ -1,17 +1,18 @@
-# SchemeOG MCP Server v3.2
+# SchemeOG MCP Server v3.6
 
 MCP server for [Diagrams.love](https://diagrams.love) — create diagrams and flowcharts with AI.
 
 ## Features
 
-- **17 commands** for schemas, projects, tags, and import/export
+- **21 commands** for schemas, projects, tags, versions, and import/export
+- **Version history**: View, restore, and create checkpoints for schemas
 - **Auto-refresh**: Browser automatically reloads when MCP updates schema
 - **Smart positioning**: Existing elements keep their positions, new elements get auto-layout
 - **No coordinate conflicts**: MCP ignores x/y to prevent overlapping cards
 - **Shared links support**: Open schemas via public `/shared/` URLs (read-only)
 - **Large schema handling**: Automatic detection and preview for schemas >100 elements
 
-## 17 Commands
+## 21 Commands
 
 ### Schemas (6 commands)
 
@@ -50,6 +51,15 @@ MCP server for [Diagrams.love](https://diagrams.love) — create diagrams and fl
 | `remove_tag` | Remove tag from schema |
 | `tag_element` | Assign/remove tag from element |
 
+### Versions (4 commands)
+
+| Command | Description |
+|---------|-------------|
+| `list_versions` | List schema version history (auto-saves and manual checkpoints) |
+| `get_version` | Get full data of a specific version |
+| `restore_version` | Restore schema from a previous version (auto-backup before restore) |
+| `create_version` | Create manual checkpoint with optional comment |
+
 ## Installation
 
 ### Via npx (recommended)
@@ -181,6 +191,35 @@ Connections are defined inside each element's `connections` array:
 
 **Line styles (`style`):** `solid` (default), `dashed`, `dotted`
 
+### Connection Label Format
+
+**RULE:** All connection labels should be in `[square brackets]`
+
+This visually highlights transitions and user actions on the diagram:
+
+```json
+{
+  "connections": [
+    {"to": "home", "label": "[Login]"},
+    {"to": "register", "label": "[Register]"},
+    {"to": "error", "label": "[Error]"},
+    {"to": "success", "label": "[Success]"}
+  ]
+}
+```
+
+**Why square brackets:**
+- Clearly distinguishes action labels from regular text
+- Shows user actions/triggers on transitions
+- Consistent visual style across all schemas
+
+**Example in ASCII:**
+```
+┌───────────┐  [Login]  ┌───────────┐
+│   Login   │──────────▶│   Home    │
+└───────────┘           └───────────┘
+```
+
 ### Full schema example
 
 ```json
@@ -401,10 +440,30 @@ import_schema_from_json(
 
 ## Version History
 
-MCP now automatically creates versions when updating schemas:
-- Before each update via MCP, a snapshot is saved
-- View version history in the web interface (History tab)
-- Restore any previous version with one click
+Full version control for your schemas:
+
+### Commands
+
+```
+# List all versions
+list_versions(schema_id: "xxx")
+
+# View specific version
+get_version(schema_id: "xxx", version_id: "yyy")
+
+# Restore from version (auto-backup before restore)
+restore_version(schema_id: "xxx", version_id: "yyy")
+
+# Create manual checkpoint
+create_version(schema_id: "xxx", comment: "Before refactoring")
+```
+
+### Features
+
+- **Auto-save**: Every schema change creates a version automatically
+- **Manual checkpoints**: Create named versions before important changes
+- **Safe restore**: Current state is backed up before any restore
+- **100 versions limit**: Old auto-saves are cleaned, manual checkpoints are preserved
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemeog-mcp",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "description": "MCP Server for Diagrams.love - Create and manage visual diagrams and flowcharts with AI assistance",
   "type": "module",
   "main": "index.js",