fraim-framework 2.0.30 → 2.0.33

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/dist/src/cli/commands/init.js +29 -2
  2. package/dist/src/cli/commands/sync.js +18 -1
  3. package/dist/src/utils/script-sync-utils.js +218 -0
  4. package/dist/tests/debug-tools.js +6 -5
  5. package/dist/tests/test-chalk-regression.js +58 -8
  6. package/dist/tests/test-cli.js +70 -5
  7. package/dist/tests/test-end-to-end-hybrid-validation.js +349 -0
  8. package/dist/tests/test-first-run-journey.js +43 -3
  9. package/dist/tests/test-hybrid-script-execution.js +369 -0
  10. package/dist/tests/test-mcp-connection.js +2 -2
  11. package/dist/tests/test-mcp-issue-integration.js +12 -4
  12. package/dist/tests/test-mcp-lifecycle-methods.js +4 -4
  13. package/dist/tests/test-node-compatibility.js +24 -2
  14. package/dist/tests/test-prep-issue.js +4 -1
  15. package/dist/tests/test-script-location-independence.js +173 -0
  16. package/dist/tests/test-script-sync.js +557 -0
  17. package/dist/tests/test-session-rehydration.js +2 -2
  18. package/dist/tests/test-standalone.js +3 -3
  19. package/dist/tests/test-sync-version-update.js +1 -1
  20. package/dist/tests/test-telemetry.js +2 -2
  21. package/dist/tests/test-user-journey.js +8 -4
  22. package/dist/tests/test-utils.js +13 -0
  23. package/dist/tests/test-wizard.js +2 -2
  24. package/package.json +3 -3
  25. package/registry/rules/agent-testing-guidelines.md +502 -502
  26. package/registry/rules/ephemeral-execution.md +37 -27
  27. package/registry/rules/local-development.md +253 -251
  28. package/registry/rules/successful-debugging-patterns.md +491 -482
  29. package/registry/scripts/prep-issue.sh +468 -468
  30. package/registry/workflows/bootstrap/evaluate-code-quality.md +8 -2
  31. package/registry/workflows/bootstrap/verify-test-coverage.md +8 -2
  32. package/registry/workflows/customer-development/thank-customers.md +203 -193
  33. package/registry/workflows/customer-development/weekly-newsletter.md +366 -362
  34. package/registry/workflows/performance/analyze-performance.md +65 -63
  35. package/registry/workflows/product-building/implement.md +6 -2
  36. package/registry/workflows/product-building/prep-issue.md +11 -24
  37. package/registry/workflows/product-building/resolve.md +5 -1
  38. package/registry/workflows/replicate/replicate-discovery.md +336 -0
  39. package/registry/workflows/replicate/replicate-to-issues.md +319 -0
  40. package/registry/workflows/reviewer/review-implementation-vs-design-spec.md +632 -632
  41. package/.windsurf/rules/windsurf-rules.md +0 -7
  42. package/.windsurf/workflows/resolve-issue.md +0 -6
  43. package/.windsurf/workflows/retrospect.md +0 -6
  44. package/.windsurf/workflows/start-design.md +0 -6
  45. package/.windsurf/workflows/start-impl.md +0 -6
  46. package/.windsurf/workflows/start-spec.md +0 -6
  47. package/.windsurf/workflows/start-tests.md +0 -6
  48. package/bin/fraim.js +0 -23
  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
