@memberjunction/db-auto-doc 2.117.0 → 2.118.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 (251) hide show
  1. package/README.md +652 -165
  2. package/bin/run.js +7 -0
  3. package/dist/api/DBAutoDocAPI.d.ts +252 -0
  4. package/dist/api/DBAutoDocAPI.d.ts.map +1 -0
  5. package/dist/api/DBAutoDocAPI.js +530 -0
  6. package/dist/api/DBAutoDocAPI.js.map +1 -0
  7. package/dist/api/index.d.ts +7 -0
  8. package/dist/api/index.d.ts.map +1 -0
  9. package/dist/api/index.js +10 -0
  10. package/dist/api/index.js.map +1 -0
  11. package/dist/commands/analyze.d.ts +6 -4
  12. package/dist/commands/analyze.d.ts.map +1 -1
  13. package/dist/commands/analyze.js +58 -71
  14. package/dist/commands/analyze.js.map +1 -1
  15. package/dist/commands/export.d.ts +14 -4
  16. package/dist/commands/export.d.ts.map +1 -1
  17. package/dist/commands/export.js +156 -61
  18. package/dist/commands/export.js.map +1 -1
  19. package/dist/commands/init.d.ts +3 -4
  20. package/dist/commands/init.d.ts.map +1 -1
  21. package/dist/commands/init.js +155 -146
  22. package/dist/commands/init.js.map +1 -1
  23. package/dist/commands/reset.d.ts +4 -1
  24. package/dist/commands/reset.d.ts.map +1 -1
  25. package/dist/commands/reset.js +33 -19
  26. package/dist/commands/reset.js.map +1 -1
  27. package/dist/commands/status.d.ts +10 -0
  28. package/dist/commands/status.d.ts.map +1 -0
  29. package/dist/commands/status.js +66 -0
  30. package/dist/commands/status.js.map +1 -0
  31. package/dist/core/AnalysisEngine.d.ts +108 -0
  32. package/dist/core/AnalysisEngine.d.ts.map +1 -0
  33. package/dist/core/AnalysisEngine.js +716 -0
  34. package/dist/core/AnalysisEngine.js.map +1 -0
  35. package/dist/core/AnalysisOrchestrator.d.ts +37 -0
  36. package/dist/core/AnalysisOrchestrator.d.ts.map +1 -0
  37. package/dist/core/AnalysisOrchestrator.js +294 -0
  38. package/dist/core/AnalysisOrchestrator.js.map +1 -0
  39. package/dist/core/BackpropagationEngine.d.ts +32 -0
  40. package/dist/core/BackpropagationEngine.d.ts.map +1 -0
  41. package/dist/core/BackpropagationEngine.js +121 -0
  42. package/dist/core/BackpropagationEngine.js.map +1 -0
  43. package/dist/core/ConvergenceDetector.d.ts +27 -0
  44. package/dist/core/ConvergenceDetector.d.ts.map +1 -0
  45. package/dist/core/ConvergenceDetector.js +92 -0
  46. package/dist/core/ConvergenceDetector.js.map +1 -0
  47. package/dist/core/GuardrailsManager.d.ts +78 -0
  48. package/dist/core/GuardrailsManager.d.ts.map +1 -0
  49. package/dist/core/GuardrailsManager.js +367 -0
  50. package/dist/core/GuardrailsManager.js.map +1 -0
  51. package/dist/core/index.d.ts +7 -0
  52. package/dist/core/index.d.ts.map +1 -0
  53. package/dist/core/index.js +13 -0
  54. package/dist/core/index.js.map +1 -0
  55. package/dist/database/Database.d.ts +56 -0
  56. package/dist/database/Database.d.ts.map +1 -0
  57. package/dist/database/Database.js +172 -0
  58. package/dist/database/Database.js.map +1 -0
  59. package/dist/database/TopologicalSorter.d.ts +25 -0
  60. package/dist/database/TopologicalSorter.d.ts.map +1 -0
  61. package/dist/database/TopologicalSorter.js +150 -0
  62. package/dist/database/TopologicalSorter.js.map +1 -0
  63. package/dist/database/index.d.ts +6 -0
  64. package/dist/database/index.d.ts.map +1 -0
  65. package/dist/database/index.js +14 -0
  66. package/dist/database/index.js.map +1 -0
  67. package/dist/discovery/ColumnStatsCache.d.ts +91 -0
  68. package/dist/discovery/ColumnStatsCache.d.ts.map +1 -0
  69. package/dist/discovery/ColumnStatsCache.js +231 -0
  70. package/dist/discovery/ColumnStatsCache.js.map +1 -0
  71. package/dist/discovery/DiscoveryEngine.d.ts +100 -0
  72. package/dist/discovery/DiscoveryEngine.d.ts.map +1 -0
  73. package/dist/discovery/DiscoveryEngine.js +726 -0
  74. package/dist/discovery/DiscoveryEngine.js.map +1 -0
  75. package/dist/discovery/DiscoveryTriggerAnalyzer.d.ts +57 -0
  76. package/dist/discovery/DiscoveryTriggerAnalyzer.d.ts.map +1 -0
  77. package/dist/discovery/DiscoveryTriggerAnalyzer.js +186 -0
  78. package/dist/discovery/DiscoveryTriggerAnalyzer.js.map +1 -0
  79. package/dist/discovery/FKDetector.d.ts +47 -0
  80. package/dist/discovery/FKDetector.d.ts.map +1 -0
  81. package/dist/discovery/FKDetector.js +317 -0
  82. package/dist/discovery/FKDetector.js.map +1 -0
  83. package/dist/discovery/LLMDiscoveryValidator.d.ts +64 -0
  84. package/dist/discovery/LLMDiscoveryValidator.d.ts.map +1 -0
  85. package/dist/discovery/LLMDiscoveryValidator.js +431 -0
  86. package/dist/discovery/LLMDiscoveryValidator.js.map +1 -0
  87. package/dist/discovery/LLMSanityChecker.d.ts +38 -0
  88. package/dist/discovery/LLMSanityChecker.d.ts.map +1 -0
  89. package/dist/discovery/LLMSanityChecker.js +156 -0
  90. package/dist/discovery/LLMSanityChecker.js.map +1 -0
  91. package/dist/discovery/PKDetector.d.ts +62 -0
  92. package/dist/discovery/PKDetector.d.ts.map +1 -0
  93. package/dist/discovery/PKDetector.js +436 -0
  94. package/dist/discovery/PKDetector.js.map +1 -0
  95. package/dist/discovery/index.d.ts +9 -0
  96. package/dist/discovery/index.d.ts.map +1 -0
  97. package/dist/discovery/index.js +25 -0
  98. package/dist/discovery/index.js.map +1 -0
  99. package/dist/drivers/BaseAutoDocDriver.d.ts +132 -0
  100. package/dist/drivers/BaseAutoDocDriver.d.ts.map +1 -0
  101. package/dist/drivers/BaseAutoDocDriver.js +121 -0
  102. package/dist/drivers/BaseAutoDocDriver.js.map +1 -0
  103. package/dist/drivers/MySQLDriver.d.ts +61 -0
  104. package/dist/drivers/MySQLDriver.d.ts.map +1 -0
  105. package/dist/drivers/MySQLDriver.js +668 -0
  106. package/dist/drivers/MySQLDriver.js.map +1 -0
  107. package/dist/drivers/PostgreSQLDriver.d.ts +65 -0
  108. package/dist/drivers/PostgreSQLDriver.d.ts.map +1 -0
  109. package/dist/drivers/PostgreSQLDriver.js +704 -0
  110. package/dist/drivers/PostgreSQLDriver.js.map +1 -0
  111. package/dist/drivers/SQLServerDriver.d.ts +61 -0
  112. package/dist/drivers/SQLServerDriver.d.ts.map +1 -0
  113. package/dist/drivers/SQLServerDriver.js +667 -0
  114. package/dist/drivers/SQLServerDriver.js.map +1 -0
  115. package/dist/generators/CSVGenerator.d.ts +35 -0
  116. package/dist/generators/CSVGenerator.d.ts.map +1 -0
  117. package/dist/generators/CSVGenerator.js +154 -0
  118. package/dist/generators/CSVGenerator.js.map +1 -0
  119. package/dist/generators/HTMLGenerator.d.ts +29 -0
  120. package/dist/generators/HTMLGenerator.d.ts.map +1 -0
  121. package/dist/generators/HTMLGenerator.js +710 -0
  122. package/dist/generators/HTMLGenerator.js.map +1 -0
  123. package/dist/generators/MarkdownGenerator.d.ts +27 -0
  124. package/dist/generators/MarkdownGenerator.d.ts.map +1 -0
  125. package/dist/generators/MarkdownGenerator.js +361 -0
  126. package/dist/generators/MarkdownGenerator.js.map +1 -0
  127. package/dist/generators/MermaidGenerator.d.ts +35 -0
  128. package/dist/generators/MermaidGenerator.d.ts.map +1 -0
  129. package/dist/generators/MermaidGenerator.js +321 -0
  130. package/dist/generators/MermaidGenerator.js.map +1 -0
  131. package/dist/generators/ReportGenerator.d.ts +22 -0
  132. package/dist/generators/ReportGenerator.d.ts.map +1 -0
  133. package/dist/generators/ReportGenerator.js +176 -0
  134. package/dist/generators/ReportGenerator.js.map +1 -0
  135. package/dist/generators/SQLGenerator.d.ts +31 -0
  136. package/dist/generators/SQLGenerator.d.ts.map +1 -0
  137. package/dist/generators/SQLGenerator.js +168 -0
  138. package/dist/generators/SQLGenerator.js.map +1 -0
  139. package/dist/generators/index.d.ts +10 -0
  140. package/dist/generators/index.d.ts.map +1 -0
  141. package/dist/generators/index.js +19 -0
  142. package/dist/generators/index.js.map +1 -0
  143. package/dist/index.d.ts +11 -20
  144. package/dist/index.d.ts.map +1 -1
  145. package/dist/index.js +19 -20
  146. package/dist/index.js.map +1 -1
  147. package/dist/prompts/PromptEngine.d.ts +65 -0
  148. package/dist/prompts/PromptEngine.d.ts.map +1 -0
  149. package/dist/prompts/PromptEngine.js +282 -0
  150. package/dist/prompts/PromptEngine.js.map +1 -0
  151. package/dist/prompts/PromptFileLoader.d.ts +21 -0
  152. package/dist/prompts/PromptFileLoader.d.ts.map +1 -0
  153. package/dist/prompts/PromptFileLoader.js +74 -0
  154. package/dist/prompts/PromptFileLoader.js.map +1 -0
  155. package/dist/prompts/index.d.ts +6 -0
  156. package/dist/prompts/index.d.ts.map +1 -0
  157. package/dist/prompts/index.js +11 -0
  158. package/dist/prompts/index.js.map +1 -0
  159. package/dist/state/IterationTracker.d.ts +64 -0
  160. package/dist/state/IterationTracker.d.ts.map +1 -0
  161. package/dist/state/IterationTracker.js +136 -0
  162. package/dist/state/IterationTracker.js.map +1 -0
  163. package/dist/state/StateManager.d.ts +79 -0
  164. package/dist/state/StateManager.d.ts.map +1 -0
  165. package/dist/state/StateManager.js +348 -0
  166. package/dist/state/StateManager.js.map +1 -0
  167. package/dist/state/StateValidator.d.ts +24 -0
  168. package/dist/state/StateValidator.d.ts.map +1 -0
  169. package/dist/state/StateValidator.js +147 -0
  170. package/dist/state/StateValidator.js.map +1 -0
  171. package/dist/state/index.d.ts +7 -0
  172. package/dist/state/index.d.ts.map +1 -0
  173. package/dist/state/index.js +13 -0
  174. package/dist/state/index.js.map +1 -0
  175. package/dist/types/analysis.d.ts +76 -0
  176. package/dist/types/analysis.d.ts.map +1 -0
  177. package/dist/types/analysis.js +6 -0
  178. package/dist/types/analysis.js.map +1 -0
  179. package/dist/types/config.d.ts +132 -0
  180. package/dist/types/config.d.ts.map +1 -0
  181. package/dist/types/config.js +7 -0
  182. package/dist/types/config.js.map +1 -0
  183. package/dist/types/discovery.d.ts +277 -0
  184. package/dist/types/discovery.d.ts.map +1 -0
  185. package/dist/types/discovery.js +7 -0
  186. package/dist/types/discovery.js.map +1 -0
  187. package/dist/types/driver.d.ts +148 -0
  188. package/dist/types/driver.d.ts.map +1 -0
  189. package/dist/types/driver.js +7 -0
  190. package/dist/types/driver.js.map +1 -0
  191. package/dist/types/index.d.ts +8 -0
  192. package/dist/types/index.d.ts.map +1 -0
  193. package/dist/types/index.js +24 -0
  194. package/dist/types/index.js.map +1 -0
  195. package/dist/types/prompts.d.ts +158 -0
  196. package/dist/types/prompts.d.ts.map +1 -0
  197. package/dist/types/prompts.js +6 -0
  198. package/dist/types/prompts.js.map +1 -0
  199. package/dist/types/state.d.ts +278 -0
  200. package/dist/types/state.d.ts.map +1 -0
  201. package/dist/types/state.js +7 -0
  202. package/dist/types/state.js.map +1 -0
  203. package/dist/utils/config-loader.d.ts +29 -0
  204. package/dist/utils/config-loader.d.ts.map +1 -0
  205. package/dist/utils/config-loader.js +163 -0
  206. package/dist/utils/config-loader.js.map +1 -0
  207. package/dist/utils/index.d.ts +5 -0
  208. package/dist/utils/index.d.ts.map +1 -0
  209. package/dist/utils/index.js +9 -0
  210. package/dist/utils/index.js.map +1 -0
  211. package/package.json +24 -3
  212. package/dist/ai/simple-ai-client.d.ts +0 -70
  213. package/dist/ai/simple-ai-client.d.ts.map +0 -1
  214. package/dist/ai/simple-ai-client.js +0 -181
  215. package/dist/ai/simple-ai-client.js.map +0 -1
  216. package/dist/analyzers/analyzer.d.ts +0 -23
  217. package/dist/analyzers/analyzer.d.ts.map +0 -1
  218. package/dist/analyzers/analyzer.js +0 -127
  219. package/dist/analyzers/analyzer.js.map +0 -1
  220. package/dist/cli-old/cli.d.ts +0 -3
  221. package/dist/cli-old/cli.d.ts.map +0 -1
  222. package/dist/cli-old/cli.js +0 -388
  223. package/dist/cli-old/cli.js.map +0 -1
  224. package/dist/commands/review.d.ts +0 -11
  225. package/dist/commands/review.d.ts.map +0 -1
  226. package/dist/commands/review.js +0 -82
  227. package/dist/commands/review.js.map +0 -1
  228. package/dist/database/connection.d.ts +0 -40
  229. package/dist/database/connection.d.ts.map +0 -1
  230. package/dist/database/connection.js +0 -136
  231. package/dist/database/connection.js.map +0 -1
  232. package/dist/database/introspection.d.ts +0 -59
  233. package/dist/database/introspection.d.ts.map +0 -1
  234. package/dist/database/introspection.js +0 -124
  235. package/dist/database/introspection.js.map +0 -1
  236. package/dist/generators/markdown-generator.d.ts +0 -8
  237. package/dist/generators/markdown-generator.d.ts.map +0 -1
  238. package/dist/generators/markdown-generator.js +0 -106
  239. package/dist/generators/markdown-generator.js.map +0 -1
  240. package/dist/generators/sql-generator.d.ts +0 -20
  241. package/dist/generators/sql-generator.d.ts.map +0 -1
  242. package/dist/generators/sql-generator.js +0 -83
  243. package/dist/generators/sql-generator.js.map +0 -1
  244. package/dist/state/state-manager.d.ts +0 -95
  245. package/dist/state/state-manager.d.ts.map +0 -1
  246. package/dist/state/state-manager.js +0 -236
  247. package/dist/state/state-manager.js.map +0 -1
  248. package/dist/types/state-file.d.ts +0 -124
  249. package/dist/types/state-file.d.ts.map +0 -1
  250. package/dist/types/state-file.js +0 -79
  251. package/dist/types/state-file.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PromptEngine.js","sourceRoot":"","sources":["../../src/prompts/PromptEngine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Custom Nunjucks loader for file-based prompts
