@vibescope/mcp-server 0.2.3 → 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 (117) hide show
  1. package/CHANGELOG.md +84 -0
  2. package/README.md +194 -138
  3. package/dist/api-client.d.ts +276 -8
  4. package/dist/api-client.js +123 -8
  5. package/dist/cli.d.ts +6 -3
  6. package/dist/cli.js +28 -10
  7. package/dist/handlers/blockers.d.ts +11 -0
  8. package/dist/handlers/blockers.js +37 -2
  9. package/dist/handlers/bodies-of-work.d.ts +2 -0
  10. package/dist/handlers/bodies-of-work.js +30 -1
  11. package/dist/handlers/connectors.js +2 -2
  12. package/dist/handlers/decisions.d.ts +11 -0
  13. package/dist/handlers/decisions.js +37 -2
  14. package/dist/handlers/deployment.d.ts +6 -0
  15. package/dist/handlers/deployment.js +33 -5
  16. package/dist/handlers/discovery.js +27 -11
  17. package/dist/handlers/fallback.js +12 -6
  18. package/dist/handlers/file-checkouts.d.ts +1 -0
  19. package/dist/handlers/file-checkouts.js +17 -2
  20. package/dist/handlers/findings.d.ts +5 -0
  21. package/dist/handlers/findings.js +19 -2
  22. package/dist/handlers/git-issues.js +4 -2
  23. package/dist/handlers/ideas.d.ts +5 -0
  24. package/dist/handlers/ideas.js +19 -2
  25. package/dist/handlers/progress.js +2 -2
  26. package/dist/handlers/project.d.ts +1 -0
  27. package/dist/handlers/project.js +35 -2
  28. package/dist/handlers/requests.js +6 -3
  29. package/dist/handlers/roles.js +13 -2
  30. package/dist/handlers/session.d.ts +12 -0
  31. package/dist/handlers/session.js +288 -25
  32. package/dist/handlers/sprints.d.ts +2 -0
  33. package/dist/handlers/sprints.js +30 -1
  34. package/dist/handlers/tasks.d.ts +25 -2
  35. package/dist/handlers/tasks.js +228 -35
  36. package/dist/handlers/tool-docs.js +834 -767
  37. package/dist/index.js +73 -73
  38. package/dist/knowledge.d.ts +6 -0
  39. package/dist/knowledge.js +218 -0
  40. package/dist/setup.d.ts +22 -0
  41. package/dist/setup.js +313 -0
  42. package/dist/templates/agent-guidelines.d.ts +18 -0
  43. package/dist/templates/agent-guidelines.js +207 -0
  44. package/dist/tools.js +527 -174
  45. package/dist/utils.d.ts +5 -2
  46. package/dist/utils.js +101 -62
  47. package/docs/TOOLS.md +2053 -2053
  48. package/package.json +51 -46
  49. package/scripts/generate-docs.ts +212 -212
  50. package/scripts/version-bump.ts +203 -0
  51. package/src/api-client.test.ts +723 -723
  52. package/src/api-client.ts +2499 -2140
  53. package/src/cli.ts +27 -10
  54. package/src/handlers/__test-setup__.ts +236 -231
  55. package/src/handlers/__test-utils__.ts +87 -87
  56. package/src/handlers/blockers.test.ts +468 -392
  57. package/src/handlers/blockers.ts +163 -109
  58. package/src/handlers/bodies-of-work.test.ts +704 -704
  59. package/src/handlers/bodies-of-work.ts +526 -468
  60. package/src/handlers/connectors.test.ts +834 -834
  61. package/src/handlers/connectors.ts +229 -229
  62. package/src/handlers/cost.test.ts +462 -462
  63. package/src/handlers/cost.ts +285 -285
  64. package/src/handlers/decisions.test.ts +382 -313
  65. package/src/handlers/decisions.ts +153 -99
  66. package/src/handlers/deployment.test.ts +551 -470
  67. package/src/handlers/deployment.ts +541 -508
  68. package/src/handlers/discovery.test.ts +206 -206
  69. package/src/handlers/discovery.ts +390 -374
  70. package/src/handlers/fallback.test.ts +537 -536
  71. package/src/handlers/fallback.ts +194 -188
  72. package/src/handlers/file-checkouts.test.ts +750 -670
  73. package/src/handlers/file-checkouts.ts +185 -165
  74. package/src/handlers/findings.test.ts +633 -633
  75. package/src/handlers/findings.ts +239 -203
  76. package/src/handlers/git-issues.test.ts +631 -631
  77. package/src/handlers/git-issues.ts +136 -134
  78. package/src/handlers/ideas.test.ts +644 -644
  79. package/src/handlers/ideas.ts +207 -175
  80. package/src/handlers/index.ts +84 -84
  81. package/src/handlers/milestones.test.ts +475 -475
  82. package/src/handlers/milestones.ts +180 -180
  83. package/src/handlers/organizations.test.ts +826 -826
  84. package/src/handlers/organizations.ts +315 -315
  85. package/src/handlers/progress.test.ts +269 -269
  86. package/src/handlers/progress.ts +77 -77
  87. package/src/handlers/project.test.ts +546 -546
  88. package/src/handlers/project.ts +239 -194
  89. package/src/handlers/requests.test.ts +303 -272
  90. package/src/handlers/requests.ts +99 -96
  91. package/src/handlers/roles.test.ts +303 -303
  92. package/src/handlers/roles.ts +226 -208
  93. package/src/handlers/session.test.ts +875 -576
  94. package/src/handlers/session.ts +738 -425
  95. package/src/handlers/sprints.test.ts +732 -732
  96. package/src/handlers/sprints.ts +537 -477
  97. package/src/handlers/tasks.test.ts +907 -980
  98. package/src/handlers/tasks.ts +945 -716
  99. package/src/handlers/tool-categories.test.ts +66 -66
  100. package/src/handlers/tool-docs.ts +1096 -1024
  101. package/src/handlers/types.test.ts +259 -0
  102. package/src/handlers/types.ts +175 -175
  103. package/src/handlers/validation.test.ts +582 -582
  104. package/src/handlers/validation.ts +97 -97
  105. package/src/index.ts +792 -792
  106. package/src/setup.test.ts +231 -0
  107. package/src/setup.ts +370 -0
  108. package/src/templates/agent-guidelines.ts +210 -0
  109. package/src/token-tracking.test.ts +453 -453
  110. package/src/token-tracking.ts +164 -164
  111. package/src/tools.ts +3562 -3208
  112. package/src/utils.test.ts +683 -681
  113. package/src/utils.ts +436 -392
  114. package/src/validators.test.ts +223 -223
  115. package/src/validators.ts +249 -249
  116. package/tsconfig.json +16 -16
  117. package/vitest.config.ts +14 -14
