ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/config/manager.js

@@ -0,0 +1,227 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { detectProviderFromEnv, getProviderKeyFromEnv, PROVIDER_NAMES, PROVIDERS, } from '../llm/index.js';
+const CONFIG_DIR = join(homedir(), '.ralph-starter');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+export function readConfig() {
+    ensureConfigDir();
+    if (!existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(config) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export async function getApiKey() {
+    // 1. Check CLI flag (handled by caller)
+    // 2. Check environment variable
+    if (process.env.ANTHROPIC_API_KEY) {
+        return process.env.ANTHROPIC_API_KEY;
+    }
+    // 3. Check config file
+    const config = readConfig();
+    if (config.apiKey) {
+        return config.apiKey;
+    }
+    // 4. Prompt user
+    return promptForApiKey();
+}
+export async function promptForApiKey() {
+    console.log();
+    console.log(chalk.yellow('No API key found.'));
+    console.log(chalk.dim('You can get one at: https://console.anthropic.com/'));
+    console.log();
+    const { apiKey } = await inquirer.prompt([
+        {
+            type: 'password',
+            name: 'apiKey',
+            message: 'Enter your Anthropic API key:',
+            mask: '*',
+        },
+    ]);
+    if (!apiKey) {
+        return null;
+    }
+    const { save } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'save',
+            message: 'Save this API key for future use?',
+            default: true,
+        },
+    ]);
+    if (save) {
+        const config = readConfig();
+        config.apiKey = apiKey;
+        writeConfig(config);
+        console.log(chalk.green(`API key saved to ${CONFIG_FILE}`));
+    }
+    return apiKey;
+}
+export async function isClaudeCliInstalled() {
+    try {
+        const { execa } = await import('execa');
+        await execa('claude', ['--version']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the configured LLM provider
+ * Priority: config file > auto-detect from env > default (anthropic)
+ */
+export function getLLMProvider() {
+    const config = readConfig();
+    // Check explicit config
+    if (config.llm?.provider) {
+        return config.llm.provider;
+    }
+    // Auto-detect from environment
+    const detected = detectProviderFromEnv();
+    if (detected) {
+        return detected;
+    }
+    // Default to anthropic
+    return 'anthropic';
+}
+/**
+ * Get API key for a specific provider
+ * Priority: env var > config file providers.X.apiKey > legacy apiKey (for anthropic)
+ */
+export function getLLMApiKey(provider) {
+    // Check environment variable first
+    const envKey = getProviderKeyFromEnv(provider);
+    if (envKey) {
+        return envKey;
+    }
+    // Check config file
+    const config = readConfig();
+    // Check new providers.X.apiKey format
+    const providerKey = config.providers?.[provider]?.apiKey;
+    if (providerKey) {
+        return providerKey;
+    }
+    // Legacy: check apiKey for anthropic
+    if (provider === 'anthropic' && config.apiKey) {
+        return config.apiKey;
+    }
+    return null;
+}
+/**
+ * Get API key silently (no prompt) - for wizard use
+ * Returns provider and key, or null if none available
+ */
+export function getConfiguredLLM() {
+    // Try configured provider first
+    const config = readConfig();
+    if (config.llm?.provider) {
+        const key = getLLMApiKey(config.llm.provider);
+        if (key) {
+            return { provider: config.llm.provider, apiKey: key };
+        }
+    }
+    // Auto-detect from environment
+    for (const provider of PROVIDER_NAMES) {
+        const key = getLLMApiKey(provider);
+        if (key) {
+            return { provider, apiKey: key };
+        }
+    }
+    return null;
+}
+/**
+ * Set LLM provider in config
+ */
+export function setLLMProvider(provider) {
+    const config = readConfig();
+    config.llm = { ...config.llm, provider };
+    writeConfig(config);
+}
+/**
+ * Set API key for a provider
+ */
+export function setLLMApiKey(provider, apiKey) {
+    const config = readConfig();
+    if (!config.providers) {
+        config.providers = {};
+    }
+    config.providers[provider] = { apiKey };
+    writeConfig(config);
+}
+/**
+ * Get configured model for LLM
+ */
+export function getLLMModel() {
+    const config = readConfig();
+    return config.llm?.model || config.defaultModel || null;
+}
+/**
+ * Interactive prompt for LLM provider selection and API key
+ */
+export async function promptForLLMSetup() {
+    console.log();
+    console.log(chalk.yellow('No LLM API key configured.'));
+    console.log();
+    // Provider selection
+    const { provider } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'provider',
+            message: 'Choose your LLM provider:',
+            choices: PROVIDER_NAMES.map((p) => ({
+                name: PROVIDERS[p].displayName,
+                value: p,
+            })),
+        },
+    ]);
+    const providerConfig = PROVIDERS[provider];
+    console.log();
+    console.log(chalk.dim(`Get your API key at: ${providerConfig.consoleUrl}`));
+    console.log();
+    // API key input
+    const { apiKey } = await inquirer.prompt([
+        {
+            type: 'password',
+            name: 'apiKey',
+            message: `Enter your ${providerConfig.displayName} API key:`,
+            mask: '*',
+        },
+    ]);
+    if (!apiKey) {
+        return null;
+    }
+    // Save option
+    const { save } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'save',
+            message: 'Save this configuration for future use?',
+            default: true,
+        },
+    ]);
+    if (save) {
+        setLLMProvider(provider);
+        setLLMApiKey(provider, apiKey);
+        console.log(chalk.green(`Configuration saved to ${CONFIG_FILE}`));
+    }
+    return { provider: provider, apiKey };
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export declare const version = "0.1.0";
+export declare const name = "ralph-starter";
+export { createPullRequest, gitCommit, gitPush, isGitRepo } from './automation/git.js';
+export { configCommand } from './commands/config.js';
+export { initCommand } from './commands/init.js';
+export { planCommand } from './commands/plan.js';
+export { runCommand } from './commands/run.js';
+export { skillCommand } from './commands/skill.js';
+export { sourceCommand } from './commands/source.js';
+export { getApiKey, readConfig, writeConfig } from './config/manager.js';
+export type { Agent, AgentType } from './loop/agents.js';
+export { detectAvailableAgents, detectBestAgent } from './loop/agents.js';
+export { runLoop } from './loop/executor.js';
+export { detectValidationCommands, runAllValidations, runValidation } from './loop/validation.js';
+export type { InitCoreOptions, InitCoreResult } from './mcp/core/init.js';
+export { initCore } from './mcp/core/init.js';
+export type { PlanCoreOptions, PlanCoreResult } from './mcp/core/plan.js';
+export { planCore } from './mcp/core/plan.js';
+export type { RunCoreOptions, RunCoreResult } from './mcp/core/run.js';
+export { runCore } from './mcp/core/run.js';
+export { createMcpServer, startMcpServer } from './mcp/server.js';
+export { detectSource, fetchFromSource, getAllSources, getSource, getSourceHelp, getSourcesInfo, testSource, } from './sources/index.js';
+export type { InputSource, SourceInfo, SourceOptions, SourceResult } from './sources/types.js';
+export { runIdeaMode, runWizard } from './wizard/index.js';
+export type { IdeaContext, IdeaDiscoveryMethod, IdeaSuggestion } from './wizard/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClG,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,3 +1,28 @@
-// ralph-starter - AI-powered project scaffolder for Claude Code loops
-export const version = '0.0.1';
+// ralph-starter - Ralph Wiggum made easy
+export const version = '0.1.0';
 export const name = 'ralph-starter';
