@neobiotechlabs/neobiotech-dev-agent 0.1.7

package/dist/tools/jira-crud.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { textToAdf } from '../jira-client.js';
+import { inferAdfFields, applyAdfToFields } from '../utils/jira-fields.js';
+export const registerJiraCrudTools = (ctx) => {
+    const { server, jira } = ctx;
+    server.tool('jira_get_issue', 'Get a Jira issue by key', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+        fields: z.string().optional().describe('Comma-separated list of fields to return'),
+    }, async ({ issue_key, fields }) => {
+        const fieldList = fields ? fields.split(',').map(f => f.trim()) : undefined;
+        const data = await jira.getIssue(issue_key, fieldList);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('jira_search', 'Search Jira issues with JQL', {
+        jql: z.string().describe('JQL query string'),
+        max_results: z.number().optional().default(50).describe('Maximum results to return'),
+    }, async ({ jql, max_results }) => {
+        const data = await jira.search(jql, max_results);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('jira_create_issue', 'Create a new Jira issue. Rich-text customfields: pass their keys in rich_text_custom_fields (string values auto-converted to ADF), or set auto_detect_rich_text to infer them from the field schema (jira_get_issue_type_schema).', {
+        project: z.string().describe('Project key (e.g. PROJ)'),
+        summary: z.string().describe('Issue summary/title'),
+        issuetype: z.string().describe('Issue type name (e.g. Task, Story, Bug, Requirement)'),
+        description: z.string().optional().describe('Issue description (plain text, auto-converted to ADF)'),
+        assignee: z.string().optional().describe('Assignee email or accountId'),
+        labels: z.array(z.string()).optional().describe('Labels to apply'),
+        priority: z.string().optional().describe('Priority name (e.g. High, Medium, Low)'),
+        parent: z.string().optional().describe('Parent issue key for sub-tasks'),
+        extra_fields: z.record(z.unknown()).optional().describe('Additional fields to set (customfield_*). Rich-text fields should be listed in rich_text_custom_fields.'),
+        rich_text_custom_fields: z.array(z.string()).optional().describe('customfield keys whose plain-text values should be auto-converted to ADF. Discover ADF candidates via jira_get_issue_type_schema (inferredFormat: adf/adf-suspect).'),
+        auto_detect_rich_text: z.boolean().optional().describe('If true, query the field schema for this project/issuetype and auto-convert detected ADF fields (merged with rich_text_custom_fields). Adds extra API calls.'),
+    }, async ({ project, summary, issuetype, description, assignee, labels, priority, parent, extra_fields, rich_text_custom_fields, auto_detect_rich_text }) => {
+        const fields = {
+            project: { key: project },
+            summary,
+            issuetype: { name: issuetype },
+        };
+        if (description)
+            fields.description = textToAdf(description);
+        if (assignee)
+            fields.assignee = { emailAddress: assignee };
+        if (labels?.length)
+            fields.labels = labels;
+        if (priority)
+            fields.priority = { name: priority };
+        if (parent)
+            fields.parent = { key: parent };
+        if (extra_fields)
+            Object.assign(fields, extra_fields);
+        // 하이브리드 ADF 변환: 명시 키 + (선택) schema 자동 감지 병합
+        let adfKeys = rich_text_custom_fields || [];
+        if (auto_detect_rich_text) {
+            const schema = await jira.getIssueTypeSchema(project);
+            const it = schema.issueTypes?.find(t => t.name === issuetype);
+            adfKeys = inferAdfFields(it?.fields || [], rich_text_custom_fields);
+        }
+        const finalFields = applyAdfToFields(fields, adfKeys);
+        const data = await jira.createIssue(finalFields);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('jira_update_issue', 'Update fields on a Jira issue. Rich-text customfields: pass their keys in rich_text_custom_fields (string values auto-converted to ADF), or set auto_detect_rich_text to infer them from the issue\'s field schema. description is accepted as plain text and auto-converted to ADF.', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+        fields: z.record(z.unknown()).describe('Fields to update as key-value pairs. Rich-text (ADF) fields should be listed in rich_text_custom_fields; otherwise pass a pre-built ADF object.'),
+        description: z.string().optional().describe('New description (plain text, auto-converted to ADF). Overrides fields.description if present.'),
+        rich_text_custom_fields: z.array(z.string()).optional().describe('customfield keys whose plain-text values should be auto-converted to ADF. Discover ADF candidates via jira_get_issue_type_schema (inferredFormat: adf/adf-suspect).'),
+        auto_detect_rich_text: z.boolean().optional().describe('If true, detect ADF fields from the issue\'s issuetype schema and auto-convert (merged with rich_text_custom_fields). Adds extra API calls.'),
+    }, async ({ issue_key, fields, description, rich_text_custom_fields, auto_detect_rich_text }) => {
+        const merged = { ...fields };
+        if (description !== undefined)
+            merged.description = textToAdf(description);
+        // 하이브리드 ADF 변환: 명시 키 + (선택) issue의 issuetype schema 자동 감지 병합
+        let adfKeys = rich_text_custom_fields || [];
+        if (auto_detect_rich_text) {
+            const issue = await jira.getIssue(issue_key, ['issuetype', 'project']);
+            const projectKey = issue.fields?.project?.key;
+            const itName = issue.fields?.issuetype?.name;
+            if (projectKey && itName) {
+                const schema = await jira.getIssueTypeSchema(projectKey);
+                const it = schema.issueTypes?.find(t => t.name === itName);
+                adfKeys = inferAdfFields(it?.fields || [], rich_text_custom_fields);
+            }
+        }
+        const finalFields = applyAdfToFields(merged, adfKeys);
+        await jira.updateIssue(issue_key, finalFields);
+        return { content: [{ type: 'text', text: `Issue ${issue_key} updated successfully${adfKeys.length ? ` (ADF-converted: ${adfKeys.join(', ')})` : ''}` }] };
+    });
+    server.tool('jira_add_comment', 'Add a comment to a Jira issue', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+        body: z.string().describe('Comment text'),
+    }, async ({ issue_key, body }) => {
+        const data = await jira.addComment(issue_key, body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('jira_create_link', 'Create a link between two issues. IMPORTANT direction rules: For "Blocks", outward_key blocks inward_key (e.g. outward=Document, inward=Gate means Document blocks Gate). For "Implements", outward_key implements inward_key (e.g. outward=Task, inward=DetailedDesign). For "Relates", direction does not matter. For "Risk Source", outward_key gives rise to inward_key (e.g. outward=SyRS, inward=Hazard means SyRS gives rise to Hazard). For "Mitigates", outward_key mitigates inward_key (e.g. outward=Requirement, inward=Hazard).', {
+        link_type: z.string().describe('Link type (Blocks, Implements, Relates, Risk Source, Mitigates)'),
+        inward_key: z.string().describe('The TARGET issue key (the one being blocked/implemented/mitigated/arising from)'),
+        outward_key: z.string().describe('The SOURCE issue key (the one doing the blocking/implementing/mitigating/giving rise to)'),
+    }, async ({ link_type, inward_key, outward_key }) => {
+        await jira.createLink(link_type, inward_key, outward_key);
+        return { content: [{ type: 'text', text: `Link created: ${inward_key} ←[${link_type}]→ ${outward_key}` }] };
+    });
+    server.tool('jira_delete_link', 'Delete an issue link by link ID', {
+        link_id: z.string().describe('The issue link ID to delete'),
+    }, async ({ link_id }) => {
+        await jira.deleteLink(link_id);
+        return { content: [{ type: 'text', text: `Link ${link_id} deleted` }] };
+    });
+    server.tool('jira_get_links', 'Get all issue links for a Jira issue', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+    }, async ({ issue_key }) => {
+        const links = await jira.getLinks(issue_key);
+        return { content: [{ type: 'text', text: JSON.stringify(links, null, 2) }] };
+    });
+    server.tool('jira_get_transitions', 'Get available status transitions for an issue', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+    }, async ({ issue_key }) => {
+        const data = await jira.getTransitions(issue_key);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('jira_transition', 'Transition an issue to a new status', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+        transition_id: z.string().describe('Transition ID from jira_get_transitions'),
+    }, async ({ issue_key, transition_id }) => {
+        await jira.transition(issue_key, transition_id);
+        return { content: [{ type: 'text', text: `Issue ${issue_key} transitioned` }] };
+    });
+    server.tool('jira_delete_issue', 'Delete a Jira issue', {
+        issue_key: z.string().describe('Issue key (e.g. PROJ-123)'),
+    }, async ({ issue_key }) => {
+        await jira.deleteIssue(issue_key);
+        return { content: [{ type: 'text', text: `Issue ${issue_key} deleted` }] };
+    });
+    server.tool('jira_get_issue_type_schema', 'Get the field schema for issue types in a project. Use this to discover available fields for Vulnerability, SW Failure, Hazard, etc.', {
+        project_key: z.string().describe('Project key (e.g. PLAYG)'),
+        issue_type_id: z.string().optional().describe('Specific issue type ID. Omit to get all issue types.'),
+    }, async ({ project_key, issue_type_id }) => {
+        const data = await jira.getIssueTypeSchema(project_key, issue_type_id);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+};
+//# sourceMappingURL=jira-crud.js.map

package/dist/tools/jira-crud.js.map

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

package/dist/tools/risk.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from './types.js';
+export declare const registerRiskTools: ToolRegistrar;

package/dist/tools/risk.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import { getRiskConfig } from '../config/project-config.js';
+export const registerRiskTools = (ctx) => {
+    const { server, risk, jira } = ctx;
+    server.tool('risk_activate_panel', 'Activate Risk Management Plugin panel on an issue', {
+        issue_key: z.string().describe('Issue key to activate risk panel on'),
+    }, async ({ issue_key }) => {
+        const ok = await risk.activateRiskPanel(issue_key);
+        return { content: [{ type: 'text', text: ok ? `Risk panel activated on ${issue_key}` : `Failed to activate risk panel on ${issue_key}` }] };
+    });
+    server.tool('risk_set_values', 'Set risk values (severity, p1, p2) on an issue via Risk Management Plugin', {
+        issue_key: z.string().describe('Issue key'),
+        project_key: z.string().describe('Project key (for config lookup)'),
+        severity: z.enum(['negligible', 'minor', 'serious', 'critical', 'catastrophic']).optional(),
+        p1: z.enum(['improvable', 'remote', 'occasional', 'probable', 'frequent']).optional(),
+        p2: z.enum(['improvable', 'remote', 'occasional', 'probable', 'frequent']).optional(),
+        risk_set: z.enum(['initial', 'current']).default('current').describe('Which risk set to update'),
+    }, async ({ issue_key, project_key, severity, p1, p2, risk_set }) => {
+        const riskConfig = getRiskConfig(project_key);
+        if (!riskConfig)
+            return { content: [{ type: 'text', text: `No risk management config for project ${project_key}. Check PROJECT_CONFIG_PATH.` }] };
+        const riskSetId = riskConfig.risk_sets[risk_set];
+        const configForSet = {
+            endpoint: riskConfig.endpoint,
+            author: riskConfig.author,
+            riskModelKey: riskConfig.risk_model_key,
+            riskSetId,
+            classifiers: riskConfig.classifiers,
+        };
+        const results = [];
+        for (const [name, value] of [['severity', severity], ['p1', p1], ['p2', p2]]) {
+            if (value) {
+                const ok = await risk.setRiskValue(issue_key, configForSet, name, value);
+                results.push(`${name}=${value}: ${ok ? 'OK' : 'FAILED'}`);
+            }
+        }
+        return { content: [{ type: 'text', text: `Risk values for ${issue_key} (${risk_set} set):\n${results.join('\n')}` }] };
+    });
+    server.tool('risk_get_config', 'Get risk management configuration for a project', {
+        project_key: z.string().describe('Project key'),
+    }, async ({ project_key }) => {
+        const config = getRiskConfig(project_key);
+        if (!config)
+            return { content: [{ type: 'text', text: `No risk config for ${project_key}` }] };
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        risk_model_key: config.risk_model_key,
+                        risk_sets: config.risk_sets,
+                        classifiers: Object.fromEntries(Object.entries(config.classifiers).map(([k, v]) => [k, { id: v.id, options: Object.keys(v.options) }])),
+                    }, null, 2) }] };
+    });
+    server.tool('risk_create_hazards', 'Batch create Hazard tickets with Risk panel activation, risk values, and Risk Source links. Migrated from rmr_create_hazards.py.', {
+        project_key: z.string().describe('Project key'),
+        rmr_key: z.string().describe('RMR Document ticket key'),
+        hazards: z.array(z.object({
+            summary: z.string(),
+            description: z.string(),
+            harm: z.string(),
+            severity: z.enum(['negligible', 'minor', 'serious', 'critical', 'catastrophic']),
+            p1: z.enum(['improvable', 'remote', 'occasional', 'probable', 'frequent']),
+            p2: z.enum(['improvable', 'remote', 'occasional', 'probable', 'frequent']),
+            source_keys: z.array(z.string()).describe('Related IU/SyRS ticket keys'),
+        })).describe('Array of hazard definitions'),
+    }, async ({ project_key, rmr_key, hazards }) => {
+        const riskConfig = getRiskConfig(project_key);
+        const { textToAdf } = await import('../jira-client.js');
+        const results = [];
+        const errors = [];
+        for (const h of hazards) {
+            try {
+                // 1. Create Hazard ticket
+                const issue = await jira.createIssue({
+                    project: { key: project_key },
+                    summary: h.summary,
+                    issuetype: { name: 'Hazard' },
+                    description: textToAdf(h.description),
+                    customfield_10148: h.harm,
+                });
+                const issueKey = issue.key;
+                if (!issueKey) {
+                    errors.push(`${h.summary}: creation failed`);
+                    continue;
+                }
+                // 2. Activate Risk Panel
+                await risk.activateRiskPanel(issueKey);
+                // 3. Set Risk values (both initial and current sets)
+                if (riskConfig) {
+                    for (const setName of ['initial', 'current']) {
+                        const setConfig = {
+                            endpoint: riskConfig.endpoint, author: riskConfig.author,
+                            riskModelKey: riskConfig.risk_model_key, riskSetId: riskConfig.risk_sets[setName],
+                            classifiers: riskConfig.classifiers,
+                        };
+                        for (const [name, value] of [['severity', h.severity], ['p1', h.p1], ['p2', h.p2]]) {
+                            await risk.setRiskValue(issueKey, setConfig, name, value);
+                        }
+                    }
+                }
+                // 4. Risk Source links (SyRS/IU → Hazard)
+                for (const srcKey of h.source_keys) {
+                    await jira.createLink('Risk Source', issueKey, srcKey);
+                }
+                // 5. Relates link (Hazard → RMR)
+                await jira.createLink('Relates', issueKey, rmr_key);
+                results.push({ key: issueKey, summary: h.summary, status: 'created' });
+            }
+            catch (e) {
+                errors.push(`${h.summary}: ${e.message}`);
+            }
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ created: results.length, failed: errors.length, results, errors }, null, 2) }] };
+    });
+    server.tool('risk_create_mitigation', 'Create mitigation Requirements, link to Hazards, and update Hazard Current P2. Migrated from srs_create_requirements.py.', {
+        project_key: z.string().describe('Project key'),
+        srs_key: z.string().describe('SRS Document ticket key'),
+        requirements: z.array(z.object({
+            summary: z.string(),
+            description: z.string(),
+            mitigates: z.array(z.string()).describe('Hazard keys this requirement mitigates'),
+            implements: z.array(z.string()).describe('System Requirement keys this implements'),
+        })),
+        hazard_risk_updates: z.record(z.object({ p2: z.string() })).describe('Hazard key → new P2 value mapping'),
+    }, async ({ project_key, srs_key, requirements, hazard_risk_updates }) => {
+        const riskConfig = getRiskConfig(project_key);
+        const { textToAdf } = await import('../jira-client.js');
+        const results = [];
+        const errors = [];
+        for (const req of requirements) {
+            try {
+                const issue = await jira.createIssue({
+                    project: { key: project_key },
+                    summary: req.summary,
+                    issuetype: { name: 'Requirement' },
+                    description: textToAdf(req.description),
+                });
+                const issueKey = issue.key;
+                if (!issueKey) {
+                    errors.push(`${req.summary}: creation failed`);
+                    continue;
+                }
+                // Mitigates links
+                for (const hazKey of req.mitigates) {
+                    await jira.createLink('Mitigates', issueKey, hazKey);
+                }
+                // Implements links
+                for (const syrsKey of req.implements) {
+                    await jira.createLink('Implements', issueKey, syrsKey);
+                }
+                // Relates link → SRS
+                await jira.createLink('Relates', issueKey, srs_key);
+                results.push({ key: issueKey, summary: req.summary, mitigates: req.mitigates });
+            }
+            catch (e) {
+                errors.push(`${req.summary}: ${e.message}`);
+            }
+        }
+        // Update Hazard Current P2
+        const riskUpdates = [];
+        if (riskConfig) {
+            const currentConfig = {
+                endpoint: riskConfig.endpoint, author: riskConfig.author,
+                riskModelKey: riskConfig.risk_model_key, riskSetId: riskConfig.risk_sets.current,
+                classifiers: riskConfig.classifiers,
+            };
+            for (const [hazKey, update] of Object.entries(hazard_risk_updates)) {
+                const ok = await risk.setRiskValue(hazKey, currentConfig, 'p2', update.p2);
+                riskUpdates.push(`${hazKey} P2→${update.p2}: ${ok ? 'OK' : 'FAILED'}`);
+            }
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ requirements_created: results.length, results, risk_updates: riskUpdates, errors }, null, 2) }] };
+    });
+};
+//# sourceMappingURL=risk.js.map

