@fractary/faber 1.0.2 → 1.2.0

package/dist/config.d.ts

@@ -5,6 +5,16 @@
  */
 import { z } from 'zod';
 import { FaberConfig, WorkConfig, RepoConfig, WorkflowConfig, SpecConfig, LogConfig, StateConfig } from './types';
+/**
+ * Options for configuration loading functions
+ */
+export interface LoadConfigOptions {
+    /**
+     * If true, return null instead of throwing when config is missing
+     * @default false
+     */
+    allowMissing?: boolean;
+}
 declare const WorkConfigSchema: z.ZodObject<{
     platform: z.ZodEnum<["github", "jira", "linear"]>;
     owner: z.ZodOptional<z.ZodString>;
@@ -86,11 +96,11 @@ declare const WorkflowConfigSchema: z.ZodObject<{
         } & {
             refineSpec: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
             refineSpec: boolean;
+            enabled: boolean;
         }, {
-            enabled?: boolean | undefined;
             refineSpec?: boolean | undefined;
+            enabled?: boolean | undefined;
         }>>;
         build: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -104,11 +114,11 @@ declare const WorkflowConfigSchema: z.ZodObject<{
         } & {
             maxRetries: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
             maxRetries: number;
+            enabled: boolean;
         }, {
-            enabled?: boolean | undefined;
             maxRetries?: number | undefined;
+            enabled?: boolean | undefined;
         }>>;
         release: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -116,53 +126,53 @@ declare const WorkflowConfigSchema: z.ZodObject<{
             requestReviews: z.ZodDefault<z.ZodBoolean>;
             reviewers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
             requestReviews: boolean;
             reviewers: string[];
+            enabled: boolean;
         }, {
-            enabled?: boolean | undefined;
             requestReviews?: boolean | undefined;
             reviewers?: string[] | undefined;
+            enabled?: boolean | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         frame: {
             enabled: boolean;
         };
         architect: {
-            enabled: boolean;
             refineSpec: boolean;
+            enabled: boolean;
         };
         build: {
             enabled: boolean;
         };
         evaluate: {
-            enabled: boolean;
             maxRetries: number;
+            enabled: boolean;
         };
         release: {
-            enabled: boolean;
             requestReviews: boolean;
             reviewers: string[];
+            enabled: boolean;
         };
     }, {
         frame?: {
             enabled?: boolean | undefined;
         } | undefined;
         architect?: {
-            enabled?: boolean | undefined;
             refineSpec?: boolean | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         build?: {
             enabled?: boolean | undefined;
         } | undefined;
         evaluate?: {
-            enabled?: boolean | undefined;
             maxRetries?: number | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         release?: {
-            enabled?: boolean | undefined;
             requestReviews?: boolean | undefined;
             reviewers?: string[] | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
     }>;
     hooks: z.ZodOptional<z.ZodObject<{
@@ -206,20 +216,20 @@ declare const WorkflowConfigSchema: z.ZodObject<{
             enabled: boolean;
         };
         architect: {
-            enabled: boolean;
             refineSpec: boolean;
+            enabled: boolean;
         };
         build: {
             enabled: boolean;
         };
         evaluate: {
-            enabled: boolean;
             maxRetries: number;
+            enabled: boolean;
         };
         release: {
-            enabled: boolean;
             requestReviews: boolean;
             reviewers: string[];
+            enabled: boolean;
         };
     };
     hooks?: {
@@ -240,20 +250,20 @@ declare const WorkflowConfigSchema: z.ZodObject<{
             enabled?: boolean | undefined;
         } | undefined;
         architect?: {
-            enabled?: boolean | undefined;
             refineSpec?: boolean | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         build?: {
             enabled?: boolean | undefined;
         } | undefined;
         evaluate?: {
-            enabled?: boolean | undefined;
             maxRetries?: number | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         release?: {
-            enabled?: boolean | undefined;
             requestReviews?: boolean | undefined;
             reviewers?: string[] | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
     };
     autonomy?: "dry-run" | "assisted" | "guarded" | "autonomous" | undefined;
@@ -411,11 +421,11 @@ declare const FaberConfigSchema: z.ZodObject<{
             } & {
                 refineSpec: z.ZodDefault<z.ZodBoolean>;
             }, "strip", z.ZodTypeAny, {
-                enabled: boolean;
                 refineSpec: boolean;
+                enabled: boolean;
             }, {
-                enabled?: boolean | undefined;
                 refineSpec?: boolean | undefined;
+                enabled?: boolean | undefined;
             }>>;
             build: z.ZodDefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
@@ -429,11 +439,11 @@ declare const FaberConfigSchema: z.ZodObject<{
             } & {
                 maxRetries: z.ZodDefault<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
-                enabled: boolean;
                 maxRetries: number;
+                enabled: boolean;
             }, {
-                enabled?: boolean | undefined;
                 maxRetries?: number | undefined;
+                enabled?: boolean | undefined;
             }>>;
             release: z.ZodDefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;
@@ -441,53 +451,53 @@ declare const FaberConfigSchema: z.ZodObject<{
                 requestReviews: z.ZodDefault<z.ZodBoolean>;
                 reviewers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
             }, "strip", z.ZodTypeAny, {
-                enabled: boolean;
                 requestReviews: boolean;
                 reviewers: string[];
+                enabled: boolean;
             }, {
-                enabled?: boolean | undefined;
                 requestReviews?: boolean | undefined;
                 reviewers?: string[] | undefined;
+                enabled?: boolean | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
             frame: {
                 enabled: boolean;
             };
             architect: {
-                enabled: boolean;
                 refineSpec: boolean;
+                enabled: boolean;
             };
             build: {
                 enabled: boolean;
             };
             evaluate: {
-                enabled: boolean;
                 maxRetries: number;
+                enabled: boolean;
             };
             release: {
-                enabled: boolean;
                 requestReviews: boolean;
                 reviewers: string[];
+                enabled: boolean;
             };
         }, {
             frame?: {
                 enabled?: boolean | undefined;
             } | undefined;
             architect?: {
-                enabled?: boolean | undefined;
                 refineSpec?: boolean | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             build?: {
                 enabled?: boolean | undefined;
             } | undefined;
             evaluate?: {
-                enabled?: boolean | undefined;
                 maxRetries?: number | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             release?: {
-                enabled?: boolean | undefined;
                 requestReviews?: boolean | undefined;
                 reviewers?: string[] | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
         }>;
         hooks: z.ZodOptional<z.ZodObject<{
@@ -531,20 +541,20 @@ declare const FaberConfigSchema: z.ZodObject<{
                 enabled: boolean;
             };
             architect: {
-                enabled: boolean;
                 refineSpec: boolean;
+                enabled: boolean;
             };
             build: {
                 enabled: boolean;
             };
             evaluate: {
-                enabled: boolean;
                 maxRetries: number;
+                enabled: boolean;
             };
             release: {
-                enabled: boolean;
                 requestReviews: boolean;
                 reviewers: string[];
+                enabled: boolean;
             };
         };
         hooks?: {
@@ -565,20 +575,20 @@ declare const FaberConfigSchema: z.ZodObject<{
                 enabled?: boolean | undefined;
             } | undefined;
             architect?: {
-                enabled?: boolean | undefined;
                 refineSpec?: boolean | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             build?: {
                 enabled?: boolean | undefined;
             } | undefined;
             evaluate?: {
-                enabled?: boolean | undefined;
                 maxRetries?: number | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             release?: {
-                enabled?: boolean | undefined;
                 requestReviews?: boolean | undefined;
                 reviewers?: string[] | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
         };
         autonomy?: "dry-run" | "assisted" | "guarded" | "autonomous" | undefined;
@@ -613,20 +623,20 @@ declare const FaberConfigSchema: z.ZodObject<{
                 enabled: boolean;
             };
             architect: {
-                enabled: boolean;
                 refineSpec: boolean;
+                enabled: boolean;
             };
             build: {
                 enabled: boolean;
             };
             evaluate: {
-                enabled: boolean;
                 maxRetries: number;
+                enabled: boolean;
             };
             release: {
-                enabled: boolean;
                 requestReviews: boolean;
                 reviewers: string[];
+                enabled: boolean;
             };
         };
         hooks?: {
@@ -722,20 +732,20 @@ declare const FaberConfigSchema: z.ZodObject<{
                 enabled?: boolean | undefined;
             } | undefined;
             architect?: {
-                enabled?: boolean | undefined;
                 refineSpec?: boolean | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             build?: {
                 enabled?: boolean | undefined;
             } | undefined;
             evaluate?: {
-                enabled?: boolean | undefined;
                 maxRetries?: number | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
             release?: {
-                enabled?: boolean | undefined;
                 requestReviews?: boolean | undefined;
                 reviewers?: string[] | undefined;
+                enabled?: boolean | undefined;
             } | undefined;
         };
         autonomy?: "dry-run" | "assisted" | "guarded" | "autonomous" | undefined;
@@ -768,16 +778,31 @@ export declare function findProjectRoot(startDir?: string): string;
 export declare function loadJsonConfig<T>(filePath: string): T | null;
 /**
  * Load work plugin configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns WorkConfig or null
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-export declare function loadWorkConfig(projectRoot?: string): WorkConfig | null;
+export declare function loadWorkConfig(projectRoot?: string, options?: LoadConfigOptions): WorkConfig | null;
 /**
  * Load repo plugin configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns RepoConfig or null
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-export declare function loadRepoConfig(projectRoot?: string): RepoConfig | null;
+export declare function loadRepoConfig(projectRoot?: string, options?: LoadConfigOptions): RepoConfig | null;
 /**
  * Load the full FABER configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns FaberConfig or null (if allowMissing is true and config doesn't exist)
+ * @throws ConfigValidationError if config exists but is invalid, or if missing and allowMissing is false
  */
-export declare function loadFaberConfig(projectRoot?: string): FaberConfig | null;
+export declare function loadFaberConfig(projectRoot?: string, options?: LoadConfigOptions): FaberConfig | null;
 /**
  * Validate a configuration object
  */
@@ -792,23 +817,46 @@ export declare function getDefaultWorkflowConfig(): WorkflowConfig;
 export declare function mergeWithDefaults(partial: Partial<WorkflowConfig>): WorkflowConfig;
 /**
  * Write configuration to file
+ *
+ * @deprecated Use ConfigInitializer.writeConfig() instead
  */
 export declare function writeConfig(configPath: string, config: Record<string, unknown>): void;
 /**
  * Initialize FABER configuration in a project
+ *
+ * @deprecated Use ConfigInitializer.generateDefaultConfig() and ConfigInitializer.writeConfig() instead
+ * @example
+ * // Old way (deprecated):
+ * // initFaberConfig(projectRoot, partialConfig);
+ *
+ * // New way:
+ * // const config = ConfigInitializer.generateDefaultConfig();
+ * // ConfigInitializer.writeConfig(config);
  */
 export declare function initFaberConfig(projectRoot: string, config: Partial<FaberConfig>): string;
 /**
  * Load spec configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return default config instead of throwing)
+ * @returns SpecConfig (with defaults if allowMissing is true and config missing)
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-export declare function loadSpecConfig(projectRoot?: string): SpecConfig;
+export declare function loadSpecConfig(projectRoot?: string, options?: LoadConfigOptions): SpecConfig;
 /**
  * Load log configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @returns LogConfig (always returns defaults if config missing - logs are optional)
  */
 export declare function loadLogConfig(projectRoot?: string): LogConfig;
 /**
  * Load state configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @returns StateConfig (always returns defaults if config missing - state is optional)
  */
 export declare function loadStateConfig(projectRoot?: string): StateConfig;
+export { ConfigInitializer } from './config/initializer';
 export { FaberConfigSchema, WorkConfigSchema, RepoConfigSchema, WorkflowConfigSchema, };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -38,7 +38,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowConfigSchema = exports.RepoConfigSchema = exports.WorkConfigSchema = exports.FaberConfigSchema = void 0;
+exports.WorkflowConfigSchema = exports.RepoConfigSchema = exports.WorkConfigSchema = exports.FaberConfigSchema = exports.ConfigInitializer = void 0;
 exports.findProjectRoot = findProjectRoot;
 exports.loadJsonConfig = loadJsonConfig;
 exports.loadWorkConfig = loadWorkConfig;
@@ -197,13 +197,28 @@ function loadJsonConfig(filePath) {
 }
 /**
  * Load work plugin configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns WorkConfig or null
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-function loadWorkConfig(projectRoot) {
+function loadWorkConfig(projectRoot, options) {
     const root = projectRoot || findProjectRoot();
     const configPath = path.join(root, WORK_CONFIG_PATH);
     const config = loadJsonConfig(configPath);
     if (!config) {
-        return null;
+        if (options?.allowMissing) {
+            return null;
+        }
+        throw new errors_1.ConfigValidationError([
+            'Work plugin configuration not found.',
+            '',
+            'Run the following command to create a default configuration:',
+            '  fractary init',
+            '',
+            `Expected config at: ${configPath}`,
+        ]);
     }
     // Handle handlers structure from plugins
     const handlers = config['handlers'];
@@ -227,17 +242,32 @@ function loadWorkConfig(projectRoot) {
     if (result.success) {
         return result.data;
     }
-    return null;
+    throw new errors_1.ConfigValidationError(['Invalid work configuration']);
 }
 /**
  * Load repo plugin configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns RepoConfig or null
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-function loadRepoConfig(projectRoot) {
+function loadRepoConfig(projectRoot, options) {
     const root = projectRoot || findProjectRoot();
     const configPath = path.join(root, REPO_CONFIG_PATH);
     const config = loadJsonConfig(configPath);
     if (!config) {
-        return null;
+        if (options?.allowMissing) {
+            return null;
+        }
+        throw new errors_1.ConfigValidationError([
+            'Repo plugin configuration not found.',
+            '',
+            'Run the following command to create a default configuration:',
+            '  fractary init',
+            '',
+            `Expected config at: ${configPath}`,
+        ]);
     }
     // Handle handlers structure from plugins
     const handlers = config['handlers'];
@@ -261,19 +291,24 @@ function loadRepoConfig(projectRoot) {
     if (result.success) {
         return result.data;
     }
-    return null;
+    throw new errors_1.ConfigValidationError(['Invalid repo configuration']);
 }
 /**
  * Load the full FABER configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return null instead of throwing)
+ * @returns FaberConfig or null (if allowMissing is true and config doesn't exist)
+ * @throws ConfigValidationError if config exists but is invalid, or if missing and allowMissing is false
  */
-function loadFaberConfig(projectRoot) {
+function loadFaberConfig(projectRoot, options) {
     const root = projectRoot || findProjectRoot();
     const configPath = path.join(root, FABER_CONFIG_PATH);
     const config = loadJsonConfig(configPath);
     if (!config) {
         // Try to construct from individual plugin configs
-        const workConfig = loadWorkConfig(root);
-        const repoConfig = loadRepoConfig(root);
+        const workConfig = loadWorkConfig(root, { allowMissing: true });
+        const repoConfig = loadRepoConfig(root, { allowMissing: true });
         if (workConfig && repoConfig) {
             return {
                 schema_version: '1.0',
@@ -296,7 +331,18 @@ function loadFaberConfig(projectRoot) {
                 },
             };
         }
-        return null;
+        // Config not found - throw or return null based on options
+        if (options?.allowMissing) {
+            return null;
+        }
+        throw new errors_1.ConfigValidationError([
+            'FABER configuration not found.',
+            '',
+            'Run the following command to create a default configuration:',
+            '  fractary init',
+            '',
+            `Expected config at: ${configPath}`,
+        ]);
     }
     const result = FaberConfigSchema.safeParse(config);
     if (!result.success) {
@@ -361,6 +407,8 @@ function ensureDir(dirPath) {
 }
 /**
  * Write configuration to file
+ *
+ * @deprecated Use ConfigInitializer.writeConfig() instead
  */
 function writeConfig(configPath, config) {
     ensureDir(path.dirname(configPath));
@@ -368,6 +416,15 @@ function writeConfig(configPath, config) {
 }
 /**
  * Initialize FABER configuration in a project
+ *
+ * @deprecated Use ConfigInitializer.generateDefaultConfig() and ConfigInitializer.writeConfig() instead
+ * @example
+ * // Old way (deprecated):
+ * // initFaberConfig(projectRoot, partialConfig);
+ *
+ * // New way:
+ * // const config = ConfigInitializer.generateDefaultConfig();
+ * // ConfigInitializer.writeConfig(config);
  */
 function initFaberConfig(projectRoot, config) {
     const configPath = path.join(projectRoot, FABER_CONFIG_PATH);
@@ -389,50 +446,75 @@ function initFaberConfig(projectRoot, config) {
 // ============================================================================
 /**
  * Load spec configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @param options - Loading options (allowMissing to return default config instead of throwing)
+ * @returns SpecConfig (with defaults if allowMissing is true and config missing)
+ * @throws ConfigValidationError if missing and allowMissing is false
  */
-function loadSpecConfig(projectRoot) {
+function loadSpecConfig(projectRoot, options) {
     const root = projectRoot || findProjectRoot();
-    const faberConfig = loadFaberConfig(root);
+    const faberConfig = loadFaberConfig(root, { allowMissing: true });
     if (faberConfig?.artifacts?.specs) {
         return {
             localPath: path.join(root, faberConfig.artifacts.specs.local_path),
         };
     }
-    // Default spec config
+    // No FABER config found - throw or return defaults based on options
+    if (!options?.allowMissing) {
+        throw new errors_1.ConfigValidationError([
+            'Spec configuration not found.',
+            '',
+            'Run the following command to create a default configuration:',
+            '  fractary init',
+        ]);
+    }
+    // Return default spec config
     return {
         localPath: path.join(root, 'specs'),
     };
 }
 /**
  * Load log configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @returns LogConfig (always returns defaults if config missing - logs are optional)
  */
 function loadLogConfig(projectRoot) {
     const root = projectRoot || findProjectRoot();
-    const faberConfig = loadFaberConfig(root);
+    const faberConfig = loadFaberConfig(root, { allowMissing: true });
     if (faberConfig?.artifacts?.logs) {
         return {
             localPath: path.join(root, faberConfig.artifacts.logs.local_path),
         };
     }
-    // Default log config
+    // No FABER config found - return defaults (logs are optional)
     return {
         localPath: path.join(root, '.fractary', 'logs'),
     };
 }
 /**
  * Load state configuration
+ *
+ * @param projectRoot - Optional project root directory
+ * @returns StateConfig (always returns defaults if config missing - state is optional)
  */
 function loadStateConfig(projectRoot) {
     const root = projectRoot || findProjectRoot();
-    const faberConfig = loadFaberConfig(root);
+    const faberConfig = loadFaberConfig(root, { allowMissing: true });
     if (faberConfig?.artifacts?.state) {
         return {
             localPath: path.join(root, faberConfig.artifacts.state.local_path),
         };
     }
-    // Default state config
+    // No FABER config found - return defaults (state is optional)
     return {
         localPath: path.join(root, '.faber', 'state'),
     };
 }
+// ============================================================================
+// Exports
+// ============================================================================
+var initializer_1 = require("./config/initializer");
+Object.defineProperty(exports, "ConfigInitializer", { enumerable: true, get: function () { return initializer_1.ConfigInitializer; } });
 //# sourceMappingURL=config.js.map