@corbat-tech/coding-standards-mcp 1.0.2 → 1.1.0

package/dist/metrics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Simple in-memory metrics for Corbat MCP.
+ * Tracks tool calls, profiles used, and errors.
+ */
+/**
+ * Record a tool call.
+ */
+export declare function recordToolCall(toolName: string): void;
+/**
+ * Record a profile being used.
+ */
+export declare function recordProfileUsed(profileId: string): void;
+/**
+ * Record a task type being processed.
+ */
+export declare function recordTaskType(taskType: string): void;
+/**
+ * Record an error.
+ */
+export declare function recordError(): void;
+/**
+ * Get current metrics with computed values.
+ */
+export declare function getMetrics(): {
+    toolCalls: Record<string, number>;
+    profilesUsed: Record<string, number>;
+    taskTypes: Record<string, number>;
+    errors: number;
+    uptimeMs: number;
+    uptimeFormatted: string;
+    totalToolCalls: number;
+    mostUsedTool: string | null;
+    mostUsedProfile: string | null;
+    mostCommonTaskType: string | null;
+};
+/**
+ * Reset all metrics (useful for testing).
+ */
+export declare function resetMetrics(): void;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAoCD;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAgBA;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC"}

package/dist/metrics.js

@@ -0,0 +1,97 @@
+/**
+ * Simple in-memory metrics for Corbat MCP.
+ * Tracks tool calls, profiles used, and errors.
+ */
+/**
+ * Global metrics state.
+ */
+const metrics = {
+    toolCalls: {},
+    profilesUsed: {},
+    taskTypes: {},
+    errors: 0,
+    startTime: Date.now(),
+};
+/**
+ * Record a tool call.
+ */
+export function recordToolCall(toolName) {
+    metrics.toolCalls[toolName] = (metrics.toolCalls[toolName] || 0) + 1;
+}
+/**
+ * Record a profile being used.
+ */
+export function recordProfileUsed(profileId) {
+    metrics.profilesUsed[profileId] = (metrics.profilesUsed[profileId] || 0) + 1;
+}
+/**
+ * Record a task type being processed.
+ */
+export function recordTaskType(taskType) {
+    metrics.taskTypes[taskType] = (metrics.taskTypes[taskType] || 0) + 1;
+}
+/**
+ * Record an error.
+ */
+export function recordError() {
+    metrics.errors++;
+}
+/**
+ * Get the most used item from a record.
+ */
+function getMostUsed(record) {
+    let maxKey = null;
+    let maxValue = 0;
+    for (const [key, value] of Object.entries(record)) {
+        if (value > maxValue) {
+            maxValue = value;
+            maxKey = key;
+        }
+    }
+    return maxKey;
+}
+/**
+ * Format duration in human-readable format.
+ */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Get current metrics with computed values.
+ */
+export function getMetrics() {
+    const uptimeMs = Date.now() - metrics.startTime;
+    const totalToolCalls = Object.values(metrics.toolCalls).reduce((a, b) => a + b, 0);
+    return {
+        toolCalls: { ...metrics.toolCalls },
+        profilesUsed: { ...metrics.profilesUsed },
+        taskTypes: { ...metrics.taskTypes },
+        errors: metrics.errors,
+        uptimeMs,
+        uptimeFormatted: formatDuration(uptimeMs),
+        totalToolCalls,
+        mostUsedTool: getMostUsed(metrics.toolCalls),
+        mostUsedProfile: getMostUsed(metrics.profilesUsed),
+        mostCommonTaskType: getMostUsed(metrics.taskTypes),
+    };
+}
+/**
+ * Reset all metrics (useful for testing).
+ */
+export function resetMetrics() {
+    metrics.toolCalls = {};
+    metrics.profilesUsed = {};
+    metrics.taskTypes = {};
+    metrics.errors = 0;
+    metrics.startTime = Date.now();
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/profiles.d.ts

@@ -21,7 +21,7 @@ export declare function listProfiles(): Promise<Array<{
     profile: Profile;
 }>>;
 /**
- * Load all standards from markdown files.
+ * Load all standards from markdown files (parallelized).
  */
 export declare function loadStandards(): Promise<StandardDocument[]>;
 /**

package/dist/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyB1G;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAqCD;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAG3E;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAGrF;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiBjE;AA4CD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIvD;AA8YD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBpF"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuG1G;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAqDD;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2ClE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAG3E;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAGrF;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgBjE;AAwDD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIvD;AAiaD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBpF"}

package/dist/profiles.js

@@ -1,4 +1,4 @@
-import { readFile, readdir, stat } from 'node:fs/promises';
+import { readdir, readFile, stat } from 'node:fs/promises';
 import { basename, join } from 'node:path';
 import { parse } from 'yaml';
 import { config } from './config.js';
@@ -8,6 +8,62 @@ import { DEFAULT_HEXAGONAL_LAYERS, ProfileSchema } from './types.js';
  * Set to 0 to disable cache expiration.
  */
 const CACHE_TTL_MS = 60_000;
+/**
+ * Deep merge two objects. Child values override parent values.
+ * Arrays are replaced, not merged.
+ */
+function deepMerge(parent, child) {
+    const result = { ...parent };
+    for (const key of Object.keys(child)) {
+        const childValue = child[key];
+        const parentValue = parent[key];
+        if (childValue === undefined) {
+            continue;
+        }
+        if (childValue !== null &&
+            typeof childValue === 'object' &&
+            !Array.isArray(childValue) &&
+            parentValue !== null &&
+            typeof parentValue === 'object' &&
+            !Array.isArray(parentValue)) {
+            // Recursively merge objects
+            result[key] = deepMerge(parentValue, childValue);
+        }
+        else {
+            // Replace value (including arrays)
+            result[key] = childValue;
+        }
+    }
+    return result;
+}
+/**
+ * Resolve profile inheritance chain.
+ * Returns a merged profile with all inherited properties.
+ */
+function resolveProfileInheritance(profile, allProfiles, visited = new Set()) {
+    const extendsId = profile.extends;
+    if (!extendsId) {
+        return profile;
+    }
+    // Prevent circular inheritance
+    if (visited.has(extendsId)) {
+        console.error(`Circular inheritance detected: ${extendsId}`);
+        return profile;
+    }
+    const parentProfile = allProfiles.get(extendsId);
+    if (!parentProfile) {
+        console.error(`Parent profile "${extendsId}" not found for inheritance`);
+        return profile;
+    }
+    visited.add(extendsId);
+    // Recursively resolve parent's inheritance first
+    const resolvedParent = resolveProfileInheritance(parentProfile, allProfiles, visited);
+    // Merge parent into child (child overrides parent)
+    const merged = deepMerge(resolvedParent, profile);
+    // Remove the 'extends' field from the merged result
+    delete merged.extends;
+    return merged;
+}
 /**
  * Cache for loaded profiles and standards.
  */
@@ -35,27 +91,43 @@ export function invalidateCache() {
     standardsCacheTime = null;
 }
 /**
- * Load profiles from a specific directory.
+ * Load a single profile from a YAML file.
+ */
+async function loadProfileFromFile(filePath) {
+    try {
+        const fileStat = await stat(filePath);
+        if (fileStat.isDirectory())
+            return null;
+        const content = await readFile(filePath, 'utf-8');
+        const rawData = parse(content);
+        const fileName = basename(filePath);
+        const profileId = basename(fileName, fileName.endsWith('.yaml') ? '.yaml' : '.yml');
+        const profile = ProfileSchema.parse(rawData);
+        // Apply default hexagonal layers if not specified
+        if (profile.architecture?.type === 'hexagonal' && !profile.architecture.layers) {
+            profile.architecture.layers = DEFAULT_HEXAGONAL_LAYERS;
+        }
+        return { id: profileId, profile };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load profiles from a specific directory (parallelized).
  */
 async function loadProfilesFromDir(dir, profiles) {
     try {
         const files = await readdir(dir);
         const yamlFiles = files.filter((f) => (f.endsWith('.yaml') || f.endsWith('.yml')) && !f.startsWith('_'));
-        for (const file of yamlFiles) {
-            const filePath = join(dir, file);
-            const fileStat = await stat(filePath);
-            // Skip directories
-            if (fileStat.isDirectory())
-                continue;
-            const content = await readFile(filePath, 'utf-8');
-            const rawData = parse(content);
-            const profileId = basename(file, file.endsWith('.yaml') ? '.yaml' : '.yml');
-            const profile = ProfileSchema.parse(rawData);
-            // Apply default hexagonal layers if not specified
-            if (profile.architecture?.type === 'hexagonal' && !profile.architecture.layers) {
-                profile.architecture.layers = DEFAULT_HEXAGONAL_LAYERS;
+        // Load all profiles in parallel
+        const loadPromises = yamlFiles.map((file) => loadProfileFromFile(join(dir, file)));
+        const results = await Promise.all(loadPromises);
+        // Add loaded profiles to the map
+        for (const result of results) {
+            if (result) {
+                profiles.set(result.id, result.profile);
             }
-            profiles.set(profileId, profile);
         }
     }
     catch (error) {
@@ -74,14 +146,35 @@ export async function loadProfiles() {
         return profilesCache;
     }
     profilesCache = new Map();
-    // Load from templates first (official profiles)
+    // Define directories to load from (in priority order - later overrides earlier)
     const templatesDir = join(config.profilesDir, 'templates');
-    await loadProfilesFromDir(templatesDir, profilesCache);
-    // Load from custom (user profiles - can override templates)
     const customDir = join(config.profilesDir, 'custom');
-    await loadProfilesFromDir(customDir, profilesCache);
-    // Fallback: also check root profiles dir for backwards compatibility
-    await loadProfilesFromDir(config.profilesDir, profilesCache);
+    // Create separate maps for each source
+    const templateProfiles = new Map();
+    const customProfiles = new Map();
+    const rootProfiles = new Map();
+    // Load all directories in parallel
+    await Promise.all([
+        loadProfilesFromDir(templatesDir, templateProfiles),
+        loadProfilesFromDir(customDir, customProfiles),
+        loadProfilesFromDir(config.profilesDir, rootProfiles),
+    ]);
+    // Merge in priority order: templates < root < custom
+    for (const [id, profile] of templateProfiles) {
+        profilesCache.set(id, profile);
+    }
+    for (const [id, profile] of rootProfiles) {
+        profilesCache.set(id, profile);
+    }
+    for (const [id, profile] of customProfiles) {
+        profilesCache.set(id, profile);
+    }
+    // Resolve inheritance for all profiles
+    const resolvedProfiles = new Map();
+    for (const [id, profile] of profilesCache) {
+        resolvedProfiles.set(id, resolveProfileInheritance(profile, profilesCache));
+    }
+    profilesCache = resolvedProfiles;
     profilesCacheTime = Date.now();
     return profilesCache;
 }
@@ -100,44 +193,54 @@ export async function listProfiles() {
     return Array.from(profiles.entries()).map(([id, profile]) => ({ id, profile }));
 }
 /**
- * Load all standards from markdown files.
+ * Load all standards from markdown files (parallelized).
  */
 export async function loadStandards() {
     if (standardsCache && isCacheValid(standardsCacheTime)) {
         return standardsCache;
     }
-    standardsCache = [];
     try {
-        await scanStandardsDirectory(config.standardsDir, '');
+        standardsCache = await scanStandardsDirectory(config.standardsDir, '');
     }
     catch (error) {
         if (error.code !== 'ENOENT') {
             throw error;
         }
+        standardsCache = [];
     }
     standardsCacheTime = Date.now();
     return standardsCache;
 }
 async function scanStandardsDirectory(dir, category) {
     const entries = await readdir(dir);
-    for (const entry of entries) {
+    const documents = [];
+    // Process all entries in parallel
+    const processEntry = async (entry) => {
         const fullPath = join(dir, entry);
         const stats = await stat(fullPath);
         if (stats.isDirectory()) {
-            await scanStandardsDirectory(fullPath, entry);
+            return scanStandardsDirectory(fullPath, entry);
         }
         else if (entry.endsWith('.md')) {
             const content = await readFile(fullPath, 'utf-8');
             const id = generateStandardId(fullPath);
             const name = extractStandardName(content, entry);
-            standardsCache?.push({
-                id,
-                name,
-                category: category || 'general',
-                content,
-            });
+            return [
+                {
+                    id,
+                    name,
+                    category: category || 'general',
+                    content,
+                },
+            ];
         }
+        return [];
+    };
+    const results = await Promise.all(entries.map(processEntry));
+    for (const result of results) {
+        documents.push(...result);
     }
+    return documents;
 }
 function generateStandardId(filePath) {
     return filePath
@@ -426,92 +529,120 @@ function formatObservabilitySection(profile) {
     }
     return lines;
 }
-function formatRemainingProfileSections(profile) {
-    const lines = [];
-    // API Documentation
-    if (profile.apiDocumentation?.enabled) {
-        lines.push('## API Documentation', '', `- Tool: ${profile.apiDocumentation.tool}`);
-        if (profile.apiDocumentation.version)
-            lines.push(`- Version: ${profile.apiDocumentation.version}`);
-        if (profile.apiDocumentation.requirements) {
-            lines.push('', '**Requirements:**', ...profile.apiDocumentation.requirements.map((r) => `- ${r}`));
-        }
-        if (profile.apiDocumentation.output) {
-            lines.push('', '**Output:**', ...profile.apiDocumentation.output.map((o) => `- ${o}`));
-        }
-        lines.push('');
+function formatApiDocSection(profile) {
+    if (!profile.apiDocumentation?.enabled)
+        return [];
+    const lines = ['## API Documentation', '', `- Tool: ${profile.apiDocumentation.tool}`];
+    if (profile.apiDocumentation.version)
+        lines.push(`- Version: ${profile.apiDocumentation.version}`);
+    if (profile.apiDocumentation.requirements) {
+        lines.push('', '**Requirements:**', ...profile.apiDocumentation.requirements.map((r) => `- ${r}`));
     }
-    // Security
-    if (profile.security) {
-        lines.push('## Security', '');
-        if (profile.security.authentication) {
-            lines.push(`- Authentication: ${profile.security.authentication.method || 'N/A'}`);
-        }
-        if (profile.security.authorization) {
-            lines.push(`- Authorization: ${profile.security.authorization.method || 'N/A'} (${profile.security.authorization.framework || 'N/A'})`);
-        }
-        if (profile.security.practices) {
-            lines.push('', '**Practices:**', ...profile.security.practices.map((p) => `- ${p}`));
-        }
-        lines.push('');
+    if (profile.apiDocumentation.output) {
+        lines.push('', '**Output:**', ...profile.apiDocumentation.output.map((o) => `- ${o}`));
     }
-    // Error Handling
-    if (profile.errorHandling) {
-        lines.push('## Error Handling', '', `- Format: ${profile.errorHandling.format}`);
-        if (profile.errorHandling.globalHandler)
-            lines.push(`- Global Handler: ${profile.errorHandling.globalHandler}`);
-        if (profile.errorHandling.customExceptions?.domain) {
-            lines.push('', '**Domain Exceptions:**', ...profile.errorHandling.customExceptions.domain.map((e) => `- ${e}`));
-        }
-        if (profile.errorHandling.customExceptions?.application) {
-            lines.push('', '**Application Exceptions:**', ...profile.errorHandling.customExceptions.application.map((e) => `- ${e}`));
-        }
-        lines.push('');
+    lines.push('');
+    return lines;
+}
+function formatSecuritySection(profile) {
+    if (!profile.security)
+        return [];
+    const lines = ['## Security', ''];
+    if (profile.security.authentication) {
+        lines.push(`- Authentication: ${profile.security.authentication.method || 'N/A'}`);
     }
-    // Database
-    if (profile.database) {
-        lines.push('## Database', '');
-        if (profile.database.migrations) {
-            lines.push(`- Migrations: ${profile.database.migrations.tool}`);
-            if (profile.database.migrations.naming)
-                lines.push(`- Naming: ${profile.database.migrations.naming}`);
-        }
-        if (profile.database.auditing?.enabled) {
-            lines.push(`- Auditing: enabled (fields: ${profile.database.auditing.fields?.join(', ') || 'N/A'})`);
-        }
-        if (profile.database.softDelete?.recommended) {
-            lines.push(`- Soft Delete: recommended (field: ${profile.database.softDelete.field || 'deletedAt'})`);
-        }
-        lines.push('');
+    if (profile.security.authorization) {
+        lines.push(`- Authorization: ${profile.security.authorization.method || 'N/A'} (${profile.security.authorization.framework || 'N/A'})`);
     }
-    // Mapping
-    if (profile.mapping) {
-        lines.push('## Object Mapping', '', `- Tool: ${profile.mapping.tool}`);
-        if (profile.mapping.componentModel)
-            lines.push(`- Component Model: ${profile.mapping.componentModel}`);
-        if (profile.mapping.patterns) {
-            lines.push('', '**Patterns:**', ...profile.mapping.patterns.map((p) => `- ${p}`));
-        }
-        lines.push('');
+    if (profile.security.practices) {
+        lines.push('', '**Practices:**', ...profile.security.practices.map((p) => `- ${p}`));
+    }
+    lines.push('');
+    return lines;
+}
+function formatErrorHandlingSection(profile) {
+    if (!profile.errorHandling)
+        return [];
+    const lines = ['## Error Handling', '', `- Format: ${profile.errorHandling.format}`];
+    if (profile.errorHandling.globalHandler)
+        lines.push(`- Global Handler: ${profile.errorHandling.globalHandler}`);
+    if (profile.errorHandling.customExceptions?.domain) {
+        lines.push('', '**Domain Exceptions:**', ...profile.errorHandling.customExceptions.domain.map((e) => `- ${e}`));
+    }
+    if (profile.errorHandling.customExceptions?.application) {
+        lines.push('', '**Application Exceptions:**', ...profile.errorHandling.customExceptions.application.map((e) => `- ${e}`));
+    }
+    lines.push('');
+    return lines;
+}
+function formatDatabaseSection(profile) {
+    if (!profile.database || Object.keys(profile.database).length === 0)
+        return [];
+    const lines = ['## Database', ''];
+    const db = profile.database;
+    const migrations = db.migrations;
+    const auditing = db.auditing;
+    const softDelete = db.softDelete;
+    if (migrations) {
+        if (migrations.tool)
+            lines.push(`- Migrations: ${migrations.tool}`);
+        if (migrations.naming)
+            lines.push(`- Naming: ${migrations.naming}`);
+    }
+    if (auditing?.enabled) {
+        const fields = auditing.fields;
+        lines.push(`- Auditing: enabled (fields: ${fields?.join(', ') || 'N/A'})`);
+    }
+    if (softDelete?.recommended) {
+        lines.push(`- Soft Delete: recommended (field: ${softDelete.field || 'deletedAt'})`);
+    }
+    if (db.orm)
+        lines.push(`- ORM: ${db.orm}`);
+    if (db.driver)
+        lines.push(`- Driver: ${db.driver}`);
+    lines.push('');
+    return lines;
+}
+function formatMappingSection(profile) {
+    if (!profile.mapping)
+        return [];
+    const lines = ['## Object Mapping', '', `- Tool: ${profile.mapping.tool}`];
+    if (profile.mapping.componentModel)
+        lines.push(`- Component Model: ${profile.mapping.componentModel}`);
+    if (profile.mapping.patterns) {
+        lines.push('', '**Patterns:**', ...profile.mapping.patterns.map((p) => `- ${p}`));
     }
-    // Technologies
-    if (profile.technologies?.length) {
-        lines.push('## Technologies', '');
-        for (const tech of profile.technologies) {
-            lines.push(`### ${tech.name}${tech.version ? ` (${tech.version})` : ''}`);
-            if (tech.tool)
-                lines.push(`Tool: ${tech.tool}`);
-            if (tech.specificRules && Object.keys(tech.specificRules).length > 0) {
-                lines.push('**Rules:**');
-                for (const [key, value] of Object.entries(tech.specificRules)) {
-                    lines.push(`- ${key}: ${value}`);
-                }
+    lines.push('');
+    return lines;
+}
+function formatTechnologiesSection(profile) {
+    if (!profile.technologies?.length)
+        return [];
+    const lines = ['## Technologies', ''];
+    for (const tech of profile.technologies) {
+        lines.push(`### ${tech.name}${tech.version ? ` (${tech.version})` : ''}`);
+        if (tech.tool)
+            lines.push(`Tool: ${tech.tool}`);
+        if (tech.specificRules && Object.keys(tech.specificRules).length > 0) {
+            lines.push('**Rules:**');
+            for (const [key, value] of Object.entries(tech.specificRules)) {
+                lines.push(`- ${key}: ${value}`);
             }
-            lines.push('');
         }
+        lines.push('');
     }
     return lines;
 }
+function formatRemainingProfileSections(profile) {
+    return [
+        ...formatApiDocSection(profile),
+        ...formatSecuritySection(profile),
+        ...formatErrorHandlingSection(profile),
+        ...formatDatabaseSection(profile),
+        ...formatMappingSection(profile),
+        ...formatTechnologiesSection(profile),
+    ];
+}
 /**
  * Format a profile as markdown for LLM context.
  */