@ash-technologia/fathom 0.1.0

package/dist/utils/git.js

@@ -0,0 +1,125 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+const execFileAsync = promisify(execFile);
+/**
+ * Execute a Git command safely in the given directory.
+ * Never throws — returns exit code and output.
+ *
+ * Security: Only pre-approved git subcommands are executed.
+ * Arguments are passed as an array, never interpolated into a shell string.
+ */
+async function runGit(cwd, args) {
+    try {
+        const { stdout, stderr } = await execFileAsync('git', args, {
+            cwd,
+            timeout: 10_000,
+            maxBuffer: 1024 * 1024, // 1MB
+        });
+        return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
+    }
+    catch (err) {
+        if (err && typeof err === 'object' && 'stdout' in err && 'stderr' in err && 'code' in err) {
+            const e = err;
+            return {
+                stdout: (e.stdout ?? '').trim(),
+                stderr: (e.stderr ?? '').trim(),
+                exitCode: e.code ?? 1,
+            };
+        }
+        return { stdout: '', stderr: String(err), exitCode: 1 };
+    }
+}
+/**
+ * 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 async function isGitRepository(root) {
+    const result = await runGit(root, ['rev-parse', '--absolute-git-dir']);
+    if (result.exitCode !== 0)
+        return false;
+    // Normalise both paths with trailing sep so prefix matching is unambiguous
+    const normalizedRoot = path.resolve(root) + path.sep;
+    const gitDir = path.resolve(result.stdout) + path.sep;
+    return gitDir.startsWith(normalizedRoot);
+}
+/**
+ * Check whether the repository has any commits.
+ */
+export async function hasCommits(root) {
+    const result = await runGit(root, ['log', '--oneline', '-1']);
+    return result.exitCode === 0 && result.stdout.length > 0;
+}
+/**
+ * Get the list of files tracked by Git.
+ * Returns an empty array if not a Git repository.
+ */
+export async function getTrackedFiles(root) {
+    const result = await runGit(root, ['ls-files']);
+    if (result.exitCode !== 0)
+        return [];
+    return result.stdout.split('\n').filter(Boolean);
+}
+/**
+ * Check whether the working directory has uncommitted changes.
+ */
+export async function hasUncommittedChanges(root) {
+    const result = await runGit(root, ['status', '--porcelain']);
+    return result.exitCode === 0 && result.stdout.length > 0;
+}
+/**
+ * Get the list of large tracked files above a size threshold (bytes).
+ * Uses git cat-file to check sizes of tracked blobs.
+ */
+export async function getLargeTrackedFiles(root, thresholdBytes) {
+    // git ls-files with size information
+    const result = await runGit(root, ['ls-files', '-s']);
+    if (result.exitCode !== 0)
+        return [];
+    const largeFiles = [];
+    for (const line of result.stdout.split('\n')) {
+        // Format: mode SP hash SP stage TAB filename
+        const match = /^\S+\s+(\S+)\s+\S+\t(.+)$/.exec(line);
+        if (!match)
+            continue;
+        const [, hash, filePath] = match;
+        if (!hash || !filePath)
+            continue;
+        // Get blob size
+        const sizeResult = await runGit(root, ['cat-file', '-s', hash]);
+        if (sizeResult.exitCode !== 0)
+            continue;
+        const size = parseInt(sizeResult.stdout, 10);
+        if (!isNaN(size) && size >= thresholdBytes) {
+            largeFiles.push({ file: path.normalize(filePath), sizeBytes: size });
+        }
+    }
+    return largeFiles;
+}
+/**
+ * Read the raw content of .gitignore. Returns null if not found.
+ */
+export async function readGitignoreContent(root) {
+    const { readFileSafe } = await import('./filesystem.js');
+    return readFileSafe(path.join(root, '.gitignore'));
+}
+/**
+ * Check whether a given path pattern is mentioned in .gitignore content.
+ * This is a simplified heuristic — not a full gitignore pattern parser.
+ */
+export function isPathMentionedInGitignore(gitignoreContent, targetPattern) {
+    const lines = gitignoreContent
+        .split('\n')
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith('#'));
+    return lines.some((line) => {
+        // Normalize both for comparison
+        const normalized = line.replace(/^\//, '').replace(/\/$/, '');
+        const target = targetPattern.replace(/^\//, '').replace(/\/$/, '');
+        return normalized === target || line === `/${target}` || line === target + '/';
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal structured logger.
+ *
+ * - Respects NO_COLOR env variable.
+ * - When --json mode is active, all log output goes to stderr.
+ * - Debug logs only appear when FATHOM_DEBUG=1.
+ */
+export declare const logger: {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,MAAM;mBACF,MAAM,GAAG,IAAI;kBAId,MAAM,GAAG,IAAI;kBAGb,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,25 @@
+/**
+ * Minimal structured logger.
+ *
+ * - Respects NO_COLOR env variable.
+ * - When --json mode is active, all log output goes to stderr.
+ * - Debug logs only appear when FATHOM_DEBUG=1.
+ */
+const isDebug = process.env['FATHOM_DEBUG'] === '1';
+export const logger = {
+    debug(message) {
+        if (!isDebug)
+            return;
+        process.stderr.write(`[debug] ${message}\n`);
+    },
+    info(message) {
+        process.stderr.write(`[info] ${message}\n`);
+    },
+    warn(message) {
+        process.stderr.write(`[warn] ${message}\n`);
+    },
+    error(message) {
+        process.stderr.write(`[error] ${message}\n`);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC;AAEpD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Convert an absolute path to a repository-relative path.
+ */
+export declare function toRelativePath(root: string, absolutePath: string): string;
+/**
+ * Normalize a path to use forward slashes regardless of platform.
+ * Used for consistent output across operating systems.
+ */
+export declare function normalizeSlashes(p: string): string;
+/**
+ * Get the extension of a file path (lowercase, with dot).
+ */
+export declare function getExtension(filePath: string): string;
+/**
+ * Get the filename without the directory.
+ */
+export declare function getBasename(filePath: string): string;
+/**
+ * Get the filename without the directory and extension.
+ */
+export declare function getBasenameStem(filePath: string): string;
+/**
+ * Compute the directory depth of a relative path.
+ */
+export declare function computeDepth(relativePath: string): number;
+/**
+ * Check whether a path (relative or absolute) contains a given directory component.
+ */
+export declare function pathContainsDirectory(filePath: string, dirName: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGhF"}

package/dist/utils/paths.js

@@ -0,0 +1,48 @@
+import path from 'node:path';
+/**
+ * Convert an absolute path to a repository-relative path.
+ */
+export function toRelativePath(root, absolutePath) {
+    return normalizeSlashes(path.relative(root, absolutePath));
+}
+/**
+ * Normalize a path to use forward slashes regardless of platform.
+ * Used for consistent output across operating systems.
+ */
+export function normalizeSlashes(p) {
+    return p.replace(/\\/g, '/');
+}
+/**
+ * Get the extension of a file path (lowercase, with dot).
+ */
+export function getExtension(filePath) {
+    return path.extname(filePath).toLowerCase();
+}
+/**
+ * Get the filename without the directory.
+ */
+export function getBasename(filePath) {
+    return path.basename(filePath);
+}
+/**
+ * Get the filename without the directory and extension.
+ */
+export function getBasenameStem(filePath) {
+    const base = path.basename(filePath);
+    const ext = path.extname(base);
+    return base.slice(0, base.length - ext.length);
+}
+/**
+ * Compute the directory depth of a relative path.
+ */
+export function computeDepth(relativePath) {
+    return normalizeSlashes(relativePath).split('/').length - 1;
+}
+/**
+ * Check whether a path (relative or absolute) contains a given directory component.
+ */
+export function pathContainsDirectory(filePath, dirName) {
+    const parts = normalizeSlashes(filePath).split('/');
+    return parts.includes(dirName);
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,YAAoB;IAC/D,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,gBAAgB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAe;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/utils/timing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Timing utilities for measuring analysis duration.
+ */
+/**
+ * Create a timer that returns elapsed milliseconds when called.
+ */
+export declare function createTimer(): () => number;
+/**
+ * Format milliseconds as a human-readable string.
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=timing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/utils/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,MAAM,CAG1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/utils/timing.js

@@ -0,0 +1,19 @@
+/**
+ * Timing utilities for measuring analysis duration.
+ */
+/**
+ * Create a timer that returns elapsed milliseconds when called.
+ */
+export function createTimer() {
+    const start = Date.now();
+    return () => Date.now() - start;
+}
+/**
+ * Format milliseconds as a human-readable string.
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+//# sourceMappingURL=timing.js.map

package/dist/utils/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/utils/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@ash-technologia/fathom",
+  "version": "0.1.0",
+  "description": "Local-first repository intelligence CLI. Know what's beneath the surface.",
+  "keywords": [
+    "repository",
+    "analysis",
+    "security",
+    "developer-tool",
+    "cli",
+    "code-quality",
+    "git",
+    "health-score"
+  ],
+  "homepage": "https://github.com/Ash-Technologia/Fathom#readme",
+  "bugs": {
+    "url": "https://github.com/Ash-Technologia/Fathom/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ash-Technologia/Fathom.git"
+  },
+  "license": "MIT",
+  "author": "Fathom Contributors",
+  "type": "module",
+  "main": "./dist/cli/index.js",
+  "bin": {
+    "fathom": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "build:watch": "tsc --project tsconfig.json --watch",
+    "clean": "node scripts/clean.js",
+    "dev": "npm run build && node dist/cli/index.js",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "lint:fix": "eslint --fix \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fast-glob": "^3.3.2",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.11.1",
+    "@types/node": "^22.7.4",
+    "@vitest/coverage-v8": "^2.1.1",
+    "eslint": "^9.11.1",
+    "prettier": "^3.3.3",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.7.0",
+    "vitest": "^2.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}