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>

.changeset/config.json

@@ -11,6 +11,9 @@
   "access": "public",
   "baseBranch": "main",
   "ignore": [
-    "docs"
+    "docs",
+    "@tm/cli",
+    "@tm/core",
+    "@tm/build-config"
   ]
 }

.changeset/fluffy-clocks-cross.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix module not found for new 0.27.0 release

.changeset/pre.json

@@ -1,12 +0,0 @@
-{
-  "mode": "pre",
-  "tag": "rc",
-  "initialVersions": {
-    "task-master-ai": "0.27.0",
-    "docs": "0.0.3",
-    "extension": "0.25.1"
-  },
-  "changesets": [
-    "fluffy-clocks-cross"
-  ]
-}

.changeset/soft-dingos-grow.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-One last testing final final

.manypkg.json

@@ -1,6 +0,0 @@
-{
-	"$schema": "https://unpkg.com/@manypkg/get-packages@1.1.3/schema.json",
-	"defaultBranch": "main",
-	"ignoredRules": ["ROOT_HAS_DEPENDENCIES", "INTERNAL_MISMATCH"],
-	"ignoredPackages": ["@tm/core", "@tm/cli", "@tm/build-config"]
-}

CHANGELOG.md

@@ -1,11 +1,5 @@
 # task-master-ai
 
