faf-cli 3.0.1 → 3.0.3

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/README.md +177 -31
  2. package/dist/cli.d.ts.map +1 -1
  3. package/dist/cli.js +46 -0
  4. package/dist/cli.js.map +1 -1
  5. package/dist/commands/auto.d.ts.map +1 -1
  6. package/dist/commands/auto.js +102 -0
  7. package/dist/commands/auto.js.map +1 -1
  8. package/dist/commands/fam.d.ts +15 -0
  9. package/dist/commands/fam.d.ts.map +1 -0
  10. package/dist/commands/fam.js +247 -0
  11. package/dist/commands/fam.js.map +1 -0
  12. package/dist/compiler/faf-compiler.d.ts.map +1 -1
  13. package/dist/compiler/faf-compiler.js +76 -4
  14. package/dist/compiler/faf-compiler.js.map +1 -1
  15. package/dist/core/platform-adapters.d.ts +76 -0
  16. package/dist/core/platform-adapters.d.ts.map +1 -0
  17. package/dist/core/platform-adapters.js +407 -0
  18. package/dist/core/platform-adapters.js.map +1 -0
  19. package/dist/core/universal-intelligence-generator.d.ts +156 -0
  20. package/dist/core/universal-intelligence-generator.d.ts.map +1 -0
  21. package/dist/core/universal-intelligence-generator.js +352 -0
  22. package/dist/core/universal-intelligence-generator.js.map +1 -0
  23. package/dist/family/detectors/n8n.d.ts +10 -0
  24. package/dist/family/detectors/n8n.d.ts.map +1 -0
  25. package/dist/family/detectors/n8n.js +95 -0
  26. package/dist/family/detectors/n8n.js.map +1 -0
  27. package/dist/family/detectors/next.d.ts +8 -0
  28. package/dist/family/detectors/next.d.ts.map +1 -0
  29. package/dist/family/detectors/next.js +86 -0
  30. package/dist/family/detectors/next.js.map +1 -0
  31. package/dist/family/detectors/react.d.ts +8 -0
  32. package/dist/family/detectors/react.d.ts.map +1 -0
  33. package/dist/family/detectors/react.js +73 -0
  34. package/dist/family/detectors/react.js.map +1 -0
  35. package/dist/family/detectors/svelte.d.ts +8 -0
  36. package/dist/family/detectors/svelte.d.ts.map +1 -0
  37. package/dist/family/detectors/svelte.js +90 -0
  38. package/dist/family/detectors/svelte.js.map +1 -0
  39. package/dist/family/detectors/typescript.d.ts +8 -0
  40. package/dist/family/detectors/typescript.d.ts.map +1 -0
  41. package/dist/family/detectors/typescript.js +102 -0
  42. package/dist/family/detectors/typescript.js.map +1 -0
  43. package/dist/family/detectors/vite.d.ts +8 -0
  44. package/dist/family/detectors/vite.d.ts.map +1 -0
  45. package/dist/family/detectors/vite.js +89 -0
  46. package/dist/family/detectors/vite.js.map +1 -0
  47. package/dist/family/index.d.ts +21 -0
  48. package/dist/family/index.d.ts.map +1 -0
  49. package/dist/family/index.js +73 -0
  50. package/dist/family/index.js.map +1 -0
  51. package/dist/family/registry.d.ts +57 -0
  52. package/dist/family/registry.d.ts.map +1 -0
  53. package/dist/family/registry.js +154 -0
  54. package/dist/family/registry.js.map +1 -0
  55. package/dist/family/types.d.ts +94 -0
  56. package/dist/family/types.d.ts.map +1 -0
  57. package/dist/family/types.js +8 -0
  58. package/dist/family/types.js.map +1 -0
  59. package/dist/tests/manual-validation.d.ts +8 -0
  60. package/dist/tests/manual-validation.d.ts.map +1 -0
  61. package/dist/tests/manual-validation.js +114 -0
  62. package/dist/tests/manual-validation.js.map +1 -0
  63. package/dist/utils/file-utils.d.ts +38 -0
  64. package/dist/utils/file-utils.d.ts.map +1 -1
  65. package/dist/utils/file-utils.js +148 -0
  66. package/dist/utils/file-utils.js.map +1 -1
  67. package/package.json +21 -4
