An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
JavaScript aicursorcursor-aicursorailovablelovable-devroocodetask-managertaskstasks-listwindsurfwindsurf-ai
feat: Support custom response language (#510)
shenysunc99df64f651f
diff --git a/.changeset/tidy-meals-enter.md b/.changeset/tidy-meals-enter.mdnew file mode 100644index 00000000..5b3667b9--- /dev/null+++ b/.changeset/tidy-meals-enter.md@@ -0,0 +1,5 @@+---+'task-master-ai': patch+---++Support custom response languagediff --git a/.taskmaster/config.json b/.taskmaster/config.jsonindex 3bd2b3f8..cef8dcaa 100644--- a/.taskmaster/config.json+++ b/.taskmaster/config.json@@ -29,6 +29,7 @@"bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com","userId": "1234567890","azureBaseURL": "https://your-endpoint.azure.com/",- "defaultTag": "master"+ "defaultTag": "master",+ "responseLanguage": "English"}}diff --git a/assets/config.json b/assets/config.jsonindex d015eb4c..8ec52f58 100644--- a/assets/config.json+++ b/assets/config.json@@ -3,7 +3,7 @@"main": {"provider": "anthropic","modelId": "claude-3-7-sonnet-20250219",- "maxTokens": 120000,+ "maxTokens": 100000,"temperature": 0.2},"research": {@@ -14,9 +14,9 @@},"fallback": {"provider": "anthropic",- "modelId": "claude-3-5-sonnet-20240620",+ "modelId": "claude-3-7-sonnet-20250219","maxTokens": 8192,- "temperature": 0.1+ "temperature": 0.2}},"global": {@@ -28,6 +28,7 @@"defaultTag": "master","ollamaBaseURL": "http://localhost:11434/api","azureOpenaiBaseURL": "https://your-endpoint.openai.azure.com/",- "bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com"+ "bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com",+ "responseLanguage": "English"}}diff --git a/docs/configuration.md b/docs/configuration.mdindex 4d619dd9..9be224c5 100644--- a/docs/configuration.md+++ b/docs/configuration.md@@ -44,7 +44,8 @@ Taskmaster uses two primary methods for configuration:"ollamaBaseURL": "http://localhost:11434/api","azureBaseURL": "https://your-endpoint.azure.com/openai/deployments","vertexProjectId": "your-gcp-project-id",- "vertexLocation": "us-central1"+ "vertexLocation": "us-central1",+ "responseLanguage": "English"}}```diff --git a/mcp-server/src/core/direct-functions/response-language.js b/mcp-server/src/core/direct-functions/response-language.jsnew file mode 100644index 00000000..e39bda74--- /dev/null+++ b/mcp-server/src/core/direct-functions/response-language.js@@ -0,0 +1,40 @@+/**+ * response-language.js+ * Direct function for managing response language via MCP+ */++import { setResponseLanguage } from '../../../../scripts/modules/task-manager.js';+import {+ enableSilentMode,+ disableSilentMode+} from '../../../../scripts/modules/utils.js';+import { createLogWrapper } from '../../tools/utils.js';++export async function responseLanguageDirect(args, log, context = {}) {+ const { projectRoot, language } = args;+ const mcpLog = createLogWrapper(log);++ log.info(+ `Executing response-language_direct with args: ${JSON.stringify(args)}`+ );+ log.info(`Using project root: ${projectRoot}`);++ try {+ enableSilentMode();+ return setResponseLanguage(language, {+ mcpLog,+ projectRoot+ });+ } catch (error) {+ return {+ success: false,+ error: {+ code: 'DIRECT_FUNCTION_ERROR',+ message: error.message,+ details: error.stack+ }+ };+ } finally {+ disableSilentMode();+ }+}diff --git a/mcp-server/src/tools/index.js b/mcp-server/src/tools/index.jsindex a4aaaecc..32144619 100644--- a/mcp-server/src/tools/index.js+++ b/mcp-server/src/tools/index.js@@ -29,6 +29,7 @@ import { registerRemoveTaskTool } from './remove-task.js';import { registerInitializeProjectTool } from './initialize-project.js';import { registerModelsTool } from './models.js';import { registerMoveTaskTool } from './move-task.js';+import { registerResponseLanguageTool } from './response-language.js';import { registerAddTagTool } from './add-tag.js';import { registerDeleteTagTool } from './delete-tag.js';import { registerListTagsTool } from './list-tags.js';@@ -83,6 +84,7 @@ export function registerTaskMasterTools(server) {registerRemoveDependencyTool(server);registerValidateDependenciesTool(server);registerFixDependenciesTool(server);+ registerResponseLanguageTool(server);// Group 7: Tag ManagementregisterListTagsTool(server);diff --git a/mcp-server/src/tools/response-language.js b/mcp-server/src/tools/response-language.jsnew file mode 100644index 00000000..42a8ee06--- /dev/null+++ b/mcp-server/src/tools/response-language.js@@ -0,0 +1,46 @@+import { z } from 'zod';+import {+ createErrorResponse,+ handleApiResult,+ withNormalizedProjectRoot+} from './utils.js';+import { responseLanguageDirect } from '../core/direct-functions/response-language.js';++export function registerResponseLanguageTool(server) {+ server.addTool({+ name: 'response-language',+ description: 'Get or set the response language for the project',+ parameters: z.object({+ projectRoot: z+ .string()+ .describe(+ 'The root directory for the project. ALWAYS SET THIS TO THE PROJECT ROOT DIRECTORY. IF NOT SET, THE TOOL WILL NOT WORK.'+ ),+ language: z+ .string()+ .describe(+ 'The new response language to set. like "中文" "English" or "español".'+ )+ }),+ execute: withNormalizedProjectRoot(async (args, { log, session }) => {+ try {+ log.info(+ `Executing response-language tool with args: ${JSON.stringify(args)}`+ );++ const result = await responseLanguageDirect(+ {+ ...args,+ projectRoot: args.projectRoot+ },+ log,+ { session }+ );+ return handleApiResult(result, log, 'Error setting response language');+ } catch (error) {+ log.error(`Error in response-language tool: ${error.message}`);+ return createErrorResponse(error.message);+ }+ })+ });+}diff --git a/scripts/init.js b/scripts/init.jsindex 8009e4a3..10ecb200 100755--- a/scripts/init.js+++ b/scripts/init.js@@ -766,6 +766,44 @@ function createProjectStructure(}// =====================================+ // === Add Response Language Step ===+ if (!isSilentMode() && !dryRun && !options?.yes) {+ console.log(+ boxen(chalk.cyan('Configuring Response Language...'), {+ padding: 0.5,+ margin: { top: 1, bottom: 0.5 },+ borderStyle: 'round',+ borderColor: 'blue'+ })+ );+ log(+ 'info',+ 'Running interactive response language setup. Please input your preferred language.'+ );+ try {+ execSync('npx task-master lang --setup', {+ stdio: 'inherit',+ cwd: targetDir+ });+ log('success', 'Response Language configured.');+ } catch (error) {+ log('error', 'Failed to configure response language:', error.message);+ log('warn', 'You may need to run "task-master lang --setup" manually.');+ }+ } else if (isSilentMode() && !dryRun) {+ log(+ 'info',+ 'Skipping interactive response language setup in silent (MCP) mode.'+ );+ log(+ 'warn',+ 'Please configure response language using "task-master models --set-response-language" or the "models" MCP tool.'+ );+ } else if (dryRun) {+ log('info', 'DRY RUN: Skipping interactive response language setup.');+ }+ // =====================================+// === Add Model Configuration Step ===if (!isSilentMode() && !dryRun && !options?.yes) {console.log(diff --git a/scripts/modules/ai-services-unified.js b/scripts/modules/ai-services-unified.jsindex 283f69d4..e8f4f549 100644--- a/scripts/modules/ai-services-unified.js+++ b/scripts/modules/ai-services-unified.js@@ -15,6 +15,7 @@ import {getFallbackProvider,getFallbackModelId,getParametersForRole,+ getResponseLanguage,getUserId,MODEL_MAP,getDebugFlag,@@ -551,9 +552,12 @@ async function _unifiedServiceRunner(serviceType, params) {}const messages = [];- if (systemPrompt) {- messages.push({ role: 'system', content: systemPrompt });- }+ const responseLanguage = getResponseLanguage(effectiveProjectRoot);+ const systemPromptWithLanguage = `${systemPrompt} \n\n Always respond in ${responseLanguage}.`;+ messages.push({+ role: 'system',+ content: systemPromptWithLanguage.trim()+ });// IN THE FUTURE WHEN DOING CONTEXT IMPROVEMENTS// {diff --git a/scripts/modules/commands.js b/scripts/modules/commands.jsindex fc54d80a..8b653463 100644--- a/scripts/modules/commands.js+++ b/scripts/modules/commands.js@@ -42,7 +42,8 @@ import {findTaskById,taskExists,moveTask,- migrateProject+ migrateProject,+ setResponseLanguage} from './task-manager.js';import {@@ -3661,6 +3662,63 @@ Examples:return; // Stop execution here});+ // response-language command+ programInstance+ .command('lang')+ .description('Manage response language settings')+ .option('--response <response_language>', 'Set the response language')+ .option('--setup', 'Run interactive setup to configure response language')+ .action(async (options) => {+ const projectRoot = findProjectRoot(); // Find project root for context+ const { response, setup } = options;+ console.log(+ chalk.blue('Response language set to:', JSON.stringify(options))+ );+ let responseLanguage = response || 'English';+ if (setup) {+ console.log(+ chalk.blue('Starting interactive response language setup...')+ );+ try {+ const userResponse = await inquirer.prompt([+ {+ type: 'input',+ name: 'responseLanguage',+ message: 'Input your preferred response language',+ default: 'English'+ }+ ]);++ console.log(+ chalk.blue(+ 'Response language set to:',+ userResponse.responseLanguage+ )+ );+ responseLanguage = userResponse.responseLanguage;+ } catch (setupError) {+ console.error(+ chalk.red('\\nInteractive setup failed unexpectedly:'),+ setupError.message+ );+ }+ }++ const result = setResponseLanguage(responseLanguage, {+ projectRoot+ });++ if (result.success) {+ console.log(chalk.green(`✅ ${result.data.message}`));+ } else {+ console.error(+ chalk.red(+ `❌ Error setting response language: ${result.error.message}`+ )+ );+ }+ });+// move-task commandprogramInstance.command('move')diff --git a/scripts/modules/config-manager.js b/scripts/modules/config-manager.jsindex 51577436..43442682 100644--- a/scripts/modules/config-manager.js+++ b/scripts/modules/config-manager.js@@ -66,7 +66,8 @@ const DEFAULTS = {defaultPriority: 'medium',projectName: 'Task Master',ollamaBaseURL: 'http://localhost:11434/api',- bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'+ bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com',+ responseLanguage: 'English'}};@@ -425,6 +426,11 @@ function getVertexLocation(explicitRoot = null) {return getGlobalConfig(explicitRoot).vertexLocation || 'us-central1';}+function getResponseLanguage(explicitRoot = null) {+ // Directly return value from config+ return getGlobalConfig(explicitRoot).responseLanguage;+}+/*** Gets model parameters (maxTokens, temperature) for a specific role,* considering model-specific overrides from supported-models.json.@@ -841,6 +847,7 @@ export {getOllamaBaseURL,getAzureBaseURL,getBedrockBaseURL,+ getResponseLanguage,getParametersForRole,getUserId,// API Key Checkers (still relevant)diff --git a/scripts/modules/task-manager.js b/scripts/modules/task-manager.jsindex e8af0023..7fab9d8f 100644--- a/scripts/modules/task-manager.js+++ b/scripts/modules/task-manager.js@@ -23,10 +23,12 @@ import updateSubtaskById from './task-manager/update-subtask-by-id.js';import removeTask from './task-manager/remove-task.js';import taskExists from './task-manager/task-exists.js';import isTaskDependentOn from './task-manager/is-task-dependent.js';+import setResponseLanguage from './task-manager/response-language.js';import moveTask from './task-manager/move-task.js';import { migrateProject } from './task-manager/migrate.js';import { performResearch } from './task-manager/research.js';import { readComplexityReport } from './utils.js';+// Export task manager functionsexport {parsePRD,@@ -49,6 +51,7 @@ export {findTaskById,taskExists,isTaskDependentOn,+ setResponseLanguage,moveTask,readComplexityReport,migrateProject,diff --git a/scripts/modules/task-manager/response-language.js b/scripts/modules/task-manager/response-language.jsnew file mode 100644index 00000000..7ca97ea6--- /dev/null+++ b/scripts/modules/task-manager/response-language.js@@ -0,0 +1,94 @@+import path from 'path';+import fs from 'fs';+import {+ getConfig,+ isConfigFilePresent,+ writeConfig+} from '../config-manager.js';++function setResponseLanguage(lang, options = {}) {+ const { mcpLog, projectRoot } = options;++ const report = (level, ...args) => {+ if (mcpLog && typeof mcpLog[level] === 'function') {+ mcpLog[level](...args);+ }+ };++ let configPath;+ let configExists = false;++ if (projectRoot) {+ configPath = path.join(projectRoot, '.taskmasterconfig');+ configExists = fs.existsSync(configPath);+ report(+ 'info',+ `Checking for .taskmasterconfig at: ${configPath}, exists: ${configExists}`+ );+ } else {+ configExists = isConfigFilePresent();+ report(+ 'info',+ `Checking for .taskmasterconfig using isConfigFilePresent(), exists: ${configExists}`+ );+ }++ if (!configExists) {+ return {+ success: false,+ error: {+ code: 'CONFIG_MISSING',+ message:+ 'The .taskmasterconfig file is missing. Run "task-master models --setup" to create it.'+ }+ };+ }++ // Validate response language+ if (typeof lang !== 'string' || lang.trim() === '') {+ return {+ success: false,+ error: {+ code: 'INVALID_RESPONSE_LANGUAGE',+ message: `Invalid response language: ${lang}. Must be a non-empty string.`+ }+ };+ }++ try {+ const currentConfig = getConfig(projectRoot);+ currentConfig.global.responseLanguage = lang;+ const writeResult = writeConfig(currentConfig, projectRoot);++ if (!writeResult) {+ return {+ success: false,+ error: {+ code: 'WRITE_ERROR',+ message: 'Error writing updated configuration to .taskmasterconfig'+ }+ };+ }++ const successMessage = `Successfully set response language to: ${lang}`;+ report('info', successMessage);+ return {+ success: true,+ data: {+ responseLanguage: lang,+ message: successMessage+ }+ };+ } catch (error) {+ report('error', `Error setting response language: ${error.message}`);+ return {+ success: false,+ error: {+ code: 'SET_RESPONSE_LANGUAGE_ERROR',+ message: error.message+ }+ };+ }+}++export default setResponseLanguage;diff --git a/tests/unit/ai-services-unified.test.js b/tests/unit/ai-services-unified.test.jsindex 333fe1ae..f12b37bf 100644--- a/tests/unit/ai-services-unified.test.js+++ b/tests/unit/ai-services-unified.test.js@@ -8,6 +8,7 @@ const mockGetResearchModelId = jest.fn();const mockGetFallbackProvider = jest.fn();const mockGetFallbackModelId = jest.fn();const mockGetParametersForRole = jest.fn();+const mockGetResponseLanguage = jest.fn();const mockGetUserId = jest.fn();const mockGetDebugFlag = jest.fn();const mockIsApiKeySet = jest.fn();@@ -98,6 +99,7 @@ jest.unstable_mockModule('../../scripts/modules/config-manager.js', () => ({getFallbackMaxTokens: mockGetFallbackMaxTokens,getFallbackTemperature: mockGetFallbackTemperature,getParametersForRole: mockGetParametersForRole,+ getResponseLanguage: mockGetResponseLanguage,getUserId: mockGetUserId,getDebugFlag: mockGetDebugFlag,getBaseUrlForRole: mockGetBaseUrlForRole,@@ -277,6 +279,7 @@ describe('Unified AI Services', () => {if (role === 'fallback') return { maxTokens: 150, temperature: 0.6 };return { maxTokens: 100, temperature: 0.5 }; // Default});+ mockGetResponseLanguage.mockReturnValue('English');mockResolveEnvVariable.mockImplementation((key) => {if (key === 'ANTHROPIC_API_KEY') return 'mock-anthropic-key';if (key === 'PERPLEXITY_API_KEY') return 'mock-perplexity-key';@@ -463,6 +466,68 @@ describe('Unified AI Services', () => {expect(mockAnthropicProvider.generateText).toHaveBeenCalledTimes(1);});+ test('should use configured responseLanguage in system prompt', async () => {+ mockGetResponseLanguage.mockReturnValue('中文');+ mockAnthropicProvider.generateText.mockResolvedValue('中文回复');++ const params = {+ role: 'main',+ systemPrompt: 'You are an assistant',+ prompt: 'Hello'+ };+ await generateTextService(params);++ expect(mockAnthropicProvider.generateText).toHaveBeenCalledWith(+ expect.objectContaining({+ messages: [+ {+ role: 'system',+ content: expect.stringContaining('Always respond in 中文')+ },+ { role: 'user', content: 'Hello' }+ ]+ })+ );+ expect(mockGetResponseLanguage).toHaveBeenCalledWith(fakeProjectRoot);+ });++ test('should pass custom projectRoot to getResponseLanguage', async () => {+ const customRoot = '/custom/project/root';+ mockGetResponseLanguage.mockReturnValue('Español');+ mockAnthropicProvider.generateText.mockResolvedValue(+ 'Respuesta en Español'+ );++ const params = {+ role: 'main',+ systemPrompt: 'You are an assistant',+ prompt: 'Hello',+ projectRoot: customRoot+ };+ await generateTextService(params);++ expect(mockGetResponseLanguage).toHaveBeenCalledWith(customRoot);+ expect(mockAnthropicProvider.generateText).toHaveBeenCalledWith(+ expect.objectContaining({+ messages: [+ {+ role: 'system',+ content: expect.stringContaining('Always respond in Español')+ },+ { role: 'user', content: 'Hello' }+ ]+ })+ );+ });++ // Add more tests for edge cases:+ // - Missing API keys (should throw from _resolveApiKey)+ // - Unsupported provider configured (should skip and log)+ // - Missing provider/model config for a role (should skip and log)+ // - Missing prompt+ // - Different initial roles (research, fallback)+ // - generateObjectService (mock schema, check object result)+ // - streamTextService (more complex to test, might need stream helpers)test('should skip provider with missing API key and try next in fallback sequence', async () => {// Setup isApiKeySet to return false for anthropic but true for perplexitymockIsApiKeySet.mockImplementation((provider, session, root) => {diff --git a/tests/unit/config-manager.test.js b/tests/unit/config-manager.test.jsindex c7d14e63..51021afa 100644--- a/tests/unit/config-manager.test.js+++ b/tests/unit/config-manager.test.js@@ -141,7 +141,8 @@ const DEFAULT_CONFIG = {defaultPriority: 'medium',projectName: 'Task Master',ollamaBaseURL: 'http://localhost:11434/api',- bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'+ bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com',+ responseLanguage: 'English'}};@@ -685,6 +686,82 @@ describe('Getter Functions', () => {expect(logLevel).toBe(VALID_CUSTOM_CONFIG.global.logLevel);});+ test('getResponseLanguage should return responseLanguage from config', () => {+ // Arrange+ // Prepare a config object with responseLanguage property for this test+ const configWithLanguage = JSON.stringify({+ models: {+ main: { provider: 'openai', modelId: 'gpt-4-turbo' }+ },+ global: {+ projectName: 'Test Project',+ responseLanguage: '中文'+ }+ });++ // Set up fs.readFileSync to return our test config+ fsReadFileSyncSpy.mockImplementation((filePath) => {+ if (filePath === MOCK_CONFIG_PATH) {+ return configWithLanguage;+ }+ if (path.basename(filePath) === 'supported-models.json') {+ return JSON.stringify({+ openai: [{ id: 'gpt-4-turbo' }]+ });+ }+ throw new Error(`Unexpected fs.readFileSync call: ${filePath}`);+ });++ fsExistsSyncSpy.mockReturnValue(true);++ // Ensure getConfig returns new values instead of cached ones+ configManager.getConfig(MOCK_PROJECT_ROOT, true);++ // Act+ const responseLanguage =+ configManager.getResponseLanguage(MOCK_PROJECT_ROOT);++ // Assert+ expect(responseLanguage).toBe('中文');+ });++ test('getResponseLanguage should return undefined when responseLanguage is not in config', () => {+ // Arrange+ const configWithoutLanguage = JSON.stringify({+ models: {+ main: { provider: 'openai', modelId: 'gpt-4-turbo' }+ },+ global: {+ projectName: 'Test Project'+ // No responseLanguage property+ }+ });++ fsReadFileSyncSpy.mockImplementation((filePath) => {+ if (filePath === MOCK_CONFIG_PATH) {+ return configWithoutLanguage;+ }+ if (path.basename(filePath) === 'supported-models.json') {+ return JSON.stringify({+ openai: [{ id: 'gpt-4-turbo' }]+ });+ }+ throw new Error(`Unexpected fs.readFileSync call: ${filePath}`);+ });++ fsExistsSyncSpy.mockReturnValue(true);++ // Ensure getConfig returns new values instead of cached ones+ configManager.getConfig(MOCK_PROJECT_ROOT, true);++ // Act+ const responseLanguage =+ configManager.getResponseLanguage(MOCK_PROJECT_ROOT);++ // Assert+ expect(responseLanguage).toBe('English');+ });+// Add more tests for other getters (getResearchProvider, getProjectName, etc.)});