@kiyeonjeon21/datacontext 0.2.0 → 0.3.1

package/dist/core/llm-service.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * LLM Service Module
+ *
+ * Provides AI-powered features using Claude API.
+ * Used for auto-generating glossary terms, descriptions, and query suggestions.
+ *
+ * @example
+ * ```typescript
+ * const llm = createLLMService();
+ *
+ * // Generate glossary from user's raw terms
+ * const terms = await llm.generateGlossary(
+ *   "활성 사용자, 최근 주문, VIP 고객",
+ *   schemaContext
+ * );
+ *
+ * // Generate table descriptions
+ * const descriptions = await llm.generateTableDescriptions(tableInfo);
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMService = void 0;
+exports.createLLMService = createLLMService;
+exports.isLLMAvailable = isLLMAvailable;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const types_js_1 = require("../knowledge/types.js");
+/** LLM Service class */
+class LLMService {
+    client;
+    model;
+    maxTokens;
+    constructor(config = {}) {
+        const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new Error('Anthropic API key not found. Set ANTHROPIC_API_KEY environment variable or pass apiKey in config.');
+        }
+        this.client = new sdk_1.default({ apiKey });
+        this.model = config.model || process.env.ANTHROPIC_MODEL || 'claude-sonnet-4-20250514';
+        this.maxTokens = config.maxTokens || 4096;
+    }
+    /**
+     * Generate glossary terms from user's raw input
+     *
+     * Takes natural language terms and generates structured BusinessTerm entries
+     * with SQL expressions and proper categorization.
+     *
+     * @param rawTerms - User's raw term input (comma-separated, YAML, or natural language)
+     * @param context - Database schema context
+     * @param schemaHash - Current schema hash for metadata
+     * @returns Array of generated BusinessTerm entries
+     *
+     * @example
+     * ```typescript
+     * const terms = await llm.generateGlossary(
+     *   "활성 사용자 = status가 1인 사용자\n최근 주문 = 30일 이내 주문",
+     *   { tables: [{ name: 'users', columns: [...] }] },
+     *   "abc123"
+     * );
+     * ```
+     */
+    async generateGlossary(rawTerms, context, schemaHash = '') {
+        const systemPrompt = `You are a database context expert. Your job is to analyze user-provided business terms and generate structured glossary entries that can be used to translate natural language queries into accurate SQL.
+
+IMPORTANT RULES:
+1. Generate SQL expressions that are syntactically correct for the given schema
+2. Match terms to actual table/column names in the schema
+3. Be precise with data types (e.g., integer status codes, date intervals)
+4. Include synonyms in multiple languages if the term suggests it
+5. Categorize terms appropriately: status, time, money, entity, metric, filter, custom
+
+OUTPUT FORMAT: Return a JSON array of term objects. Each object must have:
+- term: The primary term name
+- synonyms: Array of alternative names (include English, Korean if applicable)
+- definition: Clear explanation of what this term means
+- sqlExpression: SQL condition or expression (if applicable)
+- appliesTo: { tables?: string[], columns?: string[] }
+- category: One of: status, time, money, entity, metric, filter, custom
+- examples: Array of example usage in natural language queries
+
+Return ONLY the JSON array, no other text.`;
+        const schemaInfo = this.formatSchemaContext(context);
+        const userPrompt = `DATABASE SCHEMA:
+${schemaInfo}
+
+${context.existingTerms?.length ? `EXISTING TERMS (avoid duplicates):
+${context.existingTerms.map(t => `- ${t.term}: ${t.definition}`).join('\n')}
+` : ''}
+
+USER'S RAW TERMS TO PROCESS:
+${rawTerms}
+
+Generate structured glossary entries for these terms. Match them to the actual schema above.`;
+        try {
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: this.maxTokens,
+                messages: [
+                    { role: 'user', content: userPrompt }
+                ],
+                system: systemPrompt,
+            });
+            const content = response.content[0];
+            if (content.type !== 'text') {
+                throw new Error('Unexpected response type from Claude');
+            }
+            // Parse JSON response
+            const generated = this.parseJsonResponse(content.text);
+            // Convert to BusinessTerm with metadata
+            return generated.map(term => ({
+                ...(0, types_js_1.createKnowledgeMeta)('auto', schemaHash),
+                type: 'business_term',
+                term: term.term,
+                synonyms: term.synonyms || [],
+                definition: term.definition,
+                sqlExpression: term.sqlExpression,
+                appliesTo: term.appliesTo,
+                category: term.category,
+                examples: term.examples,
+                isActive: true,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to generate glossary: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Generate table/column descriptions from schema
+     *
+     * Analyzes table and column names to generate meaningful descriptions.
+     * Useful for cold-start when no documentation exists.
+     *
+     * @param tableInfo - Table schema information
+     * @param schemaHash - Current schema hash
+     * @returns Generated TableDescription
+     */
+    async generateTableDescription(tableInfo, schemaHash = '') {
+        const systemPrompt = `You are a database documentation expert. Analyze the table structure and generate clear, useful descriptions.
+
+OUTPUT FORMAT: Return a JSON object with:
+- description: One sentence describing the table's purpose
+- purpose: Detailed explanation of the table's role
+- columns: Array of { name: string, description: string, valueMappings?: Record<string, string> }
+- tags: Array of relevant tags
+
+Return ONLY the JSON object, no other text.`;
+        const sampleDataStr = tableInfo.sampleData
+            ? `\n\nSAMPLE DATA:\n${JSON.stringify(tableInfo.sampleData.slice(0, 3), null, 2)}`
+            : '';
+        const userPrompt = `TABLE: ${tableInfo.name}
+
+COLUMNS:
+${tableInfo.columns.map(c => `- ${c.name} (${c.type}${c.nullable ? ', nullable' : ''})`).join('\n')}
+${sampleDataStr}
+
+Generate descriptions for this table and its columns.`;
+        try {
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: this.maxTokens,
+                messages: [
+                    { role: 'user', content: userPrompt }
+                ],
+                system: systemPrompt,
+            });
+            const content = response.content[0];
+            if (content.type !== 'text') {
+                throw new Error('Unexpected response type from Claude');
+            }
+            return this.parseJsonResponse(content.text);
+        }
+        catch (error) {
+            throw new Error(`Failed to generate table description: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Enhance a user query with glossary context
+     *
+     * Takes a natural language query and returns an enhanced version
+     * with term definitions resolved.
+     *
+     * @param query - User's natural language query
+     * @param terms - Available business terms
+     * @returns Enhanced query with context
+     */
+    async enhanceQueryWithGlossary(query, terms) {
+        if (terms.length === 0) {
+            return { enhancedQuery: query, usedTerms: [], suggestedConditions: [] };
+        }
+        const systemPrompt = `You are a query enhancement assistant. Your job is to identify business terms in user queries and suggest SQL conditions based on the glossary.
+
+OUTPUT FORMAT: Return a JSON object with:
+- enhancedQuery: The query with term definitions inline
+- usedTerms: Array of term names that were found in the query
+- suggestedConditions: Array of SQL conditions to apply
+
+Return ONLY the JSON object, no other text.`;
+        const glossaryStr = terms
+            .filter(t => t.isActive)
+            .map(t => `- "${t.term}" (${t.synonyms.join(', ')}): ${t.definition}${t.sqlExpression ? ` → SQL: ${t.sqlExpression}` : ''}`)
+            .join('\n');
+        const userPrompt = `GLOSSARY:
+${glossaryStr}
+
+USER QUERY:
+${query}
+
+Identify any terms from the glossary used in this query and suggest SQL conditions.`;
+        try {
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: 1024,
+                messages: [
+                    { role: 'user', content: userPrompt }
+                ],
+                system: systemPrompt,
+            });
+            const content = response.content[0];
+            if (content.type !== 'text') {
+                return { enhancedQuery: query, usedTerms: [], suggestedConditions: [] };
+            }
+            return this.parseJsonResponse(content.text);
+        }
+        catch {
+            return { enhancedQuery: query, usedTerms: [], suggestedConditions: [] };
+        }
+    }
+    /**
+     * Parse JSON response from Claude, handling markdown code blocks
+     */
+    parseJsonResponse(text) {
+        // Remove markdown code blocks if present
+        let cleaned = text.trim();
+        if (cleaned.startsWith('```json')) {
+            cleaned = cleaned.slice(7);
+        }
+        else if (cleaned.startsWith('```')) {
+            cleaned = cleaned.slice(3);
+        }
+        if (cleaned.endsWith('```')) {
+            cleaned = cleaned.slice(0, -3);
+        }
+        cleaned = cleaned.trim();
+        try {
+            return JSON.parse(cleaned);
+        }
+        catch {
+            throw new Error(`Failed to parse JSON response: ${text.slice(0, 200)}...`);
+        }
+    }
+    /**
+     * Format schema context for prompts
+     */
+    formatSchemaContext(context) {
+        return context.tables
+            .map(table => {
+            const cols = table.columns
+                .map(c => `  - ${c.name} (${c.type}${c.nullable ? ', nullable' : ''})`)
+                .join('\n');
+            return `Table: ${table.name}\n${cols}`;
+        })
+            .join('\n\n');
+    }
+}
+exports.LLMService = LLMService;
+/**
+ * Create an LLM service instance
+ *
+ * @param config - Service configuration
+ * @returns LLMService instance
+ */
+function createLLMService(config = {}) {
+    return new LLMService(config);
+}
+/**
+ * Check if LLM service is available (API key configured)
+ */
+function isLLMAvailable() {
+    return !!process.env.ANTHROPIC_API_KEY;
+}
+//# sourceMappingURL=llm-service.js.map

