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

package/docs/modules/src__cli__validate-cli.ts.md

@@ -0,0 +1,144 @@
+# Modul: src/cli/validate-cli.ts
+
+## Relevante ADRs
+
+- [ADR-025: MCP-Server Tools Scan/Validate – CLI-Bridge-Pattern](../adr/025-mcp-tools-scan-validate-cli-bridge.md)
+- [ADR-029: Parser-Flow-Kopplung und Sync/Drift-Modi für die Validierung](../adr/029-parser-flow-kopplung-und-sync-drift-modi.md)
+
+### interface: ValidateCliResult
+Rolle: domain-model (Sichtbarkeit: public, Priorität: high)
+Signatur: `interface ValidateCliResult {
+  status: 'success' | 'warnings' | 'errors';
+  errors: ValidationError[];
+  warnings: ValidationError[];
+  coverage: {
+    documented: number;
+    total: number;
+    percentage: number;
+  };
+  duration: number;
+  logs: string[];
+}`
+```ts
+interface ValidateCliResult {
+  status: 'success' | 'warnings' | 'errors';
+  errors: ValidationError[];
+  warnings: ValidationError[];
+  coverage: {
+    documented: number;
+    total: number;
+    percentage: number;
+  };
+  duration: number;
+  logs: string[];
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `coverage` | `{
+    documented: number;
+    total: number;
+    percentage: number;
+  }` | nein |
+| `duration` | `number` | nein |
+| `errors` | `ValidationError[]` | nein |
+| `logs` | `string[]` | nein |
+| `status` | `'success' | 'warnings' | 'errors'` | nein |
+| `warnings` | `ValidationError[]` | nein |
+
+### interface: ValidateCliOptions
+Rolle: config (Sichtbarkeit: public, Priorität: normal)
+Signatur: `interface ValidateCliOptions {
+  workspaceRoot?: string;
+  outputPath?: string;
+  files?: string[];
+  verbose?: boolean;
+  thresholds?: CoverageThresholds;
+}`
+```ts
+interface ValidateCliOptions {
+  workspaceRoot?: string;
+  outputPath?: string;
+  files?: string[];
+  verbose?: boolean;
+  thresholds?: CoverageThresholds;
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `files` | `string[]` | ja |
+| `outputPath` | `string` | ja |
+| `thresholds` | `CoverageThresholds` | ja |
+| `verbose` | `boolean` | ja |
+| `workspaceRoot` | `string` | ja |
+
+### interface: ValidationError
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `interface ValidationError {
+  file: string;
+  type: 'signature_mismatch' | 'missing_docs' | 'stale_docs' | 'coverage';
+  message: string;
+  expected?: string;
+  found?: string;
+}`
+```ts
+interface ValidationError {
+  file: string;
+  type: 'signature_mismatch' | 'missing_docs' | 'stale_docs' | 'coverage';
+  message: string;
+  expected?: string;
+  found?: string;
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `expected` | `string` | ja |
+| `file` | `string` | nein |
+| `found` | `string` | ja |
+| `message` | `string` | nein |
+| `type` | `'signature_mismatch' | 'missing_docs' | 'stale_docs' | 'coverage'` | nein |
+
+### function: runValidateCli
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `runValidateCli(options: ValidateCliOptions = …): Promise<ValidateCliResult>`
+```ts
+runValidateCli(options: ValidateCliOptions = …): Promise<ValidateCliResult>
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `options` | `ValidateCliOptions` | nein | ja |
+
+Rückgabewert: `Promise<ValidateCliResult>`
+
+### variable: reexport:runValidateClifrom:undefined
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `reexport:runValidateClifrom:undefined`
+```ts
+reexport:runValidateClifrom:undefined
+```
+
+### variable: reexport:ValidateCliOptionsfrom:undefined
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `reexport:ValidateCliOptionsfrom:undefined`
+```ts
+reexport:ValidateCliOptionsfrom:undefined
+```
+
+### variable: reexport:ValidateCliResultfrom:undefined
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `reexport:ValidateCliResultfrom:undefined`
+```ts
+reexport:ValidateCliResultfrom:undefined
+```

package/docs/modules/src__core__async.ts.md

@@ -0,0 +1,18 @@
+# Modul: src/core/async.ts
+
+### function: mapLimit
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `mapLimit(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>`
+```ts
+mapLimit(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `fn` | `(item: T, index: number) => Promise<R>` | nein | nein |
+| `items` | `T[]` | nein | nein |
+| `limit` | `number` | nein | nein |
+
+Rückgabewert: `Promise<R[]>`

package/docs/modules/src__core__consolidation.ts.md

@@ -0,0 +1,158 @@
+# Modul: src/core/consolidation.ts
+
+## Relevante ADRs
+
+- [ADR-008: dependencies-cache-phase1](../adr/008-dependencies-cache-phase1.md)
+- [ADR-009: consolidation-union-logic-phase1-2](../adr/009-consolidation-union-logic-phase1-2.md)
+- [ADR-027: Scanner-Excludes und Union-Logik Fix](../adr/027-scanner-excludes-and-union-logic-fix.md)
+- [ADR-036: Enhanced Dependency Metadata (Aliasing, Type-Only, Re-Exports)](../adr/036-enhanced-dependency-metadata.md)
+
+<!-- change: symbol-added name="deduplicateAndSortDependencies" kind="function" -->
+### interface: DependenciesUnionResult
+Rolle: domain-model (Sichtbarkeit: public, Priorität: high)
+Signatur: `interface DependenciesUnionResult {
+  dependencies: DependencyCacheEntry[];
+  debug: UnionDebugInfo;
+}`
+```ts
+interface DependenciesUnionResult {
+  dependencies: DependencyCacheEntry[];
+  debug: UnionDebugInfo;
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `debug` | `UnionDebugInfo` | nein |
+| `dependencies` | `DependencyCacheEntry[]` | nein |
+
+### interface: UnionDebugInfo
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `interface UnionDebugInfo {
+  keptFromUnparsed: number;
+  skippedFromParsed: number;
+  skippedFromDeleted: number;
+  newDeps: number;
+}`
+```ts
+interface UnionDebugInfo {
+  keptFromUnparsed: number;
+  skippedFromParsed: number;
+  skippedFromDeleted: number;
+  newDeps: number;
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `keptFromUnparsed` | `number` | nein |
+| `newDeps` | `number` | nein |
+| `skippedFromDeleted` | `number` | nein |
+| `skippedFromParsed` | `number` | nein |
+
+### function: buildDependenciesUnion
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `buildDependenciesUnion(dependenciesNew: ModuleDependency[], dependenciesCachePrev: DependencyCacheEntry[], parsedFiles: Set<string>, deletedFiles: Set<string>): DependencyCacheEntry[]`
+```ts
+buildDependenciesUnion(dependenciesNew: ModuleDependency[], dependenciesCachePrev: DependencyCacheEntry[], parsedFiles: Set<string>, deletedFiles: Set<string>): DependencyCacheEntry[]
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `deletedFiles` | `Set<string>` | nein | nein |
+| `dependenciesCachePrev` | `DependencyCacheEntry[]` | nein | nein |
+| `dependenciesNew` | `ModuleDependency[]` | nein | nein |
+| `parsedFiles` | `Set<string>` | nein | nein |
+
+Rückgabewert: `DependencyCacheEntry[]`
+
+### function: buildDependenciesUnionWithDebug
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `buildDependenciesUnionWithDebug(dependenciesNew: ModuleDependency[], dependenciesCachePrev: DependencyCacheEntry[], parsedFiles: Set<string>, deletedFiles: Set<string>): DependenciesUnionResult`
+```ts
+buildDependenciesUnionWithDebug(dependenciesNew: ModuleDependency[], dependenciesCachePrev: DependencyCacheEntry[], parsedFiles: Set<string>, deletedFiles: Set<string>): DependenciesUnionResult
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `deletedFiles` | `Set<string>` | nein | nein |
+| `dependenciesCachePrev` | `DependencyCacheEntry[]` | nein | nein |
+| `dependenciesNew` | `ModuleDependency[]` | nein | nein |
+| `parsedFiles` | `Set<string>` | nein | nein |
+
+Rückgabewert: `DependenciesUnionResult`
+
+### function: buildPreviousDependenciesMap
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `buildPreviousDependenciesMap(entries: DependencyCacheEntry[]): Map<string, DependencyCacheEntry[]>`
+```ts
+buildPreviousDependenciesMap(entries: DependencyCacheEntry[]): Map<string, DependencyCacheEntry[]>
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `entries` | `DependencyCacheEntry[]` | nein | nein |
+
+Rückgabewert: `Map<string, DependencyCacheEntry[]>`
+
+### function: buildSymbolsUnion
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `buildSymbolsUnion(symbolsNew: ParsedSymbol[], symbolsPrev: ParsedSymbol[], parsedFiles: Set<string>, deletedFiles: Set<string>, scannedFiles: Set<string>): ParsedSymbol[]`
+```ts
+buildSymbolsUnion(symbolsNew: ParsedSymbol[], symbolsPrev: ParsedSymbol[], parsedFiles: Set<string>, deletedFiles: Set<string>, scannedFiles: Set<string>): ParsedSymbol[]
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `deletedFiles` | `Set<string>` | nein | nein |
+| `parsedFiles` | `Set<string>` | nein | nein |
+| `scannedFiles` | `Set<string>` | nein | nein |
+| `symbolsNew` | `ParsedSymbol[]` | nein | nein |
+| `symbolsPrev` | `ParsedSymbol[]` | nein | nein |
+
+Rückgabewert: `ParsedSymbol[]`
+
+### function: buildUnionMap
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `buildUnionMap(dependenciesNew: ModuleDependency[], depMapPrev: Map<string, DependencyCacheEntry[]>, parsedFiles: Set<string>, deletedFiles: Set<string>): { union: Map<string, DependencyCacheEntry[]>, debug: UnionDebugInfo }`
+```ts
+buildUnionMap(dependenciesNew: ModuleDependency[], depMapPrev: Map<string, DependencyCacheEntry[]>, parsedFiles: Set<string>, deletedFiles: Set<string>): { union: Map<string, DependencyCacheEntry[]>, debug: UnionDebugInfo }
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `deletedFiles` | `Set<string>` | nein | nein |
+| `dependenciesNew` | `ModuleDependency[]` | nein | nein |
+| `depMapPrev` | `Map<string, DependencyCacheEntry[]>` | nein | nein |
+| `parsedFiles` | `Set<string>` | nein | nein |
+
+Rückgabewert: `{ union: Map<string, DependencyCacheEntry[]>, debug: UnionDebugInfo }`
+
+### function: deduplicateAndSortDependencies
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `deduplicateAndSortDependencies(depMap: Map<string, DependencyCacheEntry[]>): DependencyCacheEntry[]`
+```ts
+deduplicateAndSortDependencies(depMap: Map<string, DependencyCacheEntry[]>): DependencyCacheEntry[]
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `depMap` | `Map<string, DependencyCacheEntry[]>` | nein | nein |
+
+Rückgabewert: `DependencyCacheEntry[]`

package/docs/modules/src__core__git.ts.md

@@ -0,0 +1,35 @@
+# Modul: src/core/git.ts
+
+## Relevante ADRs
+
+- [ADR-012: git-deletions-change-report-phase4](../adr/012-git-deletions-change-report-phase4.md)
+
+### function: getChangedFiles
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `getChangedFiles(repoRoot: string): Set<string> | null`
+```ts
+getChangedFiles(repoRoot: string): Set<string> | null
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `repoRoot` | `string` | nein | nein |
+
+Rückgabewert: `Set<string> | null`
+
+### function: getDeletedFiles
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `getDeletedFiles(repoRoot: string): Set<string> | null`
+```ts
+getDeletedFiles(repoRoot: string): Set<string> | null
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `repoRoot` | `string` | nein | nein |
+
+Rückgabewert: `Set<string> | null`

package/docs/modules/src__core__language-detection.ts.md

@@ -0,0 +1,31 @@
+# Modul: src/core/language-detection.ts
+
+### function: guessLanguageByShebang
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `guessLanguageByShebang(firstLine: string | null): string | null`
+```ts
+guessLanguageByShebang(firstLine: string | null): string | null
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `firstLine` | `string | null` | nein | nein |
+
+Rückgabewert: `string | null`
+
+### function: normalizeLineEndings
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `normalizeLineEndings(content: string): string`
+```ts
+normalizeLineEndings(content: string): string
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `content` | `string` | nein | nein |
+
+Rückgabewert: `string`

package/docs/modules/src__core__scanner.ts.md

@@ -0,0 +1,101 @@
+# Modul: src/core/scanner.ts
+
+## Relevante ADRs
+
+- [ADR-006: parser-variable-type-extraction](../adr/006-parser-variable-type-extraction.md)
+- [ADR-012: git-deletions-change-report-phase4](../adr/012-git-deletions-change-report-phase4.md)
+- [ADR-019: System-Schwachstellen-Analyse und proaktive Fixes](../adr/019-system-schwachstellen-analyse-und-fixes.md)
+- [ADR-025: MCP-Server Tools Scan/Validate – CLI-Bridge-Pattern](../adr/025-mcp-tools-scan-validate-cli-bridge.md)
+- [ADR-027: Scanner-Excludes und Union-Logik Fix](../adr/027-scanner-excludes-and-union-logic-fix.md)
+- [ADR-028: Vollständige `src`-Abdeckung, Union-Logik & Resync-Strategie](../adr/028-src-coverage-union-resync.md)
+
+### interface: ScanOptions
+Rolle: config (Sichtbarkeit: public, Priorität: normal)
+Signatur: `interface ScanOptions {
+  workspaceRoot: string;
+  includeGlobs?: string[];
+  excludeGlobs?: string[];
+}`
+```ts
+interface ScanOptions {
+  workspaceRoot: string;
+  includeGlobs?: string[];
+  excludeGlobs?: string[];
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `excludeGlobs` | `string[]` | ja |
+| `includeGlobs` | `string[]` | ja |
+| `workspaceRoot` | `string` | nein |
+
+### interface: ScannedFile
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `interface ScannedFile {
+  absolutePath: string;
+  repositoryRelativePath: string;
+  language: string | null;
+}`
+```ts
+interface ScannedFile {
+  absolutePath: string;
+  repositoryRelativePath: string;
+  language: string | null;
+}
+```
+
+Eigenschaften:
+
+| Name | Typ | Optional |
+|------|-----|----------|
+| `absolutePath` | `string` | nein |
+| `language` | `string | null` | nein |
+| `repositoryRelativePath` | `string` | nein |
+
+### function: scanWorkspace
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `scanWorkspace(options: ScanOptions, includeBackups: boolean = …): ScannedFile[]`
+```ts
+scanWorkspace(options: ScanOptions, includeBackups: boolean = …): ScannedFile[]
+```
+
+Parameter:
+
+| Name | Typ | Optional | Default |
+|------|-----|----------|---------|
+| `includeBackups` | `boolean` | nein | ja |
+| `options` | `ScanOptions` | nein | nein |
+
+Rückgabewert: `ScannedFile[]`
+
+### variable: BACKUP_DIR_NAMES
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `BACKUP_DIR_NAMES: Set<string>`
+```ts
+BACKUP_DIR_NAMES: Set<string>
+```
+
+### variable: BACKUP_FILE_SUFFIXES
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `BACKUP_FILE_SUFFIXES: string[]`
+```ts
+BACKUP_FILE_SUFFIXES: string[]
+```
+
+### variable: DEFAULT_EXCLUDES
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `DEFAULT_EXCLUDES: Set<string>`
+```ts
+DEFAULT_EXCLUDES: Set<string>
+```
+
+<!-- change: symbol-added name="EXCLUDE_FILE_PATTERNS" kind="variable" -->
+### variable: EXCLUDE_FILE_PATTERNS
+Rolle: other (Sichtbarkeit: public, Priorität: normal)
+Signatur: `EXCLUDE_FILE_PATTERNS: RegExp[]`
+```ts
+EXCLUDE_FILE_PATTERNS: RegExp[]
+```