@ash-technologia/fathom 0.1.0

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

@@ -0,0 +1,44 @@
+import type { PRDiffStats } from './types.js';
+export interface GitCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Execute a Git command safely via child_process.execFile.
+ * Arguments are passed as an array, never interpolated into shell strings.
+ */
+export declare function runGit(cwd: string, args: string[]): Promise<GitCommandResult>;
+/**
+ * Resolve the base Git reference to diff against.
+ * Handles explicit refs, auto-detection, shallow clones, and detached HEAD.
+ */
+export declare function resolveBaseRef(repoRoot: string, requestedRef?: string | boolean): Promise<string>;
+/**
+ * Determine the merge-base or comparison point between baseRef and current HEAD.
+ */
+export declare function getDiffTargetRef(repoRoot: string, baseRef: string): Promise<string>;
+/**
+ * Check if a 1-based line number falls into any of the changed line ranges.
+ */
+export declare function isLineInRanges(ranges: Array<{
+    start: number;
+    end: number;
+}>, line: number): boolean;
+/**
+ * Parse hunk line ranges from git diff -U0 output.
+ */
+export declare function parseDiffHunks(diffOutput: string): Map<string, Array<{
+    start: number;
+    end: number;
+}>>;
+/**
+ * Retrieve summary and file-by-file stats for the diff against baseRef.
+ */
+export declare function getDiffStats(repoRoot: string, baseRef: string): Promise<PRDiffStats>;
+/**
+ * Retrieve file contents at a given Git reference.
+ * Returns null if the file does not exist at that ref.
+ */
+export declare function getFileAtRef(repoRoot: string, ref: string, relativePath: string): Promise<string | null>;
+//# sourceMappingURL=git-diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.d.ts","sourceRoot":"","sources":["../../src/diff/git-diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAM7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmBnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwEjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAazF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7C,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,GACjB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAsCpD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAkG1F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}

package/dist/diff/git-diff.js

