get-lem-ai 1.0.0

package/bin/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+'use strict';
+
+const { program } = require('commander');
+const { setup } = require('../src/setup');
+const { install, uninstall } = require('../src/install');
+const { checkout } = require('../src/checkout');
+
+program
+  .name('lem-ai')
+  .description('lem-ai — generate Implementation.md on branch creation')
+  .version('1.0.0');
+
+program.command('setup').description('Configure webhook URL').action(setup);
+program.command('install').description('Install git hook into current repo').action(install);
+program.command('uninstall').description('Remove git hook from current repo').action(uninstall);
+program.command('checkout <branchName>').description('Internal: called by git hook').action(checkout);
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "get-lem-ai",
+  "version": "1.0.0",
+  "description": "lem-ai — Automate Implementation.md generation from Jira tickets on branch creation",
+  "main": "src/index.js",
+  "bin": {
+    "get-lem-ai": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "keywords": [
+    "git",
+    "hook",
+    "jira",
+    "lem-ai",
+    "automation"
+  ],
+  "author": "lem-ai",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.15.1",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.3",
+    "ora": "^5.4.1"
+  }
+}

package/src/checkout.js

@@ -0,0 +1,93 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const axios = require('axios');
+const chalk = require('chalk');
+const { spawn } = require('child_process');
+const { loadConfig, findGitRoot, WEBHOOK_URL } = require('./config');
+
+function extractTicketId(branchName) {
+  const match = branchName.match(/([A-Z][A-Z0-9]+-\d+)/i);
+  return match ? match[1].toUpperCase() : null;
+}
+
+async function checkout(branchName) {
+  const config = loadConfig();
+
+  if (!config) {
+    console.log(chalk.yellow('\n⚠️  Not configured. Run: lem-ai setup\n'));
+    return;
+  }
+
+  // ────────────────────────────────────────────────────────────
+  // PHASE 1: Main Process — Spawn Background Worker & Exit
+  // ────────────────────────────────────────────────────────────
+  if (!process.env.LEMAI_BG) {
+    console.log(chalk.cyan(`\n[lem-ai] 🚀 Branch detected: ${chalk.bold(branchName)}`));
+    console.log(chalk.gray(`[lem-ai] ⚡ Generating Implementation.md in background...`));
+    console.log(chalk.gray(`[lem-ai] 🏁 Git checkout will proceed instantly.\n`));
+
+    const gitRoot = findGitRoot(process.cwd()) || process.cwd();
+    const logPath = path.join(gitRoot, '.lem-ai.log');
+
+    // Open log file for background process
+    const out = fs.openSync(logPath, 'a');
+    const err = fs.openSync(logPath, 'a');
+
+    // Spawn this same CLI command but with LEMAI_BG=true
+    const child = spawn(process.argv[0], [process.argv[1], 'checkout', branchName], {
+      detached: true,
+      stdio: ['ignore', out, err],
+      env: { ...process.env, LEMAI_BG: 'true' },
+      cwd: process.cwd()
+    });
+
+    child.unref();
+    process.exit(0);
+  }
+
+  // ────────────────────────────────────────────────────────────
+  // PHASE 2: Background Process — Do the heavy lifting
+  // ────────────────────────────────────────────────────────────
+  const ticketId = extractTicketId(branchName);
+  const startTime = new Date().toISOString();
+
+  const gitRoot = findGitRoot(process.cwd()) || process.cwd();
+  const logPath = path.join(gitRoot, '.lem-ai.log');
+
+  const log = (msg) => {
+    fs.appendFileSync(logPath, `[${new Date().toISOString()}] ${msg}\n`);
+  };
+
+  log(`Starting background sync for ${branchName}...`);
+
+  const headers = { 'Content-Type': 'application/json' };
+  if (config.secret) headers['Authorization'] = `Bearer ${config.secret}`;
+  if (config.apiKey) headers['x-sdk-key'] = config.apiKey;
+
+  // Fire and Forget: Start the request without blocking the main flow
+  axios.post(
+    WEBHOOK_URL,
+    { branchName, ticketId, timestamp: startTime },
+    { headers, timeout: 300000 }
+  ).then(response => {
+    const { markdown } = response.data;
+
+    if (markdown) {
+      const outputPath = path.join(gitRoot, config.outputFile || 'Implementation.md');
+      fs.writeFileSync(outputPath, markdown, 'utf-8');
+      log(`✅ Implementation.md generated successfully.`);
+    } else {
+      log(`ℹ️ No markdown generated by backend.`);
+    }
+    process.exit(0);
+  }).catch(err => {
+    log(`❌ Error: ${err.message}`);
+    if (err.response) {
+      log(`Backend error ${err.response.status}: ${JSON.stringify(err.response.data)}`);
+    }
+    process.exit(1);
+  });
+}
+
+module.exports = { checkout };

