threadlines 0.2.16 → 0.2.18

package/dist/commands/check.js

@@ -42,10 +42,7 @@ const file_1 = require("../git/file");
 const client_1 = require("../api/client");
 const config_1 = require("../utils/config");
 const environment_1 = require("../utils/environment");
-const github_1 = require("../git/github");
-const gitlab_1 = require("../git/gitlab");
-const bitbucket_1 = require("../git/bitbucket");
-const vercel_1 = require("../git/vercel");
+const ci_context_1 = require("../git/ci-context");
 const local_1 = require("../git/local");
 const config_file_1 = require("../utils/config-file");
 const logger_1 = require("../utils/logger");
@@ -55,22 +52,20 @@ const chalk_1 = __importDefault(require("chalk"));
 const simple_git_1 = __importDefault(require("simple-git"));
 /**
  * Helper to get context for any environment.
- * This centralizes the environment switch logic.
+ * CI environments use the unified getCIContext().
+ * Local environment has special handling for flags.
  */
 async function getContextForEnvironment(environment, repoRoot, commitSha) {
     switch (environment) {
+        case 'local':
+            return (0, local_1.getLocalContext)(repoRoot, commitSha);
         case 'github':
-            return (0, github_1.getGitHubContext)(repoRoot);
         case 'gitlab':
-            return (0, gitlab_1.getGitLabContext)(repoRoot);
         case 'bitbucket':
-            return (0, bitbucket_1.getBitbucketContext)(repoRoot);
         case 'vercel':
-            return (0, vercel_1.getVercelContext)(repoRoot);
-        case 'local':
-            return (0, local_1.getLocalContext)(repoRoot, commitSha);
+            return (0, ci_context_1.getCIContext)(repoRoot, environment);
         default:
-            // TypeScript exhaustiveness check - should never happen
+            // TypeScript exhaustiveness check - fails at compile time if new Environment added
             throw new Error(`Unrecognized environment: ${environment}`);
     }
 }

package/dist/git/ci-config.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * CI Environment Configuration
+ *
+ * This is the ONLY place where CI-specific environment variables are read.
+ * Each CI provider has different env var names for the same concepts.
+ * This config maps them to a common interface.
+ *
+ * Everything else (repo URL, commit SHA, author, diff) uses shared git commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CI_CONFIGS = void 0;
+/**
+ * CI configuration for each environment.
+ * Only reads env vars - no git commands here.
+ */
+exports.CI_CONFIGS = {
+    github: {
+        isPullRequest: () => process.env.GITHUB_EVENT_NAME === 'pull_request',
+        getTargetBranch: () => process.env.GITHUB_BASE_REF,
+        getBranchName: () => {
+            const refName = process.env.GITHUB_REF_NAME;
+            if (!refName) {
+                throw new Error('GitHub Actions: GITHUB_REF_NAME is not set. ' +
+                    'This should be automatically provided by GitHub Actions.');
+            }
+            return refName;
+        },
+        getPRTitle: () => process.env.PR_TITLE, // Must be passed from workflow YAML
+    },
+    gitlab: {
+        isPullRequest: () => !!process.env.CI_MERGE_REQUEST_IID,
+        getTargetBranch: () => process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME,
+        getBranchName: () => {
+            const refName = process.env.CI_COMMIT_REF_NAME;
+            if (!refName) {
+                throw new Error('GitLab CI: CI_COMMIT_REF_NAME is not set. ' +
+                    'This should be automatically provided by GitLab CI.');
+            }
+            return refName;
+        },
+        getPRTitle: () => process.env.CI_MERGE_REQUEST_TITLE,
+    },
+    bitbucket: {
+        isPullRequest: () => !!process.env.BITBUCKET_PR_ID,
+        getTargetBranch: () => process.env.BITBUCKET_PR_DESTINATION_BRANCH,
+        getBranchName: () => {
+            const branchName = process.env.BITBUCKET_BRANCH;
+            if (!branchName) {
+                throw new Error('Bitbucket Pipelines: BITBUCKET_BRANCH is not set. ' +
+                    'This should be automatically provided by Bitbucket Pipelines.');
+            }
+            return branchName;
+        },
+        getPRTitle: () => undefined, // Bitbucket doesn't expose PR title as env var
+    },
+    vercel: {
+        isPullRequest: () => false, // Vercel only supports commit deployments
+        getTargetBranch: () => undefined,
+        getBranchName: () => {
+            const branch = process.env.VERCEL_GIT_COMMIT_REF;
+            if (!branch) {
+                throw new Error('Vercel: VERCEL_GIT_COMMIT_REF is not set. ' +
+                    'This should be automatically provided by Vercel.');
+            }
+            return branch;
+        },
+        getPRTitle: () => undefined,
+    },
+};

