threadlines 0.2.4 → 0.2.6

package/dist/commands/check.js

@@ -44,6 +44,7 @@ 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 local_1 = require("../git/local");
 const diff_1 = require("../git/diff");
@@ -51,6 +52,24 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 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.
+ */
+async function getContextForEnvironment(environment, repoRoot, commitSha) {
+    switch (environment) {
+        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);
+        default:
+            return (0, local_1.getLocalContext)(repoRoot, commitSha);
+    }
+}
 // Get CLI version from package.json
 const packageJsonPath = path.join(__dirname, '../../package.json');
 const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
@@ -103,9 +122,10 @@ async function checkCommand(options) {
         console.log(chalk_1.default.gray('    3. Make sure .env.local is in your .gitignore'));
         console.log('');
         console.log(chalk_1.default.white('  CI/CD:'));
-        console.log(chalk_1.default.gray('    GitHub Actions: Settings → Secrets → Add variables'));
-        console.log(chalk_1.default.gray('    GitLab CI:      Settings → CI/CD → Variables'));
-        console.log(chalk_1.default.gray('    Vercel:         Settings → Environment Variables'));
+        console.log(chalk_1.default.gray('    GitHub Actions:     Settings → Secrets → Add variables'));
+        console.log(chalk_1.default.gray('    GitLab CI:          Settings → CI/CD → Variables'));
+        console.log(chalk_1.default.gray('    Bitbucket Pipelines: Repository settings → Repository variables'));
+        console.log(chalk_1.default.gray('    Vercel:             Settings → Environment Variables'));
         console.log('');
         console.log(chalk_1.default.gray('Get your credentials at: https://devthreadline.com/settings'));
         process.exit(1);
@@ -126,155 +146,37 @@ async function checkCommand(options) {
         let repoName;
         let branchName;
         let metadata = {};
-        // Validate mutually exclusive flags
+        // Check for explicit flags
         const explicitFlags = [options.branch, options.commit, options.file, options.folder, options.files].filter(Boolean);
+        // Validate mutually exclusive flags
         if (explicitFlags.length > 1) {
             console.error(chalk_1.default.red('❌ Error: Only one review option can be specified at a time'));
             console.log(chalk_1.default.gray('   Options: --branch, --commit, --file, --folder, --files'));
             process.exit(1);
         }
-        // Check for explicit flags first (override auto-detection)
-        if (options.file) {
-            console.log(chalk_1.default.gray(`📝 Reading file: ${options.file}...`));
-            gitDiff = await (0, file_1.getFileContent)(repoRoot, options.file);
-        }
-        else if (options.folder) {
-            console.log(chalk_1.default.gray(`📝 Reading folder: ${options.folder}...`));
-            gitDiff = await (0, file_1.getFolderContent)(repoRoot, options.folder);
-        }
-        else if (options.files && options.files.length > 0) {
-            console.log(chalk_1.default.gray(`📝 Reading ${options.files.length} file(s)...`));
-            gitDiff = await (0, file_1.getMultipleFilesContent)(repoRoot, options.files);
-        }
-        else if (options.branch) {
-            console.log(chalk_1.default.gray(`📝 Collecting git changes for branch: ${options.branch}...`));
-            gitDiff = await (0, diff_1.getBranchDiff)(repoRoot, options.branch);
-            // Get repo/branch using environment-specific approach
-            if (environment === 'github') {
-                const gitContext = await (0, github_1.getGitHubContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email,
-                    prTitle: gitContext.prTitle
-                };
-            }
-            else if (environment === 'gitlab') {
-                const gitContext = await (0, gitlab_1.getGitLabContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email,
-                    prTitle: gitContext.prTitle
-                };
-            }
-            else if (environment === 'vercel') {
-                const gitContext = await (0, vercel_1.getVercelContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email
-                };
-            }
-            else {
-                const gitContext = await (0, local_1.getLocalContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email
-                };
-            }
-        }
-        else if (options.commit) {
-            console.log(chalk_1.default.gray(`📝 Collecting git changes for commit: ${options.commit}...`));
-            gitDiff = await (0, diff_1.getCommitDiff)(repoRoot, options.commit);
-            // Get repo/branch using environment-specific approach
-            if (environment === 'github') {
-                const gitContext = await (0, github_1.getGitHubContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email,
-                    prTitle: gitContext.prTitle
-                };
+        // CI environments: auto-detect only, flags are ignored with warning
+        // Local: full flag support for developer flexibility
+        if ((0, environment_1.isCIEnvironment)(environment)) {
+            // Warn if flags are passed in CI - they're meant for local development
+            if (explicitFlags.length > 0) {
+                const flagName = options.branch ? '--branch' :
+                    options.commit ? '--commit' :
+                        options.file ? '--file' :
+                            options.folder ? '--folder' : '--files';
+                console.log(chalk_1.default.yellow(`⚠️  Warning: ${flagName} flag ignored in CI environment. Using auto-detection.\n`));
             }
-            else if (environment === 'gitlab') {
-                const gitContext = await (0, gitlab_1.getGitLabContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email,
-                    prTitle: gitContext.prTitle
-                };
-            }
-            else if (environment === 'vercel') {
-                const gitContext = await (0, vercel_1.getVercelContext)(repoRoot);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email
-                };
-            }
-            else {
-                const gitContext = await (0, local_1.getLocalContext)(repoRoot, options.commit);
-                repoName = gitContext.repoName;
-                branchName = gitContext.branchName;
-                metadata = {
-                    commitSha: gitContext.commitSha,
-                    commitMessage: gitContext.commitMessage,
-                    commitAuthorName: gitContext.commitAuthor.name,
-                    commitAuthorEmail: gitContext.commitAuthor.email
-                };
-            }
-        }
-        else {
-            // Auto-detect: Use environment-specific context collection (completely isolated)
+            // CI auto-detect: use environment-specific context
             const envNames = {
                 vercel: 'Vercel',
-                github: 'GitHub',
-                gitlab: 'GitLab',
-                local: 'Local'
+                github: 'GitHub Actions',
+                gitlab: 'GitLab CI',
+                bitbucket: 'Bitbucket Pipelines'
             };
             console.log(chalk_1.default.gray(`📝 Collecting git context for ${envNames[environment]}...`));
-            // Get all context from environment-specific module
-            let envContext;
-            if (environment === 'github') {
-                envContext = await (0, github_1.getGitHubContext)(repoRoot);
-            }
-            else if (environment === 'gitlab') {
-                envContext = await (0, gitlab_1.getGitLabContext)(repoRoot);
-            }
-            else if (environment === 'vercel') {
-                envContext = await (0, vercel_1.getVercelContext)(repoRoot);
-            }
-            else {
-                envContext = await (0, local_1.getLocalContext)(repoRoot);
-            }
+            const envContext = await getContextForEnvironment(environment, repoRoot);
             gitDiff = envContext.diff;
             repoName = envContext.repoName;
             branchName = envContext.branchName;
-            // Use metadata from environment context
             metadata = {
                 commitSha: envContext.commitSha,
                 commitMessage: envContext.commitMessage,
@@ -283,6 +185,63 @@ async function checkCommand(options) {
                 prTitle: envContext.prTitle
             };
         }
+        else {
+            // Local environment: support all flags
+            if (options.file) {
+                console.log(chalk_1.default.gray(`📝 Reading file: ${options.file}...`));
+                gitDiff = await (0, file_1.getFileContent)(repoRoot, options.file);
+            }
+            else if (options.folder) {
+                console.log(chalk_1.default.gray(`📝 Reading folder: ${options.folder}...`));
+                gitDiff = await (0, file_1.getFolderContent)(repoRoot, options.folder);
+            }
+            else if (options.files && options.files.length > 0) {
+                console.log(chalk_1.default.gray(`📝 Reading ${options.files.length} file(s)...`));
+                gitDiff = await (0, file_1.getMultipleFilesContent)(repoRoot, options.files);
+            }
+            else if (options.branch) {
+                console.log(chalk_1.default.gray(`📝 Collecting git changes for branch: ${options.branch}...`));
+                gitDiff = await (0, diff_1.getBranchDiff)(repoRoot, options.branch);
+                // Use local context for metadata
+                const localContext = await (0, local_1.getLocalContext)(repoRoot);
+                repoName = localContext.repoName;
+                branchName = localContext.branchName;
+                metadata = {
+                    commitSha: localContext.commitSha,
+                    commitMessage: localContext.commitMessage,
+                    commitAuthorName: localContext.commitAuthor.name,
+                    commitAuthorEmail: localContext.commitAuthor.email
+                };
+            }
+            else if (options.commit) {
+                console.log(chalk_1.default.gray(`📝 Collecting git changes for commit: ${options.commit}...`));
+                gitDiff = await (0, diff_1.getCommitDiff)(repoRoot, options.commit);
+                // Use local context for metadata, passing commit SHA for author lookup
+                const localContext = await (0, local_1.getLocalContext)(repoRoot, options.commit);
+                repoName = localContext.repoName;
+                branchName = localContext.branchName;
+                metadata = {
+                    commitSha: localContext.commitSha,
+                    commitMessage: localContext.commitMessage,
+                    commitAuthorName: localContext.commitAuthor.name,
+                    commitAuthorEmail: localContext.commitAuthor.email
+                };
+            }
+            else {
+                // Local auto-detect: staged/unstaged changes
+                console.log(chalk_1.default.gray('📝 Collecting git context for Local...'));
+                const localContext = await (0, local_1.getLocalContext)(repoRoot);
+                gitDiff = localContext.diff;
+                repoName = localContext.repoName;
+                branchName = localContext.branchName;
+                metadata = {
+                    commitSha: localContext.commitSha,
+                    commitMessage: localContext.commitMessage,
+                    commitAuthorName: localContext.commitAuthor.name,
+                    commitAuthorEmail: localContext.commitAuthor.email
+                };
+            }
+        }
         if (gitDiff.changedFiles.length === 0) {
             console.error(chalk_1.default.bold('ℹ️ No changes detected.'));
             process.exit(0);

package/dist/git/bitbucket.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Bitbucket Pipelines Environment - Complete Isolation
+ *
+ * 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 child_process_1 = require("child_process");
+const diff_1 = require("./diff");
+/**
+ * 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 commitSha = getCommitSha();
+    // Get commit author (from git log - Bitbucket doesn't provide this as env var)
+    const commitAuthor = await 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
+    };
+}
+/**
+ * Get diff for Bitbucket Pipelines environment
+ *
+ * Bitbucket Pipelines with depth: full has full git history available,
+ * including origin/main. Unlike GitLab, no fetch is needed.
+ *
+ * Diff Strategy:
+ *
+ * | Scenario                  | Target Branch Known?                        | Diff Command                              |
+ * |---------------------------|---------------------------------------------|-------------------------------------------|
+ * | PR                        | ✅ Yes - BITBUCKET_PR_DESTINATION_BRANCH    | origin/${destination}...HEAD              |
+ * | Feature branch (no PR)    | ❌ No - detect main/master                  | origin/main...HEAD or origin/master...HEAD|
+ * | Push to default branch    | N/A                                         | HEAD~1...HEAD                             |
+ *
+ * Key point: For PRs, Bitbucket provides BITBUCKET_PR_DESTINATION_BRANCH - this is the
+ * most relevant comparison point because it's where the code will be merged.
+ *
+ * For non-PR feature branches, Bitbucket does NOT provide a default branch env var
+ * (unlike GitLab's CI_DEFAULT_BRANCH), so we detect by checking if origin/main or
+ * origin/master exists.
+ */
+async function getDiff(repoRoot) {
+    const git = (0, simple_git_1.default)(repoRoot);
+    const branchName = process.env.BITBUCKET_BRANCH;
+    const prId = process.env.BITBUCKET_PR_ID;
+    const prDestinationBranch = process.env.BITBUCKET_PR_DESTINATION_BRANCH;
+    // Scenario 1: PR context - use the target branch from env var
+    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.');
+        }
+        console.log(`  [Bitbucket] PR #${prId}, using origin/${prDestinationBranch}...HEAD`);
+        const diff = await git.diff([`origin/${prDestinationBranch}...HEAD`, '-U200']);
+        const diffSummary = await git.diffSummary([`origin/${prDestinationBranch}...HEAD`]);
+        const changedFiles = diffSummary.files.map(f => f.file);
+        return { diff: diff || '', changedFiles };
+    }
+    // Scenario 2: Non-PR push
+    if (!branchName) {
+        throw new Error('Bitbucket Pipelines: BITBUCKET_BRANCH environment variable is not set. ' +
+            'This should be automatically provided by Bitbucket Pipelines.');
+    }
+    // Detect the default branch (Bitbucket doesn't provide this as an env var)
+    const defaultBranch = await detectDefaultBranch(git);
+    // If we're on the default branch, just show the last commit
+    if (branchName === defaultBranch) {
+        console.log(`  [Bitbucket] Push to ${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 };
+    }
+    // Feature branch: compare against default branch
+    // This shows all changes the branch introduces, correctly excluding
+    // any commits merged in from the default branch
+    console.log(`  [Bitbucket] Feature branch "${branchName}", using origin/${defaultBranch}...HEAD`);
+    const diff = await git.diff([`origin/${defaultBranch}...HEAD`, '-U200']);
+    const diffSummary = await git.diffSummary([`origin/${defaultBranch}...HEAD`]);
+    const changedFiles = diffSummary.files.map(f => f.file);
+    return { diff: diff || '', changedFiles };
+}
+/**
+ * Detect the default branch for Bitbucket Pipelines.
+ *
+ * Bitbucket does NOT provide a default branch env var (unlike GitLab's CI_DEFAULT_BRANCH
+ * or GitHub's repository.default_branch in the event JSON).
+ *
+ * We try 'main' first (most common), then 'master' as fallback.
+ * This covers the vast majority of repositories.
+ *
+ * ---
+ * Design Decision: We compare against main instead of just checking the last commit
+ *
+ * Threadlines assumes that feature branches are intended to eventually merge to the
+ * default branch. Comparing against main shows ALL changes the branch introduces,
+ * which is what you want to review before merging.
+ *
+ * Per-commit checking happens during local development.
+ * ---
+ */
+async function detectDefaultBranch(git) {
+    // Try 'main' first (modern default)
+    try {
+        await git.revparse(['--verify', 'origin/main']);
+        return 'main';
+    }
+    catch {
+        // origin/main doesn't exist, try master
+    }
+    // Try 'master' (legacy default)
+    try {
+        await git.revparse(['--verify', 'origin/master']);
+        return 'master';
+    }
+    catch {
+        // origin/master doesn't exist either
+    }
+    throw new Error('Bitbucket Pipelines: Cannot determine default branch. ' +
+        'Neither origin/main nor origin/master found. ' +
+        'For repositories with a different default branch, create a PR to trigger branch comparison.');
+}
+/**
+ * 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, branch, or 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
+        };
+    }
+    // Branch context
+    if (process.env.BITBUCKET_BRANCH) {
+        return {
+            type: 'branch',
+            branchName: process.env.BITBUCKET_BRANCH
+        };
+    }
+    // Commit context
+    if (process.env.BITBUCKET_COMMIT) {
+        return {
+            type: 'commit',
+            commitSha: process.env.BITBUCKET_COMMIT
+        };
+    }
+    // Fallback to local (shouldn't happen in Bitbucket Pipelines)
+    return { type: 'local' };
+}
+/**
+ * Gets commit SHA from Bitbucket environment
+ */
+function getCommitSha() {
+    return process.env.BITBUCKET_COMMIT;
+}
+/**
+ * Gets commit author for Bitbucket Pipelines
+ *
+ * Bitbucket doesn't provide commit author as an environment variable,
+ * so we use git log to get it.
+ *
+ * This approach is verified by our test script (test-bitbucket-context.ts)
+ * which successfully retrieves commit author in all scenarios:
+ * - Direct commit to main
+ * - Feature branch push
+ * - PR pipeline
+ * - Merge commit
+ */
+async function getCommitAuthor(repoRoot) {
+    // Use raw git commands - this is exactly what the test script uses and we know it works
+    try {
+        const name = (0, child_process_1.execSync)('git log -1 --format=%an', { encoding: 'utf-8', cwd: repoRoot }).trim();
+        const email = (0, child_process_1.execSync)('git log -1 --format=%ae', { encoding: 'utf-8', cwd: repoRoot }).trim();
+        if (!name || !email) {
+            throw new Error('git log returned empty name or email');
+        }
+        return { name, email };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Bitbucket Pipelines: Failed to get commit author from git log. ` +
+            `Error: ${errorMessage}`);
+    }
+}

package/dist/git/repo.js

@@ -213,7 +213,7 @@ async function getGitLabBranchName(_repoRoot) {
  * Uses GITHUB_EVENT_PATH JSON (repository.default_branch) - the most authoritative source
  * provided directly by GitHub Actions.
  *
- * This function is ONLY called from GitHub Actions context (getGitHubDiff),
+ * This function is ONLY called from GitHub Actions context (github.ts),
  * so GITHUB_EVENT_PATH should always be available. If it's not, we fail with a clear error.
  *
  * Returns the branch name (e.g., "main", "master") without the "origin/" prefix.

package/dist/types/git.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Git-related type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/context.js

@@ -25,6 +25,8 @@ function detectContext(environment) {
             return detectGitHubContext();
         case 'gitlab':
             return detectGitLabContext();
+        case 'bitbucket':
+            return detectBitbucketContext();
         case 'vercel':
             return detectVercelContext();
         case 'local':
@@ -146,3 +148,43 @@ function detectVercelContext() {
     // Fallback to local
     return { type: 'local' };
 }
+/**
+ * Bitbucket Pipelines context detection
+ *
+ * Environment Variables (all tested 2026-01-18):
+ * - Branch: BITBUCKET_BRANCH
+ * - Commit: BITBUCKET_COMMIT
+ * - PR: BITBUCKET_PR_ID, BITBUCKET_PR_DESTINATION_BRANCH
+ *
+ * Note: Bitbucket does not provide PR title as an environment variable.
+ */
+function detectBitbucketContext() {
+    // 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
+        };
+    }
+    // Branch context
+    if (process.env.BITBUCKET_BRANCH) {
+        return {
+            type: 'branch',
+            branchName: process.env.BITBUCKET_BRANCH
+        };
+    }
+    // Commit context
+    if (process.env.BITBUCKET_COMMIT) {
+        return {
+            type: 'commit',
+            commitSha: process.env.BITBUCKET_COMMIT
+        };
+    }
+    // Fallback to local
+    return { type: 'local' };
+}

package/dist/utils/environment.js

@@ -15,7 +15,8 @@ exports.isCIEnvironment = isCIEnvironment;
  * 1. Vercel: VERCEL=1
  * 2. GitHub Actions: GITHUB_ACTIONS=1
  * 3. GitLab CI: GITLAB_CI=1 or (CI=1 + CI_COMMIT_SHA)
- * 4. Local: None of the above
+ * 4. Bitbucket Pipelines: BITBUCKET_BUILD_NUMBER exists
+ * 5. Local: None of the above
  */
 function detectEnvironment() {
     if (process.env.VERCEL)
@@ -24,6 +25,8 @@ function detectEnvironment() {
         return 'github';
     if (process.env.GITLAB_CI || (process.env.CI && process.env.CI_COMMIT_SHA))
         return 'gitlab';
+    if (process.env.BITBUCKET_BUILD_NUMBER)
+        return 'bitbucket';
     return 'local';
 }
 /**

package/package.json

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