Skip to content

feat: add worked-example surface conformance harness #351

Description

@edithatogo

Summary

Add a reusable conformance harness that proves worked examples exercise the supported public surfaces consistently: Python API, CLI/file contract, docs tutorial artifacts, MCP boundary validation, HTTP API contract examples, and OpenAI tool adapter documentation where safe.

Linked Conductor track

conductor/tracks/public_clinical_dataset_worked_example_20260704

Why this is separate

The MIMIC-IV Demo worked example should demonstrate available surfaces, but a reusable harness across examples is shared validation infrastructure and should have its own tests, fixtures, and CI integration.

Acceptance criteria

  • Define a fixture contract for worked-example inputs and expected surface outputs.
  • Validate Python API and CLI/file outputs against shared fixtures.
  • Validate MCP boundary behavior without claiming unsupported formula execution in the MCP adapter.
  • Validate HTTP API and OpenAI adapter examples as contract/documentation surfaces where runtime execution is not available.
  • Emit a report suitable for docs and GitHub Actions evidence.

Dependencies

  • Public Clinical Dataset Worked Example.
  • Existing MCP, CLI/file, HTTP API, and OpenAI adapter contracts.

Metadata

Metadata

Assignees

No one assigned

    Labels

    ciContinuous integration and workflow changescodexenhancementNew feature or requestroadmapRoadmap and project-board tracking

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions