feed-the-machine 1.6.1 → 1.7.1

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 (272) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +262 -170
  3. package/bin/__pycache__/tasks_db.cpython-314.pyc +0 -0
  4. package/bin/brain.py +1340 -0
  5. package/bin/convert_claude_skills_to_codex.py +490 -0
  6. package/bin/generate-manifest.mjs +463 -463
  7. package/bin/harden_codex_skills.py +141 -0
  8. package/bin/install.mjs +491 -491
  9. package/bin/migrate-eng-buddy-data.py +875 -0
  10. package/bin/playbook_engine/__init__.py +1 -0
  11. package/bin/playbook_engine/conftest.py +8 -0
  12. package/bin/playbook_engine/extractor.py +33 -0
  13. package/bin/playbook_engine/manager.py +102 -0
  14. package/bin/playbook_engine/models.py +84 -0
  15. package/bin/playbook_engine/registry.py +35 -0
  16. package/bin/playbook_engine/test_extractor.py +72 -0
  17. package/bin/playbook_engine/test_integration.py +129 -0
  18. package/bin/playbook_engine/test_manager.py +85 -0
  19. package/bin/playbook_engine/test_models.py +166 -0
  20. package/bin/playbook_engine/test_registry.py +67 -0
  21. package/bin/playbook_engine/test_tracer.py +86 -0
  22. package/bin/playbook_engine/tracer.py +93 -0
  23. package/bin/tasks_db.py +456 -0
  24. package/docs/HOOKS.md +243 -243
  25. package/docs/INBOX.md +233 -233
  26. package/ftm/SKILL.md +125 -122
  27. package/ftm-audit/SKILL.md +673 -623
  28. package/ftm-audit/references/protocols/PROJECT-PATTERNS.md +91 -91
  29. package/ftm-audit/references/protocols/RUNTIME-WIRING.md +66 -66
  30. package/ftm-audit/references/protocols/WIRING-CONTRACTS.md +135 -135
  31. package/ftm-audit/references/strategies/AUTO-FIX-STRATEGIES.md +69 -69
  32. package/ftm-audit/references/templates/REPORT-FORMAT.md +96 -96
  33. package/ftm-audit/scripts/run-knip.sh +23 -23
  34. package/ftm-audit.yml +2 -2
  35. package/ftm-brainstorm/SKILL.md +1003 -498
  36. package/ftm-brainstorm/evals/evals.json +180 -100
  37. package/ftm-brainstorm/evals/promptfoo.yaml +109 -109
  38. package/ftm-brainstorm/references/agent-prompts.md +552 -224
  39. package/ftm-brainstorm/references/plan-template.md +209 -121
  40. package/ftm-brainstorm.yml +2 -2
  41. package/ftm-browse/SKILL.md +454 -454
  42. package/ftm-browse/daemon/browser-manager.ts +206 -206
  43. package/ftm-browse/daemon/bun.lock +30 -30
  44. package/ftm-browse/daemon/cli.ts +347 -347
  45. package/ftm-browse/daemon/commands.ts +410 -410
  46. package/ftm-browse/daemon/main.ts +357 -357
  47. package/ftm-browse/daemon/package.json +17 -17
  48. package/ftm-browse/daemon/server.ts +189 -189
  49. package/ftm-browse/daemon/snapshot.ts +519 -519
  50. package/ftm-browse/daemon/tsconfig.json +22 -22
  51. package/ftm-browse.yml +4 -4
  52. package/ftm-capture/SKILL.md +370 -370
  53. package/ftm-capture.yml +4 -4
  54. package/ftm-codex-gate/SKILL.md +361 -361
  55. package/ftm-codex-gate.yml +2 -2
  56. package/ftm-config/SKILL.md +422 -345
  57. package/ftm-config.default.yml +125 -82
  58. package/ftm-config.yml +44 -2
  59. package/ftm-council/SKILL.md +416 -416
  60. package/ftm-council/references/prompts/CLAUDE-INVESTIGATION.md +60 -60
  61. package/ftm-council/references/prompts/CODEX-INVESTIGATION.md +58 -58
  62. package/ftm-council/references/prompts/GEMINI-INVESTIGATION.md +58 -58
  63. package/ftm-council/references/prompts/REBUTTAL-TEMPLATE.md +57 -57
  64. package/ftm-council/references/protocols/PREREQUISITES.md +47 -47
  65. package/ftm-council/references/protocols/STEP-0-FRAMING.md +46 -46
  66. package/ftm-council-chat.yml +2 -0
  67. package/ftm-council.yml +2 -2
  68. package/ftm-dashboard/SKILL.md +163 -163
  69. package/ftm-dashboard.yml +4 -4
  70. package/ftm-debug/SKILL.md +1037 -1037
  71. package/ftm-debug/references/phases/PHASE-0-INTAKE.md +58 -58
  72. package/ftm-debug/references/phases/PHASE-1-TRIAGE.md +46 -46
  73. package/ftm-debug/references/phases/PHASE-2-WAR-ROOM-AGENTS.md +279 -279
  74. package/ftm-debug/references/phases/PHASE-3-TO-6-EXECUTION.md +436 -436
  75. package/ftm-debug/references/protocols/BLACKBOARD.md +86 -86
  76. package/ftm-debug/references/protocols/EDGE-CASES.md +103 -103
  77. package/ftm-debug.yml +2 -2
  78. package/ftm-diagram/SKILL.md +277 -277
  79. package/ftm-diagram.yml +2 -2
  80. package/ftm-executor/SKILL.md +777 -777
  81. package/ftm-executor/references/STYLE-TEMPLATE.md +73 -73
  82. package/ftm-executor/references/phases/PHASE-0-VERIFICATION.md +62 -62
  83. package/ftm-executor/references/phases/PHASE-2-AGENT-ASSEMBLY.md +34 -34
  84. package/ftm-executor/references/phases/PHASE-3-WORKTREES.md +38 -38
  85. package/ftm-executor/references/phases/PHASE-4-5-AUDIT.md +81 -72
  86. package/ftm-executor/references/phases/PHASE-4-DISPATCH.md +66 -66
  87. package/ftm-executor/references/phases/PHASE-5-5-CODEX-GATE.md +73 -73
  88. package/ftm-executor/references/protocols/DOCUMENTATION-BOOTSTRAP.md +36 -36
  89. package/ftm-executor/references/protocols/MODEL-PROFILE.md +59 -59
  90. package/ftm-executor/references/protocols/PROGRESS-TRACKING.md +66 -66
  91. package/ftm-executor/runtime/ftm-runtime.mjs +252 -252
  92. package/ftm-executor/runtime/package.json +8 -8
  93. package/ftm-executor.yml +2 -2
  94. package/ftm-git/SKILL.md +441 -441
  95. package/ftm-git/evals/evals.json +26 -26
  96. package/ftm-git/evals/promptfoo.yaml +75 -75
  97. package/ftm-git/hooks/post-commit-experience.sh +92 -92
  98. package/ftm-git/references/patterns/SECRET-PATTERNS.md +104 -104
  99. package/ftm-git/references/protocols/REMEDIATION.md +139 -139
  100. package/ftm-git/scripts/pre-commit-secrets.sh +110 -110
  101. package/ftm-git.yml +2 -2
  102. package/ftm-inbox/backend/__pycache__/main.cpython-314.pyc +0 -0
  103. package/ftm-inbox/backend/adapters/_retry.py +64 -64
  104. package/ftm-inbox/backend/adapters/base.py +230 -230
  105. package/ftm-inbox/backend/adapters/freshservice.py +104 -104
  106. package/ftm-inbox/backend/adapters/gmail.py +125 -125
  107. package/ftm-inbox/backend/adapters/jira.py +136 -136
  108. package/ftm-inbox/backend/adapters/registry.py +192 -192
  109. package/ftm-inbox/backend/adapters/slack.py +110 -110
  110. package/ftm-inbox/backend/db/connection.py +54 -54
  111. package/ftm-inbox/backend/db/schema.py +78 -78
  112. package/ftm-inbox/backend/executor/__init__.py +7 -7
  113. package/ftm-inbox/backend/executor/engine.py +149 -149
  114. package/ftm-inbox/backend/executor/step_runner.py +98 -98
  115. package/ftm-inbox/backend/main.py +103 -103
  116. package/ftm-inbox/backend/models/__init__.py +1 -1
  117. package/ftm-inbox/backend/models/unified_task.py +36 -36
  118. package/ftm-inbox/backend/planner/__init__.py +6 -6
  119. package/ftm-inbox/backend/planner/__pycache__/__init__.cpython-314.pyc +0 -0
  120. package/ftm-inbox/backend/planner/__pycache__/generator.cpython-314.pyc +0 -0
  121. package/ftm-inbox/backend/planner/__pycache__/schema.cpython-314.pyc +0 -0
  122. package/ftm-inbox/backend/planner/generator.py +127 -127
  123. package/ftm-inbox/backend/planner/schema.py +34 -34
  124. package/ftm-inbox/backend/requirements.txt +5 -5
  125. package/ftm-inbox/backend/routes/__pycache__/plan.cpython-314.pyc +0 -0
  126. package/ftm-inbox/backend/routes/execute.py +186 -186
  127. package/ftm-inbox/backend/routes/health.py +52 -52
  128. package/ftm-inbox/backend/routes/inbox.py +68 -68
  129. package/ftm-inbox/backend/routes/plan.py +271 -271
  130. package/ftm-inbox/bin/launchagent.mjs +91 -91
  131. package/ftm-inbox/bin/setup.mjs +188 -188
  132. package/ftm-inbox/bin/start.sh +10 -10
  133. package/ftm-inbox/bin/status.sh +17 -17
  134. package/ftm-inbox/bin/stop.sh +8 -8
  135. package/ftm-inbox/config.example.yml +55 -55
  136. package/ftm-inbox/package-lock.json +2898 -2898
  137. package/ftm-inbox/package.json +26 -26
  138. package/ftm-inbox/postcss.config.js +6 -6
  139. package/ftm-inbox/src/app.css +199 -199
  140. package/ftm-inbox/src/app.html +18 -18
  141. package/ftm-inbox/src/lib/api.ts +166 -166
  142. package/ftm-inbox/src/lib/components/ExecutionLog.svelte +81 -81
  143. package/ftm-inbox/src/lib/components/InboxFeed.svelte +143 -143
  144. package/ftm-inbox/src/lib/components/PlanStep.svelte +271 -271
  145. package/ftm-inbox/src/lib/components/PlanView.svelte +206 -206
  146. package/ftm-inbox/src/lib/components/StreamPanel.svelte +99 -99
  147. package/ftm-inbox/src/lib/components/TaskCard.svelte +190 -190
  148. package/ftm-inbox/src/lib/components/ui/EmptyState.svelte +63 -63
  149. package/ftm-inbox/src/lib/components/ui/KawaiiCard.svelte +86 -86
  150. package/ftm-inbox/src/lib/components/ui/PillButton.svelte +106 -106
  151. package/ftm-inbox/src/lib/components/ui/StatusBadge.svelte +67 -67
  152. package/ftm-inbox/src/lib/components/ui/StreamDrawer.svelte +149 -149
  153. package/ftm-inbox/src/lib/components/ui/ThemeToggle.svelte +80 -80
  154. package/ftm-inbox/src/lib/theme.ts +47 -47
  155. package/ftm-inbox/src/routes/+layout.svelte +76 -76
  156. package/ftm-inbox/src/routes/+page.svelte +401 -401
  157. package/ftm-inbox/svelte.config.js +12 -12
  158. package/ftm-inbox/tailwind.config.ts +63 -63
  159. package/ftm-inbox/tsconfig.json +13 -13
  160. package/ftm-inbox/vite.config.ts +6 -6
  161. package/ftm-intent/SKILL.md +241 -241
  162. package/ftm-intent.yml +2 -2
  163. package/ftm-manifest.json +3794 -3794
  164. package/ftm-map/SKILL.md +291 -291
  165. package/ftm-map/scripts/db.py +712 -712
  166. package/ftm-map/scripts/index.py +415 -415
  167. package/ftm-map/scripts/parser.py +224 -224
  168. package/ftm-map/scripts/queries/go-tags.scm +20 -20
  169. package/ftm-map/scripts/queries/javascript-tags.scm +35 -35
  170. package/ftm-map/scripts/queries/python-tags.scm +31 -31
  171. package/ftm-map/scripts/queries/ruby-tags.scm +19 -19
  172. package/ftm-map/scripts/queries/rust-tags.scm +37 -37
  173. package/ftm-map/scripts/queries/typescript-tags.scm +41 -41
  174. package/ftm-map/scripts/query.py +301 -301
  175. package/ftm-map/scripts/ranker.py +377 -377
  176. package/ftm-map/scripts/requirements.txt +5 -5
  177. package/ftm-map/scripts/setup-hooks.sh +27 -27
  178. package/ftm-map/scripts/setup.sh +56 -56
  179. package/ftm-map/scripts/test_db.py +364 -364
  180. package/ftm-map/scripts/test_parser.py +174 -174
  181. package/ftm-map/scripts/test_query.py +183 -183
  182. package/ftm-map/scripts/test_ranker.py +199 -199
  183. package/ftm-map/scripts/views.py +591 -591
  184. package/ftm-map.yml +2 -2
  185. package/ftm-mind/SKILL.md +201 -1943
  186. package/ftm-mind/evals/promptfoo.yaml +142 -142
  187. package/ftm-mind/references/blackboard-protocol.md +110 -0
  188. package/ftm-mind/references/blackboard-schema.md +328 -328
  189. package/ftm-mind/references/complexity-guide.md +110 -110
  190. package/ftm-mind/references/complexity-sizing.md +138 -0
  191. package/ftm-mind/references/decide-act-protocol.md +172 -0
  192. package/ftm-mind/references/direct-execution.md +51 -0
  193. package/ftm-mind/references/environment-discovery.md +77 -0
  194. package/ftm-mind/references/event-registry.md +319 -319
  195. package/ftm-mind/references/mcp-inventory.md +300 -296
  196. package/ftm-mind/references/ops-routing.md +47 -0
  197. package/ftm-mind/references/orient-protocol.md +234 -0
  198. package/ftm-mind/references/personality.md +40 -0
  199. package/ftm-mind/references/protocols/COMPLEXITY-SIZING.md +72 -72
  200. package/ftm-mind/references/protocols/MCP-HEURISTICS.md +32 -32
  201. package/ftm-mind/references/protocols/PLAN-APPROVAL.md +80 -80
  202. package/ftm-mind/references/reflexion-protocol.md +249 -249
  203. package/ftm-mind/references/routing/SCENARIOS.md +22 -22
  204. package/ftm-mind/references/routing-scenarios.md +35 -35
  205. package/ftm-mind.yml +2 -2
  206. package/ftm-ops.yml +4 -0
  207. package/ftm-pause/SKILL.md +395 -395
  208. package/ftm-pause/references/protocols/SKILL-RESTORE-PROTOCOLS.md +186 -186
  209. package/ftm-pause/references/protocols/VALIDATION.md +80 -80
  210. package/ftm-pause.yml +2 -2
  211. package/ftm-researcher/SKILL.md +275 -275
  212. package/ftm-researcher/evals/agent-diversity.yaml +17 -17
  213. package/ftm-researcher/evals/synthesis-quality.yaml +12 -12
  214. package/ftm-researcher/evals/trigger-accuracy.yaml +39 -39
  215. package/ftm-researcher/references/adaptive-search.md +116 -116
  216. package/ftm-researcher/references/agent-prompts.md +193 -193
  217. package/ftm-researcher/references/council-integration.md +193 -193
  218. package/ftm-researcher/references/output-format.md +203 -203
  219. package/ftm-researcher/references/synthesis-pipeline.md +165 -165
  220. package/ftm-researcher/scripts/score_credibility.py +234 -234
  221. package/ftm-researcher/scripts/validate_research.py +92 -92
  222. package/ftm-researcher.yml +2 -2
  223. package/ftm-resume/SKILL.md +518 -518
  224. package/ftm-resume/references/protocols/VALIDATION.md +172 -172
  225. package/ftm-resume.yml +2 -2
  226. package/ftm-retro/SKILL.md +380 -380
  227. package/ftm-retro/references/protocols/SCORING-RUBRICS.md +89 -89
  228. package/ftm-retro/references/templates/REPORT-FORMAT.md +109 -109
  229. package/ftm-retro.yml +2 -2
  230. package/ftm-routine/SKILL.md +170 -170
  231. package/ftm-routine.yml +4 -4
  232. package/ftm-state/blackboard/capabilities.json +5 -5
  233. package/ftm-state/blackboard/capabilities.schema.json +27 -27
  234. package/ftm-state/blackboard/context.json +37 -23
  235. package/ftm-state/blackboard/experiences/doom-statusline-fix.json +26 -0
  236. package/ftm-state/blackboard/experiences/hackathon-pages-site.json +26 -0
  237. package/ftm-state/blackboard/experiences/hindsight-sso-kickoff.json +42 -0
  238. package/ftm-state/blackboard/experiences/index.json +58 -9
  239. package/ftm-state/blackboard/experiences/learning-ragnarok-api-access.json +23 -0
  240. package/ftm-state/blackboard/experiences/nordlayer-members-auto-assign.json +26 -0
  241. package/ftm-state/blackboard/experiences/saml2aws-stale-session-fix.json +41 -0
  242. package/ftm-state/blackboard/patterns.json +6 -6
  243. package/ftm-state/schemas/context.schema.json +130 -130
  244. package/ftm-state/schemas/experience-index.schema.json +77 -77
  245. package/ftm-state/schemas/experience.schema.json +78 -78
  246. package/ftm-state/schemas/patterns.schema.json +44 -44
  247. package/ftm-upgrade/SKILL.md +194 -194
  248. package/ftm-upgrade/scripts/check-version.sh +76 -76
  249. package/ftm-upgrade/scripts/upgrade.sh +143 -143
  250. package/ftm-upgrade.yml +2 -2
  251. package/ftm-verify.yml +2 -2
  252. package/ftm.yml +2 -2
  253. package/hooks/ftm-auto-log.sh +137 -0
  254. package/hooks/ftm-blackboard-enforcer.sh +93 -93
  255. package/hooks/ftm-discovery-reminder.sh +90 -90
  256. package/hooks/ftm-drafts-gate.sh +61 -61
  257. package/hooks/ftm-event-logger.mjs +107 -107
  258. package/hooks/ftm-install-hooks.sh +240 -0
  259. package/hooks/ftm-learning-capture.sh +117 -0
  260. package/hooks/ftm-map-autodetect.sh +79 -79
  261. package/hooks/ftm-pending-sync-check.sh +22 -22
  262. package/hooks/ftm-plan-gate.sh +92 -92
  263. package/hooks/ftm-post-commit-trigger.sh +57 -57
  264. package/hooks/ftm-post-compaction.sh +138 -0
  265. package/hooks/ftm-pre-compaction.sh +147 -0
  266. package/hooks/ftm-session-end.sh +52 -0
  267. package/hooks/ftm-session-snapshot.sh +213 -0
  268. package/hooks/ftm-task-loader.sh +100 -0
  269. package/hooks/settings-template.json +91 -81
  270. package/install.sh +363 -363
  271. package/package.json +84 -84
  272. package/uninstall.sh +25 -25
