dorfteich/fixtures/import
Claude Fable 5 269b36c761
Some checks failed
CD / Build and push images (push) Successful in 2m53s
CD / Deploy to Test (push) Successful in 9s
CD / Smoke tests against Test (push) Successful in 1m11s
CI / Lint, typecheck, test (push) Failing after 4m22s
CI / Auth e2e pack (push) Has been skipped
CI / Import/export fidelity gate (push) Has been skipped
CI / Build container images (push) Has been skipped
CD / Promote to Int (push) Successful in 11s
Fix the gates the #116 commit skipped past
The asset type lost its name field during the split into path+extension
(tsc error), and the fixture's .obsidian/app.json needed Prettier's
formatting. Lesson from the /srv move repeated within one day: the gate
chain must gate — never '; echo' past a failing typecheck.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 16:53:11 +02:00
..
obsidian-vault Fix the gates the #116 commit skipped past 2026-07-14 16:53:11 +02:00
article.docx Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
article.docx.expected.md Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
article.odt Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
article.odt.expected.md Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
article.src.html Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
formatting.docx Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
formatting.docx.expected.md Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
formatting.odt Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
formatting.odt.expected.md Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
formatting.src.html Import .docx and .odt documents as new pages (#63) 2026-07-10 07:34:43 +02:00
README.md Add import/export fidelity gate to CI (#69) 2026-07-10 13:59:10 +02:00

Import fixture corpus (issue #63, ADR 0009)

Representative .docx/.odt documents and the Markdown our import pipeline is expected to produce from them. import.fixtures.test.ts runs the real two-pass pandoc conversion over each and asserts the result, so a change in behaviour (ours or pandoc's) surfaces as a snapshot diff to review — not a silent regression. This suite is part of the CI fidelity gate (issue #69); see ../README.md for the fidelity contract and the fixture-first bug process (how a fidelity bug becomes a new corpus fixture).

Files

For each document <name> and format <ext> (docx, odt):

  • <name>.<ext> — the source document.
  • <name>.<ext>.expected.md — the Markdown the pipeline produces, with every embedded image's data: URI normalised to the literal data:embedded-image (the base64 payload is volatile and not what the snapshot is pinning).

article covers headings, paragraphs, bold/italic, a link, a bullet list with nesting, an ordered list, an embedded image, and a table. formatting covers strikethrough, inline code, a blockquote, and three levels of nesting.

Fidelity notes (structure, not layout — ADR 0009)

  • ODT images lose their alt text and ODT tables lose their header row: pandoc's HTML→ODT writer does not encode either, so the source documents genuinely lack them. The DOCX variants keep both. This is a pinned pandoc limitation, not an import bug — extend the corpus rather than chasing it.

Limits (ADR 0009)

An uploaded document may be at most 25 MiB (MAX_CONVERSION_INPUT_BYTES), and each of the two conversion passes may run for at most 60 s (CONVERSION_TIMEOUT_MS). A ~50-page document converts well inside that ceiling (import.fixtures.test.ts asserts it); a document that exceeds the timeout fails the job with converter_timeout.

Regenerating

The documents and snapshots are generated with the pinned pandoc/core:3.6 (the production sidecar) so the snapshots match CI; a different pandoc version wraps lists and pads tables differently. scripts/gen-import-fixtures.mjs regenerates everything against a reachable pandoc sidecar (PANDOC_URL).