@omnidev-ai/core 0.3.0 → 0.4.0

package/src/config/loader.ts

@@ -1,207 +0,0 @@
-import { existsSync } from "node:fs";
-import type { OmniConfig } from "../types";
-import { parseOmniConfig } from "./parser";
-
-const CONFIG_PATH = "omni.toml";
-const LOCAL_CONFIG = "omni.local.toml";
-
-/**
- * Deep merge two config objects, with override taking precedence
- * @param base - The base config object
- * @param override - The override config object
- * @returns Merged config with override values taking precedence
- */
-function mergeConfigs(base: OmniConfig, override: OmniConfig): OmniConfig {
-	const merged: OmniConfig = { ...base, ...override };
-
-	// Deep merge env
-	merged.env = { ...base.env, ...override.env };
-
-	// Deep merge profiles
-	merged.profiles = { ...base.profiles };
-	for (const [name, profile] of Object.entries(override.profiles || {})) {
-		merged.profiles[name] = {
-			...(base.profiles?.[name] || {}),
-			...profile,
-		};
-	}
-
-	// Deep merge mcps (only if at least one config has it)
-	if (base.mcps || override.mcps) {
-		merged.mcps = { ...base.mcps, ...override.mcps };
-	}
-
-	return merged;
-}
-
-/**
- * Load and merge config and local configuration files
- * @returns Merged OmniConfig object
- *
- * Reads omni.toml (main config) and omni.local.toml (local overrides).
- * Local config takes precedence over main config. Missing files are treated as empty configs.
- */
-export async function loadConfig(): Promise<OmniConfig> {
-	let baseConfig: OmniConfig = {};
-	let localConfig: OmniConfig = {};
-
-	if (existsSync(CONFIG_PATH)) {
-		const content = await Bun.file(CONFIG_PATH).text();
-		baseConfig = parseOmniConfig(content);
-	}
-
-	if (existsSync(LOCAL_CONFIG)) {
-		const content = await Bun.file(LOCAL_CONFIG).text();
-		localConfig = parseOmniConfig(content);
-	}
-
-	return mergeConfigs(baseConfig, localConfig);
-}
-
-/**
- * Write config to omni.toml at project root
- * @param config - The config object to write
- */
-export async function writeConfig(config: OmniConfig): Promise<void> {
-	const content = generateConfigToml(config);
-	await Bun.write(CONFIG_PATH, content);
-}
-
-/**
- * Generate TOML content for OmniConfig
- * @param config - The config object
- * @returns TOML string
- */
-function generateConfigToml(config: OmniConfig): string {
-	const lines: string[] = [];
-
-	lines.push("# =============================================================================");
-	lines.push("# OmniDev Configuration");
-	lines.push("# =============================================================================");
-	lines.push("# This file defines your project's capabilities, profiles, and settings.");
-	lines.push("#");
-	lines.push("# Files:");
-	lines.push("#   • omni.toml - Main config (commit to share with team)");
-	lines.push("#   • omni.local.toml - Local overrides (add to .gitignore)");
-	lines.push("#   • omni.lock.toml - Version lock file (commit for reproducibility)");
-	lines.push("#");
-	lines.push("# Quick start:");
-	lines.push("#   1. Add capability sources to [capabilities.sources]");
-	lines.push("#   2. Reference them in your profiles");
-	lines.push("#   3. Run: omnidev sync");
-	lines.push("#   4. Switch profiles: omnidev profile use <name>");
-	lines.push("");
-
-	// Project name
-	if (config.project) {
-		lines.push(`project = "${config.project}"`);
-		lines.push("");
-	}
-
-	// Note: active_profile is stored in .omni/state/active-profile, not in config.toml
-	// We still read it from config.toml for backwards compatibility, but don't write it here
-
-	// Providers
-	if (config.providers?.enabled && config.providers.enabled.length > 0) {
-		lines.push("# AI providers to enable (claude, codex, or both)");
-		lines.push("[providers]");
-		lines.push(`enabled = [${config.providers.enabled.map((p) => `"${p}"`).join(", ")}]`);
-		lines.push("");
-	}
-
-	// Environment variables
-	lines.push("# =============================================================================");
-	lines.push("# Environment Variables");
-	lines.push("# =============================================================================");
-	lines.push("# Global environment variables available to all capabilities.");
-	// biome-ignore lint/suspicious/noTemplateCurlyInString: Example of env var syntax
-	lines.push("# Use ${VAR_NAME} syntax to reference shell environment variables.");
-	lines.push("#");
-	if (config.env && Object.keys(config.env).length > 0) {
-		lines.push("[env]");
-		for (const [key, value] of Object.entries(config.env)) {
-			lines.push(`${key} = "${value}"`);
-		}
-	} else {
-		lines.push("# [env]");
-		// biome-ignore lint/suspicious/noTemplateCurlyInString: Example of env var syntax
-		lines.push('# DATABASE_URL = "${DATABASE_URL}"');
-		// biome-ignore lint/suspicious/noTemplateCurlyInString: Example of env var syntax
-		lines.push('# API_KEY = "${MY_API_KEY}"');
-	}
-	lines.push("");
-
-	// Capability sources (commented examples)
-	lines.push("# =============================================================================");
-	lines.push("# Capability Sources");
-	lines.push("# =============================================================================");
-	lines.push("# Fetch capabilities from Git repositories. On sync, these are");
-	lines.push("# cloned/updated and made available to your profiles.");
-	lines.push("#");
-	lines.push("# [capabilities.sources]");
-	lines.push("# # GitHub shorthand (uses latest commit)");
-	lines.push('# tasks = "github:example-org/tasks-capability"');
-	lines.push("#");
-	lines.push("# # Version pinning (recommended for production)");
-	lines.push('# ralph = { source = "github:example-org/ralph", ref = "v1.2.0" }');
-	lines.push("#");
-	lines.push("# # Other Git sources");
-	lines.push('# private = "git@github.com:company/private-cap.git"');
-	lines.push('# gitlab = "https://gitlab.com/user/capability.git"');
-	lines.push("");
-
-	// MCP servers (commented examples)
-	lines.push("# =============================================================================");
-	lines.push("# MCP Servers");
-	lines.push("# =============================================================================");
-	lines.push("# Define MCP servers that automatically become capabilities.");
-	lines.push(
-		'# Reference in profiles using the MCP name directly, e.g. capabilities = ["filesystem"]',
-	);
-	lines.push("#");
-	lines.push("# [mcps.filesystem]");
-	lines.push('# command = "npx"');
-	lines.push('# args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]');
-	lines.push('# transport = "stdio"  # stdio (default), sse, or http');
-	lines.push("#");
-	lines.push("# [mcps.database]");
-	lines.push('# command = "node"');
-	lines.push('# args = ["./servers/database.js"]');
-	lines.push('# cwd = "./mcp-servers"');
-	lines.push("# [mcps.database.env]");
-	// biome-ignore lint/suspicious/noTemplateCurlyInString: Example of env var syntax
-	lines.push('# DB_URL = "${DATABASE_URL}"');
-	lines.push("");
-
-	// Always enabled capabilities
-	lines.push("# =============================================================================");
-	lines.push("# Always Enabled Capabilities");
-	lines.push("# =============================================================================");
-	lines.push("# Capabilities that load in ALL profiles, regardless of profile config.");
-	lines.push("# Useful for essential tools needed everywhere.");
-	lines.push("#");
-	lines.push('# always_enabled_capabilities = ["git-tools", "linting"]');
-	lines.push("");
-
-	// Profiles
-	lines.push("# =============================================================================");
-	lines.push("# Profiles");
-	lines.push("# =============================================================================");
-	lines.push("# Define different capability sets for different workflows.");
-	lines.push("# Switch profiles with: omnidev profile use <name>");
-	lines.push("");
-	if (config.profiles && Object.keys(config.profiles).length > 0) {
-		for (const [name, profile] of Object.entries(config.profiles)) {
-			lines.push(`[profiles.${name}]`);
-			const capabilities = profile.capabilities ?? [];
-			if (capabilities.length > 0) {
-				lines.push(`capabilities = [${capabilities.map((id) => `"${id}"`).join(", ")}]`);
-			} else {
-				lines.push("capabilities = []");
-			}
-			lines.push("");
-		}
-	}
-
-	return lines.join("\n");
-}

