vralphy 0.8.0

package/dist/index.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { resolveConfig } from './lib/config.js';
+import { buildCommand } from './commands/build.js';
+import { planCommand } from './commands/plan.js';
+import { specCommand } from './commands/spec.js';
+import { initCommand } from './commands/init.js';
+import { cleanupCommand } from './commands/cleanup.js';
+import { detectEngines } from './lib/engines/index.js';
+import { listSkills, getSkill } from './lib/skills.js';
+import { listAgents, getAgent } from './lib/agents.js';
+import { getSkillsDir, getAgentsDir } from './lib/config.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('vralphy')
+    .description('CLI tool implementing the Ralph Playbook methodology')
+    .version(packageJson.version);
+program
+    .option('--engine <engine>', 'Engine selection (claude|opencode|codex)')
+    .option('--planning-model <model>', 'Planning model (default: opus)')
+    .option('--executor-model <model>', 'Executor/subagent model (default: sonnet)')
+    .option('--skills <path>', 'Skills directory')
+    .option('--agents <path>', 'Agents directory')
+    .option('--config <path>', 'Config file (default: vralphy.config.json)')
+    .option('--reasoning-effort <level>', 'Reasoning effort level (e.g., high, xhigh)')
+    .option('--verbose', 'Verbose output', false)
+    .option('--dry-run', 'Show what would execute without running', false);
+program
+    .command('build [iterations]')
+    .description('Run build mode (default command)')
+    .action(async (iterations) => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    let parsedIterations;
+    if (iterations) {
+        parsedIterations = parseInt(iterations, 10);
+        if (isNaN(parsedIterations) || parsedIterations < 0 || parsedIterations > 1000000) {
+            console.error('Error: iterations must be a positive number between 0 and 1,000,000');
+            process.exit(1);
+        }
+    }
+    await buildCommand(config, { iterations: parsedIterations });
+});
+program
+    .command('plan [iterations]')
+    .description('Run plan mode')
+    .action(async (iterations) => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    let parsedIterations;
+    if (iterations) {
+        parsedIterations = parseInt(iterations, 10);
+        if (isNaN(parsedIterations) || parsedIterations < 0 || parsedIterations > 1000000) {
+            console.error('Error: iterations must be a positive number between 0 and 1,000,000');
+            process.exit(1);
+        }
+    }
+    await planCommand(config, { iterations: parsedIterations });
+});
+program
+    .command('spec [topic]')
+    .description('Interactive spec creation')
+    .action(async (topic) => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    await specCommand(config, { topic });
+});
+program
+    .command('init')
+    .description('Initialize project for vralphy')
+    .option('--from <path>', 'Initialize from existing project')
+    .option('--no-ai', 'Skip AI generation, use template fallback')
+    .option('--no-inject', 'Skip injecting references into CLAUDE.md and AGENTS.md')
+    .option('--approve', 'Review AGENTS.md before saving')
+    .option('--engine <engine>', 'Specify engine for AI generation (claude|opencode|codex)')
+    .action(async (cmdOpts) => {
+    const globalOpts = program.opts();
+    // Commander parses --no-ai as ai: false, so we convert to noAi: true
+    const noAi = cmdOpts.ai === false;
+    const noInject = cmdOpts.inject === false;
+    await initCommand({ ...cmdOpts, noAi, noInject, verbose: globalOpts.verbose });
+});
+program
+    .command('cleanup')
+    .description('Remove vralphy from project')
+    .option('--from <path>', 'Clean up from existing project')
+    .option('--remove-specs', 'Also remove specs/ directory')
+    .option('--force', 'Skip confirmation prompt')
+    .action(async (cmdOpts) => {
+    await cleanupCommand(cmdOpts);
+});
+program
+    .command('engines')
+    .description('List available engines')
+    .action(async () => {
+    const available = await detectEngines();
+    console.log('Available engines:');
+    for (const engine of available) {
+        console.log(`  - ${engine}`);
+    }
+    if (available.length === 0) {
+        console.log('  (none found - install claude or opencode CLI)');
+    }
+});
+const skillsCmd = program
+    .command('skills')
+    .description('Manage skills');
+skillsCmd
+    .command('list')
+    .description('List available skills')
+    .action(async () => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const skillsDir = getSkillsDir(config.engine, config.skillsDir);
+    const skills = await listSkills(skillsDir);
+    if (skills.length === 0) {
+        console.log(`No skills found in: ${skillsDir}`);
+        console.log('Create .md files with frontmatter to add skills.');
+        return;
+    }
+    console.log('Available skills:');
+    for (const skill of skills) {
+        console.log(`  - ${skill.name}${skill.description ? `: ${skill.description}` : ''}`);
+    }
+});
+skillsCmd
+    .command('show <name>')
+    .description('Show skill content')
+    .action(async (name) => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const skillsDir = getSkillsDir(config.engine, config.skillsDir);
+    const skill = await getSkill(skillsDir, name);
+    if (!skill) {
+        console.error(`Skill not found: ${name}`);
+        console.log(`\nAvailable skills in ${skillsDir}:`);
+        const skills = await listSkills(skillsDir);
+        for (const s of skills) {
+            console.log(`  - ${s.name}`);
+        }
+        process.exit(1);
+    }
+    console.log(`# ${skill.name}`);
+    if (skill.metadata.description) {
+        console.log(`\n${skill.metadata.description}`);
+    }
+    if (skill.metadata.triggers && skill.metadata.triggers.length > 0) {
+        console.log(`\nTriggers: ${skill.metadata.triggers.join(', ')}`);
+    }
+    if (skill.metadata.alwaysInclude) {
+        console.log('Always included: yes');
+    }
+    console.log(`\n---\n`);
+    console.log(skill.content);
+});
+// Default action for 'skills' with no subcommand (backwards compat)
+skillsCmd.action(async () => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const skillsDir = getSkillsDir(config.engine, config.skillsDir);
+    const skills = await listSkills(skillsDir);
+    if (skills.length === 0) {
+        console.log(`No skills found in: ${skillsDir}`);
+        console.log('Create .md files with frontmatter to add skills.');
+        return;
+    }
+    console.log('Available skills:');
+    for (const skill of skills) {
+        console.log(`  - ${skill.name}${skill.description ? `: ${skill.description}` : ''}`);
+    }
+});
+const agentsCmd = program
+    .command('agents')
+    .description('Manage agents');
+agentsCmd
+    .command('list')
+    .description('List available agents')
+    .action(async () => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const agentsDir = getAgentsDir(config.engine, config.agentsDir);
+    const agents = await listAgents(agentsDir);
+    if (agents.length === 0) {
+        console.log(`No agents found in: ${agentsDir}`);
+        console.log('Create .md files with frontmatter to add agents.');
+        return;
+    }
+    console.log('Available agents:');
+    for (const agent of agents) {
+        const model = agent.model ? ` (${agent.model})` : '';
+        console.log(`  - ${agent.name}${model}${agent.description ? `: ${agent.description}` : ''}`);
+    }
+});
+agentsCmd
+    .command('show <name>')
+    .description('Show agent content')
+    .action(async (name) => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const agentsDir = getAgentsDir(config.engine, config.agentsDir);
+    const agent = await getAgent(agentsDir, name);
+    if (!agent) {
+        console.error(`Agent not found: ${name}`);
+        console.log(`\nAvailable agents in ${agentsDir}:`);
+        const agents = await listAgents(agentsDir);
+        for (const a of agents) {
+            console.log(`  - ${a.name}`);
+        }
+        process.exit(1);
+    }
+    console.log(`# ${agent.name}`);
+    if (agent.metadata.description) {
+        console.log(`\n${agent.metadata.description}`);
+    }
+    if (agent.metadata.model) {
+        console.log(`\nModel: ${agent.metadata.model}`);
+    }
+    console.log(`\n---\n`);
+    console.log(agent.content);
+});
+// Default action for 'agents' with no subcommand (backwards compat)
+agentsCmd.action(async () => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    const agentsDir = getAgentsDir(config.engine, config.agentsDir);
+    const agents = await listAgents(agentsDir);
+    if (agents.length === 0) {
+        console.log(`No agents found in: ${agentsDir}`);
+        console.log('Create .md files with frontmatter to add agents.');
+        return;
+    }
+    console.log('Available agents:');
+    for (const agent of agents) {
+        const model = agent.model ? ` (${agent.model})` : '';
+        console.log(`  - ${agent.name}${model}${agent.description ? `: ${agent.description}` : ''}`);
+    }
+});
+program
+    .action(async () => {
+    const opts = program.opts();
+    const config = await resolveConfig(opts);
+    await buildCommand(config, {});
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/agents.d.ts

@@ -0,0 +1,32 @@
+export interface AgentMetadata {
+    name: string;
+    description?: string;
+    model?: string;
+}
+export interface Agent {
+    name: string;
+    path: string;
+    metadata: AgentMetadata;
+    content: string;
+}
+/**
+ * Load all agents from a directory
+ */
+export declare function loadAgents(dir: string): Promise<Agent[]>;
+/**
+ * Format agents for prompt injection
+ */
+export declare function formatAgentsForPrompt(agents: Agent[], defaultModel: string): string;
+/**
+ * List available agents (for CLI command)
+ */
+export declare function listAgents(dir: string): Promise<{
+    name: string;
+    description?: string;
+    model?: string;
+}[]>;
+/**
+ * Get agent by name
+ */
+export declare function getAgent(dir: string, name: string): Promise<Agent | undefined>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/lib/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/lib/agents.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAoB9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAO/G;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAGpF"}

package/dist/lib/agents.js

@@ -0,0 +1,96 @@
+import { readFile, readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, basename } from 'path';
+/**
+ * Parse frontmatter from markdown file
+ */
+function parseFrontmatter(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        return { metadata: {}, content };
+    }
+    const [, frontmatter, body] = frontmatterMatch;
+    const metadata = {};
+    for (const line of frontmatter.split('\n')) {
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+            const [, key, value] = match;
+            metadata[key] = value;
+        }
+    }
+    return { metadata, content: body };
+}
+/**
+ * Load a single agent from file
+ */
+async function loadAgent(path) {
+    const content = await readFile(path, 'utf-8');
+    const { metadata, content: body } = parseFrontmatter(content);
+    const name = metadata.name ?? basename(path, '.md');
+    return {
+        name,
+        path,
+        metadata: {
+            name,
+            description: metadata.description,
+            model: metadata.model,
+        },
+        content: body,
+    };
+}
+/**
+ * Load all agents from a directory
+ */
+export async function loadAgents(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const files = await readdir(dir);
+    const mdFiles = files.filter((f) => f.endsWith('.md'));
+    const agents = [];
+    for (const file of mdFiles) {
+        try {
+            const agent = await loadAgent(join(dir, file));
+            agents.push(agent);
+        }
+        catch (e) {
+            console.error(`Failed to load agent ${file}:`, e);
+        }
+    }
+    return agents;
+}
+/**
+ * Format agents for prompt injection
+ */
+export function formatAgentsForPrompt(agents, defaultModel) {
+    if (agents.length === 0)
+        return '';
+    let result = '## Available Specialized Agents\n\n';
+    result += 'You may spawn these agents using subagents when their expertise is needed:\n\n';
+    for (const agent of agents) {
+        const name = agent.name ?? 'Unnamed Agent';
+        const description = agent.metadata?.description ?? 'No description';
+        const model = agent.metadata?.model ?? defaultModel;
+        result += `- **${name}**: ${description} (use ${model})\n`;
+    }
+    return result;
+}
+/**
+ * List available agents (for CLI command)
+ */
+export async function listAgents(dir) {
+    const agents = await loadAgents(dir);
+    return agents.map((a) => ({
+        name: a.name,
+        description: a.metadata.description,
+        model: a.metadata.model,
+    }));
+}
+/**
+ * Get agent by name
+ */
+export async function getAgent(dir, name) {
+    const agents = await loadAgents(dir);
+    return agents.find((a) => a.name === name);
+}
+//# sourceMappingURL=agents.js.map

