@vibescope/mcp-server 0.0.1 → 0.2.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 (173) hide show
  1. package/README.md +113 -98
  2. package/dist/api-client.d.ts +1169 -0
  3. package/dist/api-client.js +713 -0
  4. package/dist/cli.d.ts +1 -6
  5. package/dist/cli.js +39 -240
  6. package/dist/config/tool-categories.d.ts +31 -0
  7. package/dist/config/tool-categories.js +253 -0
  8. package/dist/handlers/blockers.js +57 -58
  9. package/dist/handlers/bodies-of-work.d.ts +2 -0
  10. package/dist/handlers/bodies-of-work.js +108 -477
  11. package/dist/handlers/cost.d.ts +1 -0
  12. package/dist/handlers/cost.js +35 -113
  13. package/dist/handlers/decisions.d.ts +2 -0
  14. package/dist/handlers/decisions.js +28 -27
  15. package/dist/handlers/deployment.js +113 -828
  16. package/dist/handlers/discovery.d.ts +3 -0
  17. package/dist/handlers/discovery.js +26 -627
  18. package/dist/handlers/fallback.d.ts +2 -0
  19. package/dist/handlers/fallback.js +56 -142
  20. package/dist/handlers/findings.d.ts +8 -1
  21. package/dist/handlers/findings.js +65 -68
  22. package/dist/handlers/git-issues.d.ts +9 -13
  23. package/dist/handlers/git-issues.js +80 -225
  24. package/dist/handlers/ideas.d.ts +3 -0
  25. package/dist/handlers/ideas.js +53 -134
  26. package/dist/handlers/index.d.ts +2 -0
  27. package/dist/handlers/index.js +6 -0
  28. package/dist/handlers/milestones.d.ts +2 -0
  29. package/dist/handlers/milestones.js +51 -98
  30. package/dist/handlers/organizations.js +79 -275
  31. package/dist/handlers/progress.d.ts +2 -0
  32. package/dist/handlers/progress.js +25 -123
  33. package/dist/handlers/project.js +42 -221
  34. package/dist/handlers/requests.d.ts +2 -0
  35. package/dist/handlers/requests.js +23 -83
  36. package/dist/handlers/session.js +119 -590
  37. package/dist/handlers/sprints.d.ts +32 -0
  38. package/dist/handlers/sprints.js +275 -0
  39. package/dist/handlers/tasks.d.ts +7 -10
  40. package/dist/handlers/tasks.js +245 -894
  41. package/dist/handlers/tool-docs.d.ts +9 -0
  42. package/dist/handlers/tool-docs.js +904 -0
  43. package/dist/handlers/types.d.ts +11 -3
  44. package/dist/handlers/validation.d.ts +1 -1
  45. package/dist/handlers/validation.js +38 -153
  46. package/dist/index.js +493 -162
  47. package/dist/knowledge.js +106 -9
  48. package/dist/tools.js +34 -4
  49. package/dist/validators.d.ts +21 -0
  50. package/dist/validators.js +91 -0
  51. package/package.json +2 -3
  52. package/src/api-client.ts +1822 -0
  53. package/src/cli.test.ts +128 -302
  54. package/src/cli.ts +41 -285
  55. package/src/handlers/__test-setup__.ts +215 -0
  56. package/src/handlers/__test-utils__.ts +4 -134
  57. package/src/handlers/blockers.test.ts +114 -124
  58. package/src/handlers/blockers.ts +68 -70
  59. package/src/handlers/bodies-of-work.test.ts +236 -831
  60. package/src/handlers/bodies-of-work.ts +210 -525
  61. package/src/handlers/cost.test.ts +149 -113
  62. package/src/handlers/cost.ts +44 -132
  63. package/src/handlers/decisions.test.ts +111 -209
  64. package/src/handlers/decisions.ts +35 -27
  65. package/src/handlers/deployment.test.ts +193 -239
  66. package/src/handlers/deployment.ts +143 -896
  67. package/src/handlers/discovery.test.ts +20 -67
  68. package/src/handlers/discovery.ts +29 -714
  69. package/src/handlers/fallback.test.ts +206 -361
  70. package/src/handlers/fallback.ts +81 -156
  71. package/src/handlers/findings.test.ts +229 -320
  72. package/src/handlers/findings.ts +76 -64
  73. package/src/handlers/git-issues.test.ts +623 -0
  74. package/src/handlers/git-issues.ts +174 -0
  75. package/src/handlers/ideas.test.ts +229 -343
  76. package/src/handlers/ideas.ts +69 -143
  77. package/src/handlers/index.ts +6 -0
  78. package/src/handlers/milestones.test.ts +167 -281
  79. package/src/handlers/milestones.ts +54 -93
  80. package/src/handlers/organizations.test.ts +275 -467
  81. package/src/handlers/organizations.ts +84 -294
  82. package/src/handlers/progress.test.ts +112 -218
  83. package/src/handlers/progress.ts +29 -142
  84. package/src/handlers/project.test.ts +203 -226
  85. package/src/handlers/project.ts +48 -238
  86. package/src/handlers/requests.test.ts +74 -342
  87. package/src/handlers/requests.ts +25 -83
  88. package/src/handlers/session.test.ts +276 -206
  89. package/src/handlers/session.ts +136 -662
  90. package/src/handlers/sprints.test.ts +711 -0
  91. package/src/handlers/sprints.ts +510 -0
  92. package/src/handlers/tasks.test.ts +669 -353
  93. package/src/handlers/tasks.ts +263 -1015
  94. package/src/handlers/tool-docs.ts +1024 -0
  95. package/src/handlers/types.ts +12 -4
  96. package/src/handlers/validation.test.ts +237 -568
  97. package/src/handlers/validation.ts +43 -167
  98. package/src/index.ts +493 -186
  99. package/src/tools.ts +2532 -0
  100. package/src/validators.test.ts +223 -223
  101. package/src/validators.ts +127 -0
  102. package/tsconfig.json +1 -1
  103. package/vitest.config.ts +14 -13
  104. package/dist/cli.test.d.ts +0 -1
  105. package/dist/cli.test.js +0 -367
  106. package/dist/handlers/__test-utils__.d.ts +0 -72
  107. package/dist/handlers/__test-utils__.js +0 -176
  108. package/dist/handlers/checkouts.d.ts +0 -37
  109. package/dist/handlers/checkouts.js +0 -377
  110. package/dist/handlers/knowledge-query.d.ts +0 -22
  111. package/dist/handlers/knowledge-query.js +0 -253
  112. package/dist/handlers/knowledge.d.ts +0 -12
  113. package/dist/handlers/knowledge.js +0 -108
  114. package/dist/handlers/roles.d.ts +0 -30
  115. package/dist/handlers/roles.js +0 -281
  116. package/dist/handlers/tasks.test.d.ts +0 -1
  117. package/dist/handlers/tasks.test.js +0 -431
  118. package/dist/utils.test.d.ts +0 -1
  119. package/dist/utils.test.js +0 -532
  120. package/dist/validators.test.d.ts +0 -1
  121. package/dist/validators.test.js +0 -176
  122. package/src/knowledge.ts +0 -132
  123. package/src/tmpclaude-0078-cwd +0 -1
  124. package/src/tmpclaude-0ee1-cwd +0 -1
  125. package/src/tmpclaude-2dd5-cwd +0 -1
  126. package/src/tmpclaude-344c-cwd +0 -1
  127. package/src/tmpclaude-3860-cwd +0 -1
  128. package/src/tmpclaude-4b63-cwd +0 -1
  129. package/src/tmpclaude-5c73-cwd +0 -1
  130. package/src/tmpclaude-5ee3-cwd +0 -1
  131. package/src/tmpclaude-6795-cwd +0 -1
  132. package/src/tmpclaude-709e-cwd +0 -1
  133. package/src/tmpclaude-9839-cwd +0 -1
  134. package/src/tmpclaude-d829-cwd +0 -1
  135. package/src/tmpclaude-e072-cwd +0 -1
  136. package/src/tmpclaude-f6ee-cwd +0 -1
  137. package/tmpclaude-0439-cwd +0 -1
  138. package/tmpclaude-132f-cwd +0 -1
  139. package/tmpclaude-15bb-cwd +0 -1
  140. package/tmpclaude-165a-cwd +0 -1
  141. package/tmpclaude-1ba9-cwd +0 -1
  142. package/tmpclaude-21a3-cwd +0 -1
  143. package/tmpclaude-2a38-cwd +0 -1
  144. package/tmpclaude-2adf-cwd +0 -1
  145. package/tmpclaude-2f56-cwd +0 -1
  146. package/tmpclaude-3626-cwd +0 -1
  147. package/tmpclaude-3727-cwd +0 -1
  148. package/tmpclaude-40bc-cwd +0 -1
  149. package/tmpclaude-436f-cwd +0 -1
  150. package/tmpclaude-4783-cwd +0 -1
  151. package/tmpclaude-4b6d-cwd +0 -1
  152. package/tmpclaude-4ba4-cwd +0 -1
  153. package/tmpclaude-51e6-cwd +0 -1
  154. package/tmpclaude-5ecf-cwd +0 -1
  155. package/tmpclaude-6f97-cwd +0 -1
  156. package/tmpclaude-7fb2-cwd +0 -1
  157. package/tmpclaude-825c-cwd +0 -1
  158. package/tmpclaude-8baf-cwd +0 -1
  159. package/tmpclaude-8d9f-cwd +0 -1
  160. package/tmpclaude-975c-cwd +0 -1
  161. package/tmpclaude-9983-cwd +0 -1
  162. package/tmpclaude-a045-cwd +0 -1
  163. package/tmpclaude-ac4a-cwd +0 -1
  164. package/tmpclaude-b593-cwd +0 -1
  165. package/tmpclaude-b891-cwd +0 -1
  166. package/tmpclaude-c032-cwd +0 -1
  167. package/tmpclaude-cf43-cwd +0 -1
  168. package/tmpclaude-d040-cwd +0 -1
  169. package/tmpclaude-dcdd-cwd +0 -1
  170. package/tmpclaude-dcee-cwd +0 -1
  171. package/tmpclaude-e16b-cwd +0 -1
  172. package/tmpclaude-ecd2-cwd +0 -1
  173. package/tmpclaude-f48d-cwd +0 -1
