fraim-framework 2.0.64 โ†’ 2.0.65

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 (107) hide show
  1. package/bin/fraim-mcp.js +52 -19
  2. package/bin/fraim.js +23 -0
  3. package/dist/src/cli/commands/add-ide.js +53 -14
  4. package/dist/src/cli/commands/doctor.js +12 -24
  5. package/dist/src/cli/commands/init-project.js +0 -3
  6. package/dist/src/cli/commands/init.js +0 -2
  7. package/dist/src/cli/commands/mcp.js +65 -0
  8. package/dist/src/cli/commands/setup.js +17 -1
  9. package/dist/src/cli/commands/sync.js +173 -104
  10. package/dist/src/cli/setup/auto-mcp-setup.js +6 -4
  11. package/dist/src/cli/setup/mcp-config-generator.js +65 -41
  12. package/dist/src/fraim/issue-tracking/ado-provider.js +304 -0
  13. package/dist/src/fraim/issue-tracking/factory.js +63 -0
  14. package/dist/src/fraim/issue-tracking/github-provider.js +200 -0
  15. package/dist/src/fraim/issue-tracking/types.js +7 -0
  16. package/dist/src/fraim/issue-tracking-config.js +83 -0
  17. package/dist/src/local-mcp-server/stdio-server.js +23 -3
  18. package/dist/src/utils/remote-sync.js +130 -0
  19. package/package.json +2 -3
  20. package/dist/src/utils/enforcement-utils.js +0 -239
  21. package/dist/src/utils/validate-workflows.js +0 -101
  22. package/registry/scripts/cleanup-branch.ts +0 -341
  23. package/registry/scripts/code-quality-check.sh +0 -566
  24. package/registry/scripts/comprehensive-explorer.py +0 -297
  25. package/registry/scripts/create-git-labels.sh +0 -49
  26. package/registry/scripts/create-website-structure.js +0 -562
  27. package/registry/scripts/detect-tautological-tests.sh +0 -38
  28. package/registry/scripts/evaluate-code-quality.ts +0 -36
  29. package/registry/scripts/exec-with-timeout.ts +0 -122
  30. package/registry/scripts/generate-engagement-emails.ts +0 -830
  31. package/registry/scripts/interactive-explorer.py +0 -270
  32. package/registry/scripts/markdown-to-pdf.js +0 -395
  33. package/registry/scripts/newsletter-helpers.ts +0 -777
  34. package/registry/scripts/pdf-styles.css +0 -172
  35. package/registry/scripts/prep-issue.sh +0 -548
  36. package/registry/scripts/productivity/build-productivity-csv.mjs +0 -242
  37. package/registry/scripts/productivity/fetch-pr-details.mjs +0 -144
  38. package/registry/scripts/productivity/productivity-report.sh +0 -147
  39. package/registry/scripts/profile-server.ts +0 -426
  40. package/registry/scripts/run-thank-you-workflow.ts +0 -122
  41. package/registry/scripts/scrape-site.py +0 -302
  42. package/registry/scripts/send-newsletter-simple.ts +0 -102
  43. package/registry/scripts/send-thank-you-emails.ts +0 -57
  44. package/registry/scripts/validate-openapi-limits.ts +0 -366
  45. package/registry/scripts/validate-test-coverage.ts +0 -280
  46. package/registry/scripts/verify-pr-comments.sh +0 -74
  47. package/registry/scripts/verify-test-coverage.ts +0 -36
  48. package/registry/stubs/workflows/azure/cost-optimization.md +0 -11
  49. package/registry/stubs/workflows/bootstrap/create-architecture.md +0 -11
  50. package/registry/stubs/workflows/bootstrap/detect-broken-windows.md +0 -11
  51. package/registry/stubs/workflows/bootstrap/evaluate-code-quality.md +0 -11
  52. package/registry/stubs/workflows/bootstrap/verify-test-coverage.md +0 -11
  53. package/registry/stubs/workflows/brainstorming/blue-sky-brainstorming.md +0 -11
  54. package/registry/stubs/workflows/brainstorming/codebase-brainstorming.md +0 -11
  55. package/registry/stubs/workflows/business-development/create-business-plan.md +0 -11
  56. package/registry/stubs/workflows/business-development/ideate-business-opportunity.md +0 -11
  57. package/registry/stubs/workflows/business-development/price-product.md +0 -18
  58. package/registry/stubs/workflows/compliance/detect-compliance-requirements.md +0 -11
  59. package/registry/stubs/workflows/compliance/generate-audit-evidence.md +0 -11
  60. package/registry/stubs/workflows/compliance/soc2-evidence-generator.md +0 -11
  61. package/registry/stubs/workflows/customer-development/insight-analysis.md +0 -11
  62. package/registry/stubs/workflows/customer-development/insight-triage.md +0 -11
  63. package/registry/stubs/workflows/customer-development/interview-preparation.md +0 -11
  64. package/registry/stubs/workflows/customer-development/linkedin-outreach.md +0 -11
  65. package/registry/stubs/workflows/customer-development/strategic-brainstorming.md +0 -11
  66. package/registry/stubs/workflows/customer-development/thank-customers.md +0 -11
  67. package/registry/stubs/workflows/customer-development/user-survey-dispatch.md +0 -11
  68. package/registry/stubs/workflows/customer-development/users-to-target.md +0 -11
  69. package/registry/stubs/workflows/customer-development/weekly-newsletter.md +0 -11
  70. package/registry/stubs/workflows/deploy/cloud-deployment.md +0 -11
  71. package/registry/stubs/workflows/improve-fraim/contribute.md +0 -11
  72. package/registry/stubs/workflows/improve-fraim/file-issue.md +0 -11
  73. package/registry/stubs/workflows/learning/build-skillset.md +0 -11
  74. package/registry/stubs/workflows/learning/synthesize-learnings.md +0 -11
  75. package/registry/stubs/workflows/legal/contract-review-analysis.md +0 -11
  76. package/registry/stubs/workflows/legal/nda.md +0 -11
  77. package/registry/stubs/workflows/legal/patent-filing.md +0 -11
  78. package/registry/stubs/workflows/legal/saas-contract-development.md +0 -11
  79. package/registry/stubs/workflows/legal/trademark-filing.md +0 -11
  80. package/registry/stubs/workflows/marketing/content-creation.md +0 -11
  81. package/registry/stubs/workflows/marketing/convert-to-pdf.md +0 -11
  82. package/registry/stubs/workflows/marketing/create-modern-website.md +0 -11
  83. package/registry/stubs/workflows/marketing/domain-registration.md +0 -11
  84. package/registry/stubs/workflows/marketing/hbr-article.md +0 -11
  85. package/registry/stubs/workflows/marketing/launch-checklist.md +0 -11
  86. package/registry/stubs/workflows/marketing/marketing-strategy.md +0 -11
  87. package/registry/stubs/workflows/marketing/storytelling.md +0 -11
  88. package/registry/stubs/workflows/performance/analyze-performance.md +0 -11
  89. package/registry/stubs/workflows/product-building/design.md +0 -11
  90. package/registry/stubs/workflows/product-building/implement.md +0 -11
  91. package/registry/stubs/workflows/product-building/iterate-on-pr-comments.md +0 -11
  92. package/registry/stubs/workflows/product-building/prep-issue.md +0 -11
  93. package/registry/stubs/workflows/product-building/prototype.md +0 -11
  94. package/registry/stubs/workflows/product-building/resolve.md +0 -11
  95. package/registry/stubs/workflows/product-building/retrospect.md +0 -11
  96. package/registry/stubs/workflows/product-building/spec.md +0 -11
  97. package/registry/stubs/workflows/product-building/test.md +0 -11
  98. package/registry/stubs/workflows/productivity-report/productivity-report.md +0 -11
  99. package/registry/stubs/workflows/quality-assurance/browser-validation.md +0 -11
  100. package/registry/stubs/workflows/quality-assurance/iterative-improvement-cycle.md +0 -11
  101. package/registry/stubs/workflows/replicate/replicate-discovery.md +0 -11
  102. package/registry/stubs/workflows/replicate/replicate-to-issues.md +0 -11
  103. package/registry/stubs/workflows/reviewer/review-implementation-vs-design-spec.md +0 -11
  104. package/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md +0 -11
  105. package/registry/stubs/workflows/startup-credits/aws-activate-application.md +0 -11
  106. package/registry/stubs/workflows/startup-credits/google-cloud-application.md +0 -11
  107. package/registry/stubs/workflows/startup-credits/microsoft-azure-application.md +0 -11
