@ash-technologia/fathom 0.1.0

package/dist/scoring/score.js

@@ -0,0 +1,81 @@
+import { CATEGORIES } from '../rules/categories.js';
+import { CATEGORY_WEIGHTS, SEVERITY_PENALTIES } from './weights.js';
+/**
+ * Calculate a category score from its findings.
+ *
+ * - Starts at 100
+ * - Each finding deducts penalty points based on severity
+ * - Score is clamped to [0, 100]
+ * - The category weight is stored for weighted average calculation
+ *
+ * The scoring is deterministic: same findings → same score.
+ */
+export function calculateCategoryScore(category, findings) {
+    const categoryFindings = findings.filter((f) => f.category === category);
+    let score = 100;
+    for (const finding of categoryFindings) {
+        const basePenalty = SEVERITY_PENALTIES[finding.severity] ?? 0;
+        // Weight penalty by confidence so heuristic findings (confidence < 1) have
+        // proportionally less impact than fully deterministic findings (confidence ~1).
+        const penalty = basePenalty * finding.confidence;
+        score -= penalty;
+    }
+    score = Math.max(0, Math.min(100, score));
+    return {
+        category,
+        score: Math.round(score),
+        maxScore: 100,
+        weight: CATEGORY_WEIGHTS[category] ?? 0,
+        findingCount: categoryFindings.length,
+    };
+}
+/**
+ * Classify a score into a health band.
+ */
+export function classifyScore(score) {
+    if (score >= 90)
+        return 'excellent';
+    if (score >= 75)
+        return 'healthy';
+    if (score >= 60)
+        return 'fair';
+    if (score >= 40)
+        return 'needs-attention';
+    return 'critical';
+}
+/**
+ * Calculate the full health score from all findings and analyzer results.
+ */
+export function calculateHealthScore(findings, _analyzerResults) {
+    const categoryScores = CATEGORIES.map((cat) => calculateCategoryScore(cat, findings));
+    // Weighted average (only include categories with non-zero weight)
+    let weightedSum = 0;
+    let totalWeight = 0;
+    for (const cs of categoryScores) {
+        if (cs.weight > 0) {
+            weightedSum += cs.score * cs.weight;
+            totalWeight += cs.weight;
+        }
+    }
+    const overall = totalWeight > 0 ? Math.round(weightedSum / totalWeight) : 100;
+    const clampedOverall = Math.max(0, Math.min(100, overall));
+    return {
+        overall: clampedOverall,
+        band: classifyScore(clampedOverall),
+        categories: categoryScores,
+    };
+}
+/**
+ * Get the human-readable label for a health band.
+ */
+export function bandLabel(band) {
+    const labels = {
+        critical: 'Critical',
+        'needs-attention': 'Needs Attention',
+        fair: 'Fair',
+        healthy: 'Healthy',
+        excellent: 'Excellent',
+    };
+    return labels[band];
+}
+//# sourceMappingURL=score.js.map

package/dist/scoring/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/scoring/score.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB,EAAE,QAAmB;IAC5E,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzE,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9D,2EAA2E;QAC3E,gFAAgF;QAChF,MAAM,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QACjD,KAAK,IAAI,OAAO,CAAC;IACnB,CAAC;IAED,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1C,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACxB,QAAQ,EAAE,GAAG;QACb,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvC,YAAY,EAAE,gBAAgB,CAAC,MAAM;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,iBAAiB,CAAC;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAmB,EACnB,gBAAkC;IAElC,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEtF,kEAAkE;IAClE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,WAAW,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC;YACpC,WAAW,IAAI,EAAE,CAAC,MAAM,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9E,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3D,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,aAAa,CAAC,cAAc,CAAC;QACnC,UAAU,EAAE,cAAc;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAyB;IACjD,MAAM,MAAM,GAAwC;QAClD,QAAQ,EAAE,UAAU;QACpB,iBAAiB,EAAE,iBAAiB;QACpC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,WAAW;KACvB,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/scoring/weights.d.ts

