forge-workflow 0.0.4 → 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 -340
  2. package/.claude/commands/plan.md +521 -521
  3. package/.claude/commands/premerge.md +176 -176
  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 -164
  8. package/.claude/commands/sonarcloud.md +152 -152
  9. package/.claude/commands/status.md +48 -48
  10. package/.claude/commands/validate.md +282 -282
  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 -337
  17. package/.cline/workflows/plan.md +518 -518
  18. package/.cline/workflows/premerge.md +173 -173
  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 -161
  23. package/.cline/workflows/sonarcloud.md +146 -146
  24. package/.cline/workflows/status.md +45 -45
  25. package/.cline/workflows/validate.md +279 -279
  26. package/.cline/workflows/verify.md +218 -218
  27. package/.codex/config.toml +11 -11
  28. package/.codex/skills/dev/SKILL.md +340 -340
  29. package/.codex/skills/plan/SKILL.md +521 -521
  30. package/.codex/skills/premerge/SKILL.md +176 -176
  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 -164
  35. package/.codex/skills/sonarcloud/SKILL.md +149 -149
  36. package/.codex/skills/status/SKILL.md +48 -48
  37. package/.codex/skills/validate/SKILL.md +282 -282
  38. package/.codex/skills/verify/SKILL.md +221 -221
  39. package/.cursor/commands/dev.md +337 -337
  40. package/.cursor/commands/plan.md +518 -518
  41. package/.cursor/commands/premerge.md +173 -173
  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 -161
  46. package/.cursor/commands/sonarcloud.md +146 -146
  47. package/.cursor/commands/status.md +45 -45
  48. package/.cursor/commands/validate.md +279 -279
  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 -342
  54. package/.github/prompts/plan.prompt.md +523 -523
  55. package/.github/prompts/premerge.prompt.md +178 -178
  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 -166
  60. package/.github/prompts/sonarcloud.prompt.md +151 -151
  61. package/.github/prompts/status.prompt.md +50 -50
  62. package/.github/prompts/validate.prompt.md +284 -284
  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 -341
  67. package/.kilocode/workflows/plan.md +522 -522
  68. package/.kilocode/workflows/premerge.md +177 -177
  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 -165
  73. package/.kilocode/workflows/sonarcloud.md +150 -150
  74. package/.kilocode/workflows/status.md +49 -49
  75. package/.kilocode/workflows/validate.md +283 -283
  76. package/.kilocode/workflows/verify.md +222 -222
  77. package/.mcp.json.example +12 -12
  78. package/.opencode/commands/dev.md +340 -340
  79. package/.opencode/commands/plan.md +521 -521
  80. package/.opencode/commands/premerge.md +176 -176
  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 -164
  85. package/.opencode/commands/sonarcloud.md +149 -149
  86. package/.opencode/commands/status.md +48 -48
  87. package/.opencode/commands/validate.md +282 -282
  88. package/.opencode/commands/verify.md +221 -221
  89. package/.roo/commands/dev.md +341 -341
  90. package/.roo/commands/plan.md +522 -522
  91. package/.roo/commands/premerge.md +177 -177
  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 -165
  96. package/.roo/commands/sonarcloud.md +150 -150
  97. package/.roo/commands/status.md +49 -49
  98. package/.roo/commands/validate.md +283 -283
  99. package/.roo/commands/verify.md +222 -222
  100. package/AGENTS.md +175 -175
  101. package/CLAUDE.md +100 -100
  102. package/README.md +429 -416
  103. package/bin/forge-cmd.js +313 -313
  104. package/bin/forge-preflight.js +309 -309
  105. package/bin/forge.js +4596 -4303
  106. package/docs/AGENT_INSTALL_PROMPT.md +342 -342
  107. package/docs/BEADS_GITHUB_SYNC.md +251 -251
  108. package/docs/ENHANCED_ONBOARDING.md +602 -602
  109. package/docs/EXAMPLES.md +482 -482
  110. package/docs/GREPTILE_SETUP.md +400 -400
  111. package/docs/MANUAL_REVIEW_GUIDE.md +106 -106
  112. package/docs/ROADMAP.md +359 -359
  113. package/docs/SETUP.md +663 -631
  114. package/docs/TOOLCHAIN.md +630 -630
  115. package/docs/VALIDATION.md +363 -363
  116. package/install.sh +40 -1056
  117. package/lefthook.yml +39 -39
  118. package/lib/agents/README.md +198 -198
  119. package/lib/agents/claude.plugin.json +28 -28
  120. package/lib/agents/cline.plugin.json +22 -22
  121. package/lib/agents/codex.plugin.json +19 -19
  122. package/lib/agents/copilot.plugin.json +24 -24
  123. package/lib/agents/cursor.plugin.json +25 -25
  124. package/lib/agents/kilocode.plugin.json +22 -22
  125. package/lib/agents/opencode.plugin.json +20 -20
  126. package/lib/agents/roo.plugin.json +23 -23
  127. package/lib/agents-config.js +2112 -2112
  128. package/lib/beads-health-check.js +143 -0
  129. package/lib/beads-setup.js +341 -0
  130. package/lib/beads-sync-scaffold.js +260 -0
  131. package/lib/commands/dev.js +513 -513
  132. package/lib/commands/plan.js +692 -692
  133. package/lib/commands/recommend.js +119 -119
  134. package/lib/commands/ship.js +377 -377
  135. package/lib/commands/status.js +378 -378
  136. package/lib/commands/validate.js +602 -602
  137. package/lib/context-merge.js +359 -359
  138. package/lib/dep-guard/analyzer.js +294 -294
  139. package/lib/dep-guard/behavior-detector.js +98 -98
  140. package/lib/dep-guard/contract-detector.js +162 -162
  141. package/lib/dep-guard/import-detector.js +498 -498
  142. package/lib/dep-guard/path-utils.js +13 -13
  143. package/lib/dep-guard/rubric.js +120 -120
  144. package/lib/dep-guard/task-parser.js +318 -318
  145. package/lib/detect-agent.js +191 -191
  146. package/lib/detect-worktree.js +47 -47
  147. package/lib/file-hash.js +26 -26
  148. package/lib/husky-migration.js +450 -0
  149. package/lib/lefthook-check.js +65 -0
  150. package/lib/pat-setup.js +207 -0
  151. package/lib/plugin-catalog.js +350 -350
  152. package/lib/plugin-manager.js +166 -166
  153. package/lib/plugin-recommender.js +141 -141
  154. package/lib/project-discovery.js +491 -491
  155. package/lib/setup-action-log.js +139 -139
  156. package/lib/setup-summary-renderer.js +106 -106
  157. package/lib/setup-utils.js +96 -0
  158. package/lib/setup.js +192 -192
  159. package/lib/smart-merge.js +64 -0
  160. package/lib/symlink-utils.js +81 -0
  161. package/lib/workflow-profiles.js +197 -197
  162. package/package.json +131 -128
  163. package/scripts/beads-context.sh +291 -0
  164. package/scripts/beads-context.test.js +563 -0
  165. package/scripts/behavioral-judge.sh +378 -0
  166. package/scripts/benchmark.js +85 -0
  167. package/scripts/branch-protection.js +183 -0
  168. package/scripts/check-agents.js +172 -0
  169. package/scripts/commitlint.js +42 -0
  170. package/scripts/conflict-detect.sh +323 -0
  171. package/scripts/dep-guard-analyze.js +71 -0
  172. package/scripts/dep-guard.sh +811 -0
  173. package/scripts/eval_win.py +249 -0
  174. package/scripts/file-index.sh +399 -0
  175. package/scripts/github-beads-sync/comment.mjs +64 -0
  176. package/scripts/github-beads-sync/config.mjs +148 -0
  177. package/scripts/github-beads-sync/github-api.mjs +131 -0
  178. package/scripts/github-beads-sync/index.mjs +332 -0
  179. package/scripts/github-beads-sync/label-mapper.mjs +54 -0
  180. package/scripts/github-beads-sync/mapping.mjs +78 -0
  181. package/scripts/github-beads-sync/reverse-sync-cli.mjs +31 -0
  182. package/scripts/github-beads-sync/reverse-sync.mjs +138 -0
  183. package/scripts/github-beads-sync/run-bd.mjs +159 -0
  184. package/scripts/github-beads-sync/sanitize.mjs +121 -0
  185. package/scripts/github-beads-sync.config.json +26 -0
  186. package/scripts/improve-command.js +375 -0
  187. package/scripts/lib/eval-runner.js +229 -0
  188. package/scripts/lib/eval-schema.js +135 -0
  189. package/scripts/lib/eval-storage.js +78 -0
  190. package/scripts/lib/grading.js +203 -0
  191. package/scripts/lib/transcript-parser.js +63 -0
  192. package/scripts/lint.js +47 -0
  193. package/scripts/migrate-to-bun-test.js +412 -0
  194. package/scripts/run-command-eval.js +236 -0
  195. package/scripts/smart-status.sh +782 -0
  196. package/scripts/sync-commands.js +571 -0
  197. package/scripts/sync-utils.sh +460 -0
  198. package/scripts/test-dashboard.js +123 -0
  199. package/scripts/test.js +44 -0
  200. package/scripts/validate.sh +94 -0
  201. package/skills/parallel-deep-research/SKILL.md +108 -108
  202. package/skills/parallel-deep-research/evals/README.md +27 -27
  203. package/skills/parallel-deep-research/evals/evals.json +62 -62
  204. package/skills/sonarcloud-analysis/SKILL.md +171 -171
  205. package/skills/sonarcloud-analysis/evals/README.md +27 -27
  206. package/skills/sonarcloud-analysis/evals/evals.json +50 -50
  207. package/skills/sonarcloud-analysis/references/api-reference.md +466 -466
  208. package/.cursor/hooks/state/continual-learning-index.json +0 -19
  209. package/.cursor/hooks/state/continual-learning.json +0 -8
@@ -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 };