@id3-clarity/mcp-server 1.5.0

package/dist/tools/index.js

@@ -0,0 +1,1120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS = void 0;
+const REQ_PROJECT_ID = {
+    projectId: { type: 'string', format: 'uuid', description: 'Project UUID (REQUIRED)' },
+};
+exports.TOOLS = [
+    // === Read tools (15) ===
+    {
+        name: 'list_projects',
+        description: {
+            tr: "CLARITY'de erişebileceğin projeleri listeler.",
+            en: 'Lists CLARITY projects accessible to your token.',
+        },
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_project',
+        description: {
+            tr: 'Belirtilen projenin detaylarını döndürür.',
+            en: 'Returns details of a specific project.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'get_project_stats',
+        description: {
+            tr: 'Proje istatistikleri (case sayısı, son 30 gün başarı oranı).',
+            en: 'Project statistics (case count, last 30 days success rate).',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'list_folders',
+        description: {
+            tr: 'Projedeki klasörleri (flat) listeler.',
+            en: 'Lists folders in a project (flat).',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'get_folder_tree',
+        description: {
+            tr: 'Klasör hiyerarşisini ağaç olarak döner.',
+            en: 'Returns folder hierarchy as a tree.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'list_test_cases',
+        description: {
+            tr: "Test case'leri sayfalı listeler. folderId/type/priority/status/tag/search filtreleri destekler.",
+            en: 'Lists test cases (paginated). Supports folderId/type/priority/status/tag/search filters.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                folderId: { type: 'string', format: 'uuid' },
+                type: {
+                    type: 'string',
+                    enum: ['MANUAL', 'AUTOMATED', 'CUCUMBER', 'API', 'PERFORMANCE', 'SECURITY', 'EXPLORATORY'],
+                },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                status: { type: 'string', enum: ['ACTIVE', 'ARCHIVED'] },
+                tag: { type: 'string' },
+                search: { type: 'string' },
+                page: { type: 'number', minimum: 1, default: 1 },
+                limit: { type: 'number', minimum: 1, maximum: 200, default: 50 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_test_case',
+        description: {
+            tr: 'Test case detayını döner (steps + metadata + ilişkiler).',
+            en: 'Returns test case detail (steps + metadata + relations).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { ...REQ_PROJECT_ID, caseId: { type: 'string', format: 'uuid' } },
+            required: ['projectId', 'caseId'],
+        },
+    },
+    {
+        name: 'search_test_cases',
+        description: {
+            tr: "Test case'lerde başlık ile full-text arama.",
+            en: 'Full-text search by title in test cases.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                query: { type: 'string', minLength: 1, maxLength: 200 },
+                limit: { type: 'number', minimum: 1, maximum: 100, default: 20 },
+            },
+            required: ['projectId', 'query'],
+        },
+    },
+    {
+        name: 'list_suites',
+        description: {
+            tr: "Test suite'leri listeler.",
+            en: 'Lists test suites.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'get_suite',
+        description: {
+            tr: "Suite detayını + içindeki case'leri döner.",
+            en: 'Returns suite detail with included cases.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { ...REQ_PROJECT_ID, suiteId: { type: 'string', format: 'uuid' } },
+            required: ['projectId', 'suiteId'],
+        },
+    },
+    {
+        name: 'list_runs',
+        description: {
+            tr: "Test run'ları listeler. status filtresi destekler.",
+            en: 'Lists test runs. Supports status filter.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                status: { type: 'string', enum: ['PENDING', 'IN_PROGRESS', 'COMPLETED', 'CANCELLED'] },
+                limit: { type: 'number', minimum: 1, maximum: 100, default: 20 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_run',
+        description: {
+            tr: 'Run detayını + execution sonuçlarını döner.',
+            en: 'Returns run detail with execution results.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { ...REQ_PROJECT_ID, runId: { type: 'string', format: 'uuid' } },
+            required: ['projectId', 'runId'],
+        },
+    },
+    {
+        name: 'get_run_progress',
+        description: {
+            tr: 'Run ilerleme istatistikleri (pass/fail/skip/blocked/pending sayıları).',
+            en: 'Run progress statistics (pass/fail/skip/blocked/pending counts).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { ...REQ_PROJECT_ID, runId: { type: 'string', format: 'uuid' } },
+            required: ['projectId', 'runId'],
+        },
+    },
+    {
+        name: 'get_failing_cases',
+        description: {
+            tr: "Son N gün içinde en çok hata alan test case'ler.",
+            en: 'Top failing test cases in the last N days.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                days: { type: 'number', minimum: 1, maximum: 365, default: 30 },
+                limit: { type: 'number', minimum: 1, maximum: 100, default: 10 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_test_type_info',
+        description: {
+            tr: 'Test tipi enum değerleri ve açıklamaları (MANUAL/API/AUTOMATED vb.).',
+            en: 'Test type enum values and descriptions (MANUAL/API/AUTOMATED etc.).',
+        },
+        inputSchema: { type: 'object', properties: {} },
+    },
+    // === Write tools (12) ===
+    {
+        name: 'create_project',
+        description: {
+            tr: 'Yeni proje oluşturur.',
+            en: 'Creates a new project.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                code: { type: 'string', minLength: 1, maxLength: 50 },
+                description: { type: 'string', maxLength: 1000 },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['name', 'code'],
+        },
+    },
+    {
+        name: 'update_project',
+        description: {
+            tr: 'Proje bilgilerini günceller.',
+            en: 'Updates project info.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                description: { type: 'string', maxLength: 1000 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'create_folder',
+        description: {
+            tr: 'Klasör oluşturur. parentId ile nested.',
+            en: 'Creates a folder. Use parentId for nested.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                parentId: { type: 'string', format: 'uuid' },
+            },
+            required: ['projectId', 'name'],
+        },
+    },
+    {
+        name: 'update_folder',
+        description: {
+            tr: "Klasör adını/parent'ı günceller.",
+            en: 'Updates folder name/parent.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                folderId: { type: 'string', format: 'uuid' },
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                parentId: { type: 'string', format: 'uuid' },
+            },
+            required: ['projectId', 'folderId'],
+        },
+    },
+    {
+        name: 'create_test_case',
+        description: {
+            tr: "Yeni test case oluşturur. type MANUAL veya AUTOMATED; API/FUNCTIONAL/UI/E2E/PERFORMANCE/SECURITY otomatik MANUAL'a coerce + testTypes'a eklenir.",
+            en: 'Creates a new test case. type must be MANUAL or AUTOMATED; API/FUNCTIONAL/UI/E2E/PERFORMANCE/SECURITY auto-coerce to MANUAL with value pushed to testTypes.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                title: { type: 'string', minLength: 1, maxLength: 200 },
+                description: { type: 'string', maxLength: 1000 },
+                preconditions: { type: 'string' },
+                type: {
+                    type: 'string',
+                    enum: ['MANUAL', 'AUTOMATED', 'CUCUMBER', 'API', 'PERFORMANCE', 'SECURITY', 'EXPLORATORY'],
+                },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                tags: { type: 'array', items: { type: 'string' } },
+                testTypes: { type: 'array', items: { type: 'string' } },
+                steps: {
+                    type: 'array',
+                    minItems: 1,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            order: { type: 'number' },
+                            action: { type: 'string' },
+                            expectedResult: { type: 'string' },
+                        },
+                    },
+                },
+                folderId: { type: 'string', format: 'uuid' },
+                metadata: { type: 'object', additionalProperties: true },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'title', 'steps'],
+        },
+    },
+    {
+        name: 'update_test_case',
+        description: {
+            tr: "Test case alanlarını günceller. folderId vererek case'i başka bir klasöre taşıyabilirsin (null = proje kökü); hedef klasör aynı projeye ait olmalı. Çoklu taşıma için bulk_move_test_cases kullan.",
+            en: 'Updates test case fields. Pass folderId to move the case to another folder (null = project root); the target folder must belong to the same project. For moving many cases use bulk_move_test_cases.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                caseId: { type: 'string', format: 'uuid' },
+                title: { type: 'string', minLength: 1, maxLength: 200 },
+                description: { type: 'string', maxLength: 1000 },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                status: { type: 'string', enum: ['ACTIVE', 'ARCHIVED'] },
+                tags: { type: 'array', items: { type: 'string' } },
+                steps: { type: 'array' },
+                folderId: { type: ['string', 'null'], format: 'uuid' },
+            },
+            required: ['projectId', 'caseId'],
+        },
+    },
+    {
+        name: 'bulk_create_test_cases',
+        description: {
+            tr: 'Birden fazla test case oluşturur (max 50). Daha fazlası için import_test_cases_json kullan.',
+            en: 'Bulk create test cases (max 50). For more, use import_test_cases_json.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                testCases: { type: 'array', minItems: 1, maxItems: 50, items: { type: 'object' } },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'testCases'],
+        },
+    },
+    {
+        name: 'bulk_move_test_cases',
+        description: {
+            tr: "Birden fazla test case'i (max 200) tek seferde bir klasöre taşır; folderId null verilirse proje köküne taşır. Hedef klasör belirtilen projeye ait olmalı; farklı projeye/eksik/silinmiş id'ler taşınmaz ve notFound içinde döner.",
+            en: 'Moves many test cases (max 200) into one folder at once; pass folderId null to move them to the project root. The target folder must belong to the given project; ids from another project / missing / soft-deleted are skipped and returned in notFound.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                caseIds: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 200,
+                    items: { type: 'string', format: 'uuid' },
+                },
+                folderId: { type: ['string', 'null'], format: 'uuid' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'caseIds', 'folderId'],
+        },
+    },
+    {
+        name: 'import_test_cases_json',
+        description: {
+            tr: 'JSON içerik ile bulk test case import. CLARITY JSON şeması kullanılır (canonical veya suggestions[] alias). folderStrategy ve duplicateStrategy ile akış kontrolü.',
+            en: 'Bulk import test cases via JSON content. Uses CLARITY JSON schema (canonical or suggestions[] alias). Control flow with folderStrategy and duplicateStrategy.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                jsonContent: { type: 'string', minLength: 2 },
+                folderId: { type: 'string', format: 'uuid' },
+                folderStrategy: {
+                    type: 'string',
+                    enum: ['auto-create', 'find-or-create', 'existing-only'],
+                    default: 'find-or-create',
+                },
+                duplicateStrategy: {
+                    type: 'string',
+                    enum: ['skip', 'update', 'create-new'],
+                    default: 'skip',
+                },
+            },
+            required: ['projectId', 'jsonContent'],
+        },
+    },
+    {
+        name: 'create_suite',
+        description: {
+            tr: 'Yeni test suite oluşturur.',
+            en: 'Creates a new test suite.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                description: { type: 'string', maxLength: 1000 },
+            },
+            required: ['projectId', 'name'],
+        },
+    },
+    {
+        name: 'update_suite',
+        description: {
+            tr: "Suite'i günceller. addCaseIds/removeCaseIds ile case ekleme/çıkarma.",
+            en: 'Updates a suite. Use addCaseIds/removeCaseIds for case mgmt.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                suiteId: { type: 'string', format: 'uuid' },
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                description: { type: 'string', maxLength: 1000 },
+                addCaseIds: { type: 'array', items: { type: 'string', format: 'uuid' } },
+                removeCaseIds: { type: 'array', items: { type: 'string', format: 'uuid' } },
+            },
+            required: ['projectId', 'suiteId'],
+        },
+    },
+    {
+        name: 'create_run',
+        description: {
+            tr: 'Test run oluşturur. suiteId VEYA caseIds[] VEYA suggestSuite zorunlu. assignee (userId) ile atama yapılabilir.',
+            en: 'Creates a test run. Either suiteId OR caseIds[] OR suggestSuite required. Optional assignee (userId) reassigns executions.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 100 },
+                testSuiteId: { type: 'string', format: 'uuid' },
+                testCaseIds: { type: 'array', items: { type: 'string', format: 'uuid' } },
+                plannedStartDate: { type: 'string', format: 'date-time' },
+                plannedEndDate: { type: 'string', format: 'date-time' },
+                assignee: {
+                    type: 'string',
+                    format: 'uuid',
+                    description: 'Optional userId to assign the run executions to (tenant-scoped).',
+                },
+                suggestSuite: {
+                    type: 'boolean',
+                    description: 'When true and no explicit suite/cases given, heuristically pick stale-first ACTIVE cases.',
+                },
+            },
+            required: ['projectId', 'name'],
+        },
+    },
+    {
+        name: 'update_execution_result',
+        description: {
+            tr: "Run içindeki bir case'in execution sonucunu günceller (passed/failed/skipped/blocked).",
+            en: 'Updates execution result for a case within a run (passed/failed/skipped/blocked).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                runId: { type: 'string', format: 'uuid' },
+                caseId: { type: 'string', format: 'uuid' },
+                status: { type: 'string', enum: ['PASS', 'FAIL', 'SKIP', 'BLOCKED'] },
+                comment: { type: 'string', maxLength: 2000 },
+            },
+            required: ['projectId', 'runId', 'caseId', 'status'],
+        },
+    },
+    // === Delete tools (3, with confirmation) ===
+    {
+        name: 'delete_test_case',
+        description: {
+            tr: "Test case'i siler (soft-delete, 30 gün geri alınabilir). 1. çağrı confirmationToken döner; 2. çağrıda confirmationToken parametresi gönderin.",
+            en: 'Deletes a test case (soft-delete, restorable in 30 days). 1st call returns confirmationToken; 2nd call must include confirmationToken parameter.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                caseId: { type: 'string', format: 'uuid' },
+                confirmationToken: { type: 'string' },
+            },
+            required: ['projectId', 'caseId'],
+        },
+    },
+    {
+        name: 'delete_folder',
+        description: {
+            tr: "Klasör ve içindeki case'leri siler (soft-delete, 30 gün geri alınabilir). 2-aşamalı confirmation.",
+            en: 'Deletes folder + cases inside (soft-delete, restorable in 30 days). 2-step confirmation.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                folderId: { type: 'string', format: 'uuid' },
+                confirmationToken: { type: 'string' },
+            },
+            required: ['projectId', 'folderId'],
+        },
+    },
+    {
+        name: 'delete_suite',
+        description: {
+            tr: "Suite'i siler (case'ler kalır). 2-aşamalı confirmation.",
+            en: 'Deletes a suite (cases remain). 2-step confirmation.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                suiteId: { type: 'string', format: 'uuid' },
+                confirmationToken: { type: 'string' },
+            },
+            required: ['projectId', 'suiteId'],
+        },
+    },
+    // === Requirements (5) ===
+    {
+        name: 'list_requirements',
+        description: {
+            tr: 'Bir projedeki gereksinimleri listeler. type / status / priority / assignee / source / syncStatus / testable / search filtreleri destekler.',
+            en: 'Lists requirements in a project. Supports type / status / priority / assignee / source / syncStatus / testable / search filters.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', format: 'uuid', description: 'Project UUID (REQUIRED)' },
+                type: { type: 'string', description: 'Type key (story, epic, task...) or UUID typeId — service auto-resolves' },
+                status: { type: 'string', description: 'Status key (open, in_progress, resolved, closed) or UUID statusId' },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                source: { type: 'string', enum: ['jira', 'azure_devops', 'manual'] },
+                syncStatus: { type: 'string', enum: ['synced', 'pending', 'error', 'conflict', 'manual'] },
+                testable: { type: 'boolean' },
+                assignee: { type: 'string' },
+                search: { type: 'string', maxLength: 200, description: 'Free-text match on code/title/description' },
+                limit: { type: 'number', minimum: 1, maximum: 500, default: 100 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_requirement',
+        description: {
+            tr: 'Tek bir gereksinimin tam detayını döner (attachments, Jira/Azure sync durumu dahil).',
+            en: 'Returns full requirement detail including attachments and Jira/Azure sync status.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+            },
+            required: ['requirementId'],
+        },
+    },
+    {
+        name: 'create_requirement',
+        description: {
+            tr: 'Yeni gereksinim oluşturur. `type`/`status` legacy varchar key veya `typeId`/`statusId` UUID kabul eder — backend otomatik resolve eder. idempotencyKey ile tekrar denemeler güvenli.',
+            en: 'Creates a new requirement. Accepts legacy varchar `type`/`status` OR modern `typeId`/`statusId` UUIDs — backend auto-resolves. idempotencyKey makes retries safe.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', format: 'uuid', description: 'Project UUID (REQUIRED)' },
+                key: { type: 'string', minLength: 1, maxLength: 64, description: 'Per-project unique key, e.g. REQ-101' },
+                title: { type: 'string', minLength: 1, maxLength: 500 },
+                description: { type: 'string', maxLength: 10000 },
+                type: { type: 'string', description: 'Legacy varchar key (story/epic/task/bug/improvement) — backend resolves' },
+                typeId: { type: 'string', format: 'uuid', description: 'Configured RequirementType UUID — preferred over type' },
+                status: { type: 'string', description: 'Legacy varchar key (open/in_progress/...)' },
+                statusId: { type: 'string', format: 'uuid', description: 'Configured RequirementStatus UUID — preferred' },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                assignee: { type: 'string', maxLength: 200 },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'key', 'title'],
+        },
+    },
+    {
+        name: 'update_requirement',
+        description: {
+            tr: "Gereksinim alanlarını günceller. Jira/Azure'a bağlı bir gereksinim güncellenirse syncStatus otomatik 'pending'e düşer — sonra sync_requirement çağırılmalı (v1.3'te gelecek).",
+            en: "Updates requirement fields. If linked to Jira/Azure, syncStatus auto-flips to 'pending' — call sync_requirement (v1.3) to push back.",
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                key: { type: 'string', minLength: 1, maxLength: 64 },
+                title: { type: 'string', minLength: 1, maxLength: 500 },
+                description: { type: 'string', maxLength: 10000 },
+                type: { type: 'string' },
+                typeId: { type: 'string', format: 'uuid' },
+                status: { type: 'string' },
+                statusId: { type: 'string', format: 'uuid' },
+                priority: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'] },
+                assignee: { type: 'string', maxLength: 200 },
+                testable: { type: 'boolean' },
+            },
+            required: ['requirementId'],
+        },
+    },
+    {
+        name: 'link_requirement_to_test_case',
+        description: {
+            tr: 'Bir gereksinimi bir veya daha fazla test case ile ilişkilendirir (max 100 per call). Zaten bağlı olanlar sessizce atlanır → idempotent.',
+            en: 'Links a requirement to one or more test cases (max 100 per call). Already-linked entries are silently skipped → idempotent.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                testCaseIds: {
+                    type: 'array',
+                    items: { type: 'string', format: 'uuid' },
+                    minItems: 1,
+                    maxItems: 100,
+                },
+            },
+            required: ['requirementId', 'testCaseIds'],
+        },
+    },
+    {
+        name: 'unlink_requirement_from_test_case',
+        description: {
+            tr: 'Bir gereksinim ile bir test case arasındaki bağlantıyı kaldırır. Bağlantı yoksa sessizce no-op → idempotent.',
+            en: 'Removes the link between a requirement and a single test case. No-op if the link does not exist → idempotent.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                testCaseId: { type: 'string', format: 'uuid' },
+            },
+            required: ['requirementId', 'testCaseId'],
+        },
+    },
+    {
+        name: 'delete_requirement',
+        description: {
+            tr: 'Bir gereksinimi soft-delete eder. Test case bağlantıları kaldırılır, test case\'lerin kendisi etkilenmez. İki adımlı onay gerekir (confirmationToken).',
+            en: 'Soft-deletes a requirement. Test case links are removed but the test cases themselves remain intact. Requires two-step confirmation (confirmationToken).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                confirmationToken: { type: 'string', description: 'Returned by the first call; required to confirm deletion.' },
+            },
+            required: ['requirementId'],
+        },
+    },
+    {
+        name: 'get_requirement_traceability',
+        description: {
+            tr: 'Projenin gereksinim → test case → son çalıştırma sonucu matrisini döner. Coverage yüzdesi ve özet istatistikler dahil.',
+            en: 'Returns the project\'s requirement → test case → last execution status traceability matrix. Includes coverage percentage and summary stats.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'list_requirement_types',
+        description: {
+            tr: 'Projedeki gereksinim tiplerini (system + project overrides) listeler. create/update_requirement için typeId değerlerini buradan alabilirsin.',
+            en: 'Lists requirement types for a project (system defaults + project overrides). Use these typeIds in create/update_requirement calls.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'list_requirement_statuses',
+        description: {
+            tr: 'Projedeki gereksinim statülerini (system + project overrides) listeler. create/update_requirement için statusId değerlerini buradan alabilirsin.',
+            en: 'Lists requirement statuses for a project (system defaults + project overrides). Use these statusIds in create/update_requirement calls.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    {
+        name: 'push_requirement_to_jira',
+        description: {
+            tr: 'Manuel olarak oluşturulmuş bir gereksinimi Jira\'ya yeni bir issue olarak push eder. Projenin Jira entegrasyonu yapılandırılmış olmalı.',
+            en: 'Pushes a manually-created requirement to Jira as a new issue. Project must have a Jira integration configured.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                jiraProjectKey: { type: 'string', minLength: 1, maxLength: 64, description: 'Jira project key (e.g. CLAR)' },
+                issueType: { type: 'string', minLength: 1, maxLength: 64, description: 'Jira issue type name (Story, Task, Bug...)' },
+            },
+            required: ['requirementId', 'jiraProjectKey', 'issueType'],
+        },
+    },
+    {
+        name: 'link_requirement_to_jira',
+        description: {
+            tr: 'Var olan bir Jira issue ile gereksinimi eşler. Gereksinim alanları Jira\'dan gelen verilerle güncellenir.',
+            en: 'Links a requirement to an existing Jira issue. Requirement fields are overwritten with Jira data.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirementId: { type: 'string', format: 'uuid' },
+                jiraIssueKey: { type: 'string', minLength: 1, maxLength: 64, description: 'Existing Jira issue key (e.g. CLAR-123)' },
+            },
+            required: ['requirementId', 'jiraIssueKey'],
+        },
+    },
+    {
+        name: 'sync_requirement',
+        description: {
+            tr: 'Jira/Azure DevOps\'a bağlı bir gereksinim için tek yönlü pull-sync yapar (uzaktan local\'e). Conflict varsa syncStatus="conflict" döner; manuel sadece reddedilir.',
+            en: 'One-way pull-sync from Jira/Azure DevOps to local for a linked requirement. Returns syncStatus="conflict" if both sides changed; manual requirements are rejected.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { requirementId: { type: 'string', format: 'uuid' } },
+            required: ['requirementId'],
+        },
+    },
+    {
+        name: 'push_requirement_update_to_jira',
+        description: {
+            tr: "CLARITY tarafındaki değişiklikleri, halihazırda bağlı olan Jira issue'ya YUKARI doğru push eder (sync_requirement'ın tersi). Strateji: last-write-wins + conflict tespiti. Jira son sync'ten sonra değişmişse push yapılmaz, syncStatus=\"conflict\" döner ve {pushed:false, conflict} ile yanıtlar. Sadece title/description/priority/assignee push edilir; status Jira workflow transition gerektirir.",
+            en: "Pushes CLARITY changes UP to the already-linked Jira issue (opposite of sync_requirement). Strategy: last-write-wins with conflict detection. If Jira was modified after the last sync, the push is rejected with syncStatus='conflict' and a {pushed:false, conflict} response. Only title/description/priority/assignee are pushed; status requires Jira workflow transitions.",
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { requirementId: { type: 'string', format: 'uuid' } },
+            required: ['requirementId'],
+        },
+    },
+    // === Releases (10) ===
+    {
+        name: 'list_releases',
+        description: {
+            tr: 'Projedeki sürümleri (release) listeler. status filtresi destekler. coveragePercent, overallPassRate, readinessScore otomatik hesaplanır.',
+            en: 'Lists releases in a project. Supports status filter. coveragePercent / overallPassRate / readinessScore are auto-computed.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                status: {
+                    type: 'string',
+                    enum: ['planning', 'testing', 'ready', 'released', 'cancelled'],
+                },
+                limit: { type: 'number', minimum: 1, maximum: 500, default: 100 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_release',
+        description: {
+            tr: 'Sürüm detayı — birleşik test koşumları (direkt + gereksinim üzerinden miras) ve koşum bazlı istatistikler dahil.',
+            en: 'Release detail — merged test runs (direct + inherited via requirements) with per-run statistics.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { releaseId: { type: 'string', format: 'uuid' } },
+            required: ['releaseId'],
+        },
+    },
+    {
+        name: 'create_release',
+        description: {
+            tr: 'Yeni sürüm oluşturur. status varsayılan "planning". jiraFixVersionId veya jiraSprintId ile Jira scope bağlanabilir. idempotencyKey ile tekrar denemeler güvenli.',
+            en: 'Creates a new release. status defaults to "planning". Optional jiraFixVersionId / jiraSprintId binds Jira scope. idempotencyKey makes retries safe.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 200 },
+                version: { type: 'string', maxLength: 50 },
+                description: { type: 'string', maxLength: 10000 },
+                status: {
+                    type: 'string',
+                    enum: ['planning', 'testing', 'ready', 'released', 'cancelled'],
+                },
+                plannedDate: { type: 'string', format: 'date-time' },
+                jiraFixVersion: { type: 'string', maxLength: 200 },
+                jiraFixVersionId: { type: 'string', maxLength: 100 },
+                jiraSprintId: { type: 'string', maxLength: 100 },
+                jiraSprintName: { type: 'string', maxLength: 200 },
+                releaseNotes: { type: 'string' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'name'],
+        },
+    },
+    {
+        name: 'update_release',
+        description: {
+            tr: 'Sürüm alanlarını günceller (partial). status "released" yapılırsa actualDate otomatik atanır. idempotencyKey destekler.',
+            en: 'Partial update of release fields. Setting status="released" auto-sets actualDate if missing. Supports idempotencyKey.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                name: { type: 'string', minLength: 1, maxLength: 200 },
+                version: { type: 'string', maxLength: 50 },
+                description: { type: 'string', maxLength: 10000 },
+                status: {
+                    type: 'string',
+                    enum: ['planning', 'testing', 'ready', 'released', 'cancelled'],
+                },
+                plannedDate: { type: 'string', format: 'date-time' },
+                actualDate: { type: 'string', format: 'date-time' },
+                jiraFixVersion: { type: 'string', maxLength: 200 },
+                jiraFixVersionId: { type: 'string', maxLength: 100 },
+                jiraSprintId: { type: 'string', maxLength: 100 },
+                jiraSprintName: { type: 'string', maxLength: 200 },
+                releaseNotes: { type: 'string' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['releaseId'],
+        },
+    },
+    {
+        name: 'delete_release',
+        description: {
+            tr: 'Sürümü soft-delete eder. Bağlı test koşumları ve gereksinimler etkilenmez. 2-aşamalı confirmation (1. çağrı confirmationToken döner; 2. çağrıda gönderin).',
+            en: 'Soft-deletes a release. Linked test runs and requirements remain intact. 2-step confirmation (1st call returns confirmationToken; 2nd must include it).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                confirmationToken: { type: 'string' },
+            },
+            required: ['releaseId'],
+        },
+    },
+    {
+        name: 'add_requirement_to_release',
+        description: {
+            tr: 'Bir gereksinimi sürüme ekler. Bu gereksinime bağlı test case\'ler içeren test koşumları otomatik olarak sürüme miras yoluyla bağlanır.',
+            en: 'Links a requirement to a release. Test runs whose cases are tied to that requirement are auto-linked (inherited) to the release.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                requirementId: { type: 'string', format: 'uuid' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['releaseId', 'requirementId'],
+        },
+    },
+    {
+        name: 'remove_requirement_from_release',
+        description: {
+            tr: 'Sürümden gereksinim bağlantısını kaldırır. Zaten bağlı değilse no-op döner — idempotent.',
+            en: 'Unlinks a requirement from a release. No-op if not linked — idempotent.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                requirementId: { type: 'string', format: 'uuid' },
+            },
+            required: ['releaseId', 'requirementId'],
+        },
+    },
+    {
+        name: 'bulk_remove_requirements_from_release',
+        description: {
+            tr: 'Sürümden birden fazla gereksinim bağlantısını tek seferde kaldırır (max 500). Bağlı olmayan ID\'ler sessizce atlanır — inherently idempotent.',
+            en: 'Bulk-unlink multiple requirements from a release (max 500). Non-linked IDs are silently skipped — inherently idempotent.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                requirementIds: {
+                    type: 'array',
+                    items: { type: 'string', format: 'uuid' },
+                    minItems: 1,
+                    maxItems: 500,
+                },
+            },
+            required: ['releaseId', 'requirementIds'],
+        },
+    },
+    {
+        name: 'add_test_run_to_release',
+        description: {
+            tr: 'Bir test koşumunu sürüme direkt olarak bağlar. runType ile koşumun tipini (feature/regression/smoke/re_test/custom) belirleyin.',
+            en: 'Directly attaches a test run to a release. Use runType to classify (feature/regression/smoke/re_test/custom).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                releaseId: { type: 'string', format: 'uuid' },
+                testRunId: { type: 'string', format: 'uuid' },
+                runType: {
+                    type: 'string',
+                    enum: ['feature', 'regression', 'smoke', 're_test', 'custom'],
+                    default: 'feature',
+                },
+                label: { type: 'string', maxLength: 200 },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['releaseId', 'testRunId'],
+        },
+    },
+    {
+        name: 'get_release_readiness',
+        description: {
+            tr: 'Sürüm release hazırlık skoru (60% pass rate + 40% coverage), gate pass/fail listesi, blocker listesi. NOT_READY/AT_RISK/READY durumu döner.',
+            en: 'Release readiness score (60% pass rate + 40% coverage), gates pass/fail array, blockers list. Returns NOT_READY / AT_RISK / READY status.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { releaseId: { type: 'string', format: 'uuid' } },
+            required: ['releaseId'],
+        },
+    },
+    // === Users (2) ===
+    {
+        name: 'list_users',
+        description: {
+            tr: 'Bir projeye atanmış kullanıcıları listeler (id, email, ad, soyad, rol).',
+            en: 'Lists users assigned to a project (id, email, firstName, lastName, role).',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                limit: { type: 'number', minimum: 1, maximum: 500, default: 100 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_user',
+        description: {
+            tr: 'Kullanıcı detaylarını döner — rol, departman, son giriş, proje üyeliği sayısı dahil.',
+            en: 'Returns user details — role, department, last login, project membership count.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { userId: { type: 'string', format: 'uuid' } },
+            required: ['userId'],
+        },
+    },
+    // === Tags (1) ===
+    {
+        name: 'list_tags',
+        description: {
+            tr: "Projedeki test case'lerde kullanılan tüm benzersiz etiketleri alfabetik olarak listeler.",
+            en: 'Lists all unique tags used in test cases of a project, alphabetically sorted.',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    // === Custom Fields (1) ===
+    {
+        name: 'list_custom_fields',
+        description: {
+            tr: 'Tenant kapsamındaki özel alan tanımlarını listeler (id, name, type, required, options).',
+            en: 'Lists tenant-scoped custom field definitions (id, name, type, required, options).',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    // === Webhooks (1) ===
+    {
+        name: 'list_webhooks',
+        description: {
+            tr: 'Projeye veya tenant geneline tanımlı webhook listesini döner (url, events, enabled).',
+            en: 'Lists webhooks scoped to the project or tenant-wide (url, events, enabled).',
+        },
+        inputSchema: { type: 'object', properties: REQ_PROJECT_ID, required: ['projectId'] },
+    },
+    // === Pipelines (1) ===
+    {
+        name: 'list_pipelines',
+        description: {
+            tr: "Projedeki CI/CD pipeline'larını ve son koşum durumlarını listeler.",
+            en: 'Lists CI/CD pipelines for a project with their most recent run status.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                limit: { type: 'number', minimum: 1, maximum: 100, default: 20 },
+            },
+            required: ['projectId'],
+        },
+    },
+    // === Dashboard (1) ===
+    {
+        name: 'get_dashboard_metrics',
+        description: {
+            tr: "Proje için analitik özeti (toplam case, run, pass rate, recent failures, top flaky, ortalama yürütme süresi). days=30 varsayılan.",
+            en: 'Analytics digest for a project (total cases, runs, pass rate, recent failures, top flaky, avg execution time). days defaults to 30.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                days: { type: 'number', minimum: 1, maximum: 365, default: 30 },
+            },
+            required: ['projectId'],
+        },
+    },
+    // === Test Case Attachments (1) ===
+    {
+        name: 'add_test_case_attachment',
+        description: {
+            tr: "Bir test case'e dış URL üzerinden kanıt (screenshot, log dosyası vb.) ekler. Dosya bytes'ı yüklenmez — URL referansı saklanır. mime tipi otomatik olarak IMAGE/VIDEO/DOCUMENT/OTHER kategorisine eşlenir.",
+            en: 'Attaches external evidence to a test case via URL (screenshot, log file, etc.). File bytes are NOT uploaded — only the URL reference is stored. The mime type auto-maps to IMAGE/VIDEO/DOCUMENT/OTHER.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                caseId: { type: 'string', format: 'uuid' },
+                url: { type: 'string', format: 'uri', maxLength: 2048 },
+                mime: { type: 'string', minLength: 1, maxLength: 200, description: 'MIME type (e.g. image/png, text/plain)' },
+                filename: { type: 'string', maxLength: 255, description: 'Optional display name — derived from URL if omitted' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['caseId', 'url', 'mime'],
+        },
+    },
+    // === Test Case Comments (1) ===
+    {
+        name: 'add_test_case_comment',
+        description: {
+            tr: "Bir test case'e markdown destekli yorum ekler. mentions[] parametresine UUID listesi geçirilirse @-mention bildirimleri (e-posta + uygulama içi) otomatik tetiklenir.",
+            en: 'Adds a markdown-formatted comment to a test case. If mentions[] is provided as user UUIDs, @-mention notifications (email + in-app) are auto-fanned-out via the existing notification queue.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                caseId: { type: 'string', format: 'uuid' },
+                body: { type: 'string', minLength: 1, maxLength: 10000 },
+                mentions: {
+                    type: 'array',
+                    items: { type: 'string', format: 'uuid' },
+                    maxItems: 50,
+                    description: 'Optional user UUIDs to notify. Injected as @[user](uuid) at the end of the body.',
+                },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['caseId', 'body'],
+        },
+    },
+    // === Scheduled Runs (3) ===
+    {
+        name: 'list_scheduled_runs',
+        description: {
+            tr: 'Projedeki zamanlanmış test koşumlarını listeler. status filtresi (active/paused/completed/failed) destekler. cronExpression, nextRunAt, lastRunAt ve enabled boolean alanı döner.',
+            en: 'Lists scheduled test runs for a project. Supports status filter (active/paused/completed/failed). Returns cronExpression, nextRunAt, lastRunAt and a flattened `enabled` boolean.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                status: { type: 'string', enum: ['active', 'paused', 'completed', 'failed'] },
+                limit: { type: 'number', minimum: 1, maximum: 500, default: 100 },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'create_scheduled_run',
+        description: {
+            tr: "Belirtilen test paketi için zamanlanmış bir koşum oluşturur. schedule.type='cron' → CUSTOM frequency + cron expression; schedule.type='interval' → DAILY frequency, expression ISO date olarak parse edilir. enabled=false ile pasif başlatılabilir.",
+            en: "Creates a scheduled test run for a suite. schedule.type='cron' → CUSTOM frequency + cron expression; schedule.type='interval' → DAILY frequency, expression parsed as ISO date. Set enabled=false to start paused.",
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...REQ_PROJECT_ID,
+                name: { type: 'string', minLength: 1, maxLength: 200 },
+                suiteId: { type: 'string', format: 'uuid' },
+                schedule: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', enum: ['cron', 'interval'] },
+                        expression: { type: 'string', minLength: 1, maxLength: 200 },
+                    },
+                    required: ['type', 'expression'],
+                },
+                enabled: { type: 'boolean', default: true },
+                timezone: { type: 'string', maxLength: 100, default: 'UTC' },
+                idempotencyKey: { type: 'string', maxLength: 64 },
+            },
+            required: ['projectId', 'name', 'suiteId', 'schedule'],
+        },
+    },
+    {
+        name: 'pause_scheduled_run',
+        description: {
+            tr: 'Aktif bir zamanlanmış koşumu duraklatır (status=paused). Resume için update_scheduled_run veya UI üzerinden devam ettirilebilir.',
+            en: 'Pauses an active scheduled run (status=paused). Use update_scheduled_run or the UI to resume.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: { scheduledRunId: { type: 'string', format: 'uuid' } },
+            required: ['scheduledRunId'],
+        },
+    },
+    // === Meta tools (2) ===
+    {
+        name: 'get_my_quota',
+        description: {
+            tr: "Token'ın scope'larını, erişebildiği projeleri ve rate limit'lerini gösterir.",
+            en: "Shows your token's scopes, accessible projects, and rate limits.",
+        },
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_schema',
+        description: {
+            tr: "Tüm tool'ların listesini veya belirli bir tool'un şemasını döner.",
+            en: 'Returns list of all tools or schema of a specific tool.',
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                toolName: { type: 'string' },
+            },
+        },
+    },
+];
+//# sourceMappingURL=index.js.map