@codeledger/cli 0.6.8 → 0.7.0

package/dist/intent/extractor.js

@@ -0,0 +1,149 @@
+/**
+ * Intent extractor — parse structured intent from raw issue data.
+ *
+ * Deterministic extraction (no LLM):
+ *   - Title → title
+ *   - First sentence of body → goal
+ *   - Lines starting with "- [ ]" or numbered items under AC headings → acceptance_criteria
+ *   - Lines mentioning constraints, limits, must-not → constraints
+ */
+/**
+ * Extract structured intent from raw issue data.
+ */
+export function extractIntent(issueId, raw) {
+    const body = raw.body ?? '';
+    return {
+        title: raw.title,
+        goal: extractGoal(raw.title, body),
+        constraints: extractConstraints(body),
+        acceptance_criteria: extractAcceptanceCriteria(body),
+        source_id: issueId,
+        source_system: detectSourceSystem(issueId),
+        raw: body,
+    };
+}
+function extractGoal(title, body) {
+    // Use the first meaningful paragraph of the body as the goal.
+    // Fall back to the title if body is empty or starts with a heading.
+    if (!body.trim())
+        return title;
+    const lines = body.split('\n').map((l) => l.trim()).filter(Boolean);
+    // Skip leading headings (#) and find first prose paragraph
+    for (const line of lines) {
+        if (line.startsWith('#'))
+            continue;
+        if (line.startsWith('- [') || line.startsWith('* ['))
+            continue;
+        if (line.startsWith('|'))
+            continue; // table
+        // Take the first non-heading, non-checklist line as the goal
+        // Truncate to ~200 chars
+        const goal = line.length > 200 ? line.slice(0, 197) + '...' : line;
+        return goal;
+    }
+    return title;
+}
+function extractAcceptanceCriteria(body) {
+    const criteria = [];
+    const lines = body.split('\n');
+    let inACSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect AC section headers
+        if (/^#{1,3}\s*(acceptance\s*criteria|ac|definition\s*of\s*done|done\s*when|requirements)/i.test(trimmed)) {
+            inACSection = true;
+            continue;
+        }
+        // New heading ends AC section
+        if (inACSection && /^#{1,3}\s/.test(trimmed) && !/acceptance/i.test(trimmed)) {
+            inACSection = false;
+            continue;
+        }
+        // Collect checklist items and bullet points in AC section
+        if (inACSection) {
+            const checkboxMatch = trimmed.match(/^[-*]\s*\[[ x]]\s*(.+)/i);
+            if (checkboxMatch) {
+                criteria.push(checkboxMatch[1].trim());
+                continue;
+            }
+            const bulletMatch = trimmed.match(/^[-*]\s+(.+)/);
+            if (bulletMatch) {
+                criteria.push(bulletMatch[1].trim());
+                continue;
+            }
+            const numberedMatch = trimmed.match(/^\d+\.\s+(.+)/);
+            if (numberedMatch) {
+                criteria.push(numberedMatch[1].trim());
+                continue;
+            }
+        }
+        // Also collect standalone checklists outside AC section
+        if (!inACSection) {
+            const checkboxMatch = trimmed.match(/^[-*]\s*\[[ x]]\s*(.+)/i);
+            if (checkboxMatch) {
+                criteria.push(checkboxMatch[1].trim());
+            }
+        }
+    }
+    return criteria;
+}
+function extractConstraints(body) {
+    const constraints = [];
+    const lines = body.split('\n');
+    const CONSTRAINT_PATTERNS = [
+        /\bmust\s+not\b/i,
+        /\bshould\s+not\b/i,
+        /\bdo\s+not\b/i,
+        /\bdon't\b/i,
+        /\bavoid\b/i,
+        /\bno\s+(?:more|fewer|less)\s+than\b/i,
+        /\bmax(?:imum)?\s+\d/i,
+        /\bmin(?:imum)?\s+\d/i,
+        /\bwithin\s+\d/i,
+        /\blimit(?:ed)?\s+to\b/i,
+        /\bbackwards?\s*compat/i,
+        /\bbreaking\s+change/i,
+    ];
+    let inConstraintsSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect constraints section
+        if (/^#{1,3}\s*(constraints?|limitations?|restrictions?|non-?goals?)/i.test(trimmed)) {
+            inConstraintsSection = true;
+            continue;
+        }
+        if (inConstraintsSection && /^#{1,3}\s/.test(trimmed)) {
+            inConstraintsSection = false;
+            continue;
+        }
+        // Collect bullets in constraints section
+        if (inConstraintsSection) {
+            const bulletMatch = trimmed.match(/^[-*]\s+(.+)/);
+            if (bulletMatch) {
+                constraints.push(bulletMatch[1].trim());
+                continue;
+            }
+        }
+        // Detect constraint-like language anywhere
+        if (CONSTRAINT_PATTERNS.some((p) => p.test(trimmed))) {
+            // Only grab bullet points or short sentences
+            const bulletMatch = trimmed.match(/^[-*]\s+(.+)/);
+            if (bulletMatch) {
+                constraints.push(bulletMatch[1].trim());
+            }
+        }
+    }
+    return constraints;
+}
+function detectSourceSystem(issueId) {
+    if (issueId.includes('#') || /^\d+$/.test(issueId))
+        return 'github';
+    if (/^[A-Z]+-\d+$/.test(issueId)) {
+        // Disambiguate: Jira if JIRA_BASE_URL is set, otherwise Linear
+        if (process.env['JIRA_BASE_URL'])
+            return 'jira';
+        return 'linear';
+    }
+    return 'manual';
+}
+//# sourceMappingURL=extractor.js.map

