{"_id":"@aiagentkit/agent-doc-generator","_rev":"2-264d41ed3cdd566cffb5611407cc83c0","name":"@aiagentkit/agent-doc-generator","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aiagentkit/agent-doc-generator","version":"1.0.0","keywords":["ai","documentation","jsdoc","code-generation","documentation-generator"],"author":{"name":"Marcelo Adan"},"license":"MIT","_id":"@aiagentkit/agent-doc-generator@1.0.0","maintainers":[{"name":"npm7381","email":"marcelomp024@gmail.com"}],"homepage":"https://github.com/MarceloAdan73/ai-agent-toolkit#readme","bugs":{"url":"https://github.com/MarceloAdan73/ai-agent-toolkit/issues"},"bin":{"agent-doc-generator":"dist/index.js"},"dist":{"shasum":"a00833396c130694e72b17ffeb7358db9a0eab8f","tarball":"https://registry.npmjs.org/@aiagentkit/agent-doc-generator/-/agent-doc-generator-1.0.0.tgz","fileCount":47,"integrity":"sha512-pldX6YKgb3SUUjPJlmN2mU+9hd5j9Djul+Tx6eTzG/BXStvN/pm7LxWZzmzoB/EhxQQnRaALaSXg97wTRjqoxQ==","signatures":[{"sig":"MEQCIHhr9tOMuPnsb3sp3TnLKAYdwnNeTJs2d1IBp0SrOrgkAiAg5FokM8Cs2gHvmWH7l/gpm2Z+3BOPNQ4xdzJMPxqE0A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101344},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d8265ab498265875cdaeeee65685324d75ba8c27","scripts":{"dev":"tsx index.ts","doc":"node dist/index.js --path .","test":"vitest run","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build","test:integration":"vitest run tests/providerIntegration.test.ts"},"_npmUser":{"name":"npm7381","email":"marcelomp024@gmail.com"},"repository":{"url":"git+https://github.com/MarceloAdan73/ai-agent-toolkit.git","type":"git","directory":"agent-doc-generator"},"_npmVersion":"11.17.0","description":"AI-powered documentation generator for codebases","directories":{},"_nodeVersion":"26.5.0","dependencies":{"ora":"^9.4.1","dotenv":"^16.4.7","pdfkit":"^0.19.1","commander":"^12.1.0","@google/genai":"^1.52.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.1.1","typescript":"^5.7.0","@types/node":"^22.0.0","@types/pdfkit":"^0.17.6"},"_npmOperationalInternal":{"tmp":"tmp/agent-doc-generator_1.0.0_1784545858610_0.49396240317796725","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aiagentkit/agent-doc-generator","version":"1.0.1","description":"AI-powered documentation generator for codebases","main":"dist/index.js","bin":{"agent-doc-generator":"dist/index.js"},"engines":{"node":">=18"},"type":"module","license":"MIT","author":{"name":"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":"git+https://github.com/MarceloAdan73/ai-agent-toolkit.git","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"},"gitHead":"484b69be500055c0bf3431664360deb66574df98","types":"./dist/index.d.ts","_id":"@aiagentkit/agent-doc-generator@1.0.1","bugs":{"url":"https://github.com/MarceloAdan73/ai-agent-toolkit/issues"},"homepage":"https://github.com/MarceloAdan73/ai-agent-toolkit#readme","_nodeVersion":"26.5.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-DNs5AeqgJpyxmXqYU33qQQlcIFRrM86phQ/APLZogqM0mm1aDxnDRVMwpSSJc+3GyBX8VOIvuIiuEnE02+1kvQ==","shasum":"7d57fd588d7953cfc7023679efd7473ab1dc4e4c","tarball":"https://registry.npmjs.org/@aiagentkit/agent-doc-generator/-/agent-doc-generator-1.0.1.tgz","fileCount":47,"unpackedSize":104576,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBEe0auNPZJ0iyvYE+wO2qn4JjnDlbURS/ZRRRae68dyAiEAnX0x7mU6/qK3HwSL7g2UbV+M4yIaLpPOFq1QY1rKEJo="}]},"_npmUser":{"name":"npm7381","email":"marcelomp024@gmail.com"},"directories":{},"maintainers":[{"name":"npm7381","email":"marcelomp024@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-doc-generator_1.0.1_1785639415696_0.3956717899625768"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-20T11:10:58.435Z","modified":"2026-08-02T02:56:56.023Z","1.0.0":"2026-07-20T11:10:58.748Z","1.0.1":"2026-08-02T02:56:55.837Z"},"bugs":{"url":"https://github.com/MarceloAdan73/ai-agent-toolkit/issues"},"author":{"name":"Marcelo Adan"},"license":"MIT","homepage":"https://github.com/MarceloAdan73/ai-agent-toolkit#readme","keywords":["ai","documentation","jsdoc","code-generation","documentation-generator"],"repository":{"type":"git","url":"git+https://github.com/MarceloAdan73/ai-agent-toolkit.git","directory":"agent-doc-generator"},"description":"AI-powered documentation generator for codebases","maintainers":[{"name":"npm7381","email":"marcelomp024@gmail.com"}],"readme":"# agent-doc-generator\n\nGenera documentación JSDoc automática usando IA.\n\n## Instalación\n\n```bash\n# Global\nnpm install -g @aiagentkit/agent-doc-generator\n\n# O sin instalar\nnpx @aiagentkit/agent-doc-generator --path ./src\n```\n\n## Uso\n\n```bash\nagent-doc-generator --path ./src                        # documentación de todo src/\nagent-doc-generator --path ./src/utils.ts               # un solo archivo\nagent-doc-generator --path ./src --split                # un DOCS.md por archivo\nagent-doc-generator --path ./src --format html          # salida HTML\nagent-doc-generator --path ./src --extensions .ts,.prisma  # solo archivos .ts y .prisma\nagent-doc-generator --path ./src --dry-run              # preview sin escribir\nagent-doc-generator --path ./src --verbose              # logs detallados\n```\n\n## Proveedores\n\n| Provider | Modelo Default | Auth | Notas |\n|----------|---------------|------|-------|\n| gemini | `gemini-2.5-flash` | `GEMINI_API_KEY` | Free tier disponible |\n| openai | `gpt-4o` | `OPENAI_API_KEY` | GPT-4o, GPT-4o-mini |\n| anthropic | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` | Claude |\n| deepseek | `deepseek-chat` | `DEEPSEEK_API_KEY` | El más barato |\n| ollama | modelo instalado | Sin key | Local, gratis, privacidad |\n\n**Auto-detección**: Si no especificas `--provider`, detecta automáticamente qué tienes configurado (keys en `.env` o Ollama corriendo).\n\n## Flags\n\n| Flag | Descripción | Default |\n|------|-------------|---------|\n| `--path` | Archivo o carpeta a procesar | (requerido) |\n| `--provider` | `gemini` \\| `openai` \\| `anthropic` \\| `deepseek` \\| `ollama` | auto-detectado |\n| `--model` | Modelo a usar | según provider |\n| `--base-url` | URL del servidor (Ollama) | `http://localhost:11434` |\n| `--api-key` | API key (opcional para Ollama) | .env |\n| `--max-chars` | Límite de chars por archivo | 15000 |\n| `--output` | Carpeta/archivo de salida | junto al archivo |\n| `--extensions` | Extensiones a procesar (CSV: `.ts,.prisma`) | todas |\n| `--split` | Un archivo por cada fuente | false |\n| `--format` | Formato de salida `terminal` \\| `markdown` \\| `html` \\| `pdf` | terminal |\n| `--dry-run` | Solo preview, no escribir | false |\n| `--verbose` | Logs detallados | false |\n\n## Features\n\n- **Modo single** (default): genera un único `DOCS.md`\n- **Modo split** (`--split`): genera `.docs.md` por cada fuente\n- **Cache**: hash MD5 para no regenerar archivos sin cambios\n- **Auto-detección**: detecta provider disponible al iniciar\n- **Resiliencia**: 3 reintentos con backoff ante errores de API\n- **Truncado**: archivos > `--max-chars` se recortan con aviso\n- **Filtro por extensión**: `--extensions .ts,.prisma` para limitar tipos de archivo\n\n## Requisitos\n\n- Node.js >= 18\n- Un proveedor de IA configurado (API key o Ollama local)\n\n## Licencia\n\nMIT\n\nParte de [AI Agent Toolkit](https://github.com/MarceloAdan73/ai-agent-toolkit).\n","readmeFilename":"README.md"}