fraim-framework 2.0.30 → 2.0.34

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 (67) hide show
  1. package/bin/fraim.js +3 -18
  2. package/dist/src/cli/commands/init.js +29 -2
  3. package/dist/src/cli/commands/sync.js +82 -70
  4. package/dist/src/utils/script-sync-utils.js +216 -0
  5. package/dist/tests/debug-tools.js +6 -5
  6. package/dist/tests/test-chalk-regression.js +58 -8
  7. package/dist/tests/test-cli.js +70 -5
  8. package/dist/tests/test-end-to-end-hybrid-validation.js +328 -0
  9. package/dist/tests/test-first-run-journey.js +43 -3
  10. package/dist/tests/test-hybrid-script-execution.js +340 -0
  11. package/dist/tests/test-mcp-connection.js +2 -2
  12. package/dist/tests/test-mcp-issue-integration.js +12 -4
  13. package/dist/tests/test-mcp-lifecycle-methods.js +4 -4
  14. package/dist/tests/test-node-compatibility.js +24 -2
  15. package/dist/tests/test-prep-issue.js +4 -1
  16. package/dist/tests/test-script-location-independence.js +173 -0
  17. package/dist/tests/test-script-sync.js +557 -0
  18. package/dist/tests/test-session-rehydration.js +2 -2
  19. package/dist/tests/test-standalone.js +3 -3
  20. package/dist/tests/test-sync-version-update.js +1 -1
  21. package/dist/tests/test-telemetry.js +2 -2
  22. package/dist/tests/test-user-journey.js +8 -4
  23. package/dist/tests/test-utils.js +13 -0
  24. package/dist/tests/test-wizard.js +2 -2
  25. package/package.json +3 -3
  26. package/registry/rules/agent-testing-guidelines.md +502 -502
  27. package/registry/rules/ephemeral-execution.md +37 -27
  28. package/registry/rules/local-development.md +253 -251
  29. package/registry/rules/successful-debugging-patterns.md +491 -482
  30. package/registry/scripts/prep-issue.sh +468 -468
  31. package/registry/workflows/bootstrap/evaluate-code-quality.md +8 -2
  32. package/registry/workflows/bootstrap/verify-test-coverage.md +8 -2
  33. package/registry/workflows/customer-development/thank-customers.md +203 -193
  34. package/registry/workflows/customer-development/weekly-newsletter.md +366 -362
  35. package/registry/workflows/performance/analyze-performance.md +65 -63
  36. package/registry/workflows/product-building/implement.md +6 -2
  37. package/registry/workflows/product-building/prep-issue.md +11 -24
  38. package/registry/workflows/product-building/resolve.md +5 -1
  39. package/registry/workflows/replicate/replicate-discovery.md +336 -0
  40. package/registry/workflows/replicate/replicate-to-issues.md +319 -0
  41. package/registry/workflows/reviewer/review-implementation-vs-design-spec.md +632 -632
  42. package/.windsurf/rules/windsurf-rules.md +0 -7
  43. package/.windsurf/workflows/resolve-issue.md +0 -6
  44. package/.windsurf/workflows/retrospect.md +0 -6
  45. package/.windsurf/workflows/start-design.md +0 -6
  46. package/.windsurf/workflows/start-impl.md +0 -6
  47. package/.windsurf/workflows/start-spec.md +0 -6
  48. package/.windsurf/workflows/start-tests.md +0 -6
  49. package/registry/scripts/build-scripts-generator.ts +0 -216
  50. package/registry/scripts/cleanup-branch.ts +0 -303
  51. package/registry/scripts/fraim-config.ts +0 -63
  52. package/registry/scripts/generate-engagement-emails.ts +0 -744
  53. package/registry/scripts/generic-issues-api.ts +0 -110
  54. package/registry/scripts/newsletter-helpers.ts +0 -874
  55. package/registry/scripts/openapi-generator.ts +0 -695
  56. package/registry/scripts/performance/profile-server.ts +0 -370
  57. package/registry/scripts/run-thank-you-workflow.ts +0 -122
  58. package/registry/scripts/send-newsletter-simple.ts +0 -104
  59. package/registry/scripts/send-thank-you-emails.ts +0 -57
  60. package/registry/workflows/replicate/re-implementation-strategy.md +0 -226
  61. package/registry/workflows/replicate/use-case-extraction.md +0 -135
  62. package/registry/workflows/replicate/visual-analysis.md +0 -154
  63. package/registry/workflows/replicate/website-discovery-analysis.md +0 -231
  64. package/sample_package.json +0 -18
  65. /package/registry/scripts/{replicate/comprehensive-explorer.py → comprehensive-explorer.py} +0 -0
  66. /package/registry/scripts/{replicate/interactive-explorer.py → interactive-explorer.py} +0 -0
  67. /package/registry/scripts/{replicate/scrape-site.py → scrape-site.py} +0 -0
