ralph-starter 0.0.1 → 0.1.1-beta.0

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9E"}

package/dist/commands/setup.js

@@ -0,0 +1,27 @@
+/**
+ * Setup command for ralph-starter
+ * Interactive setup wizard to configure LLM and agents
+ */
+import { runSetupWizard } from '../setup/wizard.js';
+/**
+ * Run the setup command
+ */
+export async function setupCommand(options) {
+    try {
+        const result = await runSetupWizard({
+            force: options.force,
+        });
+        if (!result.success && result.error !== 'Cancelled') {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        // Handle Ctrl+C gracefully
+        if (error.message?.includes('User force closed')) {
+            console.log('\nSetup cancelled.');
+            process.exit(0);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2BAA2B;QAC3B,IAAK,KAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,6 @@
+interface SkillOptions {
+    global?: boolean;
+}
+export declare function skillCommand(action: string, skillName?: string, options?: SkillOptions): Promise<void>;
+export {};
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAKA,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiBD,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/commands/skill.js

@@ -0,0 +1,151 @@
+import chalk from 'chalk';
+import { execa } from 'execa';
+import inquirer from 'inquirer';
+import ora from 'ora';
+// Popular skills registry (curated list)
+const POPULAR_SKILLS = [
+    {
+        name: 'vercel-labs/agent-skills',
+        description: 'React, Next.js, and Vercel best practices',
+        skills: [
+            'react-best-practices',
+            'nextjs-best-practices',
+            'vercel-best-practices',
+            'web-design-review',
+        ],
+    },
+    // Add more as the ecosystem grows
+];
+export async function skillCommand(action, skillName, options = {}) {
+    switch (action) {
+        case 'add':
+        case 'install':
+        case 'i':
+            if (!skillName) {
+                console.log(chalk.red('Please specify a skill to install.'));
+                console.log(chalk.gray('  Example: ralph-starter skill add vercel-labs/agent-skills'));
+                return;
+            }
+            await addSkill(skillName, options);
+            break;
+        case 'list':
+        case 'ls':
+            await listSkills();
+            break;
+        case 'search':
+            await searchSkills(skillName);
+            break;
+        case 'browse':
+            await browseSkills();
+            break;
+        default:
+            console.log(chalk.red(`Unknown action: ${action}`));
+            showSkillHelp();
+    }
+}
+async function addSkill(skillName, options) {
+    const spinner = ora();
+    console.log();
+    console.log(chalk.cyan(`Installing skill: ${chalk.bold(skillName)}`));
+    console.log();
+    // Check if add-skill is available
+    spinner.start('Checking for add-skill CLI...');
+    try {
+        await execa('npx', ['add-skill', '--version']);
+        spinner.succeed('add-skill CLI available');
+    }
+    catch {
+        spinner.warn('add-skill not found, will use npx');
+    }
+    // Install the skill using add-skill
+    spinner.start('Installing skill...');
+    try {
+        const args = [skillName];
+        if (options.global) {
+            args.push('--global');
+        }
+        await execa('npx', ['add-skill', ...args], {
+            stdio: 'inherit',
+        });
+        spinner.succeed('Skill installed successfully!');
+    }
+    catch (_error) {
+        spinner.fail('Failed to install skill');
+        console.log();
+        console.log(chalk.yellow('Try running manually:'));
+        console.log(chalk.gray(`  npx add-skill ${skillName}`));
+    }
+}
+async function listSkills() {
+    console.log();
+    console.log(chalk.cyan.bold('Popular Skills'));
+    console.log();
+    for (const repo of POPULAR_SKILLS) {
+        console.log(chalk.white.bold(`  ${repo.name}`));
+        console.log(chalk.dim(`  ${repo.description}`));
+        console.log(chalk.gray(`  Skills: ${repo.skills.join(', ')}`));
+        console.log();
+    }
+    console.log(chalk.dim('Install with: ralph-starter skill add <repo>'));
+    console.log(chalk.dim('Browse more: https://github.com/topics/agent-skills'));
+}
+async function searchSkills(query) {
+    if (!query) {
+        console.log(chalk.yellow('Please provide a search term.'));
+        console.log(chalk.gray('  Example: ralph-starter skill search react'));
+        return;
+    }
+    console.log();
+    console.log(chalk.cyan(`Searching for: ${chalk.bold(query)}`));
+    console.log();
+    // Filter popular skills by query
+    const results = POPULAR_SKILLS.filter((repo) => repo.name.toLowerCase().includes(query.toLowerCase()) ||
+        repo.description.toLowerCase().includes(query.toLowerCase()) ||
+        repo.skills.some((s) => s.toLowerCase().includes(query.toLowerCase())));
+    if (results.length === 0) {
+        console.log(chalk.gray('No skills found. Try browsing GitHub:'));
+        console.log(chalk.blue('  https://github.com/topics/agent-skills'));
+        return;
+    }
+    for (const repo of results) {
+        console.log(chalk.white.bold(`  ${repo.name}`));
+        console.log(chalk.dim(`  ${repo.description}`));
+        console.log();
+    }
+}
+async function browseSkills() {
+    const { skill } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'skill',
+            message: 'Select a skill to install:',
+            choices: [
+                ...POPULAR_SKILLS.map((repo) => ({
+                    name: `${repo.name} - ${chalk.dim(repo.description)}`,
+                    value: repo.name,
+                })),
+                new inquirer.Separator(),
+                { name: chalk.dim('Cancel'), value: null },
+            ],
+        },
+    ]);
+    if (skill) {
+        await addSkill(skill, {});
+    }
+}
+function showSkillHelp() {
+    console.log();
+    console.log(chalk.cyan.bold('ralph-starter skill'));
+    console.log();
+    console.log('Commands:');
+    console.log(chalk.gray('  add <repo>     Install a skill from a git repository'));
+    console.log(chalk.gray('  list           List popular skills'));
+    console.log(chalk.gray('  search <term>  Search for skills'));
+    console.log(chalk.gray('  browse         Interactive skill browser'));
+    console.log();
+    console.log('Examples:');
+    console.log(chalk.gray('  ralph-starter skill add vercel-labs/agent-skills'));
+    console.log(chalk.gray('  ralph-starter skill list'));
+    console.log(chalk.gray('  ralph-starter skill search react'));
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

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

package/dist/commands/source.d.ts

@@ -0,0 +1,17 @@
+export interface SourceCommandOptions {
+    project?: string;
+    label?: string;
+    status?: string;
+    limit?: number;
+}
+/**
+ * Source command - list, test, and preview sources
+ *
+ * Usage:
+ *   ralph-starter source list           - List all available sources
+ *   ralph-starter source help <source>  - Show help for a specific source
+ *   ralph-starter source test <source>  - Test source connectivity
+ *   ralph-starter source preview <identifier> - Preview content from a source
+ */
+export declare function sourceCommand(action: string, args: string[], options?: SourceCommandOptions): Promise<void>;
+//# sourceMappingURL=source.d.ts.map

package/dist/commands/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/commands/source.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/commands/source.js

@@ -0,0 +1,173 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { fetchFromSource, getSourceHelp, getSourcesInfo, testSource } from '../sources/index.js';
+/**
+ * Source command - list, test, and preview sources
+ *
+ * Usage:
+ *   ralph-starter source list           - List all available sources
+ *   ralph-starter source help <source>  - Show help for a specific source
+ *   ralph-starter source test <source>  - Test source connectivity
+ *   ralph-starter source preview <identifier> - Preview content from a source
+ */
+export async function sourceCommand(action, args, options) {
+    switch (action) {
+        case 'list':
+        case 'ls':
+            await listSources();
+            break;
+        case 'help':
+            if (args.length < 1) {
+                // Show general help when no source specified
+                showSourceCommandHelp();
+                return;
+            }
+            showSourceHelp(args[0]);
+            break;
+        case 'test':
+            if (args.length < 1) {
+                console.error(chalk.red('Usage: ralph-starter source test <source>'));
+                process.exit(1);
+            }
+            await testSourceConnection(args[0]);
+            break;
+        case 'preview':
+            if (args.length < 1) {
+                console.error(chalk.red('Usage: ralph-starter source preview <identifier>'));
+                process.exit(1);
+            }
+            await previewSource(args[0], options);
+            break;
+        default:
+            showSourceCommandHelp();
+            break;
+    }
+}
+async function listSources() {
+    const spinner = ora('Loading sources...').start();
+    try {
+        const sources = await getSourcesInfo();
+        spinner.stop();
+        console.log(chalk.bold('\nAvailable Sources\n'));
+        // Group by type
+        const builtins = sources.filter((s) => s.type === 'builtin');
+        const integrations = sources.filter((s) => s.type === 'integration');
+        // Built-in sources
+        console.log(chalk.cyan.bold('Built-in'));
+        for (const source of builtins) {
+            const status = source.available ? chalk.green('✓') : chalk.red('✗');
+            console.log(`  ${status} ${chalk.bold(source.name)} - ${source.description}`);
+        }
+        console.log();
+        // Integration sources
+        console.log(chalk.cyan.bold('Integrations'));
+        for (const source of integrations) {
+            const _status = source.available
+                ? chalk.green('✓ configured')
+                : chalk.yellow('○ not configured');
+            console.log(`  ${source.available ? chalk.green('✓') : chalk.yellow('○')} ${chalk.bold(source.name)} - ${source.description}`);
+            if (!source.available && source.requiresAuth) {
+                console.log(chalk.dim(`      Run: ralph-starter config set ${source.name}.apiKey <value>`));
+            }
+        }
+        console.log();
+        console.log(chalk.dim('Use "ralph-starter source help <name>" for details'));
+    }
+    catch (error) {
+        spinner.fail('Failed to load sources');
+        throw error;
+    }
+}
+function showSourceHelp(sourceName) {
+    const help = getSourceHelp(sourceName);
+    if (!help) {
+        console.error(chalk.red(`Unknown source: ${sourceName}`));
+        console.error(chalk.dim('\nUse "ralph-starter source list" to see available sources'));
+        process.exit(1);
+    }
+    console.log();
+    console.log(help);
+    console.log();
+}
+async function testSourceConnection(sourceName) {
+    const spinner = ora(`Testing ${sourceName}...`).start();
+    const result = await testSource(sourceName);
+    if (result.success) {
+        spinner.succeed(chalk.green(`${sourceName}: ${result.message}`));
+    }
+    else {
+        spinner.fail(chalk.red(`${sourceName}: ${result.message}`));
+        process.exit(1);
+    }
+}
+async function previewSource(identifier, options) {
+    const spinner = ora('Fetching content...').start();
+    try {
+        const result = await fetchFromSource(identifier, {
+            project: options?.project,
+            label: options?.label,
+            status: options?.status,
+            limit: options?.limit || 5,
+        });
+        spinner.succeed('Content fetched');
+        console.log();
+        console.log(chalk.bold.cyan('Source:'), result.source);
+        if (result.title) {
+            console.log(chalk.bold.cyan('Title:'), result.title);
+        }
+        if (result.metadata) {
+            console.log(chalk.bold.cyan('Metadata:'), JSON.stringify(result.metadata, null, 2));
+        }
+        console.log();
+        console.log(chalk.bold('Preview:'));
+        console.log(chalk.dim('─'.repeat(60)));
+        // Show first 50 lines
+        const lines = result.content.split('\n');
+        const preview = lines.slice(0, 50).join('\n');
+        console.log(preview);
+        if (lines.length > 50) {
+            console.log(chalk.dim(`\n... and ${lines.length - 50} more lines`));
+        }
+        console.log(chalk.dim('─'.repeat(60)));
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch content');
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+}
+function showSourceCommandHelp() {
+    console.log(`
+${chalk.bold('ralph-starter source')} - Manage input sources
+
+${chalk.bold('Commands:')}
+  list                          List all available sources
+  help <source>                 Show help for a specific source
+  test <source>                 Test source connectivity
+  preview <identifier>          Preview content from a source
+
+${chalk.bold('Preview Options:')}
+  --project <name>              Project/repo name for integrations
+  --label <name>                Filter by label
+  --status <status>             Filter by status (e.g., open, closed)
+  --limit <n>                   Maximum items to fetch
+
+${chalk.bold('Examples:')}
+  ralph-starter source list
+  ralph-starter source help github
+  ralph-starter source test todoist
+  ralph-starter source preview ./spec.md
+  ralph-starter source preview https://example.com/spec.md
+  ralph-starter source preview github --project owner/repo --label bug
+  ralph-starter source preview todoist --project "My Project"
+
+${chalk.bold('Identifier Formats:')}
+  ./path/to/file.md             Local file
+  https://example.com/spec.md   Remote URL
+  github:owner/repo             GitHub issues
+  todoist:project-name          Todoist tasks
+  linear:TEAM-KEY               Linear issues
+  notion:page-id                Notion page
+`);
+}
+//# sourceMappingURL=source.js.map

package/dist/commands/source.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,70 @@
+import { type LLMProvider } from '../llm/index.js';
+export interface RalphConfig {
+    apiKey?: string;
+    defaultModel?: string;
+    llm?: {
+        provider?: LLMProvider;
+        model?: string;
+    };
+    providers?: {
+        anthropic?: {
+            apiKey: string;
+        };
+        openai?: {
+            apiKey: string;
+        };
+        openrouter?: {
+            apiKey: string;
+        };
+    };
+    agent?: {
+        default?: string;
+        usesClaudeCodeCLI?: boolean;
+    };
+    setupCompleted?: boolean;
+    setupVersion?: string;
+}
+export declare function ensureConfigDir(): void;
+export declare function readConfig(): RalphConfig;
+export declare function writeConfig(config: RalphConfig): void;
+export declare function getApiKey(): Promise<string | null>;
+export declare function promptForApiKey(): Promise<string | null>;
+export declare function isClaudeCliInstalled(): Promise<boolean>;
+/**
+ * Get the configured LLM provider
+ * Priority: config file > auto-detect from env > default (anthropic)
+ */
+export declare function getLLMProvider(): LLMProvider;
+/**
+ * Get API key for a specific provider
+ * Priority: env var > config file providers.X.apiKey > legacy apiKey (for anthropic)
+ */
+export declare function getLLMApiKey(provider: LLMProvider): string | null;
+/**
+ * Get API key silently (no prompt) - for wizard use
+ * Returns provider and key, or null if none available
+ */
+export declare function getConfiguredLLM(): {
+    provider: LLMProvider;
+    apiKey: string;
+} | null;
+/**
+ * Set LLM provider in config
+ */
+export declare function setLLMProvider(provider: LLMProvider): void;
+/**
+ * Set API key for a provider
+ */
+export declare function setLLMApiKey(provider: LLMProvider, apiKey: string): void;
+/**
+ * Get configured model for LLM
+ */
+export declare function getLLMModel(): string | null;
+/**
+ * Interactive prompt for LLM provider selection and API key
+ */
+export declare function promptForLLMSetup(): Promise<{
+    provider: LLMProvider;
+    apiKey: string;
+} | null>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW;IAE1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/B,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,UAAU,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjC,CAAC;IAGF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IAGF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED,wBAAgB,UAAU,IAAI,WAAW,CAaxC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGrD;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoC9D;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAgB5C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAsBjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASxE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IACjD,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAAC,CAuDR"}