@vibescope/mcp-server 0.4.9 → 0.5.1
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.
- package/CHANGELOG.md +84 -84
- package/README.md +194 -194
- package/dist/api-client/tasks.d.ts +1 -0
- package/dist/cli-init.js +21 -21
- package/dist/cli.js +26 -26
- package/dist/handlers/tasks.js +7 -1
- package/dist/handlers/tool-docs.js +1216 -1216
- package/dist/index.js +73 -73
- package/dist/templates/agent-guidelines.d.ts +1 -1
- package/dist/templates/agent-guidelines.js +205 -205
- package/dist/templates/help-content.js +1621 -1621
- package/dist/tools/bodies-of-work.js +6 -6
- package/dist/tools/cloud-agents.js +22 -22
- package/dist/tools/milestones.js +2 -2
- package/dist/tools/requests.js +1 -1
- package/dist/tools/session.js +11 -11
- package/dist/tools/sprints.js +9 -9
- package/dist/tools/tasks.js +43 -35
- package/dist/tools/worktrees.js +14 -14
- package/dist/utils.js +11 -11
- package/docs/TOOLS.md +2687 -2685
- package/package.json +53 -53
- package/scripts/generate-docs.ts +212 -212
- package/scripts/version-bump.ts +203 -203
- package/src/api-client/blockers.ts +86 -86
- package/src/api-client/bodies-of-work.ts +194 -194
- package/src/api-client/chat.ts +50 -50
- package/src/api-client/connectors.ts +152 -152
- package/src/api-client/cost.ts +185 -185
- package/src/api-client/decisions.ts +87 -87
- package/src/api-client/deployment.ts +313 -313
- package/src/api-client/discovery.ts +81 -81
- package/src/api-client/fallback.ts +52 -52
- package/src/api-client/file-checkouts.ts +115 -115
- package/src/api-client/findings.ts +100 -100
- package/src/api-client/git-issues.ts +88 -88
- package/src/api-client/ideas.ts +112 -112
- package/src/api-client/index.ts +592 -592
- package/src/api-client/milestones.ts +83 -83
- package/src/api-client/organizations.ts +185 -185
- package/src/api-client/progress.ts +94 -94
- package/src/api-client/project.ts +181 -181
- package/src/api-client/requests.ts +54 -54
- package/src/api-client/session.ts +220 -220
- package/src/api-client/sprints.ts +227 -227
- package/src/api-client/subtasks.ts +57 -57
- package/src/api-client/tasks.ts +451 -450
- package/src/api-client/types.ts +32 -32
- package/src/api-client/validation.ts +60 -60
- package/src/api-client/worktrees.ts +53 -53
- package/src/api-client.test.ts +847 -847
- package/src/api-client.ts +2728 -2728
- package/src/cli-init.ts +558 -558
- package/src/cli.test.ts +284 -284
- package/src/cli.ts +204 -204
- package/src/handlers/__test-setup__.ts +240 -240
- package/src/handlers/__test-utils__.ts +89 -89
- package/src/handlers/blockers.test.ts +468 -468
- package/src/handlers/blockers.ts +172 -172
- package/src/handlers/bodies-of-work.test.ts +704 -704
- package/src/handlers/bodies-of-work.ts +526 -526
- package/src/handlers/chat.test.ts +185 -185
- package/src/handlers/chat.ts +101 -101
- package/src/handlers/cloud-agents.test.ts +438 -438
- package/src/handlers/cloud-agents.ts +156 -156
- package/src/handlers/connectors.test.ts +834 -834
- package/src/handlers/connectors.ts +229 -229
- package/src/handlers/cost.test.ts +462 -462
- package/src/handlers/cost.ts +285 -285
- package/src/handlers/decisions.test.ts +382 -382
- package/src/handlers/decisions.ts +153 -153
- package/src/handlers/deployment.test.ts +551 -551
- package/src/handlers/deployment.ts +570 -570
- package/src/handlers/discovery.test.ts +206 -206
- package/src/handlers/discovery.ts +433 -433
- package/src/handlers/fallback.test.ts +537 -537
- package/src/handlers/fallback.ts +194 -194
- package/src/handlers/file-checkouts.test.ts +750 -750
- package/src/handlers/file-checkouts.ts +185 -185
- package/src/handlers/findings.test.ts +633 -633
- package/src/handlers/findings.ts +239 -239
- package/src/handlers/git-issues.test.ts +631 -631
- package/src/handlers/git-issues.ts +136 -136
- package/src/handlers/ideas.test.ts +644 -644
- package/src/handlers/ideas.ts +207 -207
- package/src/handlers/index.ts +93 -93
- package/src/handlers/milestones.test.ts +475 -475
- package/src/handlers/milestones.ts +180 -180
- package/src/handlers/organizations.test.ts +826 -826
- package/src/handlers/organizations.ts +315 -315
- package/src/handlers/progress.test.ts +269 -269
- package/src/handlers/progress.ts +77 -77
- package/src/handlers/project.test.ts +546 -546
- package/src/handlers/project.ts +245 -245
- package/src/handlers/requests.test.ts +303 -303
- package/src/handlers/requests.ts +99 -99
- package/src/handlers/roles.test.ts +305 -305
- package/src/handlers/roles.ts +219 -219
- package/src/handlers/session.test.ts +998 -998
- package/src/handlers/session.ts +1105 -1105
- package/src/handlers/sprints.test.ts +732 -732
- package/src/handlers/sprints.ts +537 -537
- package/src/handlers/tasks.test.ts +931 -931
- package/src/handlers/tasks.ts +1144 -1137
- package/src/handlers/tool-categories.test.ts +66 -66
- package/src/handlers/tool-docs.test.ts +511 -511
- package/src/handlers/tool-docs.ts +1595 -1595
- package/src/handlers/types.test.ts +259 -259
- package/src/handlers/types.ts +176 -176
- package/src/handlers/validation.test.ts +582 -582
- package/src/handlers/validation.ts +164 -164
- package/src/handlers/version.ts +63 -63
- package/src/index.test.ts +674 -674
- package/src/index.ts +884 -884
- package/src/setup.test.ts +243 -243
- package/src/setup.ts +410 -410
- package/src/templates/agent-guidelines.ts +233 -233
- package/src/templates/help-content.ts +1751 -1751
- package/src/token-tracking.test.ts +463 -463
- package/src/token-tracking.ts +167 -167
- package/src/tools/blockers.ts +122 -122
- package/src/tools/bodies-of-work.ts +283 -283
- package/src/tools/chat.ts +72 -72
- package/src/tools/cloud-agents.ts +101 -101
- package/src/tools/connectors.ts +191 -191
- package/src/tools/cost.ts +111 -111
- package/src/tools/decisions.ts +111 -111
- package/src/tools/deployment.ts +455 -455
- package/src/tools/discovery.ts +76 -76
- package/src/tools/fallback.ts +111 -111
- package/src/tools/features.ts +154 -154
- package/src/tools/file-checkouts.ts +145 -145
- package/src/tools/findings.ts +101 -101
- package/src/tools/git-issues.ts +130 -130
- package/src/tools/ideas.ts +162 -162
- package/src/tools/index.ts +145 -145
- package/src/tools/milestones.ts +118 -118
- package/src/tools/organizations.ts +224 -224
- package/src/tools/persona-templates.ts +25 -25
- package/src/tools/progress.ts +73 -73
- package/src/tools/project.ts +210 -210
- package/src/tools/requests.ts +68 -68
- package/src/tools/roles.ts +112 -112
- package/src/tools/session.ts +181 -181
- package/src/tools/sprints.ts +298 -298
- package/src/tools/tasks.ts +583 -575
- package/src/tools/tools.test.ts +222 -222
- package/src/tools/types.ts +9 -9
- package/src/tools/validation.ts +75 -75
- package/src/tools/version.ts +34 -34
- package/src/tools/worktrees.ts +66 -66
- package/src/tools.test.ts +416 -416
- package/src/utils.test.ts +1014 -1014
- package/src/utils.ts +586 -586
- package/src/validators.test.ts +223 -223
- package/src/validators.ts +249 -249
- package/src/version.ts +162 -162
- package/tsconfig.json +16 -16
- package/vitest.config.ts +14 -14
package/src/tools/version.ts
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Version management tool definitions
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
import type { Tool } from './types.js';
|
|
6
|
-
|
|
7
|
-
export const versionTools: Tool[] = [
|
|
8
|
-
{
|
|
9
|
-
name: 'check_mcp_version',
|
|
10
|
-
description:
|
|
11
|
-
'Check if the Vibescope MCP server is up to date. Compares the locally installed version against the latest published version on npm. Call this when starting a session or when the server instructions indicate an update is available.',
|
|
12
|
-
inputSchema: {
|
|
13
|
-
type: 'object' as const,
|
|
14
|
-
properties: {},
|
|
15
|
-
required: [],
|
|
16
|
-
},
|
|
17
|
-
},
|
|
18
|
-
{
|
|
19
|
-
name: 'update_mcp_server',
|
|
20
|
-
description:
|
|
21
|
-
'Update the Vibescope MCP server to the latest version. Runs npm install to fetch the latest version. After updating, the server must be restarted (the agent should ask the user to restart their MCP client/editor). Only call this when the user agrees to update.',
|
|
22
|
-
inputSchema: {
|
|
23
|
-
type: 'object' as const,
|
|
24
|
-
properties: {
|
|
25
|
-
global: {
|
|
26
|
-
type: 'boolean',
|
|
27
|
-
description:
|
|
28
|
-
'If true, update the global installation (npm install -g). If false, update locally. Default: true.',
|
|
29
|
-
},
|
|
30
|
-
},
|
|
31
|
-
required: [],
|
|
32
|
-
},
|
|
33
|
-
},
|
|
34
|
-
];
|
|
1
|
+
/**
|
|
2
|
+
* Version management tool definitions
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import type { Tool } from './types.js';
|
|
6
|
+
|
|
7
|
+
export const versionTools: Tool[] = [
|
|
8
|
+
{
|
|
9
|
+
name: 'check_mcp_version',
|
|
10
|
+
description:
|
|
11
|
+
'Check if the Vibescope MCP server is up to date. Compares the locally installed version against the latest published version on npm. Call this when starting a session or when the server instructions indicate an update is available.',
|
|
12
|
+
inputSchema: {
|
|
13
|
+
type: 'object' as const,
|
|
14
|
+
properties: {},
|
|
15
|
+
required: [],
|
|
16
|
+
},
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
name: 'update_mcp_server',
|
|
20
|
+
description:
|
|
21
|
+
'Update the Vibescope MCP server to the latest version. Runs npm install to fetch the latest version. After updating, the server must be restarted (the agent should ask the user to restart their MCP client/editor). Only call this when the user agrees to update.',
|
|
22
|
+
inputSchema: {
|
|
23
|
+
type: 'object' as const,
|
|
24
|
+
properties: {
|
|
25
|
+
global: {
|
|
26
|
+
type: 'boolean',
|
|
27
|
+
description:
|
|
28
|
+
'If true, update the global installation (npm install -g). If false, update locally. Default: true.',
|
|
29
|
+
},
|
|
30
|
+
},
|
|
31
|
+
required: [],
|
|
32
|
+
},
|
|
33
|
+
},
|
|
34
|
+
];
|
package/src/tools/worktrees.ts
CHANGED
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Git Worktree Tool Definitions
|
|
3
|
-
*
|
|
4
|
-
* Tools for managing git worktrees:
|
|
5
|
-
* - get_stale_worktrees: Get worktrees that need cleanup
|
|
6
|
-
* - clear_worktree_path: Clear worktree_path from a task after cleanup
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
import type { Tool } from './types.js';
|
|
10
|
-
|
|
11
|
-
export const worktreeTools: Tool[] = [
|
|
12
|
-
{
|
|
13
|
-
name: 'get_stale_worktrees',
|
|
14
|
-
description: `Get worktrees that need cleanup.
|
|
15
|
-
|
|
16
|
-
Returns tasks with worktree_path set where:
|
|
17
|
-
- Task is completed or cancelled (worktree should have been cleaned up)
|
|
18
|
-
- Task has been abandoned (no activity for 24+ hours while in_progress)
|
|
19
|
-
|
|
20
|
-
IMPORTANT: Pass hostname (os.hostname()) to only see worktrees created on THIS machine.
|
|
21
|
-
Worktrees created on other machines cannot be removed locally.
|
|
22
|
-
|
|
23
|
-
For each stale worktree:
|
|
24
|
-
1. Run: git worktree remove <worktree_path>
|
|
25
|
-
2. Call: clear_worktree_path(task_id)`,
|
|
26
|
-
inputSchema: {
|
|
27
|
-
type: 'object',
|
|
28
|
-
properties: {
|
|
29
|
-
project_id: {
|
|
30
|
-
type: 'string',
|
|
31
|
-
description: 'Project UUID',
|
|
32
|
-
},
|
|
33
|
-
hostname: {
|
|
34
|
-
type: 'string',
|
|
35
|
-
description: 'Machine hostname (os.hostname()). Only returns worktrees created on this machine, preventing attempts to clean up worktrees on other machines.',
|
|
36
|
-
},
|
|
37
|
-
limit: {
|
|
38
|
-
type: 'number',
|
|
39
|
-
description: 'Max worktrees to return (default: 50)',
|
|
40
|
-
},
|
|
41
|
-
offset: {
|
|
42
|
-
type: 'number',
|
|
43
|
-
description: 'Number of worktrees to skip for pagination (default: 0)',
|
|
44
|
-
},
|
|
45
|
-
},
|
|
46
|
-
required: ['project_id'],
|
|
47
|
-
},
|
|
48
|
-
},
|
|
49
|
-
{
|
|
50
|
-
name: 'clear_worktree_path',
|
|
51
|
-
description: `Clear the worktree_path from a task after cleanup.
|
|
52
|
-
|
|
53
|
-
Call this AFTER removing the worktree with git worktree remove.
|
|
54
|
-
This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
|
|
55
|
-
inputSchema: {
|
|
56
|
-
type: 'object',
|
|
57
|
-
properties: {
|
|
58
|
-
task_id: {
|
|
59
|
-
type: 'string',
|
|
60
|
-
description: 'Task UUID',
|
|
61
|
-
},
|
|
62
|
-
},
|
|
63
|
-
required: ['task_id'],
|
|
64
|
-
},
|
|
65
|
-
},
|
|
66
|
-
];
|
|
1
|
+
/**
|
|
2
|
+
* Git Worktree Tool Definitions
|
|
3
|
+
*
|
|
4
|
+
* Tools for managing git worktrees:
|
|
5
|
+
* - get_stale_worktrees: Get worktrees that need cleanup
|
|
6
|
+
* - clear_worktree_path: Clear worktree_path from a task after cleanup
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import type { Tool } from './types.js';
|
|
10
|
+
|
|
11
|
+
export const worktreeTools: Tool[] = [
|
|
12
|
+
{
|
|
13
|
+
name: 'get_stale_worktrees',
|
|
14
|
+
description: `Get worktrees that need cleanup.
|
|
15
|
+
|
|
16
|
+
Returns tasks with worktree_path set where:
|
|
17
|
+
- Task is completed or cancelled (worktree should have been cleaned up)
|
|
18
|
+
- Task has been abandoned (no activity for 24+ hours while in_progress)
|
|
19
|
+
|
|
20
|
+
IMPORTANT: Pass hostname (os.hostname()) to only see worktrees created on THIS machine.
|
|
21
|
+
Worktrees created on other machines cannot be removed locally.
|
|
22
|
+
|
|
23
|
+
For each stale worktree:
|
|
24
|
+
1. Run: git worktree remove <worktree_path>
|
|
25
|
+
2. Call: clear_worktree_path(task_id)`,
|
|
26
|
+
inputSchema: {
|
|
27
|
+
type: 'object',
|
|
28
|
+
properties: {
|
|
29
|
+
project_id: {
|
|
30
|
+
type: 'string',
|
|
31
|
+
description: 'Project UUID',
|
|
32
|
+
},
|
|
33
|
+
hostname: {
|
|
34
|
+
type: 'string',
|
|
35
|
+
description: 'Machine hostname (os.hostname()). Only returns worktrees created on this machine, preventing attempts to clean up worktrees on other machines.',
|
|
36
|
+
},
|
|
37
|
+
limit: {
|
|
38
|
+
type: 'number',
|
|
39
|
+
description: 'Max worktrees to return (default: 50)',
|
|
40
|
+
},
|
|
41
|
+
offset: {
|
|
42
|
+
type: 'number',
|
|
43
|
+
description: 'Number of worktrees to skip for pagination (default: 0)',
|
|
44
|
+
},
|
|
45
|
+
},
|
|
46
|
+
required: ['project_id'],
|
|
47
|
+
},
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
name: 'clear_worktree_path',
|
|
51
|
+
description: `Clear the worktree_path from a task after cleanup.
|
|
52
|
+
|
|
53
|
+
Call this AFTER removing the worktree with git worktree remove.
|
|
54
|
+
This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
|
|
55
|
+
inputSchema: {
|
|
56
|
+
type: 'object',
|
|
57
|
+
properties: {
|
|
58
|
+
task_id: {
|
|
59
|
+
type: 'string',
|
|
60
|
+
description: 'Task UUID',
|
|
61
|
+
},
|
|
62
|
+
},
|
|
63
|
+
required: ['task_id'],
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
];
|