package/dist/tools/risk.js.map

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

package/dist/tools/traceability.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from './types.js';
+export declare const registerTraceabilityTools: ToolRegistrar;

package/dist/tools/traceability.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+function extractLinks(issueData) {
+    const links = [];
+    for (const link of issueData?.fields?.issuelinks || []) {
+        if (link.outwardIssue) {
+            // We're the inward side — show our perspective (inward label, incoming arrow)
+            links.push({ key: link.outwardIssue.key, summary: link.outwardIssue.fields?.summary || '', link_type: link.type.inward, direction: 'inward' });
+        }
+        if (link.inwardIssue) {
+            // We're the outward side — show our perspective (outward label, outgoing arrow)
+            links.push({ key: link.inwardIssue.key, summary: link.inwardIssue.fields?.summary || '', link_type: link.type.outward, direction: 'outward' });
+        }
+    }
+    return links;
+}
+export const registerTraceabilityTools = (ctx) => {
+    const { server, jira } = ctx;
+    server.tool('traceability_check', 'Check traceability status of a ticket - show all links and their types', {
+        issue_key: z.string().describe('Issue key to check'),
+    }, async ({ issue_key }) => {
+        const data = await jira.getIssue(issue_key, ['summary', 'issuetype', 'status', 'issuelinks', 'subtasks', 'parent']);
+        const f = data.fields;
+        const links = extractLinks(data);
+        const report = [
+            `=== ${issue_key}: ${f.summary} ===`,
+            `Type: ${f.issuetype?.name} | Status: ${f.status?.name}`,
+            '',
+            `Parent: ${f.parent?.key || '(none)'}`,
+            `Subtasks: ${(f.subtasks || []).map((s) => s.key).join(', ') || '(none)'}`,
+            '',
+            `Links (${links.length}):`,
+            ...links.map(l => `  ${l.direction === 'inward' ? '←' : '→'} [${l.link_type}] ${l.key}: ${l.summary}`),
+        ];
+        return { content: [{ type: 'text', text: report.join('\n') }] };
+    });
+    server.tool('traceability_find_missing', 'Find missing traceability links within a Gate. Checks expected link patterns based on IEC 62304 traceability map.', {
+        issue_key: z.string().describe('Any ticket key within the Gate to check'),
+    }, async ({ issue_key }) => {
+        // Search for Gate issues in the project
+        const projectKey = issue_key.split('-')[0];
+        const gates = await jira.search(`project=${projectKey} AND issuetype=Gate`, 50, ['summary', 'issuelinks']);
+        const missing = [];
+        for (const gate of gates.issues || []) {
+            const gateLinks = extractLinks(gate);
+            const documentKeys = gateLinks.filter(l => l.link_type === 'is blocked by').map(l => l.key);
+            for (const docKey of documentKeys) {
+                const docData = await jira.getIssue(docKey, ['summary', 'issuetype', 'issuelinks']);
+                const docLinks = extractLinks(docData);
+                const docType = docData.fields?.issuetype?.name;
+                const docSummary = docData.fields?.summary || '';
+                // Check: Document should link to its sub-tickets
+                if (docType === 'Document' && docSummary.includes('Risk Management Report')) {
+                    // Should have Hazard links
+                    const hasHazardLinks = docLinks.some(l => l.link_type === 'Relates');
+                    if (!hasHazardLinks && documentKeys.length > 0) {
+                        missing.push({ source: docKey, target: '(any Hazard)', expected_link: 'Relates' });
+                    }
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: missing.length > 0
+                        ? `Missing links found:\n${missing.map(m => `  ${m.source} → ${m.target} [${m.expected_link}]`).join('\n')}`
+                        : `No missing links found for Gate issues in ${projectKey}` }] };
+    });
+    server.tool('traceability_fix', 'Automatically create missing traceability links', {
+        links: z.array(z.object({
+            link_type: z.string().describe('Link type name (e.g. Relates, Blocks, Implements, Risk Source, Mitigates)'),
+            inward_key: z.string().describe('Inward issue key'),
+            outward_key: z.string().describe('Outward issue key'),
+        })).describe('Array of links to create'),
+    }, async ({ links: linksToCreate }) => {
+        const results = [];
+        for (const l of linksToCreate) {
+            try {
+                await jira.createLink(l.link_type, l.inward_key, l.outward_key);
+                results.push({ link: `${l.inward_key} ←[${l.link_type}]→ ${l.outward_key}`, status: 'created' });
+            }
+            catch (e) {
+                results.push({ link: `${l.inward_key} ←[${l.link_type}]→ ${l.outward_key}`, status: `failed: ${e.message}` });
+            }
+        }
+        return { content: [{ type: 'text', text: results.map(r => `${r.status}: ${r.link}`).join('\n') }] };
+    });
+};
+//# sourceMappingURL=traceability.js.map

