feat: Propose Sentry observability, webhint linting, and analista-processual enhancements

[felippepestana]

Overview

Proposal to integrate production-ready observability infrastructure, code quality tooling, and enhanced deadline tracking capabilities into the AIOX squads ecosystem.

Features Proposed

1. Sentry Full-Stack Observability

• Client-side: React integration with browser tracing, session replay, and error profiling
• Server-side: Express.js integration with automatic error capture and context enrichment
• Configuration: Environment-based setup (SENTRY_DSN) for secure secret management
• Benefits: Real-time error monitoring, performance tracking, session replay for debugging

2. Webhint Code Quality Integration

• Accessibility: Automated a11y compliance checking
• Best Practices: Modern web standards validation
• CI/CD Integration: GitHub Actions workflows for automated checks
• Tools: @hint/hint-no-inline-styles, @hint/connector-local, @hint/formatter-stylish

3. Analista Processual Enhancements

• Deadline Model: Extended with legal basis tracking and urgency classification
• Calendar Support: Parallel tracking of business days and calendar days
• Automation: Flag for automated deadline detection
• Schema: Prisma ORM with robust data relationships

4. Infrastructure Improvements

• Server Configuration: Enhanced session management with environment variables
• Dependency Updates: Next.js v15.1.0, @sentry/react@10.46.0, @sentry/node@10.46.0
• CI/CD: GitHub Actions workflows for automated Docker deployment

Implementation Reference

A working reference implementation is available at:

• Repository: https://github.com/felippepestana/aiox-squads-FelippePestana
• Release: v0.1.0 (https://github.com/felippepestana/aiox-squads-FelippePestana/releases/tag/v0.1.0)
• Commits:
  • 2bea8de: feat: implement Sentry observability and webhint code quality linting
  • f1230cc: feat: enhance analista-processual deadline tracking

Code Quality

• ✅ All linting checks passing
• ✅ TypeScript compilation successful
• ✅ Smoke tests validated
• ✅ Docker builds verified

Questions for Discussion

1. Architecture: Does the Sentry integration align with AIOX observability strategy?
2. Scope: Should webhint be integrated as a standard quality gate for all squads?
3. Database: Is the Deadline model enhancement compatible with existing analista-processual workflows?
4. Dependencies: Are the version updates acceptable for the ecosystem?

Next Steps

• Community feedback on proposed features
• Architecture review with AIOX maintainers
• Compatibility testing with other squads
• Documentation and guides
• Integration into main branch

---

Submitted via felippepestana/aiox-squads-FelippePestana fork