@hivey/cli 0.0.0-stage → 0.9.36

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 (83) hide show
  1. package/README.md +235 -2
  2. package/bin/hivey.js +98 -0
  3. package/native/darwin-arm64/hivey +0 -0
  4. package/package.json +36 -4
  5. package/platforms.json +3 -0
  6. package/repo/LICENSE +201 -0
  7. package/repo/NOTICE +18 -0
  8. package/repo/README.md +148 -0
  9. package/repo/install.sh +365 -0
  10. package/repo/pets/README.md +25 -0
  11. package/repo/pets/hivey-dot/CLAUDE.md +55 -0
  12. package/repo/pets/hivey-dot/build.sh +34 -0
  13. package/repo/pets/hivey-dot/main.swift +750 -0
  14. package/repo/pets/hivey-h/CLAUDE.md +75 -0
  15. package/repo/pets/hivey-h/build.sh +34 -0
  16. package/repo/pets/hivey-h/main.swift +739 -0
  17. package/repo/pets/hivey-prompt/CLAUDE.md +59 -0
  18. package/repo/pets/hivey-prompt/build.sh +34 -0
  19. package/repo/pets/hivey-prompt/main.swift +691 -0
  20. package/repo/pets/pet.py +288 -0
  21. package/repo/pets/shared/HiveyWatch.swift +437 -0
  22. package/repo/pets/test_pet.py +122 -0
  23. package/repo/plugins/README.md +108 -0
  24. package/repo/plugins/agent-creator/herdr-plugin.toml +17 -0
  25. package/repo/plugins/dashboard/dashboard.py +507 -0
  26. package/repo/plugins/dashboard/herdr-plugin.toml +14 -0
  27. package/repo/plugins/dashboard/test_dashboard.py +134 -0
  28. package/repo/plugins/github/github.py +261 -0
  29. package/repo/plugins/github/herdr-plugin.toml +14 -0
  30. package/repo/plugins/github/test_github.py +49 -0
  31. package/repo/plugins/skills/herdr-plugin.toml +11 -0
  32. package/repo/plugins/skills/skills.md +41 -0
  33. package/repo/plugins/slack-relay/connect.py +198 -0
  34. package/repo/plugins/slack-relay/create_channel.py +134 -0
  35. package/repo/plugins/slack-relay/herdr-plugin.toml +15 -0
  36. package/repo/plugins/slack-relay/relay.py +401 -0
  37. package/repo/plugins/slack-relay/slack-app-manifest.json +30 -0
  38. package/repo/plugins/slack-relay/test_connect.py +66 -0
  39. package/repo/plugins/slack-relay/test_create_channel.py +61 -0
  40. package/repo/plugins/slack-relay/test_relay.py +254 -0
  41. package/repo/plugins/swarm-creator/herdr-plugin.toml +17 -0
  42. package/repo/plugins/swarm-watcher/dashboard.py +333 -0
  43. package/repo/plugins/swarm-watcher/herdr-plugin.toml +16 -0
  44. package/repo/plugins/swarm-watcher/usage.py +129 -0
  45. package/repo/plugins/swarm-watcher/watcher.py +191 -0
  46. package/repo/plugins/team-template/herdr-plugin.toml +15 -0
  47. package/repo/plugins/team-template/setup.py +211 -0
  48. package/repo/plugins/team-template/test_setup.py +73 -0
  49. package/repo/plugins/tts/herdr-plugin.toml +15 -0
  50. package/repo/skills/herdr/SKILL.md +214 -0
  51. package/repo/skills/hivey/SKILL.md +322 -0
  52. package/repo/skills/hivey/scripts/handoff.py +27 -0
  53. package/repo/skills/hivey/scripts/new_wiki.py +143 -0
  54. package/repo/skills/hivey-agent-creator/SKILL.md +303 -0
  55. package/repo/skills/hivey-agent-creator/references/agent-claude-md.md +256 -0
  56. package/repo/skills/hivey-agent-creator/references/global-guidelines.md +67 -0
  57. package/repo/skills/hivey-agent-creator/references/reviewer-agent.md +35 -0
  58. package/repo/skills/hivey-agent-creator/scripts/agent_context.py +76 -0
  59. package/repo/skills/hivey-agent-creator/scripts/agent_gate.py +78 -0
  60. package/repo/skills/hivey-agent-creator/scripts/setup_agent.py +288 -0
  61. package/repo/skills/hivey-agy/SKILL.md +123 -0
  62. package/repo/skills/hivey-agy/references/gemini-prompting.md +134 -0
  63. package/repo/skills/hivey-agy/scripts/agy_run.py +146 -0
  64. package/repo/skills/hivey-codex/SKILL.md +66 -0
  65. package/repo/skills/hivey-context7/SKILL.md +56 -0
  66. package/repo/skills/hivey-create-wiki/SKILL.md +329 -0
  67. package/repo/skills/hivey-grok/SKILL.md +101 -0
  68. package/repo/skills/hivey-grok/scripts/grok_run.py +139 -0
  69. package/repo/skills/hivey-swarm-creator/SKILL.md +384 -0
  70. package/repo/skills/hivey-swarm-creator/references/agent-claude-md.md +313 -0
  71. package/repo/skills/hivey-swarm-creator/references/archify-report.md +24 -0
  72. package/repo/skills/hivey-swarm-creator/references/dashboard.md +46 -0
  73. package/repo/skills/hivey-swarm-creator/references/retrospective.md +23 -0
  74. package/repo/skills/hivey-swarm-creator/references/shared-rules.md +39 -0
  75. package/repo/skills/hivey-swarm-creator/references/wiki-memory.md +30 -0
  76. package/repo/skills/hivey-swarm-creator/scripts/setup_agent.py +76 -0
  77. package/repo/skills/hivey-swarm-creator/scripts/shared_rules.py +50 -0
  78. package/repo/skills/hivey-swarm-creator/scripts/swarm_tasks.py +171 -0
  79. package/repo/skills/hivey-wiki-ingest/SKILL.md +45 -0
  80. package/repo/skills/hivey-wiki-lint/SKILL.md +38 -0
  81. package/repo/skills/hivey-wiki-list/SKILL.md +46 -0
  82. package/repo/skills/hivey-wiki-log/SKILL.md +45 -0
  83. package/repo/skills/hivey-wiki-query/SKILL.md +44 -0
