Concept

Workspace artifacts are part of the product surface.

.echo-pdf-workspace/ is not incidental cache dust. It is an inspectable local contract for downstream tools that need document, page, render, OCR, and semantic artifacts.

Directory layout

.echo-pdf-workspace/
  documents/<documentId>/
    document.json
    structure.json
    semantic-structure.json
    pages/
      0001.json
    renders/
      0001.scale-2.json
      0001.scale-2.png
    ocr/
      0001.scale-2.provider-openai.model-gpt-4o.prompt-<hash>.json

Reuse boundary

Artifacts reuse only when source snapshot and strategy metadata still match the current document state.

Traceability

Artifacts link back to source files, sibling artifacts, and page-level origins so downstream readers can audit what they consume.

What not to assume

documentId is path-derived, not a portable content hash. Optional artifacts appear only after their primitive runs.

Local artifact contract, not remote storage.

The workspace is documented as a local filesystem contract. This site does not promise a hosted artifact browser or cloud artifact retention surface.