ralph-starter 0.0.1 → 0.1.1-beta.1

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

@@ -0,0 +1,37 @@
+/**
+ * Linear OAuth Provider with PKCE Support
+ *
+ * Linear supports PKCE (Proof Key for Code Exchange) which allows
+ * public clients (like CLI apps) to authenticate without a client secret.
+ *
+ * Linear's OAuth flow:
+ * https://developers.linear.app/docs/oauth/authentication
+ *
+ * To configure ralph-starter's Linear OAuth app:
+ * 1. Go to https://linear.app/settings/api/applications
+ * 2. Create a new OAuth application
+ * 3. Set redirect URI to http://127.0.0.1:52847/callback
+ * 4. Copy the Client ID and set RALPH_LINEAR_CLIENT_ID env var
+ */
+import { BaseOAuthProvider } from '../../auth/providers/base.js';
+export declare class LinearOAuthProvider extends BaseOAuthProvider {
+    name: string;
+    displayName: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    supportsPKCE: boolean;
+    scopes: string[];
+    clientId: string;
+    clientSecret: string | undefined;
+    authParams: {
+        prompt: string;
+        actor: string;
+    };
+    /**
+     * Check if Linear OAuth is configured
+     * With PKCE, we only need the client_id (no secret required)
+     */
+    isConfigured(): boolean;
+}
+export declare const linearProvider: LinearOAuthProvider;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/integrations/linear/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,IAAI,SAAY;IAChB,WAAW,SAAY;IACvB,gBAAgB,SAAwC;IACxD,QAAQ,SAAwC;IAGhD,YAAY,UAAQ;IAGpB,MAAM,WAEJ;IAGF,QAAQ,SAA4C;IAGpD,YAAY,qBAA0C;IAEtD,UAAU;;;MAGR;IAEF;;;OAGG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED,eAAO,MAAM,cAAc,qBAA4B,CAAC"}

package/dist/integrations/linear/auth.js

@@ -0,0 +1,45 @@
+/**
+ * Linear OAuth Provider with PKCE Support
+ *
+ * Linear supports PKCE (Proof Key for Code Exchange) which allows
+ * public clients (like CLI apps) to authenticate without a client secret.
+ *
+ * Linear's OAuth flow:
+ * https://developers.linear.app/docs/oauth/authentication
+ *
+ * To configure ralph-starter's Linear OAuth app:
+ * 1. Go to https://linear.app/settings/api/applications
+ * 2. Create a new OAuth application
+ * 3. Set redirect URI to http://127.0.0.1:52847/callback
+ * 4. Copy the Client ID and set RALPH_LINEAR_CLIENT_ID env var
+ */
+import { BaseOAuthProvider } from '../../auth/providers/base.js';
+export class LinearOAuthProvider extends BaseOAuthProvider {
+    name = 'linear';
+    displayName = 'Linear';
+    authorizationUrl = 'https://linear.app/oauth/authorize';
+    tokenUrl = 'https://api.linear.app/oauth/token';
+    // Linear supports PKCE - no client secret needed!
+    supportsPKCE = true;
+    // Linear scopes
+    scopes = [
+        'read', // Read access to all resources
+    ];
+    // Client ID from environment variable
+    clientId = process.env.RALPH_LINEAR_CLIENT_ID || '';
+    // Client secret is optional with PKCE
+    clientSecret = process.env.RALPH_LINEAR_CLIENT_SECRET;
+    authParams = {
+        prompt: 'consent', // Always show consent screen
+        actor: 'user', // Act as the authorizing user
+    };
+    /**
+     * Check if Linear OAuth is configured
+     * With PKCE, we only need the client_id (no secret required)
+     */
+    isConfigured() {
+        return !!this.clientId;
+    }
+}
+export const linearProvider = new LinearOAuthProvider();
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/integrations/linear/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,QAAQ,CAAC;IACvB,gBAAgB,GAAG,oCAAoC,CAAC;IACxD,QAAQ,GAAG,oCAAoC,CAAC;IAEhD,kDAAkD;IAClD,YAAY,GAAG,IAAI,CAAC;IAEpB,gBAAgB;IAChB,MAAM,GAAG;QACP,MAAM,EAAE,+BAA+B;KACxC,CAAC;IAEF,sCAAsC;IACtC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAEpD,sCAAsC;IACtC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAEtD,UAAU,GAAG;QACX,MAAM,EAAE,SAAS,EAAE,6BAA6B;QAChD,KAAK,EAAE,MAAM,EAAE,8BAA8B;KAC9C,CAAC;IAEF;;;OAGG;IACH,YAAY;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Linear Integration
+ *
+ * Fetches issues from Linear workspaces.
+ * Uses the Linear CLI for authentication or API key.
+ */
+export { LinearOAuthProvider, linearProvider } from './auth.js';
+export { LinearIntegration } from './source.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/linear/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/linear/index.js

