@ign8t/mcp 0.2.0 → 0.3.1

package/README.md

@@ -205,9 +205,21 @@ The MCP server also provides quick access to resources:
 | `reject_recommendations` | Reject recommendations                           | "Reject this duplicate recommendation"       |
 | `add_user_persona`       | Add or replace a user persona in context         | "Add admin operator persona"                 |
 | `update_success_criteria`| Add or update measurable success criteria        | "Add activation-rate target"                 |
+| `update_context`         | Change the tech stack and constraints after you confirm the exact change | "We moved from Firebase to Supabase" |
 | `import_project`         | Import the local codebase into project context (28 Sparks) | "Import this codebase into project abc123" |
 
-The write tools (`create_task`, `update_task_status`, `accept_recommendations`, `reject_recommendations`, `add_feature_request`, `add_user_persona`, `update_success_criteria`) are free. Only `import_project` costs Sparks.
+The write tools (`create_task`, `update_task_status`, `accept_recommendations`, `reject_recommendations`, `add_feature_request`, `add_user_persona`, `update_success_criteria`, `update_context`) are free. Only `import_project` costs Sparks.
+
+### Updating the implementation context
+
+`update_context` lets the project owner's AI change what ign8t knows about the implementation: the tech stack and the project constraints. Vision, features, users and success criteria are not writable through it.
+
+- Any key already in the project's tech stack can be changed or removed, spelled exactly as stored (`backend` and `Backend` are different keys). A key stored as text takes a new text value; a key stored as a list takes items to add or remove (added values are trimmed, removed values must match the stored text exactly). Constraints work like a list.
+- Besides the stored keys, only `platform`, `framework`, `database` and `ai_models` can be added, as text or as a list. Any other new key is rejected, so the stack doesn't split into near-duplicate keys.
+
+- The AI reads the project with `get_project` first, shows you the exact change, and applies it only after you agree. The change is saved immediately and costs no Sparks.
+- All previously generated documents (BRD/PRD/TRD, delivery brief, master spec, task specs) may be marked stale. They are not regenerated automatically, and regenerating them costs Sparks.
+- If the context changed since the AI read it, nothing is saved: the AI reads it again and asks you again.
 
 ### Importing a local codebase
 

package/dist/index.js

@@ -3,7 +3,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { buildWorkspaceSnapshot } from "./workspace-snapshot.js";
-const VERSION = "0.2.0";
+const VERSION = "0.3.1";
 // Parse command line arguments
 function parseArgs() {
     const args = process.argv.slice(2);
@@ -93,6 +93,12 @@ async function callIgn8tAPI(endpoint, data = {}) {
     }
     return response.json();
 }
+// update_context's add/remove of list items, each at most maxLength characters; the
+// 20-operation cap is on the whole patch (see its description).
+const listOps = (maxLength) => {
+    const items = { type: "array", items: { type: "string", minLength: 1, maxLength } };
+    return { type: "object", properties: { add: items, remove: items }, additionalProperties: false };
+};
 // Define available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
@@ -577,6 +583,58 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["project_id", "criteria"],
                 },
             },
+            {
+                name: "update_context",
+                description: "Change the project's implementation context: tech_stack keys and constraints. Use the tech_stack key names you see in get_project's context.tech_stack, spelled exactly as stored (\"backend\" and \"Backend\" are different keys); besides those, only platform, framework, database and ai_models can be added. Every key follows what is stored: a key stored as text takes a new text value; a key stored as a list takes add/remove items (add values are trimmed; remove values must match the stored text exactly), as do constraints; a key not stored yet takes either. List keys in tech_stack.unset to remove them. Writes immediately and costs zero Sparks. Call get_project first and pass its context.context_version as expected_context_version. Before calling, show the user the exact change and tell them that all previously generated documents (BRD/PRD/TRD, delivery brief, master spec, task specs) may be marked stale, and that regenerating them costs Sparks; set confirmed_with_user to true only after the user agreed. A CONTEXT_CHANGED error means the context changed since you read it: read it again, reconcile, and ask the user again. Vision, features, users and success criteria are not writable here: use add_user_persona, update_success_criteria or add_feature_request.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            format: "uuid",
+                            description: "The project ID",
+                        },
+                        expected_context_version: {
+                            type: "integer",
+                            minimum: 1,
+                            description: "context.context_version from the get_project call the user's confirmation was based on",
+                        },
+                        reason: {
+                            type: "string",
+                            minLength: 10,
+                            maxLength: 500,
+                            description: "Why this change is needed (e.g., what was discovered while implementing)",
+                        },
+                        confirmed_with_user: {
+                            type: "boolean",
+                            description: "Must be true, set only after the user saw the exact change and agreed to it; anything else is rejected",
+                        },
+                        patch: {
+                            type: "object",
+                            description: "At most 20 operations in total (each set, unset, added or removed item counts). A list can grow to at most 50 items, and the tech stack and constraints to at most 12000 characters together.",
+                            properties: {
+                                tech_stack: {
+                                    type: "object",
+                                    properties: {
+                                        unset: {
+                                            type: "array",
+                                            items: { type: "string", minLength: 1, maxLength: 60 },
+                                            description: "Keys to remove; a key cannot be both changed and unset",
+                                        },
+                                    },
+                                    additionalProperties: {
+                                        description: "A key already stored in tech_stack, or one of the canonical keys platform, framework, database, ai_models (at most 60 characters): a string of 1-200 characters if it is stored as text, {add, remove} arrays of 1-200 character strings if it is stored as a list, either if it is not stored yet. Other new keys are rejected with UNKNOWN_TECH_STACK_KEY.",
+                                    },
+                                },
+                                constraints: listOps(500),
+                            },
+                            additionalProperties: false,
+                        },
+                    },
+                    required: ["project_id", "expected_context_version", "reason", "confirmed_with_user", "patch"],
+                    additionalProperties: false,
+                },
+            },
         ],
     };
 });
@@ -688,6 +746,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
                 console.error("Success criteria updated successfully");
                 break;
             }
+            case "update_context":
+                result = await callIgn8tAPI("/context/update", args);
+                break;
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ign8t/mcp",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "MCP server for ign8t project management - AI IDE integration",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
   "mcp": {
     "name": "ign8t-mcp",
     "description": "MCP server for ign8t project management - AI IDE integration",
-    "version": "0.2.0"
+    "version": "0.3.1"
   },
   "author": "nocodecat",
   "license": "MIT",