nowaikit 2.5.3 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/dist/cli/index.js +89 -1
  2. package/dist/cli/index.js.map +1 -1
  3. package/dist/direct/executor.d.ts +28 -0
  4. package/dist/direct/executor.d.ts.map +1 -0
  5. package/dist/direct/executor.js +228 -0
  6. package/dist/direct/executor.js.map +1 -0
  7. package/dist/direct/llm-client.d.ts +32 -0
  8. package/dist/direct/llm-client.d.ts.map +1 -0
  9. package/dist/direct/llm-client.js +122 -0
  10. package/dist/direct/llm-client.js.map +1 -0
  11. package/dist/prompts/capabilities/build-app.d.ts +4 -0
  12. package/dist/prompts/capabilities/build-app.d.ts.map +1 -0
  13. package/dist/prompts/capabilities/build-app.js +238 -0
  14. package/dist/prompts/capabilities/build-app.js.map +1 -0
  15. package/dist/prompts/capabilities/build-business-rule.d.ts +4 -0
  16. package/dist/prompts/capabilities/build-business-rule.d.ts.map +1 -0
  17. package/dist/prompts/capabilities/build-business-rule.js +93 -0
  18. package/dist/prompts/capabilities/build-business-rule.js.map +1 -0
  19. package/dist/prompts/capabilities/build-catalog.d.ts +4 -0
  20. package/dist/prompts/capabilities/build-catalog.d.ts.map +1 -0
  21. package/dist/prompts/capabilities/build-catalog.js +350 -0
  22. package/dist/prompts/capabilities/build-catalog.js.map +1 -0
  23. package/dist/prompts/capabilities/build-client-script.d.ts +4 -0
  24. package/dist/prompts/capabilities/build-client-script.d.ts.map +1 -0
  25. package/dist/prompts/capabilities/build-client-script.js +157 -0
  26. package/dist/prompts/capabilities/build-client-script.js.map +1 -0
  27. package/dist/prompts/capabilities/build-flow.d.ts +4 -0
  28. package/dist/prompts/capabilities/build-flow.d.ts.map +1 -0
  29. package/dist/prompts/capabilities/build-flow.js +243 -0
  30. package/dist/prompts/capabilities/build-flow.js.map +1 -0
  31. package/dist/prompts/capabilities/build-portal.d.ts +4 -0
  32. package/dist/prompts/capabilities/build-portal.d.ts.map +1 -0
  33. package/dist/prompts/capabilities/build-portal.js +250 -0
  34. package/dist/prompts/capabilities/build-portal.js.map +1 -0
  35. package/dist/prompts/capabilities/build-rest-api.d.ts +4 -0
  36. package/dist/prompts/capabilities/build-rest-api.d.ts.map +1 -0
  37. package/dist/prompts/capabilities/build-rest-api.js +293 -0
  38. package/dist/prompts/capabilities/build-rest-api.js.map +1 -0
  39. package/dist/prompts/capabilities/build-test-plan.d.ts +4 -0
  40. package/dist/prompts/capabilities/build-test-plan.d.ts.map +1 -0
  41. package/dist/prompts/capabilities/build-test-plan.js +162 -0
  42. package/dist/prompts/capabilities/build-test-plan.js.map +1 -0
  43. package/dist/prompts/capabilities/build-uib.d.ts +4 -0
  44. package/dist/prompts/capabilities/build-uib.d.ts.map +1 -0
  45. package/dist/prompts/capabilities/build-uib.js +309 -0
  46. package/dist/prompts/capabilities/build-uib.js.map +1 -0
  47. package/dist/prompts/capabilities/docs-app.d.ts +4 -0
  48. package/dist/prompts/capabilities/docs-app.d.ts.map +1 -0
  49. package/dist/prompts/capabilities/docs-app.js +234 -0
  50. package/dist/prompts/capabilities/docs-app.js.map +1 -0
  51. package/dist/prompts/capabilities/docs-release.d.ts +4 -0
  52. package/dist/prompts/capabilities/docs-release.d.ts.map +1 -0
  53. package/dist/prompts/capabilities/docs-release.js +197 -0
  54. package/dist/prompts/capabilities/docs-release.js.map +1 -0
  55. package/dist/prompts/capabilities/docs-runbook.d.ts +4 -0
  56. package/dist/prompts/capabilities/docs-runbook.d.ts.map +1 -0
  57. package/dist/prompts/capabilities/docs-runbook.js +223 -0
  58. package/dist/prompts/capabilities/docs-runbook.js.map +1 -0
  59. package/dist/prompts/capabilities/docs-script.d.ts +4 -0
  60. package/dist/prompts/capabilities/docs-script.d.ts.map +1 -0
  61. package/dist/prompts/capabilities/docs-script.js +242 -0
  62. package/dist/prompts/capabilities/docs-script.js.map +1 -0
  63. package/dist/prompts/capabilities/ops-deploy.d.ts +4 -0
  64. package/dist/prompts/capabilities/ops-deploy.d.ts.map +1 -0
  65. package/dist/prompts/capabilities/ops-deploy.js +193 -0
  66. package/dist/prompts/capabilities/ops-deploy.js.map +1 -0
  67. package/dist/prompts/capabilities/ops-risk.d.ts +4 -0
  68. package/dist/prompts/capabilities/ops-risk.d.ts.map +1 -0
  69. package/dist/prompts/capabilities/ops-risk.js +227 -0
  70. package/dist/prompts/capabilities/ops-risk.js.map +1 -0
  71. package/dist/prompts/capabilities/ops-triage.d.ts +4 -0
  72. package/dist/prompts/capabilities/ops-triage.d.ts.map +1 -0
  73. package/dist/prompts/capabilities/ops-triage.js +183 -0
  74. package/dist/prompts/capabilities/ops-triage.js.map +1 -0
  75. package/dist/prompts/capabilities/review-acls.d.ts +4 -0
  76. package/dist/prompts/capabilities/review-acls.d.ts.map +1 -0
  77. package/dist/prompts/capabilities/review-acls.js +142 -0
  78. package/dist/prompts/capabilities/review-acls.js.map +1 -0
  79. package/dist/prompts/capabilities/review-code.d.ts +4 -0
  80. package/dist/prompts/capabilities/review-code.d.ts.map +1 -0
  81. package/dist/prompts/capabilities/review-code.js +155 -0
  82. package/dist/prompts/capabilities/review-code.js.map +1 -0
  83. package/dist/prompts/capabilities/review-flows.d.ts +4 -0
  84. package/dist/prompts/capabilities/review-flows.d.ts.map +1 -0
  85. package/dist/prompts/capabilities/review-flows.js +413 -0
  86. package/dist/prompts/capabilities/review-flows.js.map +1 -0
  87. package/dist/prompts/capabilities/review-scripts.d.ts +4 -0
  88. package/dist/prompts/capabilities/review-scripts.d.ts.map +1 -0
  89. package/dist/prompts/capabilities/review-scripts.js +160 -0
  90. package/dist/prompts/capabilities/review-scripts.js.map +1 -0
  91. package/dist/prompts/capabilities/scan-automation.d.ts +4 -0
  92. package/dist/prompts/capabilities/scan-automation.d.ts.map +1 -0
  93. package/dist/prompts/capabilities/scan-automation.js +449 -0
  94. package/dist/prompts/capabilities/scan-automation.js.map +1 -0
  95. package/dist/prompts/capabilities/scan-cmdb.d.ts +4 -0
  96. package/dist/prompts/capabilities/scan-cmdb.d.ts.map +1 -0
  97. package/dist/prompts/capabilities/scan-cmdb.js +450 -0
  98. package/dist/prompts/capabilities/scan-cmdb.js.map +1 -0
  99. package/dist/prompts/capabilities/scan-debt.d.ts +4 -0
  100. package/dist/prompts/capabilities/scan-debt.d.ts.map +1 -0
  101. package/dist/prompts/capabilities/scan-debt.js +287 -0
  102. package/dist/prompts/capabilities/scan-debt.js.map +1 -0
  103. package/dist/prompts/capabilities/scan-health.d.ts +4 -0
  104. package/dist/prompts/capabilities/scan-health.d.ts.map +1 -0
  105. package/dist/prompts/capabilities/scan-health.js +235 -0
  106. package/dist/prompts/capabilities/scan-health.js.map +1 -0
  107. package/dist/prompts/capabilities/scan-security.d.ts +4 -0
  108. package/dist/prompts/capabilities/scan-security.d.ts.map +1 -0
  109. package/dist/prompts/capabilities/scan-security.js +370 -0
  110. package/dist/prompts/capabilities/scan-security.js.map +1 -0
  111. package/dist/prompts/capabilities/scan-upgrade.d.ts +4 -0
  112. package/dist/prompts/capabilities/scan-upgrade.d.ts.map +1 -0
  113. package/dist/prompts/capabilities/scan-upgrade.js +327 -0
  114. package/dist/prompts/capabilities/scan-upgrade.js.map +1 -0
  115. package/dist/prompts/index.d.ts +24 -2
  116. package/dist/prompts/index.d.ts.map +1 -1
  117. package/dist/prompts/index.js +160 -14
  118. package/dist/prompts/index.js.map +1 -1
  119. package/dist/prompts/knowledge.d.ts +10 -0
  120. package/dist/prompts/knowledge.d.ts.map +1 -0
  121. package/dist/prompts/knowledge.js +604 -0
  122. package/dist/prompts/knowledge.js.map +1 -0
  123. package/dist/prompts/types.d.ts +38 -0
  124. package/dist/prompts/types.d.ts.map +1 -0
  125. package/dist/prompts/types.js +8 -0
  126. package/dist/prompts/types.js.map +1 -0
  127. package/dist/server.js +3 -3
  128. package/dist/server.js.map +1 -1
  129. package/dist/servicenow/client.d.ts +15 -0
  130. package/dist/servicenow/client.d.ts.map +1 -1
  131. package/dist/servicenow/client.js +107 -0
  132. package/dist/servicenow/client.js.map +1 -1
  133. package/dist/tools/core.d.ts +68 -0
  134. package/dist/tools/core.d.ts.map +1 -1
  135. package/dist/tools/core.js +58 -0
  136. package/dist/tools/core.js.map +1 -1
  137. package/dist/tools/fluent.d.ts +161 -0
  138. package/dist/tools/fluent.d.ts.map +1 -0
  139. package/dist/tools/fluent.js +277 -0
  140. package/dist/tools/fluent.js.map +1 -0
  141. package/dist/tools/index.d.ts +214 -0
  142. package/dist/tools/index.d.ts.map +1 -1
  143. package/dist/tools/index.js +12 -6
  144. package/dist/tools/index.js.map +1 -1
  145. package/dist/tools/now-assist.d.ts.map +1 -1
  146. package/dist/tools/now-assist.js +8 -0
  147. package/dist/tools/now-assist.js.map +1 -1
  148. package/dist/tools/script.d.ts.map +1 -1
  149. package/dist/tools/script.js +12 -0
  150. package/dist/tools/script.js.map +1 -1
  151. package/package.json +11 -3
