From e363e1152bbef0e1bc8ae14bcb1b2ad6d92a84f8 Mon Sep 17 00:00:00 2001
From: 7000pctAUTO <lukems3823@gmail.com>
Date: Fri, 30 Jan 2026 07:11:04 +0000
Subject: [PATCH] Add validators schema and code templates

---
 src/validators/schema.ts | 69 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 src/validators/schema.ts

diff --git a/src/validators/schema.ts b/src/validators/schema.ts
new file mode 100644
index 0000000..100758b
--- /dev/null
+++ b/src/validators/schema.ts
@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { CLISpec, Option, Command, Argument, Example } from '../types/spec.js';
+
+const optionSchema: z.ZodType<Option> = z.object({
+  name: z.string().min(1, 'Option name is required'),
+  short: z.string().optional(),
+  description: z.string().min(1, 'Option description is required'),
+  type: z.enum(['string', 'number', 'boolean', 'array']),
+  required: z.boolean().optional(),
+  default: z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]).optional(),
+  choices: z.array(z.union([z.string(), z.number()])).optional(),
+  implies: z.array(z.string()).optional(),
+  conflicts: z.array(z.string()).optional(),
+});
+
+const argumentSchema: z.ZodType<Argument> = z.object({
+  name: z.string().min(1, 'Argument name is required'),
+  description: z.string().min(1, 'Argument description is required'),
+  required: z.boolean().optional(),
+  variadic: z.boolean().optional(),
+  choices: z.array(z.string()).optional(),
+});
+
+const exampleSchema: z.ZodType<Example> = z.object({
+  description: z.string().min(1, 'Example description is required'),
+  command: z.string().min(1, 'Example command is required'),
+  output: z.string().optional(),
+});
+
+const commandSchema: z.ZodType<Command> = z.lazy(() =>
+  z.object({
+    name: z.string().min(1, 'Command name is required'),
+    description: z.string().min(1, 'Command description is required'),
+    aliases: z.array(z.string()).optional(),
+    options: z.array(optionSchema).optional(),
+    arguments: z.array(argumentSchema).optional(),
+    subcommands: z.array(z.lazy(() => commandSchema)).optional(),
+    examples: z.array(exampleSchema).optional(),
+  })
+);
+
+export const cliSpecSchema: z.ZodType<CLISpec> = z.object({
+  name: z.string().min(1, 'CLI name is required'),
+  version: z.string().regex(/^\d+\.\d+\.\d+/, 'Version must be semantic (e.g., 1.0.0)'),
+  description: z.string().min(1, 'Description is required'),
+  author: z.string().optional(),
+  license: z.string().optional(),
+  homepage: z.string().url().optional().or(z.string().optional()),
+  bin: z.string().optional(),
+  globalOptions: z.array(optionSchema).optional(),
+  commands: z.array(commandSchema).min(1, 'At least one command is required'),
+  examples: z.array(exampleSchema).optional(),
+});
+
+export function validateSpec(spec: unknown): { success: true; data: CLISpec } | { success: false; errors: string[] } {
+  const result = cliSpecSchema.safeParse(spec);
+
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+
+  const errors: string[] = [];
+  for (const issue of result.error.issues) {
+    const path = issue.path.join('.');
+    errors.push(`${path ? `${path}: ` : ''}${issue.message}`);
+  }
+
+  return { success: false, errors };
+}