chorus-cli 0.4.0

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "chorus-cli",
+  "version": "0.4.0",
+  "description": "Automated ticket resolution with AI, Teams, and Slack integration",
+  "main": "index.js",
+  "bin": {
+    "chorus": "index.js"
+  },
+  "files": [
+    "index.js",
+    "providers/",
+    "tools/",
+    "scripts/postinstall.js"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "setup": "node index.js setup",
+    "start": "node index.js run"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.73.0",
+    "@octokit/rest": "^20.0.2",
+    "dotenv": "^17.2.4",
+    "playwright": "^1.40.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/providers/azuredevops.js

@@ -0,0 +1,202 @@
+'use strict';
+
+const { exec } = require('child_process');
+const util = require('util');
+const fs = require('fs').promises;
+const execPromise = util.promisify(exec);
+
+/**
+ * Normalize an Azure DevOps work item into the shared issue shape.
+ */
+function normalize(workItem) {
+  const fields = workItem.fields || {};
+  return {
+    number: workItem.id,
+    title: fields['System.Title'] || '(untitled)',
+    body: fields['System.Description'] || '',
+    labels: (fields['System.Tags'] || '')
+      .split(';')
+      .map(t => t.trim())
+      .filter(Boolean)
+      .map(name => ({ name })),
+    user: {
+      login: fields['System.CreatedBy']?.displayName
+        || fields['System.CreatedBy']?.uniqueName
+        || 'unknown',
+    },
+  };
+}
+
+function createAzureDevOpsProvider(config) {
+  const { org, project, repo, pat } = config;
+
+  const baseUrl = `https://dev.azure.com/${org}`;
+  const apiVersion = '7.1';
+
+  function authHeaders() {
+    const encoded = Buffer.from(`:${pat}`).toString('base64');
+    return {
+      Authorization: `Basic ${encoded}`,
+      'Content-Type': 'application/json',
+    };
+  }
+
+  async function adoFetch(url, options = {}) {
+    const res = await fetch(url, {
+      ...options,
+      headers: { ...authHeaders(), ...options.headers },
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Azure DevOps API error (${res.status}): ${text}`);
+    }
+    return res.json();
+  }
+
+  async function fetchLatestIssue() {
+    const wiql = {
+      query: `SELECT [System.Id] FROM WorkItems
+              WHERE [System.AssignedTo] = @me
+                AND [System.State] <> 'Closed'
+                AND [System.State] <> 'Removed'
+              ORDER BY [System.CreatedDate] DESC`,
+    };
+
+    const result = await adoFetch(
+      `${baseUrl}/${project}/_apis/wit/wiql?api-version=${apiVersion}`,
+      { method: 'POST', body: JSON.stringify(wiql) }
+    );
+
+    if (!result.workItems || result.workItems.length === 0) {
+      throw new Error('No open work items found assigned to you in Azure DevOps');
+    }
+
+    const topId = result.workItems[0].id;
+    return fetchIssueByNumber(topId);
+  }
+
+  async function fetchIssueByNumber(id) {
+    const data = await adoFetch(
+      `${baseUrl}/${project}/_apis/wit/workitems/${id}?$expand=all&api-version=${apiVersion}`
+    );
+    return normalize(data);
+  }
+
+  async function getUserDisplayName(identifier) {
+    // ADO work items already include the display name, so just pass it through
+    return identifier;
+  }
+
+  function parseIssueArg(arg) {
+    if (!arg) return null;
+
+    // Full ADO URL: https://dev.azure.com/{org}/{project}/_workitems/edit/{id}
+    const urlMatch = arg.match(
+      /dev\.azure\.com\/([^/]+)\/([^/]+)\/_workitems\/edit\/(\d+)/
+    );
+    if (urlMatch) {
+      return {
+        org: urlMatch[1],
+        project: urlMatch[2],
+        number: parseInt(urlMatch[3], 10),
+      };
+    }
+
+    // Bare work item number
+    if (/^\d+$/.test(arg)) {
+      return { org, project, number: parseInt(arg, 10) };
+    }
+
+    throw new Error(
+      `Invalid issue argument: "${arg}". Pass a number (456) or Azure DevOps URL.`
+    );
+  }
+
+  function getSolutionFiles(solution) {
+    return [...(solution.files_modified || []), ...(solution.files_created || [])];
+  }
+
+  async function gitAddSolutionFiles(solution) {
+    const files = getSolutionFiles(solution);
+    if (files.length > 0) {
+      const quoted = files.map(f => `"${f}"`).join(' ');
+      await execPromise(`git add ${quoted}`);
+    } else {
+      await execPromise('git add .');
+    }
+  }
+
+  async function createPR(issue, solution) {
+    const branchName = `fix/ab${issue.number}`;
+    const isCoder = config.codingTool === 'coder';
+
+    console.log('🌿 Creating PR...');
+
+    if (!isCoder) {
+      // Legacy: parse code blocks and write files
+      const fileRegex = /```(.+?)\n([\s\S]+?)```/g;
+      const raw = solution._raw || solution;
+      let match;
+      while ((match = fileRegex.exec(raw)) !== null) {
+        const [, filepath, content] = match;
+        const cleanPath = filepath.trim();
+        if (cleanPath.includes('/') || cleanPath.includes('.')) {
+          const dir = cleanPath.substring(0, cleanPath.lastIndexOf('/'));
+          if (dir) await execPromise(`mkdir -p ${dir}`).catch(() => {});
+          await fs.writeFile(cleanPath, content.trim());
+        }
+      }
+    }
+
+    // Clean up stale branch
+    await execPromise(`git branch -D ${branchName}`).catch(() => {});
+    await execPromise(`git push origin --delete ${branchName}`).catch(() => {});
+
+    await execPromise(`git checkout -b ${branchName}`);
+    await gitAddSolutionFiles(solution);
+
+    const { stdout: diffCheck } = await execPromise(`git diff --cached --stat`);
+    if (!diffCheck.trim()) {
+      await execPromise(`git checkout main`);
+      await execPromise(`git branch -D ${branchName}`).catch(() => {});
+      throw new Error('No file changes to commit — coder did not produce any code');
+    }
+
+    // AB#123 syntax links the commit to the Azure DevOps work item
+    await execPromise(`git commit -m "Fix: ${issue.title} AB#${issue.number}"`);
+    await execPromise(`git push origin ${branchName}`);
+
+    // Create PR via Azure DevOps REST API
+    const summary = isCoder ? solution.summary : (solution._raw || solution);
+    const filesChanged = isCoder
+      ? getSolutionFiles(solution).map(f => `- \`${f}\``).join('\n')
+      : '';
+
+    const prBody = {
+      sourceRefName: `refs/heads/${branchName}`,
+      targetRefName: 'refs/heads/main',
+      title: `Fix: ${issue.title}`,
+      description: `Resolves AB#${issue.number}\n\n## Summary\n${summary}${filesChanged ? `\n\n## Files Changed\n${filesChanged}` : ''}`,
+    };
+
+    const prResult = await adoFetch(
+      `${baseUrl}/${project}/_apis/git/repositories/${repo}/pullrequests?api-version=${apiVersion}`,
+      { method: 'POST', body: JSON.stringify(prBody) }
+    );
+
+    console.log('✅ PR created:', prResult.url || `PR #${prResult.pullRequestId}`);
+  }
+
+  return {
+    name: 'azuredevops',
+    fetchLatestIssue,
+    fetchIssueByNumber,
+    getUserDisplayName,
+    parseIssueArg,
+    createPR,
+    getSolutionFiles,
+    gitAddSolutionFiles,
+  };
+}
+
+module.exports = { createAzureDevOpsProvider };

package/providers/github.js

@@ -0,0 +1,144 @@
+'use strict';
+
+const { Octokit } = require('@octokit/rest');
+const { exec } = require('child_process');
+const util = require('util');
+const fs = require('fs').promises;
+const execPromise = util.promisify(exec);
+
+function createGitHubProvider(config) {
+  const { owner, repo, token, codingTool } = config;
+
+  function getOctokit() {
+    return new Octokit({ auth: token });
+  }
+
+  async function fetchLatestIssue() {
+    const octokit = getOctokit();
+    const { data: issues } = await octokit.issues.listForRepo({
+      owner,
+      repo,
+      state: 'open',
+      assignee: 'james-baloyi',
+      sort: 'created',
+      direction: 'desc',
+      per_page: 10,
+    });
+
+    if (issues.length === 0) {
+      throw new Error(`No open issues found assigned to james-baloyi in ${owner}/${repo}`);
+    }
+
+    return issues[0];
+  }
+
+  async function fetchIssueByNumber(number, issueOwner, issueRepo) {
+    const octokit = getOctokit();
+    const { data: issue } = await octokit.issues.get({
+      owner: issueOwner || owner,
+      repo: issueRepo || repo,
+      issue_number: number,
+    });
+    return issue;
+  }
+
+  async function getUserDisplayName(username) {
+    const octokit = getOctokit();
+    const { data: user } = await octokit.users.getByUsername({ username });
+    return user;
+  }
+
+  function parseIssueArg(arg) {
+    if (!arg) return null;
+
+    // Full GitHub URL: https://github.com/owner/repo/issues/123
+    const urlMatch = arg.match(/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
+    if (urlMatch) {
+      return { owner: urlMatch[1], repo: urlMatch[2], number: parseInt(urlMatch[3], 10) };
+    }
+
+    // Bare issue number
+    if (/^\d+$/.test(arg)) {
+      return { owner, repo, number: parseInt(arg, 10) };
+    }
+
+    throw new Error(`Invalid issue argument: "${arg}". Pass a number (4464) or GitHub URL.`);
+  }
+
+  function getSolutionFiles(solution) {
+    return [...(solution.files_modified || []), ...(solution.files_created || [])];
+  }
+
+  async function gitAddSolutionFiles(solution) {
+    const files = getSolutionFiles(solution);
+    if (files.length > 0) {
+      const quoted = files.map(f => `"${f}"`).join(' ');
+      await execPromise(`git add ${quoted}`);
+    } else {
+      await execPromise('git add .');
+    }
+  }
+
+  async function createPR(issue, solution) {
+    const branchName = `fix/issue-${issue.number}`;
+    const isCoder = codingTool === 'coder';
+
+    console.log('🌿 Creating PR...');
+
+    if (!isCoder) {
+      await writeSolutionToFiles(solution._raw || solution);
+    }
+
+    // Clean up stale branch from previous runs
+    await execPromise(`git branch -D ${branchName}`).catch(() => {});
+    await execPromise(`git push origin --delete ${branchName}`).catch(() => {});
+
+    await execPromise(`git checkout -b ${branchName}`);
+    await gitAddSolutionFiles(solution);
+
+    const { stdout: diffCheck } = await execPromise(`git diff --cached --stat`);
+    if (!diffCheck.trim()) {
+      await execPromise(`git checkout main`);
+      await execPromise(`git branch -D ${branchName}`).catch(() => {});
+      throw new Error('No file changes to commit — coder did not produce any code');
+    }
+
+    await execPromise(`git commit -m "Fix: ${issue.title} (resolves #${issue.number})"`);
+    await execPromise(`git push origin ${branchName}`);
+
+    const summary = isCoder ? solution.summary : (solution._raw || solution);
+    const filesChanged = isCoder
+      ? getSolutionFiles(solution).map(f => `- \`${f}\``).join('\n')
+      : '';
+
+    const prBody = `Resolves #${issue.number}
+
+## Summary
+${summary}
+${filesChanged ? `\n## Files Changed\n${filesChanged}` : ''}`;
+
+    const tmpBody = `/tmp/pr-body-${Date.now()}.md`;
+    await fs.writeFile(tmpBody, prBody);
+
+    const escapedTitle = issue.title.replace(/"/g, '\\"');
+    const { stdout } = await execPromise(
+      `gh pr create --title "Fix: ${escapedTitle}" --body-file "${tmpBody}" --base main`
+    );
+    await fs.unlink(tmpBody).catch(() => {});
+
+    console.log('✅ PR created:', stdout);
+  }
+
+  return {
+    name: 'github',
+    fetchLatestIssue,
+    fetchIssueByNumber,
+    getUserDisplayName,
+    parseIssueArg,
+    createPR,
+    getSolutionFiles,
+    gitAddSolutionFiles,
+  };
+}
+
+module.exports = { createGitHubProvider };

package/providers/index.js

@@ -0,0 +1,51 @@
+'use strict';
+
+const { createGitHubProvider } = require('./github');
+const { createAzureDevOpsProvider } = require('./azuredevops');
+
+/**
+ * Detect provider from an issue argument URL.
+ * Returns 'github', 'azuredevops', or null if undetectable.
+ */
+function detectProviderFromArg(issueArg) {
+  if (!issueArg || typeof issueArg !== 'string') return null;
+  if (issueArg.includes('github.com')) return 'github';
+  if (issueArg.includes('dev.azure.com')) return 'azuredevops';
+  return null;
+}
+
+/**
+ * Create a provider instance.
+ *
+ * Resolution order:
+ *   1. Explicit PROVIDER env var
+ *   2. URL detection from issueArg
+ *   3. Default to 'github'
+ */
+function createProvider(config, issueArg) {
+  const explicit = process.env.PROVIDER;
+  const detected = detectProviderFromArg(issueArg);
+  const name = (explicit || detected || 'github').toLowerCase();
+
+  if (name === 'azuredevops' || name === 'azure' || name === 'ado') {
+    if (!config.azuredevops.org || !config.azuredevops.pat) {
+      throw new Error(
+        'Azure DevOps provider requires AZDO_ORG, AZDO_PROJECT, AZDO_REPO, and AZDO_PAT environment variables. Run "chorus setup" to configure.'
+      );
+    }
+    return createAzureDevOpsProvider({
+      ...config.azuredevops,
+      codingTool: config.ai.codingTool,
+    });
+  }
+
+  // Default: GitHub
+  return createGitHubProvider({
+    owner: config.github.owner,
+    repo: config.github.repo,
+    token: config.github.token,
+    codingTool: config.ai.codingTool,
+  });
+}
+
+module.exports = { createProvider, detectProviderFromArg };

package/scripts/postinstall.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+'use strict';
+
+const { execFileSync, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const os = require('os');
+const ROOT = path.resolve(__dirname, '..');
+const VENV = path.join(os.homedir(), '.config', 'chorus', '.venv');
+const REQUIREMENTS = path.join(ROOT, 'tools', 'requirements.txt');
+
+// Skip in CI or when explicitly opted out
+if (process.env.CHORUS_SKIP_POSTINSTALL === '1') {
+  console.log('CHORUS_SKIP_POSTINSTALL=1 — skipping Python setup');
+  process.exit(0);
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function run(cmd, args, opts) {
+  try {
+    return execFileSync(cmd, args, { stdio: 'inherit', ...opts });
+  } catch (e) {
+    console.error(`   Command failed: ${cmd} ${args.join(' ')}`);
+    if (e.message) console.error(`   ${e.message}`);
+    return null;
+  }
+}
+
+function findPython() {
+  for (const candidate of ['python3', 'python']) {
+    try {
+      const version = execFileSync(candidate, ['--version'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+      }).trim(); // e.g. "Python 3.11.4"
+
+      const match = version.match(/Python (\d+)\.(\d+)/);
+      if (match) {
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        if (major === 3 && minor >= 8) {
+          console.log(`Found ${version} (${candidate})`);
+          return candidate;
+        }
+      }
+    } catch {
+      // candidate not found, try next
+    }
+  }
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+console.log('\nChorus postinstall — setting up Python environment\n');
+
+const python = findPython();
+
+if (!python) {
+  console.error(
+    '⚠  Python 3.8+ not found.\n' +
+    '   Chorus needs Python 3 to run its AI tools (coder, qa, mapper).\n' +
+    '   Install Python 3 and re-run: npm rebuild chorus\n'
+  );
+  // Exit 0 so npm install still succeeds
+  process.exit(0);
+}
+
+// 1. Create venv (skip if it already exists and looks valid)
+const venvPython = process.platform === 'win32'
+  ? path.join(VENV, 'Scripts', 'python.exe')
+  : path.join(VENV, 'bin', 'python');
+
+if (!fs.existsSync(venvPython)) {
+  console.log('Creating virtual environment...');
+  if (run(python, ['-m', 'venv', VENV]) === null) {
+    console.error('⚠  Failed to create virtual environment. Install the venv module and re-run: npm rebuild chorus');
+    process.exit(0);
+  }
+} else {
+  console.log('Virtual environment already exists');
+}
+
+// 2. Install Python dependencies using python -m pip (more reliable than pip binary)
+console.log('Installing Python dependencies...');
+run(venvPython, ['-m', 'pip', 'install', '-r', REQUIREMENTS]);
+
+// 3. Verify critical dependency installed
+try {
+  execFileSync(venvPython, ['-c', 'import anthropic'], { stdio: 'ignore' });
+  console.log('   Dependencies installed ✓');
+} catch {
+  console.error(
+    '⚠  "anthropic" module is missing after pip install.\n' +
+    '   Run manually: ' + venvPython + ' -m pip install -r ' + REQUIREMENTS
+  );
+  process.exit(0);
+}
+
+// 4. Verify slack_sdk installed
+try {
+  execFileSync(venvPython, ['-c', 'import slack_sdk'], { stdio: 'ignore' });
+  console.log('   slack_sdk installed ✓');
+} catch {
+  console.warn(
+    '⚠  "slack_sdk" module is missing after pip install.\n' +
+    '   Slack messenger will not work. Run manually:\n' +
+    '   ' + venvPython + ' -m pip install slack_sdk>=3.27.0'
+  );
+  // Non-blocking — Slack is optional
+}
+
+// 5. Install Playwright Firefox for the Python side
+console.log('Installing Playwright Firefox...');
+if (run(venvPython, ['-m', 'playwright', 'install', 'firefox']) === null) {
+  console.error('⚠  Playwright Firefox install failed. You can run it manually later:\n   ' + venvPython + ' -m playwright install firefox');
+}
+
+console.log('\n✅ Chorus Python environment ready\n');