package/dist/git/ci-context.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Unified CI Context
+ *
+ * Single function to get context for ANY CI environment.
+ * Uses:
+ * - Shared git commands for: repo URL, commit SHA, author, message, diff
+ * - CI-specific env vars (via ci-config.ts) for: PR detection, branch name, PR title
+ *
+ * This replaces the individual github.ts, gitlab.ts, bitbucket.ts, vercel.ts files.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCIContext = getCIContext;
+const simple_git_1 = __importDefault(require("simple-git"));
+const logger_1 = require("../utils/logger");
+const ci_config_1 = require("./ci-config");
+const diff_1 = require("./diff");
+/**
+ * Get context for any CI environment.
+ *
+ * This is the SINGLE entry point for all CI environments.
+ * It uses shared git commands for most data, and only reads
+ * CI-specific env vars for things git can't provide reliably.
+ *
+ * @param repoRoot - Path to the repository root
+ * @param environment - The CI environment (github, gitlab, bitbucket, vercel)
+ */
+async function getCIContext(repoRoot, environment) {
+    const git = (0, simple_git_1.default)(repoRoot);
+    const config = ci_config_1.CI_CONFIGS[environment];
+    // 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.');
+    }
+    // === SHARED GIT COMMANDS (reliable across all CI environments) ===
+    const repoName = await (0, diff_1.getRepoUrl)(repoRoot);
+    const commitSha = await (0, diff_1.getHeadCommitSha)(repoRoot);
+    const commitAuthor = await (0, diff_1.getCommitAuthor)(repoRoot);
+    const commitMessage = await (0, diff_1.getCommitMessage)(repoRoot, commitSha) || undefined;
+    // === CI-SPECIFIC ENV VARS (only for things git can't provide) ===
+    const branchName = config.getBranchName();
+    const isPR = config.isPullRequest();
+    const reviewContext = isPR ? 'pr' : 'commit';
+    const prTitle = isPR ? config.getPRTitle() : undefined;
+    // Get diff using appropriate strategy
+    let diff;
+    if (isPR) {
+        const targetBranch = config.getTargetBranch();
+        if (!targetBranch) {
+            throw new Error(`${environment} PR context detected but target branch is missing. ` +
+                'This should be automatically provided by the CI environment.');
+        }
+        diff = await (0, diff_1.getPRDiff)(repoRoot, targetBranch, logger_1.logger);
+    }
+    else {
+        diff = await (0, diff_1.getCommitDiff)(repoRoot);
+    }
+    return {
+        diff,
+        repoName,
+        branchName,
+        commitSha,
+        commitMessage,
+        commitAuthor,
+        prTitle,
+        reviewContext,
+    };
+}

package/dist/git/diff.js

@@ -3,12 +3,88 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepoUrl = getRepoUrl;
+exports.getHeadCommitSha = getHeadCommitSha;
 exports.getCommitMessage = getCommitMessage;
 exports.getCommitAuthor = getCommitAuthor;
 exports.getPRDiff = getPRDiff;
 exports.getCommitDiff = getCommitDiff;
 const simple_git_1 = __importDefault(require("simple-git"));
 const child_process_1 = require("child_process");