@@ -0,0 +1,256 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+import { FathomGitDiffError } from '../core/errors.js';
+import { isGitRepository, hasCommits, hasUncommittedChanges } from '../utils/git.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Execute a Git command safely via child_process.execFile.
+ * Arguments are passed as an array, never interpolated into shell strings.
+ */
+export async function runGit(cwd, args) {
+    try {
+        const { stdout, stderr } = await execFileAsync('git', args, {
+            cwd,
+            timeout: 15_000,
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        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 };
+    }
+}
+/**
+ * Resolve the base Git reference to diff against.
+ * Handles explicit refs, auto-detection, shallow clones, and detached HEAD.
+ */
+export async function resolveBaseRef(repoRoot, requestedRef) {
+    const isRepo = await isGitRepository(repoRoot);
+    if (!isRepo) {
+        throw new FathomGitDiffError(`Directory "${path.resolve(repoRoot)}" is not a valid Git repository root.`);
+    }
+    const commitsExist = await hasCommits(repoRoot);
+    if (!commitsExist) {
+        throw new FathomGitDiffError('Git repository has no commits to diff against.');
+    }
+    // If specific ref requested
+    if (typeof requestedRef === 'string' && requestedRef.trim() !== '') {
+        const ref = requestedRef.trim();
+        const verify = await runGit(repoRoot, ['rev-parse', '--verify', ref]);
+        if (verify.exitCode !== 0) {
+            const isShallow = await runGit(repoRoot, ['rev-parse', '--is-shallow-repository']);
+            if (isShallow.stdout === 'true') {
+                throw new FathomGitDiffError(`Base ref "${ref}" is not reachable in this shallow clone.\nFetch more history using "git fetch --depth=50 origin ${ref}" or "git fetch --unshallow".`);
+            }
+            throw new FathomGitDiffError(`Base ref "${ref}" could not be resolved. Please verify the branch, tag, or commit exists.`);
+        }
+        return ref;
+    }
+    // Auto-detect base ref
+    // 1. Try upstream tracking branch
+    const upstreamRes = await runGit(repoRoot, ['rev-parse', '--abbrev-ref', '@{u}']);
+    if (upstreamRes.exitCode === 0 && upstreamRes.stdout) {
+        const upstream = upstreamRes.stdout;
+        const verify = await runGit(repoRoot, ['rev-parse', '--verify', upstream]);
+        if (verify.exitCode === 0) {
+            return upstream;
+        }
+    }
+    // 2. Try common default branches
+    const candidates = ['origin/main', 'main', 'origin/master', 'master'];
+    for (const candidate of candidates) {
+        const verify = await runGit(repoRoot, ['rev-parse', '--verify', candidate]);
+        if (verify.exitCode === 0) {
+            return candidate;
+        }
+    }
+    // 3. If working directory has uncommitted changes, diff against HEAD
+    const uncommitted = await hasUncommittedChanges(repoRoot);
+    if (uncommitted) {
+        return 'HEAD';
+    }
+    // 4. Try HEAD~1 if history exists
+    const headPrev = await runGit(repoRoot, ['rev-parse', '--verify', 'HEAD~1']);
+    if (headPrev.exitCode === 0) {
+        return 'HEAD~1';
+    }
+    // 5. Fallback to HEAD
+    const head = await runGit(repoRoot, ['rev-parse', '--verify', 'HEAD']);
+    if (head.exitCode === 0) {
+        return 'HEAD';
+    }
+    throw new FathomGitDiffError('Could not auto-detect a base branch. Please specify a base ref (e.g. fathom --diff main).');
+}
+/**
+ * Determine the merge-base or comparison point between baseRef and current HEAD.
+ */
+export async function getDiffTargetRef(repoRoot, baseRef) {
+    // If baseRef is already HEAD or HEAD~1, use it directly
+    if (baseRef === 'HEAD' || baseRef.startsWith('HEAD~')) {
+        return baseRef;
+    }
+    // Try finding common ancestor via merge-base
+    const mb = await runGit(repoRoot, ['merge-base', baseRef, 'HEAD']);
+    if (mb.exitCode === 0 && mb.stdout) {
+        return mb.stdout;
+    }
+    return baseRef;
+}
+/**
+ * Check if a 1-based line number falls into any of the changed line ranges.
+ */
+export function isLineInRanges(ranges, line) {
+    return ranges.some((r) => line >= r.start && line <= r.end);
+}
+/**
+ * Parse hunk line ranges from git diff -U0 output.
+ */
+export function parseDiffHunks(diffOutput) {
+    const lineRangeMap = new Map();
+    let currentFile = null;
+    const lines = diffOutput.split('\n');
+    for (const line of lines) {
+        if (line.startsWith('diff --git ')) {
+            // Format: diff --git a/path b/path
+            const match = /^diff --git a\/.+ b\/(.+)$/.exec(line);
+            if (match?.[1]) {
+                currentFile = match[1].replace(/\\/g, '/');
+            }
+            else {
+                currentFile = null;
+            }
+            continue;
+        }
+        if (currentFile && line.startsWith('@@ ')) {
+            // Format: @@ -oldStart,oldLen +newStart,newLen @@
+            const match = /@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/.exec(line);
+            if (match?.[1]) {
+                const start = parseInt(match[1], 10);
+                const len = match[2] !== undefined ? parseInt(match[2], 10) : 1;
+                if (!isNaN(start)) {
+                    const ranges = lineRangeMap.get(currentFile) ?? [];
+                    if (len > 0) {
+                        ranges.push({ start, end: start + len - 1 });
+                    }
+                    else {
+                        // Line deleted at position `start`
+                        ranges.push({ start, end: start });
+                    }
+                    lineRangeMap.set(currentFile, ranges);
+                }
+            }
+        }
+    }
+    return lineRangeMap;
+}
+/**
+ * Retrieve summary and file-by-file stats for the diff against baseRef.
+ */
+export async function getDiffStats(repoRoot, baseRef) {
+    const diffTarget = await getDiffTargetRef(repoRoot, baseRef);
+    // 1. Get name-status
+    const nameStatusRes = await runGit(repoRoot, ['diff', '--name-status', diffTarget]);
+    if (nameStatusRes.exitCode !== 0) {
+        throw new FathomGitDiffError(`Failed to compute git diff against "${baseRef}": ${nameStatusRes.stderr}`);
+    }
+    // 2. Get numstat
+    const numstatRes = await runGit(repoRoot, ['diff', '--numstat', diffTarget]);
+    // 3. Get unified diff for line ranges
+    const u0Res = await runGit(repoRoot, ['diff', '-U0', diffTarget]);
+    const hunksMap = u0Res.exitCode === 0
+        ? parseDiffHunks(u0Res.stdout)
+        : new Map();
+    // Map numstats by file path
+    const numstatMap = new Map();
+    if (numstatRes.exitCode === 0 && numstatRes.stdout) {
+        for (const line of numstatRes.stdout.split('\n')) {
+            const parts = line.split('\t');
+            if (parts.length >= 3) {
+                const added = parts[0] === '-' ? 0 : parseInt(parts[0] ?? '0', 10) || 0;
+                const removed = parts[1] === '-' ? 0 : parseInt(parts[1] ?? '0', 10) || 0;
+                let filePath = (parts[2] ?? '').trim();
+                // Handle renamed paths in numstat: {old => new} or old => new
+                if (filePath.includes(' => ')) {
+                    const renameMatch = /\{?.* => (.*?)\}?$/.exec(filePath);
+                    if (renameMatch?.[1]) {
+                        filePath = renameMatch[1].replace(/\\/g, '/');
+                    }
+                }
+                numstatMap.set(filePath.replace(/\\/g, '/'), { added, removed });
+            }
+        }
+    }
+    const files = [];
+    let totalAdded = 0;
+    let totalRemoved = 0;
+    if (nameStatusRes.stdout) {
+        for (const line of nameStatusRes.stdout.split('\n')) {
+            const parts = line.split('\t');
+            if (parts.length < 2)
+                continue;
+            const statusCode = (parts[0] ?? '').trim();
+            let filePath = (parts[1] ?? '').trim().replace(/\\/g, '/');
+            let basePath = undefined;
+            let status = 'modified';
+            if (statusCode.startsWith('A')) {
+                status = 'added';
+            }
+            else if (statusCode.startsWith('D')) {
+                status = 'deleted';
+            }
+            else if (statusCode.startsWith('R')) {
+                status = 'renamed';
+                basePath = filePath;
+                filePath = (parts[2] ?? '').trim().replace(/\\/g, '/');
+            }
+            else if (statusCode.startsWith('M')) {
+                status = 'modified';
+            }
+            const num = numstatMap.get(filePath) ?? { added: 0, removed: 0 };
+            totalAdded += num.added;
+            totalRemoved += num.removed;
+            const changedLineRanges = hunksMap.get(filePath) ?? [];
+            const changedFile = {
+                path: filePath,
+                status,
+                linesAdded: num.added,
+                linesRemoved: num.removed,
+                changedLineRanges,
+            };
+            if (basePath) {
+                changedFile.basePath = basePath;
+            }
+            files.push(changedFile);
+        }
+    }
+    return {
+        baseRef,
+        targetRef: diffTarget,
+        filesChanged: files.length,
+        linesAdded: totalAdded,
+        linesRemoved: totalRemoved,
+        files,
+    };
+}
+/**
+ * Retrieve file contents at a given Git reference.
+ * Returns null if the file does not exist at that ref.
+ */
+export async function getFileAtRef(repoRoot, ref, relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/');
+    const result = await runGit(repoRoot, ['show', `${ref}:${normalized}`]);
+    if (result.exitCode === 0) {
+        return result.stdout;
+    }
+    return null;
+}
+//# sourceMappingURL=git-diff.js.map

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

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

package/dist/diff/types.d.ts

@@ -0,0 +1,75 @@
+import type { Category } from '../rules/categories.js';
+import type { Finding } from '../core/findings.js';
+/**
+ * Information about an individual changed file in the Git diff.
+ */
+export interface PRChangedFile {
+    /** Repository-relative path */
+    path: string;
+    /** Status of the file in the diff */
+    status: 'added' | 'modified' | 'deleted' | 'renamed';
+    /** Lines added */
+    linesAdded: number;
+    /** Lines removed */
+    linesRemoved: number;
+    /** Line ranges added or modified in the target version (1-indexed) */
+    changedLineRanges: Array<{
+        start: number;
+        end: number;
+    }>;
+    /** Previous path if renamed */
+    basePath?: string;
+}
+/**
+ * Summary statistics of the Git diff.
+ */
+export interface PRDiffStats {
+    /** The base Git reference compared against */
+    baseRef: string;
+    /** The target Git reference (usually HEAD or working directory) */
+    targetRef: string;
+    /** Total number of changed files */
+    filesChanged: number;
+    /** Total number of lines added */
+    linesAdded: number;
+    /** Total number of lines removed */
+    linesRemoved: number;
+    /** List of changed files */
+    files: PRChangedFile[];
+}
+/**
+ * Impact of the diff on a specific category's score.
+ */
+export interface PRCategoryImpact {
+    category: Category;
+    baseScore: number;
+    currentScore: number;
+    delta: number;
+}
+/**
+ * Complete result of the PR / Git diff analysis.
+ */
+export interface PRAnalysisResult {
+    /** Diff summary statistics */
+    stats: PRDiffStats;
+    /** Overall health score at the base ref */
+    baseScore: number;
+    /** Overall health score in current repository state */
+    currentScore: number;
+    /** Overall score change (currentScore - baseScore) */
+    scoreDelta: number;
+    /** Findings newly introduced by the diff */
+    newFindings: Finding[];
+    /** Existing findings in files/lines touched by the diff */
+    touchedFindings: Finding[];
+    /** Findings resolved by the diff */
+    resolvedFindings: Finding[];
+    /** Category-by-category score impact */
+    categoryImpact: PRCategoryImpact[];
+    /** Verdict */
+    verdict: {
+        passed: boolean;
+        summary: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/diff/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACrD,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,iBAAiB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,2DAA2D;IAC3D,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,wCAAwC;IACxC,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,cAAc;IACd,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/diff/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diff/types.js.map

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

package/dist/integrations/github/context.d.ts

@@ -0,0 +1,22 @@
+import type { GitHubContext, CommentResult } from './types.js';
+/**
+ * Safely detect GitHub Actions environment variables and event payload.
+ * Never throws — returns safe defaults if not in GitHub Actions.
+ */
+export declare function detectGitHubContext(): Promise<GitHubContext>;
+/**
+ * Append a Markdown summary to GitHub Actions step summary file.
+ * Returns true if written, false if no summary path was found.
+ */
+export declare function publishStepSummary(markdown: string, customPath?: string): Promise<boolean>;
+/**
+ * Post a comment to a GitHub pull request using the GitHub REST API.
+ * Never leaks credentials in error logs or stdout.
+ */
+export declare function publishPRComment(options: {
+    repository: string;
+    prNumber: number;
+    token: string;
+    body: string;
+}): Promise<CommentResult>;
+//# sourceMappingURL=context.d.ts.map

package/dist/integrations/github/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/integrations/github/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CA4ClE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAehG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,aAAa,CAAC,CAiDzB"}

package/dist/integrations/github/context.js

@@ -0,0 +1,115 @@
+import fs from 'node:fs/promises';
+/**
+ * Safely detect GitHub Actions environment variables and event payload.
+ * Never throws — returns safe defaults if not in GitHub Actions.
+ */
+export async function detectGitHubContext() {
+    const isGitHubActions = process.env['GITHUB_ACTIONS'] === 'true';
+    const eventName = process.env['GITHUB_EVENT_NAME'];
+    const repository = process.env['GITHUB_REPOSITORY'];
+    const baseRef = process.env['GITHUB_BASE_REF'];
+    const headRef = process.env['GITHUB_HEAD_REF'];
+    const stepSummaryPath = process.env['GITHUB_STEP_SUMMARY'];
+    const token = process.env['GITHUB_TOKEN'];
+    let prNumber = undefined;
+    // Try extracting PR number from event payload if available
+    const eventPath = process.env['GITHUB_EVENT_PATH'];
+    if (eventPath) {
+        try {
+            const eventRaw = await fs.readFile(eventPath, 'utf8');
+            const eventData = JSON.parse(eventRaw);
+            if (typeof eventData?.pull_request?.number === 'number') {
+                prNumber = eventData.pull_request.number;
+            }
+            else if (typeof eventData?.number === 'number') {
+                prNumber = eventData.number;
+            }
+            else if (typeof eventData?.issue?.number === 'number') {
+                prNumber = eventData.issue.number;
+            }
+        }
+        catch {
+            // Ignore unreadable or invalid event file
+            prNumber = undefined;
+        }
+    }
+    return {
+        isGitHubActions,
+        eventName,
+        repository,
+        prNumber,
+        baseRef,
+        headRef,
+        stepSummaryPath,
+        token,
+    };
+}
+/**
+ * Append a Markdown summary to GitHub Actions step summary file.
+ * Returns true if written, false if no summary path was found.
+ */
+export async function publishStepSummary(markdown, customPath) {
+    const targetPath = customPath ?? process.env['GITHUB_STEP_SUMMARY'];
+    if (!targetPath) {
+        return false;
+    }
+    try {
+        await fs.appendFile(targetPath, `${markdown}\n\n`, 'utf8');
+        return true;
+    }
+    catch (err) {
+        process.stderr.write(`[Fathom] Warning: Failed to write to GitHub step summary (${targetPath}): ${String(err)}\n`);
+        return false;
+    }
+}
+/**
+ * Post a comment to a GitHub pull request using the GitHub REST API.
+ * Never leaks credentials in error logs or stdout.
+ */
+export async function publishPRComment(options) {
+    const { repository, prNumber, token, body } = options;
+    if (!repository || !prNumber || !token) {
+        return {
+            success: false,
+            error: 'Missing repository, pull request number, or GitHub token.',
+        };
+    }
+    const url = `https://api.github.com/repos/${repository}/issues/${prNumber}/comments`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Accept: 'application/vnd.github+json',
+                Authorization: `Bearer ${token}`,
+                'X-GitHub-Api-Version': '2022-11-28',
+                'User-Agent': 'Fathom-PR-Intelligence/0.1.0',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ body }),
+        });
+        if (!response.ok) {
+            const statusText = response.statusText;
+            return {
+                success: false,
+                error: `GitHub API error (HTTP ${response.status}: ${statusText})`,
+            };
+        }
+        const data = (await response.json());
+        return {
+            success: true,
+            commentId: data?.id,
+        };
+    }
+    catch (err) {
+        // Sanitize any error message to ensure token is never printed
+        let safeMessage = String(err);
+        if (token && safeMessage.includes(token)) {
+            safeMessage = safeMessage.replaceAll(token, '***TOKEN***');
+        }
+        return {
+            success: false,
+            error: `Network error posting PR comment: ${safeMessage}`,
+        };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/integrations/github/context.js.map

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

package/dist/integrations/github/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Metadata and runtime state extracted from GitHub Actions environment.
+ */
+export interface GitHubContext {
+    /** True if running inside a GitHub Actions workflow */
+    isGitHubActions: boolean;
+    /** Name of the webhook event that triggered the workflow (e.g. 'pull_request', 'push') */
+    eventName?: string | undefined;
+    /** GitHub repository in 'owner/repo' format */
+    repository?: string | undefined;
+    /** Pull request number if triggered by a pull_request event */
+    prNumber?: number | undefined;
+    /** Base branch or ref name for pull request (e.g. 'main') */
+    baseRef?: string | undefined;
+    /** Head branch or ref name for pull request */
+    headRef?: string | undefined;
+    /** Absolute path to the file specified in $GITHUB_STEP_SUMMARY */
+    stepSummaryPath?: string | undefined;
+    /** Authentication token from $GITHUB_TOKEN if provided */
+    token?: string | undefined;
+}
+/**
+ * Result of posting a comment to a GitHub PR.
+ */
+export interface CommentResult {
+    success: boolean;
+    commentId?: number | undefined;
+    error?: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/github/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/github/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B"}

package/dist/integrations/github/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integrations/github/types.js.map

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

package/dist/plugins/context.d.ts

@@ -0,0 +1,13 @@
+import type { RepositoryContext } from '../core/context.js';
+import type { PluginContext, PluginRule } from './types.js';
+/**
+ * Creates an isolated, sandboxed PluginContext.
+ *
+ * Enforces:
+ * - Read-only access to repository metadata
+ * - Traversal-safe file reading (cannot read outside repository root)
+ * - Size-bounded reads to avoid out-of-memory errors
+ * - Rule validation on finding creation
+ */
+export declare function createPluginContext(repoContext: RepositoryContext, rules: readonly PluginRule[]): PluginContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/plugins/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/plugins/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI5D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,iBAAiB,EAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,aAAa,CAgHf"}