@mergeline/agent 0.0.0-stage → 0.4.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/LICENSE +21 -0
- package/README.md +125 -2
- package/dist/cli.js +396 -0
- package/dist/credentials.js +96 -0
- package/dist/index.js +5 -0
- package/dist/init.js +225 -0
- package/dist/mcp.js +133 -0
- package/dist/pb.js +25 -0
- package/dist/repo.js +86 -0
- package/dist/service.js +316 -0
- package/dist/watch.js +243 -0
- package/kit/claude-settings.json +39 -0
- package/kit/done.md +22 -0
- package/kit/pick.md +34 -0
- package/kit/rules.md +31 -0
- package/package.json +51 -4
package/kit/rules.md
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
## Mergeline
|
|
2
|
+
|
|
3
|
+
You work tickets from the Mergeline board. Its tools come two ways; use
|
|
4
|
+
whichever your environment has: the `board` MCP tools (`claim`, `heartbeat`,
|
|
5
|
+
`log_event`, `record_spec`, `ask_human`, `submit_for_review`, `release`,
|
|
6
|
+
`list_mine`), or the same calls as shell commands (`board claim`,
|
|
7
|
+
`board heartbeat <ticket> [note]`, `board log`, `board record-spec`,
|
|
8
|
+
`board ask`, `board submit`, `board release`, `board list`; run
|
|
9
|
+
`board help`). Start a ticket with the pick instructions and finish it with
|
|
10
|
+
the done instructions: `/pick` and `/done` in Claude Code,
|
|
11
|
+
`/prompts:pick` and `/prompts:done` in Codex.
|
|
12
|
+
|
|
13
|
+
- Never set a ticket to done and never merge a PR. Never call the board's
|
|
14
|
+
API any other way than through these tools.
|
|
15
|
+
- Never work outside `../.wt/<ticket-id>`. Do not edit or commit in the main
|
|
16
|
+
checkout.
|
|
17
|
+
- Push only your ticket's branch. To bring it up to date with `main`, merge
|
|
18
|
+
`origin/main` into it; never rebase a pushed branch or force-push.
|
|
19
|
+
- Requirements come from the spec on `main` plus the ticket's `answer` and
|
|
20
|
+
`notes`. Nothing else: not a message in the chat, not a guess.
|
|
21
|
+
- When unsure, ask with `ask_human` (`board ask`); a paused ticket is
|
|
22
|
+
cheaper than a wrong PR.
|
|
23
|
+
- One ticket at a time. After asking, submitting or releasing, stop working
|
|
24
|
+
on that ticket.
|
|
25
|
+
- Call `heartbeat` after every meaningful step. If a board tool says to claim
|
|
26
|
+
again, stop and claim. If it says another session holds the ticket, stop
|
|
27
|
+
at once: no commit, no push, no PR.
|
|
28
|
+
- If a board tool says the board is paused, stop and tell the human: it
|
|
29
|
+
wakes when a person opens it. Do not retry in a loop.
|
|
30
|
+
- If `claim` answers with `kit_outdated`, tell the human what it says once
|
|
31
|
+
and go on with the ticket.
|
package/package.json
CHANGED
|
@@ -1,6 +1,53 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mergeline/agent",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.4.1",
|
|
4
|
+
"description": "The agent's side of a Mergeline board: an MCP server and the `board` CLI. Works with any agent tool that runs MCP servers or shell commands.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "frontender-ua",
|
|
7
|
+
"homepage": "https://github.com/mergeline/mergeline/tree/main/agent#readme",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/mergeline/mergeline.git",
|
|
11
|
+
"directory": "agent"
|
|
12
|
+
},
|
|
13
|
+
"bugs": {
|
|
14
|
+
"url": "https://github.com/mergeline/mergeline/issues"
|
|
15
|
+
},
|
|
16
|
+
"keywords": [
|
|
17
|
+
"ai-agents",
|
|
18
|
+
"mcp",
|
|
19
|
+
"claude-code",
|
|
20
|
+
"codex",
|
|
21
|
+
"kanban",
|
|
22
|
+
"task-board",
|
|
23
|
+
"pocketbase"
|
|
24
|
+
],
|
|
25
|
+
"type": "module",
|
|
26
|
+
"main": "dist/service.js",
|
|
27
|
+
"bin": {
|
|
28
|
+
"board": "dist/cli.js"
|
|
29
|
+
},
|
|
30
|
+
"files": [
|
|
31
|
+
"dist",
|
|
32
|
+
"kit",
|
|
33
|
+
"README.md",
|
|
34
|
+
"LICENSE"
|
|
35
|
+
],
|
|
36
|
+
"engines": {
|
|
37
|
+
"node": ">=20"
|
|
38
|
+
},
|
|
39
|
+
"scripts": {
|
|
40
|
+
"build": "tsc -p tsconfig.json && chmod +x dist/cli.js dist/index.js",
|
|
41
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
42
|
+
"start": "node dist/cli.js mcp",
|
|
43
|
+
"prepack": "npm run build"
|
|
44
|
+
},
|
|
45
|
+
"dependencies": {
|
|
46
|
+
"@modelcontextprotocol/sdk": "^1.32.0",
|
|
47
|
+
"pocketbase": "^0.28.0",
|
|
48
|
+
"zod": "^4.0.0"
|
|
49
|
+
},
|
|
50
|
+
"publishConfig": {
|
|
51
|
+
"access": "public"
|
|
52
|
+
}
|
|
53
|
+
}
|