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

package/out/generator/system-metadata.js

@@ -0,0 +1,202 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeSystemMetadata = exports.generateSystemMetadata = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+/**
+ * Generates system metadata JSON.
+ *
+ * @param workspaceRoot Workspace root directory
+ * @returns System metadata object
+ */
+function generateSystemMetadata(workspaceRoot) {
+    // Compute system_id (workspace hash)
+    const normalizedPath = path.resolve(workspaceRoot).replace(/\\/g, '/').toLowerCase();
+    const hash = crypto.createHash('sha256').update(normalizedPath).digest('hex');
+    const systemId = hash.substring(0, 16);
+    // Read root package.json for version
+    const rootPackageJsonPath = path.join(workspaceRoot, 'package.json');
+    let version = '0.0.0';
+    if (fs.existsSync(rootPackageJsonPath)) {
+        try {
+            const rootPackageJson = JSON.parse(fs.readFileSync(rootPackageJsonPath, 'utf8'));
+            version = rootPackageJson.version || '0.0.0';
+        }
+        catch {
+            // Use default version
+        }
+    }
+    // Find plugins
+    const plugins = [];
+    // 5d-database-plugin
+    const dbPluginPath = path.join(workspaceRoot, '5d-database-plugin');
+    if (fs.existsSync(path.join(dbPluginPath, 'package.json'))) {
+        try {
+            const dbPackageJson = JSON.parse(fs.readFileSync(path.join(dbPluginPath, 'package.json'), 'utf8'));
+            plugins.push({
+                name: dbPackageJson.name || '@noyrax/5d-database-plugin',
+                version: dbPackageJson.version || '0.0.0',
+                path: path.relative(workspaceRoot, dbPluginPath)
+            });
+        }
+        catch {
+            // Skip if can't read
+        }
+    }
+    // documentation-system-plugin
+    const docPluginPath = path.join(workspaceRoot, 'documentation-system-plugin');
+    if (fs.existsSync(path.join(docPluginPath, 'package.json'))) {
+        try {
+            const docPackageJson = JSON.parse(fs.readFileSync(path.join(docPluginPath, 'package.json'), 'utf8'));
+            plugins.push({
+                name: docPackageJson.name || '@noyrax/documentation-system-plugin',
+                version: docPackageJson.version || '0.0.0',
+                path: path.relative(workspaceRoot, docPluginPath)
+            });
+        }
+        catch {
+            // Skip if can't read
+        }
+    }
+    // mcp-server
+    const mcpServerPath = path.join(workspaceRoot, 'mcp-server');
+    if (fs.existsSync(path.join(mcpServerPath, 'package.json'))) {
+        try {
+            const mcpPackageJson = JSON.parse(fs.readFileSync(path.join(mcpServerPath, 'package.json'), 'utf8'));
+            plugins.push({
+                name: mcpPackageJson.name || '@noyrax/mcp-server',
+                version: mcpPackageJson.version || '0.0.0',
+                path: path.relative(workspaceRoot, mcpServerPath)
+            });
+        }
+        catch {
+            // Skip if can't read
+        }
+    }
+    // Dimensions descriptions
+    const dimensions = {
+        X: {
+            name: 'Modules',
+            description: 'Module documentation (X-Dimension): API documentation per file'
+        },
+        Y: {
+            name: 'Symbols',
+            description: 'Symbol index (Y-Dimension): Symbols with dependencies'
+        },
+        Z: {
+            name: 'Dependencies',
+            description: 'Dependency graph (Z-Dimension): Module dependencies'
+        },
+        W: {
+            name: 'ADRs',
+            description: 'Architecture Decision Records (W-Dimension): Architecture decisions (map)'
+        },
+        T: {
+            name: 'Changes',
+            description: 'Change reports (T-Dimension): Changes over time'
+        },
+        V: {
+            name: 'Vectors',
+            description: 'Vector embeddings (V-Dimension): Semantic search vectors'
+        }
+    };
+    // Public API from package.json exports
+    const publicApi = {};
+    // Read exports from all plugin package.json files
+    for (const plugin of plugins) {
+        if (plugin.path) {
+            const pluginPackageJsonPath = path.join(workspaceRoot, plugin.path, 'package.json');
+            if (fs.existsSync(pluginPackageJsonPath)) {
+                try {
+                    const pluginPackageJson = JSON.parse(fs.readFileSync(pluginPackageJsonPath, 'utf8'));
+                    if (pluginPackageJson.exports) {
+                        // Process exports field
+                        if (typeof pluginPackageJson.exports === 'object') {
+                            for (const [exportPath, exportValue] of Object.entries(pluginPackageJson.exports)) {
+                                if (typeof exportValue === 'string') {
+                                    publicApi[`${plugin.name}${exportPath}`] = {
+                                        import: exportValue
+                                    };
+                                }
+                                else if (typeof exportValue === 'object' && exportValue !== null) {
+                                    const exportObj = exportValue;
+                                    publicApi[`${plugin.name}${exportPath}`] = {
+                                        import: exportObj.import || exportObj.default,
+                                        types: exportObj.types
+                                    };
+                                }
+                            }
+                        }
+                    }
+                    else if (pluginPackageJson.main) {
+                        // Fallback to main field
+                        publicApi[`${plugin.name}/main`] = {
+                            import: pluginPackageJson.main,
+                            types: pluginPackageJson.types
+                        };
+                    }
+                }
+                catch {
+                    // Skip if can't read
+                }
+            }
+        }
+    }
+    // Policies
+    const policies = {
+        soft_delete: true,
+        active_only_default: true
+    };
+    return {
+        system_id: systemId,
+        workspace_root: path.resolve(workspaceRoot).replace(/\\/g, '/'),
+        version,
+        plugins,
+        dimensions,
+        public_api: publicApi,
+        policies
+    };
+}
+exports.generateSystemMetadata = generateSystemMetadata;
+/**
+ * Writes system metadata to file.
+ *
+ * @param workspaceRoot Workspace root directory
+ * @param outputPath Output path (default: 'docs/system')
+ */
+function writeSystemMetadata(workspaceRoot, outputPath) {
+    const metadata = generateSystemMetadata(workspaceRoot);
+    const systemDir = outputPath || path.join(workspaceRoot, 'docs', 'system');
+    // Ensure directory exists
+    if (!fs.existsSync(systemDir)) {
+        fs.mkdirSync(systemDir, { recursive: true });
+    }
+    const metadataPath = path.join(systemDir, 'SYSTEM_METADATA.json');
+    fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), 'utf8');
+}
+exports.writeSystemMetadata = writeSystemMetadata;
+//# sourceMappingURL=system-metadata.js.map

