nowaikit 2.5.3 → 3.0.0

package/dist/prompts/capabilities/scan-debt.js

@@ -0,0 +1,287 @@
+const capability = {
+    name: 'scan-debt',
+    title: 'Technical Debt Analysis',
+    description: 'Find dead code, unused scripts, duplicate logic, stale configurations across ALL artifact types',
+    category: 'scan',
+    arguments: [
+        {
+            name: 'scope',
+            description: 'Scope of analysis: "instance" (default) for full scan, or a specific table/app name',
+            required: false,
+        },
+    ],
+    recommendedTools: [
+        'list_business_rules',
+        'list_script_includes',
+        'list_client_scripts',
+        'list_ui_policies',
+        'list_ui_actions',
+        'query_records',
+        'list_update_sets',
+        'list_scheduled_jobs',
+        'list_flows',
+    ],
+    buildPrompt(args) {
+        const scope = args?.scope ?? 'instance';
+        const isFullInstance = scope === 'instance';
+        const scopeLabel = isFullInstance
+            ? 'Full instance technical debt analysis'
+            : `Technical debt analysis for \`${scope}\``;
+        // ─── Inactive / Disabled Artifacts ────────────────────────────────────────
+        const inactiveSection = [
+            '## 1. Inactive & Disabled Artifacts',
+            '',
+            'Scan ALL artifact types for inactive/disabled items that are candidates for removal:',
+            '',
+            'Use `list_business_rules`, `list_client_scripts`, `list_ui_policies`, `list_ui_actions`,',
+            '`list_scheduled_jobs`, `list_flows`, and `query_records` to find:',
+            '',
+            '- **Business Rules** (`sys_script`) \u2014 `active=false`; note last modified date',
+            '- **Client Scripts** (`sys_script_client`) \u2014 `active=false`',
+            '- **UI Policies** (`sys_ui_policy`) \u2014 `active=false`',
+            '- **UI Actions** (`sys_ui_action`) \u2014 `active=false`',
+            '- **Scheduled Jobs** (`sysauto_script`) \u2014 `active=false`',
+            '- **Flows** (`sys_hub_flow`) \u2014 `active=false` or draft state',
+            '- **Workflows** (`wf_workflow`) \u2014 `active=false` (legacy)',
+            '- **Script Includes** (`sys_script_include`) \u2014 `active=false`',
+            '- **Notifications** (`sysevent_email_action`) \u2014 `active=false`',
+            '- **ACLs** (`sys_security_acl`) \u2014 `active=false`',
+            '- **Transform Maps** (`sys_transform_map`) \u2014 `active=false`',
+            '- **Data Sources** (`sys_data_source`) \u2014 `active=false`',
+            '',
+            'For each, note: name, table, last modified, last modified by, inactive duration.',
+            'Flag items inactive for > 90 days as safe removal candidates.',
+            '',
+            '**Output:** Count per artifact type + detailed list sorted by inactive duration',
+        ];
+        // ─── Unused Script Includes ───────────────────────────────────────────────
+        const unusedScriptsSection = [
+            '## 2. Unreferenced Script Includes',
+            '',
+            'Use `list_script_includes` and `query_records` to identify Script Includes not referenced',
+            'by any other artifact:',
+            '',
+            '- Get all active Script Includes (name and API name)',
+            '- For each, search across these artifact types for references to its name:',
+            '  - Business Rules scripts',
+            '  - Other Script Includes',
+            '  - Client Scripts (GlideAjax calls)',
+            '  - Fix Scripts',
+            '  - Scheduled Jobs',
+            '  - Flow Designer script steps',
+            '  - Workflow run-script activities',
+            '  - REST message scripts',
+            '  - Transform map scripts',
+            '',
+            'A Script Include with zero references is likely dead code.',
+            '',
+            'NOTE: Some SIs are invoked dynamically (`GlideEvaluator`, `gs.include()`). Flag these',
+            'as "possibly unused" rather than "confirmed unused".',
+            '',
+            '**Output:** List of unreferenced Script Includes with creation date and last update',
+        ];
+        // ─── Duplicate Artifacts ──────────────────────────────────────────────────
+        const duplicateSection = [
+            '## 3. Duplicate & Redundant Artifacts',
+            '',
+            'Use `query_records` to find duplicates across artifact types:',
+            '',
+            '- **Duplicate ACLs:** same table + operation + role combination',
+            '- **Duplicate Business Rules:** same table + when + order with similar script bodies',
+            '- **Overlapping Client Scripts:** same table + type (onChange/onLoad) on same field',
+            '- **Redundant UI Policies:** same table with conflicting or identical conditions',
+            '- **Duplicate Scheduled Jobs:** similar names and scripts running on overlapping schedules',
+            '- **Overlapping Notifications:** same event + table + conditions',
+            '',
+            'For script-based duplicates, compare script content for > 80% similarity.',
+            '',
+            '**Output:** Duplicate pairs/groups with recommendation on which to keep',
+        ];
+        // ─── Stale Update Sets ────────────────────────────────────────────────────
+        const staleUpdateSetsSection = [
+            '## 4. Stale Update Sets',
+            '',
+            'Use `list_update_sets` and `query_records` on `sys_update_set` to find:',
+            '',
+            '- Update sets in "in progress" state for > 30 days',
+            '- Update sets with 0 customer updates (empty)',
+            '- Update sets created by users who have since left (inactive users)',
+            '- Batch parent update sets with incomplete children',
+            '- Update sets with naming that suggests they are test/temporary',
+            '',
+            '**Output:** Stale update set inventory with age, owner, and update count',
+        ];
+        // ─── Empty / Stub Scripts ─────────────────────────────────────────────────
+        const emptyScriptSection = [
+            '## 5. Empty & Stub Scripts',
+            '',
+            'Use `query_records` to find artifacts that were created but never properly implemented:',
+            '',
+            '- Business Rules with empty `script` field or only comments/placeholder text',
+            '- Script Includes with only the class prototype boilerplate and no actual methods',
+            '- Client Scripts with empty `script` field',
+            '- UI Actions with no script and no URL',
+            '- Scheduled Jobs with empty or trivial scripts (only `gs.log`)',
+            '- Flow Actions with no steps defined',
+            '',
+            '**Output:** List of stub artifacts with creation date and creator',
+        ];
+        // ─── Orphaned Records ─────────────────────────────────────────────────────
+        const orphanedSection = [
+            '## 6. Orphaned Records & Broken References',
+            '',
+            'Use `query_records` to detect:',
+            '',
+            '- Business Rules referencing tables that no longer exist',
+            '- Client Scripts on tables that have been removed',
+            '- ACLs for deleted tables or fields',
+            '- Notification references to deleted events',
+            '- Workflow contexts for deleted workflow versions',
+            '- Dictionary entries (`sys_dictionary`) for non-existent tables',
+            '- Catalog variables referencing deleted catalog items',
+            '- Group memberships for inactive users',
+            '',
+            '**Output:** Orphaned record inventory by type with broken reference details',
+        ];
+        // ─── Deprecated API Usage ─────────────────────────────────────────────────
+        const deprecatedApiSection = [
+            '## 7. Deprecated API Usage',
+            '',
+            'Scan ALL scriptable artifacts for deprecated API patterns:',
+            '',
+            '- **`Packages.java.*`** \u2014 Java package imports (removed in scoped apps, deprecated globally)',
+            '- **`GlideRecord.getDisplayValue()`** without field parameter (ambiguous behavior)',
+            '- **`current.getDisplayValue()`** without field in async Business Rules',
+            '- **`gs.print()`** \u2014 deprecated, use `gs.info()` / `gs.debug()`',
+            '- **`getReference()`** \u2014 synchronous, use `GlideRecord` query instead',
+            '- **`GlideAjax` synchronous calls** \u2014 `getXMLWait()` is deprecated',
+            '- **`g_form.getReference()`** without callback',
+            '- **`GlideDialogWindow`** \u2014 replaced by `GlideModal`',
+            '- **`gel()`** \u2014 use standard DOM APIs or `g_form`',
+            '- **`$j()` / prototype.js`** patterns in UI scripts',
+            '',
+            '**Output:** Deprecated API usage inventory with file, line/context, and modern replacement',
+        ];
+        // ─── Debug / Test Artifacts ───────────────────────────────────────────────
+        const debugSection = [
+            '## 8. Debug & Test Artifacts in Production',
+            '',
+            'Scan ALL artifact types for debug/test patterns that should not be in production:',
+            '',
+            '- **Server-side debug logging:**',
+            '  - `gs.log()` (should use `gs.debug()` with system property gating)',
+            '  - `gs.print()` (deprecated and verbose)',
+            '  - `gs.logWarning()` / `gs.logError()` with test/debug messages',
+            '',
+            '- **Client-side debug logging:**',
+            '  - `console.log()`, `console.debug()`, `console.warn()`',
+            '  - `jslog()` left in production scripts',
+            '  - `alert()` calls used for debugging',
+            '',
+            '- **Test artifacts:**',
+            '  - Scripts with "test", "debug", "temp", "TODO", "FIXME", "HACK" in name or script',
+            '  - Business Rules with names like "test BR" or "debug rule"',
+            '  - Hardcoded test data (test user sys_ids, test email addresses)',
+            '',
+            '- **Commented-out code blocks:**',
+            '  - Large blocks of commented code (> 5 consecutive comment lines that look like code)',
+            '  - Commented-out `addQuery` / `addEncodedQuery` lines',
+            '  - Commented-out function calls',
+            '',
+            '**Output:** Debug/test artifact inventory with artifact type, name, pattern found, and evidence',
+        ];
+        // ─── Report Format ────────────────────────────────────────────────────────
+        const reportFormat = [
+            '## Technical Debt Report Format',
+            '',
+            'Compile all findings into this structure:',
+            '',
+            '```',
+            'TECHNICAL DEBT REPORT',
+            '=====================',
+            `Scope: ${isFullInstance ? 'Full instance' : scope}`,
+            'Date: [current date]',
+            '',
+            'DEBT SUMMARY',
+            '------------',
+            '| Category                    | Count | Est. Cleanup Effort |',
+            '|-----------------------------|-------|---------------------|',
+            '| Inactive artifacts          | X     | [hours/days]        |',
+            '| Unreferenced Script Includes| X     | [hours/days]        |',
+            '| Duplicate artifacts         | X     | [hours/days]        |',
+            '| Stale update sets           | X     | [hours/days]        |',
+            '| Empty/stub scripts          | X     | [hours/days]        |',
+            '| Orphaned records            | X     | [hours/days]        |',
+            '| Deprecated API usage        | X     | [hours/days]        |',
+            '| Debug/test artifacts        | X     | [hours/days]        |',
+            '| TOTAL                       | X     | [hours/days]        |',
+            '',
+            'EFFORT ESTIMATION GUIDE',
+            '  Trivial:  < 5 min per item (delete inactive, remove debug logs)',
+            '  Low:      5-15 min per item (update deprecated API calls)',
+            '  Medium:   15-60 min per item (refactor duplicates, fix orphans)',
+            '  High:     1-4 hours per item (rewrite scripts, consolidate logic)',
+            '',
+            'DETAILED FINDINGS',
+            '[Organized by category, each item with name, type, evidence, effort estimate]',
+            '',
+            'CLEANUP PRIORITIES',
+            '1. [Quick wins — high count, trivial effort]',
+            '2. [Risk reduction — orphans and deprecated APIs]',
+            '3. [Maintenance — duplicates and stale items]',
+            '',
+            'RECOMMENDED CLEANUP PROCESS',
+            '1. Back up via update set before removing anything',
+            '2. Start with inactive artifacts (lowest risk)',
+            '3. Test deprecated API replacements in sub-prod first',
+            '4. Schedule regular debt reviews (quarterly)',
+            '```',
+        ];
+        return [
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: [
+                        '# Capability: Technical Debt Analysis',
+                        '',
+                        `**Scope:** ${scopeLabel}`,
+                        '',
+                        'This capability performs an exhaustive scan for technical debt across ALL artifact types',
+                        'in the ServiceNow instance. It identifies dead code, unused scripts, duplicate logic,',
+                        'stale configurations, deprecated patterns, and debug artifacts that should be cleaned up.',
+                        '',
+                        'CRITICAL INSTRUCTION: Scan every artifact type, not just Business Rules and Script Includes.',
+                        'Technical debt hides in UI Policies, Notifications, Transform Maps, and many other places.',
+                        '',
+                        ...inactiveSection, '',
+                        ...unusedScriptsSection, '',
+                        ...duplicateSection, '',
+                        ...staleUpdateSetsSection, '',
+                        ...emptyScriptSection, '',
+                        ...orphanedSection, '',
+                        ...deprecatedApiSection, '',
+                        ...debugSection, '',
+                        ...reportFormat,
+                        '',
+                        '---',
+                        '',
+                        'Beginning technical debt analysis. Every finding must include artifact type, name,',
+                        'evidence, and estimated cleanup effort.',
+                    ].join('\n'),
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: isFullInstance
+                        ? 'Run a full technical debt analysis on my ServiceNow instance. Scan every artifact type and give me a structured debt inventory with cleanup effort estimates.'
+                        : `Run a technical debt analysis on \`${scope}\`. Scan every relevant artifact type and give me a structured debt inventory with cleanup effort estimates.`,
+                },
+            },
+        ];
+    },
+};
+export default capability;
+//# sourceMappingURL=scan-debt.js.map