+// =============================================================================
+// CORE GIT OPERATIONS
+// These functions use raw git commands and work reliably across all CI environments.
+// They are the single source of truth for git information.
+// =============================================================================
+/**
+ * Get the repository URL from git remote origin.
+ *
+ * Uses `git remote get-url origin` which works in all environments,
+ * including shallow clones. This is more reliable than CI-specific
+ * environment variables as it reads directly from git config.
+ *
+ * @param repoRoot - Path to the repository root
+ * @returns Repository URL (e.g., "https://github.com/user/repo.git")
+ */
+/**
+ * Sanitize a git remote URL by removing embedded credentials.
+ *
+ * CI environments often embed tokens in the remote URL for authentication:
+ * - GitLab CI: https://gitlab-ci-token:TOKEN@gitlab.com/user/repo
+ * - GitHub Actions: https://x-access-token:TOKEN@github.com/user/repo
+ *
+ * This function strips credentials to prevent token exposure in logs/UI.
+ */
+function sanitizeRepoUrl(url) {
+    // Handle HTTPS URLs with credentials: https://user:pass@host/path
+    // The regex matches: protocol://anything@host/path and removes "anything@"
+    const sanitized = url.replace(/^(https?:\/\/)([^@]+@)/, '$1');
+    return sanitized;
+}
+async function getRepoUrl(repoRoot) {
+    try {
+        const url = (0, child_process_1.execSync)('git remote get-url origin', {
+            encoding: 'utf-8',
+            cwd: repoRoot
+        }).trim();
+        if (!url) {
+            throw new Error('Empty URL returned');
+        }
+        // Remove embedded credentials (CI tokens) from the URL
+        return sanitizeRepoUrl(url);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get repository URL from git remote. ` +
+            `Ensure 'origin' remote is configured. Error: ${message}`);
+    }
+}
+/**
+ * Get the current HEAD commit SHA.
+ *
+ * Uses `git rev-parse HEAD` which works reliably in all environments,
+ * including shallow clones. This is the single source of truth for
+ * the current commit SHA.
+ *
+ * @param repoRoot - Path to the repository root
+ * @returns Full commit SHA (40 characters)
+ */
+async function getHeadCommitSha(repoRoot) {
+    try {
+        const sha = (0, child_process_1.execSync)('git rev-parse HEAD', {
+            encoding: 'utf-8',
+            cwd: repoRoot
+        }).trim();
+        if (!sha || sha.length !== 40) {
+            throw new Error(`Invalid SHA returned: "${sha}"`);
+        }
+        return sha;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get HEAD commit SHA: ${message}`);
+    }
+}
 /**
  * Get commit message for a specific commit SHA
  * Returns full commit message (subject + body) or null if commit not found

package/dist/git/local.js

@@ -30,9 +30,8 @@ async function getLocalContext(repoRoot, commitSha) {
     }
     // Get all Local context
     const diff = commitSha ? await (0, diff_1.getCommitDiff)(repoRoot, commitSha) : await getDiff(repoRoot);
-    const repoName = await getRepoName(repoRoot);
+    const repoName = await (0, diff_1.getRepoUrl)(repoRoot); // Shared git command
     const branchName = await getBranchName(repoRoot);
-    const context = commitSha ? { type: 'commit', commitSha } : { type: 'local' };
     const reviewContext = commitSha ? 'commit' : 'local';
     // Get commit author (fails loudly if unavailable)
     const commitAuthor = commitSha
@@ -54,7 +53,6 @@ async function getLocalContext(repoRoot, commitSha) {
         commitMessage,
         commitAuthor,
         prTitle: undefined, // Not applicable for local
-        context,
         reviewContext
     };
 }
@@ -96,26 +94,9 @@ async function getDiff(repoRoot) {
         changedFiles
     };
 }
-/**
- * Gets repository name for local environment
- */
-async function getRepoName(repoRoot) {
-    const git = (0, simple_git_1.default)(repoRoot);
-    try {
-        const remotes = await git.getRemotes(true);
-        const origin = remotes.find(r => r.name === 'origin');
-        if (!origin || !origin.refs?.fetch) {
-            throw new Error('No origin remote found. Please set up a git remote named "origin".');
-        }
-        return origin.refs.fetch;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        throw new Error(`Failed to get repository name from git remote: ${errorMessage}`);
-    }
-}
 /**
  * Gets branch name for local environment
+ * (Uses git command directly - works in local because not in detached HEAD state)
  */
 async function getBranchName(repoRoot) {
     const git = (0, simple_git_1.default)(repoRoot);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threadlines",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "Threadlines CLI - AI-powered linter based on your natural language documentation",
   "main": "dist/index.js",
   "bin": {

package/dist/git/bitbucket.js

@@ -1,164 +0,0 @@
-"use strict";
-/**
- * Bitbucket Pipelines Environment
- *
- * All Bitbucket-specific logic is contained in this file.
- * No dependencies on other environment implementations.
- *
- * Exports a single function: getBitbucketContext() that returns:
- * - diff: GitDiffResult
- * - repoName: string
- * - branchName: string
- * - commitAuthor: { name: string; email: string }
- * - prTitle?: string (PR title - not available in Bitbucket env vars)
- *
- * Implementation Status (all tested 2026-01-18):
- * - ✅ Direct commit to main
- * - ✅ Feature branch push
- * - ✅ PR context
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBitbucketContext = getBitbucketContext;
-const simple_git_1 = __importDefault(require("simple-git"));
-const diff_1 = require("./diff");
-const logger_1 = require("../utils/logger");
-/**
- * Gets all Bitbucket context in one call
- */
-async function getBitbucketContext(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 all Bitbucket context
-    const diff = await getDiff(repoRoot);
-    const repoName = getRepoName();
-    const branchName = getBranchName();
-    const context = detectContext();
-    const reviewContext = detectReviewContext();
-    const commitSha = getCommitSha();
-    // Get commit author using shared function (git log)
-    // getCommitAuthor throws on failure with descriptive error
-    const commitAuthor = await (0, diff_1.getCommitAuthor)(repoRoot);
-    // Get commit message if we have a SHA
-    let commitMessage;
-    if (commitSha) {
-        const message = await (0, diff_1.getCommitMessage)(repoRoot, commitSha);
-        if (message) {
-            commitMessage = message;
-        }
-    }
-    return {
-        diff,
-        repoName,
-        branchName,
-        commitSha,
-        commitMessage,
-        commitAuthor,
-        prTitle: undefined, // Bitbucket doesn't expose PR title as env var
-        context,
-        reviewContext
-    };
-}
-/**
- * Get diff for Bitbucket Pipelines environment
- *
- * Strategy:
- * - PR context: Uses shared getPRDiff() - fetches destination branch, compares against HEAD
- * - Any push (main or feature branch): Compare last commit only (HEAD~1...HEAD)
- *
- * Note: We fetch the destination branch on-demand so this works with shallow clones.
- * Users don't need `depth: full` in their bitbucket-pipelines.yml.
- */
-async function getDiff(repoRoot) {
-    const prId = process.env.BITBUCKET_PR_ID;
-    const prDestinationBranch = process.env.BITBUCKET_PR_DESTINATION_BRANCH;
-    // PR Context: Use shared getPRDiff() implementation
-    if (prId) {
-        if (!prDestinationBranch) {
-            throw new Error('Bitbucket PR context detected but BITBUCKET_PR_DESTINATION_BRANCH is not set. ' +
-                'This should be automatically provided by Bitbucket Pipelines.');
-        }
-        return (0, diff_1.getPRDiff)(repoRoot, prDestinationBranch, logger_1.logger);
-    }
-    // Any push (main or feature branch): Review last commit only
-    // Use shared getCommitDiff (defaults to HEAD)
-    return (0, diff_1.getCommitDiff)(repoRoot);
-}
-/**
- * Gets repository name for Bitbucket Pipelines
- *
- * Uses BITBUCKET_REPO_FULL_NAME to construct the repo URL.
- * Example: ngrootscholten/threadline -> https://bitbucket.org/ngrootscholten/threadline.git
- */
-function getRepoName() {
-    const repoFullName = process.env.BITBUCKET_REPO_FULL_NAME;
-    if (!repoFullName) {
-        throw new Error('Bitbucket Pipelines: BITBUCKET_REPO_FULL_NAME environment variable is not set. ' +
-            'This should be automatically provided by Bitbucket Pipelines.');
-    }
-    return `https://bitbucket.org/${repoFullName}.git`;
-}
-/**
- * Gets branch name for Bitbucket Pipelines
- */
-function getBranchName() {
-    const branchName = process.env.BITBUCKET_BRANCH;
-    if (!branchName) {
-        throw new Error('Bitbucket Pipelines: BITBUCKET_BRANCH environment variable is not set. ' +
-            'This should be automatically provided by Bitbucket Pipelines.');
-    }
-    return branchName;
-}
-/**
- * Detects Bitbucket context (PR or commit)
- *
- * - PR context: When BITBUCKET_PR_ID is set
- * - Commit context: Any push (main or feature branch) - reviews single commit
- */
-function detectContext() {
-    // PR context
-    const prId = process.env.BITBUCKET_PR_ID;
-    const prDestinationBranch = process.env.BITBUCKET_PR_DESTINATION_BRANCH;
-    const sourceBranch = process.env.BITBUCKET_BRANCH;
-    if (prId && prDestinationBranch && sourceBranch) {
-        return {
-            type: 'pr',
-            prNumber: prId,
-            sourceBranch,
-            targetBranch: prDestinationBranch
-        };
-    }
-    // Any push (main or feature branch) → commit context
-    if (process.env.BITBUCKET_COMMIT) {
-        return {
-            type: 'commit',
-            commitSha: process.env.BITBUCKET_COMMIT
-        };
-    }
-    throw new Error('Bitbucket Pipelines: Could not detect context. ' +
-        'Expected BITBUCKET_PR_ID or BITBUCKET_COMMIT to be set. ' +
-        'This should be automatically provided by Bitbucket Pipelines.');
-}
-/**
- * Detects review context type for API (simple string type)
- */
-function detectReviewContext() {
-    // PR context
-    if (process.env.BITBUCKET_PR_ID) {
-        return 'pr';
-    }
-    // Commit context (any push)
-    return 'commit';
-}
-/**
- * Gets commit SHA from Bitbucket environment
- */
-function getCommitSha() {
-    return process.env.BITBUCKET_COMMIT;
-}

package/dist/git/github.js

@@ -1,184 +0,0 @@
-"use strict";
-/**
- * GitHub Actions Environment
- *
- * All GitHub-specific logic is contained in this file.
- * No dependencies on other environment implementations.
- *
- * Exports a single function: getGitHubContext() that returns:
- * - diff: GitDiffResult
- * - repoName: string
- * - branchName: string
- * - commitAuthor: { name: string; email: string }
- * - prTitle?: string
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGitHubContext = getGitHubContext;
-const simple_git_1 = __importDefault(require("simple-git"));
-const diff_1 = require("./diff");
-const logger_1 = require("../utils/logger");
-/**
- * Gets all GitHub context
- */
-async function getGitHubContext(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 all GitHub context
-    const diff = await getDiff(repoRoot);
-    const repoName = await getRepoName();
-    const branchName = await getBranchName();
-    const context = detectContext();
-    const reviewContext = detectReviewContext();
-    const commitSha = getCommitSha(context);
-    // Validate commit SHA is available (should always be set in GitHub Actions)
-    if (!commitSha) {
-        throw new Error('GitHub Actions: GITHUB_SHA environment variable is not set. ' +
-            'This should be automatically provided by GitHub Actions.');
-    }
-    // Get commit author using git commands (same approach as Bitbucket/Local)
-    // getCommitAuthor throws on failure with descriptive error
-    const commitAuthor = await (0, diff_1.getCommitAuthor)(repoRoot, commitSha);
-    // Get commit message if we have a SHA
-    let commitMessage;
-    if (commitSha) {
-        const message = await (0, diff_1.getCommitMessage)(repoRoot, commitSha);
-        if (message) {
-            commitMessage = message;
-        }
-    }
-    // Get PR title if in PR context
-    const prTitle = getPRTitle(context);
-    return {
-        diff,
-        repoName,
-        branchName,
-        commitSha,
-        commitMessage,
-        commitAuthor,
-        prTitle,
-        context,
-        reviewContext
-    };
-}
-/**
- * Gets diff for GitHub Actions CI environment
- *
- * Strategy:
- * - PR context: Uses shared getPRDiff() - fetches base branch, compares against HEAD
- * - Any push (main or feature branch): Compare last commit only using git show HEAD
- *
- * Note: GitHub Actions does shallow clones by default (fetch-depth: 1), so we fetch
- * the base branch on-demand. HEAD points to the merge commit which contains all PR changes.
- */
-async function getDiff(repoRoot) {
-    const eventName = process.env.GITHUB_EVENT_NAME;
-    const baseRef = process.env.GITHUB_BASE_REF;
-    // PR Context: Use shared getPRDiff() implementation
-    if (eventName === 'pull_request') {
-        if (!baseRef) {
-            throw new Error('GitHub PR context detected but GITHUB_BASE_REF is missing. ' +
-                'This should be automatically provided by GitHub Actions.');
-        }
-        return (0, diff_1.getPRDiff)(repoRoot, baseRef, logger_1.logger);
-    }
-    // Any push (main or feature branch): Review last commit only
-    // Use shared getCommitDiff (defaults to HEAD)
-    return (0, diff_1.getCommitDiff)(repoRoot);
-}
-/**
- * Gets repository name for GitHub Actions
- */
-async function getRepoName() {
-    const githubRepo = process.env.GITHUB_REPOSITORY;
-    if (!githubRepo) {
-        throw new Error('GitHub Actions: GITHUB_REPOSITORY environment variable is not set. ' +
-            'This should be automatically provided by GitHub Actions.');
-    }
-    const serverUrl = process.env.GITHUB_SERVER_URL || 'https://github.com';
-    return `${serverUrl}/${githubRepo}.git`;
-}
-/**
- * Gets branch name for GitHub Actions
- */
-async function getBranchName() {
-    const refName = process.env.GITHUB_REF_NAME;
-    if (!refName) {
-        throw new Error('GitHub Actions: GITHUB_REF_NAME environment variable is not set. ' +
-            'This should be automatically provided by GitHub Actions.');
-    }
-    return refName;
-}
-/**
- * Detects GitHub context (PR or commit)
- *
- * - PR context: When GITHUB_EVENT_NAME is 'pull_request'
- * - Commit context: Any push (main or feature branch) - reviews single commit
- */
-function detectContext() {
-    // PR context
-    if (process.env.GITHUB_EVENT_NAME === 'pull_request') {
-        const targetBranch = process.env.GITHUB_BASE_REF;
-        const sourceBranch = process.env.GITHUB_HEAD_REF;
-        const prNumber = process.env.GITHUB_EVENT_PULL_REQUEST_NUMBER || process.env.GITHUB_EVENT_NUMBER;
-        if (targetBranch && sourceBranch && prNumber) {
-            return {
-                type: 'pr',
-                prNumber,
-                sourceBranch,
-                targetBranch
-            };
-        }
-    }
-    // Any push (main or feature branch) → commit context
-    if (process.env.GITHUB_SHA) {
-        return {
-            type: 'commit',
-            commitSha: process.env.GITHUB_SHA
-        };
-    }
-    throw new Error('GitHub Actions: Could not detect context. ' +
-        'Expected GITHUB_EVENT_NAME="pull_request" or GITHUB_SHA to be set. ' +
-        'This should be automatically provided by GitHub Actions.');
-}
-/**
- * Gets commit SHA from context
- */
-function getCommitSha(context) {
-    if (context.type === 'commit') {
-        return context.commitSha;
-    }
-    if (context.type === 'pr') {
-        return process.env.GITHUB_SHA;
-    }
-    return undefined;
-}
-/**
- * Detects review context type for API (simple string type)
- */
-function detectReviewContext() {
-    // PR context
-    if (process.env.GITHUB_EVENT_NAME === 'pull_request') {
-        return 'pr';
-    }
-    // Commit context (any push)
-    return 'commit';
-}
-/**
- * Gets PR title for GitHub Actions
- * Note: GitHub Actions doesn't provide PR title as an env var by default.
- * It would need to be passed from the workflow YAML or fetched via API.
- */
-function getPRTitle(context) {
-    if (context.type !== 'pr') {
-        return undefined;
-    }
-    // Only if passed from workflow: PR_TITLE: ${{ github.event.pull_request.title }}
-    return process.env.PR_TITLE;
-}

package/dist/git/gitlab.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * GitLab CI Environment
- *
- * All GitLab-specific logic is contained in this file.
- * No dependencies on other environment implementations.
- *
- * Exports a single function: getGitLabContext() that returns:
- * - diff: GitDiffResult
- * - repoName: string
- * - branchName: string
- * - commitAuthor: { name: string; email: string }
- * - prTitle?: string (MR title)
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGitLabContext = getGitLabContext;
-const simple_git_1 = __importDefault(require("simple-git"));
-const diff_1 = require("./diff");
-const logger_1 = require("../utils/logger");
-/**
- * Gets all GitLab context
- */
-async function getGitLabContext(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 all GitLab context
-    const diff = await getDiff(repoRoot);
-    const repoName = await getRepoName();
-    const branchName = await getBranchName();
-    const context = detectContext();
-    const reviewContext = detectReviewContext();
-    const commitSha = getCommitSha(context);
-    // Get commit author using shared function (git log)
-    // getCommitAuthor throws on failure with descriptive error
-    const commitAuthor = await (0, diff_1.getCommitAuthor)(repoRoot);
-    // Get commit message if we have a SHA
-    let commitMessage;
-    if (commitSha) {
-        const message = await (0, diff_1.getCommitMessage)(repoRoot, commitSha);
-        if (message) {
-            commitMessage = message;
-        }
-    }
-    // Get MR title if in MR context
-    const prTitle = getMRTitle(context);
-    return {
-        diff,
-        repoName,
-        branchName,
-        commitSha,
-        commitMessage,
-        commitAuthor,
-        prTitle,
-        context,
-        reviewContext
-    };
-}
-/**
- * Get diff for GitLab CI environment
- *
- * Strategy:
- * - MR context: Uses shared getPRDiff() - fetches target branch, compares against HEAD
- * - Any push (main or feature branch): Compare last commit only (HEAD~1...HEAD)
- *
- * Note: GitLab CI does a shallow clone, so we fetch the target branch for MR context.
- * For regular pushes, HEAD~1...HEAD works without additional fetching.
- */
-async function getDiff(repoRoot) {
-    const mrIid = process.env.CI_MERGE_REQUEST_IID;
-    const targetBranch = process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME;
-    // MR Context: Use shared getPRDiff() implementation
-    if (mrIid) {
-        if (!targetBranch) {
-            throw new Error('GitLab MR context detected but CI_MERGE_REQUEST_TARGET_BRANCH_NAME is missing. ' +
-                'This should be automatically provided by GitLab CI.');
-        }
-        return (0, diff_1.getPRDiff)(repoRoot, targetBranch, logger_1.logger);
-    }
-    // Any push (main or feature branch): Review last commit only
-    // Use shared getCommitDiff (defaults to HEAD)
-    return (0, diff_1.getCommitDiff)(repoRoot);
-}
-/**
- * Gets repository name for GitLab CI
- */
-async function getRepoName() {
-    const projectUrl = process.env.CI_PROJECT_URL;
-    if (!projectUrl) {
-        throw new Error('GitLab CI: CI_PROJECT_URL environment variable is not set. ' +
-            'This should be automatically provided by GitLab CI.');
-    }
-    return `${projectUrl}.git`;
-}
-/**
- * Gets branch name for GitLab CI
- */
-async function getBranchName() {
-    const refName = process.env.CI_COMMIT_REF_NAME;
-    if (!refName) {
-        throw new Error('GitLab CI: CI_COMMIT_REF_NAME environment variable is not set. ' +
-            'This should be automatically provided by GitLab CI.');
-    }
-    return refName;
-}
-/**
- * Detects GitLab context (MR or commit)
- *
- * - MR context: When CI_MERGE_REQUEST_IID is set
- * - Commit context: Any push (main or feature branch) - reviews single commit
- */
-function detectContext() {
-    // MR context
-    const mrIid = process.env.CI_MERGE_REQUEST_IID;
-    if (mrIid) {
-        const targetBranch = process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME;
-        const sourceBranch = process.env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME;
-        if (targetBranch && sourceBranch) {
-            return {
-                type: 'mr',
-                mrNumber: mrIid,
-                sourceBranch,
-                targetBranch
-            };
-        }
-    }
-    // Any push (main or feature branch) → commit context
-    if (process.env.CI_COMMIT_SHA) {
-        return {
-            type: 'commit',
-            commitSha: process.env.CI_COMMIT_SHA
-        };
-    }
-    throw new Error('GitLab CI: Could not detect context. ' +
-        'Expected CI_MERGE_REQUEST_IID or CI_COMMIT_SHA to be set. ' +
-        'This should be automatically provided by GitLab CI.');
-}
-/**
- * Detects review context type for API (simple string type)
- */
-function detectReviewContext() {
-    // MR context
-    if (process.env.CI_MERGE_REQUEST_IID) {
-        return 'pr';
-    }
-    // Commit context (any push)
-    return 'commit';
-}
-/**
- * Gets commit SHA from context
- */
-function getCommitSha(context) {
-    if (context.type === 'commit') {
-        return context.commitSha;
-    }
-    if (context.type === 'mr') {
-        return process.env.CI_COMMIT_SHA;
-    }
-    return undefined;
-}
-/**
- * Gets MR title for GitLab CI
- */
-function getMRTitle(context) {
-    if (context.type !== 'mr') {
-        return undefined;
-    }
-    // GitLab CI provides MR title as env var
-    return process.env.CI_MERGE_REQUEST_TITLE;
-}

package/dist/git/vercel.js

@@ -1,102 +0,0 @@
-"use strict";
-/**
- * Vercel Environment
- *
- * All Vercel-specific logic is contained in this file.
- * No dependencies on other environment implementations.
- *
- * Exports a single function: getVercelContext() that returns:
- * - diff: GitDiffResult
- * - repoName: string
- * - branchName: string
- * - commitAuthor: { name: string; email: string }
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVercelContext = getVercelContext;
-const simple_git_1 = __importDefault(require("simple-git"));
-const diff_1 = require("./diff");
-/**
- * Gets all Vercel context
- */
-async function getVercelContext(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 all Vercel context
-    const diff = await getDiff(repoRoot);
-    const repoName = await getRepoName();
-    const branchName = await getBranchName();
-    const commitSha = getCommitSha();
-    const context = { type: 'commit', commitSha };
-    const reviewContext = 'commit';
-    // Get commit author using shared function (git log)
-    // getCommitAuthor throws on failure with descriptive error
-    const commitAuthor = await (0, diff_1.getCommitAuthor)(repoRoot, commitSha);
-    // Get commit message
-    let commitMessage;
-    const message = await (0, diff_1.getCommitMessage)(repoRoot, commitSha);
-    if (message) {
-        commitMessage = message;
-    }
-    return {
-        diff,
-        repoName,
-        branchName,
-        commitSha,
-        commitMessage,
-        commitAuthor,
-        context,
-        reviewContext
-    };
-}
-/**
- * Get diff for Vercel CI environment
- *
- * Vercel only supports commit context (no PRs).
- * Uses shared getCommitDiff with HEAD (which equals VERCEL_GIT_COMMIT_SHA).
- */
-async function getDiff(repoRoot) {
-    // Use shared getCommitDiff (defaults to HEAD)
-    // In Vercel, HEAD is the commit being deployed
-    return (0, diff_1.getCommitDiff)(repoRoot);
-}
-/**
- * Gets repository name for Vercel
- */
-async function getRepoName() {
-    const owner = process.env.VERCEL_GIT_REPO_OWNER;
-    const slug = process.env.VERCEL_GIT_REPO_SLUG;
-    if (!owner || !slug) {
-        throw new Error('Vercel: VERCEL_GIT_REPO_OWNER or VERCEL_GIT_REPO_SLUG environment variable is not set. ' +
-            'This should be automatically provided by Vercel CI.');
-    }
-    return `https://github.com/${owner}/${slug}.git`;
-}
-/**
- * Gets branch name for Vercel
- */
-async function getBranchName() {
-    const branchName = process.env.VERCEL_GIT_COMMIT_REF;
-    if (!branchName) {
-        throw new Error('Vercel: VERCEL_GIT_COMMIT_REF environment variable is not set. ' +
-            'This should be automatically provided by Vercel CI.');
-    }
-    return branchName;
-}
-/**
- * Gets commit SHA for Vercel
- */
-function getCommitSha() {
-    const commitSha = process.env.VERCEL_GIT_COMMIT_SHA;
-    if (!commitSha) {
-        throw new Error('Vercel: VERCEL_GIT_COMMIT_SHA environment variable is not set. ' +
-            'This should be automatically provided by Vercel CI.');
-    }
-    return commitSha;
-}

package/dist/utils/context.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * Review Context Types
- *
- * Type definitions for the different code review contexts:
- * - PR/MR: Comparing source branch vs target branch (branch-level diff)
- * - Commit: Single commit changes (any push without PR/MR)
- * - Local: Staged/unstaged changes in working directory
- */
-Object.defineProperty(exports, "__esModule", { value: true });