package/dist/lib/agents.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,54 @@
+import { EngineName } from './engines/index.js';
+export interface CodexConfig {
+    maxAgents?: number;
+    workerTimeout?: number;
+}
+export interface VralphyConfig {
+    engine: EngineName;
+    planningModel: string;
+    executorModel: string;
+    skillsDir: string;
+    agentsDir: string;
+    verbose: boolean;
+    dryRun: boolean;
+    reasoningEffort?: string;
+    codex?: CodexConfig;
+    slackWebhook?: string;
+}
+export interface ConfigOptions {
+    engine?: string;
+    planningModel?: string;
+    executorModel?: string;
+    skills?: string;
+    agents?: string;
+    config?: string;
+    reasoningEffort?: string;
+    verbose?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Get preferred project config path (non-invasive location)
+ */
+export declare function getPreferredConfigPath(): string;
+/**
+ * Get all possible project config paths in order of preference
+ */
+export declare function getProjectConfigPaths(): string[];
+/**
+ * Resolve configuration from multiple sources
+ * Priority: CLI flags > env vars > project config > global config > defaults
+ */
+export declare function resolveConfig(cliOptions: ConfigOptions): Promise<VralphyConfig>;
+/**
+ * Determine skills directory based on engine
+ */
+export declare function getSkillsDir(engine: EngineName, customPath?: string): string;
+/**
+ * Determine agents directory based on engine
+ */
+export declare function getAgentsDir(engine: EngineName, customPath?: string): string;
+/**
+ * Find project root by looking for common markers
+ */
+export declare function findProjectRoot(startDir?: string): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAa,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2CD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAKhD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAqFrF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAoBxE"}

package/dist/lib/config.js

@@ -0,0 +1,199 @@
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, parse as parsePath } from 'path';
+import { homedir } from 'os';
+import { getEngine } from './engines/index.js';
+import { validateModelForEngine } from './engines/base.js';
+const DEFAULT_CONFIG = {
+    engine: 'claude',
+    planningModel: 'opus',
+    executorModel: 'sonnet',
+    skillsDir: '.claude/skills',
+    agentsDir: 'agents',
+    verbose: false,
+    dryRun: false,
+    reasoningEffort: undefined,
+    codex: {
+        maxAgents: 8,
+        workerTimeout: 300,
+    },
+};
+/**
+ * Load config from file if it exists
+ */
+async function loadConfigFile(path) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    try {
+        const content = await readFile(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (e) {
+        const errorMsg = e instanceof Error ? e.message : String(e);
+        console.warn(`Warning: Failed to parse config file at ${path}: ${errorMsg}`);
+        console.warn('Using default configuration instead.');
+        return {};
+    }
+}
+/**
+ * Get path to global config file
+ */
+function getGlobalConfigPath() {
+    return join(homedir(), '.config', 'vralphy', 'config.json');
+}
+/**
+ * Get preferred project config path (non-invasive location)
+ */
+export function getPreferredConfigPath() {
+    return '.vralphy/config.json';
+}
+/**
+ * Get all possible project config paths in order of preference
+ */
+export function getProjectConfigPaths() {
+    return [
+        '.vralphy/config.json', // Preferred (non-invasive)
+        'vralphy.config.json', // Legacy (backwards compat)
+    ];
+}
+/**
+ * Resolve configuration from multiple sources
+ * Priority: CLI flags > env vars > project config > global config > defaults
+ */
+export async function resolveConfig(cliOptions) {
+    // Load global config first (lowest priority of file configs)
+    const globalConfig = await loadConfigFile(getGlobalConfigPath());
+    // Load project config (overrides global)
+    // Prefer .vralphy/config.json (non-invasive), fallback to vralphy.config.json (legacy)
+    let configPath;
+    if (cliOptions.config) {
+        configPath = cliOptions.config;
+    }
+    else {
+        const projectConfigPaths = [
+            '.vralphy/config.json', // Preferred (non-invasive)
+            'vralphy.config.json', // Legacy (backwards compat)
+        ];
+        configPath = projectConfigPaths.find(p => existsSync(p)) ?? '.vralphy/config.json';
+    }
+    const projectConfig = await loadConfigFile(configPath);
+    // Merge: global ← project (project wins)
+    const fileConfig = {
+        ...globalConfig,
+        ...projectConfig,
+        // Deep merge codex config
+        codex: {
+            ...globalConfig.codex,
+            ...projectConfig.codex,
+        },
+    };
+    // Resolve Codex-specific config
+    const codexMaxAgents = process.env.VRALPHY_CODEX_MAX_AGENTS
+        ? parseInt(process.env.VRALPHY_CODEX_MAX_AGENTS, 10)
+        : fileConfig.codex?.maxAgents ?? DEFAULT_CONFIG.codex?.maxAgents;
+    const codexWorkerTimeout = process.env.VRALPHY_CODEX_WORKER_TIMEOUT
+        ? parseInt(process.env.VRALPHY_CODEX_WORKER_TIMEOUT, 10)
+        : fileConfig.codex?.workerTimeout ?? DEFAULT_CONFIG.codex?.workerTimeout;
+    // Validate and resolve engine
+    const engineValue = cliOptions.engine ?? process.env.VRALPHY_ENGINE ?? fileConfig.engine ?? DEFAULT_CONFIG.engine;
+    const validEngines = ['claude', 'opencode', 'codex'];
+    if (!validEngines.includes(engineValue)) {
+        throw new Error(`Invalid engine: ${engineValue}. Must be one of: ${validEngines.join(', ')}`);
+    }
+    // Resolve Slack webhook URL
+    const slackWebhook = process.env.VRALPHY_SLACK_WEBHOOK ?? fileConfig.slackWebhook;
+    const config = {
+        engine: engineValue,
+        planningModel: cliOptions.planningModel ?? process.env.VRALPHY_PLANNING_MODEL ?? fileConfig.planningModel ?? DEFAULT_CONFIG.planningModel,
+        executorModel: cliOptions.executorModel ?? process.env.VRALPHY_EXECUTOR_MODEL ?? fileConfig.executorModel ?? DEFAULT_CONFIG.executorModel,
+        skillsDir: cliOptions.skills ?? fileConfig.skillsDir ?? DEFAULT_CONFIG.skillsDir,
+        agentsDir: cliOptions.agents ?? fileConfig.agentsDir ?? DEFAULT_CONFIG.agentsDir,
+        verbose: cliOptions.verbose ?? fileConfig.verbose ?? DEFAULT_CONFIG.verbose,
+        dryRun: cliOptions.dryRun ?? fileConfig.dryRun ?? DEFAULT_CONFIG.dryRun,
+        reasoningEffort: cliOptions.reasoningEffort ?? process.env.VRALPHY_REASONING_EFFORT ?? fileConfig.reasoningEffort ?? DEFAULT_CONFIG.reasoningEffort,
+        codex: {
+            maxAgents: codexMaxAgents,
+            workerTimeout: codexWorkerTimeout,
+        },
+        slackWebhook,
+    };
+    // Validate model is compatible with engine
+    validateModelForEngine(config.planningModel, config.engine);
+    // Soft-validate model availability (warn, don't error)
+    const engine = getEngine(config.engine);
+    const isSupported = await engine.isModelSupported(config.planningModel);
+    if (!isSupported) {
+        const availableModels = await engine.getAvailableModels();
+        if (availableModels.length === 0) {
+            // Cache unavailable - allow execution
+            console.warn(`Warning: Could not verify model '${config.planningModel}' (${config.engine} model cache unavailable).`);
+            console.warn('Attempting to use anyway. If model is invalid, the engine will report an error.\n');
+        }
+        else {
+            // Cache available but model not found - still allow but warn
+            console.warn(`Warning: Model '${config.planningModel}' not found in ${config.engine} cache.`);
+            console.warn(`Known models: ${availableModels.slice(0, 5).join(', ')}${availableModels.length > 5 ? '...' : ''}`);
+            console.warn('Attempting to use anyway.\n');
+        }
+    }
+    return config;
+}
+/**
+ * Determine skills directory based on engine
+ */
+export function getSkillsDir(engine, customPath) {
+    if (customPath)
+        return customPath;
+    const engineDirs = {
+        claude: '.claude/skills',
+        opencode: '.opencode/skills',
+        codex: '.codex/skills',
+    };
+    const engineDir = engineDirs[engine];
+    if (existsSync(engineDir))
+        return engineDir;
+    if (existsSync('skills'))
+        return 'skills';
+    return engineDir;
+}
+/**
+ * Determine agents directory based on engine
+ */
+export function getAgentsDir(engine, customPath) {
+    if (customPath)
+        return customPath;
+    const engineDirs = {
+        claude: '.claude/agents',
+        opencode: '.opencode/agents',
+        codex: '.codex/agents',
+    };
+    const engineDir = engineDirs[engine];
+    if (existsSync(engineDir))
+        return engineDir;
+    if (existsSync('agents'))
+        return 'agents';
+    return engineDir;
+}
+/**
+ * Find project root by looking for common markers
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let dir = startDir;
+    const rootPath = parsePath(dir).root;
+    while (dir !== rootPath) {
+        const markers = ['package.json', 'Cargo.toml', 'go.mod', '.git', 'AGENTS.md'];
+        for (const marker of markers) {
+            if (existsSync(join(dir, marker))) {
+                return dir;
+            }
+        }
+        const parent = join(dir, '..');
+        // Prevent infinite loop if join doesn't change the path
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return startDir;
+}
+//# sourceMappingURL=config.js.map