ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/sources/config.js

@@ -0,0 +1,215 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.ralph-starter');
+const SOURCES_CONFIG_FILE = join(CONFIG_DIR, 'sources.json');
+/**
+ * Environment variable mappings for each source
+ * Format: { sourceName: { credentialKey: ENV_VAR_NAME } }
+ */
+const ENV_VAR_MAPPINGS = {
+    todoist: { apiKey: 'TODOIST_API_KEY' },
+    linear: { apiKey: 'LINEAR_API_KEY' },
+    notion: { apiKey: 'NOTION_API_KEY' },
+    github: { token: 'GITHUB_TOKEN' },
+};
+/**
+ * Get credentials from environment variables for a source
+ */
+function getEnvCredentials(sourceName) {
+    const mappings = ENV_VAR_MAPPINGS[sourceName];
+    if (!mappings)
+        return null;
+    const credentials = {};
+    let hasAny = false;
+    for (const [key, envVar] of Object.entries(mappings)) {
+        const value = process.env[envVar];
+        if (value) {
+            credentials[key] = value;
+            hasAny = true;
+        }
+    }
+    return hasAny ? credentials : null;
+}
+/**
+ * Get the environment variable name for a source credential
+ */
+export function getEnvVarName(sourceName, key) {
+    return ENV_VAR_MAPPINGS[sourceName]?.[key] || null;
+}
+/**
+ * Get all environment variable names for credentials
+ */
+export function getAllEnvVarMappings() {
+    return ENV_VAR_MAPPINGS;
+}
+/**
+ * Ensure config directory exists
+ */
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Read sources configuration
+ */
+export function readSourcesConfig() {
+    ensureConfigDir();
+    if (!existsSync(SOURCES_CONFIG_FILE)) {
+        return { sources: {} };
+    }
+    try {
+        const content = readFileSync(SOURCES_CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return { sources: {} };
+    }
+}
+/**
+ * Write sources configuration
+ */
+export function writeSourcesConfig(config) {
+    ensureConfigDir();
+    writeFileSync(SOURCES_CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+/**
+ * Get configuration for a specific source
+ */
+export function getSourceConfig(sourceName) {
+    const config = readSourcesConfig();
+    return config.sources[sourceName] || null;
+}
+/**
+ * Set configuration for a specific source
+ */
+export function setSourceConfig(sourceName, sourceConfig) {
+    const config = readSourcesConfig();
+    config.sources[sourceName] = {
+        ...config.sources[sourceName],
+        ...sourceConfig,
+    };
+    writeSourcesConfig(config);
+}
+/**
+ * Get credentials for a specific source
+ * Priority: Environment variables > Config file
+ */
+export function getSourceCredentials(sourceName) {
+    // Check environment variables first
+    const envCredentials = getEnvCredentials(sourceName);
+    const configCredentials = getSourceConfig(sourceName)?.credentials || null;
+    // Merge: env vars take precedence
+    if (envCredentials && configCredentials) {
+        return { ...configCredentials, ...envCredentials };
+    }
+    return envCredentials || configCredentials;
+}
+/**
+ * Check if credentials came from environment variables
+ */
+export function isCredentialFromEnv(sourceName, key) {
+    const envVar = getEnvVarName(sourceName, key);
+    return envVar ? !!process.env[envVar] : false;
+}
+/**
+ * Set a credential for a specific source
+ */
+export function setSourceCredential(sourceName, key, value) {
+    const config = readSourcesConfig();
+    if (!config.sources[sourceName]) {
+        config.sources[sourceName] = {};
+    }
+    if (!config.sources[sourceName].credentials) {
+        config.sources[sourceName].credentials = {};
+    }
+    config.sources[sourceName].credentials[key] = value;
+    writeSourcesConfig(config);
+}
+/**
+ * Delete a credential for a specific source
+ */
+export function deleteSourceCredential(sourceName, key) {
+    const config = readSourcesConfig();
+    if (!config.sources[sourceName]?.credentials?.[key]) {
+        return false;
+    }
+    delete config.sources[sourceName].credentials?.[key];
+    // Clean up empty credentials object
+    if (Object.keys(config.sources[sourceName].credentials).length === 0) {
+        delete config.sources[sourceName].credentials;
+    }
+    // Clean up empty source config
+    if (Object.keys(config.sources[sourceName]).length === 0) {
+        delete config.sources[sourceName];
+    }
+    writeSourcesConfig(config);
+    return true;
+}
+/**
+ * Get default options for a specific source
+ */
+export function getSourceDefaults(sourceName) {
+    const sourceConfig = getSourceConfig(sourceName);
+    return sourceConfig?.defaults || null;
+}
+/**
+ * Set default options for a specific source
+ */
+export function setSourceDefaults(sourceName, defaults) {
+    const config = readSourcesConfig();
+    if (!config.sources[sourceName]) {
+        config.sources[sourceName] = {};
+    }
+    config.sources[sourceName].defaults = {
+        ...config.sources[sourceName].defaults,
+        ...defaults,
+    };
+    writeSourcesConfig(config);
+}
+/**
+ * Check if a source is enabled
+ * Sources are enabled by default unless explicitly disabled
+ */
+export function isSourceEnabled(sourceName) {
+    const sourceConfig = getSourceConfig(sourceName);
+    return sourceConfig?.enabled !== false;
+}
+/**
+ * Enable or disable a source
+ */
+export function setSourceEnabled(sourceName, enabled) {
+    const config = readSourcesConfig();
+    if (!config.sources[sourceName]) {
+        config.sources[sourceName] = {};
+    }
+    config.sources[sourceName].enabled = enabled;
+    writeSourcesConfig(config);
+}
+/**
+ * List all configured sources
+ */
+export function listConfiguredSources() {
+    const config = readSourcesConfig();
+    return Object.keys(config.sources);
+}
+/**
+ * Delete all configuration for a source
+ */
+export function deleteSourceConfig(sourceName) {
+    const config = readSourcesConfig();
+    if (!config.sources[sourceName]) {
+        return false;
+    }
+    delete config.sources[sourceName];
+    writeSourcesConfig(config);
+    return true;
+}
+/**
+ * Get the config file path (for display purposes)
+ */
+export function getSourcesConfigPath() {
+    return SOURCES_CONFIG_FILE;
+}
+//# sourceMappingURL=config.js.map

package/dist/sources/config.js.map

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

package/dist/sources/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Source registry and factory
+ *
+ * Manages all available input sources and provides methods to:
+ * - List available sources
+ * - Get source by name
+ * - Auto-detect source from identifier
+ * - Fetch content from any source
+ */
+import type { InputSource, SourceInfo, SourceOptions, SourceResult } from './types.js';
+/**
+ * Get a source by name
+ */
+export declare function getSource(name: string): InputSource | null;
+/**
+ * Get all registered sources
+ */
+export declare function getAllSources(): InputSource[];
+/**
+ * Get source info for all sources
+ */
+export declare function getSourcesInfo(): Promise<SourceInfo[]>;
+/**
+ * Auto-detect the appropriate source from an identifier
+ */
+export declare function detectSource(identifier: string): InputSource | null;
+/**
+ * Fetch content from any source
+ *
+ * @param sourceOrIdentifier - Source name or auto-detectable identifier
+ * @param identifierOrOptions - Identifier (if source given) or options
+ * @param options - Additional options
+ */
+export declare function fetchFromSource(sourceOrIdentifier: string, identifierOrOptions?: string | SourceOptions, options?: SourceOptions): Promise<SourceResult>;
+/**
+ * Get help text for a specific source
+ */
+export declare function getSourceHelp(name: string): string | null;
+/**
+ * Test if a source's credentials are valid
+ */
+export declare function testSource(name: string): Promise<{
+    success: boolean;
+    message: string;
+}>;
+export type { InputSource, SourceInfo, SourceOptions, SourceResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiCvF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAG7C;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAgB5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2DnE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,kBAAkB,EAAE,MAAM,EAC1B,mBAAmB,CAAC,EAAE,MAAM,GAAG,aAAa,EAC5C,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAgDvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CA2BD;AAGD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/sources/index.js

@@ -0,0 +1,210 @@
+/**
+ * Source registry and factory
+ *
+ * Manages all available input sources and provides methods to:
+ * - List available sources
+ * - Get source by name
+ * - Auto-detect source from identifier
+ * - Fetch content from any source
+ */
+// Built-in sources
+import { FileSource } from './builtin/file.js';
+import { PdfSource } from './builtin/pdf.js';
+import { UrlSource } from './builtin/url.js';
+// Integration sources
+import { GitHubSource } from './integrations/github.js';
+import { LinearSource } from './integrations/linear.js';
+import { NotionSource } from './integrations/notion.js';
+import { TodoistSource } from './integrations/todoist.js';
+/**
+ * All registered sources
+ */
+const sources = new Map();
+/**
+ * Initialize all sources
+ */
+function initializeSources() {
+    if (sources.size > 0)
+        return;
+    // Register builtin sources
+    const builtins = [new FileSource(), new UrlSource(), new PdfSource()];
+    for (const source of builtins) {
+        sources.set(source.name, source);
+    }
+    // Register integration sources
+    const integrations = [
+        new GitHubSource(),
+        new TodoistSource(),
+        new LinearSource(),
+        new NotionSource(),
+    ];
+    for (const source of integrations) {
+        sources.set(source.name, source);
+    }
+}
+/**
+ * Get a source by name
+ */
+export function getSource(name) {
+    initializeSources();
+    return sources.get(name) || null;
+}
+/**
+ * Get all registered sources
+ */
+export function getAllSources() {
+    initializeSources();
+    return Array.from(sources.values());
+}
+/**
+ * Get source info for all sources
+ */
+export async function getSourcesInfo() {
+    initializeSources();
+    const info = [];
+    for (const source of sources.values()) {
+        info.push({
+            name: source.name,
+            description: source.description,
+            type: source.type,
+            requiresAuth: source.requiresAuth(),
+            available: await source.isAvailable(),
+        });
+    }
+    return info;
+}
+/**
+ * Auto-detect the appropriate source from an identifier
+ */
+export function detectSource(identifier) {
+    initializeSources();
+    // Check for explicit source prefix (e.g., "github:owner/repo")
+    const prefixMatch = identifier.match(/^([a-z]+):/i);
+    if (prefixMatch) {
+        const sourceName = prefixMatch[1].toLowerCase();
+        return sources.get(sourceName) || null;
+    }
+    // Auto-detect from identifier format
+    const lowerIdentifier = identifier.toLowerCase();
+    // URL detection
+    if (identifier.startsWith('http://') || identifier.startsWith('https://')) {
+        // Check for specific service URLs
+        if (lowerIdentifier.includes('github.com')) {
+            return sources.get('github') || null;
+        }
+        if (lowerIdentifier.includes('notion.so') || lowerIdentifier.includes('notion.site')) {
+            return sources.get('notion') || null;
+        }
+        if (lowerIdentifier.includes('linear.app')) {
+            return sources.get('linear') || null;
+        }
+        if (lowerIdentifier.includes('todoist.com')) {
+            return sources.get('todoist') || null;
+        }
+        // Check for PDF URLs
+        if (lowerIdentifier.endsWith('.pdf')) {
+            return sources.get('pdf') || null;
+        }
+        // Default to URL source
+        return sources.get('url') || null;
+    }
+    // Local file detection
+    if (identifier.startsWith('./') ||
+        identifier.startsWith('/') ||
+        identifier.startsWith('../') ||
+        identifier.includes('/') ||
+        lowerIdentifier.endsWith('.md') ||
+        lowerIdentifier.endsWith('.txt') ||
+        lowerIdentifier.endsWith('.pdf')) {
+        // PDF files
+        if (lowerIdentifier.endsWith('.pdf')) {
+            return sources.get('pdf') || null;
+        }
+        // Other files
+        return sources.get('file') || null;
+    }
+    // No match - could be a project name for integrations
+    return null;
+}
+/**
+ * Fetch content from any source
+ *
+ * @param sourceOrIdentifier - Source name or auto-detectable identifier
+ * @param identifierOrOptions - Identifier (if source given) or options
+ * @param options - Additional options
+ */
+export async function fetchFromSource(sourceOrIdentifier, identifierOrOptions, options) {
+    initializeSources();
+    let source;
+    let identifier;
+    let fetchOptions;
+    // Determine if first arg is source name or identifier
+    const explicitSource = sources.get(sourceOrIdentifier.toLowerCase());
+    if (explicitSource && typeof identifierOrOptions === 'string') {
+        // First arg is source name
+        source = explicitSource;
+        identifier = identifierOrOptions;
+        fetchOptions = options;
+    }
+    else {
+        // First arg is identifier, auto-detect source
+        identifier = sourceOrIdentifier;
+        source = detectSource(identifier);
+        fetchOptions = typeof identifierOrOptions === 'object' ? identifierOrOptions : options;
+        // Strip source prefix if present
+        const prefixMatch = identifier.match(/^([a-z]+):/i);
+        if (prefixMatch) {
+            identifier = identifier.slice(prefixMatch[0].length);
+        }
+    }
+    if (!source) {
+        throw new Error(`Could not determine source for: ${sourceOrIdentifier}. ` +
+            `Use --from <source> to specify explicitly.`);
+    }
+    // Check if source is available
+    const available = await source.isAvailable();
+    if (!available) {
+        if (source.requiresAuth()) {
+            throw new Error(`Source "${source.name}" requires authentication. ` +
+                `Run: ralph-starter config set ${source.name}.apiKey <value>`);
+        }
+        throw new Error(`Source "${source.name}" is not available.`);
+    }
+    return source.fetch(identifier, fetchOptions);
+}
+/**
+ * Get help text for a specific source
+ */
+export function getSourceHelp(name) {
+    initializeSources();
+    const source = sources.get(name);
+    return source?.getHelp() || null;
+}
+/**
+ * Test if a source's credentials are valid
+ */
+export async function testSource(name) {
+    initializeSources();
+    const source = sources.get(name);
+    if (!source) {
+        return { success: false, message: `Unknown source: ${name}` };
+    }
+    const available = await source.isAvailable();
+    if (!available) {
+        if (source.requiresAuth()) {
+            return {
+                success: false,
+                message: `Not configured. Run: ralph-starter config set ${name}.apiKey <value>`,
+            };
+        }
+        return { success: false, message: 'Source dependencies not available' };
+    }
+    if (source.validateCredentials) {
+        const valid = await source.validateCredentials();
+        if (!valid) {
+            return { success: false, message: 'Credentials validation failed' };
+        }
+    }
+    return { success: true, message: 'Source is available and configured' };
+}
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

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

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

@@ -0,0 +1,24 @@
+import { IntegrationSource } from '../base.js';
+import type { SourceOptions, SourceResult } from '../types.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 declare class GitHubSource extends IntegrationSource {
+    name: string;
+    description: string;
+    private ghAvailable;
+    isAvailable(): Promise<boolean>;
+    requiresAuth(): boolean;
+    private isGhCliAvailable;
+    fetch(identifier: string, options?: SourceOptions): Promise<SourceResult>;
+    private parseRepoIdentifier;
+    private fetchViaGhCli;
+    private fetchViaApi;
+    private formatIssues;
+    protected getRequiredCredentialKey(): string;
+    getHelp(): string;
+}
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/sources/integrations/github.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,WAAW,CAAwB;IAErC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAUrC,YAAY,IAAI,OAAO;YAKT,gBAAgB;IAgBxB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAY/E,OAAO,CAAC,mBAAmB;YAkBb,aAAa;YAwCb,WAAW;IA2CzB,OAAO,CAAC,YAAY;IAgDpB,SAAS,CAAC,wBAAwB,IAAI,MAAM;IAI5C,OAAO,IAAI,MAAM;CAwBlB"}