3
+ * Pattern adapted from Templates package's TemplateEntityLoader
4
+ */
5
+ import * as nunjucks from 'nunjucks';
6
+ export declare class PromptFileLoader extends nunjucks.Loader {
7
+ private promptsDir;
8
+ async: true;
9
+ private prompts;
10
+ constructor(promptsDir: string);
11
+ /**
12
+ * Load all prompt files from directory
13
+ */
14
+ loadAll(): Promise<void>;
15
+ /**
16
+ * Required by Nunjucks Loader - provides template source
17
+ * Pattern from Templates package
18
+ */
19
+ getSource(name: string, callback: any): void;
20
+ }
21
+ //# sourceMappingURL=PromptFileLoader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PromptFileLoader.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptFileLoader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAIrC,qBAAa,gBAAiB,SAAQ,QAAQ,CAAC,MAAM;IAKvC,OAAO,CAAC,UAAU;IAJvB,KAAK,EAAE,IAAI,CAAQ;IAE1B,OAAO,CAAC,OAAO,CAAkC;gBAE7B,UAAU,EAAE,MAAM;IAItC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAarC;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;CAYpD"}
@@ -0,0 +1,74 @@
1
+ "use strict";
2
+ /**
3
+ * Custom Nunjucks loader for file-based prompts
4
+ * Pattern adapted from Templates package's TemplateEntityLoader
5
+ */
6
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
+ if (k2 === undefined) k2 = k;
8
+ var desc = Object.getOwnPropertyDescriptor(m, k);
9
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
10
+ desc = { enumerable: true, get: function() { return m[k]; } };
11
+ }
12
+ Object.defineProperty(o, k2, desc);
13
+ }) : (function(o, m, k, k2) {
14
+ if (k2 === undefined) k2 = k;
15
+ o[k2] = m[k];
16
+ }));
17
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
18
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
19
+ }) : function(o, v) {
20
+ o["default"] = v;
21
+ });
22
+ var __importStar = (this && this.__importStar) || function (mod) {
23
+ if (mod && mod.__esModule) return mod;
24
+ var result = {};
25
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
26
+ __setModuleDefault(result, mod);
27
+ return result;
28
+ };
29
+ Object.defineProperty(exports, "__esModule", { value: true });
30
+ exports.PromptFileLoader = void 0;
31
+ const nunjucks = __importStar(require("nunjucks"));
32
+ const fs = __importStar(require("fs/promises"));
33
+ const path = __importStar(require("path"));
34
+ class PromptFileLoader extends nunjucks.Loader {
35
+ constructor(promptsDir) {
36
+ super();
37
+ this.promptsDir = promptsDir;
38
+ this.async = true;
39
+ this.prompts = new Map();
40
+ }
41
+ /**
42
+ * Load all prompt files from directory
43
+ */
44
+ async loadAll() {
45
+ const files = await fs.readdir(this.promptsDir);
46
+ for (const file of files) {
47
+ if (file.endsWith('.md') || file.endsWith('.txt')) {
48
+ const promptName = path.basename(file, path.extname(file));
49
+ const filePath = path.join(this.promptsDir, file);
50
+ const content = await fs.readFile(filePath, 'utf-8');
51
+ this.prompts.set(promptName, content);
52
+ }
53
+ }
54
+ }
55
+ /**
56
+ * Required by Nunjucks Loader - provides template source
57
+ * Pattern from Templates package
58
+ */
59
+ getSource(name, callback) {
60
+ const content = this.prompts.get(name);
61
+ if (content) {
62
+ callback(null, {
63
+ src: content,
64
+ path: name,
65
+ noCache: true
66
+ });
67
+ }
68
+ else {
69
+ callback(new Error(`Prompt not found: ${name}`));
70
+ }
71
+ }
72
+ }
73
+ exports.PromptFileLoader = PromptFileLoader;
74
+ //# sourceMappingURL=PromptFileLoader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PromptFileLoader.js","sourceRoot":"","sources":["../../src/prompts/PromptFileLoader.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AACrC,gDAAkC;AAClC,2CAA6B;AAE7B,MAAa,gBAAiB,SAAQ,QAAQ,CAAC,MAAM;IAKnD,YAAoB,UAAkB;QACpC,KAAK,EAAE,CAAC;QADU,eAAU,GAAV,UAAU,CAAQ;QAJ/B,UAAK,GAAS,IAAI,CAAC;QAElB,YAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAIjD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,SAAS,CAAC,IAAY,EAAE,QAAa;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,EAAE;gBACb,GAAG,EAAE,OAAO;gBACZ,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAzCD,4CAyCC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Exports for prompts module
3
+ */
4
+ export { PromptFileLoader } from './PromptFileLoader.js';
5
+ export { PromptEngine } from './PromptEngine.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+ /**
3
+ * Exports for prompts module
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.PromptEngine = exports.PromptFileLoader = void 0;
7
+ var PromptFileLoader_js_1 = require("./PromptFileLoader.js");
8
+ Object.defineProperty(exports, "PromptFileLoader", { enumerable: true, get: function () { return PromptFileLoader_js_1.PromptFileLoader; } });
9
+ var PromptEngine_js_1 = require("./PromptEngine.js");
10
+ Object.defineProperty(exports, "PromptEngine", { enumerable: true, get: function () { return PromptEngine_js_1.PromptEngine; } });
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Tracks iteration metadata and changes
3
+ */
4
+ import { DatabaseDocumentation, AnalysisRun, ProcessingLogEntry } from '../types/state.js';
5
+ export declare class IterationTracker {
6
+ /**
7
+ * Get the current (latest) analysis run
8
+ */
9
+ getCurrentRun(state: DatabaseDocumentation): AnalysisRun | null;
10
+ /**
11
+ * Add processing log entry
12
+ */
13
+ addLogEntry(run: AnalysisRun, entry: Omit<ProcessingLogEntry, 'timestamp'>): void;
14
+ /**
15
+ * Add processing log entry with prompt I/O details
16
+ */
17
+ addLogEntryWithPrompt(run: AnalysisRun, entry: Omit<ProcessingLogEntry, 'timestamp'>, promptInput?: string, promptOutput?: string): void;
18
+ /**
19
+ * Mark run as complete
20
+ */
21
+ completeRun(run: AnalysisRun, converged: boolean, convergenceReason?: string): void;
22
+ /**
23
+ * Mark run as failed
24
+ */
25
+ failRun(run: AnalysisRun, error: string): void;
26
+ /**
27
+ * Get recent changes from processing log
28
+ */
29
+ getRecentChanges(run: AnalysisRun, count?: number): ProcessingLogEntry[];
30
+ /**
31
+ * Check if any changes occurred in last N iterations
32
+ */
33
+ hasRecentChanges(state: DatabaseDocumentation, windowSize: number): boolean;
34
+ /**
35
+ * Get iteration statistics
36
+ */
37
+ getIterationStats(run: AnalysisRun): {
38
+ totalProcessed: number;
39
+ changed: number;
40
+ unchanged: number;
41
+ errors: number;
42
+ };
43
+ /**
44
+ * Add tokens to run total
45
+ */
46
+ addTokenUsage(run: AnalysisRun, tokensUsed: number, cost?: number): void;
47
+ /**
48
+ * Increment iteration count
49
+ */
50
+ incrementIteration(state: DatabaseDocumentation, run: AnalysisRun): void;
51
+ /**
52
+ * Increment backpropagation count
53
+ */
54
+ incrementBackpropagation(run: AnalysisRun): void;
55
+ /**
56
+ * Add warning to run
57
+ */
58
+ addWarning(run: AnalysisRun, warning: string): void;
59
+ /**
60
+ * Add error to run
61
+ */
62
+ addError(run: AnalysisRun, error: string): void;
63
+ }
64
+ //# sourceMappingURL=IterationTracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IterationTracker.d.ts","sourceRoot":"","sources":["../../src/state/IterationTracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE3F,qBAAa,gBAAgB;IAC3B;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,WAAW,GAAG,IAAI;IAOtE;;OAEG;IACI,WAAW,CAChB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAC3C,IAAI;IASP;;OAEG;IACI,qBAAqB,CAC1B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,EAC5C,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI;IAWP;;OAEG;IACI,WAAW,CAChB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,OAAO,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI;IAOP;;OAEG;IACI,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrD;;OAEG;IACI,gBAAgB,CACrB,GAAG,EAAE,WAAW,EAChB,KAAK,GAAE,MAAW,GACjB,kBAAkB,EAAE;IAQvB;;OAEG;IACI,gBAAgB,CACrB,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO;IAYV;;OAEG;IACI,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG;QAC1C,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IAyBD;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/E;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAK/E;;OAEG;IACI,wBAAwB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAIvD;;OAEG;IACI,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACI,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAGvD"}
@@ -0,0 +1,136 @@
1
+ "use strict";
2
+ /**
3
+ * Tracks iteration metadata and changes
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.IterationTracker = void 0;
7
+ class IterationTracker {
8
+ /**
9
+ * Get the current (latest) analysis run
10
+ */
11
+ getCurrentRun(state) {
12
+ if (state.phases.descriptionGeneration.length === 0) {
13
+ return null;
14
+ }
15
+ return state.phases.descriptionGeneration[state.phases.descriptionGeneration.length - 1];
16
+ }
17
+ /**
18
+ * Add processing log entry
19
+ */
20
+ addLogEntry(run, entry) {
21
+ const logEntry = {
22
+ ...entry,
23
+ timestamp: new Date().toISOString()
24
+ };
25
+ run.processingLog.push(logEntry);
26
+ }
27
+ /**
28
+ * Add processing log entry with prompt I/O details
29
+ */
30
+ addLogEntryWithPrompt(run, entry, promptInput, promptOutput) {
31
+ const logEntry = {
32
+ ...entry,
33
+ timestamp: new Date().toISOString(),
34
+ promptInput,
35
+ promptOutput
36
+ };
37
+ run.processingLog.push(logEntry);
38
+ }
39
+ /**
40
+ * Mark run as complete
41
+ */
42
+ completeRun(run, converged, convergenceReason) {
43
+ run.completedAt = new Date().toISOString();
44
+ run.status = converged ? 'converged' : 'completed';
45
+ run.converged = converged;
46
+ run.convergenceReason = convergenceReason;
47
+ }
48
+ /**
49
+ * Mark run as failed
50
+ */
51
+ failRun(run, error) {
52
+ run.completedAt = new Date().toISOString();
53
+ run.status = 'failed';
54
+ run.errors.push(error);
55
+ }
56
+ /**
57
+ * Get recent changes from processing log
58
+ */
59
+ getRecentChanges(run, count = 10) {
60
+ const changes = run.processingLog.filter(entry => entry.result === 'changed');
61
+ return changes.slice(-count);
62
+ }
63
+ /**
64
+ * Check if any changes occurred in last N iterations
65
+ */
66
+ hasRecentChanges(state, windowSize) {
67
+ const run = this.getCurrentRun(state);
68
+ if (!run) {
69
+ return false;
70
+ }
71
+ // Get log entries from last windowSize iterations
72
+ const recentLogs = run.processingLog.slice(-(windowSize * 10)); // Rough estimate
73
+ return recentLogs.some(entry => entry.result === 'changed');
74
+ }
75
+ /**
76
+ * Get iteration statistics
77
+ */
78
+ getIterationStats(run) {
79
+ const stats = {
80
+ totalProcessed: run.processingLog.length,
81
+ changed: 0,
82
+ unchanged: 0,
83
+ errors: 0
84
+ };
85
+ for (const entry of run.processingLog) {
86
+ switch (entry.result) {
87
+ case 'changed':
88
+ stats.changed++;
89
+ break;
90
+ case 'unchanged':
91
+ stats.unchanged++;
92
+ break;
93
+ case 'error':
94
+ stats.errors++;
95
+ break;
96
+ }
97
+ }
98
+ return stats;
99
+ }
100
+ /**
101
+ * Add tokens to run total
102
+ */
103
+ addTokenUsage(run, tokensUsed, cost) {
104
+ run.totalTokensUsed += tokensUsed;
105
+ if (cost) {
106
+ run.estimatedCost += cost;
107
+ }
108
+ }
109
+ /**
110
+ * Increment iteration count
111
+ */
112
+ incrementIteration(state, run) {
113
+ run.iterationsPerformed++;
114
+ state.summary.totalIterations++;
115
+ }
116
+ /**
117
+ * Increment backpropagation count
118
+ */
119
+ incrementBackpropagation(run) {
120
+ run.backpropagationCount++;
121
+ }
122
+ /**
123
+ * Add warning to run
124
+ */
125
+ addWarning(run, warning) {
126
+ run.warnings.push(warning);
127
+ }
128
+ /**
129
+ * Add error to run
130
+ */
131
+ addError(run, error) {
132
+ run.errors.push(error);
133
+ }
134
+ }
135
+ exports.IterationTracker = IterationTracker;
136
+ //# sourceMappingURL=IterationTracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IterationTracker.js","sourceRoot":"","sources":["../../src/state/IterationTracker.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,MAAa,gBAAgB;IAC3B;;OAEG;IACI,aAAa,CAAC,KAA4B;QAC/C,IAAI,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACI,WAAW,CAChB,GAAgB,EAChB,KAA4C;QAE5C,MAAM,QAAQ,GAAuB;YACnC,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,qBAAqB,CAC1B,GAAgB,EAChB,KAA4C,EAC5C,WAAoB,EACpB,YAAqB;QAErB,MAAM,QAAQ,GAAuB;YACnC,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW;YACX,YAAY;SACb,CAAC;QAEF,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,WAAW,CAChB,GAAgB,EAChB,SAAkB,EAClB,iBAA0B;QAE1B,GAAG,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;QACnD,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QAC1B,GAAG,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,GAAgB,EAAE,KAAa;QAC5C,GAAG,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;QACtB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,gBAAgB,CACrB,GAAgB,EAChB,QAAgB,EAAE;QAElB,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CACtC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CACpC,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,gBAAgB,CACrB,KAA4B,EAC5B,UAAkB;QAElB,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kDAAkD;QAClD,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAEjF,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACI,iBAAiB,CAAC,GAAgB;QAMvC,MAAM,KAAK,GAAG;YACZ,cAAc,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM;YACxC,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;SACV,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACtC,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,KAAK,SAAS;oBACZ,KAAK,CAAC,OAAO,EAAE,CAAC;oBAChB,MAAM;gBACR,KAAK,WAAW;oBACd,KAAK,CAAC,SAAS,EAAE,CAAC;oBAClB,MAAM;gBACR,KAAK,OAAO;oBACV,KAAK,CAAC,MAAM,EAAE,CAAC;oBACf,MAAM;YACV,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,GAAgB,EAAE,UAAkB,EAAE,IAAa;QACtE,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,KAA4B,EAAE,GAAgB;QACtE,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,wBAAwB,CAAC,GAAgB;QAC9C,GAAG,CAAC,oBAAoB,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,GAAgB,EAAE,OAAe;QACjD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,GAAgB,EAAE,KAAa;QAC7C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF;AA3KD,4CA2KC"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * State file management
3
+ * Handles loading, saving, and updating the state file
4
+ */
5
+ import { DatabaseDocumentation, SchemaDefinition, TableDefinition, ColumnDefinition, AnalysisRun } from '../types/state.js';
6
+ export declare class StateManager {
7
+ private stateFilePath;
8
+ constructor(stateFilePath: string);
9
+ /**
10
+ * Load state from file
11
+ */
12
+ load(): Promise<DatabaseDocumentation | null>;
13
+ /**
14
+ * Save state to file
15
+ */
16
+ save(state: DatabaseDocumentation): Promise<void>;
17
+ /**
18
+ * Create initial empty state
19
+ */
20
+ createInitialState(databaseName: string, serverName: string): DatabaseDocumentation;
21
+ /**
22
+ * Start a new analysis run
23
+ */
24
+ createAnalysisRun(state: DatabaseDocumentation, modelUsed: string, vendor: string, temperature: number, topP?: number, topK?: number): AnalysisRun;
25
+ /**
26
+ * Update table description with new iteration
27
+ */
28
+ updateTableDescription(table: TableDefinition, description: string, reasoning: string, confidence: number, modelUsed: string, triggeredBy: 'initial' | 'backpropagation' | 'refinement' | 'dependency_sanity_check' | 'schema_sanity_check' | 'cross_schema_sanity_check'): void;
29
+ /**
30
+ * Update column description with new iteration
31
+ */
32
+ updateColumnDescription(column: ColumnDefinition, description: string, reasoning: string, modelUsed: string): void;
33
+ /**
34
+ * Update schema description
35
+ */
36
+ updateSchemaDescription(schema: SchemaDefinition, description: string, reasoning: string, modelUsed: string): void;
37
+ /**
38
+ * Find a table in the state
39
+ */
40
+ findTable(state: DatabaseDocumentation, schemaName: string, tableName: string): TableDefinition | null;
41
+ /**
42
+ * Get all unapproved tables
43
+ */
44
+ getUnapprovedTables(state: DatabaseDocumentation): TableDefinition[];
45
+ /**
46
+ * Get low-confidence tables
47
+ */
48
+ getLowConfidenceTables(state: DatabaseDocumentation, threshold: number): Array<{
49
+ schema: string;
50
+ table: string;
51
+ confidence: number;
52
+ description: string;
53
+ reasoning: string;
54
+ }>;
55
+ /**
56
+ * Get tables that need processing (no descriptions yet)
57
+ */
58
+ getUnprocessedTables(state: DatabaseDocumentation): Array<{
59
+ schema: string;
60
+ table: string;
61
+ }>;
62
+ /**
63
+ * Check if state file exists
64
+ */
65
+ private fileExists;
66
+ /**
67
+ * Generate unique run ID
68
+ */
69
+ private generateRunId;
70
+ /**
71
+ * Update summary statistics from current state and analysis runs
72
+ */
73
+ updateSummary(state: DatabaseDocumentation): void;
74
+ /**
75
+ * Delete state file
76
+ */
77
+ delete(): Promise<void>;
78
+ }
79
+ //# sourceMappingURL=StateManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StateManager.d.ts","sourceRoot":"","sources":["../../src/state/StateManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEhB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,YAAY;IACX,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAEzC;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAuD1D;;OAEG;IACU,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9D;;OAEG;IACI,kBAAkB,CACvB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,qBAAqB;IA6BxB;;OAEG;IACI,iBAAiB,CACtB,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW;IA2Bd;;OAEG;IACI,sBAAsB,CAC3B,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,SAAS,GAAG,iBAAiB,GAAG,YAAY,GAAG,yBAAyB,GAAG,qBAAqB,GAAG,2BAA2B,GAC1I,IAAI;IAeP;;OAEG;IACI,uBAAuB,CAC5B,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI;IAYP;;OAEG;IACI,uBAAuB,CAC5B,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI;IAaP;;OAEG;IACI,SAAS,CACd,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI;IASzB;;OAEG;IACI,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,EAAE;IAc3E;;OAEG;IACI,sBAAsB,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BvG;;OAEG;IACI,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBnG;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAyCxD;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAUrC"}