threadlines 0.2.4 → 0.2.6

package/dist/git/context.js

@@ -1,55 +0,0 @@
-"use strict";
-/**
- * Unified Git Context Collection
- *
- * Collects all git-related information (diff, repo name, branch name) in a unified way.
- * Each environment has isolated implementations - changes to one don't affect others.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGitContextForEnvironment = getGitContextForEnvironment;
-const git_diff_executor_1 = require("../utils/git-diff-executor");
-const repo_1 = require("./repo");
-const repo_2 = require("./repo");
-/**
- * Collects all git context (diff, repo name, branch name) for the given environment.
- *
- * Each environment has a single, specific implementation:
- * - GitHub: Uses GITHUB_REPOSITORY, GITHUB_REF_NAME, and GitHub-specific diff logic
- * - Vercel: Uses VERCEL_GIT_REPO_OWNER/SLUG, VERCEL_GIT_COMMIT_REF, and Vercel-specific diff logic
- * - GitLab: Uses CI_PROJECT_URL, CI_COMMIT_REF_NAME, and GitLab-specific diff logic
- *           (fetches default branch on-demand since GitLab only clones current branch)
- * - Local: Uses git commands for repo/branch, and local diff logic
- *
- * All methods fail loudly if they can't get the required information.
- */
-async function getGitContextForEnvironment(environment, repoRoot) {
-    switch (environment) {
-        case 'github':
-            return {
-                diff: await (0, git_diff_executor_1.getDiffForEnvironment)('github', repoRoot),
-                repoName: await (0, repo_1.getGitHubRepoName)(repoRoot),
-                branchName: await (0, repo_2.getGitHubBranchName)(repoRoot)
-            };
-        case 'vercel':
-            return {
-                diff: await (0, git_diff_executor_1.getDiffForEnvironment)('vercel', repoRoot),
-                repoName: await (0, repo_1.getVercelRepoName)(repoRoot),
-                branchName: await (0, repo_2.getVercelBranchName)(repoRoot)
-            };
-        case 'local':
-            return {
-                diff: await (0, git_diff_executor_1.getDiffForEnvironment)('local', repoRoot),
-                repoName: await (0, repo_1.getLocalRepoName)(repoRoot),
-                branchName: await (0, repo_2.getLocalBranchName)(repoRoot)
-            };
-        case 'gitlab':
-            return {
-                diff: await (0, git_diff_executor_1.getDiffForEnvironment)('gitlab', repoRoot),
-                repoName: await (0, repo_1.getGitLabRepoName)(repoRoot),
-                branchName: await (0, repo_2.getGitLabBranchName)(repoRoot)
-            };
-        default:
-            const _exhaustive = environment;
-            throw new Error(`Unknown environment: ${_exhaustive}`);
-    }
-}

package/dist/git/github-diff.js

