@vibe-validate/config 0.9.10 → 0.10.0

package/dist/loader.d.ts

@@ -36,6 +36,9 @@
 import { type VibeValidateConfig } from './schema.js';
 /**
  * Configuration file names to search for (in order)
+ *
+ * YAML is the primary and recommended format.
+ * .mjs is legacy (deprecated) - supported for migration only.
  */
 export declare const CONFIG_FILE_NAMES: string[];
 /**

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAKH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItE;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAO7B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAiC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAazC;AA0DD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,UAG7B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAkC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAazC;AA0DD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

package/dist/loader.js

@@ -36,19 +36,19 @@
 import { resolve, dirname } from 'path';
 import { readFileSync } from 'fs';
 import { pathToFileURL } from 'url';
+import { load as parseYaml } from 'js-yaml';
 import { validateConfig } from './schema.js';
 import { mergeConfig } from './define-config.js';
 import { getPreset } from './presets/index.js';
 /**
  * Configuration file names to search for (in order)
+ *
+ * YAML is the primary and recommended format.
+ * .mjs is legacy (deprecated) - supported for migration only.
  */
 export const CONFIG_FILE_NAMES = [
-    'vibe-validate.config.ts',
-    'vibe-validate.config.mts',
-    'vibe-validate.config.js',
-    'vibe-validate.config.mjs',
-    'vibe-validate.config.json',
-    '.vibe-validate.json',
+    'vibe-validate.config.yaml',
+    'vibe-validate.config.mjs', // DEPRECATED: Legacy format, will be removed in v1.0
 ];
 /**
  * Load configuration from a file path
@@ -59,33 +59,29 @@ export const CONFIG_FILE_NAMES = [
  */
 export async function loadConfigFromFile(configPath) {
     const absolutePath = resolve(configPath);
-    // JSON files
-    if (absolutePath.endsWith('.json')) {
+    // YAML files (primary format)
+    if (absolutePath.endsWith('.yaml')) {
         const content = readFileSync(absolutePath, 'utf-8');
-        const raw = JSON.parse(content);
+        const raw = parseYaml(content);
+        // Remove $schema property if present (used for IDE support only)
+        if (raw && typeof raw === 'object' && '$schema' in raw) {
+            delete raw['$schema'];
+        }
         return await resolveConfig(raw, dirname(absolutePath));
     }
-    // TypeScript files - use tsx for loading
-    if (absolutePath.endsWith('.ts') || absolutePath.endsWith('.mts')) {
-        // Use tsx to load TypeScript files
-        const { register } = await import('tsx/esm/api');
-        const unregister = register();
-        try {
-            // Add cache-busting timestamp to force fresh load
-            const fileUrl = pathToFileURL(absolutePath).href + '?t=' + Date.now();
-            const module = await import(fileUrl);
-            const raw = module.default || module;
-            return await resolveConfig(raw, dirname(absolutePath));
-        }
-        finally {
-            unregister();
-        }
+    // Legacy .mjs files (DEPRECATED - will be removed in v1.0)
+    if (absolutePath.endsWith('.mjs')) {
+        console.warn('⚠️  WARNING: .mjs config format is deprecated and will be removed in v1.0');
+        console.warn('   Please migrate to vibe-validate.config.yaml');
+        console.warn('   Run: vibe-validate doctor for migration guidance\n');
+        const fileUrl = pathToFileURL(absolutePath).href;
+        const module = await import(fileUrl);
+        const raw = module.default || module;
+        return await resolveConfig(raw, dirname(absolutePath));
     }
-    // JavaScript files (ES modules)
-    const fileUrl = pathToFileURL(absolutePath).href;
-    const module = await import(fileUrl);
-    const raw = module.default || module;
-    return await resolveConfig(raw, dirname(absolutePath));
+    throw new Error(`Unsupported config file format: ${absolutePath}\n` +
+        `Only .yaml and .mjs (deprecated) formats are supported.\n` +
+        `Please use vibe-validate.config.yaml`);
 }
 /**
  * Find and load configuration from current working directory

package/dist/schema-export.d.ts

@@ -0,0 +1,24 @@
+/**
+ * JSON Schema Export for YAML Configuration
+ *
+ * Generates JSON Schema from Zod configuration schema to enable
+ * IDE validation and autocomplete for YAML config files.
+ */
+/**
+ * Generate JSON Schema from Zod config schema
+ *
+ * This schema can be referenced in YAML files using the $schema property:
+ * ```yaml
+ * $schema: ./node_modules/@vibe-validate/config/vibe-validate.schema.json
+ * validation:
+ *   phases: []
+ * ```
+ *
+ * @returns JSON Schema object
+ */
+export declare function generateJsonSchema(): object;
+/**
+ * Pre-generated JSON Schema (exported for bundling in npm package)
+ */
+export declare const vibeValidateJsonSchema: object;
+//# sourceMappingURL=schema-export.d.ts.map

package/dist/schema-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.d.ts","sourceRoot":"","sources":["../src/schema-export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAuB,CAAC"}

package/dist/schema-export.js

@@ -0,0 +1,31 @@
+/**
+ * JSON Schema Export for YAML Configuration
+ *
+ * Generates JSON Schema from Zod configuration schema to enable
+ * IDE validation and autocomplete for YAML config files.
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { VibeValidateConfigSchema } from './schema.js';
+/**
+ * Generate JSON Schema from Zod config schema
+ *
+ * This schema can be referenced in YAML files using the $schema property:
+ * ```yaml
+ * $schema: ./node_modules/@vibe-validate/config/vibe-validate.schema.json
+ * validation:
+ *   phases: []
+ * ```
+ *
+ * @returns JSON Schema object
+ */
+export function generateJsonSchema() {
+    return zodToJsonSchema(VibeValidateConfigSchema, {
+        name: 'VibeValidateConfig',
+        $refStrategy: 'none', // Inline all references for simplicity
+        target: 'jsonSchema7',
+    });
+}
+/**
+ * Pre-generated JSON Schema (exported for bundling in npm package)
+ */
+export const vibeValidateJsonSchema = generateJsonSchema();

package/dist/scripts/generate-schema.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Generate JSON Schema File
+ *
+ * Creates vibe-validate.schema.json in the package root for use in YAML configs.
+ * This script runs during the build process.
+ */
+export {};
+//# sourceMappingURL=generate-schema.d.ts.map

package/dist/scripts/generate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schema.d.ts","sourceRoot":"","sources":["../../src/scripts/generate-schema.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/scripts/generate-schema.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Generate JSON Schema File
+ *
+ * Creates vibe-validate.schema.json in the package root for use in YAML configs.
+ * This script runs during the build process.
+ */
+import { writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { vibeValidateJsonSchema } from '../schema-export.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageRoot = join(__dirname, '..', '..');
+const schemaPath = join(packageRoot, 'vibe-validate.schema.json');
+// Generate and write schema file
+writeFileSync(schemaPath, JSON.stringify(vibeValidateJsonSchema, null, 2), 'utf-8');
+console.log('✓ Generated vibe-validate.schema.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/config",
-  "version": "0.9.10",
+  "version": "0.10.0",
   "description": "Configuration system for vibe-validate with TypeScript-first design and framework presets",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,7 +12,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "vibe-validate.schema.json"
   ],
   "keywords": [
     "validation",
@@ -29,11 +30,14 @@
     "directory": "packages/config"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "typescript": "^5.7.2"
   },
   "dependencies": {
+    "js-yaml": "^4.1.0",
     "tsx": "^4.20.6",
-    "zod": "^3.24.1"
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.6"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -42,7 +46,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist"
+    "build": "tsc && node --import tsx ./src/scripts/generate-schema.ts",
+    "clean": "rm -rf dist vibe-validate.schema.json"
   }
 }

package/vibe-validate.schema.json

@@ -0,0 +1,238 @@
+{
+  "$ref": "#/definitions/VibeValidateConfig",
+  "definitions": {
+    "VibeValidateConfig": {
+      "type": "object",
+      "properties": {
+        "validation": {
+          "type": "object",
+          "properties": {
+            "phases": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "parallel": {
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "dependsOn": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "steps": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "command": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "timeout": {
+                          "type": "number",
+                          "exclusiveMinimum": 0
+                        },
+                        "continueOnError": {
+                          "type": "boolean"
+                        },
+                        "env": {
+                          "type": "object",
+                          "additionalProperties": {
+                            "type": "string"
+                          }
+                        },
+                        "cwd": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "command"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "timeout": {
+                    "type": "number",
+                    "exclusiveMinimum": 0,
+                    "default": 300000
+                  },
+                  "failFast": {
+                    "type": "boolean",
+                    "default": true
+                  }
+                },
+                "required": [
+                  "name",
+                  "steps"
+                ],
+                "additionalProperties": false
+              },
+              "minItems": 1
+            },
+            "caching": {
+              "type": "object",
+              "properties": {
+                "strategy": {
+                  "type": "string",
+                  "enum": [
+                    "git-tree-hash",
+                    "timestamp",
+                    "disabled"
+                  ],
+                  "default": "git-tree-hash"
+                },
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "statePath": {
+                  "type": "string",
+                  "default": ".vibe-validate-state.yaml"
+                }
+              },
+              "additionalProperties": false,
+              "default": {
+                "strategy": "git-tree-hash",
+                "enabled": true,
+                "statePath": ".vibe-validate-state.yaml"
+              }
+            }
+          },
+          "required": [
+            "phases"
+          ],
+          "additionalProperties": false
+        },
+        "git": {
+          "type": "object",
+          "properties": {
+            "mainBranch": {
+              "type": "string",
+              "default": "main"
+            },
+            "remoteOrigin": {
+              "type": "string",
+              "default": "origin"
+            },
+            "autoSync": {
+              "type": "boolean",
+              "default": false
+            },
+            "warnIfBehind": {
+              "type": "boolean",
+              "default": true
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "mainBranch": "main",
+            "remoteOrigin": "origin",
+            "autoSync": false,
+            "warnIfBehind": true
+          }
+        },
+        "output": {
+          "type": "object",
+          "properties": {
+            "showProgress": {
+              "type": "boolean",
+              "default": true
+            },
+            "verbose": {
+              "type": "boolean",
+              "default": false
+            },
+            "noColor": {
+              "type": "boolean",
+              "default": false
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "showProgress": true,
+            "verbose": false,
+            "noColor": false
+          }
+        },
+        "ci": {
+          "type": "object",
+          "properties": {
+            "nodeVersions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "os": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "failFast": {
+              "type": "boolean"
+            },
+            "coverage": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        },
+        "hooks": {
+          "type": "object",
+          "properties": {
+            "preCommit": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "command": {
+                  "type": "string",
+                  "default": "npx vibe-validate pre-commit"
+                }
+              },
+              "additionalProperties": false,
+              "default": {
+                "enabled": true,
+                "command": "npx vibe-validate pre-commit"
+              }
+            }
+          },
+          "additionalProperties": false,
+          "default": {
+            "preCommit": {
+              "enabled": true,
+              "command": "npx vibe-validate pre-commit"
+            }
+          }
+        },
+        "preset": {
+          "type": "string"
+        },
+        "extends": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "validation"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}