@nahisaho/musubix-core 1.0.0

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 (214) hide show
  1. package/bin/musubix.js +18 -0
  2. package/dist/__tests__/index.test.d.ts +2 -0
  3. package/dist/__tests__/index.test.d.ts.map +1 -0
  4. package/dist/__tests__/index.test.js +27 -0
  5. package/dist/__tests__/index.test.js.map +1 -0
  6. package/dist/auth/auth-manager.d.ts +320 -0
  7. package/dist/auth/auth-manager.d.ts.map +1 -0
  8. package/dist/auth/auth-manager.js +580 -0
  9. package/dist/auth/auth-manager.js.map +1 -0
  10. package/dist/cli/base.d.ts +58 -0
  11. package/dist/cli/base.d.ts.map +1 -0
  12. package/dist/cli/base.js +93 -0
  13. package/dist/cli/base.js.map +1 -0
  14. package/dist/cli/commands/help.d.ts +17 -0
  15. package/dist/cli/commands/help.d.ts.map +1 -0
  16. package/dist/cli/commands/help.js +228 -0
  17. package/dist/cli/commands/help.js.map +1 -0
  18. package/dist/cli/commands/index.d.ts +14 -0
  19. package/dist/cli/commands/index.d.ts.map +1 -0
  20. package/dist/cli/commands/index.js +25 -0
  21. package/dist/cli/commands/index.js.map +1 -0
  22. package/dist/cli/commands/init.d.ts +38 -0
  23. package/dist/cli/commands/init.d.ts.map +1 -0
  24. package/dist/cli/commands/init.js +258 -0
  25. package/dist/cli/commands/init.js.map +1 -0
  26. package/dist/cli/index.d.ts +9 -0
  27. package/dist/cli/index.d.ts.map +1 -0
  28. package/dist/cli/index.js +9 -0
  29. package/dist/cli/index.js.map +1 -0
  30. package/dist/codegen/coding-standards.d.ts +250 -0
  31. package/dist/codegen/coding-standards.d.ts.map +1 -0
  32. package/dist/codegen/coding-standards.js +976 -0
  33. package/dist/codegen/coding-standards.js.map +1 -0
  34. package/dist/codegen/coverage-reporter.d.ts +264 -0
  35. package/dist/codegen/coverage-reporter.d.ts.map +1 -0
  36. package/dist/codegen/coverage-reporter.js +697 -0
  37. package/dist/codegen/coverage-reporter.js.map +1 -0
  38. package/dist/codegen/dependency-analyzer.d.ts +271 -0
  39. package/dist/codegen/dependency-analyzer.d.ts.map +1 -0
  40. package/dist/codegen/dependency-analyzer.js +661 -0
  41. package/dist/codegen/dependency-analyzer.js.map +1 -0
  42. package/dist/codegen/generator.d.ts +275 -0
  43. package/dist/codegen/generator.d.ts.map +1 -0
  44. package/dist/codegen/generator.js +781 -0
  45. package/dist/codegen/generator.js.map +1 -0
  46. package/dist/codegen/index.d.ts +18 -0
  47. package/dist/codegen/index.d.ts.map +1 -0
  48. package/dist/codegen/index.js +27 -0
  49. package/dist/codegen/index.js.map +1 -0
  50. package/dist/codegen/integration-test-generator.d.ts +312 -0
  51. package/dist/codegen/integration-test-generator.d.ts.map +1 -0
  52. package/dist/codegen/integration-test-generator.js +765 -0
  53. package/dist/codegen/integration-test-generator.js.map +1 -0
  54. package/dist/codegen/pattern-conformance.d.ts +309 -0
  55. package/dist/codegen/pattern-conformance.d.ts.map +1 -0
  56. package/dist/codegen/pattern-conformance.js +590 -0
  57. package/dist/codegen/pattern-conformance.js.map +1 -0
  58. package/dist/codegen/quality-metrics.d.ts +235 -0
  59. package/dist/codegen/quality-metrics.d.ts.map +1 -0
  60. package/dist/codegen/quality-metrics.js +439 -0
  61. package/dist/codegen/quality-metrics.js.map +1 -0
  62. package/dist/codegen/security-scanner.d.ts +179 -0
  63. package/dist/codegen/security-scanner.d.ts.map +1 -0
  64. package/dist/codegen/security-scanner.js +495 -0
  65. package/dist/codegen/security-scanner.js.map +1 -0
  66. package/dist/codegen/static-analyzer.d.ts +188 -0
  67. package/dist/codegen/static-analyzer.d.ts.map +1 -0
  68. package/dist/codegen/static-analyzer.js +490 -0
  69. package/dist/codegen/static-analyzer.js.map +1 -0
  70. package/dist/codegen/unit-test-generator.d.ts +289 -0
  71. package/dist/codegen/unit-test-generator.d.ts.map +1 -0
  72. package/dist/codegen/unit-test-generator.js +634 -0
  73. package/dist/codegen/unit-test-generator.js.map +1 -0
  74. package/dist/design/adr-generator.d.ts +227 -0
  75. package/dist/design/adr-generator.d.ts.map +1 -0
  76. package/dist/design/adr-generator.js +423 -0
  77. package/dist/design/adr-generator.js.map +1 -0
  78. package/dist/design/c4-generator.d.ts +267 -0
  79. package/dist/design/c4-generator.d.ts.map +1 -0
  80. package/dist/design/c4-generator.js +453 -0
  81. package/dist/design/c4-generator.js.map +1 -0
  82. package/dist/design/framework-optimizer.d.ts +190 -0
  83. package/dist/design/framework-optimizer.d.ts.map +1 -0
  84. package/dist/design/framework-optimizer.js +589 -0
  85. package/dist/design/framework-optimizer.js.map +1 -0
  86. package/dist/design/index.d.ts +12 -0
  87. package/dist/design/index.d.ts.map +1 -0
  88. package/dist/design/index.js +13 -0
  89. package/dist/design/index.js.map +1 -0
  90. package/dist/design/pattern-detector.d.ts +270 -0
  91. package/dist/design/pattern-detector.d.ts.map +1 -0
  92. package/dist/design/pattern-detector.js +621 -0
  93. package/dist/design/pattern-detector.js.map +1 -0
  94. package/dist/design/solid-validator.d.ts +188 -0
  95. package/dist/design/solid-validator.d.ts.map +1 -0
  96. package/dist/design/solid-validator.js +579 -0
  97. package/dist/design/solid-validator.js.map +1 -0
  98. package/dist/error/data-persistence.d.ts +311 -0
  99. package/dist/error/data-persistence.d.ts.map +1 -0
  100. package/dist/error/data-persistence.js +586 -0
  101. package/dist/error/data-persistence.js.map +1 -0
  102. package/dist/error/graceful-degradation.d.ts +309 -0
  103. package/dist/error/graceful-degradation.d.ts.map +1 -0
  104. package/dist/error/graceful-degradation.js +510 -0
  105. package/dist/error/graceful-degradation.js.map +1 -0
  106. package/dist/error/index.d.ts +11 -0
  107. package/dist/error/index.d.ts.map +1 -0
  108. package/dist/error/index.js +19 -0
  109. package/dist/error/index.js.map +1 -0
  110. package/dist/explanation/explanation-generator.d.ts +228 -0
  111. package/dist/explanation/explanation-generator.d.ts.map +1 -0
  112. package/dist/explanation/explanation-generator.js +662 -0
  113. package/dist/explanation/explanation-generator.js.map +1 -0
  114. package/dist/explanation/index.d.ts +11 -0
  115. package/dist/explanation/index.d.ts.map +1 -0
  116. package/dist/explanation/index.js +19 -0
  117. package/dist/explanation/index.js.map +1 -0
  118. package/dist/explanation/reasoning-chain.d.ts +314 -0
  119. package/dist/explanation/reasoning-chain.d.ts.map +1 -0
  120. package/dist/explanation/reasoning-chain.js +414 -0
  121. package/dist/explanation/reasoning-chain.js.map +1 -0
  122. package/dist/explanation/visual-explanation.d.ts +315 -0
  123. package/dist/explanation/visual-explanation.d.ts.map +1 -0
  124. package/dist/explanation/visual-explanation.js +667 -0
  125. package/dist/explanation/visual-explanation.js.map +1 -0
  126. package/dist/index.d.ts +33 -0
  127. package/dist/index.d.ts.map +1 -0
  128. package/dist/index.js +47 -0
  129. package/dist/index.js.map +1 -0
  130. package/dist/requirements/decomposer.d.ts +235 -0
  131. package/dist/requirements/decomposer.d.ts.map +1 -0
  132. package/dist/requirements/decomposer.js +587 -0
  133. package/dist/requirements/decomposer.js.map +1 -0
  134. package/dist/requirements/related-finder.d.ts +261 -0
  135. package/dist/requirements/related-finder.d.ts.map +1 -0
  136. package/dist/requirements/related-finder.js +629 -0
  137. package/dist/requirements/related-finder.js.map +1 -0
  138. package/dist/traceability/impact.d.ts +196 -0
  139. package/dist/traceability/impact.d.ts.map +1 -0
  140. package/dist/traceability/impact.js +438 -0
  141. package/dist/traceability/impact.js.map +1 -0
  142. package/dist/traceability/index.d.ts +9 -0
  143. package/dist/traceability/index.d.ts.map +1 -0
  144. package/dist/traceability/index.js +10 -0
  145. package/dist/traceability/index.js.map +1 -0
  146. package/dist/traceability/manager.d.ts +266 -0
  147. package/dist/traceability/manager.d.ts.map +1 -0
  148. package/dist/traceability/manager.js +412 -0
  149. package/dist/traceability/manager.js.map +1 -0
  150. package/dist/types/common.d.ts +294 -0
  151. package/dist/types/common.d.ts.map +1 -0
  152. package/dist/types/common.js +15 -0
  153. package/dist/types/common.js.map +1 -0
  154. package/dist/types/ears.d.ts +158 -0
  155. package/dist/types/ears.d.ts.map +1 -0
  156. package/dist/types/ears.js +33 -0
  157. package/dist/types/ears.js.map +1 -0
  158. package/dist/types/errors.d.ts +176 -0
  159. package/dist/types/errors.d.ts.map +1 -0
  160. package/dist/types/errors.js +55 -0
  161. package/dist/types/errors.js.map +1 -0
  162. package/dist/types/index.d.ts +10 -0
  163. package/dist/types/index.d.ts.map +1 -0
  164. package/dist/types/index.js +10 -0
  165. package/dist/types/index.js.map +1 -0
  166. package/dist/utils/data-protector.d.ts +122 -0
  167. package/dist/utils/data-protector.d.ts.map +1 -0
  168. package/dist/utils/data-protector.js +275 -0
  169. package/dist/utils/data-protector.js.map +1 -0
  170. package/dist/utils/error-handler.d.ts +101 -0
  171. package/dist/utils/error-handler.d.ts.map +1 -0
  172. package/dist/utils/error-handler.js +324 -0
  173. package/dist/utils/error-handler.js.map +1 -0
  174. package/dist/utils/i18n-manager.d.ts +259 -0
  175. package/dist/utils/i18n-manager.d.ts.map +1 -0
  176. package/dist/utils/i18n-manager.js +554 -0
  177. package/dist/utils/i18n-manager.js.map +1 -0
  178. package/dist/utils/index.d.ts +10 -0
  179. package/dist/utils/index.d.ts.map +1 -0
  180. package/dist/utils/index.js +10 -0
  181. package/dist/utils/index.js.map +1 -0
  182. package/dist/utils/logger.d.ts +120 -0
  183. package/dist/utils/logger.d.ts.map +1 -0
  184. package/dist/utils/logger.js +237 -0
  185. package/dist/utils/logger.js.map +1 -0
  186. package/dist/utils/performance-profiler.d.ts +251 -0
  187. package/dist/utils/performance-profiler.d.ts.map +1 -0
  188. package/dist/utils/performance-profiler.js +458 -0
  189. package/dist/utils/performance-profiler.js.map +1 -0
  190. package/dist/utils/scalability-optimizer.d.ts +294 -0
  191. package/dist/utils/scalability-optimizer.d.ts.map +1 -0
  192. package/dist/utils/scalability-optimizer.js +606 -0
  193. package/dist/utils/scalability-optimizer.js.map +1 -0
  194. package/dist/utils/structured-logger.d.ts +294 -0
  195. package/dist/utils/structured-logger.d.ts.map +1 -0
  196. package/dist/utils/structured-logger.js +630 -0
  197. package/dist/utils/structured-logger.js.map +1 -0
  198. package/dist/utils/version-compatibility.d.ts +217 -0
  199. package/dist/utils/version-compatibility.d.ts.map +1 -0
  200. package/dist/utils/version-compatibility.js +443 -0
  201. package/dist/utils/version-compatibility.js.map +1 -0
  202. package/dist/validators/ears-validator.d.ts +182 -0
  203. package/dist/validators/ears-validator.d.ts.map +1 -0
  204. package/dist/validators/ears-validator.js +357 -0
  205. package/dist/validators/ears-validator.js.map +1 -0
  206. package/dist/validators/index.d.ts +8 -0
  207. package/dist/validators/index.d.ts.map +1 -0
  208. package/dist/validators/index.js +9 -0
  209. package/dist/validators/index.js.map +1 -0
  210. package/dist/version.d.ts +8 -0
  211. package/dist/version.d.ts.map +1 -0
  212. package/dist/version.js +8 -0
  213. package/dist/version.js.map +1 -0
  214. package/package.json +100 -0