@@ -1,116 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGitHubDiff = getGitHubDiff;
-const simple_git_1 = __importDefault(require("simple-git"));
-const repo_1 = require("./repo");
-/**
- * Get diff for GitHub Actions CI environment
- *
- * Handles four scenarios:
- *
- * 1. PR Context (pull_request event):
- *    Uses GITHUB_BASE_REF vs GITHUB_HEAD_REF
- *    Shows: All changes in the PR
- *
- * 2. Merge Commit to Default Branch (push event, default branch):
- *    Compare: origin/default~1 vs origin/default
- *    Shows: All changes that were merged in
- *
- * 3. Feature Branch Push (push event, feature branch):
- *    Compare: origin/default vs origin/feature-branch
- *    Shows: Cumulative changes in feature branch vs default
- *
- * 4. Direct Commit to Default Branch (push event, default branch, non-merge):
- *    Compare: origin/default~1 vs origin/default
- *    Shows: Changes in the direct commit
- *
- * Known Limitation - Rebase and Merge:
- *    When using "Rebase and merge" strategy in GitHub, multiple commits are
- *    added to the default branch. Our approach (default~1 vs default) only
- *    captures the LAST commit, not all rebased commits. This is a naive
- *    implementation. To fully support rebase merges, we'd need to use the
- *    `before` SHA from GITHUB_EVENT_PATH to compare before...after.
- */
-async function getGitHubDiff(repoRoot) {
-    const git = (0, simple_git_1.default)(repoRoot);
-    // Check if we're in a git repo
-    const isRepo = await git.checkIsRepo();
-    if (!isRepo) {
-        throw new Error('Not a git repository. Threadline requires a git repository.');
-    }
-    // Detect the default branch name (e.g., "main", "master")
-    // This is used for scenarios 2, 3, and 4
-    const defaultBranch = await (0, repo_1.getDefaultBranchName)(repoRoot);
-    // Determine context from GitHub environment variables
-    const eventName = process.env.GITHUB_EVENT_NAME;
-    const baseRef = process.env.GITHUB_BASE_REF;
-    const headRef = process.env.GITHUB_HEAD_REF;
-    const refName = process.env.GITHUB_REF_NAME;
-    const commitSha = process.env.GITHUB_SHA;
-    // Scenario 1: PR Context
-    // When a PR is created or updated, GitHub provides both base and head branches
-    // This is the simplest case - we use what GitHub gives us directly
-    if (eventName === 'pull_request') {
-        if (!baseRef || !headRef) {
-            throw new Error('GitHub PR context detected but GITHUB_BASE_REF or GITHUB_HEAD_REF is missing. ' +
-                'This should be automatically provided by GitHub Actions.');
-        }
-        // Compare target branch (base) vs source branch (head)
-        // This shows all changes in the PR
-        const diff = await git.diff([`origin/${baseRef}...origin/${headRef}`, '-U200']);
-        const diffSummary = await git.diffSummary([`origin/${baseRef}...origin/${headRef}`]);
-        const changedFiles = diffSummary.files.map(f => f.file);
-        return {
-            diff: diff || '',
-            changedFiles
-        };
-    }
-    // Scenario 2 & 4: Default Branch Push (merge commit or direct commit)
-    // When code is pushed to the default branch, we compare default~1 vs default
-    // This works for both merge commits and direct commits:
-    // - Merge commits: Shows all changes that were merged in
-    // - Direct commits: Shows the changes in the direct commit
-    if (refName === defaultBranch && commitSha) {
-        // Compare default branch before the push (default~1) vs default branch after the push (default)
-        // This shows all changes introduced by the push, whether merged or direct
-        try {
-            const diff = await git.diff([`origin/${defaultBranch}~1...origin/${defaultBranch}`, '-U200']);
-            const diffSummary = await git.diffSummary([`origin/${defaultBranch}~1...origin/${defaultBranch}`]);
-            const changedFiles = diffSummary.files.map(f => f.file);
-            return {
-                diff: diff || '',
-                changedFiles
-            };
-        }
-        catch (error) {
-            // If we can't get the diff (e.g., first commit on branch), throw a clear error
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-            throw new Error(`Could not get diff for default branch '${defaultBranch}'. ` +
-                `This might be the first commit on the branch. Error: ${errorMessage}`);
-        }
-    }
-    // Scenario 3: Feature Branch Push
-    // When code is pushed to a feature branch, we want to see all changes vs the default branch
-    // Compare: origin/default vs origin/feature-branch
-    // This shows cumulative changes in the feature branch (all commits vs default branch)
-    // Note: We don't use HEAD~1 vs HEAD because that only shows the last commit,
-    //       not the cumulative changes in the branch
-    if (refName) {
-        // For branch pushes, compare against origin/default (detected default branch)
-        // GitHub Actions with fetch-depth: 0 should have origin/default available
-        const diff = await git.diff([`origin/${defaultBranch}...origin/${refName}`, '-U200']);
-        const diffSummary = await git.diffSummary([`origin/${defaultBranch}...origin/${refName}`]);
-        const changedFiles = diffSummary.files.map(f => f.file);
-        return {
-            diff: diff || '',
-            changedFiles
-        };
-    }
-    // Neither PR nor branch context available
-    throw new Error('GitHub Actions environment detected but no valid context found. ' +
-        'Expected GITHUB_EVENT_NAME="pull_request" (with GITHUB_BASE_REF/GITHUB_HEAD_REF) ' +
-        'or GITHUB_REF_NAME for branch context.');
-}

package/dist/git/gitlab-diff.js