+// Automation
+export { createPullRequest, gitCommit, gitPush, isGitRepo } from './automation/git.js';
+export { configCommand } from './commands/config.js';
+export { initCommand } from './commands/init.js';
+export { planCommand } from './commands/plan.js';
+// Commands
+export { runCommand } from './commands/run.js';
+export { skillCommand } from './commands/skill.js';
+export { sourceCommand } from './commands/source.js';
+// Config
+export { getApiKey, readConfig, writeConfig } from './config/manager.js';
+export { detectAvailableAgents, detectBestAgent } from './loop/agents.js';
+// Loop
+export { runLoop } from './loop/executor.js';
+export { detectValidationCommands, runAllValidations, runValidation } from './loop/validation.js';
+export { initCore } from './mcp/core/init.js';
+export { planCore } from './mcp/core/plan.js';
+export { runCore } from './mcp/core/run.js';
+// MCP
+export { createMcpServer, startMcpServer } from './mcp/server.js';
+// Sources
+export { detectSource, fetchFromSource, getAllSources, getSource, getSourceHelp, getSourcesInfo, testSource, } from './sources/index.js';
+// Wizard
+export { runIdeaMode, runWizard } from './wizard/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC;AAEpC,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,WAAW;AACX,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElG,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,UAAU;AACV,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Template OAuth Provider (Optional)
+ *
+ * Only needed if your integration uses OAuth authentication.
+ * Delete this file if using API key or CLI authentication.
+ *
+ * To set up OAuth:
+ * 1. Register an OAuth app with the service
+ * 2. Get Client ID (and Client Secret if not using PKCE)
+ * 3. Configure redirect URI: http://127.0.0.1:52847/callback
+ */
+import { BaseOAuthProvider } from '../../auth/providers/base.js';
+export declare class TemplateOAuthProvider extends BaseOAuthProvider {
+    name: string;
+    displayName: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    scopes: string[];
+    clientId: string;
+    clientSecret: string | undefined;
+    supportsPKCE: boolean;
+    authParams: {};
+    /**
+     * Check if OAuth is configured
+     */
+    isConfigured(): boolean;
+}
+export declare const templateProvider: TemplateOAuthProvider;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/integrations/_template/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,IAAI,SAAc;IAClB,WAAW,SAAsB;IAGjC,gBAAgB,SAAyC;IACzD,QAAQ,SAAyC;IAGjD,MAAM,WAAY;IAGlB,QAAQ,SAA8C;IAGtD,YAAY,qBAA4C;IAGxD,YAAY,UAAS;IAGrB,UAAU,KAER;IAEF;;OAEG;IACH,YAAY,IAAI,OAAO;CAMxB;AAED,eAAO,MAAM,gBAAgB,uBAA8B,CAAC"}

