openlore 2.0.0

package/dist/core/drift/drift-detector.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Drift Detection Engine
+ *
+ * Compares code changes (from git) against existing specs (from spec-mapper)
+ * to detect gaps, stale specs, uncovered files, and orphaned specs.
+ */
+import type { ChangedFile, DriftIssue, DriftIssueKind, DriftResult, DriftSeverity, SpecMap } from '../../types/index.js';
+import { type ADRMap } from './spec-mapper.js';
+import type { LLMService } from '../services/llm-service.js';
+export interface DriftDetectorOptions {
+    rootPath: string;
+    specMap: SpecMap;
+    changedFiles: ChangedFile[];
+    failOn: DriftSeverity;
+    llm?: LLMService;
+    domainFilter?: string[];
+    /** Relative path to the openspec directory (e.g. "openspec"). Used for spec-change detection. */
+    openspecRelPath?: string;
+    /** Git base ref for fetching file diffs (needed for LLM enhancement). */
+    baseRef?: string;
+    /** Maximum number of LLM calls per run (default: 10). */
+    maxLlmCalls?: number;
+    /** Optional ADR map for ADR drift detection. */
+    adrMap?: ADRMap;
+}
+/**
+ * Determine if a changed file is relevant for spec drift detection.
+ * Filters out test files, generated files, lock files, assets, etc.
+ * @param openspecRelPath - relative path to the openspec directory (default: "openspec")
+ */
+export declare function isSpecRelevantChange(file: ChangedFile, openspecRelPath?: string): boolean;
+/**
+ * Compute severity based on issue kind and change magnitude
+ */
+export declare function computeSeverity(kind: DriftIssueKind, file: ChangedFile): DriftSeverity;
+/**
+ * Extract domain names whose specs were also changed in this changeset.
+ * Must be called on the FULL changedFiles list (before isSpecRelevantChange
+ * filtering), because spec files live under openspec/ which isSpecRelevantChange
+ * intentionally excludes from source-drift analysis.
+ *
+ * @param openspecRelPath - relative path prefix for spec files (default: "openspec")
+ */
+export declare function extractChangedSpecDomains(changedFiles: ChangedFile[], openspecRelPath?: string): Set<string>;
+/**
+ * Detect gaps: code changed in a domain but spec wasn't updated.
+ * Pass pre-computed changedSpecDomains to avoid depending on openspec/ files
+ * being present in changedFiles (they are excluded by isSpecRelevantChange).
+ */
+export declare function detectGaps(changedFiles: ChangedFile[], specMap: SpecMap, changedSpecDomains?: Set<string>, openspecRelPath?: string): DriftIssue[];
+/**
+ * Detect stale specs: spec references files that were deleted or heavily modified
+ */
+export declare function detectStaleSpecs(changedFiles: ChangedFile[], specMap: SpecMap): DriftIssue[];
+/**
+ * Detect uncovered files: new files that don't map to any spec domain
+ */
+export declare function detectUncoveredFiles(changedFiles: ChangedFile[], specMap: SpecMap, openspecRelPath?: string): DriftIssue[];
+/**
+ * Detect orphaned specs: spec declares source files that don't exist on disk.
+ * Skips meta-domains (overview, architecture) which often have generic paths.
+ */
+export declare function detectOrphanedSpecs(specMap: SpecMap, rootPath: string): Promise<DriftIssue[]>;
+/**
+ * Extract ADR IDs that were changed in this changeset.
+ * Matches files like: openspec/decisions/adr-0001-foo.md
+ */
+export declare function extractChangedADRIds(changedFiles: ChangedFile[], openspecRelPath?: string): Set<string>;
+/**
+ * Detect ADR gaps: code changed in a domain referenced by an ADR,
+ * but the ADR wasn't updated. Reports once per ADR, not per file.
+ * Severity is always 'info' — most code changes don't invalidate decisions.
+ */
+export declare function detectADRGaps(changedFiles: ChangedFile[], adrMap: ADRMap, specMap: SpecMap, changedADRIds: Set<string>, openspecRelPath?: string): DriftIssue[];
+/**
+ * Detect orphaned ADRs: ADR references domains that no longer exist in specs.
+ */
+export declare function detectADROrphaned(adrMap: ADRMap, specMap: SpecMap): DriftIssue[];
+/**
+ * Post-process gap issues using an LLM to determine if code changes
+ * actually affect spec-documented behavior. This reduces false positives
+ * by dismissing purely internal changes (refactoring, formatting, etc.).
+ *
+ * Only processes 'gap' issues. Other issue types (stale, uncovered, orphaned)
+ * are structural and don't benefit from semantic analysis.
+ */
+export declare function enhanceGapsWithLLM(issues: DriftIssue[], options: {
+    llm: LLMService;
+    rootPath: string;
+    specMap: SpecMap;
+    baseRef: string;
+    maxLlmCalls?: number;
+    /** Override diff fetching (for testing) */
+    _getDiff?: (rootPath: string, filePath: string, baseRef: string) => Promise<string>;
+    /** Override spec content fetching (for testing) */
+    _getSpec?: (domain: string, specMap: SpecMap, rootPath: string) => Promise<string | null>;
+}): Promise<DriftIssue[]>;
+/**
+ * Run all drift detection algorithms and produce a combined result
+ */
+export declare function detectDrift(options: DriftDetectorOptions): Promise<DriftResult>;
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/core/drift/drift-detector.d.ts.map

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