@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,336 +0,0 @@
1
- ```mermaid
2
- graph TD
3
- N0["../cache/ast-cache"]
4
- N1["../cache/dependencies-cache"]
5
- N2["../cache/output-cache"]
6
- N3["../cache/signature-cache"]
7
- N4["../constants.js"]
8
- N5["../core/consolidation"]
9
- N6["../core/git"]
10
- N7["../core/scanner"]
11
- N8["../core/signature-formatter"]
12
- N9["../core/symbol-classifier"]
13
- N10["../core/symbols"]
14
- N11["../drift/index"]
15
- N12["../generator/change-report"]
16
- N13["../generator/dependency-graph"]
17
- N14["../generator/index"]
18
- N15["../index/index"]
19
- N16["../logging/index"]
20
- N17["../parsers/dependencies"]
21
- N18["../parsers/json-yaml"]
22
- N19["../parsers/python"]
23
- N20["../parsers/ts-js"]
24
- N21["../parsers/types"]
25
- N22["../types.js"]
26
- N23["../validator/index"]
27
- N24["./adr-linker"]
28
- N25["./cache/ast-cache"]
29
- N26["./cache/dependencies-cache"]
30
- N27["./cache/output-cache"]
31
- N28["./cache/signature-cache"]
32
- N29["./cli/init.js"]
33
- N30["./cli/update.js"]
34
- N31["./constants.js"]
35
- N32["./core/async"]
36
- N33["./core/consolidation"]
37
- N34["./core/git"]
38
- N35["./core/scanner"]
39
- N36["./drift/index"]
40
- N37["./generator/change-report"]
41
- N38["./generator/dependency-graph"]
42
- N39["./generator/index"]
43
- N40["./index/index"]
44
- N41["./init.js"]
45
- N42["./language-detection"]
46
- N43["./mcp/server.js"]
47
- N44["./mcp/types.js"]
48
- N45["./module-doc"]
49
- N46["./parsers/dependencies"]
50
- N47["./parsers/json-yaml"]
51
- N48["./parsers/python"]
52
- N49["./parsers/ts-js"]
53
- N50["./parsers/types"]
54
- N51["./signature-matching"]
55
- N52["./status"]
56
- N53["./symbols"]
57
- N54["./types"]
58
- N55["./ui/commands-provider"]
59
- N56["./ui/status-bar"]
60
- N57["./update.js"]
61
- N58["./validator/index"]
62
- N59["./validator/status"]
63
- N60["_jest/globals"]
64
- N61["child_process"]
65
- N62["commander"]
66
- N63["crypto"]
67
- N64["fs"]
68
- N65["ignore"]
69
- N66["mcp/src/resources/docs.ts"]
70
- N67["mcp/src/tools/drift.ts"]
71
- N68["mcp/src/tools/impact.ts"]
72
- N69["mcp/src/tools/scan.ts"]
73
- N70["mcp/src/tools/validate.ts"]
74
- N71["mcp/src/tools/verify-adrs.ts"]
75
- N72["node_child_process"]
76
- N73["node_fs"]
77
- N74["node_fs/promises"]
78
- N75["node_path"]
79
- N76["node_readline"]
80
- N77["node_url"]
81
- N78["node_util"]
82
- N79["os"]
83
- N80["packages/doc-system-agent/src/cli/index.ts"]
84
- N81["packages/doc-system-agent/src/cli/init.ts"]
85
- N82["packages/doc-system-agent/src/cli/update.ts"]
86
- N83["packages/doc-system-agent/src/index.ts"]
87
- N84["packages/doc-system-agent/src/mcp/resources/docs.ts"]
88
- N85["packages/doc-system-agent/src/mcp/tools/drift.ts"]
89
- N86["packages/doc-system-agent/src/mcp/tools/impact.ts"]
90
- N87["packages/doc-system-agent/src/mcp/tools/scan.ts"]
91
- N88["packages/doc-system-agent/src/mcp/tools/validate.ts"]
92
- N89["packages/doc-system-agent/src/mcp/tools/verify-adrs.ts"]
93
- N90["path"]
94
- N91["src/__tests__/determinism.test.ts"]
95
- N92["src/__tests__/parser-symbol-types.test.ts"]
96
- N93["src/__tests__/setup.ts"]
97
- N94["src/__tests__/signature-formatter.test.ts"]
98
- N95["src/__tests__/snapshot-doc-generation.test.ts"]
99
- N96["src/__tests__/symbol-classifier.test.ts"]
100
- N97["src/cache/ast-cache.ts"]
101
- N98["src/cache/dependencies-cache.ts"]
102
- N99["src/cache/output-cache.ts"]
103
- N100["src/cache/signature-cache.ts"]
104
- N101["src/cli/generate-cli.ts"]
105
- N102["src/cli/scan-cli.ts"]
106
- N103["src/cli/validate-cli.ts"]
107
- N104["src/core/consolidation.ts"]
108
- N105["src/core/git.ts"]
109
- N106["src/core/scanner.ts"]
110
- N107["src/core/signature-formatter.ts"]
111
- N108["src/core/symbol-classifier.ts"]
112
- N109["src/core/symbols.ts"]
113
- N110["src/drift/index.ts"]
114
- N111["src/extension.ts"]
115
- N112["src/generator/adr-linker.ts"]
116
- N113["src/generator/dependency-graph.ts"]
117
- N114["src/generator/index.ts"]
118
- N115["src/generator/module-doc.ts"]
119
- N116["src/index/index.ts"]
120
- N117["src/parsers/dependencies.ts"]
121
- N118["src/parsers/json-yaml.ts"]
122
- N119["src/parsers/python.ts"]
123
- N120["src/parsers/ts-js.ts"]
124
- N121["src/ui/commands-provider.ts"]
125
- N122["src/ui/status-bar.ts"]
126
- N123["src/validator/index.ts"]
127
- N124["src/validator/signature-matching.ts"]
128
- N125["tree-sitter"]
129
- N126["tree-sitter-python"]
130
- N127["ts-morph"]
131
- N128["vscode"]
132
- N129["yaml"]
133
-
134
- N100 --> N64
135
- N100 --> N90
136
- N101 --> N0
137
- N101 --> N1
138
- N101 --> N11
139
- N101 --> N12
140
- N101 --> N13
141
- N101 --> N14
142
- N101 --> N15
143
- N101 --> N17
144
- N101 --> N18
145
- N101 --> N19
146
- N101 --> N2
147
- N101 --> N20
148
- N101 --> N21
149
- N101 --> N3
150
- N101 --> N5
151
- N101 --> N6
152
- N101 --> N64
153
- N101 --> N7
154
- N101 --> N90
155
- N102 --> N18
156
- N102 --> N19
157
- N102 --> N20
158
- N102 --> N21
159
- N102 --> N64
160
- N102 --> N7
161
- N102 --> N90
162
- N103 --> N15
163
- N103 --> N18
164
- N103 --> N19
165
- N103 --> N20
166
- N103 --> N21
167
- N103 --> N23
168
- N103 --> N64
169
- N103 --> N7
170
- N103 --> N90
171
- N104 --> N1
172
- N104 --> N17
173
- N104 --> N21
174
- N104 --> N53
175
- N105 --> N61
176
- N106 --> N16
177
- N106 --> N42
178
- N106 --> N65
179
- N106 --> N73
180
- N106 --> N75
181
- N107 --> N21
182
- N108 --> N21
183
- N109 --> N21
184
- N109 --> N63
185
- N110 --> N10
186
- N110 --> N21
187
- N110 --> N3
188
- N111 --> N128
189
- N111 --> N25
190
- N111 --> N26
191
- N111 --> N27
192
- N111 --> N28
193
- N111 --> N32
194
- N111 --> N33
195
- N111 --> N34
196
- N111 --> N35
197
- N111 --> N36
198
- N111 --> N37
199
- N111 --> N38
200
- N111 --> N39
201
- N111 --> N40
202
- N111 --> N46
203
- N111 --> N47
204
- N111 --> N48
205
- N111 --> N49
206
- N111 --> N50
207
- N111 --> N55
208
- N111 --> N56
209
- N111 --> N58
210
- N111 --> N59
211
- N111 --> N64
212
- N111 --> N90
213
- N112 --> N73
214
- N112 --> N75
215
- N113 --> N17
216
- N114 --> N21
217
- N114 --> N24
218
- N114 --> N45
219
- N114 --> N73
220
- N114 --> N75
221
- N115 --> N21
222
- N115 --> N24
223
- N115 --> N8
224
- N115 --> N9
225
- N116 --> N1
226
- N116 --> N10
227
- N116 --> N21
228
- N116 --> N64
229
- N116 --> N90
230
- N117 --> N127
231
- N118 --> N129
232
- N118 --> N54
233
- N118 --> N90
234
- N119 --> N125
235
- N119 --> N126
236
- N119 --> N54
237
- N119 --> N90
238
- N120 --> N127
239
- N120 --> N54
240
- N120 --> N90
241
- N121 --> N128
242
- N122 --> N128
243
- N123 --> N16
244
- N123 --> N21
245
- N123 --> N51
246
- N123 --> N52
247
- N123 --> N64
248
- N123 --> N90
249
- N124 --> N21
250
- N124 --> N8
251
- N124 --> N9
252
- N66 --> N74
253
- N66 --> N75
254
- N67 --> N72
255
- N67 --> N74
256
- N67 --> N75
257
- N67 --> N78
258
- N68 --> N73
259
- N68 --> N75
260
- N68 --> N76
261
- N69 --> N72
262
- N69 --> N78
263
- N70 --> N72
264
- N70 --> N78
265
- N71 --> N72
266
- N71 --> N78
267
- N80 --> N4
268
- N80 --> N41
269
- N80 --> N57
270
- N80 --> N62
271
- N81 --> N4
272
- N81 --> N74
273
- N81 --> N75
274
- N81 --> N77
275
- N82 --> N4
276
- N82 --> N74
277
- N82 --> N75
278
- N82 --> N77
279
- N83 --> N29
280
- N83 --> N30
281
- N83 --> N31
282
- N83 --> N43
283
- N83 --> N44
284
- N84 --> N74
285
- N84 --> N75
286
- N85 --> N22
287
- N85 --> N72
288
- N85 --> N74
289
- N85 --> N75
290
- N85 --> N78
291
- N86 --> N22
292
- N86 --> N73
293
- N86 --> N75
294
- N86 --> N76
295
- N87 --> N22
296
- N87 --> N72
297
- N87 --> N78
298
- N88 --> N22
299
- N88 --> N72
300
- N88 --> N78
301
- N89 --> N72
302
- N89 --> N78
303
- N91 --> N10
304
- N91 --> N14
305
- N91 --> N15
306
- N91 --> N17
307
- N91 --> N20
308
- N91 --> N64
309
- N91 --> N7
310
- N91 --> N79
311
- N91 --> N90
312
- N92 --> N18
313
- N92 --> N20
314
- N92 --> N8
315
- N93 --> N60
316
- N94 --> N21
317
- N94 --> N8
318
- N95 --> N14
319
- N95 --> N15
320
- N95 --> N20
321
- N95 --> N21
322
- N95 --> N5
323
- N95 --> N64
324
- N95 --> N79
325
- N95 --> N90
326
- N96 --> N21
327
- N96 --> N9
328
- N97 --> N63
329
- N97 --> N64
330
- N97 --> N90
331
- N98 --> N64
332
- N98 --> N90
333
- N99 --> N63
334
- N99 --> N64
335
- N99 --> N90
336
- ```
@@ -1,244 +0,0 @@
1
- # Mehrdimensionaler Navigationsraum - Analyse
2
-
3
- **Zweck:** Analyse, ob das aktuelle System als mehrdimensionaler Navigationsraum für KI-Agenten funktioniert
4
-
5
- ## Frage
6
-
7
- > "Das Ziel war es, die ADRs als Wissensquelle zu nutzen und die docs/modules, docs/index und docs/system als Koordinaten zu sehen, damit sich ein Agent oder eine KI in einem mehrdimensionalen Raum bewegen kann. Funktioniert das momentan auf dem aktuellen Systemstand?"
8
-
9
- ## Antwort: ✅ JA, mit Einschränkungen
10
-
11
- ### Was funktioniert
12
-
13
- #### 1. Koordinaten-System existiert ✅ (ADR-024)
14
-
15
- Das Documentation-System-Plugin generiert bereits ein **funktionierendes Koordinaten-System** mit 5 Dimensionen:
16
-
17
- | Dimension | Artefakt | Status | Zugriff |
18
- |-----------|----------|--------|---------|
19
- | **Modul-Raum (X)** | `docs/modules/*.md` | ✅ 71 Module | `docs://modules/{path}` |
20
- | **Symbol-Raum (Y)** | `docs/index/symbols.jsonl` | ✅ 445 Zeilen | `docs://index/symbols.jsonl` |
21
- | **Beziehungs-Raum (Z)** | `docs/system/DEPENDENCY_GRAPH.md` | ✅ 127 Knoten | `docs://system/graph` |
22
- | **Wissens-Raum (W)** | `docs/adr/*.md` | ✅ 26 ADRs | `docs://adr/{name}` |
23
- | **Zeit-Raum (T)** | `docs/system/CHANGE_REPORT.md` | ✅ Implementiert | `docs://system/changes` |
24
-
25
- **Zeit-Dimension (T):**
26
- - Change Report zeigt neu hinzugefügte/geänderte Symbole
27
- - Dependency-Änderungen werden erfasst
28
- - Ermöglicht Änderungsmuster zu erkennen
29
- - Integration mit Database Plugin (ADR-034): Change-Records in Workspace-DB
30
-
31
- #### 2. MCP-Server ermöglicht Agent-Zugriff ✅ (ADR-025)
32
-
33
- Der MCP-Server (`mcp/` und `packages/doc-system-agent/`) bietet strukturierte Zugriffe:
34
-
35
- **Resources (99 insgesamt):**
36
- - 4 System-Resources: `graph`, `dependencies`, `changes`, `symbols.jsonl`
37
- - 71 Modul-Resources: `docs://modules/{path}`
38
- - 24 ADR-Resources: `docs://adr/{name}`
39
-
40
- **Tools:**
41
- ```typescript
42
- // Modul-Dokumentation lesen
43
- readDocsResource('docs://modules/src__parsers__ts-js.ts.md')
44
-
45
- // Dependency-Graph abrufen
46
- readDocsResource('docs://system/graph')
47
-
48
- // Change Report abrufen (Zeit-Dimension)
49
- readDocsResource('docs://system/changes')
50
-
51
- // ADRs lesen
52
- readDocsResource('docs://adr/020-api-doc-tiefe-und-signatureformatter.md')
53
-
54
- // Impact-Analyse durchführen
55
- analyzeImpact({ file: 'src/parsers/ts-js.ts', symbol: 'TsJsParser' })
56
-
57
- // Scan via CLI-Bridge
58
- runScan({ workspaceRoot: '...' })
59
-
60
- // Validate via CLI-Bridge
61
- runValidate({ workspaceRoot: '...' })
62
- ```
63
-
64
- #### 3. Database Plugin persistiert Koordinaten ✅
65
-
66
- Der Database Plugin liest die `docs/` Artefakte und persistiert sie in SQLite (Hybrid-Architektur, ADR-035):
67
- - **Registry-DB**: Plugin-Registrierungen (global)
68
- - **Workspace-DB**: Workspace-spezifische Daten
69
- - Symbole mit Metadaten
70
- - Dependencies mit Beziehungen
71
- - Snapshots für Zeitvergleiche
72
- - **ADR-Verknüpfungen** (neu, ADR-034)
73
- - **Change-Records** (neu, ADR-034)
74
-
75
- #### 4. Semantic Brain Plugin berechnet Intelligence 🔄
76
-
77
- Das Semantic Brain Plugin transformiert die Rohdaten in semantische Strukturen:
78
- - Graph mit Nodes & Edges
79
- - Embeddings für Similarity
80
- - Centrality-Metriken
81
-
82
- **Einschränkung:** APIs fehlen noch für direkten Agent-Zugriff
83
-
84
- ### Was noch fehlt
85
-
86
- #### 1. Semantic Brain APIs ❌
87
-
88
- Die Semantic Brain APIs (`graph-api.ts`, `similarity-api.ts`, etc.) sind noch nicht implementiert, daher können Agenten noch nicht direkt:
89
- - Graph-Nachbarschaften abrufen
90
- - Ähnliche Symbole finden
91
- - Semantische Suche durchführen
92
-
93
- #### 2. Context/RAG Plugin ❌
94
-
95
- Das Context/RAG Plugin, das die semantischen Daten für AI-Agenten aufbereitet, ist noch nicht implementiert.
96
-
97
- #### 3. Bidirektionale ADR-Verknüpfung ✅ (ADR-034)
98
-
99
- ADR-034 implementiert vollständige ADR-Verknüpfungen:
100
- - ✅ Module → ADR: `getAdrsForModule(moduleFilePath)` - Welche ADRs betreffen ein Modul?
101
- - ✅ ADR → Module: `getModulesForAdr(adrId)` - Welche Module betreffen ein ADR?
102
- - ✅ Persistiert in Workspace-DB (`adr_relations` Tabelle)
103
-
104
- ## Funktionsweise
105
-
106
- ### Beispiel: Agent möchte Parser-Module verstehen
107
-
108
- ```typescript
109
- // 1. Modul-Raum: Parser-Module finden
110
- const parserModules = await listModuleDocs()
111
- .then(files => files.filter(f => f.includes('parser')));
112
-
113
- // 2. Symbol-Raum: Symbole in Parser-Modulen analysieren
114
- const symbols = await readDocsResource('docs://index/symbols.jsonl')
115
- .then(content => content.split('\n')
116
- .map(line => JSON.parse(line))
117
- .filter(s => parserModules.some(m => s.path.includes(m))));
118
-
119
- // 3. Beziehungs-Raum: Dependencies verstehen
120
- const graph = await readDocsResource('docs://system/graph');
121
- // Mermaid-Graph zeigt: parser → core → symbols
122
-
123
- // 4. Wissens-Raum: Architektur-Entscheidungen lesen
124
- // Via MCP-Server (ADR-023): ADR-Links direkt in Modul-Doku
125
- const adrs = await readDocsResource('docs://modules/src__parsers__ts-js.ts.md')
126
- .then(content => {
127
- // ADR-Links extrahieren (ADR-023)
128
- const adrMatches = content.match(/\[ADR-\d+.*?\]\(.*?\)/g);
129
- return adrMatches || [];
130
- });
131
- // Oder via Database Plugin (ADR-034):
132
- const adrs = await databaseApi.getAdrsForModule('src/parsers/ts-js.ts');
133
-
134
- // 5. Zeit-Raum: Änderungen analysieren (Change Report)
135
- // Via MCP-Server:
136
- const changeReport = await readDocsResource('docs://system/changes');
137
- // Via Database Plugin (ADR-034):
138
- const changes = await databaseApi.getRecentChanges(snapshotId);
139
- const addedSymbols = await databaseApi.getChangesByType(snapshotId, 'added');
140
- const fileChanges = await databaseApi.getChangesForFile('src/parsers/ts-js.ts');
141
-
142
- // 6. Impact-Analyse: Was würde eine Änderung beeinflussen?
143
- const impact = await analyzeImpact({
144
- file: 'src/parsers/ts-js.ts',
145
- symbol: 'TsJsParser'
146
- });
147
- // Zeigt: directDependents, transitiveDependents, impactLevel
148
- ```
149
-
150
- ### Beispiel: Semantische Suche (geplant)
151
-
152
- ```typescript
153
- // Mit Semantic Brain APIs (noch zu implementieren):
154
- const similar = await semanticBrain.findSimilarNodes({
155
- nodeId: 'parser-ts-js',
156
- similarityTypes: ['structural', 'semantic'],
157
- minSimilarity: 0.7,
158
- limit: 10
159
- });
160
-
161
- // Mit Context/RAG Plugin (geplant):
162
- const context = await ragEngine.assembleContext({
163
- query: 'How do parsers work?',
164
- scope: { filePaths: ['src/parsers/**'] },
165
- intent: 'explanation'
166
- });
167
- ```
168
-
169
- ## Fazit
170
-
171
- ### ✅ Funktioniert bereits
172
-
173
- 1. **Koordinaten-System** - Alle 5 Dimensionen existieren (ADR-024)
174
- - Modul-Raum (X), Symbol-Raum (Y), Beziehungs-Raum (Z), Wissens-Raum (W), Zeit-Raum (T)
175
- 2. **MCP-Server Zugriff** - 99 Resources für strukturierte APIs (ADR-025)
176
- - CLI-Bridge-Pattern für Scan/Validate
177
- - Dynamisches Laden von Modulen und ADRs
178
- 3. **Impact-Analyse** - Dependency-Traversierung funktioniert
179
- 4. **ADR-Verknüpfung** - ✅ Vollständig implementiert (ADR-023, ADR-034)
180
- - Module → ADR: Automatisch in Modul-Doku eingefügt (ADR-023)
181
- - Module → ADR: `getAdrsForModule()` via Database Plugin (ADR-034)
182
- - ADR → Module: `getModulesForAdr()` via Database Plugin (ADR-034)
183
- 5. **Change-Records** - ✅ Implementiert (ADR-034)
184
- - Symbol-Änderungen (added/modified/removed)
185
- - Change-Report-Integration
186
- - Zeit-Dimension für Änderungsmuster
187
- 6. **Hybrid-Datenbank-Architektur** - ✅ Implementiert (ADR-035)
188
- - Registry-DB für Plugin-Registrierungen
189
- - Workspace-DB für Plugin-Daten
190
- - Automatische Migration
191
- 7. **Semantische Features** - ✅ Implementiert (ADR-020, ADR-021, ADR-022)
192
- - SignatureFormatter: Zentrale Signatur-Formatierung
193
- - SymbolClassifier: Rollenbasierte Doku-Tiefe und Validierung
194
- - Semantisches Rendering: Klassen und Konstanten strukturiert
195
- 8. **Reality-Driven Development** - ✅ Implementiert (ADR-026)
196
- - Verification-Scripts: Architektur, ADRs, Imports
197
- - Pre-Commit Hooks und CI/CD Integration
198
- - Evidence-basierte Claims
199
-
200
- ### 🔄 In Arbeit
201
-
202
- 1. **Semantic Brain APIs** - Graph- und Similarity-Zugriff fehlt noch
203
-
204
- ### ❌ Noch nicht implementiert
205
-
206
- 1. **Context/RAG Plugin** - AI-Agent Integration fehlt
207
- 2. **Semantische Suche** - Ähnlichkeits-basierte Navigation fehlt
208
-
209
- ## Empfehlung
210
-
211
- Das System **funktioniert bereits** als mehrdimensionaler Navigationsraum für **grundlegende und erweiterte Navigation**:
212
-
213
- - ✅ Modul-Navigation (docs/modules) - Mit ADR-Links und semantischem Rendering
214
- - ✅ Symbol-Navigation (docs/index/symbols.jsonl) - Mit Dependencies
215
- - ✅ Dependency-Navigation (docs/system/DEPENDENCY_GRAPH.md) - 127 Knoten
216
- - ✅ Wissens-Navigation (docs/adr) - 26 ADRs automatisch verknüpft
217
- - ✅ Zeit-Navigation (docs/system/CHANGE_REPORT.md) - Änderungsmuster erkennbar
218
- - ✅ MCP-Server-Integration - 99 Resources für strukturierten Zugriff
219
- - ✅ Semantische Klassifizierung - Rollenbasierte Doku-Tiefe und Validierung
220
- - ✅ Reality-Driven Development - Verification-Loops verhindern Halluzinationen
221
-
222
- Für **erweiterte semantische Navigation** müssen noch implementiert werden:
223
-
224
- - 🔄 Semantic Brain APIs - Graph- und Similarity-Zugriff fehlt noch
225
- - ❌ Context/RAG Plugin - AI-Agent Integration fehlt
226
-
227
- **Priorität:** Semantic Brain APIs implementieren, damit Agenten Graph- und Similarity-Zugriff haben.
228
-
229
- ---
230
-
231
- **Referenzen:**
232
- - Systemanalyse: `docs/system/SYSTEM_ANALYSIS.md` - Umfassende Systemanalyse mit Diagrammen
233
- - Plugin-Ecosystem Status: `docs/system/PLUGIN_ECOSYSTEM_STATUS.md`
234
- - MVP-Pläne Update Guide: `docs/system/MVP_PLANS_UPDATE_GUIDE.md`
235
- - ADR-020: `docs/adr/020-api-doc-tiefe-und-signatureformatter.md` - SignatureFormatter
236
- - ADR-021: `docs/adr/021-semantic-api-docs-and-symbol-classifier.md` - SymbolClassifier
237
- - ADR-022: `docs/adr/022-semantic-class-and-constants-rendering.md` - Semantisches Rendering
238
- - ADR-023: `docs/adr/023-adr-verknuepfung-modul-doku.md` - ADR-Linking
239
- - ADR-024: `docs/adr/024-cursor-rules-mehrdimensionaler-raum.md` - Mehrdimensionaler Raum
240
- - ADR-025: `docs/adr/025-mcp-tools-scan-validate-cli-bridge.md` - MCP-Server CLI-Bridge
241
- - ADR-026: `docs/adr/026-reality-driven-development-system.md` - Reality-Driven Development
242
- - ADR-034: `docs/adr/034-adr-change-integration.md` (Database Plugin: ADR- und Change-Integration)
243
- - ADR-035: `docs/adr/035-hybrid-database-architecture.md` (Database Plugin: Hybrid-Datenbank-Architektur)
244
-
@@ -1,85 +0,0 @@
1
- # NPX Cache Problem - Lösung
2
-
3
- **Problem:** `npx @noyrax/cli update-rules` gibt "unknown command" zurück, obwohl der Command existiert.
4
-
5
- ## Ursache
6
-
7
- NPX verwendet eine **gecachte Version** des Packages aus dem npm-Cache. Wenn das Package lokal aktualisiert wurde, aber noch nicht auf npm veröffentlicht wurde, verwendet npx die alte Version.
8
-
9
- ## Lösungen
10
-
11
- ### Lösung 1: NPX Cache leeren
12
-
13
- ```bash
14
- # NPX Cache leeren
15
- npx clear-npx-cache
16
-
17
- # Oder manuell
18
- rm -rf ~/.npm/_npx
19
- ```
20
-
21
- Dann erneut versuchen:
22
- ```bash
23
- npx @noyrax/cli update-rules
24
- ```
25
-
26
- ### Lösung 2: Lokales Package verwenden (für Entwicklung)
27
-
28
- Wenn das Package lokal gebaut wurde, aber noch nicht veröffentlicht:
29
-
30
- ```bash
31
- # Im documentation-system-plugin Verzeichnis
32
- cd packages/doc-system-agent
33
- npm link
34
-
35
- # Im database-plugin Verzeichnis
36
- cd D:\Extensions\database-plugin
37
- npm link @noyrax/cli
38
-
39
- # Dann verwenden
40
- npx @noyrax/cli update-rules
41
- ```
42
-
43
- ### Lösung 3: Direktes Ausführen (wenn lokal verfügbar)
44
-
45
- ```bash
46
- # Wenn das Package lokal gebaut wurde
47
- node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js update-rules
48
- ```
49
-
50
- ### Lösung 4: Package-Version erzwingen
51
-
52
- ```bash
53
- # Spezifische Version verwenden
54
- npx @noyrax/cli@1.1.0 update-rules
55
-
56
- # Oder neueste Version erzwingen
57
- npx -y @noyrax/cli@latest update-rules
58
- ```
59
-
60
- ## Verifizierung
61
-
62
- Prüfe, welche Version npx verwendet:
63
-
64
- ```bash
65
- # Version prüfen
66
- npx @noyrax/cli info
67
-
68
- # Sollte zeigen:
69
- # Package-Version: 1.1.0
70
- # Rules-Version: 2
71
- ```
72
-
73
- Wenn noch Version 1.0.0 angezeigt wird, verwendet npx eine alte Version.
74
-
75
- ## Empfehlung
76
-
77
- Für lokale Entwicklung:
78
- 1. Package lokal linken (`npm link`)
79
- 2. Oder direkt aus dem dist-Verzeichnis ausführen
80
-
81
- Für Produktion:
82
- 1. Package auf npm veröffentlichen
83
- 2. NPX Cache leeren
84
- 3. Dann `npx @noyrax/cli update-rules` verwenden
85
-