@vibescope/mcp-server 0.2.4 → 0.2.5

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 (84) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -181
  3. package/dist/cli.d.ts +6 -3
  4. package/dist/cli.js +28 -10
  5. package/dist/handlers/tool-docs.js +828 -828
  6. package/dist/index.js +73 -73
  7. package/dist/knowledge.d.ts +6 -0
  8. package/dist/knowledge.js +218 -0
  9. package/dist/setup.d.ts +22 -0
  10. package/dist/setup.js +313 -0
  11. package/dist/templates/agent-guidelines.js +185 -185
  12. package/dist/tools.js +65 -65
  13. package/dist/utils.js +11 -11
  14. package/docs/TOOLS.md +2053 -2053
  15. package/package.json +1 -1
  16. package/scripts/generate-docs.ts +212 -212
  17. package/scripts/version-bump.ts +203 -203
  18. package/src/api-client.test.ts +723 -723
  19. package/src/api-client.ts +2499 -2499
  20. package/src/cli.ts +27 -10
  21. package/src/handlers/__test-setup__.ts +236 -236
  22. package/src/handlers/__test-utils__.ts +87 -87
  23. package/src/handlers/blockers.test.ts +468 -468
  24. package/src/handlers/blockers.ts +163 -163
  25. package/src/handlers/bodies-of-work.test.ts +704 -704
  26. package/src/handlers/bodies-of-work.ts +526 -526
  27. package/src/handlers/connectors.test.ts +834 -834
  28. package/src/handlers/connectors.ts +229 -229
  29. package/src/handlers/cost.test.ts +462 -462
  30. package/src/handlers/cost.ts +285 -285
  31. package/src/handlers/decisions.test.ts +382 -382
  32. package/src/handlers/decisions.ts +153 -153
  33. package/src/handlers/deployment.test.ts +551 -551
  34. package/src/handlers/deployment.ts +541 -541
  35. package/src/handlers/discovery.test.ts +206 -206
  36. package/src/handlers/discovery.ts +390 -390
  37. package/src/handlers/fallback.test.ts +537 -537
  38. package/src/handlers/fallback.ts +194 -194
  39. package/src/handlers/file-checkouts.test.ts +750 -750
  40. package/src/handlers/file-checkouts.ts +185 -185
  41. package/src/handlers/findings.test.ts +633 -633
  42. package/src/handlers/findings.ts +239 -239
  43. package/src/handlers/git-issues.test.ts +631 -631
  44. package/src/handlers/git-issues.ts +136 -136
  45. package/src/handlers/ideas.test.ts +644 -644
  46. package/src/handlers/ideas.ts +207 -207
  47. package/src/handlers/index.ts +84 -84
  48. package/src/handlers/milestones.test.ts +475 -475
  49. package/src/handlers/milestones.ts +180 -180
  50. package/src/handlers/organizations.test.ts +826 -826
  51. package/src/handlers/organizations.ts +315 -315
  52. package/src/handlers/progress.test.ts +269 -269
  53. package/src/handlers/progress.ts +77 -77
  54. package/src/handlers/project.test.ts +546 -546
  55. package/src/handlers/project.ts +239 -239
  56. package/src/handlers/requests.test.ts +303 -303
  57. package/src/handlers/requests.ts +99 -99
  58. package/src/handlers/roles.test.ts +303 -303
  59. package/src/handlers/roles.ts +226 -226
  60. package/src/handlers/session.test.ts +875 -875
  61. package/src/handlers/session.ts +738 -738
  62. package/src/handlers/sprints.test.ts +732 -732
  63. package/src/handlers/sprints.ts +537 -537
  64. package/src/handlers/tasks.test.ts +907 -907
  65. package/src/handlers/tasks.ts +945 -945
  66. package/src/handlers/tool-categories.test.ts +66 -66
  67. package/src/handlers/tool-docs.ts +1096 -1096
  68. package/src/handlers/types.test.ts +259 -259
  69. package/src/handlers/types.ts +175 -175
  70. package/src/handlers/validation.test.ts +582 -582
  71. package/src/handlers/validation.ts +97 -97
  72. package/src/index.ts +792 -792
  73. package/src/setup.test.ts +231 -0
  74. package/src/setup.ts +370 -0
  75. package/src/templates/agent-guidelines.ts +210 -210
  76. package/src/token-tracking.test.ts +453 -453
  77. package/src/token-tracking.ts +164 -164
  78. package/src/tools.ts +3562 -3562
  79. package/src/utils.test.ts +683 -683
  80. package/src/utils.ts +436 -436
  81. package/src/validators.test.ts +223 -223
  82. package/src/validators.ts +249 -249
  83. package/tsconfig.json +16 -16
  84. package/vitest.config.ts +14 -14