@@ -0,0 +1,61 @@
1
+ """Tests for create_channel.py's invites (no network: a fake Slack answers)."""
2
+ import json
3
+ import os
4
+ import tempfile
5
+ import unittest
6
+ from pathlib import Path
7
+ from unittest import mock
8
+
9
+ import create_channel
10
+
11
+
12
+ class FakeSlack:
13
+ """Bot B shares #a and #b with the user U1, and #b with U2."""
14
+
15
+ def __init__(self, in_channel=()):
16
+ self.invited = []
17
+ self.in_channel = set(in_channel)
18
+
19
+ def call(self, method, http="POST", **params):
20
+ if method == "auth.test":
21
+ return {"user_id": "B"}
22
+ if method == "conversations.list":
23
+ return {"channels": [{"id": "Ca", "is_member": True}, {"id": "Cb", "is_member": True},
24
+ {"id": "Cc", "is_member": False}]}
25
+ if method == "conversations.members":
26
+ return {"members": {"Ca": ["B", "U1"], "Cb": ["B", "U1", "U2"]}[params["channel"]]}
27
+ if method == "conversations.invite":
28
+ if params["users"] in self.in_channel:
29
+ raise RuntimeError("slack conversations.invite: already_in_channel")
30
+ self.invited.append(params["users"])
31
+ return {"ok": True}
32
+ raise AssertionError(method)
33
+
34
+
35
+ class InviteTest(unittest.TestCase):
36
+ def setUp(self):
37
+ self.dir = tempfile.TemporaryDirectory()
38
+ self.env = mock.patch.dict(os.environ, {"HERDR_PLUGIN_CONFIG_DIR": self.dir.name})
39
+ self.env.start()
40
+
41
+ def tearDown(self):
42
+ self.env.stop()
43
+ self.dir.cleanup()
44
+
45
+ def test_the_person_sharing_most_channels_is_invited_and_remembered(self):
46
+ config = {"token_command": "x"}
47
+ self.assertEqual(create_channel.invitees(FakeSlack(), config), ["U1"])
48
+ saved = json.loads((Path(self.dir.name) / "config.json").read_text())
49
+ self.assertEqual(saved["invite"], ["U1"])
50
+
51
+ def test_configured_people_win(self):
52
+ self.assertEqual(create_channel.invitees(FakeSlack(), {"invite": "U9"}), ["U9"])
53
+
54
+ def test_invite_skips_people_already_there(self):
55
+ slack = FakeSlack(in_channel={"U1"})
56
+ self.assertEqual(create_channel.invite(slack, "Cnew", ["U1", "U2"]), ["U2"])
57
+ self.assertEqual(slack.invited, ["U2"])
58
+
59
+
60
+ if __name__ == "__main__":
61
+ unittest.main()
@@ -0,0 +1,254 @@
1
+ """Tests for the hivey Slack relay: python3 -m unittest plugins/slack-relay/test_relay.py"""
2
+ import json
3
+ import os
4
+ import sys
5
+ import tempfile
6
+ import unittest
7
+ from pathlib import Path
8
+
9
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
10
+ import relay # noqa: E402
11
+
12
+ # Never the real ~/.hivey (its quiet mode, its held posts)
13
+ os.environ["HIVEY_HOME"] = tempfile.mkdtemp()
14
+
15
+ MANIFEST = {
16
+ "slug": "ideas",
17
+ "coordinator": "ideas-coordinator",
18
+ "agents": {"scout": {"herdr_name": "ideas-scout"}, "critic": {"herdr_name": "ideas-critic"}},
19
+ }
20
+
21
+
22
+ class EchoGuards(unittest.TestCase):
23
+ def test_recognizes_the_relays_own_posts(self):
24
+ roles = relay.roster(MANIFEST)
25
+ mirror = relay.format_mirror({"from": "human", "to": "coordinator", "text": "hi"}, roles, "ideas")
26
+ self.assertTrue(relay.is_relay_post(mirror))
27
+ self.assertTrue(relay.is_relay_post(":bust_in_silhouette: *human → coordinator*: hi"))
28
+ self.assertTrue(relay.is_relay_post(relay.format_catch_up(["a", "b"])))
29
+ self.assertTrue(relay.is_relay_post(":crescent_moon: *Quiet mode ended: 13 updates while it was on*"))
30
+ # Agent posts and people's messages still reach the bus.
31
+ self.assertFalse(relay.is_relay_post(":fox_face: *[scout]* found 3"))
32
+ self.assertFalse(relay.is_relay_post("@scout find 3 competitors"))
33
+ self.assertFalse(relay.is_relay_post("*important* → read this"))
34
+
35
+ def test_own_post_is_not_reinjected_when_its_ts_guard_is_lost(self):
36
+ # The 2026-10-17 loop: the catch-up came back from Slack as a "human" message, was
37
+ # mirrored, came back again, and nested ("human → coordinator: human → …").
38
+ with tempfile.TemporaryDirectory() as tmp:
39
+ root = Path(tmp)
40
+ (root / ".swarm").mkdir()
41
+ (root / ".swarm" / "agents.json").write_text(json.dumps(MANIFEST))
42
+ bus = root / ".swarm" / "bus.jsonl"
43
+ bus.write_text("")
44
+ slack, hivey = FakeSlack(), FakeHivey(bus)
45
+ r = relay.Relay(root, slack, hivey, "C1", "masters")
46
+ r.state["last_ts"] = "0"
47
+ slack.inbox.append({"ts": "1.000000", "bot_id": "B1",
48
+ "text": ":crescent_moon: *Quiet mode ended: 3 updates while it was on*"})
49
+ slack.inbox.append({"ts": "2.000000", "bot_id": "B1",
50
+ "text": ":bust_in_silhouette: *human → coordinator*: back"})
51
+ r.step()
52
+ self.assertEqual(hivey.sent, [])
53
+ self.assertEqual(slack.posted, [])
54
+
55
+ def test_a_newer_relay_takes_over(self):
56
+ with tempfile.TemporaryDirectory() as tmp:
57
+ pid_path = Path(tmp) / "slack_relay.pid"
58
+ still_ours = relay.claim(pid_path)
59
+ self.assertTrue(still_ours())
60
+ pid_path.write_text("999999") # another relay started for this swarm
61
+ self.assertFalse(still_ours())
62
+
63
+
64
+ class ParseSlack(unittest.TestCase):
65
+ def test_unaddressed_human_message_goes_to_the_master(self):
66
+ self.assertEqual(relay.parse_slack("how is it going?", MANIFEST),
67
+ ("human", "how is it going?", ["coordinator"]))
68
+
69
+ def test_mentions_broadcast_and_master_aliases(self):
70
+ _, _, targets = relay.parse_slack("@scout and @ideas-critic please, @master fyi", MANIFEST)
71
+ self.assertEqual(targets, ["scout", "critic", "coordinator"])
72
+ _, _, targets = relay.parse_slack("<!here> stop", MANIFEST)
73
+ self.assertEqual(targets, ["@all"])
74
+
75
+ def test_agent_posts_keep_their_sender_and_never_target_themselves(self):
76
+ sender, body, targets = relay.parse_slack("🔭 *[scout]* done @scout @critic", MANIFEST)
77
+ self.assertEqual((sender, body, targets), ("scout", "done @scout @critic", ["critic"]))
78
+ # An agent's unaddressed chatter isn't forwarded to anyone.
79
+ self.assertEqual(relay.parse_slack("*[scout]* thinking", MANIFEST)[2], [])
80
+
81
+
82
+ class Mirror(unittest.TestCase):
83
+ roles = relay.roster(MANIFEST)
84
+
85
+ def msg(self, frm, to, **extra):
86
+ return {"ev": "msg", "id": "m1", "from": frm, "to": to, "swarm": "ideas", "text": "t", **extra}
87
+
88
+ def test_masters_scope_keeps_master_and_human_traffic_only(self):
89
+ keep = relay.should_mirror
90
+ self.assertTrue(keep(self.msg("ideas/scout", "coordinator"), "masters", self.roles, set()))
91
+ self.assertTrue(keep(self.msg("ideas/coordinator", "scout"), "masters", self.roles, set()))
92
+ self.assertTrue(keep(self.msg("ideas/scout", "human"), "masters", self.roles, set()))
93
+ self.assertFalse(keep(self.msg("ideas/scout", "critic"), "masters", self.roles, set()))
94
+ self.assertTrue(keep(self.msg("ideas/scout", "critic"), "all", self.roles, set()))
95
+ self.assertFalse(keep(self.msg("ideas/scout", "coordinator"), "off", self.roles, set()))
96
+
97
+ def test_never_echoes_slack_messages_or_sender_copies(self):
98
+ self.assertFalse(relay.should_mirror(self.msg("human", "coordinator"), "all", self.roles, {"m1"}))
99
+ self.assertFalse(relay.should_mirror(self.msg("ideas/coordinator", "coordinator", copy=True),
100
+ "all", self.roles, set()))
101
+
102
+ def test_format(self):
103
+ text = relay.format_mirror(self.msg("ideas/scout", "coordinator", kind="urgent"), self.roles, "ideas")
104
+ self.assertTrue(text.endswith("*scout → coordinator* *(urgent)*: t"), text)
105
+ other = relay.format_mirror(self.msg("ideas/coordinator", "coordinator", swarm="tonight"),
106
+ self.roles, "ideas")
107
+ self.assertIn("🧭 *coordinator → tonight/coordinator*", other)
108
+
109
+
110
+ class FakeSlack:
111
+ def __init__(self):
112
+ self.inbox, self.posted, self.next_ts = [], [], 100.0
113
+
114
+ def history(self, channel, oldest):
115
+ return [m for m in self.inbox if float(m["ts"]) > float(oldest)]
116
+
117
+ def post(self, channel, text):
118
+ self.next_ts += 1
119
+ ts = f"{self.next_ts:.6f}"
120
+ self.posted.append(text)
121
+ self.inbox.append({"ts": ts, "text": text}) # our own post shows up in history
122
+ return ts
123
+
124
+
125
+ class FakeHivey:
126
+ def __init__(self, bus):
127
+ self.bus, self.sent, self.n = bus, [], 0
128
+
129
+ def send(self, target, text, sender):
130
+ self.n += 1
131
+ mid = f"m{self.n}"
132
+ self.sent.append((target, text, sender))
133
+ frm = "human" if sender == "human" else f"ideas/{sender}"
134
+ with open(self.bus, "a") as f:
135
+ f.write(json.dumps({"ev": "msg", "id": mid, "from": frm, "to": target, "swarm": "ideas",
136
+ "text": text}) + "\n")
137
+ return [mid]
138
+
139
+
140
+ class RoundTrip(unittest.TestCase):
141
+ def test_slack_to_bus_to_slack_without_echo(self):
142
+ with tempfile.TemporaryDirectory() as tmp:
143
+ root = Path(tmp)
144
+ (root / ".swarm").mkdir()
145
+ (root / ".swarm" / "agents.json").write_text(json.dumps(MANIFEST))
146
+ bus = root / ".swarm" / "bus.jsonl"
147
+ bus.write_text("")
148
+ slack, hivey = FakeSlack(), FakeHivey(bus)
149
+ r = relay.Relay(root, slack, hivey, "C1", "masters")
150
+ r.state["last_ts"] = "0"
151
+ slack.inbox.append({"ts": "1.000000", "text": "@scout find 3 competitors"})
152
+ r.step()
153
+ self.assertEqual(hivey.sent, [("scout", "@scout find 3 competitors", "human")])
154
+ self.assertEqual(slack.posted, [], "a message from Slack is not echoed back")
155
+ # An agent answers the master on the bus: mirrored once, and the mirror post
156
+ # coming back through history is not re-injected.
157
+ with open(bus, "a") as f:
158
+ f.write(json.dumps({"ev": "msg", "id": "a1", "from": "ideas/scout",
159
+ "to": "coordinator", "swarm": "ideas", "text": "found 3"}) + "\n")
160
+ f.write('{"ev": "msg", "id": "torn"') # half-written line is left for later
161
+ r.step()
162
+ r.step()
163
+ self.assertEqual(len(slack.posted), 1)
164
+ self.assertIn("scout → coordinator", slack.posted[0])
165
+ self.assertEqual(len(hivey.sent), 1)
166
+ # State survives a restart of the relay.
167
+ again = relay.Relay(root, slack, hivey, "C1", "masters")
168
+ again.step()
169
+ self.assertEqual(len(slack.posted), 1)
170
+ self.assertEqual(len(hivey.sent), 1)
171
+
172
+
173
+ class QuietMode(unittest.TestCase):
174
+ def setUp(self):
175
+ self.tmp = tempfile.TemporaryDirectory()
176
+ self.root = Path(self.tmp.name)
177
+ (self.root / ".swarm").mkdir()
178
+ (self.root / ".swarm" / "agents.json").write_text(json.dumps(MANIFEST))
179
+ self.bus = self.root / ".swarm" / "bus.jsonl"
180
+ self.bus.write_text("")
181
+ self.slack, self.hivey = FakeSlack(), FakeHivey(self.bus)
182
+ self.quiet = True
183
+ self.direct = [] # posts agents held through swarm_slack.py
184
+
185
+ def held_posts(channel):
186
+ taken, self.direct[:] = list(self.direct), []
187
+ return taken
188
+
189
+ self.relay = relay.Relay(self.root, self.slack, self.hivey, "C1", "masters",
190
+ quiet=lambda: self.quiet, held_posts=held_posts)
191
+ self.relay.state["last_ts"] = "0"
192
+
193
+ def tearDown(self):
194
+ self.tmp.cleanup()
195
+
196
+ def agent_reports(self, text):
197
+ with open(self.bus, "a") as f:
198
+ f.write(json.dumps({"ev": "msg", "id": text, "from": "ideas/scout",
199
+ "to": "coordinator", "swarm": "ideas", "text": text}) + "\n")
200
+
201
+ def test_holds_posts_then_sends_one_catch_up(self):
202
+ self.slack.inbox.append({"ts": "1.000000", "text": "@scout keep going overnight"})
203
+ self.agent_reports("found 3")
204
+ self.relay.step()
205
+ self.agent_reports("found 5")
206
+ self.direct.append("*[scout]* posted directly")
207
+ self.relay.step()
208
+ self.assertEqual(self.slack.posted, [], "nothing reaches Slack in quiet mode")
209
+ self.assertEqual(len(self.hivey.sent), 1, "Slack → bus keeps working")
210
+ # Held posts survive a relay restart
211
+ self.relay = relay.Relay(self.root, self.slack, self.hivey, "C1", "masters",
212
+ quiet=lambda: self.quiet, held_posts=lambda _channel: [])
213
+ self.quiet = False
214
+ self.agent_reports("found 8")
215
+ self.relay.step()
216
+ self.assertEqual(len(self.slack.posted), 2)
217
+ catch_up, after = self.slack.posted
218
+ self.assertTrue(catch_up.startswith("🌙 *Quiet mode ended: 2 updates"))
219
+ self.assertIn("found 3", catch_up)
220
+ self.assertIn("found 5", catch_up)
221
+ self.assertIn("found 8", after)
222
+ self.relay.step()
223
+ self.assertEqual(len(self.slack.posted), 2, "the catch-up is sent once")
224
+ self.assertEqual(len(self.hivey.sent), 1, "our catch-up post is not injected back")
225
+
226
+ def test_catch_up_includes_direct_posts(self):
227
+ self.direct.append("*[scout]* posted directly")
228
+ self.quiet = False
229
+ self.relay.step()
230
+ self.assertEqual(len(self.slack.posted), 1)
231
+ self.assertIn("1 update while", self.slack.posted[0])
232
+ self.assertIn("posted directly", self.slack.posted[0])
233
+
234
+ def test_catch_up_is_bounded(self):
235
+ message = relay.format_catch_up([f"line {n}" for n in range(100)])
236
+ self.assertIn("100 updates", message)
237
+ self.assertIn("last 40", message)
238
+ self.assertNotIn("line 59\n", message)
239
+ self.assertTrue(message.endswith("line 99"))
240
+
241
+
242
+ class HeldPostFiles(unittest.TestCase):
243
+ def test_take_held_posts_claims_the_channel_file_once(self):
244
+ held = relay.hivey_dir() / "quiet-held"
245
+ held.mkdir(parents=True, exist_ok=True)
246
+ (held / "C9.jsonl").write_text(json.dumps({"text": "*[a]* one"}) + "\nnot json\n"
247
+ + json.dumps({"text": "*[b]* two"}) + "\n")
248
+ self.assertEqual(relay.take_held_posts("C9"), ["*[a]* one", "*[b]* two"])
249
+ self.assertEqual(relay.take_held_posts("C9"), [])
250
+ self.assertEqual(list(held.iterdir()), [])
251
+
252
+
253
+ if __name__ == "__main__":
254
+ unittest.main()
@@ -0,0 +1,17 @@
1
+ id = "hivey.swarm-creator"
2
+ name = "Swarm creator"
3
+ version = "0.2.0"
4
+ min_herdr_version = "0.9.0"
5
+ description = "Swarm setup provider (built in): a Claude coordinator runs the hivey-swarm-creator skill, designs a team for any task with you (each agent on Claude Code, Codex, Grok or agy), writes the briefs and the wiki, and launches it"
6
+ platforms = ["linux", "macos"]
7
+
8
+ # `hivey swarm new "<task>"` (or `--provider hivey.swarm-creator`), run from the folder the
9
+ # swarm will live in, opens this pane with HIVEY_SETUP_TASK and HIVEY_SETUP_CWD set. The
10
+ # coordinator follows the hivey-swarm-creator skill (shipped with hivey): agrees the team with
11
+ # the user, writes <root>/<agent>/CLAUDE.md, makes the wiki with hivey-create-wiki, then
12
+ # `hivey swarm launch` moves this pane into the swarm's space as its master.
13
+ [[panes]]
14
+ id = "setup"
15
+ title = "swarm setup"
16
+ placement = "tab"
17
+ command = ["sh", "-c", "exec claude --chrome --dangerously-skip-permissions --model opus \"/hivey-swarm-creator Folder: ${HIVEY_SETUP_CWD}\nTask: ${HIVEY_SETUP_TASK}\""]