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,252 +1,252 @@
1
- #!/usr/bin/env node
2
- import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
3
- import { resolve } from 'path';
4
- import { createHash } from 'crypto';
5
- import { homedir } from 'os';
6
-
7
- const STATE_DIR = resolve(homedir(), '.claude', 'ftm-state');
8
- const STATE_FILE = resolve(STATE_DIR, 'runtime-state.json');
9
-
10
- // --- Parsing ---
11
-
12
- export function parsePlan(markdown) {
13
- const tasks = [];
14
- const blocks = markdown.split(/(?=^### Task \d+:)/m).filter(b => b.trim());
15
-
16
- for (const block of blocks) {
17
- const idMatch = block.match(/^### Task (\d+):\s*(.+)/m);
18
- if (!idMatch) continue;
19
-
20
- const id = parseInt(idMatch[1], 10);
21
- const title = idMatch[2].trim();
22
-
23
- const get = (field) => {
24
- const m = block.match(new RegExp(`\\*\\*${field}:\\*\\*\\s*(.+)`));
25
- return m ? m[1].trim() : '';
26
- };
27
- const splitList = (raw) => (!raw || raw.toLowerCase() === 'none')
28
- ? [] : raw.split(',').map(s => s.trim()).filter(Boolean);
29
-
30
- const rawDeps = get('Dependencies');
31
- const dependencies = splitList(rawDeps).map(d => {
32
- const m = d.match(/Task\s+(\d+)/i);
33
- return m ? parseInt(m[1], 10) : null;
34
- }).filter(Boolean);
35
-
36
- const files = splitList(get('Files'));
37
-
38
- const criteriaMatches = [...block.matchAll(/^-\s*\[[ x]\]\s*(.+)/gm)];
39
- const acceptance_criteria = criteriaMatches.map(m => m[1].trim());
40
-
41
- tasks.push({
42
- id,
43
- title,
44
- description: get('Description'),
45
- files,
46
- dependencies,
47
- agent_type: get('Agent type'),
48
- acceptance_criteria,
49
- });
50
- }
51
-
52
- tasks.sort((a, b) => a.id - b.id);
53
- return tasks;
54
- }
55
-
56
- // --- Wave grouping ---
57
-
58
- export function computeWaves(tasks) {
59
- const allIds = new Set(tasks.map(t => t.id));
60
-
61
- for (const task of tasks) {
62
- for (const dep of task.dependencies) {
63
- if (!allIds.has(dep)) {
64
- throw new Error(`Task ${task.id} references unknown dependency Task ${dep}`);
65
- }
66
- }
67
- }
68
-
69
- const remaining = new Set(tasks.map(t => t.id));
70
- const completed = new Set();
71
- const waves = [];
72
- const taskMap = Object.fromEntries(tasks.map(t => [t.id, t]));
73
-
74
- while (remaining.size > 0) {
75
- const wave = [...remaining].filter(id =>
76
- taskMap[id].dependencies.every(dep => completed.has(dep))
77
- );
78
-
79
- if (wave.length === 0) {
80
- const cycle = [...remaining].join(', ');
81
- throw new Error(`Circular dependency detected among tasks: ${cycle}`);
82
- }
83
-
84
- waves.push(wave.sort((a, b) => a - b));
85
- for (const id of wave) {
86
- completed.add(id);
87
- remaining.delete(id);
88
- }
89
- }
90
-
91
- return waves;
92
- }
93
-
94
- // --- State I/O ---
95
-
96
- function readState() {
97
- if (!existsSync(STATE_FILE)) return null;
98
- return JSON.parse(readFileSync(STATE_FILE, 'utf8'));
99
- }
100
-
101
- function requireState() {
102
- const s = readState();
103
- if (!s) { console.error('Error: No active plan. Run plan-index first.'); process.exit(1); }
104
- return s;
105
- }
106
-
107
- function writeState(state) {
108
- mkdirSync(STATE_DIR, { recursive: true });
109
- state.updated_at = new Date().toISOString();
110
- writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
111
- }
112
-
113
- function hashContent(content) {
114
- return createHash('sha256').update(content).digest('hex');
115
- }
116
-
117
- // --- Commands ---
118
-
119
- function cmdPlanIndex(planPath) {
120
- const absPath = resolve(planPath);
121
- if (!existsSync(absPath)) {
122
- console.error(`Error: Plan file not found: ${absPath}`);
123
- process.exit(1);
124
- }
125
-
126
- const content = readFileSync(absPath, 'utf8');
127
- const tasks = parsePlan(content);
128
- const waves = computeWaves(tasks);
129
-
130
- const taskState = {};
131
- for (const task of tasks) {
132
- taskState[task.id] = { ...task, status: 'pending', completed_at: null };
133
- }
134
-
135
- const state = {
136
- plan_path: absPath,
137
- plan_hash: hashContent(content),
138
- tasks: taskState,
139
- waves,
140
- current_wave: 0,
141
- started_at: new Date().toISOString(),
142
- updated_at: new Date().toISOString(),
143
- };
144
-
145
- writeState(state);
146
-
147
- console.log(JSON.stringify({
148
- tasks,
149
- waves,
150
- total_tasks: tasks.length,
151
- total_waves: waves.length,
152
- }, null, 2));
153
- }
154
-
155
- function cmdNextWave() {
156
- const state = requireState();
157
- const done = { wave_number: null, tasks: [], remaining_waves: 0, complete: true };
158
-
159
- for (let i = 0; i < state.waves.length; i++) {
160
- const pending = state.waves[i].filter(id => state.tasks[id]?.status !== 'completed');
161
- if (pending.length > 0) {
162
- const remaining_waves = state.waves.slice(i + 1)
163
- .filter(w => w.some(id => state.tasks[id]?.status !== 'completed')).length;
164
- console.log(JSON.stringify({ wave_number: i + 1, tasks: pending.map(id => state.tasks[id]), remaining_waves }, null, 2));
165
- return;
166
- }
167
- }
168
- console.log(JSON.stringify(done, null, 2));
169
- }
170
-
171
- function cmdMarkComplete(taskIdArg) {
172
- const taskId = parseInt(taskIdArg, 10);
173
- if (isNaN(taskId)) { console.error(`Error: Invalid task ID: ${taskIdArg}`); process.exit(1); }
174
-
175
- const state = requireState();
176
- if (!state.tasks[taskId]) {
177
- console.error(`Error: Task ${taskId} not found in current plan.`); process.exit(1);
178
- }
179
-
180
- state.tasks[taskId].status = 'completed';
181
- state.tasks[taskId].completed_at = new Date().toISOString();
182
-
183
- const waveIdx = state.waves.findIndex(w => w.includes(taskId));
184
- const wave = waveIdx >= 0 ? state.waves[waveIdx] : [];
185
- const waveCompleted = wave.filter(id => state.tasks[id]?.status === 'completed').length;
186
- const totalCompleted = Object.values(state.tasks).filter(t => t.status === 'completed').length;
187
-
188
- writeState(state);
189
-
190
- console.log(JSON.stringify({
191
- task_id: taskId,
192
- status: 'completed',
193
- wave_progress: `${waveCompleted}/${wave.length}`,
194
- plan_progress: `${totalCompleted}/${Object.keys(state.tasks).length}`,
195
- }, null, 2));
196
- }
197
-
198
- function cmdStatus() {
199
- const state = requireState();
200
-
201
- const tasks = Object.values(state.tasks);
202
- const completed = tasks.filter(t => t.status === 'completed').length;
203
- const pending = tasks.filter(t => t.status === 'pending').length;
204
-
205
- let current_wave = null;
206
- let waves_remaining = 0;
207
-
208
- for (let i = 0; i < state.waves.length; i++) {
209
- const wave = state.waves[i];
210
- const hasPending = wave.some(id => state.tasks[id]?.status !== 'completed');
211
- if (hasPending) {
212
- current_wave = i + 1;
213
- waves_remaining = state.waves.slice(i).filter(w =>
214
- w.some(id => state.tasks[id]?.status !== 'completed')
215
- ).length;
216
- break;
217
- }
218
- }
219
-
220
- console.log(JSON.stringify({
221
- total_tasks: tasks.length,
222
- completed_tasks: completed,
223
- current_wave,
224
- waves_remaining,
225
- tasks_by_status: { pending, completed },
226
- }, null, 2));
227
- }
228
-
229
- // --- Entry point ---
230
-
231
- const [,, command, ...args] = process.argv;
232
-
233
- switch (command) {
234
- case 'plan-index':
235
- if (!args[0]) { console.error('Usage: ftm-runtime plan-index <plan-path>'); process.exit(1); }
236
- cmdPlanIndex(args[0]);
237
- break;
238
- case 'next-wave':
239
- cmdNextWave();
240
- break;
241
- case 'mark-complete':
242
- if (!args[0]) { console.error('Usage: ftm-runtime mark-complete <task-id>'); process.exit(1); }
243
- cmdMarkComplete(args[0]);
244
- break;
245
- case 'status':
246
- cmdStatus();
247
- break;
248
- default:
249
- console.error(`Unknown command: ${command}`);
250
- console.error('Commands: plan-index, next-wave, mark-complete, status');
251
- process.exit(1);
252
- }
1
+ #!/usr/bin/env node
2
+ import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
3
+ import { resolve } from 'path';
4
+ import { createHash } from 'crypto';
5
+ import { homedir } from 'os';
6
+
7
+ const STATE_DIR = resolve(homedir(), '.claude', 'ftm-state');
8
+ const STATE_FILE = resolve(STATE_DIR, 'runtime-state.json');
9
+
10
+ // --- Parsing ---
11
+
12
+ export function parsePlan(markdown) {
13
+ const tasks = [];
14
+ const blocks = markdown.split(/(?=^### Task \d+:)/m).filter(b => b.trim());
15
+
16
+ for (const block of blocks) {
17
+ const idMatch = block.match(/^### Task (\d+):\s*(.+)/m);
18
+ if (!idMatch) continue;
19
+
20
+ const id = parseInt(idMatch[1], 10);
21
+ const title = idMatch[2].trim();
22
+
23
+ const get = (field) => {
24
+ const m = block.match(new RegExp(`\\*\\*${field}:\\*\\*\\s*(.+)`));
25
+ return m ? m[1].trim() : '';
26
+ };
27
+ const splitList = (raw) => (!raw || raw.toLowerCase() === 'none')
28
+ ? [] : raw.split(',').map(s => s.trim()).filter(Boolean);
29
+
30
+ const rawDeps = get('Dependencies');
31
+ const dependencies = splitList(rawDeps).map(d => {
32
+ const m = d.match(/Task\s+(\d+)/i);
33
+ return m ? parseInt(m[1], 10) : null;
34
+ }).filter(Boolean);
35
+
36
+ const files = splitList(get('Files'));
37
+
38
+ const criteriaMatches = [...block.matchAll(/^-\s*\[[ x]\]\s*(.+)/gm)];
39
+ const acceptance_criteria = criteriaMatches.map(m => m[1].trim());
40
+
41
+ tasks.push({
42
+ id,
43
+ title,
44
+ description: get('Description'),
45
+ files,
46
+ dependencies,
47
+ agent_type: get('Agent type'),
48
+ acceptance_criteria,
49
+ });
50
+ }
51
+
52
+ tasks.sort((a, b) => a.id - b.id);
53
+ return tasks;
54
+ }
55
+
56
+ // --- Wave grouping ---
57
+
58
+ export function computeWaves(tasks) {
59
+ const allIds = new Set(tasks.map(t => t.id));
60
+
61
+ for (const task of tasks) {
62
+ for (const dep of task.dependencies) {
63
+ if (!allIds.has(dep)) {
64
+ throw new Error(`Task ${task.id} references unknown dependency Task ${dep}`);
65
+ }
66
+ }
67
+ }
68
+
69
+ const remaining = new Set(tasks.map(t => t.id));
70
+ const completed = new Set();
71
+ const waves = [];
72
+ const taskMap = Object.fromEntries(tasks.map(t => [t.id, t]));
73
+
74
+ while (remaining.size > 0) {
75
+ const wave = [...remaining].filter(id =>
76
+ taskMap[id].dependencies.every(dep => completed.has(dep))
77
+ );
78
+
79
+ if (wave.length === 0) {
80
+ const cycle = [...remaining].join(', ');
81
+ throw new Error(`Circular dependency detected among tasks: ${cycle}`);
82
+ }
83
+
84
+ waves.push(wave.sort((a, b) => a - b));
85
+ for (const id of wave) {
86
+ completed.add(id);
87
+ remaining.delete(id);
88
+ }
89
+ }
90
+
91
+ return waves;
92
+ }
93
+
94
+ // --- State I/O ---
95
+
96
+ function readState() {
97
+ if (!existsSync(STATE_FILE)) return null;
98
+ return JSON.parse(readFileSync(STATE_FILE, 'utf8'));
99
+ }
100
+
101
+ function requireState() {
102
+ const s = readState();
103
+ if (!s) { console.error('Error: No active plan. Run plan-index first.'); process.exit(1); }
104
+ return s;
105
+ }
106
+
107
+ function writeState(state) {
108
+ mkdirSync(STATE_DIR, { recursive: true });
109
+ state.updated_at = new Date().toISOString();
110
+ writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
111
+ }
112
+
113
+ function hashContent(content) {
114
+ return createHash('sha256').update(content).digest('hex');
115
+ }
116
+
117
+ // --- Commands ---
118
+
119
+ function cmdPlanIndex(planPath) {
120
+ const absPath = resolve(planPath);
121
+ if (!existsSync(absPath)) {
122
+ console.error(`Error: Plan file not found: ${absPath}`);
123
+ process.exit(1);
124
+ }
125
+
126
+ const content = readFileSync(absPath, 'utf8');
127
+ const tasks = parsePlan(content);
128
+ const waves = computeWaves(tasks);
129
+
130
+ const taskState = {};
131
+ for (const task of tasks) {
132
+ taskState[task.id] = { ...task, status: 'pending', completed_at: null };
133
+ }
134
+
135
+ const state = {
136
+ plan_path: absPath,
137
+ plan_hash: hashContent(content),
138
+ tasks: taskState,
139
+ waves,
140
+ current_wave: 0,
141
+ started_at: new Date().toISOString(),
142
+ updated_at: new Date().toISOString(),
143
+ };
144
+
145
+ writeState(state);
146
+
147
+ console.log(JSON.stringify({
148
+ tasks,
149
+ waves,
150
+ total_tasks: tasks.length,
151
+ total_waves: waves.length,
152
+ }, null, 2));
153
+ }
154
+
155
+ function cmdNextWave() {
156
+ const state = requireState();
157
+ const done = { wave_number: null, tasks: [], remaining_waves: 0, complete: true };
158
+
159
+ for (let i = 0; i < state.waves.length; i++) {
160
+ const pending = state.waves[i].filter(id => state.tasks[id]?.status !== 'completed');
161
+ if (pending.length > 0) {
162
+ const remaining_waves = state.waves.slice(i + 1)
163
+ .filter(w => w.some(id => state.tasks[id]?.status !== 'completed')).length;
164
+ console.log(JSON.stringify({ wave_number: i + 1, tasks: pending.map(id => state.tasks[id]), remaining_waves }, null, 2));
165
+ return;
166
+ }
167
+ }
168
+ console.log(JSON.stringify(done, null, 2));
169
+ }
170
+
171
+ function cmdMarkComplete(taskIdArg) {
172
+ const taskId = parseInt(taskIdArg, 10);
173
+ if (isNaN(taskId)) { console.error(`Error: Invalid task ID: ${taskIdArg}`); process.exit(1); }
174
+
175
+ const state = requireState();
176
+ if (!state.tasks[taskId]) {
177
+ console.error(`Error: Task ${taskId} not found in current plan.`); process.exit(1);
178
+ }
179
+
180
+ state.tasks[taskId].status = 'completed';
181
+ state.tasks[taskId].completed_at = new Date().toISOString();
182
+
183
+ const waveIdx = state.waves.findIndex(w => w.includes(taskId));
184
+ const wave = waveIdx >= 0 ? state.waves[waveIdx] : [];
185
+ const waveCompleted = wave.filter(id => state.tasks[id]?.status === 'completed').length;
186
+ const totalCompleted = Object.values(state.tasks).filter(t => t.status === 'completed').length;
187
+
188
+ writeState(state);
189
+
190
+ console.log(JSON.stringify({
191
+ task_id: taskId,
192
+ status: 'completed',
193
+ wave_progress: `${waveCompleted}/${wave.length}`,
194
+ plan_progress: `${totalCompleted}/${Object.keys(state.tasks).length}`,
195
+ }, null, 2));
196
+ }
197
+
198
+ function cmdStatus() {
199
+ const state = requireState();
200
+
201
+ const tasks = Object.values(state.tasks);
202
+ const completed = tasks.filter(t => t.status === 'completed').length;
203
+ const pending = tasks.filter(t => t.status === 'pending').length;
204
+
205
+ let current_wave = null;
206
+ let waves_remaining = 0;
207
+
208
+ for (let i = 0; i < state.waves.length; i++) {
209
+ const wave = state.waves[i];
210
+ const hasPending = wave.some(id => state.tasks[id]?.status !== 'completed');
211
+ if (hasPending) {
212
+ current_wave = i + 1;
213
+ waves_remaining = state.waves.slice(i).filter(w =>
214
+ w.some(id => state.tasks[id]?.status !== 'completed')
215
+ ).length;
216
+ break;
217
+ }
218
+ }
219
+
220
+ console.log(JSON.stringify({
221
+ total_tasks: tasks.length,
222
+ completed_tasks: completed,
223
+ current_wave,
224
+ waves_remaining,
225
+ tasks_by_status: { pending, completed },
226
+ }, null, 2));
227
+ }
228
+
229
+ // --- Entry point ---
230
+
231
+ const [,, command, ...args] = process.argv;
232
+
233
+ switch (command) {
234
+ case 'plan-index':
235
+ if (!args[0]) { console.error('Usage: ftm-runtime plan-index <plan-path>'); process.exit(1); }
236
+ cmdPlanIndex(args[0]);
237
+ break;
238
+ case 'next-wave':
239
+ cmdNextWave();
240
+ break;
241
+ case 'mark-complete':
242
+ if (!args[0]) { console.error('Usage: ftm-runtime mark-complete <task-id>'); process.exit(1); }
243
+ cmdMarkComplete(args[0]);
244
+ break;
245
+ case 'status':
246
+ cmdStatus();
247
+ break;
248
+ default:
249
+ console.error(`Unknown command: ${command}`);
250
+ console.error('Commands: plan-index, next-wave, mark-complete, status');
251
+ process.exit(1);
252
+ }
@@ -1,8 +1,8 @@
1
- {
2
- "name": "ftm-runtime",
3
- "version": "1.0.0",
4
- "type": "module",
5
- "bin": {
6
- "ftm-runtime": "./ftm-runtime.mjs"
7
- }
8
- }
1
+ {
2
+ "name": "ftm-runtime",
3
+ "version": "1.0.0",
4
+ "type": "module",
5
+ "bin": {
6
+ "ftm-runtime": "./ftm-runtime.mjs"
7
+ }
8
+ }
package/ftm-executor.yml CHANGED
@@ -1,2 +1,2 @@
1
- name: ftm-executor
2
- description: Autonomous plan execution engine. Takes any plan document and executes it end-to-end with a dynamically assembled agent team — analyzing tasks, creating purpose-built agents, dispatching them in parallel worktrees, and running each through a commit-review-fix loop until complete. Use this skill whenever the user wants to execute a plan, run a plan doc, launch an agent team on tasks, or says things like "execute this plan", "run this", "launch agents on this doc", "take this plan and go", or points to a plan file and wants it implemented autonomously. Even if they just paste a plan path and say "go" — this is the skill.
1
+ name: ftm-executor
2
+ description: Autonomous plan execution engine. Takes any plan document and executes it end-to-end with a dynamically assembled agent team — analyzing tasks, creating purpose-built agents, dispatching them in parallel worktrees, and running each through a commit-review-fix loop until complete. Use this skill whenever the user wants to execute a plan, run a plan doc, launch an agent team on tasks, or says things like "execute this plan", "run this", "launch agents on this doc", "take this plan and go", or points to a plan file and wants it implemented autonomously. Even if they just paste a plan path and say "go" — this is the skill.