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

package/out/core/signature-formatter.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignatureFormatter = void 0;
+/**
+ * @public
+ * Zentrale Klasse für konsistente Signatur-Formatierung
+ *
+ * Diese Klasse stellt sicher, dass Generator und Validator identische
+ * Signatur-Darstellungen verwenden. Basierend auf ADR-004 und der
+ * Analyse aus agent-pre.plan.md (Abschnitt 2.6).
+ */
+class SignatureFormatter {
+    /**
+     * Formatiert ein Symbol für die Dokumentation
+     * Verwendet von: Generator (renderModuleDoc) und Validator (formatSignatureForDoc)
+     */
+    static formatForDoc(symbol) {
+        switch (symbol.kind) {
+            case 'interface':
+                return SignatureFormatter.formatInterface(symbol);
+            case 'class':
+                return `class ${symbol.signature.name}`;
+            case 'type':
+                return `type ${symbol.signature.name}`;
+            case 'enum':
+                return `enum ${symbol.signature.name}`;
+            case 'function':
+            case 'method':
+                return SignatureFormatter.formatFunctionOrMethod(symbol);
+            case 'variable':
+                return SignatureFormatter.formatVariable(symbol);
+            case 'module':
+                return `module ${symbol.signature.name}`;
+            default:
+                return symbol.signature.name;
+        }
+    }
+    /**
+     * Formatiert ein Interface mit allen Properties
+     */
+    static formatInterface(symbol) {
+        if (symbol.signature.parameters.length > 0) {
+            const props = symbol.signature.parameters
+                .map(p => SignatureFormatter.formatInterfaceProperty(p))
+                .join('\n');
+            return 'interface ' + symbol.signature.name + ' {\n' + props + '\n}';
+        }
+        return 'interface ' + symbol.signature.name + ' {}';
+    }
+    /**
+     * Formatiert eine einzelne Interface-Property
+     */
+    static formatInterfaceProperty(p) {
+        const optionalMarker = p.optional ? '?' : '';
+        const typeAnnotation = p.type ? ': ' + p.type : '';
+        return '  ' + p.name + optionalMarker + typeAnnotation + ';';
+    }
+    /**
+     * Formatiert eine Funktion oder Methode mit Parametern und Rückgabetyp
+     */
+    static formatFunctionOrMethod(symbol) {
+        const params = symbol.signature.parameters
+            .map(p => SignatureFormatter.formatFunctionParameter(p))
+            .join(', ');
+        const ret = symbol.signature.returnType ? ': ' + symbol.signature.returnType : '';
+        return symbol.signature.name + '(' + params + ')' + ret;
+    }
+    /**
+     * Formatiert einen einzelnen Funktions-Parameter
+     */
+    static formatFunctionParameter(p) {
+        const optionalMarker = p.optional ? '?' : '';
+        const typeAnnotation = p.type ? ': ' + p.type : '';
+        const defaultMarker = p.hasDefault ? ' = …' : '';
+        return p.name + optionalMarker + typeAnnotation + defaultMarker;
+    }
+    /**
+     * Formatiert eine Variable mit Typ
+     */
+    static formatVariable(symbol) {
+        const varType = symbol.signature.returnType ? `: ${symbol.signature.returnType}` : '';
+        return `${symbol.signature.name}${varType}`;
+    }
+    /**
+     * Normalisiert eine Signatur für Vergleiche
+     * Entfernt Whitespace-Unterschiede und normalisiert Formatierung
+     */
+    static normalize(signature) {
+        // Using replace with /g flag (replaceAll requires ES2021+)
+        return signature
+            .replace(/\s+/g, ' ')
+            .replace(/\s*:\s*/g, ':')
+            .replace(/\s*;\s*/g, ';')
+            .replace(/\s*\{\s*/g, '{')
+            .replace(/\s*\}\s*/g, '}')
+            .replace(/\s*\|\s*/g, '|')
+            .replace(/\s*,\s*/g, ', ')
+            .trim();
+    }
+    /**
+     * Normalisiert eine SymbolSignature zu einem String für Hashing/Vergleiche
+     */
+    static normalizeSignature(sig) {
+        const params = sig.parameters
+            .map(p => {
+            const optMarker = p.optional ? '?' : '';
+            const typeStr = p.type ?? '';
+            const defaultMarker = p.hasDefault ? '=…' : '';
+            return p.name + optMarker + ':' + typeStr + defaultMarker;
+        })
+            .sort((a, b) => a.localeCompare(b))
+            .join(',');
+        const retType = sig.returnType ?? '';
+        return sig.name + '(' + params + '):' + retType;
+    }
+    /**
+     * Vergleicht zwei Signaturen mit konfigurierbarer Toleranz
+     */
+    static compare(expected, documented, options = {}) {
+        const expectedNorm = SignatureFormatter.normalize(expected);
+        const documentedNorm = SignatureFormatter.normalize(documented);
+        // Exakter Match
+        if (expectedNorm === documentedNorm) {
+            return { match: true, reason: 'exact' };
+        }
+        // Optional-Feld-Toleranz
+        if (options.tolerateOptionalFields && SignatureFormatter.isOptionalFieldCompatible(expectedNorm, documentedNorm)) {
+            return { match: true, reason: 'optional-fields' };
+        }
+        // Generics-Vereinfachung
+        if (options.tolerateGenericSimplification && SignatureFormatter.isGenericTypeSimplification(expectedNorm, documentedNorm)) {
+            return { match: true, reason: 'generic-simplification' };
+        }
+        return { match: false, reason: 'mismatch' };
+    }
+    /**
+     * Prüft ob Signaturen nur durch optionale Felder unterschiedlich sind
+     */
+    static isOptionalFieldCompatible(expected, documented) {
+        // Using replace with /g flag (replaceAll requires ES2021+)
+        const removeOptionalMarkers = (s) => s.replace(/(\w+)\?:/g, '$1:');
+        return removeOptionalMarkers(expected) === removeOptionalMarkers(documented);
+    }
+    /**
+     * Prüft ob es sich um eine Generics-Vereinfachung handelt
+     */
+    static isGenericTypeSimplification(expected, documented) {
+        // Using replace with /g flag (replaceAll requires ES2021+)
+        const simplifyTypes = (sig) => {
+            return sig
+                .replace(/\b[A-Z]\b\[\]/g, '{}')
+                .replace(/\b[A-Z]\b(?!\[\])/g, '{}')
+                .replace(/Promise<[^>]+>/g, 'Promise<{}>')
+                .replace(/Thenable<[^>]+>/g, 'Thenable<{}>')
+                .replace(/Map<([^,>]+),\s*[^>]+>/g, 'Map<$1, {}>')
+                .replace(/Array<([^>]+)>/g, '$1[]');
+        };
+        return simplifyTypes(expected) === simplifyTypes(documented);
+    }
+}
+exports.SignatureFormatter = SignatureFormatter;
+//# sourceMappingURL=signature-formatter.js.map

