feat: CLI interactiva v0.1.0 — perfiles, pipelines, aprobaciones, work items, secure files y extensiones

[henryd24]

Resumen

Convierte la CLI en una herramienta interactiva y mucho más completa, y reescribe su núcleo para que sea fiable en scripts y CI. Detalle completo en RELEASE_NOTES.md (v0.1.0) y README.md.

Cambios

Núcleo

• Cliente HTTP centralizado: valida el código de respuesta de todas las llamadas, errores legibles, detección de PAT inválido (203 / sesión anónima en proyectos públicos), reintentos ante 429/5xx, escape de URLs, --debug.
• Librería (azdevops/) sin E/S de consola; comandos con RunE y códigos de salida (0 / 1 / 130).

Experiencia de uso

• Modo interactivo: azdevops sin argumentos abre un menú generado del árbol de comandos; todos los comandos preguntan lo que falte (listas filtrables, secretos ocultos, confirmaciones). Se desactiva con --no-input, AZDEVOPS_NO_INPUT o CI.
• Perfiles: login, config view|use|delete|path; el PAT va al llavero del sistema cuando está disponible.
• Salida -o table|json|yaml|tsv y --query (JMESPath), autocompletado dinámico, --version.

Comandos nuevos

• variables: list, get --id, export/import (.env/JSON), copy (entre proyectos), diff (--exit-code).
• pipelines: list, run con --name/--branch/progreso en vivo/código de salida, runs, status, logs --failed, cancel.
• approvals y environments.
• workitems (wi): list, get, create, update, delete.
• service-connections (sc) y agents.
• securefiles (sf), incluido replace, que cambia el contenido conservando pipelines autorizados, roles, herencia y aprobaciones, con reversión automática.
• security: list-members, remove-member, list-groups --search/--project-only.
• open para abrir recursos en el navegador.
• extension (ext): init genera una extensión lista (src/tasks + azde-scripts + ncc + tfx, config dev/release, UUIDs, conexión opcional); add-task, bump, validate, reset-ids, uuid, pack, publish.

Correcciones

• set-permissions aplicaba solo al primer grupo coincidente; pipelines create --branch se ignoraba; run --wait podía esperar indefinidamente o devolver éxito si fallaba la consulta; update fallaba sin process/repository; fugas de conexiones; README con flags incorrectos; nombre del binario en la ayuda.

Infraestructura

• Workflow de CI (gofmt, vet, tests con -race, build), versión inyectada con ldflags, make test/vet/install.

⚠️ Cambios de comportamiento

• Mensajes de estado en stderr; stdout solo para datos.
• pipelines run --wait termina con código 1 si la ejecución falla o se cancela.
• Sin terminal, las eliminaciones exigen --yes.
• variables get / pipelines get --name devuelven error si no hay resultados.
• pipelines get-by-id queda obsoleto (pipelines get --id).

Pruebas

• Tests unitarios (cliente HTTP con httptest, parsing, perfiles/llavero, render JMESPath/YAML/TSV, diff de variables, WIQL, securefiles replace con servidor simulado incluyendo reversión, generador de extensiones).
• Verificado contra una organización real: lecturas en varios proyectos; escrituras solo con recursos temporales en Pruebas y education (Variable Groups, un work item enviado a la papelera, secure files), eliminados al terminar.
• extension init: proyecto generado con npm install, jest, tsc, .vsix y ejecución del index.js empaquetado; comandos de mantenimiento verificados sobre una copia de azdevops-extension-exec-pipeline.
• No probado de punta a punta: aprobar/rechazar (no había pendientes), sc share, agents enable/disable, el llavero real del SO y ext publish con un token válido del Marketplace.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DPPr3c5aKtRBhPuTSFYFmA

---

Generated by Claude Code