@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.
Files changed (59) hide show
  1. package/native/darwin-arm64/hivey +0 -0
  2. package/package.json +1 -1
  3. package/repo/skills/hivey/scripts/new_wiki.py +12 -0
  4. package/repo/skills/hivey-agent-map/SKILL.md +33 -0
  5. package/repo/skills/hivey-agent-map/scripts/agent_map.py +10 -0
  6. package/repo/skills/hivey-agent-map/scripts/office/OutlineEffect.js +539 -0
  7. package/repo/skills/hivey-agent-map/scripts/office/RoomEnvironment.js +148 -0
  8. package/repo/skills/hivey-agent-map/scripts/office/loaders/GLTFLoader.js +4663 -0
  9. package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-kenney-space-kit.txt +23 -0
  10. package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-kenney-space-station-kit.txt +28 -0
  11. package/repo/skills/hivey-agent-map/scripts/office/models/LICENSE-robot.txt +2 -0
  12. package/repo/skills/hivey-agent-map/scripts/office/models/astronautA.glb.b64 +1 -0
  13. package/repo/skills/hivey-agent-map/scripts/office/models/astronautB.glb.b64 +1 -0
  14. package/repo/skills/hivey-agent-map/scripts/office/models/barrels.glb.b64 +1 -0
  15. package/repo/skills/hivey-agent-map/scripts/office/models/barrels_rail.glb.b64 +1 -0
  16. package/repo/skills/hivey-agent-map/scripts/office/models/craft_cargoA.glb.b64 +1 -0
  17. package/repo/skills/hivey-agent-map/scripts/office/models/craft_racer.glb.b64 +1 -0
  18. package/repo/skills/hivey-agent-map/scripts/office/models/craft_speederA.glb.b64 +1 -0
  19. package/repo/skills/hivey-agent-map/scripts/office/models/desk_chairArms.glb.b64 +1 -0
  20. package/repo/skills/hivey-agent-map/scripts/office/models/desk_computer.glb.b64 +1 -0
  21. package/repo/skills/hivey-agent-map/scripts/office/models/machine_generator.glb.b64 +1 -0
  22. package/repo/skills/hivey-agent-map/scripts/office/models/machine_generatorLarge.glb.b64 +1 -0
  23. package/repo/skills/hivey-agent-map/scripts/office/models/machine_wireless.glb.b64 +1 -0
  24. package/repo/skills/hivey-agent-map/scripts/office/models/robot.glb.b64 +1 -0
  25. package/repo/skills/hivey-agent-map/scripts/office/models/satelliteDish_detailed.glb.b64 +1 -0
  26. package/repo/skills/hivey-agent-map/scripts/office/models/satelliteDish_large.glb.b64 +1 -0
  27. package/repo/skills/hivey-agent-map/scripts/office/models/station/Textures/colormap.png.b64 +1 -0
  28. package/repo/skills/hivey-agent-map/scripts/office/models/station/chair-cushion-headrest.glb.b64 +1 -0
  29. package/repo/skills/hivey-agent-map/scripts/office/models/station/computer-system.glb.b64 +1 -0
  30. package/repo/skills/hivey-agent-map/scripts/office/models/station/computer-wide.glb.b64 +1 -0
  31. package/repo/skills/hivey-agent-map/scripts/office/models/station/container-flat.glb.b64 +1 -0
  32. package/repo/skills/hivey-agent-map/scripts/office/models/station/container-tall.glb.b64 +1 -0
  33. package/repo/skills/hivey-agent-map/scripts/office/models/station/container-wide.glb.b64 +1 -0
  34. package/repo/skills/hivey-agent-map/scripts/office/models/station/display-wall-wide.glb.b64 +1 -0
  35. package/repo/skills/hivey-agent-map/scripts/office/models/station/pipe-ring-colored.glb.b64 +1 -0
  36. package/repo/skills/hivey-agent-map/scripts/office/music/README.txt +2 -0
  37. package/repo/skills/hivey-agent-map/scripts/office/music/space.mp3.b64 +1 -0
  38. package/repo/skills/hivey-agent-map/scripts/office/office.html +181 -0
  39. package/repo/skills/hivey-agent-map/scripts/office/office.js +814 -0
  40. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/EffectComposer.js +231 -0
  41. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/MaskPass.js +104 -0
  42. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/OutputPass.js +95 -0
  43. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/Pass.js +95 -0
  44. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/RenderPass.js +99 -0
  45. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/ShaderPass.js +77 -0
  46. package/repo/skills/hivey-agent-map/scripts/office/postprocessing/UnrealBloomPass.js +415 -0
  47. package/repo/skills/hivey-agent-map/scripts/office/shaders/CopyShader.js +45 -0
  48. package/repo/skills/hivey-agent-map/scripts/office/shaders/LuminosityHighPassShader.js +66 -0
  49. package/repo/skills/hivey-agent-map/scripts/office/shaders/OutputShader.js +81 -0
  50. package/repo/skills/hivey-agent-map/scripts/office/ship.js +578 -0
  51. package/repo/skills/hivey-agent-map/scripts/office/three.module.min.js +6 -0
  52. package/repo/skills/hivey-agent-map/scripts/office/utils/BufferGeometryUtils.js +1375 -0
  53. package/repo/skills/hivey-agent-map/scripts/office/utils/SkeletonUtils.js +413 -0
  54. package/repo/skills/hivey-agent-map/scripts/office.py +522 -0
  55. package/repo/skills/hivey-agent-map/scripts/serve.py +190 -9
  56. package/repo/skills/hivey-create-wiki/SKILL.md +27 -2
  57. package/repo/skills/hivey-swarm-creator/SKILL.md +4 -0
  58. package/repo/skills/hivey-swarm-creator/references/wiki-memory.md +3 -0
  59. 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 one action: POST /hv-refresh runs `agent_map.py refresh` (free: no model) and only answers the
6
- pages it serves (Origin check), so other web pages can't trigger it. It stops after 2 hours unused.
7
- Python standard library only.
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
- def running() -> int | None:
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
- return port if r.read() == MARK else None
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: # an older server on another port while ours is free: replace it
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 != "/hv-refresh":
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 refresh"}')
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, format compliance (Summary / Sources / Last updated)
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. Report a numbered list: the issue, the affected page(s), a suggested fix. Do **not** auto-fix.
37
- 5. Append a `lint` line to the vault's `log.md` in its own format (`Findings: N contradictions, M orphans, ...`).
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.