docs: auto-update documentation based on changes in next branch

This PR was automatically generated to update documentation based on recent changes.

  Original commit: Merge pull request #1231 from eyaltoledano/ralph/merge.from.main\n\n\n

  Co-authored-by: Claude <claude-assistant@anthropic.com>

apps/cli/package.json

@@ -9,10 +9,7 @@
 	"exports": {
 		".": "./src/index.ts"
 	},
-	"files": [
+	"files": ["dist", "README.md"],
-		"dist",
-		"README.md"
-	],
 	"scripts": {
 		"typecheck": "tsc --noEmit",
 		"lint": "biome check src",
@@ -45,19 +42,12 @@
 	"engines": {
 		"node": ">=18.0.0"
 	},
-	"keywords": [
+	"keywords": ["task-master", "cli", "task-management", "productivity"],
-		"task-master",
-		"cli",
-		"task-management",
-		"productivity"
-	],
 	"author": "",
 	"license": "MIT",
 	"typesVersions": {
 		"*": {
-			"*": [
+			"*": ["src/*"]
-				"src/*"
-			]
 		}
 	}
 }

apps/docs/capabilities/cli-root-commands.mdx

@@ -206,4 +206,25 @@ sidebarTitle: "CLI Commands"
     task-master init
     ```
   </Accordion>
+
+  <Accordion title="Start Working on Tasks">
+    ```bash
+    # Start working on a specific task with Claude Code
+    task-master start <task-id>
+
+    # Start working on the next available task automatically
+    task-master start
+
+    # Example: Start working on task 1.2
+    task-master start 1.2
+    ```
+
+    The `start` command automatically launches Claude Code with a comprehensive prompt containing:
+    - Complete task details and context
+    - Implementation guidelines and best practices
+    - Relevant codebase information
+    - Dependencies and requirements
+
+    When no task ID is provided, it automatically detects and starts the next available task.
+  </Accordion>
 </AccordionGroup>

apps/docs/getting-started/quick-start/configuration-quick.mdx

@@ -30,7 +30,8 @@ For MCP/Cursor usage: Configure keys in the env section of your .cursor/mcp.json
 				"MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
 				"AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
 				"OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE",
-				"GITHUB_API_KEY": "GITHUB_API_KEY_HERE"
+				"GITHUB_API_KEY": "GITHUB_API_KEY_HERE",
+				"GROK_CLI_API_KEY": "GROK_CLI_API_KEY_HERE"
 			}
 		}
 	}
@@ -62,8 +63,50 @@ PERPLEXITY_API_KEY=pplx-your-key-here
 
 # Google Vertex AI Configuration (Required if using 'vertex' provider)
 # VERTEX_PROJECT_ID=your-gcp-project-id
+
+# Grok CLI Configuration (Required if using 'grok-cli' provider)
+# GROK_CLI_API_KEY=your-grok-api-key-here
+
+# Codebase Analysis Feature Control
+# TASKMASTER_ENABLE_CODEBASE_ANALYSIS=true  # Enable codebase analysis features (default: true)
 ```
 
