@npm7381/agent-doc-generator 1.0.0

package/dist/src/cache.d.ts

@@ -0,0 +1,7 @@
+import type { CacheStore } from './types.js';
+export declare function loadCache(projectRoot: string): CacheStore;
+export declare function saveCache(projectRoot: string, cache: CacheStore): void;
+export declare function computeFileHash(filePath: string): string;
+export declare function isFileCached(filePath: string, cache: CacheStore, currentHash: string): boolean;
+export declare function updateCache(filePath: string, docPath: string, hash: string, cache: CacheStore, content?: string): CacheStore;
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAWzD;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAQtE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAIT;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,CAQZ"}

package/dist/src/cache.js

@@ -0,0 +1,50 @@
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+const CACHE_FILE = '.doc-cache.json';
+function getCachePath(projectRoot) {
+    return path.join(projectRoot, CACHE_FILE);
+}
+export function loadCache(projectRoot) {
+    const cachePath = getCachePath(projectRoot);
+    try {
+        if (fs.existsSync(cachePath)) {
+            const data = fs.readFileSync(cachePath, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Corrupted cache, start fresh
+    }
+    return {};
+}
+export function saveCache(projectRoot, cache) {
+    const cachePath = getCachePath(projectRoot);
+    try {
+        fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch (err) {
+        const error = err;
+        console.warn(`[WARN] Could not save cache: ${error.message}`);
+    }
+}
+export function computeFileHash(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return crypto.createHash('md5').update(content).digest('hex');
+}
+export function isFileCached(filePath, cache, currentHash) {
+    const entry = cache[filePath];
+    if (!entry)
+        return false;
+    return entry.hash === currentHash;
+}
+export function updateCache(filePath, docPath, hash, cache, content) {
+    cache[filePath] = {
+        hash,
+        docPath,
+        content,
+        timestamp: Date.now(),
+    };
+    return cache;
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,SAAS,YAAY,CAAC,WAAmB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,KAAiB;IAC9D,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAY,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,KAAiB,EACjB,WAAmB;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,OAAe,EACf,IAAY,EACZ,KAAiB,EACjB,OAAgB;IAEhB,KAAK,CAAC,QAAQ,CAAC,GAAG;QAChB,IAAI;QACJ,OAAO;QACP,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/configLoader.d.ts

@@ -0,0 +1,15 @@
+export interface RCConfig {
+    provider?: string;
+    model?: string;
+    baseUrl?: string;
+    maxChars?: number;
+    extensions?: string[];
+    format?: string;
+    output?: string;
+    split?: boolean;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export declare function loadConfigFile(projectRoot: string): RCConfig | null;
+export declare function mergeConfig<T>(cliValue: T | undefined, configValue: T | undefined, defaultValue: T): T;
+//# sourceMappingURL=configLoader.d.ts.map

package/dist/src/configLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.d.ts","sourceRoot":"","sources":["../../src/configLoader.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAWnE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAItG"}

package/dist/src/configLoader.js

@@ -0,0 +1,26 @@
+import fs from 'fs';
+import path from 'path';
+const CONFIG_FILE = '.aiconfig.json';
+export function loadConfigFile(projectRoot) {
+    const configPath = path.join(projectRoot, CONFIG_FILE);
+    try {
+        if (!fs.existsSync(configPath))
+            return null;
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(raw);
+        if (typeof config !== 'object' || config === null)
+            return null;
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+export function mergeConfig(cliValue, configValue, defaultValue) {
+    if (cliValue !== undefined)
+        return cliValue;
+    if (configValue !== undefined)
+        return configValue;
+    return defaultValue;
+}
+//# sourceMappingURL=configLoader.js.map

package/dist/src/configLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.js","sourceRoot":"","sources":["../../src/configLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAexB,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,QAAuB,EAAE,WAA0B,EAAE,YAAe;IACjG,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAClD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/src/docGenerator.d.ts

@@ -0,0 +1,7 @@
+import { createAIClient, GeminiClient, OpenAIClient, AnthropicClient, DeepSeekClient, OllamaClient } from './aiClient.js';
+import type { AIClient } from './aiClient.js';
+export { createAIClient, GeminiClient, OpenAIClient, AnthropicClient, DeepSeekClient, OllamaClient };
+export type { AIClient };
+export declare function generateDocumentation(ai: AIClient | null, filePath: string, content: string, verbose?: boolean, model?: string, maxChars?: number): Promise<string | null>;
+export declare function extractDocContent(rawText: string | null | undefined): string;
+//# sourceMappingURL=docGenerator.d.ts.map

package/dist/src/docGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docGenerator.d.ts","sourceRoot":"","sources":["../../src/docGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AACrG,YAAY,EAAE,QAAQ,EAAE,CAAC;AAOzB,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,GAAG,IAAI,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,EACxB,KAAK,GAAE,MAAsB,EAC7B,QAAQ,GAAE,MAAuB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyDxB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS5E"}

package/dist/src/docGenerator.js

@@ -0,0 +1,68 @@
+import { getFileTypePrompt } from './prompts.js';
+import { createAIClient, GeminiClient, OpenAIClient, AnthropicClient, DeepSeekClient, OllamaClient } from './aiClient.js';
+export { createAIClient, GeminiClient, OpenAIClient, AnthropicClient, DeepSeekClient, OllamaClient };
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 2000;
+const MAX_FILE_CHARS = 15000;
+const DEFAULT_MODEL = 'gemini-2.5-flash';
+export async function generateDocumentation(ai, filePath, content, verbose = false, model = DEFAULT_MODEL, maxChars = MAX_FILE_CHARS) {
+    if (!ai) {
+        console.error('[ERROR] AI model not initialized. Skipping documentation generation.');
+        return null;
+    }
+    if (content.length > maxChars) {
+        console.warn(`[WARN] ${filePath}: ${content.length} chars truncado a ${maxChars}.`);
+    }
+    const trimmedContent = content.length > maxChars
+        ? content.slice(0, maxChars) + '\n// ... [truncated]'
+        : content;
+    const promptTemplate = getFileTypePrompt(filePath, trimmedContent);
+    const prompt = promptTemplate.replace('{CODE}', trimmedContent);
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            if (verbose) {
+                console.log(`[INFO] Generating documentation (attempt ${attempt}/${MAX_RETRIES})...`);
+            }
+            const text = await ai.generate(prompt, model);
+            if (!text || text.trim().length === 0) {
+                throw new Error('Empty response from AI provider');
+            }
+            if (verbose)
+                console.log('[INFO] Documentation generated successfully.');
+            return text;
+        }
+        catch (err) {
+            const error = err;
+            const isRateLimit = error.message?.includes('429') || error.message?.includes('RESOURCE_EXHAUSTED');
+            const isQuota = error.message?.includes('quota') || error.message?.includes('quotaExceeded');
+            if (isRateLimit || isQuota) {
+                const waitMs = RETRY_DELAY_MS * attempt;
+                console.warn(`[WARN] API rate limit hit. Retrying in ${waitMs / 1000}s... (attempt ${attempt}/${MAX_RETRIES})`);
+                await sleep(waitMs);
+                continue;
+            }
+            if (attempt < MAX_RETRIES) {
+                console.warn(`[WARN] Attempt ${attempt} failed: ${error.message}. Retrying...`);
+                await sleep(RETRY_DELAY_MS);
+                continue;
+            }
+            console.error(`[ERROR] All ${MAX_RETRIES} attempts failed for ${filePath}:`);
+            console.error(`  ${error.message}`);
+            return null;
+        }
+    }
+    return null;
+}
+export function extractDocContent(rawText) {
+    if (!rawText)
+        return '';
+    const codeBlockMatch = rawText.match(/```[\w]*\n([\s\S]*?)```/);
+    if (codeBlockMatch) {
+        return codeBlockMatch[1].trim();
+    }
+    return rawText.trim();
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=docGenerator.js.map

package/dist/src/docGenerator.js.map

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

package/dist/src/fileProcessor.d.ts

@@ -0,0 +1,10 @@
+import type { FileData } from './types.js';
+export declare function collectFiles(targetPath: string, verbose?: boolean, extensions?: string[]): string[];
+export declare function readFile(filePath: string): FileData | null;
+export declare function writeDocFile(originalFilePath: string, content: string, outputDir?: string): string | null;
+export declare function writeSingleDocFile(targetDir: string, entries: {
+    relativePath: string;
+    content: string;
+}[]): string | null;
+export declare function shouldSkipContent(content: string): boolean;
+//# sourceMappingURL=fileProcessor.d.ts.map

package/dist/src/fileProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileProcessor.d.ts","sourceRoot":"","sources":["../../src/fileProcessor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAqB1G;AAkCD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAU1D;AAED,wBAAgB,YAAY,CAC1B,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAkBf;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GACnD,MAAM,GAAG,IAAI,CAmBf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1D"}

package/dist/src/fileProcessor.js

@@ -0,0 +1,115 @@
+import fs from 'fs';
+import path from 'path';
+const DEFAULT_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.prisma']);
+const IGNORED_DIRS = new Set([
+    'node_modules', '.next', 'dist', 'build', '.git',
+    '.cache', 'coverage', '.turbo', '__pycache__',
+]);
+export function collectFiles(targetPath, verbose = false, extensions) {
+    const resolvedPath = path.resolve(targetPath);
+    const stats = fs.statSync(resolvedPath);
+    const validExts = extensions ? new Set(extensions.map(e => e.startsWith('.') ? e : `.${e}`)) : DEFAULT_EXTENSIONS;
+    if (stats.isFile()) {
+        if (!isValidExtension(resolvedPath, validExts)) {
+            console.warn(`[WARN] Skipping unsupported file type: ${resolvedPath}`);
+            return [];
+        }
+        if (verbose)
+            console.log(`[INFO] Processing single file: ${resolvedPath}`);
+        return [resolvedPath];
+    }
+    if (stats.isDirectory()) {
+        if (verbose)
+            console.log(`[INFO] Scanning directory: ${resolvedPath}`);
+        return collectDirRecursive(resolvedPath, verbose, validExts);
+    }
+    console.error(`[ERROR] Path is neither file nor directory: ${resolvedPath}`);
+    return [];
+}
+function collectDirRecursive(dirPath, verbose, validExts) {
+    const files = [];
+    try {
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORED_DIRS.has(entry.name)) {
+                    if (verbose)
+                        console.log(`[INFO] Skipping directory: ${entry.name}`);
+                    continue;
+                }
+                files.push(...collectDirRecursive(fullPath, verbose, validExts));
+            }
+            else if (entry.isFile() && isValidExtension(fullPath, validExts)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    catch (err) {
+        const error = err;
+        console.error(`[ERROR] Cannot read directory ${dirPath}: ${error.message}`);
+    }
+    return files;
+}
+function isValidExtension(filePath, validExts) {
+    const ext = path.extname(filePath).toLowerCase();
+    return validExts.has(ext);
+}
+export function readFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const relativePath = path.relative(process.cwd(), filePath);
+        return { filePath, relativePath, content };
+    }
+    catch (err) {
+        const error = err;
+        console.error(`[ERROR] Cannot read file ${filePath}: ${error.message}`);
+        return null;
+    }
+}
+export function writeDocFile(originalFilePath, content, outputDir) {
+    try {
+        const dir = outputDir || path.dirname(originalFilePath);
+        const baseName = path.basename(originalFilePath, path.extname(originalFilePath));
+        const docFileName = `${baseName}.docs.md`;
+        const docFilePath = path.join(dir, docFileName);
+        if (outputDir) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(docFilePath, content, 'utf-8');
+        return docFilePath;
+    }
+    catch (err) {
+        const error = err;
+        console.error(`[ERROR] Cannot write documentation file: ${error.message}`);
+        return null;
+    }
+}
+export function writeSingleDocFile(targetDir, entries) {
+    try {
+        const docPath = path.join(targetDir, 'DOCS.md');
+        const lines = ['# Documentación del Proyecto', '', `Generado: ${new Date().toLocaleDateString('es-AR')}`, '', '---', ''];
+        for (const entry of entries) {
+            lines.push(`## ${entry.relativePath}`, '');
+            lines.push(entry.content);
+            lines.push('');
+            lines.push('---', '');
+        }
+        fs.writeFileSync(docPath, lines.join('\n'), 'utf-8');
+        return docPath;
+    }
+    catch (err) {
+        const error = err;
+        console.error(`[ERROR] Cannot write documentation file: ${error.message}`);
+        return null;
+    }
+}
+export function shouldSkipContent(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return true;
+    if (trimmed.startsWith('// @ts-nocheck') && trimmed.length < 50)
+        return true;
+    return false;
+}
+//# sourceMappingURL=fileProcessor.js.map

package/dist/src/fileProcessor.js.map

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

package/dist/src/htmlFormatter.d.ts

@@ -0,0 +1,2 @@
+export declare function generateHtmlFromContent(content: string, title: string, agentName: string): string;
+//# sourceMappingURL=htmlFormatter.d.ts.map

package/dist/src/htmlFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlFormatter.d.ts","sourceRoot":"","sources":["../../src/htmlFormatter.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8CjG"}

package/dist/src/htmlFormatter.js

@@ -0,0 +1,54 @@
+export function generateHtmlFromContent(content, title, agentName) {
+    return `<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: #1a1a2e; background: #f5f6fa; padding: 2rem; }
+    .container { max-width: 900px; margin: 0 auto; }
+    header { background: linear-gradient(135deg, #1a1a2e, #16213e); color: #fff; padding: 2rem; border-radius: 12px; margin-bottom: 2rem; }
+    header h1 { font-size: 1.8rem; margin-bottom: .5rem; }
+    .content { background: #fff; border-radius: 10px; box-shadow: 0 2px 8px rgba(0,0,0,.06); padding: 2rem; line-height: 1.7; }
+    .content pre { background: #1a1a2e; color: #e2e8f0; padding: 1rem; border-radius: 8px; overflow-x: auto; font-size: .85rem; }
+    .content code { font-family: 'Fira Code', 'SF Mono', Consolas, monospace; background: #edf2f7; padding: .15rem .3rem; border-radius: 4px; font-size: .9em; }
+    .content pre code { background: transparent; padding: 0; }
+    .content h1 { font-size: 1.5rem; margin: 1.5rem 0 .75rem; color: #2d3748; }
+    .content h2 { font-size: 1.25rem; margin: 1.25rem 0 .5rem; color: #2d3748; }
+    .content p { margin-bottom: .75rem; color: #4a5568; }
+    .content ul, .content ol { margin: .5rem 0 .75rem 1.5rem; color: #4a5568; }
+    .content table { width: 100%; border-collapse: collapse; margin: 1rem 0; }
+    .content th, .content td { border: 1px solid #e2e8f0; padding: .5rem; text-align: left; }
+    .content th { background: #edf2f7; font-weight: 600; }
+    footer { text-align: center; color: #a0aec0; font-size: .8rem; margin-top: 2rem; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>${title}</h1>
+      <p class="meta">Generado: ${new Date().toLocaleString('es-AR')} • ${agentName}</p>
+    </header>
+    <div class="content">${content.split('\n').map(line => {
+        if (line.startsWith('# '))
+            return `<h1>${line.slice(2)}</h1>`;
+        if (line.startsWith('## '))
+            return `<h2>${line.slice(3)}</h2>`;
+        if (line.startsWith('### '))
+            return `<h3>${line.slice(4)}</h3>`;
+        if (line.startsWith('- '))
+            return `<li>${line.slice(2)}</li>`;
+        if (line.startsWith('|'))
+            return line;
+        if (line.trim() === '')
+            return '<br>';
+        return `<p>${line}</p>`;
+    }).join('\n')}</div>
+    <footer>${agentName} • AI Agent Toolkit</footer>
+  </div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=htmlFormatter.js.map

package/dist/src/htmlFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlFormatter.js","sourceRoot":"","sources":["../../src/htmlFormatter.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,KAAa,EAAE,SAAiB;IACvF,OAAO;;;;;WAKE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;YAwBJ,KAAK;kCACiB,IAAI,IAAI,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,SAAS;;2BAExD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACpD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/D,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAChE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,MAAM,CAAC;QACtC,OAAO,MAAM,IAAI,MAAM,CAAC;IAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;cACH,SAAS;;;QAGf,CAAC;AACT,CAAC"}

package/dist/src/pdfFormatter.d.ts

@@ -0,0 +1,2 @@
+export declare function generatePdfFromContent(content: string, outputPath: string, title: string, agentName: string): Promise<void>;
+//# sourceMappingURL=pdfFormatter.d.ts.map

package/dist/src/pdfFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfFormatter.d.ts","sourceRoot":"","sources":["../../src/pdfFormatter.ts"],"names":[],"mappings":"AAGA,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCjI"}

package/dist/src/pdfFormatter.js

@@ -0,0 +1,44 @@
+import PDFDocument from 'pdfkit';
+import fs from 'fs';
+export async function generatePdfFromContent(content, outputPath, title, agentName) {
+    const doc = new PDFDocument({ margin: 50, size: 'A4' });
+    const stream = fs.createWriteStream(outputPath);
+    doc.pipe(stream);
+    doc.fontSize(20).font('Helvetica-Bold').text(title, { align: 'center' });
+    doc.fontSize(11).font('Helvetica').text(`Generado: ${new Date().toLocaleString('es-AR')} • ${agentName}`, { align: 'center' });
+    doc.moveDown(1.5);
+    const lines = content.split('\n');
+    for (const line of lines) {
+        if (doc.y > 750)
+            doc.addPage();
+        if (line.startsWith('# ')) {
+            doc.fontSize(16).font('Helvetica-Bold').text(line.slice(2), { indent: 0 });
+        }
+        else if (line.startsWith('## ')) {
+            doc.fontSize(13).font('Helvetica-Bold').text(line.slice(3), { indent: 0 });
+        }
+        else if (line.startsWith('### ')) {
+            doc.fontSize(11).font('Helvetica-Bold').text(line.slice(4), { indent: 0 });
+        }
+        else if (line.startsWith('- ')) {
+            doc.fontSize(10).font('Helvetica').text(`  • ${line.slice(2)}`, { indent: 10 });
+        }
+        else if (line.startsWith('|')) {
+            // skip table formatting in PDF for simplicity
+        }
+        else if (line.trim() === '') {
+            doc.moveDown(0.3);
+        }
+        else {
+            doc.fontSize(10).font('Helvetica').text(line, { indent: 0 });
+        }
+    }
+    doc.moveDown(1);
+    doc.fontSize(8).font('Helvetica').fillColor('#999').text(`Generado por ${agentName} • AI Agent Toolkit`, { align: 'center' });
+    doc.end();
+    return new Promise((resolve, reject) => {
+        stream.on('finish', resolve);
+        stream.on('error', reject);
+    });
+}
+//# sourceMappingURL=pdfFormatter.js.map

package/dist/src/pdfFormatter.js.map

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

package/dist/src/prompts.d.ts

@@ -0,0 +1,3 @@
+export declare const SYSTEM_PROMPT = "You are an expert code documentation assistant. Your task is to generate clear, comprehensive JSDoc documentation for the given source code. Follow the conventions used in the task-manager-pro project.\n\n## Conventions to follow:\n- Use JSDoc format with /** */ blocks.\n- Include @param tags with types and descriptions.\n- Include @returns tags with type and description.\n- Include @example blocks when helpful.\n- For React components, describe the component and all its props.\n- For hooks, describe what state/behavior they manage.\n- For utility functions, describe the transformation logic.\n- For API routes/controllers, describe the endpoint, auth requirements, and response shape.\n- For Zod validators, describe the validation rules.\n- For TypeScript types/interfaces, describe each field.\n- For Prisma schemas, describe models and relations.\n\n## Response format:\nReturn ONLY the documented code wrapped in a markdown code block with the appropriate language tag. Preserve every line of the original code exactly as-is, prepending JSDoc comments above each export/function/component.";
+export declare const getFileTypePrompt: (filePath: string, content: string) => string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,klCAgBkM,CAAC;AAE7N,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,KAAG,MA2DrE,CAAC"}

package/dist/src/prompts.js

@@ -0,0 +1,83 @@
+export const SYSTEM_PROMPT = `You are an expert code documentation assistant. Your task is to generate clear, comprehensive JSDoc documentation for the given source code. Follow the conventions used in the task-manager-pro project.
+
+## Conventions to follow:
+- Use JSDoc format with /** */ blocks.
+- Include @param tags with types and descriptions.
+- Include @returns tags with type and description.
+- Include @example blocks when helpful.
+- For React components, describe the component and all its props.
+- For hooks, describe what state/behavior they manage.
+- For utility functions, describe the transformation logic.
+- For API routes/controllers, describe the endpoint, auth requirements, and response shape.
+- For Zod validators, describe the validation rules.
+- For TypeScript types/interfaces, describe each field.
+- For Prisma schemas, describe models and relations.
+
+## Response format:
+Return ONLY the documented code wrapped in a markdown code block with the appropriate language tag. Preserve every line of the original code exactly as-is, prepending JSDoc comments above each export/function/component.`;
+export const getFileTypePrompt = (filePath, content) => {
+    if (content.includes('@prisma/client') || filePath.includes('schema.prisma')) {
+        return createPrompt('Prisma Schema', `
+Document each model, field, relation, enum, and index with JSDoc-style comments above each declaration.
+For each field include: type, purpose, and any constraints (unique, default, relation).
+For enums: list each value and its meaning.
+Group related models with section comments.`);
+    }
+    if (content.includes('export const') && (content.includes('z.object') || content.includes('z.string'))) {
+        return createPrompt('Zod Validation Schema', `
+Document each schema with its validation rules, field constraints (min, max, regex), and the inferred TypeScript type.
+For each field describe: expected format, validation rules, and default values.`);
+    }
+    if (content.includes('@tanstack/react-query') || content.includes('useQuery') || content.includes('useMutation')) {
+        return createPrompt('React Query Hook', `
+Document the hook's purpose, what data it fetches/caches, mutation behavior, optimistic updates, error handling, and return value.
+List all parameters with types.`);
+    }
+    if (content.includes('React.createContext') || content.includes('createContext') || content.includes('.Provider')) {
+        return createPrompt('React Context Provider', `
+Document the context purpose, the provider component and its props, the context value shape, and how to consume it via the custom hook.
+Include usage example.`);
+    }
+    if (content.includes('React.FC') || content.includes('(): JSX') || (content.includes('=> {') && content.includes('<') && content.includes('/>'))) {
+        return createPrompt('React Component', `
+Document the component's purpose, all props (with types and descriptions), rendering logic, states (loading, empty, error, success), and side effects.
+Include a usage example showing how to import and render the component with its props.`);
+    }
+    if (content.includes('Request, Response') || content.includes('express.Router') || content.includes('RequestHandler')) {
+        return createPrompt('Express Route / Controller', `
+For each route handler document: HTTP method, path, authentication requirements, request body/params/query schema, response shape on success and error, and which services it calls.
+Include the response envelope format.`);
+    }
+    if (content.includes('export function') || content.includes('export const') || content.includes('export async function')) {
+        return createPrompt('Utility / Service Module', `
+Document each exported function: its purpose, parameters (with types), return value (with type), and any side effects or error conditions.
+Include @example blocks showing typical usage.`);
+    }
+    if (content.includes('interface ') || content.includes('type ') || filePath.includes('types/')) {
+        return createPrompt('TypeScript Type Definitions', `
+Document each interface, type alias, and enum: their purpose, each field with its type and description.
+Note which types are used as DTOs, API responses, or domain models.`);
+    }
+    if (content.includes('socket.io') || content.includes('io(') || content.includes('Server as SocketIOServer')) {
+        return createPrompt('Socket.IO Handler', `
+Document the socket events, authentication flow, room management, event payload shapes, and client connection lifecycle.`);
+    }
+    return createPrompt('Generic Module', `
+Document each export: purpose, parameters, return value, and error handling.
+Include @example for the main exports.`);
+};
+function createPrompt(fileType, specificInstructions) {
+    return `${SYSTEM_PROMPT}
+
+## File Type: ${fileType}
+
+${specificInstructions}
+
+## Code to document:
+\`\`\`
+{CODE}
+\`\`\`
+
+Return ONLY the fully documented code in a single markdown code block. Do not include any extra text or explanations.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/prompts.js.map

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

package/dist/src/providerDetector.d.ts

@@ -0,0 +1,20 @@
+export interface ProviderConfig {
+    provider: string;
+    model: string;
+    baseUrl?: string;
+    autoDetected: boolean;
+    detectedAt: string;
+}
+export interface DetectOptions {
+    env?: Record<string, string | undefined>;
+    ollamaBaseUrl?: string;
+    projectRoot?: string;
+}
+export declare function detectProvider(options?: DetectOptions): Promise<ProviderConfig | null>;
+export declare function detectOllama(baseUrl?: string): Promise<string[] | null>;
+export declare function loadConfig(projectRoot: string): ProviderConfig | null;
+export declare function saveConfig(projectRoot: string, config: ProviderConfig): void;
+export declare function getDefaultModel(provider: string): string;
+export declare function getAvailableProviders(env?: Record<string, string | undefined>): string[];
+export declare function printDetectionResult(config: ProviderConfig | null, verbose?: boolean): void;
+//# sourceMappingURL=providerDetector.d.ts.map

package/dist/src/providerDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerDetector.d.ts","sourceRoot":"","sources":["../../src/providerDetector.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD,wBAAsB,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyDhG;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,MAA2B,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAWjG;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAWrE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAG5E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAYxF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI,CA8BlG"}