@@ -1,229 +1,229 @@
1
- /**
2
- * Connectors Handlers
3
- *
4
- * Handles external integration management:
5
- * - get_connectors
6
- * - get_connector
7
- * - add_connector
8
- * - update_connector
9
- * - delete_connector
10
- * - test_connector
11
- * - get_connector_events
12
- */
13
-
14
- import type { Handler, HandlerRegistry } from './types.js';
15
- import { success, error } from './types.js';
16
- import {
17
- parseArgs,
18
- uuidValidator,
19
- createEnumValidator,
20
- } from '../validators.js';
21
- import { getApiClient } from '../api-client.js';
22
-
23
- // Valid connector types
24
- const VALID_CONNECTOR_TYPES = ['webhook', 'slack', 'discord', 'github', 'custom'] as const;
25
-
26
- // Valid connector statuses
27
- const VALID_CONNECTOR_STATUSES = ['active', 'disabled'] as const;
28
-
29
- // Valid event statuses
30
- const VALID_EVENT_STATUSES = ['pending', 'sent', 'failed', 'retrying'] as const;
31
-
32
- // Argument schemas for type-safe parsing
33
- const getConnectorsSchema = {
34
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
35
- type: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_TYPES) },
36
- status: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_STATUSES) },
37
- limit: { type: 'number' as const, default: 50 },
38
- offset: { type: 'number' as const, default: 0 },
39
- };
40
-
41
- const getConnectorSchema = {
42
- connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
43
- };
44
-
45
- const addConnectorSchema = {
46
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
47
- name: { type: 'string' as const, required: true as const },
48
- type: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_CONNECTOR_TYPES) },
49
- description: { type: 'string' as const },
50
- config: { type: 'object' as const },
51
- events: { type: 'object' as const },
52
- };
53
-
54
- const updateConnectorSchema = {
55
- connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
56
- name: { type: 'string' as const },
57
- description: { type: 'string' as const },
58
- config: { type: 'object' as const },
59
- events: { type: 'object' as const },
60
- status: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_STATUSES) },
61
- };
62
-
63
- const deleteConnectorSchema = {
64
- connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
65
- };
66
-
67
- const testConnectorSchema = {
68
- connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
69
- };
70
-
71
- const getConnectorEventsSchema = {
72
- connector_id: { type: 'string' as const, validate: uuidValidator },
73
- project_id: { type: 'string' as const, validate: uuidValidator },
74
- status: { type: 'string' as const, validate: createEnumValidator(VALID_EVENT_STATUSES) },
75
- limit: { type: 'number' as const, default: 50 },
76
- offset: { type: 'number' as const, default: 0 },
77
- };
78
-
79
- /**
80
- * Get all connectors for a project
81
- */
82
- export const getConnectors: Handler = async (args, _ctx) => {
83
- const { project_id, type, status, limit, offset } = parseArgs(args, getConnectorsSchema);
84
-
85
- const apiClient = getApiClient();
86
- const response = await apiClient.getConnectors(project_id, {
87
- type,
88
- status,
89
- limit: Math.min(limit ?? 50, 50),
90
- offset
91
- });
92
-
93
- if (!response.ok) {
94
- return error(response.error || 'Failed to fetch connectors');
95
- }
96
-
97
- return success(response.data);
98
- };
99
-
100
- /**
101
- * Get a single connector with full details
102
- */
103
- export const getConnector: Handler = async (args, _ctx) => {
104
- const { connector_id } = parseArgs(args, getConnectorSchema);
105
-
106
- const apiClient = getApiClient();
107
- const response = await apiClient.getConnector(connector_id);
108
-
109
- if (!response.ok) {
110
- return error(response.error || 'Failed to fetch connector');
111
- }
112
-
113
- return success(response.data);
114
- };
115
-
116
- /**
117
- * Add a new connector
118
- */
119
- export const addConnector: Handler = async (args, _ctx) => {
120
- const { project_id, name, type, description, config, events } = parseArgs(args, addConnectorSchema);
121
-
122
- const apiClient = getApiClient();
123
- const response = await apiClient.addConnector(project_id, {
124
- name,
125
- type,
126
- description,
127
- config: config as Record<string, unknown> | undefined,
128
- events: events as Record<string, boolean> | undefined
129
- });
130
-
131
- if (!response.ok) {
132
- return error(response.error || 'Failed to create connector');
133
- }
134
-
135
- return success(response.data);
136
- };
137
-
138
- /**
139
- * Update a connector
140
- */
141
- export const updateConnector: Handler = async (args, _ctx) => {
142
- const { connector_id, name, description, config, events, status } = parseArgs(args, updateConnectorSchema);
143
-
144
- const apiClient = getApiClient();
145
- const response = await apiClient.updateConnector(connector_id, {
146
- name,
147
- description,
148
- config: config as Record<string, unknown> | undefined,
149
- events: events as Record<string, boolean> | undefined,
150
- status
151
- });
152
-
153
- if (!response.ok) {
154
- return error(response.error || 'Failed to update connector');
155
- }
156
-
157
- return success(response.data);
158
- };
159
-
160
- /**
161
- * Delete a connector
162
- */
163
- export const deleteConnector: Handler = async (args, _ctx) => {
164
- const { connector_id } = parseArgs(args, deleteConnectorSchema);
165
-
166
- const apiClient = getApiClient();
167
- const response = await apiClient.deleteConnector(connector_id);
168
-
169
- if (!response.ok) {
170
- return error(response.error || 'Failed to delete connector');
171
- }
172
-
173
- return success(response.data);
174
- };
175
-
176
- /**
177
- * Test a connector by sending a test event
178
- */
179
- export const testConnector: Handler = async (args, _ctx) => {
180
- const { connector_id } = parseArgs(args, testConnectorSchema);
181
-
182
- const apiClient = getApiClient();
183
- const response = await apiClient.testConnector(connector_id);
184
-
185
- if (!response.ok) {
186
- return error(response.error || 'Failed to test connector');
187
- }
188
-
189
- return success(response.data);
190
- };
191
-
192
- /**
193
- * Get connector event history
194
- */
195
- export const getConnectorEvents: Handler = async (args, _ctx) => {
196
- const { connector_id, project_id, status, limit, offset } = parseArgs(args, getConnectorEventsSchema);
197
-
198
- if (!connector_id && !project_id) {
199
- return error('Either connector_id or project_id is required');
200
- }
201
-
202
- const apiClient = getApiClient();
203
- const response = await apiClient.getConnectorEvents({
204
- connector_id,
205
- project_id,
206
- status,
207
- limit: Math.min(limit ?? 50, 50),
208
- offset
209
- });
210
-
211
- if (!response.ok) {
212
- return error(response.error || 'Failed to fetch connector events');
213
- }
214
-
215
- return success(response.data);
216
- };
217
-
218
- /**
219
- * Connectors handlers registry
220
- */
221
- export const connectorHandlers: HandlerRegistry = {
222
- get_connectors: getConnectors,
223
- get_connector: getConnector,
224
- add_connector: addConnector,
225
- update_connector: updateConnector,
226
- delete_connector: deleteConnector,
227
- test_connector: testConnector,
228
- get_connector_events: getConnectorEvents,
229
- };
1
+ /**
2
+ * Connectors Handlers
3
+ *
4
+ * Handles external integration management:
5
+ * - get_connectors
6
+ * - get_connector
7
+ * - add_connector
8
+ * - update_connector
9
+ * - delete_connector
10
+ * - test_connector
11
+ * - get_connector_events
12
+ */
13
+
14
+ import type { Handler, HandlerRegistry } from './types.js';
15
+ import { success, error } from './types.js';
16
+ import {
17
+ parseArgs,
18
+ uuidValidator,
19
+ createEnumValidator,
20
+ } from '../validators.js';
21
+ import { getApiClient } from '../api-client.js';
22
+
23
+ // Valid connector types
24
+ const VALID_CONNECTOR_TYPES = ['webhook', 'slack', 'discord', 'github', 'custom'] as const;
25
+
26
+ // Valid connector statuses
27
+ const VALID_CONNECTOR_STATUSES = ['active', 'disabled'] as const;
28
+
29
+ // Valid event statuses
30
+ const VALID_EVENT_STATUSES = ['pending', 'sent', 'failed', 'retrying'] as const;
31
+
32
+ // Argument schemas for type-safe parsing
33
+ const getConnectorsSchema = {
34
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
35
+ type: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_TYPES) },
36
+ status: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_STATUSES) },
37
+ limit: { type: 'number' as const, default: 50 },
38
+ offset: { type: 'number' as const, default: 0 },
39
+ };
40
+
41
+ const getConnectorSchema = {
42
+ connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
43
+ };
44
+
45
+ const addConnectorSchema = {
46
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
47
+ name: { type: 'string' as const, required: true as const },
48
+ type: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_CONNECTOR_TYPES) },
49
+ description: { type: 'string' as const },
50
+ config: { type: 'object' as const },
51
+ events: { type: 'object' as const },
52
+ };
53
+
54
+ const updateConnectorSchema = {
55
+ connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
56
+ name: { type: 'string' as const },
57
+ description: { type: 'string' as const },
58
+ config: { type: 'object' as const },
59
+ events: { type: 'object' as const },
60
+ status: { type: 'string' as const, validate: createEnumValidator(VALID_CONNECTOR_STATUSES) },
61
+ };
62
+
63
+ const deleteConnectorSchema = {
64
+ connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
65
+ };
66
+
67
+ const testConnectorSchema = {
68
+ connector_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
69
+ };
70
+
71
+ const getConnectorEventsSchema = {
72
+ connector_id: { type: 'string' as const, validate: uuidValidator },
73
+ project_id: { type: 'string' as const, validate: uuidValidator },
74
+ status: { type: 'string' as const, validate: createEnumValidator(VALID_EVENT_STATUSES) },
75
+ limit: { type: 'number' as const, default: 50 },
76
+ offset: { type: 'number' as const, default: 0 },
77
+ };
78
+
79
+ /**
80
+ * Get all connectors for a project
81
+ */
82
+ export const getConnectors: Handler = async (args, _ctx) => {
83
+ const { project_id, type, status, limit, offset } = parseArgs(args, getConnectorsSchema);
84
+
85
+ const apiClient = getApiClient();
86
+ const response = await apiClient.getConnectors(project_id, {
87
+ type,
88
+ status,
89
+ limit: Math.min(limit ?? 50, 50),
90
+ offset
91
+ });
92
+
93
+ if (!response.ok) {
94
+ return error(response.error || 'Failed to fetch connectors');
95
+ }
96
+
97
+ return success(response.data);
98
+ };
99
+
100
+ /**
101
+ * Get a single connector with full details
102
+ */
103
+ export const getConnector: Handler = async (args, _ctx) => {
104
+ const { connector_id } = parseArgs(args, getConnectorSchema);
105
+
106
+ const apiClient = getApiClient();
107
+ const response = await apiClient.getConnector(connector_id);
108
+
109
+ if (!response.ok) {
110
+ return error(response.error || 'Failed to fetch connector');
111
+ }
112
+
113
+ return success(response.data);
114
+ };
115
+
116
+ /**
117
+ * Add a new connector
118
+ */
119
+ export const addConnector: Handler = async (args, _ctx) => {
120
+ const { project_id, name, type, description, config, events } = parseArgs(args, addConnectorSchema);
121
+
122
+ const apiClient = getApiClient();
123
+ const response = await apiClient.addConnector(project_id, {
124
+ name,
125
+ type,
126
+ description,
127
+ config: config as Record<string, unknown> | undefined,
128
+ events: events as Record<string, boolean> | undefined
129
+ });
130
+
131
+ if (!response.ok) {
132
+ return error(response.error || 'Failed to create connector');
133
+ }
134
+
135
+ return success(response.data);
136
+ };
137
+
138
+ /**
139
+ * Update a connector
140
+ */
141
+ export const updateConnector: Handler = async (args, _ctx) => {
142
+ const { connector_id, name, description, config, events, status } = parseArgs(args, updateConnectorSchema);
143
+
144
+ const apiClient = getApiClient();
145
+ const response = await apiClient.updateConnector(connector_id, {
146
+ name,
147
+ description,
148
+ config: config as Record<string, unknown> | undefined,
149
+ events: events as Record<string, boolean> | undefined,
150
+ status
151
+ });
152
+
153
+ if (!response.ok) {
154
+ return error(response.error || 'Failed to update connector');
155
+ }
156
+
157
+ return success(response.data);
158
+ };
159
+
160
+ /**
161
+ * Delete a connector
162
+ */
163
+ export const deleteConnector: Handler = async (args, _ctx) => {
164
+ const { connector_id } = parseArgs(args, deleteConnectorSchema);
165
+
166
+ const apiClient = getApiClient();
167
+ const response = await apiClient.deleteConnector(connector_id);
168
+
169
+ if (!response.ok) {
170
+ return error(response.error || 'Failed to delete connector');
171
+ }
172
+
173
+ return success(response.data);
174
+ };
175
+
176
+ /**
177
+ * Test a connector by sending a test event
178
+ */
179
+ export const testConnector: Handler = async (args, _ctx) => {
180
+ const { connector_id } = parseArgs(args, testConnectorSchema);
181
+
182
+ const apiClient = getApiClient();
183
+ const response = await apiClient.testConnector(connector_id);
184
+
185
+ if (!response.ok) {
186
+ return error(response.error || 'Failed to test connector');
187
+ }
188
+
189
+ return success(response.data);
190
+ };
191
+
192
+ /**
193
+ * Get connector event history
194
+ */
195
+ export const getConnectorEvents: Handler = async (args, _ctx) => {
196
+ const { connector_id, project_id, status, limit, offset } = parseArgs(args, getConnectorEventsSchema);
197
+
198
+ if (!connector_id && !project_id) {
199
+ return error('Either connector_id or project_id is required');
200
+ }
201
+
202
+ const apiClient = getApiClient();
203
+ const response = await apiClient.getConnectorEvents({
204
+ connector_id,
205
+ project_id,
206
+ status,
207
+ limit: Math.min(limit ?? 50, 50),
208
+ offset
209
+ });
210
+
211
+ if (!response.ok) {
212
+ return error(response.error || 'Failed to fetch connector events');
213
+ }
214
+
215
+ return success(response.data);
216
+ };
217
+
218
+ /**
219
+ * Connectors handlers registry
220
+ */
221
+ export const connectorHandlers: HandlerRegistry = {
222
+ get_connectors: getConnectors,
223
+ get_connector: getConnector,
224
+ add_connector: addConnector,
225
+ update_connector: updateConnector,
226
+ delete_connector: deleteConnector,
227
+ test_connector: testConnector,
228
+ get_connector_events: getConnectorEvents,
229
+ };