@vibescope/mcp-server 0.2.8 → 0.3.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 (97) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/api-client.d.ts +41 -5
  4. package/dist/api-client.js +34 -0
  5. package/dist/cli.d.ts +1 -1
  6. package/dist/cli.js +30 -38
  7. package/dist/handlers/discovery.js +2 -0
  8. package/dist/handlers/roles.js +1 -8
  9. package/dist/handlers/session.d.ts +11 -0
  10. package/dist/handlers/session.js +124 -32
  11. package/dist/handlers/tasks.d.ts +8 -0
  12. package/dist/handlers/tasks.js +163 -3
  13. package/dist/handlers/tool-docs.js +840 -828
  14. package/dist/handlers/validation.js +71 -15
  15. package/dist/index.js +73 -73
  16. package/dist/setup.js +6 -6
  17. package/dist/templates/agent-guidelines.js +185 -185
  18. package/dist/templates/help-content.d.ts +24 -0
  19. package/dist/templates/help-content.js +1728 -0
  20. package/dist/tools.js +132 -87
  21. package/dist/utils.d.ts +15 -11
  22. package/dist/utils.js +53 -28
  23. package/docs/TOOLS.md +2406 -2053
  24. package/package.json +1 -1
  25. package/scripts/generate-docs.ts +212 -212
  26. package/scripts/version-bump.ts +203 -203
  27. package/src/api-client.test.ts +723 -723
  28. package/src/api-client.ts +2561 -2499
  29. package/src/cli.test.ts +24 -8
  30. package/src/cli.ts +204 -212
  31. package/src/handlers/__test-setup__.ts +236 -236
  32. package/src/handlers/__test-utils__.ts +87 -87
  33. package/src/handlers/blockers.test.ts +468 -468
  34. package/src/handlers/blockers.ts +163 -163
  35. package/src/handlers/bodies-of-work.test.ts +704 -704
  36. package/src/handlers/bodies-of-work.ts +526 -526
  37. package/src/handlers/connectors.test.ts +834 -834
  38. package/src/handlers/connectors.ts +229 -229
  39. package/src/handlers/cost.test.ts +462 -462
  40. package/src/handlers/cost.ts +285 -285
  41. package/src/handlers/decisions.test.ts +382 -382
  42. package/src/handlers/decisions.ts +153 -153
  43. package/src/handlers/deployment.test.ts +551 -551
  44. package/src/handlers/deployment.ts +541 -541
  45. package/src/handlers/discovery.test.ts +206 -206
  46. package/src/handlers/discovery.ts +392 -390
  47. package/src/handlers/fallback.test.ts +537 -537
  48. package/src/handlers/fallback.ts +194 -194
  49. package/src/handlers/file-checkouts.test.ts +750 -750
  50. package/src/handlers/file-checkouts.ts +185 -185
  51. package/src/handlers/findings.test.ts +633 -633
  52. package/src/handlers/findings.ts +239 -239
  53. package/src/handlers/git-issues.test.ts +631 -631
  54. package/src/handlers/git-issues.ts +136 -136
  55. package/src/handlers/ideas.test.ts +644 -644
  56. package/src/handlers/ideas.ts +207 -207
  57. package/src/handlers/index.ts +84 -84
  58. package/src/handlers/milestones.test.ts +475 -475
  59. package/src/handlers/milestones.ts +180 -180
  60. package/src/handlers/organizations.test.ts +826 -826
  61. package/src/handlers/organizations.ts +315 -315
  62. package/src/handlers/progress.test.ts +269 -269
  63. package/src/handlers/progress.ts +77 -77
  64. package/src/handlers/project.test.ts +546 -546
  65. package/src/handlers/project.ts +239 -239
  66. package/src/handlers/requests.test.ts +303 -303
  67. package/src/handlers/requests.ts +99 -99
  68. package/src/handlers/roles.test.ts +305 -303
  69. package/src/handlers/roles.ts +219 -226
  70. package/src/handlers/session.test.ts +998 -875
  71. package/src/handlers/session.ts +839 -738
  72. package/src/handlers/sprints.test.ts +732 -732
  73. package/src/handlers/sprints.ts +537 -537
  74. package/src/handlers/tasks.test.ts +931 -907
  75. package/src/handlers/tasks.ts +1121 -945
  76. package/src/handlers/tool-categories.test.ts +66 -66
  77. package/src/handlers/tool-docs.ts +1109 -1096
  78. package/src/handlers/types.test.ts +259 -259
  79. package/src/handlers/types.ts +175 -175
  80. package/src/handlers/validation.test.ts +582 -582
  81. package/src/handlers/validation.ts +159 -97
  82. package/src/index.test.ts +674 -0
  83. package/src/index.ts +792 -792
  84. package/src/setup.test.ts +233 -233
  85. package/src/setup.ts +404 -403
  86. package/src/templates/agent-guidelines.ts +210 -210
  87. package/src/templates/help-content.ts +1751 -0
  88. package/src/token-tracking.test.ts +463 -463
  89. package/src/token-tracking.ts +166 -166
  90. package/src/tools.test.ts +416 -0
  91. package/src/tools.ts +3607 -3562
  92. package/src/utils.test.ts +785 -683
  93. package/src/utils.ts +469 -436
  94. package/src/validators.test.ts +223 -223
  95. package/src/validators.ts +249 -249
  96. package/tsconfig.json +16 -16
  97. package/vitest.config.ts +14 -14