package/out/generator/system-metadata.js.map

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

package/out/index/index.js

@@ -0,0 +1,161 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSymbolsFromIndex = exports.buildIndexFromSymbols = exports.writeJsonlIndex = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const symbols_1 = require("../core/symbols");
+function writeJsonlIndex(rows, outFile) {
+    const dir = path.dirname(outFile);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const sorted = [...rows].sort((a, b) => (a.path === b.path ? a.symbol_id.localeCompare(b.symbol_id) : a.path.localeCompare(b.path)));
+    const content = sorted.map(r => JSON.stringify(r)).join('\n') + '\n';
+    fs.writeFileSync(outFile, content, 'utf8');
+}
+exports.writeJsonlIndex = writeJsonlIndex;
+function buildIndexFromSymbols(symbols, dependencies = []) {
+    // Sammle Dependencies pro Quell-Datei und Zielmodul,
+    // damit alle Symbolnamen je Modul zusammengeführt werden können.
+    const depsByFile = new Map();
+    for (const dep of dependencies) {
+        if (!depsByFile.has(dep.from)) {
+            depsByFile.set(dep.from, new Map());
+        }
+        const fileDeps = depsByFile.get(dep.from);
+        const existing = fileDeps.get(dep.to);
+        if (existing) {
+            // Merge symbols
+            if (dep.symbols && dep.symbols.length > 0) {
+                existing.symbols.push(...dep.symbols);
+            }
+            // isTypeOnly bleibt nur true, wenn ALLE Imports type-only sind
+            if (!dep.isTypeOnly) {
+                existing.isTypeOnly = false;
+            }
+            // isReexport wird true, wenn mindestens ein Re-Export existiert
+            if (dep.isReexport) {
+                existing.isReexport = true;
+            }
+        }
+        else {
+            fileDeps.set(dep.to, {
+                module: dep.to,
+                symbols: dep.symbols && dep.symbols.length > 0 ? [...dep.symbols] : [],
+                isTypeOnly: dep.isTypeOnly ?? false,
+                isReexport: dep.isReexport ?? false,
+            });
+        }
+    }
+    return symbols.map(s => {
+        const fileDeps = depsByFile.get(s.filePath);
+        let dependencyEntries;
+        if (fileDeps && fileDeps.size > 0) {
+            // Erzeuge ein deterministisches Array:
+            // 1. Sortiere nach Modulpfad
+            // 2. Dedupliziere und sortiere Symbolnamen pro Modul
+            const entries = Array.from(fileDeps.values()).map(acc => {
+                const entry = { module: acc.module };
+                if (acc.symbols.length > 0) {
+                    entry.symbols = Array.from(new Set(acc.symbols)).sort();
+                }
+                // Nur hinzufügen wenn true (spart Platz im JSON)
+                if (acc.isTypeOnly) {
+                    entry.isTypeOnly = true;
+                }
+                if (acc.isReexport) {
+                    entry.isReexport = true;
+                }
+                return entry;
+            });
+            entries.sort((a, b) => a.module.localeCompare(b.module));
+            dependencyEntries = entries;
+        }
+        return {
+            symbol_id: (0, symbols_1.makeStableSymbolId)(s),
+            path: s.filePath,
+            kind: s.kind,
+            name: s.fullyQualifiedName,
+            signature: s.signature,
+            dependencies: dependencyEntries,
+            // Include span information if available
+            ...(s.start_line !== undefined && { start_line: s.start_line }),
+            ...(s.end_line !== undefined && { end_line: s.end_line }),
+            ...(s.start_col !== undefined && { start_col: s.start_col }),
+            ...(s.end_col !== undefined && { end_col: s.end_col }),
+            ...(s.byte_offset_start !== undefined && { byte_offset_start: s.byte_offset_start }),
+            ...(s.byte_offset_end !== undefined && { byte_offset_end: s.byte_offset_end }),
+        };
+    });
+}
+exports.buildIndexFromSymbols = buildIndexFromSymbols;
+/**
+ * @public
+ * Reconstruct ParsedSymbol[] from a JSONL index file.
+ * Wird sowohl vom Generate-Flow (als symbolsPrev) als auch vom Validator verwendet,
+ * um eine gemeinsame Symbolbasis aus `docs/index/symbols.jsonl` herzustellen.
+ */
+function readSymbolsFromIndex(indexFile) {
+    if (!fs.existsSync(indexFile)) {
+        return [];
+    }
+    try {
+        const lines = fs.readFileSync(indexFile, 'utf8').split(/\r?\n/).filter(Boolean);
+        const symbols = [];
+        for (const line of lines) {
+            try {
+                const row = JSON.parse(line);
+                symbols.push({
+                    language: 'unknown',
+                    filePath: row.path,
+                    fullyQualifiedName: row.name,
+                    kind: row.kind,
+                    signature: row.signature ?? {
+                        name: row.name,
+                        parameters: [],
+                        returnType: '',
+                        visibility: 'public',
+                    },
+                    // Restore span information if available
+                    ...(row.start_line !== undefined && { start_line: row.start_line }),
+                    ...(row.end_line !== undefined && { end_line: row.end_line }),
+                    ...(row.start_col !== undefined && { start_col: row.start_col }),
+                    ...(row.end_col !== undefined && { end_col: row.end_col }),
+                    ...(row.byte_offset_start !== undefined && { byte_offset_start: row.byte_offset_start }),
+                    ...(row.byte_offset_end !== undefined && { byte_offset_end: row.byte_offset_end }),
+                });
+            }
+            catch {
+                // Ignoriere defekte Zeilen – Validator/Generator arbeiten dann mit Teilmenge
+            }
+        }
+        return symbols;
+    }
+    catch {
+        return [];
+    }
+}
+exports.readSymbolsFromIndex = readSymbolsFromIndex;
+//# sourceMappingURL=index.js.map