package/src/config/parser.test.ts

@@ -1,256 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { parseCapabilityConfig, parseOmniConfig } from "./parser";
-
-describe("parseOmniConfig", () => {
-	test("parses valid TOML with all fields", () => {
-		const toml = `
-project = "my-project"
-default_profile = "dev"
-
-[capabilities]
-enable = ["tasks", "git"]
-disable = ["docker"]
-
-[env]
-API_URL = "https://api.example.com"
-
-[profiles.dev]
-enable = ["debug"]
-disable = []
-
-[profiles.prod]
-enable = []
-disable = ["debug"]
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect(config.project).toBe("my-project");
-		expect(config.default_profile).toBe("dev");
-		expect(config.capabilities?.enable).toEqual(["tasks", "git"]);
-		expect(config.capabilities?.disable).toEqual(["docker"]);
-		expect(config.env?.API_URL).toBe("https://api.example.com");
-		expect(config.profiles?.dev?.enable).toEqual(["debug"]);
-		expect(config.profiles?.prod?.disable).toEqual(["debug"]);
-	});
-
-	test("parses minimal TOML", () => {
-		const toml = `
-project = "minimal"
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect(config.project).toBe("minimal");
-		expect(config.capabilities).toBeUndefined();
-		expect(config.profiles).toBeUndefined();
-	});
-
-	test("parses empty TOML", () => {
-		const config = parseOmniConfig("");
-
-		expect(config).toEqual({});
-	});
-
-	test("parses TOML with arrays", () => {
-		const toml = `
-[capabilities]
-enable = ["cap1", "cap2", "cap3"]
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect(config.capabilities?.enable).toEqual(["cap1", "cap2", "cap3"]);
-	});
-
-	test("parses TOML with nested tables", () => {
-		const toml = `
-[profiles.dev]
-enable = ["debug"]
-
-[profiles.prod]
-disable = ["debug"]
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect(config.profiles?.dev?.enable).toEqual(["debug"]);
-		expect(config.profiles?.prod?.disable).toEqual(["debug"]);
-	});
-
-	test("throws error for invalid TOML syntax", () => {
-		const toml = `
-project = "test
-[invalid
-		`;
-
-		expect(() => parseOmniConfig(toml)).toThrow(/Invalid TOML in config:/);
-	});
-
-	test("throws error for duplicate keys", () => {
-		const toml = `
-project = "test"
-project = "duplicate"
-		`;
-
-		expect(() => parseOmniConfig(toml)).toThrow(/Invalid TOML in config:/);
-	});
-
-	test("handles boolean values", () => {
-		const toml = `
-[capabilities]
-debug = true
-production = false
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect((config.capabilities as Record<string, unknown>)?.debug).toBe(true);
-		expect((config.capabilities as Record<string, unknown>)?.production).toBe(false);
-	});
-
-	test("handles numeric values", () => {
-		const toml = `
-timeout = 30
-max_retries = 5
-		`;
-
-		const config = parseOmniConfig(toml);
-
-		expect((config as Record<string, unknown>).timeout).toBe(30);
-		expect((config as Record<string, unknown>).max_retries).toBe(5);
-	});
-});
-
-describe("parseCapabilityConfig", () => {
-	test("parses valid capability.toml with all required fields", () => {
-		const toml = `
-[capability]
-id = "tasks"
-name = "Task Management"
-version = "1.0.0"
-description = "Manage tasks and workflows"
-		`;
-
-		const config = parseCapabilityConfig(toml);
-
-		expect(config.capability.id).toBe("tasks");
-		expect(config.capability.name).toBe("Task Management");
-		expect(config.capability.version).toBe("1.0.0");
-		expect(config.capability.description).toBe("Manage tasks and workflows");
-	});
-
-	test("parses capability with exports", () => {
-		const toml = `
-[capability]
-id = "tasks"
-name = "Task Management"
-version = "1.0.0"
-description = "Manage tasks"
-
-[exports]
-module = "index.ts"
-		`;
-
-		const config = parseCapabilityConfig(toml);
-
-		expect(config.exports?.module).toBe("index.ts");
-	});
-
-	test("parses capability with env declarations", () => {
-		const toml = `
-[capability]
-id = "api"
-name = "API Client"
-version = "1.0.0"
-description = "API access"
-
-[env.API_KEY]
-required = true
-secret = true
-
-[env.API_URL]
-required = false
-default = "https://api.example.com"
-		`;
-
-		const config = parseCapabilityConfig(toml);
-
-		expect(config.env?.API_KEY).toEqual({ required: true, secret: true });
-		expect(config.env?.API_URL).toEqual({
-			required: false,
-			default: "https://api.example.com",
-		});
-	});
-
-	test("throws error when capability.id is missing", () => {
-		const toml = `
-[capability]
-name = "Test"
-version = "1.0.0"
-		`;
-
-		expect(() => parseCapabilityConfig(toml)).toThrow(
-			/capability.id is required in capability.toml/,
-		);
-	});
-
-	test("throws error when capability.name is missing", () => {
-		const toml = `
-[capability]
-id = "test"
-version = "1.0.0"
-		`;
-
-		expect(() => parseCapabilityConfig(toml)).toThrow(
-			/capability.name is required in capability.toml/,
-		);
-	});
-
-	test("throws error when capability.version is missing", () => {
-		const toml = `
-[capability]
-id = "test"
-name = "Test"
-		`;
-
-		expect(() => parseCapabilityConfig(toml)).toThrow(
-			/capability.version is required in capability.toml/,
-		);
-	});
-
-	test("throws error when capability table is missing", () => {
-		const toml = `
-project = "test"
-		`;
-
-		expect(() => parseCapabilityConfig(toml)).toThrow(
-			/capability.id is required in capability.toml/,
-		);
-	});
-
-	test("throws error for invalid TOML syntax", () => {
-		const toml = `
-[capability
-id = "test"
-		`;
-
-		expect(() => parseCapabilityConfig(toml)).toThrow(/Invalid capability.toml:/);
-	});
-
-	test("handles empty env declarations", () => {
-		const toml = `
-[capability]
-id = "test"
-name = "Test"
-version = "1.0.0"
-description = "Test"
-
-[env.SIMPLE_VAR]
-		`;
-
-		const config = parseCapabilityConfig(toml);
-
-		expect(config.env?.SIMPLE_VAR).toEqual({});
-	});
-});

package/src/config/parser.ts

@@ -1,55 +0,0 @@
-import { parse } from "smol-toml";
-import type { CapabilityConfig, OmniConfig } from "../types";
-
-/**
- * Parse a TOML string into an OmniConfig object
- * @param tomlContent - The TOML content to parse
- * @returns Parsed OmniConfig object
- * @throws Error if TOML is invalid
- */
-export function parseOmniConfig(tomlContent: string): OmniConfig {
-	try {
-		return parse(tomlContent) as OmniConfig;
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Invalid TOML in config: ${message}`);
-	}
-}
-
-/**
- * Validate that parsed TOML has required capability fields
- */
-function validateCapabilityConfig(parsed: Record<string, unknown>): void {
-	const cap = parsed["capability"];
-	if (typeof cap !== "object" || cap === null) {
-		throw new Error("capability.id is required in capability.toml");
-	}
-	const capability = cap as Record<string, unknown>;
-	if (typeof capability["id"] !== "string") {
-		throw new Error("capability.id is required in capability.toml");
-	}
-	if (typeof capability["name"] !== "string") {
-		throw new Error("capability.name is required in capability.toml");
-	}
-	if (typeof capability["version"] !== "string") {
-		throw new Error("capability.version is required in capability.toml");
-	}
-}
-
-/**
- * Parse a TOML string into a CapabilityConfig object
- * @param tomlContent - The TOML content to parse
- * @returns Parsed CapabilityConfig object
- * @throws Error if TOML is invalid or required fields are missing
- */
-export function parseCapabilityConfig(tomlContent: string): CapabilityConfig {
-	try {
-		const parsed = parse(tomlContent) as Record<string, unknown>;
-		validateCapabilityConfig(parsed);
-		// After validation, we know the structure matches CapabilityConfig
-		return parsed as unknown as CapabilityConfig;
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Invalid capability.toml: ${message}`);
-	}
-}