-## 0.27.1-rc.0
-
-### Patch Changes
-
-- [#1232](https://github.com/eyaltoledano/claude-task-master/pull/1232) [`f487736`](https://github.com/eyaltoledano/claude-task-master/commit/f487736670ef8c484059f676293777eabb249c9e) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix module not found for new 0.27.0 release
-
 ## 0.27.0
 
 ### Minor Changes

apps/cli/package.json

@@ -1,5 +1,6 @@
 {
 	"name": "@tm/cli",
+	"version": "0.27.0",
 	"description": "Task Master CLI - Command line interface for task management",
 	"type": "module",
 	"private": true,
@@ -23,12 +24,12 @@
 	},
 	"dependencies": {
 		"@tm/core": "*",
-		"boxen": "^8.0.1",
+		"boxen": "^7.1.1",
 		"chalk": "5.6.2",
 		"cli-table3": "^0.6.5",
 		"commander": "^12.1.0",
-		"inquirer": "^12.5.0",
+		"inquirer": "^9.2.10",
-		"ora": "^8.2.0"
+		"ora": "^8.1.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",

apps/cli/src/index.ts

@@ -18,8 +18,7 @@ export * as ui from './utils/ui.js';
 export {
 	checkForUpdate,
 	performAutoUpdate,
-	displayUpgradeNotification,
+	displayUpgradeNotification
-	compareVersions
 } from './utils/auto-update.js';
 
 // Re-export commonly used types from tm-core

apps/cli/src/utils/auto-update.ts

@@ -7,6 +7,7 @@ import https from 'https';
 import chalk from 'chalk';
 import ora from 'ora';
 import boxen from 'boxen';
+import packageJson from '../../../../package.json' with { type: 'json' };
 
 export interface UpdateInfo {
 	currentVersion: string;
@@ -15,18 +16,15 @@ export interface UpdateInfo {
 }
 
 /**
- * Get current version from build-time injected environment variable
+ * Get current version from package.json
  */
 function getCurrentVersion(): string {
-	// Version is injected at build time via TM_PUBLIC_VERSION
+	try {
-	const version = process.env.TM_PUBLIC_VERSION;
+		return packageJson.version;
-	if (version && version !== 'unknown') {
+	} catch (error) {
-		return version;
+		console.warn('Could not read package.json for version info');
+		return '0.0.0';
 	}
-
-	// Fallback for development or if injection failed
-	console.warn('Could not read version from TM_PUBLIC_VERSION, using fallback');
-	return '0.0.0';
 }
 
 /**
@@ -35,7 +33,7 @@ function getCurrentVersion(): string {
  * @param v2 - Second version
  * @returns -1 if v1 < v2, 0 if v1 = v2, 1 if v1 > v2
  */
-export function compareVersions(v1: string, v2: string): number {
+function compareVersions(v1: string, v2: string): number {
 	const toParts = (v: string) => {
 		const [core, pre = ''] = v.split('-', 2);
 		const nums = core.split('.').map((n) => Number.parseInt(n, 10) || 0);

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/CHANGELOG.md

@@ -1,12 +1,5 @@
 # Change Log
 
-## 0.25.2-rc.0
-
-### Patch Changes
-
-- Updated dependencies [[`f487736`](https://github.com/eyaltoledano/claude-task-master/commit/f487736670ef8c484059f676293777eabb249c9e)]:
-  - task-master-ai@0.27.1-rc.0
-
 ## 0.25.0
 
 ### Minor Changes

apps/extension/package.json

@@ -3,7 +3,7 @@
 	"private": true,
 	"displayName": "TaskMaster",
 	"description": "A visual Kanban board interface for TaskMaster projects in VS Code",
-	"version": "0.25.2-rc.0",
+	"version": "0.25.0",
 	"publisher": "Hamster",
 	"icon": "assets/icon.png",
 	"engines": {
@@ -240,7 +240,7 @@
 		"check-types": "tsc --noEmit"
 	},
 	"dependencies": {
-		"task-master-ai": "0.27.1-rc.0"
+		"task-master-ai": "*"
 	},
 	"devDependencies": {
 		"@dnd-kit/core": "^6.3.1",
@@ -254,9 +254,8 @@
 		"@radix-ui/react-separator": "^1.1.7",
 		"@radix-ui/react-slot": "^1.2.3",
 		"@tailwindcss/postcss": "^4.1.11",
-		"@tanstack/react-query": "^5.83.0",
 		"@types/mocha": "^10.0.10",
-		"@types/node": "^22.10.5",
+		"@types/node": "20.x",
 		"@types/react": "19.1.8",
 		"@types/react-dom": "19.1.6",
 		"@types/vscode": "^1.101.0",
@@ -272,11 +271,12 @@
 		"lucide-react": "^0.525.0",
 		"npm-run-all": "^4.1.5",
 		"postcss": "8.5.6",
-		"react": "^19.0.0",
-		"react-dom": "^19.0.0",
 		"tailwind-merge": "^3.3.1",
 		"tailwindcss": "4.1.11",
-		"typescript": "^5.7.3"
+		"typescript": "^5.8.3",
+		"@tanstack/react-query": "^5.83.0",
+		"react": "^19.0.0",
+		"react-dom": "^19.0.0"
 	},
 	"overrides": {
 		"glob@<8": "^10.4.5",

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "task-master-ai",
-	"version": "0.27.1-rc.0",
+	"version": "0.27.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "task-master-ai",
-			"version": "0.27.1-rc.0",
+			"version": "0.27.0",
 			"license": "MIT WITH Commons-Clause",
 			"workspaces": [
 				"apps/*",
@@ -29,7 +29,6 @@
 				"@inquirer/search": "^3.0.15",
 				"@openrouter/ai-sdk-provider": "^0.4.5",
 				"@streamparser/json": "^0.0.22",
-				"@supabase/supabase-js": "^2.57.4",
 				"ai": "^4.3.10",
 				"ajv": "^8.17.1",
 				"ajv-formats": "^3.0.1",
@@ -38,7 +37,7 @@
 				"cli-highlight": "^2.1.11",
 				"cli-progress": "^3.12.0",
 				"cli-table3": "^0.6.5",
-				"commander": "^12.1.0",
+				"commander": "^11.1.0",
 				"cors": "^2.8.5",
 				"dotenv": "^16.3.1",
 				"express": "^4.21.2",
@@ -71,7 +70,6 @@
 				"@biomejs/biome": "^1.9.4",
 				"@changesets/changelog-github": "^0.5.1",
 				"@changesets/cli": "^2.28.1",
-				"@manypkg/cli": "^0.25.1",
 				"@tm/cli": "*",
 				"@types/jest": "^29.5.14",
 				"@types/marked-terminal": "^6.1.1",
@@ -86,9 +84,9 @@
 				"supertest": "^7.1.0",
 				"ts-jest": "^29.4.2",
 				"tsdown": "^0.15.2",
-				"tsx": "^4.20.4",
+				"tsx": "^4.16.2",
 				"turbo": "^2.5.6",
-				"typescript": "^5.7.3"
+				"typescript": "^5.9.2"
 			},
 			"engines": {
 				"node": ">=18.0.0"
@@ -101,15 +99,16 @@
 		},
 		"apps/cli": {
 			"name": "@tm/cli",
+			"version": "0.27.0",
 			"license": "MIT",
 			"dependencies": {
 				"@tm/core": "*",
-				"boxen": "^8.0.1",
+				"boxen": "^7.1.1",
 				"chalk": "5.6.2",
 				"cli-table3": "^0.6.5",
 				"commander": "^12.1.0",
-				"inquirer": "^12.5.0",
+				"inquirer": "^9.2.10",
-				"ora": "^8.2.0"
+				"ora": "^8.1.0"
 			},
 			"devDependencies": {
 				"@biomejs/biome": "^1.9.4",
@@ -190,6 +189,15 @@
 			"integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
 			"license": "MIT"
 		},
+		"apps/cli/node_modules/commander": {
+			"version": "12.1.0",
+			"resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+			"integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=18"
+			}
+		},
 		"apps/cli/node_modules/emoji-regex": {
 			"version": "8.0.0",
 			"resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
@@ -357,9 +365,9 @@
 			}
 		},
 		"apps/extension": {
-			"version": "0.25.2-rc.0",
+			"version": "0.25.0",
 			"dependencies": {
-				"task-master-ai": "0.27.1-rc.0"
+				"task-master-ai": "*"
 			},
 			"devDependencies": {
 				"@dnd-kit/core": "^6.3.1",
@@ -375,7 +383,7 @@
 				"@tailwindcss/postcss": "^4.1.11",
 				"@tanstack/react-query": "^5.83.0",
 				"@types/mocha": "^10.0.10",
-				"@types/node": "^22.10.5",
+				"@types/node": "20.x",
 				"@types/react": "19.1.8",
 				"@types/react-dom": "19.1.6",
 				"@types/vscode": "^1.101.0",
@@ -395,7 +403,7 @@
 				"react-dom": "^19.0.0",
 				"tailwind-merge": "^3.3.1",
 				"tailwindcss": "4.1.11",
-				"typescript": "^5.7.3"
+				"typescript": "^5.8.3"
 			},
 			"engines": {
 				"vscode": "^1.93.0"
@@ -5391,101 +5399,6 @@
 			"dev": true,
 			"license": "MIT"
 		},
-		"node_modules/@manypkg/cli": {
-			"version": "0.25.1",
-			"resolved": "https://registry.npmjs.org/@manypkg/cli/-/cli-0.25.1.tgz",
-			"integrity": "sha512-lag906FyiNxzZjsRErkUD5/to174I2JzPk5bZubuJp6loMKKJn73zrtqeU7nHlVkHBg3tgXDTJj22HxUDxLRXw==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"@manypkg/get-packages": "^3.1.0",
-				"detect-indent": "^7.0.1",
-				"normalize-path": "^3.0.0",
-				"p-limit": "^6.2.0",
-				"package-json": "^10.0.1",
-				"parse-github-url": "^1.0.3",
-				"picocolors": "^1.1.1",
-				"sembear": "^0.7.0",
-				"semver": "^7.7.1",
-				"tinyexec": "^1.0.1",
-				"validate-npm-package-name": "^6.0.0"
-			},
-			"bin": {
-				"manypkg": "bin.js"
-			},
-			"engines": {
-				"node": ">=20.0.0"
-			}
-		},
-		"node_modules/@manypkg/cli/node_modules/@manypkg/find-root": {
-			"version": "3.1.0",
-			"resolved": "https://registry.npmjs.org/@manypkg/find-root/-/find-root-3.1.0.tgz",
-			"integrity": "sha512-BcSqCyKhBVZ5YkSzOiheMCV41kqAFptW6xGqYSTjkVTl9XQpr+pqHhwgGCOHQtjDCv7Is6EFyA14Sm5GVbVABA==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"@manypkg/tools": "^2.1.0"
-			},
-			"engines": {
-				"node": ">=20.0.0"
-			}
-		},
-		"node_modules/@manypkg/cli/node_modules/@manypkg/get-packages": {
-			"version": "3.1.0",
-			"resolved": "https://registry.npmjs.org/@manypkg/get-packages/-/get-packages-3.1.0.tgz",
-			"integrity": "sha512-0TbBVyvPrP7xGYBI/cP8UP+yl/z+HtbTttAD7FMAJgn/kXOTwh5/60TsqP9ZYY710forNfyV0N8P/IE/ujGZJg==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"@manypkg/find-root": "^3.1.0",
-				"@manypkg/tools": "^2.1.0"
-			},
-			"engines": {
-				"node": ">=20.0.0"
-			}
-		},
-		"node_modules/@manypkg/cli/node_modules/detect-indent": {
-			"version": "7.0.2",
-			"resolved": "https://registry.npmjs.org/detect-indent/-/detect-indent-7.0.2.tgz",
-			"integrity": "sha512-y+8xyqdGLL+6sh0tVeHcfP/QDd8gUgbasolJJpY7NgeQGSZ739bDtSiaiDgtoicy+mtYB81dKLxO9xRhCyIB3A==",
-			"dev": true,
-			"license": "MIT",
-			"engines": {
-				"node": ">=12.20"
-			},
-			"funding": {
-				"url": "https://github.com/sponsors/sindresorhus"
-			}
-		},
-		"node_modules/@manypkg/cli/node_modules/p-limit": {
-			"version": "6.2.0",
-			"resolved": "https://registry.npmjs.org/p-limit/-/p-limit-6.2.0.tgz",
-			"integrity": "sha512-kuUqqHNUqoIWp/c467RI4X6mmyuojY5jGutNU0wVTmEOOfcuwLqyMVoAi9MKi2Ak+5i9+nhmrK4ufZE8069kHA==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"yocto-queue": "^1.1.1"
-			},
-			"engines": {
-				"node": ">=18"
-			},
-			"funding": {
-				"url": "https://github.com/sponsors/sindresorhus"
-			}
-		},
-		"node_modules/@manypkg/cli/node_modules/yocto-queue": {
-			"version": "1.2.1",
-			"resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.1.tgz",
-			"integrity": "sha512-AyeEbWOu/TAXdxlV9wmGcR0+yh2j3vYPGOECcIj2S7MkrLyC7ne+oye2BKTItt0ii2PHk4cDy+95+LshzbXnGg==",
-			"dev": true,
-			"license": "MIT",
-			"engines": {
-				"node": ">=12.20"
-			},
-			"funding": {
-				"url": "https://github.com/sponsors/sindresorhus"
-			}
-		},
 		"node_modules/@manypkg/find-root": {
 			"version": "1.1.0",
 			"resolved": "https://registry.npmjs.org/@manypkg/find-root/-/find-root-1.1.0.tgz",
@@ -5598,41 +5511,6 @@
 				"node": ">= 4.0.0"
 			}
 		},
-		"node_modules/@manypkg/tools": {
-			"version": "2.1.0",
-			"resolved": "https://registry.npmjs.org/@manypkg/tools/-/tools-2.1.0.tgz",
-			"integrity": "sha512-0FOIepYR4ugPYaHwK7hDeHDkfPOBVvayt9QpvRbi2LT/h2b0GaE/gM9Gag7fsnyYyNaTZ2IGyOuVg07IYepvYQ==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"jju": "^1.4.0",
-				"js-yaml": "^4.1.0",
-				"tinyglobby": "^0.2.13"
-			},
-			"engines": {
-				"node": ">=20.0.0"
-			}
-		},
-		"node_modules/@manypkg/tools/node_modules/argparse": {
-			"version": "2.0.1",
-			"resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
-			"integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-			"dev": true,
-			"license": "Python-2.0"
-		},
-		"node_modules/@manypkg/tools/node_modules/js-yaml": {
-			"version": "4.1.0",
-			"resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-			"integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"argparse": "^2.0.1"
-			},
-			"bin": {
-				"js-yaml": "bin/js-yaml.js"
-			}
-		},
 		"node_modules/@mdx-js/mdx": {
 			"version": "3.1.1",
 			"resolved": "https://registry.npmjs.org/@mdx-js/mdx/-/mdx-3.1.1.tgz",
@@ -7462,51 +7340,6 @@
 				"node": ">=14"
 			}
 		},
-		"node_modules/@pnpm/config.env-replace": {
-			"version": "1.1.0",
-			"resolved": "https://registry.npmjs.org/@pnpm/config.env-replace/-/config.env-replace-1.1.0.tgz",
-			"integrity": "sha512-htyl8TWnKL7K/ESFa1oW2UB5lVDxuF5DpM7tBi6Hu2LNL3mWkIzNLG6N4zoCUP1lCKNxWy/3iu8mS8MvToGd6w==",
-			"dev": true,
-			"license": "MIT",
-			"engines": {
-				"node": ">=12.22.0"
-			}
-		},
-		"node_modules/@pnpm/network.ca-file": {
-			"version": "1.0.2",
-			"resolved": "https://registry.npmjs.org/@pnpm/network.ca-file/-/network.ca-file-1.0.2.tgz",
-			"integrity": "sha512-YcPQ8a0jwYU9bTdJDpXjMi7Brhkr1mXsXrUJvjqM2mQDgkRiz8jFaQGOdaLxgjtUfQgZhKy/O3cG/YwmgKaxLA==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"graceful-fs": "4.2.10"
-			},
-			"engines": {
-				"node": ">=12.22.0"
-			}
-		},
-		"node_modules/@pnpm/network.ca-file/node_modules/graceful-fs": {
-			"version": "4.2.10",
-			"resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.10.tgz",
-			"integrity": "sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==",
-			"dev": true,
-			"license": "ISC"
-		},
-		"node_modules/@pnpm/npm-conf": {
-			"version": "2.3.1",
-			"resolved": "https://registry.npmjs.org/@pnpm/npm-conf/-/npm-conf-2.3.1.tgz",
-			"integrity": "sha512-c83qWb22rNRuB0UaVCI0uRPNRr8Z0FWnEIvT47jiHAmOIUHbBOg5XvV7pM5x+rKn9HRpjxquDbXYSXr3fAKFcw==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"@pnpm/config.env-replace": "^1.1.0",
-				"@pnpm/network.ca-file": "^1.0.1",
-				"config-chain": "^1.1.11"
-			},
-			"engines": {
-				"node": ">=12"
-			}
-		},
 		"node_modules/@protobufjs/aspromise": {
 			"version": "1.1.2",
 			"resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz",
@@ -14304,12 +14137,12 @@
 			}
 		},
 		"node_modules/commander": {
-			"version": "12.1.0",
+			"version": "11.1.0",
-			"resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+			"resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz",
-			"integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+			"integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==",
 			"license": "MIT",
 			"engines": {
-				"node": ">=18"
+				"node": ">=16"
 			}
 		},
 		"node_modules/component-emitter": {
@@ -14442,17 +14275,6 @@
 			"integrity": "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==",
 			"license": "MIT"
 		},
