codesift-mcp 0.1.0

package/dist/tools/search-tools.js

@@ -0,0 +1,309 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, relative, extname } from "node:path";
+import { getBM25Index, getCodeIndex } from "./index-tools.js";
+import { searchBM25 } from "../search/bm25.js";
+import { loadConfig } from "../config.js";
+const DEFAULT_MAX_TEXT_MATCHES = 500;
+const MAX_FILE_SIZE = 1_000_000; // 1MB — skip giant files
+const MAX_WALK_FILES = 50_000; // Safety limit — stop walking after this many files
+/** Directories to skip during text search file walk */
+const IGNORE_DIRS = new Set([
+    "node_modules", ".git", "dist", "build", "coverage",
+    ".codesift", ".next", "__pycache__", ".pytest_cache",
+    ".venv", "venv", ".tox", ".mypy_cache", ".turbo",
+    "generated", "audit-results", ".backup", "jscpd-report",
+]);
+/** Binary/non-text extensions to skip during text search */
+const BINARY_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".svg",
+    ".woff", ".woff2", ".ttf", ".eot", ".otf",
+    ".zip", ".gz", ".tar", ".bz2", ".7z", ".rar",
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
+    ".exe", ".dll", ".so", ".dylib", ".o", ".obj",
+    ".wasm", ".class", ".pyc", ".pyo",
+    ".mp3", ".mp4", ".avi", ".mov", ".mkv", ".wav", ".flac",
+    ".db", ".sqlite", ".sqlite3",
+    ".lock",
+]);
+/**
+ * Match a file path against a simple glob pattern.
+ * Supports: "*.ts", "src/*.ts", "src/**\/*.ts", "**\/*.test.ts"
+ */
+function matchFilePattern(filePath, pattern) {
+    // Exact match
+    if (filePath === pattern)
+        return true;
+    // "**\/" prefix — match anywhere in path
+    if (pattern.startsWith("**/")) {
+        const suffix = pattern.slice(3);
+        // Recursively match the suffix against every segment tail
+        return matchFilePattern(filePath, suffix) ||
+            filePath.includes("/" + suffix) ||
+            matchFileSuffix(filePath, suffix);
+    }
+    // "*" at the start — match extension-style patterns like "*.ts"
+    if (pattern.startsWith("*") && !pattern.includes("/")) {
+        const suffix = pattern.slice(1);
+        return filePath.endsWith(suffix);
+    }
+    // "dir/**" — match everything under directory (e.g., "src/**")
+    if (pattern.endsWith("/**")) {
+        const prefix = pattern.slice(0, -3);
+        return filePath.startsWith(prefix + "/") || filePath === prefix;
+    }
+    // Pattern with "**" in the middle (e.g., "src/**/*.ts")
+    if (pattern.includes("/**/")) {
+        const [prefix, suffix] = splitFirst(pattern, "/**/");
+        if (!filePath.startsWith(prefix + "/") && filePath !== prefix)
+            return false;
+        const rest = filePath.slice(prefix.length + 1);
+        return matchFilePattern(rest, suffix) ||
+            matchFilePattern(rest, "**/" + suffix);
+    }
+    // Simple directory prefix + filename pattern (e.g., "src/*.ts")
+    if (pattern.includes("/") && pattern.includes("*")) {
+        const lastSlash = pattern.lastIndexOf("/");
+        const dirPart = pattern.slice(0, lastSlash);
+        const filePart = pattern.slice(lastSlash + 1);
+        const fileLastSlash = filePath.lastIndexOf("/");
+        const fileDir = fileLastSlash >= 0 ? filePath.slice(0, fileLastSlash) : "";
+        const fileName = fileLastSlash >= 0 ? filePath.slice(fileLastSlash + 1) : filePath;
+        if (fileDir !== dirPart)
+            return false;
+        return matchFilePattern(fileName, filePart);
+    }
+    // No wildcards: substring match on the full path
+    // "risk.service.ts" matches "src/lib/services/risk/risk.service.ts"
+    // "validators" matches "src/lib/validators/schema.ts"
+    if (!pattern.includes("*")) {
+        return filePath.includes(pattern);
+    }
+    return false;
+}
+function matchFileSuffix(filePath, suffix) {
+    if (suffix.startsWith("*")) {
+        const ext = suffix.slice(1);
+        return filePath.endsWith(ext);
+    }
+    return filePath.endsWith("/" + suffix) || filePath === suffix;
+}
+function splitFirst(str, sep) {
+    const idx = str.indexOf(sep);
+    if (idx < 0)
+        return [str, ""];
+    return [str.slice(0, idx), str.slice(idx + sep.length)];
+}
+/**
+ * Walk a directory tree collecting all text files.
+ * Returns relative paths from rootPath.
+ * Unlike the index walk, this includes ALL text files (not just parseable ones).
+ */
+async function walkAllTextFiles(rootPath) {
+    const files = [];
+    let limitReached = false;
+    async function walk(dirPath) {
+        if (limitReached)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dirPath, { withFileTypes: true });
+        }
+        catch {
+            return; // permission denied, etc.
+        }
+        for (const entry of entries) {
+            if (limitReached)
+                return;
+            const fullPath = join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORE_DIRS.has(entry.name) || entry.name.startsWith(".")) {
+                    continue;
+                }
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                const ext = extname(entry.name);
+                // Skip binary files
+                if (BINARY_EXTENSIONS.has(ext))
+                    continue;
+                // Skip files that are too large
+                try {
+                    const fileStat = await stat(fullPath);
+                    if (fileStat.size > MAX_FILE_SIZE)
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                files.push(relative(rootPath, fullPath));
+                if (files.length >= MAX_WALK_FILES) {
+                    console.warn(`[codesift] walkAllTextFiles: reached ${MAX_WALK_FILES} file limit, returning partial results`);
+                    limitReached = true;
+                    return;
+                }
+            }
+        }
+    }
+    await walk(rootPath);
+    return files;
+}
+/**
+ * Search symbols by name/signature/docstring using BM25 ranking.
+ * Supports filtering by symbol kind and file pattern.
+ *
+ * When query is empty, returns all symbols matching the filters (up to top_k).
+ * When kind or file_pattern filters are active, BM25 searches a wider candidate
+ * set to avoid post-filter truncation.
+ */
+export async function searchSymbols(repo, query, options) {
+    const index = await getBM25Index(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Run index_folder first.`);
+    }
+    const config = loadConfig();
+    const topK = options?.top_k ?? config.defaultTopK;
+    const includeSource = options?.include_source ?? true;
+    const hasKindFilter = !!options?.kind;
+    const hasFileFilter = !!options?.file_pattern;
+    const hasFilters = hasKindFilter || hasFileFilter;
+    let results;
+    if (!query.trim()) {
+        // Empty query: return all symbols matching filters (no BM25 scoring)
+        const allSymbols = [...index.symbols.values()];
+        let filtered = allSymbols;
+        if (hasKindFilter) {
+            const kind = options.kind;
+            filtered = filtered.filter((s) => s.kind === kind);
+        }
+        if (hasFileFilter) {
+            const pattern = options.file_pattern;
+            filtered = filtered.filter((s) => matchFilePattern(s.file, pattern));
+        }
+        results = filtered.slice(0, topK).map((symbol) => ({
+            symbol,
+            score: 0,
+        }));
+    }
+    else {
+        // When filters are active, search a wider candidate set from BM25
+        // so that post-filter truncation doesn't lose relevant results.
+        const searchTopK = hasFilters ? Math.max(topK * 5, 200) : topK;
+        results = searchBM25(index, query, searchTopK, config.bm25FieldWeights);
+        // Filter by symbol kind
+        if (hasKindFilter) {
+            const kind = options.kind;
+            results = results.filter((r) => r.symbol.kind === kind);
+        }
+        // Filter by file pattern
+        if (hasFileFilter) {
+            const pattern = options.file_pattern;
+            results = results.filter((r) => matchFilePattern(r.symbol.file, pattern));
+        }
+        // Re-truncate to requested top_k after filtering
+        results = results.slice(0, topK);
+    }
+    // Strip source if not requested
+    if (!includeSource) {
+        results = results.map((r) => {
+            const { source: _source, ...symbolWithoutSource } = r.symbol;
+            return { ...r, symbol: symbolWithoutSource };
+        });
+    }
+    // Truncate source to source_chars limit (default 500 when include_source=true)
+    const sourceChars = options?.source_chars ?? (includeSource ? 500 : undefined);
+    if (includeSource && sourceChars !== undefined && sourceChars > 0) {
+        results = results.map((r) => {
+            const source = r.symbol.source;
+            if (source && source.length > sourceChars) {
+                return {
+                    ...r,
+                    symbol: { ...r.symbol, source: source.slice(0, sourceChars) + "..." },
+                };
+            }
+            return r;
+        });
+    }
+    return results;
+}
+/**
+ * Full-text search across all files in a repository.
+ * Walks the filesystem to search ALL text files, not just indexed ones.
+ */
+export async function searchText(repo, query, options) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Run index_folder first.`);
+    }
+    const contextLines = options?.context_lines ?? 2;
+    const useRegex = options?.regex ?? false;
+    const filePattern = options?.file_pattern;
+    const maxResults = options?.max_results ?? DEFAULT_MAX_TEXT_MATCHES;
+    let regex = null;
+    if (useRegex) {
+        try {
+            regex = new RegExp(query);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Invalid regex pattern: ${message}`);
+        }
+    }
+    // Walk the filesystem to find ALL text files (not just indexed/parseable ones)
+    const allFiles = await walkAllTextFiles(index.root);
+    const matches = [];
+    for (const filePath of allFiles) {
+        if (matches.length >= maxResults)
+            break;
+        // Filter by file pattern
+        if (filePattern && !matchFilePattern(filePath, filePattern)) {
+            continue;
+        }
+        const fullPath = join(index.root, filePath);
+        let content;
+        try {
+            content = await readFile(fullPath, "utf-8");
+        }
+        catch {
+            continue; // File may have been deleted or moved
+        }
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            if (matches.length >= maxResults)
+                break;
+            const line = lines[i];
+            if (line === undefined)
+                continue;
+            const isMatch = regex ? regex.test(line) : line.includes(query);
+            if (!isMatch)
+                continue;
+            const contextBefore = [];
+            const contextAfter = [];
+            for (let j = Math.max(0, i - contextLines); j < i; j++) {
+                const ctxLine = lines[j];
+                if (ctxLine !== undefined) {
+                    contextBefore.push(ctxLine);
+                }
+            }
+            for (let j = i + 1; j <= Math.min(lines.length - 1, i + contextLines); j++) {
+                const ctxLine = lines[j];
+                if (ctxLine !== undefined) {
+                    contextAfter.push(ctxLine);
+                }
+            }
+            const match = {
+                file: filePath,
+                line: i + 1, // 1-based
+                content: line,
+            };
+            if (contextBefore.length > 0) {
+                match.context_before = contextBefore;
+            }
+            if (contextAfter.length > 0) {
+                match.context_after = contextAfter;
+            }
+            matches.push(match);
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=search-tools.js.map

package/dist/tools/search-tools.js.map

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

package/dist/tools/symbol-tools.d.ts

@@ -0,0 +1,24 @@
+import type { CodeSymbol, Reference } from "../types.js";
+/**
+ * Retrieve a single symbol by ID with fresh source from disk.
+ */
+export declare function getSymbol(repo: string, symbolId: string): Promise<CodeSymbol | null>;
+/**
+ * Retrieve multiple symbols by ID with fresh source from disk.
+ * Groups reads by file to minimize disk I/O.
+ */
+export declare function getSymbols(repo: string, symbolIds: string[]): Promise<CodeSymbol[]>;
+/**
+ * Find references to a symbol name across indexed files.
+ * Matches whole words only using word-boundary regex.
+ */
+export declare function findReferences(repo: string, symbolName: string, filePattern?: string): Promise<Reference[]>;
+/**
+ * Search for a symbol by query and return it with full source.
+ * Optionally includes references across the codebase.
+ */
+export declare function findAndShow(repo: string, query: string, includeRefs?: boolean): Promise<{
+    symbol: CodeSymbol;
+    references?: Reference[];
+} | null>;
+//# sourceMappingURL=symbol-tools.d.ts.map

package/dist/tools/symbol-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-tools.d.ts","sourceRoot":"","sources":["../../src/tools/symbol-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAwBzD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqB5B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CA0DvB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmDtB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAqBlE"}

package/dist/tools/symbol-tools.js

@@ -0,0 +1,172 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { searchBM25 } from "../search/bm25.js";
+import { loadConfig } from "../config.js";
+import { getCodeIndex, getBM25Index } from "./index-tools.js";
+const MAX_REFERENCES = 200;
+const MAX_CONTEXT_LENGTH = 200; // Truncate context lines to prevent huge output from minified files
+/**
+ * Read a source file and extract lines for a symbol (1-based, inclusive).
+ * Returns undefined if the file cannot be read.
+ */
+async function extractSource(repoRoot, file, startLine, endLine) {
+    try {
+        const content = await readFile(join(repoRoot, file), "utf-8");
+        const lines = content.split("\n");
+        return lines.slice(startLine - 1, endLine).join("\n");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Retrieve a single symbol by ID with fresh source from disk.
+ */
+export async function getSymbol(repo, symbolId) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const symbol = index.symbols.find((s) => s.id === symbolId);
+    if (!symbol)
+        return null;
+    const source = await extractSource(index.root, symbol.file, symbol.start_line, symbol.end_line);
+    const result = { ...symbol };
+    if (source !== undefined) {
+        result.source = source;
+    }
+    return result;
+}
+/**
+ * Retrieve multiple symbols by ID with fresh source from disk.
+ * Groups reads by file to minimize disk I/O.
+ */
+export async function getSymbols(repo, symbolIds) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    // Build lookup map for requested symbols
+    const symbolMap = new Map();
+    for (const sym of index.symbols) {
+        if (symbolIds.includes(sym.id)) {
+            symbolMap.set(sym.id, sym);
+        }
+    }
+    // Group symbols by file to read each file only once
+    const byFile = new Map();
+    for (const id of symbolIds) {
+        const sym = symbolMap.get(id);
+        if (!sym)
+            continue;
+        let group = byFile.get(sym.file);
+        if (!group) {
+            group = [];
+            byFile.set(sym.file, group);
+        }
+        group.push(sym);
+    }
+    // Read each file once, extract source for all symbols in that file
+    const results = new Map();
+    for (const [file, symbols] of byFile) {
+        let fileContent;
+        try {
+            fileContent = await readFile(join(index.root, file), "utf-8");
+        }
+        catch {
+            // File may have been deleted since indexing
+        }
+        const lines = fileContent?.split("\n");
+        for (const sym of symbols) {
+            const result = { ...sym };
+            if (lines) {
+                result.source = lines.slice(sym.start_line - 1, sym.end_line).join("\n");
+            }
+            results.set(sym.id, result);
+        }
+    }
+    // Return in the same order as requested, skipping missing IDs
+    const ordered = [];
+    for (const id of symbolIds) {
+        const sym = results.get(id);
+        if (sym)
+            ordered.push(sym);
+    }
+    return ordered;
+}
+/**
+ * Find references to a symbol name across indexed files.
+ * Matches whole words only using word-boundary regex.
+ */
+export async function findReferences(repo, symbolName, filePattern) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    // Escape special regex characters in symbol name
+    const escaped = symbolName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`\\b${escaped}\\b`);
+    // Optional file pattern filter
+    const fileFilter = filePattern
+        ? new RegExp(filePattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\\*/g, ".*"))
+        : null;
+    const refs = [];
+    for (const fileEntry of index.files) {
+        if (refs.length >= MAX_REFERENCES)
+            break;
+        if (fileFilter && !fileFilter.test(fileEntry.path))
+            continue;
+        let content;
+        try {
+            content = await readFile(join(index.root, fileEntry.path), "utf-8");
+        }
+        catch {
+            continue; // File may have been deleted
+        }
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            if (refs.length >= MAX_REFERENCES)
+                break;
+            const line = lines[i];
+            if (line === undefined)
+                continue;
+            const match = pattern.exec(line);
+            if (match) {
+                const rawContext = line.trimEnd();
+                refs.push({
+                    file: fileEntry.path,
+                    line: i + 1,
+                    col: match.index + 1,
+                    context: rawContext.length > MAX_CONTEXT_LENGTH
+                        ? rawContext.slice(0, MAX_CONTEXT_LENGTH) + "..."
+                        : rawContext,
+                });
+            }
+        }
+    }
+    return refs;
+}
+/**
+ * Search for a symbol by query and return it with full source.
+ * Optionally includes references across the codebase.
+ */
+export async function findAndShow(repo, query, includeRefs) {
+    const bm25Index = await getBM25Index(repo);
+    if (!bm25Index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const config = loadConfig();
+    const results = searchBM25(bm25Index, query, 1, config.bm25FieldWeights);
+    const topResult = results[0];
+    if (!topResult)
+        return null;
+    const fullSymbol = await getSymbol(repo, topResult.symbol.id);
+    if (!fullSymbol)
+        return null;
+    if (includeRefs) {
+        const references = await findReferences(repo, fullSymbol.name);
+        return { symbol: fullSymbol, references };
+    }
+    return { symbol: fullSymbol };
+}
+//# sourceMappingURL=symbol-tools.js.map

package/dist/tools/symbol-tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+export type SymbolKind = "function" | "method" | "class" | "interface" | "type" | "variable" | "constant" | "field" | "enum" | "namespace" | "module" | "section" | "metadata" | "test_suite" | "test_case" | "test_hook" | "default_export" | "unknown";
+export interface FileLocation {
+    file: string;
+    start_line: number;
+    end_line: number;
+    start_col?: number;
+    end_col?: number;
+}
+export interface CodeSymbol extends FileLocation {
+    id: string;
+    repo: string;
+    name: string;
+    kind: SymbolKind;
+    signature?: string;
+    docstring?: string;
+    source?: string;
+    parent?: string;
+    tokens?: string[];
+}
+export interface FileEntry {
+    path: string;
+    language: string;
+    symbol_count: number;
+    last_modified: number;
+}
+export interface CodeIndex {
+    repo: string;
+    root: string;
+    symbols: CodeSymbol[];
+    files: FileEntry[];
+    created_at: number;
+    updated_at: number;
+    symbol_count: number;
+    file_count: number;
+}
+export interface RepoMeta {
+    name: string;
+    root: string;
+    index_path: string;
+    symbol_count: number;
+    file_count: number;
+    updated_at: number;
+}
+export interface Registry {
+    repos: Record<string, RepoMeta>;
+    updated_at: number;
+}
+export interface SearchResult {
+    symbol: CodeSymbol;
+    score: number;
+    matches?: string[];
+}
+export interface Reference {
+    file: string;
+    line: number;
+    col?: number;
+    context: string;
+}
+export interface TextMatch {
+    file: string;
+    line: number;
+    content: string;
+    context_before?: string[];
+    context_after?: string[];
+}
+export type Direction = "callers" | "callees";
+export interface CallNode {
+    symbol: CodeSymbol;
+    children: CallNode[];
+}
+export interface ImpactResult {
+    changed_files: string[];
+    affected_symbols: CodeSymbol[];
+    dependency_graph: Record<string, string[]>;
+}
+export interface EmbeddingMeta {
+    model: string;
+    provider: "voyage" | "openai" | "ollama";
+    dimensions: number;
+    symbol_count: number;
+    updated_at: number;
+}
+export interface CodeChunk {
+    id: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    text: string;
+    tokenCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core domain types for CodeSift
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iCAAiC"}

package/dist/utils/git-validation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Git ref/URL validation utilities — shared across tools that invoke git.
+ * Prevents command injection when refs/URLs are passed to execFileSync.
+ */
+/** Allows alphanumeric, `/`, `.`, `-`, `_`, `~`, `^`, `@`, `{`, `}`. */
+export declare const GIT_REF_PATTERN: RegExp;
+export declare function validateGitRef(ref: string): void;
+/** Allows HTTPS, SSH, git://, and file:// protocols. */
+export declare const GIT_URL_PATTERN: RegExp;
+export declare function validateGitUrl(url: string): void;
+//# sourceMappingURL=git-validation.d.ts.map

package/dist/utils/git-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-validation.d.ts","sourceRoot":"","sources":["../../src/utils/git-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wEAAwE;AACxE,eAAO,MAAM,eAAe,QAA6B,CAAC;AAE1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wDAAwD;AACxD,eAAO,MAAM,eAAe,QAA2D,CAAC;AAExF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD"}