hivecode-mcp 0.12.2 → 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.
Files changed (62) hide show
  1. package/HIVE_RULES.md +11 -40
  2. package/LICENSE +21 -21
  3. package/README.md +421 -167
  4. package/core.js +91 -91
  5. package/docs/ALWAYS_ON.md +310 -0
  6. package/docs/GITHUB_WORKFLOW.md +334 -0
  7. package/docs/HIVE_RULES.md +41 -41
  8. package/docs/MCP.md +157 -118
  9. package/docs/QUICKSTART.md +266 -0
  10. package/docs/SELF_HOSTING.md +256 -256
  11. package/docs/SLACK_SETUP.md +450 -0
  12. package/docs/TROUBLESHOOTING.md +87 -0
  13. package/hive-activity.js +336 -310
  14. package/hive-await.js +207 -0
  15. package/hive-branch.js +686 -0
  16. package/hive-busy.js +88 -88
  17. package/hive-coord.js +110 -110
  18. package/hive-gate.js +135 -135
  19. package/hive-github.js +1904 -0
  20. package/hive-hook-install.js +179 -103
  21. package/hive-instructions.js +74 -66
  22. package/hive-listen.js +81 -0
  23. package/hive-mailbox.js +520 -386
  24. package/hive-mcp-http.js +580 -0
  25. package/hive-mcp.js +579 -137
  26. package/hive-mux-proto.js +58 -58
  27. package/hive-mux.js +350 -350
  28. package/hive-notify.js +233 -0
  29. package/hive-obligations.js +247 -247
  30. package/hive-pr-staleness.js +189 -189
  31. package/hive-pr.js +350 -0
  32. package/hive-privacy.js +327 -288
  33. package/hive-receipts.js +233 -233
  34. package/hive-relay-health.js +230 -225
  35. package/hive-room-key.js +209 -0
  36. package/hive-secrets.js +89 -0
  37. package/hive-session.js +114 -0
  38. package/hive-setup.js +558 -445
  39. package/hive-slack-agent.js +396 -0
  40. package/hive-slack.js +1809 -0
  41. package/hive-stdio.js +172 -168
  42. package/hive-stop-hook.js +293 -241
  43. package/hive-throttle.js +118 -118
  44. package/hive-time.js +71 -0
  45. package/hive-update.js +58 -58
  46. package/hive-version.js +110 -59
  47. package/hive-webhook.js +54 -0
  48. package/icr-merge.js +58 -58
  49. package/icr.js +851 -745
  50. package/lang-json.js +211 -211
  51. package/lang-ruby.js +230 -230
  52. package/lang-toml.js +136 -136
  53. package/lang-yaml.js +183 -183
  54. package/limits.js +413 -394
  55. package/package.json +189 -164
  56. package/reconcile.cjs +614 -477
  57. package/slack-app-manifest-agent.json +61 -0
  58. package/slack-app-manifest-inbound.json +36 -0
  59. package/slack-app-manifest.json +27 -0
  60. package/substrate.js +252 -252
  61. package/sync.js +1956 -177
  62. package/grm-link.cjs +0 -141
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, set by Ganesh 19 Sep 2026
15
-
16
- Before you build any new feature, post in the room, **before your first edit**:
17
-
18
- 1. **Who uses it, and how.** Name the person or agent and the moment they reach for it.
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
- This is not process for its own sake. **Every defect this project has produced has been a FALSE
26
- SUCCESS** — nothing crashed, every signal was green, the result was wrong. That class is never
27
- caught by testing the happy path afterwards. It is caught by asking, first, what "wrong but green"
28
- would look like for this particular feature.
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
- node hive-say.js <yourName> "taking auth.js: adding login validation"
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
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Hivecode
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Hivecode
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.