@quanvo99/ai-rules 0.1.3 → 0.1.5

package/dist/cli/lib/ollama-client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Ollama LLM client for generating questions
+ * Handles connection, API calls, and response parsing
+ */
+/**
+ * Configuration for Ollama client
+ */
+interface OllamaConfig {
+    /** Ollama server URL */
+    baseUrl: string;
+    /** Default model to use */
+    defaultModel: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+}
+/**
+ * Error class for Ollama-specific errors
+ */
+export declare class OllamaError extends Error {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Checks if Ollama server is running and accessible
+ * @param config - Ollama configuration
+ * @returns Promise that resolves to true if server is accessible, false on any error
+ */
+export declare function checkOllamaHealth(config?: OllamaConfig): Promise<boolean>;
+/**
+ * Calls Ollama API to generate text
+ * @param prompt - The prompt to send to the LLM
+ * @param model - Model to use (defaults to config default)
+ * @param config - Ollama configuration
+ * @returns Promise that resolves to the generated text
+ */
+export declare function callOllama(prompt: string, model?: string, config?: OllamaConfig): Promise<string>;
+/**
+ * Extracts JSON from LLM response text
+ * Handles cases where LLM returns pure JSON or wraps it in markdown code blocks
+ *
+ * @example
+ * // Pure JSON object
+ * extractJsonFromResponse('{"questions": [{"id": "1", "text": "test"}]}')
+ *
+ * // Pure JSON array
+ * extractJsonFromResponse('[{"id": "1", "text": "test"}]')
+ *
+ * // JSON in markdown code block
+ * extractJsonFromResponse('```json\n{"questions": []}\n```')
+ *
+ * // JSON with extra text
+ * extractJsonFromResponse('Here is the JSON: {"id": "1"}')
+ *
+ * @param response - Raw response from LLM
+ * @returns Extracted JSON string or null if not found
+ */
+export declare function extractJsonFromResponse(response: string): string | null;
+/**
+ * Generates questions using Ollama with error handling
+ * @param prompt - The prompt to send to the LLM
+ * @param model - Model to use (optional)
+ * @returns Promise that resolves to the generated JSON string
+ */
+export declare function generateQuestionsWithOllama(prompt: string, model?: string): Promise<string>;
+export {};
+//# sourceMappingURL=ollama-client.d.ts.map

package/dist/cli/lib/ollama-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/ollama-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,UAAU,YAAY;IACrB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CAChB;AAoCD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAG7B,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAA6B,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB/F;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,GAAE,YAA6B,GACnC,OAAO,CAAC,MAAM,CAAC,CAkDjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmDvE;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBjG"}

package/dist/cli/lib/ollama-client.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Ollama LLM client for generating questions
+ * Handles connection, API calls, and response parsing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaError = void 0;
+exports.checkOllamaHealth = checkOllamaHealth;
+exports.callOllama = callOllama;
+exports.extractJsonFromResponse = extractJsonFromResponse;
+exports.generateQuestionsWithOllama = generateQuestionsWithOllama;
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    baseUrl: "http://localhost:11434",
+    defaultModel: process.env.OLLAMA_MODEL || "llama3.2",
+    timeout: parseInt(process.env.OLLAMA_TIMEOUT || "180000", 10), // 3 minutes default, configurable via env
+};
+/**
+ * Error class for Ollama-specific errors
+ */
+class OllamaError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "OllamaError";
+    }
+}
+exports.OllamaError = OllamaError;
+/**
+ * Checks if Ollama server is running and accessible
+ * @param config - Ollama configuration
+ * @returns Promise that resolves to true if server is accessible, false on any error
+ */
+async function checkOllamaHealth(config = DEFAULT_CONFIG) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+    try {
+        const response = await fetch(`${config.baseUrl}/api/tags`, {
+            method: "GET",
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        return response.ok;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            return false; // Timeout occurred
+        }
+        return false; // Any other error means server is not accessible
+    }
+}
+/**
+ * Calls Ollama API to generate text
+ * @param prompt - The prompt to send to the LLM
+ * @param model - Model to use (defaults to config default)
+ * @param config - Ollama configuration
+ * @returns Promise that resolves to the generated text
+ */
+async function callOllama(prompt, model, config = DEFAULT_CONFIG) {
+    const modelToUse = model || config.defaultModel;
+    const requestBody = {
+        model: modelToUse,
+        prompt,
+        stream: false,
+        options: {
+            temperature: 0.7,
+            max_tokens: 1500,
+            top_p: 0.9,
+            frequency_penalty: 0.5,
+        },
+    };
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+        controller.abort();
+    }, config.timeout);
+    let response;
+    try {
+        response = await fetch(`${config.baseUrl}/api/generate`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(requestBody),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new OllamaError(`Request timeout after ${config.timeout}ms`);
+        }
+        throw new OllamaError(`Request failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+        throw new OllamaError(`HTTP ${response.status}: ${response.statusText}`, response.status);
+    }
+    try {
+        const data = (await response.json());
+        return data.response;
+    }
+    catch (error) {
+        throw new OllamaError(`Failed to parse JSON response: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+/**
+ * Extracts JSON from LLM response text
+ * Handles cases where LLM returns pure JSON or wraps it in markdown code blocks
+ *
+ * @example
+ * // Pure JSON object
+ * extractJsonFromResponse('{"questions": [{"id": "1", "text": "test"}]}')
+ *
+ * // Pure JSON array
+ * extractJsonFromResponse('[{"id": "1", "text": "test"}]')
+ *
+ * // JSON in markdown code block
+ * extractJsonFromResponse('```json\n{"questions": []}\n```')
+ *
+ * // JSON with extra text
+ * extractJsonFromResponse('Here is the JSON: {"id": "1"}')
+ *
+ * @param response - Raw response from LLM
+ * @returns Extracted JSON string or null if not found
+ */
+function extractJsonFromResponse(response) {
+    // Trim whitespace first
+    const trimmed = response.trim();
+    // Case 1: Response is pure JSON (starts and ends with {})
+    if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+        try {
+            // Try to parse to validate it's valid JSON
+            JSON.parse(trimmed);
+            return trimmed;
+        }
+        catch {
+            // Not valid JSON, continue to other methods
+        }
+    }
+    // Case 2: Response is pure JSON array (starts and ends with [])
+    if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+        try {
+            // Try to parse to validate it's valid JSON
+            JSON.parse(trimmed);
+            return trimmed;
+        }
+        catch {
+            // Not valid JSON, continue to other methods
+        }
+    }
+    // Case 3: JSON wrapped in markdown code blocks
+    const codeBlockMatch = response.match(/```(?:json)?\s*(\{[\s\S]*?\})\s*```/);
+    if (codeBlockMatch) {
+        return codeBlockMatch[1] ?? null;
+    }
+    // Case 4: JSON array wrapped in markdown code blocks
+    const arrayCodeBlockMatch = response.match(/```(?:json)?\s*(\[[\s\S]*?\])\s*```/);
+    if (arrayCodeBlockMatch) {
+        return arrayCodeBlockMatch[1] ?? null;
+    }
+    // Case 5: Find JSON object anywhere in the text (fallback)
+    const jsonObjectMatch = response.match(/\{[\s\S]*\}/);
+    if (jsonObjectMatch) {
+        return jsonObjectMatch[0] ?? null;
+    }
+    // Case 6: Find JSON array anywhere in the text (fallback)
+    const jsonArrayMatch = response.match(/\[[\s\S]*\]/);
+    if (jsonArrayMatch) {
+        return jsonArrayMatch[0] ?? null;
+    }
+    return null;
+}
+/**
+ * Generates questions using Ollama with error handling
+ * @param prompt - The prompt to send to the LLM
+ * @param model - Model to use (optional)
+ * @returns Promise that resolves to the generated JSON string
+ */
+async function generateQuestionsWithOllama(prompt, model) {
+    const isHealthy = await checkOllamaHealth();
+    if (!isHealthy) {
+        throw new OllamaError("Ollama server is not running or not accessible at http://localhost:11434\n" +
+            "Please start Ollama and ensure the server is running.");
+    }
+    const response = await callOllama(prompt, model);
+    const jsonString = extractJsonFromResponse(response);
+    if (!jsonString) {
+        throw new OllamaError("LLM response does not contain valid JSON.\n" +
+            "Response received:\n" +
+            response.substring(0, 500) +
+            (response.length > 500 ? "..." : ""));
+    }
+    return jsonString;
+}
+//# sourceMappingURL=ollama-client.js.map

