spec-gen-cli 1.0.0

package/dist/core/drift/git-diff.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Git diff integration for drift detection
+ *
+ * Shells out to git to determine what files changed between the current
+ * working tree and a base ref (typically main/master).
+ */
+import type { ChangedFile } from '../../types/index.js';
+export interface GitDiffOptions {
+    rootPath: string;
+    baseRef: string;
+    pathFilter?: string[];
+    includeUnstaged: boolean;
+}
+export interface GitDiffResult {
+    resolvedBase: string;
+    files: ChangedFile[];
+    hasUnstagedChanges: boolean;
+    currentBranch: string;
+}
+/**
+ * Classify a file path as test/config/generated
+ */
+export declare function classifyFile(filePath: string): Pick<ChangedFile, 'isTest' | 'isConfig' | 'isGenerated' | 'extension'>;
+/**
+ * Check if a file is a skippable binary/lock file
+ */
+export declare function isSkippableFile(filePath: string): boolean;
+/**
+ * Check if the given path is a git repository
+ */
+export declare function isGitRepository(rootPath: string): Promise<boolean>;
+/**
+ * Get the current branch name
+ */
+export declare function getCurrentBranch(rootPath: string): Promise<string>;
+/**
+ * Validate a user-supplied git ref to prevent unexpected git argument injection.
+ * Allows branch/tag names, SHA hashes, relative refs (HEAD~1, @{upstream}), and
+ * the empty-tree SHA. Rejects refs containing shell metacharacters or null bytes.
+ */
+export declare function validateGitRef(ref: string): void;
+/**
+ * Resolve a base ref, falling back through main → master → HEAD~1
+ */
+export declare function resolveBaseRef(rootPath: string, preferredRef: string): Promise<string>;
+/**
+ * Get the unified diff content for a specific file against a base ref.
+ * Returns the diff text, truncated to maxChars to fit LLM context windows.
+ */
+export declare function getFileDiff(rootPath: string, filePath: string, baseRef: string, maxChars?: number): Promise<string>;
+/**
+ * Get changed files between working tree and a base ref
+ */
+export declare function getChangedFiles(options: GitDiffOptions): Promise<GitDiffResult>;
+//# sourceMappingURL=git-diff.d.ts.map

package/dist/core/drift/git-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.d.ts","sourceRoot":"","sources":["../../../src/core/drift/git-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAWxD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAuDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CAAC,CAkBrH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzD;AAMD;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B5F;AA6ED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAkHrF"}

package/dist/core/drift/git-diff.js

