@memberjunction/db-auto-doc 2.117.0 → 2.118.0

package/dist/generators/SQLGenerator.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Generates SQL scripts with sp_addextendedproperty statements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLGenerator = void 0;
+class SQLGenerator {
+    /**
+     * Generate SQL script
+     */
+    generate(state, options = {}) {
+        const lines = [];
+        // Header
+        lines.push('-- Database Documentation Script');
+        lines.push(`-- Generated: ${new Date().toISOString()}`);
+        lines.push(`-- Database: ${state.database.name}`);
+        lines.push(`-- Server: ${state.database.server}`);
+        lines.push('');
+        lines.push('-- This script adds MS_Description extended properties to database objects');
+        lines.push('');
+        // Generate statements for each schema
+        for (const schema of state.schemas) {
+            lines.push('');
+            lines.push(`-- Schema: ${schema.name}`);
+            lines.push('');
+            // Schema description
+            if (schema.description) {
+                lines.push(this.generateSchemaDescription(schema.name, schema.description));
+                lines.push('GO');
+                lines.push('');
+            }
+            // Table descriptions
+            for (const table of schema.tables) {
+                // Check filters
+                if (options.approvedOnly && !table.userApproved) {
+                    continue;
+                }
+                if (options.confidenceThreshold && table.descriptionIterations.length > 0) {
+                    const latest = table.descriptionIterations[table.descriptionIterations.length - 1];
+                    if ((latest.confidence || 0) < options.confidenceThreshold) {
+                        continue;
+                    }
+                }
+                // Table description
+                if (table.description) {
+                    lines.push(`-- Table: ${schema.name}.${table.name}`);
+                    lines.push(this.generateTableDescription(schema.name, table.name, table.description));
+                    lines.push('GO');
+                    lines.push('');
+                }
+                // Column descriptions
+                for (const column of table.columns) {
+                    if (column.description) {
+                        lines.push(this.generateColumnDescription(schema.name, table.name, column.name, column.description));
+                        lines.push('GO');
+                    }
+                }
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate schema description statement
+     */
+    generateSchemaDescription(schemaName, description) {
+        const escapedDescription = this.escapeString(description);
+        return `
+IF EXISTS (
+    SELECT 1 FROM sys.extended_properties
+    WHERE major_id = SCHEMA_ID('${schemaName}')
+    AND name = 'MS_Description'
+    AND minor_id = 0
+)
+BEGIN
+    EXEC sp_dropextendedproperty
+        @name = N'MS_Description',
+        @level0type = N'SCHEMA',
+        @level0name = N'${schemaName}';
+END
+
+EXEC sp_addextendedproperty
+    @name = N'MS_Description',
+    @value = N'${escapedDescription}',
+    @level0type = N'SCHEMA',
+    @level0name = N'${schemaName}';
+`.trim();
+    }
+    /**
+     * Generate table description statement
+     */
+    generateTableDescription(schemaName, tableName, description) {
+        const escapedDescription = this.escapeString(description);
+        return `
+IF EXISTS (
+    SELECT 1 FROM sys.extended_properties ep
+    INNER JOIN sys.tables t ON ep.major_id = t.object_id
+    INNER JOIN sys.schemas s ON t.schema_id = s.schema_id
+    WHERE s.name = '${schemaName}'
+    AND t.name = '${tableName}'
+    AND ep.name = 'MS_Description'
+    AND ep.minor_id = 0
+)
+BEGIN
+    EXEC sp_dropextendedproperty
+        @name = N'MS_Description',
+        @level0type = N'SCHEMA',
+        @level0name = N'${schemaName}',
+        @level1type = N'TABLE',
+        @level1name = N'${tableName}';
+END
+
+EXEC sp_addextendedproperty
+    @name = N'MS_Description',
+    @value = N'${escapedDescription}',
+    @level0type = N'SCHEMA',
+    @level0name = N'${schemaName}',
+    @level1type = N'TABLE',
+    @level1name = N'${tableName}';
+`.trim();
+    }
+    /**
+     * Generate column description statement
+     */
+    generateColumnDescription(schemaName, tableName, columnName, description) {
+        const escapedDescription = this.escapeString(description);
+        return `
+IF EXISTS (
+    SELECT 1 FROM sys.extended_properties ep
+    INNER JOIN sys.tables t ON ep.major_id = t.object_id
+    INNER JOIN sys.schemas s ON t.schema_id = s.schema_id
+    INNER JOIN sys.columns c ON ep.major_id = c.object_id AND ep.minor_id = c.column_id
+    WHERE s.name = '${schemaName}'
+    AND t.name = '${tableName}'
+    AND c.name = '${columnName}'
+    AND ep.name = 'MS_Description'
+)
+BEGIN
+    EXEC sp_dropextendedproperty
+        @name = N'MS_Description',
+        @level0type = N'SCHEMA',
+        @level0name = N'${schemaName}',
+        @level1type = N'TABLE',
+        @level1name = N'${tableName}',
+        @level2type = N'COLUMN',
+        @level2name = N'${columnName}';
+END
+
+EXEC sp_addextendedproperty
+    @name = N'MS_Description',
+    @value = N'${escapedDescription}',
+    @level0type = N'SCHEMA',
+    @level0name = N'${schemaName}',
+    @level1type = N'TABLE',
+    @level1name = N'${tableName}',
+    @level2type = N'COLUMN',
+    @level2name = N'${columnName}';
+`.trim();
+    }
+    /**
+     * Escape string for SQL
+     */
+    escapeString(str) {
+        return str.replace(/'/g, "''");
+    }
+}
+exports.SQLGenerator = SQLGenerator;
+//# sourceMappingURL=SQLGenerator.js.map

package/dist/generators/SQLGenerator.js.map

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

package/dist/generators/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Exports for generators module
+ */
+export { SQLGenerator, SQLGeneratorOptions } from './SQLGenerator.js';
+export { MarkdownGenerator } from './MarkdownGenerator.js';
+export { ReportGenerator } from './ReportGenerator.js';
+export { HTMLGenerator, HTMLGeneratorOptions } from './HTMLGenerator.js';
+export { CSVGenerator, CSVGeneratorOptions, CSVExport } from './CSVGenerator.js';
+export { MermaidGenerator, MermaidGeneratorOptions } from './MermaidGenerator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/generators/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Exports for generators module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MermaidGenerator = exports.CSVGenerator = exports.HTMLGenerator = exports.ReportGenerator = exports.MarkdownGenerator = exports.SQLGenerator = void 0;
+var SQLGenerator_js_1 = require("./SQLGenerator.js");
+Object.defineProperty(exports, "SQLGenerator", { enumerable: true, get: function () { return SQLGenerator_js_1.SQLGenerator; } });
+var MarkdownGenerator_js_1 = require("./MarkdownGenerator.js");
+Object.defineProperty(exports, "MarkdownGenerator", { enumerable: true, get: function () { return MarkdownGenerator_js_1.MarkdownGenerator; } });
+var ReportGenerator_js_1 = require("./ReportGenerator.js");
+Object.defineProperty(exports, "ReportGenerator", { enumerable: true, get: function () { return ReportGenerator_js_1.ReportGenerator; } });
+var HTMLGenerator_js_1 = require("./HTMLGenerator.js");
+Object.defineProperty(exports, "HTMLGenerator", { enumerable: true, get: function () { return HTMLGenerator_js_1.HTMLGenerator; } });
+var CSVGenerator_js_1 = require("./CSVGenerator.js");
+Object.defineProperty(exports, "CSVGenerator", { enumerable: true, get: function () { return CSVGenerator_js_1.CSVGenerator; } });
+var MermaidGenerator_js_1 = require("./MermaidGenerator.js");
+Object.defineProperty(exports, "MermaidGenerator", { enumerable: true, get: function () { return MermaidGenerator_js_1.MermaidGenerator; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAsE;AAA7D,+GAAA,YAAY,OAAA;AACrB,+DAA2D;AAAlD,yHAAA,iBAAiB,OAAA;AAC1B,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,uDAAyE;AAAhE,iHAAA,aAAa,OAAA;AACtB,qDAAiF;AAAxE,+GAAA,YAAY,OAAA;AACrB,6DAAkF;AAAzE,uHAAA,gBAAgB,OAAA"}

package/dist/index.d.ts

@@ -1,23 +1,14 @@
 /**
- * @memberjunction/db-auto-doc - SQL Server Database Auto-Documentation
- *
- * AI-powered documentation generator for SQL Server databases.
- * Works standalone - no MemberJunction runtime required.
- *
- * Use via CLI:
- *   db-auto-doc init
- *   db-auto-doc analyze --interactive
- *   db-auto-doc review
- *   db-auto-doc export --format=sql
- *
- * Or programmatically:
+ * DBAutoDoc - AI-powered SQL Server database documentation generator
+ * Main exports for programmatic use
  */
-export * from './types/state-file';
-export * from './database/connection';
-export * from './database/introspection';
-export * from './state/state-manager';
-export * from './ai/simple-ai-client';
-export * from './analyzers/analyzer';
-export * from './generators/sql-generator';
-export * from './generators/markdown-generator';
+export * from './api/index.js';
+export * from './types/index.js';
+export * from './database/index.js';
+export * from './prompts/index.js';
+export * from './state/index.js';
+export * from './core/index.js';
+export * from './core/AnalysisOrchestrator.js';
+export * from './generators/index.js';
+export * from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,17 +1,7 @@
 "use strict";
 /**
- * @memberjunction/db-auto-doc - SQL Server Database Auto-Documentation
- *
- * AI-powered documentation generator for SQL Server databases.
- * Works standalone - no MemberJunction runtime required.
- *
- * Use via CLI:
- *   db-auto-doc init
- *   db-auto-doc analyze --interactive
- *   db-auto-doc review
- *   db-auto-doc export --format=sql
- *
- * Or programmatically:
+ * DBAutoDoc - AI-powered SQL Server database documentation generator
+ * Main exports for programmatic use
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -28,12 +18,21 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types/state-file"), exports);
-__exportStar(require("./database/connection"), exports);
-__exportStar(require("./database/introspection"), exports);
-__exportStar(require("./state/state-manager"), exports);
-__exportStar(require("./ai/simple-ai-client"), exports);
-__exportStar(require("./analyzers/analyzer"), exports);
-__exportStar(require("./generators/sql-generator"), exports);
-__exportStar(require("./generators/markdown-generator"), exports);
+// Programmatic API (primary entry point for library usage)
+__exportStar(require("./api/index.js"), exports);
+// Core types
+__exportStar(require("./types/index.js"), exports);
+// Database layer
+__exportStar(require("./database/index.js"), exports);
+// Prompts
+__exportStar(require("./prompts/index.js"), exports);
+// State management
+__exportStar(require("./state/index.js"), exports);
+// Analysis engine
+__exportStar(require("./core/index.js"), exports);
+__exportStar(require("./core/AnalysisOrchestrator.js"), exports);
+// Generators
+__exportStar(require("./generators/index.js"), exports);
+// Utilities
+__exportStar(require("./utils/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;AAEH,qDAAmC;AACnC,wDAAsC;AACtC,2DAAyC;AACzC,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AACrC,6DAA2C;AAC3C,kEAAgD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,2DAA2D;AAC3D,iDAA+B;AAE/B,aAAa;AACb,mDAAiC;AAEjC,iBAAiB;AACjB,sDAAoC;AAEpC,UAAU;AACV,qDAAmC;AAEnC,mBAAmB;AACnB,mDAAiC;AAEjC,kBAAkB;AAClB,kDAAgC;AAChC,iEAA+C;AAE/C,aAAa;AACb,wDAAsC;AAEtC,YAAY;AACZ,mDAAiC"}

package/dist/prompts/PromptEngine.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Prompt execution engine combining Nunjucks templating with AI/Core
+ */
+import { AIConfig } from '../types/config.js';
+import { PromptExecutionResult } from '../types/prompts.js';
+export type GuardrailCheckFn = () => {
+    canContinue: boolean;
+    reason?: string;
+};
+export declare class PromptEngine {
+    private config;
+    private nunjucksEnv;
+    private llm;
+    private guardrailCheck?;
+    constructor(config: AIConfig, promptsDir: string);
+    /**
+     * Set guardrail checking callback
+     * This will be called before every LLM execution to check if we should continue
+     */
+    setGuardrailCheck(checkFn: GuardrailCheckFn): void;
+    /**
+     * Initialize the prompt loader
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create appropriate LLM based on provider configuration
+     * Uses MJ ClassFactory pattern for BaseLLM instantiation
+     */
+    private createLLM;
+    /**
+     * Add custom Nunjucks filters
+     * Pattern from Templates package
+     */
+    private addCustomFilters;
+    /**
+     * Render a Nunjucks template with context
+     * Pattern from Templates.renderTemplateAsync()
+     */
+    private renderTemplate;
+    /**
+     * Execute a prompt with AI/Core
+     * Main entry point for DBAutoDoc analysis
+     */
+    executePrompt<T>(promptName: string, context: any, options?: {
+        systemPrompt?: string;
+        temperature?: number;
+        maxTokens?: number;
+        responseFormat?: 'JSON' | 'Text';
+    }): Promise<PromptExecutionResult<T>>;
+    /**
+     * Execute multiple prompts in parallel
+     * Uses AI/Core's ChatCompletions for efficiency
+     */
+    executePromptsParallel<T>(requests: Array<{
+        promptName: string;
+        context: any;
+        options?: {
+            systemPrompt?: string;
+            temperature?: number;
+            maxTokens?: number;
+            responseFormat?: 'JSON' | 'Text';
+        };
+    }>): Promise<Array<PromptExecutionResult<T>>>;
+}
+//# sourceMappingURL=PromptEngine.d.ts.map

package/dist/prompts/PromptEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptEngine.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptEngine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,MAAM;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,qBAAa,YAAY;IAMrB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,cAAc,CAAC,CAAmB;gBAGhC,MAAM,EAAE,QAAQ,EACxB,UAAU,EAAE,MAAM;IAgBpB;;;OAGG;IACI,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIzD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAkBjB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;;OAGG;YACW,cAAc;IAe5B;;;OAGG;IACU,aAAa,CAAC,CAAC,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAClC,GACA,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IA+FpC;;;OAGG;IACU,sBAAsB,CAAC,CAAC,EACnC,QAAQ,EAAE,KAAK,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC;QACb,OAAO,CAAC,EAAE;YACR,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;SAClC,CAAC;KACH,CAAC,GACD,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CAyD5C"}

package/dist/prompts/PromptEngine.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * Prompt execution engine combining Nunjucks templating with AI/Core
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptEngine = void 0;
+const nunjucks = __importStar(require("nunjucks"));
+const ai_1 = require("@memberjunction/ai");
+const global_1 = require("@memberjunction/global");
+const PromptFileLoader_js_1 = require("./PromptFileLoader.js");
+class PromptEngine {
+    constructor(config, promptsDir) {
+        this.config = config;
+        // Initialize Nunjucks with custom loader
+        const loader = new PromptFileLoader_js_1.PromptFileLoader(promptsDir);
+        this.nunjucksEnv = new nunjucks.Environment(loader, {
+            autoescape: false,
+            dev: true
+        });
+        // Add custom filters
+        this.addCustomFilters();
+        // Initialize AI/Core LLM
+        this.llm = this.createLLM();
+    }
+    /**
+     * Set guardrail checking callback
+     * This will be called before every LLM execution to check if we should continue
+     */
+    setGuardrailCheck(checkFn) {
+        this.guardrailCheck = checkFn;
+    }
+    /**
+     * Initialize the prompt loader
+     */
+    async initialize() {
+        const env = this.nunjucksEnv;
+        const loader = env.loaders?.[0];
+        if (loader) {
+            await loader.loadAll();
+        }
+    }
+    /**
+     * Create appropriate LLM based on provider configuration
+     * Uses MJ ClassFactory pattern for BaseLLM instantiation
+     */
+    createLLM() {
+        const { provider, apiKey } = this.config;
+        // Use MJ ClassFactory to create BaseLLM instance
+        // Provider maps to class key (e.g., 'OpenAILLM', 'AnthropicLLM', etc.)
+        const llm = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(ai_1.BaseLLM, provider, apiKey);
+        if (!llm) {
+            throw new Error(`Failed to create LLM instance for provider: ${provider}. Check that the provider name matches a registered BaseLLM subclass.`);
+        }
+        return llm;
+    }
+    /**
+     * Add custom Nunjucks filters
+     * Pattern from Templates package
+     */
+    addCustomFilters() {
+        // JSON formatting with indentation
+        this.nunjucksEnv.addFilter('json', (obj, indent = 2) => {
+            try {
+                return JSON.stringify(obj, null, indent);
+            }
+            catch (error) {
+                return `[Error serializing to JSON: ${error.message}]`;
+            }
+        });
+        // Compact JSON
+        this.nunjucksEnv.addFilter('jsoninline', (obj) => {
+            try {
+                return JSON.stringify(obj);
+            }
+            catch (error) {
+                return `[Error serializing to JSON: ${error.message}]`;
+            }
+        });
+        // Parse JSON strings
+        this.nunjucksEnv.addFilter('jsonparse', (str) => {
+            try {
+                return JSON.parse(str);
+            }
+            catch (error) {
+                return str;
+            }
+        });
+        // Array join filter
+        this.nunjucksEnv.addFilter('join', (arr, separator = ', ') => {
+            return Array.isArray(arr) ? arr.join(separator) : arr;
+        });
+    }
+    /**
+     * Render a Nunjucks template with context
+     * Pattern from Templates.renderTemplateAsync()
+     */
+    async renderTemplate(promptName, context) {
+        return new Promise((resolve, reject) => {
+            this.nunjucksEnv.render(promptName, context, (err, result) => {
+                if (err) {
+                    console.error(`[PromptEngine] FATAL: Template rendering failed for ${promptName}`);
+                    console.error(`[PromptEngine] Error:`, err.message);
+                    console.error(`[PromptEngine] Context keys:`, Object.keys(context));
+                    console.error(`[PromptEngine] Terminating process due to template rendering failure`);
+                    process.exit(1);
+                }
+                resolve(result || '');
+            });
+        });
+    }
+    /**
+     * Execute a prompt with AI/Core
+     * Main entry point for DBAutoDoc analysis
+     */
+    async executePrompt(promptName, context, options) {
+        try {
+            // Check guardrails before executing
+            if (this.guardrailCheck) {
+                const check = this.guardrailCheck();
+                if (!check.canContinue) {
+                    return {
+                        success: false,
+                        errorMessage: `Guardrail limit exceeded: ${check.reason}`,
+                        tokensUsed: 0,
+                        guardrailExceeded: true
+                    };
+                }
+            }
+            // 1. Render Nunjucks template with context
+            const renderedPrompt = await this.renderTemplate(promptName, context);
+            // 2. Build ChatParams for AI/Core
+            const messages = [];
+            // Add system prompt if provided
+            if (options?.systemPrompt) {
+                messages.push({
+                    role: 'system',
+                    content: options.systemPrompt
+                });
+            }
+            // Add rendered user prompt
+            messages.push({
+                role: 'user',
+                content: renderedPrompt
+            });
+            const params = {
+                model: this.config.model,
+                messages,
+                temperature: options?.temperature ?? this.config.temperature ?? 0.1,
+                maxOutputTokens: options?.maxTokens ?? this.config.maxTokens,
+                responseFormat: options?.responseFormat ?? 'JSON',
+                ...(this.config.effortLevel != null && { effortLevel: this.config.effortLevel.toString() }) // Optional 1-100, BaseLLM drivers handle if supported
+            };
+            // 3. Execute with AI/Core (follows RunView pattern - doesn't throw)
+            const chatResult = await this.llm.ChatCompletion(params);
+            // 4. Check success (IMPORTANT: like RunView, check .success property)
+            if (!chatResult.success) {
+                return {
+                    success: false,
+                    errorMessage: chatResult.errorMessage || 'Unknown error',
+                    tokensUsed: 0
+                };
+            }
+            // 5. Extract result and parse JSON if needed
+            const content = chatResult.data.choices[0].message.content;
+            const usage = chatResult.data.usage;
+            let parsedResult;
+            if (options?.responseFormat === 'JSON') {
+                try {
+                    parsedResult = JSON.parse(content);
+                }
+                catch (parseError) {
+                    return {
+                        success: false,
+                        errorMessage: `Failed to parse JSON response: ${parseError.message}\n\nRaw content:\n${content}`,
+                        tokensUsed: usage?.totalTokens || 0,
+                        promptInput: renderedPrompt,
+                        promptOutput: content
+                    };
+                }
+            }
+            else {
+                parsedResult = content;
+            }
+            return {
+                success: true,
+                result: parsedResult,
+                tokensUsed: usage?.totalTokens || 0,
+                cost: usage?.cost,
+                promptInput: renderedPrompt,
+                promptOutput: content
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorMessage: `Prompt execution failed: ${error.message}`,
+                tokensUsed: 0
+            };
+        }
+    }
+    /**
+     * Execute multiple prompts in parallel
+     * Uses AI/Core's ChatCompletions for efficiency
+     */
+    async executePromptsParallel(requests) {
+        try {
+            // Render all templates first
+            const renderedPrompts = await Promise.all(requests.map(req => this.renderTemplate(req.promptName, req.context)));
+            // Build ChatParams array
+            const paramsArray = renderedPrompts.map((prompt, i) => ({
+                model: this.config.model,
+                messages: [{ role: 'user', content: prompt }],
+                temperature: requests[i].options?.temperature ?? this.config.temperature ?? 0.1,
+                maxOutputTokens: requests[i].options?.maxTokens ?? this.config.maxTokens,
+                responseFormat: requests[i].options?.responseFormat ?? 'JSON'
+            }));
+            // Execute in parallel using AI/Core
+            const results = await this.llm.ChatCompletions(paramsArray);
+            // Parse and return
+            return results.map((chatResult, i) => {
+                if (!chatResult.success) {
+                    return {
+                        success: false,
+                        errorMessage: chatResult.errorMessage,
+                        tokensUsed: 0
+                    };
+                }
+                const content = chatResult.data.choices[0].message.content;
+                const usage = chatResult.data.usage;
+                try {
+                    const parsed = JSON.parse(content);
+                    return {
+                        success: true,
+                        result: parsed,
+                        tokensUsed: usage?.totalTokens || 0,
+                        cost: usage?.cost
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        errorMessage: `JSON parse error: ${error.message}`,
+                        tokensUsed: usage?.totalTokens || 0
+                    };
+                }
+            });
+        }
+        catch (error) {
+            // If rendering or execution fails completely, return array of errors
+            return requests.map(() => ({
+                success: false,
+                errorMessage: `Parallel execution failed: ${error.message}`,
+                tokensUsed: 0
+            }));
+        }
+    }
+}
+exports.PromptEngine = PromptEngine;
+//# sourceMappingURL=PromptEngine.js.map