@noyrax/documentation-system-plugin 1.0.4-beta.3 → 1.0.4-beta.5

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 (197) hide show
  1. package/out/cache/ast-cache.js +69 -0
  2. package/out/cache/ast-cache.js.map +1 -0
  3. package/out/cache/dependencies-cache.js +73 -0
  4. package/out/cache/dependencies-cache.js.map +1 -0
  5. package/out/cache/output-cache.js +69 -0
  6. package/out/cache/output-cache.js.map +1 -0
  7. package/out/cache/signature-cache.js +60 -0
  8. package/out/cache/signature-cache.js.map +1 -0
  9. package/out/cli/generate-cli.js +345 -0
  10. package/out/cli/generate-cli.js.map +1 -0
  11. package/out/cli/scan-cli.js +157 -0
  12. package/out/cli/scan-cli.js.map +1 -0
  13. package/out/cli/validate-cli.js +258 -0
  14. package/out/cli/validate-cli.js.map +1 -0
  15. package/out/core/async.js +38 -0
  16. package/out/core/async.js.map +1 -0
  17. package/out/core/consolidation.js +230 -0
  18. package/out/core/consolidation.js.map +1 -0
  19. package/out/core/git.js +48 -0
  20. package/out/core/git.js.map +1 -0
  21. package/out/core/language-detection.js +29 -0
  22. package/out/core/language-detection.js.map +1 -0
  23. package/out/core/scanner.js +180 -0
  24. package/out/core/scanner.js.map +1 -0
  25. package/out/core/signature-formatter.js +162 -0
  26. package/out/core/signature-formatter.js.map +1 -0
  27. package/out/core/symbol-classifier.js +96 -0
  28. package/out/core/symbol-classifier.js.map +1 -0
  29. package/out/core/symbols.js +24 -0
  30. package/out/core/symbols.js.map +1 -0
  31. package/out/drift/index.js +28 -0
  32. package/out/drift/index.js.map +1 -0
  33. package/out/extension.js +984 -0
  34. package/out/extension.js.map +1 -0
  35. package/out/generator/adr-linker.js +216 -0
  36. package/out/generator/adr-linker.js.map +1 -0
  37. package/out/generator/change-report.js +124 -0
  38. package/out/generator/change-report.js.map +1 -0
  39. package/out/generator/dependency-graph.js +98 -0
  40. package/out/generator/dependency-graph.js.map +1 -0
  41. package/out/generator/index.js +117 -0
  42. package/out/generator/index.js.map +1 -0
  43. package/out/generator/module-doc.js +438 -0
  44. package/out/generator/module-doc.js.map +1 -0
  45. package/out/generator/system-metadata.js +202 -0
  46. package/out/generator/system-metadata.js.map +1 -0
  47. package/out/index/index.js +161 -0
  48. package/out/index/index.js.map +1 -0
  49. package/out/logging/index.js +24 -0
  50. package/out/logging/index.js.map +1 -0
  51. package/out/parsers/dependencies.js +126 -0
  52. package/out/parsers/dependencies.js.map +1 -0
  53. package/out/parsers/json-yaml.js +121 -0
  54. package/out/parsers/json-yaml.js.map +1 -0
  55. package/out/parsers/python.js +160 -0
  56. package/out/parsers/python.js.map +1 -0
  57. package/out/parsers/ts-js.js +598 -0
  58. package/out/parsers/ts-js.js.map +1 -0
  59. package/out/parsers/types.js +3 -0
  60. package/out/parsers/types.js.map +1 -0
  61. package/out/ui/commands-provider.js +91 -0
  62. package/out/ui/commands-provider.js.map +1 -0
  63. package/out/ui/status-bar.js +85 -0
  64. package/out/ui/status-bar.js.map +1 -0
  65. package/out/validator/index.js +185 -0
  66. package/out/validator/index.js.map +1 -0
  67. package/out/validator/signature-matching.js +261 -0
  68. package/out/validator/signature-matching.js.map +1 -0
  69. package/out/validator/status.js +38 -0
  70. package/out/validator/status.js.map +1 -0
  71. package/package.json +9 -1
  72. package/.vscodeignore +0 -41
  73. package/MCP_SERVER_SETUP.md +0 -371
  74. package/assets/icon.svg +0 -27
  75. package/docs/LINKEDIN_ANTWORT_SEQUENZDIAGRAMME.md +0 -190
  76. package/docs/SEQUENZDIAGRAMM_BEWEIS.md +0 -469
  77. package/docs/SEQUENZDIAGRAMM_VALIDATE_FLOW.md +0 -282
  78. package/docs/adr/001-signatur-abweichung-fix.md +0 -54
  79. package/docs/adr/002-file-specific-validation-1.0.1.md +0 -45
  80. package/docs/adr/003-documentation-generation-bugs.md +0 -134
  81. package/docs/adr/004-validator-signature-matching-fix.md +0 -121
  82. package/docs/adr/005-validator-generic-simplification-tightening.md +0 -35
  83. package/docs/adr/006-parser-variable-type-extraction.md +0 -33
  84. package/docs/adr/007-ts-parser-load-libs-for-accurate-types.md +0 -31
  85. package/docs/adr/008-dependencies-cache-phase1.md +0 -133
  86. package/docs/adr/009-consolidation-union-logic-phase1-2.md +0 -147
  87. package/docs/adr/010-extension-union-integration-phase1-3-and-phase2.md +0 -179
  88. package/docs/adr/011-module-doc-change-tracking-phase3.md +0 -190
  89. package/docs/adr/012-git-deletions-change-report-phase4.md +0 -235
  90. package/docs/adr/013-system-functionality-fixes.md +0 -279
  91. package/docs/adr/014-rules-migration-und-mcp-integration.md +0 -113
  92. package/docs/adr/015-global-agent-package.md +0 -158
  93. package/docs/adr/016-produktisierung-docguard.md +0 -193
  94. package/docs/adr/017-signature-matching-optional-fields.md +0 -128
  95. package/docs/adr/018-rebranding-docguard-to-noyrax.md +0 -109
  96. package/docs/adr/019-system-schwachstellen-analyse-und-fixes.md +0 -204
  97. package/docs/adr/020-api-doc-tiefe-und-signatureformatter.md +0 -74
  98. package/docs/adr/021-semantic-api-docs-and-symbol-classifier.md +0 -125
  99. package/docs/adr/022-semantic-class-and-constants-rendering.md +0 -82
  100. package/docs/adr/023-adr-verknuepfung-modul-doku.md +0 -54
  101. package/docs/adr/024-cursor-rules-mehrdimensionaler-raum.md +0 -230
  102. package/docs/adr/025-mcp-tools-scan-validate-cli-bridge.md +0 -202
  103. package/docs/adr/026-reality-driven-development-system.md +0 -173
  104. package/docs/adr/027-scanner-excludes-and-union-logic-fix.md +0 -189
  105. package/docs/adr/028-src-coverage-union-resync.md +0 -124
  106. package/docs/adr/029-parser-flow-kopplung-und-sync-drift-modi.md +0 -102
  107. package/docs/adr/030-dependency-import-symbol-names-preservation.md +0 -123
  108. package/docs/adr/031-generate-cli-vollstaendige-dokumentation.md +0 -99
  109. package/docs/adr/032-windows-optimized-verification-scripts.md +0 -165
  110. package/docs/adr/036-enhanced-dependency-metadata.md +0 -190
  111. package/docs/adr/TEMPLATE.md +0 -76
  112. package/docs/index/symbols.jsonl +0 -78
  113. package/docs/modules/action__action.yml.md +0 -50
  114. package/docs/modules/documentation.config.schema.json.md +0 -37
  115. package/docs/modules/mcp__package.json.md +0 -130
  116. package/docs/modules/mcp__src__resources__docs.ts.md +0 -94
  117. package/docs/modules/mcp__src__server.ts.md +0 -15
  118. package/docs/modules/mcp__src__tools__drift.ts.md +0 -114
  119. package/docs/modules/mcp__src__tools__impact.ts.md +0 -130
  120. package/docs/modules/mcp__src__tools__scan.ts.md +0 -75
  121. package/docs/modules/mcp__src__tools__validate.ts.md +0 -116
  122. package/docs/modules/mcp__src__tools__verify-adrs.ts.md +0 -106
  123. package/docs/modules/mcp__tsconfig.json.md +0 -22
  124. package/docs/modules/package.json.md +0 -130
  125. package/docs/modules/packages__doc-system-agent__examples__basic-project__package.json.md +0 -43
  126. package/docs/modules/packages__doc-system-agent__examples__basic-project__src__calculator.ts.md +0 -81
  127. package/docs/modules/packages__doc-system-agent__package.json.md +0 -154
  128. package/docs/modules/packages__doc-system-agent__src__cli__index.ts.md +0 -8
  129. package/docs/modules/packages__doc-system-agent__src__cli__init.ts.md +0 -93
  130. package/docs/modules/packages__doc-system-agent__src__cli__update.ts.md +0 -113
  131. package/docs/modules/packages__doc-system-agent__src__constants.ts.md +0 -29
  132. package/docs/modules/packages__doc-system-agent__src__index.ts.md +0 -234
  133. package/docs/modules/packages__doc-system-agent__src__mcp__resources__docs.ts.md +0 -94
  134. package/docs/modules/packages__doc-system-agent__src__mcp__server.ts.md +0 -17
  135. package/docs/modules/packages__doc-system-agent__src__mcp__tools__drift.ts.md +0 -38
  136. package/docs/modules/packages__doc-system-agent__src__mcp__tools__impact.ts.md +0 -75
  137. package/docs/modules/packages__doc-system-agent__src__mcp__tools__scan.ts.md +0 -23
  138. package/docs/modules/packages__doc-system-agent__src__mcp__tools__validate.ts.md +0 -23
  139. package/docs/modules/packages__doc-system-agent__src__mcp__tools__verify-adrs.ts.md +0 -106
  140. package/docs/modules/packages__doc-system-agent__src__mcp__types.ts.md +0 -355
  141. package/docs/modules/packages__doc-system-agent__tsconfig.json.md +0 -22
  142. package/docs/modules/scripts__verify-adrs.js.md +0 -97
  143. package/docs/modules/scripts__verify-architecture.js.md +0 -93
  144. package/docs/modules/scripts__verify-imports.js.md +0 -114
  145. package/docs/modules/src____tests____setup.ts.md +0 -8
  146. package/docs/modules/src____tests____signature-formatter.test.ts.md +0 -16
  147. package/docs/modules/src____tests____snapshot-doc-generation.test.ts.md +0 -8
  148. package/docs/modules/src____tests____symbol-classifier.test.ts.md +0 -16
  149. package/docs/modules/src__cache__ast-cache.ts.md +0 -91
  150. package/docs/modules/src__cache__dependencies-cache.ts.md +0 -89
  151. package/docs/modules/src__cache__output-cache.ts.md +0 -91
  152. package/docs/modules/src__cache__signature-cache.ts.md +0 -76
  153. package/docs/modules/src__cli__generate-cli.ts.md +0 -130
  154. package/docs/modules/src__cli__scan-cli.ts.md +0 -99
  155. package/docs/modules/src__cli__validate-cli.ts.md +0 -144
  156. package/docs/modules/src__core__async.ts.md +0 -18
  157. package/docs/modules/src__core__consolidation.ts.md +0 -157
  158. package/docs/modules/src__core__git.ts.md +0 -35
  159. package/docs/modules/src__core__language-detection.ts.md +0 -31
  160. package/docs/modules/src__core__scanner.ts.md +0 -100
  161. package/docs/modules/src__core__signature-formatter.ts.md +0 -232
  162. package/docs/modules/src__core__symbol-classifier.ts.md +0 -178
  163. package/docs/modules/src__core__symbols.ts.md +0 -31
  164. package/docs/modules/src__drift__index.ts.md +0 -53
  165. package/docs/modules/src__extension.ts.md +0 -418
  166. package/docs/modules/src__generator__adr-linker.ts.md +0 -154
  167. package/docs/modules/src__generator__change-report.ts.md +0 -85
  168. package/docs/modules/src__generator__dependency-graph.ts.md +0 -63
  169. package/docs/modules/src__generator__index.ts.md +0 -40
  170. package/docs/modules/src__generator__module-doc.ts.md +0 -242
  171. package/docs/modules/src__index__index.ts.md +0 -159
  172. package/docs/modules/src__logging__index.ts.md +0 -87
  173. package/docs/modules/src__parsers__dependencies.ts.md +0 -69
  174. package/docs/modules/src__parsers__json-yaml.ts.md +0 -96
  175. package/docs/modules/src__parsers__python.ts.md +0 -73
  176. package/docs/modules/src__parsers__ts-js.ts.md +0 -48
  177. package/docs/modules/src__parsers__types.ts.md +0 -117
  178. package/docs/modules/src__ui__commands-provider.ts.md +0 -70
  179. package/docs/modules/src__ui__status-bar.ts.md +0 -79
  180. package/docs/modules/src__validator__index.ts.md +0 -211
  181. package/docs/modules/src__validator__signature-matching.ts.md +0 -209
  182. package/docs/modules/src__validator__status.ts.md +0 -72
  183. package/docs/modules/test-mcp-resources.js.md +0 -27
  184. package/docs/modules/tsconfig.json.md +0 -22
  185. package/docs/system/CHANGE_REPORT.md +0 -26
  186. package/docs/system/DEPENDENCIES.md +0 -403
  187. package/docs/system/DEPENDENCY_GRAPH.md +0 -336
  188. package/docs/system/NAVIGATION_SPACE_ANALYSIS.md +0 -244
  189. package/docs/system/NPX_CACHE_FIX.md +0 -85
  190. package/docs/system/NPX_LOCAL_USAGE.md +0 -66
  191. package/docs/system/PLUGIN_ECOSYSTEM_STATUS.md +0 -465
  192. package/docs/system/PLUGIN_UPDATE_GUIDE.md +0 -212
  193. package/docs/system/RULES_UPDATE_GUIDE.md +0 -182
  194. package/docs/system/SYSTEM_ANALYSIS.md +0 -947
  195. package/docs/system/SYSTEM_METADATA.json +0 -37
  196. package/documentation.config.schema.json +0 -77
  197. package/publish.ps1 +0 -21