@@ -1,86 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGitLabDiff = getGitLabDiff;
-const simple_git_1 = __importDefault(require("simple-git"));
-/**
- * Get diff for GitLab CI environment
- *
- * GitLab CI does a shallow clone of ONLY the current branch. The default branch
- * (e.g., origin/main) is NOT available by default. We fetch it on-demand.
- *
- * Scenarios handled:
- *
- * 1. MR Context (CI_MERGE_REQUEST_IID is set):
- *    - Fetch target branch, then diff target vs source
- *
- * 2. Feature Branch Push (CI_COMMIT_REF_NAME != CI_DEFAULT_BRANCH):
- *    - Fetch default branch, then diff default vs feature
- *
- * 3. Default Branch Push (CI_COMMIT_REF_NAME == CI_DEFAULT_BRANCH):
- *    - Use HEAD~1...HEAD (last commit only, no fetch needed)
- *
- * This is the ONLY implementation for GitLab - no fallbacks, no alternatives.
- */
-async function getGitLabDiff(repoRoot) {
-    const git = (0, simple_git_1.default)(repoRoot);
-    // Check if we're in a git repo
-    const isRepo = await git.checkIsRepo();
-    if (!isRepo) {
-        throw new Error('Not a git repository. Threadline requires a git repository.');
-    }
-    // Get GitLab CI environment variables
-    const mrIid = process.env.CI_MERGE_REQUEST_IID;
-    const targetBranch = process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME;
-    const sourceBranch = process.env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME;
-    const refName = process.env.CI_COMMIT_REF_NAME;
-    const defaultBranch = process.env.CI_DEFAULT_BRANCH || 'main';
-    // Scenario 1: MR Context
-    if (mrIid) {
-        if (!targetBranch || !sourceBranch) {
-            throw new Error('GitLab MR context detected but CI_MERGE_REQUEST_TARGET_BRANCH_NAME or ' +
-                'CI_MERGE_REQUEST_SOURCE_BRANCH_NAME is missing. ' +
-                'This should be automatically provided by GitLab CI.');
-        }
-        // Fetch target branch (GitLab doesn't have it by default)
-        console.log(`  [GitLab] Fetching target branch: origin/${targetBranch}`);
-        await git.fetch(['origin', `${targetBranch}:refs/remotes/origin/${targetBranch}`, '--depth=1']);
-        // Diff target vs source
-        const diff = await git.diff([`origin/${targetBranch}...origin/${sourceBranch}`, '-U200']);
-        const diffSummary = await git.diffSummary([`origin/${targetBranch}...origin/${sourceBranch}`]);
-        const changedFiles = diffSummary.files.map(f => f.file);
-        return {
-            diff: diff || '',
-            changedFiles
-        };
-    }
-    // Scenario 2 & 3: Branch Push
-    if (!refName) {
-        throw new Error('GitLab CI environment detected but CI_COMMIT_REF_NAME is not set. ' +
-            'This should be automatically provided by GitLab CI.');
-    }
-    // Scenario 3: Default Branch Push (e.g., direct commit to main)
-    if (refName === defaultBranch) {
-        console.log(`  [GitLab] Push to default branch (${defaultBranch}), using HEAD~1...HEAD`);
-        const diff = await git.diff(['HEAD~1...HEAD', '-U200']);
-        const diffSummary = await git.diffSummary(['HEAD~1...HEAD']);
-        const changedFiles = diffSummary.files.map(f => f.file);
-        return {
-            diff: diff || '',
-            changedFiles
-        };
-    }
-    // Scenario 2: Feature Branch Push
-    console.log(`  [GitLab] Feature branch push, fetching default branch: origin/${defaultBranch}`);
-    await git.fetch(['origin', `${defaultBranch}:refs/remotes/origin/${defaultBranch}`, '--depth=1']);
-    // Diff default vs feature
-    const diff = await git.diff([`origin/${defaultBranch}...origin/${refName}`, '-U200']);
-    const diffSummary = await git.diffSummary([`origin/${defaultBranch}...origin/${refName}`]);
-    const changedFiles = diffSummary.files.map(f => f.file);
-    return {
-        diff: diff || '',
-        changedFiles
-    };
-}

package/dist/git/local-diff.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalDiff = getLocalDiff;
-const simple_git_1 = __importDefault(require("simple-git"));
-/**
- * Get diff for local development environment
- *
- * For local development, we check staged changes first, then unstaged changes.
- * This allows developers to review what they've staged before committing,
- * or review unstaged changes if nothing is staged.
- *
- * This is the ONLY implementation for local - no fallbacks, no alternatives.
- * If this doesn't work, we fail with a clear error.
- */
-async function getLocalDiff(repoRoot) {
-    const git = (0, simple_git_1.default)(repoRoot);
-    // Check if we're in a git repo
-    const isRepo = await git.checkIsRepo();
-    if (!isRepo) {
-        throw new Error('Not a git repository. Threadline requires a git repository.');
-    }
-    // Get git status to determine what changes exist
-    const status = await git.status();
-    let diff;
-    let changedFiles;
-    // Priority 1: Use staged changes if available
-    if (status.staged.length > 0) {
-        diff = await git.diff(['--cached', '-U200']);
-        // status.staged is an array of strings (file paths)
-        changedFiles = status.staged;
-    }
-    // Priority 2: Use unstaged changes if no staged changes
-    else if (status.files.length > 0) {
-        diff = await git.diff(['-U200']);
-        changedFiles = status.files
-            .filter(f => f.working_dir !== ' ' || f.index !== ' ')
-            .map(f => f.path);
-    }
-    // No changes at all
-    else {
-        return {
-            diff: '',
-            changedFiles: []
-        };
-    }
-    return {
-        diff: diff || '',
-        changedFiles
-    };
-}

