Section 12 · OES Spec

Artifacts and package format

Charts, CSVs, SQL, notebooks — bundled or linked.

For sharing, archival, and presentation, OES supports attached artifacts. The JSON is the canonical manifest; CSV / Parquet / HTML / PNG files alongside are optional, useful for BI tools, slides, and downstream archives.

Fields

Field	Type	Purpose
artifacts[].type	enum	chart, screenshot, sql, notebook, csv, dashboard, slide, image, html_report.
artifacts[].title	string	Human title.
artifacts[].description	string	What the artifact shows.
artifacts[].uri	string	Relative or absolute path.
artifacts[].mimeType	string	image/png, text/csv, text/sql, etc.
artifacts[].generatedAt	string (date-time)	Timestamp.
artifacts[].source	string	Source system.
artifacts[].hash	string	Optional integrity hash.

Notes

```
Recommended package layout:
```

experiment-package/
  experiment.json
  metrics.csv
  results.csv
  segments.csv
  timeseries.csv
  artifacts/
    scorecard.html
    primary_metric.png
    guardrails.png
    analysis.sql
  README.md