@@ -0,0 +1,11 @@
+import type { Category } from '../rules/categories.js';
+/**
+ * Scoring weights for each category.
+ * Must sum to 1.0 (100%).
+ */
+export declare const CATEGORY_WEIGHTS: Record<Category, number>;
+/**
+ * Penalty points deducted from a category score per finding severity.
+ */
+export declare const SEVERITY_PENALTIES: Record<string, number>;
+//# sourceMappingURL=weights.d.ts.map

package/dist/scoring/weights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weights.d.ts","sourceRoot":"","sources":["../../src/scoring/weights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAUrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAC"}

package/dist/scoring/weights.js

@@ -0,0 +1,26 @@
+/**
+ * Scoring weights for each category.
+ * Must sum to 1.0 (100%).
+ */
+export const CATEGORY_WEIGHTS = {
+    security: 0.2,
+    git: 0.15,
+    project: 0.15,
+    dependencies: 0.1,
+    testing: 0.15,
+    documentation: 0.1,
+    quality: 0.1,
+    cicd: 0.05,
+    architecture: 0.0, // Architecture is observational in v0.1; doesn't affect score
+};
+/**
+ * Penalty points deducted from a category score per finding severity.
+ */
+export const SEVERITY_PENALTIES = {
+    critical: 30,
+    high: 15,
+    medium: 8,
+    low: 3,
+    info: 0,
+};
+//# sourceMappingURL=weights.js.map

package/dist/scoring/weights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weights.js","sourceRoot":"","sources":["../../src/scoring/weights.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,QAAQ,EAAE,GAAG;IACb,GAAG,EAAE,IAAI;IACT,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,GAAG;IACjB,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,GAAG;IAClB,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,GAAG,EAAE,8DAA8D;CAClF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;CACR,CAAC"}

package/dist/utils/filesystem.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Extensions considered as source code files.
+ */
+export declare const SOURCE_EXTENSIONS: Set<string>;
+/**
+ * Extensions considered as config files.
+ */
+export declare const CONFIG_EXTENSIONS: Set<string>;
+/**
+ * Binary file extensions to skip during text analysis.
+ */
+export declare const BINARY_EXTENSIONS: Set<string>;
+/**
+ * Directories to always ignore during scanning.
+ */
+export declare const IGNORED_DIRECTORIES: string[];
+/**
+ * Glob patterns for ignored directories used with fast-glob.
+ */
+export declare const IGNORE_GLOB_PATTERNS: string[];
+/**
+ * Check whether a file path is binary based on its extension.
+ */
+export declare function isBinaryExtension(filePath: string): boolean;
+/**
+ * Check whether a file path is a source file.
+ */
+export declare function isSourceExtension(filePath: string): boolean;
+/**
+ * Check whether a file path is a config file.
+ */
+export declare function isConfigExtension(filePath: string): boolean;
+/**
+ * Safely check if a path exists (file or directory).
+ */
+export declare function pathExists(p: string): Promise<boolean>;
+/**
+ * Safely read a file as text. Returns null on any error.
+ * Skips binary files.
+ * Enforces a max size limit to prevent memory issues.
+ */
+export declare function readFileSafe(filePath: string, maxBytes?: number): Promise<string | null>;
+/**
+ * Safely read a file as JSON. Returns null on any error.
+ */
+export declare function readJsonSafe<T>(filePath: string): Promise<T | null>;
+/**
+ * Get file size in bytes. Returns 0 on error.
+ */
+export declare function getFileSize(filePath: string): Promise<number>;
+/**
+ * Count the number of lines in a file without loading the whole thing.
+ * Uses a stream for large files. Returns 0 on error.
+ */
+export declare function countLines(filePath: string): Promise<number>;
+/**
+ * Resolve and normalize a path relative to a root, protecting against traversal.
+ * Returns null if the resolved path escapes the root.
+ */
+export declare function resolveRepositoryPath(root: string, relativePath: string): string | null;
+/**
+ * Compute the depth of a relative path (number of directory separators).
+ */
+export declare function pathDepth(relativePath: string): number;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/utils/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,iBAAiB,aA8B5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAa5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAgE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,UA4B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAqBhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAc,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAQzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/utils/filesystem.js

