1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
#!/usr/bin/env python3
"""Fan out a message file to every AI project's inbox/.
Discovers AI projects by fingerprint — any directory under SEARCH_ROOTS
whose .ai/protocols.org exists. Uses the existing inbox-send.py helper to
deliver per-target.
Usage:
broadcast.py --list
broadcast.py --file <path> [--exclude <name> ...] [--dry-run]
"""
from __future__ import annotations
import argparse
import subprocess
import sys
from pathlib import Path
SEARCH_ROOTS = [
Path.home() / "code",
Path.home() / "projects",
Path.home() / ".emacs.d",
]
def is_broadcastable(path: Path) -> bool:
"""A project is broadcastable if it has both .ai/ and a top-level inbox/.
Matches inbox-send.py's fingerprint so the broadcast only targets
projects that can actually receive (inbox-send rejects targets without
inbox/). A project that has .ai/protocols.org but no inbox/ is an AI
project that hasn't been bootstrapped for inbox messaging yet.
"""
return (path / ".ai" / "protocols.org").is_file() and (path / "inbox").is_dir()
def discover() -> list[Path]:
"""Return every broadcastable AI project, deduplicated and sorted."""
seen: dict[str, Path] = {}
for root in SEARCH_ROOTS:
if not root.is_dir():
continue
# The root itself may be a project (~/.emacs.d).
if is_broadcastable(root):
seen.setdefault(root.name, root)
continue
# Otherwise scan one level down.
for sub in sorted(root.iterdir()):
if sub.is_dir() and is_broadcastable(sub):
seen.setdefault(sub.name, sub)
return [seen[name] for name in sorted(seen)]
def sender_project() -> str | None:
"""Return the AI-project basename of the current working dir, if any."""
cwd = Path.cwd()
for ancestor in [cwd, *cwd.parents]:
if (ancestor / ".ai" / "protocols.org").is_file():
return ancestor.name
return None
def inbox_send_path() -> Path:
"""Locate the inbox-send.py helper in the current project."""
cwd = Path.cwd()
for ancestor in [cwd, *cwd.parents]:
candidate = ancestor / ".ai" / "scripts" / "inbox-send.py"
if candidate.is_file():
return candidate
raise SystemExit("broadcast: inbox-send.py not found in current project")
def main() -> int:
parser = argparse.ArgumentParser(
description="Broadcast a message file to every AI project's inbox/.",
)
parser.add_argument(
"--list", action="store_true",
help="List discovered AI projects and exit (sender-excluded).",
)
parser.add_argument(
"--file",
help="Path to the broadcast message file.",
)
parser.add_argument(
"--exclude", action="append", default=[],
help="Project basename to skip. Repeatable.",
)
parser.add_argument(
"--dry-run", action="store_true",
help="Show what would be sent without invoking inbox-send.",
)
args = parser.parse_args()
projects = discover()
sender = sender_project()
excluded = set(args.exclude)
if sender:
excluded.add(sender)
targets = [p for p in projects if p.name not in excluded]
if args.list:
print(f"Discovered {len(projects)} AI projects "
f"(sender '{sender or '?'}' excluded, "
f"{len(args.exclude)} explicit excludes):")
for p in projects:
mark = " -" if p.name in excluded else " +"
print(f"{mark} {p.name:30s} {p}")
print(f"\nWould broadcast to {len(targets)} target(s).")
return 0
if not args.file:
parser.error("--file is required unless --list is given")
msg_path = Path(args.file).resolve()
if not msg_path.is_file():
print(f"broadcast: file not found: {msg_path}", file=sys.stderr)
return 2
inbox_send = inbox_send_path()
print(f"Broadcasting {msg_path.name} to {len(targets)} project(s):")
if args.dry_run:
for target in targets:
print(f" dry {target.name}")
return 0
sent = 0
failed = []
for target in targets:
cmd = ["python3", str(inbox_send), target.name, "--file", str(msg_path)]
res = subprocess.run(cmd, capture_output=True, text=True)
if res.returncode == 0:
print(f" ok {target.name}")
sent += 1
else:
err = (res.stderr or res.stdout).strip().splitlines()[-1][:120]
print(f" FAIL {target.name}: {err}")
failed.append((target.name, err))
print(f"\nSummary: {sent} sent, {len(failed)} failed, "
f"{len(projects) - len(targets)} excluded.")
if failed:
print("\nFailures (re-run --file targeting these individually if needed):")
for name, err in failed:
print(f" {name}: {err}")
return 1
return 0
if __name__ == "__main__":
sys.exit(main())
|
