linear-github-cli 1.2.1 → 1.3.2

package/README.md

@@ -301,7 +301,7 @@ gh prms      # Merge with squash and delete branch
 ### Workflow Overview
 
 1. **Create issue** - Use `lg parent/sub` command
-2. **Create branch** - Include issue number (e.g., `feat/LEA-123-task`)
+2. **Create branch** - Include issue number (e.g., `username/LEA-123-task`)
 3. **Create draft PR** - Right after branch creation, before work begins
    - Include Linear issue ID in title (copy with `Cmd + .` in Linear)
    - Include `solve: #123` or `Closes #123` in body

package/dist/branch-utils.js

@@ -1,37 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sanitizeBranchName = sanitizeBranchName;
-exports.selectBranchPrefix = selectBranchPrefix;
 exports.generateBranchName = generateBranchName;
 exports.extractLinearIssueId = extractLinearIssueId;
 exports.extractBranchPrefix = extractBranchPrefix;
 exports.checkUnpushedCommitsOnCurrentBranch = checkUnpushedCommitsOnCurrentBranch;
 exports.createGitBranch = createGitBranch;
 const child_process_1 = require("child_process");
-const inquirer_1 = __importDefault(require("inquirer"));
 /**
  * Valid branch prefix types (must match commit_typed.sh)
  */
 const VALID_BRANCH_PREFIXES = ['feat', 'fix', 'chore', 'docs', 'refactor', 'test', 'research'];
-/**
- * Maps GitHub labels to branch prefix types
- * Since GitHub labels are already updated to match the standard list,
- * labels should directly map to branch prefixes.
- * @param label - GitHub label name (should be one of: feat, fix, chore, docs, refactor, test, research)
- * @returns Branch prefix (same as label if valid, otherwise returns label as-is)
- */
-function mapLabelToBranchPrefix(label) {
-    const labelLower = label.toLowerCase();
-    // If label is already a valid branch prefix, return it as-is
-    if (VALID_BRANCH_PREFIXES.includes(labelLower)) {
-        return labelLower;
-    }
-    // Fallback: return label as-is (shouldn't happen if labels are properly configured)
-    return labelLower;
-}
 /**
  * Sanitizes a title string to be used as part of a git branch name
  * - Converts to lowercase
@@ -65,88 +44,49 @@ function sanitizeBranchName(title) {
     return sanitized;
 }
 /**
- * Standard branch prefix options when no labels are available
- */
-const STANDARD_PREFIXES = [
-    { name: 'feat', value: 'feat' },
-    { name: 'fix', value: 'fix' },
-    { name: 'chore', value: 'chore' },
-    { name: 'docs', value: 'docs' },
-    { name: 'refactor', value: 'refactor' },
-    { name: 'test', value: 'test' },
-    { name: 'research', value: 'research' },
-];
-/**
- * Selects a branch prefix from GitHub labels
- * - If no labels: prompts user to select from standard prefixes
- * - If one label: maps and returns branch prefix
- * - If multiple labels: prompts user to select one
+ * Sanitizes a branch owner (username) to be used in a git branch name.
+ * - Converts to lowercase
+ * - Removes special characters (keeps alphanumeric and hyphens)
+ * - Collapses multiple consecutive hyphens
+ * - Removes leading/trailing hyphens
  *
- * @param labels - Array of GitHub label names
- * @returns Branch prefix string or null if user cancels
+ * @param owner - The branch owner to sanitize
+ * @returns Sanitized branch owner portion
  */
