Add a deterministic Task Processing test provider for LibreSign AI flows

Abierto
#9,055 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
php
Área
backend, testing

Línea de trabajo

Start by reading the AI foundation capability contract referenced in the issue and identify the task types currently consumed by LibreSign; no specific files or tests are named here. Then inspect how the app integrates with Nextcloud Task Processing and how existing tests provide service doubles. Done means a production-separated, network-free deterministic provider with selectable fixtures and focused tests for the supported success and failure cases.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

backend php

Goal

Provide a fast, deterministic Task Processing provider/test double that lets LibreSign exercise AI-assisted flows in CI without paid APIs, external network access or probabilistic output.

This issue is part of the AI foundation epic and must follow the capability contract defined by the foundation work.

Why

AI-assisted features need normal regression coverage. Unit mocks alone are not enough to prove that LibreSign integrates correctly with the Nextcloud Task Processing path, while real LLM calls are too slow, costly and nondeterministic for ordinary pull-request CI.

The test provider should make AI behavior as testable as other LibreSign application services.

Scope

Implement the minimum provider/task types needed by the currently defined LibreSign AI capability contract.

The provider should support deterministic scenarios such as:

  • successful task with known output;
  • malformed/invalid output;
  • provider/task unavailable;
  • task failure;
  • cancellation where the supported contract requires it;
  • delayed/asynchronous completion where relevant;
  • intermediate/progress behavior only when an implemented LibreSign feature depends on it.

Do not implement fake capabilities that have no current LibreSign consumer.

Test-fixture design

Outputs must be fixture-driven and stable.

Tests should be able to request a named behavior instead of depending on prompt wording or model-like heuristics.

Examples:

  • summary fixture returns a known summary payload;
  • structured suggestion fixture returns a known valid payload;
  • hostile fixture returns a known invalid/unsafe payload;
  • failure fixture returns a controlled Task Processing failure.

Keep the test provider clearly separated from production providers and impossible to activate accidentally in a normal production installation.

Security

The deterministic provider exists to test the same trust boundaries as a real provider.

It must make it possible to verify that LibreSign:

  • validates output rather than trusting it;
  • does not use prompts as authorization;
  • handles provider failure safely;
  • rejects hostile generated markup/structured output at the correct LibreSign boundary;
  • does not expose one user's task result to another actor.

CI expectations

The deterministic provider should be suitable for normal pull-request CI and focused local development.

Keep it:

  • network-free;
  • free of paid APIs;
  • fast enough for normal CI;
  • deterministic across runs;
  • compatible with the supported Nextcloud test environment.

Done when

  • A deterministic Task Processing provider/test double can expose the required foundation task types.
  • Tests can select stable success and failure fixtures.
  • It cannot be confused with or enabled as a production provider.
  • It supports backend/integration and browser tests without external services.
  • Security/error cases can be reproduced deterministically.
  • Focused automated tests cover the provider itself.
Lenguaje dominante
PHP
Estrellas
844
Forks
176
Merge medio
14 h 3 min
PR fusionados (30 d)
344

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de LibreSign/libresign

Todos los issues de LibreSign/libresign

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.