@@ -0,0 +1,356 @@
+/**
+ * Git diff integration for drift detection
+ *
+ * Shells out to git to determine what files changed between the current
+ * working tree and a base ref (typically main/master).
+ */
+import { execFile } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { join, extname, basename } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Git's well-known empty tree SHA — used as base ref for single-commit repos */
+const GIT_EMPTY_TREE_SHA = '4b825dc642cb6eb9a060e54bf899d15f71049056';
+// ============================================================================
+// FILE CLASSIFICATION (mirrors FileWalker heuristics)
+// ============================================================================
+const TEST_DIR_PATTERNS = [
+    /\/test\//,
+    /\/tests\//,
+    /\/__tests__\//,
+    /\/spec\//,
+    /\/specs\//,
+    /^test\//,
+    /^tests\//,
+    /^__tests__\//,
+];
+const TEST_FILE_PATTERNS = [
+    /\.test\.[^.]+$/,
+    /\.spec\.[^.]+$/,
+    /_test\.[^.]+$/,
+    /_spec\.[^.]+$/,
+    /^test_.*\.[^.]+$/,
+];
+const CONFIG_PATTERNS = [
+    /^\..*rc$/,
+    /^\..*rc\.(js|json|yaml|yml)$/,
+    /config\./,
+    /\.config\./,
+    /settings\./,
+    /^tsconfig.*\.json$/,
+    /^package\.json$/,
+    /^pyproject\.toml$/,
+    /^Cargo\.toml$/,
+    /^go\.mod$/,
+    /^Gemfile$/,
+    /^composer\.json$/,
+];
+const SKIP_EXTENSIONS = new Set([
+    '.lock', '.lockb', '.map',
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.webp', '.bmp',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.mp3', '.mp4', '.wav', '.avi', '.mov', '.webm',
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx',
+    '.zip', '.tar', '.gz', '.rar', '.7z',
+    '.pyc', '.pyo', '.class', '.o', '.so', '.dll', '.exe',
+]);
+const SKIP_FILENAMES = new Set([
+    'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock',
+    '.DS_Store', 'Thumbs.db',
+]);
+/**
+ * Classify a file path as test/config/generated
+ */
+export function classifyFile(filePath) {
+    const fileName = basename(filePath);
+    const ext = extname(filePath);
+    const isTest = TEST_DIR_PATTERNS.some(p => p.test(filePath)) ||
+        TEST_FILE_PATTERNS.some(p => p.test(fileName));
+    const isConfig = CONFIG_PATTERNS.some(p => p.test(fileName));
+    const isGenerated = fileName.endsWith('.d.ts') ||
+        fileName.endsWith('.generated.ts') ||
+        fileName.endsWith('.generated.js') ||
+        filePath.includes('/generated/') ||
+        filePath.includes('/__generated__/');
+    return { isTest, isConfig, isGenerated, extension: ext };
+}
+/**
+ * Check if a file is a skippable binary/lock file
+ */
+export function isSkippableFile(filePath) {
+    const fileName = basename(filePath);
+    const ext = extname(filePath);
+    return SKIP_EXTENSIONS.has(ext) || SKIP_FILENAMES.has(fileName);
+}
+// ============================================================================
+// GIT OPERATIONS
+// ============================================================================
+/**
+ * Check if the given path is a git repository
+ */
+export async function isGitRepository(rootPath) {
+    try {
+        await access(join(rootPath, '.git'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the current branch name
+ */
+export async function getCurrentBranch(rootPath) {
+    try {
+        const { stdout } = await execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: rootPath });
+        return stdout.trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Validate a user-supplied git ref to prevent unexpected git argument injection.
+ * Allows branch/tag names, SHA hashes, relative refs (HEAD~1, @{upstream}), and
+ * the empty-tree SHA. Rejects refs containing shell metacharacters or null bytes.
+ */
+export function validateGitRef(ref) {
+    if (ref === GIT_EMPTY_TREE_SHA || ref === 'auto')
+        return;
+    // Allow: alphanumeric, -, _, ., /, ~, ^, @, {, }, :
+    if (!/^[\w\-./~^@{}:]+$/.test(ref)) {
+        throw new Error(`Invalid git ref: "${ref}". Refs must contain only alphanumeric characters and -_./ ~^@{}:`);
+    }
+}
+/**
+ * Resolve a base ref, falling back through main → master → HEAD~1
+ */
+export async function resolveBaseRef(rootPath, preferredRef) {
+    if (preferredRef && preferredRef !== 'auto') {
+        validateGitRef(preferredRef);
+        try {
+            await execFileAsync('git', ['rev-parse', '--verify', preferredRef], { cwd: rootPath });
+            return preferredRef;
+        }
+        catch {
+            // Fall through to defaults
+        }
+    }
+    // Try common default branches
+    for (const ref of ['main', 'master']) {
+        try {
+            await execFileAsync('git', ['rev-parse', '--verify', ref], { cwd: rootPath });
+            return ref;
+        }
+        catch {
+            continue;
+        }
+    }
+    // Try HEAD~1 (previous commit)
+    try {
+        await execFileAsync('git', ['rev-parse', '--verify', 'HEAD~1'], { cwd: rootPath });
+        return 'HEAD~1';
+    }
+    catch {
+        // Single-commit repo or detached HEAD with no parent — use the empty tree SHA
+        // so git diff shows all files as "added"
+        return GIT_EMPTY_TREE_SHA;
+    }
+}
+/**
+ * Parse a git status character into a ChangedFile status
+ */
+function parseGitStatus(statusChar) {
+    switch (statusChar) {
+        case 'A': return 'added';
+        case 'D': return 'deleted';
+        case 'M': return 'modified';
+        case 'R': return 'renamed';
+        case 'C': return 'added'; // copied = effectively added
+        default: return 'modified';
+    }
+}
+/**
+ * Parse git diff --name-status output into file entries
+ */
+function parseNameStatus(output) {
+    const entries = [];
+    const lines = output.trim().split('\n').filter(Boolean);
+    for (const line of lines) {
+        const parts = line.split('\t');
+        if (parts.length < 2)
+            continue;
+        const statusRaw = parts[0].charAt(0); // R100 → R
+        const status = parseGitStatus(statusRaw);
+        if (statusRaw === 'R' && parts.length >= 3) {
+            entries.push({ path: parts[2], status: 'renamed', oldPath: parts[1] });
+        }
+        else {
+            entries.push({ path: parts[1], status });
+        }
+    }
+    return entries;
+}
+/**
+ * Parse git diff --numstat output into addition/deletion counts.
+ * Handles rename format: "10\t5\told/path => new/path" or "10\t5\t{dir => dir2}/file.ts"
+ */
+function parseNumstat(output) {
+    const stats = new Map();
+    const lines = output.trim().split('\n').filter(Boolean);
+    for (const line of lines) {
+        const parts = line.split('\t');
+        if (parts.length < 3)
+            continue;
+        // Binary files show '-' for additions/deletions
+        const additions = parts[0] === '-' ? 0 : parseInt(parts[0], 10);
+        const deletions = parts[1] === '-' ? 0 : parseInt(parts[1], 10);
+        let filePath = parts.slice(2).join('\t'); // Rejoin in case path contained tabs
+        // Handle rename formats:
+        //   "old/path => new/path"  →  extract "new/path"
+        //   "{old => new}/file.ts"  →  expand to "new/file.ts"
+        if (filePath.includes(' => ')) {
+            const braceMatch = filePath.match(/^(.*?)\{[^}]* => ([^}]*)\}(.*)$/);
+            if (braceMatch) {
+                // "{old => new}/file.ts" format
+                filePath = braceMatch[1] + braceMatch[2] + braceMatch[3];
+            }
+            else {
+                // "old/path => new/path" format
+                filePath = filePath.split(' => ').pop();
+            }
+        }
+        stats.set(filePath, { additions, deletions });
+    }
+    return stats;
+}
+/**
+ * Get the unified diff content for a specific file against a base ref.
+ * Returns the diff text, truncated to maxChars to fit LLM context windows.
+ */
+export async function getFileDiff(rootPath, filePath, baseRef, maxChars = 4000) {
+    // Try three-dot diff first (merge-base), fall back to two-dot
+    for (const separator of ['...', '..']) {
+        try {
+            const { stdout } = await execFileAsync('git', ['diff', `${baseRef}${separator}HEAD`, '--', filePath], { cwd: rootPath });
+            if (stdout.trim()) {
+                return stdout.length > maxChars
+                    ? stdout.slice(0, maxChars) + '\n... (truncated)'
+                    : stdout;
+            }
+        }
+        catch {
+            // Try next separator
+        }
+    }
+    // Fall back to unstaged/staged diff (for uncommitted changes)
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', 'HEAD', '--', filePath], { cwd: rootPath });
+        if (stdout.trim()) {
+            return stdout.length > maxChars
+                ? stdout.slice(0, maxChars) + '\n... (truncated)'
+                : stdout;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '';
+}
+/**
+ * Get changed files between working tree and a base ref
+ */
+export async function getChangedFiles(options) {
+    const { rootPath, baseRef, includeUnstaged } = options;
+    // Resolve base ref
+    const resolvedBase = await resolveBaseRef(rootPath, baseRef);
+    const currentBranch = await getCurrentBranch(rootPath);
+    const fileMap = new Map();
+    // Get committed changes on branch vs base
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', '--name-status', '--diff-filter=ACDMR', `${resolvedBase}...HEAD`], { cwd: rootPath });
+        for (const entry of parseNameStatus(stdout)) {
+            fileMap.set(entry.path, { status: entry.status, oldPath: entry.oldPath });
+        }
+    }
+    catch {
+        // If three-dot diff fails (e.g., no common ancestor), try two-dot
+        try {
+            const { stdout } = await execFileAsync('git', ['diff', '--name-status', '--diff-filter=ACDMR', `${resolvedBase}..HEAD`], { cwd: rootPath });
+            for (const entry of parseNameStatus(stdout)) {
+                fileMap.set(entry.path, { status: entry.status, oldPath: entry.oldPath });
+            }
+        }
+        catch {
+            // If that also fails, fall through with empty committed changes
+        }
+    }
+    // Get unstaged + staged changes if requested
+    let hasUnstagedChanges = false;
+    if (includeUnstaged) {
+        // Staged changes
+        try {
+            const { stdout } = await execFileAsync('git', ['diff', '--cached', '--name-status', '--diff-filter=ACDMR'], { cwd: rootPath });
+            for (const entry of parseNameStatus(stdout)) {
+                if (!fileMap.has(entry.path)) {
+                    fileMap.set(entry.path, { status: entry.status, oldPath: entry.oldPath });
+                }
+            }
+        }
+        catch { /* ignore */ }
+        // Unstaged working tree changes
+        try {
+            const { stdout } = await execFileAsync('git', ['diff', '--name-status', '--diff-filter=ACDMR'], { cwd: rootPath });
+            const unstaged = parseNameStatus(stdout);
+            if (unstaged.length > 0) {
+                hasUnstagedChanges = true;
+                for (const entry of unstaged) {
+                    if (!fileMap.has(entry.path)) {
+                        fileMap.set(entry.path, { status: entry.status, oldPath: entry.oldPath });
+                    }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Get line-level stats
+    let numstatMap = new Map();
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', '--numstat', `${resolvedBase}...HEAD`], { cwd: rootPath });
+        numstatMap = parseNumstat(stdout);
+    }
+    catch {
+        try {
+            const { stdout } = await execFileAsync('git', ['diff', '--numstat', `${resolvedBase}..HEAD`], { cwd: rootPath });
+            numstatMap = parseNumstat(stdout);
+        }
+        catch { /* ignore */ }
+    }
+    // Build ChangedFile list
+    const files = [];
+    for (const [path, { status, oldPath }] of fileMap) {
+        if (isSkippableFile(path))
+            continue;
+        const stats = numstatMap.get(path) ?? { additions: 0, deletions: 0 };
+        const classification = classifyFile(path);
+        files.push({
+            path,
+            status,
+            oldPath,
+            additions: stats.additions,
+            deletions: stats.deletions,
+            ...classification,
+        });
+    }
+    // Apply path filter if provided
+    const filtered = options.pathFilter?.length
+        ? files.filter(f => options.pathFilter.some(p => f.path.startsWith(p) || f.path === p))
+        : files;
+    return {
+        resolvedBase,
+        files: filtered,
+        hasUnstagedChanges,
+        currentBranch,
+    };
+}
+//# sourceMappingURL=git-diff.js.map

package/dist/core/drift/git-diff.js.map

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

package/dist/core/drift/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Drift detection module
+ *
+ * Detects when code changes diverge from existing OpenSpec specifications.
+ */
+export { getChangedFiles, getFileDiff, isGitRepository, getCurrentBranch, resolveBaseRef, classifyFile } from './git-diff.js';
+export type { GitDiffOptions, GitDiffResult } from './git-diff.js';
+export { buildSpecMap, matchFileToDomains, getSpecContent, parseSpecHeader, parseSpecReferences, inferDomainFromPath, buildADRMap, parseADRRelated } from './spec-mapper.js';
+export type { SpecMapperOptions, ADRMapping, ADRMap } from './spec-mapper.js';
+export { detectDrift, detectGaps, detectStaleSpecs, detectUncoveredFiles, detectOrphanedSpecs, isSpecRelevantChange, computeSeverity, extractChangedSpecDomains, enhanceGapsWithLLM, detectADRGaps, detectADROrphaned, extractChangedADRIds } from './drift-detector.js';
+export type { DriftDetectorOptions } from './drift-detector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/drift/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/drift/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC7K,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzQ,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/drift/index.js

@@ -0,0 +1,9 @@
+/**
+ * Drift detection module
+ *
+ * Detects when code changes diverge from existing OpenSpec specifications.
+ */
+export { getChangedFiles, getFileDiff, isGitRepository, getCurrentBranch, resolveBaseRef, classifyFile } from './git-diff.js';
+export { buildSpecMap, matchFileToDomains, getSpecContent, parseSpecHeader, parseSpecReferences, inferDomainFromPath, buildADRMap, parseADRRelated } from './spec-mapper.js';
+export { detectDrift, detectGaps, detectStaleSpecs, detectUncoveredFiles, detectOrphanedSpecs, isSpecRelevantChange, computeSeverity, extractChangedSpecDomains, enhanceGapsWithLLM, detectADRGaps, detectADROrphaned, extractChangedADRIds } from './drift-detector.js';
+//# sourceMappingURL=index.js.map

package/dist/core/drift/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/drift/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG9H,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG7K,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/drift/spec-mapper.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Spec-to-File Mapper
+ *
+ * Reads existing OpenSpec specs and builds a bidirectional mapping
+ * between spec domains and source files. This is the core data structure
+ * that enables drift detection.
+ */
+import type { SpecMap } from '../../types/index.js';
+export interface SpecMapperOptions {
+    rootPath: string;
+    openspecPath: string;
+    repoStructurePath?: string;
+}
+/**
+ * Extract source files from the spec header line:
+ *   > Source files: src/foo.ts, src/bar.ts
+ */
+export declare function parseSpecHeader(content: string): {
+    sourceFiles: string[];
+    generatedDate: string | null;
+};
+/**
+ * Extract file references, requirements, and entities from spec body
+ */
+export declare function parseSpecReferences(content: string): {
+    files: string[];
+    requirements: string[];
+    entities: string[];
+};
+/**
+ * Try to infer a domain for a file path based on directory structure.
+ * Uses word-boundary matching to avoid false positives (e.g., domain "auth"
+ * should match "auth-service.ts" but not "authorize.ts").
+ */
+export declare function inferDomainFromPath(filePath: string, knownDomains: string[]): string | null;
+/**
+ * Build a bidirectional map between spec domains and source files
+ */
+export declare function buildSpecMap(options: SpecMapperOptions): Promise<SpecMap>;
+/**
+ * Load spec content for a domain, reading the spec file from disk.
+ * Returns the markdown content truncated to maxChars, or null if unavailable.
+ */
+export declare function getSpecContent(domain: string, specMap: SpecMap, rootPath: string, maxChars?: number): Promise<string | null>;
+/**
+ * Find which domains a file maps to, using direct lookup + directory inference
+ */
+export declare function matchFileToDomains(filePath: string, specMap: SpecMap): string[];
+export interface ADRMapping {
+    id: string;
+    title: string;
+    adrPath: string;
+    relatedDomains: string[];
+    relatedLayers: string[];
+    status: string;
+}
+export interface ADRMap {
+    byId: Map<string, ADRMapping>;
+    byDomain: Map<string, string[]>;
+}
+/**
+ * Parse the ## Related section from an ADR file to extract domains and layers.
+ */
+export declare function parseADRRelated(content: string): {
+    domains: string[];
+    layers: string[];
+};
+/**
+ * Build an ADR map by reading all ADR files from the decisions directory.
+ * Returns null if no decisions directory exists.
+ */
+export declare function buildADRMap(options: SpecMapperOptions): Promise<ADRMap | null>;
+//# sourceMappingURL=spec-mapper.d.ts.map

package/dist/core/drift/spec-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/drift/spec-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAe,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAOjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAwBxG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAgDA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CA8B3F;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8G/E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAe/E;AAMD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAexF;AA0BD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqDpF"}