package/dist/core/llm-service.js.map

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

package/dist/knowledge/store.d.ts

@@ -2,7 +2,7 @@
  * Knowledge Store
  * Local JSON-based storage for table descriptions, query examples, and business rules
  */
-import type { TableDescription, QueryExample, BusinessRule, KnowledgeEntry, ColumnDescription } from './types.js';
+import type { TableDescription, QueryExample, BusinessRule, BusinessTerm, KnowledgeEntry, ColumnDescription, TermCategory } from './types.js';
 export declare class KnowledgeStore {
     private dataPath;
     private data;
@@ -87,14 +87,66 @@ export declare class KnowledgeStore {
         priority?: number;
         schemaHash?: string;
     }): Promise<BusinessRule>;
+    /**
+     * Get all business terms
+     */
+    getBusinessTerms(): BusinessTerm[];
+    /**
+     * Get active business terms
+     */
+    getActiveTerms(): BusinessTerm[];
+    /**
+     * Get business terms for specific tables
+     */
+    getTermsForTables(tables: string[]): BusinessTerm[];
+    /**
+     * Find terms matching a query (by term name or synonyms)
+     */
+    findMatchingTerms(query: string): BusinessTerm[];
+    /**
+     * Add a business term
+     */
+    addBusinessTerm(term: string, definition: string, options?: {
+        synonyms?: string[];
+        sqlExpression?: string;
+        appliesTo?: {
+            tables?: string[];
+            columns?: string[];
+        };
+        category?: TermCategory;
+        examples?: string[];
+        schemaHash?: string;
+    }): Promise<BusinessTerm>;
+    /**
+     * Add multiple business terms at once
+     */
+    addBusinessTerms(terms: BusinessTerm[]): Promise<BusinessTerm[]>;
+    /**
+     * Update a business term
+     */
+    updateBusinessTerm(id: string, updates: Partial<Omit<BusinessTerm, 'id' | 'type' | 'createdAt'>>): Promise<BusinessTerm>;
+    /**
+     * Delete a business term
+     */
+    deleteBusinessTerm(id: string): Promise<void>;
     /**
      * Get all knowledge entries that may be outdated (schema drift)
      */
     getOutdatedEntries(currentSchemaHash: string): KnowledgeEntry[];
     /**
      * Build context for AI from knowledge store
-     */
-    buildContext(tables: string[]): string;
+     *
+     * Generates a comprehensive context string including:
+     * - Table descriptions and column details
+     * - Business glossary/terms with SQL mappings
+     * - Business rules and conditions
+     * - Query examples
+     *
+     * @param tables - Tables to include context for
+     * @param userQuery - Optional user query to match relevant terms
+     * @returns Formatted context string for AI
+     */
+    buildContext(tables: string[], userQuery?: string): string;
     private createEmptyData;
     /**
      * Get raw knowledge data (for API/export)
@@ -111,6 +163,7 @@ export declare class KnowledgeStore {
         }>;
         queryExamples: QueryExample[];
         businessRules: BusinessRule[];
+        businessTerms: BusinessTerm[];
     };
 }
 /**

package/dist/knowledge/store.d.ts.map

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

package/dist/knowledge/store.js

@@ -236,6 +236,144 @@ class KnowledgeStore {
         await this.save();
         return rule;
     }
+    // ============ Business Terms (Glossary) ============
+    /**
+     * Get all business terms
+     */
+    getBusinessTerms() {
+        return this.data?.businessTerms ?? [];
+    }
+    /**
+     * Get active business terms
+     */
+    getActiveTerms() {
+        return this.data?.businessTerms.filter(t => t.isActive) ?? [];
+    }
+    /**
+     * Get business terms for specific tables
+     */
+    getTermsForTables(tables) {
+        return this.data?.businessTerms.filter(term => term.isActive &&
+            (term.appliesTo?.tables?.some(t => tables.includes(t)) ?? true)) ?? [];
+    }
+    /**
+     * Find terms matching a query (by term name or synonyms)
+     */
+    findMatchingTerms(query) {
+        const lowerQuery = query.toLowerCase();
+        return this.data?.businessTerms.filter(term => {
+            if (!term.isActive)
+                return false;
+            // Check term name
+            if (term.term.toLowerCase().includes(lowerQuery))
+                return true;
+            if (lowerQuery.includes(term.term.toLowerCase()))
+                return true;
+            // Check synonyms
+            for (const syn of term.synonyms) {
+                if (syn.toLowerCase().includes(lowerQuery))
+                    return true;
+                if (lowerQuery.includes(syn.toLowerCase()))
+                    return true;
+            }
+            return false;
+        }) ?? [];
+    }
+    /**
+     * Add a business term
+     */
+    async addBusinessTerm(term, definition, options = {}) {
+        if (!this.data) {
+            throw new Error('Knowledge store not loaded');
+        }
+        // Check for duplicates
+        const existing = this.data.businessTerms.find(t => t.term.toLowerCase() === term.toLowerCase());
+        if (existing) {
+            // Update existing term
+            return this.updateBusinessTerm(existing.id, {
+                definition,
+                ...options,
+            });
+        }
+        const schemaHash = options.schemaHash ?? this.data.schemaHash;
+        const newTerm = {
+            ...(0, types_js_1.createKnowledgeMeta)('user', schemaHash),
+            type: 'business_term',
+            term,
+            synonyms: options.synonyms ?? [],
+            definition,
+            sqlExpression: options.sqlExpression,
+            appliesTo: options.appliesTo,
+            category: options.category,
+            examples: options.examples,
+            isActive: true,
+        };
+        this.data.businessTerms.push(newTerm);
+        await this.save();
+        return newTerm;
+    }
+    /**
+     * Add multiple business terms at once
+     */
+    async addBusinessTerms(terms) {
+        if (!this.data) {
+            throw new Error('Knowledge store not loaded');
+        }
+        const added = [];
+        for (const term of terms) {
+            // Check for duplicates
+            const existingIndex = this.data.businessTerms.findIndex(t => t.term.toLowerCase() === term.term.toLowerCase());
+            if (existingIndex >= 0) {
+                // Update existing
+                this.data.businessTerms[existingIndex] = {
+                    ...this.data.businessTerms[existingIndex],
+                    ...term,
+                    updatedAt: new Date().toISOString(),
+                };
+                added.push(this.data.businessTerms[existingIndex]);
+            }
+            else {
+                // Add new
+                this.data.businessTerms.push(term);
+                added.push(term);
+            }
+        }
+        await this.save();
+        return added;
+    }
+    /**
+     * Update a business term
+     */
+    async updateBusinessTerm(id, updates) {
+        if (!this.data) {
+            throw new Error('Knowledge store not loaded');
+        }
+        const index = this.data.businessTerms.findIndex(t => t.id === id);
+        if (index < 0) {
+            throw new Error(`Business term not found: ${id}`);
+        }
+        const updated = {
+            ...this.data.businessTerms[index],
+            ...updates,
+            updatedAt: new Date().toISOString(),
+        };
+        this.data.businessTerms[index] = updated;
+        await this.save();
+        return updated;
+    }
+    /**
+     * Delete a business term
+     */
+    async deleteBusinessTerm(id) {
+        if (!this.data) {
+            throw new Error('Knowledge store not loaded');
+        }
+        const index = this.data.businessTerms.findIndex(t => t.id === id);
+        if (index >= 0) {
+            this.data.businessTerms.splice(index, 1);
+            await this.save();
+        }
+    }
     // ============ Utilities ============
     /**
      * Get all knowledge entries that may be outdated (schema drift)
@@ -260,13 +398,55 @@ class KnowledgeStore {
                 outdated.push(br);
             }
         }
+        for (const bt of this.data.businessTerms ?? []) {
+            if (bt.schemaHash !== currentSchemaHash) {
+                outdated.push(bt);
+            }
+        }
         return outdated;
     }
     /**
      * Build context for AI from knowledge store
+     *
+     * Generates a comprehensive context string including:
+     * - Table descriptions and column details
+     * - Business glossary/terms with SQL mappings
+     * - Business rules and conditions
+     * - Query examples
+     *
+     * @param tables - Tables to include context for
+     * @param userQuery - Optional user query to match relevant terms
+     * @returns Formatted context string for AI
      */