@@ -1,96 +1,99 @@
1
- /**
2
- * Requests Handlers
3
- *
4
- * Handles user request handling:
5
- * - get_pending_requests
6
- * - acknowledge_request
7
- * - answer_question
8
- *
9
- * MIGRATED: Uses Vibescope API client instead of direct Supabase
10
- */
11
-
12
- import type { Handler, HandlerRegistry } from './types.js';
13
- import { parseArgs, uuidValidator } from '../validators.js';
14
- import { getApiClient } from '../api-client.js';
15
-
16
- // Argument schemas for type-safe parsing
17
- const getPendingRequestsSchema = {
18
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
19
- };
20
-
21
- const acknowledgeRequestSchema = {
22
- request_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
23
- };
24
-
25
- const answerQuestionSchema = {
26
- request_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
27
- answer: { type: 'string' as const, required: true as const },
28
- };
29
-
30
- export const getPendingRequests: Handler = async (args, ctx) => {
31
- const { project_id } = parseArgs(args, getPendingRequestsSchema);
32
-
33
- const { session } = ctx;
34
- const apiClient = getApiClient();
35
-
36
- const response = await apiClient.getPendingRequests(project_id, session.currentSessionId || undefined);
37
-
38
- if (!response.ok) {
39
- return { result: { error: response.error || 'Failed to get pending requests' }, isError: true };
40
- }
41
-
42
- return {
43
- result: {
44
- requests: response.data?.requests || [],
45
- count: response.data?.requests?.length || 0,
46
- },
47
- };
48
- };
49
-
50
- export const acknowledgeRequest: Handler = async (args, ctx) => {
51
- const { request_id } = parseArgs(args, acknowledgeRequestSchema);
52
-
53
- const { session } = ctx;
54
- const apiClient = getApiClient();
55
-
56
- const response = await apiClient.acknowledgeRequest(request_id, session.currentSessionId || undefined);
57
-
58
- if (!response.ok) {
59
- return { result: { error: response.error || 'Failed to acknowledge request' }, isError: true };
60
- }
61
-
62
- return {
63
- result: {
64
- success: true,
65
- },
66
- };
67
- };
68
-
69
- export const answerQuestion: Handler = async (args, ctx) => {
70
- const { request_id, answer } = parseArgs(args, answerQuestionSchema);
71
-
72
- const { session } = ctx;
73
- const apiClient = getApiClient();
74
-
75
- const response = await apiClient.answerQuestion(request_id, answer, session.currentSessionId || undefined);
76
-
77
- if (!response.ok) {
78
- return { result: { error: response.error || 'Failed to answer question' }, isError: true };
79
- }
80
-
81
- return {
82
- result: {
83
- success: true,
84
- message: 'Question answered successfully',
85
- },
86
- };
87
- };
88
-
89
- /**
90
- * Requests handlers registry
91
- */
92
- export const requestHandlers: HandlerRegistry = {
93
- get_pending_requests: getPendingRequests,
94
- acknowledge_request: acknowledgeRequest,
95
- answer_question: answerQuestion,
96
- };
1
+ /**
2
+ * Requests Handlers
3
+ *
4
+ * Handles user request handling:
5
+ * - get_pending_requests
6
+ * - acknowledge_request
7
+ * - answer_question
8
+ *
9
+ * MIGRATED: Uses Vibescope API client instead of direct Supabase
10
+ */
11
+
12
+ import type { Handler, HandlerRegistry } from './types.js';
13
+ import { parseArgs, uuidValidator } from '../validators.js';
14
+ import { getApiClient } from '../api-client.js';
15
+
16
+ // Argument schemas for type-safe parsing
17
+ const getPendingRequestsSchema = {
18
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
19
+ limit: { type: 'number' as const, default: 50 },
20
+ offset: { type: 'number' as const, default: 0 },
21
+ };
22
+
23
+ const acknowledgeRequestSchema = {
24
+ request_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
25
+ };
26
+
27
+ const answerQuestionSchema = {
28
+ request_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
29
+ answer: { type: 'string' as const, required: true as const },
30
+ };
31
+
32
+ export const getPendingRequests: Handler = async (args, ctx) => {
33
+ const { project_id, limit, offset } = parseArgs(args, getPendingRequestsSchema);
34
+
35
+ const { session } = ctx;
36
+ const apiClient = getApiClient();
37
+
38
+ const response = await apiClient.getPendingRequests(project_id, session.currentSessionId || undefined, Math.min(limit ?? 50, 50), offset);
39
+
40
+ if (!response.ok) {
41
+ return { result: { error: response.error || 'Failed to get pending requests' }, isError: true };
42
+ }
43
+
44
+ return {
45
+ result: {
46
+ requests: response.data?.requests || [],
47
+ total_count: response.data?.total_count || 0,
48
+ has_more: response.data?.has_more || false,
49
+ },
50
+ };
51
+ };
52
+
53
+ export const acknowledgeRequest: Handler = async (args, ctx) => {
54
+ const { request_id } = parseArgs(args, acknowledgeRequestSchema);
55
+
56
+ const { session } = ctx;
57
+ const apiClient = getApiClient();
58
+
59
+ const response = await apiClient.acknowledgeRequest(request_id, session.currentSessionId || undefined);
60
+
61
+ if (!response.ok) {
62
+ return { result: { error: response.error || 'Failed to acknowledge request' }, isError: true };
63
+ }
64
+
65
+ return {
66
+ result: {
67
+ success: true,
68
+ },
69
+ };
70
+ };
71
+
72
+ export const answerQuestion: Handler = async (args, ctx) => {
73
+ const { request_id, answer } = parseArgs(args, answerQuestionSchema);
74
+
75
+ const { session } = ctx;
76
+ const apiClient = getApiClient();
77
+
78
+ const response = await apiClient.answerQuestion(request_id, answer, session.currentSessionId || undefined);
79
+
80
+ if (!response.ok) {
81
+ return { result: { error: response.error || 'Failed to answer question' }, isError: true };
82
+ }
83
+
84
+ return {
85
+ result: {
86
+ success: true,
87
+ message: 'Question answered successfully',
88
+ },
89
+ };
90
+ };
91
+
92
+ /**
93
+ * Requests handlers registry
94
+ */
95
+ export const requestHandlers: HandlerRegistry = {
96
+ get_pending_requests: getPendingRequests,
97
+ acknowledge_request: acknowledgeRequest,
98
+ answer_question: answerQuestion,
99
+ };