package/out/core/signature-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-formatter.js","sourceRoot":"","sources":["../../src/core/signature-formatter.ts"],"names":[],"mappings":"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"}

package/out/core/symbol-classifier.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifySymbol = void 0;
+/**
+ * @public
+ * Zentrale, deterministische Klassifizierungs-API für Symbole.
+ *
+ * Arbeitet ausschließlich auf ParsedSymbol-Daten (kein I/O, keine
+ * Plugin-spezifischen Abhängigkeiten) und wird von Generator und
+ * Validator verwendet, um Doku-Tiefe und Prüfstrenge zu steuern.
+ */
+function classifySymbol(symbol) {
+    const visibility = classifyVisibility(symbol);
+    const role = classifyRole(symbol);
+    const priority = classifyPriority(role, visibility);
+    return { visibility, role, priority };
+}
+exports.classifySymbol = classifySymbol;
+function classifyVisibility(symbol) {
+    // Wenn der Parser explizite Sichtbarkeit liefert, respektieren
+    // wir diese. Fallback ist „public“, um sich konservativ zu verhalten.
+    const v = symbol.signature.visibility;
+    if (v === 'private' || v === 'protected') {
+        return 'internal';
+    }
+    return 'public';
+}
+function classifyRole(symbol) {
+    const kind = symbol.kind;
+    const name = symbol.signature.name;
+    const fqn = symbol.fullyQualifiedName;
+    const filePath = normalizePath(symbol.filePath);
+    // Service-APIs: Funktionen/Methoden/Klassen mit typischen Suffixen
+    if (kind === 'function' || kind === 'method' || kind === 'class') {
+        if (hasAnySuffix(name, ['Api', 'API', 'Service', 'Manager', 'Controller'])) {
+            return 'service-api';
+        }
+        if (filePathIncludes(filePath, ['api', 'service', 'services', 'controller'])) {
+            return 'service-api';
+        }
+    }
+    // Domain-Modelle: Interfaces/Klassen mit typischen Namensmustern
+    if (kind === 'interface' || kind === 'class' || kind === 'type') {
+        if (hasAnySuffix(name, ['Entity', 'Model', 'Record', 'Result', 'Request', 'Response', 'Stats'])) {
+            return 'domain-model';
+        }
+        if (filePathIncludes(filePath, ['models', 'entities', 'domain'])) {
+            return 'domain-model';
+        }
+    }
+    // Konfigurationen: Typen mit „Config“/„Options“ oder in *config*-Pfaden
+    if (kind === 'interface' || kind === 'type' || kind === 'variable') {
+        if (hasAnySuffix(name, ['Config', 'Options', 'Settings'])) {
+            return 'config';
+        }
+        if (filePathIncludes(filePath, ['config', 'configs'])) {
+            return 'config';
+        }
+    }
+    // Infrastruktur / technische Typen (Cache, Validator, Repository, Query, Migration, Snapshot etc.)
+    if (hasAnySubstring(name, ['Cache', 'Validator', 'Repository', 'Query', 'Migration', 'Snapshot']) ||
+        filePathIncludes(filePath, ['cache', 'validator', 'validators', 'repository', 'repositories', 'migrations'])) {
+        return 'infra';
+    }
+    return 'other';
+}
+function classifyPriority(role, visibility) {
+    if (visibility === 'public') {
+        if (role === 'service-api' || role === 'domain-model') {
+            return 'high';
+        }
+        if (role === 'config') {
+            return 'normal';
+        }
+    }
+    // Interne oder rein infrastrukturelle Symbole sind niedriger priorisiert
+    if (role === 'infra' || visibility === 'internal') {
+        return 'low';
+    }
+    return 'normal';
+}
+function normalizePath(p) {
+    return p.replace(/\\/g, '/').toLowerCase();
+}
+function hasAnySuffix(name, suffixes) {
+    return suffixes.some(s => name.endsWith(s));
+}
+function hasAnySubstring(name, parts) {
+    const lower = name.toLowerCase();
+    return parts.some(p => lower.includes(p.toLowerCase()));
+}
+function filePathIncludes(path, segments) {
+    const lower = path.toLowerCase();
+    return segments.some(seg => lower.includes(`/${seg.toLowerCase()}/`) || lower.endsWith(`/${seg.toLowerCase()}.ts`));
+}
+//# sourceMappingURL=symbol-classifier.js.map