-		"node_modules/config-chain": {
-			"version": "1.1.13",
-			"resolved": "https://registry.npmjs.org/config-chain/-/config-chain-1.1.13.tgz",
-			"integrity": "sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"ini": "^1.3.4",
-				"proto-list": "~1.2.1"
-			}
-		},
 		"node_modules/consola": {
 			"version": "3.4.2",
 			"resolved": "https://registry.npmjs.org/consola/-/consola-3.4.2.tgz",
@@ -14934,6 +14756,7 @@
 			"integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
 			"dev": true,
 			"license": "MIT",
+			"optional": true,
 			"engines": {
 				"node": ">=4.0.0"
 			}
@@ -18902,7 +18725,8 @@
 			"resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
 			"integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
 			"dev": true,
-			"license": "ISC"
+			"license": "ISC",
+			"optional": true
 		},
 		"node_modules/ink": {
 			"version": "6.3.0",
@@ -21870,13 +21694,6 @@
 				"jiti": "lib/jiti-cli.mjs"
 			}
 		},
-		"node_modules/jju": {
-			"version": "1.4.0",
-			"resolved": "https://registry.npmjs.org/jju/-/jju-1.4.0.tgz",
-			"integrity": "sha512-8wb9Yw966OSxApiCt0K3yNJL8pnNeIv+OEq2YMidz4FKP6nonSRoOXc80iXY4JaN2FC11B9qsNmDsm+ZOfMROA==",
-			"dev": true,
-			"license": "MIT"
-		},
 		"node_modules/joycon": {
 			"version": "3.1.1",
 			"resolved": "https://registry.npmjs.org/joycon/-/joycon-3.1.1.tgz",
@@ -22215,19 +22032,6 @@
 				"node": ">=6"
 			}
 		},
