{"_id":"@autosocio/codelens","name":"@autosocio/codelens","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@autosocio/codelens","version":"0.1.0","description":"Analizador read-only que aplica el algoritmo de cinco pasos a repositorios de software.","type":"module","license":"UNLICENSED","repository":{"type":"git","url":"git+https://github.com/Autosociomx/codelens.git"},"bugs":{"url":"https://github.com/Autosociomx/codelens/issues"},"homepage":"https://github.com/Autosociomx/codelens#readme","keywords":["static-analysis","repository-analysis","read-only","automation","typescript"],"engines":{"node":">=20.19.0"},"bin":{"codelens":"./dist/cli/analyze-repo.js"},"publishConfig":{"access":"public"},"dependencies":{"typescript":"^5.9.3"},"devDependencies":{"@types/node":"^20.19.43","tsx":"^4.23.12","vitest":"^1.6.1"},"scripts":{"analyze":"tsx src/cli/analyze-repo.ts","build":"tsc -p tsconfig.build.json","test":"vitest run --config vitest.config.mjs","test:watch":"vitest --config vitest.config.mjs","typecheck":"tsc --noEmit","verify":"tsc --noEmit && vitest run --config vitest.config.mjs && tsc -p tsconfig.build.json"},"_nodeVersion":"24.19.0","_id":"@autosocio/codelens@0.1.0","dist":{"integrity":"sha512-4Qblv29KSRRbt9qPTTDdNaLENtLwpMWMfg5D6YyqSVCwsfkF6z4KqLr15CGTojV7WElRqlimVIGSgvBGvekSNw==","shasum":"87c52c1ed75c7d62cd19211957bf84ea3f6dd352","tarball":"https://registry.npmjs.org/@autosocio/codelens/-/codelens-0.1.0.tgz","fileCount":13,"unpackedSize":46711,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICXdLZVDTw/AdQyFzU921+R3poVHEF+s3gzCCRkn5MYqAiEAy5djRC8j2KbsaUYom4d4bmdW9wwZ48IhpdvAJWLyhTk="}]},"_npmUser":{"name":"codelens","email":"autosociomx@gmail.com"},"directories":{},"maintainers":[{"name":"codelens","email":"autosociomx@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/codelens_0.1.0_1787412852187_0.40804863889548937"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T15:34:12.080Z","0.1.0":"2026-08-22T15:34:12.330Z","modified":"2026-08-22T15:34:12.514Z"},"maintainers":[{"name":"codelens","email":"autosociomx@gmail.com"}],"description":"Analizador read-only que aplica el algoritmo de cinco pasos a repositorios de software.","homepage":"https://github.com/Autosociomx/codelens#readme","keywords":["static-analysis","repository-analysis","read-only","automation","typescript"],"repository":{"type":"git","url":"git+https://github.com/Autosociomx/codelens.git"},"bugs":{"url":"https://github.com/Autosociomx/codelens/issues"},"license":"UNLICENSED","readme":"# AutoSocio CodeLens\n\nAutoSocio CodeLens analiza repositorios sin ejecutar ni modificar su contenido. Convierte el algoritmo de cinco pasos en recomendaciones con evidencia:\n\n1. `QUESTION_REQUIREMENTS`: cuestiona exports sin cobertura observable.\n2. `ELIMINATE`: identifica archivos inalcanzables desde los puntos de entrada.\n3. `SIMPLIFY`: señala funciones alcanzables con complejidad elevada.\n4. `ACCELERATE`: detecta trabajo bloqueante repetido que puede paralelizarse o agruparse.\n5. `AUTOMATE`: recomienda automatización cuando existen pruebas pero no una ejecución automática.\n\n> Estado: versión `0.1.0`. Las recomendaciones requieren revisión humana. CodeLens nunca elimina ni reescribe archivos del repositorio analizado.\n\n## Requisitos\n\n- Node.js 20.19 o posterior.\n- Un repositorio local de TypeScript, JavaScript o Python.\n\nEl análisis de TypeScript y JavaScript usa el AST de TypeScript. El soporte de Python es estructural e inicial; no sustituye analizadores especializados del lenguaje.\n\n## Uso publicado\n\nCuando `@autosocio/codelens` esté publicado en npm:\n\n```powershell\npnpm dlx @autosocio/codelens \"C:\\ruta\\al\\repositorio\"\n```\n\nTambién puede instalarse como dependencia de desarrollo:\n\n```powershell\npnpm add -D @autosocio/codelens\npnpm exec codelens .\n```\n\n## Uso desde un paquete local\n\nDespués de ejecutar `pnpm pack` en este proyecto:\n\n```powershell\npnpm dlx \".\\autosocio-codelens-0.1.0.tgz\" \"C:\\ruta\\al\\repositorio\"\n```\n\n## Opciones\n\n```text\ncodelens [repositorio] [opciones]\n\n-e, --entry <ruta>  Define un punto de entrada relativo; puede repetirse.\n    --json          Produce salida JSON para CI e integraciones.\n-h, --help          Muestra la ayuda.\n```\n\nSi CodeLens no puede descubrir un punto de entrada con seguridad, se detiene y solicita `--entry`; no adivina uno.\n\nEjemplo con puntos de entrada explícitos:\n\n```powershell\npnpm exec codelens . --entry src/main.ts --entry src/worker.ts\n```\n\n## Salida JSON\n\n```powershell\npnpm exec codelens . --json > codelens-report.json\n```\n\nEl reporte contiene la ruta analizada, archivos leídos, puntos de entrada, estadísticas de seguridad, resumen por fase y recomendaciones con prioridad, ubicación y evidencia.\n\n## Seguridad\n\nCodeLens:\n\n- No ejecuta código del repositorio objetivo.\n- No escribe dentro del repositorio objetivo.\n- Omite secretos y rutas sensibles conocidas.\n- Omite dependencias y directorios generados.\n- Rechaza enlaces simbólicos, archivos excesivamente grandes y texto binario.\n- Considera sus resultados recomendaciones; una persona decide cualquier eliminación o cambio.\n\n## Workflow reutilizable\n\nDespués de publicar la versión `0.1.0`, otro repositorio puede crear este workflow:\n\n```yaml\nname: CodeLens\n\non:\n  workflow_dispatch:\n  pull_request:\n\njobs:\n  analyze:\n    uses: Autosociomx/codelens/.github/workflows/analyze.yml@v0.1.0\n    with:\n      package-version: 0.1.0\n```\n\nEl workflow genera `codelens-report.json` como artefacto. No modifica el pull request y no convierte recomendaciones en fallos automáticos.\n\n## Desarrollo\n\n```powershell\npnpm install\npnpm run verify\npnpm pack\n```\n\n`verify` ejecuta typecheck, pruebas y compilación. `prepack` repite esa verificación antes de generar un paquete.\n\n## Publicación\n\nLa publicación es una operación externa independiente:\n\n1. Crear `Autosociomx/codelens` en GitHub y subir este repositorio.\n2. Confirmar el nombre y la política de licencia.\n3. Autenticarse en npm con una cuenta autorizada para el scope `@autosocio`.\n4. Ejecutar `pnpm publish --access public`.\n5. Crear el tag Git `v0.1.0` sólo después de comprobar la instalación publicada.\n\nNo guardes tokens de GitHub o npm dentro del repositorio.\n\n","readmeFilename":"","_rev":"1-6cd454fa3d514cd62f088d981aaf7a57"}