forge-workflow 0.0.3 → 0.0.5

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 (209) hide show
  1. package/.claude/commands/dev.md +340 -314
  2. package/.claude/commands/plan.md +521 -478
  3. package/.claude/commands/premerge.md +176 -179
  4. package/.claude/commands/research.md +42 -42
  5. package/.claude/commands/review.md +442 -442
  6. package/.claude/commands/rollback.md +721 -721
  7. package/.claude/commands/ship.md +164 -134
  8. package/.claude/commands/sonarcloud.md +152 -152
  9. package/.claude/commands/status.md +48 -77
  10. package/.claude/commands/validate.md +282 -237
  11. package/.claude/commands/verify.md +221 -221
  12. package/.claude/rules/greptile-review-process.md +285 -285
  13. package/.claude/rules/workflow.md +105 -105
  14. package/.claude/scripts/greptile-resolve.sh +526 -526
  15. package/.claude/scripts/load-env.sh +32 -32
  16. package/.cline/workflows/dev.md +337 -311
  17. package/.cline/workflows/plan.md +518 -475
  18. package/.cline/workflows/premerge.md +173 -176
  19. package/.cline/workflows/research.md +39 -39
  20. package/.cline/workflows/review.md +439 -439
  21. package/.cline/workflows/rollback.md +718 -718
  22. package/.cline/workflows/ship.md +161 -131
  23. package/.cline/workflows/sonarcloud.md +146 -146
  24. package/.cline/workflows/status.md +45 -74
  25. package/.cline/workflows/validate.md +279 -234
  26. package/.cline/workflows/verify.md +218 -218
  27. package/.codex/config.toml +11 -11
  28. package/.codex/skills/dev/SKILL.md +340 -314
  29. package/.codex/skills/plan/SKILL.md +521 -478
  30. package/.codex/skills/premerge/SKILL.md +176 -179
  31. package/.codex/skills/research/SKILL.md +42 -42
  32. package/.codex/skills/review/SKILL.md +442 -442
  33. package/.codex/skills/rollback/SKILL.md +721 -721
  34. package/.codex/skills/ship/SKILL.md +164 -134
  35. package/.codex/skills/sonarcloud/SKILL.md +149 -149
  36. package/.codex/skills/status/SKILL.md +48 -77
  37. package/.codex/skills/validate/SKILL.md +282 -237
  38. package/.codex/skills/verify/SKILL.md +221 -221
  39. package/.cursor/commands/dev.md +337 -311
  40. package/.cursor/commands/plan.md +518 -475
  41. package/.cursor/commands/premerge.md +173 -176
  42. package/.cursor/commands/research.md +39 -39
  43. package/.cursor/commands/review.md +439 -439
  44. package/.cursor/commands/rollback.md +718 -718
  45. package/.cursor/commands/ship.md +161 -131
  46. package/.cursor/commands/sonarcloud.md +146 -146
  47. package/.cursor/commands/status.md +45 -74
  48. package/.cursor/commands/validate.md +279 -234
  49. package/.cursor/commands/verify.md +218 -218
  50. package/.cursor/rules/permissions-guidance.mdc +37 -37
  51. package/.forge/hooks/check-tdd.js +240 -240
  52. package/.github/PLUGIN_TEMPLATE.json +32 -32
  53. package/.github/prompts/dev.prompt.md +342 -316
  54. package/.github/prompts/plan.prompt.md +523 -480
  55. package/.github/prompts/premerge.prompt.md +178 -181
  56. package/.github/prompts/research.prompt.md +44 -44
  57. package/.github/prompts/review.prompt.md +444 -444
  58. package/.github/prompts/rollback.prompt.md +723 -723
  59. package/.github/prompts/ship.prompt.md +166 -136
  60. package/.github/prompts/sonarcloud.prompt.md +151 -151
  61. package/.github/prompts/status.prompt.md +50 -79
  62. package/.github/prompts/validate.prompt.md +284 -239
  63. package/.github/prompts/verify.prompt.md +223 -223
  64. package/.github/workflows/beads-to-github.yml +56 -0
  65. package/.github/workflows/github-to-beads.yml +97 -0
  66. package/.kilocode/workflows/dev.md +341 -315
  67. package/.kilocode/workflows/plan.md +522 -479
  68. package/.kilocode/workflows/premerge.md +177 -180
  69. package/.kilocode/workflows/research.md +43 -43
  70. package/.kilocode/workflows/review.md +443 -443
  71. package/.kilocode/workflows/rollback.md +722 -722
  72. package/.kilocode/workflows/ship.md +165 -135
  73. package/.kilocode/workflows/sonarcloud.md +150 -150
  74. package/.kilocode/workflows/status.md +49 -78
  75. package/.kilocode/workflows/validate.md +283 -238
  76. package/.kilocode/workflows/verify.md +222 -222
  77. package/.mcp.json.example +12 -12
  78. package/.opencode/commands/dev.md +340 -314
  79. package/.opencode/commands/plan.md +521 -478
  80. package/.opencode/commands/premerge.md +176 -179
  81. package/.opencode/commands/research.md +42 -42
  82. package/.opencode/commands/review.md +442 -442
  83. package/.opencode/commands/rollback.md +721 -721
  84. package/.opencode/commands/ship.md +164 -134
  85. package/.opencode/commands/sonarcloud.md +149 -149
  86. package/.opencode/commands/status.md +48 -77
  87. package/.opencode/commands/validate.md +282 -237
  88. package/.opencode/commands/verify.md +221 -221
  89. package/.roo/commands/dev.md +341 -315
  90. package/.roo/commands/plan.md +522 -479
  91. package/.roo/commands/premerge.md +177 -180
  92. package/.roo/commands/research.md +43 -43
  93. package/.roo/commands/review.md +443 -443
  94. package/.roo/commands/rollback.md +722 -722
  95. package/.roo/commands/ship.md +165 -135
  96. package/.roo/commands/sonarcloud.md +150 -150
  97. package/.roo/commands/status.md +49 -78
  98. package/.roo/commands/validate.md +283 -238
  99. package/.roo/commands/verify.md +222 -222
  100. package/AGENTS.md +175 -169
  101. package/CLAUDE.md +100 -99
  102. package/LICENSE +21 -21
  103. package/README.md +429 -414
  104. package/bin/forge-cmd.js +313 -313
  105. package/bin/{forge-validate.js → forge-preflight.js} +309 -303
  106. package/bin/forge.js +4596 -4232
  107. package/docs/AGENT_INSTALL_PROMPT.md +342 -342
  108. package/docs/BEADS_GITHUB_SYNC.md +251 -0
  109. package/docs/ENHANCED_ONBOARDING.md +602 -602
  110. package/docs/EXAMPLES.md +482 -482
  111. package/docs/GREPTILE_SETUP.md +400 -400
  112. package/docs/MANUAL_REVIEW_GUIDE.md +106 -106
  113. package/docs/ROADMAP.md +359 -359
  114. package/docs/SETUP.md +663 -632
  115. package/docs/TOOLCHAIN.md +630 -630
  116. package/docs/VALIDATION.md +363 -363
  117. package/install.sh +40 -1058
  118. package/lefthook.yml +39 -39
  119. package/lib/agents/README.md +198 -198
  120. package/lib/agents/claude.plugin.json +28 -28
  121. package/lib/agents/cline.plugin.json +22 -22
  122. package/lib/agents/codex.plugin.json +19 -19
  123. package/lib/agents/copilot.plugin.json +24 -24
  124. package/lib/agents/cursor.plugin.json +25 -25
  125. package/lib/agents/kilocode.plugin.json +22 -22
  126. package/lib/agents/opencode.plugin.json +20 -20
  127. package/lib/agents/roo.plugin.json +23 -23
  128. package/lib/agents-config.js +2112 -2112
  129. package/lib/beads-health-check.js +143 -0
  130. package/lib/beads-setup.js +341 -0
  131. package/lib/beads-sync-scaffold.js +260 -0
  132. package/lib/commands/dev.js +513 -513
  133. package/lib/commands/plan.js +692 -692
  134. package/lib/commands/recommend.js +119 -119
  135. package/lib/commands/ship.js +377 -377
  136. package/lib/commands/status.js +378 -378
  137. package/lib/commands/validate.js +602 -602
  138. package/lib/context-merge.js +359 -359
  139. package/lib/dep-guard/analyzer.js +294 -294
  140. package/lib/dep-guard/behavior-detector.js +98 -98
  141. package/lib/dep-guard/contract-detector.js +162 -162
  142. package/lib/dep-guard/import-detector.js +498 -498
  143. package/lib/dep-guard/path-utils.js +13 -13
  144. package/lib/dep-guard/rubric.js +120 -120
  145. package/lib/dep-guard/task-parser.js +318 -318
  146. package/lib/detect-agent.js +191 -0
  147. package/lib/detect-worktree.js +47 -0
  148. package/lib/file-hash.js +26 -0
  149. package/lib/husky-migration.js +450 -0
  150. package/lib/lefthook-check.js +65 -0
  151. package/lib/pat-setup.js +207 -0
  152. package/lib/plugin-catalog.js +350 -350
  153. package/lib/plugin-manager.js +166 -166
  154. package/lib/plugin-recommender.js +141 -141
  155. package/lib/project-discovery.js +491 -491
  156. package/lib/setup-action-log.js +139 -0
  157. package/lib/setup-summary-renderer.js +106 -0
  158. package/lib/setup-utils.js +96 -0
  159. package/lib/setup.js +192 -118
  160. package/lib/smart-merge.js +64 -0
  161. package/lib/symlink-utils.js +81 -0
  162. package/lib/workflow-profiles.js +197 -197
  163. package/package.json +131 -129
  164. package/scripts/beads-context.sh +291 -0
  165. package/scripts/beads-context.test.js +563 -0
  166. package/scripts/behavioral-judge.sh +378 -0
  167. package/scripts/benchmark.js +85 -0
  168. package/scripts/branch-protection.js +183 -0
  169. package/scripts/check-agents.js +172 -0
  170. package/scripts/commitlint.js +42 -0
  171. package/scripts/conflict-detect.sh +323 -0
  172. package/scripts/dep-guard-analyze.js +71 -0
  173. package/scripts/dep-guard.sh +811 -0
  174. package/scripts/eval_win.py +249 -0
  175. package/scripts/file-index.sh +399 -0
  176. package/scripts/github-beads-sync/comment.mjs +64 -0
  177. package/scripts/github-beads-sync/config.mjs +148 -0
  178. package/scripts/github-beads-sync/github-api.mjs +131 -0
  179. package/scripts/github-beads-sync/index.mjs +332 -0
  180. package/scripts/github-beads-sync/label-mapper.mjs +54 -0
  181. package/scripts/github-beads-sync/mapping.mjs +78 -0
  182. package/scripts/github-beads-sync/reverse-sync-cli.mjs +31 -0
  183. package/scripts/github-beads-sync/reverse-sync.mjs +138 -0
  184. package/scripts/github-beads-sync/run-bd.mjs +159 -0
  185. package/scripts/github-beads-sync/sanitize.mjs +121 -0
  186. package/scripts/github-beads-sync.config.json +26 -0
  187. package/scripts/improve-command.js +375 -0
  188. package/scripts/lib/eval-runner.js +229 -0
  189. package/scripts/lib/eval-schema.js +135 -0
  190. package/scripts/lib/eval-storage.js +78 -0
  191. package/scripts/lib/grading.js +203 -0
  192. package/scripts/lib/transcript-parser.js +63 -0
  193. package/scripts/lint.js +47 -0
  194. package/scripts/migrate-to-bun-test.js +412 -0
  195. package/scripts/run-command-eval.js +236 -0
  196. package/scripts/smart-status.sh +782 -0
  197. package/scripts/sync-commands.js +571 -0
  198. package/scripts/sync-utils.sh +460 -0
  199. package/scripts/test-dashboard.js +123 -0
  200. package/scripts/test.js +44 -0
  201. package/scripts/validate.sh +94 -0
  202. package/skills/parallel-deep-research/SKILL.md +108 -108
  203. package/skills/parallel-deep-research/evals/README.md +27 -27
  204. package/skills/parallel-deep-research/evals/evals.json +62 -62
  205. package/skills/sonarcloud-analysis/SKILL.md +171 -171
  206. package/skills/sonarcloud-analysis/evals/README.md +27 -27
  207. package/skills/sonarcloud-analysis/evals/evals.json +50 -50
  208. package/skills/sonarcloud-analysis/references/api-reference.md +466 -466
  209. package/docs/WORKFLOW.md +0 -400
