Part Begin of the insertion2End of the insertion Begin of the deletion 3End of the deletion of 5 of the text transform API for the description Begin of the insertionassistant, in review order dev → AI-133 → AI-135.End of the insertion Begin of the deletion assistant.End of the deletion Depends on Begin of the insertionAI-133 only. The function layer over the data layer: the rules that decide whether an action may run, the port to the LLM,End of the insertion Begin of the deletion parts 1End of the deletion and Begin of the deletion 2. RunsEnd of the deletion the Begin of the insertionexecution that runs theEnd of the insertion LLM call outside the request cycle and writes progress to the run's event log.

Begin of the insertionBranch `implementation/ai-135-execute-text-transforms-in-a-background-job`, PR #25171 (base: the AI-133 branch; #25170 was closed automatically by GitHub during a stack reorder, nothing was merged).

End of the insertion ## Scope

Begin of the insertion* `AI::TextTransforms::Context`: request-scoped value object for an existing work package, a new work package of a type in a project, or no context at all; resolvesEnd of the insertion Begin of the deletion - Prompt assembly service: system message = fixed scaffold + `action.prompt` +End of the deletion the type variant Begin of the insertionand its template. Never persisted.
* `AI::TextTransforms::Availability`: `assistant` (feature flag, setting, gateway readiness), `action` (plus active, usage scope vs. type,End of the insertion template Begin of the insertionpresent for `injects_type_template`), `runnable` (the job-time re-check: assistant and active only), `actions_for`. Every "no" carries a reason: `feature_disabled`, `assistant_disabled`, `llm_unavailable`, `action_inactive`, `context_required`, `type_mismatch`, `template_missing`.End of the insertion Begin of the deletion when the action injects it. User message = the submitted content verbatim. Content is never interpolated into the system message.End of the deletion
Begin of the insertion* End of the insertion Begin of the deletion -End of the deletion Gateway Begin of the insertionport: `readiness` andEnd of the insertion Begin of the deletion portEnd of the deletion `stream(system:, Begin of the insertionuser:, timeout:)End of the insertion Begin of the deletion user:)End of the deletion { |delta| }`. Begin of the insertion`NullGateway` answersEnd of the insertion Begin of the deletion The null implementation from part 2 raisesEnd of the deletion "not Begin of the insertionconfigured" and raises on stream; the real implementation comes in AI-137. `Errors::*` with the four reasons, `Cancelled`, and a `FakeGateway` specEnd of the insertion Begin of the deletion available". A testEnd of the deletion double Begin of the insertionthatEnd of the insertion replays scripted deltas, errors and Begin of the insertionclock advances.End of the insertion Begin of the deletion delays.End of the deletion
Begin of the insertion* `AI::TextTransforms::Execution`: streamsEnd of the insertion Begin of the deletion - `AI::TextTransformJob` on a dedicated queue, zero retries, hard timeout of about 180 s. LoadsEnd of the deletion the Begin of the insertionrun's stored `system_prompt` and `input` throughEnd of the insertion Begin of the deletion run by id (job arguments carryEnd of the deletion the Begin of the insertiongateway,End of the insertion Begin of the deletion id only), marks it running, streams,End of the deletion buffers deltas and appends a `text_delta` event every ~500 ms, Begin of the insertionre-reads the runEnd of the insertion Begin of the deletion checks `cancel_requested`End of the deletion at each flush Begin of the insertion(`cancel_requested` ends it `cancelled`, a deleted run ends silently), fails with `timeout` beyondEnd of the insertion Begin of the deletion and abortsEnd of the deletion the Begin of the insertion180 s budget,End of the insertion Begin of the deletion stream,End of the deletion then appends `completed` with the full text and marks the run succeeded. Begin of the insertionErrors mapEnd of the insertion Begin of the deletion
- Availability re-validated at job start.
- Error taxonomy mappedEnd of the deletion to translated `error` Begin of the insertionevents;End of the insertion Begin of the deletion events: LLM not configured or disabled, connection failed, timeout,End of the deletion upstream Begin of the insertionpayloads never reach users or logs.End of the insertion Begin of the deletion error. Never raw upstream payloads.End of the deletion
Begin of the insertion* `AI::TextTransformJob`: glue only, dedicated queue `ai_text_transforms`, zero retries, no JobStatus row, executes as the run's user with the run id as the only argument.End of the insertion Begin of the deletion - Prompts and responses are not logged above debug level.End of the deletion
Begin of the insertion* i18n keys `ai.text_transform.errors.*`; specs for context,End of the insertion Begin of the deletion - Specs againstEnd of the deletion the Begin of the insertionavailability matrix, the execution with an injected clock (flush windows,End of the insertion Begin of the deletion test double: flush throttling,End of the deletion cancel, Begin of the insertiondeletion, timeout,End of the insertion each error path, Begin of the deletion timeout,End of the deletion the full text in Begin of the insertion`completed`) and the job.End of the insertion Begin of the deletion `completed`.End of the deletion

## Notes

Begin of the insertion* No prompt assembly here:End of the insertion Begin of the deletion - The scaffold wording is a working state;End of the deletion the Begin of the deletion finalEnd of the deletion prompt Begin of the deletion setEnd of the deletion is Begin of the insertionassembled at create time and stored on the run (AI-136).End of the insertion Begin of the deletion AI-97.End of the deletion
Begin of the insertion* End of the insertion Begin of the deletion -End of the deletion Capacity is controlled by the GoodJob queue Begin of the insertionpool, e.g. `OPENPROJECT_GOOD__JOB__QUEUES="ai_text_transforms:2;-ai_text_transforms:20"`.End of the insertion Begin of the deletion pool.End of the deletion `good_job_control_concurrency_with` Begin of the insertionwould beEnd of the insertion Begin of the deletion isEnd of the deletion a backstop, not Begin of the insertionbackpressure, and is not used. DocumentingEnd of the insertion Begin of the deletion backpressure. DocumentEnd of the deletion the queue Begin of the insertionfor operators is a follow-up.
* The budget doubles asEnd of the insertion Begin of the deletion inEnd of the deletion the Begin of the insertiongateway's transport timeout, so there is no `Timeout.timeout`.End of the insertion Begin of the deletion operations docs.End of the deletion