package/dist/integrations/_template/auth.js

@@ -0,0 +1,42 @@
+/**
+ * Template OAuth Provider (Optional)
+ *
+ * Only needed if your integration uses OAuth authentication.
+ * Delete this file if using API key or CLI authentication.
+ *
+ * To set up OAuth:
+ * 1. Register an OAuth app with the service
+ * 2. Get Client ID (and Client Secret if not using PKCE)
+ * 3. Configure redirect URI: http://127.0.0.1:52847/callback
+ */
+import { BaseOAuthProvider } from '../../auth/providers/base.js';
+export class TemplateOAuthProvider extends BaseOAuthProvider {
+    name = 'template';
+    displayName = 'Template Service';
+    // OAuth endpoints - update for your service
+    authorizationUrl = 'https://example.com/oauth/authorize';
+    tokenUrl = 'https://api.example.com/oauth/token';
+    // Required scopes
+    scopes = ['read'];
+    // Client ID from environment variable
+    clientId = process.env.RALPH_TEMPLATE_CLIENT_ID || '';
+    // Client secret (optional if using PKCE)
+    clientSecret = process.env.RALPH_TEMPLATE_CLIENT_SECRET;
+    // Set to true if the service supports PKCE (no client secret needed)
+    supportsPKCE = false;
+    // Additional auth URL parameters (optional)
+    authParams = {
+    // prompt: 'consent',
+    };
+    /**
+     * Check if OAuth is configured
+     */
+    isConfigured() {
+        if (this.supportsPKCE) {
+            return !!this.clientId;
+        }
+        return !!this.clientId && !!this.clientSecret;
+    }
+}
+export const templateProvider = new TemplateOAuthProvider();
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/integrations/_template/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAC1D,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,kBAAkB,CAAC;IAEjC,4CAA4C;IAC5C,gBAAgB,GAAG,qCAAqC,CAAC;IACzD,QAAQ,GAAG,qCAAqC,CAAC;IAEjD,kBAAkB;IAClB,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IAElB,sCAAsC;IACtC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;IAEtD,yCAAyC;IACzC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC;IAExD,qEAAqE;IACrE,YAAY,GAAG,KAAK,CAAC;IAErB,4CAA4C;IAC5C,UAAU,GAAG;IACX,qBAAqB;KACtB,CAAC;IAEF;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAChD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Template Integration
+ *
+ * Copy this folder and rename it to create a new integration.
+ * Replace all occurrences of "template" with your integration name.
+ */
+export { TemplateIntegration } from './source.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/integrations/_template/index.js

@@ -0,0 +1,8 @@
+/**
+ * Template Integration
+ *
+ * Copy this folder and rename it to create a new integration.
+ * Replace all occurrences of "template" with your integration name.
+ */
+export { TemplateIntegration } from './source.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Template Integration Source
+ *
+ * This file contains the main data fetching logic.
+ * Rename this class and update all the properties.
+ */
+import { type AuthMethod, BaseIntegration, type IntegrationOptions, type IntegrationResult } from '../base.js';
+export declare class TemplateIntegration extends BaseIntegration {
+    name: string;
+    displayName: string;
+    description: string;
+    website: string;
+    authMethods: AuthMethod[];
+    /**
+     * Check if CLI tool is available and authenticated
+     * Only implement if authMethods includes 'cli'
+     */
+    protected isCliAvailable(): Promise<boolean>;
+    fetch(identifier: string, options?: IntegrationOptions): Promise<IntegrationResult>;
+    /**
+     * Fetch via CLI tool
+     */
+    private fetchViaCli;
+    /**
+     * Fetch via API
+     */
+    private fetchViaApi;
+    /**
+     * Format API results to markdown
+     */
+    private formatResults;
+    getHelp(): string;
+}
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/integrations/_template/source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,qBAAa,mBAAoB,SAAQ,eAAe;IAKtD,IAAI,SAAc;IAClB,WAAW,SAAsB;IACjC,WAAW,SAAsC;IACjD,OAAO,SAAyB;IAGhC,WAAW,EAAE,UAAU,EAAE,CAAe;IAMxC;;;OAGG;cACa,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAgB5C,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkBzF;;OAEG;YACW,WAAW;IAazB;;OAEG;YACW,WAAW;IAyBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB,OAAO,IAAI,MAAM;CAoBlB"}

package/dist/integrations/_template/source.js

