ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/sources/integrations/github.js

@@ -0,0 +1,193 @@
+import { IntegrationSource } from '../base.js';
+/**
+ * GitHub source - fetches issues from GitHub repositories
+ *
+ * Uses the gh CLI for authentication (no API key needed if gh is configured)
+ * Falls back to GitHub API with token if gh is not available
+ */
+export class GitHubSource extends IntegrationSource {
+    name = 'github';
+    description = 'Fetch issues from GitHub repositories';
+    ghAvailable = null;
+    async isAvailable() {
+        // First check if gh CLI is available and authenticated
+        if (await this.isGhCliAvailable()) {
+            return true;
+        }
+        // Fall back to checking for API token
+        return super.isAvailable();
+    }
+    requiresAuth() {
+        // gh CLI handles auth, so we don't strictly require it
+        return false;
+    }
+    async isGhCliAvailable() {
+        if (this.ghAvailable !== null) {
+            return this.ghAvailable;
+        }
+        try {
+            const { execa } = await import('execa');
+            await execa('gh', ['auth', 'status']);
+            this.ghAvailable = true;
+            return true;
+        }
+        catch {
+            this.ghAvailable = false;
+            return false;
+        }
+    }
+    async fetch(identifier, options) {
+        // Parse identifier: owner/repo or full URL
+        const { owner, repo } = this.parseRepoIdentifier(identifier);
+        // Determine which method to use
+        if (await this.isGhCliAvailable()) {
+            return this.fetchViaGhCli(owner, repo, options);
+        }
+        return this.fetchViaApi(owner, repo, options);
+    }
+    parseRepoIdentifier(identifier) {
+        // Handle full GitHub URLs
+        if (identifier.includes('github.com')) {
+            const match = identifier.match(/github\.com\/([^/]+)\/([^/]+)/);
+            if (match) {
+                return { owner: match[1], repo: match[2].replace(/\.git$/, '') };
+            }
+        }
+        // Handle owner/repo format
+        if (identifier.includes('/')) {
+            const [owner, repo] = identifier.split('/');
+            return { owner, repo };
+        }
+        this.error(`Invalid repository format: ${identifier}. Use owner/repo or GitHub URL.`);
+    }
+    async fetchViaGhCli(owner, repo, options) {
+        const { execa } = await import('execa');
+        // Build gh command
+        const args = [
+            'issue',
+            'list',
+            '-R',
+            `${owner}/${repo}`,
+            '--json',
+            'number,title,body,labels,state',
+        ];
+        // Add filters
+        if (options?.label) {
+            args.push('--label', options.label);
+        }
+        if (options?.status) {
+            args.push('--state', options.status);
+        }
+        else {
+            args.push('--state', 'open');
+        }
+        if (options?.limit) {
+            args.push('--limit', String(options.limit));
+        }
+        else {
+            args.push('--limit', '20');
+        }
+        const result = await execa('gh', args);
+        const issues = JSON.parse(result.stdout);
+        return this.formatIssues(issues, owner, repo);
+    }
+    async fetchViaApi(owner, repo, options) {
+        const token = await this.getApiKey();
+        // Build API URL
+        let url = `https://api.github.com/repos/${owner}/${repo}/issues?`;
+        const params = new URLSearchParams();
+        params.set('state', options?.status || 'open');
+        params.set('per_page', String(options?.limit || 20));
+        if (options?.label) {
+            params.set('labels', options.label);
+        }
+        url += params.toString();
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+                'User-Agent': 'ralph-starter/0.1.0',
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid GitHub token. Run: ralph-starter config set github.token <value>');
+            }
+            if (response.status === 404) {
+                this.error(`Repository not found: ${owner}/${repo}`);
+            }
+            this.error(`GitHub API error: ${response.status} ${response.statusText}`);
+        }
+        const issues = (await response.json());
+        return this.formatIssues(issues, owner, repo);
+    }
+    formatIssues(issues, owner, repo) {
+        if (issues.length === 0) {
+            return {
+                content: `# ${owner}/${repo}\n\nNo issues found matching the criteria.`,
+                source: `github:${owner}/${repo}`,
+                title: `${owner}/${repo} Issues`,
+                metadata: { type: 'github', issues: 0 },
+            };
+        }
+        const sections = [`# ${owner}/${repo} Issues\n`];
+        for (const issue of issues) {
+            const labels = issue.labels
+                ?.map((l) => (typeof l === 'string' ? l : l.name))
+                .filter(Boolean)
+                .join(', ');
+            sections.push(`## #${issue.number}: ${issue.title}`);
+            if (labels) {
+                sections.push(`*Labels: ${labels}*`);
+            }
+            sections.push('');
+            if (issue.body) {
+                sections.push(issue.body);
+            }
+            else {
+                sections.push('*No description provided*');
+            }
+            sections.push('\n---\n');
+        }
+        return {
+            content: sections.join('\n'),
+            source: `github:${owner}/${repo}`,
+            title: `${owner}/${repo} Issues`,
+            metadata: {
+                type: 'github',
+                owner,
+                repo,
+                issues: issues.length,
+            },
+        };
+    }
+    getRequiredCredentialKey() {
+        return 'token';
+    }
+    getHelp() {
+        return `
+github: Fetch issues from GitHub repositories
+
+Usage:
+  ralph-starter run --from github --project owner/repo
+  ralph-starter run --from github --project owner/repo --label bug
+  ralph-starter run --from github --project https://github.com/owner/repo
+
+Options:
+  --project  Repository in owner/repo format or GitHub URL
+  --label    Filter by label name
+  --status   Issue state: open, closed, all (default: open)
+  --limit    Maximum issues to fetch (default: 20)
+
+Authentication:
+  Uses 'gh' CLI if available and authenticated
+  Otherwise requires: ralph-starter config set github.token <token>
+
+Examples:
+  ralph-starter run --from github --project facebook/react --label "good first issue"
+  ralph-starter run --from github --project my-org/my-repo --status all
+`.trim();
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/sources/integrations/github.js.map

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

package/dist/sources/integrations/linear.d.ts

@@ -0,0 +1,18 @@
+import { IntegrationSource } from '../base.js';
+import type { SourceOptions, SourceResult } from '../types.js';
+/**
+ * Linear source - fetches issues from Linear
+ *
+ * Uses Linear's GraphQL API
+ * Requires API key from: https://linear.app/settings/api
+ */
+export declare class LinearSource extends IntegrationSource {
+    name: string;
+    description: string;
+    private readonly API_URL;
+    fetch(identifier: string, options?: SourceOptions): Promise<SourceResult>;
+    private fetchIssues;
+    private formatIssues;
+    getHelp(): string;
+}
+//# sourceMappingURL=linear.d.ts.map

package/dist/sources/integrations/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../src/sources/integrations/linear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,IAAI,SAAY;IAChB,WAAW,SAA8B;IAEzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAEtD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAYjE,WAAW;IA4FzB,OAAO,CAAC,YAAY;IAwFpB,OAAO,IAAI,MAAM;CAwBlB"}

package/dist/sources/integrations/linear.js

@@ -0,0 +1,197 @@
+import { IntegrationSource } from '../base.js';
+/**
+ * Linear source - fetches issues from Linear
+ *
+ * Uses Linear's GraphQL API
+ * Requires API key from: https://linear.app/settings/api
+ */
+export class LinearSource extends IntegrationSource {
+    name = 'linear';
+    description = 'Fetch issues from Linear';
+    API_URL = 'https://api.linear.app/graphql';
+    async fetch(identifier, options) {
+        const apiKey = await this.getApiKey();
+        // identifier can be project/team name or 'all'
+        const projectName = options?.project || identifier;
+        // Fetch issues with GraphQL
+        const issues = await this.fetchIssues(apiKey, projectName, options);
+        return this.formatIssues(issues, projectName);
+    }
+    async fetchIssues(apiKey, projectName, options) {
+        const limit = options?.limit || 50;
+        // Build filter
+        const filter = {};
+        if (projectName && projectName !== 'all') {
+            // Try to match by project or team name
+            filter.or = [
+                { project: { name: { containsIgnoreCase: projectName } } },
+                { team: { name: { containsIgnoreCase: projectName } } },
+                { team: { key: { eq: projectName.toUpperCase() } } },
+            ];
+        }
+        if (options?.label) {
+            filter.labels = { name: { containsIgnoreCase: options.label } };
+        }
+        if (options?.status) {
+            filter.state = { name: { containsIgnoreCase: options.status } };
+        }
+        else {
+            // Default to non-completed issues
+            filter.completedAt = { null: true };
+        }
+        const query = `
+      query GetIssues($filter: IssueFilter, $first: Int) {
+        issues(filter: $filter, first: $first, orderBy: updatedAt) {
+          nodes {
+            id
+            identifier
+            title
+            description
+            priority
+            priorityLabel
+            state {
+              name
+              type
+            }
+            labels {
+              nodes {
+                name
+              }
+            }
+            project {
+              name
+            }
+            team {
+              name
+              key
+            }
+          }
+        }
+      }
+    `;
+        const response = await fetch(this.API_URL, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: apiKey,
+            },
+            body: JSON.stringify({
+                query,
+                variables: {
+                    filter: Object.keys(filter).length > 0 ? filter : undefined,
+                    first: limit,
+                },
+            }),
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid Linear API key. Run: ralph-starter config set linear.apiKey <key>');
+            }
+            this.error(`Linear API error: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (data.errors) {
+            this.error(`Linear API error: ${data.errors[0].message}`);
+        }
+        return data.data.issues.nodes;
+    }
+    formatIssues(issues, projectName) {
+        const title = projectName === 'all' ? 'All Issues' : `${projectName} Issues`;
+        if (issues.length === 0) {
+            return {
+                content: `# ${title}\n\nNo issues found.`,
+                source: `linear:${projectName}`,
+                title,
+                metadata: { type: 'linear', issues: 0 },
+            };
+        }
+        const sections = [`# ${title}\n`];
+        // Group by priority
+        const priorityOrder = ['Urgent', 'High', 'Medium', 'Low', 'No priority'];
+        const byPriority = {};
+        for (const issue of issues) {
+            const priority = issue.priorityLabel || 'No priority';
+            if (!byPriority[priority]) {
+                byPriority[priority] = [];
+            }
+            byPriority[priority].push(issue);
+        }
+        const priorityEmoji = {
+            Urgent: '🔴',
+            High: '🟠',
+            Medium: '🟡',
+            Low: '🔵',
+            'No priority': '⚪',
+        };
+        for (const priority of priorityOrder) {
+            const priorityIssues = byPriority[priority];
+            if (!priorityIssues || priorityIssues.length === 0)
+                continue;
+            sections.push(`\n## ${priorityEmoji[priority] || '⚪'} ${priority}\n`);
+            for (const issue of priorityIssues) {
+                const _teamKey = issue.team?.key || '';
+                sections.push(`### ${issue.identifier}: ${issue.title}`);
+                const meta = [];
+                if (issue.state?.name) {
+                    meta.push(`Status: ${issue.state.name}`);
+                }
+                if (issue.team?.name) {
+                    meta.push(`Team: ${issue.team.name}`);
+                }
+                if (issue.project?.name) {
+                    meta.push(`Project: ${issue.project.name}`);
+                }
+                const labels = issue.labels?.nodes?.map((l) => l.name).filter(Boolean);
+                if (labels && labels.length > 0) {
+                    meta.push(`Labels: ${labels.join(', ')}`);
+                }
+                if (meta.length > 0) {
+                    sections.push(`*${meta.join(' | ')}*`);
+                }
+                sections.push('');
+                if (issue.description) {
+                    sections.push(issue.description);
+                }
+                else {
+                    sections.push('*No description*');
+                }
+                sections.push('');
+            }
+        }
+        return {
+            content: sections.join('\n'),
+            source: `linear:${projectName}`,
+            title,
+            metadata: {
+                type: 'linear',
+                project: projectName,
+                issues: issues.length,
+            },
+        };
+    }
+    getHelp() {
+        return `
+linear: Fetch issues from Linear
+
+Usage:
+  ralph-starter run --from linear --project "My Project"
+  ralph-starter run --from linear --project TEAM-KEY --label "feature"
+
+Options:
+  --project  Project name, team name, or team key (e.g., ENG)
+  --label    Filter by label name
+  --status   Filter by status name (e.g., "In Progress", "Todo")
+  --limit    Maximum issues to fetch (default: 50)
+
+Setup:
+  1. Get API key from: https://linear.app/settings/api
+  2. Run: ralph-starter config set linear.apiKey <key>
+
+Examples:
+  ralph-starter run --from linear --project "Mobile App"
+  ralph-starter run --from linear --project ENG --label "bug"
+  ralph-starter run --from linear --project all --status "In Progress"
+`.trim();
+    }
+}
+//# sourceMappingURL=linear.js.map