@@ -1,350 +1,350 @@
1
- /**
2
- * Plugin Catalog
3
- *
4
- * Static, frozen catalog of tools for the Forge workflow.
5
- * Read-only data — no installations, no side effects.
6
- */
7
-
8
- const TIERS = Object.freeze({
9
- FREE: 'free',
10
- FREE_PUBLIC: 'free-public',
11
- FREE_LIMITED: 'free-limited',
12
- PAID: 'paid',
13
- });
14
-
15
- const TOOL_TYPES = Object.freeze({
16
- CLI: 'cli',
17
- SKILL: 'skill',
18
- MCP: 'mcp',
19
- CONFIG: 'config',
20
- LSP: 'lsp',
21
- });
22
-
23
- const STAGES = Object.freeze({
24
- RESEARCH: 'research',
25
- PLAN: 'plan',
26
- DEV: 'dev',
27
- VALIDATE: 'validate',
28
- SHIP: 'ship',
29
- REVIEW: 'review',
30
- PREMERGE: 'premerge',
31
- });
32
-
33
- const BUDGET_MODES = Object.freeze({
34
- free: { label: 'Free only', includes: ['free'] },
35
- 'open-source': { label: 'Open source', includes: ['free', 'free-public'] },
36
- startup: { label: 'Startup', includes: ['free', 'free-public', 'free-limited'] },
37
- professional: { label: 'Professional', includes: ['free', 'free-public', 'free-limited', 'paid'] },
38
- custom: { label: 'Custom', includes: [] },
39
- });
40
-
41
- const PREREQUISITES = Object.freeze({
42
- node: { check: 'node --version', installUrl: 'https://nodejs.org' },
43
- git: { check: 'git --version', installUrl: 'https://git-scm.com' },
44
- gh: { check: 'gh --version', installUrl: 'https://cli.github.com' },
45
- bun: { check: 'bun --version', installUrl: 'https://bun.sh' },
46
- jq: { check: 'jq --version', installUrl: 'https://jqlang.github.io/jq/download/' },
47
- go: { check: 'go version', installUrl: 'https://go.dev/dl/' },
48
- curl: { check: 'curl --version', installUrl: null },
49
- 'parallel-cli': {
50
- check: 'parallel-cli --version',
51
- installUrl: 'https://parallel.ai/install.sh',
52
- },
53
- });
54
-
55
- const CATALOG = Object.freeze({
56
- // ── Research ──
57
- 'context7-mcp': {
58
- name: 'Context7',
59
- type: 'mcp',
60
- tier: 'free',
61
- stage: 'research',
62
- description: 'Up-to-date library documentation via MCP',
63
- detectWhen: [],
64
- install: { method: 'add-mcp', cmd: 'bunx add-mcp context7' },
65
- mcpJustified: true,
66
- },
67
- 'grep-app-mcp': {
68
- name: 'grep.app',
69
- type: 'mcp',
70
- tier: 'free',
71
- stage: 'research',
72
- description: 'Search 1M+ GitHub repos for real-world code examples',
73
- detectWhen: [],
74
- install: { method: 'add-mcp', cmd: 'bunx add-mcp grep-app' },
75
- mcpJustified: true,
76
- },
77
-
78
- 'parallel-deep-research': {
79
- name: 'Parallel Deep Research',
80
- type: 'skill',
81
- tier: 'paid',
82
- stage: 'research',
83
- description: 'Comprehensive research reports via Parallel AI pro/ultra processors (3-25 min)',
84
- detectWhen: [],
85
- install: {
86
- method: 'skills',
87
- cmd: 'bunx skills add parallel-web/parallel-agent-skills --skill parallel-deep-research',
88
- cmdCurl: 'bunx skills add harshanandak/forge --skill parallel-deep-research',
89
- },
90
- prerequisites: ['parallel-cli'],
91
- alternatives: [{ tool: 'WebSearch', tier: 'free', tradeoff: 'Shallow — only a few queries vs deep multi-source synthesis' }],
92
- },
93
-
94
- // ── Plan ──
95
- beads: {
96
- name: 'Beads',
97
- type: 'cli',
98
- tier: 'free',
99
- stage: 'plan',
100
- description: 'Git-backed issue tracking',
101
- detectWhen: [],
102
- install: { method: 'npm', cmd: 'bun add -g @beads/bd' },
103
- },
104
- // ── Dev ──
105
- 'typescript-lsp': {
106
- name: 'TypeScript LSP',
107
- type: 'lsp',
108
- tier: 'free',
109
- stage: 'dev',
110
- description: 'TypeScript language server for IDE integration',
111
- detectWhen: ['dep:typescript', 'file:tsconfig.json'],
112
- install: { method: 'lsp', cmd: '.lsp.json config' },
113
- },
114
- 'supabase-cli': {
115
- name: 'Supabase CLI',
116
- type: 'cli',
117
- tier: 'free-limited',
118
- stage: 'dev',
119
- description: 'Local Supabase development and migrations',
120
- detectWhen: ['dep:@supabase/supabase-js'],
121
- install: { method: 'npm', cmd: 'bun add -D supabase', dev: true },
122
- alternatives: [{ tool: 'postgresql-client', tier: 'free', tradeoff: 'No Supabase-specific features' }],
123
- },
124
- 'stripe-cli': {
125
- name: 'Stripe CLI',
126
- type: 'cli',
127
- tier: 'free',
128
- stage: 'dev',
129
- description: 'Stripe webhook testing and API interaction',
130
- detectWhen: ['dep:stripe'],
131
- install: { method: 'binary', cmd: 'https://stripe.com/docs/stripe-cli' },
132
- },
133
- 'vercel-agent-skills': {
134
- name: 'Vercel Agent Skills',
135
- type: 'skill',
136
- tier: 'free',
137
- stage: 'dev',
138
- description: 'Vercel deployment and preview management',
139
- detectWhen: ['dep:next'],
140
- install: { method: 'skills', cmd: 'bunx skills add vercel-labs/agent-skills' },
141
- },
142
-
143
- // ── Check ──
144
- eslint: {
145
- name: 'ESLint',
146
- type: 'cli',
147
- tier: 'free',
148
- stage: 'validate',
149
- description: 'JavaScript/TypeScript linting',
150
- detectWhen: ['file:eslint.config.js', 'dep:eslint'],
151
- install: { method: 'npm', cmd: 'bun add -D eslint', dev: true },
152
- },
153
- biome: {
154
- name: 'Biome',
155
- type: 'cli',
156
- tier: 'free',
157
- stage: 'validate',
158
- description: 'Fast formatter and linter',
159
- detectWhen: ['file:biome.json'],
160
- install: { method: 'npm', cmd: 'bun add -D @biomejs/biome', dev: true },
161
- },
162
- prettier: {
163
- name: 'Prettier',
164
- type: 'cli',
165
- tier: 'free',
166
- stage: 'validate',
167
- description: 'Opinionated code formatter',
168
- detectWhen: ['file:.prettierrc'],
169
- install: { method: 'npm', cmd: 'bun add -D prettier', dev: true },
170
- },
171
- 'eslint-plugin-security': {
172
- name: 'ESLint Security Plugin',
173
- type: 'config',
174
- tier: 'free',
175
- stage: 'validate',
176
- description: 'Security-focused ESLint rules',
177
- detectWhen: ['dep:express', 'dep:fastify'],
178
- install: { method: 'npm', cmd: 'bun add -D eslint-plugin-security', dev: true },
179
- },
180
- 'sonarcloud-analysis': {
181
- name: 'SonarCloud Analysis',
182
- type: 'skill',
183
- tier: 'free-public',
184
- stage: 'validate',
185
- description: 'Code quality and security analysis via SonarCloud REST API',
186
- detectWhen: [],
187
- install: {
188
- method: 'skills',
189
- cmd: 'bunx skills add harshanandak/forge --skill sonarcloud-analysis',
190
- },
191
- alternatives: [{ tool: 'eslint', tier: 'free', tradeoff: 'Less comprehensive analysis' }],
192
- },
193
- 'sonar-scanner': {
194
- name: 'Sonar Scanner',
195
- type: 'cli',
196
- tier: 'free-public',
197
- stage: 'validate',
198
- description: 'SonarCloud/SonarQube CLI scanner',
199
- detectWhen: ['file:sonar-project.properties'],
200
- install: { method: 'npm', cmd: 'bun add -D sonarqube-scanner', dev: true },
201
- alternatives: [{ tool: 'eslint', tier: 'free', tradeoff: 'No centralized dashboard' }],
202
- },
203
- codeql: {
204
- name: 'CodeQL',
205
- type: 'cli',
206
- tier: 'free-public',
207
- stage: 'validate',
208
- description: 'Semantic code analysis by GitHub',
209
- detectWhen: [],
210
- install: { method: 'binary', cmd: 'GitHub-provided (github.com/github/codeql-action)' },
211
- alternatives: [{ tool: 'eslint-plugin-security', tier: 'free', tradeoff: 'Less deep analysis' }],
212
- },
213
- 'npm-audit': {
214
- name: 'npm audit',
215
- type: 'cli',
216
- tier: 'free',
217
- stage: 'validate',
218
- description: 'Dependency vulnerability scanning',
219
- detectWhen: [],
220
- install: { method: 'npm', cmd: 'built-in (bun pm audit)' },
221
- },
222
- vitest: {
223
- name: 'Vitest',
224
- type: 'cli',
225
- tier: 'free',
226
- stage: 'validate',
227
- description: 'Vite-native test runner',
228
- detectWhen: ['dep:vitest', 'file:vitest.config.ts'],
229
- install: { method: 'npm', cmd: 'bun add -D vitest', dev: true },
230
- },
231
- jest: {
232
- name: 'Jest',
233
- type: 'cli',
234
- tier: 'free',
235
- stage: 'validate',
236
- description: 'Delightful JavaScript testing',
237
- detectWhen: ['dep:jest', 'file:jest.config.js'],
238
- install: { method: 'npm', cmd: 'bun add -D jest', dev: true },
239
- },
240
- playwright: {
241
- name: 'Playwright',
242
- type: 'cli',
243
- tier: 'free',
244
- stage: 'validate',
245
- description: 'End-to-end browser testing',
246
- detectWhen: ['dep:@playwright/test'],
247
- install: { method: 'npm', cmd: 'bun add -D @playwright/test', dev: true },
248
- },
249
- c8: {
250
- name: 'c8',
251
- type: 'cli',
252
- tier: 'free',
253
- stage: 'validate',
254
- description: 'Native V8 code coverage',
255
- detectWhen: [],
256
- install: { method: 'npm', cmd: 'bun add -D c8', dev: true },
257
- },
258
- stryker: {
259
- name: 'Stryker',
260
- type: 'cli',
261
- tier: 'free',
262
- stage: 'validate',
263
- description: 'Mutation testing for JavaScript',
264
- detectWhen: [],
265
- install: { method: 'npm', cmd: 'bun add -D @stryker-mutator/core', dev: true },
266
- },
267
- oxlint: {
268
- name: 'Oxlint',
269
- type: 'cli',
270
- tier: 'free',
271
- stage: 'validate',
272
- description: 'Blazing-fast Rust-based linter',
273
- detectWhen: [],
274
- install: { method: 'npm', cmd: 'bun add -D oxlint', dev: true },
275
- },
276
-
277
- // ── Ship ──
278
- 'gh-cli': {
279
- name: 'GitHub CLI',
280
- type: 'cli',
281
- tier: 'free',
282
- stage: 'ship',
283
- description: 'GitHub PR and issue management',
284
- detectWhen: [],
285
- install: { method: 'binary', cmd: 'https://cli.github.com' },
286
- prerequisites: ['gh'],
287
- },
288
- lefthook: {
289
- name: 'Lefthook',
290
- type: 'cli',
291
- tier: 'free',
292
- stage: 'ship',
293
- description: 'Fast git hooks manager',
294
- detectWhen: [],
295
- install: { method: 'npm', cmd: 'bun add -D lefthook', dev: true },
296
- },
297
-
298
- // ── Review ──
299
- coderabbit: {
300
- name: 'CodeRabbit',
301
- type: 'config',
302
- tier: 'free-public',
303
- stage: 'review',
304
- description: 'AI-powered code review',
305
- detectWhen: [],
306
- install: { method: 'config', cmd: 'GitHub App (coderabbit.ai)' },
307
- alternatives: [{ tool: 'qodo-merge', tier: 'free', tradeoff: 'Self-hosted, more setup' }],
308
- },
309
- greptile: {
310
- name: 'Greptile',
311
- type: 'config',
312
- tier: 'paid',
313
- stage: 'review',
314
- description: 'AI code review with codebase context',
315
- detectWhen: [],
316
- install: { method: 'config', cmd: 'GitHub App (greptile.com)' },
317
- alternatives: [{ tool: 'coderabbit', tier: 'free-public', tradeoff: 'Less codebase awareness' }],
318
- },
319
- 'qodo-merge': {
320
- name: 'Qodo Merge',
321
- type: 'cli',
322
- tier: 'free',
323
- stage: 'review',
324
- description: 'AI-assisted code review (self-hosted)',
325
- detectWhen: [],
326
- install: { method: 'config', cmd: 'Self-hosted (qodo.ai)' },
327
- },
328
-
329
- // ── Merge ──
330
- changesets: {
331
- name: 'Changesets',
332
- type: 'cli',
333
- tier: 'free',
334
- stage: 'premerge',
335
- description: 'Versioning and changelog management',
336
- detectWhen: ['file:package.json'],
337
- install: { method: 'npm', cmd: 'bun add -D @changesets/cli', dev: true },
338
- },
339
- 'release-please': {
340
- name: 'Release Please',
341
- type: 'config',
342
- tier: 'free',
343
- stage: 'premerge',
344
- description: 'Automated release PRs by Google',
345
- detectWhen: [],
346
- install: { method: 'config', cmd: 'GitHub Action (google-github-actions/release-please-action)' },
347
- },
348
- });
349
-
350
- module.exports = { CATALOG, TIERS, TOOL_TYPES, STAGES, BUDGET_MODES, PREREQUISITES };
1
+ /**
2
+ * Plugin Catalog
3
+ *
4
+ * Static, frozen catalog of tools for the Forge workflow.
5
+ * Read-only data — no installations, no side effects.
6
+ */
7
+
8
+ const TIERS = Object.freeze({
9
+ FREE: 'free',
10
+ FREE_PUBLIC: 'free-public',
11
+ FREE_LIMITED: 'free-limited',
12
+ PAID: 'paid',
13
+ });
14
+
15
+ const TOOL_TYPES = Object.freeze({
16
+ CLI: 'cli',
17
+ SKILL: 'skill',
18
+ MCP: 'mcp',
19
+ CONFIG: 'config',
20
+ LSP: 'lsp',
21
+ });
22
+
23
+ const STAGES = Object.freeze({
24
+ RESEARCH: 'research',
25
+ PLAN: 'plan',
26
+ DEV: 'dev',
27
+ VALIDATE: 'validate',
28
+ SHIP: 'ship',
29
+ REVIEW: 'review',
30
+ PREMERGE: 'premerge',
31
+ });
32
+
33
+ const BUDGET_MODES = Object.freeze({
34
+ free: { label: 'Free only', includes: ['free'] },
35
+ 'open-source': { label: 'Open source', includes: ['free', 'free-public'] },
36
+ startup: { label: 'Startup', includes: ['free', 'free-public', 'free-limited'] },
37
+ professional: { label: 'Professional', includes: ['free', 'free-public', 'free-limited', 'paid'] },
38
+ custom: { label: 'Custom', includes: [] },
39
+ });
40
+
41
+ const PREREQUISITES = Object.freeze({
42
+ node: { check: 'node --version', installUrl: 'https://nodejs.org' },
43
+ git: { check: 'git --version', installUrl: 'https://git-scm.com' },
44
+ gh: { check: 'gh --version', installUrl: 'https://cli.github.com' },
45
+ bun: { check: 'bun --version', installUrl: 'https://bun.sh' },
46
+ jq: { check: 'jq --version', installUrl: 'https://jqlang.github.io/jq/download/' },
47
+ go: { check: 'go version', installUrl: 'https://go.dev/dl/' },
48
+ curl: { check: 'curl --version', installUrl: null },
49
+ 'parallel-cli': {
50
+ check: 'parallel-cli --version',
51
+ installUrl: 'https://parallel.ai/install.sh',
52
+ },
53
+ });
54
+
55
+ const CATALOG = Object.freeze({
56
+ // ── Research ──
57
+ 'context7-mcp': {
58
+ name: 'Context7',
59
+ type: 'mcp',
60
+ tier: 'free',
61
+ stage: 'research',
62
+ description: 'Up-to-date library documentation via MCP',
63
+ detectWhen: [],
64
+ install: { method: 'add-mcp', cmd: 'bunx add-mcp context7' },
65
+ mcpJustified: true,
66
+ },
67
+ 'grep-app-mcp': {
68
+ name: 'grep.app',
69
+ type: 'mcp',
70
+ tier: 'free',
71
+ stage: 'research',
72
+ description: 'Search 1M+ GitHub repos for real-world code examples',
73
+ detectWhen: [],
74
+ install: { method: 'add-mcp', cmd: 'bunx add-mcp grep-app' },
75
+ mcpJustified: true,
76
+ },
77
+
78
+ 'parallel-deep-research': {
79
+ name: 'Parallel Deep Research',
80
+ type: 'skill',
81
+ tier: 'paid',
82
+ stage: 'research',
83
+ description: 'Comprehensive research reports via Parallel AI pro/ultra processors (3-25 min)',
84
+ detectWhen: [],
85
+ install: {
86
+ method: 'skills',
87
+ cmd: 'bunx skills add parallel-web/parallel-agent-skills --skill parallel-deep-research',
88
+ cmdCurl: 'bunx skills add harshanandak/forge --skill parallel-deep-research',
89
+ },
90
+ prerequisites: ['parallel-cli'],
91
+ alternatives: [{ tool: 'WebSearch', tier: 'free', tradeoff: 'Shallow — only a few queries vs deep multi-source synthesis' }],
92
+ },
93
+
94
+ // ── Plan ──
95
+ beads: {
96
+ name: 'Beads',
97
+ type: 'cli',
98
+ tier: 'free',
99
+ stage: 'plan',
100
+ description: 'Git-backed issue tracking',
101
+ detectWhen: [],
102
+ install: { method: 'npm', cmd: 'bun add -g @beads/bd' },
103
+ },
104
+ // ── Dev ──
105
+ 'typescript-lsp': {
106
+ name: 'TypeScript LSP',
107
+ type: 'lsp',
108
+ tier: 'free',
109
+ stage: 'dev',
110
+ description: 'TypeScript language server for IDE integration',
111
+ detectWhen: ['dep:typescript', 'file:tsconfig.json'],
112
+ install: { method: 'lsp', cmd: '.lsp.json config' },
113
+ },
114
+ 'supabase-cli': {
115
+ name: 'Supabase CLI',
116
+ type: 'cli',
117
+ tier: 'free-limited',
118
+ stage: 'dev',
119
+ description: 'Local Supabase development and migrations',
120
+ detectWhen: ['dep:@supabase/supabase-js'],
121
+ install: { method: 'npm', cmd: 'bun add -D supabase', dev: true },
122
+ alternatives: [{ tool: 'postgresql-client', tier: 'free', tradeoff: 'No Supabase-specific features' }],
123
+ },
124
+ 'stripe-cli': {
125
+ name: 'Stripe CLI',
126
+ type: 'cli',
127
+ tier: 'free',
128
+ stage: 'dev',
129
+ description: 'Stripe webhook testing and API interaction',
130
+ detectWhen: ['dep:stripe'],
131
+ install: { method: 'binary', cmd: 'https://stripe.com/docs/stripe-cli' },
132
+ },
133
+ 'vercel-agent-skills': {
134
+ name: 'Vercel Agent Skills',
135
+ type: 'skill',
136
+ tier: 'free',
137
+ stage: 'dev',
138
+ description: 'Vercel deployment and preview management',
139
+ detectWhen: ['dep:next'],
140
+ install: { method: 'skills', cmd: 'bunx skills add vercel-labs/agent-skills' },
141
+ },
142
+
143
+ // ── Check ──
144
+ eslint: {
145
+ name: 'ESLint',
146
+ type: 'cli',
147
+ tier: 'free',
148
+ stage: 'validate',
149
+ description: 'JavaScript/TypeScript linting',
150
+ detectWhen: ['file:eslint.config.js', 'dep:eslint'],
151
+ install: { method: 'npm', cmd: 'bun add -D eslint', dev: true },
152
+ },
153
+ biome: {
154
+ name: 'Biome',
155
+ type: 'cli',
156
+ tier: 'free',
157
+ stage: 'validate',
158
+ description: 'Fast formatter and linter',
159
+ detectWhen: ['file:biome.json'],
160
+ install: { method: 'npm', cmd: 'bun add -D @biomejs/biome', dev: true },
161
+ },
162
+ prettier: {
163
+ name: 'Prettier',
164
+ type: 'cli',
165
+ tier: 'free',
166
+ stage: 'validate',
167
+ description: 'Opinionated code formatter',
168
+ detectWhen: ['file:.prettierrc'],
169
+ install: { method: 'npm', cmd: 'bun add -D prettier', dev: true },
170
+ },
171
+ 'eslint-plugin-security': {
172
+ name: 'ESLint Security Plugin',
173
+ type: 'config',
174
+ tier: 'free',
175
+ stage: 'validate',
176
+ description: 'Security-focused ESLint rules',
177
+ detectWhen: ['dep:express', 'dep:fastify'],
178
+ install: { method: 'npm', cmd: 'bun add -D eslint-plugin-security', dev: true },
179
+ },
180
+ 'sonarcloud-analysis': {
181
+ name: 'SonarCloud Analysis',
182
+ type: 'skill',
183
+ tier: 'free-public',
184
+ stage: 'validate',
185
+ description: 'Code quality and security analysis via SonarCloud REST API',
186
+ detectWhen: [],
187
+ install: {
188
+ method: 'skills',
189
+ cmd: 'bunx skills add harshanandak/forge --skill sonarcloud-analysis',
190
+ },
191
+ alternatives: [{ tool: 'eslint', tier: 'free', tradeoff: 'Less comprehensive analysis' }],
192
+ },
193
+ 'sonar-scanner': {
194
+ name: 'Sonar Scanner',
195
+ type: 'cli',
196
+ tier: 'free-public',
197
+ stage: 'validate',
198
+ description: 'SonarCloud/SonarQube CLI scanner',
199
+ detectWhen: ['file:sonar-project.properties'],
200
+ install: { method: 'npm', cmd: 'bun add -D sonarqube-scanner', dev: true },
201
+ alternatives: [{ tool: 'eslint', tier: 'free', tradeoff: 'No centralized dashboard' }],
202
+ },
203
+ codeql: {
204
+ name: 'CodeQL',
205
+ type: 'cli',
206
+ tier: 'free-public',
207
+ stage: 'validate',
208
+ description: 'Semantic code analysis by GitHub',
209
+ detectWhen: [],
210
+ install: { method: 'binary', cmd: 'GitHub-provided (github.com/github/codeql-action)' },
211
+ alternatives: [{ tool: 'eslint-plugin-security', tier: 'free', tradeoff: 'Less deep analysis' }],
212
+ },
213
+ 'npm-audit': {
214
+ name: 'npm audit',
215
+ type: 'cli',
216
+ tier: 'free',
217
+ stage: 'validate',
218
+ description: 'Dependency vulnerability scanning',
219
+ detectWhen: [],
220
+ install: { method: 'npm', cmd: 'built-in (bun pm audit)' },
221
+ },
222
+ vitest: {
223
+ name: 'Vitest',
224
+ type: 'cli',
225
+ tier: 'free',
226
+ stage: 'validate',
227
+ description: 'Vite-native test runner',
228
+ detectWhen: ['dep:vitest', 'file:vitest.config.ts'],
229
+ install: { method: 'npm', cmd: 'bun add -D vitest', dev: true },
230
+ },
231
+ jest: {
232
+ name: 'Jest',
233
+ type: 'cli',
234
+ tier: 'free',
235
+ stage: 'validate',
236
+ description: 'Delightful JavaScript testing',
237
+ detectWhen: ['dep:jest', 'file:jest.config.js'],
238
+ install: { method: 'npm', cmd: 'bun add -D jest', dev: true },
239
+ },
240
+ playwright: {
241
+ name: 'Playwright',
242
+ type: 'cli',
243
+ tier: 'free',
244
+ stage: 'validate',
245
+ description: 'End-to-end browser testing',
246
+ detectWhen: ['dep:@playwright/test'],
247
+ install: { method: 'npm', cmd: 'bun add -D @playwright/test', dev: true },
248
+ },
249
+ c8: {
250
+ name: 'c8',
251
+ type: 'cli',
252
+ tier: 'free',
253
+ stage: 'validate',
254
+ description: 'Native V8 code coverage',
255
+ detectWhen: [],
256
+ install: { method: 'npm', cmd: 'bun add -D c8', dev: true },
257
+ },
258
+ stryker: {
259
+ name: 'Stryker',
260
+ type: 'cli',
261
+ tier: 'free',
262
+ stage: 'validate',
263
+ description: 'Mutation testing for JavaScript',
264
+ detectWhen: [],
265
+ install: { method: 'npm', cmd: 'bun add -D @stryker-mutator/core', dev: true },
266
+ },
267
+ oxlint: {
268
+ name: 'Oxlint',
269
+ type: 'cli',
270
+ tier: 'free',
271
+ stage: 'validate',
272
+ description: 'Blazing-fast Rust-based linter',
273
+ detectWhen: [],
274
+ install: { method: 'npm', cmd: 'bun add -D oxlint', dev: true },
275
+ },
276
+
277
+ // ── Ship ──
278
+ 'gh-cli': {
279
+ name: 'GitHub CLI',
280
+ type: 'cli',
281
+ tier: 'free',
282
+ stage: 'ship',
283
+ description: 'GitHub PR and issue management',
284
+ detectWhen: [],
285
+ install: { method: 'binary', cmd: 'https://cli.github.com' },
286
+ prerequisites: ['gh'],
287
+ },
288
+ lefthook: {
289
+ name: 'Lefthook',
290
+ type: 'cli',
291
+ tier: 'free',
292
+ stage: 'ship',
293
+ description: 'Fast git hooks manager',
294
+ detectWhen: [],
295
+ install: { method: 'npm', cmd: 'bun add -D lefthook', dev: true },
296
+ },
297
+
298
+ // ── Review ──
299
+ coderabbit: {
300
+ name: 'CodeRabbit',
301
+ type: 'config',
302
+ tier: 'free-public',
303
+ stage: 'review',
304
+ description: 'AI-powered code review',
305
+ detectWhen: [],
306
+ install: { method: 'config', cmd: 'GitHub App (coderabbit.ai)' },
307
+ alternatives: [{ tool: 'qodo-merge', tier: 'free', tradeoff: 'Self-hosted, more setup' }],
308
+ },
309
+ greptile: {
310
+ name: 'Greptile',
311
+ type: 'config',
312
+ tier: 'paid',
313
+ stage: 'review',
314
+ description: 'AI code review with codebase context',
315
+ detectWhen: [],
316
+ install: { method: 'config', cmd: 'GitHub App (greptile.com)' },
317
+ alternatives: [{ tool: 'coderabbit', tier: 'free-public', tradeoff: 'Less codebase awareness' }],
318
+ },
319
+ 'qodo-merge': {
320
+ name: 'Qodo Merge',
321
+ type: 'cli',
322
+ tier: 'free',
323
+ stage: 'review',
324
+ description: 'AI-assisted code review (self-hosted)',
325
+ detectWhen: [],
326
+ install: { method: 'config', cmd: 'Self-hosted (qodo.ai)' },
327
+ },
328
+
329
+ // ── Merge ──
330
+ changesets: {
331
+ name: 'Changesets',
332
+ type: 'cli',
333
+ tier: 'free',
334
+ stage: 'premerge',
335
+ description: 'Versioning and changelog management',
336
+ detectWhen: ['file:package.json'],
337
+ install: { method: 'npm', cmd: 'bun add -D @changesets/cli', dev: true },
338
+ },
339
+ 'release-please': {
340
+ name: 'Release Please',
341
+ type: 'config',
342
+ tier: 'free',
343
+ stage: 'premerge',
344
+ description: 'Automated release PRs by Google',
345
+ detectWhen: [],
346
+ install: { method: 'config', cmd: 'GitHub Action (google-github-actions/release-please-action)' },
347
+ },
348
+ });
349
+
350
+ module.exports = { CATALOG, TIERS, TOOL_TYPES, STAGES, BUDGET_MODES, PREREQUISITES };