package/dist/intent/extractor.js.map

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

package/dist/intent/fetcher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Issue fetcher — retrieves issue data from external trackers.
+ *
+ * Supported providers:
+ *   - GitHub Issues: "owner/repo#123" or "#123" (infer from git remote)
+ *   - Linear: "PREFIX-123" (requires LINEAR_API_KEY)
+ *   - Jira: "PROJ-123" with JIRA_BASE_URL set (requires JIRA_API_TOKEN + JIRA_USER_EMAIL)
+ *
+ * Requires no API keys for public GitHub repos. For private repos,
+ * set GITHUB_TOKEN in the environment.
+ */
+import type { RawIssueData } from './types.js';
+/**
+ * Detect issue source and fetch raw data.
+ * Provider detection priority: GitHub full → GitHub short → Linear/Jira (PREFIX-123)
+ */
+export declare function fetchIssue(issueId: string): Promise<RawIssueData | null>;
+/**
+ * Extract plain text from a Jira ADF description or plain string.
+ * Handles both v2 (plain string) and v3 (ADF JSON) description formats.
+ *
+ * Supported ADF node types:
+ *   - paragraph → joined text
+ *   - heading → "# text" (with level)
+ *   - bulletList / orderedList → "- item" / "1. item"
+ *   - codeBlock → fenced code block
+ *   - blockquote → "> text"
+ *   - table → pipe-separated rows
+ *   - panel → text with panel type prefix
+ *   - text, hardBreak, mention, emoji, inlineCard (inline nodes)
+ */
+export declare function extractJiraDescription(description: unknown): string;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/intent/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/intent/fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA+B9E;AAqND;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAQnE"}

package/dist/intent/fetcher.js

