ralph-starter 0.0.1 → 0.1.1-beta.0

package/dist/sources/integrations/notion.js

@@ -0,0 +1,343 @@
+import { IntegrationSource } from '../base.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 class NotionSource extends IntegrationSource {
+    name = 'notion';
+    description = 'Fetch pages and databases from Notion';
+    API_BASE = 'https://api.notion.com/v1';
+    API_VERSION = '2022-06-28';
+    getRequiredCredentialKey() {
+        return 'token';
+    }
+    async fetch(identifier, options) {
+        const token = await this.getApiKey();
+        // identifier can be a page URL, page ID, database ID, or search query
+        if (this.isNotionUrl(identifier)) {
+            return this.fetchByUrl(token, identifier);
+        }
+        if (this.isNotionId(identifier)) {
+            return this.fetchById(token, identifier);
+        }
+        // Treat as search query
+        return this.searchNotion(token, identifier, options);
+    }
+    isNotionUrl(str) {
+        return str.includes('notion.so') || str.includes('notion.site');
+    }
+    isNotionId(str) {
+        // Notion IDs are 32 hex chars (with or without hyphens)
+        const cleaned = str.replace(/-/g, '');
+        return /^[a-f0-9]{32}$/i.test(cleaned);
+    }
+    extractIdFromUrl(url) {
+        // Handle various Notion URL formats
+        // https://notion.so/Page-Title-abc123def456...
+        // https://www.notion.so/workspace/Page-Title-abc123def456...
+        const match = url.match(/([a-f0-9]{32})/i);
+        if (match) {
+            return match[1];
+        }
+        // Try the last segment with potential ID
+        const segments = url.split(/[-/]/);
+        for (let i = segments.length - 1; i >= 0; i--) {
+            const segment = segments[i].replace(/\?.*$/, '');
+            if (/^[a-f0-9]{32}$/i.test(segment)) {
+                return segment;
+            }
+        }
+        throw new Error(`Could not extract Notion ID from URL: ${url}`);
+    }
+    formatNotionId(id) {
+        // Add hyphens to Notion ID: 8-4-4-4-12
+        const clean = id.replace(/-/g, '');
+        return `${clean.slice(0, 8)}-${clean.slice(8, 12)}-${clean.slice(12, 16)}-${clean.slice(16, 20)}-${clean.slice(20)}`;
+    }
+    async fetchByUrl(token, url) {
+        const id = this.extractIdFromUrl(url);
+        return this.fetchById(token, id);
+    }
+    async fetchById(token, id) {
+        const formattedId = this.formatNotionId(id);
+        // Try as page first
+        try {
+            const page = await this.fetchPage(token, formattedId);
+            const blocks = await this.fetchBlocks(token, formattedId);
+            return this.formatPage(page, blocks);
+        }
+        catch (_error) {
+            // Try as database
+            try {
+                const database = await this.fetchDatabase(token, formattedId);
+                const items = await this.queryDatabase(token, formattedId);
+                return this.formatDatabase(database, items);
+            }
+            catch {
+                this.error(`Could not fetch Notion page or database: ${id}`);
+            }
+        }
+    }
+    async searchNotion(token, query, options) {
+        const response = await this.apiRequest(token, 'POST', '/search', {
+            query,
+            filter: { property: 'object', value: 'page' },
+            page_size: options?.limit || 10,
+        });
+        const results = response.results;
+        if (results.length === 0) {
+            return {
+                content: `# Search: "${query}"\n\nNo results found.`,
+                source: `notion:search:${query}`,
+                title: `Search: ${query}`,
+                metadata: { type: 'notion', query, results: 0 },
+            };
+        }
+        const sections = [`# Search: "${query}"\n`];
+        for (const page of results) {
+            const title = this.getPageTitle(page);
+            sections.push(`## ${title}\n`);
+            // Fetch page content
+            try {
+                const blocks = await this.fetchBlocks(token, page.id);
+                sections.push(this.blocksToMarkdown(blocks));
+            }
+            catch {
+                sections.push('*Could not fetch page content*');
+            }
+            sections.push('\n---\n');
+        }
+        return {
+            content: sections.join('\n'),
+            source: `notion:search:${query}`,
+            title: `Search: ${query}`,
+            metadata: {
+                type: 'notion',
+                query,
+                results: results.length,
+            },
+        };
+    }
+    async fetchPage(token, id) {
+        return this.apiRequest(token, 'GET', `/pages/${id}`);
+    }
+    async fetchBlocks(token, id) {
+        const response = await this.apiRequest(token, 'GET', `/blocks/${id}/children?page_size=100`);
+        return response.results;
+    }
+    async fetchDatabase(token, id) {
+        return this.apiRequest(token, 'GET', `/databases/${id}`);
+    }
+    async queryDatabase(token, id) {
+        const response = await this.apiRequest(token, 'POST', `/databases/${id}/query`, {
+            page_size: 50,
+        });
+        return response.results;
+    }
+    async apiRequest(token, method, path, body) {
+        const response = await fetch(`${this.API_BASE}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Notion-Version': this.API_VERSION,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid Notion token. Run: ralph-starter config set notion.token <token>');
+            }
+            if (response.status === 404) {
+                throw new Error('Not found');
+            }
+            const error = await response.json().catch(() => ({}));
+            this.error(`Notion API error: ${response.status} - ${error.message || response.statusText}`);
+        }
+        return response.json();
+    }
+    formatPage(page, blocks) {
+        const title = this.getPageTitle(page);
+        const content = this.blocksToMarkdown(blocks);
+        return {
+            content: `# ${title}\n\n${content}`,
+            source: `notion:${page.id}`,
+            title,
+            metadata: {
+                type: 'notion',
+                objectType: 'page',
+                id: page.id,
+            },
+        };
+    }
+    formatDatabase(database, items) {
+        const title = this.getDatabaseTitle(database);
+        const sections = [`# ${title}\n`];
+        if (items.length === 0) {
+            sections.push('*No items in database*');
+        }
+        else {
+            for (const item of items) {
+                const itemTitle = this.getPageTitle(item);
+                sections.push(`## ${itemTitle}\n`);
+                // Extract properties
+                const props = this.formatProperties(item.properties);
+                if (props) {
+                    sections.push(props);
+                }
+                sections.push('');
+            }
+        }
+        return {
+            content: sections.join('\n'),
+            source: `notion:${database.id}`,
+            title,
+            metadata: {
+                type: 'notion',
+                objectType: 'database',
+                id: database.id,
+                items: items.length,
+            },
+        };
+    }
+    getPageTitle(page) {
+        const titleProp = Object.values(page.properties || {}).find((p) => p.type === 'title');
+        if (titleProp?.title?.[0]?.plain_text) {
+            return titleProp.title[0].plain_text;
+        }
+        return 'Untitled';
+    }
+    getDatabaseTitle(database) {
+        if (database.title?.[0]?.plain_text) {
+            return database.title[0].plain_text;
+        }
+        return 'Untitled Database';
+    }
+    formatProperties(properties) {
+        const lines = [];
+        for (const [key, prop] of Object.entries(properties)) {
+            if (prop.type === 'title')
+                continue; // Already used as heading
+            const value = this.getPropertyValue(prop);
+            if (value) {
+                lines.push(`- **${key}**: ${value}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    getPropertyValue(prop) {
+        switch (prop.type) {
+            case 'rich_text':
+                return prop.rich_text?.[0]?.plain_text || null;
+            case 'number':
+                return prop.number?.toString() || null;
+            case 'select':
+                return prop.select?.name || null;
+            case 'multi_select':
+                return prop.multi_select?.map((s) => s.name).join(', ') || null;
+            case 'date':
+                return prop.date?.start || null;
+            case 'checkbox':
+                return prop.checkbox ? '✓' : '✗';
+            case 'url':
+                return prop.url || null;
+            case 'email':
+                return prop.email || null;
+            case 'phone_number':
+                return prop.phone_number || null;
+            case 'status':
+                return prop.status?.name || null;
+            default:
+                return null;
+        }
+    }
+    blocksToMarkdown(blocks) {
+        const lines = [];
+        for (const block of blocks) {
+            const md = this.blockToMarkdown(block);
+            if (md) {
+                lines.push(md);
+            }
+        }
+        return lines.join('\n');
+    }
+    blockToMarkdown(block) {
+        const content = block[block.type];
+        if (!content)
+            return '';
+        const text = this.richTextToPlain(content.rich_text);
+        switch (block.type) {
+            case 'paragraph':
+                return `${text}\n`;
+            case 'heading_1':
+                return `## ${text}\n`;
+            case 'heading_2':
+                return `### ${text}\n`;
+            case 'heading_3':
+                return `#### ${text}\n`;
+            case 'bulleted_list_item':
+                return `- ${text}`;
+            case 'numbered_list_item':
+                return `1. ${text}`;
+            case 'to_do': {
+                const checked = content.checked ? 'x' : ' ';
+                return `- [${checked}] ${text}`;
+            }
+            case 'toggle':
+                return `<details>\n<summary>${text}</summary>\n</details>\n`;
+            case 'quote':
+                return `> ${text}\n`;
+            case 'callout': {
+                const emoji = content.icon?.emoji || '💡';
+                return `> ${emoji} ${text}\n`;
+            }
+            case 'code': {
+                const lang = content.language || '';
+                return `\`\`\`${lang}\n${text}\n\`\`\`\n`;
+            }
+            case 'divider':
+                return '---\n';
+            case 'image': {
+                const url = content.file?.url || content.external?.url || '';
+                return url ? `![Image](${url})\n` : '';
+            }
+            default:
+                return text ? `${text}\n` : '';
+        }
+    }
+    richTextToPlain(richText) {
+        if (!richText)
+            return '';
+        return richText.map((t) => t.plain_text || '').join('');
+    }
+    getHelp() {
+        return `
+notion: Fetch pages and databases from Notion
+
+Usage:
+  ralph-starter run --from notion --project "page-id-or-url"
+  ralph-starter run --from notion --project "search query"
+
+Options:
+  --project  Page URL, page ID, database ID, or search query
+  --limit    Maximum results for search (default: 10)
+
+Setup:
+  1. Create integration at: https://www.notion.so/my-integrations
+  2. Run: ralph-starter config set notion.token <token>
+  3. Share pages/databases with your integration in Notion
+
+Examples:
+  ralph-starter run --from notion --project "https://notion.so/My-Spec-abc123..."
+  ralph-starter run --from notion --project "Product Requirements"
+  ralph-starter run --from notion --project "abc123def456789..."
+
+Notes:
+  - Pages must be shared with your integration to be accessible
+  - Search only finds pages, not databases
+`.trim();
+    }
+}
+//# sourceMappingURL=notion.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { IntegrationSource } from '../base.js';
+import type { SourceOptions, SourceResult } from '../types.js';
+/**
+ * Todoist source - fetches tasks from Todoist projects
+ *
+ * Requires API token from: https://todoist.com/prefs/integrations
+ */
+export declare class TodoistSource extends IntegrationSource {
+    name: string;
+    description: string;
+    private readonly API_BASE;
+    fetch(identifier: string, options?: SourceOptions): Promise<SourceResult>;
+    private fetchProjects;
+    private fetchTasks;
+    private formatTasks;
+    getHelp(): string;
+}
+//# sourceMappingURL=todoist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todoist.d.ts","sourceRoot":"","sources":["../../../src/sources/integrations/todoist.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;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,IAAI,SAAa;IACjB,WAAW,SAAuC;IAElD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAExD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAgCjE,aAAa;YAmBb,UAAU;IAsCxB,OAAO,CAAC,WAAW;IAwEnB,OAAO,IAAI,MAAM;CAsBlB"}

package/dist/sources/integrations/todoist.js

@@ -0,0 +1,154 @@
+import { IntegrationSource } from '../base.js';
+/**
+ * Todoist source - fetches tasks from Todoist projects
+ *
+ * Requires API token from: https://todoist.com/prefs/integrations
+ */
+export class TodoistSource extends IntegrationSource {
+    name = 'todoist';
+    description = 'Fetch tasks from Todoist projects';
+    API_BASE = 'https://api.todoist.com/rest/v2';
+    async fetch(identifier, options) {
+        const token = await this.getApiKey();
+        // identifier can be project name or 'all'
+        const projectName = options?.project || identifier;
+        // Get projects to find the right one
+        const projects = await this.fetchProjects(token);
+        let projectId = null;
+        let projectTitle = 'All Tasks';
+        if (projectName && projectName !== 'all') {
+            const project = projects.find((p) => p.name.toLowerCase() === projectName.toLowerCase() || p.id === projectName);
+            if (!project) {
+                const available = projects.map((p) => p.name).join(', ');
+                this.error(`Project not found: ${projectName}. Available: ${available}`);
+            }
+            projectId = project.id;
+            projectTitle = project.name;
+        }
+        // Fetch tasks
+        const tasks = await this.fetchTasks(token, projectId, options);
+        return this.formatTasks(tasks, projectTitle);
+    }
+    async fetchProjects(token) {
+        const response = await fetch(`${this.API_BASE}/projects`, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid Todoist API token. Run: ralph-starter config set todoist.apiKey <token>');
+            }
+            this.error(`Todoist API error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async fetchTasks(token, projectId, options) {
+        const params = new URLSearchParams();
+        if (projectId) {
+            params.set('project_id', projectId);
+        }
+        const url = `${this.API_BASE}/tasks?${params.toString()}`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (!response.ok) {
+            this.error(`Todoist API error: ${response.status} ${response.statusText}`);
+        }
+        let tasks = await response.json();
+        // Filter by label if specified
+        if (options?.label) {
+            const labelLower = options.label.toLowerCase();
+            tasks = tasks.filter((t) => t.labels.some((l) => l.toLowerCase() === labelLower));
+        }
+        // Apply limit
+        const limit = options?.limit || 50;
+        tasks = tasks.slice(0, limit);
+        return tasks;
+    }
+    formatTasks(tasks, projectTitle) {
+        if (tasks.length === 0) {
+            return {
+                content: `# ${projectTitle}\n\nNo tasks found.`,
+                source: `todoist:${projectTitle}`,
+                title: projectTitle,
+                metadata: { type: 'todoist', tasks: 0 },
+            };
+        }
+        const sections = [`# ${projectTitle}\n`];
+        // Group by priority
+        const priorities = {
+            4: [], // p1 (urgent)
+            3: [], // p2
+            2: [], // p3
+            1: [], // p4 (default)
+        };
+        for (const task of tasks) {
+            priorities[task.priority].push(task);
+        }
+        const priorityNames = {
+            4: '🔴 Priority 1 (Urgent)',
+            3: '🟠 Priority 2 (High)',
+            2: '🟡 Priority 3 (Medium)',
+            1: '⚪ Priority 4 (Normal)',
+        };
+        for (const priority of [4, 3, 2, 1]) {
+            const priorityTasks = priorities[priority];
+            if (priorityTasks.length === 0)
+                continue;
+            sections.push(`\n## ${priorityNames[priority]}\n`);
+            for (const task of priorityTasks) {
+                sections.push(`### ${task.content}`);
+                if (task.description) {
+                    sections.push('', task.description);
+                }
+                const meta = [];
+                if (task.labels.length > 0) {
+                    meta.push(`Labels: ${task.labels.join(', ')}`);
+                }
+                if (task.due) {
+                    meta.push(`Due: ${task.due.string}`);
+                }
+                if (meta.length > 0) {
+                    sections.push('', `*${meta.join(' | ')}*`);
+                }
+                sections.push('');
+            }
+        }
+        return {
+            content: sections.join('\n'),
+            source: `todoist:${projectTitle}`,
+            title: projectTitle,
+            metadata: {
+                type: 'todoist',
+                project: projectTitle,
+                tasks: tasks.length,
+            },
+        };
+    }
+    getHelp() {
+        return `
+todoist: Fetch tasks from Todoist projects
+
+Usage:
+  ralph-starter run --from todoist --project "My Project"
+  ralph-starter run --from todoist --project all --label "feature"
+
+Options:
+  --project  Project name or 'all' for all projects
+  --label    Filter by label name
+  --limit    Maximum tasks to fetch (default: 50)
+
+Setup:
+  1. Get API token from: https://todoist.com/prefs/integrations
+  2. Run: ralph-starter config set todoist.apiKey <token>
+
+Examples:
+  ralph-starter run --from todoist --project "App Ideas"
+  ralph-starter run --from todoist --project all --label "mvp"
+`.trim();
+    }
+}
+//# sourceMappingURL=todoist.js.map

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

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

package/dist/sources/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Input source types for ralph-starter
+ *
+ * Sources allow fetching specs from various locations:
+ * - Built-in: files, URLs, PDFs
+ * - Integrations: Todoist, Linear, Notion, GitHub
+ */
+/**
+ * Result from fetching a source
+ */
+export interface SourceResult {
+    /** The spec content in markdown format */
+    content: string;
+    /** Original source identifier */
+    source: string;
+    /** Optional title/name extracted from source */
+    title?: string;
+    /** Metadata about the fetch */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options passed to source fetch
+ */
+export interface SourceOptions {
+    /** Project name/ID for task app integrations */
+    project?: string;
+    /** Label/tag filter for task app integrations */
+    label?: string;
+    /** Status filter (e.g., 'open', 'in_progress') */
+    status?: string;
+    /** Maximum items to fetch */
+    limit?: number;
+    /** Custom headers for URL fetches */
+    headers?: Record<string, string>;
+}
+/**
+ * Credentials for authenticated sources
+ */
+export interface SourceCredentials {
+    apiKey?: string;
+    token?: string;
+    secret?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Source configuration stored in config file
+ */
+export interface SourceConfig {
+    credentials?: SourceCredentials;
+    defaults?: SourceOptions;
+    enabled?: boolean;
+}
+/**
+ * All sources configuration
+ */
+export interface SourcesConfig {
+    sources: Record<string, SourceConfig>;
+}
+/**
+ * Input source interface
+ * All sources (builtin and integrations) implement this
+ */
+export interface InputSource {
+    /** Unique identifier for the source */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Source type category */
+    type: 'builtin' | 'integration';
+    /**
+     * Check if this source is available
+     * For integrations, checks if credentials are configured
+     * For builtins, checks if dependencies are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Whether this source requires authentication
+     */
+    requiresAuth(): boolean;
+    /**
+     * Fetch content from this source
+     * @param identifier - Source-specific identifier (path, URL, project name, etc.)
+     * @param options - Additional options for the fetch
+     */
+    fetch(identifier: string, options?: SourceOptions): Promise<SourceResult>;
+    /**
+     * Validate that credentials are configured correctly
+     * Only relevant for sources that require auth
+     */
+    validateCredentials?(): Promise<boolean>;
+    /**
+     * Get help text for using this source
+     */
+    getHelp(): string;
+}
+/**
+ * Source metadata for registry
+ */
+export interface SourceInfo {
+    name: string;
+    description: string;
+    type: 'builtin' | 'integration';
+    requiresAuth: boolean;
+    available: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;IAEhC;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1E;;;OAGG;IACH,mBAAmB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/sources/types.js

@@ -0,0 +1,9 @@
+/**
+ * Input source types for ralph-starter
+ *
+ * Sources allow fetching specs from various locations:
+ * - Built-in: files, URLs, PDFs
+ * - Integrations: Todoist, Linear, Notion, GitHub
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}