@@ -0,0 +1,173 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ var __importDefault = (this && this.__importDefault) || function (mod) {
36
+ return (mod && mod.__esModule) ? mod : { "default": mod };
37
+ };
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ const test_utils_1 = require("./test-utils");
40
+ const fs_1 = __importDefault(require("fs"));
41
+ const path_1 = __importDefault(require("path"));
42
+ const os_1 = __importDefault(require("os"));
43
+ async function testScriptLocationIndependence() {
44
+ console.log(' 🚀 Testing Script Location Independence...');
45
+ const tempProjectDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'fraim-location-test-'));
46
+ const userFraimDir = path_1.default.join(os_1.default.homedir(), '.fraim-location-test');
47
+ const userScriptsDir = path_1.default.join(userFraimDir, 'scripts');
48
+ console.log(` 📂 Created temp project dir: ${tempProjectDir}`);
49
+ console.log(` 🏠 Using test user dir: ${userFraimDir}`);
50
+ try {
51
+ // Clean up any existing test user directory
52
+ if (fs_1.default.existsSync(userFraimDir)) {
53
+ fs_1.default.rmSync(userFraimDir, { recursive: true, force: true });
54
+ }
55
+ // Create user scripts directory and copy actual registry scripts
56
+ fs_1.default.mkdirSync(userScriptsDir, { recursive: true });
57
+ // Copy a few key scripts to test
58
+ const scriptsToTest = [
59
+ 'prep-issue.sh',
60
+ 'code-quality-check.sh',
61
+ 'detect-tautological-tests.sh'
62
+ ];
63
+ for (const scriptName of scriptsToTest) {
64
+ const sourcePath = path_1.default.resolve(__dirname, '../registry/scripts', scriptName);
65
+ const targetPath = path_1.default.join(userScriptsDir, scriptName);
66
+ if (fs_1.default.existsSync(sourcePath)) {
67
+ fs_1.default.copyFileSync(sourcePath, targetPath);
68
+ // Make executable on Unix systems
69
+ if (process.platform !== 'win32') {
70
+ fs_1.default.chmodSync(targetPath, 0o755);
71
+ }
72
+ }
73
+ }
74
+ // Set up project directory with .fraim/config.json
75
+ const projectFraimDir = path_1.default.join(tempProjectDir, '.fraim');
76
+ fs_1.default.mkdirSync(projectFraimDir, { recursive: true });
77
+ const testConfig = {
78
+ project: { name: 'location-test' },
79
+ git: {
80
+ repoOwner: 'test',
81
+ repoName: 'location-test',
82
+ url: 'https://github.com/test/location-test.git'
83
+ }
84
+ };
85
+ fs_1.default.writeFileSync(path_1.default.join(projectFraimDir, 'config.json'), JSON.stringify(testConfig, null, 2));
86
+ // Test 1: Try to execute prep-issue.sh from user directory
87
+ console.log(' Testing prep-issue.sh execution from user directory...');
88
+ const prepIssueScript = path_1.default.join(userScriptsDir, 'prep-issue.sh');
89
+ if (fs_1.default.existsSync(prepIssueScript)) {
90
+ try {
91
+ const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
92
+ // Use Git Bash on Windows, regular bash on Unix
93
+ const bashCommand = process.platform === 'win32'
94
+ ? `"C:\\Program Files\\Git\\bin\\bash.exe" "${prepIssueScript}" --help`
95
+ : `"${prepIssueScript}" --help`;
96
+ const output = execSync(bashCommand, {
97
+ cwd: tempProjectDir,
98
+ encoding: 'utf-8',
99
+ timeout: 10000
100
+ });
101
+ // If we get here, the script at least started successfully
102
+ console.log(' ✅ prep-issue.sh executed successfully from user directory');
103
+ }
104
+ catch (error) {
105
+ // The script may fail due to missing repo, but as long as it started, that's OK
106
+ if (process.platform === 'win32' && error.message.includes('not recognized')) {
107
+ console.log(' ⚠️ Git Bash not found on Windows, skipping prep-issue test');
108
+ }
109
+ else if (error.message.includes('Repository not found') || error.message.includes('fatal: repository')) {
110
+ // This is expected - the test repo doesn't exist, but the script ran
111
+ console.log(' ✅ prep-issue.sh executed from user directory (repo not found is expected)');
112
+ }
113
+ else {
114
+ console.log(' ❌ prep-issue.sh failed:', error.message);
115
+ return false;
116
+ }
117
+ }
118
+ }
119
+ // Test 2: Try to execute code-quality-check.sh (this will likely fail due to dependencies)
120
+ console.log(' Testing code-quality-check.sh execution from user directory...');
121
+ const qualityCheckScript = path_1.default.join(userScriptsDir, 'code-quality-check.sh');
122
+ if (fs_1.default.existsSync(qualityCheckScript)) {
123
+ try {
124
+ const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
125
+ const bashCommand = process.platform === 'win32'
126
+ ? `"C:\\Program Files\\Git\\bin\\bash.exe" "${qualityCheckScript}" --help`
127
+ : `"${qualityCheckScript}" --help`;
128
+ const output = execSync(bashCommand, {
129
+ cwd: tempProjectDir,
130
+ encoding: 'utf-8',
131
+ timeout: 10000
132
+ });
133
+ console.log(' ✅ code-quality-check.sh executed successfully from user directory');
134
+ }
135
+ catch (error) {
136
+ if (process.platform === 'win32' && error.message.includes('not recognized')) {
137
+ console.log(' ⚠️ Git Bash not found on Windows, skipping quality check test');
138
+ }
139
+ else {
140
+ console.log(' ❌ code-quality-check.sh failed (expected due to dependencies):', error.message);
141
+ // This is expected to fail - we'll document this as a known issue
142
+ }
143
+ }
144
+ }
145
+ console.log(' ✅ Script location independence test completed');
146
+ return true;
147
+ }
148
+ catch (error) {
149
+ console.error(' ❌ Script location independence test failed:', error);
150
+ return false;
151
+ }
152
+ finally {
153
+ try {
154
+ fs_1.default.rmSync(tempProjectDir, { recursive: true, force: true });
155
+ if (fs_1.default.existsSync(userFraimDir)) {
156
+ fs_1.default.rmSync(userFraimDir, { recursive: true, force: true });
157
+ }
158
+ }
159
+ catch (e) { }
160
+ }
161
+ }
162
+ async function runScriptLocationTest(testCase) {
163
+ return await testCase.testFunction();
164
+ }
165
+ const testCases = [
166
+ {
167
+ name: 'Script Location Independence',
168
+ description: 'Tests that actual registry scripts work when executed from ~/.fraim/scripts/',
169
+ testFunction: testScriptLocationIndependence,
170
+ tags: ['script-location', 'validation']
171
+ }
172
+ ];
173
+ (0, test_utils_1.runTests)(testCases, runScriptLocationTest, 'Script Location Independence Tests');