@rusha/task-master 0.1.6 → 0.1.7
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 +85 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# @rusha/task-master
|
|
2
|
+
|
|
3
|
+
**Task Master — contract-engineering governance and delivery tracking CLI**
|
|
4
|
+
|
|
5
|
+
`tm` is the command-line interface for [Task Master](https://github.com/Rusha-Corp/task-master), a contract-engineering governance platform that tracks work packets, evidence, handoffs, and delivery gates.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install -g @rusha/task-master
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Or use directly with npx:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx @rusha/task-master <command>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Commands
|
|
20
|
+
|
|
21
|
+
### `tm login`
|
|
22
|
+
|
|
23
|
+
Authenticate via OIDC PKCE through your browser. Opens a loopback server on `localhost` and exchanges the authorization code for a refresh token, stored locally at `~/.config/task-master/credentials.json` with mode `0600`.
|
|
24
|
+
|
|
25
|
+
### `tm logout`
|
|
26
|
+
|
|
27
|
+
Clears stored credentials.
|
|
28
|
+
|
|
29
|
+
### `tm init --project <id>`
|
|
30
|
+
|
|
31
|
+
Creates a `.task-master.json` config file in the current workspace. This file stores the API URL and project ID — no secrets.
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
tm init --project my-project
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### `tm sync [--dry-run] [--root <dir>]`
|
|
38
|
+
|
|
39
|
+
Syncs your `.contract-engineering/` YAML records (work packets, evidence, handoffs, decisions) into Task Master. Runs the ce-sync engine in-process, so it works from any workspace with a `.contract-engineering/` directory.
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
tm sync # sync from current directory
|
|
43
|
+
tm sync --dry-run # format check only, no API calls
|
|
44
|
+
tm sync --root ../other # sync from a different workspace
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### `tm status [--root <dir>]`
|
|
48
|
+
|
|
49
|
+
Shows the current workstream, packet states, and gate status for your project.
|
|
50
|
+
|
|
51
|
+
### `tm mcp [--root <dir>]`
|
|
52
|
+
|
|
53
|
+
Starts a stdio MCP server that exposes board, packet, evidence, and handoff tools to AI agents. Register it in your MCP client config:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"mcpServers": {
|
|
58
|
+
"task-master": {
|
|
59
|
+
"command": "tm",
|
|
60
|
+
"args": ["mcp"]
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Available MCP tools include: `list_tasks`, `list_packets`, `get_packet`, `claim_packet`, `transition_state`, `submit_evidence`, `request_handoff`, `review_handoff`, `verify_evidence`, `list_projects`, and more.
|
|
67
|
+
|
|
68
|
+
## Quick start
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
npx @rusha/task-master login
|
|
72
|
+
npx @rusha/task-master init --project my-project
|
|
73
|
+
npx @rusha/task-master sync
|
|
74
|
+
npx @rusha/task-master status
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Requirements
|
|
78
|
+
|
|
79
|
+
- Node.js 22 or later
|
|
80
|
+
- A Task Master deployment (API URL configured via `tm init`)
|
|
81
|
+
|
|
82
|
+
## Learn more
|
|
83
|
+
|
|
84
|
+
- [Repository](https://github.com/Rusha-Corp/task-master)
|
|
85
|
+
- [Architecture](https://github.com/Rusha-Corp/task-master/blob/main/docs/ARCHITECTURE.md)
|