Automatización y programación

Responsabilidad

El planificador ejecuta las tareas periódicas y puntuales configuradas, conserva el historial, expone el estado operativo y coordina trabajos de sincronización, publicación, ingestión, mantenimiento y actualización de la planificación.

La funcionalidad de automatizaciones contiene la pantalla del planificador y la conversión de intervalos. El centro de control contiene el panel operativo, historial, miembros y diálogos de directivas. Las rutas se cargan bajo demanda; los adaptadores compartidos preservan identificadores, unidades, permisos y payloads. Mover una pantalla no habilita tareas ni inicia trabajos.

Los metadatos, el estado persistido y la frontera opcional de notificaciones tienen contratos estrictamente tipados en módulos específicos. El gestor valida las definiciones heredadas antes de construir tareas de ejecución y respeta el límite de tamaño del código.

Modelo de tarea

Cada definición tiene identidad estable, estado habilitado, programación, operación, configuración y política de ejecución. El historial registra inicio, finalización, estado, mensaje y duración. Las definiciones se alinean con las conexiones antes de ejecutarse para evitar integraciones eliminadas o equivocadas.

Flujo de ejecución

sequenceDiagram
    participant Clock as Scheduler clock
    participant Manager as Scheduler manager
    participant History as Execution history
    participant Job as Domain job or skill
    Clock->>Manager: Task is due
    Manager->>Manager: Validate enabled config and overlap policy
    Manager->>History: Record running attempt
    Manager->>Job: Execute with isolated context
    Job-->>Manager: Result or controlled error
    Manager->>History: Persist status, message, duration

Las operaciones deben ser idempotentes cuando puedan repetirse. El gestor controla solapamientos según la política de tarea y utiliza contextos nuevos de base de datos o proveedor. Tras un reinicio, reconcilia la configuración persistida.

El arranque nativo activa el planificador por defecto. Las pruebas deterministas y los diagnósticos con datos locales pueden establecer GNOSI_DISABLE_SCHEDULER=1 para comprobar API e interfaz sin ejecutar integraciones pendientes. Este interruptor no modifica la configuración guardada.

El gestor conserva ciclo de vida, persistencia, solapamientos e historial; task_handlers.py contiene el despacho y las operaciones grandes, incluido el mantenimiento acotado. Así, su ejecución es reutilizable y estrictamente tipada, sin acoplarla al ciclo de vida del hilo del planificador.

Las notificaciones utilizan una frontera de plataforma independiente del proveedor. La persistencia en base de datos y Markdown está disponible en todos los hosts; las alertas nativas de macOS se intentan sin garantizar su entrega. Los logs Markdown viven bajo GNOSI_DATA_DIR, no dentro de un Vault de OneDrive, Google Drive, Nextcloud, Dropbox u otros proveedores. El fallo de un canal no bloquea los demás. La antigua ruta de la habilidad de notificaciones es una fachada de compatibilidad.

Sincronización académica y actualización de revisiones

academic_repository_sync es un trabajo persistente y reanudable para índices OAI locales. Conserva cursor, recuentos, error, cancelación y última sincronización correcta fuera de la petición. Un administrador inicia la primera recolección; después, la tarea incremental diaria continúa desde el último punto completo y aplica las marcas de eliminación OAI.

Las estrategias guardadas pueden programar academic_review_update. Cada ejecución reproduce la estrategia versionada, registra actividad y errores parciales por fuente y añade solo candidatos con una identidad nueva para esa revisión. La próxima ejecución se guarda con la configuración de la revisión.

La cola exige una raíz LOCAL_DATA explícita y falla antes de abrir SQLite si falta configuración. Los adaptadores validan los payloads antes del despacho y rechazan registros sin función ejecutable. La sincronización de contactos pasa explícitamente base de datos, workspace e integración para evitar confundir argumentos.

Los trabajos académicos resuelven el Vault activo antes de acceder a literatura. Sin Vault, registran una omisión estructurada como resultado correcto, con cero trabajos en vez de construir Path(None). La recuperación de la cola del Reader comprueba que existe el documento del trabajo gestionado por el proveedor antes de reclamarlo; los registros huérfanos se rechazan una sola vez y nunca crean hilos destinados a fallar.

Automatizaciones del Vault