@@ -1,341 +0,0 @@
1
- #!/usr/bin/env npx tsx
2
-
3
- import { execSync } from 'child_process';
4
- import { readFileSync, existsSync } from 'fs';
5
- import { join } from 'path';
6
- import dotenv from 'dotenv';
7
-
8
- // Load environment variables
9
- dotenv.config({ override: true });
10
-
11
- // Self-contained utility functions (no FRAIM internal imports)
12
- function extractIssueNumber(branchName: string): string {
13
- const match = branchName.match(/(\d+)/);
14
- return match ? match[1] : '';
15
- }
16
-
17
- function getCurrentGitBranch(): string {
18
- try {
19
- return execSync('git branch --show-current', { encoding: 'utf8' }).trim();
20
- } catch (error) {
21
- return 'unknown';
22
- }
23
- }
24
-
25
- interface FraimConfig {
26
- persona: { name: string; displayNamePattern: string; emailSignature: string };
27
- git: { repoOwner: string; repoName: string };
28
- database: { identityCollection: string; executiveCollection: string };
29
- marketing: { websiteUrl?: string; chatUrl?: string };
30
- }
31
-
32
- function loadClientConfig(): FraimConfig {
33
- const configPath = join(process.cwd(), '.fraim', 'config.json');
34
- if (!existsSync(configPath)) {
35
- throw new Error('.fraim/config.json not found. Run fraim init first.');
36
- }
37
- return JSON.parse(readFileSync(configPath, 'utf-8'));
38
- }
39
-
40
- function getEnvOr(keys: string[], fallback: string): string {
41
- for (const key of keys) {
42
- const value = process.env[key];
43
- if (value && value.length) return value;
44
- }
45
- return fallback;
46
- }
47
-
48
- interface CleanupOptions {
49
- branchName?: string;
50
- force?: boolean;
51
- skipProjectCleanup?: boolean;
52
- skipGit?: boolean;
53
- }
54
-
55
- class BranchCleanup {
56
- private options: CleanupOptions;
57
-
58
- constructor(options: CleanupOptions = {}) {
59
- this.options = {
60
- branchName: options.branchName,
61
- force: options.force || false,
62
- skipProjectCleanup: options.skipProjectCleanup || false,
63
- skipGit: options.skipGit || false,
64
- };
65
- }
66
-
67
- private async insertYourCodeHere(branchName: string): Promise<void> {
68
- const branchPattern = "branch_" + extractIssueNumber(branchName) + "%";
69
- this.log(`Attempting to fetch and run DB cleanup for pattern: ${branchPattern}`);
70
-
71
- // Historically this called: npx tsx scripts/database/cleanup-mongo-schemas.ts
72
- // In FRAIM 2.0, we should fetch it if possible, or skip if it's an internal-only script
73
- // that doesn't exist in the registry but was incorrectly referenced.
74
-
75
- // NOTE: In this specific case, cleanup-mongo-schemas.ts is likely an internal script.
76
- // If it's not in the registry, get_fraim_file will fail.
77
- // For now, we fix the path to be more agnostic or explicitly documented as a dependency.
78
-
79
- try {
80
- // NOTE: Users should define their own cleanup script location in .fraim/config.json
81
- // or the agent should fetch it. For now, we try to run it from a standard location
82
- // if it exists, but we don't hardcode it as a requirement for the script to run.
83
- const cleanupScript = process.env.FRAIM_PROJECT_CLEANUP_SCRIPT || (['scripts', 'database', 'cleanup-mongo-schemas.ts'].join('/'));
84
- this.log(`Checking for project cleanup script: ${cleanupScript}`);
85
-
86
- await this.executeCommand(
87
- `npx tsx ${cleanupScript} "${branchPattern}"`,
88
- 'Run project-specific cleanup script'
89
- );
90
- } catch (e) {
91
- this.log('Skipping project-specific cleanup (script not found or failed).', 'info');
92
- }
93
- }
94
-
95
-
96
- private log(message: string, level: 'info' | 'warn' | 'error' | 'success' = 'info') {
97
- const timestamp = new Date().toISOString();
98
- const prefix = {
99
- info: 'โ„น๏ธ ',
100
- warn: 'โš ๏ธ ',
101
- error: 'โŒ',
102
- success: 'โœ…'
103
- }[level];
104
-
105
- console.log(`${prefix} [${timestamp}] ${message}`);
106
- }
107
-
108
- private async executeCommand(command: string, description: string): Promise<string> {
109
- this.log(`Executing: ${description}`);
110
-
111
- try {
112
- const result = execSync(command, {
113
- encoding: 'utf8',
114
- stdio: 'pipe',
115
- cwd: process.cwd()
116
- });
117
- this.log(`Success: ${description}`, 'success');
118
- return result;
119
- } catch (error: any) {
120
- this.log(`Failed: ${description} - ${error.message}`, 'error');
121
- throw error;
122
- }
123
- }
124
-
125
- private async getCurrentBranch(): Promise<string> {
126
- try {
127
- const result = await this.executeCommand('git branch --show-current', 'Get current branch');
128
- return result.trim();
129
- } catch (error) {
130
- this.log('Could not determine current branch', 'warn');
131
- return 'unknown';
132
- }
133
- }
134
-
135
- private async getBranchName(): Promise<string> {
136
- if (this.options.branchName) {
137
- return this.options.branchName;
138
- }
139
-
140
- const currentBranch = await this.getCurrentBranch();
141
- if (currentBranch === 'master' || currentBranch === 'main') {
142
- throw new Error('Cannot cleanup master/main branch. Please specify a feature branch name.');
143
- }
144
-
145
- return currentBranch;
146
- }
147
-
148
- private async checkBranchExists(branchName: string, remote: boolean = false): Promise<boolean> {
149
- try {
150
- const command = remote
151
- ? `git ls-remote --heads origin ${branchName}`
152
- : `git branch --list ${branchName}`;
153
-
154
- const result = await this.executeCommand(command, `Check if ${remote ? 'remote' : 'local'} branch exists`);
155
- return result.trim().length > 0;
156
- } catch (error) {
157
- return false;
158
- }
159
- }
160
-
161
- private async doProjectSpecificCleanup(branchName: string): Promise<void> {
162
- try {
163
- if (this.options.skipProjectCleanup) {
164
- this.log('Skipping project-specific cleanup', 'warn');
165
- return;
166
- }
167
-
168
- this.log('Starting project-specific cleanup...');
169
-
170
- await this.insertYourCodeHere(branchName);
171
-
172
- this.log('Project-specific cleanup completed successfully', 'success');
173
- } catch (error: any) {
174
- this.log(`Project-specific cleanup failed: ${error.message}`, 'error');
175
- if (!this.options.force) {
176
- throw error;
177
- }
178
- }
179
- }
180
-
181
- private async cleanupGitBranches(branchName: string): Promise<void> {
182
- if (this.options.skipGit) {
183
- this.log('Skipping Git cleanup', 'warn');
184
- return;
185
- }
186
-
187
- this.log(`Starting Git branch cleanup for: ${branchName}`);
188
-
189
- // Check if we're on the branch we want to delete
190
- const currentBranch = await this.getCurrentBranch();
191
- if (currentBranch === branchName) {
192
- this.log(`Currently on branch ${branchName}, switching to master first`, 'warn');
193
- await this.executeCommand('git checkout master', 'Switch to master branch');
194
- }
195
-
196
- // Delete remote branch
197
- const remoteExists = await this.checkBranchExists(branchName, true);
198
- if (remoteExists) {
199
- this.log(`Deleting remote branch: origin/${branchName}`);
200
- await this.executeCommand(`git push origin --delete ${branchName}`, `Delete remote branch ${branchName}`);
201
- } else {
202
- this.log(`Remote branch origin/${branchName} does not exist`, 'info');
203
- }
204
-
205
- // Delete local branch
206
- const localExists = await this.checkBranchExists(branchName, false);
207
- if (localExists) {
208
- this.log(`Deleting local branch: ${branchName}`);
209
- await this.executeCommand(`git branch -D ${branchName}`, `Delete local branch ${branchName}`);
210
- } else {
211
- this.log(`Local branch ${branchName} does not exist`, 'info');
212
- }
213
-
214
- // Clean up any untracked files
215
- this.log('Cleaning up untracked files...');
216
- await this.executeCommand('git clean -fd', 'Remove untracked files and directories');
217
-
218
- // Reset any uncommitted changes
219
- this.log('Resetting uncommitted changes...');
220
- await this.executeCommand('git reset --hard HEAD', 'Reset to HEAD');
221
-
222
- this.log('Git branch cleanup completed', 'success');
223
- }
224
-
225
-
226
- private async verifyCleanup(branchName: string): Promise<void> {
227
- this.log('Verifying cleanup...');
228
-
229
- // Verify branch deletion
230
- const remoteExists = await this.checkBranchExists(branchName, true);
231
- const localExists = await this.checkBranchExists(branchName, false);
232
-
233
- if (remoteExists || localExists) {
234
- this.log(`Warning: Branch ${branchName} still exists (remote: ${remoteExists}, local: ${localExists})`, 'warn');
235
- } else {
236
- this.log(`Branch ${branchName} successfully deleted`, 'success');
237
- }
238
-
239
- // Verify we're on master
240
- const currentBranch = await this.getCurrentBranch();
241
- if (currentBranch === 'master' || currentBranch === 'main') {
242
- this.log('Currently on master/main branch', 'success');
243
- } else {
244
- this.log(`Warning: Not on master branch, currently on ${currentBranch}`, 'warn');
245
- }
246
-
247
- this.log('Cleanup verification completed', 'success');
248
- }
249
-
250
- async cleanup(): Promise<void> {
251
- try {
252
- this.log('๐Ÿš€ Starting branch cleanup process...');
253
-
254
- const branchName = await this.getBranchName();
255
- this.log(`Target branch: ${branchName}`);
256
-
257
- // Step 1: Project-specific cleanup
258
- await this.doProjectSpecificCleanup(branchName);
259
-
260
- // Step 2: Git branch cleanup
261
- await this.cleanupGitBranches(branchName);
262
-
263
- // Step 3: Verification
264
- await this.verifyCleanup(branchName);
265
-
266
- this.log('๐ŸŽ‰ Branch cleanup completed successfully!', 'success');
267
-
268
- } catch (error: any) {
269
- this.log(`Cleanup failed: ${error.message}`, 'error');
270
- if (!this.options.force) {
271
- process.exit(1);
272
- }
273
- }
274
- }
275
- }
276
-
277
- // Parse command line arguments
278
- const args = process.argv.slice(2);
279
- const options: CleanupOptions = {};
280
-
281
- // Parse arguments
282
- for (let i = 0; i < args.length; i++) {
283
- const arg = args[i];
284
-
285
- switch (arg) {
286
- case '--branch':
287
- case '-b':
288
- options.branchName = args[++i];
289
- break;
290
- case '--force':
291
- case '-f':
292
- options.force = true;
293
- break;
294
- case '--skip-project-cleanup':
295
- options.skipProjectCleanup = true;
296
- break;
297
- case '--skip-git':
298
- options.skipGit = true;
299
- break;
300
- case '--help':
301
- case '-h':
302
- console.log(`
303
- ๐Ÿงน Branch Cleanup Script
304
-
305
- Usage:
306
- npx tsx scripts/cleanup-branch.ts [options]
307
-
308
- Options:
309
- --branch, -b <name> Specific branch name to cleanup (default: current branch)
310
- --force, -f Continue even if some operations fail
311
- --skip-project-cleanup Skip project-specific cleanup
312
- --skip-git Skip Git branch deletion
313
- --help, -h Show this help message
314
-
315
- Examples:
316
- # Cleanup current branch with default settings
317
- npx tsx <cleanup-script-path>
318
-
319
- # Cleanup specific branch
320
- npx tsx <cleanup-script-path> --branch feature/123
321
-
322
- # Force cleanup even if some operations fail
323
- npx tsx <cleanup-script-path> --force
324
-
325
- # Skip project-specific cleanup (only do Git cleanup)
326
- npx tsx <cleanup-script-path> --skip-project-cleanup
327
-
328
- This script performs the following cleanup operations:
329
- 1. ๐Ÿ—„๏ธ Project-specific cleanup (calls configured cleanup script)
330
- 2. ๐ŸŒฟ Git branch deletion (remote and local)
331
- 3. โœ… Verification of cleanup completion
332
-
333
- โš ๏ธ WARNING: This script will permanently delete branches and data!
334
- `);
335
- process.exit(0);
336
- }
337
- }
338
-
339
- // Run the cleanup
340
- const cleanup = new BranchCleanup(options);
341
- cleanup.cleanup();