-		"node_modules/ky": {
-			"version": "1.10.0",
-			"resolved": "https://registry.npmjs.org/ky/-/ky-1.10.0.tgz",
-			"integrity": "sha512-YRPCzHEWZffbfvmRrfwa+5nwBHwZuYiTrfDX0wuhGBPV0pA/zCqcOq93MDssON/baIkpYbvehIX5aLpMxrRhaA==",
-			"dev": true,
-			"license": "MIT",
-			"engines": {
-				"node": ">=18"
-			},
-			"funding": {
-				"url": "https://github.com/sindresorhus/ky?sponsor=1"
-			}
-		},
 		"node_modules/lcm": {
 			"version": "0.0.3",
 			"resolved": "https://registry.npmjs.org/lcm/-/lcm-0.0.3.tgz",
@@ -25435,25 +25239,6 @@
 				"node": ">= 14"
 			}
 		},
-		"node_modules/package-json": {
-			"version": "10.0.1",
-			"resolved": "https://registry.npmjs.org/package-json/-/package-json-10.0.1.tgz",
-			"integrity": "sha512-ua1L4OgXSBdsu1FPb7F3tYH0F48a6kxvod4pLUlGY9COeJAJQNX/sNH2IiEmsxw7lqYiAwrdHMjz1FctOsyDQg==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"ky": "^1.2.0",
-				"registry-auth-token": "^5.0.2",
-				"registry-url": "^6.0.1",
-				"semver": "^7.6.0"
-			},
-			"engines": {
-				"node": ">=18"
-			},
-			"funding": {
-				"url": "https://github.com/sponsors/sindresorhus"
-			}
-		},
 		"node_modules/package-json-from-dist": {
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
@@ -25517,19 +25302,6 @@
 			"dev": true,
 			"license": "MIT"
 		},
