@azerate/claudette-mcp 1.6.0 → 1.7.1

package/README.md

@@ -64,6 +64,7 @@ Add to `~/.claude.json`:
 |------|-------------|
 | `get_changes` | Get pending git changes (modified, added, deleted files) |
 | `get_branch_info` | Get current branch, behind/ahead status, sync state |
+| `get_branch_pr_status` | Check if current branch has an open/merged/closed PR |
 | `create_branch` | Create a new feature branch from main/master |
 | `sync_branch` | Rebase or merge current branch with main |
 | `get_checkpoints` | List saved checkpoints (git stash snapshots) |
@@ -76,6 +77,7 @@ Add to `~/.claude.json`:
 | Tool | Description |
 |------|-------------|
 | `get_workflow_status` | Get current workflow pipeline status |
+| `get_workflow_recommendation` | **Smart recommendation** - analyzes branch, PR status, and changes to suggest the best next action |
 | `trigger_workflow` | Start the workflow (lint, types, tests, coverage, benchmarks) |
 | `generate_commit_message` | Generate a commit message from changes |
 | `approve_commit` | Stage and commit with the provided message |
@@ -115,6 +117,31 @@ Add to `~/.claude.json`:
 | `complete_refactor_step` | Mark a step as completed |
 | `complete_refactor` | Finish refactoring and delete plan |
 
+## Smart Workflow Recommendations
+
+Before starting a workflow, always call `get_workflow_recommendation` to get intelligent guidance:
+
+```
+get_workflow_recommendation(workspace_path="/path/to/project")
+```
+
+The tool analyzes your current state and recommends the best action:
+
+| Recommended Action | When | What to Do |
+|-------------------|------|------------|
+| `start_workflow` | Normal flow, no blockers | Proceed with `trigger_workflow` |
+| `create_feature_branch` | On main with `requireFeatureBranch` enabled | Use `create_branch` first |
+| `add_to_existing_pr` | On feature branch with open PR | Your commits will update the existing PR |
+| `switch_to_main` | PR was merged, branch is stale | Switch to main, pull, create new branch |
+| `create_new_branch` | PR was closed (not merged) | Create a fresh branch or reopen PR |
+| `sync_branch_first` | Branch is >5 commits behind main | Use `sync_branch` before committing |
+| `no_changes` | No uncommitted changes | Nothing to commit yet |
+
+Each recommendation includes:
+- **reason**: Why this action is recommended
+- **suggestion**: What you should do (trust this!)
+- **consequences**: What will happen if you proceed
+
 ## Workflow Pipeline
 
 The workflow feature provides a 10-step guided development process with best-practice Git support:

package/dist/index.js

@@ -634,6 +634,34 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["workspace_path"],
                 },
             },
+            {
+                name: "get_branch_pr_status",
+                description: "Check if the current branch has an associated pull request and its status (open, merged, or closed). Useful for understanding the current state before making changes.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        workspace_path: {
+                            type: "string",
+                            description: "Path to the workspace directory",
+                        },
+                    },
+                    required: ["workspace_path"],
+                },
+            },
+            {
+                name: "get_workflow_recommendation",
+                description: "Get a smart recommendation for what to do before starting the workflow. Analyzes current branch, PR status, uncommitted changes, and sync status to suggest the best next action. ALWAYS call this before trigger_workflow to ensure you're following best practices.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        workspace_path: {
+                            type: "string",
+                            description: "Path to the workspace directory",
+                        },
+                    },
+                    required: ["workspace_path"],
+                },
+            },
         ],
     };
 });
@@ -1356,6 +1384,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (status.error) {
                     output += `\n❌ Error: ${status.error}\n`;
                 }
+                // Show recommendation if available (auto-populated when changes exist)
+                if (status.recommendation) {
+                    const rec = status.recommendation;
+                    const actionIcons = {
+                        'start_workflow': '▶️',
+                        'create_feature_branch': '🌿',
+                        'add_to_existing_pr': '📝',
+                        'switch_to_main': '🔄',
+                        'create_new_branch': '🆕',
+                        'sync_branch_first': '🔀',
+                        'no_changes': '📭',
+                    };
+                    const icon = actionIcons[rec.action] || '❓';
+                    output += `\n${"─".repeat(40)}\n`;
+                    output += `${icon} RECOMMENDATION: ${rec.action.replace(/_/g, ' ').toUpperCase()}\n`;
+                    output += `${rec.suggestion}\n`;
+                }
                 return { content: [{ type: "text", text: output }] };
             }
             catch (err) {
@@ -1632,6 +1677,103 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return { content: [{ type: "text", text: `Error: ${err.message}` }] };
             }
         }