@@ -0,0 +1,9 @@
+/**
+ * Linear Integration
+ *
+ * Fetches issues from Linear workspaces.
+ * Uses the Linear CLI for authentication or API key.
+ */
+export { LinearOAuthProvider, linearProvider } from './auth.js';
+export { LinearIntegration } from './source.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/linear/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Linear Integration Source
+ *
+ * Fetches issues from Linear using GraphQL API.
+ * Supports CLI auth (`linear auth login`) or API key.
+ */
+import { type AuthMethod, BaseIntegration, type IntegrationOptions, type IntegrationResult } from '../base.js';
+export declare class LinearIntegration extends BaseIntegration {
+    name: string;
+    displayName: string;
+    description: string;
+    website: string;
+    authMethods: AuthMethod[];
+    private readonly API_URL;
+    private linearCliAvailable;
+    /**
+     * Check if Linear CLI is available and authenticated
+     */
+    protected isCliAvailable(): Promise<boolean>;
+    fetch(identifier: string, options?: IntegrationOptions): Promise<IntegrationResult>;
+    private getApiKeyFromCli;
+    private fetchIssues;
+    private formatIssues;
+    getHelp(): string;
+}
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/integrations/linear/source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAkCpB,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,IAAI,SAAY;IAChB,WAAW,SAAY;IACvB,WAAW,SAA8B;IACzC,OAAO,SAAwB;IAG/B,WAAW,EAAE,UAAU,EAAE,CAA+B;IAExD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,kBAAkB,CAAwB;IAElD;;OAEG;cACa,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB5C,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAyB3E,gBAAgB;YAYhB,WAAW;IA2FzB,OAAO,CAAC,YAAY;IAuFpB,OAAO,IAAI,MAAM;CA8BlB"}

package/dist/integrations/linear/source.js