@@ -1,163 +1,163 @@
1
- /**
2
- * Blockers Handlers
3
- *
4
- * Handles blocker management:
5
- * - add_blocker
6
- * - resolve_blocker
7
- * - get_blockers
8
- * - delete_blocker
9
- */
10
-
11
- import type { Handler, HandlerRegistry } from './types.js';
12
- import { success, error } from './types.js';
13
- import {
14
- parseArgs,
15
- uuidValidator,
16
- createEnumValidator,
17
- VALID_BLOCKER_STATUSES,
18
- } from '../validators.js';
19
- import { getApiClient } from '../api-client.js';
20
-
21
- // Argument schemas for type-safe parsing
22
- const addBlockerSchema = {
23
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
24
- description: { type: 'string' as const, required: true as const },
25
- };
26
-
27
- const resolveBlockerSchema = {
28
- blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
29
- resolution_note: { type: 'string' as const },
30
- };
31
-
32
- const getBlockerSchema = {
33
- blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
34
- };
35
-
36
- const getBlockersSchema = {
37
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
38
- status: { type: 'string' as const, default: 'open', validate: createEnumValidator(VALID_BLOCKER_STATUSES) },
39
- limit: { type: 'number' as const, default: 10 },
40
- offset: { type: 'number' as const, default: 0 },
41
- search_query: { type: 'string' as const },
42
- };
43
-
44
- const deleteBlockerSchema = {
45
- blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
46
- };
47
-
48
- const getBlockersStatsSchema = {
49
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
50
- };
51
-
52
- export const addBlocker: Handler = async (args, ctx) => {
53
- const { project_id, description } = parseArgs(args, addBlockerSchema);
54
-
55
- const apiClient = getApiClient();
56
- const response = await apiClient.addBlocker(project_id, description, ctx.session.currentSessionId || undefined);
57
-
58
- if (!response.ok) {
59
- return error(response.error || 'Failed to add blocker');
60
- }
61
-
62
- return success(response.data);
63
- };
64
-
65
- export const resolveBlocker: Handler = async (args, _ctx) => {
66
- const { blocker_id, resolution_note } = parseArgs(args, resolveBlockerSchema);
67
-
68
- const apiClient = getApiClient();
69
- const response = await apiClient.resolveBlocker(blocker_id, resolution_note);
70
-
71
- if (!response.ok) {
72
- return error(response.error || 'Failed to resolve blocker');
73
- }
74
-
75
- return success(response.data);
76
- };
77
-
78
- /**
79
- * Get a single blocker by ID.
80
- * More token-efficient than get_blockers when you need details for a specific blocker.
81
- */
82
- export const getBlocker: Handler = async (args, _ctx) => {
83
- const { blocker_id } = parseArgs(args, getBlockerSchema);
84
-
85
- const apiClient = getApiClient();
86
- const response = await apiClient.proxy<{
87
- blocker: {
88
- id: string;
89
- description: string;
90
- status: string;
91
- resolution_note?: string;
92
- created_at: string;
93
- resolved_at?: string;
94
- };
95
- }>('get_blocker', { blocker_id });
96
-
97
- if (!response.ok) {
98
- return error(response.error || 'Failed to get blocker');
99
- }
100
-
101
- return success(response.data);
102
- };
103
-
104
- export const getBlockers: Handler = async (args, _ctx) => {
105
- const { project_id, status, limit, offset, search_query } = parseArgs(args, getBlockersSchema);
106
-
107
- const apiClient = getApiClient();
108
- const response = await apiClient.getBlockers(project_id, {
109
- status,
110
- limit: Math.min(limit ?? 10, 200),
111
- offset,
112
- search_query
113
- });
114
-
115
- if (!response.ok) {
116
- return error(response.error || 'Failed to fetch blockers');
117
- }
118
-
119
- return success(response.data);
120
- };
121
-
122
- export const deleteBlocker: Handler = async (args, _ctx) => {
123
- const { blocker_id } = parseArgs(args, deleteBlockerSchema);
124
-
125
- const apiClient = getApiClient();
126
- const response = await apiClient.deleteBlocker(blocker_id);
127
-
128
- if (!response.ok) {
129
- return error(response.error || 'Failed to delete blocker');
130
- }
131
-
132
- return success(response.data);
133
- };
134
-
135
- /**
136
- * Get aggregate statistics about blockers for a project.
137
- * Returns total count and breakdown by status without the actual blocker data.
138
- * This is much more token-efficient than get_blockers for understanding the overall state.
139
- */
140
- export const getBlockersStats: Handler = async (args, _ctx) => {
141
- const { project_id } = parseArgs(args, getBlockersStatsSchema);
142
-
143
- const apiClient = getApiClient();
144
- const response = await apiClient.getBlockersStats(project_id);
145
-
146
- if (!response.ok) {
147
- return error(response.error || 'Failed to get blockers stats');
148
- }
149
-
150
- return success(response.data);
151
- };
152
-
153
- /**
154
- * Blockers handlers registry
155
- */
156
- export const blockerHandlers: HandlerRegistry = {
157
- add_blocker: addBlocker,
158
- resolve_blocker: resolveBlocker,
159
- get_blocker: getBlocker,
160
- get_blockers: getBlockers,
161
- get_blockers_stats: getBlockersStats,
162
- delete_blocker: deleteBlocker,
163
- };
1
+ /**
2
+ * Blockers Handlers
3
+ *
4
+ * Handles blocker management:
5
+ * - add_blocker
6
+ * - resolve_blocker
7
+ * - get_blockers
8
+ * - delete_blocker
9
+ */
10
+
11
+ import type { Handler, HandlerRegistry } from './types.js';
12
+ import { success, error } from './types.js';
13
+ import {
14
+ parseArgs,
15
+ uuidValidator,
16
+ createEnumValidator,
17
+ VALID_BLOCKER_STATUSES,
18
+ } from '../validators.js';
19
+ import { getApiClient } from '../api-client.js';
20
+
21
+ // Argument schemas for type-safe parsing
22
+ const addBlockerSchema = {
23
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
24
+ description: { type: 'string' as const, required: true as const },
25
+ };
26
+
27
+ const resolveBlockerSchema = {
28
+ blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
29
+ resolution_note: { type: 'string' as const },
30
+ };
31
+
32
+ const getBlockerSchema = {
33
+ blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
34
+ };
35
+
36
+ const getBlockersSchema = {
37
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
38
+ status: { type: 'string' as const, default: 'open', validate: createEnumValidator(VALID_BLOCKER_STATUSES) },
39
+ limit: { type: 'number' as const, default: 10 },
40
+ offset: { type: 'number' as const, default: 0 },
41
+ search_query: { type: 'string' as const },
42
+ };
43
+
44
+ const deleteBlockerSchema = {
45
+ blocker_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
46
+ };
47
+
48
+ const getBlockersStatsSchema = {
49
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
50
+ };
51
+
52
+ export const addBlocker: Handler = async (args, ctx) => {
53
+ const { project_id, description } = parseArgs(args, addBlockerSchema);
54
+
55
+ const apiClient = getApiClient();
56
+ const response = await apiClient.addBlocker(project_id, description, ctx.session.currentSessionId || undefined);
57
+
58
+ if (!response.ok) {
59
+ return error(response.error || 'Failed to add blocker');
60
+ }
61
+
62
+ return success(response.data);
63
+ };
64
+
65
+ export const resolveBlocker: Handler = async (args, _ctx) => {
66
+ const { blocker_id, resolution_note } = parseArgs(args, resolveBlockerSchema);
67
+
68
+ const apiClient = getApiClient();
69
+ const response = await apiClient.resolveBlocker(blocker_id, resolution_note);
70
+
71
+ if (!response.ok) {
72
+ return error(response.error || 'Failed to resolve blocker');
73
+ }
74
+
75
+ return success(response.data);
76
+ };
77
+
78
+ /**
79
+ * Get a single blocker by ID.
80
+ * More token-efficient than get_blockers when you need details for a specific blocker.
81
+ */
82
+ export const getBlocker: Handler = async (args, _ctx) => {
83
+ const { blocker_id } = parseArgs(args, getBlockerSchema);
84
+
85
+ const apiClient = getApiClient();
86
+ const response = await apiClient.proxy<{
87
+ blocker: {
88
+ id: string;
89
+ description: string;
90
+ status: string;
91
+ resolution_note?: string;
92
+ created_at: string;
93
+ resolved_at?: string;
94
+ };
95
+ }>('get_blocker', { blocker_id });
96
+
97
+ if (!response.ok) {
98
+ return error(response.error || 'Failed to get blocker');
99
+ }
100
+
101
+ return success(response.data);
102
+ };
103
+
104
+ export const getBlockers: Handler = async (args, _ctx) => {
105
+ const { project_id, status, limit, offset, search_query } = parseArgs(args, getBlockersSchema);
106
+
107
+ const apiClient = getApiClient();
108
+ const response = await apiClient.getBlockers(project_id, {
109
+ status,
110
+ limit: Math.min(limit ?? 10, 200),
111
+ offset,
112
+ search_query
113
+ });
114
+
115
+ if (!response.ok) {
116
+ return error(response.error || 'Failed to fetch blockers');
117
+ }
118
+
119
+ return success(response.data);
120
+ };
121
+
122
+ export const deleteBlocker: Handler = async (args, _ctx) => {
123
+ const { blocker_id } = parseArgs(args, deleteBlockerSchema);
124
+
125
+ const apiClient = getApiClient();
126
+ const response = await apiClient.deleteBlocker(blocker_id);
127
+
128
+ if (!response.ok) {
129
+ return error(response.error || 'Failed to delete blocker');
130
+ }
131
+
132
+ return success(response.data);
133
+ };
134
+
135
+ /**
136
+ * Get aggregate statistics about blockers for a project.
137
+ * Returns total count and breakdown by status without the actual blocker data.
138
+ * This is much more token-efficient than get_blockers for understanding the overall state.
139
+ */
140
+ export const getBlockersStats: Handler = async (args, _ctx) => {
141
+ const { project_id } = parseArgs(args, getBlockersStatsSchema);
142
+
143
+ const apiClient = getApiClient();
144
+ const response = await apiClient.getBlockersStats(project_id);
145
+
146
+ if (!response.ok) {
147
+ return error(response.error || 'Failed to get blockers stats');
148
+ }
149
+
150
+ return success(response.data);
151
+ };
152
+
153
+ /**
154
+ * Blockers handlers registry
155
+ */
156
+ export const blockerHandlers: HandlerRegistry = {
157
+ add_blocker: addBlocker,
158
+ resolve_blocker: resolveBlocker,
159
+ get_blocker: getBlocker,
160
+ get_blockers: getBlockers,
161
+ get_blockers_stats: getBlockersStats,
162
+ delete_blocker: deleteBlocker,
163
+ };