Compare commits

...

3 Commits

Author SHA1 Message Date
Ralph Khreish
17ef607c41 chore: add prettier package 2025-04-09 00:26:56 +02:00
Ralph Khreish
d95aaf5316 chore: run npm run format 2025-04-09 00:25:27 +02:00
Ralph Khreish
8a3841e195 chore: add prettier config 2025-04-09 00:23:09 +02:00
112 changed files with 36259 additions and 32185 deletions

View File

@@ -2,9 +2,7 @@
"mcpServers": { "mcpServers": {
"taskmaster-ai": { "taskmaster-ai": {
"command": "node", "command": "node",
"args": [ "args": ["./mcp-server/server.js"],
"./mcp-server/server.js"
],
"env": { "env": {
"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE", "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE", "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",

View File

@@ -14,7 +14,7 @@ permissions:
contents: read contents: read
jobs: jobs:
build: setup:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v4
@@ -24,21 +24,55 @@ jobs:
- uses: actions/setup-node@v4 - uses: actions/setup-node@v4
with: with:
node-version: 20 node-version: 20
cache: "npm" cache: 'npm'
- name: Install Dependencies
id: install
run: npm ci
timeout-minutes: 2
- name: Cache node_modules - name: Cache node_modules
uses: actions/cache@v4 uses: actions/cache@v4
with: with:
path: | path: node_modules
node_modules key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package-lock.json') }}
*/*/node_modules
key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-node-
- name: Install Dependencies format-check:
run: npm ci needs: setup
timeout-minutes: 2 runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- name: Restore node_modules
uses: actions/cache@v4
with:
path: node_modules
key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package-lock.json') }}
- name: Format Check
run: npm run format-check
env:
FORCE_COLOR: 1
test:
needs: setup
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- name: Restore node_modules
uses: actions/cache@v4
with:
path: node_modules
key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package-lock.json') }}
- name: Run Tests - name: Run Tests
run: | run: |
@@ -47,13 +81,13 @@ jobs:
NODE_ENV: test NODE_ENV: test
CI: true CI: true
FORCE_COLOR: 1 FORCE_COLOR: 1
timeout-minutes: 15 timeout-minutes: 10
- name: Upload Test Results - name: Upload Test Results
if: always() if: always()
uses: actions/upload-artifact@v4 uses: actions/upload-artifact@v4
with: with:
name: test-results-node name: test-results
path: | path: |
test-results test-results
coverage coverage

View File

@@ -14,7 +14,7 @@ jobs:
- uses: actions/setup-node@v4 - uses: actions/setup-node@v4
with: with:
node-version: 20 node-version: 20
cache: "npm" cache: 'npm'
- name: Cache node_modules - name: Cache node_modules
uses: actions/cache@v4 uses: actions/cache@v4

6
.prettierignore Normal file
View File

@@ -0,0 +1,6 @@
# Ignore artifacts:
build
coverage
.changeset
tasks
package-lock.json

11
.prettierrc Normal file
View File

@@ -0,0 +1,11 @@
{
"printWidth": 80,
"tabWidth": 2,
"useTabs": true,
"semi": true,
"singleQuote": true,
"trailingComma": "none",
"bracketSpacing": true,
"arrowParens": "always",
"endOfLine": "lf"
}

View File

@@ -58,6 +58,7 @@ This will prompt you for project details and set up a new project with the neces
### Important Notes ### Important Notes
1. **ES Modules Configuration:** 1. **ES Modules Configuration:**
- This project uses ES Modules (ESM) instead of CommonJS. - This project uses ES Modules (ESM) instead of CommonJS.
- This is set via `"type": "module"` in your package.json. - This is set via `"type": "module"` in your package.json.
- Use `import/export` syntax instead of `require()`. - Use `import/export` syntax instead of `require()`.

View File

@@ -21,9 +21,11 @@ In an AI-driven development process—particularly with tools like [Cursor](http
The script can be configured through environment variables in a `.env` file at the root of the project: The script can be configured through environment variables in a `.env` file at the root of the project:
### Required Configuration ### Required Configuration
- `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude - `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude
### Optional Configuration ### Optional Configuration
- `MODEL`: Specify which Claude model to use (default: "claude-3-7-sonnet-20250219") - `MODEL`: Specify which Claude model to use (default: "claude-3-7-sonnet-20250219")
- `MAX_TOKENS`: Maximum tokens for model responses (default: 4000) - `MAX_TOKENS`: Maximum tokens for model responses (default: 4000)
- `TEMPERATURE`: Temperature for model responses (default: 0.7) - `TEMPERATURE`: Temperature for model responses (default: 0.7)
@@ -39,6 +41,7 @@ The script can be configured through environment variables in a `.env` file at t
## How It Works ## How It Works
1. **`tasks.json`**: 1. **`tasks.json`**:
- A JSON file at the project root containing an array of tasks (each with `id`, `title`, `description`, `status`, etc.). - A JSON file at the project root containing an array of tasks (each with `id`, `title`, `description`, `status`, etc.).
- The `meta` field can store additional info like the project's name, version, or reference to the PRD. - The `meta` field can store additional info like the project's name, version, or reference to the PRD.
- Tasks can have `subtasks` for more detailed implementation steps. - Tasks can have `subtasks` for more detailed implementation steps.
@@ -111,6 +114,7 @@ task-master update --file=custom-tasks.json --from=5 --prompt="Change database f
``` ```
Notes: Notes:
- The `--prompt` parameter is required and should explain the changes or new context - The `--prompt` parameter is required and should explain the changes or new context
- Only tasks that aren't marked as 'done' will be updated - Only tasks that aren't marked as 'done' will be updated
- Tasks with ID >= the specified --from value will be updated - Tasks with ID >= the specified --from value will be updated
@@ -134,6 +138,7 @@ task-master set-status --id=1,2,3 --status=done
``` ```
Notes: Notes:
- When marking a parent task as "done", all of its subtasks will automatically be marked as "done" as well - When marking a parent task as "done", all of its subtasks will automatically be marked as "done" as well
- Common status values are 'done', 'pending', and 'deferred', but any string is accepted - Common status values are 'done', 'pending', and 'deferred', but any string is accepted
- You can specify multiple task IDs by separating them with commas - You can specify multiple task IDs by separating them with commas
@@ -183,6 +188,7 @@ task-master clear-subtasks --all
``` ```
Notes: Notes:
- After clearing subtasks, task files are automatically regenerated - After clearing subtasks, task files are automatically regenerated
- This is useful when you want to regenerate subtasks with a different approach - This is useful when you want to regenerate subtasks with a different approach
- Can be combined with the `expand` command to immediately generate new subtasks - Can be combined with the `expand` command to immediately generate new subtasks
@@ -198,6 +204,7 @@ The script integrates with two AI services:
The Perplexity integration uses the OpenAI client to connect to Perplexity's API, which provides enhanced research capabilities for generating more informed subtasks. If the Perplexity API is unavailable or encounters an error, the script will automatically fall back to using Anthropic's Claude. The Perplexity integration uses the OpenAI client to connect to Perplexity's API, which provides enhanced research capabilities for generating more informed subtasks. If the Perplexity API is unavailable or encounters an error, the script will automatically fall back to using Anthropic's Claude.
To use the Perplexity integration: To use the Perplexity integration:
1. Obtain a Perplexity API key 1. Obtain a Perplexity API key
2. Add `PERPLEXITY_API_KEY` to your `.env` file 2. Add `PERPLEXITY_API_KEY` to your `.env` file
3. Optionally specify `PERPLEXITY_MODEL` in your `.env` file (default: "sonar-medium-online") 3. Optionally specify `PERPLEXITY_MODEL` in your `.env` file (default: "sonar-medium-online")
@@ -206,6 +213,7 @@ To use the Perplexity integration:
## Logging ## Logging
The script supports different logging levels controlled by the `LOG_LEVEL` environment variable: The script supports different logging levels controlled by the `LOG_LEVEL` environment variable:
- `debug`: Detailed information, typically useful for troubleshooting - `debug`: Detailed information, typically useful for troubleshooting
- `info`: Confirmation that things are working as expected (default) - `info`: Confirmation that things are working as expected (default)
- `warn`: Warning messages that don't prevent execution - `warn`: Warning messages that don't prevent execution
@@ -228,17 +236,20 @@ task-master remove-dependency --id=<id> --depends-on=<id>
These commands: These commands:
1. **Allow precise dependency management**: 1. **Allow precise dependency management**:
- Add dependencies between tasks with automatic validation - Add dependencies between tasks with automatic validation
- Remove dependencies when they're no longer needed - Remove dependencies when they're no longer needed
- Update task files automatically after changes - Update task files automatically after changes
2. **Include validation checks**: 2. **Include validation checks**:
- Prevent circular dependencies (a task depending on itself) - Prevent circular dependencies (a task depending on itself)
- Prevent duplicate dependencies - Prevent duplicate dependencies
- Verify that both tasks exist before adding/removing dependencies - Verify that both tasks exist before adding/removing dependencies
- Check if dependencies exist before attempting to remove them - Check if dependencies exist before attempting to remove them
3. **Provide clear feedback**: 3. **Provide clear feedback**:
- Success messages confirm when dependencies are added/removed - Success messages confirm when dependencies are added/removed
- Error messages explain why operations failed (if applicable) - Error messages explain why operations failed (if applicable)
@@ -263,6 +274,7 @@ task-master validate-dependencies --file=custom-tasks.json
``` ```
This command: This command:
- Scans all tasks and subtasks for non-existent dependencies - Scans all tasks and subtasks for non-existent dependencies
- Identifies potential self-dependencies (tasks referencing themselves) - Identifies potential self-dependencies (tasks referencing themselves)
- Reports all found issues without modifying files - Reports all found issues without modifying files
@@ -284,6 +296,7 @@ task-master fix-dependencies --file=custom-tasks.json
``` ```
This command: This command:
1. **Validates all dependencies** across tasks and subtasks 1. **Validates all dependencies** across tasks and subtasks
2. **Automatically removes**: 2. **Automatically removes**:
- References to non-existent tasks and subtasks - References to non-existent tasks and subtasks
@@ -321,6 +334,7 @@ task-master analyze-complexity --research
``` ```
Notes: Notes:
- The command uses Claude to analyze each task's complexity (or Perplexity with --research flag) - The command uses Claude to analyze each task's complexity (or Perplexity with --research flag)
- Tasks are scored on a scale of 1-10 - Tasks are scored on a scale of 1-10
- Each task receives a recommended number of subtasks based on DEFAULT_SUBTASKS configuration - Each task receives a recommended number of subtasks based on DEFAULT_SUBTASKS configuration
@@ -345,12 +359,14 @@ task-master expand --id=8 --num=5 --prompt="Custom prompt"
``` ```
When a complexity report exists: When a complexity report exists:
- The `expand` command will use the recommended subtask count from the report (unless overridden) - The `expand` command will use the recommended subtask count from the report (unless overridden)
- It will use the tailored expansion prompt from the report (unless a custom prompt is provided) - It will use the tailored expansion prompt from the report (unless a custom prompt is provided)
- When using `--all`, tasks are sorted by complexity score (highest first) - When using `--all`, tasks are sorted by complexity score (highest first)
- The `--research` flag is preserved from the complexity analysis to expansion - The `--research` flag is preserved from the complexity analysis to expansion
The output report structure is: The output report structure is:
```json ```json
{ {
"meta": { "meta": {
@@ -369,7 +385,7 @@ The output report structure is:
"expansionPrompt": "Create subtasks that handle detecting...", "expansionPrompt": "Create subtasks that handle detecting...",
"reasoning": "This task requires sophisticated logic...", "reasoning": "This task requires sophisticated logic...",
"expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research" "expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
}, }
// More tasks sorted by complexity score (highest first) // More tasks sorted by complexity score (highest first)
] ]
} }

View File

@@ -49,7 +49,13 @@ function runDevScript(args) {
console.error('\nDEBUG - CLI Wrapper Analysis:'); console.error('\nDEBUG - CLI Wrapper Analysis:');
console.error('- Original command: ' + process.argv.join(' ')); console.error('- Original command: ' + process.argv.join(' '));
console.error('- Transformed args: ' + args.join(' ')); console.error('- Transformed args: ' + args.join(' '));
console.error('- dev.js will receive: node ' + devScriptPath + ' ' + args.join(' ') + '\n'); console.error(
'- dev.js will receive: node ' +
devScriptPath +
' ' +
args.join(' ') +
'\n'
);
} }
// For testing: If TEST_MODE is set, just print args and exit // For testing: If TEST_MODE is set, just print args and exit
@@ -86,11 +92,13 @@ function createDevScriptAction(commandName) {
// If camelCase flags were found, show error and exit // If camelCase flags were found, show error and exit
if (camelCaseFlags.length > 0) { if (camelCaseFlags.length > 0) {
console.error('\nError: Please use kebab-case for CLI flags:'); console.error('\nError: Please use kebab-case for CLI flags:');
camelCaseFlags.forEach(flag => { camelCaseFlags.forEach((flag) => {
console.error(` Instead of: --${flag.original}`); console.error(` Instead of: --${flag.original}`);
console.error(` Use: --${flag.kebabCase}`); console.error(` Use: --${flag.kebabCase}`);
}); });
console.error('\nExample: task-master parse-prd --num-tasks=5 instead of --numTasks=5\n'); console.error(
'\nExample: task-master parse-prd --num-tasks=5 instead of --numTasks=5\n'
);
process.exit(1); process.exit(1);
} }
@@ -113,9 +121,11 @@ function createDevScriptAction(commandName) {
// It's a flag - pass through as is // It's a flag - pass through as is
commandArgs.push(arg); commandArgs.push(arg);
// Skip the next arg if this is a flag with a value (not --flag=value format) // Skip the next arg if this is a flag with a value (not --flag=value format)
if (!arg.includes('=') && if (
!arg.includes('=') &&
i + 1 < process.argv.length && i + 1 < process.argv.length &&
!process.argv[i+1].startsWith('--')) { !process.argv[i + 1].startsWith('--')
) {
commandArgs.push(process.argv[++i]); commandArgs.push(process.argv[++i]);
} }
} else if (!positionals.has(arg)) { } else if (!positionals.has(arg)) {
@@ -143,7 +153,9 @@ function createDevScriptAction(commandName) {
userOptions.add(kebabName); userOptions.add(kebabName);
// Add the camelCase version as well // Add the camelCase version as well
const camelName = kebabName.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()); const camelName = kebabName.replace(/-([a-z])/g, (_, letter) =>
letter.toUpperCase()
);
userOptions.add(camelName); userOptions.add(camelName);
} }
} }
@@ -167,7 +179,10 @@ function createDevScriptAction(commandName) {
} }
// Skip built-in Commander properties and options the user provided // Skip built-in Commander properties and options the user provided
if (['parent', 'commands', 'options', 'rawArgs'].includes(key) || userOptions.has(key)) { if (
['parent', 'commands', 'options', 'rawArgs'].includes(key) ||
userOptions.has(key)
) {
return; return;
} }
@@ -224,9 +239,17 @@ function registerInitCommand(program) {
.option('--dry-run', 'Show what would be done without making changes') .option('--dry-run', 'Show what would be done without making changes')
.action((options) => { .action((options) => {
// Pass through any options to the init script // Pass through any options to the init script
const args = ['--yes', 'name', 'description', 'version', 'author', 'skip-install', 'dry-run'] const args = [
.filter(opt => options[opt]) '--yes',
.map(opt => { 'name',
'description',
'version',
'author',
'skip-install',
'dry-run'
]
.filter((opt) => options[opt])
.map((opt) => {
if (opt === 'yes' || opt === 'skip-install' || opt === 'dry-run') { if (opt === 'yes' || opt === 'skip-install' || opt === 'dry-run') {
return `--${opt}`; return `--${opt}`;
} }
@@ -279,24 +302,18 @@ const tempProgram = new Command();
registerCommands(tempProgram); registerCommands(tempProgram);
// For each command in the temp instance, add a modified version to our actual program // For each command in the temp instance, add a modified version to our actual program
tempProgram.commands.forEach(cmd => { tempProgram.commands.forEach((cmd) => {
if (['init', 'dev'].includes(cmd.name())) { if (['init', 'dev'].includes(cmd.name())) {
// Skip commands we've already defined specially // Skip commands we've already defined specially
return; return;
} }
// Create a new command with the same name and description // Create a new command with the same name and description
const newCmd = program const newCmd = program.command(cmd.name()).description(cmd.description());
.command(cmd.name())
.description(cmd.description());
// Copy all options // Copy all options
cmd.options.forEach(opt => { cmd.options.forEach((opt) => {
newCmd.option( newCmd.option(opt.flags, opt.description, opt.defaultValue);
opt.flags,
opt.description,
opt.defaultValue
);
}); });
// Set the action to proxy to dev.js // Set the action to proxy to dev.js
@@ -311,14 +328,21 @@ process.on('uncaughtException', (err) => {
// Check if this is a commander.js unknown option error // Check if this is a commander.js unknown option error
if (err.code === 'commander.unknownOption') { if (err.code === 'commander.unknownOption') {
const option = err.message.match(/'([^']+)'/)?.[1]; const option = err.message.match(/'([^']+)'/)?.[1];
const commandArg = process.argv.find(arg => !arg.startsWith('-') && const commandArg = process.argv.find(
(arg) =>
!arg.startsWith('-') &&
arg !== 'task-master' && arg !== 'task-master' &&
!arg.includes('/') && !arg.includes('/') &&
arg !== 'node'); arg !== 'node'
);
const command = commandArg || 'unknown'; const command = commandArg || 'unknown';
console.error(chalk.red(`Error: Unknown option '${option}'`)); console.error(chalk.red(`Error: Unknown option '${option}'`));
console.error(chalk.yellow(`Run 'task-master ${command} --help' to see available options for this command`)); console.error(
chalk.yellow(
`Run 'task-master ${command} --help' to see available options for this command`
)
);
process.exit(1); process.exit(1);
} }
@@ -327,7 +351,9 @@ process.on('uncaughtException', (err) => {
const command = err.message.match(/'([^']+)'/)?.[1]; const command = err.message.match(/'([^']+)'/)?.[1];
console.error(chalk.red(`Error: Unknown command '${command}'`)); console.error(chalk.red(`Error: Unknown command '${command}'`));
console.error(chalk.yellow(`Run 'task-master --help' to see available commands`)); console.error(
chalk.yellow(`Run 'task-master --help' to see available commands`)
);
process.exit(1); process.exit(1);
} }

View File

@@ -90,13 +90,13 @@ export const simpleFunction = adaptForMcp(originalFunction);
// Split implementation - completely different code paths for CLI vs MCP // Split implementation - completely different code paths for CLI vs MCP
export const complexFunction = sourceSplitFunction( export const complexFunction = sourceSplitFunction(
// CLI version with UI // CLI version with UI
function(param1, param2) { function (param1, param2) {
displayBanner(); displayBanner();
console.log(`Processing ${param1}...`); console.log(`Processing ${param1}...`);
// ... CLI implementation // ... CLI implementation
}, },
// MCP version with structured return // MCP version with structured return
function(param1, param2, options = {}) { function (param1, param2, options = {}) {
// ... MCP implementation // ... MCP implementation
return { success: true, data }; return { success: true, data };
} }
@@ -186,22 +186,22 @@ const commandMap = {
```javascript ```javascript
// In mcp-server/src/tools/newFeature.js // In mcp-server/src/tools/newFeature.js
import { z } from "zod"; import { z } from 'zod';
import { import {
executeTaskMasterCommand, executeTaskMasterCommand,
createContentResponse, createContentResponse,
createErrorResponse, createErrorResponse
} from "./utils.js"; } from './utils.js';
export function registerNewFeatureTool(server) { export function registerNewFeatureTool(server) {
server.addTool({ server.addTool({
name: "newFeature", name: 'newFeature',
description: "Run the new feature", description: 'Run the new feature',
parameters: z.object({ parameters: z.object({
param1: z.string().describe("First parameter"), param1: z.string().describe('First parameter'),
param2: z.number().optional().describe("Second parameter"), param2: z.number().optional().describe('Second parameter'),
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z.string().describe("Root directory of the project") projectRoot: z.string().describe('Root directory of the project')
}), }),
execute: async (args, { log }) => { execute: async (args, { log }) => {
try { try {
@@ -216,7 +216,7 @@ export function registerNewFeatureTool(server) {
// Execute the command // Execute the command
const result = await executeTaskMasterCommand( const result = await executeTaskMasterCommand(
"new-feature", 'new-feature',
log, log,
cmdArgs, cmdArgs,
projectRoot projectRoot
@@ -231,7 +231,7 @@ export function registerNewFeatureTool(server) {
log.error(`Error in new feature: ${error.message}`); log.error(`Error in new feature: ${error.message}`);
return createErrorResponse(`Error in new feature: ${error.message}`); return createErrorResponse(`Error in new feature: ${error.message}`);
} }
}, }
}); });
} }
``` ```
@@ -240,7 +240,7 @@ export function registerNewFeatureTool(server) {
```javascript ```javascript
// In mcp-server/src/tools/index.js // In mcp-server/src/tools/index.js
import { registerNewFeatureTool } from "./newFeature.js"; import { registerNewFeatureTool } from './newFeature.js';
export function registerTaskMasterTools(server) { export function registerTaskMasterTools(server) {
// ... existing registrations // ... existing registrations

View File

@@ -41,11 +41,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["data", "mimeType", "type"],
"data",
"mimeType",
"type"
],
"type": "object" "type": "object"
}, },
"BlobResourceContents": { "BlobResourceContents": {
@@ -65,10 +61,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["blob", "uri"],
"blob",
"uri"
],
"type": "object" "type": "object"
}, },
"CallToolRequest": { "CallToolRequest": {
@@ -88,16 +81,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name"],
"name"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"CallToolResult": { "CallToolResult": {
@@ -132,9 +120,7 @@
"type": "boolean" "type": "boolean"
} }
}, },
"required": [ "required": ["content"],
"content"
],
"type": "object" "type": "object"
}, },
"CancelledNotification": { "CancelledNotification": {
@@ -155,16 +141,11 @@
"description": "The ID of the request to cancel.\n\nThis MUST correspond to the ID of a request previously issued in the same direction." "description": "The ID of the request to cancel.\n\nThis MUST correspond to the ID of a request previously issued in the same direction."
} }
}, },
"required": [ "required": ["requestId"],
"requestId"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"ClientCapabilities": { "ClientCapabilities": {
@@ -288,10 +269,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name", "value"],
"name",
"value"
],
"type": "object" "type": "object"
}, },
"ref": { "ref": {
@@ -305,17 +283,11 @@
] ]
} }
}, },
"required": [ "required": ["argument", "ref"],
"argument",
"ref"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"CompleteResult": { "CompleteResult": {
@@ -344,15 +316,11 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["values"],
"values"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["completion"],
"completion"
],
"type": "object" "type": "object"
}, },
"CreateMessageRequest": { "CreateMessageRequest": {
@@ -366,11 +334,7 @@
"properties": { "properties": {
"includeContext": { "includeContext": {
"description": "A request to include context from one or more MCP servers (including the caller), to be attached to the prompt. The client MAY ignore this request.", "description": "A request to include context from one or more MCP servers (including the caller), to be attached to the prompt. The client MAY ignore this request.",
"enum": [ "enum": ["allServers", "none", "thisServer"],
"allServers",
"none",
"thisServer"
],
"type": "string" "type": "string"
}, },
"maxTokens": { "maxTokens": {
@@ -407,17 +371,11 @@
"type": "number" "type": "number"
} }
}, },
"required": [ "required": ["maxTokens", "messages"],
"maxTokens",
"messages"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"CreateMessageResult": { "CreateMessageResult": {
@@ -453,11 +411,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["content", "model", "role"],
"content",
"model",
"role"
],
"type": "object" "type": "object"
}, },
"Cursor": { "Cursor": {
@@ -486,10 +440,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["resource", "type"],
"resource",
"type"
],
"type": "object" "type": "object"
}, },
"EmptyResult": { "EmptyResult": {
@@ -516,16 +467,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name"],
"name"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"GetPromptResult": { "GetPromptResult": {
@@ -547,9 +493,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["messages"],
"messages"
],
"type": "object" "type": "object"
}, },
"ImageContent": { "ImageContent": {
@@ -573,11 +517,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["data", "mimeType", "type"],
"data",
"mimeType",
"type"
],
"type": "object" "type": "object"
}, },
"Implementation": { "Implementation": {
@@ -590,10 +530,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name", "version"],
"name",
"version"
],
"type": "object" "type": "object"
}, },
"InitializeRequest": { "InitializeRequest": {
@@ -616,18 +553,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["capabilities", "clientInfo", "protocolVersion"],
"capabilities",
"clientInfo",
"protocolVersion"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"InitializeResult": { "InitializeResult": {
@@ -653,11 +583,7 @@
"$ref": "#/definitions/Implementation" "$ref": "#/definitions/Implementation"
} }
}, },
"required": [ "required": ["capabilities", "protocolVersion", "serverInfo"],
"capabilities",
"protocolVersion",
"serverInfo"
],
"type": "object" "type": "object"
}, },
"InitializedNotification": { "InitializedNotification": {
@@ -679,9 +605,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"JSONRPCBatchRequest": { "JSONRPCBatchRequest": {
@@ -729,10 +653,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["code", "message"],
"code",
"message"
],
"type": "object" "type": "object"
}, },
"id": { "id": {
@@ -743,11 +664,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["error", "id", "jsonrpc"],
"error",
"id",
"jsonrpc"
],
"type": "object" "type": "object"
}, },
"JSONRPCMessage": { "JSONRPCMessage": {
@@ -817,10 +734,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["jsonrpc", "method"],
"jsonrpc",
"method"
],
"type": "object" "type": "object"
}, },
"JSONRPCRequest": { "JSONRPCRequest": {
@@ -852,11 +766,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["id", "jsonrpc", "method"],
"id",
"jsonrpc",
"method"
],
"type": "object" "type": "object"
}, },
"JSONRPCResponse": { "JSONRPCResponse": {
@@ -873,11 +783,7 @@
"$ref": "#/definitions/Result" "$ref": "#/definitions/Result"
} }
}, },
"required": [ "required": ["id", "jsonrpc", "result"],
"id",
"jsonrpc",
"result"
],
"type": "object" "type": "object"
}, },
"ListPromptsRequest": { "ListPromptsRequest": {
@@ -897,9 +803,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ListPromptsResult": { "ListPromptsResult": {
@@ -921,9 +825,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["prompts"],
"prompts"
],
"type": "object" "type": "object"
}, },
"ListResourceTemplatesRequest": { "ListResourceTemplatesRequest": {
@@ -943,9 +845,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ListResourceTemplatesResult": { "ListResourceTemplatesResult": {
@@ -967,9 +867,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["resourceTemplates"],
"resourceTemplates"
],
"type": "object" "type": "object"
}, },
"ListResourcesRequest": { "ListResourcesRequest": {
@@ -989,9 +887,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ListResourcesResult": { "ListResourcesResult": {
@@ -1013,9 +909,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["resources"],
"resources"
],
"type": "object" "type": "object"
}, },
"ListRootsRequest": { "ListRootsRequest": {
@@ -1041,9 +935,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ListRootsResult": { "ListRootsResult": {
@@ -1061,9 +953,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["roots"],
"roots"
],
"type": "object" "type": "object"
}, },
"ListToolsRequest": { "ListToolsRequest": {
@@ -1083,9 +973,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ListToolsResult": { "ListToolsResult": {
@@ -1107,9 +995,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["tools"],
"tools"
],
"type": "object" "type": "object"
}, },
"LoggingLevel": { "LoggingLevel": {
@@ -1147,17 +1033,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["data", "level"],
"data",
"level"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"ModelHint": { "ModelHint": {
@@ -1218,9 +1098,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"PaginatedRequest": { "PaginatedRequest": {
@@ -1238,9 +1116,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"PaginatedResult": { "PaginatedResult": {
@@ -1280,9 +1156,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ProgressNotification": { "ProgressNotification": {
@@ -1311,25 +1185,16 @@
"type": "number" "type": "number"
} }
}, },
"required": [ "required": ["progress", "progressToken"],
"progress",
"progressToken"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"ProgressToken": { "ProgressToken": {
"description": "A progress token, used to associate progress notifications with the original request.", "description": "A progress token, used to associate progress notifications with the original request.",
"type": [ "type": ["string", "integer"]
"string",
"integer"
]
}, },
"Prompt": { "Prompt": {
"description": "A prompt or prompt template that the server offers.", "description": "A prompt or prompt template that the server offers.",
@@ -1350,9 +1215,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name"],
"name"
],
"type": "object" "type": "object"
}, },
"PromptArgument": { "PromptArgument": {
@@ -1371,9 +1234,7 @@
"type": "boolean" "type": "boolean"
} }
}, },
"required": [ "required": ["name"],
"name"
],
"type": "object" "type": "object"
}, },
"PromptListChangedNotification": { "PromptListChangedNotification": {
@@ -1395,9 +1256,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"PromptMessage": { "PromptMessage": {
@@ -1423,10 +1282,7 @@
"$ref": "#/definitions/Role" "$ref": "#/definitions/Role"
} }
}, },
"required": [ "required": ["content", "role"],
"content",
"role"
],
"type": "object" "type": "object"
}, },
"PromptReference": { "PromptReference": {
@@ -1441,10 +1297,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name", "type"],
"name",
"type"
],
"type": "object" "type": "object"
}, },
"ReadResourceRequest": { "ReadResourceRequest": {
@@ -1462,16 +1315,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"ReadResourceResult": { "ReadResourceResult": {
@@ -1496,9 +1344,7 @@
"type": "array" "type": "array"
} }
}, },
"required": [ "required": ["contents"],
"contents"
],
"type": "object" "type": "object"
}, },
"Request": { "Request": {
@@ -1522,17 +1368,12 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"RequestId": { "RequestId": {
"description": "A uniquely identifying ID for a request in JSON-RPC.", "description": "A uniquely identifying ID for a request in JSON-RPC.",
"type": [ "type": ["string", "integer"]
"string",
"integer"
]
}, },
"Resource": { "Resource": {
"description": "A known resource that the server is capable of reading.", "description": "A known resource that the server is capable of reading.",
@@ -1559,10 +1400,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name", "uri"],
"name",
"uri"
],
"type": "object" "type": "object"
}, },
"ResourceContents": { "ResourceContents": {
@@ -1578,9 +1416,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
}, },
"ResourceListChangedNotification": { "ResourceListChangedNotification": {
@@ -1602,9 +1438,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"ResourceReference": { "ResourceReference": {
@@ -1620,10 +1454,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["type", "uri"],
"type",
"uri"
],
"type": "object" "type": "object"
}, },
"ResourceTemplate": { "ResourceTemplate": {
@@ -1651,10 +1482,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["name", "uriTemplate"],
"name",
"uriTemplate"
],
"type": "object" "type": "object"
}, },
"ResourceUpdatedNotification": { "ResourceUpdatedNotification": {
@@ -1672,16 +1500,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"Result": { "Result": {
@@ -1697,10 +1520,7 @@
}, },
"Role": { "Role": {
"description": "The sender or recipient of messages and data in a conversation.", "description": "The sender or recipient of messages and data in a conversation.",
"enum": [ "enum": ["assistant", "user"],
"assistant",
"user"
],
"type": "string" "type": "string"
}, },
"Root": { "Root": {
@@ -1716,9 +1536,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
}, },
"RootsListChangedNotification": { "RootsListChangedNotification": {
@@ -1740,9 +1558,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"SamplingMessage": { "SamplingMessage": {
@@ -1765,10 +1581,7 @@
"$ref": "#/definitions/Role" "$ref": "#/definitions/Role"
} }
}, },
"required": [ "required": ["content", "role"],
"content",
"role"
],
"type": "object" "type": "object"
}, },
"ServerCapabilities": { "ServerCapabilities": {
@@ -1915,16 +1728,11 @@
"description": "The level of logging that the client wants to receive from the server. The server should send all logs at this level and higher (i.e., more severe) to the client as notifications/message." "description": "The level of logging that the client wants to receive from the server. The server should send all logs at this level and higher (i.e., more severe) to the client as notifications/message."
} }
}, },
"required": [ "required": ["level"],
"level"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"SubscribeRequest": { "SubscribeRequest": {
@@ -1942,16 +1750,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
}, },
"TextContent": { "TextContent": {
@@ -1970,10 +1773,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["text", "type"],
"text",
"type"
],
"type": "object" "type": "object"
}, },
"TextResourceContents": { "TextResourceContents": {
@@ -1992,10 +1792,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["text", "uri"],
"text",
"uri"
],
"type": "object" "type": "object"
}, },
"Tool": { "Tool": {
@@ -2031,9 +1828,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["type"],
"type"
],
"type": "object" "type": "object"
}, },
"name": { "name": {
@@ -2041,10 +1836,7 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["inputSchema", "name"],
"inputSchema",
"name"
],
"type": "object" "type": "object"
}, },
"ToolAnnotations": { "ToolAnnotations": {
@@ -2092,9 +1884,7 @@
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method"],
"method"
],
"type": "object" "type": "object"
}, },
"UnsubscribeRequest": { "UnsubscribeRequest": {
@@ -2112,16 +1902,11 @@
"type": "string" "type": "string"
} }
}, },
"required": [ "required": ["uri"],
"uri"
],
"type": "object" "type": "object"
} }
}, },
"required": [ "required": ["method", "params"],
"method",
"params"
],
"type": "object" "type": "object"
} }
} }

View File

@@ -26,9 +26,7 @@ export async function someAiOperationDirect(args, log, context) {
model: modelConfig.model, model: modelConfig.model,
max_tokens: modelConfig.maxTokens, max_tokens: modelConfig.maxTokens,
temperature: modelConfig.temperature, temperature: modelConfig.temperature,
messages: [ messages: [{ role: 'user', content: 'Your prompt here' }]
{ role: 'user', content: 'Your prompt here' }
]
}); });
return { return {
@@ -64,7 +62,10 @@ export async function someAiOperationDirect(args, log, context) {
```javascript ```javascript
// In your MCP tool implementation: // In your MCP tool implementation:
import { AsyncOperationManager, StatusCodes } from '../../utils/async-operation-manager.js'; import {
AsyncOperationManager,
StatusCodes
} from '../../utils/async-operation-manager.js';
import { someAiOperationDirect } from '../../core/direct-functions/some-ai-operation.js'; import { someAiOperationDirect } from '../../core/direct-functions/some-ai-operation.js';
export async function someAiOperation(args, context) { export async function someAiOperation(args, context) {
@@ -87,15 +88,11 @@ export async function someAiOperation(args, context) {
}); });
// Call direct function with session and progress reporting // Call direct function with session and progress reporting
const result = await someAiOperationDirect( const result = await someAiOperationDirect(args, log, {
args,
log,
{
reportProgress, reportProgress,
mcpLog: log, mcpLog: log,
session session
} });
);
// Final progress update // Final progress update
reportProgress({ reportProgress({
@@ -178,9 +175,7 @@ export async function researchOperationDirect(args, log, context) {
// Call Perplexity // Call Perplexity
const response = await client.chat.completions.create({ const response = await client.chat.completions.create({
model: context.session?.env?.PERPLEXITY_MODEL || 'sonar-medium-online', model: context.session?.env?.PERPLEXITY_MODEL || 'sonar-medium-online',
messages: [ messages: [{ role: 'user', content: args.researchQuery }],
{ role: 'user', content: args.researchQuery }
],
temperature: 0.1 temperature: 0.1
}); });
@@ -226,7 +221,7 @@ const modelConfig = getModelConfig(context.session, operationDefaults);
const response = await client.messages.create({ const response = await client.messages.create({
model: modelConfig.model, model: modelConfig.model,
max_tokens: modelConfig.maxTokens, max_tokens: modelConfig.maxTokens,
temperature: modelConfig.temperature, temperature: modelConfig.temperature
// Other parameters... // Other parameters...
}); });
``` ```
@@ -234,20 +229,24 @@ const response = await client.messages.create({
## Best Practices ## Best Practices
1. **Error Handling**: 1. **Error Handling**:
- Always use try/catch blocks around both client initialization and API calls - Always use try/catch blocks around both client initialization and API calls
- Use `handleClaudeError` to provide user-friendly error messages - Use `handleClaudeError` to provide user-friendly error messages
- Return standardized error objects with code and message - Return standardized error objects with code and message
2. **Progress Reporting**: 2. **Progress Reporting**:
- Report progress at key points (starting, processing, completing) - Report progress at key points (starting, processing, completing)
- Include meaningful status messages - Include meaningful status messages
- Include error details in progress reports when failures occur - Include error details in progress reports when failures occur
3. **Session Handling**: 3. **Session Handling**:
- Always pass the session from the context to the AI client getters - Always pass the session from the context to the AI client getters
- Use `getModelConfig` to respect user settings from session - Use `getModelConfig` to respect user settings from session
4. **Model Selection**: 4. **Model Selection**:
- Use `getBestAvailableAIModel` when you need to select between different models - Use `getBestAvailableAIModel` when you need to select between different models
- Set `requiresResearch: true` when you need Perplexity capabilities - Set `requiresResearch: true` when you need Perplexity capabilities

View File

@@ -1,41 +0,0 @@
import os
import json
# Path to Cursor's history folder
history_path = os.path.expanduser('~/Library/Application Support/Cursor/User/History')
# File to search for
target_file = 'tasks/tasks.json'
# Function to search through all entries.json files
def search_entries_for_file(history_path, target_file):
matching_folders = []
for folder in os.listdir(history_path):
folder_path = os.path.join(history_path, folder)
if not os.path.isdir(folder_path):
continue
# Look for entries.json
entries_file = os.path.join(folder_path, 'entries.json')
if not os.path.exists(entries_file):
continue
# Parse entries.json to find the resource key
with open(entries_file, 'r') as f:
data = json.load(f)
resource = data.get('resource', None)
if resource and target_file in resource:
matching_folders.append(folder_path)
return matching_folders
# Search for the target file
matching_folders = search_entries_for_file(history_path, target_file)
# Output the matching folders
if matching_folders:
print(f"Found {target_file} in the following folders:")
for folder in matching_folders:
print(folder)
else:
print(f"No matches found for {target_file}.")

View File

@@ -80,7 +80,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
.command('init') .command('init')
.description('Initialize a new project') .description('Initialize a new project')
.action(() => { .action(() => {
runInitCLI().catch(err => { runInitCLI().catch((err) => {
console.error('Init failed:', err.message); console.error('Init failed:', err.message);
process.exit(1); process.exit(1);
}); });

View File

@@ -1,8 +1,8 @@
#!/usr/bin/env node #!/usr/bin/env node
import TaskMasterMCPServer from "./src/index.js"; import TaskMasterMCPServer from './src/index.js';
import dotenv from "dotenv"; import dotenv from 'dotenv';
import logger from "./src/logger.js"; import logger from './src/logger.js';
// Load environment variables // Load environment variables
dotenv.config(); dotenv.config();
@@ -14,12 +14,12 @@ async function startServer() {
const server = new TaskMasterMCPServer(); const server = new TaskMasterMCPServer();
// Handle graceful shutdown // Handle graceful shutdown
process.on("SIGINT", async () => { process.on('SIGINT', async () => {
await server.stop(); await server.stop();
process.exit(0); process.exit(0);
}); });
process.on("SIGTERM", async () => { process.on('SIGTERM', async () => {
await server.stop(); await server.stop();
process.exit(0); process.exit(0);
}); });

View File

@@ -14,7 +14,9 @@ describe('ContextManager', () => {
describe('getContext', () => { describe('getContext', () => {
it('should create a new context when not in cache', async () => { it('should create a new context when not in cache', async () => {
const context = await contextManager.getContext('test-id', { test: true }); const context = await contextManager.getContext('test-id', {
test: true
});
expect(context.id).toBe('test-id'); expect(context.id).toBe('test-id');
expect(context.metadata.test).toBe(true); expect(context.metadata.test).toBe(true);
expect(contextManager.stats.misses).toBe(1); expect(contextManager.stats.misses).toBe(1);
@@ -26,7 +28,9 @@ describe('ContextManager', () => {
await contextManager.getContext('test-id', { test: true }); await contextManager.getContext('test-id', { test: true });
// Second call should hit cache // Second call should hit cache
const context = await contextManager.getContext('test-id', { test: true }); const context = await contextManager.getContext('test-id', {
test: true
});
expect(context.id).toBe('test-id'); expect(context.id).toBe('test-id');
expect(context.metadata.test).toBe(true); expect(context.metadata.test).toBe(true);
expect(contextManager.stats.hits).toBe(1); expect(contextManager.stats.hits).toBe(1);
@@ -38,7 +42,7 @@ describe('ContextManager', () => {
await contextManager.getContext('test-id', { test: true }); await contextManager.getContext('test-id', { test: true });
// Wait for TTL to expire // Wait for TTL to expire
await new Promise(resolve => setTimeout(resolve, 1100)); await new Promise((resolve) => setTimeout(resolve, 1100));
// Should create new context // Should create new context
await contextManager.getContext('test-id', { test: true }); await contextManager.getContext('test-id', { test: true });
@@ -50,7 +54,9 @@ describe('ContextManager', () => {
describe('updateContext', () => { describe('updateContext', () => {
it('should update existing context metadata', async () => { it('should update existing context metadata', async () => {
await contextManager.getContext('test-id', { initial: true }); await contextManager.getContext('test-id', { initial: true });
const updated = await contextManager.updateContext('test-id', { updated: true }); const updated = await contextManager.updateContext('test-id', {
updated: true
});
expect(updated.metadata.initial).toBe(true); expect(updated.metadata.initial).toBe(true);
expect(updated.metadata.updated).toBe(true); expect(updated.metadata.updated).toBe(true);

View File

@@ -112,7 +112,8 @@ export class ContextManager {
*/ */
getCachedData(key) { getCachedData(key) {
const cached = this.cache.get(key); const cached = this.cache.get(key);
if (cached !== undefined) { // Check for undefined specifically, as null/false might be valid cached values if (cached !== undefined) {
// Check for undefined specifically, as null/false might be valid cached values
this.stats.hits++; this.stats.hits++;
return cached; return cached;
} }

View File

@@ -5,7 +5,10 @@
import { addDependency } from '../../../../scripts/modules/dependency-manager.js'; import { addDependency } from '../../../../scripts/modules/dependency-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Direct function wrapper for addDependency with error handling. * Direct function wrapper for addDependency with error handling.
@@ -47,10 +50,18 @@ export async function addDependencyDirect(args, log) {
const tasksPath = findTasksJsonPath(args, log); const tasksPath = findTasksJsonPath(args, log);
// Format IDs for the core function // Format IDs for the core function
const taskId = args.id.includes && args.id.includes('.') ? args.id : parseInt(args.id, 10); const taskId =
const dependencyId = args.dependsOn.includes && args.dependsOn.includes('.') ? args.dependsOn : parseInt(args.dependsOn, 10); args.id.includes && args.id.includes('.')
? args.id
: parseInt(args.id, 10);
const dependencyId =
args.dependsOn.includes && args.dependsOn.includes('.')
? args.dependsOn
: parseInt(args.dependsOn, 10);
log.info(`Adding dependency: task ${taskId} will depend on ${dependencyId}`); log.info(
`Adding dependency: task ${taskId} will depend on ${dependencyId}`
);
// Enable silent mode to prevent console logs from interfering with JSON response // Enable silent mode to prevent console logs from interfering with JSON response
enableSilentMode(); enableSilentMode();

View File

@@ -4,7 +4,10 @@
import { addSubtask } from '../../../../scripts/modules/task-manager.js'; import { addSubtask } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Add a subtask to an existing task * Add a subtask to an existing task
@@ -53,7 +56,7 @@ export async function addSubtaskDirect(args, log) {
// Parse dependencies if provided // Parse dependencies if provided
let dependencies = []; let dependencies = [];
if (args.dependencies) { if (args.dependencies) {
dependencies = args.dependencies.split(',').map(id => { dependencies = args.dependencies.split(',').map((id) => {
// Handle both regular IDs and dot notation // Handle both regular IDs and dot notation
return id.includes('.') ? id.trim() : parseInt(id.trim(), 10); return id.includes('.') ? id.trim() : parseInt(id.trim(), 10);
}); });
@@ -74,7 +77,13 @@ export async function addSubtaskDirect(args, log) {
// Case 1: Convert existing task to subtask // Case 1: Convert existing task to subtask
if (existingTaskId) { if (existingTaskId) {
log.info(`Converting task ${existingTaskId} to a subtask of ${parentId}`); log.info(`Converting task ${existingTaskId} to a subtask of ${parentId}`);
const result = await addSubtask(tasksPath, parentId, existingTaskId, null, generateFiles); const result = await addSubtask(
tasksPath,
parentId,
existingTaskId,
null,
generateFiles
);
// Restore normal logging // Restore normal logging
disableSilentMode(); disableSilentMode();
@@ -99,7 +108,13 @@ export async function addSubtaskDirect(args, log) {
dependencies: dependencies dependencies: dependencies
}; };
const result = await addSubtask(tasksPath, parentId, null, newSubtaskData, generateFiles); const result = await addSubtask(
tasksPath,
parentId,
null,
newSubtaskData,
generateFiles
);
// Restore normal logging // Restore normal logging
disableSilentMode(); disableSilentMode();

View File

@@ -5,9 +5,19 @@
import { addTask } from '../../../../scripts/modules/task-manager.js'; import { addTask } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
import { getAnthropicClientForMCP, getModelConfig } from '../utils/ai-client-utils.js'; enableSilentMode,
import { _buildAddTaskPrompt, parseTaskJsonResponse, _handleAnthropicStream } from '../../../../scripts/modules/ai-services.js'; disableSilentMode
} from '../../../../scripts/modules/utils.js';
import {
getAnthropicClientForMCP,
getModelConfig
} from '../utils/ai-client-utils.js';
import {
_buildAddTaskPrompt,
parseTaskJsonResponse,
_handleAnthropicStream
} from '../../../../scripts/modules/ai-services.js';
/** /**
* Direct function wrapper for adding a new task with error handling. * Direct function wrapper for adding a new task with error handling.
@@ -48,10 +58,16 @@ export async function addTaskDirect(args, log, context = {}) {
const prompt = args.prompt; const prompt = args.prompt;
const dependencies = Array.isArray(args.dependencies) const dependencies = Array.isArray(args.dependencies)
? args.dependencies ? args.dependencies
: (args.dependencies ? String(args.dependencies).split(',').map(id => parseInt(id.trim(), 10)) : []); : args.dependencies
? String(args.dependencies)
.split(',')
.map((id) => parseInt(id.trim(), 10))
: [];
const priority = args.priority || 'medium'; const priority = args.priority || 'medium';
log.info(`Adding new task with prompt: "${prompt}", dependencies: [${dependencies.join(', ')}], priority: ${priority}`); log.info(
`Adding new task with prompt: "${prompt}", dependencies: [${dependencies.join(', ')}], priority: ${priority}`
);
// Extract context parameters for advanced functionality // Extract context parameters for advanced functionality
// Commenting out reportProgress extraction // Commenting out reportProgress extraction
@@ -88,7 +104,10 @@ export async function addTaskDirect(args, log, context = {}) {
} }
// Build prompts for AI // Build prompts for AI
const { systemPrompt, userPrompt } = _buildAddTaskPrompt(prompt, tasksData.tasks); const { systemPrompt, userPrompt } = _buildAddTaskPrompt(
prompt,
tasksData.tasks
);
// Make the AI call using the streaming helper // Make the AI call using the streaming helper
let responseText; let responseText;
@@ -99,7 +118,7 @@ export async function addTaskDirect(args, log, context = {}) {
model: modelConfig.model, model: modelConfig.model,
max_tokens: modelConfig.maxTokens, max_tokens: modelConfig.maxTokens,
temperature: modelConfig.temperature, temperature: modelConfig.temperature,
messages: [{ role: "user", content: userPrompt }], messages: [{ role: 'user', content: userPrompt }],
system: systemPrompt system: systemPrompt
}, },
{ {

View File

@@ -4,7 +4,12 @@
import { analyzeTaskComplexity } from '../../../../scripts/modules/task-manager.js'; import { analyzeTaskComplexity } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode, isSilentMode, readJSON } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode,
isSilentMode,
readJSON
} from '../../../../scripts/modules/utils.js';
import fs from 'fs'; import fs from 'fs';
import path from 'path'; import path from 'path';
@@ -107,13 +112,20 @@ export async function analyzeTaskComplexityDirect(args, log, context = {}) {
// Important: Handle different report formats // Important: Handle different report formats
// The core function might return an array or an object with a complexityAnalysis property // The core function might return an array or an object with a complexityAnalysis property
const analysisArray = Array.isArray(report) ? report : const analysisArray = Array.isArray(report)
(report.complexityAnalysis || []); ? report
: report.complexityAnalysis || [];
// Count tasks by complexity // Count tasks by complexity
const highComplexityTasks = analysisArray.filter(t => t.complexityScore >= 8).length; const highComplexityTasks = analysisArray.filter(
const mediumComplexityTasks = analysisArray.filter(t => t.complexityScore >= 5 && t.complexityScore < 8).length; (t) => t.complexityScore >= 8
const lowComplexityTasks = analysisArray.filter(t => t.complexityScore < 5).length; ).length;
const mediumComplexityTasks = analysisArray.filter(
(t) => t.complexityScore >= 5 && t.complexityScore < 8
).length;
const lowComplexityTasks = analysisArray.filter(
(t) => t.complexityScore < 5
).length;
return { return {
success: true, success: true,

View File

@@ -4,7 +4,10 @@
import { clearSubtasks } from '../../../../scripts/modules/task-manager.js'; import { clearSubtasks } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import fs from 'fs'; import fs from 'fs';
/** /**
@@ -27,7 +30,8 @@ export async function clearSubtasksDirect(args, log) {
success: false, success: false,
error: { error: {
code: 'INPUT_VALIDATION_ERROR', code: 'INPUT_VALIDATION_ERROR',
message: 'Either task IDs with id parameter or all parameter must be provided' message:
'Either task IDs with id parameter or all parameter must be provided'
} }
}; };
} }
@@ -61,7 +65,7 @@ export async function clearSubtasksDirect(args, log) {
} }
}; };
} }
taskIds = data.tasks.map(t => t.id).join(','); taskIds = data.tasks.map((t) => t.id).join(',');
} else { } else {
// Use the provided task IDs // Use the provided task IDs
taskIds = args.id; taskIds = args.id;
@@ -80,12 +84,12 @@ export async function clearSubtasksDirect(args, log) {
// Read the updated data to provide a summary // Read the updated data to provide a summary
const updatedData = JSON.parse(fs.readFileSync(tasksPath, 'utf8')); const updatedData = JSON.parse(fs.readFileSync(tasksPath, 'utf8'));
const taskIdArray = taskIds.split(',').map(id => parseInt(id.trim(), 10)); const taskIdArray = taskIds.split(',').map((id) => parseInt(id.trim(), 10));
// Build a summary of what was done // Build a summary of what was done
const clearedTasksCount = taskIdArray.length; const clearedTasksCount = taskIdArray.length;
const taskSummary = taskIdArray.map(id => { const taskSummary = taskIdArray.map((id) => {
const task = updatedData.tasks.find(t => t.id === id); const task = updatedData.tasks.find((t) => t.id === id);
return task ? { id, title: task.title } : { id, title: 'Task not found' }; return task ? { id, title: task.title } : { id, title: 'Task not found' };
}); });

View File

@@ -3,7 +3,11 @@
* Direct function implementation for displaying complexity analysis report * Direct function implementation for displaying complexity analysis report
*/ */
import { readComplexityReport, enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
readComplexityReport,
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { getCachedOrExecute } from '../../tools/utils.js'; import { getCachedOrExecute } from '../../tools/utils.js';
import path from 'path'; import path from 'path';
@@ -24,12 +28,16 @@ export async function complexityReportDirect(args, log) {
try { try {
tasksPath = findTasksJsonPath(args, log); tasksPath = findTasksJsonPath(args, log);
} catch (error) { } catch (error) {
log.warn(`Tasks file not found, using current directory: ${error.message}`); log.warn(
`Tasks file not found, using current directory: ${error.message}`
);
// Continue with default or specified report path // Continue with default or specified report path
} }
// Get report file path from args or use default // Get report file path from args or use default
const reportPath = args.file || path.join(process.cwd(), 'scripts', 'task-complexity-report.json'); const reportPath =
args.file ||
path.join(process.cwd(), 'scripts', 'task-complexity-report.json');
log.info(`Looking for complexity report at: ${reportPath}`); log.info(`Looking for complexity report at: ${reportPath}`);
@@ -87,14 +95,18 @@ export async function complexityReportDirect(args, log) {
actionFn: coreActionFn, actionFn: coreActionFn,
log log
}); });
log.info(`complexityReportDirect completed. From cache: ${result.fromCache}`); log.info(
`complexityReportDirect completed. From cache: ${result.fromCache}`
);
return result; // Returns { success, data/error, fromCache } return result; // Returns { success, data/error, fromCache }
} catch (error) { } catch (error) {
// Catch unexpected errors from getCachedOrExecute itself // Catch unexpected errors from getCachedOrExecute itself
// Ensure silent mode is disabled // Ensure silent mode is disabled
disableSilentMode(); disableSilentMode();
log.error(`Unexpected error during getCachedOrExecute for complexityReport: ${error.message}`); log.error(
`Unexpected error during getCachedOrExecute for complexityReport: ${error.message}`
);
return { return {
success: false, success: false,
error: { error: {

View File

@@ -3,7 +3,11 @@
*/ */
import { expandAllTasks } from '../../../../scripts/modules/task-manager.js'; import { expandAllTasks } from '../../../../scripts/modules/task-manager.js';
import { enableSilentMode, disableSilentMode, isSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode,
isSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { getAnthropicClientForMCP } from '../utils/ai-client-utils.js'; import { getAnthropicClientForMCP } from '../utils/ai-client-utils.js';
import path from 'path'; import path from 'path';
@@ -41,7 +45,9 @@ export async function expandAllTasksDirect(args, log, context = {}) {
const additionalContext = args.prompt || ''; const additionalContext = args.prompt || '';
const forceFlag = args.force === true; const forceFlag = args.force === true;
log.info(`Expanding all tasks with ${numSubtasks || 'default'} subtasks each...`); log.info(
`Expanding all tasks with ${numSubtasks || 'default'} subtasks each...`
);
if (useResearch) { if (useResearch) {
log.info('Using Perplexity AI for research-backed subtask generation'); log.info('Using Perplexity AI for research-backed subtask generation');
@@ -87,7 +93,7 @@ export async function expandAllTasksDirect(args, log, context = {}) {
return { return {
success: true, success: true,
data: { data: {
message: "Successfully expanded all pending tasks with subtasks", message: 'Successfully expanded all pending tasks with subtasks',
details: { details: {
numSubtasks: numSubtasks, numSubtasks: numSubtasks,
research: useResearch, research: useResearch,

View File

@@ -4,9 +4,18 @@
*/ */
import { expandTask } from '../../../../scripts/modules/task-manager.js'; import { expandTask } from '../../../../scripts/modules/task-manager.js';
import { readJSON, writeJSON, enableSilentMode, disableSilentMode, isSilentMode } from '../../../../scripts/modules/utils.js'; import {
readJSON,
writeJSON,
enableSilentMode,
disableSilentMode,
isSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { getAnthropicClientForMCP, getModelConfig } from '../utils/ai-client-utils.js'; import {
getAnthropicClientForMCP,
getModelConfig
} from '../utils/ai-client-utils.js';
import path from 'path'; import path from 'path';
import fs from 'fs'; import fs from 'fs';
@@ -22,34 +31,42 @@ export async function expandTaskDirect(args, log, context = {}) {
const { session } = context; const { session } = context;
// Log session root data for debugging // Log session root data for debugging
log.info(`Session data in expandTaskDirect: ${JSON.stringify({ log.info(
`Session data in expandTaskDirect: ${JSON.stringify({
hasSession: !!session, hasSession: !!session,
sessionKeys: session ? Object.keys(session) : [], sessionKeys: session ? Object.keys(session) : [],
roots: session?.roots, roots: session?.roots,
rootsStr: JSON.stringify(session?.roots) rootsStr: JSON.stringify(session?.roots)
})}`); })}`
);
let tasksPath; let tasksPath;
try { try {
// If a direct file path is provided, use it directly // If a direct file path is provided, use it directly
if (args.file && fs.existsSync(args.file)) { if (args.file && fs.existsSync(args.file)) {
log.info(`[expandTaskDirect] Using explicitly provided tasks file: ${args.file}`); log.info(
`[expandTaskDirect] Using explicitly provided tasks file: ${args.file}`
);
tasksPath = args.file; tasksPath = args.file;
} else { } else {
// Find the tasks path through standard logic // Find the tasks path through standard logic
log.info(`[expandTaskDirect] No direct file path provided or file not found at ${args.file}, searching using findTasksJsonPath`); log.info(
`[expandTaskDirect] No direct file path provided or file not found at ${args.file}, searching using findTasksJsonPath`
);
tasksPath = findTasksJsonPath(args, log); tasksPath = findTasksJsonPath(args, log);
} }
} catch (error) { } catch (error) {
log.error(`[expandTaskDirect] Error during tasksPath determination: ${error.message}`); log.error(
`[expandTaskDirect] Error during tasksPath determination: ${error.message}`
);
// Include session roots information in error // Include session roots information in error
const sessionRootsInfo = session ? const sessionRootsInfo = session
`\nSession.roots: ${JSON.stringify(session.roots)}\n` + ? `\nSession.roots: ${JSON.stringify(session.roots)}\n` +
`Current Working Directory: ${process.cwd()}\n` + `Current Working Directory: ${process.cwd()}\n` +
`Args.projectRoot: ${args.projectRoot}\n` + `Args.projectRoot: ${args.projectRoot}\n` +
`Args.file: ${args.file}\n` : `Args.file: ${args.file}\n`
'\nSession object not available'; : '\nSession object not available';
return { return {
success: false, success: false,
@@ -102,15 +119,21 @@ export async function expandTaskDirect(args, log, context = {}) {
} }
try { try {
log.info(`[expandTaskDirect] Expanding task ${taskId} into ${numSubtasks || 'default'} subtasks. Research: ${useResearch}`); log.info(
`[expandTaskDirect] Expanding task ${taskId} into ${numSubtasks || 'default'} subtasks. Research: ${useResearch}`
);
// Read tasks data // Read tasks data
log.info(`[expandTaskDirect] Attempting to read JSON from: ${tasksPath}`); log.info(`[expandTaskDirect] Attempting to read JSON from: ${tasksPath}`);
const data = readJSON(tasksPath); const data = readJSON(tasksPath);
log.info(`[expandTaskDirect] Result of readJSON: ${data ? 'Data read successfully' : 'readJSON returned null or undefined'}`); log.info(
`[expandTaskDirect] Result of readJSON: ${data ? 'Data read successfully' : 'readJSON returned null or undefined'}`
);
if (!data || !data.tasks) { if (!data || !data.tasks) {
log.error(`[expandTaskDirect] readJSON failed or returned invalid data for path: ${tasksPath}`); log.error(
`[expandTaskDirect] readJSON failed or returned invalid data for path: ${tasksPath}`
);
return { return {
success: false, success: false,
error: { error: {
@@ -123,7 +146,7 @@ export async function expandTaskDirect(args, log, context = {}) {
// Find the specific task // Find the specific task
log.info(`[expandTaskDirect] Searching for task ID ${taskId} in data`); log.info(`[expandTaskDirect] Searching for task ID ${taskId} in data`);
const task = data.tasks.find(t => t.id === taskId); const task = data.tasks.find((t) => t.id === taskId);
log.info(`[expandTaskDirect] Task found: ${task ? 'Yes' : 'No'}`); log.info(`[expandTaskDirect] Task found: ${task ? 'Yes' : 'No'}`);
if (!task) { if (!task) {
@@ -204,14 +227,17 @@ export async function expandTaskDirect(args, log, context = {}) {
// Read the updated data // Read the updated data
const updatedData = readJSON(tasksPath); const updatedData = readJSON(tasksPath);
const updatedTask = updatedData.tasks.find(t => t.id === taskId); const updatedTask = updatedData.tasks.find((t) => t.id === taskId);
// Calculate how many subtasks were added // Calculate how many subtasks were added
const subtasksAdded = updatedTask.subtasks ? const subtasksAdded = updatedTask.subtasks
updatedTask.subtasks.length - subtasksCountBefore : 0; ? updatedTask.subtasks.length - subtasksCountBefore
: 0;
// Return the result // Return the result
log.info(`Successfully expanded task ${taskId} with ${subtasksAdded} new subtasks`); log.info(
`Successfully expanded task ${taskId} with ${subtasksAdded} new subtasks`
);
return { return {
success: true, success: true,
data: { data: {

View File

@@ -4,7 +4,10 @@
import { fixDependenciesCommand } from '../../../../scripts/modules/dependency-manager.js'; import { fixDependenciesCommand } from '../../../../scripts/modules/dependency-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import fs from 'fs'; import fs from 'fs';
/** /**

View File

@@ -4,7 +4,10 @@
*/ */
import { generateTaskFiles } from '../../../../scripts/modules/task-manager.js'; import { generateTaskFiles } from '../../../../scripts/modules/task-manager.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import path from 'path'; import path from 'path';
@@ -69,7 +72,8 @@ export async function generateTaskFilesDirect(args, log) {
message: `Successfully generated task files`, message: `Successfully generated task files`,
tasksPath, tasksPath,
outputDir, outputDir,
taskFiles: 'Individual task files have been generated in the output directory' taskFiles:
'Individual task files have been generated in the output directory'
}, },
fromCache: false // This operation always modifies state and should never be cached fromCache: false // This operation always modifies state and should never be cached
}; };
@@ -80,7 +84,10 @@ export async function generateTaskFilesDirect(args, log) {
log.error(`Error generating task files: ${error.message}`); log.error(`Error generating task files: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'GENERATE_TASKS_ERROR', message: error.message || 'Unknown error generating task files' }, error: {
code: 'GENERATE_TASKS_ERROR',
message: error.message || 'Unknown error generating task files'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -6,7 +6,10 @@
import { listTasks } from '../../../../scripts/modules/task-manager.js'; import { listTasks } from '../../../../scripts/modules/task-manager.js';
import { getCachedOrExecute } from '../../tools/utils.js'; import { getCachedOrExecute } from '../../tools/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Direct function wrapper for listTasks with error handling and caching. * Direct function wrapper for listTasks with error handling and caching.
@@ -24,11 +27,19 @@ export async function listTasksDirect(args, log) {
if (error.code === 'TASKS_FILE_NOT_FOUND') { if (error.code === 'TASKS_FILE_NOT_FOUND') {
log.error(`Tasks file not found: ${error.message}`); log.error(`Tasks file not found: ${error.message}`);
// Return the error structure expected by the calling tool/handler // Return the error structure expected by the calling tool/handler
return { success: false, error: { code: error.code, message: error.message }, fromCache: false }; return {
success: false,
error: { code: error.code, message: error.message },
fromCache: false
};
} }
log.error(`Unexpected error finding tasks file: ${error.message}`); log.error(`Unexpected error finding tasks file: ${error.message}`);
// Re-throw for outer catch or return structured error // Re-throw for outer catch or return structured error
return { success: false, error: { code: 'FIND_TASKS_PATH_ERROR', message: error.message }, fromCache: false }; return {
success: false,
error: { code: 'FIND_TASKS_PATH_ERROR', message: error.message },
fromCache: false
};
} }
// Generate cache key *after* finding tasksPath // Generate cache key *after* finding tasksPath
@@ -42,26 +53,46 @@ export async function listTasksDirect(args, log) {
// Enable silent mode to prevent console logs from interfering with JSON response // Enable silent mode to prevent console logs from interfering with JSON response
enableSilentMode(); enableSilentMode();
log.info(`Executing core listTasks function for path: ${tasksPath}, filter: ${statusFilter}, subtasks: ${withSubtasks}`); log.info(
const resultData = listTasks(tasksPath, statusFilter, withSubtasks, 'json'); `Executing core listTasks function for path: ${tasksPath}, filter: ${statusFilter}, subtasks: ${withSubtasks}`
);
const resultData = listTasks(
tasksPath,
statusFilter,
withSubtasks,
'json'
);
if (!resultData || !resultData.tasks) { if (!resultData || !resultData.tasks) {
log.error('Invalid or empty response from listTasks core function'); log.error('Invalid or empty response from listTasks core function');
return { success: false, error: { code: 'INVALID_CORE_RESPONSE', message: 'Invalid or empty response from listTasks core function' } }; return {
success: false,
error: {
code: 'INVALID_CORE_RESPONSE',
message: 'Invalid or empty response from listTasks core function'
} }
log.info(`Core listTasks function retrieved ${resultData.tasks.length} tasks`); };
}
log.info(
`Core listTasks function retrieved ${resultData.tasks.length} tasks`
);
// Restore normal logging // Restore normal logging
disableSilentMode(); disableSilentMode();
return { success: true, data: resultData }; return { success: true, data: resultData };
} catch (error) { } catch (error) {
// Make sure to restore normal logging even if there's an error // Make sure to restore normal logging even if there's an error
disableSilentMode(); disableSilentMode();
log.error(`Core listTasks function failed: ${error.message}`); log.error(`Core listTasks function failed: ${error.message}`);
return { success: false, error: { code: 'LIST_TASKS_CORE_ERROR', message: error.message || 'Failed to list tasks' } }; return {
success: false,
error: {
code: 'LIST_TASKS_CORE_ERROR',
message: error.message || 'Failed to list tasks'
}
};
} }
}; };
@@ -74,10 +105,16 @@ export async function listTasksDirect(args, log) {
}); });
log.info(`listTasksDirect completed. From cache: ${result.fromCache}`); log.info(`listTasksDirect completed. From cache: ${result.fromCache}`);
return result; // Returns { success, data/error, fromCache } return result; // Returns { success, data/error, fromCache }
} catch(error) { } catch (error) {
// Catch unexpected errors from getCachedOrExecute itself (though unlikely) // Catch unexpected errors from getCachedOrExecute itself (though unlikely)
log.error(`Unexpected error during getCachedOrExecute for listTasks: ${error.message}`); log.error(
`Unexpected error during getCachedOrExecute for listTasks: ${error.message}`
);
console.error(error.stack); console.error(error.stack);
return { success: false, error: { code: 'CACHE_UTIL_ERROR', message: error.message }, fromCache: false }; return {
success: false,
error: { code: 'CACHE_UTIL_ERROR', message: error.message },
fromCache: false
};
} }
} }

View File

@@ -7,7 +7,10 @@ import { findNextTask } from '../../../../scripts/modules/task-manager.js';
import { readJSON } from '../../../../scripts/modules/utils.js'; import { readJSON } from '../../../../scripts/modules/utils.js';
import { getCachedOrExecute } from '../../tools/utils.js'; import { getCachedOrExecute } from '../../tools/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Direct function wrapper for finding the next task to work on with error handling and caching. * Direct function wrapper for finding the next task to work on with error handling and caching.
@@ -60,11 +63,14 @@ export async function nextTaskDirect(args, log) {
const nextTask = findNextTask(data.tasks); const nextTask = findNextTask(data.tasks);
if (!nextTask) { if (!nextTask) {
log.info('No eligible next task found. All tasks are either completed or have unsatisfied dependencies'); log.info(
'No eligible next task found. All tasks are either completed or have unsatisfied dependencies'
);
return { return {
success: true, success: true,
data: { data: {
message: 'No eligible next task found. All tasks are either completed or have unsatisfied dependencies', message:
'No eligible next task found. All tasks are either completed or have unsatisfied dependencies',
nextTask: null, nextTask: null,
allTasks: data.tasks allTasks: data.tasks
} }
@@ -75,7 +81,9 @@ export async function nextTaskDirect(args, log) {
disableSilentMode(); disableSilentMode();
// Return the next task data with the full tasks array for reference // Return the next task data with the full tasks array for reference
log.info(`Successfully found next task ${nextTask.id}: ${nextTask.title}`); log.info(
`Successfully found next task ${nextTask.id}: ${nextTask.title}`
);
return { return {
success: true, success: true,
data: { data: {
@@ -109,7 +117,9 @@ export async function nextTaskDirect(args, log) {
return result; // Returns { success, data/error, fromCache } return result; // Returns { success, data/error, fromCache }
} catch (error) { } catch (error) {
// Catch unexpected errors from getCachedOrExecute itself // Catch unexpected errors from getCachedOrExecute itself
log.error(`Unexpected error during getCachedOrExecute for nextTask: ${error.message}`); log.error(
`Unexpected error during getCachedOrExecute for nextTask: ${error.message}`
);
return { return {
success: false, success: false,
error: { error: {

View File

@@ -7,8 +7,14 @@ import path from 'path';
import fs from 'fs'; import fs from 'fs';
import { parsePRD } from '../../../../scripts/modules/task-manager.js'; import { parsePRD } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
import { getAnthropicClientForMCP, getModelConfig } from '../utils/ai-client-utils.js'; enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import {
getAnthropicClientForMCP,
getModelConfig
} from '../utils/ai-client-utils.js';
/** /**
* Direct function wrapper for parsing PRD documents and generating tasks. * Direct function wrapper for parsing PRD documents and generating tasks.
@@ -42,7 +48,8 @@ export async function parsePRDDirect(args, log, context = {}) {
// Parameter validation and path resolution // Parameter validation and path resolution
if (!args.input) { if (!args.input) {
const errorMessage = 'No input file specified. Please provide an input PRD document path.'; const errorMessage =
'No input file specified. Please provide an input PRD document path.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -53,12 +60,16 @@ export async function parsePRDDirect(args, log, context = {}) {
// Resolve input path (relative to project root if provided) // Resolve input path (relative to project root if provided)
const projectRoot = args.projectRoot || process.cwd(); const projectRoot = args.projectRoot || process.cwd();
const inputPath = path.isAbsolute(args.input) ? args.input : path.resolve(projectRoot, args.input); const inputPath = path.isAbsolute(args.input)
? args.input
: path.resolve(projectRoot, args.input);
// Determine output path // Determine output path
let outputPath; let outputPath;
if (args.output) { if (args.output) {
outputPath = path.isAbsolute(args.output) ? args.output : path.resolve(projectRoot, args.output); outputPath = path.isAbsolute(args.output)
? args.output
: path.resolve(projectRoot, args.output);
} else { } else {
// Default to tasks/tasks.json in the project root // Default to tasks/tasks.json in the project root
outputPath = path.resolve(projectRoot, 'tasks', 'tasks.json'); outputPath = path.resolve(projectRoot, 'tasks', 'tasks.json');
@@ -78,14 +89,19 @@ export async function parsePRDDirect(args, log, context = {}) {
// Parse number of tasks - handle both string and number values // Parse number of tasks - handle both string and number values
let numTasks = 10; // Default let numTasks = 10; // Default
if (args.numTasks) { if (args.numTasks) {
numTasks = typeof args.numTasks === 'string' ? parseInt(args.numTasks, 10) : args.numTasks; numTasks =
typeof args.numTasks === 'string'
? parseInt(args.numTasks, 10)
: args.numTasks;
if (isNaN(numTasks)) { if (isNaN(numTasks)) {
numTasks = 10; // Fallback to default if parsing fails numTasks = 10; // Fallback to default if parsing fails
log.warn(`Invalid numTasks value: ${args.numTasks}. Using default: 10`); log.warn(`Invalid numTasks value: ${args.numTasks}. Using default: 10`);
} }
} }
log.info(`Preparing to parse PRD from ${inputPath} and output to ${outputPath} with ${numTasks} tasks`); log.info(
`Preparing to parse PRD from ${inputPath} and output to ${outputPath} with ${numTasks} tasks`
);
// Create the logger wrapper for proper logging in the core function // Create the logger wrapper for proper logging in the core function
const logWrapper = { const logWrapper = {
@@ -103,16 +119,25 @@ export async function parsePRDDirect(args, log, context = {}) {
enableSilentMode(); enableSilentMode();
try { try {
// Execute core parsePRD function with AI client // Execute core parsePRD function with AI client
await parsePRD(inputPath, outputPath, numTasks, { await parsePRD(
inputPath,
outputPath,
numTasks,
{
mcpLog: logWrapper, mcpLog: logWrapper,
session session
}, aiClient, modelConfig); },
aiClient,
modelConfig
);
// Since parsePRD doesn't return a value but writes to a file, we'll read the result // Since parsePRD doesn't return a value but writes to a file, we'll read the result
// to return it to the caller // to return it to the caller
if (fs.existsSync(outputPath)) { if (fs.existsSync(outputPath)) {
const tasksData = JSON.parse(fs.readFileSync(outputPath, 'utf8')); const tasksData = JSON.parse(fs.readFileSync(outputPath, 'utf8'));
log.info(`Successfully parsed PRD and generated ${tasksData.tasks?.length || 0} tasks`); log.info(
`Successfully parsed PRD and generated ${tasksData.tasks?.length || 0} tasks`
);
return { return {
success: true, success: true,
@@ -143,7 +168,10 @@ export async function parsePRDDirect(args, log, context = {}) {
log.error(`Error parsing PRD: ${error.message}`); log.error(`Error parsing PRD: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'PARSE_PRD_ERROR', message: error.message || 'Unknown error parsing PRD' }, error: {
code: 'PARSE_PRD_ERROR',
message: error.message || 'Unknown error parsing PRD'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -4,7 +4,10 @@
import { removeDependency } from '../../../../scripts/modules/dependency-manager.js'; import { removeDependency } from '../../../../scripts/modules/dependency-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Remove a dependency from a task * Remove a dependency from a task
@@ -45,10 +48,18 @@ export async function removeDependencyDirect(args, log) {
const tasksPath = findTasksJsonPath(args, log); const tasksPath = findTasksJsonPath(args, log);
// Format IDs for the core function // Format IDs for the core function
const taskId = args.id.includes && args.id.includes('.') ? args.id : parseInt(args.id, 10); const taskId =
const dependencyId = args.dependsOn.includes && args.dependsOn.includes('.') ? args.dependsOn : parseInt(args.dependsOn, 10); args.id.includes && args.id.includes('.')
? args.id
: parseInt(args.id, 10);
const dependencyId =
args.dependsOn.includes && args.dependsOn.includes('.')
? args.dependsOn
: parseInt(args.dependsOn, 10);
log.info(`Removing dependency: task ${taskId} no longer depends on ${dependencyId}`); log.info(
`Removing dependency: task ${taskId} no longer depends on ${dependencyId}`
);
// Enable silent mode to prevent console logs from interfering with JSON response // Enable silent mode to prevent console logs from interfering with JSON response
enableSilentMode(); enableSilentMode();

View File

@@ -4,7 +4,10 @@
import { removeSubtask } from '../../../../scripts/modules/task-manager.js'; import { removeSubtask } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Remove a subtask from its parent task * Remove a subtask from its parent task
@@ -29,7 +32,8 @@ export async function removeSubtaskDirect(args, log) {
success: false, success: false,
error: { error: {
code: 'INPUT_VALIDATION_ERROR', code: 'INPUT_VALIDATION_ERROR',
message: 'Subtask ID is required and must be in format "parentId.subtaskId"' message:
'Subtask ID is required and must be in format "parentId.subtaskId"'
} }
}; };
} }
@@ -54,9 +58,16 @@ export async function removeSubtaskDirect(args, log) {
// Determine if we should generate files // Determine if we should generate files
const generateFiles = !args.skipGenerate; const generateFiles = !args.skipGenerate;
log.info(`Removing subtask ${args.id} (convertToTask: ${convertToTask}, generateFiles: ${generateFiles})`); log.info(
`Removing subtask ${args.id} (convertToTask: ${convertToTask}, generateFiles: ${generateFiles})`
);
const result = await removeSubtask(tasksPath, args.id, convertToTask, generateFiles); const result = await removeSubtask(
tasksPath,
args.id,
convertToTask,
generateFiles
);
// Restore normal logging // Restore normal logging
disableSilentMode(); disableSilentMode();

View File

@@ -4,7 +4,10 @@
*/ */
import { removeTask } from '../../../../scripts/modules/task-manager.js'; import { removeTask } from '../../../../scripts/modules/task-manager.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
/** /**

View File

@@ -5,7 +5,11 @@
import { setTaskStatus } from '../../../../scripts/modules/task-manager.js'; import { setTaskStatus } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode, isSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode,
isSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Direct function wrapper for setTaskStatus with error handling. * Direct function wrapper for setTaskStatus with error handling.
@@ -20,7 +24,8 @@ export async function setTaskStatusDirect(args, log) {
// Check required parameters // Check required parameters
if (!args.id) { if (!args.id) {
const errorMessage = 'No task ID specified. Please provide a task ID to update.'; const errorMessage =
'No task ID specified. Please provide a task ID to update.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -30,7 +35,8 @@ export async function setTaskStatusDirect(args, log) {
} }
if (!args.status) { if (!args.status) {
const errorMessage = 'No status specified. Please provide a new status value.'; const errorMessage =
'No status specified. Please provide a new status value.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -87,7 +93,10 @@ export async function setTaskStatusDirect(args, log) {
log.error(`Error setting task status: ${error.message}`); log.error(`Error setting task status: ${error.message}`);
result = { result = {
success: false, success: false,
error: { code: 'SET_STATUS_ERROR', message: error.message || 'Unknown error setting task status' }, error: {
code: 'SET_STATUS_ERROR',
message: error.message || 'Unknown error setting task status'
},
fromCache: false fromCache: false
}; };
} finally { } finally {
@@ -105,7 +114,10 @@ export async function setTaskStatusDirect(args, log) {
log.error(`Error setting task status: ${error.message}`); log.error(`Error setting task status: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'SET_STATUS_ERROR', message: error.message || 'Unknown error setting task status' }, error: {
code: 'SET_STATUS_ERROR',
message: error.message || 'Unknown error setting task status'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -7,7 +7,10 @@ import { findTaskById } from '../../../../scripts/modules/utils.js';
import { readJSON } from '../../../../scripts/modules/utils.js'; import { readJSON } from '../../../../scripts/modules/utils.js';
import { getCachedOrExecute } from '../../tools/utils.js'; import { getCachedOrExecute } from '../../tools/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
/** /**
* Direct function wrapper for showing task details with error handling and caching. * Direct function wrapper for showing task details with error handling and caching.
@@ -123,7 +126,9 @@ export async function showTaskDirect(args, log) {
} catch (error) { } catch (error) {
// Catch unexpected errors from getCachedOrExecute itself // Catch unexpected errors from getCachedOrExecute itself
disableSilentMode(); disableSilentMode();
log.error(`Unexpected error during getCachedOrExecute for showTask: ${error.message}`); log.error(
`Unexpected error during getCachedOrExecute for showTask: ${error.message}`
);
return { return {
success: false, success: false,
error: { error: {

View File

@@ -4,9 +4,15 @@
*/ */
import { updateSubtaskById } from '../../../../scripts/modules/task-manager.js'; import { updateSubtaskById } from '../../../../scripts/modules/task-manager.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { getAnthropicClientForMCP, getPerplexityClientForMCP } from '../utils/ai-client-utils.js'; import {
getAnthropicClientForMCP,
getPerplexityClientForMCP
} from '../utils/ai-client-utils.js';
/** /**
* Direct function wrapper for updateSubtaskById with error handling. * Direct function wrapper for updateSubtaskById with error handling.
@@ -24,7 +30,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
// Check required parameters // Check required parameters
if (!args.id) { if (!args.id) {
const errorMessage = 'No subtask ID specified. Please provide a subtask ID to update.'; const errorMessage =
'No subtask ID specified. Please provide a subtask ID to update.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -34,7 +41,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
} }
if (!args.prompt) { if (!args.prompt) {
const errorMessage = 'No prompt specified. Please provide a prompt with information to add to the subtask.'; const errorMessage =
'No prompt specified. Please provide a prompt with information to add to the subtask.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -82,7 +90,9 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
// Get research flag // Get research flag
const useResearch = args.research === true; const useResearch = args.research === true;
log.info(`Updating subtask with ID ${subtaskIdStr} with prompt "${args.prompt}" and research: ${useResearch}`); log.info(
`Updating subtask with ID ${subtaskIdStr} with prompt "${args.prompt}" and research: ${useResearch}`
);
// Initialize the appropriate AI client based on research flag // Initialize the appropriate AI client based on research flag
try { try {
@@ -97,7 +107,10 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
log.error(`AI client initialization error: ${error.message}`); log.error(`AI client initialization error: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'AI_CLIENT_ERROR', message: error.message || 'Failed to initialize AI client' }, error: {
code: 'AI_CLIENT_ERROR',
message: error.message || 'Failed to initialize AI client'
},
fromCache: false fromCache: false
}; };
} }
@@ -118,10 +131,16 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
// Execute core updateSubtaskById function // Execute core updateSubtaskById function
// Pass both session and logWrapper as mcpLog to ensure outputFormat is 'json' // Pass both session and logWrapper as mcpLog to ensure outputFormat is 'json'
const updatedSubtask = await updateSubtaskById(tasksPath, subtaskIdStr, args.prompt, useResearch, { const updatedSubtask = await updateSubtaskById(
tasksPath,
subtaskIdStr,
args.prompt,
useResearch,
{
session, session,
mcpLog: logWrapper mcpLog: logWrapper
}); }
);
// Restore normal logging // Restore normal logging
disableSilentMode(); disableSilentMode();
@@ -132,7 +151,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
success: false, success: false,
error: { error: {
code: 'SUBTASK_UPDATE_FAILED', code: 'SUBTASK_UPDATE_FAILED',
message: 'Failed to update subtask. It may be marked as completed, or another error occurred.' message:
'Failed to update subtask. It may be marked as completed, or another error occurred.'
}, },
fromCache: false fromCache: false
}; };
@@ -163,7 +183,10 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
log.error(`Error updating subtask by ID: ${error.message}`); log.error(`Error updating subtask by ID: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'UPDATE_SUBTASK_ERROR', message: error.message || 'Unknown error updating subtask' }, error: {
code: 'UPDATE_SUBTASK_ERROR',
message: error.message || 'Unknown error updating subtask'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -5,7 +5,10 @@
import { updateTaskById } from '../../../../scripts/modules/task-manager.js'; import { updateTaskById } from '../../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { import {
getAnthropicClientForMCP, getAnthropicClientForMCP,
getPerplexityClientForMCP getPerplexityClientForMCP
@@ -27,7 +30,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
// Check required parameters // Check required parameters
if (!args.id) { if (!args.id) {
const errorMessage = 'No task ID specified. Please provide a task ID to update.'; const errorMessage =
'No task ID specified. Please provide a task ID to update.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -37,7 +41,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
} }
if (!args.prompt) { if (!args.prompt) {
const errorMessage = 'No prompt specified. Please provide a prompt with new information for the task update.'; const errorMessage =
'No prompt specified. Please provide a prompt with new information for the task update.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -107,7 +112,9 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
}; };
} }
log.info(`Updating task with ID ${taskId} with prompt "${args.prompt}" and research: ${useResearch}`); log.info(
`Updating task with ID ${taskId} with prompt "${args.prompt}" and research: ${useResearch}`
);
try { try {
// Enable silent mode to prevent console logs from interfering with JSON response // Enable silent mode to prevent console logs from interfering with JSON response
@@ -151,7 +158,10 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
log.error(`Error updating task by ID: ${error.message}`); log.error(`Error updating task by ID: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'UPDATE_TASK_ERROR', message: error.message || 'Unknown error updating task' }, error: {
code: 'UPDATE_TASK_ERROR',
message: error.message || 'Unknown error updating task'
},
fromCache: false fromCache: false
}; };
} finally { } finally {
@@ -165,7 +175,10 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
log.error(`Error updating task by ID: ${error.message}`); log.error(`Error updating task by ID: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'UPDATE_TASK_ERROR', message: error.message || 'Unknown error updating task' }, error: {
code: 'UPDATE_TASK_ERROR',
message: error.message || 'Unknown error updating task'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -4,7 +4,10 @@
*/ */
import { updateTasks } from '../../../../scripts/modules/task-manager.js'; import { updateTasks } from '../../../../scripts/modules/task-manager.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { import {
getAnthropicClientForMCP, getAnthropicClientForMCP,
@@ -27,14 +30,16 @@ export async function updateTasksDirect(args, log, context = {}) {
// Check for the common mistake of using 'id' instead of 'from' // Check for the common mistake of using 'id' instead of 'from'
if (args.id !== undefined && args.from === undefined) { if (args.id !== undefined && args.from === undefined) {
const errorMessage = "You specified 'id' parameter but 'update' requires 'from' parameter. Use 'from' for this tool or use 'update_task' tool if you want to update a single task."; const errorMessage =
"You specified 'id' parameter but 'update' requires 'from' parameter. Use 'from' for this tool or use 'update_task' tool if you want to update a single task.";
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
error: { error: {
code: 'PARAMETER_MISMATCH', code: 'PARAMETER_MISMATCH',
message: errorMessage, message: errorMessage,
suggestion: "Use 'from' parameter instead of 'id', or use the 'update_task' tool for single task updates" suggestion:
"Use 'from' parameter instead of 'id', or use the 'update_task' tool for single task updates"
}, },
fromCache: false fromCache: false
}; };
@@ -42,7 +47,8 @@ export async function updateTasksDirect(args, log, context = {}) {
// Check required parameters // Check required parameters
if (!args.from) { if (!args.from) {
const errorMessage = 'No from ID specified. Please provide a task ID to start updating from.'; const errorMessage =
'No from ID specified. Please provide a task ID to start updating from.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -52,7 +58,8 @@ export async function updateTasksDirect(args, log, context = {}) {
} }
if (!args.prompt) { if (!args.prompt) {
const errorMessage = 'No prompt specified. Please provide a prompt with new context for task updates.'; const errorMessage =
'No prompt specified. Please provide a prompt with new context for task updates.';
log.error(errorMessage); log.error(errorMessage);
return { return {
success: false, success: false,
@@ -116,23 +123,19 @@ export async function updateTasksDirect(args, log, context = {}) {
}; };
} }
log.info(`Updating tasks from ID ${fromId} with prompt "${args.prompt}" and research: ${useResearch}`); log.info(
`Updating tasks from ID ${fromId} with prompt "${args.prompt}" and research: ${useResearch}`
);
try { try {
// Enable silent mode to prevent console logs from interfering with JSON response // Enable silent mode to prevent console logs from interfering with JSON response
enableSilentMode(); enableSilentMode();
// Execute core updateTasks function, passing the AI client and session // Execute core updateTasks function, passing the AI client and session
await updateTasks( await updateTasks(tasksPath, fromId, args.prompt, useResearch, {
tasksPath,
fromId,
args.prompt,
useResearch,
{
mcpLog: log, mcpLog: log,
session session
} });
);
// Since updateTasks doesn't return a value but modifies the tasks file, // Since updateTasks doesn't return a value but modifies the tasks file,
// we'll return a success message // we'll return a success message
@@ -150,7 +153,10 @@ export async function updateTasksDirect(args, log, context = {}) {
log.error(`Error updating tasks: ${error.message}`); log.error(`Error updating tasks: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'UPDATE_TASKS_ERROR', message: error.message || 'Unknown error updating tasks' }, error: {
code: 'UPDATE_TASKS_ERROR',
message: error.message || 'Unknown error updating tasks'
},
fromCache: false fromCache: false
}; };
} finally { } finally {
@@ -164,7 +170,10 @@ export async function updateTasksDirect(args, log, context = {}) {
log.error(`Error updating tasks: ${error.message}`); log.error(`Error updating tasks: ${error.message}`);
return { return {
success: false, success: false,
error: { code: 'UPDATE_TASKS_ERROR', message: error.message || 'Unknown error updating tasks' }, error: {
code: 'UPDATE_TASKS_ERROR',
message: error.message || 'Unknown error updating tasks'
},
fromCache: false fromCache: false
}; };
} }

View File

@@ -4,7 +4,10 @@
import { validateDependenciesCommand } from '../../../../scripts/modules/dependency-manager.js'; import { validateDependenciesCommand } from '../../../../scripts/modules/dependency-manager.js';
import { findTasksJsonPath } from '../utils/path-utils.js'; import { findTasksJsonPath } from '../utils/path-utils.js';
import { enableSilentMode, disableSilentMode } from '../../../../scripts/modules/utils.js'; import {
enableSilentMode,
disableSilentMode
} from '../../../../scripts/modules/utils.js';
import fs from 'fs'; import fs from 'fs';
/** /**

View File

@@ -26,10 +26,13 @@ const DEFAULT_MODEL_CONFIG = {
export function getAnthropicClientForMCP(session, log = console) { export function getAnthropicClientForMCP(session, log = console) {
try { try {
// Extract API key from session.env or fall back to environment variables // Extract API key from session.env or fall back to environment variables
const apiKey = session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY; const apiKey =
session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY;
if (!apiKey) { if (!apiKey) {
throw new Error('ANTHROPIC_API_KEY not found in session environment or process.env'); throw new Error(
'ANTHROPIC_API_KEY not found in session environment or process.env'
);
} }
// Initialize and return a new Anthropic client // Initialize and return a new Anthropic client
@@ -55,10 +58,13 @@ export function getAnthropicClientForMCP(session, log = console) {
export async function getPerplexityClientForMCP(session, log = console) { export async function getPerplexityClientForMCP(session, log = console) {
try { try {
// Extract API key from session.env or fall back to environment variables // Extract API key from session.env or fall back to environment variables
const apiKey = session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY; const apiKey =
session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY;
if (!apiKey) { if (!apiKey) {
throw new Error('PERPLEXITY_API_KEY not found in session environment or process.env'); throw new Error(
'PERPLEXITY_API_KEY not found in session environment or process.env'
);
} }
// Dynamically import OpenAI (it may not be used in all contexts) // Dynamically import OpenAI (it may not be used in all contexts)
@@ -100,13 +106,19 @@ export function getModelConfig(session, defaults = DEFAULT_MODEL_CONFIG) {
* @returns {Promise<Object>} Selected model info with type and client * @returns {Promise<Object>} Selected model info with type and client
* @throws {Error} If no AI models are available * @throws {Error} If no AI models are available
*/ */
export async function getBestAvailableAIModel(session, options = {}, log = console) { export async function getBestAvailableAIModel(
session,
options = {},
log = console
) {
const { requiresResearch = false, claudeOverloaded = false } = options; const { requiresResearch = false, claudeOverloaded = false } = options;
// Test case: When research is needed but no Perplexity, use Claude // Test case: When research is needed but no Perplexity, use Claude
if (requiresResearch && if (
requiresResearch &&
!(session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY) && !(session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY) &&
(session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)) { (session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)
) {
try { try {
log.warn('Perplexity not available for research, using Claude'); log.warn('Perplexity not available for research, using Claude');
const client = getAnthropicClientForMCP(session, log); const client = getAnthropicClientForMCP(session, log);
@@ -118,7 +130,10 @@ export async function getBestAvailableAIModel(session, options = {}, log = conso
} }
// Regular path: Perplexity for research when available // Regular path: Perplexity for research when available
if (requiresResearch && (session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY)) { if (
requiresResearch &&
(session?.env?.PERPLEXITY_API_KEY || process.env.PERPLEXITY_API_KEY)
) {
try { try {
const client = await getPerplexityClientForMCP(session, log); const client = await getPerplexityClientForMCP(session, log);
return { type: 'perplexity', client }; return { type: 'perplexity', client };
@@ -129,19 +144,29 @@ export async function getBestAvailableAIModel(session, options = {}, log = conso
} }
// Test case: Claude for overloaded scenario // Test case: Claude for overloaded scenario
if (claudeOverloaded && (session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)) { if (
claudeOverloaded &&
(session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)
) {
try { try {
log.warn('Claude is overloaded but no alternatives are available. Proceeding with Claude anyway.'); log.warn(
'Claude is overloaded but no alternatives are available. Proceeding with Claude anyway.'
);
const client = getAnthropicClientForMCP(session, log); const client = getAnthropicClientForMCP(session, log);
return { type: 'claude', client }; return { type: 'claude', client };
} catch (error) { } catch (error) {
log.error(`Claude not available despite being overloaded: ${error.message}`); log.error(
`Claude not available despite being overloaded: ${error.message}`
);
throw new Error('No AI models available'); throw new Error('No AI models available');
} }
} }
// Default case: Use Claude when available and not overloaded // Default case: Use Claude when available and not overloaded
if (!claudeOverloaded && (session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)) { if (
!claudeOverloaded &&
(session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY)
) {
try { try {
const client = getAnthropicClientForMCP(session, log); const client = getAnthropicClientForMCP(session, log);
return { type: 'claude', client }; return { type: 'claude', client };

View File

@@ -33,11 +33,19 @@ class AsyncOperationManager {
this.log(operationId, 'info', `Operation added.`); this.log(operationId, 'info', `Operation added.`);
// Start execution in the background (don't await here) // Start execution in the background (don't await here)
this._runOperation(operationId, operationFn, args, context).catch(err => { this._runOperation(operationId, operationFn, args, context).catch((err) => {
// Catch unexpected errors during the async execution setup itself // Catch unexpected errors during the async execution setup itself
this.log(operationId, 'error', `Critical error starting operation: ${err.message}`, { stack: err.stack }); this.log(
operationId,
'error',
`Critical error starting operation: ${err.message}`,
{ stack: err.stack }
);
operation.status = 'failed'; operation.status = 'failed';
operation.error = { code: 'MANAGER_EXECUTION_ERROR', message: err.message }; operation.error = {
code: 'MANAGER_EXECUTION_ERROR',
message: err.message
};
operation.endTime = Date.now(); operation.endTime = Date.now();
// Move to completed operations // Move to completed operations
@@ -67,7 +75,8 @@ class AsyncOperationManager {
// The direct function needs to be adapted if it needs reportProgress // The direct function needs to be adapted if it needs reportProgress
// We pass the original context's log, plus our wrapped reportProgress // We pass the original context's log, plus our wrapped reportProgress
const result = await operationFn(args, operation.log, { const result = await operationFn(args, operation.log, {
reportProgress: (progress) => this._handleProgress(operationId, progress), reportProgress: (progress) =>
this._handleProgress(operationId, progress),
mcpLog: operation.log, // Pass log as mcpLog if direct fn expects it mcpLog: operation.log, // Pass log as mcpLog if direct fn expects it
session: operation.session session: operation.session
}); });
@@ -75,15 +84,31 @@ class AsyncOperationManager {
operation.status = result.success ? 'completed' : 'failed'; operation.status = result.success ? 'completed' : 'failed';
operation.result = result.success ? result.data : null; operation.result = result.success ? result.data : null;
operation.error = result.success ? null : result.error; operation.error = result.success ? null : result.error;
this.log(operationId, 'info', `Operation finished with status: ${operation.status}`); this.log(
operationId,
'info',
`Operation finished with status: ${operation.status}`
);
} catch (error) { } catch (error) {
this.log(operationId, 'error', `Operation failed with error: ${error.message}`, { stack: error.stack }); this.log(
operationId,
'error',
`Operation failed with error: ${error.message}`,
{ stack: error.stack }
);
operation.status = 'failed'; operation.status = 'failed';
operation.error = { code: 'OPERATION_EXECUTION_ERROR', message: error.message }; operation.error = {
code: 'OPERATION_EXECUTION_ERROR',
message: error.message
};
} finally { } finally {
operation.endTime = Date.now(); operation.endTime = Date.now();
this.emit('statusChanged', { operationId, status: operation.status, result: operation.result, error: operation.error }); this.emit('statusChanged', {
operationId,
status: operation.status,
result: operation.result,
error: operation.error
});
// Move to completed operations if done or failed // Move to completed operations if done or failed
if (operation.status === 'completed' || operation.status === 'failed') { if (operation.status === 'completed' || operation.status === 'failed') {
@@ -108,7 +133,7 @@ class AsyncOperationManager {
startTime: operation.startTime, startTime: operation.startTime,
endTime: operation.endTime, endTime: operation.endTime,
result: operation.result, result: operation.result,
error: operation.error, error: operation.error
}; };
this.completedOperations.set(operationId, completedData); this.completedOperations.set(operationId, completedData);
@@ -117,8 +142,9 @@ class AsyncOperationManager {
// Trim completed operations if exceeding maximum // Trim completed operations if exceeding maximum
if (this.completedOperations.size > this.maxCompletedOperations) { if (this.completedOperations.size > this.maxCompletedOperations) {
// Get the oldest operation (sorted by endTime) // Get the oldest operation (sorted by endTime)
const oldest = [...this.completedOperations.entries()] const oldest = [...this.completedOperations.entries()].sort(
.sort((a, b) => a[1].endTime - b[1].endTime)[0]; (a, b) => a[1].endTime - b[1].endTime
)[0];
if (oldest) { if (oldest) {
this.completedOperations.delete(oldest[0]); this.completedOperations.delete(oldest[0]);
@@ -137,9 +163,17 @@ class AsyncOperationManager {
try { try {
// Use the reportProgress function captured from the original context // Use the reportProgress function captured from the original context
operation.reportProgress(progress); operation.reportProgress(progress);
this.log(operationId, 'debug', `Reported progress: ${JSON.stringify(progress)}`); this.log(
} catch(err) { operationId,
this.log(operationId, 'warn', `Failed to report progress: ${err.message}`); 'debug',
`Reported progress: ${JSON.stringify(progress)}`
);
} catch (err) {
this.log(
operationId,
'warn',
`Failed to report progress: ${err.message}`
);
// Don't stop the operation, just log the reporting failure // Don't stop the operation, just log the reporting failure
} }
} }
@@ -160,7 +194,7 @@ class AsyncOperationManager {
startTime: operation.startTime, startTime: operation.startTime,
endTime: operation.endTime, endTime: operation.endTime,
result: operation.result, result: operation.result,
error: operation.error, error: operation.error
}; };
} }
@@ -205,7 +239,7 @@ class AsyncOperationManager {
emit(eventName, data) { emit(eventName, data) {
if (this.listeners.has(eventName)) { if (this.listeners.has(eventName)) {
this.listeners.get(eventName).forEach(listener => listener(data)); this.listeners.get(eventName).forEach((listener) => listener(data));
} }
} }
} }

View File

@@ -6,7 +6,11 @@
* @returns {Promise<any>} The result of the actionFn. * @returns {Promise<any>} The result of the actionFn.
*/ */
export async function withSessionEnv(sessionEnv, actionFn) { export async function withSessionEnv(sessionEnv, actionFn) {
if (!sessionEnv || typeof sessionEnv !== 'object' || Object.keys(sessionEnv).length === 0) { if (
!sessionEnv ||
typeof sessionEnv !== 'object' ||
Object.keys(sessionEnv).length === 0
) {
// If no sessionEnv is provided, just run the action directly // If no sessionEnv is provided, just run the action directly
return await actionFn(); return await actionFn();
} }
@@ -40,4 +44,4 @@ export async function withSessionEnv(sessionEnv, actionFn) {
} }
} }
} }
} }

View File

@@ -100,7 +100,10 @@ export function findTasksJsonPath(args, log) {
projectRoot, projectRoot,
currentDir: process.cwd(), currentDir: process.cwd(),
serverDir: path.dirname(process.argv[1]), serverDir: path.dirname(process.argv[1]),
possibleProjectRoot: path.resolve(path.dirname(process.argv[1]), '../..'), possibleProjectRoot: path.resolve(
path.dirname(process.argv[1]),
'../..'
),
lastFoundProjectRoot, lastFoundProjectRoot,
searchedPaths: error.message searchedPaths: error.message
}; };
@@ -117,17 +120,25 @@ export function findTasksJsonPath(args, log) {
log.info(`Trying last known project root: ${lastFoundProjectRoot}`); log.info(`Trying last known project root: ${lastFoundProjectRoot}`);
try { try {
// Use the cached root // Use the cached root
const tasksPath = findTasksJsonInDirectory(lastFoundProjectRoot, args.file, log); const tasksPath = findTasksJsonInDirectory(
lastFoundProjectRoot,
args.file,
log
);
return tasksPath; // Return if found in cached root return tasksPath; // Return if found in cached root
} catch (error) { } catch (error) {
log.info(`Task file not found in last known project root, continuing search.`); log.info(
`Task file not found in last known project root, continuing search.`
);
// Continue with search if not found in cache // Continue with search if not found in cache
} }
} }
// 3. Start search from current directory (most common CLI scenario) // 3. Start search from current directory (most common CLI scenario)
const startDir = process.cwd(); const startDir = process.cwd();
log.info(`Searching for tasks.json starting from current directory: ${startDir}`); log.info(
`Searching for tasks.json starting from current directory: ${startDir}`
);
// Try to find tasks.json by walking up the directory tree from cwd // Try to find tasks.json by walking up the directory tree from cwd
try { try {
@@ -146,7 +157,7 @@ export function findTasksJsonPath(args, log) {
* @returns {boolean} - True if the directory contains any project markers * @returns {boolean} - True if the directory contains any project markers
*/ */
function hasProjectMarkers(dirPath) { function hasProjectMarkers(dirPath) {
return PROJECT_MARKERS.some(marker => { return PROJECT_MARKERS.some((marker) => {
const markerPath = path.join(dirPath, marker); const markerPath = path.join(dirPath, marker);
// Check if the marker exists as either a file or directory // Check if the marker exists as either a file or directory
return fs.existsSync(markerPath); return fs.existsSync(markerPath);
@@ -192,7 +203,9 @@ function findTasksJsonInDirectory(dirPath, explicitFilePath, log) {
} }
// If no file was found, throw an error // If no file was found, throw an error
const error = new Error(`Tasks file not found in any of the expected locations relative to ${dirPath}: ${possiblePaths.join(', ')}`); const error = new Error(
`Tasks file not found in any of the expected locations relative to ${dirPath}: ${possiblePaths.join(', ')}`
);
error.code = 'TASKS_FILE_NOT_FOUND'; error.code = 'TASKS_FILE_NOT_FOUND';
throw error; throw error;
} }
@@ -230,13 +243,17 @@ function findTasksJsonWithParentSearch(startDir, explicitFilePath, log) {
break; break;
} }
log.info(`Tasks file not found in ${currentDir}, searching in parent directory: ${parentDir}`); log.info(
`Tasks file not found in ${currentDir}, searching in parent directory: ${parentDir}`
);
currentDir = parentDir; currentDir = parentDir;
} }
} }
// If we've searched all the way to the root and found nothing // If we've searched all the way to the root and found nothing
const error = new Error(`Tasks file not found in ${startDir} or any parent directory.`); const error = new Error(
`Tasks file not found in ${startDir} or any parent directory.`
);
error.code = 'TASKS_FILE_NOT_FOUND'; error.code = 'TASKS_FILE_NOT_FOUND';
throw error; throw error;
} }
@@ -262,7 +279,11 @@ function findTasksWithNpmConsideration(startDir, log) {
try { try {
// Check standard locations in home dir // Check standard locations in home dir
return findTasksJsonInDirectory(path.join(homeDir, '.task-master'), null, log); return findTasksJsonInDirectory(
path.join(homeDir, '.task-master'),
null,
log
);
} catch (thirdError) { } catch (thirdError) {
// If all approaches fail, throw the original error // If all approaches fail, throw the original error
throw error; throw error;

View File

@@ -1,10 +1,10 @@
import { FastMCP } from "fastmcp"; import { FastMCP } from 'fastmcp';
import path from "path"; import path from 'path';
import dotenv from "dotenv"; import dotenv from 'dotenv';
import { fileURLToPath } from "url"; import { fileURLToPath } from 'url';
import fs from "fs"; import fs from 'fs';
import logger from "./logger.js"; import logger from './logger.js';
import { registerTaskMasterTools } from "./tools/index.js"; import { registerTaskMasterTools } from './tools/index.js';
import { asyncOperationManager } from './core/utils/async-manager.js'; import { asyncOperationManager } from './core/utils/async-manager.js';
// Load environment variables // Load environment variables
@@ -20,12 +20,12 @@ const __dirname = path.dirname(__filename);
class TaskMasterMCPServer { class TaskMasterMCPServer {
constructor() { constructor() {
// Get version from package.json using synchronous fs // Get version from package.json using synchronous fs
const packagePath = path.join(__dirname, "../../package.json"); const packagePath = path.join(__dirname, '../../package.json');
const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8")); const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
this.options = { this.options = {
name: "Task Master MCP Server", name: 'Task Master MCP Server',
version: packageJson.version, version: packageJson.version
}; };
this.server = new FastMCP(this.options); this.server = new FastMCP(this.options);
@@ -71,7 +71,7 @@ class TaskMasterMCPServer {
// Start the FastMCP server with increased timeout // Start the FastMCP server with increased timeout
await this.server.start({ await this.server.start({
transportType: "stdio", transportType: 'stdio',
timeout: 120000 // 2 minutes timeout (in milliseconds) timeout: 120000 // 2 minutes timeout (in milliseconds)
}); });

View File

@@ -1,5 +1,5 @@
import chalk from "chalk"; import chalk from 'chalk';
import { isSilentMode } from "../../scripts/modules/utils.js"; import { isSilentMode } from '../../scripts/modules/utils.js';
// Define log levels // Define log levels
const LOG_LEVELS = { const LOG_LEVELS = {
@@ -7,12 +7,12 @@ const LOG_LEVELS = {
info: 1, info: 1,
warn: 2, warn: 2,
error: 3, error: 3,
success: 4, success: 4
}; };
// Get log level from environment or default to info // Get log level from environment or default to info
const LOG_LEVEL = process.env.LOG_LEVEL const LOG_LEVEL = process.env.LOG_LEVEL
? LOG_LEVELS[process.env.LOG_LEVEL.toLowerCase()] ?? LOG_LEVELS.info ? (LOG_LEVELS[process.env.LOG_LEVEL.toLowerCase()] ?? LOG_LEVELS.info)
: LOG_LEVELS.info; : LOG_LEVELS.info;
/** /**
@@ -28,40 +28,50 @@ function log(level, ...args) {
// Use text prefixes instead of emojis // Use text prefixes instead of emojis
const prefixes = { const prefixes = {
debug: chalk.gray("[DEBUG]"), debug: chalk.gray('[DEBUG]'),
info: chalk.blue("[INFO]"), info: chalk.blue('[INFO]'),
warn: chalk.yellow("[WARN]"), warn: chalk.yellow('[WARN]'),
error: chalk.red("[ERROR]"), error: chalk.red('[ERROR]'),
success: chalk.green("[SUCCESS]"), success: chalk.green('[SUCCESS]')
}; };
if (LOG_LEVELS[level] !== undefined && LOG_LEVELS[level] >= LOG_LEVEL) { if (LOG_LEVELS[level] !== undefined && LOG_LEVELS[level] >= LOG_LEVEL) {
const prefix = prefixes[level] || ""; const prefix = prefixes[level] || '';
let coloredArgs = args; let coloredArgs = args;
try { try {
switch(level) { switch (level) {
case "error": case 'error':
coloredArgs = args.map(arg => typeof arg === 'string' ? chalk.red(arg) : arg); coloredArgs = args.map((arg) =>
typeof arg === 'string' ? chalk.red(arg) : arg
);
break; break;
case "warn": case 'warn':
coloredArgs = args.map(arg => typeof arg === 'string' ? chalk.yellow(arg) : arg); coloredArgs = args.map((arg) =>
typeof arg === 'string' ? chalk.yellow(arg) : arg
);
break; break;
case "success": case 'success':
coloredArgs = args.map(arg => typeof arg === 'string' ? chalk.green(arg) : arg); coloredArgs = args.map((arg) =>
typeof arg === 'string' ? chalk.green(arg) : arg
);
break; break;
case "info": case 'info':
coloredArgs = args.map(arg => typeof arg === 'string' ? chalk.blue(arg) : arg); coloredArgs = args.map((arg) =>
typeof arg === 'string' ? chalk.blue(arg) : arg
);
break; break;
case "debug": case 'debug':
coloredArgs = args.map(arg => typeof arg === 'string' ? chalk.gray(arg) : arg); coloredArgs = args.map((arg) =>
typeof arg === 'string' ? chalk.gray(arg) : arg
);
break; break;
// default: use original args (no color) // default: use original args (no color)
} }
} catch (colorError) { } catch (colorError) {
// Fallback if chalk fails on an argument // Fallback if chalk fails on an argument
// Use console.error here for internal logger errors, separate from normal logging // Use console.error here for internal logger errors, separate from normal logging
console.error("Internal Logger Error applying chalk color:", colorError); console.error('Internal Logger Error applying chalk color:', colorError);
coloredArgs = args; coloredArgs = args;
} }
@@ -78,15 +88,18 @@ function log(level, ...args) {
* @returns {Object} Logger object with info, error, debug, warn, and success methods * @returns {Object} Logger object with info, error, debug, warn, and success methods
*/ */
export function createLogger() { export function createLogger() {
const createLogMethod = (level) => (...args) => log(level, ...args); const createLogMethod =
(level) =>
(...args) =>
log(level, ...args);
return { return {
debug: createLogMethod("debug"), debug: createLogMethod('debug'),
info: createLogMethod("info"), info: createLogMethod('info'),
warn: createLogMethod("warn"), warn: createLogMethod('warn'),
error: createLogMethod("error"), error: createLogMethod('error'),
success: createLogMethod("success"), success: createLogMethod('success'),
log: log, // Also expose the raw log function log: log // Also expose the raw log function
}; };
} }

View File

@@ -3,13 +3,13 @@
* Tool for adding a dependency to a task * Tool for adding a dependency to a task
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { addDependencyDirect } from "../core/task-master-core.js"; import { addDependencyDirect } from '../core/task-master-core.js';
/** /**
* Register the addDependency tool with the MCP server * Register the addDependency tool with the MCP server
@@ -17,17 +17,29 @@ import { addDependencyDirect } from "../core/task-master-core.js";
*/ */
export function registerAddDependencyTool(server) { export function registerAddDependencyTool(server) {
server.addTool({ server.addTool({
name: "add_dependency", name: 'add_dependency',
description: "Add a dependency relationship between two tasks", description: 'Add a dependency relationship between two tasks',
parameters: z.object({ parameters: z.object({
id: z.string().describe("ID of task that will depend on another task"), id: z.string().describe('ID of task that will depend on another task'),
dependsOn: z.string().describe("ID of task that will become a dependency"), dependsOn: z
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), .string()
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") .describe('ID of task that will become a dependency'),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
log.info(`Adding dependency for task ${args.id} to depend on ${args.dependsOn}`); log.info(
`Adding dependency for task ${args.id} to depend on ${args.dependsOn}`
);
reportProgress({ progress: 0 }); reportProgress({ progress: 0 });
// Get project root using the utility function // Get project root using the utility function
@@ -40,10 +52,14 @@ export function registerAddDependencyTool(server) {
} }
// Call the direct function with the resolved rootFolder // Call the direct function with the resolved rootFolder
const result = await addDependencyDirect({ const result = await addDependencyDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { reportProgress, mcpLog: log, session}); },
log,
{ reportProgress, mcpLog: log, session }
);
reportProgress({ progress: 100 }); reportProgress({ progress: 100 });
@@ -60,6 +76,6 @@ export function registerAddDependencyTool(server) {
log.error(`Error in addDependency tool: ${error.message}`); log.error(`Error in addDependency tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for adding subtasks to existing tasks * Tool for adding subtasks to existing tasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { addSubtaskDirect } from "../core/task-master-core.js"; import { addSubtaskDirect } from '../core/task-master-core.js';
/** /**
* Register the addSubtask tool with the MCP server * Register the addSubtask tool with the MCP server
@@ -17,19 +17,48 @@ import { addSubtaskDirect } from "../core/task-master-core.js";
*/ */
export function registerAddSubtaskTool(server) { export function registerAddSubtaskTool(server) {
server.addTool({ server.addTool({
name: "add_subtask", name: 'add_subtask',
description: "Add a subtask to an existing task", description: 'Add a subtask to an existing task',
parameters: z.object({ parameters: z.object({
id: z.string().describe("Parent task ID (required)"), id: z.string().describe('Parent task ID (required)'),
taskId: z.string().optional().describe("Existing task ID to convert to subtask"), taskId: z
title: z.string().optional().describe("Title for the new subtask (when creating a new subtask)"), .string()
description: z.string().optional().describe("Description for the new subtask"), .optional()
details: z.string().optional().describe("Implementation details for the new subtask"), .describe('Existing task ID to convert to subtask'),
status: z.string().optional().describe("Status for the new subtask (default: 'pending')"), title: z
dependencies: z.string().optional().describe("Comma-separated list of dependency IDs for the new subtask"), .string()
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), .optional()
skipGenerate: z.boolean().optional().describe("Skip regenerating task files"), .describe('Title for the new subtask (when creating a new subtask)'),
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") description: z
.string()
.optional()
.describe('Description for the new subtask'),
details: z
.string()
.optional()
.describe('Implementation details for the new subtask'),
status: z
.string()
.optional()
.describe("Status for the new subtask (default: 'pending')"),
dependencies: z
.string()
.optional()
.describe('Comma-separated list of dependency IDs for the new subtask'),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
skipGenerate: z
.boolean()
.optional()
.describe('Skip regenerating task files'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -42,10 +71,14 @@ export function registerAddSubtaskTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await addSubtaskDirect({ const result = await addSubtaskDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { reportProgress, mcpLog: log, session}); },
log,
{ reportProgress, mcpLog: log, session }
);
if (result.success) { if (result.success) {
log.info(`Subtask added successfully: ${result.data.message}`); log.info(`Subtask added successfully: ${result.data.message}`);
@@ -58,6 +91,6 @@ export function registerAddSubtaskTool(server) {
log.error(`Error in addSubtask tool: ${error.message}`); log.error(`Error in addSubtask tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,15 +3,15 @@
* Tool to add a new task using AI * Tool to add a new task using AI
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
createErrorResponse, createErrorResponse,
createContentResponse, createContentResponse,
getProjectRootFromSession, getProjectRootFromSession,
executeTaskMasterCommand, executeTaskMasterCommand,
handleApiResult handleApiResult
} from "./utils.js"; } from './utils.js';
import { addTaskDirect } from "../core/task-master-core.js"; import { addTaskDirect } from '../core/task-master-core.js';
/** /**
* Register the addTask tool with the MCP server * Register the addTask tool with the MCP server
@@ -19,15 +19,27 @@ import { addTaskDirect } from "../core/task-master-core.js";
*/ */
export function registerAddTaskTool(server) { export function registerAddTaskTool(server) {
server.addTool({ server.addTool({
name: "add_task", name: 'add_task',
description: "Add a new task using AI", description: 'Add a new task using AI',
parameters: z.object({ parameters: z.object({
prompt: z.string().describe("Description of the task to add"), prompt: z.string().describe('Description of the task to add'),
dependencies: z.string().optional().describe("Comma-separated list of task IDs this task depends on"), dependencies: z
priority: z.string().optional().describe("Task priority (high, medium, low)"), .string()
file: z.string().optional().describe("Path to the tasks file"), .optional()
projectRoot: z.string().optional().describe("Root directory of the project"), .describe('Comma-separated list of task IDs this task depends on'),
research: z.boolean().optional().describe("Whether to use research capabilities for task creation") priority: z
.string()
.optional()
.describe('Task priority (high, medium, low)'),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z
.string()
.optional()
.describe('Root directory of the project'),
research: z
.boolean()
.optional()
.describe('Whether to use research capabilities for task creation')
}), }),
execute: async (args, { log, reportProgress, session }) => { execute: async (args, { log, reportProgress, session }) => {
try { try {
@@ -42,10 +54,14 @@ export function registerAddTaskTool(server) {
} }
// Call the direct function // Call the direct function
const result = await addTaskDirect({ const result = await addTaskDirect(
{
...args, ...args,
projectRoot: rootFolder projectRoot: rootFolder
}, log, { reportProgress, session }); },
log,
{ reportProgress, session }
);
// Return the result // Return the result
return handleApiResult(result, log); return handleApiResult(result, log);

View File

@@ -3,13 +3,13 @@
* Tool for analyzing task complexity and generating recommendations * Tool for analyzing task complexity and generating recommendations
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { analyzeTaskComplexityDirect } from "../core/task-master-core.js"; import { analyzeTaskComplexityDirect } from '../core/task-master-core.js';
/** /**
* Register the analyze tool with the MCP server * Register the analyze tool with the MCP server
@@ -17,19 +17,48 @@ import { analyzeTaskComplexityDirect } from "../core/task-master-core.js";
*/ */
export function registerAnalyzeTool(server) { export function registerAnalyzeTool(server) {
server.addTool({ server.addTool({
name: "analyze_project_complexity", name: 'analyze_project_complexity',
description: "Analyze task complexity and generate expansion recommendations", description:
'Analyze task complexity and generate expansion recommendations',
parameters: z.object({ parameters: z.object({
output: z.string().optional().describe("Output file path for the report (default: scripts/task-complexity-report.json)"), output: z
model: z.string().optional().describe("LLM model to use for analysis (defaults to configured model)"), .string()
threshold: z.union([z.number(), z.string()]).optional().describe("Minimum complexity score to recommend expansion (1-10) (default: 5)"), .optional()
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), .describe(
research: z.boolean().optional().describe("Use Perplexity AI for research-backed complexity analysis"), 'Output file path for the report (default: scripts/task-complexity-report.json)'
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") ),
model: z
.string()
.optional()
.describe(
'LLM model to use for analysis (defaults to configured model)'
),
threshold: z
.union([z.number(), z.string()])
.optional()
.describe(
'Minimum complexity score to recommend expansion (1-10) (default: 5)'
),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
research: z
.boolean()
.optional()
.describe('Use Perplexity AI for research-backed complexity analysis'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
log.info(`Analyzing task complexity with args: ${JSON.stringify(args)}`); log.info(
`Analyzing task complexity with args: ${JSON.stringify(args)}`
);
let rootFolder = getProjectRootFromSession(session, log); let rootFolder = getProjectRootFromSession(session, log);
@@ -38,16 +67,24 @@ export function registerAnalyzeTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await analyzeTaskComplexityDirect({ const result = await analyzeTaskComplexityDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Task complexity analysis complete: ${result.data.message}`); log.info(`Task complexity analysis complete: ${result.data.message}`);
log.info(`Report summary: ${JSON.stringify(result.data.reportSummary)}`); log.info(
`Report summary: ${JSON.stringify(result.data.reportSummary)}`
);
} else { } else {
log.error(`Failed to analyze task complexity: ${result.error.message}`); log.error(
`Failed to analyze task complexity: ${result.error.message}`
);
} }
return handleApiResult(result, log, 'Error analyzing task complexity'); return handleApiResult(result, log, 'Error analyzing task complexity');
@@ -55,6 +92,6 @@ export function registerAnalyzeTool(server) {
log.error(`Error in analyze tool: ${error.message}`); log.error(`Error in analyze tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for clearing subtasks from parent tasks * Tool for clearing subtasks from parent tasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { clearSubtasksDirect } from "../core/task-master-core.js"; import { clearSubtasksDirect } from '../core/task-master-core.js';
/** /**
* Register the clearSubtasks tool with the MCP server * Register the clearSubtasks tool with the MCP server
@@ -17,16 +17,29 @@ import { clearSubtasksDirect } from "../core/task-master-core.js";
*/ */
export function registerClearSubtasksTool(server) { export function registerClearSubtasksTool(server) {
server.addTool({ server.addTool({
name: "clear_subtasks", name: 'clear_subtasks',
description: "Clear subtasks from specified tasks", description: 'Clear subtasks from specified tasks',
parameters: z.object({ parameters: z
id: z.string().optional().describe("Task IDs (comma-separated) to clear subtasks from"), .object({
all: z.boolean().optional().describe("Clear subtasks from all tasks"), id: z
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), .string()
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") .optional()
}).refine(data => data.id || data.all, { .describe('Task IDs (comma-separated) to clear subtasks from'),
all: z.boolean().optional().describe('Clear subtasks from all tasks'),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
})
.refine((data) => data.id || data.all, {
message: "Either 'id' or 'all' parameter must be provided", message: "Either 'id' or 'all' parameter must be provided",
path: ["id", "all"] path: ['id', 'all']
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -40,10 +53,14 @@ export function registerClearSubtasksTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await clearSubtasksDirect({ const result = await clearSubtasksDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { reportProgress, mcpLog: log, session}); },
log,
{ reportProgress, mcpLog: log, session }
);
reportProgress({ progress: 100 }); reportProgress({ progress: 100 });
@@ -58,6 +75,6 @@ export function registerClearSubtasksTool(server) {
log.error(`Error in clearSubtasks tool: ${error.message}`); log.error(`Error in clearSubtasks tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for displaying the complexity analysis report * Tool for displaying the complexity analysis report
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { complexityReportDirect } from "../core/task-master-core.js"; import { complexityReportDirect } from '../core/task-master-core.js';
/** /**
* Register the complexityReport tool with the MCP server * Register the complexityReport tool with the MCP server
@@ -17,15 +17,27 @@ import { complexityReportDirect } from "../core/task-master-core.js";
*/ */
export function registerComplexityReportTool(server) { export function registerComplexityReportTool(server) {
server.addTool({ server.addTool({
name: "complexity_report", name: 'complexity_report',
description: "Display the complexity analysis report in a readable format", description: 'Display the complexity analysis report in a readable format',
parameters: z.object({ parameters: z.object({
file: z.string().optional().describe("Path to the report file (default: scripts/task-complexity-report.json)"), file: z
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") .string()
.optional()
.describe(
'Path to the report file (default: scripts/task-complexity-report.json)'
),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
log.info(`Getting complexity report with args: ${JSON.stringify(args)}`); log.info(
`Getting complexity report with args: ${JSON.stringify(args)}`
);
// await reportProgress({ progress: 0 }); // await reportProgress({ progress: 0 });
let rootFolder = getProjectRootFromSession(session, log); let rootFolder = getProjectRootFromSession(session, log);
@@ -35,24 +47,37 @@ export function registerComplexityReportTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await complexityReportDirect({ const result = await complexityReportDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });
if (result.success) { if (result.success) {
log.info(`Successfully retrieved complexity report${result.fromCache ? ' (from cache)' : ''}`); log.info(
`Successfully retrieved complexity report${result.fromCache ? ' (from cache)' : ''}`
);
} else { } else {
log.error(`Failed to retrieve complexity report: ${result.error.message}`); log.error(
`Failed to retrieve complexity report: ${result.error.message}`
);
} }
return handleApiResult(result, log, 'Error retrieving complexity report'); return handleApiResult(
result,
log,
'Error retrieving complexity report'
);
} catch (error) { } catch (error) {
log.error(`Error in complexity-report tool: ${error.message}`); log.error(`Error in complexity-report tool: ${error.message}`);
return createErrorResponse(`Failed to retrieve complexity report: ${error.message}`); return createErrorResponse(
`Failed to retrieve complexity report: ${error.message}`
);
}
} }
},
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for expanding all pending tasks with subtasks * Tool for expanding all pending tasks with subtasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { expandAllTasksDirect } from "../core/task-master-core.js"; import { expandAllTasksDirect } from '../core/task-master-core.js';
/** /**
* Register the expandAll tool with the MCP server * Register the expandAll tool with the MCP server
@@ -17,15 +17,39 @@ import { expandAllTasksDirect } from "../core/task-master-core.js";
*/ */
export function registerExpandAllTool(server) { export function registerExpandAllTool(server) {
server.addTool({ server.addTool({
name: "expand_all", name: 'expand_all',
description: "Expand all pending tasks into subtasks", description: 'Expand all pending tasks into subtasks',
parameters: z.object({ parameters: z.object({
num: z.string().optional().describe("Number of subtasks to generate for each task"), num: z
research: z.boolean().optional().describe("Enable Perplexity AI for research-backed subtask generation"), .string()
prompt: z.string().optional().describe("Additional context to guide subtask generation"), .optional()
force: z.boolean().optional().describe("Force regeneration of subtasks for tasks that already have them"), .describe('Number of subtasks to generate for each task'),
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), research: z
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") .boolean()
.optional()
.describe(
'Enable Perplexity AI for research-backed subtask generation'
),
prompt: z
.string()
.optional()
.describe('Additional context to guide subtask generation'),
force: z
.boolean()
.optional()
.describe(
'Force regeneration of subtasks for tasks that already have them'
),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -38,15 +62,21 @@ export function registerExpandAllTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await expandAllTasksDirect({ const result = await expandAllTasksDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Successfully expanded all tasks: ${result.data.message}`); log.info(`Successfully expanded all tasks: ${result.data.message}`);
} else { } else {
log.error(`Failed to expand all tasks: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to expand all tasks: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error expanding all tasks'); return handleApiResult(result, log, 'Error expanding all tasks');
@@ -54,6 +84,6 @@ export function registerExpandAllTool(server) {
log.error(`Error in expand-all tool: ${error.message}`); log.error(`Error in expand-all tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,15 +3,15 @@
* Tool to expand a task into subtasks * Tool to expand a task into subtasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { expandTaskDirect } from "../core/task-master-core.js"; import { expandTaskDirect } from '../core/task-master-core.js';
import fs from "fs"; import fs from 'fs';
import path from "path"; import path from 'path';
/** /**
* Register the expand-task tool with the MCP server * Register the expand-task tool with the MCP server
@@ -19,20 +19,29 @@ import path from "path";
*/ */
export function registerExpandTaskTool(server) { export function registerExpandTaskTool(server) {
server.addTool({ server.addTool({
name: "expand_task", name: 'expand_task',
description: "Expand a task into subtasks for detailed implementation", description: 'Expand a task into subtasks for detailed implementation',
parameters: z.object({ parameters: z.object({
id: z.string().describe("ID of task to expand"), id: z.string().describe('ID of task to expand'),
num: z.union([z.string(), z.number()]).optional().describe("Number of subtasks to generate"), num: z
research: z.boolean().optional().describe("Use Perplexity AI for research-backed generation"), .union([z.string(), z.number()])
prompt: z.string().optional().describe("Additional context for subtask generation"), .optional()
file: z.string().optional().describe("Path to the tasks file"), .describe('Number of subtasks to generate'),
research: z
.boolean()
.optional()
.describe('Use Perplexity AI for research-backed generation'),
prompt: z
.string()
.optional()
.describe('Additional context for subtask generation'),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, reportProgress, session }) => { execute: async (args, { log, reportProgress, session }) => {
try { try {
@@ -61,10 +70,14 @@ export function registerExpandTaskTool(server) {
// Call direct function with only session in the context, not reportProgress // Call direct function with only session in the context, not reportProgress
// Use the pattern recommended in the MCP guidelines // Use the pattern recommended in the MCP guidelines
const result = await expandTaskDirect({ const result = await expandTaskDirect(
{
...args, ...args,
projectRoot: rootFolder projectRoot: rootFolder
}, log, { session }); // Only pass session, NOT reportProgress },
log,
{ session }
); // Only pass session, NOT reportProgress
// Return the result // Return the result
return handleApiResult(result, log, 'Error expanding task'); return handleApiResult(result, log, 'Error expanding task');
@@ -72,6 +85,6 @@ export function registerExpandTaskTool(server) {
log.error(`Error in expand task tool: ${error.message}`); log.error(`Error in expand task tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for automatically fixing invalid task dependencies * Tool for automatically fixing invalid task dependencies
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { fixDependenciesDirect } from "../core/task-master-core.js"; import { fixDependenciesDirect } from '../core/task-master-core.js';
/** /**
* Register the fixDependencies tool with the MCP server * Register the fixDependencies tool with the MCP server
@@ -17,11 +17,16 @@ import { fixDependenciesDirect } from "../core/task-master-core.js";
*/ */
export function registerFixDependenciesTool(server) { export function registerFixDependenciesTool(server) {
server.addTool({ server.addTool({
name: "fix_dependencies", name: 'fix_dependencies',
description: "Fix invalid dependencies in tasks automatically", description: 'Fix invalid dependencies in tasks automatically',
parameters: z.object({ parameters: z.object({
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -35,10 +40,14 @@ export function registerFixDependenciesTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await fixDependenciesDirect({ const result = await fixDependenciesDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { reportProgress, mcpLog: log, session}); },
log,
{ reportProgress, mcpLog: log, session }
);
await reportProgress({ progress: 100 }); await reportProgress({ progress: 100 });

View File

@@ -3,13 +3,13 @@
* Tool to generate individual task files from tasks.json * Tool to generate individual task files from tasks.json
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { generateTaskFilesDirect } from "../core/task-master-core.js"; import { generateTaskFilesDirect } from '../core/task-master-core.js';
/** /**
* Register the generate tool with the MCP server * Register the generate tool with the MCP server
@@ -17,17 +17,21 @@ import { generateTaskFilesDirect } from "../core/task-master-core.js";
*/ */
export function registerGenerateTool(server) { export function registerGenerateTool(server) {
server.addTool({ server.addTool({
name: "generate", name: 'generate',
description: "Generates individual task files in tasks/ directory based on tasks.json", description:
'Generates individual task files in tasks/ directory based on tasks.json',
parameters: z.object({ parameters: z.object({
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
output: z.string().optional().describe("Output directory (default: same directory as tasks file)"), output: z
.string()
.optional()
.describe('Output directory (default: same directory as tasks file)'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -41,17 +45,22 @@ export function registerGenerateTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await generateTaskFilesDirect({ const result = await generateTaskFilesDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });
if (result.success) { if (result.success) {
log.info(`Successfully generated task files: ${result.data.message}`); log.info(`Successfully generated task files: ${result.data.message}`);
} else { } else {
log.error(`Failed to generate task files: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to generate task files: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error generating task files'); return handleApiResult(result, log, 'Error generating task files');
@@ -59,6 +68,6 @@ export function registerGenerateTool(server) {
log.error(`Error in generate tool: ${error.message}`); log.error(`Error in generate tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -10,9 +10,10 @@ import { createErrorResponse, createContentResponse } from './utils.js'; // Assu
export function registerGetOperationStatusTool(server, asyncManager) { export function registerGetOperationStatusTool(server, asyncManager) {
server.addTool({ server.addTool({
name: 'get_operation_status', name: 'get_operation_status',
description: 'Retrieves the status and result/error of a background operation.', description:
'Retrieves the status and result/error of a background operation.',
parameters: z.object({ parameters: z.object({
operationId: z.string().describe('The ID of the operation to check.'), operationId: z.string().describe('The ID of the operation to check.')
}), }),
execute: async (args, { log }) => { execute: async (args, { log }) => {
try { try {
@@ -32,11 +33,15 @@ export function registerGetOperationStatusTool(server, asyncManager) {
log.info(`Status for ${operationId}: ${status.status}`); log.info(`Status for ${operationId}: ${status.status}`);
return createContentResponse(status); return createContentResponse(status);
} catch (error) { } catch (error) {
log.error(`Error in get_operation_status tool: ${error.message}`, { stack: error.stack }); log.error(`Error in get_operation_status tool: ${error.message}`, {
return createErrorResponse(`Failed to get operation status: ${error.message}`, 'GET_STATUS_ERROR'); stack: error.stack
});
return createErrorResponse(
`Failed to get operation status: ${error.message}`,
'GET_STATUS_ERROR'
);
}
} }
},
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to get task details by ID * Tool to get task details by ID
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { showTaskDirect } from "../core/task-master-core.js"; import { showTaskDirect } from '../core/task-master-core.js';
/** /**
* Custom processor function that removes allTasks from the response * Custom processor function that removes allTasks from the response
@@ -35,26 +35,30 @@ function processTaskResponse(data) {
*/ */
export function registerShowTaskTool(server) { export function registerShowTaskTool(server) {
server.addTool({ server.addTool({
name: "get_task", name: 'get_task',
description: "Get detailed information about a specific task", description: 'Get detailed information about a specific task',
parameters: z.object({ parameters: z.object({
id: z.string().describe("Task ID to get"), id: z.string().describe('Task ID to get'),
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
// Log the session right at the start of execute // Log the session right at the start of execute
log.info(`Session object received in execute: ${JSON.stringify(session)}`); // Use JSON.stringify for better visibility log.info(
`Session object received in execute: ${JSON.stringify(session)}`
); // Use JSON.stringify for better visibility
try { try {
log.info(`Getting task details for ID: ${args.id}`); log.info(`Getting task details for ID: ${args.id}`);
log.info(`Session object received in execute: ${JSON.stringify(session)}`); // Use JSON.stringify for better visibility log.info(
`Session object received in execute: ${JSON.stringify(session)}`
); // Use JSON.stringify for better visibility
let rootFolder = getProjectRootFromSession(session, log); let rootFolder = getProjectRootFromSession(session, log);
@@ -64,29 +68,41 @@ export function registerShowTaskTool(server) {
} else if (!rootFolder) { } else if (!rootFolder) {
// Ensure we always have *some* root, even if session failed and args didn't provide one // Ensure we always have *some* root, even if session failed and args didn't provide one
rootFolder = process.cwd(); rootFolder = process.cwd();
log.warn(`Session and args failed to provide root, using CWD: ${rootFolder}`); log.warn(
`Session and args failed to provide root, using CWD: ${rootFolder}`
);
} }
log.info(`Attempting to use project root: ${rootFolder}`); // Log the final resolved root log.info(`Attempting to use project root: ${rootFolder}`); // Log the final resolved root
log.info(`Root folder: ${rootFolder}`); // Log the final resolved root log.info(`Root folder: ${rootFolder}`); // Log the final resolved root
const result = await showTaskDirect({ const result = await showTaskDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log); },
log
);
if (result.success) { if (result.success) {
log.info(`Successfully retrieved task details for ID: ${args.id}${result.fromCache ? ' (from cache)' : ''}`); log.info(
`Successfully retrieved task details for ID: ${args.id}${result.fromCache ? ' (from cache)' : ''}`
);
} else { } else {
log.error(`Failed to get task: ${result.error.message}`); log.error(`Failed to get task: ${result.error.message}`);
} }
// Use our custom processor function to remove allTasks from the response // Use our custom processor function to remove allTasks from the response
return handleApiResult(result, log, 'Error retrieving task details', processTaskResponse); return handleApiResult(
result,
log,
'Error retrieving task details',
processTaskResponse
);
} catch (error) { } catch (error) {
log.error(`Error in get-task tool: ${error.message}\n${error.stack}`); // Add stack trace log.error(`Error in get-task tool: ${error.message}\n${error.stack}`); // Add stack trace
return createErrorResponse(`Failed to get task: ${error.message}`); return createErrorResponse(`Failed to get task: ${error.message}`);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to get all tasks from Task Master * Tool to get all tasks from Task Master
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
createErrorResponse, createErrorResponse,
handleApiResult, handleApiResult,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { listTasksDirect } from "../core/task-master-core.js"; import { listTasksDirect } from '../core/task-master-core.js';
/** /**
* Register the getTasks tool with the MCP server * Register the getTasks tool with the MCP server
@@ -17,21 +17,32 @@ import { listTasksDirect } from "../core/task-master-core.js";
*/ */
export function registerListTasksTool(server) { export function registerListTasksTool(server) {
server.addTool({ server.addTool({
name: "get_tasks", name: 'get_tasks',
description: "Get all tasks from Task Master, optionally filtering by status and including subtasks.", description:
'Get all tasks from Task Master, optionally filtering by status and including subtasks.',
parameters: z.object({ parameters: z.object({
status: z.string().optional().describe("Filter tasks by status (e.g., 'pending', 'done')"), status: z
.string()
.optional()
.describe("Filter tasks by status (e.g., 'pending', 'done')"),
withSubtasks: z withSubtasks: z
.boolean() .boolean()
.optional() .optional()
.describe("Include subtasks nested within their parent tasks in the response"), .describe(
file: z.string().optional().describe("Path to the tasks file (relative to project root or absolute)"), 'Include subtasks nested within their parent tasks in the response'
),
file: z
.string()
.optional()
.describe(
'Path to the tasks file (relative to project root or absolute)'
),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: automatically detected from session or CWD)" 'Root directory of the project (default: automatically detected from session or CWD)'
), )
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -45,20 +56,25 @@ export function registerListTasksTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await listTasksDirect({ const result = await listTasksDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });
log.info(`Retrieved ${result.success ? (result.data?.tasks?.length || 0) : 0} tasks${result.fromCache ? ' (from cache)' : ''}`); log.info(
`Retrieved ${result.success ? result.data?.tasks?.length || 0 : 0} tasks${result.fromCache ? ' (from cache)' : ''}`
);
return handleApiResult(result, log, 'Error getting tasks'); return handleApiResult(result, log, 'Error getting tasks');
} catch (error) { } catch (error) {
log.error(`Error getting tasks: ${error.message}`); log.error(`Error getting tasks: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,28 +3,28 @@
* Export all Task Master CLI tools for MCP server * Export all Task Master CLI tools for MCP server
*/ */
import { registerListTasksTool } from "./get-tasks.js"; import { registerListTasksTool } from './get-tasks.js';
import logger from "../logger.js"; import logger from '../logger.js';
import { registerSetTaskStatusTool } from "./set-task-status.js"; import { registerSetTaskStatusTool } from './set-task-status.js';
import { registerParsePRDTool } from "./parse-prd.js"; import { registerParsePRDTool } from './parse-prd.js';
import { registerUpdateTool } from "./update.js"; import { registerUpdateTool } from './update.js';
import { registerUpdateTaskTool } from "./update-task.js"; import { registerUpdateTaskTool } from './update-task.js';
import { registerUpdateSubtaskTool } from "./update-subtask.js"; import { registerUpdateSubtaskTool } from './update-subtask.js';
import { registerGenerateTool } from "./generate.js"; import { registerGenerateTool } from './generate.js';
import { registerShowTaskTool } from "./get-task.js"; import { registerShowTaskTool } from './get-task.js';
import { registerNextTaskTool } from "./next-task.js"; import { registerNextTaskTool } from './next-task.js';
import { registerExpandTaskTool } from "./expand-task.js"; import { registerExpandTaskTool } from './expand-task.js';
import { registerAddTaskTool } from "./add-task.js"; import { registerAddTaskTool } from './add-task.js';
import { registerAddSubtaskTool } from "./add-subtask.js"; import { registerAddSubtaskTool } from './add-subtask.js';
import { registerRemoveSubtaskTool } from "./remove-subtask.js"; import { registerRemoveSubtaskTool } from './remove-subtask.js';
import { registerAnalyzeTool } from "./analyze.js"; import { registerAnalyzeTool } from './analyze.js';
import { registerClearSubtasksTool } from "./clear-subtasks.js"; import { registerClearSubtasksTool } from './clear-subtasks.js';
import { registerExpandAllTool } from "./expand-all.js"; import { registerExpandAllTool } from './expand-all.js';
import { registerRemoveDependencyTool } from "./remove-dependency.js"; import { registerRemoveDependencyTool } from './remove-dependency.js';
import { registerValidateDependenciesTool } from "./validate-dependencies.js"; import { registerValidateDependenciesTool } from './validate-dependencies.js';
import { registerFixDependenciesTool } from "./fix-dependencies.js"; import { registerFixDependenciesTool } from './fix-dependencies.js';
import { registerComplexityReportTool } from "./complexity-report.js"; import { registerComplexityReportTool } from './complexity-report.js';
import { registerAddDependencyTool } from "./add-dependency.js"; import { registerAddDependencyTool } from './add-dependency.js';
import { registerRemoveTaskTool } from './remove-task.js'; import { registerRemoveTaskTool } from './remove-task.js';
import { registerInitializeProjectTool } from './initialize-project.js'; import { registerInitializeProjectTool } from './initialize-project.js';
import { asyncOperationManager } from '../core/utils/async-manager.js'; import { asyncOperationManager } from '../core/utils/async-manager.js';
@@ -69,5 +69,5 @@ export function registerTaskMasterTools(server, asyncManager) {
} }
export default { export default {
registerTaskMasterTools, registerTaskMasterTools
}; };

View File

@@ -1,33 +1,66 @@
import { z } from "zod"; import { z } from 'zod';
import { execSync } from 'child_process'; import { execSync } from 'child_process';
import { createContentResponse, createErrorResponse } from "./utils.js"; // Only need response creators import { createContentResponse, createErrorResponse } from './utils.js'; // Only need response creators
export function registerInitializeProjectTool(server) { export function registerInitializeProjectTool(server) {
server.addTool({ server.addTool({
name: "initialize_project", // snake_case for tool name name: 'initialize_project', // snake_case for tool name
description: "Initializes a new Task Master project structure in the current working directory by running 'task-master init'.", description:
"Initializes a new Task Master project structure in the current working directory by running 'task-master init'.",
parameters: z.object({ parameters: z.object({
projectName: z.string().optional().describe("The name for the new project."), projectName: z
projectDescription: z.string().optional().describe("A brief description for the project."), .string()
projectVersion: z.string().optional().describe("The initial version for the project (e.g., '0.1.0')."), .optional()
.describe('The name for the new project.'),
projectDescription: z
.string()
.optional()
.describe('A brief description for the project.'),
projectVersion: z
.string()
.optional()
.describe("The initial version for the project (e.g., '0.1.0')."),
authorName: z.string().optional().describe("The author's name."), authorName: z.string().optional().describe("The author's name."),
skipInstall: z.boolean().optional().default(false).describe("Skip installing dependencies automatically."), skipInstall: z
addAliases: z.boolean().optional().default(false).describe("Add shell aliases (tm, taskmaster) to shell config file."), .boolean()
yes: z.boolean().optional().default(false).describe("Skip prompts and use default values or provided arguments."), .optional()
.default(false)
.describe('Skip installing dependencies automatically.'),
addAliases: z
.boolean()
.optional()
.default(false)
.describe('Add shell aliases (tm, taskmaster) to shell config file.'),
yes: z
.boolean()
.optional()
.default(false)
.describe('Skip prompts and use default values or provided arguments.')
// projectRoot is not needed here as 'init' works on the current directory // projectRoot is not needed here as 'init' works on the current directory
}), }),
execute: async (args, { log }) => { // Destructure context to get log execute: async (args, { log }) => {
// Destructure context to get log
try { try {
log.info(`Executing initialize_project with args: ${JSON.stringify(args)}`); log.info(
`Executing initialize_project with args: ${JSON.stringify(args)}`
);
// Construct the command arguments carefully // Construct the command arguments carefully
// Using npx ensures it uses the locally installed version if available, or fetches it // Using npx ensures it uses the locally installed version if available, or fetches it
let command = 'npx task-master init'; let command = 'npx task-master init';
const cliArgs = []; const cliArgs = [];
if (args.projectName) cliArgs.push(`--name "${args.projectName.replace(/"/g, '\\"')}"`); // Escape quotes if (args.projectName)
if (args.projectDescription) cliArgs.push(`--description "${args.projectDescription.replace(/"/g, '\\"')}"`); cliArgs.push(`--name "${args.projectName.replace(/"/g, '\\"')}"`); // Escape quotes
if (args.projectVersion) cliArgs.push(`--version "${args.projectVersion.replace(/"/g, '\\"')}"`); if (args.projectDescription)
if (args.authorName) cliArgs.push(`--author "${args.authorName.replace(/"/g, '\\"')}"`); cliArgs.push(
`--description "${args.projectDescription.replace(/"/g, '\\"')}"`
);
if (args.projectVersion)
cliArgs.push(
`--version "${args.projectVersion.replace(/"/g, '\\"')}"`
);
if (args.authorName)
cliArgs.push(`--author "${args.authorName.replace(/"/g, '\\"')}"`);
if (args.skipInstall) cliArgs.push('--skip-install'); if (args.skipInstall) cliArgs.push('--skip-install');
if (args.addAliases) cliArgs.push('--aliases'); if (args.addAliases) cliArgs.push('--aliases');
if (args.yes) cliArgs.push('--yes'); if (args.yes) cliArgs.push('--yes');
@@ -38,20 +71,24 @@ export function registerInitializeProjectTool(server) {
// Execute the command in the current working directory of the server process // Execute the command in the current working directory of the server process
// Capture stdout/stderr. Use a reasonable timeout (e.g., 5 minutes) // Capture stdout/stderr. Use a reasonable timeout (e.g., 5 minutes)
const output = execSync(command, { encoding: 'utf8', stdio: 'pipe', timeout: 300000 }); const output = execSync(command, {
encoding: 'utf8',
stdio: 'pipe',
timeout: 300000
});
log.info(`Initialization output:\n${output}`); log.info(`Initialization output:\n${output}`);
// Return a standard success response manually // Return a standard success response manually
return createContentResponse( return createContentResponse(
"Project initialized successfully.", 'Project initialized successfully.',
{ output: output } // Include output in the data payload { output: output } // Include output in the data payload
); );
} catch (error) { } catch (error) {
// Catch errors from execSync or timeouts // Catch errors from execSync or timeouts
const errorMessage = `Project initialization failed: ${error.message}`; const errorMessage = `Project initialization failed: ${error.message}`;
const errorDetails = error.stderr?.toString() || error.stdout?.toString() || error.message; // Provide stderr/stdout if available const errorDetails =
error.stderr?.toString() || error.stdout?.toString() || error.message; // Provide stderr/stdout if available
log.error(`${errorMessage}\nDetails: ${errorDetails}`); log.error(`${errorMessage}\nDetails: ${errorDetails}`);
// Return a standard error response manually // Return a standard error response manually

View File

@@ -3,13 +3,13 @@
* Tool to find the next task to work on * Tool to find the next task to work on
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { nextTaskDirect } from "../core/task-master-core.js"; import { nextTaskDirect } from '../core/task-master-core.js';
/** /**
* Register the next-task tool with the MCP server * Register the next-task tool with the MCP server
@@ -17,16 +17,17 @@ import { nextTaskDirect } from "../core/task-master-core.js";
*/ */
export function registerNextTaskTool(server) { export function registerNextTaskTool(server) {
server.addTool({ server.addTool({
name: "next_task", name: 'next_task',
description: "Find the next task to work on based on dependencies and status", description:
'Find the next task to work on based on dependencies and status',
parameters: z.object({ parameters: z.object({
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -40,17 +41,24 @@ export function registerNextTaskTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await nextTaskDirect({ const result = await nextTaskDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });
if (result.success) { if (result.success) {
log.info(`Successfully found next task: ${result.data?.task?.id || 'No available tasks'}`); log.info(
`Successfully found next task: ${result.data?.task?.id || 'No available tasks'}`
);
} else { } else {
log.error(`Failed to find next task: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to find next task: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error finding next task'); return handleApiResult(result, log, 'Error finding next task');
@@ -58,6 +66,6 @@ export function registerNextTaskTool(server) {
log.error(`Error in nextTask tool: ${error.message}`); log.error(`Error in nextTask tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to parse PRD document and generate tasks * Tool to parse PRD document and generate tasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { parsePRDDirect } from "../core/task-master-core.js"; import { parsePRDDirect } from '../core/task-master-core.js';
/** /**
* Register the parsePRD tool with the MCP server * Register the parsePRD tool with the MCP server
@@ -17,19 +17,38 @@ import { parsePRDDirect } from "../core/task-master-core.js";
*/ */
export function registerParsePRDTool(server) { export function registerParsePRDTool(server) {
server.addTool({ server.addTool({
name: "parse_prd", name: 'parse_prd',
description: "Parse a Product Requirements Document (PRD) or text file to automatically generate initial tasks.", description:
'Parse a Product Requirements Document (PRD) or text file to automatically generate initial tasks.',
parameters: z.object({ parameters: z.object({
input: z.string().default("tasks/tasks.json").describe("Path to the PRD document file (relative to project root or absolute)"), input: z
numTasks: z.string().optional().describe("Approximate number of top-level tasks to generate (default: 10)"), .string()
output: z.string().optional().describe("Output path for tasks.json file (relative to project root or absolute, default: tasks/tasks.json)"), .default('tasks/tasks.json')
force: z.boolean().optional().describe("Allow overwriting an existing tasks.json file."), .describe(
'Path to the PRD document file (relative to project root or absolute)'
),
numTasks: z
.string()
.optional()
.describe(
'Approximate number of top-level tasks to generate (default: 10)'
),
output: z
.string()
.optional()
.describe(
'Output path for tasks.json file (relative to project root or absolute, default: tasks/tasks.json)'
),
force: z
.boolean()
.optional()
.describe('Allow overwriting an existing tasks.json file.'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: automatically detected from session or CWD)" 'Root directory of the project (default: automatically detected from session or CWD)'
), )
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -42,15 +61,21 @@ export function registerParsePRDTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await parsePRDDirect({ const result = await parsePRDDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Successfully parsed PRD: ${result.data.message}`); log.info(`Successfully parsed PRD: ${result.data.message}`);
} else { } else {
log.error(`Failed to parse PRD: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to parse PRD: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error parsing PRD'); return handleApiResult(result, log, 'Error parsing PRD');
@@ -58,6 +83,6 @@ export function registerParsePRDTool(server) {
log.error(`Error in parse-prd tool: ${error.message}`); log.error(`Error in parse-prd tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool for removing a dependency from a task * Tool for removing a dependency from a task
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { removeDependencyDirect } from "../core/task-master-core.js"; import { removeDependencyDirect } from '../core/task-master-core.js';
/** /**
* Register the removeDependency tool with the MCP server * Register the removeDependency tool with the MCP server
@@ -17,17 +17,27 @@ import { removeDependencyDirect } from "../core/task-master-core.js";
*/ */
export function registerRemoveDependencyTool(server) { export function registerRemoveDependencyTool(server) {
server.addTool({ server.addTool({
name: "remove_dependency", name: 'remove_dependency',
description: "Remove a dependency from a task", description: 'Remove a dependency from a task',
parameters: z.object({ parameters: z.object({
id: z.string().describe("Task ID to remove dependency from"), id: z.string().describe('Task ID to remove dependency from'),
dependsOn: z.string().describe("Task ID to remove as a dependency"), dependsOn: z.string().describe('Task ID to remove as a dependency'),
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), file: z
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") .string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
log.info(`Removing dependency for task ${args.id} from ${args.dependsOn} with args: ${JSON.stringify(args)}`); log.info(
`Removing dependency for task ${args.id} from ${args.dependsOn} with args: ${JSON.stringify(args)}`
);
// await reportProgress({ progress: 0 }); // await reportProgress({ progress: 0 });
let rootFolder = getProjectRootFromSession(session, log); let rootFolder = getProjectRootFromSession(session, log);
@@ -37,10 +47,13 @@ export function registerRemoveDependencyTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await removeDependencyDirect({ const result = await removeDependencyDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });

View File

@@ -3,13 +3,13 @@
* Tool for removing subtasks from parent tasks * Tool for removing subtasks from parent tasks
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { removeSubtaskDirect } from "../core/task-master-core.js"; import { removeSubtaskDirect } from '../core/task-master-core.js';
/** /**
* Register the removeSubtask tool with the MCP server * Register the removeSubtask tool with the MCP server
@@ -17,14 +17,34 @@ import { removeSubtaskDirect } from "../core/task-master-core.js";
*/ */
export function registerRemoveSubtaskTool(server) { export function registerRemoveSubtaskTool(server) {
server.addTool({ server.addTool({
name: "remove_subtask", name: 'remove_subtask',
description: "Remove a subtask from its parent task", description: 'Remove a subtask from its parent task',
parameters: z.object({ parameters: z.object({
id: z.string().describe("Subtask ID to remove in format 'parentId.subtaskId' (required)"), id: z
convert: z.boolean().optional().describe("Convert the subtask to a standalone task instead of deleting it"), .string()
file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"), .describe(
skipGenerate: z.boolean().optional().describe("Skip regenerating task files"), "Subtask ID to remove in format 'parentId.subtaskId' (required)"
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") ),
convert: z
.boolean()
.optional()
.describe(
'Convert the subtask to a standalone task instead of deleting it'
),
file: z
.string()
.optional()
.describe('Path to the tasks file (default: tasks/tasks.json)'),
skipGenerate: z
.boolean()
.optional()
.describe('Skip regenerating task files'),
projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -38,10 +58,13 @@ export function registerRemoveSubtaskTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await removeSubtaskDirect({ const result = await removeSubtaskDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log/*, { reportProgress, mcpLog: log, session}*/); },
log /*, { reportProgress, mcpLog: log, session}*/
);
// await reportProgress({ progress: 100 }); // await reportProgress({ progress: 100 });
@@ -56,6 +79,6 @@ export function registerRemoveSubtaskTool(server) {
log.error(`Error in removeSubtask tool: ${error.message}`); log.error(`Error in removeSubtask tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to remove a task by ID * Tool to remove a task by ID
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { removeTaskDirect } from "../core/task-master-core.js"; import { removeTaskDirect } from '../core/task-master-core.js';
/** /**
* Register the remove-task tool with the MCP server * Register the remove-task tool with the MCP server
@@ -17,18 +17,23 @@ import { removeTaskDirect } from "../core/task-master-core.js";
*/ */
export function registerRemoveTaskTool(server) { export function registerRemoveTaskTool(server) {
server.addTool({ server.addTool({
name: "remove_task", name: 'remove_task',
description: "Remove a task or subtask permanently from the tasks list", description: 'Remove a task or subtask permanently from the tasks list',
parameters: z.object({ parameters: z.object({
id: z.string().describe("ID of the task or subtask to remove (e.g., '5' or '5.2')"), id: z
file: z.string().optional().describe("Path to the tasks file"), .string()
.describe("ID of the task or subtask to remove (e.g., '5' or '5.2')"),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), ),
confirm: z.boolean().optional().describe("Whether to skip confirmation prompt (default: false)") confirm: z
.boolean()
.optional()
.describe('Whether to skip confirmation prompt (default: false)')
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -43,17 +48,22 @@ export function registerRemoveTaskTool(server) {
} else if (!rootFolder) { } else if (!rootFolder) {
// Ensure we have a default if nothing else works // Ensure we have a default if nothing else works
rootFolder = process.cwd(); rootFolder = process.cwd();
log.warn(`Session and args failed to provide root, using CWD: ${rootFolder}`); log.warn(
`Session and args failed to provide root, using CWD: ${rootFolder}`
);
} }
log.info(`Using project root: ${rootFolder}`); log.info(`Using project root: ${rootFolder}`);
// Assume client has already handled confirmation if needed // Assume client has already handled confirmation if needed
const result = await removeTaskDirect({ const result = await removeTaskDirect(
{
id: args.id, id: args.id,
file: args.file, file: args.file,
projectRoot: rootFolder projectRoot: rootFolder
}, log); },
log
);
if (result.success) { if (result.success) {
log.info(`Successfully removed task: ${args.id}`); log.info(`Successfully removed task: ${args.id}`);
@@ -66,6 +76,6 @@ export function registerRemoveTaskTool(server) {
log.error(`Error in remove-task tool: ${error.message}`); log.error(`Error in remove-task tool: ${error.message}`);
return createErrorResponse(`Failed to remove task: ${error.message}`); return createErrorResponse(`Failed to remove task: ${error.message}`);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to set the status of a task * Tool to set the status of a task
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { setTaskStatusDirect } from "../core/task-master-core.js"; import { setTaskStatusDirect } from '../core/task-master-core.js';
/** /**
* Register the setTaskStatus tool with the MCP server * Register the setTaskStatus tool with the MCP server
@@ -17,22 +17,26 @@ import { setTaskStatusDirect } from "../core/task-master-core.js";
*/ */
export function registerSetTaskStatusTool(server) { export function registerSetTaskStatusTool(server) {
server.addTool({ server.addTool({
name: "set_task_status", name: 'set_task_status',
description: "Set the status of one or more tasks or subtasks.", description: 'Set the status of one or more tasks or subtasks.',
parameters: z.object({ parameters: z.object({
id: z id: z
.string() .string()
.describe("Task ID or subtask ID (e.g., '15', '15.2'). Can be comma-separated for multiple updates."), .describe(
"Task ID or subtask ID (e.g., '15', '15.2'). Can be comma-separated for multiple updates."
),
status: z status: z
.string() .string()
.describe("New status to set (e.g., 'pending', 'done', 'in-progress', 'review', 'deferred', 'cancelled'."), .describe(
file: z.string().optional().describe("Path to the tasks file"), "New status to set (e.g., 'pending', 'done', 'in-progress', 'review', 'deferred', 'cancelled'."
),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: automatically detected)" 'Root directory of the project (default: automatically detected)'
), )
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -47,24 +51,33 @@ export function registerSetTaskStatusTool(server) {
} }
// Call the direct function with the project root // Call the direct function with the project root
const result = await setTaskStatusDirect({ const result = await setTaskStatusDirect(
{
...args, ...args,
projectRoot: rootFolder projectRoot: rootFolder
}, log); },
log
);
// Log the result // Log the result
if (result.success) { if (result.success) {
log.info(`Successfully updated status for task(s) ${args.id} to "${args.status}": ${result.data.message}`); log.info(
`Successfully updated status for task(s) ${args.id} to "${args.status}": ${result.data.message}`
);
} else { } else {
log.error(`Failed to update task status: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to update task status: ${result.error?.message || 'Unknown error'}`
);
} }
// Format and return the result // Format and return the result
return handleApiResult(result, log, 'Error setting task status'); return handleApiResult(result, log, 'Error setting task status');
} catch (error) { } catch (error) {
log.error(`Error in setTaskStatus tool: ${error.message}`); log.error(`Error in setTaskStatus tool: ${error.message}`);
return createErrorResponse(`Error setting task status: ${error.message}`); return createErrorResponse(
`Error setting task status: ${error.message}`
);
}
} }
},
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to append additional information to a specific subtask * Tool to append additional information to a specific subtask
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { updateSubtaskByIdDirect } from "../core/task-master-core.js"; import { updateSubtaskByIdDirect } from '../core/task-master-core.js';
/** /**
* Register the update-subtask tool with the MCP server * Register the update-subtask tool with the MCP server
@@ -17,19 +17,27 @@ import { updateSubtaskByIdDirect } from "../core/task-master-core.js";
*/ */
export function registerUpdateSubtaskTool(server) { export function registerUpdateSubtaskTool(server) {
server.addTool({ server.addTool({
name: "update_subtask", name: 'update_subtask',
description: "Appends additional information to a specific subtask without replacing existing content", description:
'Appends additional information to a specific subtask without replacing existing content',
parameters: z.object({ parameters: z.object({
id: z.string().describe("ID of the subtask to update in format \"parentId.subtaskId\" (e.g., \"5.2\")"), id: z
prompt: z.string().describe("Information to add to the subtask"), .string()
research: z.boolean().optional().describe("Use Perplexity AI for research-backed updates"), .describe(
file: z.string().optional().describe("Path to the tasks file"), 'ID of the subtask to update in format "parentId.subtaskId" (e.g., "5.2")'
),
prompt: z.string().describe('Information to add to the subtask'),
research: z
.boolean()
.optional()
.describe('Use Perplexity AI for research-backed updates'),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -42,15 +50,21 @@ export function registerUpdateSubtaskTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await updateSubtaskByIdDirect({ const result = await updateSubtaskByIdDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Successfully updated subtask with ID ${args.id}`); log.info(`Successfully updated subtask with ID ${args.id}`);
} else { } else {
log.error(`Failed to update subtask: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to update subtask: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error updating subtask'); return handleApiResult(result, log, 'Error updating subtask');
@@ -58,6 +72,6 @@ export function registerUpdateSubtaskTool(server) {
log.error(`Error in update_subtask tool: ${error.message}`); log.error(`Error in update_subtask tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to update a single task by ID with new information * Tool to update a single task by ID with new information
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { updateTaskByIdDirect } from "../core/task-master-core.js"; import { updateTaskByIdDirect } from '../core/task-master-core.js';
/** /**
* Register the update-task tool with the MCP server * Register the update-task tool with the MCP server
@@ -17,19 +17,27 @@ import { updateTaskByIdDirect } from "../core/task-master-core.js";
*/ */
export function registerUpdateTaskTool(server) { export function registerUpdateTaskTool(server) {
server.addTool({ server.addTool({
name: "update_task", name: 'update_task',
description: "Updates a single task by ID with new information or context provided in the prompt.", description:
'Updates a single task by ID with new information or context provided in the prompt.',
parameters: z.object({ parameters: z.object({
id: z.string().describe("ID of the task or subtask (e.g., '15', '15.2') to update"), id: z
prompt: z.string().describe("New information or context to incorporate into the task"), .string()
research: z.boolean().optional().describe("Use Perplexity AI for research-backed updates"), .describe("ID of the task or subtask (e.g., '15', '15.2') to update"),
file: z.string().optional().describe("Path to the tasks file"), prompt: z
.string()
.describe('New information or context to incorporate into the task'),
research: z
.boolean()
.optional()
.describe('Use Perplexity AI for research-backed updates'),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -42,15 +50,21 @@ export function registerUpdateTaskTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await updateTaskByIdDirect({ const result = await updateTaskByIdDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Successfully updated task with ID ${args.id}`); log.info(`Successfully updated task with ID ${args.id}`);
} else { } else {
log.error(`Failed to update task: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to update task: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error updating task'); return handleApiResult(result, log, 'Error updating task');
@@ -58,6 +72,6 @@ export function registerUpdateTaskTool(server) {
log.error(`Error in update_task tool: ${error.message}`); log.error(`Error in update_task tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,13 @@
* Tool to update tasks based on new context/prompt * Tool to update tasks based on new context/prompt
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { updateTasksDirect } from "../core/task-master-core.js"; import { updateTasksDirect } from '../core/task-master-core.js';
/** /**
* Register the update tool with the MCP server * Register the update tool with the MCP server
@@ -17,19 +17,29 @@ import { updateTasksDirect } from "../core/task-master-core.js";
*/ */
export function registerUpdateTool(server) { export function registerUpdateTool(server) {
server.addTool({ server.addTool({
name: "update", name: 'update',
description: "Update multiple upcoming tasks (with ID >= 'from' ID) based on new context or changes provided in the prompt. Use 'update_task' instead for a single specific task.", description:
"Update multiple upcoming tasks (with ID >= 'from' ID) based on new context or changes provided in the prompt. Use 'update_task' instead for a single specific task.",
parameters: z.object({ parameters: z.object({
from: z.string().describe("Task ID from which to start updating (inclusive). IMPORTANT: This tool uses 'from', not 'id'"), from: z
prompt: z.string().describe("Explanation of changes or new context to apply"), .string()
research: z.boolean().optional().describe("Use Perplexity AI for research-backed updates"), .describe(
file: z.string().optional().describe("Path to the tasks file"), "Task ID from which to start updating (inclusive). IMPORTANT: This tool uses 'from', not 'id'"
),
prompt: z
.string()
.describe('Explanation of changes or new context to apply'),
research: z
.boolean()
.optional()
.describe('Use Perplexity AI for research-backed updates'),
file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z projectRoot: z
.string() .string()
.optional() .optional()
.describe( .describe(
"Root directory of the project (default: current working directory)" 'Root directory of the project (default: current working directory)'
), )
}), }),
execute: async (args, { log, session }) => { execute: async (args, { log, session }) => {
try { try {
@@ -42,15 +52,23 @@ export function registerUpdateTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await updateTasksDirect({ const result = await updateTasksDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { session }); },
log,
{ session }
);
if (result.success) { if (result.success) {
log.info(`Successfully updated tasks from ID ${args.from}: ${result.data.message}`); log.info(
`Successfully updated tasks from ID ${args.from}: ${result.data.message}`
);
} else { } else {
log.error(`Failed to update tasks: ${result.error?.message || 'Unknown error'}`); log.error(
`Failed to update tasks: ${result.error?.message || 'Unknown error'}`
);
} }
return handleApiResult(result, log, 'Error updating tasks'); return handleApiResult(result, log, 'Error updating tasks');
@@ -58,6 +76,6 @@ export function registerUpdateTool(server) {
log.error(`Error in update tool: ${error.message}`); log.error(`Error in update tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -3,13 +3,16 @@
* Utility functions for Task Master CLI integration * Utility functions for Task Master CLI integration
*/ */
import { spawnSync } from "child_process"; import { spawnSync } from 'child_process';
import path from "path"; import path from 'path';
import fs from 'fs'; import fs from 'fs';
import { contextManager } from '../core/context-manager.js'; // Import the singleton import { contextManager } from '../core/context-manager.js'; // Import the singleton
// Import path utilities to ensure consistent path resolution // Import path utilities to ensure consistent path resolution
import { lastFoundProjectRoot, PROJECT_MARKERS } from '../core/utils/path-utils.js'; import {
lastFoundProjectRoot,
PROJECT_MARKERS
} from '../core/utils/path-utils.js';
/** /**
* Get normalized project root path * Get normalized project root path
@@ -31,7 +34,9 @@ function getProjectRoot(projectRootRaw, log) {
const absolutePath = path.isAbsolute(envRoot) const absolutePath = path.isAbsolute(envRoot)
? envRoot ? envRoot
: path.resolve(process.cwd(), envRoot); : path.resolve(process.cwd(), envRoot);
log.info(`Using project root from TASK_MASTER_PROJECT_ROOT environment variable: ${absolutePath}`); log.info(
`Using project root from TASK_MASTER_PROJECT_ROOT environment variable: ${absolutePath}`
);
return absolutePath; return absolutePath;
} }
@@ -47,23 +52,33 @@ function getProjectRoot(projectRootRaw, log) {
// 3. If we have a last found project root from a tasks.json search, use that for consistency // 3. If we have a last found project root from a tasks.json search, use that for consistency
if (lastFoundProjectRoot) { if (lastFoundProjectRoot) {
log.info(`Using last known project root where tasks.json was found: ${lastFoundProjectRoot}`); log.info(
`Using last known project root where tasks.json was found: ${lastFoundProjectRoot}`
);
return lastFoundProjectRoot; return lastFoundProjectRoot;
} }
// 4. Check if the current directory has any indicators of being a task-master project // 4. Check if the current directory has any indicators of being a task-master project
const currentDir = process.cwd(); const currentDir = process.cwd();
if (PROJECT_MARKERS.some(marker => { if (
PROJECT_MARKERS.some((marker) => {
const markerPath = path.join(currentDir, marker); const markerPath = path.join(currentDir, marker);
return fs.existsSync(markerPath); return fs.existsSync(markerPath);
})) { })
log.info(`Using current directory as project root (found project markers): ${currentDir}`); ) {
log.info(
`Using current directory as project root (found project markers): ${currentDir}`
);
return currentDir; return currentDir;
} }
// 5. Default to current working directory but warn the user // 5. Default to current working directory but warn the user
log.warn(`No task-master project detected in current directory. Using ${currentDir} as project root.`); log.warn(
log.warn('Consider using --project-root to specify the correct project location or set TASK_MASTER_PROJECT_ROOT environment variable.'); `No task-master project detected in current directory. Using ${currentDir} as project root.`
);
log.warn(
'Consider using --project-root to specify the correct project location or set TASK_MASTER_PROJECT_ROOT environment variable.'
);
return currentDir; return currentDir;
} }
@@ -76,7 +91,8 @@ function getProjectRoot(projectRootRaw, log) {
function getProjectRootFromSession(session, log) { function getProjectRootFromSession(session, log) {
try { try {
// Add detailed logging of session structure // Add detailed logging of session structure
log.info(`Session object: ${JSON.stringify({ log.info(
`Session object: ${JSON.stringify({
hasSession: !!session, hasSession: !!session,
hasRoots: !!session?.roots, hasRoots: !!session?.roots,
rootsType: typeof session?.roots, rootsType: typeof session?.roots,
@@ -88,7 +104,8 @@ function getProjectRootFromSession(session, log) {
isRootsRootsArray: Array.isArray(session?.roots?.roots), isRootsRootsArray: Array.isArray(session?.roots?.roots),
rootsRootsLength: session?.roots?.roots?.length, rootsRootsLength: session?.roots?.roots?.length,
firstRootsRoot: session?.roots?.roots?.[0] firstRootsRoot: session?.roots?.roots?.[0]
})}`); })}`
);
// ALWAYS ensure we return a valid path for project root // ALWAYS ensure we return a valid path for project root
const cwd = process.cwd(); const cwd = process.cwd();
@@ -125,9 +142,11 @@ function getProjectRootFromSession(session, log) {
const projectRoot = serverPath.substring(0, mcpServerIndex - 1); // -1 to remove trailing slash const projectRoot = serverPath.substring(0, mcpServerIndex - 1); // -1 to remove trailing slash
// Verify this looks like our project root by checking for key files/directories // Verify this looks like our project root by checking for key files/directories
if (fs.existsSync(path.join(projectRoot, '.cursor')) || if (
fs.existsSync(path.join(projectRoot, '.cursor')) ||
fs.existsSync(path.join(projectRoot, 'mcp-server')) || fs.existsSync(path.join(projectRoot, 'mcp-server')) ||
fs.existsSync(path.join(projectRoot, 'package.json'))) { fs.existsSync(path.join(projectRoot, 'package.json'))
) {
log.info(`Found project root from server path: ${projectRoot}`); log.info(`Found project root from server path: ${projectRoot}`);
return projectRoot; return projectRoot;
} }
@@ -142,7 +161,9 @@ function getProjectRootFromSession(session, log) {
const serverPath = process.argv[1]; const serverPath = process.argv[1];
if (serverPath && serverPath.includes('mcp-server')) { if (serverPath && serverPath.includes('mcp-server')) {
const mcpServerIndex = serverPath.indexOf('mcp-server'); const mcpServerIndex = serverPath.indexOf('mcp-server');
return mcpServerIndex !== -1 ? serverPath.substring(0, mcpServerIndex - 1) : process.cwd(); return mcpServerIndex !== -1
? serverPath.substring(0, mcpServerIndex - 1)
: process.cwd();
} }
// Only use cwd if it's not "/" // Only use cwd if it's not "/"
@@ -159,7 +180,12 @@ function getProjectRootFromSession(session, log) {
* @param {Function} processFunction - Optional function to process successful result data * @param {Function} processFunction - Optional function to process successful result data
* @returns {Object} - Standardized MCP response object * @returns {Object} - Standardized MCP response object
*/ */
function handleApiResult(result, log, errorPrefix = 'API error', processFunction = processMCPResponseData) { function handleApiResult(
result,
log,
errorPrefix = 'API error',
processFunction = processMCPResponseData
) {
if (!result.success) { if (!result.success) {
const errorMsg = result.error?.message || `Unknown ${errorPrefix}`; const errorMsg = result.error?.message || `Unknown ${errorPrefix}`;
// Include cache status in error logs // Include cache status in error logs
@@ -168,7 +194,9 @@ function handleApiResult(result, log, errorPrefix = 'API error', processFunction
} }
// Process the result data if needed // Process the result data if needed
const processedData = processFunction ? processFunction(result.data) : result.data; const processedData = processFunction
? processFunction(result.data)
: result.data;
// Log success including cache status // Log success including cache status
log.info(`Successfully completed operation. From cache: ${result.fromCache}`); // Add success log with cache status log.info(`Successfully completed operation. From cache: ${result.fromCache}`); // Add success log with cache status
@@ -214,7 +242,7 @@ function executeTaskMasterCommand(
// Common options for spawn // Common options for spawn
const spawnOptions = { const spawnOptions = {
encoding: "utf8", encoding: 'utf8',
cwd: cwd, cwd: cwd,
// Merge process.env with customEnv, giving precedence to customEnv // Merge process.env with customEnv, giving precedence to customEnv
env: { ...process.env, ...(customEnv || {}) } env: { ...process.env, ...(customEnv || {}) }
@@ -225,13 +253,13 @@ function executeTaskMasterCommand(
// Execute the command using the global task-master CLI or local script // Execute the command using the global task-master CLI or local script
// Try the global CLI first // Try the global CLI first
let result = spawnSync("task-master", fullArgs, spawnOptions); let result = spawnSync('task-master', fullArgs, spawnOptions);
// If global CLI is not available, try fallback to the local script // If global CLI is not available, try fallback to the local script
if (result.error && result.error.code === "ENOENT") { if (result.error && result.error.code === 'ENOENT') {
log.info("Global task-master not found, falling back to local script"); log.info('Global task-master not found, falling back to local script');
// Pass the same spawnOptions (including env) to the fallback // Pass the same spawnOptions (including env) to the fallback
result = spawnSync("node", ["scripts/dev.js", ...fullArgs], spawnOptions); result = spawnSync('node', ['scripts/dev.js', ...fullArgs], spawnOptions);
} }
if (result.error) { if (result.error) {
@@ -244,7 +272,7 @@ function executeTaskMasterCommand(
? result.stderr.trim() ? result.stderr.trim()
: result.stdout : result.stdout
? result.stdout.trim() ? result.stdout.trim()
: "Unknown error"; : 'Unknown error';
throw new Error( throw new Error(
`Command failed with exit code ${result.status}: ${errorOutput}` `Command failed with exit code ${result.status}: ${errorOutput}`
); );
@@ -253,13 +281,13 @@ function executeTaskMasterCommand(
return { return {
success: true, success: true,
stdout: result.stdout, stdout: result.stdout,
stderr: result.stderr, stderr: result.stderr
}; };
} catch (error) { } catch (error) {
log.error(`Error executing task-master command: ${error.message}`); log.error(`Error executing task-master command: ${error.message}`);
return { return {
success: false, success: false,
error: error.message, error: error.message
}; };
} }
} }
@@ -301,9 +329,13 @@ async function getCachedOrExecute({ cacheKey, actionFn, log }) {
const { fromCache, ...resultToCache } = result; const { fromCache, ...resultToCache } = result;
contextManager.setCachedData(cacheKey, resultToCache); contextManager.setCachedData(cacheKey, resultToCache);
} else if (!result.success) { } else if (!result.success) {
log.warn(`Action failed for cache key ${cacheKey}. Result not cached. Error: ${result.error?.message}`); log.warn(
`Action failed for cache key ${cacheKey}. Result not cached. Error: ${result.error?.message}`
);
} else { } else {
log.warn(`Action for cache key ${cacheKey} succeeded but returned no data. Result not cached.`); log.warn(
`Action for cache key ${cacheKey} succeeded but returned no data. Result not cached.`
);
} }
// Return the fresh result, indicating it wasn't from cache // Return the fresh result, indicating it wasn't from cache
@@ -320,7 +352,10 @@ async function getCachedOrExecute({ cacheKey, actionFn, log }) {
* @param {string[]} fieldsToRemove - An array of field names to remove. * @param {string[]} fieldsToRemove - An array of field names to remove.
* @returns {Object|Array} - The processed data with specified fields removed. * @returns {Object|Array} - The processed data with specified fields removed.
*/ */
function processMCPResponseData(taskOrData, fieldsToRemove = ['details', 'testStrategy']) { function processMCPResponseData(
taskOrData,
fieldsToRemove = ['details', 'testStrategy']
) {
if (!taskOrData) { if (!taskOrData) {
return taskOrData; return taskOrData;
} }
@@ -334,7 +369,7 @@ function processMCPResponseData(taskOrData, fieldsToRemove = ['details', 'testSt
const processedTask = { ...task }; const processedTask = { ...task };
// Remove specified fields from the task // Remove specified fields from the task
fieldsToRemove.forEach(field => { fieldsToRemove.forEach((field) => {
delete processedTask[field]; delete processedTask[field];
}); });
@@ -353,14 +388,23 @@ function processMCPResponseData(taskOrData, fieldsToRemove = ['details', 'testSt
}; };
// Check if the input is a data structure containing a 'tasks' array (like from listTasks) // Check if the input is a data structure containing a 'tasks' array (like from listTasks)
if (typeof taskOrData === 'object' && taskOrData !== null && Array.isArray(taskOrData.tasks)) { if (
typeof taskOrData === 'object' &&
taskOrData !== null &&
Array.isArray(taskOrData.tasks)
) {
return { return {
...taskOrData, // Keep other potential fields like 'stats', 'filter' ...taskOrData, // Keep other potential fields like 'stats', 'filter'
tasks: processArrayOfTasks(taskOrData.tasks), tasks: processArrayOfTasks(taskOrData.tasks)
}; };
} }
// Check if the input is likely a single task object (add more checks if needed) // Check if the input is likely a single task object (add more checks if needed)
else if (typeof taskOrData === 'object' && taskOrData !== null && 'id' in taskOrData && 'title' in taskOrData) { else if (
typeof taskOrData === 'object' &&
taskOrData !== null &&
'id' in taskOrData &&
'title' in taskOrData
) {
return processSingleTask(taskOrData); return processSingleTask(taskOrData);
} }
// Check if the input is an array of tasks directly (less common but possible) // Check if the input is an array of tasks directly (less common but possible)
@@ -382,11 +426,12 @@ function createContentResponse(content) {
return { return {
content: [ content: [
{ {
type: "text", type: 'text',
text: typeof content === 'object' ? text:
// Format JSON nicely with indentation typeof content === 'object'
JSON.stringify(content, null, 2) : ? // Format JSON nicely with indentation
// Keep other content types as-is JSON.stringify(content, null, 2)
: // Keep other content types as-is
String(content) String(content)
} }
] ]
@@ -402,7 +447,7 @@ export function createErrorResponse(errorMessage) {
return { return {
content: [ content: [
{ {
type: "text", type: 'text',
text: `Error: ${errorMessage}` text: `Error: ${errorMessage}`
} }
], ],
@@ -418,5 +463,5 @@ export {
executeTaskMasterCommand, executeTaskMasterCommand,
getCachedOrExecute, getCachedOrExecute,
processMCPResponseData, processMCPResponseData,
createContentResponse, createContentResponse
}; };

View File

@@ -3,13 +3,13 @@
* Tool for validating task dependencies * Tool for validating task dependencies
*/ */
import { z } from "zod"; import { z } from 'zod';
import { import {
handleApiResult, handleApiResult,
createErrorResponse, createErrorResponse,
getProjectRootFromSession getProjectRootFromSession
} from "./utils.js"; } from './utils.js';
import { validateDependenciesDirect } from "../core/task-master-core.js"; import { validateDependenciesDirect } from '../core/task-master-core.js';
/** /**
* Register the validateDependencies tool with the MCP server * Register the validateDependencies tool with the MCP server
@@ -17,11 +17,17 @@ import { validateDependenciesDirect } from "../core/task-master-core.js";
*/ */
export function registerValidateDependenciesTool(server) { export function registerValidateDependenciesTool(server) {
server.addTool({ server.addTool({
name: "validate_dependencies", name: 'validate_dependencies',
description: "Check tasks for dependency issues (like circular references or links to non-existent tasks) without making changes.", description:
'Check tasks for dependency issues (like circular references or links to non-existent tasks) without making changes.',
parameters: z.object({ parameters: z.object({
file: z.string().optional().describe("Path to the tasks file"), file: z.string().optional().describe('Path to the tasks file'),
projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)") projectRoot: z
.string()
.optional()
.describe(
'Root directory of the project (default: current working directory)'
)
}), }),
execute: async (args, { log, session, reportProgress }) => { execute: async (args, { log, session, reportProgress }) => {
try { try {
@@ -35,15 +41,21 @@ export function registerValidateDependenciesTool(server) {
log.info(`Using project root from args as fallback: ${rootFolder}`); log.info(`Using project root from args as fallback: ${rootFolder}`);
} }
const result = await validateDependenciesDirect({ const result = await validateDependenciesDirect(
{
projectRoot: rootFolder, projectRoot: rootFolder,
...args ...args
}, log, { reportProgress, mcpLog: log, session}); },
log,
{ reportProgress, mcpLog: log, session }
);
await reportProgress({ progress: 100 }); await reportProgress({ progress: 100 });
if (result.success) { if (result.success) {
log.info(`Successfully validated dependencies: ${result.data.message}`); log.info(
`Successfully validated dependencies: ${result.data.message}`
);
} else { } else {
log.error(`Failed to validate dependencies: ${result.error.message}`); log.error(`Failed to validate dependencies: ${result.error.message}`);
} }
@@ -53,6 +65,6 @@ export function registerValidateDependenciesTool(server) {
log.error(`Error in validateDependencies tool: ${error.message}`); log.error(`Error in validateDependencies tool: ${error.message}`);
return createErrorResponse(error.message); return createErrorResponse(error.message);
} }
}, }
}); });
} }

View File

@@ -16,7 +16,9 @@ try {
if (fs.existsSync(mcpPath)) { if (fs.existsSync(mcpPath)) {
console.error('mcp.json file found'); console.error('mcp.json file found');
console.error(`File content: ${JSON.stringify(JSON.parse(fs.readFileSync(mcpPath, 'utf8')), null, 2)}`); console.error(
`File content: ${JSON.stringify(JSON.parse(fs.readFileSync(mcpPath, 'utf8')), null, 2)}`
);
} else { } else {
console.error('mcp.json file not found'); console.error('mcp.json file not found');
} }
@@ -27,7 +29,9 @@ try {
// Check if env property exists // Check if env property exists
if (config.env) { if (config.env) {
console.error(`Config.env exists with keys: ${Object.keys(config.env).join(', ')}`); console.error(
`Config.env exists with keys: ${Object.keys(config.env).join(', ')}`
);
// Print each env var value (careful with sensitive values) // Print each env var value (careful with sensitive values)
for (const [key, value] of Object.entries(config.env)) { for (const [key, value] of Object.entries(config.env)) {

47
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{ {
"name": "task-master-ai", "name": "task-master-ai",
"version": "0.10.0", "version": "0.10.1",
"lockfileVersion": 3, "lockfileVersion": 3,
"requires": true, "requires": true,
"packages": { "packages": {
"": { "": {
"name": "task-master-ai", "name": "task-master-ai",
"version": "0.10.0", "version": "0.10.1",
"license": "MIT WITH Commons-Clause", "license": "MIT WITH Commons-Clause",
"dependencies": { "dependencies": {
"@anthropic-ai/sdk": "^0.39.0", "@anthropic-ai/sdk": "^0.39.0",
@@ -42,6 +42,7 @@
"jest": "^29.7.0", "jest": "^29.7.0",
"jest-environment-node": "^29.7.0", "jest-environment-node": "^29.7.0",
"mock-fs": "^5.5.0", "mock-fs": "^5.5.0",
"prettier": "^3.5.3",
"supertest": "^7.1.0" "supertest": "^7.1.0"
}, },
"engines": { "engines": {
@@ -608,6 +609,22 @@
"semver": "^7.5.3" "semver": "^7.5.3"
} }
}, },
"node_modules/@changesets/apply-release-plan/node_modules/prettier": {
"version": "2.8.8",
"resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz",
"integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==",
"dev": true,
"license": "MIT",
"bin": {
"prettier": "bin-prettier.js"
},
"engines": {
"node": ">=10.13.0"
},
"funding": {
"url": "https://github.com/prettier/prettier?sponsor=1"
}
},
"node_modules/@changesets/apply-release-plan/node_modules/semver": { "node_modules/@changesets/apply-release-plan/node_modules/semver": {
"version": "7.7.1", "version": "7.7.1",
"resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz",
@@ -930,6 +947,22 @@
"prettier": "^2.7.1" "prettier": "^2.7.1"
} }
}, },
"node_modules/@changesets/write/node_modules/prettier": {
"version": "2.8.8",
"resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz",
"integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==",
"dev": true,
"license": "MIT",
"bin": {
"prettier": "bin-prettier.js"
},
"engines": {
"node": ">=10.13.0"
},
"funding": {
"url": "https://github.com/prettier/prettier?sponsor=1"
}
},
"node_modules/@colors/colors": { "node_modules/@colors/colors": {
"version": "1.5.0", "version": "1.5.0",
"resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz", "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
@@ -6622,16 +6655,16 @@
} }
}, },
"node_modules/prettier": { "node_modules/prettier": {
"version": "2.8.8", "version": "3.5.3",
"resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz", "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.5.3.tgz",
"integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==", "integrity": "sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==",
"dev": true, "dev": true,
"license": "MIT", "license": "MIT",
"bin": { "bin": {
"prettier": "bin-prettier.js" "prettier": "bin/prettier.cjs"
}, },
"engines": { "engines": {
"node": ">=10.13.0" "node": ">=14"
}, },
"funding": { "funding": {
"url": "https://github.com/prettier/prettier?sponsor=1" "url": "https://github.com/prettier/prettier?sponsor=1"

View File

@@ -21,7 +21,9 @@
"changeset": "changeset", "changeset": "changeset",
"release": "changeset publish", "release": "changeset publish",
"inspector": "CLIENT_PORT=8888 SERVER_PORT=9000 npx @modelcontextprotocol/inspector node mcp-server/server.js", "inspector": "CLIENT_PORT=8888 SERVER_PORT=9000 npx @modelcontextprotocol/inspector node mcp-server/server.js",
"mcp-server": "node mcp-server/server.js" "mcp-server": "node mcp-server/server.js",
"format-check": "prettier --check .",
"format": "prettier --write ."
}, },
"keywords": [ "keywords": [
"claude", "claude",
@@ -91,6 +93,7 @@
"jest": "^29.7.0", "jest": "^29.7.0",
"jest-environment-node": "^29.7.0", "jest-environment-node": "^29.7.0",
"mock-fs": "^5.5.0", "mock-fs": "^5.5.0",
"prettier": "^3.5.3",
"supertest": "^7.1.0" "supertest": "^7.1.0"
} }
} }

View File

@@ -21,9 +21,11 @@ In an AI-driven development process—particularly with tools like [Cursor](http
The script can be configured through environment variables in a `.env` file at the root of the project: The script can be configured through environment variables in a `.env` file at the root of the project:
### Required Configuration ### Required Configuration
- `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude - `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude
### Optional Configuration ### Optional Configuration
- `MODEL`: Specify which Claude model to use (default: "claude-3-7-sonnet-20250219") - `MODEL`: Specify which Claude model to use (default: "claude-3-7-sonnet-20250219")
- `MAX_TOKENS`: Maximum tokens for model responses (default: 4000) - `MAX_TOKENS`: Maximum tokens for model responses (default: 4000)
- `TEMPERATURE`: Temperature for model responses (default: 0.7) - `TEMPERATURE`: Temperature for model responses (default: 0.7)
@@ -39,6 +41,7 @@ The script can be configured through environment variables in a `.env` file at t
## How It Works ## How It Works
1. **`tasks.json`**: 1. **`tasks.json`**:
- A JSON file at the project root containing an array of tasks (each with `id`, `title`, `description`, `status`, etc.). - A JSON file at the project root containing an array of tasks (each with `id`, `title`, `description`, `status`, etc.).
- The `meta` field can store additional info like the project's name, version, or reference to the PRD. - The `meta` field can store additional info like the project's name, version, or reference to the PRD.
- Tasks can have `subtasks` for more detailed implementation steps. - Tasks can have `subtasks` for more detailed implementation steps.
@@ -102,6 +105,7 @@ node scripts/dev.js update --file=custom-tasks.json --from=5 --prompt="Change da
``` ```
Notes: Notes:
- The `--prompt` parameter is required and should explain the changes or new context - The `--prompt` parameter is required and should explain the changes or new context
- Only tasks that aren't marked as 'done' will be updated - Only tasks that aren't marked as 'done' will be updated
- Tasks with ID >= the specified --from value will be updated - Tasks with ID >= the specified --from value will be updated
@@ -120,6 +124,7 @@ node scripts/dev.js update-task --id=4 --prompt="Use JWT for authentication" --r
``` ```
This command: This command:
- Updates only the specified task rather than a range of tasks - Updates only the specified task rather than a range of tasks
- Provides detailed validation with helpful error messages - Provides detailed validation with helpful error messages
- Checks for required API keys when using research mode - Checks for required API keys when using research mode
@@ -146,6 +151,7 @@ node scripts/dev.js set-status --id=1,2,3 --status=done
``` ```
Notes: Notes:
- When marking a parent task as "done", all of its subtasks will automatically be marked as "done" as well - When marking a parent task as "done", all of its subtasks will automatically be marked as "done" as well
- Common status values are 'done', 'pending', and 'deferred', but any string is accepted - Common status values are 'done', 'pending', and 'deferred', but any string is accepted
- You can specify multiple task IDs by separating them with commas - You can specify multiple task IDs by separating them with commas
@@ -195,6 +201,7 @@ node scripts/dev.js clear-subtasks --all
``` ```
Notes: Notes:
- After clearing subtasks, task files are automatically regenerated - After clearing subtasks, task files are automatically regenerated
- This is useful when you want to regenerate subtasks with a different approach - This is useful when you want to regenerate subtasks with a different approach
- Can be combined with the `expand` command to immediately generate new subtasks - Can be combined with the `expand` command to immediately generate new subtasks
@@ -210,6 +217,7 @@ The script integrates with two AI services:
The Perplexity integration uses the OpenAI client to connect to Perplexity's API, which provides enhanced research capabilities for generating more informed subtasks. If the Perplexity API is unavailable or encounters an error, the script will automatically fall back to using Anthropic's Claude. The Perplexity integration uses the OpenAI client to connect to Perplexity's API, which provides enhanced research capabilities for generating more informed subtasks. If the Perplexity API is unavailable or encounters an error, the script will automatically fall back to using Anthropic's Claude.
To use the Perplexity integration: To use the Perplexity integration:
1. Obtain a Perplexity API key 1. Obtain a Perplexity API key
2. Add `PERPLEXITY_API_KEY` to your `.env` file 2. Add `PERPLEXITY_API_KEY` to your `.env` file
3. Optionally specify `PERPLEXITY_MODEL` in your `.env` file (default: "sonar-medium-online") 3. Optionally specify `PERPLEXITY_MODEL` in your `.env` file (default: "sonar-medium-online")
@@ -218,6 +226,7 @@ To use the Perplexity integration:
## Logging ## Logging
The script supports different logging levels controlled by the `LOG_LEVEL` environment variable: The script supports different logging levels controlled by the `LOG_LEVEL` environment variable:
- `debug`: Detailed information, typically useful for troubleshooting - `debug`: Detailed information, typically useful for troubleshooting
- `info`: Confirmation that things are working as expected (default) - `info`: Confirmation that things are working as expected (default)
- `warn`: Warning messages that don't prevent execution - `warn`: Warning messages that don't prevent execution
@@ -240,17 +249,20 @@ node scripts/dev.js remove-dependency --id=<id> --depends-on=<id>
These commands: These commands:
1. **Allow precise dependency management**: 1. **Allow precise dependency management**:
- Add dependencies between tasks with automatic validation - Add dependencies between tasks with automatic validation
- Remove dependencies when they're no longer needed - Remove dependencies when they're no longer needed
- Update task files automatically after changes - Update task files automatically after changes
2. **Include validation checks**: 2. **Include validation checks**:
- Prevent circular dependencies (a task depending on itself) - Prevent circular dependencies (a task depending on itself)
- Prevent duplicate dependencies - Prevent duplicate dependencies
- Verify that both tasks exist before adding/removing dependencies - Verify that both tasks exist before adding/removing dependencies
- Check if dependencies exist before attempting to remove them - Check if dependencies exist before attempting to remove them
3. **Provide clear feedback**: 3. **Provide clear feedback**:
- Success messages confirm when dependencies are added/removed - Success messages confirm when dependencies are added/removed
- Error messages explain why operations failed (if applicable) - Error messages explain why operations failed (if applicable)
@@ -275,6 +287,7 @@ node scripts/dev.js validate-dependencies --file=custom-tasks.json
``` ```
This command: This command:
- Scans all tasks and subtasks for non-existent dependencies - Scans all tasks and subtasks for non-existent dependencies
- Identifies potential self-dependencies (tasks referencing themselves) - Identifies potential self-dependencies (tasks referencing themselves)
- Reports all found issues without modifying files - Reports all found issues without modifying files
@@ -296,6 +309,7 @@ node scripts/dev.js fix-dependencies --file=custom-tasks.json
``` ```
This command: This command:
1. **Validates all dependencies** across tasks and subtasks 1. **Validates all dependencies** across tasks and subtasks
2. **Automatically removes**: 2. **Automatically removes**:
- References to non-existent tasks and subtasks - References to non-existent tasks and subtasks
@@ -333,6 +347,7 @@ node scripts/dev.js analyze-complexity --research
``` ```
Notes: Notes:
- The command uses Claude to analyze each task's complexity (or Perplexity with --research flag) - The command uses Claude to analyze each task's complexity (or Perplexity with --research flag)
- Tasks are scored on a scale of 1-10 - Tasks are scored on a scale of 1-10
- Each task receives a recommended number of subtasks based on DEFAULT_SUBTASKS configuration - Each task receives a recommended number of subtasks based on DEFAULT_SUBTASKS configuration
@@ -357,12 +372,14 @@ node scripts/dev.js expand --id=8 --num=5 --prompt="Custom prompt"
``` ```
When a complexity report exists: When a complexity report exists:
- The `expand` command will use the recommended subtask count from the report (unless overridden) - The `expand` command will use the recommended subtask count from the report (unless overridden)
- It will use the tailored expansion prompt from the report (unless a custom prompt is provided) - It will use the tailored expansion prompt from the report (unless a custom prompt is provided)
- When using `--all`, tasks are sorted by complexity score (highest first) - When using `--all`, tasks are sorted by complexity score (highest first)
- The `--research` flag is preserved from the complexity analysis to expansion - The `--research` flag is preserved from the complexity analysis to expansion
The output report structure is: The output report structure is:
```json ```json
{ {
"meta": { "meta": {
@@ -381,7 +398,7 @@ The output report structure is:
"expansionPrompt": "Create subtasks that handle detecting...", "expansionPrompt": "Create subtasks that handle detecting...",
"reasoning": "This task requires sophisticated logic...", "reasoning": "This task requires sophisticated logic...",
"expansionCommand": "node scripts/dev.js expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research" "expansionCommand": "node scripts/dev.js expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
}, }
// More tasks sorted by complexity score (highest first) // More tasks sorted by complexity score (highest first)
] ]
} }
@@ -457,16 +474,19 @@ This command is particularly useful when you need to examine a specific task in
The script now includes improved error handling throughout all commands: The script now includes improved error handling throughout all commands:
1. **Detailed Validation**: 1. **Detailed Validation**:
- Required parameters (like task IDs and prompts) are validated early - Required parameters (like task IDs and prompts) are validated early
- File existence is checked with customized errors for common scenarios - File existence is checked with customized errors for common scenarios
- Parameter type conversion is handled with clear error messages - Parameter type conversion is handled with clear error messages
2. **Contextual Error Messages**: 2. **Contextual Error Messages**:
- Task not found errors include suggestions to run the list command - Task not found errors include suggestions to run the list command
- API key errors include reminders to check environment variables - API key errors include reminders to check environment variables
- Invalid ID format errors show the expected format - Invalid ID format errors show the expected format
3. **Command-Specific Help Displays**: 3. **Command-Specific Help Displays**:
- When validation fails, detailed help for the specific command is shown - When validation fails, detailed help for the specific command is shown
- Help displays include usage examples and parameter descriptions - Help displays include usage examples and parameter descriptions
- Formatted in clear, color-coded boxes with examples - Formatted in clear, color-coded boxes with examples
@@ -481,11 +501,13 @@ The script now includes improved error handling throughout all commands:
The script now automatically checks for updates without slowing down execution: The script now automatically checks for updates without slowing down execution:
1. **Background Version Checking**: 1. **Background Version Checking**:
- Non-blocking version checks run in the background while commands execute - Non-blocking version checks run in the background while commands execute
- Actual command execution isn't delayed by version checking - Actual command execution isn't delayed by version checking
- Update notifications appear after command completion - Update notifications appear after command completion
2. **Update Notifications**: 2. **Update Notifications**:
- When a newer version is available, a notification is displayed - When a newer version is available, a notification is displayed
- Notifications include current version, latest version, and update command - Notifications include current version, latest version, and update command
- Formatted in an attention-grabbing box with clear instructions - Formatted in an attention-grabbing box with clear instructions
@@ -516,6 +538,7 @@ node scripts/dev.js add-subtask --parent=5 --title="Login API route" --skip-gene
``` ```
Key features: Key features:
- Create new subtasks with detailed properties or convert existing tasks - Create new subtasks with detailed properties or convert existing tasks
- Define dependencies between subtasks - Define dependencies between subtasks
- Set custom status for new subtasks - Set custom status for new subtasks
@@ -538,6 +561,7 @@ node scripts/dev.js remove-subtask --id=5.2 --skip-generate
``` ```
Key features: Key features:
- Remove subtasks individually or in batches - Remove subtasks individually or in batches
- Optionally convert subtasks to standalone tasks - Optionally convert subtasks to standalone tasks
- Control whether task files are regenerated - Control whether task files are regenerated

View File

@@ -47,7 +47,10 @@ program
.option('-n, --name <name>', 'Project name') .option('-n, --name <name>', 'Project name')
.option('-my_name <name>', 'Project name (alias for --name)') .option('-my_name <name>', 'Project name (alias for --name)')
.option('-d, --description <description>', 'Project description') .option('-d, --description <description>', 'Project description')
.option('-my_description <description>', 'Project description (alias for --description)') .option(
'-my_description <description>',
'Project description (alias for --description)'
)
.option('-v, --version <version>', 'Project version') .option('-v, --version <version>', 'Project version')
.option('-my_version <version>', 'Project version (alias for --version)') .option('-my_version <version>', 'Project version (alias for --version)')
.option('--my_name <name>', 'Project name (alias for --name)') .option('--my_name <name>', 'Project name (alias for --name)')
@@ -80,7 +83,9 @@ const LOG_LEVELS = {
}; };
// Get log level from environment or default to info // Get log level from environment or default to info
const LOG_LEVEL = process.env.LOG_LEVEL ? LOG_LEVELS[process.env.LOG_LEVEL.toLowerCase()] : LOG_LEVELS.info; const LOG_LEVEL = process.env.LOG_LEVEL
? LOG_LEVELS[process.env.LOG_LEVEL.toLowerCase()]
: LOG_LEVELS.info;
// Create a color gradient for the banner // Create a color gradient for the banner
const coolGradient = gradient(['#00b4d8', '#0077b6', '#03045e']); const coolGradient = gradient(['#00b4d8', '#0077b6', '#03045e']);
@@ -98,14 +103,18 @@ function displayBanner() {
console.log(coolGradient(bannerText)); console.log(coolGradient(bannerText));
// Add creator credit line below the banner // Add creator credit line below the banner
console.log(chalk.dim('by ') + chalk.cyan.underline('https://x.com/eyaltoledano')); console.log(
chalk.dim('by ') + chalk.cyan.underline('https://x.com/eyaltoledano')
);
console.log(boxen(chalk.white(`${chalk.bold('Initializing')} your new project`), { console.log(
boxen(chalk.white(`${chalk.bold('Initializing')} your new project`), {
padding: 1, padding: 1,
margin: { top: 0, bottom: 1 }, margin: { top: 0, bottom: 1 },
borderStyle: 'round', borderStyle: 'round',
borderColor: 'cyan' borderColor: 'cyan'
})); })
);
} }
// Logging function with icons and colors // Logging function with icons and colors
@@ -167,13 +176,16 @@ function addShellAliases() {
try { try {
// Check if file exists // Check if file exists
if (!fs.existsSync(shellConfigFile)) { if (!fs.existsSync(shellConfigFile)) {
log('warn', `Shell config file ${shellConfigFile} not found. Aliases not added.`); log(
'warn',
`Shell config file ${shellConfigFile} not found. Aliases not added.`
);
return false; return false;
} }
// Check if aliases already exist // Check if aliases already exist
const configContent = fs.readFileSync(shellConfigFile, 'utf8'); const configContent = fs.readFileSync(shellConfigFile, 'utf8');
if (configContent.includes('alias tm=\'task-master\'')) { if (configContent.includes("alias tm='task-master'")) {
log('info', 'Task Master aliases already exist in shell config.'); log('info', 'Task Master aliases already exist in shell config.');
return true; return true;
} }
@@ -187,7 +199,11 @@ alias taskmaster='task-master'
fs.appendFileSync(shellConfigFile, aliasBlock); fs.appendFileSync(shellConfigFile, aliasBlock);
log('success', `Added Task Master aliases to ${shellConfigFile}`); log('success', `Added Task Master aliases to ${shellConfigFile}`);
log('info', 'To use the aliases in your current terminal, run: source ' + shellConfigFile); log(
'info',
'To use the aliases in your current terminal, run: source ' +
shellConfigFile
);
return true; return true;
} catch (error) { } catch (error) {
@@ -202,7 +218,7 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
let sourcePath; let sourcePath;
// Map template names to their actual source paths // Map template names to their actual source paths
switch(templateName) { switch (templateName) {
case 'dev.js': case 'dev.js':
sourcePath = path.join(__dirname, 'dev.js'); sourcePath = path.join(__dirname, 'dev.js');
break; break;
@@ -210,16 +226,40 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
sourcePath = path.join(__dirname, '..', 'assets', 'scripts_README.md'); sourcePath = path.join(__dirname, '..', 'assets', 'scripts_README.md');
break; break;
case 'dev_workflow.mdc': case 'dev_workflow.mdc':
sourcePath = path.join(__dirname, '..', '.cursor', 'rules', 'dev_workflow.mdc'); sourcePath = path.join(
__dirname,
'..',
'.cursor',
'rules',
'dev_workflow.mdc'
);
break; break;
case 'taskmaster.mdc': case 'taskmaster.mdc':
sourcePath = path.join(__dirname, '..', '.cursor', 'rules', 'taskmaster.mdc'); sourcePath = path.join(
__dirname,
'..',
'.cursor',
'rules',
'taskmaster.mdc'
);
break; break;
case 'cursor_rules.mdc': case 'cursor_rules.mdc':
sourcePath = path.join(__dirname, '..', '.cursor', 'rules', 'cursor_rules.mdc'); sourcePath = path.join(
__dirname,
'..',
'.cursor',
'rules',
'cursor_rules.mdc'
);
break; break;
case 'self_improve.mdc': case 'self_improve.mdc':
sourcePath = path.join(__dirname, '..', '.cursor', 'rules', 'self_improve.mdc'); sourcePath = path.join(
__dirname,
'..',
'.cursor',
'rules',
'self_improve.mdc'
);
break; break;
case 'README-task-master.md': case 'README-task-master.md':
sourcePath = path.join(__dirname, '..', 'README-task-master.md'); sourcePath = path.join(__dirname, '..', 'README-task-master.md');
@@ -258,12 +298,17 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
if (filename === '.gitignore') { if (filename === '.gitignore') {
log('info', `${targetPath} already exists, merging content...`); log('info', `${targetPath} already exists, merging content...`);
const existingContent = fs.readFileSync(targetPath, 'utf8'); const existingContent = fs.readFileSync(targetPath, 'utf8');
const existingLines = new Set(existingContent.split('\n').map(line => line.trim())); const existingLines = new Set(
const newLines = content.split('\n').filter(line => !existingLines.has(line.trim())); existingContent.split('\n').map((line) => line.trim())
);
const newLines = content
.split('\n')
.filter((line) => !existingLines.has(line.trim()));
if (newLines.length > 0) { if (newLines.length > 0) {
// Add a comment to separate the original content from our additions // Add a comment to separate the original content from our additions
const updatedContent = existingContent.trim() + const updatedContent =
existingContent.trim() +
'\n\n# Added by Claude Task Master\n' + '\n\n# Added by Claude Task Master\n' +
newLines.join('\n'); newLines.join('\n');
fs.writeFileSync(targetPath, updatedContent); fs.writeFileSync(targetPath, updatedContent);
@@ -276,11 +321,15 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
// Handle .windsurfrules - append the entire content // Handle .windsurfrules - append the entire content
if (filename === '.windsurfrules') { if (filename === '.windsurfrules') {
log('info', `${targetPath} already exists, appending content instead of overwriting...`); log(
'info',
`${targetPath} already exists, appending content instead of overwriting...`
);
const existingContent = fs.readFileSync(targetPath, 'utf8'); const existingContent = fs.readFileSync(targetPath, 'utf8');
// Add a separator comment before appending our content // Add a separator comment before appending our content
const updatedContent = existingContent.trim() + const updatedContent =
existingContent.trim() +
'\n\n# Added by Task Master - Development Workflow Rules\n\n' + '\n\n# Added by Task Master - Development Workflow Rules\n\n' +
content; content;
fs.writeFileSync(targetPath, updatedContent); fs.writeFileSync(targetPath, updatedContent);
@@ -292,7 +341,9 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
if (filename === 'package.json') { if (filename === 'package.json') {
log('info', `${targetPath} already exists, merging dependencies...`); log('info', `${targetPath} already exists, merging dependencies...`);
try { try {
const existingPackageJson = JSON.parse(fs.readFileSync(targetPath, 'utf8')); const existingPackageJson = JSON.parse(
fs.readFileSync(targetPath, 'utf8')
);
const newPackageJson = JSON.parse(content); const newPackageJson = JSON.parse(content);
// Merge dependencies, preferring existing versions in case of conflicts // Merge dependencies, preferring existing versions in case of conflicts
@@ -305,8 +356,9 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
existingPackageJson.scripts = { existingPackageJson.scripts = {
...existingPackageJson.scripts, ...existingPackageJson.scripts,
...Object.fromEntries( ...Object.fromEntries(
Object.entries(newPackageJson.scripts) Object.entries(newPackageJson.scripts).filter(
.filter(([key]) => !existingPackageJson.scripts[key]) ([key]) => !existingPackageJson.scripts[key]
)
) )
}; };
@@ -319,7 +371,10 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
targetPath, targetPath,
JSON.stringify(existingPackageJson, null, 2) JSON.stringify(existingPackageJson, null, 2)
); );
log('success', `Updated ${targetPath} with required dependencies and scripts`); log(
'success',
`Updated ${targetPath} with required dependencies and scripts`
);
} catch (error) { } catch (error) {
log('error', `Failed to merge package.json: ${error.message}`); log('error', `Failed to merge package.json: ${error.message}`);
// Fallback to writing a backup of the existing file and creating a new one // Fallback to writing a backup of the existing file and creating a new one
@@ -327,7 +382,10 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
fs.copyFileSync(targetPath, backupPath); fs.copyFileSync(targetPath, backupPath);
log('info', `Created backup of existing package.json at ${backupPath}`); log('info', `Created backup of existing package.json at ${backupPath}`);
fs.writeFileSync(targetPath, content); fs.writeFileSync(targetPath, content);
log('warn', `Replaced ${targetPath} with new content (due to JSON parsing error)`); log(
'warn',
`Replaced ${targetPath} with new content (due to JSON parsing error)`
);
} }
return; return;
} }
@@ -336,14 +394,23 @@ function copyTemplateFile(templateName, targetPath, replacements = {}) {
if (filename === 'README.md') { if (filename === 'README.md') {
log('info', `${targetPath} already exists`); log('info', `${targetPath} already exists`);
// Create a separate README file specifically for this project // Create a separate README file specifically for this project
const taskMasterReadmePath = path.join(path.dirname(targetPath), 'README-task-master.md'); const taskMasterReadmePath = path.join(
path.dirname(targetPath),
'README-task-master.md'
);
fs.writeFileSync(taskMasterReadmePath, content); fs.writeFileSync(taskMasterReadmePath, content);
log('success', `Created ${taskMasterReadmePath} (preserved original README.md)`); log(
'success',
`Created ${taskMasterReadmePath} (preserved original README.md)`
);
return; return;
} }
// For other files, warn and prompt before overwriting // For other files, warn and prompt before overwriting
log('warn', `${targetPath} already exists. Skipping file creation to avoid overwriting existing content.`); log(
'warn',
`${targetPath} already exists. Skipping file creation to avoid overwriting existing content.`
);
return; return;
} }
@@ -369,7 +436,10 @@ async function initializeProject(options = {}) {
if (dryRun) { if (dryRun) {
log('info', 'DRY RUN MODE: No files will be modified'); log('info', 'DRY RUN MODE: No files will be modified');
log('info', `Would initialize project: ${projectName} (${projectVersion})`); log(
'info',
`Would initialize project: ${projectName} (${projectVersion})`
);
log('info', `Description: ${projectDescription}`); log('info', `Description: ${projectDescription}`);
log('info', `Author: ${authorName || 'Not specified'}`); log('info', `Author: ${authorName || 'Not specified'}`);
log('info', 'Would create/update necessary project files'); log('info', 'Would create/update necessary project files');
@@ -388,7 +458,14 @@ async function initializeProject(options = {}) {
}; };
} }
createProjectStructure(projectName, projectDescription, projectVersion, authorName, skipInstall, addAliases); createProjectStructure(
projectName,
projectDescription,
projectVersion,
authorName,
skipInstall,
addAliases
);
return { return {
projectName, projectName,
projectDescription, projectDescription,
@@ -405,27 +482,53 @@ async function initializeProject(options = {}) {
}); });
try { try {
const projectName = await promptQuestion(rl, chalk.cyan('Enter project name: ')); const projectName = await promptQuestion(
const projectDescription = await promptQuestion(rl, chalk.cyan('Enter project description: ')); rl,
const projectVersionInput = await promptQuestion(rl, chalk.cyan('Enter project version (default: 1.0.0): ')); chalk.cyan('Enter project name: ')
const authorName = await promptQuestion(rl, chalk.cyan('Enter your name: ')); );
const projectDescription = await promptQuestion(
rl,
chalk.cyan('Enter project description: ')
);
const projectVersionInput = await promptQuestion(
rl,
chalk.cyan('Enter project version (default: 1.0.0): ')
);
const authorName = await promptQuestion(
rl,
chalk.cyan('Enter your name: ')
);
// Ask about shell aliases // Ask about shell aliases
const addAliasesInput = await promptQuestion(rl, chalk.cyan('Add shell aliases for task-master? (Y/n): ')); const addAliasesInput = await promptQuestion(
rl,
chalk.cyan('Add shell aliases for task-master? (Y/n): ')
);
const addAliases = addAliasesInput.trim().toLowerCase() !== 'n'; const addAliases = addAliasesInput.trim().toLowerCase() !== 'n';
// Set default version if not provided // Set default version if not provided
const projectVersion = projectVersionInput.trim() ? projectVersionInput : '1.0.0'; const projectVersion = projectVersionInput.trim()
? projectVersionInput
: '1.0.0';
// Confirm settings // Confirm settings
console.log('\nProject settings:'); console.log('\nProject settings:');
console.log(chalk.blue('Name:'), chalk.white(projectName)); console.log(chalk.blue('Name:'), chalk.white(projectName));
console.log(chalk.blue('Description:'), chalk.white(projectDescription)); console.log(chalk.blue('Description:'), chalk.white(projectDescription));
console.log(chalk.blue('Version:'), chalk.white(projectVersion)); console.log(chalk.blue('Version:'), chalk.white(projectVersion));
console.log(chalk.blue('Author:'), chalk.white(authorName || 'Not specified')); console.log(
console.log(chalk.blue('Add shell aliases:'), chalk.white(addAliases ? 'Yes' : 'No')); chalk.blue('Author:'),
chalk.white(authorName || 'Not specified')
);
console.log(
chalk.blue('Add shell aliases:'),
chalk.white(addAliases ? 'Yes' : 'No')
);
const confirmInput = await promptQuestion(rl, chalk.yellow('\nDo you want to continue with these settings? (Y/n): ')); const confirmInput = await promptQuestion(
rl,
chalk.yellow('\nDo you want to continue with these settings? (Y/n): ')
);
const shouldContinue = confirmInput.trim().toLowerCase() !== 'n'; const shouldContinue = confirmInput.trim().toLowerCase() !== 'n';
// Close the readline interface // Close the readline interface
@@ -458,7 +561,14 @@ async function initializeProject(options = {}) {
} }
// Create the project structure // Create the project structure
createProjectStructure(projectName, projectDescription, projectVersion, authorName, skipInstall, addAliases); createProjectStructure(
projectName,
projectDescription,
projectVersion,
authorName,
skipInstall,
addAliases
);
return { return {
projectName, projectName,
@@ -483,7 +593,14 @@ function promptQuestion(rl, question) {
} }
// Function to create the project structure // Function to create the project structure
function createProjectStructure(projectName, projectDescription, projectVersion, authorName, skipInstall, addAliases) { function createProjectStructure(
projectName,
projectDescription,
projectVersion,
authorName,
skipInstall,
addAliases
) {
const targetDir = process.cwd(); const targetDir = process.cwd();
log('info', `Initializing project in ${targetDir}`); log('info', `Initializing project in ${targetDir}`);
@@ -498,33 +615,33 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
version: projectVersion, version: projectVersion,
description: projectDescription, description: projectDescription,
author: authorName, author: authorName,
type: "module", type: 'module',
scripts: { scripts: {
"dev": "node scripts/dev.js", dev: 'node scripts/dev.js',
"list": "node scripts/dev.js list", list: 'node scripts/dev.js list',
"generate": "node scripts/dev.js generate", generate: 'node scripts/dev.js generate',
"parse-prd": "node scripts/dev.js parse-prd" 'parse-prd': 'node scripts/dev.js parse-prd'
}, },
dependencies: { dependencies: {
"@anthropic-ai/sdk": "^0.39.0", '@anthropic-ai/sdk': '^0.39.0',
"boxen": "^8.0.1", boxen: '^8.0.1',
"chalk": "^4.1.2", chalk: '^4.1.2',
"commander": "^11.1.0", commander: '^11.1.0',
"cli-table3": "^0.6.5", 'cli-table3': '^0.6.5',
"cors": "^2.8.5", cors: '^2.8.5',
"dotenv": "^16.3.1", dotenv: '^16.3.1',
"express": "^4.21.2", express: '^4.21.2',
"fastmcp": "^1.20.5", fastmcp: '^1.20.5',
"figlet": "^1.8.0", figlet: '^1.8.0',
"fuse.js": "^7.0.0", 'fuse.js': '^7.0.0',
"gradient-string": "^3.0.0", 'gradient-string': '^3.0.0',
"helmet": "^8.1.0", helmet: '^8.1.0',
"inquirer": "^12.5.0", inquirer: '^12.5.0',
"jsonwebtoken": "^9.0.2", jsonwebtoken: '^9.0.2',
"lru-cache": "^10.2.0", 'lru-cache': '^10.2.0',
"openai": "^4.89.0", openai: '^4.89.0',
"ora": "^8.2.0", ora: '^8.2.0',
"task-master-ai": "^0.9.31" 'task-master-ai': '^0.9.31'
} }
}; };
@@ -533,7 +650,9 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
if (fs.existsSync(packageJsonPath)) { if (fs.existsSync(packageJsonPath)) {
log('info', 'package.json already exists, merging content...'); log('info', 'package.json already exists, merging content...');
try { try {
const existingPackageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')); const existingPackageJson = JSON.parse(
fs.readFileSync(packageJsonPath, 'utf8')
);
// Preserve existing fields but add our required ones // Preserve existing fields but add our required ones
const mergedPackageJson = { const mergedPackageJson = {
@@ -541,15 +660,21 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
scripts: { scripts: {
...existingPackageJson.scripts, ...existingPackageJson.scripts,
...Object.fromEntries( ...Object.fromEntries(
Object.entries(packageJson.scripts) Object.entries(packageJson.scripts).filter(
.filter(([key]) => !existingPackageJson.scripts || !existingPackageJson.scripts[key]) ([key]) =>
!existingPackageJson.scripts ||
!existingPackageJson.scripts[key]
)
) )
}, },
dependencies: { dependencies: {
...existingPackageJson.dependencies || {}, ...(existingPackageJson.dependencies || {}),
...Object.fromEntries( ...Object.fromEntries(
Object.entries(packageJson.dependencies) Object.entries(packageJson.dependencies).filter(
.filter(([key]) => !existingPackageJson.dependencies || !existingPackageJson.dependencies[key]) ([key]) =>
!existingPackageJson.dependencies ||
!existingPackageJson.dependencies[key]
)
) )
} }
}; };
@@ -559,7 +684,10 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
mergedPackageJson.type = packageJson.type; mergedPackageJson.type = packageJson.type;
} }
fs.writeFileSync(packageJsonPath, JSON.stringify(mergedPackageJson, null, 2)); fs.writeFileSync(
packageJsonPath,
JSON.stringify(mergedPackageJson, null, 2)
);
log('success', 'Updated package.json with required fields'); log('success', 'Updated package.json with required fields');
} catch (error) { } catch (error) {
log('error', `Failed to merge package.json: ${error.message}`); log('error', `Failed to merge package.json: ${error.message}`);
@@ -568,7 +696,10 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
fs.copyFileSync(packageJsonPath, backupPath); fs.copyFileSync(packageJsonPath, backupPath);
log('info', `Created backup of existing package.json at ${backupPath}`); log('info', `Created backup of existing package.json at ${backupPath}`);
fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2)); fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
log('warn', 'Created new package.json (backup of original file was created)'); log(
'warn',
'Created new package.json (backup of original file was created)'
);
} }
} else { } else {
// If package.json doesn't exist, create it // If package.json doesn't exist, create it
@@ -589,22 +720,38 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
}; };
// Copy .env.example // Copy .env.example
copyTemplateFile('env.example', path.join(targetDir, '.env.example'), replacements); copyTemplateFile(
'env.example',
path.join(targetDir, '.env.example'),
replacements
);
// Copy .gitignore // Copy .gitignore
copyTemplateFile('gitignore', path.join(targetDir, '.gitignore')); copyTemplateFile('gitignore', path.join(targetDir, '.gitignore'));
// Copy dev_workflow.mdc // Copy dev_workflow.mdc
copyTemplateFile('dev_workflow.mdc', path.join(targetDir, '.cursor', 'rules', 'dev_workflow.mdc')); copyTemplateFile(
'dev_workflow.mdc',
path.join(targetDir, '.cursor', 'rules', 'dev_workflow.mdc')
);
// Copy taskmaster.mdc // Copy taskmaster.mdc
copyTemplateFile('taskmaster.mdc', path.join(targetDir, '.cursor', 'rules', 'taskmaster.mdc')); copyTemplateFile(
'taskmaster.mdc',
path.join(targetDir, '.cursor', 'rules', 'taskmaster.mdc')
);
// Copy cursor_rules.mdc // Copy cursor_rules.mdc
copyTemplateFile('cursor_rules.mdc', path.join(targetDir, '.cursor', 'rules', 'cursor_rules.mdc')); copyTemplateFile(
'cursor_rules.mdc',
path.join(targetDir, '.cursor', 'rules', 'cursor_rules.mdc')
);
// Copy self_improve.mdc // Copy self_improve.mdc
copyTemplateFile('self_improve.mdc', path.join(targetDir, '.cursor', 'rules', 'self_improve.mdc')); copyTemplateFile(
'self_improve.mdc',
path.join(targetDir, '.cursor', 'rules', 'self_improve.mdc')
);
// Copy .windsurfrules // Copy .windsurfrules
copyTemplateFile('windsurfrules', path.join(targetDir, '.windsurfrules')); copyTemplateFile('windsurfrules', path.join(targetDir, '.windsurfrules'));
@@ -613,13 +760,23 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
copyTemplateFile('dev.js', path.join(targetDir, 'scripts', 'dev.js')); copyTemplateFile('dev.js', path.join(targetDir, 'scripts', 'dev.js'));
// Copy scripts/README.md // Copy scripts/README.md
copyTemplateFile('scripts_README.md', path.join(targetDir, 'scripts', 'README.md')); copyTemplateFile(
'scripts_README.md',
path.join(targetDir, 'scripts', 'README.md')
);
// Copy example_prd.txt // Copy example_prd.txt
copyTemplateFile('example_prd.txt', path.join(targetDir, 'scripts', 'example_prd.txt')); copyTemplateFile(
'example_prd.txt',
path.join(targetDir, 'scripts', 'example_prd.txt')
);
// Create main README.md // Create main README.md
copyTemplateFile('README-task-master.md', path.join(targetDir, 'README.md'), replacements); copyTemplateFile(
'README-task-master.md',
path.join(targetDir, 'README.md'),
replacements
);
// Initialize git repository if git is available // Initialize git repository if git is available
try { try {
@@ -633,12 +790,14 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
} }
// Run npm install automatically // Run npm install automatically
console.log(boxen(chalk.cyan('Installing dependencies...'), { console.log(
boxen(chalk.cyan('Installing dependencies...'), {
padding: 0.5, padding: 0.5,
margin: 0.5, margin: 0.5,
borderStyle: 'round', borderStyle: 'round',
borderColor: 'blue' borderColor: 'blue'
})); })
);
try { try {
if (!skipInstall) { if (!skipInstall) {
@@ -653,16 +812,21 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
} }
// Display success message // Display success message
console.log(boxen( console.log(
warmGradient.multiline(figlet.textSync('Success!', { font: 'Standard' })) + boxen(
'\n' + chalk.green('Project initialized successfully!'), warmGradient.multiline(
figlet.textSync('Success!', { font: 'Standard' })
) +
'\n' +
chalk.green('Project initialized successfully!'),
{ {
padding: 1, padding: 1,
margin: 1, margin: 1,
borderStyle: 'double', borderStyle: 'double',
borderColor: 'green' borderColor: 'green'
} }
)); )
);
// Add shell aliases if requested // Add shell aliases if requested
if (addAliases) { if (addAliases) {
@@ -670,19 +834,58 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
} }
// Display next steps in a nice box // Display next steps in a nice box
console.log(boxen( console.log(
chalk.cyan.bold('Things you can now do:') + '\n\n' + boxen(
chalk.white('1. ') + chalk.yellow('Rename .env.example to .env and add your ANTHROPIC_API_KEY and PERPLEXITY_API_KEY') + '\n' + chalk.cyan.bold('Things you can now do:') +
chalk.white('2. ') + chalk.yellow('Discuss your idea with AI, and once ready ask for a PRD using the example_prd.txt file, and save what you get to scripts/PRD.txt') + '\n' + '\n\n' +
chalk.white('3. ') + chalk.yellow('Ask Cursor Agent to parse your PRD.txt and generate tasks') + '\n' + chalk.white('1. ') +
chalk.white(' └─ ') + chalk.dim('You can also run ') + chalk.cyan('task-master parse-prd <your-prd-file.txt>') + '\n' + chalk.yellow(
chalk.white('4. ') + chalk.yellow('Ask Cursor to analyze the complexity of your tasks') + '\n' + 'Rename .env.example to .env and add your ANTHROPIC_API_KEY and PERPLEXITY_API_KEY'
chalk.white('5. ') + chalk.yellow('Ask Cursor which task is next to determine where to start') + '\n' + ) +
chalk.white('6. ') + chalk.yellow('Ask Cursor to expand any complex tasks that are too large or complex.') + '\n' + '\n' +
chalk.white('7. ') + chalk.yellow('Ask Cursor to set the status of a task, or multiple tasks. Use the task id from the task lists.') + '\n' + chalk.white('2. ') +
chalk.white('8. ') + chalk.yellow('Ask Cursor to update all tasks from a specific task id based on new learnings or pivots in your project.') + '\n' + chalk.yellow(
chalk.white('9. ') + chalk.green.bold('Ship it!') + '\n\n' + 'Discuss your idea with AI, and once ready ask for a PRD using the example_prd.txt file, and save what you get to scripts/PRD.txt'
chalk.dim('* Review the README.md file to learn how to use other commands via Cursor Agent.'), ) +
'\n' +
chalk.white('3. ') +
chalk.yellow(
'Ask Cursor Agent to parse your PRD.txt and generate tasks'
) +
'\n' +
chalk.white(' └─ ') +
chalk.dim('You can also run ') +
chalk.cyan('task-master parse-prd <your-prd-file.txt>') +
'\n' +
chalk.white('4. ') +
chalk.yellow('Ask Cursor to analyze the complexity of your tasks') +
'\n' +
chalk.white('5. ') +
chalk.yellow(
'Ask Cursor which task is next to determine where to start'
) +
'\n' +
chalk.white('6. ') +
chalk.yellow(
'Ask Cursor to expand any complex tasks that are too large or complex.'
) +
'\n' +
chalk.white('7. ') +
chalk.yellow(
'Ask Cursor to set the status of a task, or multiple tasks. Use the task id from the task lists.'
) +
'\n' +
chalk.white('8. ') +
chalk.yellow(
'Ask Cursor to update all tasks from a specific task id based on new learnings or pivots in your project.'
) +
'\n' +
chalk.white('9. ') +
chalk.green.bold('Ship it!') +
'\n\n' +
chalk.dim(
'* Review the README.md file to learn how to use other commands via Cursor Agent.'
),
{ {
padding: 1, padding: 1,
margin: 1, margin: 1,
@@ -691,7 +894,8 @@ function createProjectStructure(projectName, projectDescription, projectVersion,
title: 'Getting Started', title: 'Getting Started',
titleAlignment: 'center' titleAlignment: 'center'
} }
)); )
);
} }
// Function to setup MCP configuration for Cursor integration // Function to setup MCP configuration for Cursor integration
@@ -706,21 +910,18 @@ function setupMCPConfiguration(targetDir, projectName) {
// New MCP config to be added - references the installed package // New MCP config to be added - references the installed package
const newMCPServer = { const newMCPServer = {
"task-master-ai": { 'task-master-ai': {
"command": "npx", command: 'npx',
"args": [ args: ['-y', 'task-master-mcp-server'],
"-y", env: {
"task-master-mcp-server" ANTHROPIC_API_KEY: '%ANTHROPIC_API_KEY%',
], PERPLEXITY_API_KEY: '%PERPLEXITY_API_KEY%',
"env": { MODEL: 'claude-3-7-sonnet-20250219',
"ANTHROPIC_API_KEY": "%ANTHROPIC_API_KEY%", PERPLEXITY_MODEL: 'sonar-pro',
"PERPLEXITY_API_KEY": "%PERPLEXITY_API_KEY%", MAX_TOKENS: 64000,
"MODEL": "claude-3-7-sonnet-20250219", TEMPERATURE: 0.3,
"PERPLEXITY_MODEL": "sonar-pro", DEFAULT_SUBTASKS: 5,
"MAX_TOKENS": 64000, DEFAULT_PRIORITY: 'medium'
"TEMPERATURE": 0.3,
"DEFAULT_SUBTASKS": 5,
"DEFAULT_PRIORITY": "medium"
} }
} }
}; };
@@ -738,18 +939,18 @@ function setupMCPConfiguration(targetDir, projectName) {
} }
// Add the task-master-ai server if it doesn't exist // Add the task-master-ai server if it doesn't exist
if (!mcpConfig.mcpServers["task-master-ai"]) { if (!mcpConfig.mcpServers['task-master-ai']) {
mcpConfig.mcpServers["task-master-ai"] = newMCPServer["task-master-ai"]; mcpConfig.mcpServers['task-master-ai'] = newMCPServer['task-master-ai'];
log('info', 'Added task-master-ai server to existing MCP configuration'); log(
'info',
'Added task-master-ai server to existing MCP configuration'
);
} else { } else {
log('info', 'task-master-ai server already configured in mcp.json'); log('info', 'task-master-ai server already configured in mcp.json');
} }
// Write the updated configuration // Write the updated configuration
fs.writeFileSync( fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 4));
mcpJsonPath,
JSON.stringify(mcpConfig, null, 4)
);
log('success', 'Updated MCP configuration file'); log('success', 'Updated MCP configuration file');
} catch (error) { } catch (error) {
log('error', `Failed to update MCP configuration: ${error.message}`); log('error', `Failed to update MCP configuration: ${error.message}`);
@@ -762,16 +963,19 @@ function setupMCPConfiguration(targetDir, projectName) {
// Create new configuration // Create new configuration
const newMCPConfig = { const newMCPConfig = {
"mcpServers": newMCPServer mcpServers: newMCPServer
}; };
fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4)); fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4));
log('warn', 'Created new MCP configuration file (backup of original file was created if it existed)'); log(
'warn',
'Created new MCP configuration file (backup of original file was created if it existed)'
);
} }
} else { } else {
// If mcp.json doesn't exist, create it // If mcp.json doesn't exist, create it
const newMCPConfig = { const newMCPConfig = {
"mcpServers": newMCPServer mcpServers: newMCPServer
}; };
fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4)); fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4));
@@ -801,7 +1005,9 @@ console.log('process.argv:', process.argv);
// When using --yes flag or providing name and description, use CLI options // When using --yes flag or providing name and description, use CLI options
await initializeProject({ await initializeProject({
projectName: options.name || 'task-master-project', projectName: options.name || 'task-master-project',
projectDescription: options.description || 'A task management system for AI-driven development', projectDescription:
options.description ||
'A task management system for AI-driven development',
projectVersion: options.version || '1.0.0', projectVersion: options.version || '1.0.0',
authorName: options.author || '', authorName: options.author || '',
dryRun: options.dryRun || false, dryRun: options.dryRun || false,
@@ -827,8 +1033,4 @@ console.log('process.argv:', process.argv);
})(); })();
// Export functions for programmatic use // Export functions for programmatic use
export { export { initializeProject, createProjectStructure, log };
initializeProject,
createProjectStructure,
log
};

View File

@@ -34,11 +34,13 @@ let perplexity = null;
function getPerplexityClient() { function getPerplexityClient() {
if (!perplexity) { if (!perplexity) {
if (!process.env.PERPLEXITY_API_KEY) { if (!process.env.PERPLEXITY_API_KEY) {
throw new Error("PERPLEXITY_API_KEY environment variable is missing. Set it to use research-backed features."); throw new Error(
'PERPLEXITY_API_KEY environment variable is missing. Set it to use research-backed features.'
);
} }
perplexity = new OpenAI({ perplexity = new OpenAI({
apiKey: process.env.PERPLEXITY_API_KEY, apiKey: process.env.PERPLEXITY_API_KEY,
baseURL: 'https://api.perplexity.ai', baseURL: 'https://api.perplexity.ai'
}); });
} }
return perplexity; return perplexity;
@@ -85,13 +87,18 @@ function getAvailableAIModel(options = {}) {
// Last resort: Use Claude even if overloaded (might fail) // Last resort: Use Claude even if overloaded (might fail)
if (process.env.ANTHROPIC_API_KEY) { if (process.env.ANTHROPIC_API_KEY) {
if (claudeOverloaded) { if (claudeOverloaded) {
log('warn', 'Claude is overloaded but no alternatives are available. Proceeding with Claude anyway.'); log(
'warn',
'Claude is overloaded but no alternatives are available. Proceeding with Claude anyway.'
);
} }
return { type: 'claude', client: anthropic }; return { type: 'claude', client: anthropic };
} }
// No models available // No models available
throw new Error('No AI models available. Please set ANTHROPIC_API_KEY and/or PERPLEXITY_API_KEY.'); throw new Error(
'No AI models available. Please set ANTHROPIC_API_KEY and/or PERPLEXITY_API_KEY.'
);
} }
/** /**
@@ -144,7 +151,15 @@ function handleClaudeError(error) {
* @param {Object} modelConfig - Model configuration (optional) * @param {Object} modelConfig - Model configuration (optional)
* @returns {Object} Claude's response * @returns {Object} Claude's response
*/ */
async function callClaude(prdContent, prdPath, numTasks, retryCount = 0, { reportProgress, mcpLog, session } = {}, aiClient = null, modelConfig = null) { async function callClaude(
prdContent,
prdPath,
numTasks,
retryCount = 0,
{ reportProgress, mcpLog, session } = {},
aiClient = null,
modelConfig = null
) {
try { try {
log('info', 'Calling Claude...'); log('info', 'Calling Claude...');
@@ -215,16 +230,28 @@ Important: Your response must be valid JSON only, with no additional explanation
log('error', userMessage); log('error', userMessage);
// Retry logic for certain errors // Retry logic for certain errors
if (retryCount < 2 && ( if (
error.error?.type === 'overloaded_error' || retryCount < 2 &&
(error.error?.type === 'overloaded_error' ||
error.error?.type === 'rate_limit_error' || error.error?.type === 'rate_limit_error' ||
error.message?.toLowerCase().includes('timeout') || error.message?.toLowerCase().includes('timeout') ||
error.message?.toLowerCase().includes('network') error.message?.toLowerCase().includes('network'))
)) { ) {
const waitTime = (retryCount + 1) * 5000; // 5s, then 10s const waitTime = (retryCount + 1) * 5000; // 5s, then 10s
log('info', `Waiting ${waitTime/1000} seconds before retry ${retryCount + 1}/2...`); log(
await new Promise(resolve => setTimeout(resolve, waitTime)); 'info',
return await callClaude(prdContent, prdPath, numTasks, retryCount + 1, { reportProgress, mcpLog, session }, aiClient, modelConfig); `Waiting ${waitTime / 1000} seconds before retry ${retryCount + 1}/2...`
);
await new Promise((resolve) => setTimeout(resolve, waitTime));
return await callClaude(
prdContent,
prdPath,
numTasks,
retryCount + 1,
{ reportProgress, mcpLog, session },
aiClient,
modelConfig
);
} else { } else {
console.error(chalk.red(userMessage)); console.error(chalk.red(userMessage));
if (CONFIG.debug) { if (CONFIG.debug) {
@@ -250,7 +277,16 @@ Important: Your response must be valid JSON only, with no additional explanation
* @param {Object} modelConfig - Model configuration (optional) * @param {Object} modelConfig - Model configuration (optional)
* @returns {Object} Claude's response * @returns {Object} Claude's response
*/ */
async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens, systemPrompt, { reportProgress, mcpLog, session } = {}, aiClient = null, modelConfig = null) { async function handleStreamingRequest(
prdContent,
prdPath,
numTasks,
maxTokens,
systemPrompt,
{ reportProgress, mcpLog, session } = {},
aiClient = null,
modelConfig = null
) {
// Determine output format based on mcpLog presence // Determine output format based on mcpLog presence
const outputFormat = mcpLog ? 'json' : 'text'; const outputFormat = mcpLog ? 'json' : 'text';
@@ -270,16 +306,23 @@ async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens,
loadingIndicator = startLoadingIndicator('Generating tasks from PRD...'); loadingIndicator = startLoadingIndicator('Generating tasks from PRD...');
} }
if (reportProgress) { await reportProgress({ progress: 0 }); } if (reportProgress) {
await reportProgress({ progress: 0 });
}
let responseText = ''; let responseText = '';
let streamingInterval = null; let streamingInterval = null;
try { try {
// Use streaming for handling large responses // Use streaming for handling large responses
const stream = await (aiClient || anthropic).messages.create({ const stream = await (aiClient || anthropic).messages.create({
model: modelConfig?.model || session?.env?.ANTHROPIC_MODEL || CONFIG.model, model:
max_tokens: modelConfig?.maxTokens || session?.env?.MAX_TOKENS || maxTokens, modelConfig?.model || session?.env?.ANTHROPIC_MODEL || CONFIG.model,
temperature: modelConfig?.temperature || session?.env?.TEMPERATURE || CONFIG.temperature, max_tokens:
modelConfig?.maxTokens || session?.env?.MAX_TOKENS || maxTokens,
temperature:
modelConfig?.temperature ||
session?.env?.TEMPERATURE ||
CONFIG.temperature,
system: systemPrompt, system: systemPrompt,
messages: [ messages: [
{ {
@@ -296,7 +339,9 @@ async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens,
const readline = await import('readline'); const readline = await import('readline');
streamingInterval = setInterval(() => { streamingInterval = setInterval(() => {
readline.cursorTo(process.stdout, 0); readline.cursorTo(process.stdout, 0);
process.stdout.write(`Receiving streaming response from Claude${'.'.repeat(dotCount)}`); process.stdout.write(
`Receiving streaming response from Claude${'.'.repeat(dotCount)}`
);
dotCount = (dotCount + 1) % 4; dotCount = (dotCount + 1) % 4;
}, 500); }, 500);
} }
@@ -307,10 +352,12 @@ async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens,
responseText += chunk.delta.text; responseText += chunk.delta.text;
} }
if (reportProgress) { if (reportProgress) {
await reportProgress({ progress: (responseText.length / maxTokens) * 100 }); await reportProgress({
progress: (responseText.length / maxTokens) * 100
});
} }
if (mcpLog) { if (mcpLog) {
mcpLog.info(`Progress: ${responseText.length / maxTokens * 100}%`); mcpLog.info(`Progress: ${(responseText.length / maxTokens) * 100}%`);
} }
} }
@@ -321,10 +368,20 @@ async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens,
stopLoadingIndicator(loadingIndicator); stopLoadingIndicator(loadingIndicator);
} }
report(`Completed streaming response from ${aiClient ? 'provided' : 'default'} AI client!`, 'info'); report(
`Completed streaming response from ${aiClient ? 'provided' : 'default'} AI client!`,
'info'
);
// Pass options to processClaudeResponse // Pass options to processClaudeResponse
return processClaudeResponse(responseText, numTasks, 0, prdContent, prdPath, { reportProgress, mcpLog, session }); return processClaudeResponse(
responseText,
numTasks,
0,
prdContent,
prdPath,
{ reportProgress, mcpLog, session }
);
} catch (error) { } catch (error) {
if (streamingInterval) clearInterval(streamingInterval); if (streamingInterval) clearInterval(streamingInterval);
@@ -360,7 +417,14 @@ async function handleStreamingRequest(prdContent, prdPath, numTasks, maxTokens,
* @param {Object} options - Options object containing mcpLog etc. * @param {Object} options - Options object containing mcpLog etc.
* @returns {Object} Processed response * @returns {Object} Processed response
*/ */
function processClaudeResponse(textContent, numTasks, retryCount, prdContent, prdPath, options = {}) { function processClaudeResponse(
textContent,
numTasks,
retryCount,
prdContent,
prdPath,
options = {}
) {
const { mcpLog } = options; const { mcpLog } = options;
// Determine output format based on mcpLog presence // Determine output format based on mcpLog presence
@@ -395,13 +459,16 @@ function processClaudeResponse(textContent, numTasks, retryCount, prdContent, pr
// Ensure we have the correct number of tasks // Ensure we have the correct number of tasks
if (parsedData.tasks.length !== numTasks) { if (parsedData.tasks.length !== numTasks) {
report(`Expected ${numTasks} tasks, but received ${parsedData.tasks.length}`, 'warn'); report(
`Expected ${numTasks} tasks, but received ${parsedData.tasks.length}`,
'warn'
);
} }
// Add metadata if missing // Add metadata if missing
if (!parsedData.metadata) { if (!parsedData.metadata) {
parsedData.metadata = { parsedData.metadata = {
projectName: "PRD Implementation", projectName: 'PRD Implementation',
totalTasks: parsedData.tasks.length, totalTasks: parsedData.tasks.length,
sourceFile: prdPath, sourceFile: prdPath,
generatedAt: new Date().toISOString().split('T')[0] generatedAt: new Date().toISOString().split('T')[0]
@@ -418,11 +485,24 @@ function processClaudeResponse(textContent, numTasks, retryCount, prdContent, pr
// Try again with Claude for a cleaner response // Try again with Claude for a cleaner response
if (retryCount === 1) { if (retryCount === 1) {
report("Calling Claude again for a cleaner response...", 'info'); report('Calling Claude again for a cleaner response...', 'info');
return callClaude(prdContent, prdPath, numTasks, retryCount + 1, options); return callClaude(
prdContent,
prdPath,
numTasks,
retryCount + 1,
options
);
} }
return processClaudeResponse(textContent, numTasks, retryCount + 1, prdContent, prdPath, options); return processClaudeResponse(
textContent,
numTasks,
retryCount + 1,
prdContent,
prdPath,
options
);
} else { } else {
throw error; throw error;
} }
@@ -441,11 +521,22 @@ function processClaudeResponse(textContent, numTasks, retryCount, prdContent, pr
* - session: Session object from MCP server (optional) * - session: Session object from MCP server (optional)
* @returns {Array} Generated subtasks * @returns {Array} Generated subtasks
*/ */
async function generateSubtasks(task, numSubtasks, nextSubtaskId, additionalContext = '', { reportProgress, mcpLog, session } = {}) { async function generateSubtasks(
task,
numSubtasks,
nextSubtaskId,
additionalContext = '',
{ reportProgress, mcpLog, session } = {}
) {
try { try {
log('info', `Generating ${numSubtasks} subtasks for task ${task.id}: ${task.title}`); log(
'info',
`Generating ${numSubtasks} subtasks for task ${task.id}: ${task.title}`
);
const loadingIndicator = startLoadingIndicator(`Generating subtasks for task ${task.id}...`); const loadingIndicator = startLoadingIndicator(
`Generating subtasks for task ${task.id}...`
);
let streamingInterval = null; let streamingInterval = null;
let responseText = ''; let responseText = '';
@@ -468,8 +559,9 @@ For each subtask, provide:
Each subtask should be implementable in a focused coding session.`; Each subtask should be implementable in a focused coding session.`;
const contextPrompt = additionalContext ? const contextPrompt = additionalContext
`\n\nAdditional context to consider: ${additionalContext}` : ''; ? `\n\nAdditional context to consider: ${additionalContext}`
: '';
const userPrompt = `Please break down this task into ${numSubtasks} specific, actionable subtasks: const userPrompt = `Please break down this task into ${numSubtasks} specific, actionable subtasks:
@@ -499,7 +591,9 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
const readline = await import('readline'); const readline = await import('readline');
streamingInterval = setInterval(() => { streamingInterval = setInterval(() => {
readline.cursorTo(process.stdout, 0); readline.cursorTo(process.stdout, 0);
process.stdout.write(`Generating subtasks for task ${task.id}${'.'.repeat(dotCount)}`); process.stdout.write(
`Generating subtasks for task ${task.id}${'.'.repeat(dotCount)}`
);
dotCount = (dotCount + 1) % 4; dotCount = (dotCount + 1) % 4;
}, 500); }, 500);
@@ -526,10 +620,14 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
responseText += chunk.delta.text; responseText += chunk.delta.text;
} }
if (reportProgress) { if (reportProgress) {
await reportProgress({ progress: (responseText.length / CONFIG.maxTokens) * 100 }); await reportProgress({
progress: (responseText.length / CONFIG.maxTokens) * 100
});
} }
if (mcpLog) { if (mcpLog) {
mcpLog.info(`Progress: ${responseText.length / CONFIG.maxTokens * 100}%`); mcpLog.info(
`Progress: ${(responseText.length / CONFIG.maxTokens) * 100}%`
);
} }
} }
@@ -538,7 +636,12 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
log('info', `Completed generating subtasks for task ${task.id}`); log('info', `Completed generating subtasks for task ${task.id}`);
return parseSubtasksFromText(responseText, nextSubtaskId, numSubtasks, task.id); return parseSubtasksFromText(
responseText,
nextSubtaskId,
numSubtasks,
task.id
);
} catch (error) { } catch (error) {
if (streamingInterval) clearInterval(streamingInterval); if (streamingInterval) clearInterval(streamingInterval);
stopLoadingIndicator(loadingIndicator); stopLoadingIndicator(loadingIndicator);
@@ -563,26 +666,38 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
* - session: Session object from MCP server (optional) * - session: Session object from MCP server (optional)
* @returns {Array} Generated subtasks * @returns {Array} Generated subtasks
*/ */
async function generateSubtasksWithPerplexity(task, numSubtasks = 3, nextSubtaskId = 1, additionalContext = '', { reportProgress, mcpLog, silentMode, session } = {}) { async function generateSubtasksWithPerplexity(
task,
numSubtasks = 3,
nextSubtaskId = 1,
additionalContext = '',
{ reportProgress, mcpLog, silentMode, session } = {}
) {
// Check both global silentMode and the passed parameter // Check both global silentMode and the passed parameter
const isSilent = silentMode || (typeof silentMode === 'undefined' && isSilentMode()); const isSilent =
silentMode || (typeof silentMode === 'undefined' && isSilentMode());
// Use mcpLog if provided, otherwise use regular log if not silent // Use mcpLog if provided, otherwise use regular log if not silent
const logFn = mcpLog ? const logFn = mcpLog
(level, ...args) => mcpLog[level](...args) : ? (level, ...args) => mcpLog[level](...args)
(level, ...args) => !isSilent && log(level, ...args); : (level, ...args) => !isSilent && log(level, ...args);
try { try {
// First, perform research to get context // First, perform research to get context
logFn('info', `Researching context for task ${task.id}: ${task.title}`); logFn('info', `Researching context for task ${task.id}: ${task.title}`);
const perplexityClient = getPerplexityClient(); const perplexityClient = getPerplexityClient();
const PERPLEXITY_MODEL = process.env.PERPLEXITY_MODEL || session?.env?.PERPLEXITY_MODEL || 'sonar-pro'; const PERPLEXITY_MODEL =
process.env.PERPLEXITY_MODEL ||
session?.env?.PERPLEXITY_MODEL ||
'sonar-pro';
// Only create loading indicators if not in silent mode // Only create loading indicators if not in silent mode
let researchLoadingIndicator = null; let researchLoadingIndicator = null;
if (!isSilent) { if (!isSilent) {
researchLoadingIndicator = startLoadingIndicator('Researching best practices with Perplexity AI...'); researchLoadingIndicator = startLoadingIndicator(
'Researching best practices with Perplexity AI...'
);
} }
// Formulate research query based on task // Formulate research query based on task
@@ -593,10 +708,12 @@ Include concrete code examples and technical considerations where relevant.`;
// Query Perplexity for research // Query Perplexity for research
const researchResponse = await perplexityClient.chat.completions.create({ const researchResponse = await perplexityClient.chat.completions.create({
model: PERPLEXITY_MODEL, model: PERPLEXITY_MODEL,
messages: [{ messages: [
{
role: 'user', role: 'user',
content: researchQuery content: researchQuery
}], }
],
temperature: 0.1 // Lower temperature for more factual responses temperature: 0.1 // Lower temperature for more factual responses
}); });
@@ -607,7 +724,10 @@ Include concrete code examples and technical considerations where relevant.`;
stopLoadingIndicator(researchLoadingIndicator); stopLoadingIndicator(researchLoadingIndicator);
} }
logFn('info', 'Research completed, now generating subtasks with additional context'); logFn(
'info',
'Research completed, now generating subtasks with additional context'
);
// Use the research result as additional context for Claude to generate subtasks // Use the research result as additional context for Claude to generate subtasks
const combinedContext = ` const combinedContext = `
@@ -615,13 +735,15 @@ RESEARCH FINDINGS:
${researchResult} ${researchResult}
ADDITIONAL CONTEXT PROVIDED BY USER: ADDITIONAL CONTEXT PROVIDED BY USER:
${additionalContext || "No additional context provided."} ${additionalContext || 'No additional context provided.'}
`; `;
// Now generate subtasks with Claude // Now generate subtasks with Claude
let loadingIndicator = null; let loadingIndicator = null;
if (!isSilent) { if (!isSilent) {
loadingIndicator = startLoadingIndicator(`Generating research-backed subtasks for task ${task.id}...`); loadingIndicator = startLoadingIndicator(
`Generating research-backed subtasks for task ${task.id}...`
);
} }
let streamingInterval = null; let streamingInterval = null;
@@ -680,7 +802,9 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
const readline = await import('readline'); const readline = await import('readline');
streamingInterval = setInterval(() => { streamingInterval = setInterval(() => {
readline.cursorTo(process.stdout, 0); readline.cursorTo(process.stdout, 0);
process.stdout.write(`Generating research-backed subtasks for task ${task.id}${'.'.repeat(dotCount)}`); process.stdout.write(
`Generating research-backed subtasks for task ${task.id}${'.'.repeat(dotCount)}`
);
dotCount = (dotCount + 1) % 4; dotCount = (dotCount + 1) % 4;
}, 500); }, 500);
} }
@@ -710,9 +834,17 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
loadingIndicator = null; loadingIndicator = null;
} }
logFn('info', `Completed generating research-backed subtasks for task ${task.id}`); logFn(
'info',
`Completed generating research-backed subtasks for task ${task.id}`
);
return parseSubtasksFromText(responseText, nextSubtaskId, numSubtasks, task.id); return parseSubtasksFromText(
responseText,
nextSubtaskId,
numSubtasks,
task.id
);
} catch (error) { } catch (error) {
// Clean up on error // Clean up on error
if (streamingInterval) { if (streamingInterval) {
@@ -726,7 +858,10 @@ Note on dependencies: Subtasks can depend on other subtasks with lower IDs. Use
throw error; throw error;
} }
} catch (error) { } catch (error) {
logFn('error', `Error generating research-backed subtasks: ${error.message}`); logFn(
'error',
`Error generating research-backed subtasks: ${error.message}`
);
throw error; throw error;
} }
} }
@@ -745,8 +880,12 @@ function parseSubtasksFromText(text, startId, expectedCount, parentTaskId) {
const jsonStartIndex = text.indexOf('['); const jsonStartIndex = text.indexOf('[');
const jsonEndIndex = text.lastIndexOf(']'); const jsonEndIndex = text.lastIndexOf(']');
if (jsonStartIndex === -1 || jsonEndIndex === -1 || jsonEndIndex < jsonStartIndex) { if (
throw new Error("Could not locate valid JSON array in the response"); jsonStartIndex === -1 ||
jsonEndIndex === -1 ||
jsonEndIndex < jsonStartIndex
) {
throw new Error('Could not locate valid JSON array in the response');
} }
// Extract and parse the JSON // Extract and parse the JSON
@@ -755,25 +894,31 @@ function parseSubtasksFromText(text, startId, expectedCount, parentTaskId) {
// Validate // Validate
if (!Array.isArray(subtasks)) { if (!Array.isArray(subtasks)) {
throw new Error("Parsed content is not an array"); throw new Error('Parsed content is not an array');
} }
// Log warning if count doesn't match expected // Log warning if count doesn't match expected
if (subtasks.length !== expectedCount) { if (subtasks.length !== expectedCount) {
log('warn', `Expected ${expectedCount} subtasks, but parsed ${subtasks.length}`); log(
'warn',
`Expected ${expectedCount} subtasks, but parsed ${subtasks.length}`
);
} }
// Normalize subtask IDs if they don't match // Normalize subtask IDs if they don't match
subtasks = subtasks.map((subtask, index) => { subtasks = subtasks.map((subtask, index) => {
// Assign the correct ID if it doesn't match // Assign the correct ID if it doesn't match
if (subtask.id !== startId + index) { if (subtask.id !== startId + index) {
log('warn', `Correcting subtask ID from ${subtask.id} to ${startId + index}`); log(
'warn',
`Correcting subtask ID from ${subtask.id} to ${startId + index}`
);
subtask.id = startId + index; subtask.id = startId + index;
} }
// Convert dependencies to numbers if they are strings // Convert dependencies to numbers if they are strings
if (subtask.dependencies && Array.isArray(subtask.dependencies)) { if (subtask.dependencies && Array.isArray(subtask.dependencies)) {
subtask.dependencies = subtask.dependencies.map(dep => { subtask.dependencies = subtask.dependencies.map((dep) => {
return typeof dep === 'string' ? parseInt(dep, 10) : dep; return typeof dep === 'string' ? parseInt(dep, 10) : dep;
}); });
} else { } else {
@@ -802,9 +947,10 @@ function parseSubtasksFromText(text, startId, expectedCount, parentTaskId) {
fallbackSubtasks.push({ fallbackSubtasks.push({
id: startId + i, id: startId + i,
title: `Subtask ${startId + i}`, title: `Subtask ${startId + i}`,
description: "Auto-generated fallback subtask", description: 'Auto-generated fallback subtask',
dependencies: [], dependencies: [],
details: "This is a fallback subtask created because parsing failed. Please update with real details.", details:
'This is a fallback subtask created because parsing failed. Please update with real details.',
status: 'pending', status: 'pending',
parentTaskId: parentTaskId parentTaskId: parentTaskId
}); });
@@ -822,14 +968,18 @@ function parseSubtasksFromText(text, startId, expectedCount, parentTaskId) {
function generateComplexityAnalysisPrompt(tasksData) { function generateComplexityAnalysisPrompt(tasksData) {
return `Analyze the complexity of the following tasks and provide recommendations for subtask breakdown: return `Analyze the complexity of the following tasks and provide recommendations for subtask breakdown:
${tasksData.tasks.map(task => ` ${tasksData.tasks
.map(
(task) => `
Task ID: ${task.id} Task ID: ${task.id}
Title: ${task.title} Title: ${task.title}
Description: ${task.description} Description: ${task.description}
Details: ${task.details} Details: ${task.details}
Dependencies: ${JSON.stringify(task.dependencies || [])} Dependencies: ${JSON.stringify(task.dependencies || [])}
Priority: ${task.priority || 'medium'} Priority: ${task.priority || 'medium'}
`).join('\n---\n')} `
)
.join('\n---\n')}
Analyze each task and return a JSON array with the following structure for each task: Analyze each task and return a JSON array with the following structure for each task:
[ [
@@ -866,20 +1016,28 @@ IMPORTANT: Make sure to include an analysis for EVERY task listed above, with th
* @param {boolean} [cliMode=false] - Whether to show CLI-specific output like spinners * @param {boolean} [cliMode=false] - Whether to show CLI-specific output like spinners
* @returns {Promise<string>} The accumulated response text * @returns {Promise<string>} The accumulated response text
*/ */
async function _handleAnthropicStream(client, params, { reportProgress, mcpLog, silentMode } = {}, cliMode = false) { async function _handleAnthropicStream(
client,
params,
{ reportProgress, mcpLog, silentMode } = {},
cliMode = false
) {
// Only set up loading indicator in CLI mode and not in silent mode // Only set up loading indicator in CLI mode and not in silent mode
let loadingIndicator = null; let loadingIndicator = null;
let streamingInterval = null; let streamingInterval = null;
let responseText = ''; let responseText = '';
// Check both the passed parameter and global silent mode using isSilentMode() // Check both the passed parameter and global silent mode using isSilentMode()
const isSilent = silentMode || (typeof silentMode === 'undefined' && isSilentMode()); const isSilent =
silentMode || (typeof silentMode === 'undefined' && isSilentMode());
// Only show CLI indicators if in cliMode AND not in silent mode // Only show CLI indicators if in cliMode AND not in silent mode
const showCLIOutput = cliMode && !isSilent; const showCLIOutput = cliMode && !isSilent;
if (showCLIOutput) { if (showCLIOutput) {
loadingIndicator = startLoadingIndicator('Processing request with Claude AI...'); loadingIndicator = startLoadingIndicator(
'Processing request with Claude AI...'
);
} }
try { try {
@@ -888,7 +1046,11 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
throw new Error('Anthropic client is required'); throw new Error('Anthropic client is required');
} }
if (!params.messages || !Array.isArray(params.messages) || params.messages.length === 0) { if (
!params.messages ||
!Array.isArray(params.messages) ||
params.messages.length === 0
) {
throw new Error('At least one message is required'); throw new Error('At least one message is required');
} }
@@ -907,7 +1069,9 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
const readline = await import('readline'); const readline = await import('readline');
streamingInterval = setInterval(() => { streamingInterval = setInterval(() => {
readline.cursorTo(process.stdout, 0); readline.cursorTo(process.stdout, 0);
process.stdout.write(`Receiving streaming response from Claude${'.'.repeat(dotCount)}`); process.stdout.write(
`Receiving streaming response from Claude${'.'.repeat(dotCount)}`
);
dotCount = (dotCount + 1) % 4; dotCount = (dotCount + 1) % 4;
}, 500); }, 500);
} }
@@ -933,7 +1097,10 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
// Report progress - use only mcpLog in MCP context and avoid direct reportProgress calls // Report progress - use only mcpLog in MCP context and avoid direct reportProgress calls
const maxTokens = params.max_tokens || CONFIG.maxTokens; const maxTokens = params.max_tokens || CONFIG.maxTokens;
const progressPercent = Math.min(100, (responseText.length / maxTokens) * 100); const progressPercent = Math.min(
100,
(responseText.length / maxTokens) * 100
);
// Only use reportProgress in CLI mode, not from MCP context, and not in silent mode // Only use reportProgress in CLI mode, not from MCP context, and not in silent mode
if (reportProgress && !mcpLog && !isSilent) { if (reportProgress && !mcpLog && !isSilent) {
@@ -945,7 +1112,9 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
// Log progress if logger is provided (MCP mode) // Log progress if logger is provided (MCP mode)
if (mcpLog) { if (mcpLog) {
mcpLog.info(`Progress: ${progressPercent}% (${responseText.length} chars generated)`); mcpLog.info(
`Progress: ${progressPercent}% (${responseText.length} chars generated)`
);
} }
} catch (iterError) { } catch (iterError) {
// Handle iteration errors // Handle iteration errors
@@ -956,7 +1125,10 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
} }
// If it's a "stream finished" error, just break the loop // If it's a "stream finished" error, just break the loop
if (iterError.message?.includes('finished') || iterError.message?.includes('closed')) { if (
iterError.message?.includes('finished') ||
iterError.message?.includes('closed')
) {
streamDone = true; streamDone = true;
} else { } else {
// For other errors, rethrow // For other errors, rethrow
@@ -978,9 +1150,9 @@ async function _handleAnthropicStream(client, params, { reportProgress, mcpLog,
// Log completion // Log completion
if (mcpLog) { if (mcpLog) {
mcpLog.info("Completed streaming response from Claude API!"); mcpLog.info('Completed streaming response from Claude API!');
} else if (!isSilent) { } else if (!isSilent) {
log('info', "Completed streaming response from Claude API!"); log('info', 'Completed streaming response from Claude API!');
} }
return responseText; return responseText;
@@ -1024,8 +1196,12 @@ function parseTaskJsonResponse(responseText) {
const jsonStartIndex = jsonContent.indexOf('{'); const jsonStartIndex = jsonContent.indexOf('{');
const jsonEndIndex = jsonContent.lastIndexOf('}'); const jsonEndIndex = jsonContent.lastIndexOf('}');
if (jsonStartIndex === -1 || jsonEndIndex === -1 || jsonEndIndex < jsonStartIndex) { if (
throw new Error("Could not locate valid JSON object in the response"); jsonStartIndex === -1 ||
jsonEndIndex === -1 ||
jsonEndIndex < jsonStartIndex
) {
throw new Error('Could not locate valid JSON object in the response');
} }
// Extract and parse the JSON // Extract and parse the JSON
@@ -1034,13 +1210,17 @@ function parseTaskJsonResponse(responseText) {
// Validate required fields // Validate required fields
if (!taskData.title || !taskData.description) { if (!taskData.title || !taskData.description) {
throw new Error("Missing required fields in the generated task (title or description)"); throw new Error(
'Missing required fields in the generated task (title or description)'
);
} }
return taskData; return taskData;
} catch (error) { } catch (error) {
if (error.name === 'SyntaxError') { if (error.name === 'SyntaxError') {
throw new Error(`Failed to parse JSON: ${error.message} (Response content may be malformed)`); throw new Error(
`Failed to parse JSON: ${error.message} (Response content may be malformed)`
);
} }
throw error; throw error;
} }
@@ -1056,7 +1236,8 @@ function parseTaskJsonResponse(responseText) {
*/ */
function _buildAddTaskPrompt(prompt, contextTasks, { newTaskId } = {}) { function _buildAddTaskPrompt(prompt, contextTasks, { newTaskId } = {}) {
// Create the system prompt for Claude // Create the system prompt for Claude
const systemPrompt = "You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description."; const systemPrompt =
"You are a helpful assistant that creates well-structured tasks for a software development project. Generate a single new task based on the user's description.";
const taskStructure = ` const taskStructure = `
{ {
@@ -1094,10 +1275,13 @@ function getAnthropicClient(session) {
} }
// Initialize a new client with API key from session or environment // Initialize a new client with API key from session or environment
const apiKey = session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY; const apiKey =
session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY;
if (!apiKey) { if (!apiKey) {
throw new Error("ANTHROPIC_API_KEY environment variable is missing. Set it to use AI features."); throw new Error(
'ANTHROPIC_API_KEY environment variable is missing. Set it to use AI features.'
);
} }
return new Anthropic({ return new Anthropic({
@@ -1118,14 +1302,22 @@ function getAnthropicClient(session) {
* @param {Object} options.session - Session object from MCP server * @param {Object} options.session - Session object from MCP server
* @returns {Object} - The generated task description * @returns {Object} - The generated task description
*/ */
async function generateTaskDescriptionWithPerplexity(prompt, { reportProgress, mcpLog, session } = {}) { async function generateTaskDescriptionWithPerplexity(
prompt,
{ reportProgress, mcpLog, session } = {}
) {
try { try {
// First, perform research to get context // First, perform research to get context
log('info', `Researching context for task prompt: "${prompt}"`); log('info', `Researching context for task prompt: "${prompt}"`);
const perplexityClient = getPerplexityClient(); const perplexityClient = getPerplexityClient();
const PERPLEXITY_MODEL = process.env.PERPLEXITY_MODEL || session?.env?.PERPLEXITY_MODEL || 'sonar-pro'; const PERPLEXITY_MODEL =
const researchLoadingIndicator = startLoadingIndicator('Researching best practices with Perplexity AI...'); process.env.PERPLEXITY_MODEL ||
session?.env?.PERPLEXITY_MODEL ||
'sonar-pro';
const researchLoadingIndicator = startLoadingIndicator(
'Researching best practices with Perplexity AI...'
);
// Formulate research query based on task prompt // Formulate research query based on task prompt
const researchQuery = `I need to implement: "${prompt}". const researchQuery = `I need to implement: "${prompt}".
@@ -1135,10 +1327,12 @@ Include concrete code examples and technical considerations where relevant.`;
// Query Perplexity for research // Query Perplexity for research
const researchResponse = await perplexityClient.chat.completions.create({ const researchResponse = await perplexityClient.chat.completions.create({
model: PERPLEXITY_MODEL, model: PERPLEXITY_MODEL,
messages: [{ messages: [
{
role: 'user', role: 'user',
content: researchQuery content: researchQuery
}], }
],
temperature: 0.1 // Lower temperature for more factual responses temperature: 0.1 // Lower temperature for more factual responses
}); });
@@ -1148,7 +1342,9 @@ Include concrete code examples and technical considerations where relevant.`;
log('info', 'Research completed, now generating detailed task description'); log('info', 'Research completed, now generating detailed task description');
// Now generate task description with Claude // Now generate task description with Claude
const loadingIndicator = startLoadingIndicator(`Generating research-backed task description...`); const loadingIndicator = startLoadingIndicator(
`Generating research-backed task description...`
);
let streamingInterval = null; let streamingInterval = null;
let responseText = ''; let responseText = '';
@@ -1185,7 +1381,9 @@ Return a JSON object with the following structure:
const readline = await import('readline'); const readline = await import('readline');
streamingInterval = setInterval(() => { streamingInterval = setInterval(() => {
readline.cursorTo(process.stdout, 0); readline.cursorTo(process.stdout, 0);
process.stdout.write(`Generating research-backed task description${'.'.repeat(dotCount)}`); process.stdout.write(
`Generating research-backed task description${'.'.repeat(dotCount)}`
);
dotCount = (dotCount + 1) % 4; dotCount = (dotCount + 1) % 4;
}, 500); }, 500);
@@ -1210,10 +1408,14 @@ Return a JSON object with the following structure:
responseText += chunk.delta.text; responseText += chunk.delta.text;
} }
if (reportProgress) { if (reportProgress) {
await reportProgress({ progress: (responseText.length / CONFIG.maxTokens) * 100 }); await reportProgress({
progress: (responseText.length / CONFIG.maxTokens) * 100
});
} }
if (mcpLog) { if (mcpLog) {
mcpLog.info(`Progress: ${responseText.length / CONFIG.maxTokens * 100}%`); mcpLog.info(
`Progress: ${(responseText.length / CONFIG.maxTokens) * 100}%`
);
} }
} }
@@ -1229,7 +1431,10 @@ Return a JSON object with the following structure:
throw error; throw error;
} }
} catch (error) { } catch (error) {
log('error', `Error generating research-backed task description: ${error.message}`); log(
'error',
`Error generating research-backed task description: ${error.message}`
);
throw error; throw error;
} }
} }
@@ -1242,10 +1447,15 @@ Return a JSON object with the following structure:
*/ */
function getConfiguredAnthropicClient(session = null, customEnv = null) { function getConfiguredAnthropicClient(session = null, customEnv = null) {
// If we have a session with ANTHROPIC_API_KEY in env, use that // If we have a session with ANTHROPIC_API_KEY in env, use that
const apiKey = session?.env?.ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY || customEnv?.ANTHROPIC_API_KEY; const apiKey =
session?.env?.ANTHROPIC_API_KEY ||
process.env.ANTHROPIC_API_KEY ||
customEnv?.ANTHROPIC_API_KEY;
if (!apiKey) { if (!apiKey) {
throw new Error("ANTHROPIC_API_KEY environment variable is missing. Set it to use AI features."); throw new Error(
'ANTHROPIC_API_KEY environment variable is missing. Set it to use AI features.'
);
} }
return new Anthropic({ return new Anthropic({
@@ -1264,9 +1474,18 @@ function getConfiguredAnthropicClient(session = null, customEnv = null) {
* @param {Object} options - Options containing reportProgress, mcpLog, silentMode, and session * @param {Object} options - Options containing reportProgress, mcpLog, silentMode, and session
* @returns {string} - Response text * @returns {string} - Response text
*/ */
async function sendChatWithContext(client, params, { reportProgress, mcpLog, silentMode, session } = {}) { async function sendChatWithContext(
client,
params,
{ reportProgress, mcpLog, silentMode, session } = {}
) {
// Use the streaming helper to get the response // Use the streaming helper to get the response
return await _handleAnthropicStream(client, params, { reportProgress, mcpLog, silentMode }, false); return await _handleAnthropicStream(
client,
params,
{ reportProgress, mcpLog, silentMode },
false
);
} }
/** /**

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -12,12 +12,12 @@ const CONFIG = {
model: process.env.MODEL || 'claude-3-7-sonnet-20250219', model: process.env.MODEL || 'claude-3-7-sonnet-20250219',
maxTokens: parseInt(process.env.MAX_TOKENS || '4000'), maxTokens: parseInt(process.env.MAX_TOKENS || '4000'),
temperature: parseFloat(process.env.TEMPERATURE || '0.7'), temperature: parseFloat(process.env.TEMPERATURE || '0.7'),
debug: process.env.DEBUG === "true", debug: process.env.DEBUG === 'true',
logLevel: process.env.LOG_LEVEL || "info", logLevel: process.env.LOG_LEVEL || 'info',
defaultSubtasks: parseInt(process.env.DEFAULT_SUBTASKS || "3"), defaultSubtasks: parseInt(process.env.DEFAULT_SUBTASKS || '3'),
defaultPriority: process.env.DEFAULT_PRIORITY || "medium", defaultPriority: process.env.DEFAULT_PRIORITY || 'medium',
projectName: process.env.PROJECT_NAME || "Task Master", projectName: process.env.PROJECT_NAME || 'Task Master',
projectVersion: "1.5.0" // Hardcoded version - ALWAYS use this value, ignore environment variable projectVersion: '1.5.0' // Hardcoded version - ALWAYS use this value, ignore environment variable
}; };
// Global silent mode flag // Global silent mode flag
@@ -67,11 +67,11 @@ function log(level, ...args) {
// Use text prefixes instead of emojis // Use text prefixes instead of emojis
const prefixes = { const prefixes = {
debug: chalk.gray("[DEBUG]"), debug: chalk.gray('[DEBUG]'),
info: chalk.blue("[INFO]"), info: chalk.blue('[INFO]'),
warn: chalk.yellow("[WARN]"), warn: chalk.yellow('[WARN]'),
error: chalk.red("[ERROR]"), error: chalk.red('[ERROR]'),
success: chalk.green("[SUCCESS]") success: chalk.green('[SUCCESS]')
}; };
// Ensure level exists, default to info if not // Ensure level exists, default to info if not
@@ -79,11 +79,15 @@ function log(level, ...args) {
const configLevel = CONFIG.logLevel || 'info'; // Ensure configLevel has a default const configLevel = CONFIG.logLevel || 'info'; // Ensure configLevel has a default
// Check log level configuration // Check log level configuration
if (LOG_LEVELS[currentLevel] >= (LOG_LEVELS[configLevel] ?? LOG_LEVELS.info)) { if (
LOG_LEVELS[currentLevel] >= (LOG_LEVELS[configLevel] ?? LOG_LEVELS.info)
) {
const prefix = prefixes[currentLevel] || ''; const prefix = prefixes[currentLevel] || '';
// Use console.log for all levels, let chalk handle coloring // Use console.log for all levels, let chalk handle coloring
// Construct the message properly // Construct the message properly
const message = args.map(arg => typeof arg === 'object' ? JSON.stringify(arg) : arg).join(' '); const message = args
.map((arg) => (typeof arg === 'object' ? JSON.stringify(arg) : arg))
.join(' ');
console.log(`${prefix} ${message}`); console.log(`${prefix} ${message}`);
} }
} }
@@ -145,7 +149,9 @@ function sanitizePrompt(prompt) {
*/ */
function readComplexityReport(customPath = null) { function readComplexityReport(customPath = null) {
try { try {
const reportPath = customPath || path.join(process.cwd(), 'scripts', 'task-complexity-report.json'); const reportPath =
customPath ||
path.join(process.cwd(), 'scripts', 'task-complexity-report.json');
if (!fs.existsSync(reportPath)) { if (!fs.existsSync(reportPath)) {
return null; return null;
} }
@@ -165,11 +171,15 @@ function readComplexityReport(customPath = null) {
* @returns {Object|null} The task analysis or null if not found * @returns {Object|null} The task analysis or null if not found
*/ */
function findTaskInComplexityReport(report, taskId) { function findTaskInComplexityReport(report, taskId) {
if (!report || !report.complexityAnalysis || !Array.isArray(report.complexityAnalysis)) { if (
!report ||
!report.complexityAnalysis ||
!Array.isArray(report.complexityAnalysis)
) {
return null; return null;
} }
return report.complexityAnalysis.find(task => task.taskId === taskId); return report.complexityAnalysis.find((task) => task.taskId === taskId);
} }
/** /**
@@ -185,18 +195,20 @@ function taskExists(tasks, taskId) {
// Handle both regular task IDs and subtask IDs (e.g., "1.2") // Handle both regular task IDs and subtask IDs (e.g., "1.2")
if (typeof taskId === 'string' && taskId.includes('.')) { if (typeof taskId === 'string' && taskId.includes('.')) {
const [parentId, subtaskId] = taskId.split('.').map(id => parseInt(id, 10)); const [parentId, subtaskId] = taskId
const parentTask = tasks.find(t => t.id === parentId); .split('.')
.map((id) => parseInt(id, 10));
const parentTask = tasks.find((t) => t.id === parentId);
if (!parentTask || !parentTask.subtasks) { if (!parentTask || !parentTask.subtasks) {
return false; return false;
} }
return parentTask.subtasks.some(st => st.id === subtaskId); return parentTask.subtasks.some((st) => st.id === subtaskId);
} }
const id = parseInt(taskId, 10); const id = parseInt(taskId, 10);
return tasks.some(t => t.id === id); return tasks.some((t) => t.id === id);
} }
/** /**
@@ -229,14 +241,16 @@ function findTaskById(tasks, taskId) {
// Check if it's a subtask ID (e.g., "1.2") // Check if it's a subtask ID (e.g., "1.2")
if (typeof taskId === 'string' && taskId.includes('.')) { if (typeof taskId === 'string' && taskId.includes('.')) {
const [parentId, subtaskId] = taskId.split('.').map(id => parseInt(id, 10)); const [parentId, subtaskId] = taskId
const parentTask = tasks.find(t => t.id === parentId); .split('.')
.map((id) => parseInt(id, 10));
const parentTask = tasks.find((t) => t.id === parentId);
if (!parentTask || !parentTask.subtasks) { if (!parentTask || !parentTask.subtasks) {
return null; return null;
} }
const subtask = parentTask.subtasks.find(st => st.id === subtaskId); const subtask = parentTask.subtasks.find((st) => st.id === subtaskId);
if (subtask) { if (subtask) {
// Add reference to parent task for context // Add reference to parent task for context
subtask.parentTask = { subtask.parentTask = {
@@ -251,7 +265,7 @@ function findTaskById(tasks, taskId) {
} }
const id = parseInt(taskId, 10); const id = parseInt(taskId, 10);
return tasks.find(t => t.id === id) || null; return tasks.find((t) => t.id === id) || null;
} }
/** /**
@@ -276,7 +290,13 @@ function truncate(text, maxLength) {
* @param {Set} recursionStack - Set of nodes in current recursion stack * @param {Set} recursionStack - Set of nodes in current recursion stack
* @returns {Array} - List of dependency edges that need to be removed to break cycles * @returns {Array} - List of dependency edges that need to be removed to break cycles
*/ */
function findCycles(subtaskId, dependencyMap, visited = new Set(), recursionStack = new Set(), path = []) { function findCycles(
subtaskId,
dependencyMap,
visited = new Set(),
recursionStack = new Set(),
path = []
) {
// Mark the current node as visited and part of recursion stack // Mark the current node as visited and part of recursion stack
visited.add(subtaskId); visited.add(subtaskId);
recursionStack.add(subtaskId); recursionStack.add(subtaskId);
@@ -291,7 +311,9 @@ function findCycles(subtaskId, dependencyMap, visited = new Set(), recursionStac
for (const depId of dependencies) { for (const depId of dependencies) {
// If not visited, recursively check for cycles // If not visited, recursively check for cycles
if (!visited.has(depId)) { if (!visited.has(depId)) {
const cycles = findCycles(depId, dependencyMap, visited, recursionStack, [...path]); const cycles = findCycles(depId, dependencyMap, visited, recursionStack, [
...path
]);
cyclesToBreak.push(...cycles); cyclesToBreak.push(...cycles);
} }
// If the dependency is in the recursion stack, we found a cycle // If the dependency is in the recursion stack, we found a cycle

View File

@@ -35,12 +35,14 @@ const COLORS = {
// Parse command line arguments // Parse command line arguments
const args = process.argv.slice(2); const args = process.argv.slice(2);
const versionBump = args.includes('--major') ? 'major' : const versionBump = args.includes('--major')
args.includes('--minor') ? 'minor' : ? 'major'
'patch'; : args.includes('--minor')
? 'minor'
: 'patch';
// Check for explicit version // Check for explicit version
const versionArg = args.find(arg => arg.startsWith('--version=')); const versionArg = args.find((arg) => arg.startsWith('--version='));
const explicitVersion = versionArg ? versionArg.split('=')[1] : null; const explicitVersion = versionArg ? versionArg.split('=')[1] : null;
// Log function with color support // Log function with color support
@@ -75,7 +77,10 @@ function ensureExecutable(filePath) {
// Function to sync template files // Function to sync template files
function syncTemplateFiles() { function syncTemplateFiles() {
// We no longer need to sync files since we're using them directly // We no longer need to sync files since we're using them directly
log('info', 'Template syncing has been deprecated - using source files directly'); log(
'info',
'Template syncing has been deprecated - using source files directly'
);
return true; return true;
} }
@@ -107,10 +112,16 @@ function preparePackage() {
let newVersion; let newVersion;
if (explicitVersion) { if (explicitVersion) {
newVersion = explicitVersion; newVersion = explicitVersion;
log('info', `Setting version to specified ${newVersion} (was ${currentVersion})`); log(
'info',
`Setting version to specified ${newVersion} (was ${currentVersion})`
);
} else { } else {
newVersion = incrementVersion(currentVersion, versionBump); newVersion = incrementVersion(currentVersion, versionBump);
log('info', `Incrementing ${versionBump} version to ${newVersion} (was ${currentVersion})`); log(
'info',
`Incrementing ${versionBump} version to ${newVersion} (was ${currentVersion})`
);
} }
packageJson.version = newVersion; packageJson.version = newVersion;
@@ -144,15 +155,15 @@ function preparePackage() {
} }
if (!allFilesExist) { if (!allFilesExist) {
log('error', 'Some required files are missing. Package preparation failed.'); log(
'error',
'Some required files are missing. Package preparation failed.'
);
process.exit(1); process.exit(1);
} }
// Ensure scripts are executable // Ensure scripts are executable
const executableScripts = [ const executableScripts = ['scripts/init.js', 'scripts/dev.js'];
'scripts/init.js',
'scripts/dev.js'
];
let allScriptsExecutable = true; let allScriptsExecutable = true;
for (const script of executableScripts) { for (const script of executableScripts) {
@@ -163,7 +174,10 @@ function preparePackage() {
} }
if (!allScriptsExecutable) { if (!allScriptsExecutable) {
log('warn', 'Some scripts could not be made executable. This may cause issues.'); log(
'warn',
'Some scripts could not be made executable. This may cause issues.'
);
} }
// Run npm pack to test package creation // Run npm pack to test package creation

View File

@@ -44,7 +44,8 @@ function createErrorSimulationScript(errorType, failureCount = 2) {
let modifiedContent = devJsContent; let modifiedContent = devJsContent;
// Find the anthropic.messages.create call and replace it with our mock // Find the anthropic.messages.create call and replace it with our mock
const anthropicCallRegex = /const response = await anthropic\.messages\.create\(/; const anthropicCallRegex =
/const response = await anthropic\.messages\.create\(/;
let mockCode = ''; let mockCode = '';
@@ -162,13 +163,18 @@ async function runErrorTest(errorType, numTasks = 5, failureCount = 2) {
console.log(`Created test PRD at ${testPRDPath}`); console.log(`Created test PRD at ${testPRDPath}`);
console.log(`Created error simulation script at ${tempScriptPath}`); console.log(`Created error simulation script at ${tempScriptPath}`);
console.log(`Running with error type: ${errorType}, failure count: ${failureCount}, tasks: ${numTasks}`); console.log(
`Running with error type: ${errorType}, failure count: ${failureCount}, tasks: ${numTasks}`
);
try { try {
// Run the modified script // Run the modified script
execSync(`node ${tempScriptPath} parse-prd --input=${testPRDPath} --tasks=${numTasks}`, { execSync(
`node ${tempScriptPath} parse-prd --input=${testPRDPath} --tasks=${numTasks}`,
{
stdio: 'inherit' stdio: 'inherit'
}); }
);
console.log(`${errorType} error test completed successfully`); console.log(`${errorType} error test completed successfully`);
} catch (error) { } catch (error) {
console.error(`${errorType} error test failed:`, error.message); console.error(`${errorType} error test failed:`, error.message);
@@ -206,7 +212,7 @@ async function runAllErrorTests() {
} }
// Run the tests // Run the tests
runAllErrorTests().catch(error => { runAllErrorTests().catch((error) => {
console.error('Error running tests:', error); console.error('Error running tests:', error);
process.exit(1); process.exit(1);
}); });

View File

@@ -157,9 +157,12 @@ async function runTests() {
const { execSync } = await import('child_process'); const { execSync } = await import('child_process');
try { try {
const smallResult = execSync(`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${smallPRDPath} --tasks=5`, { const smallResult = execSync(
`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${smallPRDPath} --tasks=5`,
{
stdio: 'inherit' stdio: 'inherit'
}); }
);
console.log('Small PRD test completed successfully'); console.log('Small PRD test completed successfully');
} catch (error) { } catch (error) {
console.error('Small PRD test failed:', error.message); console.error('Small PRD test failed:', error.message);
@@ -175,9 +178,12 @@ async function runTests() {
console.log('Running dev.js with medium PRD...'); console.log('Running dev.js with medium PRD...');
try { try {
const mediumResult = execSync(`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${mediumPRDPath} --tasks=15`, { const mediumResult = execSync(
`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${mediumPRDPath} --tasks=15`,
{
stdio: 'inherit' stdio: 'inherit'
}); }
);
console.log('Medium PRD test completed successfully'); console.log('Medium PRD test completed successfully');
} catch (error) { } catch (error) {
console.error('Medium PRD test failed:', error.message); console.error('Medium PRD test failed:', error.message);
@@ -193,9 +199,12 @@ async function runTests() {
console.log('Running dev.js with large PRD...'); console.log('Running dev.js with large PRD...');
try { try {
const largeResult = execSync(`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${largePRDPath} --tasks=25`, { const largeResult = execSync(
`node ${path.join(__dirname, 'dev.js')} parse-prd --input=${largePRDPath} --tasks=25`,
{
stdio: 'inherit' stdio: 'inherit'
}); }
);
console.log('Large PRD test completed successfully'); console.log('Large PRD test completed successfully');
} catch (error) { } catch (error) {
console.error('Large PRD test failed:', error.message); console.error('Large PRD test failed:', error.message);
@@ -213,7 +222,7 @@ async function runTests() {
path.join(__dirname, 'test-large-prd.txt') path.join(__dirname, 'test-large-prd.txt')
]; ];
testFiles.forEach(file => { testFiles.forEach((file) => {
if (fs.existsSync(file)) { if (fs.existsSync(file)) {
fs.unlinkSync(file); fs.unlinkSync(file);
console.log(`Deleted ${file}`); console.log(`Deleted ${file}`);
@@ -225,7 +234,7 @@ async function runTests() {
} }
// Run the tests // Run the tests
runTests().catch(error => { runTests().catch((error) => {
console.error('Error running tests:', error); console.error('Error running tests:', error);
process.exit(1); process.exit(1);
}); });

View File

@@ -1,4 +1,8 @@
import { checkForUpdate, displayUpgradeNotification, compareVersions } from './scripts/modules/commands.js'; import {
checkForUpdate,
displayUpgradeNotification,
compareVersions
} from './scripts/modules/commands.js';
import fs from 'fs'; import fs from 'fs';
import path from 'path'; import path from 'path';
@@ -20,7 +24,8 @@ async function testCheckForUpdate(simulatedLatestVersion) {
console.log(`Using simulated latest version: ${simulatedLatestVersion}`); console.log(`Using simulated latest version: ${simulatedLatestVersion}`);
// Compare versions // Compare versions
const needsUpdate = compareVersions(currentVersion, simulatedLatestVersion) < 0; const needsUpdate =
compareVersions(currentVersion, simulatedLatestVersion) < 0;
return { return {
currentVersion, currentVersion,
@@ -34,7 +39,9 @@ async function runTest() {
console.log('=== Testing version check scenarios ===\n'); console.log('=== Testing version check scenarios ===\n');
// Scenario 1: Update available // Scenario 1: Update available
console.log('\n--- Scenario 1: Update available (Current: 0.9.30, Latest: 1.0.0) ---'); console.log(
'\n--- Scenario 1: Update available (Current: 0.9.30, Latest: 1.0.0) ---'
);
const updateInfo1 = await testCheckForUpdate('1.0.0'); const updateInfo1 = await testCheckForUpdate('1.0.0');
console.log('Update check results:'); console.log('Update check results:');
console.log(`- Current version: ${updateInfo1.currentVersion}`); console.log(`- Current version: ${updateInfo1.currentVersion}`);
@@ -43,11 +50,16 @@ async function runTest() {
if (updateInfo1.needsUpdate) { if (updateInfo1.needsUpdate) {
console.log('\nDisplaying upgrade notification:'); console.log('\nDisplaying upgrade notification:');
displayUpgradeNotification(updateInfo1.currentVersion, updateInfo1.latestVersion); displayUpgradeNotification(
updateInfo1.currentVersion,
updateInfo1.latestVersion
);
} }
// Scenario 2: No update needed (versions equal) // Scenario 2: No update needed (versions equal)
console.log('\n--- Scenario 2: No update needed (Current: 0.9.30, Latest: 0.9.30) ---'); console.log(
'\n--- Scenario 2: No update needed (Current: 0.9.30, Latest: 0.9.30) ---'
);
const updateInfo2 = await testCheckForUpdate('0.9.30'); const updateInfo2 = await testCheckForUpdate('0.9.30');
console.log('Update check results:'); console.log('Update check results:');
console.log(`- Current version: ${updateInfo2.currentVersion}`); console.log(`- Current version: ${updateInfo2.currentVersion}`);
@@ -55,7 +67,9 @@ async function runTest() {
console.log(`- Update needed: ${updateInfo2.needsUpdate}`); console.log(`- Update needed: ${updateInfo2.needsUpdate}`);
// Scenario 3: Development version (current newer than latest) // Scenario 3: Development version (current newer than latest)
console.log('\n--- Scenario 3: Development version (Current: 0.9.30, Latest: 0.9.0) ---'); console.log(
'\n--- Scenario 3: Development version (Current: 0.9.30, Latest: 0.9.0) ---'
);
const updateInfo3 = await testCheckForUpdate('0.9.0'); const updateInfo3 = await testCheckForUpdate('0.9.0');
console.log('Update check results:'); console.log('Update check results:');
console.log(`- Current version: ${updateInfo3.currentVersion}`); console.log(`- Current version: ${updateInfo3.currentVersion}`);

View File

@@ -1,4 +1,7 @@
import { displayUpgradeNotification, compareVersions } from './scripts/modules/commands.js'; import {
displayUpgradeNotification,
compareVersions
} from './scripts/modules/commands.js';
// Simulate different version scenarios // Simulate different version scenarios
console.log('=== Simulating version check ===\n'); console.log('=== Simulating version check ===\n');
@@ -8,15 +11,25 @@ console.log('Scenario 1: Current version older than latest');
displayUpgradeNotification('0.9.30', '1.0.0'); displayUpgradeNotification('0.9.30', '1.0.0');
// 2. Current version same as latest (no update needed) // 2. Current version same as latest (no update needed)
console.log('\nScenario 2: Current version same as latest (this would not normally show a notice)'); console.log(
'\nScenario 2: Current version same as latest (this would not normally show a notice)'
);
console.log('Current: 1.0.0, Latest: 1.0.0'); console.log('Current: 1.0.0, Latest: 1.0.0');
console.log('compareVersions result:', compareVersions('1.0.0', '1.0.0')); console.log('compareVersions result:', compareVersions('1.0.0', '1.0.0'));
console.log('Update needed:', compareVersions('1.0.0', '1.0.0') < 0 ? 'Yes' : 'No'); console.log(
'Update needed:',
compareVersions('1.0.0', '1.0.0') < 0 ? 'Yes' : 'No'
);
// 3. Current version newer than latest (e.g., development version, would not show notice) // 3. Current version newer than latest (e.g., development version, would not show notice)
console.log('\nScenario 3: Current version newer than latest (this would not normally show a notice)'); console.log(
'\nScenario 3: Current version newer than latest (this would not normally show a notice)'
);
console.log('Current: 1.1.0, Latest: 1.0.0'); console.log('Current: 1.1.0, Latest: 1.0.0');
console.log('compareVersions result:', compareVersions('1.1.0', '1.0.0')); console.log('compareVersions result:', compareVersions('1.1.0', '1.0.0'));
console.log('Update needed:', compareVersions('1.1.0', '1.0.0') < 0 ? 'Yes' : 'No'); console.log(
'Update needed:',
compareVersions('1.1.0', '1.0.0') < 0 ? 'Yes' : 'No'
);
console.log('\n=== Test complete ==='); console.log('\n=== Test complete ===');

View File

@@ -6,39 +6,47 @@ export const sampleClaudeResponse = {
tasks: [ tasks: [
{ {
id: 1, id: 1,
title: "Setup Task Data Structure", title: 'Setup Task Data Structure',
description: "Implement the core task data structure and file operations", description: 'Implement the core task data structure and file operations',
status: "pending", status: 'pending',
dependencies: [], dependencies: [],
priority: "high", priority: 'high',
details: "Create the tasks.json file structure with support for task properties including ID, title, description, status, dependencies, priority, details, and test strategy. Implement file system operations for reading and writing task data.", details:
testStrategy: "Verify tasks.json is created with the correct structure and that task data can be read from and written to the file." 'Create the tasks.json file structure with support for task properties including ID, title, description, status, dependencies, priority, details, and test strategy. Implement file system operations for reading and writing task data.',
testStrategy:
'Verify tasks.json is created with the correct structure and that task data can be read from and written to the file.'
}, },
{ {
id: 2, id: 2,
title: "Implement CLI Foundation", title: 'Implement CLI Foundation',
description: "Create the command-line interface foundation with basic commands", description:
status: "pending", 'Create the command-line interface foundation with basic commands',
status: 'pending',
dependencies: [1], dependencies: [1],
priority: "high", priority: 'high',
details: "Set up Commander.js for handling CLI commands. Implement the basic command structure including help documentation. Create the foundational command parsing logic.", details:
testStrategy: "Test each command to ensure it properly parses arguments and options. Verify help documentation is displayed correctly." 'Set up Commander.js for handling CLI commands. Implement the basic command structure including help documentation. Create the foundational command parsing logic.',
testStrategy:
'Test each command to ensure it properly parses arguments and options. Verify help documentation is displayed correctly.'
}, },
{ {
id: 3, id: 3,
title: "Develop Task Management Operations", title: 'Develop Task Management Operations',
description: "Implement core operations for creating, reading, updating, and deleting tasks", description:
status: "pending", 'Implement core operations for creating, reading, updating, and deleting tasks',
status: 'pending',
dependencies: [1], dependencies: [1],
priority: "medium", priority: 'medium',
details: "Implement functions for listing tasks, adding new tasks, updating task status, and removing tasks. Include support for filtering tasks by status and other properties.", details:
testStrategy: "Create unit tests for each CRUD operation to verify they correctly modify the task data." 'Implement functions for listing tasks, adding new tasks, updating task status, and removing tasks. Include support for filtering tasks by status and other properties.',
testStrategy:
'Create unit tests for each CRUD operation to verify they correctly modify the task data.'
} }
], ],
metadata: { metadata: {
projectName: "Task Management CLI", projectName: 'Task Management CLI',
totalTasks: 3, totalTasks: 3,
sourceFile: "tests/fixtures/sample-prd.txt", sourceFile: 'tests/fixtures/sample-prd.txt',
generatedAt: "2023-12-15" generatedAt: '2023-12-15'
} }
}; };

View File

@@ -4,73 +4,75 @@
export const sampleTasks = { export const sampleTasks = {
meta: { meta: {
projectName: "Test Project", projectName: 'Test Project',
projectVersion: "1.0.0", projectVersion: '1.0.0',
createdAt: "2023-01-01T00:00:00.000Z", createdAt: '2023-01-01T00:00:00.000Z',
updatedAt: "2023-01-01T00:00:00.000Z" updatedAt: '2023-01-01T00:00:00.000Z'
}, },
tasks: [ tasks: [
{ {
id: 1, id: 1,
title: "Initialize Project", title: 'Initialize Project',
description: "Set up the project structure and dependencies", description: 'Set up the project structure and dependencies',
status: "done", status: 'done',
dependencies: [], dependencies: [],
priority: "high", priority: 'high',
details: "Create directory structure, initialize package.json, and install dependencies", details:
testStrategy: "Verify all directories and files are created correctly" 'Create directory structure, initialize package.json, and install dependencies',
testStrategy: 'Verify all directories and files are created correctly'
}, },
{ {
id: 2, id: 2,
title: "Create Core Functionality", title: 'Create Core Functionality',
description: "Implement the main features of the application", description: 'Implement the main features of the application',
status: "in-progress", status: 'in-progress',
dependencies: [1], dependencies: [1],
priority: "high", priority: 'high',
details: "Implement user authentication, data processing, and API endpoints", details:
testStrategy: "Write unit tests for all core functions", 'Implement user authentication, data processing, and API endpoints',
testStrategy: 'Write unit tests for all core functions',
subtasks: [ subtasks: [
{ {
id: 1, id: 1,
title: "Implement Authentication", title: 'Implement Authentication',
description: "Create user authentication system", description: 'Create user authentication system',
status: "done", status: 'done',
dependencies: [] dependencies: []
}, },
{ {
id: 2, id: 2,
title: "Set Up Database", title: 'Set Up Database',
description: "Configure database connection and models", description: 'Configure database connection and models',
status: "pending", status: 'pending',
dependencies: [1] dependencies: [1]
} }
] ]
}, },
{ {
id: 3, id: 3,
title: "Implement UI Components", title: 'Implement UI Components',
description: "Create the user interface components", description: 'Create the user interface components',
status: "pending", status: 'pending',
dependencies: [2], dependencies: [2],
priority: "medium", priority: 'medium',
details: "Design and implement React components for the user interface", details: 'Design and implement React components for the user interface',
testStrategy: "Test components with React Testing Library", testStrategy: 'Test components with React Testing Library',
subtasks: [ subtasks: [
{ {
id: 1, id: 1,
title: "Create Header Component", title: 'Create Header Component',
description: "Implement the header component", description: 'Implement the header component',
status: "pending", status: 'pending',
dependencies: [], dependencies: [],
details: "Create a responsive header with navigation links" details: 'Create a responsive header with navigation links'
}, },
{ {
id: 2, id: 2,
title: "Create Footer Component", title: 'Create Footer Component',
description: "Implement the footer component", description: 'Implement the footer component',
status: "pending", status: 'pending',
dependencies: [], dependencies: [],
details: "Create a footer with copyright information and links" details: 'Create a footer with copyright information and links'
} }
] ]
} }
@@ -79,10 +81,10 @@ export const sampleTasks = {
export const emptySampleTasks = { export const emptySampleTasks = {
meta: { meta: {
projectName: "Empty Project", projectName: 'Empty Project',
projectVersion: "1.0.0", projectVersion: '1.0.0',
createdAt: "2023-01-01T00:00:00.000Z", createdAt: '2023-01-01T00:00:00.000Z',
updatedAt: "2023-01-01T00:00:00.000Z" updatedAt: '2023-01-01T00:00:00.000Z'
}, },
tasks: [] tasks: []
}; };

View File

@@ -30,78 +30,86 @@ const mockDisableSilentMode = jest.fn();
const mockGetAnthropicClient = jest.fn().mockReturnValue({}); const mockGetAnthropicClient = jest.fn().mockReturnValue({});
const mockGetConfiguredAnthropicClient = jest.fn().mockReturnValue({}); const mockGetConfiguredAnthropicClient = jest.fn().mockReturnValue({});
const mockHandleAnthropicStream = jest.fn().mockResolvedValue(JSON.stringify([ const mockHandleAnthropicStream = jest.fn().mockResolvedValue(
JSON.stringify([
{ {
"id": 1, id: 1,
"title": "Mock Subtask 1", title: 'Mock Subtask 1',
"description": "First mock subtask", description: 'First mock subtask',
"dependencies": [], dependencies: [],
"details": "Implementation details for mock subtask 1" details: 'Implementation details for mock subtask 1'
}, },
{ {
"id": 2, id: 2,
"title": "Mock Subtask 2", title: 'Mock Subtask 2',
"description": "Second mock subtask", description: 'Second mock subtask',
"dependencies": [1], dependencies: [1],
"details": "Implementation details for mock subtask 2" details: 'Implementation details for mock subtask 2'
} }
])); ])
);
const mockParseSubtasksFromText = jest.fn().mockReturnValue([ const mockParseSubtasksFromText = jest.fn().mockReturnValue([
{ {
id: 1, id: 1,
title: "Mock Subtask 1", title: 'Mock Subtask 1',
description: "First mock subtask", description: 'First mock subtask',
status: "pending", status: 'pending',
dependencies: [] dependencies: []
}, },
{ {
id: 2, id: 2,
title: "Mock Subtask 2", title: 'Mock Subtask 2',
description: "Second mock subtask", description: 'Second mock subtask',
status: "pending", status: 'pending',
dependencies: [1] dependencies: [1]
} }
]); ]);
// Create a mock for expandTask that returns predefined responses instead of making real calls // Create a mock for expandTask that returns predefined responses instead of making real calls
const mockExpandTask = jest.fn().mockImplementation((taskId, numSubtasks, useResearch, additionalContext, options) => { const mockExpandTask = jest
.fn()
.mockImplementation(
(taskId, numSubtasks, useResearch, additionalContext, options) => {
const task = { const task = {
...sampleTasks.tasks.find(t => t.id === taskId) || {}, ...(sampleTasks.tasks.find((t) => t.id === taskId) || {}),
subtasks: useResearch ? [ subtasks: useResearch
? [
{ {
id: 1, id: 1,
title: "Research-Backed Subtask 1", title: 'Research-Backed Subtask 1',
description: "First research-backed subtask", description: 'First research-backed subtask',
status: "pending", status: 'pending',
dependencies: [] dependencies: []
}, },
{ {
id: 2, id: 2,
title: "Research-Backed Subtask 2", title: 'Research-Backed Subtask 2',
description: "Second research-backed subtask", description: 'Second research-backed subtask',
status: "pending", status: 'pending',
dependencies: [1] dependencies: [1]
} }
] : [ ]
: [
{ {
id: 1, id: 1,
title: "Mock Subtask 1", title: 'Mock Subtask 1',
description: "First mock subtask", description: 'First mock subtask',
status: "pending", status: 'pending',
dependencies: [] dependencies: []
}, },
{ {
id: 2, id: 2,
title: "Mock Subtask 2", title: 'Mock Subtask 2',
description: "Second mock subtask", description: 'Second mock subtask',
status: "pending", status: 'pending',
dependencies: [1] dependencies: [1]
} }
] ]
}; };
return Promise.resolve(task); return Promise.resolve(task);
}); }
);
const mockGenerateTaskFiles = jest.fn().mockResolvedValue(true); const mockGenerateTaskFiles = jest.fn().mockResolvedValue(true);
const mockFindTaskById = jest.fn(); const mockFindTaskById = jest.fn();
@@ -153,7 +161,12 @@ jest.mock('../../../scripts/modules/task-manager.js', () => ({
// Import dependencies after mocks are set up // Import dependencies after mocks are set up
import fs from 'fs'; import fs from 'fs';
import { readJSON, writeJSON, enableSilentMode, disableSilentMode } from '../../../scripts/modules/utils.js'; import {
readJSON,
writeJSON,
enableSilentMode,
disableSilentMode
} from '../../../scripts/modules/utils.js';
import { expandTask } from '../../../scripts/modules/task-manager.js'; import { expandTask } from '../../../scripts/modules/task-manager.js';
import { findTasksJsonPath } from '../../../mcp-server/src/core/utils/path-utils.js'; import { findTasksJsonPath } from '../../../mcp-server/src/core/utils/path-utils.js';
import { sampleTasks } from '../../fixtures/sample-tasks.js'; import { sampleTasks } from '../../fixtures/sample-tasks.js';
@@ -187,13 +200,13 @@ describe('MCP Server Direct Functions', () => {
// Default mockFindTaskById implementation // Default mockFindTaskById implementation
mockFindTaskById.mockImplementation((tasks, taskId) => { mockFindTaskById.mockImplementation((tasks, taskId) => {
const id = parseInt(taskId, 10); const id = parseInt(taskId, 10);
return tasks.find(t => t.id === id); return tasks.find((t) => t.id === id);
}); });
// Default mockTaskExists implementation // Default mockTaskExists implementation
mockTaskExists.mockImplementation((tasks, taskId) => { mockTaskExists.mockImplementation((tasks, taskId) => {
const id = parseInt(taskId, 10); const id = parseInt(taskId, 10);
return tasks.some(t => t.id === id); return tasks.some((t) => t.id === id);
}); });
// Default findTasksJsonPath implementation // Default findTasksJsonPath implementation
@@ -230,9 +243,13 @@ describe('MCP Server Direct Functions', () => {
tasks: sampleTasks.tasks, tasks: sampleTasks.tasks,
stats: { stats: {
total: sampleTasks.tasks.length, total: sampleTasks.tasks.length,
completed: sampleTasks.tasks.filter(t => t.status === 'done').length, completed: sampleTasks.tasks.filter((t) => t.status === 'done')
inProgress: sampleTasks.tasks.filter(t => t.status === 'in-progress').length, .length,
pending: sampleTasks.tasks.filter(t => t.status === 'pending').length inProgress: sampleTasks.tasks.filter(
(t) => t.status === 'in-progress'
).length,
pending: sampleTasks.tasks.filter((t) => t.status === 'pending')
.length
} }
}, },
fromCache: false fromCache: false
@@ -241,7 +258,9 @@ describe('MCP Server Direct Functions', () => {
// Status filter case // Status filter case
if (args.status) { if (args.status) {
const filteredTasks = sampleTasks.tasks.filter(t => t.status === args.status); const filteredTasks = sampleTasks.tasks.filter(
(t) => t.status === args.status
);
return { return {
success: true, success: true,
data: { data: {
@@ -309,7 +328,7 @@ describe('MCP Server Direct Functions', () => {
expect(result.success).toBe(true); expect(result.success).toBe(true);
expect(result.data.filter).toBe('pending'); expect(result.data.filter).toBe('pending');
// Should only include pending tasks // Should only include pending tasks
result.data.tasks.forEach(task => { result.data.tasks.forEach((task) => {
expect(task.status).toBe('pending'); expect(task.status).toBe('pending');
}); });
}); });
@@ -330,7 +349,9 @@ describe('MCP Server Direct Functions', () => {
expect(result.data.includeSubtasks).toBe(true); expect(result.data.includeSubtasks).toBe(true);
// Verify subtasks are included for tasks that have them // Verify subtasks are included for tasks that have them
const tasksWithSubtasks = result.data.tasks.filter(t => t.subtasks && t.subtasks.length > 0); const tasksWithSubtasks = result.data.tasks.filter(
(t) => t.subtasks && t.subtasks.length > 0
);
expect(tasksWithSubtasks.length).toBeGreaterThan(0); expect(tasksWithSubtasks.length).toBeGreaterThan(0);
}); });
@@ -382,7 +403,9 @@ describe('MCP Server Direct Functions', () => {
// Completed task case // Completed task case
if (args.id === '1') { if (args.id === '1') {
mockLogger.error(`Task ${args.id} is already marked as done and cannot be expanded`); mockLogger.error(
`Task ${args.id} is already marked as done and cannot be expanded`
);
return { return {
success: false, success: false,
error: { error: {
@@ -429,7 +452,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandTask(args, mockLogger, { session: mockSession }); const result = await testExpandTask(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
@@ -459,7 +484,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandTask(args, mockLogger, { session: mockSession }); const result = await testExpandTask(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(false); expect(result.success).toBe(false);
@@ -478,7 +505,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandTask(args, mockLogger, { session: mockSession }); const result = await testExpandTask(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(false); expect(result.success).toBe(false);
@@ -497,7 +526,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandTask(args, mockLogger, { session: mockSession }); const result = await testExpandTask(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(false); expect(result.success).toBe(false);
@@ -517,7 +548,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandTask(args, mockLogger, { session: mockSession }); const result = await testExpandTask(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
@@ -532,7 +565,7 @@ describe('MCP Server Direct Functions', () => {
}) })
); );
// Verify the result includes research-backed subtasks // Verify the result includes research-backed subtasks
expect(result.data.task.subtasks[0].title).toContain("Research-Backed"); expect(result.data.task.subtasks[0].title).toContain('Research-Backed');
}); });
}); });
@@ -562,7 +595,7 @@ describe('MCP Server Direct Functions', () => {
return { return {
success: true, success: true,
data: { data: {
message: "Successfully expanded all pending tasks with subtasks", message: 'Successfully expanded all pending tasks with subtasks',
details: { details: {
numSubtasks: args.num, numSubtasks: args.num,
research: args.research || false, research: args.research || false,
@@ -582,11 +615,15 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandAllTasks(args, mockLogger, { session: mockSession }); const result = await testExpandAllTasks(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
expect(result.data.message).toBe("Successfully expanded all pending tasks with subtasks"); expect(result.data.message).toBe(
'Successfully expanded all pending tasks with subtasks'
);
expect(result.data.details.numSubtasks).toBe(3); expect(result.data.details.numSubtasks).toBe(3);
expect(mockEnableSilentMode).toHaveBeenCalled(); expect(mockEnableSilentMode).toHaveBeenCalled();
expect(mockDisableSilentMode).toHaveBeenCalled(); expect(mockDisableSilentMode).toHaveBeenCalled();
@@ -602,7 +639,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandAllTasks(args, mockLogger, { session: mockSession }); const result = await testExpandAllTasks(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
@@ -620,7 +659,9 @@ describe('MCP Server Direct Functions', () => {
}; };
// Act // Act
const result = await testExpandAllTasks(args, mockLogger, { session: mockSession }); const result = await testExpandAllTasks(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
@@ -634,15 +675,19 @@ describe('MCP Server Direct Functions', () => {
const args = { const args = {
projectRoot: testProjectRoot, projectRoot: testProjectRoot,
file: testTasksPath, file: testTasksPath,
prompt: "Additional context for subtasks" prompt: 'Additional context for subtasks'
}; };
// Act // Act
const result = await testExpandAllTasks(args, mockLogger, { session: mockSession }); const result = await testExpandAllTasks(args, mockLogger, {
session: mockSession
});
// Assert // Assert
expect(result.success).toBe(true); expect(result.success).toBe(true);
expect(result.data.details.prompt).toBe("Additional context for subtasks"); expect(result.data.details.prompt).toBe(
'Additional context for subtasks'
);
expect(mockEnableSilentMode).toHaveBeenCalled(); expect(mockEnableSilentMode).toHaveBeenCalled();
expect(mockDisableSilentMode).toHaveBeenCalled(); expect(mockDisableSilentMode).toHaveBeenCalled();
}); });

View File

@@ -16,7 +16,7 @@ process.env.PROJECT_NAME = 'Test Project';
process.env.PROJECT_VERSION = '1.0.0'; process.env.PROJECT_VERSION = '1.0.0';
// Add global test helpers if needed // Add global test helpers if needed
global.wait = (ms) => new Promise(resolve => setTimeout(resolve, ms)); global.wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
// If needed, silence console during tests // If needed, silence console during tests
if (process.env.SILENCE_CONSOLE === 'true') { if (process.env.SILENCE_CONSOLE === 'true') {
@@ -25,6 +25,6 @@ if (process.env.SILENCE_CONSOLE === 'true') {
log: jest.fn(), log: jest.fn(),
info: jest.fn(), info: jest.fn(),
warn: jest.fn(), warn: jest.fn(),
error: jest.fn(), error: jest.fn()
}; };
} }

View File

@@ -127,7 +127,9 @@ describe('AI Client Utilities', () => {
const mockLog = { error: jest.fn() }; const mockLog = { error: jest.fn() };
// Execute & Verify // Execute & Verify
await expect(getPerplexityClientForMCP(session, mockLog)).rejects.toThrow(); await expect(
getPerplexityClientForMCP(session, mockLog)
).rejects.toThrow();
expect(mockLog.error).toHaveBeenCalled(); expect(mockLog.error).toHaveBeenCalled();
}); });
}); });
@@ -202,7 +204,11 @@ describe('AI Client Utilities', () => {
const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() }; const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() };
// Execute // Execute
const result = await getBestAvailableAIModel(session, { requiresResearch: true }, mockLog); const result = await getBestAvailableAIModel(
session,
{ requiresResearch: true },
mockLog
);
// Verify // Verify
expect(result.type).toBe('perplexity'); expect(result.type).toBe('perplexity');
@@ -224,7 +230,11 @@ describe('AI Client Utilities', () => {
try { try {
// Execute // Execute
const result = await getBestAvailableAIModel(session, { requiresResearch: true }, mockLog); const result = await getBestAvailableAIModel(
session,
{ requiresResearch: true },
mockLog
);
// Verify // Verify
// In our implementation, we prioritize research capability through Perplexity // In our implementation, we prioritize research capability through Perplexity
@@ -250,7 +260,11 @@ describe('AI Client Utilities', () => {
const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() }; const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() };
// Execute // Execute
const result = await getBestAvailableAIModel(session, { claudeOverloaded: true }, mockLog); const result = await getBestAvailableAIModel(
session,
{ claudeOverloaded: true },
mockLog
);
// Verify // Verify
expect(result.type).toBe('claude'); expect(result.type).toBe('claude');
@@ -266,7 +280,9 @@ describe('AI Client Utilities', () => {
const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() }; const mockLog = { warn: jest.fn(), info: jest.fn(), error: jest.fn() };
// Execute & Verify // Execute & Verify
await expect(getBestAvailableAIModel(session, {}, mockLog)).rejects.toThrow(); await expect(
getBestAvailableAIModel(session, {}, mockLog)
).rejects.toThrow();
}); });
}); });

View File

@@ -11,14 +11,16 @@ const mockLog = jest.fn();
// Mock dependencies // Mock dependencies
jest.mock('@anthropic-ai/sdk', () => { jest.mock('@anthropic-ai/sdk', () => {
const mockCreate = jest.fn().mockResolvedValue({ const mockCreate = jest.fn().mockResolvedValue({
content: [{ text: 'AI response' }], content: [{ text: 'AI response' }]
}); });
const mockAnthropicInstance = { const mockAnthropicInstance = {
messages: { messages: {
create: mockCreate create: mockCreate
} }
}; };
const mockAnthropicConstructor = jest.fn().mockImplementation(() => mockAnthropicInstance); const mockAnthropicConstructor = jest
.fn()
.mockImplementation(() => mockAnthropicInstance);
return { return {
Anthropic: mockAnthropicConstructor Anthropic: mockAnthropicConstructor
}; };
@@ -29,10 +31,10 @@ const mockOpenAIInstance = {
chat: { chat: {
completions: { completions: {
create: jest.fn().mockResolvedValue({ create: jest.fn().mockResolvedValue({
choices: [{ message: { content: 'Perplexity response' } }], choices: [{ message: { content: 'Perplexity response' } }]
}), })
}, }
}, }
}; };
const mockOpenAI = jest.fn().mockImplementation(() => mockOpenAIInstance); const mockOpenAI = jest.fn().mockImplementation(() => mockOpenAIInstance);
@@ -41,31 +43,35 @@ jest.mock('openai', () => {
}); });
jest.mock('dotenv', () => ({ jest.mock('dotenv', () => ({
config: jest.fn(), config: jest.fn()
})); }));
jest.mock('../../scripts/modules/utils.js', () => ({ jest.mock('../../scripts/modules/utils.js', () => ({
CONFIG: { CONFIG: {
model: 'claude-3-sonnet-20240229', model: 'claude-3-sonnet-20240229',
temperature: 0.7, temperature: 0.7,
maxTokens: 4000, maxTokens: 4000
}, },
log: mockLog, log: mockLog,
sanitizePrompt: jest.fn(text => text), sanitizePrompt: jest.fn((text) => text)
})); }));
jest.mock('../../scripts/modules/ui.js', () => ({ jest.mock('../../scripts/modules/ui.js', () => ({
startLoadingIndicator: jest.fn().mockReturnValue('mockLoader'), startLoadingIndicator: jest.fn().mockReturnValue('mockLoader'),
stopLoadingIndicator: jest.fn(), stopLoadingIndicator: jest.fn()
})); }));
// Mock anthropic global object // Mock anthropic global object
global.anthropic = { global.anthropic = {
messages: { messages: {
create: jest.fn().mockResolvedValue({ create: jest.fn().mockResolvedValue({
content: [{ text: '[{"id": 1, "title": "Test", "description": "Test", "dependencies": [], "details": "Test"}]' }], content: [
}), {
}, text: '[{"id": 1, "title": "Test", "description": "Test", "dependencies": [], "details": "Test"}]'
}
]
})
}
}; };
// Mock process.env // Mock process.env
@@ -393,7 +399,9 @@ These subtasks will help you implement the parent task efficiently.`;
const fileContent = fs.readFileSync(filePath, 'utf8'); const fileContent = fs.readFileSync(filePath, 'utf8');
// Check if the beta header is in the file // Check if the beta header is in the file
expect(fileContent).toContain("'anthropic-beta': 'output-128k-2025-02-19'"); expect(fileContent).toContain(
"'anthropic-beta': 'output-128k-2025-02-19'"
);
}); });
}); });
}); });

View File

@@ -26,14 +26,14 @@ jest.mock('path', () => ({
})); }));
jest.mock('chalk', () => ({ jest.mock('chalk', () => ({
red: jest.fn(text => text), red: jest.fn((text) => text),
blue: jest.fn(text => text), blue: jest.fn((text) => text),
green: jest.fn(text => text), green: jest.fn((text) => text),
yellow: jest.fn(text => text), yellow: jest.fn((text) => text),
white: jest.fn(text => ({ white: jest.fn((text) => ({
bold: jest.fn(text => text) bold: jest.fn((text) => text)
})), })),
reset: jest.fn(text => text) reset: jest.fn((text) => text)
})); }));
jest.mock('../../scripts/modules/ui.js', () => ({ jest.mock('../../scripts/modules/ui.js', () => ({
@@ -110,8 +110,12 @@ describe('Commands Module', () => {
const mockExistsSync = jest.spyOn(fs, 'existsSync'); const mockExistsSync = jest.spyOn(fs, 'existsSync');
const mockReadFileSync = jest.spyOn(fs, 'readFileSync'); const mockReadFileSync = jest.spyOn(fs, 'readFileSync');
const mockJoin = jest.spyOn(path, 'join'); const mockJoin = jest.spyOn(path, 'join');
const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation(() => {}); const mockConsoleLog = jest
const mockConsoleError = jest.spyOn(console, 'error').mockImplementation(() => {}); .spyOn(console, 'log')
.mockImplementation(() => {});
const mockConsoleError = jest
.spyOn(console, 'error')
.mockImplementation(() => {});
const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => {}); const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => {});
beforeEach(() => { beforeEach(() => {
@@ -166,10 +170,9 @@ describe('Commands Module', () => {
describe('Kebab Case Validation', () => { describe('Kebab Case Validation', () => {
test('should detect camelCase flags correctly', () => { test('should detect camelCase flags correctly', () => {
const args = ['node', 'task-master', '--camelCase', '--kebab-case']; const args = ['node', 'task-master', '--camelCase', '--kebab-case'];
const camelCaseFlags = args.filter(arg => const camelCaseFlags = args.filter(
arg.startsWith('--') && (arg) =>
/[A-Z]/.test(arg) && arg.startsWith('--') && /[A-Z]/.test(arg) && !arg.includes('-[A-Z]')
!arg.includes('-[A-Z]')
); );
expect(camelCaseFlags).toContain('--camelCase'); expect(camelCaseFlags).toContain('--camelCase');
expect(camelCaseFlags).not.toContain('--kebab-case'); expect(camelCaseFlags).not.toContain('--kebab-case');
@@ -177,10 +180,9 @@ describe('Commands Module', () => {
test('should accept kebab-case flags correctly', () => { test('should accept kebab-case flags correctly', () => {
const args = ['node', 'task-master', '--kebab-case']; const args = ['node', 'task-master', '--kebab-case'];
const camelCaseFlags = args.filter(arg => const camelCaseFlags = args.filter(
arg.startsWith('--') && (arg) =>
/[A-Z]/.test(arg) && arg.startsWith('--') && /[A-Z]/.test(arg) && !arg.includes('-[A-Z]')
!arg.includes('-[A-Z]')
); );
expect(camelCaseFlags).toHaveLength(0); expect(camelCaseFlags).toHaveLength(0);
}); });
@@ -206,7 +208,11 @@ describe('Commands Module', () => {
return; return;
} }
console.log(chalk.yellow('No PRD file specified and default PRD file not found at scripts/prd.txt.')); console.log(
chalk.yellow(
'No PRD file specified and default PRD file not found at scripts/prd.txt.'
)
);
return; return;
} }
@@ -229,11 +235,16 @@ describe('Commands Module', () => {
mockExistsSync.mockReturnValue(true); mockExistsSync.mockReturnValue(true);
// Act - call the handler directly with the right params // Act - call the handler directly with the right params
await parsePrdAction(undefined, { numTasks: '10', output: 'tasks/tasks.json' }); await parsePrdAction(undefined, {
numTasks: '10',
output: 'tasks/tasks.json'
});
// Assert // Assert
expect(mockExistsSync).toHaveBeenCalledWith('scripts/prd.txt'); expect(mockExistsSync).toHaveBeenCalledWith('scripts/prd.txt');
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Using default PRD file')); expect(mockConsoleLog).toHaveBeenCalledWith(
expect.stringContaining('Using default PRD file')
);
expect(mockParsePRD).toHaveBeenCalledWith( expect(mockParsePRD).toHaveBeenCalledWith(
'scripts/prd.txt', 'scripts/prd.txt',
'tasks/tasks.json', 'tasks/tasks.json',
@@ -246,10 +257,15 @@ describe('Commands Module', () => {
mockExistsSync.mockReturnValue(false); mockExistsSync.mockReturnValue(false);
// Act - call the handler directly with the right params // Act - call the handler directly with the right params
await parsePrdAction(undefined, { numTasks: '10', output: 'tasks/tasks.json' }); await parsePrdAction(undefined, {
numTasks: '10',
output: 'tasks/tasks.json'
});
// Assert // Assert
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('No PRD file specified')); expect(mockConsoleLog).toHaveBeenCalledWith(
expect.stringContaining('No PRD file specified')
);
expect(mockParsePRD).not.toHaveBeenCalled(); expect(mockParsePRD).not.toHaveBeenCalled();
}); });
@@ -258,11 +274,20 @@ describe('Commands Module', () => {
const testFile = 'test/prd.txt'; const testFile = 'test/prd.txt';
// Act - call the handler directly with the right params // Act - call the handler directly with the right params
await parsePrdAction(testFile, { numTasks: '10', output: 'tasks/tasks.json' }); await parsePrdAction(testFile, {
numTasks: '10',
output: 'tasks/tasks.json'
});
// Assert // Assert
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining(`Parsing PRD file: ${testFile}`)); expect(mockConsoleLog).toHaveBeenCalledWith(
expect(mockParsePRD).toHaveBeenCalledWith(testFile, 'tasks/tasks.json', 10); expect.stringContaining(`Parsing PRD file: ${testFile}`)
);
expect(mockParsePRD).toHaveBeenCalledWith(
testFile,
'tasks/tasks.json',
10
);
expect(mockExistsSync).not.toHaveBeenCalledWith('scripts/prd.txt'); expect(mockExistsSync).not.toHaveBeenCalledWith('scripts/prd.txt');
}); });
@@ -271,11 +296,21 @@ describe('Commands Module', () => {
const testFile = 'test/prd.txt'; const testFile = 'test/prd.txt';
// Act - call the handler directly with the right params // Act - call the handler directly with the right params
await parsePrdAction(undefined, { input: testFile, numTasks: '10', output: 'tasks/tasks.json' }); await parsePrdAction(undefined, {
input: testFile,
numTasks: '10',
output: 'tasks/tasks.json'
});
// Assert // Assert
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining(`Parsing PRD file: ${testFile}`)); expect(mockConsoleLog).toHaveBeenCalledWith(
expect(mockParsePRD).toHaveBeenCalledWith(testFile, 'tasks/tasks.json', 10); expect.stringContaining(`Parsing PRD file: ${testFile}`)
);
expect(mockParsePRD).toHaveBeenCalledWith(
testFile,
'tasks/tasks.json',
10
);
expect(mockExistsSync).not.toHaveBeenCalledWith('scripts/prd.txt'); expect(mockExistsSync).not.toHaveBeenCalledWith('scripts/prd.txt');
}); });
@@ -286,7 +321,10 @@ describe('Commands Module', () => {
const numTasks = 15; const numTasks = 15;
// Act - call the handler directly with the right params // Act - call the handler directly with the right params
await parsePrdAction(testFile, { numTasks: numTasks.toString(), output: outputFile }); await parsePrdAction(testFile, {
numTasks: numTasks.toString(),
output: outputFile
});
// Assert // Assert
expect(mockParsePRD).toHaveBeenCalledWith(testFile, outputFile, numTasks); expect(mockParsePRD).toHaveBeenCalledWith(testFile, outputFile, numTasks);
@@ -303,7 +341,11 @@ describe('Commands Module', () => {
// Validate required parameters // Validate required parameters
if (!options.id) { if (!options.id) {
console.error(chalk.red('Error: --id parameter is required')); console.error(chalk.red('Error: --id parameter is required'));
console.log(chalk.yellow('Usage example: task-master update-task --id=23 --prompt="Update with new information"')); console.log(
chalk.yellow(
'Usage example: task-master update-task --id=23 --prompt="Update with new information"'
)
);
process.exit(1); process.exit(1);
return; // Add early return to prevent calling updateTaskById return; // Add early return to prevent calling updateTaskById
} }
@@ -311,15 +353,31 @@ describe('Commands Module', () => {
// Parse the task ID and validate it's a number // Parse the task ID and validate it's a number
const taskId = parseInt(options.id, 10); const taskId = parseInt(options.id, 10);
if (isNaN(taskId) || taskId <= 0) { if (isNaN(taskId) || taskId <= 0) {
console.error(chalk.red(`Error: Invalid task ID: ${options.id}. Task ID must be a positive integer.`)); console.error(
console.log(chalk.yellow('Usage example: task-master update-task --id=23 --prompt="Update with new information"')); chalk.red(
`Error: Invalid task ID: ${options.id}. Task ID must be a positive integer.`
)
);
console.log(
chalk.yellow(
'Usage example: task-master update-task --id=23 --prompt="Update with new information"'
)
);
process.exit(1); process.exit(1);
return; // Add early return to prevent calling updateTaskById return; // Add early return to prevent calling updateTaskById
} }
if (!options.prompt) { if (!options.prompt) {
console.error(chalk.red('Error: --prompt parameter is required. Please provide information about the changes.')); console.error(
console.log(chalk.yellow('Usage example: task-master update-task --id=23 --prompt="Update with new information"')); chalk.red(
'Error: --prompt parameter is required. Please provide information about the changes.'
)
);
console.log(
chalk.yellow(
'Usage example: task-master update-task --id=23 --prompt="Update with new information"'
)
);
process.exit(1); process.exit(1);
return; // Add early return to prevent calling updateTaskById return; // Add early return to prevent calling updateTaskById
} }
@@ -329,48 +387,87 @@ describe('Commands Module', () => {
// Validate tasks file exists // Validate tasks file exists
if (!fs.existsSync(tasksPath)) { if (!fs.existsSync(tasksPath)) {
console.error(chalk.red(`Error: Tasks file not found at path: ${tasksPath}`)); console.error(
chalk.red(`Error: Tasks file not found at path: ${tasksPath}`)
);
if (tasksPath === 'tasks/tasks.json') { if (tasksPath === 'tasks/tasks.json') {
console.log(chalk.yellow('Hint: Run task-master init or task-master parse-prd to create tasks.json first')); console.log(
chalk.yellow(
'Hint: Run task-master init or task-master parse-prd to create tasks.json first'
)
);
} else { } else {
console.log(chalk.yellow(`Hint: Check if the file path is correct: ${tasksPath}`)); console.log(
chalk.yellow(
`Hint: Check if the file path is correct: ${tasksPath}`
)
);
} }
process.exit(1); process.exit(1);
return; // Add early return to prevent calling updateTaskById return; // Add early return to prevent calling updateTaskById
} }
console.log(chalk.blue(`Updating task ${taskId} with prompt: "${prompt}"`)); console.log(
chalk.blue(`Updating task ${taskId} with prompt: "${prompt}"`)
);
console.log(chalk.blue(`Tasks file: ${tasksPath}`)); console.log(chalk.blue(`Tasks file: ${tasksPath}`));
if (useResearch) { if (useResearch) {
// Verify Perplexity API key exists if using research // Verify Perplexity API key exists if using research
if (!process.env.PERPLEXITY_API_KEY) { if (!process.env.PERPLEXITY_API_KEY) {
console.log(chalk.yellow('Warning: PERPLEXITY_API_KEY environment variable is missing. Research-backed updates will not be available.')); console.log(
console.log(chalk.yellow('Falling back to Claude AI for task update.')); chalk.yellow(
'Warning: PERPLEXITY_API_KEY environment variable is missing. Research-backed updates will not be available.'
)
);
console.log(
chalk.yellow('Falling back to Claude AI for task update.')
);
} else { } else {
console.log(chalk.blue('Using Perplexity AI for research-backed task update')); console.log(
chalk.blue('Using Perplexity AI for research-backed task update')
);
} }
} }
const result = await mockUpdateTaskById(tasksPath, taskId, prompt, useResearch); const result = await mockUpdateTaskById(
tasksPath,
taskId,
prompt,
useResearch
);
// If the task wasn't updated (e.g., if it was already marked as done) // If the task wasn't updated (e.g., if it was already marked as done)
if (!result) { if (!result) {
console.log(chalk.yellow('\nTask update was not completed. Review the messages above for details.')); console.log(
chalk.yellow(
'\nTask update was not completed. Review the messages above for details.'
)
);
} }
} catch (error) { } catch (error) {
console.error(chalk.red(`Error: ${error.message}`)); console.error(chalk.red(`Error: ${error.message}`));
// Provide more helpful error messages for common issues // Provide more helpful error messages for common issues
if (error.message.includes('task') && error.message.includes('not found')) { if (
error.message.includes('task') &&
error.message.includes('not found')
) {
console.log(chalk.yellow('\nTo fix this issue:')); console.log(chalk.yellow('\nTo fix this issue:'));
console.log(' 1. Run task-master list to see all available task IDs'); console.log(
' 1. Run task-master list to see all available task IDs'
);
console.log(' 2. Use a valid task ID with the --id parameter'); console.log(' 2. Use a valid task ID with the --id parameter');
} else if (error.message.includes('API key')) { } else if (error.message.includes('API key')) {
console.log(chalk.yellow('\nThis error is related to API keys. Check your environment variables.')); console.log(
chalk.yellow(
'\nThis error is related to API keys. Check your environment variables.'
)
);
} }
if (true) { // CONFIG.debug if (true) {
// CONFIG.debug
console.error(error); console.error(error);
} }
@@ -397,7 +494,9 @@ describe('Commands Module', () => {
await updateTaskAction(options); await updateTaskAction(options);
// Verify validation error // Verify validation error
expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining('--id parameter is required')); expect(mockConsoleError).toHaveBeenCalledWith(
expect.stringContaining('--id parameter is required')
);
expect(mockExit).toHaveBeenCalledWith(1); expect(mockExit).toHaveBeenCalledWith(1);
expect(mockUpdateTaskById).not.toHaveBeenCalled(); expect(mockUpdateTaskById).not.toHaveBeenCalled();
}); });
@@ -414,7 +513,9 @@ describe('Commands Module', () => {
await updateTaskAction(options); await updateTaskAction(options);
// Verify validation error // Verify validation error
expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining('Invalid task ID')); expect(mockConsoleError).toHaveBeenCalledWith(
expect.stringContaining('Invalid task ID')
);
expect(mockExit).toHaveBeenCalledWith(1); expect(mockExit).toHaveBeenCalledWith(1);
expect(mockUpdateTaskById).not.toHaveBeenCalled(); expect(mockUpdateTaskById).not.toHaveBeenCalled();
}); });
@@ -430,7 +531,9 @@ describe('Commands Module', () => {
await updateTaskAction(options); await updateTaskAction(options);
// Verify validation error // Verify validation error
expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining('--prompt parameter is required')); expect(mockConsoleError).toHaveBeenCalledWith(
expect.stringContaining('--prompt parameter is required')
);
expect(mockExit).toHaveBeenCalledWith(1); expect(mockExit).toHaveBeenCalledWith(1);
expect(mockUpdateTaskById).not.toHaveBeenCalled(); expect(mockUpdateTaskById).not.toHaveBeenCalled();
}); });
@@ -450,7 +553,9 @@ describe('Commands Module', () => {
await updateTaskAction(options); await updateTaskAction(options);
// Verify validation error // Verify validation error
expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining('Tasks file not found')); expect(mockConsoleError).toHaveBeenCalledWith(
expect.stringContaining('Tasks file not found')
);
expect(mockExit).toHaveBeenCalledWith(1); expect(mockExit).toHaveBeenCalledWith(1);
expect(mockUpdateTaskById).not.toHaveBeenCalled(); expect(mockUpdateTaskById).not.toHaveBeenCalled();
}); });
@@ -479,8 +584,12 @@ describe('Commands Module', () => {
); );
// Verify console output // Verify console output
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Updating task 2')); expect(mockConsoleLog).toHaveBeenCalledWith(
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Using Perplexity AI')); expect.stringContaining('Updating task 2')
);
expect(mockConsoleLog).toHaveBeenCalledWith(
expect.stringContaining('Using Perplexity AI')
);
// Clean up // Clean up
delete process.env.PERPLEXITY_API_KEY; delete process.env.PERPLEXITY_API_KEY;
@@ -504,7 +613,9 @@ describe('Commands Module', () => {
expect(mockUpdateTaskById).toHaveBeenCalled(); expect(mockUpdateTaskById).toHaveBeenCalled();
// Verify console output for null result // Verify console output for null result
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Task update was not completed')); expect(mockConsoleLog).toHaveBeenCalledWith(
expect.stringContaining('Task update was not completed')
);
}); });
test('should handle errors from updateTaskById', async () => { test('should handle errors from updateTaskById', async () => {
@@ -522,7 +633,9 @@ describe('Commands Module', () => {
await updateTaskAction(options); await updateTaskAction(options);
// Verify error handling // Verify error handling
expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining('Error: Task update failed')); expect(mockConsoleError).toHaveBeenCalledWith(
expect.stringContaining('Error: Task update failed')
);
expect(mockExit).toHaveBeenCalledWith(1); expect(mockExit).toHaveBeenCalledWith(1);
}); });
}); });

View File

@@ -17,17 +17,17 @@ import { sampleTasks } from '../fixtures/sample-tasks.js';
// Mock dependencies // Mock dependencies
jest.mock('path'); jest.mock('path');
jest.mock('chalk', () => ({ jest.mock('chalk', () => ({
green: jest.fn(text => `<green>${text}</green>`), green: jest.fn((text) => `<green>${text}</green>`),
yellow: jest.fn(text => `<yellow>${text}</yellow>`), yellow: jest.fn((text) => `<yellow>${text}</yellow>`),
red: jest.fn(text => `<red>${text}</red>`), red: jest.fn((text) => `<red>${text}</red>`),
cyan: jest.fn(text => `<cyan>${text}</cyan>`), cyan: jest.fn((text) => `<cyan>${text}</cyan>`),
bold: jest.fn(text => `<bold>${text}</bold>`), bold: jest.fn((text) => `<bold>${text}</bold>`)
})); }));
jest.mock('boxen', () => jest.fn(text => `[boxed: ${text}]`)); jest.mock('boxen', () => jest.fn((text) => `[boxed: ${text}]`));
jest.mock('@anthropic-ai/sdk', () => ({ jest.mock('@anthropic-ai/sdk', () => ({
Anthropic: jest.fn().mockImplementation(() => ({})), Anthropic: jest.fn().mockImplementation(() => ({}))
})); }));
// Mock utils module // Mock utils module
@@ -48,11 +48,11 @@ jest.mock('../../scripts/modules/utils.js', () => ({
})); }));
jest.mock('../../scripts/modules/ui.js', () => ({ jest.mock('../../scripts/modules/ui.js', () => ({
displayBanner: jest.fn(), displayBanner: jest.fn()
})); }));
jest.mock('../../scripts/modules/task-manager.js', () => ({ jest.mock('../../scripts/modules/task-manager.js', () => ({
generateTaskFiles: jest.fn(), generateTaskFiles: jest.fn()
})); }));
// Create a path for test files // Create a path for test files
@@ -67,15 +67,21 @@ describe('Dependency Manager Module', () => {
if (Array.isArray(tasks)) { if (Array.isArray(tasks)) {
if (typeof id === 'string' && id.includes('.')) { if (typeof id === 'string' && id.includes('.')) {
const [taskId, subtaskId] = id.split('.').map(Number); const [taskId, subtaskId] = id.split('.').map(Number);
const task = tasks.find(t => t.id === taskId); const task = tasks.find((t) => t.id === taskId);
return task && task.subtasks && task.subtasks.some(st => st.id === subtaskId); return (
task &&
task.subtasks &&
task.subtasks.some((st) => st.id === subtaskId)
);
} }
return tasks.some(task => task.id === (typeof id === 'string' ? parseInt(id, 10) : id)); return tasks.some(
(task) => task.id === (typeof id === 'string' ? parseInt(id, 10) : id)
);
} }
return false; return false;
}); });
mockFormatTaskId.mockImplementation(id => { mockFormatTaskId.mockImplementation((id) => {
if (typeof id === 'string' && id.includes('.')) { if (typeof id === 'string' && id.includes('.')) {
return id; return id;
} }
@@ -87,7 +93,7 @@ describe('Dependency Manager Module', () => {
const dependencyMap = new Map(); const dependencyMap = new Map();
// Build dependency map // Build dependency map
tasks.forEach(task => { tasks.forEach((task) => {
if (task.dependencies) { if (task.dependencies) {
dependencyMap.set(task.id, task.dependencies); dependencyMap.set(task.id, task.dependencies);
} }
@@ -168,9 +174,7 @@ describe('Dependency Manager Module', () => {
}); });
test('should handle a task depending on itself', () => { test('should handle a task depending on itself', () => {
const tasks = [ const tasks = [{ id: 1, dependencies: [1] }];
{ id: 1, dependencies: [1] }
];
const result = isCircularDependency(tasks, 1); const result = isCircularDependency(tasks, 1);
expect(result).toBe(true); expect(result).toBe(true);
@@ -182,15 +186,15 @@ describe('Dependency Manager Module', () => {
id: 1, id: 1,
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: ["1.2"] }, { id: 1, dependencies: ['1.2'] },
{ id: 2, dependencies: ["1.3"] }, { id: 2, dependencies: ['1.3'] },
{ id: 3, dependencies: ["1.1"] } { id: 3, dependencies: ['1.1'] }
] ]
} }
]; ];
// This creates a circular dependency: 1.1 -> 1.2 -> 1.3 -> 1.1 // This creates a circular dependency: 1.1 -> 1.2 -> 1.3 -> 1.1
const result = isCircularDependency(tasks, "1.1", ["1.3", "1.2"]); const result = isCircularDependency(tasks, '1.1', ['1.3', '1.2']);
expect(result).toBe(true); expect(result).toBe(true);
}); });
@@ -201,14 +205,14 @@ describe('Dependency Manager Module', () => {
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: [] }, { id: 1, dependencies: [] },
{ id: 2, dependencies: ["1.1"] }, { id: 2, dependencies: ['1.1'] },
{ id: 3, dependencies: ["1.2"] } { id: 3, dependencies: ['1.2'] }
] ]
} }
]; ];
// This is a valid dependency chain: 1.3 -> 1.2 -> 1.1 // This is a valid dependency chain: 1.3 -> 1.2 -> 1.1
const result = isCircularDependency(tasks, "1.1", []); const result = isCircularDependency(tasks, '1.1', []);
expect(result).toBe(false); expect(result).toBe(false);
}); });
@@ -219,7 +223,7 @@ describe('Dependency Manager Module', () => {
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: [] }, { id: 1, dependencies: [] },
{ id: 2, dependencies: ["1.1"] }, { id: 2, dependencies: ['1.1'] },
{ id: 3, dependencies: [] } { id: 3, dependencies: [] }
] ]
} }
@@ -228,7 +232,7 @@ describe('Dependency Manager Module', () => {
// Check if adding a dependency from subtask 1.3 to 1.2 creates a circular dependency // Check if adding a dependency from subtask 1.3 to 1.2 creates a circular dependency
// This should be false as 1.3 -> 1.2 -> 1.1 is a valid chain // This should be false as 1.3 -> 1.2 -> 1.1 is a valid chain
mockTaskExists.mockImplementation(() => true); mockTaskExists.mockImplementation(() => true);
const result = isCircularDependency(tasks, "1.3", ["1.2"]); const result = isCircularDependency(tasks, '1.3', ['1.2']);
expect(result).toBe(false); expect(result).toBe(false);
}); });
@@ -238,16 +242,16 @@ describe('Dependency Manager Module', () => {
id: 1, id: 1,
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: ["1.3"] }, { id: 1, dependencies: ['1.3'] },
{ id: 2, dependencies: ["1.1"] }, { id: 2, dependencies: ['1.1'] },
{ id: 3, dependencies: ["1.2"] } { id: 3, dependencies: ['1.2'] }
] ]
} }
]; ];
// This creates a circular dependency: 1.1 -> 1.3 -> 1.2 -> 1.1 // This creates a circular dependency: 1.1 -> 1.3 -> 1.2 -> 1.1
mockTaskExists.mockImplementation(() => true); mockTaskExists.mockImplementation(() => true);
const result = isCircularDependency(tasks, "1.2", ["1.1"]); const result = isCircularDependency(tasks, '1.2', ['1.1']);
expect(result).toBe(true); expect(result).toBe(true);
}); });
}); });
@@ -277,20 +281,22 @@ describe('Dependency Manager Module', () => {
const result = validateTaskDependencies(tasks); const result = validateTaskDependencies(tasks);
expect(result.valid).toBe(false); expect(result.valid).toBe(false);
expect(result.issues.some(issue => issue.type === 'circular')).toBe(true); expect(result.issues.some((issue) => issue.type === 'circular')).toBe(
true
);
}); });
test('should detect self-dependencies', () => { test('should detect self-dependencies', () => {
const tasks = [ const tasks = [{ id: 1, dependencies: [1] }];
{ id: 1, dependencies: [1] }
];
const result = validateTaskDependencies(tasks); const result = validateTaskDependencies(tasks);
expect(result.valid).toBe(false); expect(result.valid).toBe(false);
expect(result.issues.some(issue => expect(
issue.type === 'self' && issue.taskId === 1 result.issues.some(
)).toBe(true); (issue) => issue.type === 'self' && issue.taskId === 1
)
).toBe(true);
}); });
test('should return valid for correct dependencies', () => { test('should return valid for correct dependencies', () => {
@@ -325,13 +331,13 @@ describe('Dependency Manager Module', () => {
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: [] }, { id: 1, dependencies: [] },
{ id: 2, dependencies: ["1.1"] }, // Valid - depends on another subtask { id: 2, dependencies: ['1.1'] }, // Valid - depends on another subtask
{ id: 3, dependencies: ["1.2"] } // Valid - depends on another subtask { id: 3, dependencies: ['1.2'] } // Valid - depends on another subtask
] ]
}, },
{ {
id: 2, id: 2,
dependencies: ["1.3"], // Valid - depends on a subtask from task 1 dependencies: ['1.3'], // Valid - depends on a subtask from task 1
subtasks: [] subtasks: []
} }
]; ];
@@ -340,10 +346,14 @@ describe('Dependency Manager Module', () => {
mockTaskExists.mockImplementation((tasks, id) => { mockTaskExists.mockImplementation((tasks, id) => {
if (typeof id === 'string' && id.includes('.')) { if (typeof id === 'string' && id.includes('.')) {
const [taskId, subtaskId] = id.split('.').map(Number); const [taskId, subtaskId] = id.split('.').map(Number);
const task = tasks.find(t => t.id === taskId); const task = tasks.find((t) => t.id === taskId);
return task && task.subtasks && task.subtasks.some(st => st.id === subtaskId); return (
task &&
task.subtasks &&
task.subtasks.some((st) => st.id === subtaskId)
);
} }
return tasks.some(task => task.id === parseInt(id, 10)); return tasks.some((task) => task.id === parseInt(id, 10));
}); });
const result = validateTaskDependencies(tasks); const result = validateTaskDependencies(tasks);
@@ -358,8 +368,8 @@ describe('Dependency Manager Module', () => {
id: 1, id: 1,
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: ["1.4"] }, // Invalid - subtask 4 doesn't exist { id: 1, dependencies: ['1.4'] }, // Invalid - subtask 4 doesn't exist
{ id: 2, dependencies: ["2.1"] } // Invalid - task 2 has no subtasks { id: 2, dependencies: ['2.1'] } // Invalid - task 2 has no subtasks
] ]
}, },
{ {
@@ -371,10 +381,10 @@ describe('Dependency Manager Module', () => {
// Mock taskExists to correctly identify missing subtasks // Mock taskExists to correctly identify missing subtasks
mockTaskExists.mockImplementation((taskArray, depId) => { mockTaskExists.mockImplementation((taskArray, depId) => {
if (typeof depId === 'string' && depId === "1.4") { if (typeof depId === 'string' && depId === '1.4') {
return false; // Subtask 1.4 doesn't exist return false; // Subtask 1.4 doesn't exist
} }
if (typeof depId === 'string' && depId === "2.1") { if (typeof depId === 'string' && depId === '2.1') {
return false; // Subtask 2.1 doesn't exist return false; // Subtask 2.1 doesn't exist
} }
return true; // All other dependencies exist return true; // All other dependencies exist
@@ -385,9 +395,14 @@ describe('Dependency Manager Module', () => {
expect(result.valid).toBe(false); expect(result.valid).toBe(false);
expect(result.issues.length).toBeGreaterThan(0); expect(result.issues.length).toBeGreaterThan(0);
// Should detect missing subtask dependencies // Should detect missing subtask dependencies
expect(result.issues.some(issue => expect(
issue.type === 'missing' && String(issue.taskId) === "1.1" && String(issue.dependencyId) === "1.4" result.issues.some(
)).toBe(true); (issue) =>
issue.type === 'missing' &&
String(issue.taskId) === '1.1' &&
String(issue.dependencyId) === '1.4'
)
).toBe(true);
}); });
test('should detect circular dependencies between subtasks', () => { test('should detect circular dependencies between subtasks', () => {
@@ -396,8 +411,8 @@ describe('Dependency Manager Module', () => {
id: 1, id: 1,
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 1, dependencies: ["1.2"] }, { id: 1, dependencies: ['1.2'] },
{ id: 2, dependencies: ["1.1"] } // Creates a circular dependency with 1.1 { id: 2, dependencies: ['1.1'] } // Creates a circular dependency with 1.1
] ]
} }
]; ];
@@ -408,7 +423,9 @@ describe('Dependency Manager Module', () => {
const result = validateTaskDependencies(tasks); const result = validateTaskDependencies(tasks);
expect(result.valid).toBe(false); expect(result.valid).toBe(false);
expect(result.issues.some(issue => issue.type === 'circular')).toBe(true); expect(result.issues.some((issue) => issue.type === 'circular')).toBe(
true
);
}); });
test('should properly validate dependencies between subtasks of the same parent', () => { test('should properly validate dependencies between subtasks of the same parent', () => {
@@ -417,8 +434,8 @@ describe('Dependency Manager Module', () => {
id: 23, id: 23,
dependencies: [], dependencies: [],
subtasks: [ subtasks: [
{ id: 8, dependencies: ["23.13"] }, { id: 8, dependencies: ['23.13'] },
{ id: 10, dependencies: ["23.8"] }, { id: 10, dependencies: ['23.8'] },
{ id: 13, dependencies: [] } { id: 13, dependencies: [] }
] ]
} }
@@ -427,7 +444,7 @@ describe('Dependency Manager Module', () => {
// Mock taskExists to validate the subtask dependencies // Mock taskExists to validate the subtask dependencies
mockTaskExists.mockImplementation((taskArray, id) => { mockTaskExists.mockImplementation((taskArray, id) => {
if (typeof id === 'string') { if (typeof id === 'string') {
if (id === "23.8" || id === "23.10" || id === "23.13") { if (id === '23.8' || id === '23.10' || id === '23.13') {
return true; return true;
} }
} }
@@ -576,37 +593,27 @@ describe('Dependency Manager Module', () => {
test('should handle tasks without subtasks', () => { test('should handle tasks without subtasks', () => {
const tasksData = { const tasksData = {
tasks: [ tasks: [{ id: 1 }, { id: 2, dependencies: [1] }]
{ id: 1 },
{ id: 2, dependencies: [1] }
]
}; };
const result = ensureAtLeastOneIndependentSubtask(tasksData); const result = ensureAtLeastOneIndependentSubtask(tasksData);
expect(result).toBe(false); expect(result).toBe(false);
expect(tasksData).toEqual({ expect(tasksData).toEqual({
tasks: [ tasks: [{ id: 1 }, { id: 2, dependencies: [1] }]
{ id: 1 },
{ id: 2, dependencies: [1] }
]
}); });
}); });
test('should handle empty subtasks array', () => { test('should handle empty subtasks array', () => {
const tasksData = { const tasksData = {
tasks: [ tasks: [{ id: 1, subtasks: [] }]
{ id: 1, subtasks: [] }
]
}; };
const result = ensureAtLeastOneIndependentSubtask(tasksData); const result = ensureAtLeastOneIndependentSubtask(tasksData);
expect(result).toBe(false); expect(result).toBe(false);
expect(tasksData).toEqual({ expect(tasksData).toEqual({
tasks: [ tasks: [{ id: 1, subtasks: [] }]
{ id: 1, subtasks: [] }
]
}); });
}); });
}); });
@@ -641,8 +648,12 @@ describe('Dependency Manager Module', () => {
// Handle subtask references (e.g., "1.2") // Handle subtask references (e.g., "1.2")
if (idStr.includes('.')) { if (idStr.includes('.')) {
const [parentId, subtaskId] = idStr.split('.').map(Number); const [parentId, subtaskId] = idStr.split('.').map(Number);
const task = tasks.find(t => t.id === parentId); const task = tasks.find((t) => t.id === parentId);
return task && task.subtasks && task.subtasks.some(st => st.id === subtaskId); return (
task &&
task.subtasks &&
task.subtasks.some((st) => st.id === subtaskId)
);
} }
// Handle regular task references // Handle regular task references
@@ -674,7 +685,10 @@ describe('Dependency Manager Module', () => {
expect(tasksData.tasks[1].subtasks[0].dependencies).toEqual([]); expect(tasksData.tasks[1].subtasks[0].dependencies).toEqual([]);
// IMPORTANT: Verify no calls to writeJSON with actual tasks.json // IMPORTANT: Verify no calls to writeJSON with actual tasks.json
expect(mockWriteJSON).not.toHaveBeenCalledWith('tasks/tasks.json', expect.anything()); expect(mockWriteJSON).not.toHaveBeenCalledWith(
'tasks/tasks.json',
expect.anything()
);
}); });
test('should return false if no changes needed', () => { test('should return false if no changes needed', () => {
@@ -703,8 +717,12 @@ describe('Dependency Manager Module', () => {
// Handle subtask references // Handle subtask references
if (idStr.includes('.')) { if (idStr.includes('.')) {
const [parentId, subtaskId] = idStr.split('.').map(Number); const [parentId, subtaskId] = idStr.split('.').map(Number);
const task = tasks.find(t => t.id === parentId); const task = tasks.find((t) => t.id === parentId);
return task && task.subtasks && task.subtasks.some(st => st.id === subtaskId); return (
task &&
task.subtasks &&
task.subtasks.some((st) => st.id === subtaskId)
);
} }
// Handle regular task references // Handle regular task references
@@ -720,7 +738,10 @@ describe('Dependency Manager Module', () => {
expect(tasksData).toEqual(originalData); expect(tasksData).toEqual(originalData);
// IMPORTANT: Verify no calls to writeJSON with actual tasks.json // IMPORTANT: Verify no calls to writeJSON with actual tasks.json
expect(mockWriteJSON).not.toHaveBeenCalledWith('tasks/tasks.json', expect.anything()); expect(mockWriteJSON).not.toHaveBeenCalledWith(
'tasks/tasks.json',
expect.anything()
);
}); });
test('should handle invalid input', () => { test('should handle invalid input', () => {
@@ -730,7 +751,10 @@ describe('Dependency Manager Module', () => {
expect(validateAndFixDependencies({ tasks: 'not an array' })).toBe(false); expect(validateAndFixDependencies({ tasks: 'not an array' })).toBe(false);
// IMPORTANT: Verify no calls to writeJSON with actual tasks.json // IMPORTANT: Verify no calls to writeJSON with actual tasks.json
expect(mockWriteJSON).not.toHaveBeenCalledWith('tasks/tasks.json', expect.anything()); expect(mockWriteJSON).not.toHaveBeenCalledWith(
'tasks/tasks.json',
expect.anything()
);
}); });
test('should save changes when tasksPath is provided', () => { test('should save changes when tasksPath is provided', () => {
@@ -754,8 +778,12 @@ describe('Dependency Manager Module', () => {
// Handle subtask references // Handle subtask references
if (idStr.includes('.')) { if (idStr.includes('.')) {
const [parentId, subtaskId] = idStr.split('.').map(Number); const [parentId, subtaskId] = idStr.split('.').map(Number);
const task = tasks.find(t => t.id === parentId); const task = tasks.find((t) => t.id === parentId);
return task && task.subtasks && task.subtasks.some(st => st.id === subtaskId); return (
task &&
task.subtasks &&
task.subtasks.some((st) => st.id === subtaskId)
);
} }
// Handle regular task references // Handle regular task references
@@ -776,7 +804,10 @@ describe('Dependency Manager Module', () => {
expect(tasksData).not.toEqual(originalData); expect(tasksData).not.toEqual(originalData);
// IMPORTANT: Verify no calls to writeJSON with actual tasks.json // IMPORTANT: Verify no calls to writeJSON with actual tasks.json
expect(mockWriteJSON).not.toHaveBeenCalledWith('tasks/tasks.json', expect.anything()); expect(mockWriteJSON).not.toHaveBeenCalledWith(
'tasks/tasks.json',
expect.anything()
);
}); });
}); });
}); });

View File

@@ -77,7 +77,8 @@ describe('Windsurf Rules File Handling', () => {
if (fs.existsSync(targetPath)) { if (fs.existsSync(targetPath)) {
// Should append content when file exists // Should append content when file exists
const existingContent = fs.readFileSync(targetPath, 'utf8'); const existingContent = fs.readFileSync(targetPath, 'utf8');
const updatedContent = existingContent.trim() + const updatedContent =
existingContent.trim() +
'\n\n# Added by Claude Task Master - Development Workflow Rules\n\n' + '\n\n# Added by Claude Task Master - Development Workflow Rules\n\n' +
'New content'; 'New content';
fs.writeFileSync(targetPath, updatedContent); fs.writeFileSync(targetPath, updatedContent);
@@ -131,7 +132,10 @@ describe('Windsurf Rules File Handling', () => {
// Mock implementation of createProjectStructure // Mock implementation of createProjectStructure
function mockCreateProjectStructure(projectName) { function mockCreateProjectStructure(projectName) {
// Copy template files including .windsurfrules // Copy template files including .windsurfrules
mockCopyTemplateFile('windsurfrules', path.join(tempDir, '.windsurfrules')); mockCopyTemplateFile(
'windsurfrules',
path.join(tempDir, '.windsurfrules')
);
} }
// Act - call our mock implementation // Act - call our mock implementation
@@ -160,10 +164,10 @@ describe('MCP Configuration Handling', () => {
jest.spyOn(fs, 'readFileSync').mockImplementation((filePath) => { jest.spyOn(fs, 'readFileSync').mockImplementation((filePath) => {
if (filePath.toString().includes('mcp.json')) { if (filePath.toString().includes('mcp.json')) {
return JSON.stringify({ return JSON.stringify({
"mcpServers": { mcpServers: {
"existing-server": { 'existing-server': {
"command": "node", command: 'node',
"args": ["server.js"] args: ['server.js']
} }
} }
}); });
@@ -203,12 +207,9 @@ describe('MCP Configuration Handling', () => {
// New MCP config to be added - references the installed package // New MCP config to be added - references the installed package
const newMCPServer = { const newMCPServer = {
"task-master-ai": { 'task-master-ai': {
"command": "npx", command: 'npx',
"args": [ args: ['task-master-ai', 'mcp-server']
"task-master-ai",
"mcp-server"
]
} }
}; };
@@ -224,19 +225,17 @@ describe('MCP Configuration Handling', () => {
} }
// Add the taskmaster-ai server if it doesn't exist // Add the taskmaster-ai server if it doesn't exist
if (!mcpConfig.mcpServers["task-master-ai"]) { if (!mcpConfig.mcpServers['task-master-ai']) {
mcpConfig.mcpServers["task-master-ai"] = newMCPServer["task-master-ai"]; mcpConfig.mcpServers['task-master-ai'] =
newMCPServer['task-master-ai'];
} }
// Write the updated configuration // Write the updated configuration
fs.writeFileSync( fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 4));
mcpJsonPath,
JSON.stringify(mcpConfig, null, 4)
);
} catch (error) { } catch (error) {
// Create new configuration on error // Create new configuration on error
const newMCPConfig = { const newMCPConfig = {
"mcpServers": newMCPServer mcpServers: newMCPServer
}; };
fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4)); fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4));
@@ -244,7 +243,7 @@ describe('MCP Configuration Handling', () => {
} else { } else {
// If mcp.json doesn't exist, create it // If mcp.json doesn't exist, create it
const newMCPConfig = { const newMCPConfig = {
"mcpServers": newMCPServer mcpServers: newMCPServer
}; };
fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4)); fs.writeFileSync(mcpJsonPath, JSON.stringify(newMCPConfig, null, 4));
@@ -353,14 +352,14 @@ describe('MCP Configuration Handling', () => {
fs.readFileSync.mockImplementation((filePath) => { fs.readFileSync.mockImplementation((filePath) => {
if (filePath.toString().includes('mcp.json')) { if (filePath.toString().includes('mcp.json')) {
return JSON.stringify({ return JSON.stringify({
"mcpServers": { mcpServers: {
"existing-server": { 'existing-server': {
"command": "node", command: 'node',
"args": ["server.js"] args: ['server.js']
}, },
"task-master-ai": { 'task-master-ai': {
"command": "custom", command: 'custom',
"args": ["custom-args"] args: ['custom-args']
} }
} }
}); });
@@ -377,8 +376,10 @@ describe('MCP Configuration Handling', () => {
// Assert // Assert
// Verify the written data contains the original taskmaster configuration // Verify the written data contains the original taskmaster configuration
const dataWritten = JSON.parse(writeFileSyncSpy.mock.calls[0][1]); const dataWritten = JSON.parse(writeFileSyncSpy.mock.calls[0][1]);
expect(dataWritten.mcpServers["task-master-ai"].command).toBe("custom"); expect(dataWritten.mcpServers['task-master-ai'].command).toBe('custom');
expect(dataWritten.mcpServers["task-master-ai"].args).toContain("custom-args"); expect(dataWritten.mcpServers['task-master-ai'].args).toContain(
'custom-args'
);
}); });
test('creates the .cursor directory if it doesnt exist', () => { test('creates the .cursor directory if it doesnt exist', () => {
@@ -392,6 +393,8 @@ describe('MCP Configuration Handling', () => {
mockSetupMCPConfiguration(tempDir, 'test-project'); mockSetupMCPConfiguration(tempDir, 'test-project');
// Assert // Assert
expect(fs.mkdirSync).toHaveBeenCalledWith(cursorDirPath, { recursive: true }); expect(fs.mkdirSync).toHaveBeenCalledWith(cursorDirPath, {
recursive: true
});
}); });
}); });

View File

@@ -53,7 +53,13 @@ describe('Kebab Case Validation', () => {
describe('detectCamelCaseFlags', () => { describe('detectCamelCaseFlags', () => {
test('should properly detect camelCase flags', () => { test('should properly detect camelCase flags', () => {
const args = ['node', 'task-master', 'add-task', '--promptText=test', '--userID=123']; const args = [
'node',
'task-master',
'add-task',
'--promptText=test',
'--userID=123'
];
const flags = testDetectCamelCaseFlags(args); const flags = testDetectCamelCaseFlags(args);
expect(flags).toHaveLength(2); expect(flags).toHaveLength(2);
@@ -68,7 +74,13 @@ describe('Kebab Case Validation', () => {
}); });
test('should not flag kebab-case or lowercase flags', () => { test('should not flag kebab-case or lowercase flags', () => {
const args = ['node', 'task-master', 'add-task', '--prompt=test', '--user-id=123']; const args = [
'node',
'task-master',
'add-task',
'--prompt=test',
'--user-id=123'
];
const flags = testDetectCamelCaseFlags(args); const flags = testDetectCamelCaseFlags(args);
expect(flags).toHaveLength(0); expect(flags).toHaveLength(0);

File diff suppressed because it is too large Load Diff

View File

@@ -13,17 +13,17 @@ import { sampleTasks } from '../fixtures/sample-tasks.js';
// Mock dependencies // Mock dependencies
jest.mock('chalk', () => { jest.mock('chalk', () => {
const origChalkFn = text => text; const origChalkFn = (text) => text;
const chalk = origChalkFn; const chalk = origChalkFn;
chalk.green = text => text; // Return text as-is for status functions chalk.green = (text) => text; // Return text as-is for status functions
chalk.yellow = text => text; chalk.yellow = (text) => text;
chalk.red = text => text; chalk.red = (text) => text;
chalk.cyan = text => text; chalk.cyan = (text) => text;
chalk.blue = text => text; chalk.blue = (text) => text;
chalk.gray = text => text; chalk.gray = (text) => text;
chalk.white = text => text; chalk.white = (text) => text;
chalk.bold = text => text; chalk.bold = (text) => text;
chalk.dim = text => text; chalk.dim = (text) => text;
// Add hex and other methods // Add hex and other methods
chalk.hex = () => origChalkFn; chalk.hex = () => origChalkFn;
@@ -33,40 +33,44 @@ jest.mock('chalk', () => {
}); });
jest.mock('figlet', () => ({ jest.mock('figlet', () => ({
textSync: jest.fn(() => 'Task Master Banner'), textSync: jest.fn(() => 'Task Master Banner')
})); }));
jest.mock('boxen', () => jest.fn(text => `[boxed: ${text}]`)); jest.mock('boxen', () => jest.fn((text) => `[boxed: ${text}]`));
jest.mock('ora', () => jest.fn(() => ({ jest.mock('ora', () =>
jest.fn(() => ({
start: jest.fn(), start: jest.fn(),
succeed: jest.fn(), succeed: jest.fn(),
fail: jest.fn(), fail: jest.fn(),
stop: jest.fn(), stop: jest.fn()
}))); }))
);
jest.mock('cli-table3', () => jest.fn().mockImplementation(() => ({ jest.mock('cli-table3', () =>
jest.fn().mockImplementation(() => ({
push: jest.fn(), push: jest.fn(),
toString: jest.fn(() => 'Table Content'), toString: jest.fn(() => 'Table Content')
}))); }))
);
jest.mock('gradient-string', () => jest.fn(() => jest.fn(text => text))); jest.mock('gradient-string', () => jest.fn(() => jest.fn((text) => text)));
jest.mock('../../scripts/modules/utils.js', () => ({ jest.mock('../../scripts/modules/utils.js', () => ({
CONFIG: { CONFIG: {
projectName: 'Test Project', projectName: 'Test Project',
projectVersion: '1.0.0', projectVersion: '1.0.0'
}, },
log: jest.fn(), log: jest.fn(),
findTaskById: jest.fn(), findTaskById: jest.fn(),
readJSON: jest.fn(), readJSON: jest.fn(),
readComplexityReport: jest.fn(), readComplexityReport: jest.fn(),
truncate: jest.fn(text => text), truncate: jest.fn((text) => text)
})); }));
jest.mock('../../scripts/modules/task-manager.js', () => ({ jest.mock('../../scripts/modules/task-manager.js', () => ({
findNextTask: jest.fn(), findNextTask: jest.fn(),
analyzeTaskComplexity: jest.fn(), analyzeTaskComplexity: jest.fn()
})); }));
describe('UI Module', () => { describe('UI Module', () => {
@@ -166,9 +170,7 @@ describe('UI Module', () => {
test('should handle missing tasks in the task list', () => { test('should handle missing tasks in the task list', () => {
const dependencies = [1, 999]; const dependencies = [1, 999];
const allTasks = [ const allTasks = [{ id: 1, status: 'done' }];
{ id: 1, status: 'done' }
];
const result = formatDependenciesWithStatus(dependencies, allTasks); const result = formatDependenciesWithStatus(dependencies, allTasks);
expect(result).toBe('1, 999 (Not found)'); expect(result).toBe('1, 999 (Not found)');
@@ -178,9 +180,9 @@ describe('UI Module', () => {
describe('createProgressBar function', () => { describe('createProgressBar function', () => {
test('should create a progress bar with the correct percentage', () => { test('should create a progress bar with the correct percentage', () => {
const result = createProgressBar(50, 10, { const result = createProgressBar(50, 10, {
'pending': 20, pending: 20,
'in-progress': 15, 'in-progress': 15,
'blocked': 5 blocked: 5
}); });
expect(result).toContain('50%'); expect(result).toContain('50%');
}); });
@@ -205,11 +207,11 @@ describe('UI Module', () => {
test('should support status breakdown in the progress bar', () => { test('should support status breakdown in the progress bar', () => {
const result = createProgressBar(30, 10, { const result = createProgressBar(30, 10, {
'pending': 30, pending: 30,
'in-progress': 20, 'in-progress': 20,
'blocked': 10, blocked: 10,
'deferred': 5, deferred: 5,
'cancelled': 5 cancelled: 5
}); });
expect(result).toContain('40%'); expect(result).toContain('40%');

View File

@@ -29,11 +29,11 @@ import {
// Mock chalk functions // Mock chalk functions
jest.mock('chalk', () => ({ jest.mock('chalk', () => ({
gray: jest.fn(text => `gray:${text}`), gray: jest.fn((text) => `gray:${text}`),
blue: jest.fn(text => `blue:${text}`), blue: jest.fn((text) => `blue:${text}`),
yellow: jest.fn(text => `yellow:${text}`), yellow: jest.fn((text) => `yellow:${text}`),
red: jest.fn(text => `red:${text}`), red: jest.fn((text) => `red:${text}`),
green: jest.fn(text => `green:${text}`) green: jest.fn((text) => `green:${text}`)
})); }));
// Test implementation of detectCamelCaseFlags // Test implementation of detectCamelCaseFlags
@@ -96,7 +96,10 @@ describe('Utils Module', () => {
}); });
test('should truncate the string and add ellipsis if longer than maxLength', () => { test('should truncate the string and add ellipsis if longer than maxLength', () => {
const result = truncate('This is a long string that needs truncation', 20); const result = truncate(
'This is a long string that needs truncation',
20
);
expect(result).toBe('This is a long st...'); expect(result).toBe('This is a long st...');
}); });
@@ -150,17 +153,31 @@ describe('Utils Module', () => {
log('error', 'Error message'); log('error', 'Error message');
// Debug should not be logged (level 0 < 1) // Debug should not be logged (level 0 < 1)
expect(console.log).not.toHaveBeenCalledWith(expect.stringContaining('Debug message')); expect(console.log).not.toHaveBeenCalledWith(
expect.stringContaining('Debug message')
);
// Info and above should be logged // Info and above should be logged
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Info message')); expect(console.log).toHaveBeenCalledWith(
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Warning message')); expect.stringContaining('Info message')
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Error message')); );
expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('Warning message')
);
expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('Error message')
);
// Verify the formatting includes text prefixes // Verify the formatting includes text prefixes
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('[INFO]')); expect(console.log).toHaveBeenCalledWith(
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('[WARN]')); expect.stringContaining('[INFO]')
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('[ERROR]')); );
expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('[WARN]')
);
expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('[ERROR]')
);
}); });
test('should not log messages below the configured log level', () => { test('should not log messages below the configured log level', () => {
@@ -173,16 +190,26 @@ describe('Utils Module', () => {
log('error', 'Error message'); log('error', 'Error message');
// Only error should be logged // Only error should be logged
expect(console.log).not.toHaveBeenCalledWith(expect.stringContaining('Debug message')); expect(console.log).not.toHaveBeenCalledWith(
expect(console.log).not.toHaveBeenCalledWith(expect.stringContaining('Info message')); expect.stringContaining('Debug message')
expect(console.log).not.toHaveBeenCalledWith(expect.stringContaining('Warning message')); );
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Error message')); expect(console.log).not.toHaveBeenCalledWith(
expect.stringContaining('Info message')
);
expect(console.log).not.toHaveBeenCalledWith(
expect.stringContaining('Warning message')
);
expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('Error message')
);
}); });
test('should join multiple arguments into a single message', () => { test('should join multiple arguments into a single message', () => {
CONFIG.logLevel = 'info'; CONFIG.logLevel = 'info';
log('info', 'Message', 'with', 'multiple', 'parts'); log('info', 'Message', 'with', 'multiple', 'parts');
expect(console.log).toHaveBeenCalledWith(expect.stringContaining('Message with multiple parts')); expect(console.log).toHaveBeenCalledWith(
expect.stringContaining('Message with multiple parts')
);
}); });
}); });
@@ -203,7 +230,9 @@ describe('Utils Module', () => {
}); });
// Mock console.error // Mock console.error
const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => {}); const consoleSpy = jest
.spyOn(console, 'error')
.mockImplementation(() => {});
const result = readJSON('nonexistent.json'); const result = readJSON('nonexistent.json');
@@ -217,7 +246,9 @@ describe('Utils Module', () => {
fsReadFileSyncSpy.mockReturnValue('{ invalid json: }'); fsReadFileSyncSpy.mockReturnValue('{ invalid json: }');
// Mock console.error // Mock console.error
const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => {}); const consoleSpy = jest
.spyOn(console, 'error')
.mockImplementation(() => {});
const result = readJSON('invalid.json'); const result = readJSON('invalid.json');
@@ -249,7 +280,9 @@ describe('Utils Module', () => {
}); });
// Mock console.error // Mock console.error
const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => {}); const consoleSpy = jest
.spyOn(console, 'error')
.mockImplementation(() => {});
// Function shouldn't throw, just log error // Function shouldn't throw, just log error
expect(() => writeJSON('protected.json', testData)).not.toThrow(); expect(() => writeJSON('protected.json', testData)).not.toThrow();
@@ -262,7 +295,8 @@ describe('Utils Module', () => {
describe('sanitizePrompt function', () => { describe('sanitizePrompt function', () => {
test('should escape double quotes in prompts', () => { test('should escape double quotes in prompts', () => {
const prompt = 'This is a "quoted" prompt with "multiple" quotes'; const prompt = 'This is a "quoted" prompt with "multiple" quotes';
const expected = 'This is a \\"quoted\\" prompt with \\"multiple\\" quotes'; const expected =
'This is a \\"quoted\\" prompt with \\"multiple\\" quotes';
expect(sanitizePrompt(prompt)).toBe(expected); expect(sanitizePrompt(prompt)).toBe(expected);
}); });
@@ -292,7 +326,10 @@ describe('Utils Module', () => {
const result = readComplexityReport(); const result = readComplexityReport();
expect(fsExistsSyncSpy).toHaveBeenCalled(); expect(fsExistsSyncSpy).toHaveBeenCalled();
expect(fsReadFileSyncSpy).toHaveBeenCalledWith('/path/to/report.json', 'utf8'); expect(fsReadFileSyncSpy).toHaveBeenCalledWith(
'/path/to/report.json',
'utf8'
);
expect(result).toEqual(testReport); expect(result).toEqual(testReport);
}); });
@@ -362,7 +399,9 @@ describe('Utils Module', () => {
expect(findTaskInComplexityReport({}, 1)).toBeNull(); expect(findTaskInComplexityReport({}, 1)).toBeNull();
// Test with non-array complexityAnalysis // Test with non-array complexityAnalysis
expect(findTaskInComplexityReport({ complexityAnalysis: {} }, 1)).toBeNull(); expect(
findTaskInComplexityReport({ complexityAnalysis: {} }, 1)
).toBeNull();
}); });
}); });
@@ -520,7 +559,13 @@ describe('CLI Flag Format Validation', () => {
}); });
test('detectCamelCaseFlags should identify camelCase flags', () => { test('detectCamelCaseFlags should identify camelCase flags', () => {
const args = ['node', 'task-master', 'add-task', '--promptText=test', '--userID=123']; const args = [
'node',
'task-master',
'add-task',
'--promptText=test',
'--userID=123'
];
const flags = testDetectCamelCaseFlags(args); const flags = testDetectCamelCaseFlags(args);
expect(flags).toHaveLength(2); expect(flags).toHaveLength(2);
@@ -535,14 +580,28 @@ describe('CLI Flag Format Validation', () => {
}); });
test('detectCamelCaseFlags should not flag kebab-case flags', () => { test('detectCamelCaseFlags should not flag kebab-case flags', () => {
const args = ['node', 'task-master', 'add-task', '--prompt-text=test', '--user-id=123']; const args = [
'node',
'task-master',
'add-task',
'--prompt-text=test',
'--user-id=123'
];
const flags = testDetectCamelCaseFlags(args); const flags = testDetectCamelCaseFlags(args);
expect(flags).toHaveLength(0); expect(flags).toHaveLength(0);
}); });
test('detectCamelCaseFlags should respect single-word flags', () => { test('detectCamelCaseFlags should respect single-word flags', () => {
const args = ['node', 'task-master', 'add-task', '--prompt=test', '--file=test.json', '--priority=high', '--promptText=test']; const args = [
'node',
'task-master',
'add-task',
'--prompt=test',
'--file=test.json',
'--priority=high',
'--promptText=test'
];
const flags = testDetectCamelCaseFlags(args); const flags = testDetectCamelCaseFlags(args);
// Should only flag promptText, not the single-word flags // Should only flag promptText, not the single-word flags