@@ -9,94 +9,92 @@
9
9
  */
10
10
 
11
11
  import type { Handler, HandlerRegistry } from './types.js';
12
- import { validateRequired, validateUUID } from '../validators.js';
12
+ import {
13
+ parseArgs,
14
+ uuidValidator,
15
+ createEnumValidator,
16
+ VALID_BLOCKER_STATUSES,
17
+ } from '../validators.js';
18
+ import { getApiClient } from '../api-client.js';
19
+
20
+ // Argument schemas for type-safe parsing
21
+ const addBlockerSchema = {
22
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
23
+ description: { type: 'string' as const, required: true as const },
24
+ };
13
25
 
14
- export const addBlocker: Handler = async (args, ctx) => {
15
- const { project_id, description } = args as {
16
- project_id: string;
17
- description: string;
18
- };
19
-
20
- validateRequired(project_id, 'project_id');
21
- validateUUID(project_id, 'project_id');
22
- validateRequired(description, 'description');
23
-
24
- const { supabase, session } = ctx;
25
-
26
- const { data, error } = await supabase
27
- .from('blockers')
28
- .insert({
29
- project_id,
30
- description,
31
- created_by: 'agent',
32
- created_by_session_id: session.currentSessionId,
33
- })
34
- .select('id')
35
- .single();
36
-
37
- if (error) throw new Error(`Failed to add blocker: ${error.message}`);
38
-
39
- return { result: { success: true, blocker_id: data.id } };
26
+ const resolveBlockerSchema = {
27
+ blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
28
+ resolution_note: { type: 'string' as const },
40
29
  };
41
30
 
42
- export const resolveBlocker: Handler = async (args, ctx) => {
43
- const { blocker_id, resolution_note } = args as {
44
- blocker_id: string;
45
- resolution_note?: string;
46
- };
31
+ const getBlockersSchema = {
32
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
33
+ status: { type: 'string' as const, default: 'open', validate: createEnumValidator(VALID_BLOCKER_STATUSES) },
34
+ limit: { type: 'number' as const, default: 50 },
35
+ offset: { type: 'number' as const, default: 0 },
36
+ search_query: { type: 'string' as const },
37
+ };
47
38
 
48
- validateRequired(blocker_id, 'blocker_id');
49
- validateUUID(blocker_id, 'blocker_id');
39
+ const deleteBlockerSchema = {
40
+ blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
41
+ };
50
42
 
51
- const { error } = await ctx.supabase
52
- .from('blockers')
53
- .update({
54
- status: 'resolved',
55
- resolved_at: new Date().toISOString(),
56
- resolution_note: resolution_note || null,
57
- })
58
- .eq('id', blocker_id);
43
+ export const addBlocker: Handler = async (args, ctx) => {
44
+ const { project_id, description } = parseArgs(args, addBlockerSchema);
59
45
 
60
- if (error) throw new Error(`Failed to resolve blocker: ${error.message}`);
46
+ const apiClient = getApiClient();
47
+ const response = await apiClient.addBlocker(project_id, description, ctx.session.currentSessionId || undefined);
61
48
 
62
- return { result: { success: true, blocker_id } };
63
- };
49
+ if (!response.ok) {
50
+ throw new Error(response.error || 'Failed to add blocker');
51
+ }
64
52
 
65
- export const getBlockers: Handler = async (args, ctx) => {
66
- const { project_id, status = 'open' } = args as {
67
- project_id: string;
68
- status?: string;
69
- };
53
+ return { result: response.data };
54
+ };
70
55
 
71
- validateRequired(project_id, 'project_id');
72
- validateUUID(project_id, 'project_id');
56
+ export const resolveBlocker: Handler = async (args, _ctx) => {
57
+ const { blocker_id, resolution_note } = parseArgs(args, resolveBlockerSchema);
73
58
 
74
- const { data, error } = await ctx.supabase
75
- .from('blockers')
76
- .select('id, description, status, created_at, resolved_at, resolution_note')
77
- .eq('project_id', project_id)
78
- .eq('status', status)
79
- .order('created_at', { ascending: false });
59
+ const apiClient = getApiClient();
60
+ const response = await apiClient.resolveBlocker(blocker_id, resolution_note);
80
61
 
81
- if (error) throw new Error(`Failed to fetch blockers: ${error.message}`);
62
+ if (!response.ok) {
63
+ throw new Error(response.error || 'Failed to resolve blocker');
64
+ }
82
65
 
83
- return { result: { blockers: data || [] } };
66
+ return { result: response.data };
84
67
  };
85
68
 
86
- export const deleteBlocker: Handler = async (args, ctx) => {
87
- const { blocker_id } = args as { blocker_id: string };
69
+ export const getBlockers: Handler = async (args, _ctx) => {
70
+ const { project_id, status, limit, offset, search_query } = parseArgs(args, getBlockersSchema);
71
+
72
+ const apiClient = getApiClient();
73
+ const response = await apiClient.getBlockers(project_id, {
74
+ status,
75
+ limit,
76
+ offset,
77
+ search_query
78
+ });
79
+
80
+ if (!response.ok) {
81
+ throw new Error(response.error || 'Failed to fetch blockers');
82
+ }
83
+
84
+ return { result: response.data };
85
+ };
88
86
 
89
- validateRequired(blocker_id, 'blocker_id');
90
- validateUUID(blocker_id, 'blocker_id');
87
+ export const deleteBlocker: Handler = async (args, _ctx) => {
88
+ const { blocker_id } = parseArgs(args, deleteBlockerSchema);
91
89
 
92
- const { error } = await ctx.supabase
93
- .from('blockers')
94
- .delete()
95
- .eq('id', blocker_id);
90
+ const apiClient = getApiClient();
91
+ const response = await apiClient.deleteBlocker(blocker_id);
96
92
 
97
- if (error) throw new Error(`Failed to delete blocker: ${error.message}`);
93
+ if (!response.ok) {
94
+ throw new Error(response.error || 'Failed to delete blocker');
95
+ }
98
96
 
99
- return { result: { success: true } };
97
+ return { result: response.data };
100
98
  };
101
99
 
102
100
  /**