@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.
Files changed (2) hide show
  1. package/README.md +85 -0
  2. 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)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rusha/task-master",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "Task Master — contract-engineering governance and delivery tracking CLI",
5
5
  "type": "module",
6
6
  "bin": {