@noyrax/documentation-system-plugin 1.0.4-beta.1

package/out/core/scanner.js

@@ -0,0 +1,179 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanWorkspace = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ignore_1 = __importDefault(require("ignore"));
+const language_detection_1 = require("./language-detection");
+const index_1 = require("../logging/index");
+const DEFAULT_EXCLUDES = new Set([
+    'node_modules',
+    '.git', '.svn', '.hg',
+    'dist', 'out', 'build',
+    '__pycache__', '.mypy_cache', '.venv', '.cache',
+    'docs',
+    'coverage',
+    '.database-plugin',
+    '.database',
+    '.ai-agent-context',
+    '.vscode',
+    '.cursor',
+    'demo',
+    'website', // Website-Projekt (laut .gitignore)
+]);
+// Hard-Exclude File Patterns (systemweit verbindlich)
+// Diese Dateien werden NIE gescannt, unabhängig von .gitignore
+const EXCLUDE_FILE_PATTERNS = [
+    /\.d\.ts$/,
+    /\.schema\.json$/,
+    /\.min\.js$/,
+    /\.map$/, // Source Maps
+];
+const BACKUP_DIR_NAMES = new Set(['backup', 'backups', 'archive', 'archives']);
+const BACKUP_FILE_SUFFIXES = ['.bak', '.old', '.tmp', '.swp', '.swo'];
+/**
+ * @public
+ * Scan workspace for source files
+ */
+function scanWorkspace(options, includeBackups = false) {
+    const root = path.resolve(options.workspaceRoot);
+    const results = [];
+    const logger = new index_1.Logger({ component: 'scanner' });
+    const ig = (0, ignore_1.default)();
+    const gitignorePath = path.join(root, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        try {
+            ig.add(fs.readFileSync(gitignorePath, 'utf8'));
+        }
+        catch (e) {
+            const errorMsg = e instanceof Error ? e.message : String(e);
+            logger.warn(`Konnte .gitignore nicht lesen: ${errorMsg}`);
+        }
+    }
+    function isBinaryFile(filePath) {
+        try {
+            const fd = fs.openSync(filePath, 'r');
+            const buffer = Buffer.allocUnsafe(512);
+            const bytes = fs.readSync(fd, buffer, 0, 512, 0);
+            fs.closeSync(fd);
+            for (let i = 0; i < bytes; i++) {
+                const charCode = buffer[i];
+                if (charCode === 0)
+                    return true; // NUL byte
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    function detectLanguageByExtension(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        switch (ext) {
+            case '.ts':
+            case '.tsx':
+                return 'ts';
+            case '.js':
+            case '.jsx':
+                return 'js';
+            case '.json':
+                return 'json';
+            case '.yaml':
+            case '.yml':
+                return 'yaml';
+            case '.py':
+                return 'python';
+            case '.md':
+                return 'markdown';
+            default:
+                return null;
+        }
+    }
+    function walk(currentDir) {
+        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        // Deterministische Reihenfolge
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.name.startsWith('.git'))
+                continue;
+            if (DEFAULT_EXCLUDES.has(entry.name))
+                continue;
+            const fullPath = path.join(currentDir, entry.name);
+            const repoRel = path.relative(root, fullPath).split(path.sep).join('/');
+            // Generierte Dokumentation ausschließen (docs/ Verzeichnis)
+            if (repoRel.startsWith('docs/'))
+                continue;
+            if (ig.ignores(repoRel))
+                continue;
+            if (entry.isDirectory()) {
+                if (!includeBackups && BACKUP_DIR_NAMES.has(entry.name.toLowerCase()))
+                    continue;
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                if (isBinaryFile(fullPath))
+                    continue;
+                // Hard-Exclude File Patterns (systemweit verbindlich)
+                if (EXCLUDE_FILE_PATTERNS.some(pattern => pattern.test(entry.name))) {
+                    continue;
+                }
+                let language = detectLanguageByExtension(fullPath);
+                if (!language) {
+                    try {
+                        const fd = fs.openSync(fullPath, 'r');
+                        const buffer = Buffer.allocUnsafe(128);
+                        const bytes = fs.readSync(fd, buffer, 0, 128, 0);
+                        fs.closeSync(fd);
+                        const firstLine = buffer.slice(0, bytes).toString('utf8').split(/\r?\n/)[0] || '';
+                        language = (0, language_detection_1.guessLanguageByShebang)(firstLine);
+                    }
+                    catch (e) {
+                        const errorMsg = e instanceof Error ? e.message : String(e);
+                        logger.warn(`Shebang-Erkennung fehlgeschlagen für ${repoRel}: ${errorMsg}`);
+                    }
+                }
+                // Backup- und temporäre Dateien überspringen (außer explizit gewünscht)
+                if (!includeBackups) {
+                    const lower = entry.name.toLowerCase();
+                    if (BACKUP_FILE_SUFFIXES.some(s => lower.endsWith(s)))
+                        continue;
+                    if (repoRel.includes('/backups/') || repoRel.includes('/backup/') || repoRel.includes('/archives/'))
+                        continue;
+                }
+                results.push({ absolutePath: fullPath, repositoryRelativePath: repoRel, language });
+            }
+        }
+    }
+    walk(root);
+    // Endgültig deterministisch sortieren
+    results.sort((a, b) => a.repositoryRelativePath.localeCompare(b.repositoryRelativePath));
+    return results;
+}
+exports.scanWorkspace = scanWorkspace;
+//# sourceMappingURL=scanner.js.map

package/out/core/scanner.js.map

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

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":";;;AAmCA;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,MAAoB;IAC/C,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEpD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAND,wCAMC;AAED,SAAS,kBAAkB,CAAC,MAAoB;IAC5C,+DAA+D;IAC/D,sEAAsE;IACtE,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,WAAW,EAAE;QACtC,OAAO,UAAU,CAAC;KACrB;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEhD,mEAAmE;IACnE,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE;QAC9D,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE;YACxE,OAAO,aAAa,CAAC;SACxB;QACD,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE;YAC1E,OAAO,aAAa,CAAC;SACxB;KACJ;IAED,iEAAiE;IACjE,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,EAAE;QAC7D,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,EAAE;YAC7F,OAAO,cAAc,CAAC;SACzB;QACD,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE;YAC9D,OAAO,cAAc,CAAC;SACzB;KACJ;IAED,wEAAwE;IACxE,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,EAAE;QAChE,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,EAAE;YACvD,OAAO,QAAQ,CAAC;SACnB;QACD,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,EAAE;YACnD,OAAO,QAAQ,CAAC;SACnB;KACJ;IAED,mGAAmG;IACnG,IACI,eAAe,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC7F,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,EAC9G;QACE,OAAO,OAAO,CAAC;KAClB;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAgB,EAAE,UAA4B;IACpE,IAAI,UAAU,KAAK,QAAQ,EAAE;QACzB,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,cAAc,EAAE;YACnD,OAAO,MAAM,CAAC;SACjB;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE;YACnB,OAAO,QAAQ,CAAC;SACnB;KACJ;IAED,yEAAyE;IACzE,IAAI,IAAI,KAAK,OAAO,IAAI,UAAU,KAAK,UAAU,EAAE;QAC/C,OAAO,KAAK,CAAC;KAChB;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,aAAa,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,QAAkB;IAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAe;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,QAAkB;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AACxH,CAAC"}

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"}