@hivey/cli 0.9.61 → 0.9.63
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/native/darwin-arm64/hivey +0 -0
- package/package.json +1 -1
- package/repo/skills/hivey/scripts/new_wiki.py +12 -0
- package/repo/skills/hivey-agent-map/SKILL.md +33 -0
- package/repo/skills/hivey-agent-map/scripts/agent_map.py +10 -0
- package/repo/skills/hivey-agent-map/scripts/office/OutlineEffect.js +539 -0
- package/repo/skills/hivey-agent-map/scripts/office/RoomEnvironment.js +148 -0
- package/repo/skills/hivey-agent-map/scripts/office/loaders/GLTFLoader.js +4663 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-kenney-space-kit.txt +23 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-kenney-space-station-kit.txt +28 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-robot.txt +2 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/astronautA.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/astronautB.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/barrels.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/barrels_rail.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/craft_cargoA.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/craft_racer.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/craft_speederA.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/desk_chairArms.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/desk_computer.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/machine_generator.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/machine_generatorLarge.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/machine_wireless.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/robot.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/satelliteDish_detailed.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/satelliteDish_large.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/Textures/colormap.png.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/chair-cushion-headrest.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/computer-system.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/computer-wide.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/container-flat.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/container-tall.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/container-wide.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/display-wall-wide.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/models/station/pipe-ring-colored.glb.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/music/README.txt +2 -0
- package/repo/skills/hivey-agent-map/scripts/office/music/space.mp3.b64 +1 -0
- package/repo/skills/hivey-agent-map/scripts/office/office.html +181 -0
- package/repo/skills/hivey-agent-map/scripts/office/office.js +814 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/EffectComposer.js +231 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/MaskPass.js +104 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/OutputPass.js +95 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/Pass.js +95 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/RenderPass.js +99 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/ShaderPass.js +77 -0
- package/repo/skills/hivey-agent-map/scripts/office/postprocessing/UnrealBloomPass.js +415 -0
- package/repo/skills/hivey-agent-map/scripts/office/shaders/CopyShader.js +45 -0
- package/repo/skills/hivey-agent-map/scripts/office/shaders/LuminosityHighPassShader.js +66 -0
- package/repo/skills/hivey-agent-map/scripts/office/shaders/OutputShader.js +81 -0
- package/repo/skills/hivey-agent-map/scripts/office/ship.js +578 -0
- package/repo/skills/hivey-agent-map/scripts/office/three.module.min.js +6 -0
- package/repo/skills/hivey-agent-map/scripts/office/utils/BufferGeometryUtils.js +1375 -0
- package/repo/skills/hivey-agent-map/scripts/office/utils/SkeletonUtils.js +413 -0
- package/repo/skills/hivey-agent-map/scripts/office.py +522 -0
- package/repo/skills/hivey-agent-map/scripts/serve.py +190 -9
- package/repo/skills/hivey-create-wiki/SKILL.md +27 -2
- package/repo/skills/hivey-swarm-creator/SKILL.md +4 -0
- package/repo/skills/hivey-swarm-creator/references/wiki-memory.md +3 -0
- package/repo/skills/hivey-wiki-lint/SKILL.md +7 -2
|
@@ -2,15 +2,26 @@
|
|
|
2
2
|
|
|
3
3
|
`hivey agent-map open` starts it (once; later opens reuse it) and opens the pages from
|
|
4
4
|
http://127.0.0.1:<port>/latest/. It listens on 127.0.0.1 only, serves ~/.hivey/agent-map/reports, and
|
|
5
|
-
has
|
|
6
|
-
|
|
7
|
-
|
|
5
|
+
has these actions, answered only for the pages it serves (Origin check), so other web pages can't
|
|
6
|
+
trigger them:
|
|
7
|
+
|
|
8
|
+
POST /hv-refresh `agent_map.py refresh` (free: no model)
|
|
9
|
+
POST /hv-office-refresh `office.py run` in the background (the agent office, /office/)
|
|
10
|
+
POST /hv-office-action {"pane": "wN:p1", "action": "focus" | "compact" | "clear"} for a desk on the
|
|
11
|
+
office page: focus opens the agent's terminal in hivey (and brings the
|
|
12
|
+
terminal app forward); compact/clear type /compact or /clear into an agent
|
|
13
|
+
that is not working
|
|
14
|
+
|
|
15
|
+
While an office page is open (it polls /office/office.json), the office is refreshed every 5 minutes.
|
|
16
|
+
It stops after 2 hours unused. Python standard library only.
|
|
8
17
|
"""
|
|
9
18
|
from __future__ import annotations
|
|
10
19
|
|
|
11
20
|
import http.server
|
|
12
21
|
import json
|
|
13
22
|
import os
|
|
23
|
+
import re
|
|
24
|
+
import shutil
|
|
14
25
|
import subprocess
|
|
15
26
|
import sys
|
|
16
27
|
import threading
|
|
@@ -26,18 +37,159 @@ PREFERRED_PORT = 42817 # unregistered and below macOS's temporary-port range, s
|
|
|
26
37
|
IDLE_SECONDS = 2 * 3600
|
|
27
38
|
PING = "/hv-ping"
|
|
28
39
|
MARK = b"hivey-agent-map"
|
|
40
|
+
VERSION = b"office-2" # bump when the server gains actions, so `ensure` replaces an older one
|
|
41
|
+
OFFICE_EVERY = 300 # seconds between office refreshes while its page is open
|
|
42
|
+
OFFICE_WATCHED = 600 # the page counts as open for this long after its last poll
|
|
43
|
+
OFFICE_JSON = REPORTS / "office" / "office.json"
|
|
44
|
+
PANE = re.compile(r"^[\w-]{1,24}:[\w-]{1,24}$")
|
|
45
|
+
TERMINAL_APPS = {"Apple_Terminal": "Terminal", "iTerm.app": "iTerm", "ghostty": "Ghostty",
|
|
46
|
+
"WezTerm": "WezTerm", "WarpTerminal": "Warp", "vscode": "Visual Studio Code"}
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def hivey_bin() -> str | None:
|
|
50
|
+
exe = os.environ.get("HIVEY_BIN")
|
|
51
|
+
return exe if exe and os.path.isfile(exe) else shutil.which("hivey")
|
|
52
|
+
|
|
29
53
|
|
|
54
|
+
def start_office_refresh(llm: bool = True) -> None:
|
|
55
|
+
"""office.py run in the background (it holds its own lock, so overlapping starts are dropped)."""
|
|
56
|
+
cmd = [sys.executable, "-I", str(SCRIPTS / "office.py"), "run"] + ([] if llm else ["--no-llm"])
|
|
57
|
+
with open(STATE / "office.log", "a") as fh:
|
|
58
|
+
subprocess.Popen(cmd, stdin=subprocess.DEVNULL, stdout=fh, stderr=fh, start_new_session=True)
|
|
30
59
|
|
|
31
|
-
|
|
60
|
+
|
|
61
|
+
def request_office_refresh(port: int) -> None:
|
|
62
|
+
req = urllib.request.Request(f"http://127.0.0.1:{port}/hv-office-refresh", data=b"{}", method="POST",
|
|
63
|
+
headers={"Origin": f"http://127.0.0.1:{port}", "Content-Type": "application/json"})
|
|
64
|
+
try:
|
|
65
|
+
urllib.request.urlopen(req, timeout=3).read()
|
|
66
|
+
except OSError:
|
|
67
|
+
pass
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def client_ttys() -> list[str]:
|
|
71
|
+
"""ttys of running hivey clients (the TUI), newest first."""
|
|
72
|
+
out = subprocess.run(["ps", "-axo", "pid=,tty=,command="], capture_output=True, text=True, timeout=5).stdout
|
|
73
|
+
found = []
|
|
74
|
+
for line in out.splitlines():
|
|
75
|
+
f = line.split(None, 2)
|
|
76
|
+
if len(f) < 3 or f[1] in ("??", "-"):
|
|
77
|
+
continue
|
|
78
|
+
args = f[2].split()
|
|
79
|
+
if os.path.basename(args[0]) == "hivey" and (len(args) == 1 or args[1] in ("attach", "--session", "-s")):
|
|
80
|
+
found.append((int(f[0]), "/dev/" + f[1]))
|
|
81
|
+
return [tty for _, tty in sorted(found, reverse=True)]
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
RAISE_TERMINAL = """
|
|
85
|
+
on run argv
|
|
86
|
+
set wanted to item 1 of argv
|
|
87
|
+
tell application "Terminal"
|
|
88
|
+
repeat with w in windows
|
|
89
|
+
repeat with t in tabs of w
|
|
90
|
+
if tty of t is wanted then
|
|
91
|
+
set selected of t to true
|
|
92
|
+
set index of w to 1
|
|
93
|
+
activate
|
|
94
|
+
return "ok"
|
|
95
|
+
end if
|
|
96
|
+
end repeat
|
|
97
|
+
end repeat
|
|
98
|
+
end tell
|
|
99
|
+
return "missing"
|
|
100
|
+
end run
|
|
101
|
+
"""
|
|
102
|
+
RAISE_ITERM = """
|
|
103
|
+
on run argv
|
|
104
|
+
set wanted to item 1 of argv
|
|
105
|
+
tell application "iTerm2"
|
|
106
|
+
repeat with w in windows
|
|
107
|
+
repeat with t in tabs of w
|
|
108
|
+
repeat with s in sessions of t
|
|
109
|
+
if tty of s is wanted then
|
|
110
|
+
select w
|
|
111
|
+
select t
|
|
112
|
+
select s
|
|
113
|
+
activate
|
|
114
|
+
return "ok"
|
|
115
|
+
end if
|
|
116
|
+
end repeat
|
|
117
|
+
end repeat
|
|
118
|
+
end repeat
|
|
119
|
+
end tell
|
|
120
|
+
return "missing"
|
|
121
|
+
end run
|
|
122
|
+
"""
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def raise_terminal() -> None:
|
|
126
|
+
"""Bring the terminal window (and tab) running hivey to the front, not just the terminal app."""
|
|
127
|
+
app = TERMINAL_APPS.get(os.environ.get("TERM_PROGRAM", ""), "Terminal")
|
|
128
|
+
script = {"Terminal": RAISE_TERMINAL, "iTerm": RAISE_ITERM}.get(app)
|
|
129
|
+
if script:
|
|
130
|
+
for tty in client_ttys():
|
|
131
|
+
try:
|
|
132
|
+
p = subprocess.run(["osascript", "-e", script, tty], capture_output=True, text=True, timeout=10)
|
|
133
|
+
except (OSError, subprocess.SubprocessError):
|
|
134
|
+
break
|
|
135
|
+
if p.stdout.strip() == "ok":
|
|
136
|
+
return
|
|
137
|
+
subprocess.run(["open", "-a", app], capture_output=True, timeout=10)
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
def office_desk(pane: str) -> dict | None:
|
|
141
|
+
try:
|
|
142
|
+
agents = json.loads(OFFICE_JSON.read_text()).get("agents", [])
|
|
143
|
+
except (OSError, ValueError):
|
|
144
|
+
return None
|
|
145
|
+
return next((a for a in agents if a.get("pane") == pane), None)
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def live_status(hv: str, pane: str) -> str | None:
|
|
149
|
+
try:
|
|
150
|
+
out = subprocess.run([hv, "pane", "get", pane], capture_output=True, text=True, timeout=5).stdout
|
|
151
|
+
return json.loads(out)["result"]["pane"].get("agent_status")
|
|
152
|
+
except (OSError, subprocess.SubprocessError, ValueError, KeyError, TypeError):
|
|
153
|
+
return None
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def office_action(pane: str, action: str) -> tuple[bool, str]:
|
|
157
|
+
hv = hivey_bin()
|
|
158
|
+
if not hv:
|
|
159
|
+
return False, "hivey not found"
|
|
160
|
+
if not PANE.match(pane or "") or not office_desk(pane):
|
|
161
|
+
return False, "unknown agent"
|
|
162
|
+
if action == "focus":
|
|
163
|
+
p = subprocess.run([hv, "agent", "focus", pane], capture_output=True, text=True, timeout=10)
|
|
164
|
+
if p.returncode != 0:
|
|
165
|
+
return False, (p.stderr or p.stdout).strip()[-200:] or "focus failed"
|
|
166
|
+
raise_terminal()
|
|
167
|
+
return True, "opened in hivey"
|
|
168
|
+
if action in ("compact", "clear"):
|
|
169
|
+
status = live_status(hv, pane)
|
|
170
|
+
if status in ("working", "blocked"):
|
|
171
|
+
return False, f"it is {status} now; try when it is idle"
|
|
172
|
+
p = subprocess.run([hv, "pane", "run", pane, f"/{action}"], capture_output=True, text=True, timeout=10)
|
|
173
|
+
if p.returncode != 0:
|
|
174
|
+
return False, (p.stderr or p.stdout).strip()[-200:] or f"/{action} failed"
|
|
175
|
+
return True, f"sent /{action}"
|
|
176
|
+
return False, "unknown action"
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
def running(current_only: bool = True) -> int | None:
|
|
180
|
+
"""The port of our server; with current_only, None for an older version (it lacks new actions)."""
|
|
32
181
|
try:
|
|
33
182
|
port = int(json.loads(INFO.read_text())["port"])
|
|
34
183
|
except (OSError, ValueError, KeyError, TypeError):
|
|
35
184
|
return None
|
|
36
185
|
try:
|
|
37
186
|
with urllib.request.urlopen(f"http://127.0.0.1:{port}{PING}", timeout=1) as r:
|
|
38
|
-
|
|
187
|
+
body = r.read()
|
|
39
188
|
except OSError:
|
|
40
189
|
return None
|
|
190
|
+
if not body.startswith(MARK):
|
|
191
|
+
return None
|
|
192
|
+
return port if body == MARK + b" " + VERSION or not current_only else None
|
|
41
193
|
|
|
42
194
|
|
|
43
195
|
def port_free(port: int) -> bool:
|
|
@@ -55,7 +207,7 @@ def ensure() -> int | None:
|
|
|
55
207
|
port = running()
|
|
56
208
|
if port and (port == PREFERRED_PORT or not port_free(PREFERRED_PORT)):
|
|
57
209
|
return port
|
|
58
|
-
if port: #
|
|
210
|
+
if port or running(current_only=False): # older version, or on another port while ours is free
|
|
59
211
|
try:
|
|
60
212
|
os.kill(int(json.loads(INFO.read_text())["pid"]), 15)
|
|
61
213
|
time.sleep(0.3)
|
|
@@ -77,6 +229,7 @@ class Handler(http.server.SimpleHTTPRequestHandler):
|
|
|
77
229
|
server_version = "hivey-agent-map"
|
|
78
230
|
busy = threading.Lock()
|
|
79
231
|
last_used = time.time()
|
|
232
|
+
office_polled = 0.0
|
|
80
233
|
|
|
81
234
|
def __init__(self, *args, **kwargs):
|
|
82
235
|
super().__init__(*args, directory=str(REPORTS), **kwargs)
|
|
@@ -98,16 +251,29 @@ class Handler(http.server.SimpleHTTPRequestHandler):
|
|
|
98
251
|
def do_GET(self) -> None:
|
|
99
252
|
Handler.last_used = time.time()
|
|
100
253
|
if self.path == PING:
|
|
101
|
-
return self.answer(200, MARK, "text/plain")
|
|
254
|
+
return self.answer(200, MARK + b" " + VERSION, "text/plain")
|
|
255
|
+
if self.path.split("?")[0] == "/office/office.json":
|
|
256
|
+
Handler.office_polled = time.time()
|
|
102
257
|
return super().do_GET()
|
|
103
258
|
|
|
104
259
|
def do_POST(self) -> None:
|
|
105
260
|
Handler.last_used = time.time()
|
|
106
261
|
port = self.server.server_address[1]
|
|
107
|
-
if self.path
|
|
262
|
+
if self.path not in ("/hv-refresh", "/hv-office-refresh", "/hv-office-action"):
|
|
108
263
|
return self.answer(404, b'{"ok":false,"error":"not found"}')
|
|
109
264
|
if self.headers.get("Origin") not in (f"http://127.0.0.1:{port}", f"http://localhost:{port}"):
|
|
110
|
-
return self.answer(403, b'{"ok":false,"error":"only the agent map pages can
|
|
265
|
+
return self.answer(403, b'{"ok":false,"error":"only the agent map pages can do this"}')
|
|
266
|
+
if self.path == "/hv-office-refresh":
|
|
267
|
+
start_office_refresh()
|
|
268
|
+
return self.answer(200, b'{"ok":true,"started":true}')
|
|
269
|
+
if self.path == "/hv-office-action":
|
|
270
|
+
try:
|
|
271
|
+
length = min(int(self.headers.get("Content-Length") or 0), 4096)
|
|
272
|
+
req = json.loads(self.rfile.read(length) or b"{}")
|
|
273
|
+
ok, msg = office_action(str(req.get("pane", "")), str(req.get("action", "")))
|
|
274
|
+
except (ValueError, OSError, subprocess.SubprocessError) as e:
|
|
275
|
+
ok, msg = False, str(e)[:200]
|
|
276
|
+
return self.answer(200, json.dumps({"ok": ok, "message": msg}).encode())
|
|
111
277
|
start = time.time()
|
|
112
278
|
with Handler.busy: # two clicks: the second waits and then sees the fresh pages
|
|
113
279
|
try:
|
|
@@ -139,7 +305,22 @@ def serve() -> int:
|
|
|
139
305
|
httpd.shutdown()
|
|
140
306
|
return
|
|
141
307
|
|
|
308
|
+
def office_clock() -> None:
|
|
309
|
+
"""Refresh the office every 5 minutes while one of its pages is open."""
|
|
310
|
+
while True:
|
|
311
|
+
time.sleep(15)
|
|
312
|
+
if time.time() - Handler.office_polled > OFFICE_WATCHED:
|
|
313
|
+
continue
|
|
314
|
+
try:
|
|
315
|
+
age = time.time() - OFFICE_JSON.stat().st_mtime
|
|
316
|
+
except OSError:
|
|
317
|
+
age = OFFICE_EVERY
|
|
318
|
+
if age >= OFFICE_EVERY:
|
|
319
|
+
start_office_refresh()
|
|
320
|
+
time.sleep(60) # give it time to write before checking the age again
|
|
321
|
+
|
|
142
322
|
threading.Thread(target=watchdog, daemon=True).start()
|
|
323
|
+
threading.Thread(target=office_clock, daemon=True).start()
|
|
143
324
|
print(f"agent map pages: http://127.0.0.1:{port}/latest/agent-stats.html", flush=True)
|
|
144
325
|
httpd.serve_forever()
|
|
145
326
|
try:
|
|
@@ -242,6 +242,21 @@ Use Obsidian callouts when warranted (`> [!warning] Title`); types: `note`, `tip
|
|
|
242
242
|
a `lessons/` (or equivalent) page.
|
|
243
243
|
- A claim without a source is marked `> [!info] Unverified` and flagged at the next lint.
|
|
244
244
|
|
|
245
|
+
## Claim labels
|
|
246
|
+
|
|
247
|
+
Label every important claim so a later reader (another agent, a fresh session) knows what it
|
|
248
|
+
can trust; one agent's mistake must not become everyone's "truth":
|
|
249
|
+
|
|
250
|
+
- **verified**: checked, with its source: `verified: X (source: raw/… / file:line / command
|
|
251
|
+
and output / URL)`.
|
|
252
|
+
- **hypothesis**: believed but not checked; never build on it as if it were fact. What one
|
|
253
|
+
agent reported and nobody checked is a hypothesis.
|
|
254
|
+
- **decision**: a choice, with who made it and why: `decision: X (user, 2026-05-12)`.
|
|
255
|
+
|
|
256
|
+
When a hypothesis is checked, relabel it, or delete it if it was wrong, instead of appending a
|
|
257
|
+
correction next to it, so the page never says two conflicting things. Before relying on an old
|
|
258
|
+
`verified`, re-check its source: a stale "verified" looks safe and isn't.
|
|
259
|
+
|
|
245
260
|
## Question answering
|
|
246
261
|
|
|
247
262
|
1. Read `index.md` first to find relevant pages.
|
|
@@ -254,7 +269,8 @@ Use Obsidian callouts when warranted (`> [!warning] Title`); types: `note`, `tip
|
|
|
254
269
|
|
|
255
270
|
When asked to lint or audit, look for: contradictions between pages, stale claims newer
|
|
256
271
|
sources superseded, orphan pages (no inbound links), concepts in 3+ pages without their own
|
|
257
|
-
page, cross-reference gaps,
|
|
272
|
+
page, cross-reference gaps, important claims without a label, `verified` claims without a
|
|
273
|
+
source, hypotheses that other pages treat as fact, format compliance (Summary / Sources / Last updated)
|
|
258
274
|
{{, source-coverage gaps if applicable}}. Report a numbered list with suggested fixes; do not
|
|
259
275
|
auto-fix, discuss first.
|
|
260
276
|
|
|
@@ -282,6 +298,10 @@ Every entry in `log.md` starts with a parseable prefix:
|
|
|
282
298
|
|
|
283
299
|
- **Never** modify anything in `raw/`.
|
|
284
300
|
- **Never** put live config, runnable code, or current operational state in the wiki.
|
|
301
|
+
- **Never** write secrets (keys, tokens, passwords): write the envsave ID or the variable name.
|
|
302
|
+
hivey's wiki guard blocks writes that look like a secret.
|
|
303
|
+
- If a write is blocked because another agent is editing the page, wait, re-read the page, then
|
|
304
|
+
apply your change.
|
|
285
305
|
- **Always** update `index.md` and `log.md` after any wiki write.
|
|
286
306
|
- Page filenames: lowercase-hyphenated.
|
|
287
307
|
- {{If applicable: measured data wins over wiki narrative; when they disagree, update the
|
|
@@ -325,5 +345,10 @@ When to touch it:
|
|
|
325
345
|
5. When you'd otherwise write a report: write it as a wiki page instead.
|
|
326
346
|
|
|
327
347
|
Hard rules: never modify `{{vault}}/raw/`; no live config or operational state in the wiki;
|
|
328
|
-
always update `index.md` and `log.md` after a wiki write; filenames lowercase-hyphenated
|
|
348
|
+
always update `index.md` and `log.md` after a wiki write; filenames lowercase-hyphenated;
|
|
349
|
+
label claims verified / hypothesis / decision; never write secrets.
|
|
329
350
|
```
|
|
351
|
+
|
|
352
|
+
For a **swarm worker** (not the coordinator), replace "pages you write" and the "When to touch
|
|
353
|
+
it" list with: *the wiki is read-only for you (hivey blocks writes); write your reports to
|
|
354
|
+
`{{vault}}/raw/reports/<agent>/` and tell the coordinator, which checks and files them.*
|
|
@@ -259,6 +259,10 @@ user again. If the vault already exists (a resumed swarm), reuse it. Shape it fo
|
|
|
259
259
|
- In the vault's CLAUDE.md add the swarm rule: *only the coordinator writes `wiki/`; it ingests
|
|
260
260
|
agent reports from `raw/reports/` without waiting to discuss them, because the swarm runs
|
|
261
261
|
unattended.* Agents writing `index.md`/`log.md` in parallel would clobber each other.
|
|
262
|
+
hivey's swarm guard enforces it: a worker's write anywhere in the vault except its own
|
|
263
|
+
`raw/reports/<agent>/` is blocked. Add too: *a worker's finding enters the wiki as a
|
|
264
|
+
**hypothesis** until it is checked (a fresh review, a test, a second source); only then does
|
|
265
|
+
it become **verified**, with that check as its source.*
|
|
262
266
|
|
|
263
267
|
Then initialize the memory: `wiki/swarm-overview.md` (the user's request, goal, roster, Slack
|
|
264
268
|
channel, root, hand-off chain), `wiki/agents/<agent>.md` per agent (role, owns, deliverables,
|
|
@@ -15,6 +15,9 @@ Only the coordinator writes `wiki/`; agents write reports to `raw/reports/<agent
|
|
|
15
15
|
the builder's feature choice, a fresh review's issue with a design decision), link them both ways
|
|
16
16
|
with `[[wiki-links]]`. Where they contradict, record it in a `> [!warning]` callout on both
|
|
17
17
|
pages and in `lessons/`.
|
|
18
|
+
- Label each claim: a worker's finding is a **hypothesis** until a fresh review, a test or a
|
|
19
|
+
second source checks it; then **verified** with that check cited. Plans and choices are
|
|
20
|
+
**decisions** (who, why). This keeps one agent's mistake from becoming the swarm's truth.
|
|
18
21
|
- Every page cites its source report(s). Update `wiki/agents/<agent>.md` (status,
|
|
19
22
|
deliverables, report links, the pages its work fed), then `index.md` and `log.md`.
|
|
20
23
|
- **When an agent sends FINISHED, ingest its final report before anything else.** A worker only
|
|
@@ -33,6 +33,11 @@ format its log uses, follow it; do not impose another layout.
|
|
|
33
33
|
2. **Read `<vault>/CLAUDE.md`**: it defines the lint workflow (checks, what counts as stale, coverage gaps). Follow it.
|
|
34
34
|
3. Walk every file under `<vault>/wiki/` (and `index.md`). Use Grep for the wiki-link inventory
|
|
35
35
|
(`\[\[([^\]]+)\]\]`) and for the page-format fields the vault requires.
|
|
36
|
-
4.
|
|
37
|
-
|
|
36
|
+
4. Whatever the vault's own rules say, also check the claim labels: important claims with no
|
|
37
|
+
`verified` / `hypothesis` / `decision` label, `verified` claims with no source, and
|
|
38
|
+
hypotheses that other pages cite as fact (one agent's unchecked claim spreading). Grep for
|
|
39
|
+
key-shaped strings too (`sk-`, `ghp_`, `xox`, `AKIA`, `-----BEGIN`): a secret in a page is a
|
|
40
|
+
finding of its own, listed first.
|
|
41
|
+
5. Report a numbered list: the issue, the affected page(s), a suggested fix. Do **not** auto-fix.
|
|
42
|
+
6. Append a `lint` line to the vault's `log.md` in its own format (`Findings: N contradictions, M orphans, ...`).
|
|
38
43
|
Offer to file the findings as a page; do not assume.
|