task-o-matic 0.0.14 → 0.0.16

package/dist/lib/config-validation.d.ts

@@ -0,0 +1,215 @@
+import { z } from "zod";
+/**
+ * Zod schema for AI Provider
+ */
+export declare const AIProviderSchema: z.ZodEnum<["openai", "anthropic", "openrouter", "custom"]>;
+/**
+ * Zod schema for AI Configuration
+ */
+export declare const AIConfigSchema: z.ZodObject<{
+    provider: z.ZodEnum<["openai", "anthropic", "openrouter", "custom"]>;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    baseURL: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    context7Enabled: z.ZodOptional<z.ZodBoolean>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxTokens?: number | undefined;
+    }, {
+        maxTokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    provider: "openai" | "anthropic" | "openrouter" | "custom";
+    model: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    context7Enabled?: boolean | undefined;
+    reasoning?: {
+        maxTokens?: number | undefined;
+    } | undefined;
+}, {
+    provider: "openai" | "anthropic" | "openrouter" | "custom";
+    model: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    context7Enabled?: boolean | undefined;
+    reasoning?: {
+        maxTokens?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * Zod schema for full Config object
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    ai: z.ZodObject<{
+        provider: z.ZodEnum<["openai", "anthropic", "openrouter", "custom"]>;
+        model: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        context7Enabled: z.ZodOptional<z.ZodBoolean>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxTokens?: number | undefined;
+        }, {
+            maxTokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "openai" | "anthropic" | "openrouter" | "custom";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        context7Enabled?: boolean | undefined;
+        reasoning?: {
+            maxTokens?: number | undefined;
+        } | undefined;
+    }, {
+        provider: "openai" | "anthropic" | "openrouter" | "custom";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        context7Enabled?: boolean | undefined;
+        reasoning?: {
+            maxTokens?: number | undefined;
+        } | undefined;
+    }>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ai: {
+        provider: "openai" | "anthropic" | "openrouter" | "custom";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        context7Enabled?: boolean | undefined;
+        reasoning?: {
+            maxTokens?: number | undefined;
+        } | undefined;
+    };
+    workingDirectory?: string | undefined;
+}, {
+    ai: {
+        provider: "openai" | "anthropic" | "openrouter" | "custom";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        context7Enabled?: boolean | undefined;
+        reasoning?: {
+            maxTokens?: number | undefined;
+        } | undefined;
+    };
+    workingDirectory?: string | undefined;
+}>;
+/**
+ * Validation result type
+ */
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Validate AI configuration
+ *
+ * @param config - AI configuration to validate
+ * @returns Validated and typed configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const aiConfig = {
+ *   provider: "openai",
+ *   model: "gpt-4",
+ *   temperature: 0.7,
+ *   maxTokens: 4000
+ * };
+ *
+ * const validated = validateAIConfig(aiConfig);
+ * // validated is now type-safe and guaranteed valid
+ * ```
+ */
+export declare function validateAIConfig(config: unknown): z.infer<typeof AIConfigSchema>;
+/**
+ * Validate full configuration object
+ *
+ * @param config - Configuration object to validate
+ * @returns Validated and typed configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   ai: {
+ *     provider: "anthropic",
+ *     model: "claude-sonnet-4.5",
+ *     temperature: 0.5
+ *   },
+ *   workingDirectory: "/path/to/project"
+ * };
+ *
+ * const validated = validateConfig(config);
+ * ```
+ */
+export declare function validateConfig(config: unknown): z.infer<typeof ConfigSchema>;
+/**
+ * Safe validation that returns a result object instead of throwing
+ *
+ * @param config - Configuration to validate
+ * @returns Validation result with success flag and data or errors
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidateConfig(userInput);
+ * if (result.success) {
+ *   console.log("Valid config:", result.data);
+ * } else {
+ *   console.error("Validation errors:", result.errors);
+ * }
+ * ```
+ */
+export declare function safeValidateConfig(config: unknown): ValidationResult<z.infer<typeof ConfigSchema>>;
+/**
+ * Safe AI config validation
+ *
+ * @param config - AI configuration to validate
+ * @returns Validation result with success flag and data or errors
+ */
+export declare function safeValidateAIConfig(config: unknown): ValidationResult<z.infer<typeof AIConfigSchema>>;
+/**
+ * Validate partial AI config (for updates)
+ *
+ * @param config - Partial AI configuration to validate
+ * @returns Validated partial configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * // Only validating fields that are present
+ * const updates = {
+ *   temperature: 0.8
+ * };
+ *
+ * const validated = validatePartialAIConfig(updates);
+ * ```
+ */
+export declare function validatePartialAIConfig(config: unknown): Partial<z.infer<typeof AIConfigSchema>>;
+//# sourceMappingURL=config-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-validation.d.ts","sourceRoot":"","sources":["../../src/lib/config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,gBAAgB,4DAI3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CA0BhF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAuB5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,CAiBlG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC,CAiBtG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC,CAsBzC"}

package/dist/lib/config-validation.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigSchema = exports.AIConfigSchema = exports.AIProviderSchema = void 0;
+exports.validateAIConfig = validateAIConfig;
+exports.validateConfig = validateConfig;
+exports.safeValidateConfig = safeValidateConfig;
+exports.safeValidateAIConfig = safeValidateAIConfig;
+exports.validatePartialAIConfig = validatePartialAIConfig;
+const zod_1 = require("zod");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
+/**
+ * Zod schema for AI Provider
+ */
+exports.AIProviderSchema = zod_1.z.enum(["openai", "anthropic", "openrouter", "custom"], {
+    errorMap: () => ({
+        message: "Provider must be one of: openai, anthropic, openrouter, custom",
+    }),
+});
+/**
+ * Zod schema for AI Configuration
+ */
+exports.AIConfigSchema = zod_1.z.object({
+    provider: exports.AIProviderSchema,
+    model: zod_1.z.string().min(1, "Model name cannot be empty"),
+    apiKey: zod_1.z.string().optional(),
+    baseURL: zod_1.z.string().url("Base URL must be a valid URL").optional().or(zod_1.z.literal("")),
+    maxTokens: zod_1.z
+        .number()
+        .int("Max tokens must be an integer")
+        .positive("Max tokens must be positive")
+        .max(1000000, "Max tokens cannot exceed 1,000,000")
+        .optional(),
+    temperature: zod_1.z
+        .number()
+        .min(0, "Temperature must be between 0 and 2")
+        .max(2, "Temperature must be between 0 and 2")
+        .optional(),
+    context7Enabled: zod_1.z.boolean().optional(),
+    reasoning: zod_1.z
+        .object({
+        maxTokens: zod_1.z
+            .number()
+            .int("Reasoning max tokens must be an integer")
+            .positive("Reasoning max tokens must be positive")
+            .max(100000, "Reasoning max tokens cannot exceed 100,000")
+            .optional(),
+    })
+        .optional(),
+});
+/**
+ * Zod schema for full Config object
+ */
+exports.ConfigSchema = zod_1.z.object({
+    ai: exports.AIConfigSchema,
+    workingDirectory: zod_1.z.string().optional(),
+});
+/**
+ * Validate AI configuration
+ *
+ * @param config - AI configuration to validate
+ * @returns Validated and typed configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const aiConfig = {
+ *   provider: "openai",
+ *   model: "gpt-4",
+ *   temperature: 0.7,
+ *   maxTokens: 4000
+ * };
+ *
+ * const validated = validateAIConfig(aiConfig);
+ * // validated is now type-safe and guaranteed valid
+ * ```
+ */
+function validateAIConfig(config) {
+    try {
+        return exports.AIConfigSchema.parse(config);
+    }
+    catch (error) {
+        if (error instanceof zod_1.z.ZodError) {
+            const errors = error.errors.map((err) => ({
+                path: err.path.join("."),
+                message: err.message,
+            }));
+            throw new task_o_matic_error_1.TaskOMaticError("AI configuration validation failed", {
+                code: task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR,
+                context: JSON.stringify(config, null, 2),
+                suggestions: [
+                    "Check that all required fields are present",
+                    "Verify provider is one of: openai, anthropic, openrouter, custom",
+                    "Ensure model name is not empty",
+                    "Check temperature is between 0 and 2",
+                    "Verify maxTokens is a positive integer",
+                    ...errors.map((e) => `Fix ${e.path}: ${e.message}`),
+                ],
+                metadata: { errors },
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Validate full configuration object
+ *
+ * @param config - Configuration object to validate
+ * @returns Validated and typed configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = {
+ *   ai: {
+ *     provider: "anthropic",
+ *     model: "claude-sonnet-4.5",
+ *     temperature: 0.5
+ *   },
+ *   workingDirectory: "/path/to/project"
+ * };
+ *
+ * const validated = validateConfig(config);
+ * ```
+ */
+function validateConfig(config) {
+    try {
+        return exports.ConfigSchema.parse(config);
+    }
+    catch (error) {
+        if (error instanceof zod_1.z.ZodError) {
+            const errors = error.errors.map((err) => ({
+                path: err.path.join("."),
+                message: err.message,
+            }));
+            throw new task_o_matic_error_1.TaskOMaticError("Configuration validation failed", {
+                code: task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR,
+                context: JSON.stringify(config, null, 2),
+                suggestions: [
+                    "Check that all required fields are present",
+                    "Verify the configuration structure is correct",
+                    ...errors.map((e) => `Fix ${e.path}: ${e.message}`),
+                ],
+                metadata: { errors },
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Safe validation that returns a result object instead of throwing
+ *
+ * @param config - Configuration to validate
+ * @returns Validation result with success flag and data or errors
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidateConfig(userInput);
+ * if (result.success) {
+ *   console.log("Valid config:", result.data);
+ * } else {
+ *   console.error("Validation errors:", result.errors);
+ * }
+ * ```
+ */
+function safeValidateConfig(config) {
+    const result = exports.ConfigSchema.safeParse(config);
+    if (result.success) {
+        return {
+            success: true,
+            data: result.data,
+        };
+    }
+    else {
+        return {
+            success: false,
+            errors: result.error.errors.map((err) => ({
+                path: err.path.join("."),
+                message: err.message,
+            })),
+        };
+    }
+}
+/**
+ * Safe AI config validation
+ *
+ * @param config - AI configuration to validate
+ * @returns Validation result with success flag and data or errors
+ */
+function safeValidateAIConfig(config) {
+    const result = exports.AIConfigSchema.safeParse(config);
+    if (result.success) {
+        return {
+            success: true,
+            data: result.data,
+        };
+    }
+    else {
+        return {
+            success: false,
+            errors: result.error.errors.map((err) => ({
+                path: err.path.join("."),
+                message: err.message,
+            })),
+        };
+    }
+}
+/**
+ * Validate partial AI config (for updates)
+ *
+ * @param config - Partial AI configuration to validate
+ * @returns Validated partial configuration
+ * @throws {TaskOMaticError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * // Only validating fields that are present
+ * const updates = {
+ *   temperature: 0.8
+ * };
+ *
+ * const validated = validatePartialAIConfig(updates);
+ * ```
+ */
+function validatePartialAIConfig(config) {
+    try {
+        return exports.AIConfigSchema.partial().parse(config);
+    }
+    catch (error) {
+        if (error instanceof zod_1.z.ZodError) {
+            const errors = error.errors.map((err) => ({
+                path: err.path.join("."),
+                message: err.message,
+            }));
+            throw new task_o_matic_error_1.TaskOMaticError("AI configuration update validation failed", {
+                code: task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR,
+                context: JSON.stringify(config, null, 2),
+                suggestions: [
+                    "Check that field values are valid",
+                    ...errors.map((e) => `Fix ${e.path}: ${e.message}`),
+                ],
+                metadata: { errors },
+            });
+        }
+        throw error;
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAA6C,MAAM,UAAU,CAAC;AAI/E,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7C;AA4CD,wBAAgB,4BAA4B,CAC1C,UAAU,GAAE,MAAc,GACzB,eAAe,CA+BjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAiBlE,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQtC,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAK9C,mBAAmB,IAAI,MAAM;IAI7B,gBAAgB,IAAI,MAAM;IAI1B,OAAO,CAAC,aAAa;IAoBf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAsCvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,SAAS,IAAI,MAAM;IAanB,WAAW,IAAI,QAAQ;IAIjB,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,iBAAiB,IAAI,MAAM;CAG5B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAA6C,MAAM,UAAU,CAAC;AAS/E,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7C;AA4CD,wBAAgB,4BAA4B,CAC1C,UAAU,GAAE,MAAc,GACzB,eAAe,CA+BjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAiBlE,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQtC,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAK9C,mBAAmB,IAAI,MAAM;IAI7B,gBAAgB,IAAI,MAAM;IAI1B,OAAO,CAAC,aAAa;IAoBf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA6CvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,SAAS,IAAI,MAAM;IAqBnB,WAAW,IAAI,QAAQ;IAIjB,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,iBAAiB,IAAI,MAAM;CAG5B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/lib/config.js

@@ -7,6 +7,8 @@ const path_1 = require("path");
 const process_1 = require("process");
 const fs_1 = require("fs");
 const dotenv_1 = require("dotenv");
+const config_validation_1 = require("./config-validation");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 // Provider-specific sensible defaults for 2025
 const PROVIDER_DEFAULTS = {
     openrouter: {
@@ -140,28 +142,35 @@ class ConfigManager {
             const configData = await this.callbacks.read("config.json");
             if (configData) {
                 const fileConfig = JSON.parse(configData);
-                this.config = {
+                const mergedConfig = {
                     ...defaultConfig,
                     ...fileConfig,
                     ai: { ...defaultConfig.ai, ...fileConfig.ai, ...envConfig },
                 };
+                // Validate the merged configuration
+                const validatedConfig = (0, config_validation_1.validateConfig)(mergedConfig);
+                this.config = validatedConfig;
                 if (this.config && this.config.workingDirectory) {
                     this.customWorkingDir = this.config.workingDirectory;
                 }
             }
             else {
-                this.config = defaultConfig;
+                // Validate default config too
+                this.config = (0, config_validation_1.validateConfig)(defaultConfig);
             }
         }
         catch (error) {
-            console.warn("Failed to read config, using defaults:", error);
-            this.config = defaultConfig;
+            console.warn("Failed to read or validate config, using defaults:", error);
+            // Even defaults should be validated
+            this.config = (0, config_validation_1.validateConfig)(defaultConfig);
         }
         return this.config;
     }
     async save() {
         if (!this.config) {
-            throw new Error("Config not loaded, cannot save.");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR, "Config not loaded, cannot save.", {
+                suggestions: ["Call await configManager.load() before saving"],
+            });
         }
         try {
             await this.callbacks.write("config.json", JSON.stringify(this.config, null, 2));
@@ -177,7 +186,13 @@ class ConfigManager {
             // Since we can't be async here, we must throw or return defaults.
             // Returning defaults might hide issues.
             // Throwing forces users to await load().
-            throw new Error("Config not loaded. Call await configManager.load() first.");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR, "Config not loaded. Call await configManager.load() first.", {
+                context: "Configuration must be loaded before access",
+                suggestions: [
+                    "Call await configManager.load() first",
+                    "Check initialization order",
+                ],
+            });
         }
         return this.config;
     }
@@ -188,7 +203,15 @@ class ConfigManager {
         if (!this.config) {
             await this.load();
         }
-        this.config.ai = { ...this.config.ai, ...aiConfig };
+        // Validate the partial config before merging
+        const validatedPartial = (0, config_validation_1.validatePartialAIConfig)(aiConfig);
+        // Merge and validate the full config
+        const mergedAIConfig = { ...this.config.ai, ...validatedPartial };
+        const validatedConfig = (0, config_validation_1.validateConfig)({
+            ...this.config,
+            ai: mergedAIConfig,
+        });
+        this.config = validatedConfig;
         await this.save();
     }
     setConfig(config) {

package/dist/lib/index.d.ts

@@ -57,7 +57,7 @@ export type { CreateTaskOptions, SplitTaskOptions, PlanTaskOptions, EnhanceTaskO
  * Factory functions for getting singleton instances of core services
  * These ensure only one instance exists throughout the application
  */
-export { getAIOperations, getModelProvider, getStorage, getContextBuilder, resetServiceInstances, } from "../utils/ai-service-factory";
+export { getAIOperations, getModelProvider, getStorage, getContextBuilder, resetServiceInstances, initializeServices, } from "../utils/ai-service-factory";
 /**
  * AI configuration builder utility
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD;;GAEG;AACH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAMnC;;;GAGG;AACH,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAM5D;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMjD;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;GAEG;AACH,OAAO,EACL,sBAAsB,EACtB,wCAAwC,GACzC,MAAM,4BAA4B,CAAC;AAMpC;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD;;GAEG;AACH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAMnC;;;GAGG;AACH,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAM5D;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMjD;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;GAEG;AACH,OAAO,EACL,sBAAsB,EACtB,wCAAwC,GACzC,MAAM,4BAA4B,CAAC;AAMpC;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/index.js

@@ -32,7 +32,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runValidations = exports.isValidAIProvider = exports.createStreamingOptionsWithCustomHandlers = exports.createStreamingOptions = exports.formatStackInfo = exports.PromptBuilder = exports.ContextBuilder = exports.ModelProvider = exports.AIOperations = exports.configManager = exports.ConfigManager = exports.FileSystemStorage = exports.buildAIConfig = exports.resetServiceInstances = exports.getContextBuilder = exports.getStorage = exports.getModelProvider = exports.getAIOperations = exports.BenchmarkService = exports.WorkflowService = exports.PRDService = exports.TaskService = void 0;
+exports.runValidations = exports.isValidAIProvider = exports.createStreamingOptionsWithCustomHandlers = exports.createStreamingOptions = exports.formatStackInfo = exports.PromptBuilder = exports.ContextBuilder = exports.ModelProvider = exports.AIOperations = exports.configManager = exports.ConfigManager = exports.FileSystemStorage = exports.buildAIConfig = exports.initializeServices = exports.resetServiceInstances = exports.getContextBuilder = exports.getStorage = exports.getModelProvider = exports.getAIOperations = exports.BenchmarkService = exports.WorkflowService = exports.PRDService = exports.TaskService = void 0;
 // ============================================================================
 // Main Services - Business Logic Layer
 // ============================================================================
@@ -81,6 +81,7 @@ Object.defineProperty(exports, "getModelProvider", { enumerable: true, get: func
 Object.defineProperty(exports, "getStorage", { enumerable: true, get: function () { return ai_service_factory_1.getStorage; } });
 Object.defineProperty(exports, "getContextBuilder", { enumerable: true, get: function () { return ai_service_factory_1.getContextBuilder; } });
 Object.defineProperty(exports, "resetServiceInstances", { enumerable: true, get: function () { return ai_service_factory_1.resetServiceInstances; } });
+Object.defineProperty(exports, "initializeServices", { enumerable: true, get: function () { return ai_service_factory_1.initializeServices; } });
 /**
  * AI configuration builder utility
  */

package/dist/lib/storage/file-system.d.ts.map

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