Implement eml-pdf-assembly (openspec change)

[rubenvdlinde]

Hydra pipeline tracking issue — auto-filed for openspec change eml-pdf-assembly on development.

Spec

openspec/changes/eml-pdf-assembly/

---

Gemigreerd van Codeberg — oorspronkelijk Conduction/docudesk#13, geopend door rubenvdlinde op 2026-06-01.

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

[Hydra Supervisor] Orphaned build:running label detected (worker exited without emitting a verdict). Escalated to needs-input. Check logs/pipeline-13-* and logs/reviews/docudesk-13-*.jsonl to diagnose, then apply retry:queued or rebuild:queued to resume.

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

[Hydra Supervisor] Orphaned build:running label detected (worker exited without emitting a verdict). Escalated to needs-input. Check logs/pipeline-13-* and logs/reviews/docudesk-13-*.jsonl to diagnose, then apply retry:queued or rebuild:queued to resume.

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

Pipeline Progress

Stage	Status	Details
Implementation	✓ 13/15 tasks	Completed tasks 1-11, 14, 15
Quality Checks	✓	phpcs clean, 24/24 unit tests pass
Verification	pending
Archive	pending

Draft PR opened: https://codeberg.org/Conduction/docudesk/pulls/67

Updated: 2026-06-02

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

Pipeline Progress

Builder: DONE — Implementation committed and pushed.

PR

https://codeberg.org/Conduction/docudesk/pulls/67

Implemented

• EmlPdfAssemblyService — full multi-pass mPDF assembly (envelope HTML, cid: image resolution, PDF/A-3 file embedding via SetAssociatedFiles, per-type attachment rendering, nested EML recursion up to depth 3, error fallbacks per D8)
• ConversionBackendInterface + ConversionFailedException — cascade infrastructure
• EmlBackend — gates on TextExtractionService::parseEmlStructured being present; falls back to flat extractEml on parse failure
• Twig templates: email_envelope.twig (header block + body) + divider.twig (per-attachment divider)
• Tenant config keys: append_attachment_pages, max_attachment_render_size_bytes, divider_template
• 371 unit tests pass; 14 hydra gates green
• Fixed 2 pre-existing GrondslagenSummaryServiceTest failures

Tasks completed: 1-11, 14, 15 ✓ | 12-13 deferred (integration tests, cross-app coordination)

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

[Hydra Supervisor] Orphaned code-review:running label detected (worker exited without emitting a verdict). Escalated to needs-input. Check logs/pipeline-13-* and logs/reviews/docudesk-13-*.jsonl to diagnose, then apply retry:queued or rebuild:queued to resume.

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

[Hydra Supervisor] Orphaned security-review:running label detected (worker exited without emitting a verdict). Escalated to needs-input. Check logs/pipeline-13-* and logs/reviews/docudesk-13-*.jsonl to diagnose, then apply retry:queued or rebuild:queued to resume.

[rubenvdlinde]

al-gorithm-con op 2026-06-02 (van Codeberg):

Pipeline escalation: Applier dispatch skipped because openspec/changes/eml-pdf-assembly/hydra.json could not be read from the PR branch (feature/13/eml-pdf-assembly) or from the local spec path. An empty hydra.json would make the applier trivially pass on the "no unfixed CRITICAL" decision rule, so this is a hard block. Investigate the missing metadata and re-queue with retry:queued once restored.

[github-actions]

Thank you for opening this issue! It has been assigned to @rubenvdlinde for review.

What happens next:

1. A maintainer will review this issue and determine the appropriate action
2. If accepted, it may be converted into an OpenSpec change for structured development
3. You will be notified of any status changes

Triage labels:

• triage:accept-feature — accepted as a new feature
• triage:accept-bugfix — accepted as a bug fix
• triage:needs-info — more information needed
• triage:wontfix — will not be addressed
• triage:duplicate — duplicate of another issue