ado-sync 0.1.47 → 0.1.49

package/dist/issues/create-issues.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Create GitHub Issues or ADO Bugs for failed test results.
+ *
+ * Guards applied in order before any issue is filed:
+ *   1. Failure-rate threshold  — if >N% fail → one environment-failure issue
+ *   2. Error clustering        — same error message → one cluster issue per group
+ *   3. Hard cap                — stop after maxIssues; file one overflow summary
+ *   4. Dedup                   — skip if an open issue for the same TC already exists
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIssuesFromResults = createIssuesFromResults;
+const ado_bugs_1 = require("./ado-bugs");
+const github_1 = require("./github");
+// ─── Main entry point ─────────────────────────────────────────────────────────
+async function createIssuesFromResults(results, config, issueConfig, runInfo, dryRun = false) {
+    const failed = results.filter((r) => r.outcome === 'Failed');
+    const totalFailed = failed.length;
+    const totalResults = runInfo.totalResults;
+    const threshold = issueConfig.threshold ?? 20;
+    const maxIssues = issueConfig.maxIssues ?? 50;
+    const clusterByError = issueConfig.clusterByError !== false;
+    const dedupEnabled = issueConfig.dedupByTestCase !== false;
+    const provider = issueConfig.provider ?? 'github';
+    const issued = [];
+    let suppressed = 0;
+    if (totalFailed === 0) {
+        return { mode: 'per-test', issued, totalFailed: 0, suppressed: 0 };
+    }
+    // ── Guard 1: Failure-rate threshold ─────────────────────────────────────────
+    const failureRate = totalResults > 0 ? (totalFailed / totalResults) * 100 : 100;
+    if (failureRate > threshold) {
+        const title = `[ENV FAILURE] ${totalFailed}/${totalResults} tests failed (${Math.round(failureRate)}%)`;
+        if (dryRun) {
+            return { mode: 'environment', issued: [{ action: 'created', title, reason: 'dry-run' }], totalFailed, suppressed: totalFailed - 1 };
+        }
+        const body = buildEnvFailureBody(failed, runInfo);
+        const url = await fileIssue(provider, config, issueConfig, title, body, ['test-failure', 'environment-failure']);
+        return { mode: 'environment', issued: [{ action: 'created', url, title }], totalFailed, suppressed: totalFailed - 1 };
+    }
+    // ── Guard 2: Error clustering ────────────────────────────────────────────────
+    const batches = clusterByError ? clusterByErrorSignature(failed) : failed.map((t) => [t]);
+    const mode = batches.some((b) => b.length > 1) ? 'cluster' : 'per-test';
+    for (const batch of batches) {
+        // ── Guard 3: Hard cap ──────────────────────────────────────────────────────
+        if (issued.filter((i) => i.action === 'created').length >= maxIssues) {
+            suppressed += batch.length;
+            continue;
+        }
+        const isCluster = batch.length > 1;
+        const first = batch[0];
+        const title = isCluster
+            ? `[CLUSTER] ${errorSignature(first.errorMessage)} (${batch.length} tests)`
+            : `[FAILED] ${first.testName}`;
+        // ── Guard 4: Dedup ─────────────────────────────────────────────────────────
+        if (dedupEnabled && !isCluster && first.testCaseId !== undefined) {
+            const existing = await checkDuplicate(provider, config, issueConfig, first);
+            if (existing) {
+                issued.push({ action: 'skipped', title, reason: `open issue exists: ${existing}` });
+                continue;
+            }
+        }
+        if (dryRun) {
+            issued.push({ action: 'created', title, reason: 'dry-run' });
+            continue;
+        }
+        const labels = isCluster ? [...(issueConfig.labels ?? ['test-failure']), 'error-cluster']
+            : buildLabels(issueConfig.labels, first.testCaseId);
+        const body = isCluster
+            ? buildClusterBody(batch, runInfo)
+            : buildTestFailureBody(first, runInfo, config.orgUrl, config.project);
+        const url = await fileIssue(provider, config, issueConfig, title, body, labels, isCluster ? undefined : first);
+        issued.push({ action: 'created', url, title });
+    }
+    // ── Guard 3 overflow summary ─────────────────────────────────────────────────
+    if (suppressed > 0 && !dryRun) {
+        const title = `[OVERFLOW] ${suppressed} additional failures suppressed (cap: ${maxIssues})`;
+        const body = [
+            `**${issued.filter((i) => i.action === 'created').length}** issues were filed for this run.`,
+            `An additional **${suppressed}** failures were suppressed to stay within the \`maxIssues\` limit of ${maxIssues}.`,
+            '',
+            runInfo.runUrl ? `[View full test run](${runInfo.runUrl})` : '',
+            '',
+            'Consider investigating whether this is an environment-level failure.',
+        ].join('\n');
+        const url = await fileIssue(provider, config, issueConfig, title, body, ['test-failure', 'overflow']);
+        issued.push({ action: 'created', url, title });
+    }
+    return { mode, issued, totalFailed, suppressed };
+}
+// ─── Clustering ───────────────────────────────────────────────────────────────
+/** Returns a short human-readable fingerprint of an error message. */
+function errorSignature(msg) {
+    if (!msg)
+        return 'unknown error';
+    // Take first non-empty line, strip timestamps/numbers, cap length
+    const first = msg.split('\n').map((l) => l.trim()).find((l) => l.length > 0) ?? msg;
+    return first.replace(/\d+/g, 'N').slice(0, 80);
+}
+/** Group failures by error signature. Clusters with >1 member go first. */
+function clusterByErrorSignature(failed) {
+    const map = new Map();
+    for (const r of failed) {
+        const key = errorSignature(r.errorMessage);
+        if (!map.has(key))
+            map.set(key, []);
+        map.get(key).push(r);
+    }
+    // Largest clusters first so we use the cap budget on the most impactful groups
+    return [...map.values()].sort((a, b) => b.length - a.length);
+}
+// ─── Dedup ────────────────────────────────────────────────────────────────────
+async function checkDuplicate(provider, config, issueConfig, result) {
+    const tcId = result.testCaseId;
+    if (provider === 'github') {
+        const token = resolveToken(issueConfig.token);
+        if (!token || !issueConfig.repo)
+            return null;
+        const existing = await (0, github_1.findOpenGitHubIssueByLabel)(issueConfig.repo, token, `tc:${tcId}`).catch(() => null);
+        return existing ? existing.html_url : null;
+    }
+    else {
+        const existingId = await (0, ado_bugs_1.findOpenAdoBug)(config, `[FAILED] ${result.testName}`).catch(() => null);
+        return existingId ? `${config.orgUrl}/${config.project}/_workitems/edit/${existingId}` : null;
+    }
+}
+// ─── Issue filing ─────────────────────────────────────────────────────────────
+async function fileIssue(provider, config, issueConfig, title, body, labels, result) {
+    if (provider === 'github') {
+        const token = resolveToken(issueConfig.token);
+        if (!token)
+            throw new Error('GitHub token is required (--github-token or createIssuesOnFailure.token)');
+        if (!issueConfig.repo)
+            throw new Error('GitHub repo is required (--github-repo or createIssuesOnFailure.repo)');
+        const issue = await (0, github_1.createGitHubIssue)({
+            repo: issueConfig.repo, token, title, body, labels,
+            assignees: issueConfig.assignees,
+        });
+        return issue.html_url;
+    }
+    else {
+        const bug = await (0, ado_bugs_1.createAdoBug)(config, {
+            title, body,
+            areaPath: issueConfig.areaPath,
+            assignTo: issueConfig.assignTo,
+            testCaseId: result?.testCaseId,
+        });
+        return bug.url;
+    }
+}
+function buildLabels(base, tcId) {
+    const labels = [...(base ?? ['test-failure'])];
+    if (tcId !== undefined)
+        labels.push(`tc:${tcId}`);
+    return labels;
+}
+/** Resolve $ENV_VAR references in token strings. */
+function resolveToken(token) {
+    if (!token)
+        return token;
+    if (token.startsWith('$'))
+        return process.env[token.slice(1)];
+    return token;
+}
+// ─── Issue body builders ──────────────────────────────────────────────────────
+function buildTestFailureBody(result, runInfo, orgUrl, project) {
+    const tcLink = result.testCaseId
+        ? `[#${result.testCaseId}](${orgUrl.replace(/\/$/, '')}/${project}/_testManagement?testCaseId=${result.testCaseId})`
+        : '—';
+    const runLink = runInfo.runUrl ? `[View run](${runInfo.runUrl})` : '—';
+    const buildLink = runInfo.buildId ? `#${runInfo.buildId}` : '—';
+    const lines = [
+        `## Test failure: ${result.testName}`,
+        '',
+        '| Field | Value |',
+        '|---|---|',
+        `| ADO Test Case | ${tcLink} |`,
+        `| Build | ${buildLink} |`,
+        `| Run | ${runLink} |`,
+        '',
+    ];
+    if (result.errorMessage) {
+        lines.push('### Error', '```', result.errorMessage.trim(), '```', '');
+    }
+    if (result.stackTrace) {
+        lines.push('### Stack trace', '```', result.stackTrace.trim(), '```', '');
+    }
+    lines.push('---', '_Filed automatically by [ado-sync](https://github.com/PavanMudigonda/ado-sync)_');
+    return lines.join('\n');
+}
+function buildClusterBody(batch, runInfo) {
+    const runLink = runInfo.runUrl ? `[View run](${runInfo.runUrl})` : '—';
+    const sample = batch[0];
+    const names = batch.slice(0, 20).map((r) => `- ${r.testName}`).join('\n');
+    const overflow = batch.length > 20 ? `\n_… and ${batch.length - 20} more_` : '';
+    const lines = [
+        `## Error cluster: ${errorSignature(sample.errorMessage)}`,
+        '',
+        `**${batch.length} tests failed with the same error.** Run: ${runLink}`,
+        '',
+        '### Affected tests',
+        names + overflow,
+        '',
+    ];
+    if (sample.errorMessage) {
+        lines.push('### Error', '```', sample.errorMessage.trim(), '```', '');
+    }
+    if (sample.stackTrace) {
+        lines.push('### Stack trace (first failure)', '```', sample.stackTrace.trim(), '```', '');
+    }
+    lines.push('---', '_Filed automatically by [ado-sync](https://github.com/PavanMudigonda/ado-sync)_');
+    return lines.join('\n');
+}
+function buildEnvFailureBody(failed, runInfo) {
+    const runLink = runInfo.runUrl ? `[View run](${runInfo.runUrl})` : '—';
+    const sample = failed[0];
+    const names = failed.slice(0, 10).map((r) => `- ${r.testName}`).join('\n');
+    const overflow = failed.length > 10 ? `\n_… and ${failed.length - 10} more_` : '';
+    const lines = [
+        `## Environment failure: ${failed.length} tests failed`,
+        '',
+        `More than the configured threshold of tests failed in a single run. This likely indicates an **infrastructure or environment issue** rather than individual test failures.`,
+        '',
+        `**Run:** ${runLink}`,
+        '',
+        '### Sample failures',
+        names + overflow,
+        '',
+    ];
+    if (sample?.errorMessage) {
+        lines.push('### Sample error', '```', sample.errorMessage.trim(), '```', '');
+    }
+    lines.push('---', '_Filed automatically by [ado-sync](https://github.com/PavanMudigonda/ado-sync)_');
+    return lines.join('\n');
+}
+//# sourceMappingURL=create-issues.js.map