package/src/config.js

@@ -0,0 +1,35 @@
+'use strict';
+const fs   = require('fs');
+const path = require('path');
+
+function findGitRoot(dir) {
+  if (fs.existsSync(path.join(dir, '.git'))) return dir;
+  const parent = path.dirname(dir);
+  if (parent === dir) return null;
+  return findGitRoot(parent);
+}
+
+function getConfigPath() {
+  const repoRoot = findGitRoot(process.cwd());
+  if (!repoRoot) return null;
+  return path.join(repoRoot, '.lem-ai.json');
+}
+
+function loadConfig() {
+  const configPath = getConfigPath();
+  if (!configPath || !fs.existsSync(configPath)) return null;
+  try { return JSON.parse(fs.readFileSync(configPath, 'utf-8')); }
+  catch { return null; }
+}
+
+function saveConfig(data) {
+  const configPath = getConfigPath();
+  if (!configPath) {
+    throw new Error('Not inside a git repository. Cannot save project-level config.');
+  }
+  fs.writeFileSync(configPath, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+const WEBHOOK_URL = 'https://api.getlem.ai/api/v1/webhooks/lem';
+
+module.exports = { loadConfig, saveConfig, getConfigPath, findGitRoot, WEBHOOK_URL };

package/src/index.js

@@ -0,0 +1,7 @@
+'use strict';
+module.exports = {
+  ...require('./checkout'),
+  ...require('./config'),
+  ...require('./install'),
+  ...require('./setup'),
+};

package/src/install.js

@@ -0,0 +1,103 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { findGitRoot, getConfigPath } = require('./config');
+
+const HOOK_SCRIPT = `#!/bin/sh
+# Injected by lem-ai
+# This hook captures all branch creation events (git branch, git checkout -b, git switch -c)
+if [ "$1" = "committed" ]; then
+    while read -r old_rev new_rev ref_name; do
+        # Check if it's a brand new local branch (old_rev is all zeros)
+        if [ "$old_rev" = "0000000000000000000000000000000000000000" ] && [ "\${ref_name#refs/heads/}" != "$ref_name" ] && [ "$new_rev" != "0000000000000000000000000000000000000000" ]; then
+            BRANCH_NAME=\${ref_name#refs/heads/}
+            # Run synchronously since we fixed the Node hang issue
+            lem-ai checkout "$BRANCH_NAME"
+        fi
+    done
+fi
+`;
+
+async function install() {
+  const { loadConfig } = require('./config');
+  const { setup } = require('./setup');
+  const config = loadConfig();
+
+  // If config is missing or the new apiKey field is missing, force setup
+  if (!config || !config.apiKey) {
+    console.log(chalk.yellow('⚠️   Configuration missing or outdated. Starting setup...'));
+    await setup();
+  }
+
+  const repoRoot = findGitRoot(process.cwd());
+  if (!repoRoot) {
+    console.error(chalk.red('❌  Not inside a git repository.'));
+    process.exit(1);
+  }
+
+  const hooksDir = path.join(repoRoot, '.git', 'hooks');
+  const hookPath = path.join(hooksDir, 'reference-transaction');
+
+  // Clean up ALL legacy hooks
+  const oldHooks = ['post-checkout', 'reference-transaction'];
+  for (const h of oldHooks) {
+    const p = path.join(hooksDir, h);
+    if (fs.existsSync(p)) {
+      const content = fs.readFileSync(p, 'utf-8');
+      if (content.includes('git-jira-hook') || content.includes('getlem') || content.includes('lem')) {
+        if (h === 'reference-transaction' && content.includes('Injected by lem-ai')) {
+          // This is current, skip
+          continue;
+        }
+        fs.unlinkSync(p);
+        console.log(chalk.gray(`ℹ️  Cleaned up legacy hook: ${h}`));
+      }
+    }
+  }
+
+  if (!fs.existsSync(hooksDir)) fs.mkdirSync(hooksDir, { recursive: true });
+
+  if (fs.existsSync(hookPath)) {
+    fs.copyFileSync(hookPath, hookPath + '.backup');
+    console.log(chalk.yellow('⚠️   Existing hook backed up'));
+  }
+
+  fs.writeFileSync(hookPath, HOOK_SCRIPT, { mode: 0o755 });
+  console.log(chalk.green(`\n✅  Ref-Transaction Hook installed/updated → ${hookPath}`));
+  console.log(chalk.cyan('🎉  This will now trigger on ANY branch creation method:'));
+  console.log(chalk.gray('    - git branch <name>'));
+  console.log(chalk.gray('    - git checkout -b <name>'));
+  console.log(chalk.gray('    - git switch -c <name>\n'));
+}
+
+function uninstall() {
+  const repoRoot = findGitRoot(process.cwd());
+  if (!repoRoot) {
+    console.error(chalk.red('❌  Not inside a git repository.'));
+    process.exit(1);
+  }
+
+  const hookPath = path.join(repoRoot, '.git', 'hooks', 'reference-transaction');
+
+  if (fs.existsSync(hookPath)) {
+    const content = fs.readFileSync(hookPath, 'utf-8');
+    if (content.includes('lem-ai') || content.includes('getlem') || content.includes('lem') || content.includes('git-jira-hook')) {
+      fs.unlinkSync(hookPath);
+      console.log(chalk.green('\n✅  lem-ai Git Hook uninstalled successfully.\n'));
+    } else {
+      console.log(chalk.yellow('\n⚠️   Hook at this path was not created by lem-ai. Skipping.\n'));
+    }
+  } else {
+    console.log(chalk.gray('\nℹ️   No lem-ai hook found to uninstall.\n'));
+  }
+
+  // Also remove the project-level config file if it exists
+  const configPath = getConfigPath();
+  if (configPath && fs.existsSync(configPath)) {
+    fs.unlinkSync(configPath);
+    console.log(chalk.gray('ℹ️   Project configuration removed.'));
+  }
+}
+
+module.exports = { install, uninstall };

package/src/setup.js

@@ -0,0 +1,27 @@
+'use strict';
+const readline = require('readline');
+const chalk = require('chalk');
+const { saveConfig } = require('./config');
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function setup() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  console.log(chalk.cyan('\n🔧  lem-ai Setup\n'));
+
+  const outputFile = await ask(rl, 'Output filename [Implementation.md]: ') || 'Implementation.md';
+  const apiKey = await ask(rl, 'SDK API Key (from Lem settings): ');
+
+  rl.close();
+  saveConfig({
+    outputFile: outputFile.trim() || 'Implementation.md',
+    apiKey: apiKey.trim()
+  });
+
+  console.log(chalk.green('\n✅  Config saved to .lem-ai.json'));
+  console.log(chalk.yellow('👉  Now cd into a git repo and run: lem-ai install\n'));
+}
+
+module.exports = { setup };