-		"node_modules/parse-github-url": {
-			"version": "1.0.3",
-			"resolved": "https://registry.npmjs.org/parse-github-url/-/parse-github-url-1.0.3.tgz",
-			"integrity": "sha512-tfalY5/4SqGaV/GIGzWyHnFjlpTPTNpENR9Ea2lLldSJ8EWXMsvacWucqY3m3I4YPtas15IxTLQVQ5NSYXPrww==",
-			"dev": true,
-			"license": "MIT",
-			"bin": {
-				"parse-github-url": "cli.js"
-			},
-			"engines": {
-				"node": ">= 0.10"
-			}
-		},
 		"node_modules/parse-json": {
 			"version": "5.2.0",
 			"resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
@@ -26175,13 +25947,6 @@
 				"url": "https://github.com/sponsors/wooorm"
 			}
 		},
-		"node_modules/proto-list": {
-			"version": "1.2.4",
-			"resolved": "https://registry.npmjs.org/proto-list/-/proto-list-1.2.4.tgz",
-			"integrity": "sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==",
-			"dev": true,
-			"license": "ISC"
-		},
 		"node_modules/protobufjs": {
 			"version": "7.5.4",
 			"resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz",
@@ -26518,6 +26283,7 @@
 			"integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
 			"dev": true,
 			"license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
+			"optional": true,
 			"dependencies": {
 				"deep-extend": "^0.6.0",
 				"ini": "~1.3.0",
@@ -26534,6 +26300,7 @@
 			"integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
 			"dev": true,
 			"license": "MIT",
+			"optional": true,
 			"engines": {
 				"node": ">=0.10.0"
 			}
@@ -26950,35 +26717,6 @@
 				"url": "https://github.com/sponsors/ljharb"
 			}
 		},
-		"node_modules/registry-auth-token": {
-			"version": "5.1.0",
-			"resolved": "https://registry.npmjs.org/registry-auth-token/-/registry-auth-token-5.1.0.tgz",
-			"integrity": "sha512-GdekYuwLXLxMuFTwAPg5UKGLW/UXzQrZvH/Zj791BQif5T05T0RsaLfHc9q3ZOKi7n+BoprPD9mJ0O0k4xzUlw==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"@pnpm/npm-conf": "^2.1.0"
-			},
-			"engines": {
-				"node": ">=14"
-			}
-		},
-		"node_modules/registry-url": {
-			"version": "6.0.1",
-			"resolved": "https://registry.npmjs.org/registry-url/-/registry-url-6.0.1.tgz",
-			"integrity": "sha512-+crtS5QjFRqFCoQmvGduwYWEBng99ZvmFvF+cUJkGYF1L1BfU8C6Zp9T7f5vPAwyLkUExpvK+ANVZmGU49qi4Q==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"rc": "1.2.8"
-			},
-			"engines": {
-				"node": ">=12"
-			},
-			"funding": {
-				"url": "https://github.com/sponsors/sindresorhus"
-			}
-		},
 		"node_modules/rehype-katex": {
 			"version": "7.0.1",
 			"resolved": "https://registry.npmjs.org/rehype-katex/-/rehype-katex-7.0.1.tgz",
@@ -27788,16 +27526,6 @@
 				"url": "https://ko-fi.com/killymxi"
 			}
 		},