@@ -0,0 +1,352 @@
1
+ "use strict";
2
+ /**
3
+ * 🏆 UNIVERSAL INTELLIGENCE GENERATOR
4
+ *
5
+ * THE foundational pattern that applies to EVERYTHING:
6
+ * - Code projects (package.json, tsconfig, etc.)
7
+ * - Automation workflows (n8n, Make, Opal, OpenAI)
8
+ * - Documentation centers (markdown, wikis)
9
+ * - API specifications (OpenAPI, GraphQL)
10
+ * - ANY project that needs AI context
11
+ *
12
+ * Pattern: interrogation → extraction → filtering → generation
13
+ * Output: ALWAYS .faf (universal container for structured intelligence)
14
+ *
15
+ * FOUNDATIONAL FIRST, UNIVERSAL BY DEFAULT
16
+ */
17
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
18
+ if (k2 === undefined) k2 = k;
19
+ var desc = Object.getOwnPropertyDescriptor(m, k);
20
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
21
+ desc = { enumerable: true, get: function() { return m[k]; } };
22
+ }
23
+ Object.defineProperty(o, k2, desc);
24
+ }) : (function(o, m, k, k2) {
25
+ if (k2 === undefined) k2 = k;
26
+ o[k2] = m[k];
27
+ }));
28
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
29
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
30
+ }) : function(o, v) {
31
+ o["default"] = v;
32
+ });
33
+ var __importStar = (this && this.__importStar) || (function () {
34
+ var ownKeys = function(o) {
35
+ ownKeys = Object.getOwnPropertyNames || function (o) {
36
+ var ar = [];
37
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
38
+ return ar;
39
+ };
40
+ return ownKeys(o);
41
+ };
42
+ return function (mod) {
43
+ if (mod && mod.__esModule) return mod;
44
+ var result = {};
45
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
46
+ __setModuleDefault(result, mod);
47
+ return result;
48
+ };
49
+ })();
50
+ Object.defineProperty(exports, "__esModule", { value: true });
51
+ exports.OpenAIAssistantGenerator = exports.N8nIntelligenceGenerator = exports.UniversalIntelligenceGenerator = void 0;
52
+ exports.createGenerator = createGenerator;
53
+ exports.generateFafFromAny = generateFafFromAny;
54
+ /**
55
+ * Base class implementing the universal pattern
56
+ *
57
+ * All input adapters (n8n, Make, Opal, etc.) extend this
58
+ */
59
+ class UniversalIntelligenceGenerator {
60
+ /**
61
+ * PHASE 4: GENERATION
62
+ *
63
+ * "Output championship .faf"
64
+ *
65
+ * Converts structured intelligence → YAML .faf file
66
+ * Target: 85%+ score (🥉 Bronze or better)
67
+ */
68
+ generate(intelligence) {
69
+ // Universal YAML generation
70
+ return this.toYAML(intelligence);
71
+ }
72
+ /**
73
+ * THE COMPLETE FLOW
74
+ *
75
+ * Orchestrates all 4 phases
76
+ */
77
+ async process(filePath) {
78
+ // 1. INTERROGATION
79
+ const canProcess = await this.detect(filePath);
80
+ if (!canProcess) {
81
+ throw new Error(`Cannot process file: ${filePath}`);
82
+ }
83
+ // 2. EXTRACTION
84
+ const raw = await this.extract(filePath);
85
+ // 3. FILTERING
86
+ const structured = await this.filter(raw);
87
+ // 4. GENERATION
88
+ const fafContent = this.generate(structured);
89
+ return fafContent;
90
+ }
91
+ /**
92
+ * Helper: Convert structured intelligence → YAML
93
+ */
94
+ toYAML(intelligence) {
95
+ const yaml = require('yaml');
96
+ return yaml.stringify(intelligence);
97
+ }
98
+ /**
99
+ * Helper: Calculate quality scores
100
+ *
101
+ * Used in FILTERING phase
102
+ */
103
+ calculateScores(data) {
104
+ // Count filled fields
105
+ let totalSlots = 0;
106
+ let filledSlots = 0;
107
+ // Project slots (required)
108
+ totalSlots += 3; // name, type, goal
109
+ if (data.project?.name)
110
+ filledSlots++;
111
+ if (data.project?.type)
112
+ filledSlots++;
113
+ if (data.project?.goal)
114
+ filledSlots++;
115
+ // Human context slots (6 W's - critical)
116
+ totalSlots += 6;
117
+ if (data.human_context?.who)
118
+ filledSlots++;
119
+ if (data.human_context?.what)
120
+ filledSlots++;
121
+ if (data.human_context?.why)
122
+ filledSlots++;
123
+ if (data.human_context?.where)
124
+ filledSlots++;
125
+ if (data.human_context?.when)
126
+ filledSlots++;
127
+ if (data.human_context?.how)
128
+ filledSlots++;
129
+ // Architecture slots (if applicable)
130
+ if (data.architecture) {
131
+ totalSlots += 2;
132
+ if (data.architecture.pattern)
133
+ filledSlots++;
134
+ if (data.architecture.components?.length)
135
+ filledSlots++;
136
+ }
137
+ // Tech stack slots (if applicable)
138
+ if (data.tech_stack && Object.keys(data.tech_stack).length > 0) {
139
+ totalSlots += Object.keys(data.tech_stack).length;
140
+ filledSlots += Object.values(data.tech_stack).filter(v => v).length;
141
+ }
142
+ const faf_score = Math.round((filledSlots / totalSlots) * 100);
143
+ return {
144
+ faf_score,
145
+ ai_compatibility_score: faf_score, // Aligned for now
146
+ completeness_score: faf_score, // Aligned for now
147
+ };
148
+ }
149
+ }
150
+ exports.UniversalIntelligenceGenerator = UniversalIntelligenceGenerator;
151
+ /**
152
+ * Example: n8n Workflow Intelligence Generator
153
+ *
154
+ * Extends the universal pattern for n8n-specific processing
155
+ */
156
+ class N8nIntelligenceGenerator extends UniversalIntelligenceGenerator {
157
+ async detect(filePath) {
158
+ // Check if file is n8n workflow JSON
159
+ const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
160
+ try {
161
+ const content = await fs.readFile(filePath, 'utf-8');
162
+ const json = JSON.parse(content);
163
+ return !!(json.nodes && json.connections);
164
+ }
165
+ catch {
166
+ return false;
167
+ }
168
+ }
169
+ async extract(filePath) {
170
+ // Use existing n8n analyzer (compiled in dist)
171
+ const { N8nWorkflowAnalyzer } = await Promise.resolve().then(() => __importStar(require('../../dist/enrichment/n8n-analyzer')));
172
+ const workflow = await N8nWorkflowAnalyzer.parse(filePath);
173
+ const pattern = N8nWorkflowAnalyzer.detectPattern(workflow);
174
+ return {
175
+ data: {
176
+ workflow,
177
+ pattern,
178
+ aiModels: N8nWorkflowAnalyzer.extractAIModels(workflow),
179
+ infrastructure: N8nWorkflowAnalyzer.extractInfrastructure(workflow),
180
+ triggers: N8nWorkflowAnalyzer.extractTriggers(workflow),
181
+ nodes: N8nWorkflowAnalyzer.groupNodes(workflow),
182
+ tools: N8nWorkflowAnalyzer.extractToolCapabilities(workflow),
183
+ decisionPoints: N8nWorkflowAnalyzer.extractDecisionPoints(workflow),
184
+ memory: N8nWorkflowAnalyzer.extractMemoryRequirements(workflow),
185
+ },
186
+ confidence: 95,
187
+ metadata: {
188
+ source_type: 'n8n-workflow',
189
+ source_file: filePath,
190
+ extracted_at: new Date().toISOString(),
191
+ },
192
+ };
193
+ }
194
+ async filter(raw) {
195
+ const { workflow, pattern, aiModels, infrastructure } = raw.data;
196
+ // Use existing n8n-faf-generator for RICH transformation
197
+ // This already does: questions → auto-correct → 6 W's filling
198
+ const { N8nFafGenerator } = await Promise.resolve().then(() => __importStar(require('../../dist/enrichment/n8n-faf-generator')));
199
+ const generator = new N8nFafGenerator();
200
+ // Generate full .faf (includes human context enrichment)
201
+ // NOTE: N8nFafGenerator.generate() returns FILE PATH, not content
202
+ const outputPath = await generator.generate({
203
+ workflowFile: raw.metadata.source_file,
204
+ quiet: true, // Quiet mode for tests
205
+ });
206
+ // Read the generated file
207
+ const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
208
+ const fafYAML = await fs.readFile(outputPath, 'utf-8');
209
+ // Parse back to structured format
210
+ const yaml = require('yaml');
211
+ const structured = yaml.parse(fafYAML);
212
+ return structured;
213
+ }
214
+ }
215
+ exports.N8nIntelligenceGenerator = N8nIntelligenceGenerator;
216
+ /**
217
+ * Example: OpenAI Assistant Intelligence Generator
218
+ *
219
+ * Same universal pattern, different input adapter
220
+ */
221
+ class OpenAIAssistantGenerator extends UniversalIntelligenceGenerator {
222
+ async detect(filePath) {
223
+ // Detect OpenAI Assistant config (OpenAPI 3.1.0 schema)
224
+ const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
225
+ try {
226
+ const content = await fs.readFile(filePath, 'utf-8');
227
+ const json = JSON.parse(content);
228
+ return !!(json.openapi && json.paths);
229
+ }
230
+ catch {
231
+ return false;
232
+ }
233
+ }
234
+ async extract(filePath) {
235
+ // Parse OpenAPI schema
236
+ const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
237
+ const content = await fs.readFile(filePath, 'utf-8');
238
+ const schema = JSON.parse(content);
239
+ return {
240
+ data: {
241
+ schema,
242
+ actions: this.extractActions(schema),
243
+ tools: this.extractTools(schema),
244
+ },
245
+ confidence: 90,
246
+ metadata: {
247
+ source_type: 'openai-assistant',
248
+ source_file: filePath,
249
+ extracted_at: new Date().toISOString(),
250
+ },
251
+ };
252
+ }
253
+ async filter(raw) {
254
+ const { schema, actions, tools } = raw.data;
255
+ // Transform to universal .faf structure
256
+ const structured = {
257
+ project: {
258
+ name: schema.info?.title || 'OpenAI Assistant',
259
+ type: 'openai-assistant',
260
+ goal: schema.info?.description || 'AI assistant with custom actions',
261
+ },
262
+ architecture: {
263
+ pattern: 'AI Assistant',
264
+ components: actions.map((a) => a.name),
265
+ },
266
+ tech_stack: {
267
+ platform: 'OpenAI Assistants API',
268
+ schema_version: schema.openapi,
269
+ },
270
+ human_context: {
271
+ who: 'AI Assistant Developer',
272
+ what: schema.info?.title || 'OpenAI Assistant',
273
+ why: schema.info?.description || 'Custom AI assistant functionality',
274
+ where: 'OpenAI Platform',
275
+ when: 'Production',
276
+ how: `OpenAPI schema with ${actions.length} custom actions`,
277
+ },
278
+ source_data: raw.data,
279
+ scores: this.calculateScores({
280
+ project: {
281
+ name: schema.info?.title,
282
+ type: 'openai-assistant',
283
+ goal: schema.info?.description,
284
+ },
285
+ human_context: {
286
+ who: 'AI Assistant Developer',
287
+ what: schema.info?.title,
288
+ why: schema.info?.description,
289
+ where: 'OpenAI Platform',
290
+ when: 'Production',
291
+ how: `OpenAPI schema with ${actions.length} custom actions`,
292
+ },
293
+ }),
294
+ generated: new Date().toISOString(),
295
+ faf_version: '3.0.1',
296
+ };
297
+ return structured;
298
+ }
299
+ extractActions(schema) {
300
+ const actions = [];
301
+ for (const [path, methods] of Object.entries(schema.paths || {})) {
302
+ for (const [method, details] of Object.entries(methods)) {
303
+ actions.push({
304
+ name: details.operationId || `${method.toUpperCase()} ${path}`,
305
+ path,
306
+ method,
307
+ description: details.description,
308
+ });
309
+ }
310
+ }
311
+ return actions;
312
+ }
313
+ extractTools(schema) {
314
+ // Extract tool names from action IDs
315
+ return this.extractActions(schema).map(a => a.name);
316
+ }
317
+ }
318
+ exports.OpenAIAssistantGenerator = OpenAIAssistantGenerator;
319
+ /**
320
+ * Factory: Auto-detect and return appropriate generator
321
+ */
322
+ async function createGenerator(filePath) {
323
+ // Import all platform adapters
324
+ const { OpalMiniAppGenerator, MakeScenarioGenerator, CodeProjectGenerator, } = await Promise.resolve().then(() => __importStar(require('./platform-adapters')));
325
+ const generators = [
326
+ // Automation platforms
327
+ new N8nIntelligenceGenerator(),
328
+ new OpalMiniAppGenerator(),
329
+ new MakeScenarioGenerator(),
330
+ // AI assistants
331
+ new OpenAIAssistantGenerator(),
332
+ // Code projects (fallback)
333
+ new CodeProjectGenerator(),
334
+ ];
335
+ for (const generator of generators) {
336
+ if (await generator.detect(filePath)) {
337
+ return generator;
338
+ }
339
+ }
340
+ return null;
341
+ }
342
+ /**
343
+ * Main entry point: Process any file → .faf
344
+ */
345
+ async function generateFafFromAny(filePath) {
346
+ const generator = await createGenerator(filePath);
347
+ if (!generator) {
348
+ throw new Error(`No generator found for file: ${filePath}`);
349
+ }
350
+ return generator.process(filePath);
351
+ }
352
+ //# sourceMappingURL=universal-intelligence-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"universal-intelligence-generator.js","sourceRoot":"","sources":["../../src/core/universal-intelligence-generator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsYH,0CA4BC;AAKD,gDAQC;AA5WD;;;;GAIG;AACH,MAAsB,8BAA8B;IAmClD;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAoC;QAC3C,4BAA4B;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,mBAAmB;QACnB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,gBAAgB;QAChB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEzC,eAAe;QACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAE1C,gBAAgB;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE7C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACO,MAAM,CAAC,YAAoC;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACO,eAAe,CAAC,IAAqC;QAK7D,sBAAsB;QACtB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,2BAA2B;QAC3B,UAAU,IAAI,CAAC,CAAC,CAAC,mBAAmB;QACpC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI;YAAE,WAAW,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI;YAAE,WAAW,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI;YAAE,WAAW,EAAE,CAAC;QAEtC,yCAAyC;QACzC,UAAU,IAAI,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,aAAa,EAAE,GAAG;YAAE,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,aAAa,EAAE,IAAI;YAAE,WAAW,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,aAAa,EAAE,GAAG;YAAE,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,aAAa,EAAE,KAAK;YAAE,WAAW,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,aAAa,EAAE,IAAI;YAAE,WAAW,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,aAAa,EAAE,GAAG;YAAE,WAAW,EAAE,CAAC;QAE3C,qCAAqC;QACrC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,UAAU,IAAI,CAAC,CAAC;YAChB,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO;gBAAE,WAAW,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM;gBAAE,WAAW,EAAE,CAAC;QAC1D,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;YAClD,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACtE,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;QAE/D,OAAO;YACL,SAAS;YACT,sBAAsB,EAAE,SAAS,EAAE,kBAAkB;YACrD,kBAAkB,EAAE,SAAS,EAAM,kBAAkB;SACtD,CAAC;IACJ,CAAC;CACF;AAlID,wEAkIC;AAED;;;;GAIG;AACH,MAAa,wBAAyB,SAAQ,8BAA8B;IAE1E,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,qCAAqC;QACrC,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,+CAA+C;QAC/C,MAAM,EAAE,mBAAmB,EAAE,GAAG,wDAAa,oCAAoC,GAAC,CAAC;QACnF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE5D,OAAO;YACL,IAAI,EAAE;gBACJ,QAAQ;gBACR,OAAO;gBACP,QAAQ,EAAE,mBAAmB,CAAC,eAAe,CAAC,QAAQ,CAAC;gBACvD,cAAc,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,QAAQ,CAAC;gBACnE,QAAQ,EAAE,mBAAmB,CAAC,eAAe,CAAC,QAAQ,CAAC;gBACvD,KAAK,EAAE,mBAAmB,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAC/C,KAAK,EAAE,mBAAmB,CAAC,uBAAuB,CAAC,QAAQ,CAAC;gBAC5D,cAAc,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,QAAQ,CAAC;gBACnE,MAAM,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,QAAQ,CAAC;aAChE;YACD,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR,WAAW,EAAE,cAAc;gBAC3B,WAAW,EAAE,QAAQ;gBACrB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAoB;QAC/B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QAEjE,yDAAyD;QACzD,8DAA8D;QAC9D,MAAM,EAAE,eAAe,EAAE,GAAG,wDAAa,yCAAyC,GAAC,CAAC;QACpF,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QAExC,yDAAyD;QACzD,kEAAkE;QAClE,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;YAC1C,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,WAAW;YACtC,KAAK,EAAE,IAAI,EAAE,uBAAuB;SACrC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEvD,kCAAkC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEvC,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAlED,4DAkEC;AAED;;;;GAIG;AACH,MAAa,wBAAyB,SAAQ,8BAA8B;IAE1E,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,wDAAwD;QACxD,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,uBAAuB;QACvB,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM;gBACN,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;gBACpC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;aACjC;YACD,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR,WAAW,EAAE,kBAAkB;gBAC/B,WAAW,EAAE,QAAQ;gBACrB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAoB;QAC/B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QAE5C,wCAAwC;QACxC,MAAM,UAAU,GAA2B;YACzC,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,kBAAkB;gBAC9C,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,kCAAkC;aACrE;YACD,YAAY,EAAE;gBACZ,OAAO,EAAE,cAAc;gBACvB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAC5C;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE,uBAAuB;gBACjC,cAAc,EAAE,MAAM,CAAC,OAAO;aAC/B;YACD,aAAa,EAAE;gBACb,GAAG,EAAE,wBAAwB;gBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,kBAAkB;gBAC9C,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,mCAAmC;gBACpE,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,YAAY;gBAClB,GAAG,EAAE,uBAAuB,OAAO,CAAC,MAAM,iBAAiB;aAC5D;YACD,WAAW,EAAE,GAAG,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;gBAC3B,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK;oBACxB,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW;iBAC/B;gBACD,aAAa,EAAE;oBACb,GAAG,EAAE,wBAAwB;oBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK;oBACxB,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW;oBAC7B,KAAK,EAAE,iBAAiB;oBACxB,IAAI,EAAE,YAAY;oBAClB,GAAG,EAAE,uBAAuB,OAAO,CAAC,MAAM,iBAAiB;iBAC5D;aACF,CAAC;YACF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,OAAO;SACrB,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,cAAc,CAAC,MAAW;QAChC,MAAM,OAAO,GAAU,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAc,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAG,OAAe,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE;oBACvE,IAAI;oBACJ,MAAM;oBACN,WAAW,EAAG,OAAe,CAAC,WAAW;iBAC1C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,YAAY,CAAC,MAAW;QAC9B,qCAAqC;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;CACF;AAvGD,4DAuGC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,+BAA+B;IAC/B,MAAM,EACJ,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,GAAG,wDAAa,qBAAqB,GAAC,CAAC;IAExC,MAAM,UAAU,GAAqC;QACnD,uBAAuB;QACvB,IAAI,wBAAwB,EAAE;QAC9B,IAAI,oBAAoB,EAAE;QAC1B,IAAI,qBAAqB,EAAE;QAE3B,gBAAgB;QAChB,IAAI,wBAAwB,EAAE;QAE9B,2BAA2B;QAC3B,IAAI,oBAAoB,EAAE;KAC3B,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * n8n Integration Detector
3
+ *
4
+ * Detects n8n workflow automation usage and generates n8n-optimized .faf context
5
+ *
6
+ * n8n-mcp ecosystem: 87k/week + 314k/week (n8n-nodes-mcp) = 401k total reach
7
+ */
8
+ import { IntegrationDetector } from '../types.js';
9
+ export declare const n8nDetector: IntegrationDetector;
10
+ //# sourceMappingURL=n8n.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n.d.ts","sourceRoot":"","sources":["../../../src/family/detectors/n8n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAW,MAAM,aAAa,CAAC;AAI3D,eAAO,MAAM,WAAW,EAAE,mBAyFzB,CAAC"}
@@ -0,0 +1,95 @@
1
+ "use strict";
2
+ /**
3
+ * n8n Integration Detector
4
+ *
5
+ * Detects n8n workflow automation usage and generates n8n-optimized .faf context
6
+ *
7
+ * n8n-mcp ecosystem: 87k/week + 314k/week (n8n-nodes-mcp) = 401k total reach
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.n8nDetector = void 0;
11
+ const fs_1 = require("fs");
12
+ const path_1 = require("path");
13
+ exports.n8nDetector = {
14
+ name: 'n8n',
15
+ displayName: 'n8n',
16
+ tier: 'gold', // Based on evaluation: n8n will score 90+
17
+ qualityScore: 92,
18
+ weeklyAdoption: 401_000, // 87k (n8n-mcp) + 314k (n8n-nodes-mcp)
19
+ mcpServers: ['n8n-mcp', 'n8n-nodes-mcp'],
20
+ contextContribution: ['automation_platform', 'workflow_engine', 'integration_layer', 'api_orchestration'],
21
+ detect(projectPath) {
22
+ const packageJsonPath = (0, path_1.join)(projectPath, 'package.json');
23
+ if (!(0, fs_1.existsSync)(packageJsonPath)) {
24
+ return false;
25
+ }
26
+ try {
27
+ const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
28
+ const allDeps = {
29
+ ...packageJson.dependencies,
30
+ ...packageJson.devDependencies,
31
+ };
32
+ // Check for n8n core or n8n custom nodes
33
+ return 'n8n' in allDeps ||
34
+ Object.keys(allDeps).some(dep => dep.startsWith('n8n-nodes-'));
35
+ }
36
+ catch {
37
+ return false;
38
+ }
39
+ },
40
+ generateContext(projectPath) {
41
+ const packageJsonPath = (0, path_1.join)(projectPath, 'package.json');
42
+ let version = 'unknown';
43
+ let customNodes = [];
44
+ let hasTypeScript = false;
45
+ if ((0, fs_1.existsSync)(packageJsonPath)) {
46
+ try {
47
+ const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
48
+ const allDeps = {
49
+ ...packageJson.dependencies,
50
+ ...packageJson.devDependencies,
51
+ };
52
+ version = allDeps.n8n || 'latest';
53
+ hasTypeScript = 'typescript' in allDeps || '@types/node' in allDeps;
54
+ // Detect custom n8n nodes
55
+ customNodes = Object.keys(allDeps).filter(dep => dep.startsWith('n8n-nodes-'));
56
+ }
57
+ catch {
58
+ // Fallback to defaults
59
+ }
60
+ }
61
+ // Check for n8n configuration
62
+ const hasN8nConfig = (0, fs_1.existsSync)((0, path_1.join)(projectPath, '.n8n')) ||
63
+ (0, fs_1.existsSync)((0, path_1.join)(projectPath, 'n8n.config.json'));
64
+ return {
65
+ stack: {
66
+ automation_platform: `n8n ${version}`,
67
+ workflow_engine: 'n8n Workflow Automation',
68
+ integration_layer: customNodes.length > 0 ? 'Custom n8n Nodes' : 'Standard n8n Nodes',
69
+ api_orchestration: 'n8n API',
70
+ backend: 'n8n Server',
71
+ main_language: hasTypeScript ? 'TypeScript' : 'JavaScript',
72
+ },
73
+ project: {
74
+ automation: {
75
+ platform: 'n8n',
76
+ custom_nodes: customNodes.length,
77
+ node_packages: customNodes,
78
+ has_config: hasN8nConfig,
79
+ },
80
+ },
81
+ integration: {
82
+ framework: 'n8n',
83
+ mcp_servers: this.mcpServers,
84
+ recommended_tools: [
85
+ 'n8n-mcp for MCP workflow integration (87k weekly)',
86
+ 'n8n-nodes-mcp for custom node development (314k weekly)',
87
+ 'n8n Desktop for workflow management',
88
+ '@supabase/supabase-js for database integration (used by n8n-mcp)',
89
+ 'axios for HTTP requests (used by n8n-mcp)',
90
+ ],
91
+ },
92
+ };
93
+ },
94
+ };
95
+ //# sourceMappingURL=n8n.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n.js","sourceRoot":"","sources":["../../../src/family/detectors/n8n.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Next.js Integration Detector
3
+ *
4
+ * Detects Next.js usage and generates Next.js-optimized .faf context
5
+ */
6
+ import { IntegrationDetector } from '../types.js';
7
+ export declare const nextDetector: IntegrationDetector;
8
+ //# sourceMappingURL=next.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/family/detectors/next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAW,MAAM,aAAa,CAAC;AAI3D,eAAO,MAAM,YAAY,EAAE,mBAkF1B,CAAC"}
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ /**
3
+ * Next.js Integration Detector
4
+ *
5
+ * Detects Next.js usage and generates Next.js-optimized .faf context
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.nextDetector = void 0;
9
+ const fs_1 = require("fs");
10
+ const path_1 = require("path");
11
+ exports.nextDetector = {
12
+ name: 'next',
13
+ displayName: 'Next.js',
14
+ tier: 'trophy', // Based on evaluation: Next will score 99+
15
+ qualityScore: 99,
16
+ weeklyAdoption: 5_000_000, // ~5M weekly downloads
17
+ mcpServers: ['@vercel/mcp-server', '@nextjs/mcp-tools'],
18
+ contextContribution: ['frontend', 'backend', 'runtime', 'hosting', 'api_type'],
19
+ detect(projectPath) {
20
+ const packageJsonPath = (0, path_1.join)(projectPath, 'package.json');
21
+ if (!(0, fs_1.existsSync)(packageJsonPath)) {
22
+ return false;
23
+ }
24
+ try {
25
+ const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
26
+ const allDeps = {
27
+ ...packageJson.dependencies,
28
+ ...packageJson.devDependencies,
29
+ };
30
+ return 'next' in allDeps;
31
+ }
32
+ catch {
33
+ return false;
34
+ }
35
+ },
36
+ generateContext(projectPath) {
37
+ const packageJsonPath = (0, path_1.join)(projectPath, 'package.json');
38
+ let version = 'unknown';
39
+ let hasAppRouter = false;
40
+ let hasTypeScript = false;
41
+ if ((0, fs_1.existsSync)(packageJsonPath)) {
42
+ try {
43
+ const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
44
+ const allDeps = {
45
+ ...packageJson.dependencies,
46
+ ...packageJson.devDependencies,
47
+ };
48
+ version = allDeps.next || 'latest';
49
+ hasTypeScript = 'typescript' in allDeps || '@types/node' in allDeps;
50
+ // Check if using App Router (Next 13+)
51
+ const versionNum = parseFloat(version.replace(/[^\d.]/g, ''));
52
+ hasAppRouter = versionNum >= 13;
53
+ }
54
+ catch {
55
+ // Fallback to defaults
56
+ }
57
+ }
58
+ // Check for app directory
59
+ const appDirExists = (0, fs_1.existsSync)((0, path_1.join)(projectPath, 'app'));
60
+ return {
61
+ stack: {
62
+ frontend: `Next.js ${version}`,
63
+ backend: 'Next.js API Routes',
64
+ runtime: 'Node.js (Vercel Edge Runtime compatible)',
65
+ build: 'Next.js Compiler (Turbopack/Webpack)',
66
+ api_type: 'REST/GraphQL',
67
+ hosting: 'Vercel (optimized)',
68
+ main_language: hasTypeScript ? 'TypeScript' : 'JavaScript',
69
+ },
70
+ project: {
71
+ architecture: appDirExists || hasAppRouter ? 'App Router' : 'Pages Router',
72
+ },
73
+ integration: {
74
+ framework: 'next',
75
+ mcp_servers: this.mcpServers,
76
+ recommended_tools: [
77
+ '@vercel/mcp-server for deployment and analytics',
78
+ 'Next.js DevTools',
79
+ 'Vercel CLI for local development',
80
+ 'React Developer Tools',
81
+ ],
82
+ },
83
+ };
84
+ },
85
+ };
86
+ //# sourceMappingURL=next.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"next.js","sourceRoot":"","sources":["../../../src/family/detectors/next.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,2BAA8C;AAC9C,+BAA4B;AAEf,QAAA,YAAY,GAAwB;IAC/C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,QAAQ,EAAE,2CAA2C;IAC3D,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,SAAS,EAAE,uBAAuB;IAClD,UAAU,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;IACvD,mBAAmB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;IAE9E,MAAM,CAAC,WAAmB;QACxB,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAE1D,IAAI,CAAC,IAAA,eAAU,EAAC,eAAe,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG;gBACd,GAAG,WAAW,CAAC,YAAY;gBAC3B,GAAG,WAAW,CAAC,eAAe;aAC/B,CAAC;YAEF,OAAO,MAAM,IAAI,OAAO,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,eAAe,CAAC,WAAmB;QACjC,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAC1D,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,IAAI,IAAA,eAAU,EAAC,eAAe,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvE,MAAM,OAAO,GAAG;oBACd,GAAG,WAAW,CAAC,YAAY;oBAC3B,GAAG,WAAW,CAAC,eAAe;iBAC/B,CAAC;gBAEF,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;gBACnC,aAAa,GAAG,YAAY,IAAI,OAAO,IAAI,aAAa,IAAI,OAAO,CAAC;gBAEpE,uCAAuC;gBACvC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC9D,YAAY,GAAG,UAAU,IAAI,EAAE,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,YAAY,GAAG,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QAE1D,OAAO;YACL,KAAK,EAAE;gBACL,QAAQ,EAAE,WAAW,OAAO,EAAE;gBAC9B,OAAO,EAAE,oBAAoB;gBAC7B,OAAO,EAAE,0CAA0C;gBACnD,KAAK,EAAE,sCAAsC;gBAC7C,QAAQ,EAAE,cAAc;gBACxB,OAAO,EAAE,oBAAoB;gBAC7B,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;aAC3D;YACD,OAAO,EAAE;gBACP,YAAY,EAAE,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc;aAC3E;YACD,WAAW,EAAE;gBACX,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,iBAAiB,EAAE;oBACjB,iDAAiD;oBACjD,kBAAkB;oBAClB,kCAAkC;oBAClC,uBAAuB;iBACxB;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * React Integration Detector
3
+ *
4
+ * Detects React usage and generates React-optimized .faf context
5
+ */
6
+ import { IntegrationDetector } from '../types.js';
7
+ export declare const reactDetector: IntegrationDetector;
8
+ //# sourceMappingURL=react.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/family/detectors/react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAW,MAAM,aAAa,CAAC;AAI3D,eAAO,MAAM,aAAa,EAAE,mBAmE3B,CAAC"}