package/dist/git/vercel-diff.js

@@ -1,42 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVercelDiff = getVercelDiff;
-const simple_git_1 = __importDefault(require("simple-git"));
-/**
- * Get diff for Vercel CI environment
- *
- * Vercel provides VERCEL_GIT_COMMIT_SHA which contains the commit being deployed.
- * This function gets the diff for that specific commit using git show.
- *
- * This is the ONLY implementation for Vercel - no fallbacks, no alternatives.
- * If this doesn't work, we fail with a clear error.
- */
-async function getVercelDiff(repoRoot) {
-    const git = (0, simple_git_1.default)(repoRoot);
-    // Check if we're in a git repo
-    const isRepo = await git.checkIsRepo();
-    if (!isRepo) {
-        throw new Error('Not a git repository. Threadline requires a git repository.');
-    }
-    // Get commit SHA from Vercel environment variable
-    const commitSha = process.env.VERCEL_GIT_COMMIT_SHA;
-    if (!commitSha) {
-        throw new Error('VERCEL_GIT_COMMIT_SHA environment variable is not set. ' +
-            'This should be automatically provided by Vercel CI.');
-    }
-    // Get diff using git show - this is the ONLY way we get diff in Vercel
-    const diff = await git.show([commitSha, '--format=', '--no-color', '-U200']);
-    // Get changed files using git show --name-only
-    const commitFiles = await git.show([commitSha, '--name-only', '--format=', '--pretty=format:']);
-    const changedFiles = commitFiles
-        .split('\n')
-        .filter(line => line.trim().length > 0)
-        .map(line => line.trim());
-    return {
-        diff: diff || '',
-        changedFiles
-    };
-}

package/dist/utils/git-diff-executor.js

@@ -1,65 +0,0 @@
-"use strict";
-/**
- * Git Diff Execution
- *
- * Executes the appropriate git diff function based on environment.
- * Each environment has ONE SINGLE IMPLEMENTATION - no fallbacks, no alternatives.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDiffForEnvironment = getDiffForEnvironment;
-exports.getContextDescription = getContextDescription;
-const vercel_diff_1 = require("../git/vercel-diff");
-const github_diff_1 = require("../git/github-diff");
-const local_diff_1 = require("../git/local-diff");
-const gitlab_diff_1 = require("../git/gitlab-diff");
-/**
- * Executes the appropriate git diff function based on environment.
- *
- * Each environment has a single, specific implementation:
- * - Vercel: Uses VERCEL_GIT_COMMIT_SHA, gets commit diff via git show
- * - GitHub: Uses GITHUB_BASE_REF/GITHUB_HEAD_REF for PRs, GITHUB_REF_NAME for branches
- * - GitLab: Uses CI_MERGE_REQUEST_TARGET_BRANCH_NAME/CI_MERGE_REQUEST_SOURCE_BRANCH_NAME for MRs, CI_COMMIT_REF_NAME for branches
- * - Local: Uses staged changes first, then unstaged changes
- *
- * No fallbacks - if the environment-specific implementation fails, we fail clearly.
- * Each environment is completely isolated - changes to one don't affect others.
- */
-async function getDiffForEnvironment(environment, repoRoot, _context) {
-    switch (environment) {
-        case 'vercel':
-            // Vercel: Single implementation using commit SHA
-            return await (0, vercel_diff_1.getVercelDiff)(repoRoot);
-        case 'github':
-            // GitHub: Single implementation using GitHub-provided environment variables
-            return await (0, github_diff_1.getGitHubDiff)(repoRoot);
-        case 'gitlab':
-            // GitLab: Single implementation using GitLab-provided environment variables
-            return await (0, gitlab_diff_1.getGitLabDiff)(repoRoot);
-        case 'local':
-            // Local: Single implementation using staged/unstaged changes
-            return await (0, local_diff_1.getLocalDiff)(repoRoot);
-        default:
-            const _exhaustive = environment;
-            throw new Error(`Unknown environment: ${_exhaustive}`);
-    }
-}
-/**
- * Returns a human-readable description of the context for logging.
- */
-function getContextDescription(context) {
-    switch (context.type) {
-        case 'pr':
-            return `PR: ${context.prNumber}`;
-        case 'mr':
-            return `MR: ${context.mrNumber}`;
-        case 'branch':
-            return `branch: ${context.branchName}`;
-        case 'commit':
-            return `commit: ${context.commitSha.substring(0, 7)}`;
-        case 'local':
-            return 'local changes';
-        default:
-            const _exhaustive = context;
-            throw new Error(`Unknown context type: ${_exhaustive}`);
-    }
-}