clavix 5.6.2 → 5.6.4

package/dist/utils/schemas.js

@@ -0,0 +1,164 @@
+/**
+ * Zod schemas for configuration file validation
+ * Provides runtime validation for integrations.json and user config.json
+ */
+import { z } from 'zod';
+/**
+ * Integration type discriminator
+ * - "standard": Normal adapter with slash command generation
+ * - "universal": Documentation-only adapter (Copilot, OCTO, WARP)
+ */
+const IntegrationTypeSchema = z.enum(['standard', 'universal']).optional().default('standard');
+/**
+ * Schema for a single integration entry in integrations.json
+ */
+export const IntegrationEntrySchema = z.object({
+    name: z.string().min(1, 'Integration name is required'),
+    displayName: z.string().min(1, 'Display name is required'),
+    directory: z.string().min(1, 'Directory path is required'),
+    filenamePattern: z.string().min(1, 'Filename pattern is required'),
+    extension: z.enum(['.md', '.toml']),
+    separator: z.enum([':', '-']),
+    detection: z.string().min(1, 'Detection path is required'),
+    type: IntegrationTypeSchema,
+    // Optional fields
+    specialAdapter: z.enum(['toml', 'doc-injection']).optional(),
+    rootDir: z.string().optional(),
+    global: z.boolean().optional(),
+    placeholder: z.string().optional(),
+});
+/**
+ * Schema for the full integrations.json file
+ */
+export const IntegrationsConfigSchema = z.object({
+    $schema: z.string().optional(),
+    version: z.string().regex(/^\d+\.\d+\.\d+$/, 'Version must be semver format (e.g., "1.0.0")'),
+    integrations: z
+        .array(IntegrationEntrySchema)
+        .min(1, 'At least one integration is required')
+        .refine((integrations) => {
+        const names = integrations.map((i) => i.name);
+        return new Set(names).size === names.length;
+    }, { message: 'Integration names must be unique' }),
+});
+/**
+ * Schema for template configuration
+ */
+const TemplateConfigSchema = z.object({
+    prdQuestions: z.string(),
+    fullPrd: z.string(),
+    quickPrd: z.string(),
+});
+/**
+ * Schema for output configuration
+ */
+const OutputConfigSchema = z.object({
+    path: z.string(),
+    format: z.enum(['markdown', 'pdf']),
+});
+/**
+ * Schema for user preferences
+ */
+const PreferencesConfigSchema = z.object({
+    autoOpenOutputs: z.boolean(),
+    verboseLogging: z.boolean(),
+});
+/**
+ * Schema for user's .clavix/config.json
+ * Matches ClavixConfig interface in src/types/config.ts
+ */
+export const UserConfigSchema = z.object({
+    version: z.string().optional(),
+    integrations: z.array(z.string().min(1)).optional().describe('List of enabled integration names'),
+    // Legacy field name (backwards compatibility)
+    providers: z
+        .array(z.string().min(1))
+        .optional()
+        .describe('Legacy field: use "integrations" instead'),
+    templates: TemplateConfigSchema.optional(),
+    outputs: OutputConfigSchema.optional(),
+    preferences: PreferencesConfigSchema.optional(),
+    experimental: z.record(z.unknown()).optional(),
+});
+/**
+ * Validate integrations.json content (build-time, strict)
+ * @param content - Parsed JSON content from integrations.json
+ * @returns Validation result with parsed data or errors
+ */
+export function validateIntegrationsConfig(content) {
+    const result = IntegrationsConfigSchema.safeParse(content);
+    if (!result.success) {
+        return {
+            success: false,
+            errors: result.error,
+        };
+    }
+    const warnings = [];
+    // Check for unknown fields (warn only)
+    if (typeof content === 'object' && content !== null) {
+        const knownFields = new Set(['$schema', 'version', 'integrations']);
+        const contentKeys = Object.keys(content);
+        const unknownKeys = contentKeys.filter((key) => !knownFields.has(key));
+        if (unknownKeys.length > 0) {
+            warnings.push(`Unknown fields in integrations.json: ${unknownKeys.join(', ')}`);
+        }
+    }
+    return {
+        success: true,
+        data: result.data,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Validate user config.json content (runtime, lenient)
+ * @param content - Parsed JSON content from .clavix/config.json
+ * @returns Validation result with parsed data or errors
+ */
+export function validateUserConfig(content) {
+    const result = UserConfigSchema.safeParse(content);
+    if (!result.success) {
+        return {
+            success: false,
+            errors: result.error,
+        };
+    }
+    const warnings = [];
+    // Warn about legacy field usage
+    if (result.data.providers && !result.data.integrations) {
+        warnings.push('Using deprecated "providers" field. Please rename to "integrations" in .clavix/config.json');
+    }
+    // Check for unknown fields (warn only)
+    if (typeof content === 'object' && content !== null) {
+        const knownFields = new Set([
+            'version',
+            'integrations',
+            'providers',
+            'templates',
+            'outputs',
+            'preferences',
+            'experimental',
+        ]);
+        const contentKeys = Object.keys(content);
+        const unknownKeys = contentKeys.filter((key) => !knownFields.has(key));
+        if (unknownKeys.length > 0) {
+            warnings.push(`Unknown fields in config.json: ${unknownKeys.join(', ')}`);
+        }
+    }
+    return {
+        success: true,
+        data: result.data,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Format Zod errors into human-readable messages
+ * @param errors - Zod validation errors
+ * @returns Array of formatted error messages
+ */
+export function formatZodErrors(errors) {
+    return errors.errors.map((err) => {
+        const path = err.path.join('.');
+        return path ? `${path}: ${err.message}` : err.message;
+    });
+}
+//# sourceMappingURL=schemas.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.6.2",
+  "version": "5.6.4",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n  /clavix:improve    Optimize prompts with auto-depth\n  /clavix:prd        Generate PRD through questions\n  /clavix:plan       Create task breakdown from PRD\n  /clavix:implement  Execute tasks with progress tracking\n  /clavix:start      Begin conversational session\n  /clavix:summarize  Extract requirements from conversation\n\nWorks with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",
@@ -70,7 +70,8 @@
     "@oclif/plugin-help": "^6.2.35",
     "chalk": "^5.6.2",
     "fs-extra": "^11.3.2",
-    "inquirer": "^12.11.1"
+    "inquirer": "^12.11.1",
+    "zod": "^3.24.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.17.0",