package/dist/tools/traceability.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JiraClient } from '../jira-client.js';
+import { ConfluenceClient } from '../confluence-client.js';
+import { RiskClient } from '../clients/risk-client.js';
+import { XrayClient } from '../clients/xray-client.js';
+export interface ToolContext {
+    server: McpServer;
+    jira: JiraClient;
+    confluence: ConfluenceClient;
+    risk: RiskClient;
+    xray: XrayClient | null;
+}
+export type ToolRegistrar = (ctx: ToolContext) => void;

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/usability.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from './types.js';
+export declare const registerUsabilityTools: ToolRegistrar;

package/dist/tools/usability.js

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import { textToAdf } from '../jira-client.js';
+export const registerUsabilityTools = (ctx) => {
+    const { server, jira } = ctx;
+    server.tool('usability_create_use_spec', 'Create Document ticket with Use Specification content (IEC 62366-1), linked to PA Gate with Blocks link.', {
+        project_key: z.string().describe('Project key'),
+        pa_gate_key: z.string().describe('PA Gate ticket key'),
+        summary: z.string().optional().describe('Document summary (default: "[Use Specification]")'),
+        user_profile: z.string().describe('User profile description'),
+        use_environment: z.string().describe('Use environment description'),
+        intended_use: z.string().describe('Intended use description'),
+    }, async ({ project_key, pa_gate_key, summary, user_profile, use_environment, intended_use }) => {
+        const docSummary = summary || '[Use Specification]';
+        const content = [
+            '# Use Specification (IEC 62366-1)',
+            '',
+            '## User Profile',
+            user_profile,
+            '',
+            '## Use Environment',
+            use_environment,
+            '',
+            '## Intended Use',
+            intended_use,
+        ].join('\n');
+        const issue = await jira.createIssue({
+            project: { key: project_key },
+            summary: docSummary,
+            issuetype: { name: 'Document' },
+            description: textToAdf(content),
+        });
+        const issueKey = issue.key;
+        // Document blocks Gate
+        await jira.createLink('Blocks', pa_gate_key, issueKey);
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        key: issueKey,
+                        summary: docSummary,
+                        linked_to_gate: pa_gate_key,
+                        message: 'Use Specification Document created and linked to PA Gate with Blocks.',
+                    }, null, 2) }] };
+    });
+    server.tool('usability_create_scenarios', 'Batch create Task tickets for Normal/Abnormal Use scenarios, linked to use_spec with Relates.', {
+        project_key: z.string().describe('Project key'),
+        use_spec_key: z.string().describe('Use Specification Document ticket key'),
+        scenarios: z.array(z.object({
+            summary: z.string().describe('Scenario summary'),
+            description: z.string().describe('Scenario description'),
+            type: z.enum(['normal', 'abnormal']).describe('Scenario type: normal or abnormal'),
+            frequency: z.enum(['rare', 'occasional', 'frequent']).describe('Usage frequency'),
+        })).describe('Scenarios to create'),
+    }, async ({ project_key, use_spec_key, scenarios }) => {
+        const results = [];
+        for (const scenario of scenarios) {
+            const content = [
+                `# Use Scenario: ${scenario.summary}`,
+                '',
+                `**Type:** ${scenario.type}`,
+                `**Frequency:** ${scenario.frequency}`,
+                '',
+                '## Description',
+                scenario.description,
+                '',
+                '## Steps',
+                '1. [Step 1]',
+                '2. [Step 2]',
+                '...',
+            ].join('\n');
+            const issue = await jira.createIssue({
+                project: { key: project_key },
+                summary: scenario.summary,
+                issuetype: { name: 'Task' },
+                description: textToAdf(content),
+                labels: ['use-scenario', scenario.type],
+            });
+            const issueKey = issue.key;
+            // Relates link to Use Specification
+            await jira.createLink('Relates', issueKey, use_spec_key);
+            results.push({
+                key: issueKey,
+                summary: scenario.summary,
+                type: scenario.type,
+                frequency: scenario.frequency,
+            });
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        total_created: results.length,
+                        linked_to: use_spec_key,
+                        scenarios: results,
+                        message: `${results.length} use scenarios created and linked to Use Specification.`,
+                    }, null, 2) }] };
+    });
+    server.tool('usability_link_to_hazard', 'Link scenario to hazards with Risk Source link (scenario gives rise to hazard).', {
+        scenario_key: z.string().describe('Use scenario Task ticket key'),
+        hazard_keys: z.array(z.string()).describe('Hazard ticket keys to link'),
+    }, async ({ scenario_key, hazard_keys }) => {
+        const results = [];
+        for (const hazardKey of hazard_keys) {
+            await jira.createLink('Risk Source', hazardKey, scenario_key);
+            results.push(`${scenario_key} → ${hazardKey} (Risk Source)`);
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        scenario: scenario_key,
+                        linked_hazards: hazard_keys,
+                        links_created: results,
+                        message: `${results.length} Risk Source links created (scenario → hazards).`,
+                    }, null, 2) }] };
+    });
+    server.tool('usability_create_validation', 'Create Task ticket with usability validation evidence, linked to scenario with Relates.', {
+        project_key: z.string().describe('Project key'),
+        scenario_key: z.string().describe('Use scenario Task ticket key'),
+        summary: z.string().describe('Validation summary'),
+        method: z.string().describe('Validation method'),
+        result: z.enum(['pass', 'fail', 'partial']).describe('Validation result'),
+        evidence: z.string().describe('Evidence description'),
+        participants: z.string().optional().describe('Participant information'),
+    }, async ({ project_key, scenario_key, summary, method, result, evidence, participants }) => {
+        const content = [
+            '# Usability Validation',
+            '',
+            `**Method:** ${method}`,
+            `**Result:** ${result}`,
+            '',
+            participants ? `**Participants:** ${participants}\n` : '',
+            '## Evidence',
+            evidence,
+            '',
+            '## Conclusion',
+            result === 'pass' ? 'Usability validation PASSED.' : result === 'fail' ? 'Usability validation FAILED.' : 'Usability validation PARTIALLY PASSED.',
+        ].join('\n');
+        const issue = await jira.createIssue({
+            project: { key: project_key },
+            summary,
+            issuetype: { name: 'Task' },
+            description: textToAdf(content),
+            labels: ['usability-validation'],
+        });
+        const issueKey = issue.key;
+        // Relates link to scenario
+        await jira.createLink('Relates', issueKey, scenario_key);
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        key: issueKey,
+                        summary,
+                        result,
+                        linked_to_scenario: scenario_key,
+                        message: 'Usability validation Task created and linked to scenario.',
+                    }, null, 2) }] };
+    });
+};
+//# sourceMappingURL=usability.js.map