-		"node_modules/sembear": {
-			"version": "0.7.0",
-			"resolved": "https://registry.npmjs.org/sembear/-/sembear-0.7.0.tgz",
-			"integrity": "sha512-XyLTEich2D02FODCkfdto3mB9DetWPLuTzr4tvoofe9SvyM27h4nQSbV3+iVcYQz94AFyKtqBv5pcZbj3k2hdA==",
-			"dev": true,
-			"license": "MIT",
-			"dependencies": {
-				"semver": "^7.3.5"
-			}
-		},
 		"node_modules/semver": {
 			"version": "7.7.2",
 			"resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
@@ -30757,16 +30485,6 @@
 				"spdx-expression-parse": "^3.0.0"
 			}
 		},
-		"node_modules/validate-npm-package-name": {
-			"version": "6.0.2",
-			"resolved": "https://registry.npmjs.org/validate-npm-package-name/-/validate-npm-package-name-6.0.2.tgz",
-			"integrity": "sha512-IUoow1YUtvoBBC06dXs8bR8B9vuA3aJfmQNKMoaPG/OFsPmoQvw8xh+6Ye25Gx9DQhoEom3Pcu9MKHerm/NpUQ==",
-			"dev": true,
-			"license": "ISC",
-			"engines": {
-				"node": "^18.17.0 || >=20.5.0"
-			}
-		},
 		"node_modules/vary": {
 			"version": "1.1.2",
 			"resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
@@ -32155,6 +31873,7 @@
 		},
 		"packages/build-config": {
 			"name": "@tm/build-config",
+			"version": "1.0.1",
 			"license": "MIT",
 			"dependencies": {
 				"tsup": "^8.5.0"
@@ -32166,21 +31885,22 @@
 		},
 		"packages/tm-core": {
 			"name": "@tm/core",
+			"version": "0.26.1",
 			"license": "MIT",
 			"dependencies": {
 				"@supabase/supabase-js": "^2.57.4",
-				"zod": "^3.23.8"
+				"zod": "^3.22.4"
 			},
 			"devDependencies": {
 				"@biomejs/biome": "^1.9.4",
 				"@tm/build-config": "*",
-				"@types/node": "^22.10.5",
+				"@types/node": "^20.11.30",
 				"@vitest/coverage-v8": "^2.0.5",
-				"dotenv-mono": "^1.5.1",
+				"dotenv-mono": "^1.3.14",
 				"ts-node": "^10.9.2",
 				"tsup": "^8.5.0",
-				"typescript": "^5.7.3",
+				"typescript": "^5.4.3",
-				"vitest": "^2.1.8"
+				"vitest": "^2.0.5"
 			},
 			"engines": {
 				"node": ">=18.0.0"

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-master-ai",
-	"version": "0.27.1-rc.0",
+	"version": "0.27.0",
 	"description": "A task management system for ambitious AI-driven development that doesn't overwhelm and confuse Cursor.",
 	"main": "index.js",
 	"type": "module",
@@ -33,9 +33,7 @@
 		"inspector": "npx @modelcontextprotocol/inspector node dist/mcp-server.js",
 		"mcp-server": "node dist/mcp-server.js",
 		"format-check": "biome format .",
-		"format": "biome format . --write",
+		"format": "biome format . --write"
-		"deps:check": "manypkg check || echo 'Note: Workspace package version warnings are expected for internal @tm/* packages'",
-		"deps:fix": "manypkg fix"
 	},
 	"keywords": [
 		"claude",
@@ -67,7 +65,6 @@
 		"@inquirer/search": "^3.0.15",
 		"@openrouter/ai-sdk-provider": "^0.4.5",
 		"@streamparser/json": "^0.0.22",
-		"@supabase/supabase-js": "^2.57.4",
 		"ai": "^4.3.10",
 		"ajv": "^8.17.1",
 		"ajv-formats": "^3.0.1",
@@ -76,7 +73,7 @@
 		"cli-highlight": "^2.1.11",
 		"cli-progress": "^3.12.0",
 		"cli-table3": "^0.6.5",
-		"commander": "^12.1.0",
+		"commander": "^11.1.0",
 		"cors": "^2.8.5",
 		"dotenv": "^16.3.1",
 		"express": "^4.21.2",
@@ -123,11 +120,10 @@
 		"whatwg-url": "^11.0.0"
 	},
 	"devDependencies": {
+		"@tm/cli": "*",
 		"@biomejs/biome": "^1.9.4",
 		"@changesets/changelog-github": "^0.5.1",
 		"@changesets/cli": "^2.28.1",
-		"@manypkg/cli": "^0.25.1",
-		"@tm/cli": "*",
 		"@types/jest": "^29.5.14",
 		"@types/marked-terminal": "^6.1.1",
 		"concurrently": "^9.2.1",
@@ -141,8 +137,8 @@
 		"supertest": "^7.1.0",
 		"ts-jest": "^29.4.2",
 		"tsdown": "^0.15.2",
-		"tsx": "^4.20.4",
+		"tsx": "^4.16.2",
 		"turbo": "^2.5.6",
-		"typescript": "^5.7.3"
+		"typescript": "^5.9.2"
 	}
 }

packages/build-config/package.json

@@ -1,5 +1,6 @@
 {
 	"name": "@tm/build-config",
+	"version": "1.0.1",
 	"description": "Shared build configuration for Task Master monorepo",
 	"type": "module",
 	"private": true,

packages/tm-core/package.json

@@ -1,5 +1,6 @@
 {
 	"name": "@tm/core",
+	"version": "0.26.1",
 	"private": true,
 	"description": "Core library for Task Master - TypeScript task management system",
 	"type": "module",
@@ -31,18 +32,18 @@
 	},
 	"dependencies": {
 		"@supabase/supabase-js": "^2.57.4",
-		"zod": "^3.23.8"
+		"zod": "^3.22.4"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",
 		"@tm/build-config": "*",
-		"@types/node": "^22.10.5",
+		"@types/node": "^20.11.30",
 		"@vitest/coverage-v8": "^2.0.5",
-		"dotenv-mono": "^1.5.1",
+		"dotenv-mono": "^1.3.14",
 		"ts-node": "^10.9.2",
 		"tsup": "^8.5.0",
-		"typescript": "^5.7.3",
+		"typescript": "^5.4.3",
-		"vitest": "^2.1.8"
+		"vitest": "^2.0.5"
 	},
 	"engines": {
 		"node": ">=18.0.0"

scripts/modules/commands.js

@@ -3,7 +3,7 @@
  * Command-line interface for the Task Master CLI
  */
 
-import { Command } from 'commander';
+import { program } from 'commander';
 import path from 'path';
 import chalk from 'chalk';
 import boxen from 'boxen';
@@ -5076,10 +5076,28 @@ Examples:
  */
 function setupCLI() {
 	// Create a new program instance
-	const programInstance = new Command()
+	const programInstance = program
 		.name('dev')
 		.description('AI-driven development task management')
-		.version(process.env.TM_PUBLIC_VERSION || 'unknown')
+		.version(() => {
+			// Read version directly from package.json ONLY
+			try {
+				const packageJsonPath = path.join(process.cwd(), 'package.json');
+				if (fs.existsSync(packageJsonPath)) {
+					const packageJson = JSON.parse(
+						fs.readFileSync(packageJsonPath, 'utf8')
+					);
+					return packageJson.version;
+				}
+			} catch (error) {
+				// Silently fall back to 'unknown'
+				log(
+					'warn',
+					'Could not read package.json for version info in .version()'
+				);
+			}
+			return 'unknown'; // Default fallback if package.json fails
+		})
 		.helpOption('-h, --help', 'Display help')
 		.addHelpCommand(false); // Disable default help command
 

tests/integration/profiles/roo-files-inclusion.test.js

@@ -100,13 +100,17 @@ describe('Roo Files Inclusion in Package', () => {
 		});
 	});
 
-	test('source Roo files exist in assets directory', () => {
+	test('source Roo files exist in public/assets directory', () => {
 		// Verify that the source files for Roo integration exist
 		expect(
-			fs.existsSync(path.join(process.cwd(), 'assets', 'roocode', '.roo'))
+			fs.existsSync(
+				path.join(process.cwd(), 'public', 'assets', 'roocode', '.roo')
+			)
 		).toBe(true);
 		expect(
-			fs.existsSync(path.join(process.cwd(), 'assets', 'roocode', '.roomodes'))
+			fs.existsSync(
+				path.join(process.cwd(), 'public', 'assets', 'roocode', '.roomodes')
+			)
 		).toBe(true);
 	});
 });

tests/integration/profiles/rules-files-inclusion.test.js

@@ -16,9 +16,9 @@ describe('Rules Files Inclusion in Package', () => {
 		expect(packageJson.files).toContain('dist/**');
 	});
 
-	test('source rules files exist in assets/rules directory', () => {
+	test('source rules files exist in public/assets/rules directory', () => {
 		// Verify that the actual rules files exist
-		const rulesDir = path.join(process.cwd(), 'assets', 'rules');
+		const rulesDir = path.join(process.cwd(), 'public', 'assets', 'rules');
 		expect(fs.existsSync(rulesDir)).toBe(true);
 
 		// Check for the 4 files that currently exist
@@ -86,13 +86,17 @@ describe('Rules Files Inclusion in Package', () => {
 		expect(rooJsContent.includes('${mode}-rules')).toBe(true);
 	});
 
-	test('source Roo files exist in assets directory', () => {
+	test('source Roo files exist in public/assets directory', () => {
 		// Verify that the source files for Roo integration exist
 		expect(
-			fs.existsSync(path.join(process.cwd(), 'assets', 'roocode', '.roo'))
+			fs.existsSync(
+				path.join(process.cwd(), 'public', 'assets', 'roocode', '.roo')
+			)
 		).toBe(true);
 		expect(
-			fs.existsSync(path.join(process.cwd(), 'assets', 'roocode', '.roomodes'))
+			fs.existsSync(
+				path.join(process.cwd(), 'public', 'assets', 'roocode', '.roomodes')
+			)
 		).toBe(true);
 	});
 });

tests/unit/commands.test.js

@@ -96,10 +96,11 @@ import {
 	RULES_SETUP_ACTION,
 	RULES_ACTIONS
 } from '../../src/constants/rules-actions.js';
-import { compareVersions } from '@tm/cli';
 
 describe('Commands Module - CLI Setup and Integration', () => {
 	const mockExistsSync = jest.spyOn(fs, 'existsSync');
+	const mockReadFileSync = jest.spyOn(fs, 'readFileSync');
+	const mockJoin = jest.spyOn(path, 'join');
 
 	beforeEach(() => {
 		jest.clearAllMocks();
@@ -117,39 +118,52 @@ describe('Commands Module - CLI Setup and Integration', () => {
 			expect(program.name()).toBe('dev');
 		});
 
-		test('should return version that matches package.json when TM_PUBLIC_VERSION is set', () => {
+		test('should read version from package.json when available', () => {
-			// Read actual version from package.json
+			mockExistsSync.mockReturnValue(true);
-			const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+			mockReadFileSync.mockReturnValue('{"version": "1.0.0"}');
-			const expectedVersion = packageJson.version;
+			mockJoin.mockReturnValue('package.json');
-
-			// Set environment variable to match package.json
-			const originalEnv = process.env.TM_PUBLIC_VERSION;
-			process.env.TM_PUBLIC_VERSION = expectedVersion;
 
 			const program = setupCLI();
-			const version = program.version();
+			const version = program._version();
-			expect(version).toBe(expectedVersion);
+			expect(mockReadFileSync).toHaveBeenCalledWith('package.json', 'utf8');
-
+			expect(version).toBe('1.0.0');
-			// Restore original environment
-			if (originalEnv !== undefined) {
-				process.env.TM_PUBLIC_VERSION = originalEnv;
-			} else {
-				delete process.env.TM_PUBLIC_VERSION;
-			}
 		});
 
-		test('should use default version when TM_PUBLIC_VERSION is not available', () => {
+		test('should use default version when package.json is not available', () => {
-			const originalEnv = process.env.TM_PUBLIC_VERSION;
+			mockExistsSync.mockReturnValue(false);
-			delete process.env.TM_PUBLIC_VERSION;
 
 			const program = setupCLI();
-			const version = program.version();
+			const version = program._version();
+			expect(mockReadFileSync).not.toHaveBeenCalled();
+			expect(version).toBe('unknown');
+		});
+
+		test('should use default version when package.json reading throws an error', () => {
+			mockExistsSync.mockReturnValue(true);
+			mockReadFileSync.mockImplementation(() => {
+				throw new Error('Read error');
+			});
+
+			// Mock console methods to prevent chalk formatting conflicts
+			const consoleErrorSpy = jest
+				.spyOn(console, 'error')
+				.mockImplementation(() => {});
+			const consoleLogSpy = jest
+				.spyOn(console, 'log')
+				.mockImplementation(() => {});
+			const consoleWarnSpy = jest
+				.spyOn(console, 'warn')
+				.mockImplementation(() => {});
+
+			const program = setupCLI();
+			const version = program._version();
+			expect(mockReadFileSync).toHaveBeenCalled();
 			expect(version).toBe('unknown');
 
-			// Restore original environment
+			// Restore console methods
-			if (originalEnv !== undefined) {
+			consoleErrorSpy.mockRestore();
-				process.env.TM_PUBLIC_VERSION = originalEnv;
+			consoleLogSpy.mockRestore();
-			}
+			consoleWarnSpy.mockRestore();
 		});
 	});
 
@@ -263,6 +277,31 @@ describe('Commands Module - CLI Setup and Integration', () => {
 
 // Test utility functions that commands rely on
 describe('Version comparison utility', () => {
+	let compareVersions;
+
+	beforeAll(async () => {
+		// Import from @tm/cli instead of commands.js
+		const { compareVersions: cv } = await import(
+			'../../apps/cli/src/utils/auto-update.js'
+		);
+
+		// Create a local compareVersions function for testing
+		compareVersions = (v1, v2) => {
+			const v1Parts = v1.split('.').map((p) => parseInt(p, 10));
+			const v2Parts = v2.split('.').map((p) => parseInt(p, 10));
+
+			for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
+				const v1Part = v1Parts[i] || 0;
+				const v2Part = v2Parts[i] || 0;
+
+				if (v1Part < v2Part) return -1;
+				if (v1Part > v2Part) return 1;
+			}
+
+			return 0;
+		};
+	});
+
 	test('compareVersions correctly compares semantic versions', () => {
 		expect(compareVersions('1.0.0', '1.0.0')).toBe(0);
 		expect(compareVersions('1.0.0', '1.0.1')).toBe(-1);