@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,136 +1,136 @@
1
- /**
2
- * Git Issues Handlers
3
- *
4
- * Handles git issue management:
5
- * - add_git_issue: Record a git-related issue (conflicts, push failures, etc.)
6
- * - resolve_git_issue: Mark a git issue as resolved
7
- * - get_git_issues: List git issues for a project
8
- * - delete_git_issue: Remove a git issue
9
- */
10
-
11
- import type { Handler, HandlerRegistry } from './types.js';
12
- import { parseArgs, uuidValidator, createEnumValidator } from '../validators.js';
13
- import { getApiClient } from '../api-client.js';
14
-
15
- const VALID_GIT_ISSUE_TYPES = [
16
- 'merge_conflict',
17
- 'push_failed',
18
- 'rebase_needed',
19
- 'branch_diverged',
20
- 'pr_not_mergeable',
21
- ] as const;
22
-
23
- const VALID_GIT_ISSUE_STATUSES = ['open', 'resolved'] as const;
24
-
25
- type GitIssueType = (typeof VALID_GIT_ISSUE_TYPES)[number];
26
- type GitIssueStatus = (typeof VALID_GIT_ISSUE_STATUSES)[number];
27
-
28
- // Argument schemas for type-safe parsing
29
- const addGitIssueSchema = {
30
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
31
- issue_type: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_GIT_ISSUE_TYPES) },
32
- branch: { type: 'string' as const, required: true as const },
33
- target_branch: { type: 'string' as const },
34
- pr_url: { type: 'string' as const },
35
- conflicting_files: { type: 'array' as const },
36
- error_message: { type: 'string' as const },
37
- task_id: { type: 'string' as const, validate: uuidValidator },
38
- };
39
-
40
- const resolveGitIssueSchema = {
41
- git_issue_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
42
- resolution_note: { type: 'string' as const },
43
- auto_resolved: { type: 'boolean' as const },
44
- };
45
-
46
- const getGitIssuesSchema = {
47
- project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
48
- status: { type: 'string' as const, default: 'open', validate: createEnumValidator(VALID_GIT_ISSUE_STATUSES) },
49
- issue_type: { type: 'string' as const, validate: createEnumValidator(VALID_GIT_ISSUE_TYPES) },
50
- branch: { type: 'string' as const },
51
- limit: { type: 'number' as const, default: 50 },
52
- offset: { type: 'number' as const, default: 0 },
53
- };
54
-
55
- const deleteGitIssueSchema = {
56
- git_issue_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
57
- };
58
-
59
- export const addGitIssue: Handler = async (args, ctx) => {
60
- const { project_id, issue_type, branch, target_branch, pr_url, conflicting_files, error_message, task_id } = parseArgs(args, addGitIssueSchema);
61
-
62
- const apiClient = getApiClient();
63
- const response = await apiClient.addGitIssue(project_id, {
64
- issue_type: issue_type as GitIssueType,
65
- branch,
66
- target_branch,
67
- pr_url,
68
- conflicting_files: conflicting_files as string[] | undefined,
69
- error_message,
70
- task_id
71
- }, ctx.session.currentSessionId || undefined);
72
-
73
- if (!response.ok) {
74
- return { result: { error: response.error || 'Failed to add git issue' }, isError: true };
75
- }
76
-
77
- return { result: response.data };
78
- };
79
-
80
- export const resolveGitIssue: Handler = async (args, ctx) => {
81
- const { git_issue_id, resolution_note, auto_resolved } = parseArgs(args, resolveGitIssueSchema);
82
-
83
- const apiClient = getApiClient();
84
- const response = await apiClient.resolveGitIssue(git_issue_id, {
85
- resolution_note,
86
- auto_resolved
87
- }, ctx.session.currentSessionId || undefined);
88
-
89
- if (!response.ok) {
90
- return { result: { error: response.error || 'Failed to resolve git issue' }, isError: true };
91
- }
92
-
93
- return { result: response.data };
94
- };
95
-
96
- export const getGitIssues: Handler = async (args, _ctx) => {
97
- const { project_id, status, issue_type, branch, limit, offset } = parseArgs(args, getGitIssuesSchema);
98
-
99
- const apiClient = getApiClient();
100
- const response = await apiClient.getGitIssues(project_id, {
101
- status: status as GitIssueStatus | undefined,
102
- issue_type: issue_type as GitIssueType | undefined,
103
- branch,
104
- limit: Math.min(limit ?? 50, 50),
105
- offset
106
- });
107
-
108
- if (!response.ok) {
109
- return { result: { error: response.error || 'Failed to fetch git issues' }, isError: true };
110
- }
111
-
112
- return { result: response.data };
113
- };
114
-
115
- export const deleteGitIssue: Handler = async (args, _ctx) => {
116
- const { git_issue_id } = parseArgs(args, deleteGitIssueSchema);
117
-
118
- const apiClient = getApiClient();
119
- const response = await apiClient.deleteGitIssue(git_issue_id);
120
-
121
- if (!response.ok) {
122
- return { result: { error: response.error || 'Failed to delete git issue' }, isError: true };
123
- }
124
-
125
- return { result: response.data };
126
- };
127
-
128
- /**
129
- * Git Issues handlers registry
130
- */
131
- export const gitIssueHandlers: HandlerRegistry = {
132
- add_git_issue: addGitIssue,
133
- resolve_git_issue: resolveGitIssue,
134
- get_git_issues: getGitIssues,
135
- delete_git_issue: deleteGitIssue,
136
- };
1
+ /**
2
+ * Git Issues Handlers
3
+ *
4
+ * Handles git issue management:
5
+ * - add_git_issue: Record a git-related issue (conflicts, push failures, etc.)
6
+ * - resolve_git_issue: Mark a git issue as resolved
7
+ * - get_git_issues: List git issues for a project
8
+ * - delete_git_issue: Remove a git issue
9
+ */
10
+
11
+ import type { Handler, HandlerRegistry } from './types.js';
12
+ import { parseArgs, uuidValidator, createEnumValidator } from '../validators.js';
13
+ import { getApiClient } from '../api-client.js';
14
+
15
+ const VALID_GIT_ISSUE_TYPES = [
16
+ 'merge_conflict',
17
+ 'push_failed',
18
+ 'rebase_needed',
19
+ 'branch_diverged',
20
+ 'pr_not_mergeable',
21
+ ] as const;
22
+
23
+ const VALID_GIT_ISSUE_STATUSES = ['open', 'resolved'] as const;
24
+
25
+ type GitIssueType = (typeof VALID_GIT_ISSUE_TYPES)[number];
26
+ type GitIssueStatus = (typeof VALID_GIT_ISSUE_STATUSES)[number];
27
+
28
+ // Argument schemas for type-safe parsing
29
+ const addGitIssueSchema = {
30
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
31
+ issue_type: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_GIT_ISSUE_TYPES) },
32
+ branch: { type: 'string' as const, required: true as const },
33
+ target_branch: { type: 'string' as const },
34
+ pr_url: { type: 'string' as const },
35
+ conflicting_files: { type: 'array' as const },
36
+ error_message: { type: 'string' as const },
37
+ task_id: { type: 'string' as const, validate: uuidValidator },
38
+ };
39
+
40
+ const resolveGitIssueSchema = {
41
+ git_issue_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
42
+ resolution_note: { type: 'string' as const },
43
+ auto_resolved: { type: 'boolean' as const },
44
+ };
45
+
46
+ const getGitIssuesSchema = {
47
+ project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
48
+ status: { type: 'string' as const, default: 'open', validate: createEnumValidator(VALID_GIT_ISSUE_STATUSES) },
49
+ issue_type: { type: 'string' as const, validate: createEnumValidator(VALID_GIT_ISSUE_TYPES) },
50
+ branch: { type: 'string' as const },
51
+ limit: { type: 'number' as const, default: 50 },
52
+ offset: { type: 'number' as const, default: 0 },
53
+ };
54
+
55
+ const deleteGitIssueSchema = {
56
+ git_issue_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
57
+ };
58
+
59
+ export const addGitIssue: Handler = async (args, ctx) => {
60
+ const { project_id, issue_type, branch, target_branch, pr_url, conflicting_files, error_message, task_id } = parseArgs(args, addGitIssueSchema);
61
+
62
+ const apiClient = getApiClient();
63
+ const response = await apiClient.addGitIssue(project_id, {
64
+ issue_type: issue_type as GitIssueType,
65
+ branch,
66
+ target_branch,
67
+ pr_url,
68
+ conflicting_files: conflicting_files as string[] | undefined,
69
+ error_message,
70
+ task_id
71
+ }, ctx.session.currentSessionId || undefined);
72
+
73
+ if (!response.ok) {
74
+ return { result: { error: response.error || 'Failed to add git issue' }, isError: true };
75
+ }
76
+
77
+ return { result: response.data };
78
+ };
79
+
80
+ export const resolveGitIssue: Handler = async (args, ctx) => {
81
+ const { git_issue_id, resolution_note, auto_resolved } = parseArgs(args, resolveGitIssueSchema);
82
+
83
+ const apiClient = getApiClient();
84
+ const response = await apiClient.resolveGitIssue(git_issue_id, {
85
+ resolution_note,
86
+ auto_resolved
87
+ }, ctx.session.currentSessionId || undefined);
88
+
89
+ if (!response.ok) {
90
+ return { result: { error: response.error || 'Failed to resolve git issue' }, isError: true };
91
+ }
92
+
93
+ return { result: response.data };
94
+ };
95
+
96
+ export const getGitIssues: Handler = async (args, _ctx) => {
97
+ const { project_id, status, issue_type, branch, limit, offset } = parseArgs(args, getGitIssuesSchema);
98
+
99
+ const apiClient = getApiClient();
100
+ const response = await apiClient.getGitIssues(project_id, {
101
+ status: status as GitIssueStatus | undefined,
102
+ issue_type: issue_type as GitIssueType | undefined,
103
+ branch,
104
+ limit: Math.min(limit ?? 50, 50),
105
+ offset
106
+ });
107
+
108
+ if (!response.ok) {
109
+ return { result: { error: response.error || 'Failed to fetch git issues' }, isError: true };
110
+ }
111
+
112
+ return { result: response.data };
113
+ };
114
+
115
+ export const deleteGitIssue: Handler = async (args, _ctx) => {
116
+ const { git_issue_id } = parseArgs(args, deleteGitIssueSchema);
117
+
118
+ const apiClient = getApiClient();
119
+ const response = await apiClient.deleteGitIssue(git_issue_id);
120
+
121
+ if (!response.ok) {
122
+ return { result: { error: response.error || 'Failed to delete git issue' }, isError: true };
123
+ }
124
+
125
+ return { result: response.data };
126
+ };
127
+
128
+ /**
129
+ * Git Issues handlers registry
130
+ */
131
+ export const gitIssueHandlers: HandlerRegistry = {
132
+ add_git_issue: addGitIssue,
133
+ resolve_git_issue: resolveGitIssue,
134
+ get_git_issues: getGitIssues,
135
+ delete_git_issue: deleteGitIssue,
136
+ };