@@ -1,357 +1,357 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * main.ts — Unified entry point for the compiled ftm-browse binary.
4
- *
5
- * When invoked as:
6
- * ftm-browse --server → runs the HTTP daemon (server.ts logic)
7
- * ftm-browse <command> ... → runs the CLI client (cli.ts logic)
8
- */
9
-
10
- import * as path from "path";
11
- import * as fs from "fs";
12
- import * as crypto from "crypto";
13
- import { browserManager } from "./browser-manager.ts";
14
- import { executeCommand } from "./commands.ts";
15
-
16
- // ─── Shared Types & Helpers ───────────────────────────────────────────────────
17
-
18
- const STATE_DIR = path.join(process.env.HOME || "~", ".ftm-browse");
19
- const STATE_FILE = path.join(STATE_DIR, "state.json");
20
-
21
- interface DaemonState {
22
- port: number;
23
- token: string;
24
- pid: number;
25
- }
26
-
27
- function readState(): DaemonState | null {
28
- try {
29
- if (!fs.existsSync(STATE_FILE)) return null;
30
- const raw = fs.readFileSync(STATE_FILE, "utf-8");
31
- return JSON.parse(raw) as DaemonState;
32
- } catch {
33
- return null;
34
- }
35
- }
36
-
37
- function isProcessAlive(pid: number): boolean {
38
- try {
39
- process.kill(pid, 0);
40
- return true;
41
- } catch {
42
- return false;
43
- }
44
- }
45
-
46
- // ─── Server Mode ─────────────────────────────────────────────────────────────
47
-
48
- function sendJson(data: unknown, status = 200): Response {
49
- return new Response(JSON.stringify(data), {
50
- status,
51
- headers: { "Content-Type": "application/json" },
52
- });
53
- }
54
-
55
- async function handleRequest(req: Request, token: string): Promise<Response> {
56
- const authHeader = req.headers.get("Authorization");
57
- if (!authHeader || authHeader !== `Bearer ${token}`) {
58
- return sendJson({ error: "Unauthorized" }, 401);
59
- }
60
-
61
- const url = new URL(req.url);
62
- const command = url.pathname.slice(1);
63
-
64
- if (req.method !== "POST") {
65
- return sendJson({ error: "Method not allowed" }, 405);
66
- }
67
-
68
- if (command === "health") {
69
- return sendJson({ status: "ok", pid: process.pid });
70
- }
71
-
72
- let body: Record<string, unknown> = {};
73
- try {
74
- const text = await req.text();
75
- if (text.trim()) {
76
- body = JSON.parse(text);
77
- }
78
- } catch {
79
- return sendJson({ error: "Invalid JSON body" }, 400);
80
- }
81
-
82
- const result = await executeCommand(command, body);
83
- return sendJson(result, result.success ? 200 : 400);
84
- }
85
-
86
- async function runServer(): Promise<void> {
87
- const port = Math.floor(Math.random() * (60000 - 10000 + 1)) + 10000;
88
- const token = crypto.randomBytes(32).toString("hex");
89
-
90
- console.log(`[ftm-browse] Starting daemon on port ${port}`);
91
-
92
- // Ensure state dir exists
93
- if (!fs.existsSync(STATE_DIR)) {
94
- fs.mkdirSync(STATE_DIR, { recursive: true, mode: 0o700 });
95
- }
96
-
97
- const removeState = () => {
98
- try {
99
- if (fs.existsSync(STATE_FILE)) fs.unlinkSync(STATE_FILE);
100
- } catch { /* ignore */ }
101
- };
102
-
103
- browserManager.setShutdownCallback(() => {
104
- console.log("[ftm-browse] Browser shut down, removing state and exiting");
105
- removeState();
106
- process.exit(0);
107
- });
108
-
109
- const cleanup = () => {
110
- removeState();
111
- process.exit(0);
112
- };
113
-
114
- process.on("SIGTERM", cleanup);
115
- process.on("SIGINT", cleanup);
116
- process.on("SIGHUP", cleanup);
117
-
118
- const server = Bun.serve({
119
- port,
120
- fetch(req: Request) {
121
- return handleRequest(req, token);
122
- },
123
- error(err: Error) {
124
- console.error("[ftm-browse] Server error:", err);
125
- return new Response("Internal Server Error", { status: 500 });
126
- },
127
- });
128
-
129
- fs.writeFileSync(STATE_FILE, JSON.stringify({ port, token, pid: process.pid }, null, 2), {
130
- mode: 0o600,
131
- encoding: "utf-8",
132
- });
133
-
134
- console.log(`[ftm-browse] Daemon ready. PID: ${process.pid}, Port: ${port}`);
135
-
136
- await new Promise<void>((resolve) => {
137
- process.on("exit", resolve);
138
- });
139
-
140
- server.stop();
141
- }
142
-
143
- // ─── CLI Mode ─────────────────────────────────────────────────────────────────
144
-
145
- async function ensureDaemon(): Promise<DaemonState> {
146
- const existing = readState();
147
- if (existing && isProcessAlive(existing.pid)) {
148
- return existing;
149
- }
150
-
151
- try {
152
- if (fs.existsSync(STATE_FILE)) fs.unlinkSync(STATE_FILE);
153
- } catch { /* ignore */ }
154
-
155
- console.error("[ftm-browse] Starting daemon...");
156
-
157
- // Spawn self with --server flag (works for both compiled binary and bun run)
158
- const selfPath = process.execPath;
159
- let spawnArgs: string[];
160
-
161
- if (selfPath.endsWith("bun") || selfPath.includes("/bun/")) {
162
- // Running under bun directly — spawn server.ts
163
- const serverScript = path.join(import.meta.dir, "server.ts");
164
- spawnArgs = [selfPath, "run", serverScript];
165
- } else {
166
- // Running as compiled binary — spawn self in server mode
167
- spawnArgs = [selfPath, "--server"];
168
- }
169
-
170
- const proc = Bun.spawn(spawnArgs, {
171
- stdout: "pipe",
172
- stderr: "pipe",
173
- stdin: "pipe",
174
- detached: true,
175
- });
176
-
177
- proc.unref();
178
-
179
- const timeout = Date.now() + 10000;
180
- while (Date.now() < timeout) {
181
- await Bun.sleep(100);
182
- const state = readState();
183
- if (state && isProcessAlive(state.pid)) {
184
- console.error(`[ftm-browse] Daemon started on port ${state.port}`);
185
- return state;
186
- }
187
- }
188
-
189
- throw new Error(
190
- "Daemon failed to start within 10 seconds. Check ~/.ftm-browse/logs for details."
191
- );
192
- }
193
-
194
- async function sendCommand(
195
- state: DaemonState,
196
- command: string,
197
- args: Record<string, unknown>
198
- ): Promise<unknown> {
199
- const url = `http://127.0.0.1:${state.port}/${command}`;
200
- const response = await fetch(url, {
201
- method: "POST",
202
- headers: {
203
- "Content-Type": "application/json",
204
- Authorization: `Bearer ${state.token}`,
205
- },
206
- body: JSON.stringify(args),
207
- });
208
- return response.json();
209
- }
210
-
211
- interface ParsedCommand {
212
- command: string;
213
- args: Record<string, unknown>;
214
- }
215
-
216
- function parseArgs(argv: string[]): ParsedCommand {
217
- // argv[0] is the executable, argv[1] is the first real arg for compiled binary
218
- // For compiled: process.argv = ["/path/to/ftm-browse", "goto", "url"]
219
- // For bun run: process.argv = ["bun", "cli.ts", "goto", "url"]
220
- const args = argv.slice(2);
221
-
222
- if (args.length === 0) {
223
- printUsage();
224
- process.exit(1);
225
- }
226
-
227
- const command = args[0];
228
-
229
- switch (command) {
230
- case "goto": {
231
- if (!args[1]) { console.error("Usage: ftm-browse goto <url>"); process.exit(1); }
232
- return { command: "goto", args: { url: args[1] } };
233
- }
234
- case "snapshot": {
235
- const interactiveOnly = args.includes("-i") || args.includes("--interactive");
236
- return { command: "snapshot", args: { interactive_only: interactiveOnly } };
237
- }
238
- case "screenshot": {
239
- const pathIndex = args.indexOf("--path");
240
- const screenshotPath = pathIndex !== -1 && args[pathIndex + 1] ? args[pathIndex + 1] : undefined;
241
- return { command: "screenshot", args: screenshotPath ? { path: screenshotPath } : {} };
242
- }
243
- case "click": {
244
- if (!args[1]) { console.error("Usage: ftm-browse click <@ref>"); process.exit(1); }
245
- return { command: "click", args: { ref: args[1] } };
246
- }
247
- case "fill": {
248
- if (!args[1] || args[2] === undefined) { console.error("Usage: ftm-browse fill <@ref> <value>"); process.exit(1); }
249
- return { command: "fill", args: { ref: args[1], value: args.slice(2).join(" ") } };
250
- }
251
- case "press": {
252
- if (!args[1]) { console.error("Usage: ftm-browse press <key>"); process.exit(1); }
253
- return { command: "press", args: { key: args[1] } };
254
- }
255
- case "text": return { command: "text", args: {} };
256
- case "html": return { command: "html", args: {} };
257
- case "tabs": return { command: "tabs", args: {} };
258
- case "chain": {
259
- if (!args[1]) { console.error("Usage: ftm-browse chain <json-array>"); process.exit(1); }
260
- let commands: unknown;
261
- try { commands = JSON.parse(args[1]); } catch { console.error("Error: chain argument must be valid JSON array"); process.exit(1); }
262
- if (!Array.isArray(commands)) { console.error("Error: chain argument must be a JSON array"); process.exit(1); }
263
- return { command: "chain", args: { commands } };
264
- }
265
- case "health": return { command: "health", args: {} };
266
- case "stop":
267
- case "shutdown": return { command: "__shutdown__", args: {} };
268
- case "--help":
269
- case "-h":
270
- case "help": { printUsage(); process.exit(0); }
271
- default: {
272
- console.error(`Unknown command: ${command}`);
273
- printUsage();
274
- process.exit(1);
275
- }
276
- }
277
- }
278
-
279
- function printUsage(): void {
280
- console.error(`
281
- ftm-browse - Headless browser daemon for Claude Code agents
282
-
283
- USAGE:
284
- ftm-browse <command> [args]
285
-
286
- COMMANDS:
287
- goto <url> Navigate to URL
288
- snapshot [-i] Get ARIA tree snapshot. -i = interactive elements only
289
- screenshot [--path <file>] Take screenshot (default: ~/.ftm-browse/screenshots/)
290
- click <@ref> Click element by ref (e.g. @e1)
291
- fill <@ref> <value> Fill input element by ref
292
- press <key> Press keyboard key (e.g. Enter, Tab, Escape)
293
- text Get page text content
294
- html Get page HTML
295
- tabs List all open tabs
296
- chain <json-array> Execute multiple commands sequentially
297
- health Check daemon health
298
- stop Stop the daemon
299
- `);
300
- }
301
-
302
- async function runCli(): Promise<void> {
303
- const parsed = parseArgs(process.argv);
304
-
305
- if (parsed.command === "__shutdown__") {
306
- const state = readState();
307
- if (!state) { console.error("No daemon running."); process.exit(0); }
308
- try {
309
- process.kill(state.pid, "SIGTERM");
310
- console.log(`Sent SIGTERM to daemon (PID ${state.pid})`);
311
- } catch {
312
- console.error("Failed to send signal to daemon");
313
- }
314
- process.exit(0);
315
- }
316
-
317
- let state: DaemonState;
318
- try {
319
- state = await ensureDaemon();
320
- } catch (err) {
321
- console.error("Error:", err instanceof Error ? err.message : String(err));
322
- process.exit(1);
323
- }
324
-
325
- let result: unknown;
326
- try {
327
- result = await sendCommand(state, parsed.command, parsed.args);
328
- } catch (err) {
329
- console.error("Failed to connect to daemon:", err instanceof Error ? err.message : String(err));
330
- process.exit(1);
331
- }
332
-
333
- console.log(JSON.stringify(result, null, 2));
334
-
335
- const typedResult = result as { success?: boolean };
336
- if (typedResult && typeof typedResult === "object" && typedResult.success === false) {
337
- process.exit(1);
338
- }
339
-
340
- process.exit(0);
341
- }
342
-
343
- // ─── Entry Point ──────────────────────────────────────────────────────────────
344
-
345
- const firstArg = process.argv[2];
346
-
347
- if (firstArg === "--server") {
348
- runServer().catch((err) => {
349
- console.error("[ftm-browse] Fatal server error:", err instanceof Error ? err.message : String(err));
350
- process.exit(1);
351
- });
352
- } else {
353
- runCli().catch((err) => {
354
- console.error("Fatal error:", err instanceof Error ? err.message : String(err));
355
- process.exit(1);
356
- });
357
- }
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * main.ts — Unified entry point for the compiled ftm-browse binary.
4
+ *
5
+ * When invoked as:
6
+ * ftm-browse --server → runs the HTTP daemon (server.ts logic)
7
+ * ftm-browse <command> ... → runs the CLI client (cli.ts logic)
8
+ */
9
+
10
+ import * as path from "path";
11
+ import * as fs from "fs";
12
+ import * as crypto from "crypto";
13
+ import { browserManager } from "./browser-manager.ts";
14
+ import { executeCommand } from "./commands.ts";
15
+
16
+ // ─── Shared Types & Helpers ───────────────────────────────────────────────────
17
+
18
+ const STATE_DIR = path.join(process.env.HOME || "~", ".ftm-browse");
19
+ const STATE_FILE = path.join(STATE_DIR, "state.json");
20
+
21
+ interface DaemonState {
22
+ port: number;
23
+ token: string;
24
+ pid: number;
25
+ }
26
+
27
+ function readState(): DaemonState | null {
28
+ try {
29
+ if (!fs.existsSync(STATE_FILE)) return null;
30
+ const raw = fs.readFileSync(STATE_FILE, "utf-8");
31
+ return JSON.parse(raw) as DaemonState;
32
+ } catch {
33
+ return null;
34
+ }
35
+ }
36
+
37
+ function isProcessAlive(pid: number): boolean {
38
+ try {
39
+ process.kill(pid, 0);
40
+ return true;
41
+ } catch {
42
+ return false;
43
+ }
44
+ }
45
+
46
+ // ─── Server Mode ─────────────────────────────────────────────────────────────
47
+
48
+ function sendJson(data: unknown, status = 200): Response {
49
+ return new Response(JSON.stringify(data), {
50
+ status,
51
+ headers: { "Content-Type": "application/json" },
52
+ });
53
+ }
54
+
55
+ async function handleRequest(req: Request, token: string): Promise<Response> {
56
+ const authHeader = req.headers.get("Authorization");
57
+ if (!authHeader || authHeader !== `Bearer ${token}`) {
58
+ return sendJson({ error: "Unauthorized" }, 401);
59
+ }
60
+
61
+ const url = new URL(req.url);
62
+ const command = url.pathname.slice(1);
63
+
64
+ if (req.method !== "POST") {
65
+ return sendJson({ error: "Method not allowed" }, 405);
66
+ }
67
+
68
+ if (command === "health") {
69
+ return sendJson({ status: "ok", pid: process.pid });
70
+ }
71
+
72
+ let body: Record<string, unknown> = {};
73
+ try {
74
+ const text = await req.text();
75
+ if (text.trim()) {
76
+ body = JSON.parse(text);
77
+ }
78
+ } catch {
79
+ return sendJson({ error: "Invalid JSON body" }, 400);
80
+ }
81
+
82
+ const result = await executeCommand(command, body);
83
+ return sendJson(result, result.success ? 200 : 400);
84
+ }
85
+
86
+ async function runServer(): Promise<void> {
87
+ const port = Math.floor(Math.random() * (60000 - 10000 + 1)) + 10000;
88
+ const token = crypto.randomBytes(32).toString("hex");
89
+
90
+ console.log(`[ftm-browse] Starting daemon on port ${port}`);
91
+
92
+ // Ensure state dir exists
93
+ if (!fs.existsSync(STATE_DIR)) {
94
+ fs.mkdirSync(STATE_DIR, { recursive: true, mode: 0o700 });
95
+ }
96
+
97
+ const removeState = () => {
98
+ try {
99
+ if (fs.existsSync(STATE_FILE)) fs.unlinkSync(STATE_FILE);
100
+ } catch { /* ignore */ }
101
+ };
102
+
103
+ browserManager.setShutdownCallback(() => {
104
+ console.log("[ftm-browse] Browser shut down, removing state and exiting");
105
+ removeState();
106
+ process.exit(0);
107
+ });
108
+
109
+ const cleanup = () => {
110
+ removeState();
111
+ process.exit(0);
112
+ };
113
+
114
+ process.on("SIGTERM", cleanup);
115
+ process.on("SIGINT", cleanup);
116
+ process.on("SIGHUP", cleanup);
117
+
118
+ const server = Bun.serve({
119
+ port,
120
+ fetch(req: Request) {
121
+ return handleRequest(req, token);
122
+ },
123
+ error(err: Error) {
124
+ console.error("[ftm-browse] Server error:", err);
125
+ return new Response("Internal Server Error", { status: 500 });
126
+ },
127
+ });
128
+
129
+ fs.writeFileSync(STATE_FILE, JSON.stringify({ port, token, pid: process.pid }, null, 2), {
130
+ mode: 0o600,
131
+ encoding: "utf-8",
132
+ });
133
+
134
+ console.log(`[ftm-browse] Daemon ready. PID: ${process.pid}, Port: ${port}`);
135
+
136
+ await new Promise<void>((resolve) => {
137
+ process.on("exit", resolve);
138
+ });
139
+
140
+ server.stop();
141
+ }
142
+
143
+ // ─── CLI Mode ─────────────────────────────────────────────────────────────────
144
+
145
+ async function ensureDaemon(): Promise<DaemonState> {
146
+ const existing = readState();
147
+ if (existing && isProcessAlive(existing.pid)) {
148
+ return existing;
149
+ }
150
+
151
+ try {
152
+ if (fs.existsSync(STATE_FILE)) fs.unlinkSync(STATE_FILE);
153
+ } catch { /* ignore */ }
154
+
155
+ console.error("[ftm-browse] Starting daemon...");
156
+
157
+ // Spawn self with --server flag (works for both compiled binary and bun run)
158
+ const selfPath = process.execPath;
159
+ let spawnArgs: string[];
160
+
161
+ if (selfPath.endsWith("bun") || selfPath.includes("/bun/")) {
162
+ // Running under bun directly — spawn server.ts
163
+ const serverScript = path.join(import.meta.dir, "server.ts");
164
+ spawnArgs = [selfPath, "run", serverScript];
165
+ } else {
166
+ // Running as compiled binary — spawn self in server mode
167
+ spawnArgs = [selfPath, "--server"];
168
+ }
169
+
170
+ const proc = Bun.spawn(spawnArgs, {
171
+ stdout: "pipe",
172
+ stderr: "pipe",
173
+ stdin: "pipe",
174
+ detached: true,
175
+ });
176
+
177
+ proc.unref();
178
+
179
+ const timeout = Date.now() + 10000;
180
+ while (Date.now() < timeout) {
181
+ await Bun.sleep(100);
182
+ const state = readState();
183
+ if (state && isProcessAlive(state.pid)) {
184
+ console.error(`[ftm-browse] Daemon started on port ${state.port}`);
185
+ return state;
186
+ }
187
+ }
188
+
189
+ throw new Error(
190
+ "Daemon failed to start within 10 seconds. Check ~/.ftm-browse/logs for details."
191
+ );
192
+ }
193
+
194
+ async function sendCommand(
195
+ state: DaemonState,
196
+ command: string,
197
+ args: Record<string, unknown>
198
+ ): Promise<unknown> {
199
+ const url = `http://127.0.0.1:${state.port}/${command}`;
200
+ const response = await fetch(url, {
201
+ method: "POST",
202
+ headers: {
203
+ "Content-Type": "application/json",
204
+ Authorization: `Bearer ${state.token}`,
205
+ },
206
+ body: JSON.stringify(args),
207
+ });
208
+ return response.json();
209
+ }
210
+
211
+ interface ParsedCommand {
212
+ command: string;
213
+ args: Record<string, unknown>;
214
+ }
215
+
216
+ function parseArgs(argv: string[]): ParsedCommand {
217
+ // argv[0] is the executable, argv[1] is the first real arg for compiled binary
218
+ // For compiled: process.argv = ["/path/to/ftm-browse", "goto", "url"]
219
+ // For bun run: process.argv = ["bun", "cli.ts", "goto", "url"]
220
+ const args = argv.slice(2);
221
+
222
+ if (args.length === 0) {
223
+ printUsage();
224
+ process.exit(1);
225
+ }
226
+
227
+ const command = args[0];
228
+
229
+ switch (command) {
230
+ case "goto": {
231
+ if (!args[1]) { console.error("Usage: ftm-browse goto <url>"); process.exit(1); }
232
+ return { command: "goto", args: { url: args[1] } };
233
+ }
234
+ case "snapshot": {
235
+ const interactiveOnly = args.includes("-i") || args.includes("--interactive");
236
+ return { command: "snapshot", args: { interactive_only: interactiveOnly } };
237
+ }
238
+ case "screenshot": {
239
+ const pathIndex = args.indexOf("--path");
240
+ const screenshotPath = pathIndex !== -1 && args[pathIndex + 1] ? args[pathIndex + 1] : undefined;
241
+ return { command: "screenshot", args: screenshotPath ? { path: screenshotPath } : {} };
242
+ }
243
+ case "click": {
244
+ if (!args[1]) { console.error("Usage: ftm-browse click <@ref>"); process.exit(1); }
245
+ return { command: "click", args: { ref: args[1] } };
246
+ }
247
+ case "fill": {
248
+ if (!args[1] || args[2] === undefined) { console.error("Usage: ftm-browse fill <@ref> <value>"); process.exit(1); }
249
+ return { command: "fill", args: { ref: args[1], value: args.slice(2).join(" ") } };
250
+ }
251
+ case "press": {
252
+ if (!args[1]) { console.error("Usage: ftm-browse press <key>"); process.exit(1); }
253
+ return { command: "press", args: { key: args[1] } };
254
+ }
255
+ case "text": return { command: "text", args: {} };
256
+ case "html": return { command: "html", args: {} };
257
+ case "tabs": return { command: "tabs", args: {} };
258
+ case "chain": {
259
+ if (!args[1]) { console.error("Usage: ftm-browse chain <json-array>"); process.exit(1); }
260
+ let commands: unknown;
261
+ try { commands = JSON.parse(args[1]); } catch { console.error("Error: chain argument must be valid JSON array"); process.exit(1); }
262
+ if (!Array.isArray(commands)) { console.error("Error: chain argument must be a JSON array"); process.exit(1); }
263
+ return { command: "chain", args: { commands } };
264
+ }
265
+ case "health": return { command: "health", args: {} };
266
+ case "stop":
267
+ case "shutdown": return { command: "__shutdown__", args: {} };
268
+ case "--help":
269
+ case "-h":
270
+ case "help": { printUsage(); process.exit(0); }
271
+ default: {
272
+ console.error(`Unknown command: ${command}`);
273
+ printUsage();
274
+ process.exit(1);
275
+ }
276
+ }
277
+ }
278
+
279
+ function printUsage(): void {
280
+ console.error(`
281
+ ftm-browse - Headless browser daemon for Claude Code agents
282
+
283
+ USAGE:
284
+ ftm-browse <command> [args]
285
+
286
+ COMMANDS:
287
+ goto <url> Navigate to URL
288
+ snapshot [-i] Get ARIA tree snapshot. -i = interactive elements only
289
+ screenshot [--path <file>] Take screenshot (default: ~/.ftm-browse/screenshots/)
290
+ click <@ref> Click element by ref (e.g. @e1)
291
+ fill <@ref> <value> Fill input element by ref
292
+ press <key> Press keyboard key (e.g. Enter, Tab, Escape)
293
+ text Get page text content
294
+ html Get page HTML
295
+ tabs List all open tabs
296
+ chain <json-array> Execute multiple commands sequentially
297
+ health Check daemon health
298
+ stop Stop the daemon
299
+ `);
300
+ }
301
+
302
+ async function runCli(): Promise<void> {
303
+ const parsed = parseArgs(process.argv);
304
+
305
+ if (parsed.command === "__shutdown__") {
306
+ const state = readState();
307
+ if (!state) { console.error("No daemon running."); process.exit(0); }
308
+ try {
309
+ process.kill(state.pid, "SIGTERM");
310
+ console.log(`Sent SIGTERM to daemon (PID ${state.pid})`);
311
+ } catch {
312
+ console.error("Failed to send signal to daemon");
313
+ }
314
+ process.exit(0);
315
+ }
316
+
317
+ let state: DaemonState;
318
+ try {
319
+ state = await ensureDaemon();
320
+ } catch (err) {
321
+ console.error("Error:", err instanceof Error ? err.message : String(err));
322
+ process.exit(1);
323
+ }
324
+
325
+ let result: unknown;
326
+ try {
327
+ result = await sendCommand(state, parsed.command, parsed.args);
328
+ } catch (err) {
329
+ console.error("Failed to connect to daemon:", err instanceof Error ? err.message : String(err));
330
+ process.exit(1);
331
+ }
332
+
333
+ console.log(JSON.stringify(result, null, 2));
334
+
335
+ const typedResult = result as { success?: boolean };
336
+ if (typedResult && typeof typedResult === "object" && typedResult.success === false) {
337
+ process.exit(1);
338
+ }
339
+
340
+ process.exit(0);
341
+ }
342
+
343
+ // ─── Entry Point ──────────────────────────────────────────────────────────────
344
+
345
+ const firstArg = process.argv[2];
346
+
347
+ if (firstArg === "--server") {
348
+ runServer().catch((err) => {
349
+ console.error("[ftm-browse] Fatal server error:", err instanceof Error ? err.message : String(err));
350
+ process.exit(1);
351
+ });
352
+ } else {
353
+ runCli().catch((err) => {
354
+ console.error("Fatal error:", err instanceof Error ? err.message : String(err));
355
+ process.exit(1);
356
+ });
357
+ }