@@ -0,0 +1,124 @@
+/**
+ * Template Integration Source
+ *
+ * This file contains the main data fetching logic.
+ * Rename this class and update all the properties.
+ */
+import { BaseIntegration, } from '../base.js';
+export class TemplateIntegration extends BaseIntegration {
+    // ============================================
+    // Required properties - update these
+    // ============================================
+    name = 'template';
+    displayName = 'Template Service';
+    description = 'Fetch data from Template Service';
+    website = 'https://example.com';
+    // Supported auth methods: 'cli' | 'api-key' | 'oauth' | 'none'
+    authMethods = ['api-key'];
+    // ============================================
+    // Optional: CLI authentication
+    // ============================================
+    /**
+     * Check if CLI tool is available and authenticated
+     * Only implement if authMethods includes 'cli'
+     */
+    async isCliAvailable() {
+        // Example: Check if a CLI is installed and authenticated
+        // try {
+        //   const { execa } = await import('execa');
+        //   await execa('your-cli', ['auth', 'status']);
+        //   return true;
+        // } catch {
+        //   return false;
+        // }
+        return false;
+    }
+    // ============================================
+    // Main fetch method
+    // ============================================
+    async fetch(identifier, options) {
+        // Get authentication
+        const authMethod = await this.getConfiguredAuthMethod();
+        if (!authMethod) {
+            this.error('No authentication configured. Run: ralph-starter config set template.apiKey <key>');
+        }
+        // Fetch data based on auth method
+        if (authMethod === 'cli') {
+            return this.fetchViaCli(identifier, options);
+        }
+        return this.fetchViaApi(identifier, options);
+    }
+    /**
+     * Fetch via CLI tool
+     */
+    async fetchViaCli(_identifier, _options) {
+        // Example implementation:
+        // const { execa } = await import('execa');
+        // const result = await execa('your-cli', ['list', identifier, '--json']);
+        // const data = JSON.parse(result.stdout);
+        // return this.formatResults(data);
+        throw new Error('CLI fetch not implemented');
+    }
+    /**
+     * Fetch via API
+     */
+    async fetchViaApi(identifier, _options) {
+        const apiKey = await this.getApiKey();
+        // Example: Make API request
+        const response = await fetch(`https://api.example.com/data/${identifier}`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                this.error('Invalid API key. Run: ralph-starter config set template.apiKey <key>');
+            }
+            this.error(`API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return this.formatResults(data, identifier);
+    }
+    /**
+     * Format API results to markdown
+     */
+    formatResults(data, identifier) {
+        const sections = [`# ${identifier}\n`];
+        // Format your data here
+        sections.push('*Add your formatting logic*');
+        return {
+            content: sections.join('\n'),
+            source: `template:${identifier}`,
+            title: identifier,
+            metadata: {
+                type: 'template',
+                count: data.length,
+            },
+        };
+    }
+    // ============================================
+    // Help text
+    // ============================================
+    getHelp() {
+        return `
+template: Fetch data from Template Service
+
+Usage:
+  ralph-starter run --from template --project "project-name"
+
+Options:
+  --project  Project name or identifier
+  --label    Filter by label (optional)
+  --limit    Maximum items to fetch (default: 20)
+
+Setup:
+  1. Get API key from: https://example.com/settings/api
+  2. Run: ralph-starter config set template.apiKey <key>
+
+Examples:
+  ralph-starter run --from template --project "my-project"
+`.trim();
+    }
+}
+//# sourceMappingURL=source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/integrations/_template/source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,eAAe,GAGhB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,+CAA+C;IAC/C,qCAAqC;IACrC,+CAA+C;IAE/C,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,kBAAkB,CAAC;IACjC,WAAW,GAAG,kCAAkC,CAAC;IACjD,OAAO,GAAG,qBAAqB,CAAC;IAEhC,+DAA+D;IAC/D,WAAW,GAAiB,CAAC,SAAS,CAAC,CAAC;IAExC,+CAA+C;IAC/C,+BAA+B;IAC/B,+CAA+C;IAE/C;;;OAGG;IACO,KAAK,CAAC,cAAc;QAC5B,yDAAyD;QACzD,QAAQ;QACR,6CAA6C;QAC7C,iDAAiD;QACjD,iBAAiB;QACjB,YAAY;QACZ,kBAAkB;QAClB,IAAI;QACJ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,oBAAoB;IACpB,+CAA+C;IAE/C,KAAK,CAAC,KAAK,CAAC,UAAkB,EAAE,OAA4B;QAC1D,qBAAqB;QACrB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAExD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CACR,mFAAmF,CACpF,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,WAAmB,EACnB,QAA6B;QAE7B,0BAA0B;QAC1B,2CAA2C;QAC3C,0EAA0E;QAC1E,0CAA0C;QAC1C,mCAAmC;QAEnC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,UAAkB,EAClB,QAA6B;QAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEtC,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gCAAgC,UAAU,EAAE,EAAE;YACzE,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAiC,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,IAA+B,EAAE,UAAkB;QACvE,MAAM,QAAQ,GAAa,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC;QAEjD,wBAAwB;QACxB,QAAQ,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAE7C,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAE,YAAY,UAAU,EAAE;YAChC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,IAAI,CAAC,MAAM;aACnB;SACF,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,YAAY;IACZ,+CAA+C;IAE/C,OAAO;QACL,OAAO;;;;;;;;;;;;;;;;;CAiBV,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;CACF"}