package/dist/sources/integrations/linear.js.map

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

package/dist/sources/integrations/notion.d.ts

@@ -0,0 +1,39 @@
+import { IntegrationSource } from '../base.js';
+import type { SourceOptions, SourceResult } from '../types.js';
+/**
+ * Notion source - fetches pages and databases from Notion
+ *
+ * Requires integration token from: https://www.notion.so/my-integrations
+ * The integration must be added to the pages/databases you want to access
+ */
+export declare class NotionSource extends IntegrationSource {
+    name: string;
+    description: string;
+    private readonly API_BASE;
+    private readonly API_VERSION;
+    protected getRequiredCredentialKey(): string;
+    fetch(identifier: string, options?: SourceOptions): Promise<SourceResult>;
+    private isNotionUrl;
+    private isNotionId;
+    private extractIdFromUrl;
+    private formatNotionId;
+    private fetchByUrl;
+    private fetchById;
+    private searchNotion;
+    private fetchPage;
+    private fetchBlocks;
+    private fetchDatabase;
+    private queryDatabase;
+    private apiRequest;
+    private formatPage;
+    private formatDatabase;
+    private getPageTitle;
+    private getDatabaseTitle;
+    private formatProperties;
+    private getPropertyValue;
+    private blocksToMarkdown;
+    private blockToMarkdown;
+    private richTextToPlain;
+    getHelp(): string;
+}
+//# sourceMappingURL=notion.d.ts.map

package/dist/sources/integrations/notion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.d.ts","sourceRoot":"","sources":["../../../src/sources/integrations/notion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,IAAI,SAAY;IAChB,WAAW,SAA2C;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAE5C,SAAS,CAAC,wBAAwB,IAAI,MAAM;IAItC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB/E,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;YAMR,UAAU;YAKV,SAAS;YAoBT,YAAY;YAmDZ,SAAS;YAIT,WAAW;YAKX,aAAa;YAIb,aAAa;YAOb,UAAU;IAgCxB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IA8CvB,OAAO,CAAC,eAAe;IAKvB,OAAO,IAAI,MAAM;CA2BlB"}