@@ -0,0 +1,248 @@
+/**
+ * Linear Integration Source
+ *
+ * Fetches issues from Linear using GraphQL API.
+ * Supports CLI auth (`linear auth login`) or API key.
+ */
+import { BaseIntegration, } from '../base.js';
+export class LinearIntegration extends BaseIntegration {
+    name = 'linear';
+    displayName = 'Linear';
+    description = 'Fetch issues from Linear';
+    website = 'https://linear.app';
+    // Supports CLI auth, API key, and OAuth
+    authMethods = ['cli', 'api-key', 'oauth'];
+    API_URL = 'https://api.linear.app/graphql';
+    linearCliAvailable = null;
+    /**
+     * Check if Linear CLI is available and authenticated
+     */
+    async isCliAvailable() {
+        if (this.linearCliAvailable !== null) {
+            return this.linearCliAvailable;
+        }
+        try {
+            const { execa } = await import('execa');
+            // Check if linear CLI is installed and authenticated
+            const result = await execa('linear', ['whoami'], { reject: false });
+            this.linearCliAvailable = result.exitCode === 0;
+            return this.linearCliAvailable;
+        }
+        catch {
+            this.linearCliAvailable = false;
+            return false;
+        }
+    }
+    async fetch(identifier, options) {
+        const projectName = options?.project || identifier;
+        const authMethod = await this.getConfiguredAuthMethod();
+        if (!authMethod) {
+            this.error('No authentication configured. Options:\n' +
+                '  1. Install Linear CLI: npm install -g @linear/cli && linear auth login\n' +
+                '  2. Use API key: ralph-starter config set linear.apiKey <key>');
+        }
+        // Get API key based on auth method
+        let apiKey;
+        if (authMethod === 'cli') {
+            apiKey = await this.getApiKeyFromCli();
+        }
+        else {
+            apiKey = await this.getApiKey();
+        }
+        const issues = await this.fetchIssues(apiKey, projectName, options);
+        return this.formatIssues(issues, projectName);
+    }
+    async getApiKeyFromCli() {
+        try {
+            const { execa } = await import('execa');
+            // Linear CLI stores token which we can use
+            const result = await execa('linear', ['config', 'get', 'apiKey']);
+            return result.stdout.trim();
+        }
+        catch {
+            // Fall back to regular API key
+            return this.getApiKey();
+        }
+    }
+    async fetchIssues(apiKey, projectName, options) {
+        const limit = options?.limit || 50;
+        // Build filter
+        const filter = {};
+        if (projectName && projectName !== 'all') {
+            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) {
+                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)
+
+Authentication:
+
+Option 1: Linear CLI (recommended)
+  1. Install: npm install -g @linear/cli
+  2. Login: linear auth login
+
+Option 2: API Key
+  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=source.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Notion Integration
+ *
+ * Fetches pages from Notion workspaces.
+ * Supports public pages via HTML fetch (no auth) and private pages via API.
+ */
+export { NotionIntegration } from './source.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/notion/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/notion/index.js

@@ -0,0 +1,8 @@
+/**
+ * Notion Integration
+ *
+ * Fetches pages from Notion workspaces.
+ * Supports public pages via HTML fetch (no auth) and private pages via API.
+ */
+export { NotionIntegration } from './source.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/notion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/notion/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Notion Integration Source
+ *
+ * Fetches pages from Notion:
+ * - Public pages: HTML fetch (no auth needed)
+ * - Private pages: Notion API (requires token)
+ */
+import { type AuthMethod, BaseIntegration, type IntegrationOptions, type IntegrationResult } from '../base.js';
+export declare class NotionIntegration extends BaseIntegration {
+    name: string;
+    displayName: string;
+    description: string;
+    website: string;
+    authMethods: AuthMethod[];
+    private readonly API_BASE;
+    private readonly API_VERSION;
+    fetch(identifier: string, options?: IntegrationOptions): Promise<IntegrationResult>;
+    private isNotionUrl;
+    /**
+     * Fetch a public Notion page via HTML
+     * Returns null if the page is not public
+     */
+    private fetchPublicPage;
+    /**
+     * Convert Notion HTML to markdown
+     */
+    private htmlToMarkdown;
+    /**
+     * Extract title from Notion HTML
+     */
+    private extractTitle;
+    /**
+     * Fetch via Notion API (for private pages or search)
+     */
+    private fetchViaApi;
+    private isNotionId;
+    private extractIdFromUrl;
+    private formatNotionId;
+    private fetchPageById;
+    private searchNotion;
+    private apiRequest;
+    private formatPage;
+    private formatDatabase;
+    private getPageTitle;
+    private getDatabaseTitle;
+    private formatProperties;
+    private getPropertyValue;
+    private blocksToMarkdown;
+    private blockToMarkdown;
+    private richTextToPlain;
+    getHelp(): string;
+}
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/integrations/notion/source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAoBpB,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,IAAI,SAAY;IAChB,WAAW,SAAY;IACvB,WAAW,SAAiD;IAC5D,OAAO,SAAuB;IAG9B,WAAW,EAAE,UAAU,EAAE,CAAuB;IAEhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAEtC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BzF,OAAO,CAAC,WAAW;IAInB;;;OAGG;YACW,eAAe;IAuC7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAwDtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;YACW,WAAW;IAqBzB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,cAAc;YAKR,aAAa;YA+Bb,YAAY;YAsDZ,UAAU;IA8BxB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,eAAe;IAKvB,OAAO,IAAI,MAAM;CAsClB"}