clickup-markdown-mcp 1.0.0

package/dist/cli.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+"use strict";
+// ============================================================
+// ClickUp MCP Server — CLI Standalone
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const clickup_client_js_1 = require("./api/clickup-client.js");
+const environment_scanner_js_1 = require("./discovery/environment-scanner.js");
+const markdown_parser_js_1 = require("./parsers/markdown-parser.js");
+const markdown_generator_js_1 = require("./generators/markdown-generator.js");
+const config_js_1 = require("./config/config.js");
+const config = (0, config_js_1.loadConfig)();
+const client = new clickup_client_js_1.ClickUpClient(config.apiToken);
+const scanner = new environment_scanner_js_1.EnvironmentScanner(client);
+const generator = new markdown_generator_js_1.MarkdownGenerator(client);
+const program = new commander_1.Command();
+program
+    .name('clickup-mcp-cli')
+    .description('ClickUp MCP CLI — Create, export, and manage tasks from Markdown')
+    .version('1.0.0');
+// --- Discover ---
+program
+    .command('discover')
+    .description('Scan a ClickUp list to discover statuses, custom fields, and patterns')
+    .requiredOption('-l, --list <id>', 'List ID to scan')
+    .action(async (opts) => {
+    try {
+        const env = await scanner.scan(opts.list);
+        console.log(JSON.stringify(env, null, 2));
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Guide ---
+program
+    .command('guide')
+    .description('Generate the AI tutorial/guide for tasks.md format')
+    .option('-l, --list <id>', 'List ID for environment-specific guide')
+    .action(async (opts) => {
+    try {
+        if (opts.list) {
+            const env = await scanner.scan(opts.list);
+            console.log(scanner.generateGuide(env));
+        }
+        else {
+            const env = {
+                list: { id: '', name: '(not specified)' },
+                statuses: [],
+                custom_fields: [],
+                members: [],
+                detected_patterns: {
+                    naming: 'Sprint N - Title / [TAG] Subtask title',
+                    hierarchy: 'Task pai → Sprint → Subtask',
+                    time_tracking: 'Track time on subtasks',
+                },
+            };
+            console.log(scanner.generateGuide(env));
+        }
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Validate ---
+program
+    .command('validate')
+    .description('Validate a tasks.md file before importing')
+    .argument('<file>', 'Path to tasks.md file')
+    .action(async (file) => {
+    try {
+        const content = (0, fs_1.readFileSync)(file, 'utf-8');
+        const result = (0, markdown_parser_js_1.validateTasksMd)(content);
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.valid)
+            process.exit(1);
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Import ---
+program
+    .command('import')
+    .description('Import tasks from a tasks.md file into ClickUp')
+    .argument('<file>', 'Path to tasks.md file')
+    .requiredOption('-p, --parent <id>', 'Parent task ID')
+    .requiredOption('-l, --list <id>', 'List ID')
+    .option('-a, --assignees <ids>', 'Comma-separated user IDs', '')
+    .option('-f, --field <id:value>', 'Custom field (can be used multiple times)', (val, prev) => {
+    prev.push(val);
+    return prev;
+}, [])
+    .option('--from-sprint <n>', 'Start from sprint number', '1')
+    .option('--close', 'Mark all tasks as closed after creation', false)
+    .action(async (file, opts) => {
+    try {
+        const content = (0, fs_1.readFileSync)(file, 'utf-8');
+        const parsed = (0, markdown_parser_js_1.parseTasksMd)(content);
+        const assignees = opts.assignees
+            ? opts.assignees.split(',').map(Number).filter(Boolean)
+            : config.defaultAssignees || [];
+        const customFields = opts.field.map((f) => {
+            const [id, value] = f.split(':');
+            return { id, value };
+        });
+        console.log(`Importing ${parsed.sprints.length} sprints...`);
+        // Get closed status if needed
+        let closedStatus;
+        if (opts.close) {
+            const list = await client.getList(opts.list);
+            const closed = list.statuses?.find((s) => s.type === 'closed');
+            if (closed)
+                closedStatus = closed.status;
+        }
+        const fromSprint = parseInt(opts.fromSprint, 10);
+        const sprintsToImport = parsed.sprints.filter((s) => s.number >= fromSprint);
+        let totalSprints = 0;
+        let totalSubtasks = 0;
+        let totalTime = 0;
+        for (const sprint of sprintsToImport) {
+            const sprintTask = await client.createTask(opts.list, {
+                name: `Sprint ${sprint.number} - ${sprint.name}`,
+                parent: opts.parent,
+                assignees,
+                custom_fields: customFields,
+            });
+            totalSprints++;
+            console.log(`  ✅ Sprint ${sprint.number}: ${sprint.name} (${sprintTask.id})`);
+            let subtaskIndex = 0;
+            for (const sub of sprint.subtasks) {
+                const subTask = await client.createTask(opts.list, {
+                    name: sub.title,
+                    description: sub.description,
+                    parent: sprintTask.id,
+                    assignees,
+                    custom_fields: customFields,
+                });
+                totalSubtasks++;
+                if (sub.timeReal > 0) {
+                    const baseStart = 1774563600000 + (subtaskIndex * 7200000);
+                    await client.addTimeEntry(subTask.id, {
+                        duration: sub.timeReal,
+                        start: baseStart,
+                        end: baseStart + sub.timeReal,
+                    });
+                    totalTime += sub.timeReal;
+                }
+                if (closedStatus) {
+                    await client.updateTask(subTask.id, { status: closedStatus });
+                }
+                console.log(`    ✅ ${sub.title} (${Math.round(sub.timeReal / 60000)}min)`);
+                subtaskIndex++;
+            }
+            if (closedStatus) {
+                await client.updateTask(sprintTask.id, { status: closedStatus });
+            }
+        }
+        console.log(`\n🎉 Done! ${totalSprints} sprints, ${totalSubtasks} subtasks, ${Math.round(totalTime / 60000)} minutes tracked`);
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Export ---
+program
+    .command('export')
+    .description('Export tasks from ClickUp to tasks.md format')
+    .requiredOption('-t, --task <id>', 'Parent task ID to export')
+    .option('-o, --output <file>', 'Output file path (default: stdout)')
+    .action(async (opts) => {
+    try {
+        const md = await generator.exportToMd(opts.task);
+        if (opts.output) {
+            (0, fs_1.writeFileSync)(opts.output, md, 'utf-8');
+            console.log(`✅ Exported to ${opts.output}`);
+        }
+        else {
+            console.log(md);
+        }
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Close ---
+program
+    .command('close')
+    .description('Mark a task and all its subtasks as closed/concluded')
+    .requiredOption('-t, --task <id>', 'Task ID to close')
+    .option('-r, --recursive', 'Also close all subtasks recursively', false)
+    .action(async (opts) => {
+    try {
+        let taskIds;
+        if (opts.recursive) {
+            console.log('Collecting all subtasks...');
+            taskIds = await client.getSubtasksRecursive(opts.task);
+        }
+        else {
+            taskIds = [opts.task];
+        }
+        // Get closed status
+        const task = await client.getTask(opts.task);
+        const list = await client.getList(task.list.id);
+        const closed = list.statuses?.find((s) => s.type === 'closed');
+        if (!closed) {
+            console.error('No closed status found for this list');
+            process.exit(1);
+        }
+        console.log(`Closing ${taskIds.length} tasks...`);
+        const result = await client.bulkUpdateStatus(taskIds, closed.status);
+        console.log(`✅ ${result.updated} closed, ${result.errors} errors`);
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+// --- Fields ---
+program
+    .command('fields')
+    .description('List custom fields for a list')
+    .requiredOption('-l, --list <id>', 'List ID')
+    .action(async (opts) => {
+    try {
+        const list = await client.getList(opts.list);
+        for (const cf of list.custom_fields || []) {
+            console.log(`\n📋 ${cf.name} (${cf.type})${cf.required ? ' [REQUIRED]' : ''}`);
+            console.log(`   ID: ${cf.id}`);
+            if (cf.type_config?.options) {
+                for (const opt of cf.type_config.options) {
+                    console.log(`   - "${opt.name}" (${opt.id})`);
+                }
+            }
+        }
+    }
+    catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config/config.d.ts

@@ -0,0 +1,3 @@
+import { ClickUpMcpConfig } from '../types/index.js';
+export declare function loadConfig(): ClickUpMcpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA4BrD,wBAAgB,UAAU,IAAI,gBAAgB,CAiC7C"}

package/dist/config/config.js

@@ -0,0 +1,58 @@
+"use strict";
+// ============================================================
+// ClickUp MCP Server — Configuration Manager
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const CONFIG_FILE_NAME = '.clickup-mcp.json';
+function findConfigFile() {
+    const paths = [
+        (0, path_1.join)(process.cwd(), CONFIG_FILE_NAME),
+        (0, path_1.join)(process.env.HOME || process.env.USERPROFILE || '', CONFIG_FILE_NAME),
+    ];
+    for (const p of paths) {
+        if ((0, fs_1.existsSync)(p))
+            return p;
+    }
+    return null;
+}
+function loadFileConfig() {
+    const configPath = findConfigFile();
+    if (!configPath)
+        return {};
+    try {
+        const raw = (0, fs_1.readFileSync)(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function loadConfig() {
+    const fileConfig = loadFileConfig();
+    const apiToken = process.env.CLICKUP_API_TOKEN ||
+        fileConfig.apiToken ||
+        '';
+    const defaultListId = process.env.CLICKUP_DEFAULT_LIST_ID ||
+        fileConfig.defaultListId;
+    const defaultAssignees = (() => {
+        const env = process.env.CLICKUP_DEFAULT_ASSIGNEES;
+        if (env)
+            return env.split(',').map(Number).filter(Boolean);
+        return fileConfig.defaultAssignees;
+    })();
+    const requiredCustomFields = fileConfig.requiredCustomFields;
+    if (!apiToken) {
+        console.error('[clickup-mcp] Warning: No API token configured.\n' +
+            'Set CLICKUP_API_TOKEN env var or create a .clickup-mcp.json file.');
+    }
+    return {
+        apiToken,
+        defaultListId,
+        defaultAssignees,
+        requiredCustomFields,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,6CAA6C;AAC7C,+DAA+D;;AA8B/D,gCAiCC;AA5DD,2BAA8C;AAC9C,+BAA4B;AAE5B,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,SAAS,cAAc;IACrB,MAAM,KAAK,GAAG;QACZ,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;QACrC,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,gBAAgB,CAAC;KAC1E,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,IAAA,eAAU,EAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,UAAU;IACxB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAEpC,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,UAAU,CAAC,QAAQ;QACnB,EAAE,CAAC;IAEL,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,uBAAuB;QACnC,UAAU,CAAC,aAAa,CAAC;IAE3B,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAClD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,gBAAgB,CAAC;IACrC,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,oBAAoB,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAE7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CACX,mDAAmD;YACnD,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,aAAa;QACb,gBAAgB;QAChB,oBAAoB;KACrB,CAAC;AACJ,CAAC"}

package/dist/discovery/environment-scanner.d.ts

@@ -0,0 +1,10 @@
+import { ClickUpClient } from '../api/clickup-client.js';
+import type { EnvironmentInfo } from '../types/index.js';
+export declare class EnvironmentScanner {
+    private client;
+    constructor(client: ClickUpClient);
+    scan(listId: string): Promise<EnvironmentInfo>;
+    private detectPatterns;
+    generateGuide(env: EnvironmentInfo): string;
+}
+//# sourceMappingURL=environment-scanner.d.ts.map

package/dist/discovery/environment-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-scanner.d.ts","sourceRoot":"","sources":["../../src/discovery/environment-scanner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAI3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YA+CtC,cAAc;IAkD5B,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM;CA+F5C"}

package/dist/discovery/environment-scanner.js

@@ -0,0 +1,185 @@
+"use strict";
+// ============================================================
+// ClickUp MCP Server — Environment Scanner (Auto-Discovery)
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentScanner = void 0;
+class EnvironmentScanner {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async scan(listId) {
+        // 1. Get list details (statuses + custom fields)
+        const list = await this.client.getList(listId);
+        // 2. Get workspace members
+        const workspaces = await this.client.listWorkspaces();
+        const members = workspaces.length > 0
+            ? workspaces[0].members.map((m) => ({
+                id: m.id,
+                name: m.username,
+                email: m.email,
+            }))
+            : [];
+        // 3. Map statuses with exact encoding
+        const statuses = (list.statuses || []).map((s) => ({
+            name: s.status,
+            type: s.type,
+            encoded_name: s.status, // preserve exact encoding (important for special chars)
+        }));
+        // 4. Map custom fields
+        const custom_fields = (list.custom_fields || []).map((cf) => ({
+            id: cf.id,
+            name: cf.name,
+            type: cf.type,
+            required: cf.required || false,
+            options: cf.type_config?.options?.map((o) => ({
+                id: o.id,
+                name: o.name,
+                color: o.color,
+                orderindex: o.orderindex,
+            })),
+        }));
+        // 5. Detect patterns from existing tasks
+        const detected_patterns = await this.detectPatterns(listId);
+        return {
+            list: { id: list.id, name: list.name },
+            statuses,
+            custom_fields,
+            members,
+            detected_patterns,
+        };
+    }
+    async detectPatterns(listId) {
+        try {
+            const tasks = await this.client.searchTasks(listId, {
+                include_subtasks: true,
+            });
+            if (!tasks || tasks.length === 0) {
+                return {
+                    naming: 'No existing tasks found — use Sprint N - Title for sprints and [TAG] Title for subtasks',
+                    hierarchy: 'Task pai → Sprint → Subtask (3 levels)',
+                    time_tracking: 'Track time on subtasks (leaf tasks)',
+                };
+            }
+            // Analyze naming patterns
+            const sprintPattern = tasks.some((t) => /sprint\s+\d+/i.test(t.name));
+            const tagPattern = tasks.some((t) => /\[.+\]/.test(t.name));
+            const hasSubtasks = tasks.some((t) => t.subtasks && t.subtasks.length > 0);
+            const naming = [
+                sprintPattern ? 'Sprint N - Titulo' : null,
+                tagPattern ? '[TAG][TAG] Titulo da subtask' : null,
+            ]
+                .filter(Boolean)
+                .join(' / ') || 'Free-form naming';
+            return {
+                naming,
+                hierarchy: hasSubtasks
+                    ? 'Task pai → Sprint → Subtask (3 levels detected)'
+                    : 'Flat task list (no hierarchy detected)',
+                time_tracking: 'Track time on leaf-level subtasks',
+            };
+        }
+        catch {
+            return {
+                naming: 'Sprint N - Title / [TAG] Subtask title',
+                hierarchy: 'Task pai → Sprint → Subtask',
+                time_tracking: 'Track time on subtasks',
+            };
+        }
+    }
+    generateGuide(env) {
+        const requiredFields = env.custom_fields
+            .filter((f) => f.required)
+            .map((f) => {
+            const optionsStr = f.options
+                ? f.options.map((o) => `  - "${o.name}" (id: ${o.id})`).join('\n')
+                : '  (no options)';
+            return `- **${f.name}** (${f.type}, REQUIRED)\n${optionsStr}`;
+        })
+            .join('\n\n');
+        const statusList = env.statuses
+            .map((s) => `- "${s.name}" (${s.type})`)
+            .join('\n');
+        const memberList = env.members
+            .map((m) => `- ${m.name} (id: ${m.id}, ${m.email})`)
+            .join('\n');
+        return `# Guia de Geração de tasks.md para ClickUp
+
+## Ambiente detectado
+- **Lista**: ${env.list.name} (id: ${env.list.id})
+- **Padrão de nomes**: ${env.detected_patterns.naming}
+- **Hierarquia**: ${env.detected_patterns.hierarchy}
+- **Time tracking**: ${env.detected_patterns.time_tracking}
+
+## Formato obrigatório do tasks.md
+
+Cada bloco de sprint deve seguir esta estrutura exata:
+
+\`\`\`markdown
+**Sprint N - Nome descritivo da sprint**
+
+| Subtask | Descricao | Tempo estimado | Tempo real gasto |
+| --- | --- | --- | --- |
+| \\\`[TAG1][TAG2]\\\` Titulo curto | Frase descritiva do que foi feito. | 20 min | 15 min |
+\`\`\`
+
+## Regras de formatação
+- Tags são em CAPS entre colchetes: [BACK], [FRONT], [DB], [INFRA], [QA], [DOCS], [RESEARCH], [ANALYSIS], [PLANNING], etc.
+- Descrição é uma frase objetiva no passado (ex: "Criamos...", "Reescrevemos...", "Validamos...")
+- Tempo aceita formatos: "5 min", "15 min", "20 min", "1h", "1h30", "45 min"
+- Cada sprint pode ter 1 a N subtasks
+- Opcionalmente, antes das sprints pode haver um bloco Task Master:
+
+\`\`\`markdown
+**Task Master**
+
+| Titulo | Descricao | Tempo estimado | Tempo real gasto |
+| --- | --- | --- | --- |
+| Titulo do pacote | Descricao geral do que foi feito. | 5h a 6h | ~5h |
+\`\`\`
+
+## Statuses disponíveis
+${statusList}
+
+## Campos customizados
+${requiredFields || '(nenhum campo obrigatório detectado)'}
+
+## Membros do workspace
+${memberList || '(nenhum membro encontrado)'}
+
+## Fluxo recomendado para a IA
+1. Durante a sessão de trabalho, registre mentalmente as tarefas executadas
+2. Ao final, gere o tasks.md seguindo o formato acima
+3. Use \`validate_md\` para verificar o formato
+4. Use \`import_from_md\` para criar tudo no ClickUp
+5. Use \`bulk_update_status\` para marcar como concluído se necessário
+
+## Exemplo completo
+
+**Task Master**
+
+| Titulo | Descricao | Tempo estimado | Tempo real gasto |
+| --- | --- | --- | --- |
+| Implementacao da feature X | Criamos o modulo X com backend, frontend e testes. | 2h a 3h | ~2h30 |
+
+**Sprint 1 - Setup e infraestrutura**
+
+| Subtask | Descricao | Tempo estimado | Tempo real gasto |
+| --- | --- | --- | --- |
+| \\\`[INFRA][DB]\\\` Criacao das tabelas | Criamos as migrations para as novas tabelas do modulo X. | 30 min | 25 min |
+| \\\`[BACK][API]\\\` Rotas REST | Implementamos GET/POST/PUT/DELETE para o recurso X. | 45 min | 40 min |
+| \\\`[QA]\\\` Testes e validacao | Rodamos build e testes unitarios do backend. | 15 min | 10 min |
+
+**Sprint 2 - Frontend**
+
+| Subtask | Descricao | Tempo estimado | Tempo real gasto |
+| --- | --- | --- | --- |
+| \\\`[FRONT][UI]\\\` Pagina principal | Criamos a pagina de listagem com filtros e paginacao. | 40 min | 35 min |
+| \\\`[FRONT][FORM]\\\` Formulario de criacao | Implementamos o formulario com validacao Zod. | 30 min | 25 min |
+| \\\`[QA][FRONT]\\\` Build frontend | Validamos o build do frontend com a nova pagina. | 10 min | 10 min |
+`;
+    }
+}
+exports.EnvironmentScanner = EnvironmentScanner;
+//# sourceMappingURL=environment-scanner.js.map

package/dist/discovery/environment-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-scanner.js","sourceRoot":"","sources":["../../src/discovery/environment-scanner.ts"],"names":[],"mappings":"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"}

package/dist/generators/markdown-generator.d.ts

@@ -0,0 +1,8 @@
+import { ClickUpClient } from '../api/clickup-client.js';
+export declare class MarkdownGenerator {
+    private client;
+    constructor(client: ClickUpClient);
+    exportToMd(parentTaskId: string): Promise<string>;
+    private wrapTagsInBackticks;
+}
+//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/generators/markdown-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/generators/markdown-generator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAYzD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAI3B,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoEvD,OAAO,CAAC,mBAAmB;CAQ5B"}

package/dist/generators/markdown-generator.js

@@ -0,0 +1,88 @@
+"use strict";
+// ============================================================
+// ClickUp MCP Server — Markdown Generator
+// Exports ClickUp tasks to tasks.md format
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownGenerator = void 0;
+function formatTime(ms) {
+    if (ms === 0)
+        return '0 min';
+    const totalMinutes = Math.round(ms / 60000);
+    if (totalMinutes < 60)
+        return `${totalMinutes} min`;
+    const hours = Math.floor(totalMinutes / 60);
+    const mins = totalMinutes % 60;
+    if (mins === 0)
+        return `${hours}h`;
+    return `${hours}h${mins}`;
+}
+class MarkdownGenerator {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async exportToMd(parentTaskId) {
+        const parentTask = await this.client.getTask(parentTaskId, true);
+        const lines = [];
+        lines.push(`Tempos abaixo sao **aproximados**, baseados no trabalho real das sessoes.`);
+        lines.push('');
+        if (!parentTask.subtasks || parentTask.subtasks.length === 0) {
+            lines.push('(Nenhuma sprint encontrada)');
+            return lines.join('\n');
+        }
+        // Calculate total time
+        let totalTimeReal = 0;
+        for (const sprint of parentTask.subtasks) {
+            // Get full sprint with subtasks
+            const fullSprint = await this.client.getTask(sprint.id, true);
+            lines.push(`**${fullSprint.name}**`);
+            lines.push('');
+            if (!fullSprint.subtasks || fullSprint.subtasks.length === 0) {
+                lines.push('(Nenhuma subtask)');
+                lines.push('');
+                continue;
+            }
+            lines.push('| Subtask | Descricao | Tempo estimado | Tempo real gasto |');
+            lines.push('| --- | --- | --- | --- |');
+            for (const subtask of fullSprint.subtasks) {
+                // Get time entries for the subtask
+                let timeReal = 0;
+                try {
+                    const entries = await this.client.getTimeEntries(subtask.id);
+                    timeReal = entries.reduce((sum, e) => sum + (typeof e.time === 'number' ? e.time : 0), 0);
+                }
+                catch {
+                    timeReal = subtask.time_spent || 0;
+                }
+                totalTimeReal += timeReal;
+                const title = subtask.name.includes('`')
+                    ? subtask.name
+                    : this.wrapTagsInBackticks(subtask.name);
+                const desc = subtask.text_content || subtask.description || '';
+                const timeStr = formatTime(timeReal);
+                lines.push(`| ${title} | ${desc} | ${timeStr} | ${timeStr} |`);
+            }
+            lines.push('');
+        }
+        // Summary
+        lines.push('**Resumo**');
+        lines.push('');
+        lines.push('| Item | Valor |');
+        lines.push('| --- | --- |');
+        lines.push(`| Sprints | ${parentTask.subtasks.length} |`);
+        lines.push(`| Tempo real total | ${formatTime(totalTimeReal)} |`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    wrapTagsInBackticks(name) {
+        // If name starts with [TAG], wrap the tags in backticks
+        const match = name.match(/^(\[.+?\](?:\s*\[.+?\])*)\s*(.*)/);
+        if (match) {
+            return `\`${match[1].toLowerCase()}\` ${match[2]}`;
+        }
+        return name;
+    }
+}
+exports.MarkdownGenerator = MarkdownGenerator;
+//# sourceMappingURL=markdown-generator.js.map

package/dist/generators/markdown-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.js","sourceRoot":"","sources":["../../src/generators/markdown-generator.ts"],"names":[],"mappings":"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"}