Las reglas combinan desencadenantes, condiciones y acciones. Las fórmulas y rollups se evalúan de forma determinista, no como código arbitrario. Las acciones externas o destructivas conservan los mismos límites de autorización y confirmación que las interactivas.

Trabajo autónomo de calidad

Los ciclos de mantenimiento y calidad son tareas operativas acotadas. Pueden diagnosticar, generar informes o aplicar cambios dentro de su ámbito. La programación no amplía los permisos sobre archivos, secretos, Git o publicaciones.

Límite del mantenimiento por dispositivo

system_maintenance vacía la caché en memoria de la aplicación y trunca únicamente el archivo ordinario logs/gnosi.log, con un solo enlace físico, bajo el GNOSI_DATA_DIR canónico, solo si es el LOG_FILE configurado. Conserva el inodo para que el logger siga escribiendo. Ni los directorios ni el archivo pueden ser enlaces simbólicos. Si la ruta no es válida o la plataforma no ofrece operaciones seguras relativas a un directorio, omite la limpieza de disco.

No limpia código fuente, bytecode, logs configurados en otras ubicaciones, buzones privados del workspace, bases de datos, secretos, documentos del Vault ni carpetas sincronizadas. Los contadores heredados de buzón, temporales y bytecode se conservan con valor cero. Retirar checkouts antiguos es una operación separada y revisada del workspace, no una tarea programada de la aplicación.

Generación diaria de audio

El servicio de pódcast del Reader selecciona modelo e idioma con contratos tipados, limita los trabajadores TTS por frase y sustituye el MP3 atómicamente. Captura el Vault seleccionado antes de comenzar y rechaza el inicio sin Vault activo, para impedir que la salida acabe en una ruta local ambigua.

Invariantes

• Las tareas deshabilitadas o inválidas no se ejecutan.
• Cada ejecución tiene un resultado persistente en el historial.
• Los reintentos no duplican efectos externos sin una estrategia de idempotencia.
• Eliminar o reasignar conexiones actualiza las programaciones dependientes.
• Las zonas horarias tienen semántica explícita.
• Las excepciones no interrumpen el bucle del planificador.
• Los trabajos no reutilizan sesiones de base de datos de una petición.
• Cancelar una recolección OAI conserva el cursor para reanudarla.
• Repetir una revisión no duplica resultados ya identificados.

Verificación

Compruebe la resistencia de la configuración a fallos, la coherencia de las conexiones, las tareas de planificación, el historial, los solapamientos, las zonas horarias, reintentos, reanudación y cancelación OAI, marcas de eliminación, detección de nuevos resultados y confinamiento del mantenimiento. Ejecute también las pruebas de automatización de Playwright y una integración representativa de principio a fin con datos sintéticos o una cuenta de pruebas.

Centro de actividad unificado

El panel contiene programaciones, historial de ejecuciones y aprobaciones pendientes. Distingue las automatizaciones personales de habilidades de los servicios de mantenimiento e integración del sistema. Configuración conserva modelos, agentes, habilidades y herramientas; las antiguas pestañas de operaciones redirigen al panel. La ruta independiente del planificador redirige a las programaciones del sistema.

Las programaciones personales admiten intervalos, horas locales diarias y días de la semana seleccionados, con zona horaria IANA explícita. Una hora inexistente en primavera se desplaza según el salto horario; una hora ambigua en otoño se ejecuta solo en su primera ocurrencia. Editar otros campos conserva la siguiente ejecución. La migración aditiva automations_0002 mantiene los intervalos existentes y añade una respuesta final de tamaño limitado al historial.

El historial relaciona definiciones y ejecuciones dentro del Vault, espacio y usuario actuales. La paginación y el límite de los filtros a las páginas cargadas son visibles. El historial del sistema, los trabajos de fondo y las ejecuciones personales tienen orígenes distintos. El distribuidor interno se oculta hasta activar la actividad técnica. Los detalles traducen mensajes genéricos sin afirmar que se ha realizado trabajo cuando el registro no lo confirma. El enlace de programación abre el servicio concreto; las referencias y mensajes originales se pueden desplegar y copiar, con etiquetas explicativas. Los errores se distinguen de resultados vacíos. Eliminar una automatización conserva las filas guardadas pero las excluye de esta consulta personal conjunta; es un historial operativo, no un archivo permanente de auditoría.