package/out/core/symbol-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-classifier.js","sourceRoot":"","sources":["../../src/core/symbol-classifier.ts"],"names":[],"mappings":"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"}

package/out/core/symbols.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeStableSymbolId = exports.computeSignatureHash = void 0;
+const crypto_1 = require("crypto");
+/**
+ * @public
+ * Compute hash for symbol signature
+ */
+function computeSignatureHash(symbol) {
+    const base = [
+        symbol.signature.name,
+        symbol.signature.parameters.map(p => `${p.name}:${p.type ?? ''}:${p.hasDefault ? '1' : '0'}`).join('|'),
+        symbol.signature.returnType ?? '',
+        symbol.signature.visibility ?? 'public',
+    ].join('::');
+    return (0, crypto_1.createHash)('sha256').update(base).digest('hex').slice(0, 16);
+}
+exports.computeSignatureHash = computeSignatureHash;
+function makeStableSymbolId(symbol) {
+    const hash = computeSignatureHash(symbol);
+    return `${symbol.language}://${symbol.filePath}#${symbol.fullyQualifiedName}(${hash})`;
+}
+exports.makeStableSymbolId = makeStableSymbolId;
+//# sourceMappingURL=symbols.js.map

package/out/core/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/core/symbols.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAGpC;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,MAAoB;IACrD,MAAM,IAAI,GAAG;QACT,MAAM,CAAC,SAAS,CAAC,IAAI;QACrB,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACvG,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE;QACjC,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,QAAQ;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AARD,oDAQC;AAED,SAAgB,kBAAkB,CAAC,MAAoB;IACnD,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,GAAG,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,GAAG,CAAC;AAC3F,CAAC;AAHD,gDAGC"}

package/out/drift/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectDrift = exports.computeCacheEntries = void 0;
+const symbols_1 = require("../core/symbols");
+function computeCacheEntries(symbols) {
+    return symbols.map(s => {
+        const id = (0, symbols_1.makeStableSymbolId)(s);
+        const baseId = id.replace(/\([^)]*\)$/, ''); // ohne hash
+        const signatureHash = (0, symbols_1.computeSignatureHash)(s);
+        return { baseId, signatureHash };
+    }).sort((a, b) => a.baseId.localeCompare(b.baseId));
+}
+exports.computeCacheEntries = computeCacheEntries;
+function detectDrift(previous, current) {
+    if (!previous)
+        return { staleSymbols: [] };
+    const prevMap = new Map(previous.entries.map(e => [e.baseId, e.signatureHash]));
+    const stale = [];
+    for (const now of current) {
+        const before = prevMap.get(now.baseId);
+        if (before && before !== now.signatureHash) {
+            stale.push(now.baseId);
+        }
+    }
+    return { staleSymbols: stale };
+}
+exports.detectDrift = detectDrift;
+//# sourceMappingURL=index.js.map

package/out/drift/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/drift/index.ts"],"names":[],"mappings":";;;AACA,6CAA2E;AAO3E,SAAgB,mBAAmB,CAAC,OAAuB;IACvD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACnB,MAAM,EAAE,GAAG,IAAA,4BAAkB,EAAC,CAAC,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY;QACzD,MAAM,aAAa,GAAG,IAAA,8BAAoB,EAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAPD,kDAOC;AAED,SAAgB,WAAW,CAAC,QAAmC,EAAE,OAAqB;IAClF,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAAU,CAAC,CAAC,CAAC;IACzF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,aAAa,EAAE;YACxC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SAC1B;KACJ;IACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAXD,kCAWC"}