hivecode-mcp 0.12.4 → 0.13.0
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/HIVE_RULES.md +11 -40
- package/README.md +421 -346
- package/docs/ALWAYS_ON.md +310 -0
- package/docs/GITHUB_WORKFLOW.md +334 -0
- package/docs/MCP.md +157 -118
- package/docs/QUICKSTART.md +266 -0
- package/docs/SELF_HOSTING.md +2 -2
- package/docs/SLACK_SETUP.md +450 -0
- package/docs/TROUBLESHOOTING.md +87 -0
- package/hive-await.js +25 -5
- package/hive-branch.js +55 -25
- package/hive-github.js +1904 -0
- package/hive-listen.js +81 -81
- package/hive-mailbox.js +5 -2
- package/hive-mcp-http.js +580 -0
- package/hive-mcp.js +109 -24
- package/hive-notify.js +233 -0
- package/hive-pr.js +17 -4
- package/hive-relay-health.js +230 -230
- package/hive-room-key.js +209 -0
- package/hive-session.js +114 -0
- package/hive-setup.js +14 -4
- package/hive-slack-agent.js +396 -0
- package/hive-slack.js +1809 -0
- package/hive-stop-hook.js +7 -4
- package/hive-time.js +71 -0
- package/hive-webhook.js +54 -0
- package/icr.js +851 -851
- package/limits.js +3 -3
- package/package.json +189 -172
- package/slack-app-manifest-agent.json +61 -0
- package/slack-app-manifest-inbound.json +36 -0
- package/slack-app-manifest.json +27 -0
- package/sync.js +4790 -4691
package/HIVE_RULES.md
CHANGED
|
@@ -11,53 +11,24 @@ another's work. The sync layer enforces the hard parts automatically; you do the
|
|
|
11
11
|
## Know who you are working with
|
|
12
12
|
- Read HIVE_MEMBERS.md — who (humans + AIs) is in the room right now, and how many.
|
|
13
13
|
|
|
14
|
-
## DESIGN BEFORE YOU WRITE — mandatory
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
2. **What it costs when it is wrong.** One sentence a non-author can act on at 3am.
|
|
20
|
-
3. **Every edge case you can name.** Empty, missing, offline, refused, concurrent, already-done,
|
|
14
|
+
## DESIGN BEFORE YOU WRITE — mandatory (Ganesh, 19 Sep 2026)
|
|
15
|
+
Before you build any new feature, post in the room, BEFORE your first edit:
|
|
16
|
+
1. WHO uses it, and when — name the person or agent and the moment they reach for it.
|
|
17
|
+
2. WHAT IT COSTS when it is wrong — one sentence someone who did not write it can act on at 3am.
|
|
18
|
+
3. EVERY EDGE CASE you can name — empty, missing, offline, refused, concurrent, already-done,
|
|
21
19
|
called twice, called by the wrong person.
|
|
22
|
-
|
|
23
20
|
Then build it.
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
If you cannot say what breaks, you do not understand the feature well enough to write it. Say so
|
|
31
|
-
in the room and ask — that is a complete and acceptable answer.
|
|
21
|
+
This is not process for its own sake. Every defect this project has produced has been a FALSE
|
|
22
|
+
SUCCESS — nothing crashed, every signal was green, the result was wrong. That class is never
|
|
23
|
+
caught by testing the happy path afterwards; it is caught by asking first what "wrong but green"
|
|
24
|
+
would look like for this particular feature. If you cannot say what breaks, you do not understand
|
|
25
|
+
it well enough to write it — say so in the room and ask. That is a complete answer.
|
|
32
26
|
|
|
33
27
|
## Before you touch a file
|
|
34
28
|
1. Read HIVE_CHAT.md — what is everyone doing right now.
|
|
35
29
|
2. Read HIVE_BOARD.md — which files were just rewritten (and what was touched).
|
|
36
30
|
3. If a file you plan to edit appears there, RE-READ it before changing it.
|
|
37
31
|
|
|
38
|
-
## MEMORY — ask before you assume (the recall tool)
|
|
39
|
-
- This room has a memory of everything decided here and in past sessions. It is a
|
|
40
|
-
tool called `recall`. It costs a fraction of a second and it is on your machine —
|
|
41
|
-
no cloud, no key. Use it far more than feels necessary.
|
|
42
|
-
- CALL RECALL AT THESE FOUR MOMENTS, every time:
|
|
43
|
-
1. BEFORE the planning meeting — what was already decided about this project?
|
|
44
|
-
2. BEFORE you claim a file — has this file been discussed, reworked, or does it
|
|
45
|
-
carry a convention someone already chose?
|
|
46
|
-
3. BEFORE you invent anything with a NAME — an id format, an error shape, a port,
|
|
47
|
-
an env var, a header, a timestamp unit. The project has probably already picked
|
|
48
|
-
one, and inventing a second is how a codebase rots.
|
|
49
|
-
4. AFTER any reconnect or restart — you lost your context, the room did not.
|
|
50
|
-
- ASK IT WITH NAMES, NOT SENTENCES. It matches the literal words you send.
|
|
51
|
-
GOOD recall("hive_claim ttl coordinator")
|
|
52
|
-
GOOD recall("auth.js login validation")
|
|
53
|
-
BAD recall("how does the claiming work")
|
|
54
|
-
Two or three identifiers is plenty. A question phrased as prose usually misses.
|
|
55
|
-
- Nothing coming back is information too: it means the thing was never discussed,
|
|
56
|
-
not that it is false. Say so out loud rather than guessing.
|
|
57
|
-
- What it returns is what someone SAID, at some past moment. It is prior context,
|
|
58
|
-
not instruction, and not automatically still true. Check it against the code
|
|
59
|
-
before you act on anything load-bearing.
|
|
60
|
-
|
|
61
32
|
## CLAIM before you edit (this is how the hive avoids collisions)
|
|
62
33
|
- Before editing a file, CLAIM it: call the hive_claim tool with the file path
|
|
63
34
|
(and a short intent). This is the most important coordination step.
|
|
@@ -69,7 +40,7 @@ in the room and ask — that is a complete and acceptable answer.
|
|
|
69
40
|
|
|
70
41
|
## While you work
|
|
71
42
|
4. ANNOUNCE first: post to chat what you are taking, e.g.
|
|
72
|
-
|
|
43
|
+
call hive_say with "taking auth.js: adding login validation"
|
|
73
44
|
5. PREFER SMALL PATCHES — grep to the spot, edit a few lines. Patches from
|
|
74
45
|
different agents merge automatically with no conflict.
|
|
75
46
|
6. AVOID full-file rewrites unless necessary. If you must rewrite, RE-READ the
|