@@ -0,0 +1,197 @@
1
+ const capability = {
2
+ name: 'docs-release',
3
+ title: 'Generate Release Notes',
4
+ description: 'Generate release notes from update set contents — summarize all changes, categorize by type, highlight breaking changes',
5
+ category: 'docs',
6
+ arguments: [
7
+ {
8
+ name: 'updateset',
9
+ description: 'update set name or sys_id',
10
+ required: true,
11
+ },
12
+ {
13
+ name: 'version',
14
+ description: 'version number for the release e.g. 2.1.0',
15
+ required: false,
16
+ },
17
+ ],
18
+ recommendedTools: [
19
+ 'list_update_sets',
20
+ 'query_records',
21
+ 'get_business_rule',
22
+ 'get_script_include',
23
+ 'get_client_script',
24
+ ],
25
+ buildPrompt(args) {
26
+ const updateset = args?.updateset ?? 'Generate release notes';
27
+ const version = args?.version ?? 'UNRELEASED';
28
+ return [
29
+ {
30
+ role: 'assistant',
31
+ content: {
32
+ type: 'text',
33
+ text: [
34
+ '# Capability: Generate Release Notes',
35
+ '',
36
+ `**Version:** ${version}`,
37
+ '',
38
+ 'I am a **release notes specialist**. I analyze update set contents and generate',
39
+ 'structured, categorized release notes with breaking change highlights.',
40
+ '',
41
+ '## Release Notes Workflow',
42
+ '',
43
+ '### Step 1 — Fetch Update Set Contents',
44
+ '',
45
+ 'Use `list_update_sets` to find the update set, then `query_records` on',
46
+ '`sys_update_xml` filtered by `update_set` to retrieve every customer update:',
47
+ '- Record type (table name)',
48
+ '- Action (insert, update, delete)',
49
+ '- Target record name and sys_id',
50
+ '- Payload summary (what fields changed)',
51
+ '- Update set name and parent set (if batched)',
52
+ '',
53
+ '### Step 2 — Categorize Changes',
54
+ '',
55
+ 'Sort each change into one of these categories:',
56
+ '',
57
+ '| Category | Icon | Criteria |',
58
+ '|----------|------|----------|',
59
+ '| **New Features** | NEW | New records (inserts) that add functionality |',
60
+ '| **Enhancements** | ENHANCED | Updates to existing records that improve functionality |',
61
+ '| **Bug Fixes** | FIXED | Changes that correct defective behavior |',
62
+ '| **Security** | SECURITY | ACL changes, role modifications, security policies |',
63
+ '| **Configuration** | CONFIG | Property changes, system settings, UI adjustments |',
64
+ '| **Deprecated** | DEPRECATED | Features marked for removal in future releases |',
65
+ '',
66
+ 'Categorization heuristics:',
67
+ '- Inserts on functional tables (sys_script, sys_script_include, etc.) = New Features',
68
+ '- Updates with "fix" in description or work notes = Bug Fixes',
69
+ '- ACL/role table changes = Security',
70
+ '- sys_properties changes = Configuration',
71
+ '- Use context clues from record names and descriptions',
72
+ '',
73
+ '### Step 3 — Detail Each Change',
74
+ '',
75
+ 'For each change, document:',
76
+ '',
77
+ '| Field | Description |',
78
+ '|-------|-------------|',
79
+ '| **Type** | Artifact type: BR, SI, CS, ACL, Flow, Catalog Item, Table, etc. |',
80
+ '| **Table Affected** | Which table this artifact operates on |',
81
+ '| **Name** | Human-readable name of the artifact |',
82
+ '| **What Changed** | Summary of the modification in plain language |',
83
+ '| **Impact** | Who/what is affected by this change |',
84
+ '',
85
+ 'Use `get_business_rule`, `get_script_include`, `get_client_script` to fetch',
86
+ 'details when the update XML payload is insufficient.',
87
+ '',
88
+ '### Step 4 — Highlight Breaking Changes',
89
+ '',
90
+ 'Flag changes that may break existing functionality:',
91
+ '',
92
+ '**Schema Changes (BREAKING)**',
93
+ '- New mandatory fields on existing tables',
94
+ '- Field type changes (e.g., string to reference)',
95
+ '- Deleted fields or tables',
96
+ '- Changed field max length (shorter)',
97
+ '',
98
+ '**ACL Changes (BREAKING)**',
99
+ '- More restrictive ACLs (users lose access)',
100
+ '- Removed ACLs (security gap)',
101
+ '- Changed ACL conditions',
102
+ '',
103
+ '**Script Interface Changes (BREAKING)**',
104
+ '- Script Include method signature changes',
105
+ '- Removed or renamed public methods',
106
+ '- Changed return types or behavior',
107
+ '- Modified API endpoints (Scripted REST)',
108
+ '',
109
+ '**Behavioral Changes (POTENTIALLY BREAKING)**',
110
+ '- Business rule condition changes',
111
+ '- Flow trigger modifications',
112
+ '- Notification recipient changes',
113
+ '- Catalog variable changes affecting fulfillment',
114
+ '',
115
+ '### Step 5 — Generate Formatted Release Notes',
116
+ '',
117
+ '## Output Format',
118
+ '',
119
+ '```',
120
+ `# Release Notes — v${version}`,
121
+ 'Release Date: [date]',
122
+ 'Update Set: [name]',
123
+ '',
124
+ '---',
125
+ '',
126
+ '## Breaking Changes',
127
+ '',
128
+ '> These changes require attention during upgrade. Review before deploying.',
129
+ '',
130
+ '- **[BREAKING]** [type] — [description of what changed and migration steps]',
131
+ '',
132
+ '---',
133
+ '',
134
+ '## New Features',
135
+ '',
136
+ '- **[type]** [name] — [description]',
137
+ ' - Table: [affected table]',
138
+ ' - Details: [additional context]',
139
+ '',
140
+ '## Enhancements',
141
+ '',
142
+ '- **[type]** [name] — [description]',
143
+ '',
144
+ '## Bug Fixes',
145
+ '',
146
+ '- **[type]** [name] — [what was broken and how it was fixed]',
147
+ '',
148
+ '## Security',
149
+ '',
150
+ '- **[type]** [name] — [security change description]',
151
+ '',
152
+ '## Configuration Changes',
153
+ '',
154
+ '- **[type]** [name] — [what was configured]',
155
+ '',
156
+ '---',
157
+ '',
158
+ '## Change Summary',
159
+ '',
160
+ '| Category | Count |',
161
+ '|----------|-------|',
162
+ '| New Features | X |',
163
+ '| Enhancements | X |',
164
+ '| Bug Fixes | X |',
165
+ '| Security | X |',
166
+ '| Configuration | X |',
167
+ '| **Total** | **X** |',
168
+ '',
169
+ '## Artifact Breakdown',
170
+ '',
171
+ '| Artifact Type | Inserts | Updates | Deletes |',
172
+ '|---------------|---------|---------|---------|',
173
+ '| Business Rules | X | X | X |',
174
+ '| Script Includes | X | X | X |',
175
+ '| Client Scripts | X | X | X |',
176
+ '| ACLs | X | X | X |',
177
+ '| ... | ... | ... | ... |',
178
+ '```',
179
+ '',
180
+ '---',
181
+ '',
182
+ `Starting release notes generation for version: **${version}**.`,
183
+ ].join('\n'),
184
+ },
185
+ },
186
+ {
187
+ role: 'user',
188
+ content: {
189
+ type: 'text',
190
+ text: updateset,
191
+ },
192
+ },
193
+ ];
194
+ },
195
+ };
196
+ export default capability;
197
+ //# sourceMappingURL=docs-release.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-release.js","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-release.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { CapabilityDefinition } from '../types.js';
2
+ declare const capability: CapabilityDefinition;
3
+ export default capability;
4
+ //# sourceMappingURL=docs-runbook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-runbook.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-runbook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBAiOjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
@@ -0,0 +1,223 @@
1
+ const capability = {
2
+ name: 'docs-runbook',
3
+ title: 'Generate Runbook',
4
+ description: 'Generate operational runbook for a service, application, or CI — incident response steps, health checks, escalation paths',
5
+ category: 'docs',
6
+ arguments: [
7
+ {
8
+ name: 'service',
9
+ description: 'service name, CI name, or application name',
10
+ required: true,
11
+ },
12
+ ],
13
+ recommendedTools: [
14
+ 'search_cmdb_ci',
15
+ 'get_cmdb_ci',
16
+ 'list_relationships',
17
+ 'query_records',
18
+ 'search_knowledge',
19
+ 'list_business_rules',
20
+ 'list_scheduled_jobs',
21
+ 'list_flows',
22
+ ],
23
+ buildPrompt(args) {
24
+ const service = args?.service ?? 'Generate the runbook';
25
+ return [
26
+ {
27
+ role: 'assistant',
28
+ content: {
29
+ type: 'text',
30
+ text: [
31
+ '# Capability: Generate Runbook',
32
+ '',
33
+ 'I am an **operational runbook specialist**. I generate comprehensive runbooks for',
34
+ 'services, applications, and configuration items by gathering information from the',
35
+ 'CMDB, knowledge base, automation, and operational data.',
36
+ '',
37
+ '## Runbook Sections',
38
+ '',
39
+ '### 1. Service Overview & Architecture',
40
+ '',
41
+ 'Use `search_cmdb_ci`, `get_cmdb_ci`, and `query_records` to document:',
42
+ '- Service/CI name, class, operational status',
43
+ '- Business criticality and tier (Tier 1/2/3)',
44
+ '- Owner, support group, managed by',
45
+ '- Environment (production, staging, dev)',
46
+ '- Architecture description — what the service does, how it works',
47
+ '- Technology stack and platform dependencies',
48
+ '- SLA commitments (uptime, response time)',
49
+ '',
50
+ '### 2. Key CIs & Dependencies',
51
+ '',
52
+ 'Use `get_cmdb_ci` and `list_relationships` to map:',
53
+ '',
54
+ '**Upstream Dependencies (this service depends on):**',
55
+ '- CI name, class, operational status',
56
+ '- Impact if upstream fails (full outage, degraded, none)',
57
+ '- Failover/redundancy available',
58
+ '',
59
+ '**Downstream Dependants (depend on this service):**',
60
+ '- CI name, class, business criticality',
61
+ '- Impact if this service fails',
62
+ '- Number of end users affected',
63
+ '',
64
+ '**Infrastructure Components:**',
65
+ '- Servers, load balancers, databases',
66
+ '- Network segments, firewalls, DNS',
67
+ '- Storage, backup systems',
68
+ '',
69
+ 'Output: Dependency diagram description (upstream -> service -> downstream)',
70
+ '',
71
+ '### 3. Health Check Procedures',
72
+ '',
73
+ 'Use `query_records`, `list_scheduled_jobs`, and `search_knowledge` to define:',
74
+ '',
75
+ '| Check | Command/Procedure | Expected Result | Frequency |',
76
+ '|-------|-------------------|-----------------|-----------|',
77
+ '| Service availability | [how to check] | [expected response] | Every 5 min |',
78
+ '| Database connectivity | [how to check] | [expected state] | Every 5 min |',
79
+ '| Queue depth | [how to check] | [threshold] | Every 15 min |',
80
+ '| Scheduled jobs | [how to check] | [all green] | Daily |',
81
+ '| Log error rate | [how to check] | [< threshold] | Every 15 min |',
82
+ '| Integration endpoints | [how to check] | [200 OK] | Every 5 min |',
83
+ '| Certificate expiry | [how to check] | [> 30 days] | Weekly |',
84
+ '',
85
+ '### 4. Common Incidents & Troubleshooting',
86
+ '',
87
+ 'Use `query_records` on `incident` (filtered by CI) and `search_knowledge` to compile:',
88
+ '',
89
+ 'For each common incident pattern:',
90
+ '',
91
+ '```',
92
+ 'INCIDENT: [Short description pattern]',
93
+ 'Frequency: [how often this occurs]',
94
+ 'Severity: [typical priority]',
95
+ 'Symptoms:',
96
+ ' - [symptom 1]',
97
+ ' - [symptom 2]',
98
+ 'Root Cause: [known cause]',
99
+ 'Resolution Steps:',
100
+ ' 1. [step with detail]',
101
+ ' 2. [step with detail]',
102
+ ' ...',
103
+ 'Verification: [how to confirm resolution]',
104
+ 'Prevention: [how to avoid recurrence]',
105
+ 'KB Article: [link if available]',
106
+ '```',
107
+ '',
108
+ '### 5. Escalation Matrix',
109
+ '',
110
+ 'Use `query_records` on `sys_user_group`, `cmdb_ci_service`, and related tables:',
111
+ '',
112
+ '| Level | When to Escalate | Contact | Response Time |',
113
+ '|-------|------------------|---------|---------------|',
114
+ '| L1 | Initial triage, known issues | [support group] | 15 min |',
115
+ '| L2 | Unknown issues, requires investigation | [engineering team] | 30 min |',
116
+ '| L3 | Complex issues, code changes needed | [dev team / vendor] | 1 hour |',
117
+ '| Management | P1 incidents, SLA breach risk | [service owner / manager] | Immediate |',
118
+ '| Executive | Major outage, customer impact | [director / VP] | Immediate |',
119
+ '',
120
+ 'Include: on-call rotation information, bridge/war room procedures, vendor contacts',
121
+ '',
122
+ '### 6. Maintenance Windows & Procedures',
123
+ '',
124
+ 'Use `query_records` and `list_scheduled_jobs` to document:',
125
+ '',
126
+ '**Regular Maintenance:**',
127
+ '- Scheduled window (day/time/timezone)',
128
+ '- What maintenance activities are performed',
129
+ '- Pre-maintenance checklist',
130
+ '- Post-maintenance validation steps',
131
+ '- User notification requirements',
132
+ '',
133
+ '**Patching Procedures:**',
134
+ '- Patch schedule and approval process',
135
+ '- Pre-patch backup requirements',
136
+ '- Patch application steps',
137
+ '- Post-patch validation',
138
+ '',
139
+ '### 7. Recovery Procedures',
140
+ '',
141
+ 'Use `search_knowledge` and `query_records` to compile:',
142
+ '',
143
+ '**Service Restart:**',
144
+ '1. Pre-restart checks (save state, drain connections)',
145
+ '2. Restart command/procedure',
146
+ '3. Post-restart validation',
147
+ '4. Expected recovery time',
148
+ '',
149
+ '**Failover:**',
150
+ '1. Failover trigger conditions',
151
+ '2. Automatic vs. manual failover',
152
+ '3. Failover execution steps',
153
+ '4. DNS/load balancer updates',
154
+ '5. Verification of failover success',
155
+ '6. Failback procedure',
156
+ '',
157
+ '**Rollback:**',
158
+ '1. Rollback trigger conditions',
159
+ '2. Data backup verification',
160
+ '3. Rollback execution steps',
161
+ '4. Post-rollback validation',
162
+ '5. Communication to stakeholders',
163
+ '',
164
+ '**Disaster Recovery:**',
165
+ '- RPO (Recovery Point Objective)',
166
+ '- RTO (Recovery Time Objective)',
167
+ '- DR site details and activation procedure',
168
+ '- Data restoration steps',
169
+ '',
170
+ '### 8. Monitoring & Alerting',
171
+ '',
172
+ 'Use `query_records` and `list_flows` to document:',
173
+ '',
174
+ '| Metric | Threshold (Warning) | Threshold (Critical) | Alert Channel |',
175
+ '|--------|---------------------|----------------------|---------------|',
176
+ '| Response time | > 2s | > 5s | [email/SMS/PagerDuty] |',
177
+ '| Error rate | > 1% | > 5% | [channel] |',
178
+ '| CPU utilization | > 80% | > 95% | [channel] |',
179
+ '| Memory usage | > 80% | > 95% | [channel] |',
180
+ '| Queue depth | > 1000 | > 5000 | [channel] |',
181
+ '| Disk usage | > 80% | > 90% | [channel] |',
182
+ '',
183
+ '- Dashboard URLs and access instructions',
184
+ '- Log locations and search queries for common issues',
185
+ '- Alert acknowledgment and escalation procedures',
186
+ '',
187
+ '## Output Format',
188
+ '',
189
+ '```',
190
+ '# Operational Runbook: [Service Name]',
191
+ '## Version: [date] | Owner: [team] | Criticality: [tier]',
192
+ '',
193
+ '### Table of Contents',
194
+ '1. Service Overview & Architecture',
195
+ '2. Key CIs & Dependencies',
196
+ '3. Health Check Procedures',
197
+ '4. Common Incidents & Troubleshooting',
198
+ '5. Escalation Matrix',
199
+ '6. Maintenance Windows & Procedures',
200
+ '7. Recovery Procedures',
201
+ '8. Monitoring & Alerting',
202
+ '',
203
+ '[Each section fully populated with operational detail]',
204
+ '```',
205
+ '',
206
+ '---',
207
+ '',
208
+ 'Starting runbook generation.',
209
+ ].join('\n'),
210
+ },
211
+ },
212
+ {
213
+ role: 'user',
214
+ content: {
215
+ type: 'text',
216
+ text: service,
217
+ },
218
+ },
219
+ ];
220
+ },
221
+ };
222
+ export default capability;
223
+ //# sourceMappingURL=docs-runbook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-runbook.js","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-runbook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { CapabilityDefinition } from '../types.js';
2
+ declare const capability: CapabilityDefinition;
3
+ export default capability;
4
+ //# sourceMappingURL=docs-script.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-script.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBAqPjB,CAAC;AAEF,eAAe,UAAU,CAAC"}