@project-ava-supernova/core 0.2.71

package/dist/tools/test-generate.js

@@ -0,0 +1,259 @@
+import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
+import { join, dirname, basename, extname } from 'node:path';
+import { glob } from 'glob';
+import { validatePath } from './security.js';
+const MAX_FILE_SIZE = 50_000;
+export class TestGenerateTool {
+    name = 'test_generate';
+    description = 'Generate test scaffolding for a source file using the detected test framework';
+    riskLevel = 'write';
+    requiresConfirmation = true;
+    schema = {
+        name: 'test_generate',
+        description: 'Generate a test file for a given source file. Detects the test framework (Jest, Vitest, Pytest, etc.) ' +
+            'and creates a test scaffold with imports, describe blocks, and placeholder test cases based on ' +
+            'exported functions/classes found in the source file. Looks at existing tests in the project for style consistency.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Path to the source file to generate tests for.',
+                },
+                framework: {
+                    type: 'string',
+                    enum: ['jest', 'vitest', 'mocha', 'pytest'],
+                    description: 'Override auto-detected framework.',
+                },
+                output_path: {
+                    type: 'string',
+                    description: 'Custom output path for the test file. Auto-generated if omitted.',
+                },
+            },
+            required: ['file_path'],
+        },
+    };
+    async execute(args, context) {
+        const filePath = args.file_path;
+        const frameworkOverride = args.framework;
+        const outputPath = args.output_path;
+        let absolutePath;
+        try {
+            absolutePath = validatePath(filePath, context.cwd);
+        }
+        catch (err) {
+            return { success: false, output: err.message };
+        }
+        // Read source file
+        let source;
+        try {
+            source = await readFile(absolutePath, 'utf-8');
+        }
+        catch {
+            return { success: false, output: `Cannot read file: ${filePath}` };
+        }
+        if (source.length > MAX_FILE_SIZE) {
+            source = source.slice(0, MAX_FILE_SIZE) + '\n// ... (truncated for test generation)';
+        }
+        const ext = extname(absolutePath);
+        const name = basename(absolutePath, ext);
+        const isPython = ext === '.py';
+        // Detect framework
+        const framework = frameworkOverride
+            ? this.getFramework(frameworkOverride, isPython)
+            : await this.detectFramework(context.cwd, isPython);
+        if (!framework) {
+            return { success: false, output: 'Could not detect test framework. Use the "framework" parameter.' };
+        }
+        // Extract exports/functions for test scaffolding
+        const symbols = isPython
+            ? this.extractPythonSymbols(source)
+            : this.extractJsSymbols(source);
+        // Look for existing test examples for style consistency
+        const existingExample = await this.findExistingTest(context.cwd, framework);
+        // Generate test content
+        const testContent = this.buildTest(framework, name, filePath, symbols, existingExample);
+        // Determine output path
+        let testPath;
+        if (outputPath) {
+            try {
+                testPath = validatePath(outputPath, context.cwd);
+            }
+            catch (err) {
+                return { success: false, output: err.message };
+            }
+        }
+        else {
+            testPath = this.resolveTestPath(absolutePath, framework, context.cwd);
+        }
+        // Check if test file already exists
+        try {
+            await access(testPath);
+            return {
+                success: false,
+                output: `Test file already exists: ${testPath}\nUse output_path to specify a different location, or delete the existing file first.`,
+            };
+        }
+        catch { /* good — doesn't exist */ }
+        // Write test file
+        await mkdir(dirname(testPath), { recursive: true });
+        await writeFile(testPath, testContent, 'utf-8');
+        const lineCount = testContent.split('\n').length;
+        return {
+            success: true,
+            output: `Generated ${framework.name} test file:\n  ${testPath}\n  ${symbols.length} test cases, ${lineCount} lines\n\nSymbols covered:\n${symbols.map(s => `  - ${s}`).join('\n')}`,
+            metadata: { path: testPath, framework: framework.name, symbols, lineCount },
+        };
+    }
+    extractJsSymbols(source) {
+        const symbols = [];
+        // export function/const/class
+        const exportRegex = /export\s+(?:default\s+)?(?:function|const|class|async\s+function)\s+(\w+)/g;
+        let match;
+        while ((match = exportRegex.exec(source)) !== null) {
+            symbols.push(match[1]);
+        }
+        // module.exports
+        const cjsRegex = /module\.exports\s*=\s*\{?\s*([\w\s,]+)/;
+        const cjsMatch = source.match(cjsRegex);
+        if (cjsMatch) {
+            symbols.push(...cjsMatch[1].split(',').map(s => s.trim()).filter(Boolean));
+        }
+        return symbols.length > 0 ? symbols : ['default'];
+    }
+    extractPythonSymbols(source) {
+        const symbols = [];
+        const funcRegex = /^(?:def|class|async\s+def)\s+(\w+)/gm;
+        let match;
+        while ((match = funcRegex.exec(source)) !== null) {
+            if (!match[1].startsWith('_'))
+                symbols.push(match[1]);
+        }
+        return symbols.length > 0 ? symbols : ['main'];
+    }
+    async detectFramework(cwd, isPython) {
+        if (isPython)
+            return this.getFramework('pytest', true);
+        try {
+            const pkg = JSON.parse(await readFile(join(cwd, 'package.json'), 'utf-8'));
+            const deps = { ...pkg.devDependencies, ...pkg.dependencies };
+            if (deps.vitest)
+                return this.getFramework('vitest', false);
+            if (deps.jest)
+                return this.getFramework('jest', false);
+            if (deps.mocha)
+                return this.getFramework('mocha', false);
+            // Default to vitest for TS/JS projects
+            return this.getFramework('vitest', false);
+        }
+        catch {
+            return null;
+        }
+    }
+    getFramework(name, isPython) {
+        if (isPython || name === 'pytest') {
+            return {
+                name: 'pytest',
+                extension: '.py',
+                testDir: 'tests',
+                testSuffix: 'test_',
+                imports: '',
+                template: (fileName, _content) => `# Tests for ${fileName}`,
+            };
+        }
+        const frameworks = {
+            jest: {
+                name: 'jest', extension: '.test.ts', testDir: '__tests__', testSuffix: '.test',
+                imports: '',
+                template: (fn) => `import { ${fn} } from`,
+            },
+            vitest: {
+                name: 'vitest', extension: '.test.ts', testDir: '__tests__', testSuffix: '.test',
+                imports: "import { describe, it, expect } from 'vitest';",
+                template: (fn) => `import { ${fn} } from`,
+            },
+            mocha: {
+                name: 'mocha', extension: '.test.ts', testDir: 'test', testSuffix: '.test',
+                imports: "import { expect } from 'chai';",
+                template: (fn) => `import { ${fn} } from`,
+            },
+        };
+        return frameworks[name] || null;
+    }
+    buildTest(framework, name, sourcePath, symbols, existing) {
+        if (framework.name === 'pytest') {
+            return this.buildPytestFile(name, sourcePath, symbols);
+        }
+        return this.buildJsTestFile(framework, name, sourcePath, symbols, existing);
+    }
+    buildPytestFile(name, sourcePath, symbols) {
+        const module = sourcePath.replace(/\.py$/, '').replace(/[/\\]/g, '.');
+        let out = `"""Tests for ${name}."""\n\n`;
+        out += `from ${module} import ${symbols.join(', ')}\n\n\n`;
+        for (const sym of symbols) {
+            const isClass = sym[0] === sym[0].toUpperCase() && sym[0] !== sym[0].toLowerCase();
+            if (isClass) {
+                out += `class Test${sym}:\n`;
+                out += `    """Tests for ${sym}."""\n\n`;
+                out += `    def test_init(self):\n`;
+                out += `        """Test ${sym} initialization."""\n`;
+                out += `        instance = ${sym}()\n`;
+                out += `        assert instance is not None\n\n`;
+            }
+            else {
+                out += `def test_${sym}():\n`;
+                out += `    """Test ${sym}."""\n`;
+                out += `    result = ${sym}()\n`;
+                out += `    assert result is not None\n\n\n`;
+            }
+        }
+        return out;
+    }
+    buildJsTestFile(framework, name, sourcePath, symbols, _existing) {
+        const relPath = sourcePath.replace(/\\/g, '/');
+        const importPath = relPath.replace(/\.(ts|tsx|js|jsx)$/, '');
+        let out = '';
+        if (framework.imports)
+            out += `${framework.imports}\n`;
+        out += `import { ${symbols.join(', ')} } from '${importPath}';\n\n`;
+        out += `describe('${name}', () => {\n`;
+        for (const sym of symbols) {
+            out += `  describe('${sym}', () => {\n`;
+            out += `    it('should exist', () => {\n`;
+            out += `      expect(${sym}).toBeDefined();\n`;
+            out += `    });\n\n`;
+            out += `    it('should work correctly', () => {\n`;
+            out += `      // TODO: Add test implementation\n`;
+            out += `      expect(true).toBe(true);\n`;
+            out += `    });\n`;
+            out += `  });\n\n`;
+        }
+        out += '});\n';
+        return out;
+    }
+    resolveTestPath(sourcePath, framework, cwd) {
+        const ext = extname(sourcePath);
+        const name = basename(sourcePath, ext);
+        const dir = dirname(sourcePath);
+        if (framework.name === 'pytest') {
+            return join(cwd, 'tests', `test_${name}.py`);
+        }
+        // Co-locate test next to source file
+        return join(dir, `${name}${framework.extension}`);
+    }
+    async findExistingTest(cwd, framework) {
+        try {
+            const pattern = framework.name === 'pytest'
+                ? 'tests/test_*.py'
+                : `**/*${framework.testSuffix}${framework.extension}`;
+            const files = await glob(pattern, { cwd, absolute: true, nodir: true });
+            if (files.length > 0) {
+                const content = await readFile(files[0], 'utf-8');
+                return content.slice(0, 2000); // First 2K for style reference
+            }
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+}
+//# sourceMappingURL=test-generate.js.map

package/dist/tools/test-generate.js.map

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

package/dist/tools/test-run.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class TestRunTool implements Tool {
+    readonly name = "test_run";
+    readonly description = "Detect the project test framework and run tests (full suite or specific file)";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private detectRunner;
+    private parseResults;
+}
+//# sourceMappingURL=test-run.d.ts.map

package/dist/tools/test-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-run.d.ts","sourceRoot":"","sources":["../../src/tools/test-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAc5D,qBAAa,WAAY,YAAW,IAAI;IACtC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,mFAAmF;IACvG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAwB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YAwElF,YAAY;IA8C1B,OAAO,CAAC,YAAY;CAiCrB"}

package/dist/tools/test-run.js

@@ -0,0 +1,177 @@
+import { exec } from 'node:child_process';
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Characters that could be used for shell injection */
+const SHELL_INJECTION_PATTERN = /[;&|`$(){}[\]<>!#\\'"]/;
+const TEST_TIMEOUT_MS = 300_000; // 5 minutes
+const MAX_OUTPUT_LENGTH = 30_000;
+export class TestRunTool {
+    name = 'test_run';
+    description = 'Detect the project test framework and run tests (full suite or specific file)';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'test_run',
+        description: 'Detect the test framework in the current project and run tests. ' +
+            'Auto-detects Jest, Vitest, Mocha, Pytest, Cargo test, Go test, and more. ' +
+            'Can run the full suite or a specific test file. Returns pass/fail counts and failure details.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Run tests for a specific file only. Omit for full test suite.',
+                },
+                command: {
+                    type: 'string',
+                    description: 'Override auto-detected test command (e.g., "npm test", "pytest -x").',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Timeout in seconds. Default: 300 (5 minutes).',
+                },
+            },
+            required: [],
+        },
+    };
+    async execute(args, context) {
+        const filePath = args.file_path;
+        const commandOverride = args.command;
+        const timeout = (args.timeout ?? 300) * 1000;
+        // Validate filePath against shell injection
+        if (filePath && SHELL_INJECTION_PATTERN.test(filePath)) {
+            return { success: false, output: 'file_path contains unsafe characters. Use a plain file path without shell metacharacters.' };
+        }
+        let command;
+        if (commandOverride) {
+            command = filePath ? `${commandOverride} ${filePath}` : commandOverride;
+        }
+        else {
+            const runner = await this.detectRunner(context.cwd);
+            if (!runner) {
+                return { success: false, output: 'Could not detect a test framework. Use the "command" parameter to specify one.' };
+            }
+            command = filePath && runner.fileFlag
+                ? `${runner.command} ${runner.fileFlag} ${filePath}`
+                : filePath
+                    ? `${runner.command} ${filePath}`
+                    : runner.command;
+        }
+        return new Promise((resolve) => {
+            const child = exec(command, {
+                cwd: context.cwd,
+                timeout: Math.min(timeout, TEST_TIMEOUT_MS),
+                maxBuffer: 1024 * 1024 * 10,
+                env: { ...process.env, FORCE_COLOR: '0', CI: 'true' },
+            }, (error, stdout, stderr) => {
+                let output = '';
+                if (stdout)
+                    output += stdout;
+                if (stderr)
+                    output += (output ? '\n' : '') + stderr;
+                if (error?.killed) {
+                    output += `\n\nTest timed out after ${Math.round(timeout / 1000)}s`;
+                }
+                if (output.length > MAX_OUTPUT_LENGTH) {
+                    output = output.slice(0, MAX_OUTPUT_LENGTH) + '\n... (output truncated)';
+                }
+                // Parse results
+                const parsed = this.parseResults(output);
+                let summary = `Command: ${command}\n`;
+                summary += `Result: ${error ? 'FAILED' : 'PASSED'}\n`;
+                if (parsed) {
+                    summary += `Tests: ${parsed.passed} passed, ${parsed.failed} failed`;
+                    if (parsed.skipped > 0)
+                        summary += `, ${parsed.skipped} skipped`;
+                    summary += ` (${parsed.total} total)\n`;
+                }
+                summary += `\n${output}`;
+                resolve({
+                    success: !error,
+                    output: summary,
+                    metadata: { command, ...(parsed || {}) },
+                });
+            });
+            if (context.onOutput) {
+                const onOutput = context.onOutput;
+                child.stdout?.on('data', (chunk) => onOutput(chunk.toString()));
+                child.stderr?.on('data', (chunk) => onOutput(chunk.toString()));
+            }
+        });
+    }
+    async detectRunner(cwd) {
+        // Check package.json for JS/TS projects
+        try {
+            const pkg = JSON.parse(await readFile(join(cwd, 'package.json'), 'utf-8'));
+            const deps = { ...pkg.devDependencies, ...pkg.dependencies };
+            const scripts = pkg.scripts || {};
+            if (deps.vitest || scripts.test?.includes('vitest')) {
+                return { name: 'Vitest', command: 'npx vitest run', fileFlag: '' };
+            }
+            if (deps.jest || scripts.test?.includes('jest')) {
+                return { name: 'Jest', command: 'npx jest --no-coverage', fileFlag: '' };
+            }
+            if (deps.mocha || scripts.test?.includes('mocha')) {
+                return { name: 'Mocha', command: 'npx mocha', fileFlag: '' };
+            }
+            if (scripts.test) {
+                return { name: 'npm test', command: 'npm test --' };
+            }
+        }
+        catch { /* not a JS project */ }
+        // Python
+        try {
+            await access(join(cwd, 'pyproject.toml'));
+            return { name: 'Pytest', command: 'python -m pytest -v', fileFlag: '' };
+        }
+        catch { /* ignore */ }
+        try {
+            await access(join(cwd, 'setup.py'));
+            return { name: 'Pytest', command: 'python -m pytest -v', fileFlag: '' };
+        }
+        catch { /* ignore */ }
+        // Rust
+        try {
+            await access(join(cwd, 'Cargo.toml'));
+            return { name: 'Cargo', command: 'cargo test', fileFlag: '--' };
+        }
+        catch { /* ignore */ }
+        // Go
+        try {
+            await access(join(cwd, 'go.mod'));
+            return { name: 'Go', command: 'go test ./...', fileFlag: '-run' };
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+    parseResults(output) {
+        // Jest/Vitest: "Tests:  2 passed, 1 failed, 3 total"
+        const jestMatch = output.match(/Tests:\s+(\d+)\s+passed,?\s*(\d+)\s+failed,?\s*(?:(\d+)\s+skipped,?\s*)?(\d+)\s+total/i);
+        if (jestMatch) {
+            return { passed: +jestMatch[1], failed: +jestMatch[2], skipped: +(jestMatch[3] || 0), total: +jestMatch[4] };
+        }
+        // Pytest: "2 passed, 1 failed"
+        const pytestPassed = output.match(/(\d+)\s+passed/);
+        const pytestFailed = output.match(/(\d+)\s+failed/);
+        const pytestSkipped = output.match(/(\d+)\s+skipped/);
+        if (pytestPassed || pytestFailed) {
+            const p = +(pytestPassed?.[1] || 0);
+            const f = +(pytestFailed?.[1] || 0);
+            const s = +(pytestSkipped?.[1] || 0);
+            return { passed: p, failed: f, skipped: s, total: p + f + s };
+        }
+        // Go: "ok" or "FAIL" lines
+        const goOk = (output.match(/^ok\s/gm) || []).length;
+        const goFail = (output.match(/^FAIL\s/gm) || []).length;
+        if (goOk + goFail > 0) {
+            return { passed: goOk, failed: goFail, skipped: 0, total: goOk + goFail };
+        }
+        // Cargo: "test result: ok. X passed; Y failed"
+        const cargoMatch = output.match(/test result:.*?(\d+)\s+passed;\s+(\d+)\s+failed;\s+(\d+)\s+ignored/);
+        if (cargoMatch) {
+            return { passed: +cargoMatch[1], failed: +cargoMatch[2], skipped: +cargoMatch[3], total: +cargoMatch[1] + +cargoMatch[2] + +cargoMatch[3] };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=test-run.js.map

package/dist/tools/test-run.js.map

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

package/dist/tools/todo-write.d.ts

@@ -0,0 +1,11 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class TodoWriteTool implements Tool {
+    readonly name = "todo_write";
+    readonly description = "Create or update a visual task list for tracking progress";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=todo-write.d.ts.map

package/dist/tools/todo-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write.d.ts","sourceRoot":"","sources":["../../src/tools/todo-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,+DAA+D;IACnF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAmC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA+BjG"}

package/dist/tools/todo-write.js

@@ -0,0 +1,70 @@
+export class TodoWriteTool {
+    name = 'todo_write';
+    description = 'Create or update a visual task list for tracking progress';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'todo_write',
+        description: 'Create or update a visual task list. Call this when starting multi-step work ' +
+            'and update it as you complete steps. The user sees it as a live card with status indicators. ' +
+            'Always pass the full list on each call (replaces previous state).',
+        parameters: {
+            type: 'object',
+            properties: {
+                todos: {
+                    type: 'array',
+                    description: 'The complete task list (replaces any previous list)',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            content: {
+                                type: 'string',
+                                description: 'Task description in imperative form (e.g. "Fix linting errors")',
+                            },
+                            status: {
+                                type: 'string',
+                                enum: ['pending', 'in_progress', 'completed'],
+                                description: 'Current status of this task',
+                            },
+                            activeForm: {
+                                type: 'string',
+                                description: 'Present-continuous form shown while running (e.g. "Fixing linting errors")',
+                            },
+                        },
+                        required: ['content', 'status', 'activeForm'],
+                    },
+                },
+            },
+            required: ['todos'],
+        },
+    };
+    async execute(args, context) {
+        const todos = args.todos;
+        const done = todos.filter((t) => t.status === 'completed').length;
+        const lines = todos.map((t) => {
+            const icon = t.status === 'completed' ? '[x]' : t.status === 'in_progress' ? '[~]' : '[ ]';
+            return `${icon} ${t.content}`;
+        });
+        // Persist to TaskManager if available (session tasks)
+        const taskManager = context.sharedState?.taskManager;
+        if (taskManager) {
+            for (const todo of todos) {
+                const statusMap = {
+                    pending: 'todo',
+                    in_progress: 'in-progress',
+                    completed: 'done',
+                };
+                taskManager.addSessionTask({
+                    id: `session-${todo.content.slice(0, 40).replace(/\s+/g, '-').toLowerCase()}`,
+                    title: todo.content,
+                    status: statusMap[todo.status] ?? 'todo',
+                });
+            }
+        }
+        return {
+            success: true,
+            output: `Tasks updated (${done}/${todos.length} done):\n${lines.join('\n')}`,
+        };
+    }
+}
+//# sourceMappingURL=todo-write.js.map

package/dist/tools/todo-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write.js","sourceRoot":"","sources":["../../src/tools/todo-write.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,2DAA2D,CAAC;IAC1E,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,+EAA+E;YAC/E,+FAA+F;YAC/F,mEAAmE;QACrE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,qDAAqD;oBAClE,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,iEAAiE;6BAC/E;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC;gCAC7C,WAAW,EAAE,6BAA6B;6BAC3C;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4EAA4E;6BAC1F;yBACF;wBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;qBAC9C;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAwE,CAAC;QAC5F,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QAClE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3F,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,sDAAsD;QACtD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,WAC8E,CAAC;QACxH,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAoD;oBACjE,OAAO,EAAE,MAAM;oBACf,WAAW,EAAE,aAAa;oBAC1B,SAAS,EAAE,MAAM;iBAClB,CAAC;gBACF,WAAW,CAAC,cAAc,CAAC;oBACzB,EAAE,EAAE,WAAW,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;oBAC7E,KAAK,EAAE,IAAI,CAAC,OAAO;oBACnB,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM;iBACzC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,kBAAkB,IAAI,IAAI,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC7E,CAAC;IACJ,CAAC;CACF"}