package/dist/prompts/capabilities/scan-debt.js.map

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

package/dist/prompts/capabilities/scan-health.d.ts

@@ -0,0 +1,4 @@
+import type { CapabilityDefinition } from '../types.js';
+declare const capability: CapabilityDefinition;
+export default capability;
+//# sourceMappingURL=scan-health.d.ts.map

package/dist/prompts/capabilities/scan-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-health.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/scan-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBA2PjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/prompts/capabilities/scan-health.js

@@ -0,0 +1,235 @@
+const capability = {
+    name: 'scan-health',
+    title: 'Instance Health Scan',
+    description: 'Complete instance health assessment \u2014 plugins, scheduled jobs, logs, quotas, system diagnostics',
+    category: 'scan',
+    arguments: [
+        {
+            name: 'scope',
+            description: 'Health scan scope: "full" (default), "plugins", "jobs", or "logs"',
+            required: false,
+        },
+    ],
+    recommendedTools: [
+        'query_records',
+        'get_sys_log',
+        'list_scheduled_jobs',
+        'get_scheduled_job',
+        'get_system_property',
+        'list_system_properties',
+        'check_table_completeness',
+        'get_table_record_count',
+    ],
+    buildPrompt(args) {
+        const scope = args?.scope ?? 'full';
+        const scopeLabel = {
+            full: 'Full instance health scan',
+            plugins: 'Plugin health scan',
+            jobs: 'Scheduled job health scan',
+            logs: 'System log analysis',
+        };
+        const scopeDescription = scopeLabel[scope] ?? `Scoped health scan: ${scope}`;
+        const systemPropertiesSection = [
+            '## 1. System Properties & Instance Info',
+            '',
+            'Use `list_system_properties` and `get_system_property` to collect:',
+            '- Instance version and build tag (`glide.buildtag`, `glide.war`)',
+            '- Instance name and environment type (dev/test/prod)',
+            '- Time zone and locale settings',
+            '- Licensing info (`glide.product.*`)',
+            '- Node configuration (`glide.cluster.*`)',
+            '- Key feature flags and toggles',
+            '',
+            '**Output:** Instance identity card with version, environment, and config summary',
+        ];
+        const pluginSection = [
+            '## 2. Plugin Status',
+            '',
+            'Use `query_records` on `v_plugin` and `sys_plugins` to check:',
+            '- Count of active vs inactive plugins',
+            '- Plugins in "demo" status that should not be active in production',
+            '- Version mismatches between related plugin families',
+            '- Recently activated or deactivated plugins (last 30 days)',
+            '- Plugins with known deprecation notices',
+            '- Orphaned plugin dependencies (required plugin inactive but dependant active)',
+            '',
+            '**Output:** Plugin inventory table — name, version, status, last modified, risk notes',
+        ];
+        const jobSection = [
+            '## 3. Scheduled Job Health',
+            '',
+            'Use `list_scheduled_jobs` and `get_scheduled_job` to assess:',
+            '- Jobs in "error" or "cancelled" state',
+            '- Jobs that have not run in their expected window (overdue)',
+            '- Long-running jobs (last execution time > 2x average)',
+            '- Critical system jobs that are disabled (e.g., clean-up, replication, mid-server heartbeat)',
+            '- Jobs running as admin that should use a service account',
+            '- Conflicting schedules (multiple heavy jobs overlapping)',
+            '- Custom jobs with no run-as user',
+            '',
+            '**Output:** Job status table with severity for each finding',
+        ];
+        const logSection = [
+            '## 4. System Log Analysis',
+            '',
+            'Use `get_sys_log` and `query_records` on `syslog`, `syslog_transaction`, and `sys_email_log` to analyze:',
+            '- Error and warning frequency over the last 24h/7d',
+            '- Top 10 error sources (by script/table/source field)',
+            '- Recurring error patterns (same message repeating)',
+            '- Transaction quota violations',
+            '- Slow query and transaction warnings',
+            '- Email delivery failures and bounce rates',
+            '- Authentication failures and lockouts',
+            '',
+            '**Output:** Log summary with error trend, top offenders, and severity ratings',
+        ];
+        const tableHealthSection = [
+            '## 5. Table Health',
+            '',
+            'Use `check_table_completeness`, `get_table_record_count`, and `query_records` to evaluate:',
+            '- Record counts for core tables (incident, task, cmdb_ci, sys_audit, syslog)',
+            '- Tables with abnormal growth (>10% increase in 30 days)',
+            '- Attachment table size and orphaned attachments',
+            '- Audit/journal table bloat',
+            '- Tables approaching row count thresholds',
+            '- Data completeness (mandatory fields with null values)',
+            '',
+            '**Output:** Table health matrix with row counts, growth indicators, and warnings',
+        ];
+        const queueSection = [
+            '## 6. Queue Sizes & Backlogs',
+            '',
+            'Use `query_records` and `get_table_record_count` to inspect:',
+            '- Event queue depth (`sysevent` — unprocessed events)',
+            '- Email queue (`sys_email` — ready/send-failed counts)',
+            '- Import set queue (`sys_import_set_row` — pending rows)',
+            '- Scheduled job queue (`sys_trigger` — pending triggers)',
+            '- ECC queue depth (`ecc_queue` — pending input/output)',
+            '- Transform queue backlog',
+            '- Workflow context queue (`wf_context` — active/waiting)',
+            '',
+            '**Output:** Queue status table with current depth, trend direction, and risk level',
+        ];
+        const performanceSection = [
+            '## 7. Performance Indicators',
+            '',
+            'Use `query_records` and `list_system_properties` to gather:',
+            '- Transaction response time properties and thresholds',
+            '- Semaphore and concurrency settings',
+            '- Cache hit/miss ratios (if available via properties)',
+            '- Business rule execution counts (heavy tables)',
+            '- Long-running transaction settings and violations',
+            '- Session timeout and concurrency limits',
+            '',
+            '**Output:** Performance summary with indicator values and recommended thresholds',
+        ];
+        const nodeSection = [
+            '## 8. Node & Cluster Status',
+            '',
+            'Use `query_records` on `sys_cluster_state` and `list_system_properties` for:',
+            '- Number of active application nodes',
+            '- Node roles and load distribution',
+            '- Last heartbeat times per node',
+            '- MID Server connectivity (`ecc_agent` — status, last run)',
+            '- Cluster replication lag',
+            '- Node-specific errors or warnings',
+            '',
+            '**Output:** Cluster topology summary with node status and connectivity',
+        ];
+        // Build sections based on scope
+        let sections;
+        switch (scope) {
+            case 'plugins':
+                sections = [systemPropertiesSection, pluginSection];
+                break;
+            case 'jobs':
+                sections = [jobSection];
+                break;
+            case 'logs':
+                sections = [logSection];
+                break;
+            default:
+                sections = [
+                    systemPropertiesSection,
+                    pluginSection,
+                    jobSection,
+                    logSection,
+                    tableHealthSection,
+                    queueSection,
+                    performanceSection,
+                    nodeSection,
+                ];
+        }
+        const reportFormat = [
+            '## Health Report Format',
+            '',
+            'Compile all findings into a structured report:',
+            '',
+            '```',
+            'INSTANCE HEALTH REPORT',
+            '======================',
+            'Instance: [name]  |  Version: [version]  |  Scan scope: [scope]',
+            'Scan date: [current date]',
+            '',
+            'EXECUTIVE SUMMARY',
+            '- Critical issues: X',
+            '- Warnings: X',
+            '- Informational: X',
+            '- Overall health: [Healthy / Degraded / Critical]',
+            '',
+            'FINDINGS BY CATEGORY',
+            '--------------------',
+            'Each finding includes:',
+            '  [SEVERITY] CATEGORY — Description',
+            '  Evidence: [data/metric that triggered the finding]',
+            '  Impact: [what happens if ignored]',
+            '  Recommendation: [actionable fix]',
+            '',
+            'SEVERITY LEGEND',
+            '  CRITICAL — Immediate action required; service impact likely',
+            '  HIGH     — Action needed within 24-48 hours',
+            '  MEDIUM   — Plan remediation within 1-2 weeks',
+            '  LOW      — Housekeeping; address during next maintenance window',
+            '  INFO     — No action required; noted for awareness',
+            '',
+            'TREND INDICATORS',
+            '  Improving / Stable / Degrading',
+            '```',
+        ];
+        return [
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: [
+                        '# Capability: Instance Health Scan',
+                        '',
+                        `**Scope:** ${scopeDescription}`,
+                        '',
+                        'This capability performs a comprehensive health assessment of the ServiceNow instance.',
+                        'Each section gathers data, analyzes it against best-practice thresholds, and produces',
+                        'findings with severity ratings.',
+                        '',
+                        ...sections.flatMap(s => [...s, '']),
+                        ...reportFormat,
+                        '',
+                        '---',
+                        '',
+                        `Starting health scan with scope: **${scope}**.`,
+                    ].join('\n'),
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: scope === 'full'
+                        ? 'Run a full health scan on my ServiceNow instance. Check every category and give me a structured report with severity ratings.'
+                        : `Run a ${scope} health scan on my ServiceNow instance. Give me a structured report with severity ratings.`,
+                },
+            },
+        ];
+    },
+};
+export default capability;
+//# sourceMappingURL=scan-health.js.map

package/dist/prompts/capabilities/scan-health.js.map

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

package/dist/prompts/capabilities/scan-security.d.ts

@@ -0,0 +1,4 @@
+import type { CapabilityDefinition } from '../types.js';
+declare const capability: CapabilityDefinition;
+export default capability;
+//# sourceMappingURL=scan-security.d.ts.map

package/dist/prompts/capabilities/scan-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-security.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/scan-security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBA+YjB,CAAC;AAEF,eAAe,UAAU,CAAC"}