@npm7381/agent-doc-generator 1.0.0

package/dist/src/providerDetector.js

@@ -0,0 +1,145 @@
+import fs from 'fs';
+import path from 'path';
+const CONFIG_FILE = '.aicode.json';
+const DEFAULT_MODELS = {
+    openai: 'gpt-4o',
+    anthropic: 'claude-sonnet-4-20250514',
+    deepseek: 'deepseek-chat',
+    gemini: 'gemini-2.5-flash',
+    ollama: 'llama3',
+};
+const OLLAMA_DEFAULT_URL = 'http://localhost:11434';
+export async function detectProvider(options = {}) {
+    const env = options.env ?? process.env;
+    const ollamaBaseUrl = options.ollamaBaseUrl ?? OLLAMA_DEFAULT_URL;
+    if (env.OPENAI_API_KEY && env.OPENAI_API_KEY !== 'your_openai_api_key_here') {
+        return {
+            provider: 'openai',
+            model: DEFAULT_MODELS.openai,
+            autoDetected: true,
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    if (env.ANTHROPIC_API_KEY && env.ANTHROPIC_API_KEY !== 'your_anthropic_api_key_here') {
+        return {
+            provider: 'anthropic',
+            model: DEFAULT_MODELS.anthropic,
+            autoDetected: true,
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    if (env.DEEPSEEK_API_KEY && env.DEEPSEEK_API_KEY !== 'your_deepseek_api_key_here') {
+        return {
+            provider: 'deepseek',
+            model: DEFAULT_MODELS.deepseek,
+            autoDetected: true,
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    if (env.GEMINI_API_KEY && env.GEMINI_API_KEY !== 'your_gemini_api_key_here') {
+        return {
+            provider: 'gemini',
+            model: DEFAULT_MODELS.gemini,
+            autoDetected: true,
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    const ollamaModels = await detectOllama(ollamaBaseUrl);
+    if (ollamaModels && ollamaModels.length > 0) {
+        const model = ollamaModels[0];
+        return {
+            provider: 'ollama',
+            model,
+            baseUrl: ollamaBaseUrl,
+            autoDetected: true,
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    if (ollamaModels === null) {
+        return null;
+    }
+    return null;
+}
+export async function detectOllama(baseUrl = OLLAMA_DEFAULT_URL) {
+    try {
+        const res = await fetch(`${baseUrl}/api/tags`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return (data.models ?? []).map((m) => m.name);
+    }
+    catch {
+        return null;
+    }
+}
+export function loadConfig(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 (config.provider && config.model)
+            return config;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveConfig(projectRoot, config) {
+    const configPath = path.join(projectRoot, CONFIG_FILE);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export function getDefaultModel(provider) {
+    return DEFAULT_MODELS[provider] ?? 'gemini-2.5-flash';
+}
+export function getAvailableProviders(env) {
+    const e = env ?? process.env;
+    const providers = [];
+    if (e.GEMINI_API_KEY && e.GEMINI_API_KEY !== 'your_gemini_api_key_here')
+        providers.push('gemini');
+    if (e.OPENAI_API_KEY && e.OPENAI_API_KEY !== 'your_openai_api_key_here')
+        providers.push('openai');
+    if (e.ANTHROPIC_API_KEY && e.ANTHROPIC_API_KEY !== 'your_anthropic_api_key_here')
+        providers.push('anthropic');
+    if (e.DEEPSEEK_API_KEY && e.DEEPSEEK_API_KEY !== 'your_deepseek_api_key_here')
+        providers.push('deepseek');
+    providers.push('ollama');
+    return providers;
+}
+export function printDetectionResult(config, verbose = false) {
+    if (config) {
+        console.log(`[AUTO-DETECT] Provider: ${config.provider} | Model: ${config.model}`);
+        if (verbose) {
+            console.log(`[AUTO-DETECT] Auto-detected at: ${config.detectedAt}`);
+        }
+    }
+    else {
+        console.log('[AUTO-DETECT] No provider found.');
+        console.log('');
+        console.log('  Set up one of these options:');
+        console.log('');
+        console.log('  1. Gemini (free tier):');
+        console.log('     echo "GEMINI_API_KEY=your_key" > .env');
+        console.log('     Get key: https://aistudio.google.com/apikey');
+        console.log('');
+        console.log('  2. OpenAI:');
+        console.log('     echo "OPENAI_API_KEY=sk-..." > .env');
+        console.log('');
+        console.log('  3. Anthropic:');
+        console.log('     echo "ANTHROPIC_API_KEY=sk-ant-..." > .env');
+        console.log('');
+        console.log('  4. DeepSeek (cheapest):');
+        console.log('     echo "DEEPSEEK_API_KEY=sk-..." > .env');
+        console.log('');
+        console.log('  5. Ollama (local, free):');
+        console.log('     Install: https://ollama.com');
+        console.log('     ollama pull llama3');
+        console.log('');
+        console.log('  Or specify directly: --provider openai --model gpt-4o');
+    }
+}
+//# sourceMappingURL=providerDetector.js.map

package/dist/src/providerDetector.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,35 @@
+export interface FileData {
+    filePath: string;
+    relativePath: string;
+    content: string;
+}
+export interface DocResult {
+    relativePath: string;
+    filePath?: string;
+    docPath: string;
+    summary: string;
+}
+export interface CacheEntry {
+    hash: string;
+    docPath: string;
+    content?: string;
+    timestamp: number;
+}
+export interface CacheStore {
+    [filePath: string]: CacheEntry;
+}
+export interface CLIOptions {
+    path: string;
+    verbose: boolean;
+    model: string;
+    provider: string;
+    baseUrl?: string;
+    apiKey?: string;
+    maxChars: number;
+    output?: string;
+    format: 'terminal' | 'markdown' | 'html' | 'pdf';
+    dryRun: boolean;
+    split: boolean;
+    extensions?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@npm7381/agent-doc-generator",
+  "version": "1.0.0",
+  "description": "AI-powered documentation generator for codebases",
+  "main": "dist/index.js",
+  "bin": {
+    "agent-doc-generator": "./dist/index.js"
+  },
+  "files": ["dist/", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "type": "module",
+  "license": "MIT",
+  "author": "Marcelo Adan",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx index.ts",
+    "doc": "node dist/index.js --path .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "test:integration": "vitest run tests/providerIntegration.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MarceloAdan73/ai-agent-toolkit",
+    "directory": "agent-doc-generator"
+  },
+  "keywords": ["ai", "documentation", "jsdoc", "code-generation", "documentation-generator"],
+  "dependencies": {
+    "@google/genai": "^1.52.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.7",
+    "ora": "^9.4.1",
+    "pdfkit": "^0.19.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pdfkit": "^0.17.6",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.1"
+  }
+}