package/dist/cli/lib/ollama-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.js","sourceRoot":"","sources":["../../../../src/cli/lib/ollama-client.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/question-prompt.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Prompt builder for question generation
+ * Reads rule content and builds structured prompts for LLM
+ */
+import type { Manifest } from "../../server/types";
+/**
+ * Rule content structure for prompt building
+ */
+interface RuleContent {
+    /** Rule manifest metadata */
+    manifest: Manifest;
+    /** Content of all rule files */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+/**
+ * Reads rule content from the repository
+ * @param rulePath - The path to the rule directory (e.g., 'rules/cursor/brainstorming')
+ * @returns Rule content with manifest and files
+ */
+export declare function readRuleContent(rulePath: string): RuleContent;
+/**
+ * Builds context string from rule metadata and content
+ * @param ruleContent - Rule content structure
+ * @returns Formatted context string for LLM
+ */
+export declare function buildRuleContext(ruleContent: RuleContent): string;
+/**
+ * Builds the complete prompt for LLM question generation
+ * @param rulePath - The path to the rule directory
+ * @returns Complete prompt string
+ */
+export declare function buildQuestionPrompt(rulePath: string): string;
+export {};
+//# sourceMappingURL=question-prompt.d.ts.map

package/dist/cli/lib/question-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-prompt.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/question-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,UAAU,WAAW;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,gCAAgC;IAChC,KAAK,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA+B7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAcjE;AAmID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D"}

package/dist/cli/lib/question-prompt.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Prompt builder for question generation
+ * Reads rule content and builds structured prompts for LLM
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRuleContent = readRuleContent;
+exports.buildRuleContext = buildRuleContext;
+exports.buildQuestionPrompt = buildQuestionPrompt;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Reads rule content from the repository
+ * @param rulePath - The path to the rule directory (e.g., 'rules/cursor/brainstorming')
+ * @returns Rule content with manifest and files
+ */
+function readRuleContent(rulePath) {
+    // Resolve the rule directory path
+    const ruleDir = rulePath.startsWith("/") ? rulePath : (0, node_path_1.join)(process.cwd(), rulePath);
+    if (!(0, node_fs_1.existsSync)(ruleDir)) {
+        throw new Error(`Rule directory not found: ${ruleDir}`);
+    }
+    // Read manifest
+    const manifestPath = (0, node_path_1.join)(ruleDir, "manifest.json");
+    if (!(0, node_fs_1.existsSync)(manifestPath)) {
+        throw new Error(`Manifest not found: ${manifestPath}`);
+    }
+    const manifest = JSON.parse((0, node_fs_1.readFileSync)(manifestPath, "utf-8"));
+    // Read all rule files
+    const files = manifest.files.map((file) => {
+        const filePath = (0, node_path_1.join)(ruleDir, file.path);
+        if (!(0, node_fs_1.existsSync)(filePath)) {
+            throw new Error(`Rule file not found: ${filePath}`);
+        }
+        const content = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+        return {
+            path: file.path,
+            content,
+        };
+    });
+    return { manifest, files };
+}
+/**
+ * Builds context string from rule metadata and content
+ * @param ruleContent - Rule content structure
+ * @returns Formatted context string for LLM
+ */
+function buildRuleContext(ruleContent) {
+    const { manifest, files } = ruleContent;
+    const context = `
+Rule ID: ${manifest.id}
+Category: ${manifest.category}
+Tags: ${manifest.tags.join(", ")}
+Description: ${manifest.description}
+
+Rule Content:
+${files.map((file) => `--- ${file.path} ---\n${file.content}`).join("\n\n")}
+`;
+    return context.trim();
+}
+/**
+ * System prompt for question generation
+ * Includes instructions, schema, and examples
+ */
+const SYSTEM_PROMPT = `You are a question generation assistant for an AI rules library.
+
+Your task: Generate 3-5 questions that identify if developers want/need help from this rule.
+
+Context: Questions build context for fuzzy search rule discovery. User describes project → answers questions → keywords added to context → context searches rules.
+
+Question Types:
+1. yes-no: Binary questions. Must include "keywords" array (added to search context if user answers yes)
+2. choice: Multiple choice. Must include "options" array with text and keywords for each
+3. open-ended: Free text. Full answer added to search context.
+
+All questions MUST include:
+- "id": Unique identifier in kebab-case
+- "text": Clear, concise question text
+- "type": One of: yes-no, choice, open-ended
+- "tags": Array of relevant search tags (technology names, concepts, patterns)
+
+Requirements:
+- ALWAYS lead with 1-2 high-level need/intent questions
+- High-level questions should directly ask about wanting/needing help (e.g., "Do you want rules to help with X?")
+- Then follow with specific usage or technical questions
+- Questions can ask about current usage OR needs - both add keywords to context
+- For core technologies (e.g., TypeScript, React, Next.js, Node.js), the FIRST question MUST be a usage-detection yes/no (e.g., "Are you using TypeScript?") when the rule clearly targets that technology
+- Focus on what will help identify if this rule solves their problems
+- Tags should match common terms developers use
+- Keywords should include aliases and variations
+- Keep questions clear and unambiguous
+
+Return valid JSON matching this schema:
+{
+  "questions": [
+    {
+      "id": "string (kebab-case, unique)",
+      "text": "string (the question)",
+      "type": "yes-no | choice | open-ended",
+      "tags": ["string", "..."],
+      "keywords": ["string", "..."], // for yes-no only
+      "options": [ // for choice only
+        { "text": "string", "keywords": ["string", "..."] }
+      ]
+    }
+  ]
+}
+
+Examples:
+
+Example for a TypeScript rule (usage detection MUST be first):
+{
+  "id": "uses-typescript",
+  "text": "Are you using TypeScript?",
+  "type": "yes-no",
+  "tags": ["typescript", "language", "type-system"],
+  "keywords": ["typescript", "ts"]
+}
+
+Example for a React hooks rule (usage detection):
+{
+  "id": "uses-react-hooks",
+  "text": "Are you using React hooks in your project?",
+  "type": "yes-no",
+  "tags": ["react", "hooks", "frontend"],
+  "keywords": ["react", "hooks", "useState", "useEffect"]
+}
+
+Example for a CSS framework choice:
+{
+  "id": "css-framework",
+  "text": "What CSS framework are you using?",
+  "type": "choice",
+  "tags": ["css", "styling", "framework"],
+  "options": [
+    { "text": "Tailwind CSS", "keywords": ["tailwind", "tailwindcss"] },
+    { "text": "styled-components", "keywords": ["styled-components"] },
+    { "text": "CSS Modules", "keywords": ["css-modules"] }
+  ]
+}
+
+Example for a brainstorming rule (high-level need):
+{
+  "id": "wants-brainstorming-help",
+  "text": "Do you want rules to help you brainstorm and document ideas methodically?",
+  "type": "yes-no",
+  "tags": ["brainstorming", "problem-solving", "documentation"],
+  "keywords": ["brainstorming", "structured-thinking", "documentation", "problem-definition"]
+}
+
+Example for open-ended (exploration):
+{
+  "id": "project-challenges",
+  "text": "What are the main challenges you face in your development process?",
+  "type": "open-ended",
+  "tags": ["challenges", "problems", "workflow"]
+}
+
+Example for a React Server Components rule (usage detection):
+{
+  "id": "uses-nextjs-app-router",
+  "text": "Are you using Next.js App Router?",
+  "type": "yes-no",
+  "tags": ["nextjs", "react", "app-router", "server-components"],
+  "keywords": ["nextjs", "app-router", "server-components", "next.js"]
+}
+
+Example for a React Server Components rule (architecture choice):
+{
+  "id": "component-architecture",
+  "text": "What component architecture are you using?",
+  "type": "choice",
+  "tags": ["react", "architecture", "components"],
+  "options": [
+    { "text": "Server Components with App Router", "keywords": ["server-components", "app-router", "rsc"] },
+    { "text": "Client Components only", "keywords": ["client-components", "spa"] },
+    { "text": "Pages Router", "keywords": ["pages-router", "getServerSideProps"] }
+  ]
+}
+
+Example for a Server Components rule (need for guidance):
+{
+  "id": "needs-server-component-patterns",
+  "text": "Do you need help with Server Component patterns and best practices?",
+  "type": "yes-no",
+  "tags": ["react", "server-components", "patterns", "best-practices"],
+  "keywords": ["server-components", "client-server-separation", "data-fetching", "composition"]
+}`;
+/**
+ * Builds the complete prompt for LLM question generation
+ * @param rulePath - The path to the rule directory
+ * @returns Complete prompt string
+ */
+function buildQuestionPrompt(rulePath) {
+    const ruleContent = readRuleContent(rulePath);
+    const context = buildRuleContext(ruleContent);
+    return `${SYSTEM_PROMPT}
+
+Rule to analyze:
+${context}
+
+Generate 3-5 relevant questions for this rule. Return only valid JSON.`;
+}
+//# sourceMappingURL=question-prompt.js.map

package/dist/cli/lib/question-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-prompt.js","sourceRoot":"","sources":["../../../../src/cli/lib/question-prompt.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAwBH,0CA+BC;AAOD,4CAcC;AAwID,kDAUC;AA5ND,qCAAmD;AACnD,yCAAiC;AAgBjC;;;;GAIG;AACH,SAAgB,eAAe,CAAC,QAAgB;IAC/C,kCAAkC;IAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEpF,IAAI,CAAC,IAAA,oBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,gBAAgB;IAChB,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACpD,IAAI,CAAC,IAAA,oBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,QAAQ,GAAa,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,sBAAsB;IACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO;SACP,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,WAAwB;IACxD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC;IAExC,MAAM,OAAO,GAAG;WACN,QAAQ,CAAC,EAAE;YACV,QAAQ,CAAC,QAAQ;QACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;eACjB,QAAQ,CAAC,WAAW;;;EAGjC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;CAC1E,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2HpB,CAAC;AAEH;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,QAAgB;IACnD,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE9C,OAAO,GAAG,aAAa;;;EAGtB,OAAO;;uEAE8D,CAAC;AACxE,CAAC"}

package/dist/cli/lib/question-schema.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Zod schemas for validating question generation responses
+ * Provides type-safe validation with detailed error messages
+ */
+import type { Question, QuestionResponse } from "src/lib/question-types";
+import { z } from "zod";
+/**
+ * Discriminated union schema for all question types
+ * Automatically validates based on the 'type' field
+ */
+export declare const QuestionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    type: z.ZodLiteral<"yes-no">;
+    keywords: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    type: z.ZodLiteral<"choice">;
+    options: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        keywords: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    type: z.ZodLiteral<"open-ended">;
+}, z.core.$strip>], "type">;
+/**
+ * Schema for the complete response containing questions array
+ */
+export declare const QuestionResponseSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        type: z.ZodLiteral<"yes-no">;
+        keywords: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        type: z.ZodLiteral<"choice">;
+        options: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            keywords: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        type: z.ZodLiteral<"open-ended">;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+/**
+ * Validates a question response and returns typed result
+ * @param data - Raw data to validate
+ * @returns Success result with typed data or error details
+ */
+export declare function validateQuestionResponse(data: unknown): {
+    success: true;
+    data: QuestionResponse;
+} | {
+    success: false;
+    error: string;
+    details?: z.ZodError;
+};
+/**
+ * Validates a single question
+ * @param data - Raw data to validate
+ * @returns Success result with typed question or error details
+ */
+export declare function validateQuestion(data: unknown): {
+    success: true;
+    data: Question;
+} | {
+    success: false;
+    error: string;
+    details?: z.ZodError;
+};
+//# sourceMappingURL=question-schema.d.ts.map

package/dist/cli/lib/question-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-schema.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/question-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;2BAIzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GACnD;IACA,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACtB,GACD;IACA,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;CACpB,CAyBH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAC3C;IACA,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CACd,GACD;IACA,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;CACpB,CAyBH"}