@@ -0,0 +1,453 @@
1
+ /**
2
+ * C4 Model Generator
3
+ *
4
+ * Generates C4 architecture diagrams from design specifications
5
+ *
6
+ * @packageDocumentation
7
+ * @module design/c4-generator
8
+ *
9
+ * @see REQ-DES-004 - C4 Model Generation
10
+ * @see Article IV - Design-Implementation Consistency
11
+ */
12
+ /**
13
+ * Default configuration
14
+ */
15
+ export const DEFAULT_C4_CONFIG = {
16
+ outputFormat: 'mermaid',
17
+ includeAllLevels: true,
18
+ includeCodeLevel: false,
19
+ autoDetectContainers: true,
20
+ };
21
+ /**
22
+ * Default style
23
+ */
24
+ export const DEFAULT_C4_STYLE = {
25
+ personColor: '#08427B',
26
+ softwareSystemColor: '#1168BD',
27
+ containerColor: '#438DD5',
28
+ componentColor: '#85BBF0',
29
+ externalColor: '#999999',
30
+ databaseColor: '#438DD5',
31
+ };
32
+ /**
33
+ * C4 Model Generator
34
+ */
35
+ export class C4ModelGenerator {
36
+ config;
37
+ elementCounter = 0;
38
+ relationshipCounter = 0;
39
+ constructor(config) {
40
+ this.config = { ...DEFAULT_C4_CONFIG, ...config };
41
+ }
42
+ /**
43
+ * Generate C4 model from design input
44
+ */
45
+ generate(input) {
46
+ const elements = [];
47
+ const relationships = [];
48
+ const diagrams = [];
49
+ // Create main system
50
+ const mainSystem = this.createElement('software-system', input.systemName, input.systemDescription);
51
+ elements.push(mainSystem);
52
+ // Create users
53
+ for (const user of input.users ?? []) {
54
+ const person = this.createElement('person', user.name, user.description);
55
+ elements.push(person);
56
+ // Add relationship to main system
57
+ relationships.push(this.createRelationship(person.id, mainSystem.id, 'uses', `Uses ${input.systemName}`));
58
+ }
59
+ // Create external systems
60
+ for (const ext of input.externalSystems ?? []) {
61
+ const system = this.createElement('software-system', ext.name, ext.description, { external: true });
62
+ elements.push(system);
63
+ }
64
+ // Create containers
65
+ const containerMap = new Map();
66
+ for (const container of input.containers ?? []) {
67
+ const element = this.createElement('container', container.name, container.description, {
68
+ technology: container.technology,
69
+ systemId: mainSystem.id,
70
+ tags: container.type ? [container.type] : undefined,
71
+ });
72
+ elements.push(element);
73
+ containerMap.set(container.name, element);
74
+ }
75
+ // Create components
76
+ for (const component of input.components ?? []) {
77
+ const container = containerMap.get(component.containerId);
78
+ const element = this.createElement('component', component.name, component.description, {
79
+ technology: component.technology,
80
+ containerId: container?.id,
81
+ });
82
+ elements.push(element);
83
+ }
84
+ // Create relationships from interactions
85
+ for (const interaction of input.interactions ?? []) {
86
+ const source = this.findElement(elements, interaction.from);
87
+ const target = this.findElement(elements, interaction.to);
88
+ if (source && target) {
89
+ relationships.push(this.createRelationship(source.id, target.id, 'uses', interaction.description, interaction.technology));
90
+ }
91
+ }
92
+ // Generate diagrams
93
+ diagrams.push(this.generateContextDiagram(mainSystem, elements, relationships));
94
+ if (this.config.includeAllLevels) {
95
+ diagrams.push(this.generateContainerDiagram(mainSystem, elements, relationships));
96
+ // Generate component diagrams for each container
97
+ for (const container of containerMap.values()) {
98
+ const componentElements = elements.filter((e) => e.type === 'component' && e.containerId === container.id);
99
+ if (componentElements.length > 0) {
100
+ diagrams.push(this.generateComponentDiagram(container, elements, relationships));
101
+ }
102
+ }
103
+ }
104
+ return {
105
+ id: `c4-model-${Date.now()}`,
106
+ name: input.systemName,
107
+ diagrams,
108
+ elements,
109
+ relationships,
110
+ generatedAt: new Date(),
111
+ };
112
+ }
113
+ /**
114
+ * Export diagram to specified format
115
+ */
116
+ export(diagram, format) {
117
+ const fmt = format ?? this.config.outputFormat;
118
+ switch (fmt) {
119
+ case 'structurizr':
120
+ return this.toStructurizr(diagram);
121
+ case 'plantuml':
122
+ return this.toPlantUML(diagram);
123
+ case 'mermaid':
124
+ return this.toMermaid(diagram);
125
+ case 'json':
126
+ return JSON.stringify(diagram, null, 2);
127
+ default:
128
+ return this.toMermaid(diagram);
129
+ }
130
+ }
131
+ /**
132
+ * Export entire model
133
+ */
134
+ exportModel(model, format) {
135
+ const outputs = [];
136
+ for (const diagram of model.diagrams) {
137
+ outputs.push(`// ${diagram.title}\n${this.export(diagram, format)}`);
138
+ }
139
+ return outputs.join('\n\n');
140
+ }
141
+ /**
142
+ * Generate context diagram
143
+ */
144
+ generateContextDiagram(mainSystem, elements, relationships) {
145
+ // Include persons, external systems, and the main system
146
+ const contextElements = elements.filter((e) => e.type === 'person' || e.type === 'software-system');
147
+ // Include relationships between context elements
148
+ const contextRelationships = relationships.filter((r) => contextElements.some((e) => e.id === r.sourceId) &&
149
+ contextElements.some((e) => e.id === r.targetId));
150
+ return {
151
+ id: `context-${mainSystem.id}`,
152
+ title: `System Context: ${mainSystem.name}`,
153
+ level: 'context',
154
+ scope: mainSystem.id,
155
+ elements: contextElements,
156
+ relationships: contextRelationships,
157
+ description: `System context diagram for ${mainSystem.name}`,
158
+ generatedAt: new Date(),
159
+ };
160
+ }
161
+ /**
162
+ * Generate container diagram
163
+ */
164
+ generateContainerDiagram(mainSystem, elements, relationships) {
165
+ // Include persons, containers of main system, and external systems
166
+ const containerElements = elements.filter((e) => e.type === 'person' ||
167
+ (e.type === 'software-system' && e.external) ||
168
+ (e.type === 'container' && e.systemId === mainSystem.id));
169
+ const containerRelationships = relationships.filter((r) => containerElements.some((e) => e.id === r.sourceId) &&
170
+ containerElements.some((e) => e.id === r.targetId));
171
+ return {
172
+ id: `container-${mainSystem.id}`,
173
+ title: `Container: ${mainSystem.name}`,
174
+ level: 'container',
175
+ scope: mainSystem.id,
176
+ elements: containerElements,
177
+ relationships: containerRelationships,
178
+ description: `Container diagram for ${mainSystem.name}`,
179
+ generatedAt: new Date(),
180
+ };
181
+ }
182
+ /**
183
+ * Generate component diagram
184
+ */
185
+ generateComponentDiagram(container, elements, relationships) {
186
+ // Include components of this container and related elements
187
+ const componentElements = elements.filter((e) => (e.type === 'component' && e.containerId === container.id) ||
188
+ (e.type === 'container' && e.id !== container.id));
189
+ const componentRelationships = relationships.filter((r) => componentElements.some((e) => e.id === r.sourceId) ||
190
+ componentElements.some((e) => e.id === r.targetId));
191
+ return {
192
+ id: `component-${container.id}`,
193
+ title: `Component: ${container.name}`,
194
+ level: 'component',
195
+ scope: container.id,
196
+ elements: componentElements,
197
+ relationships: componentRelationships,
198
+ description: `Component diagram for ${container.name}`,
199
+ generatedAt: new Date(),
200
+ };
201
+ }
202
+ /**
203
+ * Create an element
204
+ */
205
+ createElement(type, name, description, options) {
206
+ return {
207
+ id: `el-${++this.elementCounter}`,
208
+ type,
209
+ name,
210
+ description,
211
+ ...options,
212
+ };
213
+ }
214
+ /**
215
+ * Create a relationship
216
+ */
217
+ createRelationship(sourceId, targetId, type, description, technology) {
218
+ return {
219
+ id: `rel-${++this.relationshipCounter}`,
220
+ sourceId,
221
+ targetId,
222
+ type,
223
+ description,
224
+ technology,
225
+ };
226
+ }
227
+ /**
228
+ * Find element by name
229
+ */
230
+ findElement(elements, name) {
231
+ return elements.find((e) => e.name === name || e.id === name);
232
+ }
233
+ /**
234
+ * Export to Structurizr DSL
235
+ */
236
+ toStructurizr(diagram) {
237
+ const lines = [];
238
+ lines.push(`workspace "${diagram.title}" {`);
239
+ lines.push(' model {');
240
+ // Elements
241
+ for (const element of diagram.elements) {
242
+ const ext = element.external ? ' "External"' : '';
243
+ switch (element.type) {
244
+ case 'person':
245
+ lines.push(` ${this.sanitizeId(element.name)} = person "${element.name}" "${element.description}"${ext}`);
246
+ break;
247
+ case 'software-system':
248
+ lines.push(` ${this.sanitizeId(element.name)} = softwareSystem "${element.name}" "${element.description}"${ext}`);
249
+ break;
250
+ case 'container':
251
+ lines.push(` ${this.sanitizeId(element.name)} = container "${element.name}" "${element.description}" "${element.technology ?? ''}"`);
252
+ break;
253
+ case 'component':
254
+ lines.push(` ${this.sanitizeId(element.name)} = component "${element.name}" "${element.description}" "${element.technology ?? ''}"`);
255
+ break;
256
+ }
257
+ }
258
+ // Relationships
259
+ for (const rel of diagram.relationships) {
260
+ const source = diagram.elements.find((e) => e.id === rel.sourceId);
261
+ const target = diagram.elements.find((e) => e.id === rel.targetId);
262
+ if (source && target) {
263
+ const tech = rel.technology ? ` "${rel.technology}"` : '';
264
+ lines.push(` ${this.sanitizeId(source.name)} -> ${this.sanitizeId(target.name)} "${rel.description}"${tech}`);
265
+ }
266
+ }
267
+ lines.push(' }');
268
+ lines.push(' views {');
269
+ lines.push(` ${diagram.level} ${this.sanitizeId(diagram.title)} {`);
270
+ lines.push(' include *');
271
+ lines.push(' autoLayout');
272
+ lines.push(' }');
273
+ lines.push(' }');
274
+ lines.push('}');
275
+ return lines.join('\n');
276
+ }
277
+ /**
278
+ * Export to PlantUML
279
+ */
280
+ toPlantUML(diagram) {
281
+ const lines = [];
282
+ lines.push('@startuml');
283
+ lines.push(`!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_${this.capitalizeFirst(diagram.level)}.puml`);
284
+ lines.push('');
285
+ lines.push(`title ${diagram.title}`);
286
+ lines.push('');
287
+ // Elements
288
+ for (const element of diagram.elements) {
289
+ const ext = element.external ? '_Ext' : '';
290
+ switch (element.type) {
291
+ case 'person':
292
+ lines.push(`Person${ext}(${this.sanitizeId(element.name)}, "${element.name}", "${element.description}")`);
293
+ break;
294
+ case 'software-system':
295
+ lines.push(`System${ext}(${this.sanitizeId(element.name)}, "${element.name}", "${element.description}")`);
296
+ break;
297
+ case 'container':
298
+ const containerType = this.getPlantUMLContainerType(element);
299
+ lines.push(`${containerType}(${this.sanitizeId(element.name)}, "${element.name}", "${element.technology ?? ''}", "${element.description}")`);
300
+ break;
301
+ case 'component':
302
+ lines.push(`Component(${this.sanitizeId(element.name)}, "${element.name}", "${element.technology ?? ''}", "${element.description}")`);
303
+ break;
304
+ }
305
+ }
306
+ lines.push('');
307
+ // Relationships
308
+ for (const rel of diagram.relationships) {
309
+ const source = diagram.elements.find((e) => e.id === rel.sourceId);
310
+ const target = diagram.elements.find((e) => e.id === rel.targetId);
311
+ if (source && target) {
312
+ const tech = rel.technology ? `, "${rel.technology}"` : '';
313
+ lines.push(`Rel(${this.sanitizeId(source.name)}, ${this.sanitizeId(target.name)}, "${rel.description}"${tech})`);
314
+ }
315
+ }
316
+ lines.push('');
317
+ lines.push('@enduml');
318
+ return lines.join('\n');
319
+ }
320
+ /**
321
+ * Export to Mermaid
322
+ */
323
+ toMermaid(diagram) {
324
+ const lines = [];
325
+ lines.push(`%% ${diagram.title}`);
326
+ lines.push('flowchart TB');
327
+ lines.push('');
328
+ // Group elements by type
329
+ const persons = diagram.elements.filter((e) => e.type === 'person');
330
+ const systems = diagram.elements.filter((e) => e.type === 'software-system' && !e.external);
331
+ const external = diagram.elements.filter((e) => e.type === 'software-system' && e.external);
332
+ const containers = diagram.elements.filter((e) => e.type === 'container');
333
+ const components = diagram.elements.filter((e) => e.type === 'component');
334
+ // Subgraph for persons
335
+ if (persons.length > 0) {
336
+ lines.push(' subgraph Users');
337
+ for (const p of persons) {
338
+ lines.push(` ${this.sanitizeId(p.name)}["👤 ${p.name}<br/>${p.description}"]`);
339
+ }
340
+ lines.push(' end');
341
+ lines.push('');
342
+ }
343
+ // Main system / containers
344
+ if (containers.length > 0) {
345
+ const mainSystem = systems[0];
346
+ lines.push(` subgraph ${this.sanitizeId(mainSystem?.name ?? 'System')}["${mainSystem?.name ?? 'System'}"]`);
347
+ for (const c of containers) {
348
+ const icon = this.getMermaidIcon(c);
349
+ lines.push(` ${this.sanitizeId(c.name)}["${icon} ${c.name}<br/>${c.technology ?? ''}<br/>${c.description}"]`);
350
+ }
351
+ lines.push(' end');
352
+ lines.push('');
353
+ }
354
+ else if (systems.length > 0) {
355
+ for (const s of systems) {
356
+ lines.push(` ${this.sanitizeId(s.name)}["🖥️ ${s.name}<br/>${s.description}"]`);
357
+ }
358
+ lines.push('');
359
+ }
360
+ // Components
361
+ if (components.length > 0) {
362
+ // Group by container
363
+ const byContainer = new Map();
364
+ for (const c of components) {
365
+ const key = c.containerId ?? 'unknown';
366
+ if (!byContainer.has(key))
367
+ byContainer.set(key, []);
368
+ byContainer.get(key).push(c);
369
+ }
370
+ for (const [containerId, comps] of byContainer) {
371
+ const container = diagram.elements.find((e) => e.id === containerId);
372
+ lines.push(` subgraph ${containerId}["${container?.name ?? containerId}"]`);
373
+ for (const c of comps) {
374
+ lines.push(` ${this.sanitizeId(c.name)}["📦 ${c.name}<br/>${c.description}"]`);
375
+ }
376
+ lines.push(' end');
377
+ }
378
+ lines.push('');
379
+ }
380
+ // External systems
381
+ if (external.length > 0) {
382
+ lines.push(' subgraph External["External Systems"]');
383
+ for (const e of external) {
384
+ lines.push(` ${this.sanitizeId(e.name)}["🌐 ${e.name}<br/>${e.description}"]`);
385
+ }
386
+ lines.push(' end');
387
+ lines.push('');
388
+ }
389
+ // Relationships
390
+ for (const rel of diagram.relationships) {
391
+ const source = diagram.elements.find((e) => e.id === rel.sourceId);
392
+ const target = diagram.elements.find((e) => e.id === rel.targetId);
393
+ if (source && target) {
394
+ const label = rel.technology ? `${rel.description}<br/>${rel.technology}` : rel.description;
395
+ lines.push(` ${this.sanitizeId(source.name)} -->|"${label}"| ${this.sanitizeId(target.name)}`);
396
+ }
397
+ }
398
+ // Styling
399
+ lines.push('');
400
+ lines.push(' classDef person fill:#08427B,color:#fff');
401
+ lines.push(' classDef system fill:#1168BD,color:#fff');
402
+ lines.push(' classDef container fill:#438DD5,color:#fff');
403
+ lines.push(' classDef external fill:#999999,color:#fff');
404
+ return lines.join('\n');
405
+ }
406
+ /**
407
+ * Get PlantUML container type
408
+ */
409
+ getPlantUMLContainerType(element) {
410
+ const tags = element.tags ?? [];
411
+ if (tags.includes('database'))
412
+ return 'ContainerDb';
413
+ if (tags.includes('queue'))
414
+ return 'ContainerQueue';
415
+ return 'Container';
416
+ }
417
+ /**
418
+ * Get Mermaid icon for element
419
+ */
420
+ getMermaidIcon(element) {
421
+ const tags = element.tags ?? [];
422
+ if (tags.includes('database'))
423
+ return '🗄️';
424
+ if (tags.includes('queue'))
425
+ return '📨';
426
+ if (tags.includes('web-app'))
427
+ return '🌐';
428
+ if (tags.includes('api'))
429
+ return '⚡';
430
+ if (tags.includes('storage'))
431
+ return '💾';
432
+ return '📦';
433
+ }
434
+ /**
435
+ * Sanitize ID for diagram formats
436
+ */
437
+ sanitizeId(name) {
438
+ return name.replace(/[^a-zA-Z0-9]/g, '_').toLowerCase();
439
+ }
440
+ /**
441
+ * Capitalize first letter
442
+ */
443
+ capitalizeFirst(str) {
444
+ return str.charAt(0).toUpperCase() + str.slice(1);
445
+ }
446
+ }
447
+ /**
448
+ * Create C4 model generator instance
449
+ */
450
+ export function createC4ModelGenerator(config) {
451
+ return new C4ModelGenerator(config);
452
+ }
453
+ //# sourceMappingURL=c4-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"c4-generator.js","sourceRoot":"","sources":["../../src/design/c4-generator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,190 @@
1
+ /**
2
+ * Framework Optimizer
3
+ *
4
+ * Provides framework-specific optimizations and best practices
5
+ *
6
+ * @packageDocumentation
7
+ * @module design/framework-optimizer
8
+ *
9
+ * @see REQ-DES-002 - Framework Optimization
10
+ * @see Article III - Design Validation
11
+ */
12
+ /**
13
+ * Supported frameworks
14
+ */
15
+ export type FrameworkType = 'react' | 'vue' | 'angular' | 'express' | 'fastify' | 'nestjs' | 'nextjs' | 'nuxt' | 'svelte' | 'node' | 'generic';
16
+ /**
17
+ * Framework info
18
+ */
19
+ export interface FrameworkInfo {
20
+ /** Framework ID */
21
+ id: FrameworkType;
22
+ /** Display name */
23
+ name: string;
24
+ /** Category */
25
+ category: 'frontend' | 'backend' | 'fullstack' | 'runtime';
26
+ /** Key patterns */
27
+ patterns: string[];
28
+ /** Best practices */
29
+ bestPractices: FrameworkBestPractice[];
30
+ /** Anti-patterns */
31
+ antiPatterns: FrameworkAntiPattern[];
32
+ /** Detection indicators */
33
+ detectionPatterns: string[];
34
+ }
35
+ /**
36
+ * Best practice
37
+ */
38
+ export interface FrameworkBestPractice {
39
+ /** Practice ID */
40
+ id: string;
41
+ /** Practice name */
42
+ name: string;
43
+ /** Description */
44
+ description: string;
45
+ /** Why it matters */
46
+ rationale: string;
47
+ /** Example */
48
+ example?: string;
49
+ /** Priority */
50
+ priority: 'high' | 'medium' | 'low';
51
+ }
52
+ /**
53
+ * Anti-pattern
54
+ */
55
+ export interface FrameworkAntiPattern {
56
+ /** Anti-pattern ID */
57
+ id: string;
58
+ /** Name */
59
+ name: string;
60
+ /** Description */
61
+ description: string;
62
+ /** Detection pattern */
63
+ detection: RegExp | string;
64
+ /** Severity */
65
+ severity: 'high' | 'medium' | 'low';
66
+ /** Fix suggestion */
67
+ fix: string;
68
+ }
69
+ /**
70
+ * Optimization suggestion
71
+ */
72
+ export interface OptimizationSuggestion {
73
+ /** Suggestion ID */
74
+ id: string;
75
+ /** Category */
76
+ category: 'performance' | 'security' | 'maintainability' | 'scalability';
77
+ /** Title */
78
+ title: string;
79
+ /** Description */
80
+ description: string;
81
+ /** Priority */
82
+ priority: 'high' | 'medium' | 'low';
83
+ /** Impact */
84
+ impact: string;
85
+ /** How to implement */
86
+ implementation: string;
87
+ /** Code example */
88
+ codeExample?: string;
89
+ /** Related files */
90
+ relatedFiles?: string[];
91
+ }
92
+ /**
93
+ * Framework analysis result
94
+ */
95
+ export interface FrameworkAnalysisResult {
96
+ /** Detected framework */
97
+ framework: FrameworkInfo;
98
+ /** Confidence */
99
+ confidence: number;
100
+ /** Anti-patterns found */
101
+ antiPatternsFound: AntiPatternMatch[];
102
+ /** Best practices missing */
103
+ missingBestPractices: FrameworkBestPractice[];
104
+ /** Optimization suggestions */
105
+ suggestions: OptimizationSuggestion[];
106
+ /** Overall score */
107
+ score: number;
108
+ }
109
+ /**
110
+ * Anti-pattern match
111
+ */
112
+ export interface AntiPatternMatch {
113
+ /** Anti-pattern */
114
+ antiPattern: FrameworkAntiPattern;
115
+ /** Where found */
116
+ location: string;
117
+ /** Matched text */
118
+ matchedText: string;
119
+ }
120
+ /**
121
+ * Framework definitions
122
+ */
123
+ export declare const FRAMEWORKS: Record<FrameworkType, FrameworkInfo>;
124
+ /**
125
+ * Framework Optimizer configuration
126
+ */
127
+ export interface FrameworkOptimizerConfig {
128
+ /** Custom frameworks */
129
+ customFrameworks?: FrameworkInfo[];
130
+ /** Strict mode */
131
+ strictMode: boolean;
132
+ /** Minimum confidence for detection */
133
+ detectionThreshold: number;
134
+ }
135
+ /**
136
+ * Default configuration
137
+ */
138
+ export declare const DEFAULT_OPTIMIZER_CONFIG: FrameworkOptimizerConfig;
139
+ /**
140
+ * Framework Optimizer
141
+ */
142
+ export declare class FrameworkOptimizer {
143
+ private config;
144
+ private frameworks;
145
+ constructor(config?: Partial<FrameworkOptimizerConfig>);
146
+ /**
147
+ * Detect framework from code
148
+ */
149
+ detectFramework(code: string): {
150
+ framework: FrameworkType;
151
+ confidence: number;
152
+ } | null;
153
+ /**
154
+ * Analyze code for framework-specific issues
155
+ */
156
+ analyze(code: string, framework?: FrameworkType): FrameworkAnalysisResult;
157
+ /**
158
+ * Find anti-patterns in code
159
+ */
160
+ private findAntiPatterns;
161
+ /**
162
+ * Check for missing best practices
163
+ */
164
+ private checkBestPractices;
165
+ /**
166
+ * Generate optimization suggestions
167
+ */
168
+ private generateSuggestions;
169
+ /**
170
+ * Calculate optimization score
171
+ */
172
+ private calculateScore;
173
+ /**
174
+ * Get framework info
175
+ */
176
+ getFrameworkInfo(framework: FrameworkType): FrameworkInfo | undefined;
177
+ /**
178
+ * Get all frameworks
179
+ */
180
+ getAllFrameworks(): FrameworkInfo[];
181
+ /**
182
+ * Get frameworks by category
183
+ */
184
+ getFrameworksByCategory(category: FrameworkInfo['category']): FrameworkInfo[];
185
+ }
186
+ /**
187
+ * Create framework optimizer instance
188
+ */
189
+ export declare function createFrameworkOptimizer(config?: Partial<FrameworkOptimizerConfig>): FrameworkOptimizer;
190
+ //# sourceMappingURL=framework-optimizer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"framework-optimizer.d.ts","sourceRoot":"","sources":["../../src/design/framework-optimizer.ts"],"names":[],"mappings":"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"}