@@ -0,0 +1,299 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { createReadStream } from 'node:fs';
+/**
+ * Extensions considered as source code files.
+ */
+export const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.py',
+    '.pyw',
+    '.go',
+    '.rs',
+    '.java',
+    '.kt',
+    '.groovy',
+    '.rb',
+    '.php',
+    '.cs',
+    '.c',
+    '.cpp',
+    '.cc',
+    '.h',
+    '.hpp',
+    '.swift',
+    '.dart',
+    '.scala',
+    '.r',
+    '.R',
+    '.sh',
+    '.bash',
+    '.zsh',
+]);
+/**
+ * Extensions considered as config files.
+ */
+export const CONFIG_EXTENSIONS = new Set([
+    '.json',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.ini',
+    '.cfg',
+    '.env',
+    '.env.local',
+    '.env.example',
+    '.env.sample',
+    '.xml',
+    '.properties',
+]);
+/**
+ * Binary file extensions to skip during text analysis.
+ */
+export const BINARY_EXTENSIONS = new Set([
+    // Images
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.bmp',
+    '.ico',
+    '.webp',
+    '.svg',
+    '.avif',
+    // Video
+    '.mp4',
+    '.mov',
+    '.avi',
+    '.mkv',
+    '.webm',
+    // Audio
+    '.mp3',
+    '.wav',
+    '.flac',
+    '.ogg',
+    // Archives
+    '.zip',
+    '.tar',
+    '.gz',
+    '.bz2',
+    '.xz',
+    '.7z',
+    '.rar',
+    // Executables / compiled
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+    '.bin',
+    '.wasm',
+    // Fonts
+    '.ttf',
+    '.otf',
+    '.woff',
+    '.woff2',
+    '.eot',
+    // Documents
+    '.pdf',
+    '.doc',
+    '.docx',
+    '.xls',
+    '.xlsx',
+    '.ppt',
+    '.pptx',
+    // Keys and certs (handle separately in security)
+    '.pem',
+    '.crt',
+    '.cer',
+    '.p12',
+    '.pfx',
+    // Other
+    '.lock', // lockfiles are text but not analyzed as source
+    '.map',
+    '.min.js',
+    '.pyc',
+    '.class',
+    '.jar',
+]);
+/**
+ * Directories to always ignore during scanning.
+ */
+export const IGNORED_DIRECTORIES = [
+    '.git',
+    '.fathom',
+    'node_modules',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.nuxt',
+    'target',
+    'vendor',
+    '.cache',
+    '__pycache__',
+    '.mypy_cache',
+    '.pytest_cache',
+    '.tox',
+    'venv',
+    '.venv',
+    'env',
+    '.env',
+    '.eggs',
+    '*.egg-info',
+    '.gradle',
+    '.mvn',
+    'out',
+    '.idea',
+    '.vscode',
+    '.DS_Store',
+];
+/**
+ * Glob patterns for ignored directories used with fast-glob.
+ */
+export const IGNORE_GLOB_PATTERNS = [
+    '**/.git/**',
+    '**/.fathom/**',
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/.next/**',
+    '**/.nuxt/**',
+    '**/target/**',
+    '**/vendor/**',
+    '**/.cache/**',
+    '**/__pycache__/**',
+    '**/.mypy_cache/**',
+    '**/.pytest_cache/**',
+    '**/.tox/**',
+    '**/venv/**',
+    '**/.venv/**',
+    '**/.eggs/**',
+    '**/.gradle/**',
+    '**/out/**',
+];
+/**
+ * Check whether a file path is binary based on its extension.
+ */
+export function isBinaryExtension(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+/**
+ * Check whether a file path is a source file.
+ */
+export function isSourceExtension(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return SOURCE_EXTENSIONS.has(ext);
+}
+/**
+ * Check whether a file path is a config file.
+ */
+export function isConfigExtension(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return CONFIG_EXTENSIONS.has(ext);
+}
+/**
+ * Safely check if a path exists (file or directory).
+ */
+export async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safely read a file as text. Returns null on any error.
+ * Skips binary files.
+ * Enforces a max size limit to prevent memory issues.
+ */
+export async function readFileSafe(filePath, maxBytes = 1024 * 1024) {
+    try {
+        if (isBinaryExtension(filePath))
+            return null;
+        const stat = await fs.stat(filePath);
+        if (!stat.isFile())
+            return null;
+        if (stat.size > maxBytes)
+            return null;
+        return await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely read a file as JSON. Returns null on any error.
+ */
+export async function readJsonSafe(filePath) {
+    const content = await readFileSafe(filePath, 512 * 1024);
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get file size in bytes. Returns 0 on error.
+ */
+export async function getFileSize(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Count the number of lines in a file without loading the whole thing.
+ * Uses a stream for large files. Returns 0 on error.
+ */
+export async function countLines(filePath) {
+    return new Promise((resolve) => {
+        let count = 0;
+        try {
+            const stream = createReadStream(filePath, { encoding: 'utf8' });
+            stream.on('data', (chunk) => {
+                const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+                for (const c of text) {
+                    if (c === '\n')
+                        count++;
+                }
+            });
+            stream.on('end', () => resolve(count + 1));
+            stream.on('error', () => resolve(0));
+        }
+        catch {
+            resolve(0);
+        }
+    });
+}
+/**
+ * Resolve and normalize a path relative to a root, protecting against traversal.
+ * Returns null if the resolved path escapes the root.
+ */
+export function resolveRepositoryPath(root, relativePath) {
+    const resolved = path.resolve(root, relativePath);
+    if (!resolved.startsWith(path.resolve(root)))
+        return null;
+    return resolved;
+}
+/**
+ * Compute the depth of a relative path (number of directory separators).
+ */
+export function pathDepth(relativePath) {
+    return relativePath.split(path.sep).length - 1;
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/utils/filesystem.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Result of a Git command execution.
+ */
+export interface GitCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Check whether the directory is a Git repository.
+ *
+ * We use `--absolute-git-dir` and verify the returned path is within
+ * `root` so that subdirectories nested inside a parent repo are not
+ * mistakenly reported as repos (e.g. test fixtures living inside Fathom).
+ */
+export declare function isGitRepository(root: string): Promise<boolean>;
+/**
+ * Check whether the repository has any commits.
+ */
+export declare function hasCommits(root: string): Promise<boolean>;
+/**
+ * Get the list of files tracked by Git.
+ * Returns an empty array if not a Git repository.
+ */
+export declare function getTrackedFiles(root: string): Promise<string[]>;
+/**
+ * Check whether the working directory has uncommitted changes.
+ */
+export declare function hasUncommittedChanges(root: string): Promise<boolean>;
+/**
+ * Get the list of large tracked files above a size threshold (bytes).
+ * Uses git cat-file to check sizes of tracked blobs.
+ */
+export declare function getLargeTrackedFiles(root: string, thresholdBytes: number): Promise<{
+    file: string;
+    sizeBytes: number;
+}[]>;
+/**
+ * Read the raw content of .gitignore. Returns null if not found.
+ */
+export declare function readGitignoreContent(root: string): Promise<string | null>;
+/**
+ * Check whether a given path pattern is mentioned in .gitignore content.
+ * This is a simplified heuristic — not a full gitignore pattern parser.
+ */
+export declare function isPathMentionedInGitignore(gitignoreContent: string, targetPattern: string): boolean;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8BD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIrE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA0BhD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG/E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAYT"}