@elixium.ai/mcp-server 0.1.7 → 0.1.9

package/dist/index.js

@@ -113,16 +113,9 @@ const parseLaneStyle = (value) => {
     return null;
 };
 const inferLaneStyleFromUrl = (apiUrl) => {
-    try {
-        const host = new URL(apiUrl).hostname.toLowerCase();
-        if (host === "localhost" || host === "127.0.0.1" || host.endsWith(".local")) {
-            return "title";
-        }
-    }
-    catch {
-        // Fall through to default.
-    }
-    return "upper";
+    // Default to title case as that's what the frontend LaneType enum expects
+    // (e.g., "Backlog", "Current", "Done", "Icebox")
+    return "title";
 };
 const normalizeLaneForComparison = (lane) => {
     if (typeof lane !== "string")
@@ -453,7 +446,7 @@ const createServer = () => {
                 // TDD Workflow Tools
                 {
                     name: "start_story",
-                    description: "Start TDD workflow for a story - creates branch and sets workflow_stage to tdd_start. Call this first, then write tests.",
+                    description: "Start TDD workflow for a story. By default creates a feature branch. Set trunkBased=true to work directly on main (recommended for small changes).",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -463,9 +456,13 @@ const createServer = () => {
                             },
                             branchPrefix: {
                                 type: "string",
-                                description: "Branch prefix (feat, fix, chore)",
+                                description: "Branch prefix (feat, fix, chore) - ignored if trunkBased=true",
                                 enum: ["feat", "fix", "chore"],
                             },
+                            trunkBased: {
+                                type: "boolean",
+                                description: "If true, skip branch creation and commit directly to main. Recommended for small, well-tested changes.",
+                            },
                         },
                         required: ["storyId"],
                     },
@@ -538,6 +535,12 @@ const createServer = () => {
                     const args = request.params.arguments;
                     const normalizedLane = await normalizeLane(args.lane);
                     const boardId = await resolveBoardId();
+                    // Warn if no boardId - stories may not appear on board UI
+                    if (!boardId) {
+                        console.warn("Warning: ELIXIUM_BOARD_SLUG is not set or board not found. " +
+                            "Stories created without boardId may not appear on the board UI. " +
+                            "Set ELIXIUM_BOARD_SLUG in your MCP configuration.");
+                    }
                     // Use requester from args, fall back to env var, then let backend use API key owner
                     const requester = args.requester || USER_EMAIL;
                     const response = await client.post("/stories", {
@@ -720,15 +723,35 @@ Here’s the smallest change that will validate it:
                 // TDD Workflow Handlers
                 case "start_story": {
                     const args = request.params.arguments;
-                    const { storyId, branchPrefix } = args;
+                    const { storyId, branchPrefix, trunkBased } = args;
                     if (!storyId) {
                         throw new Error("storyId is required");
                     }
                     const response = await client.post(`/stories/${storyId}/start`, {
                         branchPrefix: branchPrefix || "feat",
+                        trunkBased: trunkBased || false,
                     });
                     const result = response.data;
-                    const formattedResult = `
+                    const isTrunk = trunkBased || result.branch === "main";
+                    const formattedResult = isTrunk ? `
+# Story Started (Trunk-Based): ${storyId}
+
+**Mode:** 🚀 Direct to main (trunk-based development)
+**Workflow Stage:** ${result.workflow_stage}
+
+## Acceptance Criteria
+${result.acceptance_criteria || "No specific AC provided."}
+
+## Trunk-Based Workflow
+1. ✅ Write tests first
+2. ✅ Call \`propose_test_plan\` and wait for approval
+3. ✅ Implement (make tests pass)
+4. ✅ Run \`npm run build\` to verify
+5. ✅ Commit directly to main
+6. 🚀 Auto-deploy on green CI
+
+> ⚠️ **TDD Workflow:** Write tests first, then call \`propose_test_plan\` before implementing.
+` : `
 # Story Started: ${storyId}
 
 **Branch:** \`${result.branch}\`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elixium.ai/mcp-server",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "MCP Server for Elixium.ai",
   "publishConfig": {

package/templates/workflows/implement-story.md

@@ -7,6 +7,13 @@ Follow this workflow when a developer selects a story for implementation.
 > [!IMPORTANT]
 > This workflow enforces **Test-Driven Development**. You cannot skip tests.
 
+## Workflow Modes
+
+| Mode | When to Use | Branch Strategy |
+|------|-------------|-----------------|
+| **Trunk-Based** (recommended) | Small, well-scoped stories (<1 day) | Direct to `main` |
+| **Branch-Based** | Large features, breaking changes | Feature branch → PR → merge |
+
 ### 0. Check the North Star
 - **Before any implementation**, read `docs/NORTHSTAR.md` to understand current priorities and principles.
 - Verify the story aligns with the decision framework.
@@ -19,8 +26,17 @@ Follow this workflow when a developer selects a story for implementation.
 
 ### 2. Start TDD Workflow (MANDATORY)
 - Call `mcp_elixium_start_story` with the storyId.
-- This creates a git branch and sets `workflow_stage: tdd_start`.
-- You will receive the branch name and a reminder to write tests first.
+- **For trunk-based (default for small changes):** Add `trunkBased: true`
+- **For branch-based (large features):** Omit trunkBased or set to false
+- This sets `workflow_stage: tdd_start`.
+
+```
+// Trunk-based (recommended for most stories)
+mcp_elixium_start_story({ storyId: "abc123", trunkBased: true })
+
+// Branch-based (for larger features)
+mcp_elixium_start_story({ storyId: "abc123", branchPrefix: "feat" })
+```
 
 ### 3. Write Tests First (MANDATORY)
 - Create test files that cover the acceptance criteria.
@@ -60,12 +76,16 @@ Follow this workflow when a developer selects a story for implementation.
   - `implementationNotes`: Summary of what was implemented
 - This sets `state: finished` and `workflow_stage: review`.
 
-### 8. Final Human Review
-- The developer reviews the diff and runs tests one more time.
+### 8. Merge & Deploy
+- **Trunk-based:** Push to main → CI runs → auto-deploys to prod on green ✅
+- **Branch-based:** Create PR → review → merge → auto-deploys to prod
+
+### 9. Final Human Review
+- The developer reviews the deployment in production.
 - **Only the developer** can move the story to Done lane.
 - **Only the developer** can set state to `accepted`.
 
-### 9. Record Learning
+### 10. Record Learning
 - Before the developer moves to Done, use `mcp_elixium_record_learning` to capture:
     - What was validated?
     - What new risks appeared?