-async function selectBranchPrefix(labels) {
-    // Map all labels to branch prefixes
-    const mappedPrefixes = labels && labels.length > 0
-        ? labels.map(label => ({
-            label,
-            prefix: mapLabelToBranchPrefix(label),
-        }))
-        : [];
-    // If no labels: prompt user to select from standard prefixes
-    if (mappedPrefixes.length === 0) {
-        const { selectedPrefix } = await inquirer_1.default.prompt([
-            {
-                type: 'list',
-                name: 'selectedPrefix',
-                message: 'Select branch prefix (no labels selected):',
-                choices: STANDARD_PREFIXES,
-            },
-        ]);
-        return selectedPrefix;
-    }
-    // If only one label, return its mapped prefix
-    if (mappedPrefixes.length === 1) {
-        return mappedPrefixes[0].prefix;
+function sanitizeBranchOwner(owner) {
+    if (!owner || owner.trim().length === 0) {
+        return '';
     }
-    // Multiple labels: prompt user to select
-    const choices = mappedPrefixes.map(({ label, prefix }) => ({
-        name: `${label} → ${prefix}`,
-        value: prefix,
-    }));
-    const { selectedPrefix } = await inquirer_1.default.prompt([
-        {
-            type: 'list',
-            name: 'selectedPrefix',
-            message: 'Select branch prefix (multiple labels selected):',
-            choices,
-        },
-    ]);
-    return selectedPrefix;
+    let sanitized = owner.toLowerCase().replace(/[^a-z0-9-]/g, '');
+    sanitized = sanitized.replace(/-+/g, '-');
+    sanitized = sanitized.replace(/^-+|-+$/g, '');
+    return sanitized;
 }
 /**
- * Generates a branch name from prefix, Linear ID, and title
- * Format: prefix/LinearID-sanitized-title
+ * Generates a branch name from owner, Linear ID, and title
+ * Format: owner/LinearID-sanitized-title
  *
- * @param prefix - Branch prefix (e.g., 'feat', 'docs')
+ * @param owner - Branch owner (e.g., GitHub username)
  * @param linearId - Linear issue ID (e.g., 'LEA-123')
  * @param title - Issue title to sanitize
  * @returns Full branch name
  */
-function generateBranchName(prefix, linearId, title) {
+function generateBranchName(owner, linearId, title) {
+    const sanitizedOwner = sanitizeBranchOwner(owner);
     const sanitizedTitle = sanitizeBranchName(title);
+    const ownerSegment = sanitizedOwner || 'user';
     if (!sanitizedTitle) {
-        // If title is empty after sanitization, just use prefix and ID
-        return `${prefix}/${linearId}`;
+        // If title is empty after sanitization, just use owner and ID
+        return `${ownerSegment}/${linearId}`;
     }
-    return `${prefix}/${linearId}-${sanitizedTitle}`;
+    return `${ownerSegment}/${linearId}-${sanitizedTitle}`;
 }
 /**
  * Extracts Linear issue ID from a branch name
- * - Matches pattern: prefix/LEA-123-title or prefix/LEA-123
+ * - Matches pattern: owner/LEA-123-title or owner/LEA-123
  * - Uses regex to find Linear issue ID format: [A-Z]+-\d+
  *
- * @param branchName - Branch name (e.g., 'feat/LEA-123-implement-login')
+ * @param branchName - Branch name (e.g., 'negoth/LEA-123-implement-login')
  * @returns Linear issue ID (e.g., 'LEA-123') or null if not found
  */
 function extractLinearIssueId(branchName) {
@@ -161,27 +101,25 @@ function extractLinearIssueId(branchName) {
  * Extracts branch prefix (commit type) from a branch name
  * - Extracts the part before the first '/' (e.g., 'research' from 'research/LEA-75-probit-model')
  * - Validates against VALID_BRANCH_PREFIXES
- * - Returns 'feat' as default if prefix is not found or invalid
  *
  * @param branchName - Branch name (e.g., 'research/LEA-75-probit-model')
- * @returns Branch prefix (e.g., 'research') or 'feat' as default
+ * @returns Branch prefix (e.g., 'research') or null if not found/invalid
  */
 function extractBranchPrefix(branchName) {
     if (!branchName || branchName.trim().length === 0) {
-        return 'feat';
+        return null;
     }
     // Extract prefix before first '/'
     const parts = branchName.split('/');
     if (parts.length === 0 || !parts[0]) {
-        return 'feat';
+        return null;
     }
     const prefix = parts[0].toLowerCase();
     // Validate against valid prefixes
     if (VALID_BRANCH_PREFIXES.includes(prefix)) {
         return prefix;
     }
-    // Return 'feat' as default if prefix is invalid
-    return 'feat';
+    return null;
 }
 /**
  * Checks for unpushed commits on the current branch

package/dist/cli.js

@@ -13,9 +13,16 @@ const create_sub_1 = require("./commands/create-sub");
 const env_utils_1 = require("./env-utils");
 // Load .env file from current working directory, parent directories, or home directory
 (0, env_utils_1.loadEnvFile)();
-// Check for updates
-const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.resolve)(__dirname, '..', 'package.json'), 'utf-8'));
-(0, update_notifier_1.default)({ pkg }).notify();
+// Check for updates (support both dev and built paths)
+const pkgPathCandidates = [
+    (0, path_1.resolve)(__dirname, 'package.json'),
+    (0, path_1.resolve)(__dirname, '..', 'package.json'),
+];
+const pkgPath = pkgPathCandidates.find(candidate => (0, fs_1.existsSync)(candidate));
+if (pkgPath) {
+    const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+    (0, update_notifier_1.default)({ pkg }).notify();
+}
 const program = new commander_1.Command();
 program
     .name('lg')

package/dist/commands/commit-first.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.commitFirst = commitFirst;
 const child_process_1 = require("child_process");
+const inquirer_1 = __importDefault(require("inquirer"));
 const branch_utils_1 = require("../branch-utils");
 const linear_client_1 = require("../linear-client");
 const env_utils_1 = require("../env-utils");
@@ -37,14 +41,25 @@ async function commitFirst() {
             console.error('❌ Error: Not in a git repository or unable to get branch name');
             process.exit(1);
         }
-        // Step 2: Extract branch prefix and Linear issue ID from branch name
-        const prefix = (0, branch_utils_1.extractBranchPrefix)(branchName);
+        // Step 2: Extract branch prefix (if any) and Linear issue ID from branch name
+        let prefix = (0, branch_utils_1.extractBranchPrefix)(branchName);
         const linearId = (0, branch_utils_1.extractLinearIssueId)(branchName);
         if (!linearId) {
             console.error(`❌ Error: Could not extract Linear issue ID from branch name: ${branchName}`);
-            console.error('   Branch name should follow pattern: prefix/LEA-123-title');
+            console.error('   Branch name should follow pattern: username/LEA-123-title');
             process.exit(1);
         }
+        if (!prefix) {
+            const { selectedPrefix } = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'selectedPrefix',
+                    message: 'Select commit type:',
+                    choices: ['feat', 'fix', 'chore', 'docs', 'refactor', 'test', 'research'],
+                },
+            ]);
+            prefix = selectedPrefix;
+        }
         console.log(`📋 Found Linear issue ID: ${linearId}`);
         console.log(`📋 Using commit type: ${prefix}`);
         // Step 3: Initialize Linear client and fetch issue data

package/dist/commands/create-parent.js

@@ -83,22 +83,30 @@ async function createParentIssue() {
     });
     if (linearIssueId) {
         console.log('✅ Found Linear issue, updating metadata...');
-        // Auto-find Linear project if GitHub project was selected
+        // Auto-find/create Linear project if GitHub project was selected
         let linearProjectId = null;
+        let linearProjectName = null;
         if (githubProject) {
             console.log(`   Looking for Linear project matching "${githubProject}"...`);
             linearProjectId = await linearClient.findProjectByName(githubProject);
             if (linearProjectId) {
+                linearProjectName = githubProject;
                 console.log(`   ✅ Found matching Linear project: ${githubProject}`);
             }
             else {
-                console.log(`   ⚠️  No matching Linear project found. You can set it manually.`);
+                console.log(`   ⚠️  No matching Linear project found. Creating "${githubProject}"...`);
+                const teamId = await linearClient.getIssueTeamId(linearIssueId);
+                const createdProject = await linearClient.createProject(githubProject, teamId || undefined);
+                if (createdProject) {
+                    linearProjectId = createdProject.id;
+                    linearProjectName = createdProject.name;
+                    console.log(`   ✅ Created Linear project: ${createdProject.name}`);
+                }
+                else {
+                    console.log(`   ⚠️  Failed to create Linear project. You can set it manually.`);
+                }
             }
         }
-        // If no auto-match, ask user (only if GitHub project wasn't selected)
-        if (!linearProjectId && !githubProject) {
-            linearProjectId = await inputHandler.selectLinearProject();
-        }
         // Set labels on Linear issue
         if (details.labels && details.labels.length > 0) {
             console.log(`   Setting labels: ${details.labels.join(', ')}`);
@@ -115,7 +123,7 @@ async function createParentIssue() {
         if (success) {
             console.log('✅ Linear issue metadata updated!');
             if (linearProjectId) {
-                console.log(`   Project: ${githubProject || 'selected project'}`);
+                console.log(`   Project: ${linearProjectName || githubProject || 'linked'}`);
             }
             if (details.dueDate) {
                 console.log(`   Due date: ${details.dueDate}`);
@@ -144,18 +152,22 @@ async function createParentIssue() {
                     console.log(`   GitHub issue #${issue.number}`);
                 }
                 else {
-                    const branchPrefix = await (0, branch_utils_1.selectBranchPrefix)(details.labels);
-                    if (branchPrefix) {
-                        const branchName = (0, branch_utils_1.generateBranchName)(branchPrefix, linearIssueIdentifier, details.title);
-                        const success = await (0, branch_utils_1.createGitBranch)(branchName);
-                        if (success) {
-                            console.log(`✅ Branch created: ${branchName}`);
-                            console.log(`   Linear issue ID: ${linearIssueIdentifier}`);
-                            console.log(`   GitHub issue #${issue.number}`);
-                        }
+                    let branchOwner = await githubClient.getCurrentUsername();
+                    if (!branchOwner) {
+                        const { ownerInput } = await inquirer_1.default.prompt([
+                            {
+                                type: 'input',
+                                name: 'ownerInput',
+                                message: 'Branch username for naming (e.g., your GitHub login):',
+                                validate: (input) => input.trim().length > 0 || 'Username is required',
+                            },
+                        ]);
+                        branchOwner = ownerInput.trim();
                     }
-                    else {
-                        console.log('⚠️  No suitable label found for branch prefix. Branch creation skipped.');
+                    const branchName = (0, branch_utils_1.generateBranchName)(branchOwner ?? 'user', linearIssueIdentifier, details.title);
+                    const success = await (0, branch_utils_1.createGitBranch)(branchName);
+                    if (success) {
+                        console.log(`✅ Branch created: ${branchName}`);
                         console.log(`   Linear issue ID: ${linearIssueIdentifier}`);
                         console.log(`   GitHub issue #${issue.number}`);
                     }

package/dist/commands/create-sub.js

@@ -110,10 +110,7 @@ async function createSubIssue() {
         else {
             console.log(`   ⚠️  Parent Linear issue not found yet (may need more time to sync)`);
         }
-        // If no parent project, ask user (only if no parent project found)
-        if (!linearProjectId) {
-            linearProjectId = await inputHandler.selectLinearProject();
-        }
+        // If no parent project, leave project unset (no prompt)
         // Set labels on Linear issue
         if (details.labels && details.labels.length > 0) {
             console.log(`   Setting labels: ${details.labels.join(', ')}`);
@@ -172,18 +169,22 @@ async function createSubIssue() {
                     console.log(`   GitHub issue #${subIssue.number}`);
                 }
                 else {
-                    const branchPrefix = await (0, branch_utils_1.selectBranchPrefix)(details.labels);
-                    if (branchPrefix) {
-                        const branchName = (0, branch_utils_1.generateBranchName)(branchPrefix, linearIssueIdentifier, details.title);
-                        const success = await (0, branch_utils_1.createGitBranch)(branchName);
-                        if (success) {
-                            console.log(`✅ Branch created: ${branchName}`);
-                            console.log(`   Linear issue ID: ${linearIssueIdentifier}`);
-                            console.log(`   GitHub issue #${subIssue.number}`);
-                        }
+                    let branchOwner = await githubClient.getCurrentUsername();
+                    if (!branchOwner) {
+                        const { ownerInput } = await inquirer_1.default.prompt([
+                            {
+                                type: 'input',
+                                name: 'ownerInput',
+                                message: 'Branch username for naming (e.g., your GitHub login):',
+                                validate: (input) => input.trim().length > 0 || 'Username is required',
+                            },
+                        ]);
+                        branchOwner = ownerInput.trim();
                     }
-                    else {
-                        console.log('⚠️  No suitable label found for branch prefix. Branch creation skipped.');
+                    const branchName = (0, branch_utils_1.generateBranchName)(branchOwner ?? 'user', linearIssueIdentifier, details.title);
+                    const success = await (0, branch_utils_1.createGitBranch)(branchName);
+                    if (success) {
+                        console.log(`✅ Branch created: ${branchName}`);
                         console.log(`   Linear issue ID: ${linearIssueIdentifier}`);
                         console.log(`   GitHub issue #${subIssue.number}`);
                     }

package/dist/env-utils.js

@@ -14,6 +14,22 @@ const os_1 = require("os");
  * - Installed globally (user can create .env in their project or home directory)
  * - Installed locally (works with project's .env file)
  */
+function hasLinearApiKey(envPath) {
+    const contents = (0, fs_1.readFileSync)(envPath, 'utf-8');
+    const match = contents.match(/^\s*LINEAR_API_KEY\s*=\s*(.+)\s*$/m);
+    if (!match) {
+        return false;
+    }
+    const rawValue = match[1].trim();
+    const unquoted = rawValue.replace(/^['"]|['"]$/g, '').trim();
+    return unquoted.length > 0;
+}
+function exitMissingLinearApiKey() {
+    console.error('❌ LINEAR_API_KEY not found in .env');
+    console.error('   Add it to your .env file:');
+    console.error('     echo "LINEAR_API_KEY=lin_api_..." > .env');
+    process.exit(1);
+}
 function loadEnvFile() {
     // First, try to find .env in current working directory and parent directories
     let currentDir = process.cwd();
@@ -21,6 +37,10 @@ function loadEnvFile() {
     while (currentDir !== root) {
         const envPath = (0, path_1.resolve)(currentDir, '.env');
         if ((0, fs_1.existsSync)(envPath)) {
+            if (!hasLinearApiKey(envPath)) {
+                exitMissingLinearApiKey();
+            }
+            console.log(`✅ LINEAR_API_KEY found in ${envPath}`);
             (0, dotenv_1.config)({ path: envPath });
             return;
         }
@@ -34,10 +54,12 @@ function loadEnvFile() {
     // Fallback: try home directory
     const homeEnvPath = (0, path_1.resolve)((0, os_1.homedir)(), '.env');
     if ((0, fs_1.existsSync)(homeEnvPath)) {
+        if (!hasLinearApiKey(homeEnvPath)) {
+            exitMissingLinearApiKey();
+        }
+        console.log(`✅ LINEAR_API_KEY found in ${homeEnvPath}`);
         (0, dotenv_1.config)({ path: homeEnvPath });
         return;
     }
-    // If no .env file found, dotenv will use environment variables
-    // This is fine - we don't need to throw an error here
-    (0, dotenv_1.config)();
+    exitMissingLinearApiKey();
 }

package/dist/github-client.js

@@ -12,6 +12,18 @@ class GitHubClientWrapper {
             this.octokit = new rest_1.Octokit({ auth: token });
         }
     }
+    async getCurrentUsername() {
+        try {
+            const output = (0, child_process_1.execSync)('gh api user -q .login', {
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            }).trim();
+            return output || null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
     async getRepositories() {
         // Use gh CLI to get accessible repos
         const output = (0, child_process_1.execSync)('gh repo list --limit 100 --json nameWithOwner', {

package/dist/input-handler.js

@@ -187,11 +187,8 @@ class InputHandler {
             {
                 type: 'checkbox',
                 name: 'labels',
-                message: 'Select GitHub labels (at least one required):',
+                message: 'Select GitHub labels (optional):',
                 choices: labelChoices,
-                validate: (input) => {
-                    return input.length > 0 || 'At least one label is required';
-                },
             },
         ]);
         let description = '';

package/dist/linear-client.js

@@ -28,6 +28,41 @@ class LinearClientWrapper {
             return project?.id || null;
         }
     }
+    async createProject(projectName, teamId) {
+        try {
+            const mutation = `mutation CreateProject($input: ProjectCreateInput!) {
+        projectCreate(input: $input) {
+          success
+          project { id name }
+        }
+      }`;
+            const input = { name: projectName };
+            if (teamId) {
+                input.teamIds = [teamId];
+            }
+            const response = await fetch('https://api.linear.app/graphql', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': linearApiKey,
+                },
+                body: JSON.stringify({
+                    query: mutation,
+                    variables: { input },
+                }),
+            });
+            const result = await response.json();
+            if (result.errors || !result.data?.projectCreate?.success) {
+                console.error(`❌ Failed to create project "${projectName}":`, result.errors);
+                return null;
+            }
+            return result.data.projectCreate.project ?? null;
+        }
+        catch (error) {
+            console.error(`❌ Error creating project "${projectName}":`, error);
+            return null;
+        }
+    }
     async getWorkflowStates(teamId) {
         try {
             // Get workflow states from teams

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linear-github-cli",
-  "version": "1.2.1",
+  "version": "1.3.2",
   "description": "CLI tool for creating GitHub issues with Linear integration",
   "main": "dist/cli.js",
   "bin": {