@vibescope/mcp-server 0.0.1 → 0.1.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 (170) hide show
  1. package/README.md +113 -98
  2. package/dist/api-client.d.ts +1114 -0
  3. package/dist/api-client.js +698 -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 +106 -476
  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 +112 -828
  16. package/dist/handlers/discovery.js +31 -0
  17. package/dist/handlers/fallback.d.ts +2 -0
  18. package/dist/handlers/fallback.js +39 -134
  19. package/dist/handlers/findings.js +43 -67
  20. package/dist/handlers/git-issues.d.ts +9 -13
  21. package/dist/handlers/git-issues.js +80 -225
  22. package/dist/handlers/ideas.d.ts +3 -0
  23. package/dist/handlers/ideas.js +53 -134
  24. package/dist/handlers/index.d.ts +2 -0
  25. package/dist/handlers/index.js +6 -0
  26. package/dist/handlers/milestones.d.ts +2 -0
  27. package/dist/handlers/milestones.js +51 -98
  28. package/dist/handlers/organizations.js +79 -275
  29. package/dist/handlers/progress.d.ts +2 -0
  30. package/dist/handlers/progress.js +25 -123
  31. package/dist/handlers/project.js +42 -221
  32. package/dist/handlers/requests.d.ts +2 -0
  33. package/dist/handlers/requests.js +23 -83
  34. package/dist/handlers/session.js +99 -585
  35. package/dist/handlers/sprints.d.ts +32 -0
  36. package/dist/handlers/sprints.js +274 -0
  37. package/dist/handlers/tasks.d.ts +7 -10
  38. package/dist/handlers/tasks.js +230 -900
  39. package/dist/handlers/tool-docs.d.ts +8 -0
  40. package/dist/handlers/tool-docs.js +657 -0
  41. package/dist/handlers/types.d.ts +11 -3
  42. package/dist/handlers/validation.d.ts +1 -1
  43. package/dist/handlers/validation.js +26 -153
  44. package/dist/index.js +473 -160
  45. package/dist/knowledge.js +106 -9
  46. package/dist/tools.js +4 -0
  47. package/dist/validators.d.ts +21 -0
  48. package/dist/validators.js +91 -0
  49. package/package.json +2 -3
  50. package/src/api-client.ts +1752 -0
  51. package/src/cli.test.ts +128 -302
  52. package/src/cli.ts +41 -285
  53. package/src/handlers/__test-setup__.ts +210 -0
  54. package/src/handlers/__test-utils__.ts +4 -134
  55. package/src/handlers/blockers.test.ts +114 -124
  56. package/src/handlers/blockers.ts +68 -70
  57. package/src/handlers/bodies-of-work.test.ts +236 -831
  58. package/src/handlers/bodies-of-work.ts +194 -525
  59. package/src/handlers/cost.test.ts +149 -113
  60. package/src/handlers/cost.ts +44 -132
  61. package/src/handlers/decisions.test.ts +111 -209
  62. package/src/handlers/decisions.ts +35 -27
  63. package/src/handlers/deployment.test.ts +193 -239
  64. package/src/handlers/deployment.ts +140 -895
  65. package/src/handlers/discovery.test.ts +20 -67
  66. package/src/handlers/discovery.ts +32 -0
  67. package/src/handlers/fallback.test.ts +128 -361
  68. package/src/handlers/fallback.ts +62 -148
  69. package/src/handlers/findings.test.ts +127 -345
  70. package/src/handlers/findings.ts +49 -66
  71. package/src/handlers/git-issues.test.ts +623 -0
  72. package/src/handlers/git-issues.ts +174 -0
  73. package/src/handlers/ideas.test.ts +229 -343
  74. package/src/handlers/ideas.ts +69 -143
  75. package/src/handlers/index.ts +6 -0
  76. package/src/handlers/milestones.test.ts +167 -281
  77. package/src/handlers/milestones.ts +54 -93
  78. package/src/handlers/organizations.test.ts +275 -467
  79. package/src/handlers/organizations.ts +84 -294
  80. package/src/handlers/progress.test.ts +112 -218
  81. package/src/handlers/progress.ts +29 -142
  82. package/src/handlers/project.test.ts +203 -226
  83. package/src/handlers/project.ts +48 -238
  84. package/src/handlers/requests.test.ts +74 -342
  85. package/src/handlers/requests.ts +25 -83
  86. package/src/handlers/session.test.ts +241 -206
  87. package/src/handlers/session.ts +110 -657
  88. package/src/handlers/sprints.test.ts +711 -0
  89. package/src/handlers/sprints.ts +497 -0
  90. package/src/handlers/tasks.test.ts +608 -353
  91. package/src/handlers/tasks.ts +248 -1025
  92. package/src/handlers/types.ts +12 -4
  93. package/src/handlers/validation.test.ts +189 -572
  94. package/src/handlers/validation.ts +29 -166
  95. package/src/index.ts +473 -184
  96. package/src/knowledge.ts +107 -9
  97. package/src/tools.ts +2506 -0
  98. package/src/validators.test.ts +223 -223
  99. package/src/validators.ts +127 -0
  100. package/tsconfig.json +1 -1
  101. package/vitest.config.ts +14 -13
  102. package/dist/cli.test.d.ts +0 -1
  103. package/dist/cli.test.js +0 -367
  104. package/dist/handlers/__test-utils__.d.ts +0 -72
  105. package/dist/handlers/__test-utils__.js +0 -176
  106. package/dist/handlers/checkouts.d.ts +0 -37
  107. package/dist/handlers/checkouts.js +0 -377
  108. package/dist/handlers/knowledge-query.d.ts +0 -22
  109. package/dist/handlers/knowledge-query.js +0 -253
  110. package/dist/handlers/knowledge.d.ts +0 -12
  111. package/dist/handlers/knowledge.js +0 -108
  112. package/dist/handlers/roles.d.ts +0 -30
  113. package/dist/handlers/roles.js +0 -281
  114. package/dist/handlers/tasks.test.d.ts +0 -1
  115. package/dist/handlers/tasks.test.js +0 -431
  116. package/dist/utils.test.d.ts +0 -1
  117. package/dist/utils.test.js +0 -532
  118. package/dist/validators.test.d.ts +0 -1
  119. package/dist/validators.test.js +0 -176
  120. package/src/tmpclaude-0078-cwd +0 -1
  121. package/src/tmpclaude-0ee1-cwd +0 -1
  122. package/src/tmpclaude-2dd5-cwd +0 -1
  123. package/src/tmpclaude-344c-cwd +0 -1
  124. package/src/tmpclaude-3860-cwd +0 -1
  125. package/src/tmpclaude-4b63-cwd +0 -1
  126. package/src/tmpclaude-5c73-cwd +0 -1
  127. package/src/tmpclaude-5ee3-cwd +0 -1
  128. package/src/tmpclaude-6795-cwd +0 -1
  129. package/src/tmpclaude-709e-cwd +0 -1
  130. package/src/tmpclaude-9839-cwd +0 -1
  131. package/src/tmpclaude-d829-cwd +0 -1
  132. package/src/tmpclaude-e072-cwd +0 -1
  133. package/src/tmpclaude-f6ee-cwd +0 -1
  134. package/tmpclaude-0439-cwd +0 -1
  135. package/tmpclaude-132f-cwd +0 -1
  136. package/tmpclaude-15bb-cwd +0 -1
  137. package/tmpclaude-165a-cwd +0 -1
  138. package/tmpclaude-1ba9-cwd +0 -1
  139. package/tmpclaude-21a3-cwd +0 -1
  140. package/tmpclaude-2a38-cwd +0 -1
  141. package/tmpclaude-2adf-cwd +0 -1
  142. package/tmpclaude-2f56-cwd +0 -1
  143. package/tmpclaude-3626-cwd +0 -1
  144. package/tmpclaude-3727-cwd +0 -1
  145. package/tmpclaude-40bc-cwd +0 -1
  146. package/tmpclaude-436f-cwd +0 -1
  147. package/tmpclaude-4783-cwd +0 -1
  148. package/tmpclaude-4b6d-cwd +0 -1
  149. package/tmpclaude-4ba4-cwd +0 -1
  150. package/tmpclaude-51e6-cwd +0 -1
  151. package/tmpclaude-5ecf-cwd +0 -1
  152. package/tmpclaude-6f97-cwd +0 -1
  153. package/tmpclaude-7fb2-cwd +0 -1
  154. package/tmpclaude-825c-cwd +0 -1
  155. package/tmpclaude-8baf-cwd +0 -1
  156. package/tmpclaude-8d9f-cwd +0 -1
  157. package/tmpclaude-975c-cwd +0 -1
  158. package/tmpclaude-9983-cwd +0 -1
  159. package/tmpclaude-a045-cwd +0 -1
  160. package/tmpclaude-ac4a-cwd +0 -1
  161. package/tmpclaude-b593-cwd +0 -1
  162. package/tmpclaude-b891-cwd +0 -1
  163. package/tmpclaude-c032-cwd +0 -1
  164. package/tmpclaude-cf43-cwd +0 -1
  165. package/tmpclaude-d040-cwd +0 -1
  166. package/tmpclaude-dcdd-cwd +0 -1
  167. package/tmpclaude-dcee-cwd +0 -1
  168. package/tmpclaude-e16b-cwd +0 -1
  169. package/tmpclaude-ecd2-cwd +0 -1
  170. 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
  /**