Changelog

Todos los cambios relevantes de tecsas3-cli se documentan aquí. El formato sigue Keep a Changelog 1.0.0 y el versionado es SemVer 2.0.0.
El CLI actualmente está en Beta (Development Status :: 4). Las APIs son estables dentro de una misma minor version; los breaking changes se reservan para majors.

Cómo actualizar

Tras actualizar, ejecuta tecsas3 util security-check para confirmar que los permisos del directorio ~/.tecsas3/ y del archivo credentials siguen dentro de la política, y vuelve a publicar la skill en tus agentes:
Si vienes de una versión anterior a 0.4.0, revisa la nota sobre redirección de util openapiutil schema documentada en la entrada [0.4.1] (sección Cambiado).

Versionado

  • MAJOR (1.0.0 → 2.0.0): cambios incompatibles en el contrato JSON, en nombres de recursos, en el formato de credenciales o en la forma de los placeholders de pipe.
  • MINOR (0.4.x → 0.5.0): recursos nuevos, comandos nuevos o cambios aditivos en el output JSON (nuevos campos opcionales).
  • PATCH (0.4.0 → 0.4.1): bugfixes, mejoras de rendimiento y actualizaciones de dependencias que no rompen contrato.
El versionado se sincroniza entre cli/src/tecsas3_cli/__init__.py y cli/pyproject.toml; el tag de Git y el wheel de PyPI comparten el mismo identificador.

Reportar problemas

[0.4.1] - 2026-09-06

Añadido

  • Comando install-skill para publicar la skill en mcode, pi, claude-code, opencode, hermes, openclaw, cursor, continue y codex.
  • Documento docs/COMPATIBILIDAD_AGENTES_2026.md con verificación empírica (17/17 checks) desde mcode y pi.
  • Suite tests/test_smoke.py con 17 smoke tests que invocan --help por recurso sin depender de la versión de rich (anti-regresión de drift de golden tests).
  • Suite tests/test_install_skill.py con 23 tests para install_skill.py (registro, dry-run, overwrite, candidatos inexistentes, parametrizado por los 9 agentes).
  • Tests adicionales: test_pipe_env_var_placeholder, test_pipe_positional_list, test_pipe_continue_on_error, test_fhir_export_bundle.

Cambiado

  • rich anclado a >=13.7,<16 en pyproject.toml para evitar drift de los golden tests --help ante nuevas versiones de rich.
  • USER_AGENT ahora se parametriza con __version__ (antes era el literal tecsas3-cli/0.1).
  • agent_info.EXAMPLES añade dos ejemplos para mcode y pi.
  • SKILL.md y docs/GUIA_CLI_TECSA_S3.md: corregidas referencias util openapiutil schema y prefijo de env vars TECSA_S3_*TECSAS3_*.

Corregido

  • Drift de los 14 golden tests --help por cambio en los caracteres Unicode de caja de rich (de ┌─┐└─┘ a ╭─╮╰─╯); regenerados con TECSAS3_UPDATE_GOLDEN=1.

Seguridad

  • Sin cambios; HTTPS obligatorio, keyring con fallback 0600 y redacción PHI se mantienen.

[0.4.0] - 2026-06-15

Añadido

  • Recurso hce: historias clínicas, notas, diagnósticos, órdenes, documentos, fórmulas, bitácora, antecedentes, escalas, consentimientos, ICD-10 y consultas IA.
  • Recurso fhir: pacientes, diagnostic reports, resultados de examen, agentes, EAPB, export, bundle y logs FHIR.
  • Recurso pipe: pipelines declarativos YAML con placeholders, paso de datos entre steps y --dry-run.
  • IA v2: chats, consulta libre, búsqueda de pacientes/familias, contexto y análisis.
  • Golden tests con snapshots regenerables (TECSAS3_UPDATE_GOLDEN=1).
  • Skill universal para agentes de código (OpenCode, Claude Code, OpenClaw, Hermes).
  • Guía completa en docs/GUIA_CLI_TECSA_S3.md.
  • Autocompletado de shell (--install-completion, --show-completion).
  • Workflow CI para build + publish en GitHub releases.

Cambiado

  • CLI pasó a Beta.
  • agent_info ahora expone guide, skill, agent_modes y golden paths extendidos.
  • Versión sincronizada entre __init__.py y pyproject.toml.

Corregido

  • Uso consistente de Runtime compartido en pipelines y tests anidados.
  • Parser de placeholders _dotted_get ahora soporta índices y atributos anidados (results[0].id_paciente).

Seguridad

  • Tokens preferentemente en keyring; fallback a archivo ~/.tecsas3/credentials con permisos 0600.
  • HTTPS obligatorio en producción; redacción PHI activa por defecto.