@@ -1,110 +0,0 @@
1
- /**
2
- * FRAIM Generic Issues API
3
- *
4
- * Generic issue filing endpoint that works for any project.
5
- * Can be invoked through ChatGPT OpenAPI or MCP.
6
- *
7
- * Usage:
8
- * 1. Import this file
9
- * 2. Mount the router in your Express app
10
- * 3. Configure GitHub repository in .fraim/config.json
11
- */
12
-
13
- import { Router, Request, Response } from 'express';
14
- import { fileFraimIssue } from '../../src/fraim/issues.js';
15
- import { loadFraimConfig } from '../../src/fraim/config-loader.js';
16
-
17
- const issuesRouter = Router();
18
-
19
- /**
20
- * POST /issues/create - Create a GitHub issue
21
- *
22
- * Generic endpoint that works for any FRAIM project.
23
- * Repository owner and name are read from .fraim/config.json
24
- */
25
- issuesRouter.post('/create', async (req: Request, res: Response) => {
26
- try {
27
- // Load project configuration
28
- const config = loadFraimConfig();
29
- const repoOwner = config.git?.repoOwner || process.env.GITHUB_OWNER || 'your-org';
30
- const repoName = config.git?.repoName || process.env.GITHUB_REPO || 'your-repo';
31
-
32
- // Get user context (if available - project-specific)
33
- // Projects can customize this based on their auth system
34
- const userId = (req as any).userContext?.userId ||
35
- (req as any).executiveContext?.executiveId ||
36
- req.headers['x-user-id'] as string;
37
- const userEmail = (req as any).userContext?.email ||
38
- (req as any).executiveContext?.executiveEmail ||
39
- req.headers['x-user-email'] as string;
40
- const userName = (req as any).userContext?.name ||
41
- (req as any).executiveContext?.executiveName ||
42
- req.headers['x-user-name'] as string;
43
-
44
- const { title, body, labels } = req.body;
45
-
46
- if (!title || !body) {
47
- return res.status(400).json({
48
- success: false,
49
- error: 'Missing required fields: title, body'
50
- });
51
- }
52
-
53
- // Check if GitHub token is configured
54
- if (!process.env.GITHUB_TOKEN && !process.env.GIT_TOKEN && !process.env.GITHUB_PAT) {
55
- return res.status(500).json({
56
- success: false,
57
- error: 'GitHub integration not configured. Please set GITHUB_TOKEN environment variable.'
58
- });
59
- }
60
-
61
- // Build issue body with user context (if available)
62
- let issueBody = body;
63
- if (userName || userEmail || userId) {
64
- issueBody = `**Reported by:** ${userName || 'Unknown'}${userEmail ? ` (${userEmail})` : ''}${userId ? `\n**User ID:** ${userId}` : ''}\n\n**Issue Details:**\n${body}\n\n---\n*This issue was automatically created through the API.*`;
65
- }
66
-
67
- // Create the issue using shared function
68
- const result = await fileFraimIssue({
69
- title: title,
70
- body: issueBody,
71
- labels: labels || ['user-reported']
72
- });
73
-
74
- if (!result.success) {
75
- return res.status(500).json({
76
- success: false,
77
- error: result.message
78
- });
79
- }
80
-
81
- return res.json({
82
- success: true,
83
- message: 'Issue created successfully',
84
- issueNumber: result.issueNumber,
85
- issueUrl: result.htmlUrl,
86
- title: title
87
- });
88
-
89
- } catch (error: any) {
90
- console.error('❌ Unexpected error creating Git issue:', error);
91
- return res.status(500).json({
92
- success: false,
93
- error: error.message || 'Failed to create Git issue'
94
- });
95
- }
96
- });
97
-
98
- /**
99
- * GET /issues/list - List issues
100
- *
101
- * Not implemented in this generic version.
102
- */
103
- issuesRouter.get('/list', async (req: Request, res: Response) => {
104
- return res.status(501).json({
105
- success: false,
106
- error: 'Listing issues is not supported in this generic API version yet.'
107
- });
108
- });
109
-
110
- export { issuesRouter };