package/out/index/index.js.map

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

package/out/logging/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    constructor(options) {
+        this.component = options.component;
+    }
+    info(message) {
+        console.log(`[${this.component}] ${message}`);
+    }
+    warn(message) {
+        console.warn(`[${this.component}] ${message}`);
+    }
+    error(message, err) {
+        if (err) {
+            console.error(`[${this.component}] ${message}:`, err);
+        }
+        else {
+            console.error(`[${this.component}] ${message}`);
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=index.js.map

package/out/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":";;;AAMA,MAAa,MAAM;IAGf,YAAY,OAAsB;QAC9B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,OAAe;QAChB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAa;QAChC,IAAI,GAAG,EAAE;YACL,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;SACzD;aAAM;YACH,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;SACnD;IACL,CAAC;CACJ;AAtBD,wBAsBC"}

package/out/parsers/dependencies.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPythonDependencies = exports.extractTsJsDependencies = void 0;
+/**
+ * @public
+ * Extract dependencies from TypeScript/JavaScript files
+ */
+function extractTsJsDependencies(sourceFile, repoRelPath) {
+    const deps = [];
+    // Import declarations
+    sourceFile.getImportDeclarations().forEach(imp => {
+        const moduleSpec = imp.getModuleSpecifierValue();
+        const isTypeOnly = imp.isTypeOnly();
+        // Named imports mit Alias-Unterstützung
+        const namedImports = imp.getNamedImports().map(ni => {
+            const name = ni.getName();
+            const alias = ni.getAliasNode()?.getText();
+            const isTypeOnlySpecifier = ni.isTypeOnly();
+            // Format: "OriginalName" oder "OriginalName as Alias" oder "type OriginalName"
+            let result = name;
+            if (alias && alias !== name) {
+                result = `${name} as ${alias}`;
+            }
+            if (isTypeOnlySpecifier || isTypeOnly) {
+                result = `type ${result}`;
+            }
+            return result;
+        });
+        const defaultImport = imp.getDefaultImport()?.getText();
+        const namespaceImport = imp.getNamespaceImport()?.getText();
+        const symbols = [];
+        if (defaultImport) {
+            const prefix = isTypeOnly ? 'type default as' : 'default as';
+            symbols.push(`${prefix} ${defaultImport}`);
+        }
+        if (namespaceImport) {
+            const prefix = isTypeOnly ? 'type * as' : '* as';
+            symbols.push(`${prefix} ${namespaceImport}`);
+        }
+        symbols.push(...namedImports);
+        deps.push({
+            from: repoRelPath,
+            to: moduleSpec,
+            type: 'import',
+            symbols: symbols.length > 0 ? symbols : undefined,
+            isTypeOnly: isTypeOnly || undefined,
+        });
+    });
+    // Export declarations (Re-Exports / Barrel-Pattern)
+    sourceFile.getExportDeclarations().forEach(exp => {
+        const moduleSpec = exp.getModuleSpecifierValue();
+        if (moduleSpec) {
+            const isTypeOnly = exp.isTypeOnly();
+            const isNamespace = exp.isNamespaceExport();
+            // Named exports mit Alias-Unterstützung
+            const namedExports = exp.getNamedExports().map(ne => {
+                const name = ne.getName();
+                const alias = ne.getAliasNode()?.getText();
+                const isTypeOnlySpecifier = ne.isTypeOnly();
+                // Format: "OriginalName" oder "OriginalName as Alias" oder "type OriginalName"
+                let result = name;
+                if (alias && alias !== name) {
+                    result = `${name} as ${alias}`;
+                }
+                if (isTypeOnlySpecifier || isTypeOnly) {
+                    result = `type ${result}`;
+                }
+                return result;
+            });
+            const symbols = [];
+            if (isNamespace) {
+                symbols.push(isTypeOnly ? 'type *' : '*');
+            }
+            symbols.push(...namedExports);
+            deps.push({
+                from: repoRelPath,
+                to: moduleSpec,
+                type: 'export',
+                symbols: symbols.length > 0 ? symbols : undefined,
+                isTypeOnly: isTypeOnly || undefined,
+                isReexport: true, // Markiert als Re-Export (Barrel-Pattern)
+            });
+        }
+    });
+    return deps;
+}
+exports.extractTsJsDependencies = extractTsJsDependencies;
+/**
+ * @public
+ * Extract dependencies from Python files
+ */
+function extractPythonDependencies(content, repoRelPath) {
+    const deps = [];
+    const lines = content.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // import module
+        const importMatch = trimmed.match(/^import\s+([^#]+)/);
+        if (importMatch) {
+            const modules = importMatch[1].split(',').map(m => m.trim());
+            for (const mod of modules) {
+                deps.push({
+                    from: repoRelPath,
+                    to: mod,
+                    type: 'import',
+                });
+            }
+            continue;
+        }
+        // from module import symbols
+        const fromMatch = trimmed.match(/^from\s+([^\s]+)\s+import\s+([^#]+)/);
+        if (fromMatch) {
+            const module = fromMatch[1];
+            const symbols = fromMatch[2].split(',').map(s => s.trim());
+            deps.push({
+                from: repoRelPath,
+                to: module,
+                type: 'import',
+                symbols,
+            });
+        }
+    }
+    return deps;
+}
+exports.extractPythonDependencies = extractPythonDependencies;
+//# sourceMappingURL=dependencies.js.map

package/out/parsers/dependencies.js.map

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

package/out/parsers/json-yaml.js

@@ -0,0 +1,121 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonYamlParser = void 0;
+const path = __importStar(require("path"));
+const YAML = __importStar(require("yaml"));
+function asRepoRel(p) {
+    return p.split(path.sep).join('/');
+}
+class JsonYamlParser {
+    constructor() {
+        this.language = 'json-yaml';
+    }
+    parse(filePath, fileContent) {
+        // ARCHITECTURE DECISION (ADR): JSON/YAML liefern keine Code-Symbole
+        // Diese Dateien enthalten Konfiguration, keine Code-Symbole.
+        // Root Cause Fix: Verhindert $schema, $ref und andere JSON-Keys als Symbole.
+        // 
+        // Option A (alt): Komplett deaktivieren - return []
+        // Option B (implementiert): Nur spezifische Config-Keys extrahieren (z.B. package.json, tsconfig.json)
+        //
+        // Begründung: JSON/YAML sind Konfigurationsdateien, keine Code-Quellen.
+        // Symbole sollten nur aus .ts/.tsx/.js/.jsx extrahiert werden.
+        const ext = path.extname(filePath).toLowerCase();
+        const base = path.basename(filePath).toLowerCase();
+        const repoRel = asRepoRel(filePath);
+        // JSON/YAML: standardmäßig keine Symbole extrahieren (Konfiguration ≠ Code),
+        // aber für wenige, semantisch nützliche Standarddateien Top-Level-Keys extrahieren.
+        if (ext === '.json') {
+            if (base === 'package.json' || base === 'tsconfig.json') {
+                try {
+                    const parsed = JSON.parse(fileContent);
+                    const out = [];
+                    this.collectFromObject(this.filterConfigKeys(parsed), repoRel, out, this.language);
+                    return out;
+                }
+                catch {
+                    // Invalid JSON → keine Symbole
+                    return [];
+                }
+            }
+            return [];
+        }
+        if (ext === '.yaml' || ext === '.yml') {
+            return [];
+        }
+        // Markdown Front-Matter: Auch keine Symbole (nur Metadaten)
+        if (ext === '.md') {
+            return [];
+        }
+        return [];
+    }
+    filterConfigKeys(obj) {
+        if (!obj || typeof obj !== 'object' || Array.isArray(obj))
+            return {};
+        const record = obj;
+        const out = {};
+        for (const k of Object.keys(record)) {
+            // Schutz gegen Noise: $schema, $ref, etc. nie als „Symbol“ behandeln
+            if (k.startsWith('$'))
+                continue;
+            out[k] = record[k];
+        }
+        return out;
+    }
+    collectFromObject(obj, repoRel, out, lang) {
+        if (!obj || typeof obj !== 'object')
+            return;
+        const keys = Object.keys(obj).sort();
+        for (const k of keys) {
+            const v = obj[k];
+            const sig = { name: k, parameters: [], returnType: typeof v, visibility: 'public' };
+            out.push({
+                language: lang,
+                filePath: repoRel,
+                fullyQualifiedName: k,
+                signature: sig,
+                kind: 'variable',
+            });
+        }
+    }
+    extractFrontMatter(content) {
+        // Einfacher Front-Matter-Parser: erwartet '---' Block am Anfang
+        if (!content.startsWith('---'))
+            return null;
+        const end = content.indexOf('\n---', 3);
+        if (end === -1)
+            return null;
+        const block = content.slice(3, end).trim();
+        try {
+            return YAML.parse(block);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.JsonYamlParser = JsonYamlParser;
+//# sourceMappingURL=json-yaml.js.map