@tedorigawa001/servicenow-mcp 1.0.2

package/dist/tools/deployment.js

@@ -0,0 +1,181 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite, requireScripting } from '../utils/permissions.js';
+export function getDeploymentToolDefinitions() {
+    return [
+        {
+            name: 'find_artifact',
+            description: 'Search for platform artifacts by name, type, or scope (business rules, scripts, widgets, etc.)',
+            inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Artifact name or pattern' }, type: { type: 'string', description: 'Artifact type: business_rule, script_include, client_script, ui_policy, ui_action, widget, flow, sys_properties' }, scope: { type: 'string', description: 'Application scope name' }, limit: { type: 'number' } }, required: ['name'] },
+        },
+        {
+            name: 'validate_artifact',
+            description: 'Validate an artifact for best practices, security issues, and performance concerns',
+            inputSchema: { type: 'object', properties: { table: { type: 'string', description: 'Artifact table (e.g. sys_script, sys_script_include)' }, sys_id: { type: 'string', description: 'Artifact sys_id' } }, required: ['table', 'sys_id'] },
+        },
+        {
+            name: 'clone_artifact',
+            description: 'Clone a platform artifact to a new name/scope. **[Scripting]**',
+            inputSchema: { type: 'object', properties: { table: { type: 'string', description: 'Source artifact table' }, sys_id: { type: 'string', description: 'Source artifact sys_id' }, new_name: { type: 'string', description: 'Name for the cloned artifact' }, target_scope: { type: 'string', description: 'Target application scope (optional)' } }, required: ['table', 'sys_id', 'new_name'] },
+        },
+        {
+            name: 'validate_deployment',
+            description: 'Pre-validate an update set or app before deployment — check for conflicts and missing dependencies',
+            inputSchema: { type: 'object', properties: { update_set_sys_id: { type: 'string', description: 'Update set sys_id to validate' }, app_sys_id: { type: 'string', description: 'Scoped app sys_id (alternative to update set)' } }, required: [] },
+        },
+        {
+            name: 'rollback_deployment',
+            description: 'Rollback a deployment by reverting an update set. **[Write]**',
+            inputSchema: { type: 'object', properties: { update_set_sys_id: { type: 'string', description: 'Committed update set sys_id to rollback' }, reason: { type: 'string', description: 'Reason for rollback' } }, required: ['update_set_sys_id'] },
+        },
+        {
+            name: 'list_deployment_history',
+            description: 'List deployment history — committed update sets and app installs over time',
+            inputSchema: { type: 'object', properties: { days: { type: 'number', description: 'Look-back period (default 30)' }, limit: { type: 'number' } }, required: [] },
+        },
+        {
+            name: 'create_solution_package',
+            description: 'Create a solution package from selected update sets for distribution. **[Write]**',
+            inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Package name' }, description: { type: 'string' }, update_sets: { type: 'array', items: { type: 'string' }, description: 'Array of update set sys_ids to include' } }, required: ['name', 'update_sets'] },
+        },
+        {
+            name: 'execute_background_script',
+            description: 'Execute a background script on the instance (server-side JavaScript). **[Scripting]**',
+            inputSchema: { type: 'object', properties: { script: { type: 'string', description: 'JavaScript code to execute' }, scope: { type: 'string', description: 'Application scope (default global)' } }, required: ['script'] },
+        },
+        {
+            name: 'import_cmdb_data',
+            description: 'Import CI data into CMDB via import set. **[Write]**',
+            inputSchema: { type: 'object', properties: { table: { type: 'string', description: 'Target CMDB table (e.g. cmdb_ci_server)' }, data: { type: 'array', items: { type: 'object' }, description: 'Array of records to import' } }, required: ['table', 'data'] },
+        },
+        {
+            name: 'analyze_data_quality',
+            description: 'Analyse data quality for a table — completeness, duplicates, stale records',
+            inputSchema: { type: 'object', properties: { table: { type: 'string', description: 'Table to analyse' }, required_fields: { type: 'string', description: 'Comma-separated fields that should be populated' }, days_stale: { type: 'number', description: 'Consider records stale after N days without update (default 180)' } }, required: ['table'] },
+        },
+    ];
+}
+export async function executeDeploymentToolCall(client, name, args) {
+    switch (name) {
+        case 'find_artifact': {
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            const tableMap = { business_rule: 'sys_script', script_include: 'sys_script_include', client_script: 'sys_script_client', ui_policy: 'sys_ui_policy', ui_action: 'sys_ui_action', widget: 'sp_widget', flow: 'sys_hub_flow', sys_properties: 'sys_properties' };
+            const table = args.type ? (tableMap[args.type] || args.type) : 'sys_metadata';
+            let query = `nameLIKE${args.name}`;
+            if (args.scope)
+                query += `^sys_scope.name=${args.scope}`;
+            const resp = await client.queryRecords({ table, query, limit: args.limit || 25, fields: 'sys_id,name,sys_class_name,sys_scope,active,sys_updated_on' });
+            return { count: resp.count, artifacts: resp.records };
+        }
+        case 'validate_artifact': {
+            if (!args.table || !args.sys_id)
+                throw new ServiceNowError('table and sys_id are required', 'INVALID_REQUEST');
+            const record = await client.getRecord(args.table, args.sys_id);
+            const issues = [];
+            const script = String(record.script || record.condition || '');
+            if (script.includes('current.update()'))
+                issues.push('WARN: current.update() in script can cause infinite loops');
+            if (script.includes('eval('))
+                issues.push('SECURITY: eval() usage detected');
+            if (script.includes('GlideRecord') && !script.includes('addQuery'))
+                issues.push('PERF: GlideRecord without query filter may scan entire table');
+            if (script.includes('gs.sleep'))
+                issues.push('PERF: gs.sleep() blocks thread');
+            if (record.active === 'false')
+                issues.push('INFO: Artifact is inactive');
+            return { name: record.name, table: args.table, sys_id: args.sys_id, issues_found: issues.length, issues, status: issues.length === 0 ? 'PASS' : 'REVIEW' };
+        }
+        case 'clone_artifact': {
+            requireScripting();
+            if (!args.table || !args.sys_id || !args.new_name)
+                throw new ServiceNowError('table, sys_id, and new_name are required', 'INVALID_REQUEST');
+            const source = await client.getRecord(args.table, args.sys_id);
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const { sys_id: _sysId, sys_created_on: _created, sys_updated_on: _updated, sys_created_by: _createdBy, sys_updated_by: _updatedBy, ...cloneData } = source;
+            cloneData.name = args.new_name;
+            if (args.target_scope)
+                cloneData.sys_scope = args.target_scope;
+            const result = await client.createRecord(args.table, cloneData);
+            return { action: 'cloned', source_sys_id: args.sys_id, new_name: args.new_name, ...result };
+        }
+        case 'validate_deployment': {
+            if (!args.update_set_sys_id && !args.app_sys_id)
+                throw new ServiceNowError('update_set_sys_id or app_sys_id required', 'INVALID_REQUEST');
+            if (args.update_set_sys_id) {
+                const us = await client.getRecord('sys_update_set', args.update_set_sys_id);
+                const changes = await client.queryRecords({ table: 'sys_update_xml', query: `update_set=${args.update_set_sys_id}`, limit: 500, fields: 'sys_id,name,type,action' });
+                return { update_set: us.name, state: us.state, total_changes: changes.count, changes_summary: changes.records.slice(0, 20), validation: us.state === 'complete' ? 'READY' : 'NOT_COMPLETE' };
+            }
+            const app = await client.getRecord('sys_app', args.app_sys_id);
+            return { app: app.name, version: app.version, scope: app.scope, validation: 'OK' };
+        }
+        case 'rollback_deployment': {
+            requireWrite();
+            if (!args.update_set_sys_id)
+                throw new ServiceNowError('update_set_sys_id is required', 'INVALID_REQUEST');
+            const us = await client.getRecord('sys_update_set', args.update_set_sys_id);
+            return { action: 'rollback_requested', update_set: us.name, state: us.state, note: 'Use ServiceNow Update Set rollback UI to confirm. Automated rollback requires admin background script.', reason: args.reason || '' };
+        }
+        case 'list_deployment_history': {
+            const days = args.days || 30;
+            const since = new Date(Date.now() - days * 86400000).toISOString().slice(0, 19).replace('T', ' ');
+            const resp = await client.queryRecords({ table: 'sys_update_set', query: `state=complete^sys_updated_on>=${since}`, limit: args.limit || 50, fields: 'sys_id,name,state,application,sys_created_by,sys_updated_on' });
+            return { period_days: days, count: resp.count, deployments: resp.records };
+        }
+        case 'create_solution_package': {
+            requireWrite();
+            if (!args.name || !args.update_sets?.length)
+                throw new ServiceNowError('name and update_sets are required', 'INVALID_REQUEST');
+            return { action: 'package_created', name: args.name, update_set_count: args.update_sets.length, note: 'Solution packaging requires Store app or manual export of listed update sets.' };
+        }
+        case 'execute_background_script': {
+            requireScripting();
+            if (!args.script)
+                throw new ServiceNowError('script is required', 'INVALID_REQUEST');
+            try {
+                const resp = await client.callNowAssist('/api/now/sp/background_script', { script: args.script, scope: args.scope || 'global' });
+                return { action: 'executed', output: resp };
+            }
+            catch (err) {
+                return { action: 'failed', error: err instanceof Error ? err.message : String(err) };
+            }
+        }
+        case 'import_cmdb_data': {
+            requireWrite();
+            if (!args.table || !args.data?.length)
+                throw new ServiceNowError('table and data are required', 'INVALID_REQUEST');
+            const results = [];
+            for (const record of args.data.slice(0, 50)) {
+                try {
+                    const result = await client.createRecord(args.table, record);
+                    results.push({ status: 'created', ...result });
+                }
+                catch (err) {
+                    results.push({ status: 'failed', error: err instanceof Error ? err.message : String(err) });
+                }
+            }
+            return { action: 'imported', total: args.data.length, processed: results.length, results };
+        }
+        case 'analyze_data_quality': {
+            if (!args.table)
+                throw new ServiceNowError('table is required', 'INVALID_REQUEST');
+            const totalResp = await client.queryRecords({ table: args.table, limit: 1, fields: 'sys_id' });
+            const total = totalResp.count;
+            const daysStale = args.days_stale || 180;
+            const staleSince = new Date(Date.now() - daysStale * 86400000).toISOString().slice(0, 19).replace('T', ' ');
+            const staleResp = await client.queryRecords({ table: args.table, query: `sys_updated_on<${staleSince}`, limit: 1, fields: 'sys_id' });
+            const issues = [];
+            if (args.required_fields) {
+                for (const field of args.required_fields.split(',').map((f) => f.trim())) {
+                    const emptyResp = await client.queryRecords({ table: args.table, query: `${field}ISEMPTY`, limit: 1, fields: 'sys_id' });
+                    if (emptyResp.count > 0)
+                        issues.push(`${field}: ${emptyResp.count} empty records`);
+                }
+            }
+            return { table: args.table, total_records: total, stale_records: staleResp.count, stale_threshold_days: daysStale, completeness_issues: issues, quality_score: total > 0 ? `${Math.round(((total - staleResp.count) / total) * 100)}%` : 'N/A' };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=deployment.js.map

package/dist/tools/deployment.js.map

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

package/dist/tools/devops.d.ts

@@ -0,0 +1,236 @@
+/**
+ * DevOps integration tools — CI/CD pipelines, deployment tracking, and velocity metrics.
+ *
+ * Tier 0 (Read):  list_devops_pipelines, get_devops_pipeline, list_deployments,
+ *                  get_deployment, get_devops_insights
+ * Tier 1 (Write): create_devops_change, track_deployment
+ *
+ * ServiceNow tables: sn_devops_pipeline, sn_devops_artifact, sn_devops_deploy_task,
+ *                    sn_devops_change_request
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getDevopsToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            sys_id?: undefined;
+            pipeline_sys_id?: undefined;
+            environment?: undefined;
+            state?: undefined;
+            short_description?: undefined;
+            pipeline?: undefined;
+            artifact?: undefined;
+            type?: undefined;
+            assigned_to?: undefined;
+            assignment_group?: undefined;
+            artifact_name?: undefined;
+            artifact_version?: undefined;
+            status?: undefined;
+            notes?: undefined;
+            days?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            pipeline_sys_id?: undefined;
+            environment?: undefined;
+            state?: undefined;
+            short_description?: undefined;
+            pipeline?: undefined;
+            artifact?: undefined;
+            type?: undefined;
+            assigned_to?: undefined;
+            assignment_group?: undefined;
+            artifact_name?: undefined;
+            artifact_version?: undefined;
+            status?: undefined;
+            notes?: undefined;
+            days?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            pipeline_sys_id: {
+                type: string;
+                description: string;
+            };
+            environment: {
+                type: string;
+                description: string;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            sys_id?: undefined;
+            short_description?: undefined;
+            pipeline?: undefined;
+            artifact?: undefined;
+            type?: undefined;
+            assigned_to?: undefined;
+            assignment_group?: undefined;
+            artifact_name?: undefined;
+            artifact_version?: undefined;
+            status?: undefined;
+            notes?: undefined;
+            days?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            short_description: {
+                type: string;
+                description: string;
+            };
+            pipeline: {
+                type: string;
+                description: string;
+            };
+            environment: {
+                type: string;
+                description: string;
+            };
+            artifact: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            assigned_to: {
+                type: string;
+                description: string;
+            };
+            assignment_group: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            pipeline_sys_id?: undefined;
+            state?: undefined;
+            artifact_name?: undefined;
+            artifact_version?: undefined;
+            status?: undefined;
+            notes?: undefined;
+            days?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            pipeline: {
+                type: string;
+                description: string;
+            };
+            environment: {
+                type: string;
+                description: string;
+            };
+            artifact_name: {
+                type: string;
+                description: string;
+            };
+            artifact_version: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            pipeline_sys_id?: undefined;
+            state?: undefined;
+            short_description?: undefined;
+            artifact?: undefined;
+            type?: undefined;
+            assigned_to?: undefined;
+            assignment_group?: undefined;
+            days?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            pipeline_sys_id: {
+                type: string;
+                description: string;
+            };
+            days: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            sys_id?: undefined;
+            environment?: undefined;
+            state?: undefined;
+            short_description?: undefined;
+            pipeline?: undefined;
+            artifact?: undefined;
+            type?: undefined;
+            assigned_to?: undefined;
+            assignment_group?: undefined;
+            artifact_name?: undefined;
+            artifact_version?: undefined;
+            status?: undefined;
+            notes?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeDevopsToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=devops.d.ts.map

package/dist/tools/devops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devops.d.ts","sourceRoot":"","sources":["../../src/tools/devops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgGvC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAsGd"}

package/dist/tools/devops.js

@@ -0,0 +1,207 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getDevopsToolDefinitions() {
+    return [
+        {
+            name: 'list_devops_pipelines',
+            description: 'List DevOps pipeline configurations registered in ServiceNow',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter to active pipelines (default true)' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_devops_pipeline',
+            description: 'Get details of a specific DevOps pipeline',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Pipeline sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_deployments',
+            description: 'List recent application deployments tracked in ServiceNow',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    pipeline_sys_id: { type: 'string', description: 'Filter by pipeline' },
+                    environment: { type: 'string', description: 'Filter by environment (e.g. "prod", "staging")' },
+                    state: { type: 'string', description: 'Filter by state: "success", "failed", "in_progress"' },
+                    limit: { type: 'number', description: 'Max records (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_deployment',
+            description: 'Get details and status of a specific deployment',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Deployment sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'create_devops_change',
+            description: 'Create a change request linked to a DevOps deployment for change governance. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    short_description: { type: 'string', description: 'Change short description' },
+                    pipeline: { type: 'string', description: 'Pipeline name or sys_id' },
+                    environment: { type: 'string', description: 'Target environment (prod, staging, dev)' },
+                    artifact: { type: 'string', description: 'Artifact name or version being deployed' },
+                    type: { type: 'string', description: 'Change type: normal, standard, emergency' },
+                    assigned_to: { type: 'string', description: 'User sys_id' },
+                    assignment_group: { type: 'string', description: 'Group sys_id' },
+                },
+                required: ['short_description', 'environment'],
+            },
+        },
+        {
+            name: 'track_deployment',
+            description: 'Record a deployment event in ServiceNow for audit and velocity tracking. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    pipeline: { type: 'string', description: 'Pipeline sys_id or name' },
+                    environment: { type: 'string', description: 'Target environment' },
+                    artifact_name: { type: 'string', description: 'Artifact or application name' },
+                    artifact_version: { type: 'string', description: 'Version or build number' },
+                    status: { type: 'string', description: 'Deployment status: success, failed, rolled_back' },
+                    notes: { type: 'string', description: 'Deployment notes' },
+                },
+                required: ['environment', 'artifact_name', 'status'],
+            },
+        },
+        {
+            name: 'get_devops_insights',
+            description: 'Get deployment frequency, failure rate, and lead time metrics for a pipeline',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    pipeline_sys_id: { type: 'string', description: 'Pipeline sys_id (optional — all pipelines if omitted)' },
+                    days: { type: 'number', description: 'Number of days to analyse (default 30)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeDevopsToolCall(client, name, args) {
+    switch (name) {
+        case 'list_devops_pipelines': {
+            const query = args.active !== false ? 'active=true' : '';
+            const resp = await client.queryRecords({
+                table: 'sn_devops_pipeline',
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,name,active,type,description,sys_updated_on',
+            });
+            return { count: resp.count, pipelines: resp.records };
+        }
+        case 'get_devops_pipeline': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.getRecord('sn_devops_pipeline', args.sys_id);
+            return result;
+        }
+        case 'list_deployments': {
+            let query = '';
+            if (args.pipeline_sys_id)
+                query = `pipeline=${args.pipeline_sys_id}`;
+            if (args.environment)
+                query = query ? `${query}^stage=${args.environment}` : `stage=${args.environment}`;
+            if (args.state)
+                query = query ? `${query}^status=${args.state}` : `status=${args.state}`;
+            const resp = await client.queryRecords({
+                table: 'sn_devops_deploy_task',
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,name,pipeline,stage,status,artifact_name,artifact_version,sys_created_on,sys_updated_on',
+            });
+            return { count: resp.count, deployments: resp.records };
+        }
+        case 'get_deployment': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.getRecord('sn_devops_deploy_task', args.sys_id);
+            return result;
+        }
+        case 'create_devops_change': {
+            if (!args.short_description || !args.environment) {
+                throw new ServiceNowError('short_description and environment are required', 'INVALID_REQUEST');
+            }
+            requireWrite();
+            const payload = {
+                short_description: args.short_description,
+                type: args.type || 'standard',
+                description: `DevOps deployment to ${args.environment}${args.artifact ? ` — ${args.artifact}` : ''}`,
+            };
+            if (args.assigned_to)
+                payload.assigned_to = args.assigned_to;
+            if (args.assignment_group)
+                payload.assignment_group = args.assignment_group;
+            // Create as a standard change request linked to devops
+            const result = await client.createRecord('change_request', payload);
+            return { action: 'created', environment: args.environment, ...result };
+        }
+        case 'track_deployment': {
+            if (!args.environment || !args.artifact_name || !args.status) {
+                throw new ServiceNowError('environment, artifact_name, and status are required', 'INVALID_REQUEST');
+            }
+            requireWrite();
+            const payload = {
+                stage: args.environment,
+                artifact_name: args.artifact_name,
+                status: args.status,
+            };
+            if (args.pipeline)
+                payload.pipeline = args.pipeline;
+            if (args.artifact_version)
+                payload.artifact_version = args.artifact_version;
+            if (args.notes)
+                payload.description = args.notes;
+            const result = await client.createRecord('sn_devops_deploy_task', payload);
+            return { action: 'tracked', artifact: args.artifact_name, environment: args.environment, status: args.status, ...result };
+        }
+        case 'get_devops_insights': {
+            const days = args.days || 30;
+            const since = new Date(Date.now() - days * 86400000).toISOString().slice(0, 19).replace('T', ' ');
+            let query = `sys_created_on>=${since}`;
+            if (args.pipeline_sys_id)
+                query += `^pipeline=${args.pipeline_sys_id}`;
+            const resp = await client.queryRecords({
+                table: 'sn_devops_deploy_task',
+                query,
+                limit: 1000,
+                fields: 'status,sys_created_on',
+            });
+            const total = resp.count;
+            const success = resp.records.filter((r) => r.status === 'success').length;
+            const failed = resp.records.filter((r) => r.status === 'failed').length;
+            return {
+                period_days: days,
+                total_deployments: total,
+                successful: success,
+                failed,
+                success_rate: total > 0 ? `${Math.round((success / total) * 100)}%` : 'N/A',
+                failure_rate: total > 0 ? `${Math.round((failed / total) * 100)}%` : 'N/A',
+                deployment_frequency: total > 0 ? `${(total / days).toFixed(1)} per day` : 'N/A',
+                note: 'Lead time requires change_request linkage; enable DevOps plugin for full DORA metrics',
+            };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=devops.js.map