@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.
- package/out/cache/ast-cache.js +69 -0
- package/out/cache/ast-cache.js.map +1 -0
- package/out/cache/dependencies-cache.js +73 -0
- package/out/cache/dependencies-cache.js.map +1 -0
- package/out/cache/output-cache.js +69 -0
- package/out/cache/output-cache.js.map +1 -0
- package/out/cache/signature-cache.js +60 -0
- package/out/cache/signature-cache.js.map +1 -0
- package/out/cli/generate-cli.js +345 -0
- package/out/cli/generate-cli.js.map +1 -0
- package/out/cli/scan-cli.js +157 -0
- package/out/cli/scan-cli.js.map +1 -0
- package/out/cli/validate-cli.js +258 -0
- package/out/cli/validate-cli.js.map +1 -0
- package/out/core/async.js +38 -0
- package/out/core/async.js.map +1 -0
- package/out/core/consolidation.js +230 -0
- package/out/core/consolidation.js.map +1 -0
- package/out/core/git.js +48 -0
- package/out/core/git.js.map +1 -0
- package/out/core/language-detection.js +29 -0
- package/out/core/language-detection.js.map +1 -0
- package/out/core/scanner.js +180 -0
- package/out/core/scanner.js.map +1 -0
- package/out/core/signature-formatter.js +162 -0
- package/out/core/signature-formatter.js.map +1 -0
- package/out/core/symbol-classifier.js +96 -0
- package/out/core/symbol-classifier.js.map +1 -0
- package/out/core/symbols.js +24 -0
- package/out/core/symbols.js.map +1 -0
- package/out/drift/index.js +28 -0
- package/out/drift/index.js.map +1 -0
- package/out/extension.js +984 -0
- package/out/extension.js.map +1 -0
- package/out/generator/adr-linker.js +216 -0
- package/out/generator/adr-linker.js.map +1 -0
- package/out/generator/change-report.js +124 -0
- package/out/generator/change-report.js.map +1 -0
- package/out/generator/dependency-graph.js +98 -0
- package/out/generator/dependency-graph.js.map +1 -0
- package/out/generator/index.js +117 -0
- package/out/generator/index.js.map +1 -0
- package/out/generator/module-doc.js +438 -0
- package/out/generator/module-doc.js.map +1 -0
- package/out/generator/system-metadata.js +202 -0
- package/out/generator/system-metadata.js.map +1 -0
- package/out/index/index.js +161 -0
- package/out/index/index.js.map +1 -0
- package/out/logging/index.js +24 -0
- package/out/logging/index.js.map +1 -0
- package/out/parsers/dependencies.js +126 -0
- package/out/parsers/dependencies.js.map +1 -0
- package/out/parsers/json-yaml.js +121 -0
- package/out/parsers/json-yaml.js.map +1 -0
- package/out/parsers/python.js +160 -0
- package/out/parsers/python.js.map +1 -0
- package/out/parsers/ts-js.js +598 -0
- package/out/parsers/ts-js.js.map +1 -0
- package/out/parsers/types.js +3 -0
- package/out/parsers/types.js.map +1 -0
- package/out/ui/commands-provider.js +91 -0
- package/out/ui/commands-provider.js.map +1 -0
- package/out/ui/status-bar.js +85 -0
- package/out/ui/status-bar.js.map +1 -0
- package/out/validator/index.js +185 -0
- package/out/validator/index.js.map +1 -0
- package/out/validator/signature-matching.js +261 -0
- package/out/validator/signature-matching.js.map +1 -0
- package/out/validator/status.js +38 -0
- package/out/validator/status.js.map +1 -0
- package/package.json +9 -1
- package/.vscodeignore +0 -41
- package/MCP_SERVER_SETUP.md +0 -371
- package/assets/icon.svg +0 -27
- package/docs/LINKEDIN_ANTWORT_SEQUENZDIAGRAMME.md +0 -190
- package/docs/SEQUENZDIAGRAMM_BEWEIS.md +0 -469
- package/docs/SEQUENZDIAGRAMM_VALIDATE_FLOW.md +0 -282
- package/docs/adr/001-signatur-abweichung-fix.md +0 -54
- package/docs/adr/002-file-specific-validation-1.0.1.md +0 -45
- package/docs/adr/003-documentation-generation-bugs.md +0 -134
- package/docs/adr/004-validator-signature-matching-fix.md +0 -121
- package/docs/adr/005-validator-generic-simplification-tightening.md +0 -35
- package/docs/adr/006-parser-variable-type-extraction.md +0 -33
- package/docs/adr/007-ts-parser-load-libs-for-accurate-types.md +0 -31
- package/docs/adr/008-dependencies-cache-phase1.md +0 -133
- package/docs/adr/009-consolidation-union-logic-phase1-2.md +0 -147
- package/docs/adr/010-extension-union-integration-phase1-3-and-phase2.md +0 -179
- package/docs/adr/011-module-doc-change-tracking-phase3.md +0 -190
- package/docs/adr/012-git-deletions-change-report-phase4.md +0 -235
- package/docs/adr/013-system-functionality-fixes.md +0 -279
- package/docs/adr/014-rules-migration-und-mcp-integration.md +0 -113
- package/docs/adr/015-global-agent-package.md +0 -158
- package/docs/adr/016-produktisierung-docguard.md +0 -193
- package/docs/adr/017-signature-matching-optional-fields.md +0 -128
- package/docs/adr/018-rebranding-docguard-to-noyrax.md +0 -109
- package/docs/adr/019-system-schwachstellen-analyse-und-fixes.md +0 -204
- package/docs/adr/020-api-doc-tiefe-und-signatureformatter.md +0 -74
- package/docs/adr/021-semantic-api-docs-and-symbol-classifier.md +0 -125
- package/docs/adr/022-semantic-class-and-constants-rendering.md +0 -82
- package/docs/adr/023-adr-verknuepfung-modul-doku.md +0 -54
- package/docs/adr/024-cursor-rules-mehrdimensionaler-raum.md +0 -230
- package/docs/adr/025-mcp-tools-scan-validate-cli-bridge.md +0 -202
- package/docs/adr/026-reality-driven-development-system.md +0 -173
- package/docs/adr/027-scanner-excludes-and-union-logic-fix.md +0 -189
- package/docs/adr/028-src-coverage-union-resync.md +0 -124
- package/docs/adr/029-parser-flow-kopplung-und-sync-drift-modi.md +0 -102
- package/docs/adr/030-dependency-import-symbol-names-preservation.md +0 -123
- package/docs/adr/031-generate-cli-vollstaendige-dokumentation.md +0 -99
- package/docs/adr/032-windows-optimized-verification-scripts.md +0 -165
- package/docs/adr/036-enhanced-dependency-metadata.md +0 -190
- package/docs/adr/TEMPLATE.md +0 -76
- package/docs/index/symbols.jsonl +0 -78
- package/docs/modules/action__action.yml.md +0 -50
- package/docs/modules/documentation.config.schema.json.md +0 -37
- package/docs/modules/mcp__package.json.md +0 -130
- package/docs/modules/mcp__src__resources__docs.ts.md +0 -94
- package/docs/modules/mcp__src__server.ts.md +0 -15
- package/docs/modules/mcp__src__tools__drift.ts.md +0 -114
- package/docs/modules/mcp__src__tools__impact.ts.md +0 -130
- package/docs/modules/mcp__src__tools__scan.ts.md +0 -75
- package/docs/modules/mcp__src__tools__validate.ts.md +0 -116
- package/docs/modules/mcp__src__tools__verify-adrs.ts.md +0 -106
- package/docs/modules/mcp__tsconfig.json.md +0 -22
- package/docs/modules/package.json.md +0 -130
- package/docs/modules/packages__doc-system-agent__examples__basic-project__package.json.md +0 -43
- package/docs/modules/packages__doc-system-agent__examples__basic-project__src__calculator.ts.md +0 -81
- package/docs/modules/packages__doc-system-agent__package.json.md +0 -154
- package/docs/modules/packages__doc-system-agent__src__cli__index.ts.md +0 -8
- package/docs/modules/packages__doc-system-agent__src__cli__init.ts.md +0 -93
- package/docs/modules/packages__doc-system-agent__src__cli__update.ts.md +0 -113
- package/docs/modules/packages__doc-system-agent__src__constants.ts.md +0 -29
- package/docs/modules/packages__doc-system-agent__src__index.ts.md +0 -234
- package/docs/modules/packages__doc-system-agent__src__mcp__resources__docs.ts.md +0 -94
- package/docs/modules/packages__doc-system-agent__src__mcp__server.ts.md +0 -17
- package/docs/modules/packages__doc-system-agent__src__mcp__tools__drift.ts.md +0 -38
- package/docs/modules/packages__doc-system-agent__src__mcp__tools__impact.ts.md +0 -75
- package/docs/modules/packages__doc-system-agent__src__mcp__tools__scan.ts.md +0 -23
- package/docs/modules/packages__doc-system-agent__src__mcp__tools__validate.ts.md +0 -23
- package/docs/modules/packages__doc-system-agent__src__mcp__tools__verify-adrs.ts.md +0 -106
- package/docs/modules/packages__doc-system-agent__src__mcp__types.ts.md +0 -355
- package/docs/modules/packages__doc-system-agent__tsconfig.json.md +0 -22
- package/docs/modules/scripts__verify-adrs.js.md +0 -97
- package/docs/modules/scripts__verify-architecture.js.md +0 -93
- package/docs/modules/scripts__verify-imports.js.md +0 -114
- package/docs/modules/src____tests____setup.ts.md +0 -8
- package/docs/modules/src____tests____signature-formatter.test.ts.md +0 -16
- package/docs/modules/src____tests____snapshot-doc-generation.test.ts.md +0 -8
- package/docs/modules/src____tests____symbol-classifier.test.ts.md +0 -16
- package/docs/modules/src__cache__ast-cache.ts.md +0 -91
- package/docs/modules/src__cache__dependencies-cache.ts.md +0 -89
- package/docs/modules/src__cache__output-cache.ts.md +0 -91
- package/docs/modules/src__cache__signature-cache.ts.md +0 -76
- package/docs/modules/src__cli__generate-cli.ts.md +0 -130
- package/docs/modules/src__cli__scan-cli.ts.md +0 -99
- package/docs/modules/src__cli__validate-cli.ts.md +0 -144
- package/docs/modules/src__core__async.ts.md +0 -18
- package/docs/modules/src__core__consolidation.ts.md +0 -157
- package/docs/modules/src__core__git.ts.md +0 -35
- package/docs/modules/src__core__language-detection.ts.md +0 -31
- package/docs/modules/src__core__scanner.ts.md +0 -100
- package/docs/modules/src__core__signature-formatter.ts.md +0 -232
- package/docs/modules/src__core__symbol-classifier.ts.md +0 -178
- package/docs/modules/src__core__symbols.ts.md +0 -31
- package/docs/modules/src__drift__index.ts.md +0 -53
- package/docs/modules/src__extension.ts.md +0 -418
- package/docs/modules/src__generator__adr-linker.ts.md +0 -154
- package/docs/modules/src__generator__change-report.ts.md +0 -85
- package/docs/modules/src__generator__dependency-graph.ts.md +0 -63
- package/docs/modules/src__generator__index.ts.md +0 -40
- package/docs/modules/src__generator__module-doc.ts.md +0 -242
- package/docs/modules/src__index__index.ts.md +0 -159
- package/docs/modules/src__logging__index.ts.md +0 -87
- package/docs/modules/src__parsers__dependencies.ts.md +0 -69
- package/docs/modules/src__parsers__json-yaml.ts.md +0 -96
- package/docs/modules/src__parsers__python.ts.md +0 -73
- package/docs/modules/src__parsers__ts-js.ts.md +0 -48
- package/docs/modules/src__parsers__types.ts.md +0 -117
- package/docs/modules/src__ui__commands-provider.ts.md +0 -70
- package/docs/modules/src__ui__status-bar.ts.md +0 -79
- package/docs/modules/src__validator__index.ts.md +0 -211
- package/docs/modules/src__validator__signature-matching.ts.md +0 -209
- package/docs/modules/src__validator__status.ts.md +0 -72
- package/docs/modules/test-mcp-resources.js.md +0 -27
- package/docs/modules/tsconfig.json.md +0 -22
- package/docs/system/CHANGE_REPORT.md +0 -26
- package/docs/system/DEPENDENCIES.md +0 -403
- package/docs/system/DEPENDENCY_GRAPH.md +0 -336
- package/docs/system/NAVIGATION_SPACE_ANALYSIS.md +0 -244
- package/docs/system/NPX_CACHE_FIX.md +0 -85
- package/docs/system/NPX_LOCAL_USAGE.md +0 -66
- package/docs/system/PLUGIN_ECOSYSTEM_STATUS.md +0 -465
- package/docs/system/PLUGIN_UPDATE_GUIDE.md +0 -212
- package/docs/system/RULES_UPDATE_GUIDE.md +0 -182
- package/docs/system/SYSTEM_ANALYSIS.md +0 -947
- package/docs/system/SYSTEM_METADATA.json +0 -37
- package/documentation.config.schema.json +0 -77
- package/publish.ps1 +0 -21
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"signature-matching.js","sourceRoot":"","sources":["../../src/validator/signature-matching.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.computeValidationStatus = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* @public
|
|
6
|
+
* Compute overall validation status from results
|
|
7
|
+
*/
|
|
8
|
+
function computeValidationStatus(errors, warnings, coverageErrors, signatureMismatches, markdownErrors) {
|
|
9
|
+
const totalErrors = errors.length + coverageErrors.length + markdownErrors.length;
|
|
10
|
+
const totalWarnings = warnings.length;
|
|
11
|
+
let status;
|
|
12
|
+
let message;
|
|
13
|
+
if (totalErrors > 0) {
|
|
14
|
+
status = 'red';
|
|
15
|
+
message = `Kritische Probleme: ${totalErrors} Fehler`;
|
|
16
|
+
}
|
|
17
|
+
else if (totalWarnings > 0 || signatureMismatches > 0) {
|
|
18
|
+
status = 'yellow';
|
|
19
|
+
message = `Verbesserungen möglich: ${totalWarnings} Warnungen, ${signatureMismatches} Signatur-Abweichungen`;
|
|
20
|
+
}
|
|
21
|
+
else {
|
|
22
|
+
status = 'green';
|
|
23
|
+
message = 'Alle Validierungen bestanden';
|
|
24
|
+
}
|
|
25
|
+
return {
|
|
26
|
+
status,
|
|
27
|
+
message,
|
|
28
|
+
details: {
|
|
29
|
+
totalErrors,
|
|
30
|
+
totalWarnings,
|
|
31
|
+
coverageIssues: coverageErrors.length,
|
|
32
|
+
signatureMismatches,
|
|
33
|
+
markdownIssues: markdownErrors.length,
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
exports.computeValidationStatus = computeValidationStatus;
|
|
38
|
+
//# sourceMappingURL=status.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/validator/status.ts"],"names":[],"mappings":";;;AAcA;;;GAGG;AACH,SAAgB,uBAAuB,CACnC,MAAgB,EAChB,QAAkB,EAClB,cAAwB,EACxB,mBAA2B,EAC3B,cAAwB;IAExB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;IAClF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;IAEtC,IAAI,MAAwB,CAAC;IAC7B,IAAI,OAAe,CAAC;IAEpB,IAAI,WAAW,GAAG,CAAC,EAAE;QACjB,MAAM,GAAG,KAAK,CAAC;QACf,OAAO,GAAG,uBAAuB,WAAW,SAAS,CAAC;KACzD;SAAM,IAAI,aAAa,GAAG,CAAC,IAAI,mBAAmB,GAAG,CAAC,EAAE;QACrD,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,GAAG,2BAA2B,aAAa,eAAe,mBAAmB,wBAAwB,CAAC;KAChH;SAAM;QACH,MAAM,GAAG,OAAO,CAAC;QACjB,OAAO,GAAG,8BAA8B,CAAC;KAC5C;IAED,OAAO;QACH,MAAM;QACN,OAAO;QACP,OAAO,EAAE;YACL,WAAW;YACX,aAAa;YACb,cAAc,EAAE,cAAc,CAAC,MAAM;YACrC,mBAAmB;YACnB,cAAc,EAAE,cAAc,CAAC,MAAM;SACxC;KACJ,CAAC;AACN,CAAC;AAnCD,0DAmCC"}
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@noyrax/documentation-system-plugin",
|
|
3
3
|
"displayName": "Noyrax",
|
|
4
4
|
"description": "Documentation that never drifts. Automatic documentation generation with validation and drift detection. Generates 5-dimensional documentation structure (modules, symbols, dependencies, ADRs, changes) for codebases.",
|
|
5
|
-
"version": "1.0.4-beta.
|
|
5
|
+
"version": "1.0.4-beta.5",
|
|
6
6
|
"publisher": "noyrax",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
@@ -16,6 +16,13 @@
|
|
|
16
16
|
"bugs": {
|
|
17
17
|
"url": "https://github.com/noyrax/noyrax/issues"
|
|
18
18
|
},
|
|
19
|
+
"files": [
|
|
20
|
+
"out/",
|
|
21
|
+
"scripts/",
|
|
22
|
+
"package.json",
|
|
23
|
+
"README.md",
|
|
24
|
+
"LICENSE"
|
|
25
|
+
],
|
|
19
26
|
"engines": {
|
|
20
27
|
"vscode": "^1.75.0"
|
|
21
28
|
},
|
|
@@ -266,6 +273,7 @@
|
|
|
266
273
|
"scripts": {
|
|
267
274
|
"vscode:prepublish": "npm run compile",
|
|
268
275
|
"prepublishOnly": "npm run compile",
|
|
276
|
+
"postinstall": "node -e \"const fs=require('fs'),path=require('path');const cliPath=path.join(__dirname,'out','cli','scan-cli.js');if(!fs.existsSync(cliPath)){console.log('[postinstall] CLI files missing, compiling...');require('child_process').execSync('npm run compile',{stdio:'inherit',cwd:__dirname});}\"",
|
|
269
277
|
"compile": "tsc -p ./",
|
|
270
278
|
"watch": "tsc -watch -p ./",
|
|
271
279
|
"test": "jest",
|
package/.vscodeignore
DELETED
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
# Source Maps und Type Definitions nicht benötigt
|
|
2
|
-
out/**/*.map
|
|
3
|
-
out/**/*.d.ts
|
|
4
|
-
dist/**
|
|
5
|
-
test-corpus/**
|
|
6
|
-
|
|
7
|
-
# Source Files nicht benötigt (nur kompilierte out/ Dateien)
|
|
8
|
-
src/**
|
|
9
|
-
|
|
10
|
-
# Demo-Projekt nicht ins VSIX packen
|
|
11
|
-
demo/**
|
|
12
|
-
|
|
13
|
-
# Website / Marketing
|
|
14
|
-
website/**
|
|
15
|
-
|
|
16
|
-
# Interne Pläne und Editor-/Agent-Metadaten
|
|
17
|
-
plans-archive/**
|
|
18
|
-
.cursor/**
|
|
19
|
-
.ai-agent-context/**
|
|
20
|
-
.ai-agent-rules.json
|
|
21
|
-
|
|
22
|
-
# Generierte Dokumentation nicht ins VSIX packen
|
|
23
|
-
docs/**
|
|
24
|
-
|
|
25
|
-
# MCP Server und Packages nicht ins VSIX packen (separate Projekte)
|
|
26
|
-
mcp/**
|
|
27
|
-
packages/**
|
|
28
|
-
|
|
29
|
-
# GitHub Actions nicht ins VSIX packen
|
|
30
|
-
action/**
|
|
31
|
-
|
|
32
|
-
# Lokale Build-/Cache-Artefakte
|
|
33
|
-
*.vsix
|
|
34
|
-
*.zip
|
|
35
|
-
temp-vsix-extract/**
|
|
36
|
-
temp-check/**
|
|
37
|
-
temp-*/**
|
|
38
|
-
*.log
|
|
39
|
-
|
|
40
|
-
# node_modules wird von vsce automatisch eingebunden (nur dependencies, nicht devDependencies)
|
|
41
|
-
# Daher NICHT ausschließen - vsce kümmert sich darum
|
package/MCP_SERVER_SETUP.md
DELETED
|
@@ -1,371 +0,0 @@
|
|
|
1
|
-
# MCP Server Setup für LLM-Agenten
|
|
2
|
-
|
|
3
|
-
## Übersicht
|
|
4
|
-
|
|
5
|
-
Der 5D Database Plugin MCP Server ermöglicht es LLM-Agenten (Claude, GPT, Cursor AI), über das Model Context Protocol (MCP) auf die Datenbanken zuzugreifen.
|
|
6
|
-
|
|
7
|
-
## Voraussetzungen
|
|
8
|
-
|
|
9
|
-
⚠️ **KRITISCH: System-Kopplung**
|
|
10
|
-
|
|
11
|
-
**Das Documentation System Plugin (Noyrax) und das 5D Database Plugin müssen beide installiert und konfiguriert sein!**
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
1. Documentation System Plugin (Noyrax) → generiert docs/
|
|
15
|
-
2. 5D Database Plugin → ingestiert docs/ in SQLite-DBs
|
|
16
|
-
3. MCP-Server → ermöglicht LLM-Agenten-Zugriff
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Installation
|
|
20
|
-
|
|
21
|
-
### Option 1: Via VS Code Extension (Development)
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
# 1. Extension kompilieren
|
|
25
|
-
cd 5d-database-plugin
|
|
26
|
-
npm install
|
|
27
|
-
npm run compile
|
|
28
|
-
|
|
29
|
-
# 2. MCP-Server direkt starten
|
|
30
|
-
node out/cli/mcp-server-cli.js /path/to/workspace
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### Option 2: Via npm Package (wenn veröffentlicht)
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
# 1. Package installieren
|
|
37
|
-
npm install -g @noyrax/5d-database-plugin
|
|
38
|
-
|
|
39
|
-
# 2. MCP-Server starten
|
|
40
|
-
noyrax-5d-database-mcp /path/to/workspace
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Option 3: Via npx (ohne Installation)
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
npx -y @noyrax/5d-database-plugin mcp-server /path/to/workspace
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## CLI-Tools für direkten Zugriff (AI-Agenten)
|
|
50
|
-
|
|
51
|
-
Für AI-Agenten (wie Cursor AI) stehen zusätzliche CLI-Tools zur Verfügung, die direkten Zugriff auf Datenbanken und Tools bieten, ohne MCP-Server-Prozess:
|
|
52
|
-
|
|
53
|
-
### Query-CLI (Datenbank-Queries)
|
|
54
|
-
|
|
55
|
-
Direkter Zugriff auf Datenbank-Queries:
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
# Query Module
|
|
59
|
-
noyrax-5d-database-query <workspace-root> modules <filePath>
|
|
60
|
-
|
|
61
|
-
# Query Symbols
|
|
62
|
-
noyrax-5d-database-query <workspace-root> symbols <path|symbolId>
|
|
63
|
-
|
|
64
|
-
# Query Dependencies
|
|
65
|
-
noyrax-5d-database-query <workspace-root> dependencies --from <path>
|
|
66
|
-
noyrax-5d-database-query <workspace-root> dependencies --to <path>
|
|
67
|
-
|
|
68
|
-
# Query ADRs
|
|
69
|
-
noyrax-5d-database-query <workspace-root> adrs --number <num>
|
|
70
|
-
noyrax-5d-database-query <workspace-root> adrs --path <path>
|
|
71
|
-
|
|
72
|
-
# Query Changes
|
|
73
|
-
noyrax-5d-database-query <workspace-root> changes
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
### Tool-CLI (MCP-Tools direkt)
|
|
77
|
-
|
|
78
|
-
Direkter Zugriff auf MCP-Tools ohne Server:
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
# Bootstrap
|
|
82
|
-
noyrax-5d-database-tool <workspace-root> bootstrap
|
|
83
|
-
|
|
84
|
-
# Semantic Discovery
|
|
85
|
-
noyrax-5d-database-tool <workspace-root> semantic_discovery "How does ingestion work?" [limit]
|
|
86
|
-
|
|
87
|
-
# System Explanation
|
|
88
|
-
noyrax-5d-database-tool <workspace-root> system_explanation
|
|
89
|
-
|
|
90
|
-
# Learning Path
|
|
91
|
-
noyrax-5d-database-tool <workspace-root> learning_path <topic>
|
|
92
|
-
|
|
93
|
-
# Cross Analysis
|
|
94
|
-
noyrax-5d-database-tool <workspace-root> cross_analysis <filePath>
|
|
95
|
-
|
|
96
|
-
# Gap Analysis (ab Version 0.1.8)
|
|
97
|
-
noyrax-5d-database-tool <workspace-root> gap_analysis [--min-deps N] [--limit N]
|
|
98
|
-
|
|
99
|
-
# Architecture Mining (ab Version 0.1.8)
|
|
100
|
-
noyrax-5d-database-tool <workspace-root> architecture_mining [filePath]
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
### Semantic-Search-CLI (V-Dimension)
|
|
104
|
-
|
|
105
|
-
Direkter Zugriff auf Semantic Search:
|
|
106
|
-
|
|
107
|
-
```bash
|
|
108
|
-
# Semantic Search
|
|
109
|
-
noyrax-5d-database-search <workspace-root> "How does the MCP server work?" --limit 10
|
|
110
|
-
|
|
111
|
-
# Mit spezifischen Dimensionen
|
|
112
|
-
noyrax-5d-database-search <workspace-root> "ingestion" --dimensions X,W --limit 5
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
**Vorteile für AI-Agenten:**
|
|
116
|
-
- Schneller als MCP-Server (kein JSON-RPC-Overhead)
|
|
117
|
-
- Direkter API-Zugriff
|
|
118
|
-
- JSON-Output einfach zu parsen
|
|
119
|
-
- Keine zusätzliche Infrastruktur nötig
|
|
120
|
-
|
|
121
|
-
## Konfiguration für LLM-Agenten
|
|
122
|
-
|
|
123
|
-
### Claude Desktop
|
|
124
|
-
|
|
125
|
-
Konfiguriere den MCP Server in `claude_desktop_config.json`:
|
|
126
|
-
|
|
127
|
-
**Windows:**
|
|
128
|
-
```
|
|
129
|
-
%APPDATA%\Claude\claude_desktop_config.json
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
**macOS:**
|
|
133
|
-
```
|
|
134
|
-
~/Library/Application Support/Claude/claude_desktop_config.json
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
**Linux:**
|
|
138
|
-
```
|
|
139
|
-
~/.config/Claude/claude_desktop_config.json
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
#### Konfiguration (Entwicklung - lokaler Pfad):
|
|
143
|
-
|
|
144
|
-
```json
|
|
145
|
-
{
|
|
146
|
-
"mcpServers": {
|
|
147
|
-
"5d-database": {
|
|
148
|
-
"command": "node",
|
|
149
|
-
"args": [
|
|
150
|
-
"D:/path/to/5d-database-plugin/out/cli/mcp-server-cli.js",
|
|
151
|
-
"${workspaceFolder}"
|
|
152
|
-
]
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
#### Konfiguration (Production - npm Package):
|
|
159
|
-
|
|
160
|
-
```json
|
|
161
|
-
{
|
|
162
|
-
"mcpServers": {
|
|
163
|
-
"5d-database": {
|
|
164
|
-
"command": "npx",
|
|
165
|
-
"args": [
|
|
166
|
-
"-y",
|
|
167
|
-
"@noyrax/5d-database-plugin",
|
|
168
|
-
"mcp-server",
|
|
169
|
-
"${workspaceFolder}"
|
|
170
|
-
]
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
}
|
|
174
|
-
```
|
|
175
|
-
|
|
176
|
-
### Andere LLM-Agenten
|
|
177
|
-
|
|
178
|
-
Der MCP-Server kommuniziert via stdin/stdout (JSON-RPC 2.0). Jeder MCP-kompatible Agent kann den Server nutzen, indem er:
|
|
179
|
-
|
|
180
|
-
1. Den Server als Child-Process startet: `node out/cli/mcp-server-cli.js <workspace-root>`
|
|
181
|
-
2. JSON-RPC 2.0 Requests via stdin sendet
|
|
182
|
-
3. JSON-RPC 2.0 Responses via stdout empfängt
|
|
183
|
-
|
|
184
|
-
## Verfügbare Tools
|
|
185
|
-
|
|
186
|
-
Der MCP-Server stellt folgende Tools bereit:
|
|
187
|
-
|
|
188
|
-
| Tool | Beschreibung | Parameter |
|
|
189
|
-
|------|--------------|-----------|
|
|
190
|
-
| `bootstrap` | Erste Anlaufstelle für Agenten ohne Vorwissen | `pluginId` |
|
|
191
|
-
| `semantic_discovery` | Semantic Search in natürlicher Sprache | `query`, `pluginId`, `limit?` |
|
|
192
|
-
| `system_explanation` | System-Übersicht, Entry Points, Architecture ADRs | `pluginId` |
|
|
193
|
-
| `learning_path` | Geführter Lernpfad für ein Topic | `topic`, `pluginId` |
|
|
194
|
-
| `query_modules` | Query Module nach filePath | `filePath`, `pluginId` |
|
|
195
|
-
| `query_symbols` | Query Symbols nach path oder symbolId | `path?`, `symbolId?`, `pluginId` |
|
|
196
|
-
| `query_dependencies` | Query Dependencies nach fromModule oder toModule | `fromModule?`, `toModule?`, `pluginId` |
|
|
197
|
-
| `cross_analysis` | Cross-Dimension-Analyse für filePath | `filePath`, `pluginId` |
|
|
198
|
-
| `gap_analysis` | Findet Dokumentationslücken (Module mit vielen Dependencies aber wenigen ADRs) | `pluginId`, `minDependencies?` (default: 5), `limit?` (default: 50) |
|
|
199
|
-
| `architecture_mining` | Leitet Architektur-Entscheidungen aus Code-Struktur ab | `pluginId`, `filePath?` (optional, für spezifische Datei) |
|
|
200
|
-
|
|
201
|
-
## Verfügbare Resources
|
|
202
|
-
|
|
203
|
-
| Resource | Beschreibung | URI Format |
|
|
204
|
-
|----------|--------------|------------|
|
|
205
|
-
| Modules | Alle Module (X-Dimension) | `db://modules/{pluginId}` |
|
|
206
|
-
| Symbols | Alle Symbols (Y-Dimension) | `db://symbols/{pluginId}` |
|
|
207
|
-
| Dependencies | Alle Dependencies (Z-Dimension) | `db://dependencies/{pluginId}` |
|
|
208
|
-
| ADRs | Alle ADRs (W-Dimension) | `db://adrs/{pluginId}` |
|
|
209
|
-
| Changes | Alle Change Reports (T-Dimension) | `db://changes/{pluginId}` |
|
|
210
|
-
|
|
211
|
-
## Workflow
|
|
212
|
-
|
|
213
|
-
### 1. Dokumentation generieren (Noyrax)
|
|
214
|
-
|
|
215
|
-
```bash
|
|
216
|
-
# Documentation System Plugin ausführen
|
|
217
|
-
noyrax-documentation generate /path/to/workspace
|
|
218
|
-
# Erstellt docs/ Ordner mit allen 5 Dimensionen
|
|
219
|
-
```
|
|
220
|
-
|
|
221
|
-
### 2. Ingestion ausführen (5D Database Plugin)
|
|
222
|
-
|
|
223
|
-
```bash
|
|
224
|
-
# 5D Database Plugin ausführen
|
|
225
|
-
noyrax-5d-database ingest /path/to/workspace
|
|
226
|
-
# Liest docs/ und speichert in SQLite-DBs (.database-plugin/)
|
|
227
|
-
```
|
|
228
|
-
|
|
229
|
-
### 3. MCP-Server starten
|
|
230
|
-
|
|
231
|
-
```bash
|
|
232
|
-
# MCP-Server starten (für LLM-Agenten)
|
|
233
|
-
noyrax-5d-database-mcp /path/to/workspace
|
|
234
|
-
```
|
|
235
|
-
|
|
236
|
-
### 4. LLM-Agent nutzen
|
|
237
|
-
|
|
238
|
-
Der LLM-Agent kann nun:
|
|
239
|
-
- `bootstrap` Tool aufrufen, um System zu verstehen
|
|
240
|
-
- `semantic_discovery` Tool nutzen, um relevante Code-Entitäten zu finden
|
|
241
|
-
- `system_explanation` Tool nutzen, um Entry Points zu finden
|
|
242
|
-
- `learning_path` Tool nutzen, um geführte Lernpfade zu generieren
|
|
243
|
-
- Resources lesen, um auf Datenbanken zuzugreifen
|
|
244
|
-
|
|
245
|
-
## Troubleshooting
|
|
246
|
-
|
|
247
|
-
### "docs/ directory not found"
|
|
248
|
-
|
|
249
|
-
**Problem:** Documentation System Plugin wurde nicht ausgeführt.
|
|
250
|
-
|
|
251
|
-
**Lösung:**
|
|
252
|
-
```bash
|
|
253
|
-
# Schritt 1: Dokumentation generieren
|
|
254
|
-
noyrax-documentation generate /path/to/workspace
|
|
255
|
-
```
|
|
256
|
-
|
|
257
|
-
### "No modules found in database"
|
|
258
|
-
|
|
259
|
-
**Problem:** Ingestion wurde nicht ausgeführt.
|
|
260
|
-
|
|
261
|
-
**Lösung:**
|
|
262
|
-
```bash
|
|
263
|
-
# Schritt 2: Ingestion ausführen
|
|
264
|
-
noyrax-5d-database ingest /path/to/workspace
|
|
265
|
-
```
|
|
266
|
-
|
|
267
|
-
### "MCP Server connection failed"
|
|
268
|
-
|
|
269
|
-
**Problem:** MCP-Server konnte nicht gestartet werden.
|
|
270
|
-
|
|
271
|
-
**Lösung:**
|
|
272
|
-
1. Prüfe ob beide Plugins installiert sind (Noyrax + 5D Database)
|
|
273
|
-
2. Prüfe ob `docs/` existiert
|
|
274
|
-
3. Prüfe ob Ingestion ausgeführt wurde
|
|
275
|
-
4. Prüfe MCP-Server-Konfiguration in Claude Desktop
|
|
276
|
-
|
|
277
|
-
### "Permission denied" beim Starten des Servers
|
|
278
|
-
|
|
279
|
-
**Problem:** Node.js-Script ist nicht ausführbar.
|
|
280
|
-
|
|
281
|
-
**Lösung (Linux/macOS):**
|
|
282
|
-
```bash
|
|
283
|
-
chmod +x out/cli/mcp-server-cli.js
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
## Beispiel-Interaktion
|
|
287
|
-
|
|
288
|
-
### 1. Bootstrap (First Contact)
|
|
289
|
-
|
|
290
|
-
**LLM-Agent fragt:**
|
|
291
|
-
```json
|
|
292
|
-
{
|
|
293
|
-
"method": "tools/call",
|
|
294
|
-
"params": {
|
|
295
|
-
"name": "bootstrap",
|
|
296
|
-
"arguments": {
|
|
297
|
-
"pluginId": "a1b2c3d4e5f6g7h8"
|
|
298
|
-
}
|
|
299
|
-
}
|
|
300
|
-
}
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
**Server antwortet:**
|
|
304
|
-
```json
|
|
305
|
-
{
|
|
306
|
-
"content": [{
|
|
307
|
-
"type": "text",
|
|
308
|
-
"text": "{\"what_am_i\": \"...\", \"where_to_start\": [...], ...}"
|
|
309
|
-
}]
|
|
310
|
-
}
|
|
311
|
-
```
|
|
312
|
-
|
|
313
|
-
### 2. Semantic Discovery
|
|
314
|
-
|
|
315
|
-
**LLM-Agent fragt:**
|
|
316
|
-
```json
|
|
317
|
-
{
|
|
318
|
-
"method": "tools/call",
|
|
319
|
-
"params": {
|
|
320
|
-
"name": "semantic_discovery",
|
|
321
|
-
"arguments": {
|
|
322
|
-
"query": "How does ingestion work?",
|
|
323
|
-
"pluginId": "a1b2c3d4e5f6g7h8",
|
|
324
|
-
"limit": 10
|
|
325
|
-
}
|
|
326
|
-
}
|
|
327
|
-
}
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
**Server antwortet:**
|
|
331
|
-
```json
|
|
332
|
-
{
|
|
333
|
-
"content": [{
|
|
334
|
-
"type": "text",
|
|
335
|
-
"text": "{\"entities\": [...], \"context\": {...}}"
|
|
336
|
-
}]
|
|
337
|
-
}
|
|
338
|
-
```
|
|
339
|
-
|
|
340
|
-
## CLI-Tools vs. MCP-Server
|
|
341
|
-
|
|
342
|
-
**MCP-Server** ist für externe LLM-Agenten gedacht, die keine direkte Codebase-Zugriff haben (z.B. Claude Desktop).
|
|
343
|
-
|
|
344
|
-
**CLI-Tools** sind für AI-Agenten gedacht, die direkten Codebase-Zugriff haben (z.B. Cursor AI):
|
|
345
|
-
|
|
346
|
-
- `noyrax-5d-database-query` - Direkte Datenbank-Queries
|
|
347
|
-
- `noyrax-5d-database-tool` - MCP-Tools direkt nutzen
|
|
348
|
-
- `noyrax-5d-database-search` - Semantic Search direkt
|
|
349
|
-
|
|
350
|
-
**Vorteile CLI-Tools:**
|
|
351
|
-
- Schneller (kein JSON-RPC-Overhead)
|
|
352
|
-
- Einfacher zu nutzen (direkter API-Zugriff)
|
|
353
|
-
- Kein Server-Prozess nötig
|
|
354
|
-
|
|
355
|
-
**Wann MCP-Server nutzen:**
|
|
356
|
-
- Externe LLM-Agenten (Claude Desktop, etc.)
|
|
357
|
-
- Standardisiertes Protokoll (JSON-RPC 2.0)
|
|
358
|
-
- Tool-Integration in Agent-UIs
|
|
359
|
-
|
|
360
|
-
## Weitere Informationen
|
|
361
|
-
|
|
362
|
-
- Siehe `SETUP_NEW_PROJECT.md` für vollständigen Setup-Workflow
|
|
363
|
-
- Siehe `README.md` für allgemeine Plugin-Dokumentation
|
|
364
|
-
- Siehe ADR-007 für MCP-Server-Architektur-Details
|
|
365
|
-
- Siehe ADR-028 für Semantic Brain MCP-Tools
|
|
366
|
-
- Siehe ADR-033 für MCP-Server CLI-Integration und System-Kopplung
|
|
367
|
-
- Siehe ADR-034 für Gap Analysis Tool
|
|
368
|
-
- Siehe ADR-035 für Architecture Mining Tool
|
|
369
|
-
|
|
370
|
-
**Hinweis:** Die Tools `gap_analysis` und `architecture_mining` sind ab Version 0.1.8 verfügbar.
|
|
371
|
-
|
package/assets/icon.svg
DELETED
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
|
|
2
|
-
<defs>
|
|
3
|
-
<linearGradient id="noyraxGradient" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
4
|
-
<stop offset="0%" style="stop-color:#2563EB;stop-opacity:1" />
|
|
5
|
-
<stop offset="100%" style="stop-color:#1E3A5F;stop-opacity:1" />
|
|
6
|
-
</linearGradient>
|
|
7
|
-
</defs>
|
|
8
|
-
|
|
9
|
-
<!-- Shield Background -->
|
|
10
|
-
<path d="M64 8 L112 24 L112 56 C112 88 92 108 64 120 C36 108 16 88 16 56 L16 24 Z"
|
|
11
|
-
fill="url(#noyraxGradient)"
|
|
12
|
-
stroke="#1E3A5F"
|
|
13
|
-
stroke-width="2"/>
|
|
14
|
-
|
|
15
|
-
<!-- Document Icon -->
|
|
16
|
-
<rect x="40" y="36" width="48" height="56" rx="4" fill="white" opacity="0.95"/>
|
|
17
|
-
|
|
18
|
-
<!-- Document Lines -->
|
|
19
|
-
<line x1="48" y1="52" x2="80" y2="52" stroke="#2563EB" stroke-width="3" stroke-linecap="round"/>
|
|
20
|
-
<line x1="48" y1="64" x2="72" y2="64" stroke="#64748B" stroke-width="2" stroke-linecap="round"/>
|
|
21
|
-
<line x1="48" y1="74" x2="76" y2="74" stroke="#64748B" stroke-width="2" stroke-linecap="round"/>
|
|
22
|
-
|
|
23
|
-
<!-- Checkmark -->
|
|
24
|
-
<circle cx="76" cy="82" r="12" fill="#10B981"/>
|
|
25
|
-
<path d="M70 82 L74 86 L82 78" stroke="white" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
|
|
26
|
-
</svg>
|
|
27
|
-
|