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,13 +1,13 @@
1
- const path = require('node:path');
2
-
3
- function toPosixPath(filePath) {
4
- return filePath.replaceAll('\\', '/').split(path.sep).join('/');
5
- }
6
-
7
- function normalizeRepoPath(filePath) {
8
- return toPosixPath(path.normalize(filePath));
9
- }
10
-
11
- module.exports = {
12
- normalizeRepoPath,
13
- };
1
+ const path = require('node:path');
2
+
3
+ function toPosixPath(filePath) {
4
+ return filePath.replaceAll('\\', '/').split(path.sep).join('/');
5
+ }
6
+
7
+ function normalizeRepoPath(filePath) {
8
+ return toPosixPath(path.normalize(filePath));
9
+ }
10
+
11
+ module.exports = {
12
+ normalizeRepoPath,
13
+ };
@@ -1,120 +1,120 @@
1
- const WEIGHTS = {
2
- importCallChain: 3,
3
- contractDependencies: 3,
4
- behavioralDependencies: 2,
5
- };
6
-
7
- const CONFLICT_MESSAGES = {
8
- materialDisagreement: 'Detector scores disagree materially across dependency categories.',
9
- behavioralUncertainty: 'Behavioral signals are heuristic and need manual review.',
10
- };
11
- const MAX_DETECTOR_STRENGTH = 3;
12
- const MAX_TOTAL = Object.values(WEIGHTS)
13
- .reduce((sum, weight) => sum + (weight * MAX_DETECTOR_STRENGTH), 0);
14
-
15
- function aggregateRubricScores(detectors, options = {}) {
16
- const confidenceThreshold = options.confidenceThreshold ?? 0.7;
17
- const dimensions = {};
18
- let total = 0;
19
- let hasMaterialDisagreement = false;
20
- let hasUncertainty = false;
21
-
22
- for (const [name, weight] of Object.entries(WEIGHTS)) {
23
- const raw = detectors[name]?.score ?? 0;
24
- const normalized = Math.min(raw, MAX_DETECTOR_STRENGTH);
25
- const weighted = normalized * weight;
26
- dimensions[name] = { raw, normalized, weighted };
27
- total += weighted;
28
- if (detectors[name]?.uncertain) {
29
- hasUncertainty = true;
30
- }
31
- }
32
-
33
- if (total === 0) {
34
- return {
35
- result: 'PASS',
36
- score: 0,
37
- total: 0,
38
- dimensions,
39
- weights: { ...WEIGHTS },
40
- confidence: {
41
- score: 1,
42
- threshold: confidenceThreshold,
43
- belowThreshold: false,
44
- reasons: [],
45
- },
46
- detectorConflicts: [],
47
- summary: 'No detector findings yet.',
48
- reasons: [],
49
- };
50
- }
51
-
52
- const rawScores = Object.values(dimensions).map((dimension) => dimension.raw);
53
- const nonZeroScores = rawScores.filter((score) => score > 0);
54
- const detectorConflicts = [];
55
-
56
- if (nonZeroScores.length >= 2 && (Math.max(...nonZeroScores) - Math.min(...nonZeroScores) >= 2)) {
57
- hasMaterialDisagreement = true;
58
- detectorConflicts.push(CONFLICT_MESSAGES.materialDisagreement);
59
- }
60
-
61
- if (hasUncertainty) {
62
- detectorConflicts.push(CONFLICT_MESSAGES.behavioralUncertainty);
63
- }
64
-
65
- let confidenceScore = total / MAX_TOTAL;
66
- if (hasMaterialDisagreement) {
67
- confidenceScore -= 0.2;
68
- }
69
- if (hasUncertainty) {
70
- confidenceScore -= 0.15;
71
- }
72
- confidenceScore = Math.max(0, Math.min(1, confidenceScore));
73
- const belowThreshold = confidenceScore < confidenceThreshold;
74
-
75
- const reasons = [];
76
- if (detectorConflicts.length > 0) {
77
- reasons.push(...detectorConflicts);
78
- }
79
- if (belowThreshold) {
80
- reasons.push(`Confidence ${confidenceScore.toFixed(2)} is below the ${(confidenceThreshold * 100).toFixed(0)}% threshold.`);
81
- }
82
-
83
- let result = 'PASS';
84
- if (detectorConflicts.length > 0) {
85
- result = 'INCONCLUSIVE';
86
- } else if (belowThreshold) {
87
- result = 'WEAK';
88
- }
89
-
90
- return {
91
- result,
92
- score: total,
93
- total,
94
- dimensions,
95
- weights: { ...WEIGHTS },
96
- confidence: {
97
- score: confidenceScore,
98
- threshold: confidenceThreshold,
99
- belowThreshold,
100
- reasons,
101
- },
102
- detectorConflicts,
103
- summary: reasons.join(' ') || 'Detector findings are consistent.',
104
- reasons,
105
- };
106
- }
107
-
108
- function needsUserEscalation(rubricResult) {
109
- return (
110
- rubricResult.result === 'INCONCLUSIVE'
111
- || rubricResult.confidence.belowThreshold
112
- || rubricResult.detectorConflicts.length > 0
113
- );
114
- }
115
-
116
- module.exports = {
117
- WEIGHTS,
118
- aggregateRubricScores,
119
- needsUserEscalation,
120
- };
1
+ const WEIGHTS = {
2
+ importCallChain: 3,
3
+ contractDependencies: 3,
4
+ behavioralDependencies: 2,
5
+ };
6
+
7
+ const CONFLICT_MESSAGES = {
8
+ materialDisagreement: 'Detector scores disagree materially across dependency categories.',
9
+ behavioralUncertainty: 'Behavioral signals are heuristic and need manual review.',
10
+ };
11
+ const MAX_DETECTOR_STRENGTH = 3;
12
+ const MAX_TOTAL = Object.values(WEIGHTS)
13
+ .reduce((sum, weight) => sum + (weight * MAX_DETECTOR_STRENGTH), 0);
14
+
15
+ function aggregateRubricScores(detectors, options = {}) {
16
+ const confidenceThreshold = options.confidenceThreshold ?? 0.7;
17
+ const dimensions = {};
18
+ let total = 0;
19
+ let hasMaterialDisagreement = false;
20
+ let hasUncertainty = false;
21
+
22
+ for (const [name, weight] of Object.entries(WEIGHTS)) {
23
+ const raw = detectors[name]?.score ?? 0;
24
+ const normalized = Math.min(raw, MAX_DETECTOR_STRENGTH);
25
+ const weighted = normalized * weight;
26
+ dimensions[name] = { raw, normalized, weighted };
27
+ total += weighted;
28
+ if (detectors[name]?.uncertain) {
29
+ hasUncertainty = true;
30
+ }
31
+ }
32
+
33
+ if (total === 0) {
34
+ return {
35
+ result: 'PASS',
36
+ score: 0,
37
+ total: 0,
38
+ dimensions,
39
+ weights: { ...WEIGHTS },
40
+ confidence: {
41
+ score: 1,
42
+ threshold: confidenceThreshold,
43
+ belowThreshold: false,
44
+ reasons: [],
45
+ },
46
+ detectorConflicts: [],
47
+ summary: 'No detector findings yet.',
48
+ reasons: [],
49
+ };
50
+ }
51
+
52
+ const rawScores = Object.values(dimensions).map((dimension) => dimension.raw);
53
+ const nonZeroScores = rawScores.filter((score) => score > 0);
54
+ const detectorConflicts = [];
55
+
56
+ if (nonZeroScores.length >= 2 && (Math.max(...nonZeroScores) - Math.min(...nonZeroScores) >= 2)) {
57
+ hasMaterialDisagreement = true;
58
+ detectorConflicts.push(CONFLICT_MESSAGES.materialDisagreement);
59
+ }
60
+
61
+ if (hasUncertainty) {
62
+ detectorConflicts.push(CONFLICT_MESSAGES.behavioralUncertainty);
63
+ }
64
+
65
+ let confidenceScore = total / MAX_TOTAL;
66
+ if (hasMaterialDisagreement) {
67
+ confidenceScore -= 0.2;
68
+ }
69
+ if (hasUncertainty) {
70
+ confidenceScore -= 0.15;
71
+ }
72
+ confidenceScore = Math.max(0, Math.min(1, confidenceScore));
73
+ const belowThreshold = confidenceScore < confidenceThreshold;
74
+
75
+ const reasons = [];
76
+ if (detectorConflicts.length > 0) {
77
+ reasons.push(...detectorConflicts);
78
+ }
79
+ if (belowThreshold) {
80
+ reasons.push(`Confidence ${confidenceScore.toFixed(2)} is below the ${(confidenceThreshold * 100).toFixed(0)}% threshold.`);
81
+ }
82
+
83
+ let result = 'PASS';
84
+ if (detectorConflicts.length > 0) {
85
+ result = 'INCONCLUSIVE';
86
+ } else if (belowThreshold) {
87
+ result = 'WEAK';
88
+ }
89
+
90
+ return {
91
+ result,
92
+ score: total,
93
+ total,
94
+ dimensions,
95
+ weights: { ...WEIGHTS },
96
+ confidence: {
97
+ score: confidenceScore,
98
+ threshold: confidenceThreshold,
99
+ belowThreshold,
100
+ reasons,
101
+ },
102
+ detectorConflicts,
103
+ summary: reasons.join(' ') || 'Detector findings are consistent.',
104
+ reasons,
105
+ };
106
+ }
107
+
108
+ function needsUserEscalation(rubricResult) {
109
+ return (
110
+ rubricResult.result === 'INCONCLUSIVE'
111
+ || rubricResult.confidence.belowThreshold
112
+ || rubricResult.detectorConflicts.length > 0
113
+ );
114
+ }
115
+
116
+ module.exports = {
117
+ WEIGHTS,
118
+ aggregateRubricScores,
119
+ needsUserEscalation,
120
+ };