+        case "get_branch_pr_status": {
+            const workspacePath = args?.workspace_path;
+            if (!workspacePath) {
+                return { content: [{ type: "text", text: "Error: workspace_path is required" }] };
+            }
+            try {
+                const response = await fetch(`${CLAUDETTE_API}/api/workflow/pr-status?path=${encodeURIComponent(workspacePath)}`);
+                const status = await response.json();
+                let output = `Branch PR Status\n${'='.repeat(50)}\n\n`;
+                if (!status.hasPR) {
+                    output += `No pull request found for this branch.\n`;
+                    output += `\nThis is normal if:\n`;
+                    output += `  • You're on main/master\n`;
+                    output += `  • This is a new feature branch without a PR yet\n`;
+                }
+                else {
+                    const statusIcon = status.prStatus === 'open' ? '🟢' :
+                        status.prStatus === 'merged' ? '🟣' : '🔴';
+                    output += `${statusIcon} PR #${status.prNumber}: ${status.prStatus.toUpperCase()}\n`;
+                    output += `Title: ${status.prTitle}\n`;
+                    output += `URL: ${status.prUrl}\n`;
+                    if (status.isDraft) {
+                        output += `📝 This is a draft PR\n`;
+                    }
+                    output += `\n`;
+                    if (status.prStatus === 'open') {
+                        output += `ℹ️ New commits will be added to this existing PR.\n`;
+                    }
+                    else if (status.prStatus === 'merged') {
+                        output += `⚠️ This PR was merged. Consider switching to main and creating a new branch.\n`;
+                    }
+                    else {
+                        output += `⚠️ This PR was closed without merging. You may want to create a new branch or reopen it.\n`;
+                    }
+                }
+                return { content: [{ type: "text", text: output }] };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `Error: ${err.message}` }] };
+            }
+        }
+        case "get_workflow_recommendation": {
+            const workspacePath = args?.workspace_path;
+            if (!workspacePath) {
+                return { content: [{ type: "text", text: "Error: workspace_path is required" }] };
+            }
+            try {
+                const response = await fetch(`${CLAUDETTE_API}/api/workflow/recommendation?path=${encodeURIComponent(workspacePath)}`);
+                const rec = await response.json();
+                let output = `Workflow Recommendation\n${'='.repeat(50)}\n\n`;
+                // Action header with icon
+                const actionIcons = {
+                    'start_workflow': '▶️',
+                    'create_feature_branch': '🌿',
+                    'add_to_existing_pr': '📝',
+                    'switch_to_main': '🔄',
+                    'create_new_branch': '🆕',
+                    'sync_branch_first': '🔀',
+                    'no_changes': '📭',
+                };
+                const icon = actionIcons[rec.action] || '❓';
+                output += `${icon} RECOMMENDED ACTION: ${rec.action.replace(/_/g, ' ').toUpperCase()}\n\n`;
+                // Current state summary
+                output += `Current State:\n`;
+                output += `────────────────────────────────────────\n`;
+                output += `  Branch: ${rec.details.currentBranch}${rec.details.isMain ? ' (main)' : ''}\n`;
+                output += `  Changes: ${rec.details.changeCount} uncommitted file(s)\n`;
+                if (rec.details.prStatus) {
+                    output += `  PR: #${rec.details.prStatus.prNumber} (${rec.details.prStatus.prStatus})\n`;
+                }
+                if (rec.details.behindMain && rec.details.behindMain > 0) {
+                    output += `  ⚠️ Behind main: ${rec.details.behindMain} commit(s)\n`;
+                }
+                output += `\n`;
+                // Reason and suggestion
+                output += `Why:\n`;
+                output += `────────────────────────────────────────\n`;
+                output += `${rec.reason}\n\n`;
+                output += `Suggestion:\n`;
+                output += `────────────────────────────────────────\n`;
+                output += `${rec.suggestion}\n\n`;
+                // What will happen
+                if (rec.consequences.length > 0) {
+                    output += `What will happen:\n`;
+                    output += `────────────────────────────────────────\n`;
+                    for (const c of rec.consequences) {
+                        output += `  • ${c}\n`;
+                    }
+                }
+                output += `\n${'='.repeat(50)}\n`;
+                output += `Trust this recommendation and proceed accordingly.\n`;
+                return { content: [{ type: "text", text: output }] };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `Error: ${err.message}` }] };
+            }
+        }
         default:
             return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azerate/claudette-mcp",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "MCP server for Claudette IDE - TypeScript errors, git changes, checkpoints, memory, and script management",
   "type": "module",
   "main": "dist/index.js",