@vibescope/mcp-server 0.2.5 → 0.2.7

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 (82) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/cli.js +26 -26
  4. package/dist/handlers/tool-docs.js +828 -828
  5. package/dist/index.js +73 -73
  6. package/dist/templates/agent-guidelines.js +185 -185
  7. package/dist/token-tracking.js +4 -2
  8. package/dist/tools.js +65 -65
  9. package/dist/utils.js +11 -11
  10. package/docs/TOOLS.md +2053 -2053
  11. package/package.json +3 -2
  12. package/scripts/generate-docs.ts +212 -212
  13. package/scripts/version-bump.ts +203 -203
  14. package/src/api-client.test.ts +723 -723
  15. package/src/api-client.ts +2499 -2499
  16. package/src/cli.ts +212 -212
  17. package/src/handlers/__test-setup__.ts +236 -236
  18. package/src/handlers/__test-utils__.ts +87 -87
  19. package/src/handlers/blockers.test.ts +468 -468
  20. package/src/handlers/blockers.ts +163 -163
  21. package/src/handlers/bodies-of-work.test.ts +704 -704
  22. package/src/handlers/bodies-of-work.ts +526 -526
  23. package/src/handlers/connectors.test.ts +834 -834
  24. package/src/handlers/connectors.ts +229 -229
  25. package/src/handlers/cost.test.ts +462 -462
  26. package/src/handlers/cost.ts +285 -285
  27. package/src/handlers/decisions.test.ts +382 -382
  28. package/src/handlers/decisions.ts +153 -153
  29. package/src/handlers/deployment.test.ts +551 -551
  30. package/src/handlers/deployment.ts +541 -541
  31. package/src/handlers/discovery.test.ts +206 -206
  32. package/src/handlers/discovery.ts +390 -390
  33. package/src/handlers/fallback.test.ts +537 -537
  34. package/src/handlers/fallback.ts +194 -194
  35. package/src/handlers/file-checkouts.test.ts +750 -750
  36. package/src/handlers/file-checkouts.ts +185 -185
  37. package/src/handlers/findings.test.ts +633 -633
  38. package/src/handlers/findings.ts +239 -239
  39. package/src/handlers/git-issues.test.ts +631 -631
  40. package/src/handlers/git-issues.ts +136 -136
  41. package/src/handlers/ideas.test.ts +644 -644
  42. package/src/handlers/ideas.ts +207 -207
  43. package/src/handlers/index.ts +84 -84
  44. package/src/handlers/milestones.test.ts +475 -475
  45. package/src/handlers/milestones.ts +180 -180
  46. package/src/handlers/organizations.test.ts +826 -826
  47. package/src/handlers/organizations.ts +315 -315
  48. package/src/handlers/progress.test.ts +269 -269
  49. package/src/handlers/progress.ts +77 -77
  50. package/src/handlers/project.test.ts +546 -546
  51. package/src/handlers/project.ts +239 -239
  52. package/src/handlers/requests.test.ts +303 -303
  53. package/src/handlers/requests.ts +99 -99
  54. package/src/handlers/roles.test.ts +303 -303
  55. package/src/handlers/roles.ts +226 -226
  56. package/src/handlers/session.test.ts +875 -875
  57. package/src/handlers/session.ts +738 -738
  58. package/src/handlers/sprints.test.ts +732 -732
  59. package/src/handlers/sprints.ts +537 -537
  60. package/src/handlers/tasks.test.ts +907 -907
  61. package/src/handlers/tasks.ts +945 -945
  62. package/src/handlers/tool-categories.test.ts +66 -66
  63. package/src/handlers/tool-docs.ts +1096 -1096
  64. package/src/handlers/types.test.ts +259 -259
  65. package/src/handlers/types.ts +175 -175
  66. package/src/handlers/validation.test.ts +582 -582
  67. package/src/handlers/validation.ts +97 -97
  68. package/src/index.ts +792 -792
  69. package/src/setup.test.ts +233 -231
  70. package/src/setup.ts +370 -370
  71. package/src/templates/agent-guidelines.ts +210 -210
  72. package/src/token-tracking.test.ts +463 -453
  73. package/src/token-tracking.ts +166 -164
  74. package/src/tools.ts +3562 -3562
  75. package/src/utils.test.ts +683 -683
  76. package/src/utils.ts +436 -436
  77. package/src/validators.test.ts +223 -223
  78. package/src/validators.ts +249 -249
  79. package/tsconfig.json +16 -16
  80. package/vitest.config.ts +14 -14
  81. package/dist/knowledge.d.ts +0 -6
  82. package/dist/knowledge.js +0 -218
@@ -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
+ };