-    buildContext(tables) {
+    buildContext(tables, userQuery) {
         const parts = [];
+        // Add business glossary FIRST (helps AI understand terminology)
+        const terms = userQuery
+            ? this.findMatchingTerms(userQuery)
+            : this.getTermsForTables(tables);
+        if (terms.length > 0) {
+            parts.push('## Business Glossary');
+            parts.push('Use these term definitions when interpreting user requests:');
+            parts.push('');
+            for (const term of terms) {
+                let termInfo = `**${term.term}**`;
+                if (term.synonyms.length > 0) {
+                    termInfo += ` (also: ${term.synonyms.join(', ')})`;
+                }
+                parts.push(termInfo);
+                parts.push(`  Definition: ${term.definition}`);
+                if (term.sqlExpression) {
+                    parts.push(`  SQL: \`${term.sqlExpression}\``);
+                }
+                if (term.appliesTo?.tables?.length) {
+                    parts.push(`  Applies to: ${term.appliesTo.tables.join(', ')}`);
+                }
+                if (term.examples?.length) {
+                    parts.push(`  Example usage: "${term.examples[0]}"`);
+                }
+                parts.push('');
+            }
+        }
         // Add table descriptions
         for (const tableName of tables) {
             const desc = this.getTableDescription(tableName);
@@ -295,10 +475,11 @@ class KnowledgeStore {
         const rules = this.getActiveRulesForTables(tables);
         if (rules.length > 0) {
             parts.push('## Business Rules');
+            parts.push('Always apply these rules when querying:');
             for (const rule of rules) {
-                parts.push(`- ${rule.name}: ${rule.description}`);
+                parts.push(`- **${rule.name}**: ${rule.description}`);
                 if (rule.condition) {
-                    parts.push(`  Condition: ${rule.condition}`);
+                    parts.push(`  SQL condition: \`${rule.condition}\``);
                 }
             }
             parts.push('');
@@ -307,11 +488,14 @@ class KnowledgeStore {
         const examples = this.getQueryExamplesForTables(tables);
         if (examples.length > 0) {
             parts.push('## Query Examples');
+            parts.push('Reference these verified examples:');
             for (const ex of examples.slice(0, 5)) { // Limit to 5 examples
-                parts.push(`Intent: ${ex.intent}`);
-                parts.push(`SQL: ${ex.sql}`);
+                parts.push(`Intent: "${ex.intent}"`);
+                parts.push('```sql');
+                parts.push(ex.sql);
+                parts.push('```');
                 if (ex.explanation) {
-                    parts.push(`Explanation: ${ex.explanation}`);
+                    parts.push(`Note: ${ex.explanation}`);
                 }
                 parts.push('');
             }
@@ -327,6 +511,7 @@ class KnowledgeStore {
             tableDescriptions: [],
             queryExamples: [],
             businessRules: [],
+            businessTerms: [],
         };
     }
     /**
@@ -334,7 +519,7 @@ class KnowledgeStore {
      */
     getData() {
         if (!this.data) {
-            return { tables: [], queryExamples: [], businessRules: [] };
+            return { tables: [], queryExamples: [], businessRules: [], businessTerms: [] };
         }
         return {
             tables: this.data.tableDescriptions.map(td => ({
@@ -345,6 +530,7 @@ class KnowledgeStore {
             })),
             queryExamples: this.data.queryExamples,
             businessRules: this.data.businessRules,
+            businessTerms: this.data.businessTerms ?? [],
         };
     }
 }