package/dist/issues/create-issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-issues.js","sourceRoot":"","sources":["../../src/issues/create-issues.ts"],"names":[],"mappings":"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"}

package/dist/issues/github.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GitHub Issues API client — creates and searches issues using Node's built-in
+ * https module (no extra dependencies required).
+ */
+export interface GitHubIssueOptions {
+    repo: string;
+    token: string;
+    title: string;
+    body: string;
+    labels?: string[];
+    assignees?: string[];
+}
+export interface GitHubIssue {
+    number: number;
+    html_url: string;
+}
+export declare function createGitHubIssue(opts: GitHubIssueOptions): Promise<GitHubIssue>;
+/**
+ * Returns the first open issue matching the given label, or null if none exists.
+ * Used for dedup: each per-test issue is labelled "tc:12345" so we can find it again.
+ */
+export declare function findOpenGitHubIssueByLabel(repo: string, token: string, tcLabel: string): Promise<GitHubIssue | null>;

package/dist/issues/github.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * GitHub Issues API client — creates and searches issues using Node's built-in
+ * https module (no extra dependencies required).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGitHubIssue = createGitHubIssue;
+exports.findOpenGitHubIssueByLabel = findOpenGitHubIssueByLabel;
+const https = __importStar(require("https"));
+async function createGitHubIssue(opts) {
+    const payload = JSON.stringify({
+        title: opts.title,
+        body: opts.body,
+        labels: opts.labels ?? [],
+        assignees: opts.assignees ?? [],
+    });
+    return ghRequest('POST', `/repos/${opts.repo}/issues`, opts.token, payload);
+}
+/**
+ * Returns the first open issue matching the given label, or null if none exists.
+ * Used for dedup: each per-test issue is labelled "tc:12345" so we can find it again.
+ */
+async function findOpenGitHubIssueByLabel(repo, token, tcLabel) {
+    const q = encodeURIComponent(`repo:${repo} label:"${tcLabel}" state:open`);
+    const result = await ghRequest('GET', `/search/issues?q=${q}&per_page=1`, token, null);
+    return result.items?.[0] ?? null;
+}
+function ghRequest(method, apiPath, token, body) {
+    return new Promise((resolve, reject) => {
+        const headers = {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'User-Agent': 'ado-sync',
+            'Content-Type': 'application/json',
+        };
+        if (body)
+            headers['Content-Length'] = Buffer.byteLength(body);
+        const req = https.request({ hostname: 'api.github.com', path: apiPath, method, headers }, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => {
+                const text = Buffer.concat(chunks).toString();
+                if (res.statusCode && res.statusCode >= 400) {
+                    reject(new Error(`GitHub API ${res.statusCode} ${method} ${apiPath}: ${text}`));
+                    return;
+                }
+                try {
+                    resolve(JSON.parse(text));
+                }
+                catch {
+                    reject(new Error(`GitHub API non-JSON response: ${text.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        if (body)
+            req.write(body);
+        req.end();
+    });
+}
+//# sourceMappingURL=github.js.map

package/dist/issues/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/issues/github.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -17,6 +17,9 @@
  *   generate_specs         — generate local spec files from ADO User Stories
  *   get_work_items         — fetch ADO User Stories by ID, WIQL query, or area path
  *   publish_test_results   — publish test results to Azure DevOps
+ *   create_issue           — file a GitHub Issue or ADO Bug for a test failure
+ *   get_story_context      — planner-agent feed: AC items, suggested tags, linked TCs
+ *   generate_manifest      — write .ai-workflow-manifest-{id}.json for a story
  *
  * Usage (register in .claude/settings.json or .vscode/mcp.json):
  *