@@ -1,63 +0,0 @@
1
- # Modul: src/generator/dependency-graph.ts
2
-
3
- ### function: appendDependencySection
4
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
5
- Signatur: `appendDependencySection(lines: string[], title: string, deps: ModuleDependency[]): void`
6
- ```ts
7
- appendDependencySection(lines: string[], title: string, deps: ModuleDependency[]): void
8
- ```
9
-
10
- Parameter:
11
-
12
- | Name | Typ | Optional | Default |
13
- |------|-----|----------|---------|
14
- | `deps` | `ModuleDependency[]` | nein | nein |
15
- | `lines` | `string[]` | nein | nein |
16
- | `title` | `string` | nein | nein |
17
-
18
- Rückgabewert: `void`
19
-
20
- ### function: generateDependencyOverview
21
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
22
- Signatur: `generateDependencyOverview(dependencies: ModuleDependency[]): string`
23
- ```ts
24
- generateDependencyOverview(dependencies: ModuleDependency[]): string
25
- ```
26
-
27
- Parameter:
28
-
29
- | Name | Typ | Optional | Default |
30
- |------|-----|----------|---------|
31
- | `dependencies` | `ModuleDependency[]` | nein | nein |
32
-
33
- Rückgabewert: `string`
34
-
35
- ### function: generateMermaidGraph
36
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
37
- Signatur: `generateMermaidGraph(dependencies: ModuleDependency[]): string`
38
- ```ts
39
- generateMermaidGraph(dependencies: ModuleDependency[]): string
40
- ```
41
-
42
- Parameter:
43
-
44
- | Name | Typ | Optional | Default |
45
- |------|-----|----------|---------|
46
- | `dependencies` | `ModuleDependency[]` | nein | nein |
47
-
48
- Rückgabewert: `string`
49
-
50
- ### function: groupDependenciesByFrom
51
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
52
- Signatur: `groupDependenciesByFrom(dependencies: ModuleDependency[]): Map<string, ModuleDependency[]>`
53
- ```ts
54
- groupDependenciesByFrom(dependencies: ModuleDependency[]): Map<string, ModuleDependency[]>
55
- ```
56
-
57
- Parameter:
58
-
59
- | Name | Typ | Optional | Default |
60
- |------|-----|----------|---------|
61
- | `dependencies` | `ModuleDependency[]` | nein | nein |
62
-
63
- Rückgabewert: `Map<string, ModuleDependency[]>`
@@ -1,40 +0,0 @@
1
- # Modul: src/generator/index.ts
2
-
3
- ## Relevante ADRs
4
-
5
- - [ADR-003: Kritische Probleme in der generierten Dokumentation](../adr/003-documentation-generation-bugs.md)
6
- - [ADR-011: module-doc-change-tracking-phase3](../adr/011-module-doc-change-tracking-phase3.md)
7
- - [ADR-012: git-deletions-change-report-phase4](../adr/012-git-deletions-change-report-phase4.md)
8
- - [ADR-023: ADR-Verknüpfung mit Modul-Dokumentation](../adr/023-adr-verknuepfung-modul-doku.md)
9
-
10
- ### function: generatePerFileDocs
11
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
12
- Signatur: `generatePerFileDocs(symbols: ParsedSymbol[], modulesDir: string, existingDocs: Map<string, string>): Map<string, string>`
13
- ```ts
14
- generatePerFileDocs(symbols: ParsedSymbol[], modulesDir: string, existingDocs: Map<string, string>): Map<string, string>
15
- ```
16
-
17
- Parameter:
18
-
19
- | Name | Typ | Optional | Default |
20
- |------|-----|----------|---------|
21
- | `existingDocs` | `Map<string, string>` | nein | nein |
22
- | `modulesDir` | `string` | nein | nein |
23
- | `symbols` | `ParsedSymbol[]` | nein | nein |
24
-
25
- Rückgabewert: `Map<string, string>`
26
-
27
- ### function: makeSafeFileName
28
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
29
- Signatur: `makeSafeFileName(filePath: string): string`
30
- ```ts
31
- makeSafeFileName(filePath: string): string
32
- ```
33
-
34
- Parameter:
35
-
36
- | Name | Typ | Optional | Default |
37
- |------|-----|----------|---------|
38
- | `filePath` | `string` | nein | nein |
39
-
40
- Rückgabewert: `string`
@@ -1,242 +0,0 @@
1
- # Modul: src/generator/module-doc.ts
2
-
3
- ## Relevante ADRs
4
-
5
- - [ADR-011: module-doc-change-tracking-phase3](../adr/011-module-doc-change-tracking-phase3.md)
6
- - [ADR-019: System-Schwachstellen-Analyse und proaktive Fixes](../adr/019-system-schwachstellen-analyse-und-fixes.md)
7
- - [ADR-020: API-Doku-Tiefe & zentrale Signatur-Formatierung](../adr/020-api-doc-tiefe-und-signatureformatter.md)
8
- - [ADR-021: Semantische API-Doku-Tiefe & SymbolClassifier](../adr/021-semantic-api-docs-and-symbol-classifier.md)
9
- - [ADR-022: semantic-class-and-constants-rendering](../adr/022-semantic-class-and-constants-rendering.md)
10
- - [ADR-023: ADR-Verknüpfung mit Modul-Dokumentation](../adr/023-adr-verknuepfung-modul-doku.md)
11
-
12
- <!-- change: symbol-added name="isTrivialNormalizedSignature" kind="function" -->
13
- ### interface: ModuleDoc
14
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
15
- Signatur: `interface ModuleDoc {
16
- blocks: ModuleDocBlock[];
17
- }`
18
- ```ts
19
- interface ModuleDoc {
20
- blocks: ModuleDocBlock[];
21
- }
22
- ```
23
-
24
- Eigenschaften:
25
-
26
- | Name | Typ | Optional |
27
- |------|-----|----------|
28
- | `blocks` | `ModuleDocBlock[]` | nein |
29
-
30
- <!-- change: symbol-added name="normalizeSignature" kind="function" -->
31
- ### interface: ModuleDocBlock
32
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
33
- Signatur: `interface ModuleDocBlock {
34
- comment: string;
35
- symbol: ParsedSymbol;
36
- }`
37
- ```ts
38
- interface ModuleDocBlock {
39
- comment: string;
40
- symbol: ParsedSymbol;
41
- }
42
- ```
43
-
44
- Eigenschaften:
45
-
46
- | Name | Typ | Optional |
47
- |------|-----|----------|
48
- | `comment` | `string` | nein |
49
- | `symbol` | `ParsedSymbol` | nein |
50
-
51
- <!-- change: symbol-added name="parseModuleDoc" kind="function" -->
52
- ### interface: ParsedBlock
53
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
54
- Signatur: `interface ParsedBlock {
55
- fullyQualifiedName: string;
56
- kind: ParsedSymbol['kind'];
57
- signature: SymbolSignature;
58
- comment: string;
59
- symbol: ParsedSymbol;
60
- }`
61
- ```ts
62
- interface ParsedBlock {
63
- fullyQualifiedName: string;
64
- kind: ParsedSymbol['kind'];
65
- signature: SymbolSignature;
66
- comment: string;
67
- symbol: ParsedSymbol;
68
- }
69
- ```
70
-
71
- Eigenschaften:
72
-
73
- | Name | Typ | Optional |
74
- |------|-----|----------|
75
- | `comment` | `string` | nein |
76
- | `fullyQualifiedName` | `string` | nein |
77
- | `kind` | `ParsedSymbol['kind']` | nein |
78
- | `signature` | `SymbolSignature` | nein |
79
- | `symbol` | `ParsedSymbol` | nein |
80
-
81
- <!-- change: symbol-added name="parseSignatureFromCode" kind="function" -->
82
- ### interface: ParsedModuleDoc
83
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
84
- Signatur: `interface ParsedModuleDoc {
85
- blocks: ParsedBlock[];
86
- }`
87
- ```ts
88
- interface ParsedModuleDoc {
89
- blocks: ParsedBlock[];
90
- }
91
- ```
92
-
93
- Eigenschaften:
94
-
95
- | Name | Typ | Optional |
96
- |------|-----|----------|
97
- | `blocks` | `ParsedBlock[]` | nein |
98
-
99
- <!-- change: symbol-added name="renderModuleDoc" kind="function" -->
100
- ### function: buildModuleDocWithChanges
101
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
102
- Signatur: `buildModuleDocWithChanges(symbols: ParsedSymbol[], existingDoc: ParsedModuleDoc): ModuleDoc`
103
- ```ts
104
- buildModuleDocWithChanges(symbols: ParsedSymbol[], existingDoc: ParsedModuleDoc): ModuleDoc
105
- ```
106
-
107
- Parameter:
108
-
109
- | Name | Typ | Optional | Default |
110
- |------|-----|----------|---------|
111
- | `existingDoc` | `ParsedModuleDoc` | nein | nein |
112
- | `symbols` | `ParsedSymbol[]` | nein | nein |
113
-
114
- Rückgabewert: `ModuleDoc`
115
-
116
- <!-- change: symbol-added name="signatureChanged" kind="function" -->
117
- ### function: compareBlocks
118
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
119
- Signatur: `compareBlocks(a: ModuleDocBlock, b: ModuleDocBlock): number`
120
- ```ts
121
- compareBlocks(a: ModuleDocBlock, b: ModuleDocBlock): number
122
- ```
123
-
124
- Parameter:
125
-
126
- | Name | Typ | Optional | Default |
127
- |------|-----|----------|---------|
128
- | `a` | `ModuleDocBlock` | nein | nein |
129
- | `b` | `ModuleDocBlock` | nein | nein |
130
-
131
- Rückgabewert: `number`
132
-
133
- <!-- change: symbol-added name="isFormatterMigration" kind="function" -->
134
- ### function: isTrivialNormalizedSignature
135
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
136
- Signatur: `isTrivialNormalizedSignature(sig: string): boolean`
137
- ```ts
138
- isTrivialNormalizedSignature(sig: string): boolean
139
- ```
140
-
141
- Parameter:
142
-
143
- | Name | Typ | Optional | Default |
144
- |------|-----|----------|---------|
145
- | `sig` | `string` | nein | nein |
146
-
147
- Rückgabewert: `boolean`
148
-
149
- ### function: normalizeSignature
150
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
151
- Signatur: `normalizeSignature(sig: SymbolSignature): string`
152
- ```ts
153
- normalizeSignature(sig: SymbolSignature): string
154
- ```
155
-
156
- Parameter:
157
-
158
- | Name | Typ | Optional | Default |
159
- |------|-----|----------|---------|
160
- | `sig` | `SymbolSignature` | nein | nein |
161
-
162
- Rückgabewert: `string`
163
-
164
- ### function: parseModuleDoc
165
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
166
- Signatur: `parseModuleDoc(content: string): ParsedModuleDoc`
167
- ```ts
168
- parseModuleDoc(content: string): ParsedModuleDoc
169
- ```
170
-
171
- Parameter:
172
-
173
- | Name | Typ | Optional | Default |
174
- |------|-----|----------|---------|
175
- | `content` | `string` | nein | nein |
176
-
177
- Rückgabewert: `ParsedModuleDoc`
178
-
179
- ### function: parseSignatureFromCode
180
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
181
- Signatur: `parseSignatureFromCode(code: string, kind: ParsedSymbol['kind']): SymbolSignature`
182
- ```ts
183
- parseSignatureFromCode(code: string, kind: ParsedSymbol['kind']): SymbolSignature
184
- ```
185
-
186
- Parameter:
187
-
188
- | Name | Typ | Optional | Default |
189
- |------|-----|----------|---------|
190
- | `code` | `string` | nein | nein |
191
- | `kind` | `ParsedSymbol['kind']` | nein | nein |
192
-
193
- Rückgabewert: `SymbolSignature`
194
-
195
- ### function: renderModuleDoc
196
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
197
- Signatur: `renderModuleDoc(doc: ModuleDoc, filePath: string, adrLinker: AdrLinker): string`
198
- ```ts
199
- renderModuleDoc(doc: ModuleDoc, filePath: string, adrLinker: AdrLinker): string
200
- ```
201
-
202
- Parameter:
203
-
204
- | Name | Typ | Optional | Default |
205
- |------|-----|----------|---------|
206
- | `adrLinker` | `AdrLinker` | nein | nein |
207
- | `doc` | `ModuleDoc` | nein | nein |
208
- | `filePath` | `string` | nein | nein |
209
-
210
- Rückgabewert: `string`
211
-
212
- ### function: signatureChanged
213
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
214
- Signatur: `signatureChanged(a: ParsedSymbol, b: ParsedSymbol): boolean`
215
- ```ts
216
- signatureChanged(a: ParsedSymbol, b: ParsedSymbol): boolean
217
- ```
218
-
219
- Parameter:
220
-
221
- | Name | Typ | Optional | Default |
222
- |------|-----|----------|---------|
223
- | `a` | `ParsedSymbol` | nein | nein |
224
- | `b` | `ParsedSymbol` | nein | nein |
225
-
226
- Rückgabewert: `boolean`
227
-
228
- ### function: isFormatterMigration
229
- Rolle: infra (Sichtbarkeit: public, Priorität: low)
230
- Signatur: `isFormatterMigration(oldSig: string, newSig: string): boolean`
231
- ```ts
232
- isFormatterMigration(oldSig: string, newSig: string): boolean
233
- ```
234
-
235
- Parameter:
236
-
237
- | Name | Typ | Optional | Default |
238
- |------|-----|----------|---------|
239
- | `newSig` | `string` | nein | nein |
240
- | `oldSig` | `string` | nein | nein |
241
-
242
- Rückgabewert: `boolean`
@@ -1,159 +0,0 @@
1
- # Modul: src/index/index.ts
2
-
3
- ## Relevante ADRs
4
-
5
- - [ADR-029: Parser-Flow-Kopplung und Sync/Drift-Modi für die Validierung](../adr/029-parser-flow-kopplung-und-sync-drift-modi.md)
6
- - [ADR-030: Dependency Import Symbol Names Preservation (Index JSONL)](../adr/030-dependency-import-symbol-names-preservation.md)
7
- - [ADR-036: Enhanced Dependency Metadata (Aliasing, Type-Only, Re-Exports)](../adr/036-enhanced-dependency-metadata.md)
8
-
9
- ### interface: DependencyAccumulator
10
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
11
- Signatur: `interface DependencyAccumulator {
12
- module: string;
13
- symbols: string[];
14
- isTypeOnly: boolean;
15
- isReexport: boolean;
16
- }`
17
- ```ts
18
- interface DependencyAccumulator {
19
- module: string;
20
- symbols: string[];
21
- isTypeOnly: boolean;
22
- isReexport: boolean;
23
- }
24
- ```
25
-
26
- Eigenschaften:
27
-
28
- | Name | Typ | Optional |
29
- |------|-----|----------|
30
- | `isReexport` | `boolean` | nein |
31
- | `isTypeOnly` | `boolean` | nein |
32
- | `module` | `string` | nein |
33
- | `symbols` | `string[]` | nein |
34
-
35
- ### interface: DependencyEntry
36
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
37
- Signatur: `interface DependencyEntry {
38
- module: string;
39
- symbols?: string[];
40
- isTypeOnly?: boolean;
41
- isReexport?: boolean;
42
- }`
43
- ```ts
44
- interface DependencyEntry {
45
- module: string;
46
- symbols?: string[];
47
- isTypeOnly?: boolean;
48
- isReexport?: boolean;
49
- }
50
- ```
51
-
52
- Eigenschaften:
53
-
54
- | Name | Typ | Optional |
55
- |------|-----|----------|
56
- | `isReexport` | `boolean` | ja |
57
- | `isTypeOnly` | `boolean` | ja |
58
- | `module` | `string` | nein |
59
- | `symbols` | `string[]` | ja |
60
-
61
- ### interface: IndexRow
62
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
63
- Signatur: `interface IndexRow {
64
- symbol_id: string;
65
- path: string;
66
- kind: string;
67
- name: string;
68
- signature?: SymbolSignature;
69
- summary?: string;
70
- dependencies?: string[] | DependencyEntry[];
71
- start_line?: number;
72
- end_line?: number;
73
- start_col?: number;
74
- end_col?: number;
75
- byte_offset_start?: number;
76
- byte_offset_end?: number;
77
- }`
78
- ```ts
79
- interface IndexRow {
80
- symbol_id: string;
81
- path: string;
82
- kind: string;
83
- name: string;
84
- signature?: SymbolSignature;
85
- summary?: string;
86
- dependencies?: string[] | DependencyEntry[];
87
- start_line?: number;
88
- end_line?: number;
89
- start_col?: number;
90
- end_col?: number;
91
- byte_offset_start?: number;
92
- byte_offset_end?: number;
93
- }
94
- ```
95
-
96
- Eigenschaften:
97
-
98
- | Name | Typ | Optional |
99
- |------|-----|----------|
100
- | `byte_offset_end` | `number` | ja |
101
- | `byte_offset_start` | `number` | ja |
102
- | `dependencies` | `string[] | DependencyEntry[]` | ja |
103
- | `end_col` | `number` | ja |
104
- | `end_line` | `number` | ja |
105
- | `kind` | `string` | nein |
106
- | `name` | `string` | nein |
107
- | `path` | `string` | nein |
108
- | `signature` | `SymbolSignature` | ja |
109
- | `start_col` | `number` | ja |
110
- | `start_line` | `number` | ja |
111
- | `summary` | `string` | ja |
112
- | `symbol_id` | `string` | nein |
113
-
114
- ### function: buildIndexFromSymbols
115
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
116
- Signatur: `buildIndexFromSymbols(symbols: ParsedSymbol[], dependencies: DependencyCacheEntry[] = …): IndexRow[]`
117
- ```ts
118
- buildIndexFromSymbols(symbols: ParsedSymbol[], dependencies: DependencyCacheEntry[] = …): IndexRow[]
119
- ```
120
-
121
- Parameter:
122
-
123
- | Name | Typ | Optional | Default |
124
- |------|-----|----------|---------|
125
- | `dependencies` | `DependencyCacheEntry[]` | nein | ja |
126
- | `symbols` | `ParsedSymbol[]` | nein | nein |
127
-
128
- Rückgabewert: `IndexRow[]`
129
-
130
- ### function: readSymbolsFromIndex
131
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
132
- Signatur: `readSymbolsFromIndex(indexFile: string): ParsedSymbol[]`
133
- ```ts
134
- readSymbolsFromIndex(indexFile: string): ParsedSymbol[]
135
- ```
136
-
137
- Parameter:
138
-
139
- | Name | Typ | Optional | Default |
140
- |------|-----|----------|---------|
141
- | `indexFile` | `string` | nein | nein |
142
-
143
- Rückgabewert: `ParsedSymbol[]`
144
-
145
- ### function: writeJsonlIndex
146
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
147
- Signatur: `writeJsonlIndex(rows: IndexRow[], outFile: string): void`
148
- ```ts
149
- writeJsonlIndex(rows: IndexRow[], outFile: string): void
150
- ```
151
-
152
- Parameter:
153
-
154
- | Name | Typ | Optional | Default |
155
- |------|-----|----------|---------|
156
- | `outFile` | `string` | nein | nein |
157
- | `rows` | `IndexRow[]` | nein | nein |
158
-
159
- Rückgabewert: `void`
@@ -1,87 +0,0 @@
1
- # Modul: src/logging/index.ts
2
-
3
- ### class: Logger
4
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
5
- Signatur: `class Logger`
6
- ```ts
7
- class Logger
8
- ```
9
-
10
- Diese Klasse bündelt 3 Methoden. Die detaillierten Signaturen sind in den nachfolgenden `method:`-Abschnitten dokumentiert.
11
-
12
- ### interface: LoggerOptions
13
- Rolle: config (Sichtbarkeit: public, Priorität: normal)
14
- Signatur: `interface LoggerOptions {
15
- component: string;
16
- }`
17
- ```ts
18
- interface LoggerOptions {
19
- component: string;
20
- }
21
- ```
22
-
23
- Eigenschaften:
24
-
25
- | Name | Typ | Optional |
26
- |------|-----|----------|
27
- | `component` | `string` | nein |
28
-
29
- ### method: Logger.error
30
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
31
- Signatur: `error(message: string, err: unknown): void`
32
- ```ts
33
- error(message: string, err: unknown): void
34
- ```
35
-
36
- Parameter:
37
-
38
- | Name | Typ | Optional | Default |
39
- |------|-----|----------|---------|
40
- | `err` | `unknown` | nein | nein |
41
- | `message` | `string` | nein | nein |
42
-
43
- Rückgabewert: `void`
44
-
45
- ### method: Logger.info
46
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
47
- Signatur: `info(message: string): void`
48
- ```ts
49
- info(message: string): void
50
- ```
51
-
52
- Parameter:
53
-
54
- | Name | Typ | Optional | Default |
55
- |------|-----|----------|---------|
56
- | `message` | `string` | nein | nein |
57
-
58
- Rückgabewert: `void`
59
-
60
- ### method: Logger.warn
61
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
62
- Signatur: `warn(message: string): void`
63
- ```ts
64
- warn(message: string): void
65
- ```
66
-
67
- Parameter:
68
-
69
- | Name | Typ | Optional | Default |
70
- |------|-----|----------|---------|
71
- | `message` | `string` | nein | nein |
72
-
73
- Rückgabewert: `void`
74
-
75
- ### variable: Logger.component
76
- Rolle: other (Sichtbarkeit: internal, Priorität: low)
77
- Signatur: `component: string`
78
- ```ts
79
- component: string
80
- ```
81
-
82
- ### type: LogLevel
83
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
84
- Signatur: `type LogLevel`
85
- ```ts
86
- type LogLevel
87
- ```
@@ -1,69 +0,0 @@
1
- # Modul: src/parsers/dependencies.ts
2
-
3
- ## Relevante ADRs
4
-
5
- - [ADR-036: Enhanced Dependency Metadata (Aliasing, Type-Only, Re-Exports)](../adr/036-enhanced-dependency-metadata.md)
6
-
7
- ### interface: ModuleDependency
8
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
9
- Signatur: `interface ModuleDependency {
10
- from: string;
11
- to: string;
12
- type: 'import' | 'export' | 'require';
13
- symbols?: string[];
14
- isTypeOnly?: boolean;
15
- isReexport?: boolean;
16
- }`
17
- ```ts
18
- interface ModuleDependency {
19
- from: string;
20
- to: string;
21
- type: 'import' | 'export' | 'require';
22
- symbols?: string[];
23
- isTypeOnly?: boolean;
24
- isReexport?: boolean;
25
- }
26
- ```
27
-
28
- Eigenschaften:
29
-
30
- | Name | Typ | Optional |
31
- |------|-----|----------|
32
- | `from` | `string` | nein |
33
- | `isReexport` | `boolean` | ja |
34
- | `isTypeOnly` | `boolean` | ja |
35
- | `symbols` | `string[]` | ja |
36
- | `to` | `string` | nein |
37
- | `type` | `'import' | 'export' | 'require'` | nein |
38
-
39
- ### function: extractPythonDependencies
40
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
41
- Signatur: `extractPythonDependencies(content: string, repoRelPath: string): ModuleDependency[]`
42
- ```ts
43
- extractPythonDependencies(content: string, repoRelPath: string): ModuleDependency[]
44
- ```
45
-
46
- Parameter:
47
-
48
- | Name | Typ | Optional | Default |
49
- |------|-----|----------|---------|
50
- | `content` | `string` | nein | nein |
51
- | `repoRelPath` | `string` | nein | nein |
52
-
53
- Rückgabewert: `ModuleDependency[]`
54
-
55
- ### function: extractTsJsDependencies
56
- Rolle: other (Sichtbarkeit: public, Priorität: normal)
57
- Signatur: `extractTsJsDependencies(sourceFile: SourceFile, repoRelPath: string): ModuleDependency[]`
58
- ```ts
59
- extractTsJsDependencies(sourceFile: SourceFile, repoRelPath: string): ModuleDependency[]
60
- ```
61
-
62
- Parameter:
63
-
64
- | Name | Typ | Optional | Default |
65
- |------|-----|----------|---------|
66
- | `repoRelPath` | `string` | nein | nein |
67
- | `sourceFile` | `SourceFile` | nein | nein |
68
-
69
- Rückgabewert: `ModuleDependency[]`