+## Grok Provider Setup
+
+Task Master now supports Grok models from xAI with full codebase context awareness. This is especially useful for AI operations that benefit from understanding your entire project structure.
+
+### Getting Started with Grok
+
+1. **Get your Grok API key** from [console.x.ai](https://console.x.ai)
+2. **Set the environment variable**:
+   ```bash
+   export GROK_CLI_API_KEY="your-api-key-here"
+   ```
+3. **Configure Task Master to use Grok**:
+   ```bash
+   task-master models --set-main grok-beta
+   # or
+   task-master models --set-research grok-beta
+   # or  
+   task-master models --set-fallback grok-beta
+   ```
+
+### Key Features
+
+- **Full codebase context**: Grok models can analyze your entire project when generating tasks or parsing PRDs
+- **xAI model access**: Support for latest Grok models (grok-2, grok-3, grok-4, etc.)
+- **Code-aware task generation**: Create more accurate and contextual tasks based on your actual codebase
+- **Intelligent PRD parsing**: Parse requirements with understanding of your existing code structure
+
+### Available Models
+
+- `grok-beta` - Latest Grok model with codebase context
+- `grok-vision-beta` - Grok with vision capabilities and codebase context
+
+<Note>
+The Grok CLI provider integrates with xAI's Grok models via [grok-cli](https://github.com/superagent-ai/grok-cli) by Superagent AI and can also use the local Grok CLI configuration file (`~/.grok/user-settings.json`) if available.
+</Note>
+
 ## What Else Can Be Configured?
 
 The main configuration file (`.taskmaster/config.json`) allows you to control nearly every aspect of Task Master’s behavior. Here’s a high-level look at what you can customize:
@@ -89,6 +132,13 @@ You don’t need to configure everything up front. Most settings can be left as
 - `defaultSubtasks`: Number of subtasks to auto-generate
 - `defaultPriority`: Priority level for new tasks
 
+### Codebase Analysis Control
+- `TASKMASTER_ENABLE_CODEBASE_ANALYSIS`: Control whether codebase analysis features are enabled
+  - Can be set via environment variables, MCP configuration, or project config files
+  - Priority order: `.env` > MCP session env > `.taskmaster/config.json`
+  - Default: `true`
+  - When enabled, allows providers like Claude Code and Gemini CLI to analyze your project structure for more contextual task generation
+
 ### API Endpoint Overrides
 - `ollamaBaseURL`: Custom Ollama server URL
 - `azureBaseURL`: Global Azure endpoint

apps/docs/whats-new.mdx

@@ -3,4 +3,78 @@ title: "What's New"
 sidebarTitle: "What's New"
 ---
 
-An easy way to see the latest releases
+## Version 0.27.0 - Latest Release
+
+### New Features
+
+#### `task-master start` Command
+- **Automated Task Execution**: New command that automatically launches Claude Code with comprehensive task context
+- **Smart Task Detection**: When no task ID is provided, automatically detects and starts the next available task
+- **Rich Context**: Provides complete task details, implementation guidelines, and codebase information to Claude Code
+
+#### Grok Provider Integration
+- **Full Codebase Context**: Grok models can now analyze your entire project when generating tasks or parsing PRDs
+- **xAI Model Support**: Access to latest Grok models (grok-2, grok-3, grok-4, etc.) via the grok-cli integration
+- **Code-Aware Generation**: More accurate and contextual task creation based on your actual codebase structure
+- **Available Models**: 
+  - `grok-beta` - Latest Grok model with codebase context
+  - `grok-vision-beta` - Grok with vision capabilities and codebase context
+
+### Improvements
+
+#### Enhanced Provider Defaults
+- **Main Model**: Upgraded from Claude 3.5 Sonnet to **Claude Sonnet 4** for better performance
+- **Fallback Model**: Improved from Claude 3.5 Sonnet to **Claude 3.7** for enhanced reliability
+
+#### MCP Server Simplification
+- **No More --package Flag**: Removed the need for `--package=task-master-ai` in MCP server configuration
+- **Bundled Package**: The entire package is now bundled, eliminating common configuration issues
+
+#### Auto-Update Functionality
+- **CLI Auto-Updates**: Every CLI command now includes auto-update functionality to keep you on the latest version
+
+#### Codebase Analysis Feature Control
+- **Configurable Analysis**: New `TASKMASTER_ENABLE_CODEBASE_ANALYSIS` environment variable to control codebase analysis features
+- **Multiple Configuration Sources**: Can be set via `.env`, MCP configuration, or project config files
+- **Priority System**: Environment variables > MCP session env > `.taskmaster/config.json`
+
+### TypeScript Migration
+- **Improved Development**: Moving from JavaScript to TypeScript environment for better development experience
+- **Gradual Migration**: JavaScript commands are being incrementally moved to TypeScript
+
+## Getting Started with New Features
+
+### Using the Start Command
+```bash
+# Start working on a specific task
+task-master start 1.2
+
+# Auto-detect and start next available task  
+task-master start
+```
+
+### Setting up Grok
+```bash
+# Set your API key
+export GROK_CLI_API_KEY="your-api-key-here"
+
+# Configure Grok as your main provider
+task-master models --set-main grok-beta
+```
+
+### Simplified MCP Configuration
+```json
+{
+  "mcpServers": {
+    "task-master-ai": {
+      "command": "npx",
+      "args": ["-y", "task-master-ai"],
+      "env": {
+        "ANTHROPIC_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+For detailed setup instructions and configuration options, see our [Configuration Guide](/docs/getting-started/quick-start/configuration-quick).

apps/extension/package.json

@@ -9,17 +9,9 @@
 	"engines": {
 		"vscode": "^1.93.0"
 	},
-	"categories": [
+	"categories": ["AI", "Visualization", "Education", "Other"],
-		"AI",
-		"Visualization",
-		"Education",
-		"Other"
-	],
 	"main": "./dist/extension.js",
-	"activationEvents": [
+	"activationEvents": ["onStartupFinished", "workspaceContains:.taskmaster/**"],
-		"onStartupFinished",
-		"workspaceContains:.taskmaster/**"
-	],
 	"contributes": {
 		"viewsContainers": {
 			"activitybar": [
@@ -147,11 +139,7 @@
 				},
 				"taskmaster.ui.theme": {
 					"type": "string",
-					"enum": [
+					"enum": ["auto", "light", "dark"],
-						"auto",
-						"light",
-						"dark"
-					],
 					"default": "auto",
 					"description": "UI theme preference"
 				},
@@ -212,12 +200,7 @@
 				},
 				"taskmaster.debug.logLevel": {
 					"type": "string",
-					"enum": [
+					"enum": ["error", "warn", "info", "debug"],
-						"error",
-						"warn",
-						"info",
-						"debug"
-					],
 					"default": "info",
 					"description": "Logging level"
 				},

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "task-master-ai",
-	"version": "0.27.0-rc.2",
+	"version": "0.27.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "task-master-ai",
-			"version": "0.27.0-rc.2",
+			"version": "0.27.0",
 			"license": "MIT WITH Commons-Clause",
 			"workspaces": [
 				"apps/*",
@@ -99,7 +99,7 @@
 		},
 		"apps/cli": {
 			"name": "@tm/cli",
-			"version": "0.27.0-rc.0",
+			"version": "0.27.0",
 			"license": "MIT",
 			"dependencies": {
 				"@tm/core": "*",
@@ -359,13 +359,13 @@
 			}
 		},
 		"apps/docs": {
-			"version": "0.0.2",
+			"version": "0.0.3",
 			"devDependencies": {
 				"mintlify": "^4.2.111"
 			}
 		},
 		"apps/extension": {
-			"version": "0.25.0-rc.0",
+			"version": "0.25.0",
 			"dependencies": {
 				"task-master-ai": "*"
 			},
@@ -31873,7 +31873,7 @@
 		},
 		"packages/build-config": {
 			"name": "@tm/build-config",
-			"version": "1.0.0",
+			"version": "1.0.1",
 			"license": "MIT",
 			"dependencies": {
 				"tsup": "^8.5.0"
@@ -31885,7 +31885,7 @@
 		},
 		"packages/tm-core": {
 			"name": "@tm/core",
-			"version": "0.26.0",
+			"version": "0.26.1",
 			"license": "MIT",
 			"dependencies": {
 				"@supabase/supabase-js": "^2.57.4",

package.json

@@ -9,11 +9,7 @@
 		"task-master-mcp": "dist/mcp-server.js",
 		"task-master-ai": "dist/mcp-server.js"
 	},
-	"workspaces": [
+	"workspaces": ["apps/*", "packages/*", "."],
-		"apps/*",
-		"packages/*",
-		"."
-	],
 	"scripts": {
 		"build": "npm run build:build-config && cross-env NODE_ENV=production tsdown",
 		"dev": "tsdown --watch",
@@ -118,12 +114,7 @@
 	"bugs": {
 		"url": "https://github.com/eyaltoledano/claude-task-master/issues"
 	},
-	"files": [
+	"files": ["dist/**", "README-task-master.md", "README.md", "LICENSE"],
-		"dist/**",
-		"README-task-master.md",
-		"README.md",
-		"LICENSE"
-	],
 	"overrides": {
 		"node-fetch": "^2.6.12",
 		"whatwg-url": "^11.0.0"

packages/build-config/package.json

@@ -12,15 +12,8 @@
 			"import": "./dist/tsdown.base.js"
 		}
 	},
-	"files": [
+	"files": ["dist", "src"],
-		"dist",
+	"keywords": ["build-config", "tsup", "monorepo"],
-		"src"
-	],
-	"keywords": [
-		"build-config",
-		"tsup",
-		"monorepo"
-	],
 	"author": "",
 	"license": "MIT",
 	"scripts": {

packages/tm-core/package.json

@@ -48,18 +48,8 @@
 	"engines": {
 		"node": ">=18.0.0"
 	},
-	"files": [
+	"files": ["src", "README.md", "CHANGELOG.md"],
-		"src",
+	"keywords": ["task-management", "typescript", "ai", "prd", "parser"],
-		"README.md",
-		"CHANGELOG.md"
-	],
-	"keywords": [
-		"task-management",
-		"typescript",
-		"ai",
-		"prd",
-		"parser"
-	],
 	"author": "Task Master AI",
 	"license": "MIT"
 }