@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
@@ -7,68 +7,67 @@
7
7
  * - get_blockers
8
8
  * - delete_blocker
9
9
  */
10
- import { validateRequired, validateUUID } from '../validators.js';
10
+ import { parseArgs, uuidValidator, createEnumValidator, VALID_BLOCKER_STATUSES, } from '../validators.js';
11
+ import { getApiClient } from '../api-client.js';
12
+ // Argument schemas for type-safe parsing
13
+ const addBlockerSchema = {
14
+ project_id: { type: 'string', required: true, validate: uuidValidator },
15
+ description: { type: 'string', required: true },
16
+ };
17
+ const resolveBlockerSchema = {
18
+ blocker_id: { type: 'string', required: true, validate: uuidValidator },
19
+ resolution_note: { type: 'string' },
20
+ };
21
+ const getBlockersSchema = {
22
+ project_id: { type: 'string', required: true, validate: uuidValidator },
23
+ status: { type: 'string', default: 'open', validate: createEnumValidator(VALID_BLOCKER_STATUSES) },
24
+ limit: { type: 'number', default: 50 },
25
+ offset: { type: 'number', default: 0 },
26
+ search_query: { type: 'string' },
27
+ };
28
+ const deleteBlockerSchema = {
29
+ blocker_id: { type: 'string', required: true, validate: uuidValidator },
30
+ };
11
31
  export const addBlocker = async (args, ctx) => {
12
- const { project_id, description } = args;
13
- validateRequired(project_id, 'project_id');
14
- validateUUID(project_id, 'project_id');
15
- validateRequired(description, 'description');
16
- const { supabase, session } = ctx;
17
- const { data, error } = await supabase
18
- .from('blockers')
19
- .insert({
20
- project_id,
21
- description,
22
- created_by: 'agent',
23
- created_by_session_id: session.currentSessionId,
24
- })
25
- .select('id')
26
- .single();
27
- if (error)
28
- throw new Error(`Failed to add blocker: ${error.message}`);
29
- return { result: { success: true, blocker_id: data.id } };
32
+ const { project_id, description } = parseArgs(args, addBlockerSchema);
33
+ const apiClient = getApiClient();
34
+ const response = await apiClient.addBlocker(project_id, description, ctx.session.currentSessionId || undefined);
35
+ if (!response.ok) {
36
+ throw new Error(response.error || 'Failed to add blocker');
37
+ }
38
+ return { result: response.data };
30
39
  };
31
- export const resolveBlocker = async (args, ctx) => {
32
- const { blocker_id, resolution_note } = args;
33
- validateRequired(blocker_id, 'blocker_id');
34
- validateUUID(blocker_id, 'blocker_id');
35
- const { error } = await ctx.supabase
36
- .from('blockers')
37
- .update({
38
- status: 'resolved',
39
- resolved_at: new Date().toISOString(),
40
- resolution_note: resolution_note || null,
41
- })
42
- .eq('id', blocker_id);
43
- if (error)
44
- throw new Error(`Failed to resolve blocker: ${error.message}`);
45
- return { result: { success: true, blocker_id } };
40
+ export const resolveBlocker = async (args, _ctx) => {
41
+ const { blocker_id, resolution_note } = parseArgs(args, resolveBlockerSchema);
42
+ const apiClient = getApiClient();
43
+ const response = await apiClient.resolveBlocker(blocker_id, resolution_note);
44
+ if (!response.ok) {
45
+ throw new Error(response.error || 'Failed to resolve blocker');
46
+ }
47
+ return { result: response.data };
46
48
  };
47
- export const getBlockers = async (args, ctx) => {
48
- const { project_id, status = 'open' } = args;
49
- validateRequired(project_id, 'project_id');
50
- validateUUID(project_id, 'project_id');
51
- const { data, error } = await ctx.supabase
52
- .from('blockers')
53
- .select('id, description, status, created_at, resolved_at, resolution_note')
54
- .eq('project_id', project_id)
55
- .eq('status', status)
56
- .order('created_at', { ascending: false });
57
- if (error)
58
- throw new Error(`Failed to fetch blockers: ${error.message}`);
59
- return { result: { blockers: data || [] } };
49
+ export const getBlockers = async (args, _ctx) => {
50
+ const { project_id, status, limit, offset, search_query } = parseArgs(args, getBlockersSchema);
51
+ const apiClient = getApiClient();
52
+ const response = await apiClient.getBlockers(project_id, {
53
+ status,
54
+ limit,
55
+ offset,
56
+ search_query
57
+ });
58
+ if (!response.ok) {
59
+ throw new Error(response.error || 'Failed to fetch blockers');
60
+ }
61
+ return { result: response.data };
60
62
  };
61
- export const deleteBlocker = async (args, ctx) => {
62
- const { blocker_id } = args;
63
- validateRequired(blocker_id, 'blocker_id');
64
- validateUUID(blocker_id, 'blocker_id');
65
- const { error } = await ctx.supabase
66
- .from('blockers')
67
- .delete()
68
- .eq('id', blocker_id);
69
- if (error)
70
- throw new Error(`Failed to delete blocker: ${error.message}`);
71
- return { result: { success: true } };
63
+ export const deleteBlocker = async (args, _ctx) => {
64
+ const { blocker_id } = parseArgs(args, deleteBlockerSchema);
65
+ const apiClient = getApiClient();
66
+ const response = await apiClient.deleteBlocker(blocker_id);
67
+ if (!response.ok) {
68
+ throw new Error(response.error || 'Failed to delete blocker');
69
+ }
70
+ return { result: response.data };
72
71
  };
73
72
  /**
74
73
  * Blockers handlers registry
@@ -14,6 +14,8 @@
14
14
  * - remove_task_dependency
15
15
  * - get_task_dependencies
16
16
  * - get_next_body_of_work_task
17
+ *
18
+ * MIGRATED: Uses Vibescope API client instead of direct Supabase
17
19
  */
18
20
  import type { Handler, HandlerRegistry } from './types.js';
19
21
  export declare const createBodyOfWork: Handler;