@@ -0,0 +1,364 @@
+/**
+ * Issue fetcher — retrieves issue data from external trackers.
+ *
+ * Supported providers:
+ *   - GitHub Issues: "owner/repo#123" or "#123" (infer from git remote)
+ *   - Linear: "PREFIX-123" (requires LINEAR_API_KEY)
+ *   - Jira: "PROJ-123" with JIRA_BASE_URL set (requires JIRA_API_TOKEN + JIRA_USER_EMAIL)
+ *
+ * Requires no API keys for public GitHub repos. For private repos,
+ * set GITHUB_TOKEN in the environment.
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Detect issue source and fetch raw data.
+ * Provider detection priority: GitHub full → GitHub short → Linear/Jira (PREFIX-123)
+ */
+export async function fetchIssue(issueId) {
+    // GitHub: owner/repo#123
+    const ghFullMatch = issueId.match(/^([^/]+\/[^#]+)#(\d+)$/);
+    if (ghFullMatch) {
+        return fetchGitHubIssue(ghFullMatch[1], ghFullMatch[2]);
+    }
+    // GitHub shorthand: #123 (infer repo from git remote)
+    const ghShortMatch = issueId.match(/^#?(\d+)$/);
+    if (ghShortMatch) {
+        const repo = inferGitHubRepo();
+        if (repo) {
+            return fetchGitHubIssue(repo, ghShortMatch[1]);
+        }
+        console.error(`Cannot infer GitHub repo for issue ${issueId}. Use "owner/repo#${ghShortMatch[1]}" format.`);
+        return null;
+    }
+    // PREFIX-123 pattern: detect Linear vs Jira based on env vars
+    const prefixMatch = issueId.match(/^([A-Z]+)-(\d+)$/);
+    if (prefixMatch) {
+        // If JIRA_BASE_URL is set, treat as Jira
+        if (process.env['JIRA_BASE_URL']) {
+            return fetchJiraIssue(issueId);
+        }
+        // Otherwise treat as Linear (default for PREFIX-123 format)
+        return fetchLinearIssue(issueId);
+    }
+    console.error(`Unrecognized issue format: "${issueId}". Supported: owner/repo#123, #123, PREFIX-123`);
+    return null;
+}
+async function fetchGitHubIssue(repo, number) {
+    const url = `https://api.github.com/repos/${repo}/issues/${number}`;
+    const token = process.env['GITHUB_TOKEN'] || process.env['GH_TOKEN'];
+    const headers = {
+        'Accept': 'application/vnd.github.v3+json',
+        'User-Agent': 'codeledger-cli',
+    };
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    try {
+        const res = await fetch(url, { headers });
+        if (!res.ok) {
+            if (res.status === 404) {
+                console.error(`Issue not found: ${repo}#${number}`);
+            }
+            else if (res.status === 403) {
+                console.error(`GitHub API rate limit or auth error. Set GITHUB_TOKEN for private repos.`);
+            }
+            else {
+                console.error(`GitHub API error ${res.status}: ${res.statusText}`);
+            }
+            return null;
+        }
+        const data = await res.json();
+        return {
+            title: data.title,
+            body: data.body ?? '',
+            labels: data.labels.map((l) => l.name),
+            state: data.state,
+            assignee: data.assignee?.login,
+            url: data.html_url,
+        };
+    }
+    catch (err) {
+        console.error(`Failed to fetch GitHub issue: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+// ── Linear Provider ──────────────────────────────────────────────────────────
+async function fetchLinearIssue(issueId) {
+    const token = process.env['LINEAR_API_KEY'];
+    if (!token) {
+        console.error(`Linear API key required. Set LINEAR_API_KEY in your environment.\n` +
+            `  export LINEAR_API_KEY=lin_api_...\n` +
+            `Or save issue data manually:\n` +
+            `  codeledger intent from-issue ${issueId} --format json > intent.json\n` +
+            `  Then use: --intent-file intent.json`);
+        return null;
+    }
+    const query = `
+    query IssueByIdentifier($id: String!) {
+      issue(id: $id) {
+        title
+        description
+        state { name }
+        assignee { name }
+        labels { nodes { name } }
+        url
+      }
+    }
+  `;
+    try {
+        const res = await fetch('https://api.linear.app/graphql', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': token,
+            },
+            body: JSON.stringify({ query, variables: { id: issueId } }),
+        });
+        if (!res.ok) {
+            if (res.status === 401) {
+                console.error('Linear API authentication failed. Check LINEAR_API_KEY.');
+            }
+            else {
+                console.error(`Linear API error ${res.status}: ${res.statusText}`);
+            }
+            return null;
+        }
+        const json = await res.json();
+        if (json.errors && json.errors.length > 0) {
+            console.error(`Linear API error: ${json.errors[0].message}`);
+            return null;
+        }
+        const issue = json.data?.issue;
+        if (!issue) {
+            console.error(`Linear issue not found: ${issueId}`);
+            return null;
+        }
+        return {
+            title: issue.title,
+            body: issue.description ?? '',
+            labels: issue.labels.nodes.map((l) => l.name),
+            state: issue.state?.name,
+            assignee: issue.assignee?.name,
+            url: issue.url,
+        };
+    }
+    catch (err) {
+        console.error(`Failed to fetch Linear issue: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+// ── Jira Provider ────────────────────────────────────────────────────────────
+async function fetchJiraIssue(issueId) {
+    const baseUrl = process.env['JIRA_BASE_URL'];
+    if (!baseUrl) {
+        console.error(`Jira base URL required. Set JIRA_BASE_URL in your environment.\n` +
+            `  export JIRA_BASE_URL=https://your-org.atlassian.net`);
+        return null;
+    }
+    const token = process.env['JIRA_API_TOKEN'];
+    const email = process.env['JIRA_USER_EMAIL'];
+    if (!token || !email) {
+        console.error(`Jira API credentials required. Set both JIRA_API_TOKEN and JIRA_USER_EMAIL.\n` +
+            `  export JIRA_API_TOKEN=...\n` +
+            `  export JIRA_USER_EMAIL=you@company.com\n` +
+            `Or save issue data manually:\n` +
+            `  codeledger intent from-issue ${issueId} --format json > intent.json\n` +
+            `  Then use: --intent-file intent.json`);
+        return null;
+    }
+    const url = `${baseUrl.replace(/\/$/, '')}/rest/api/3/issue/${issueId}`;
+    const auth = Buffer.from(`${email}:${token}`).toString('base64');
+    try {
+        const res = await fetch(url, {
+            headers: {
+                'Accept': 'application/json',
+                'Authorization': `Basic ${auth}`,
+            },
+        });
+        if (!res.ok) {
+            if (res.status === 404) {
+                console.error(`Jira issue not found: ${issueId}`);
+            }
+            else if (res.status === 401) {
+                console.error('Jira API authentication failed. Check JIRA_API_TOKEN and JIRA_USER_EMAIL.');
+            }
+            else {
+                console.error(`Jira API error ${res.status}: ${res.statusText}`);
+            }
+            return null;
+        }
+        const data = await res.json();
+        // Jira v3 API uses ADF (Atlassian Document Format) for description.
+        // Extract plain text from top-level paragraphs.
+        const body = extractJiraDescription(data.fields.description);
+        return {
+            title: data.fields.summary,
+            body,
+            labels: data.fields.labels,
+            state: data.fields.status?.name,
+            assignee: data.fields.assignee?.displayName,
+            url: `${baseUrl.replace(/\/$/, '')}/browse/${data.key}`,
+        };
+    }
+    catch (err) {
+        console.error(`Failed to fetch Jira issue: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/**
+ * Extract plain text from a Jira ADF description or plain string.
+ * Handles both v2 (plain string) and v3 (ADF JSON) description formats.
+ *
+ * Supported ADF node types:
+ *   - paragraph → joined text
+ *   - heading → "# text" (with level)
+ *   - bulletList / orderedList → "- item" / "1. item"
+ *   - codeBlock → fenced code block
+ *   - blockquote → "> text"
+ *   - table → pipe-separated rows
+ *   - panel → text with panel type prefix
+ *   - text, hardBreak, mention, emoji, inlineCard (inline nodes)
+ */
+export function extractJiraDescription(description) {
+    if (typeof description === 'string')
+        return description;
+    if (!description || typeof description !== 'object')
+        return '';
+    const doc = description;
+    if (!Array.isArray(doc.content))
+        return '';
+    return extractAdfBlocks(doc.content).join('\n');
+}
+/** Recursively extract text from an array of ADF block nodes. */
+function extractAdfBlocks(blocks) {
+    const lines = [];
+    for (const block of blocks) {
+        switch (block.type) {
+            case 'paragraph':
+                lines.push(extractInlineText(block.content));
+                break;
+            case 'heading': {
+                const level = block.attrs?.['level'] ?? 2;
+                const prefix = '#'.repeat(Math.min(level, 6));
+                lines.push(`${prefix} ${extractInlineText(block.content)}`);
+                break;
+            }
+            case 'bulletList':
+                if (block.content) {
+                    for (const item of block.content) {
+                        if (item.type === 'listItem' && item.content) {
+                            const itemText = extractAdfBlocks(item.content).join(' ');
+                            lines.push(`- ${itemText}`);
+                        }
+                    }
+                }
+                break;
+            case 'orderedList':
+                if (block.content) {
+                    let idx = 1;
+                    for (const item of block.content) {
+                        if (item.type === 'listItem' && item.content) {
+                            const itemText = extractAdfBlocks(item.content).join(' ');
+                            lines.push(`${idx}. ${itemText}`);
+                            idx++;
+                        }
+                    }
+                }
+                break;
+            case 'codeBlock': {
+                const lang = block.attrs?.['language'] ?? '';
+                lines.push(`\`\`\`${lang}`);
+                lines.push(extractInlineText(block.content));
+                lines.push('```');
+                break;
+            }
+            case 'blockquote':
+                if (block.content) {
+                    for (const inner of extractAdfBlocks(block.content)) {
+                        lines.push(`> ${inner}`);
+                    }
+                }
+                break;
+            case 'table':
+                if (block.content) {
+                    for (const row of block.content) {
+                        if ((row.type === 'tableRow' || row.type === 'tableHeader') && row.content) {
+                            const cells = row.content.map((cell) => cell.content ? extractAdfBlocks(cell.content).join(' ') : '');
+                            lines.push(`| ${cells.join(' | ')} |`);
+                        }
+                    }
+                }
+                break;
+            case 'panel':
+                if (block.content) {
+                    const panelType = block.attrs?.['panelType'] ?? 'info';
+                    lines.push(`[${panelType.toUpperCase()}]`);
+                    lines.push(...extractAdfBlocks(block.content));
+                }
+                break;
+            case 'rule':
+                lines.push('---');
+                break;
+            default:
+                // Unknown block type — try to extract inline text as fallback
+                if (block.content) {
+                    const text = extractInlineText(block.content);
+                    if (text)
+                        lines.push(text);
+                }
+                break;
+        }
+    }
+    return lines;
+}
+/** Extract plain text from an array of ADF inline nodes. */
+function extractInlineText(nodes) {
+    if (!nodes)
+        return '';
+    const parts = [];
+    for (const node of nodes) {
+        switch (node.type) {
+            case 'text':
+                if (typeof node.text === 'string')
+                    parts.push(node.text);
+                break;
+            case 'hardBreak':
+                parts.push('\n');
+                break;
+            case 'mention':
+                parts.push(`@${node.attrs?.['text'] ?? 'user'}`);
+                break;
+            case 'emoji':
+                parts.push(node.attrs?.['shortName'] ?? '');
+                break;
+            case 'inlineCard':
+                parts.push(node.attrs?.['url'] ?? '');
+                break;
+            default:
+                // Unknown inline — try text field
+                if (typeof node.text === 'string')
+                    parts.push(node.text);
+                break;
+        }
+    }
+    return parts.join('');
+}
+// ── Repo Inference ───────────────────────────────────────────────────────────
+function inferGitHubRepo() {
+    try {
+        const remote = execSync('git remote get-url origin', { encoding: 'utf-8', timeout: 5000 }).trim();
+        // SSH: git@github.com:owner/repo.git
+        const sshMatch = remote.match(/github\.com[:/]([^/]+\/[^.]+?)(?:\.git)?$/);
+        if (sshMatch)
+            return sshMatch[1];
+        // HTTPS: https://github.com/owner/repo.git
+        const httpsMatch = remote.match(/github\.com\/([^/]+\/[^.]+?)(?:\.git)?$/);
+        if (httpsMatch)
+            return httpsMatch[1];
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/intent/fetcher.js.map

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

package/dist/intent/loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Intent loader — resolves an IssueIntent from:
+ *   1. --intent-file <path>  (pre-extracted JSON)
+ *   2. --issue <ID>          (fetch from tracker, extract intent)
+ *   3. branch name inference (via tracker_prefix config)
+ *   4. (none)                (returns null — diff-only inference)
+ */
+import type { IssueIntent } from './types.js';
+export interface IntentSource {
+    issue?: string;
+    intentFile?: string;
+    trackerPrefix?: string;
+}
+/**
+ * Infer an issue ID from a branch name using a tracker prefix.
+ * E.g., branch "feat/LINEAR-123-add-search" with prefix "LINEAR" → "LINEAR-123"
+ *
+ * When branchName is omitted, reads current branch from git.
+ */
+export declare function inferIssueFromBranch(trackerPrefix: string, branchName?: string): string | null;
+/**
+ * Load intent from the best available source.
+ * Returns null if no intent source is provided.
+ */
+export declare function loadIntent(source: IntentSource): Promise<IssueIntent | null>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/intent/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/intent/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB9F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAuClF"}