@we-scrum/cli 1.0.0 → 1.0.2
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/README.md +63 -0
- package/dist/cli.js +43 -35
- package/package.json +14 -12
- package/src/cli.ts +2 -4
- package/src/{auth-helper.ts → helpers/auth-helper.ts} +33 -22
- package/src/{firebase-helper.ts → helpers/firebase-helper.ts} +1 -1
- package/src/helpers/index.ts +4 -0
- package/src/helpers/we-scrum.helper.ts +240 -0
- package/src/mcp-server/index.ts +1 -0
- package/src/mcp-server/mcp-server.ts +82 -0
- package/src/mcp-server/tools/complete-task.ts +6 -0
- package/src/mcp-server/tools/get-next-task.ts +149 -0
- package/src/mcp-server/tools/get-unit-test-guidelines.ts +15 -0
- package/src/mcp-server/tools/index.ts +4 -0
- package/src/mcp-server/tools/start-task.ts +6 -0
- package/tsconfig.json +2 -4
- package/src/mcp-server.ts +0 -127
- package/src/we-scrum.service.ts +0 -107
- /package/src/{settings-helper.ts → helpers/settings-helper.ts} +0 -0
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# @we-scrum/cli
|
|
2
|
+
|
|
3
|
+
Command-line tool and MCP server for the [we-scrum](https://github.com/BUONJG/we-scrum) application.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @we-scrum/cli
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Authentication
|
|
12
|
+
|
|
13
|
+
Authentication uses Google OAuth2. Credentials are stored locally in `~/.we-scrum.json` and refreshed automatically on each use.
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
we-scrum login # Authenticate with your Google account
|
|
17
|
+
we-scrum logout # Remove stored credentials
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Commands
|
|
21
|
+
|
|
22
|
+
### Select a project
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
we-scrum use-project # Interactive project picker
|
|
26
|
+
we-scrum use-project --projectId <id> # Set project directly
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The selected project is persisted in `~/.we-scrum.json` and used by all subsequent commands.
|
|
30
|
+
|
|
31
|
+
### MCP server
|
|
32
|
+
|
|
33
|
+
Start the we-scrum MCP server over stdio transport:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
we-scrum mcp
|
|
37
|
+
we-scrum mcp --projectId <id> # Override the active project for this session
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## MCP integration
|
|
41
|
+
|
|
42
|
+
Add the following to your MCP client configuration (e.g. Claude Desktop):
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"we-scrum": {
|
|
48
|
+
"command": "we-scrum",
|
|
49
|
+
"args": ["mcp"]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Available tools
|
|
56
|
+
|
|
57
|
+
| Tool | Description |
|
|
58
|
+
|------|-------------|
|
|
59
|
+
| `get_next_task` | Get the next pending task (status: ToDo) for a story, including its description, type template, section analysis, and the IDs needed to start or complete it. |
|
|
60
|
+
|
|
61
|
+
## Requirements
|
|
62
|
+
|
|
63
|
+
- Node.js 22+
|