# Optimizer Evidence Artifact Manifest

Package schema for `kaizen-agentic metrics publish` → **artifact-store**.

## Package identity

| Field | Value |
|-------|-------|
| `producer` | `kaizen-agentic` |
| `retention_class` | `raw-evidence` (180d default, ADR-004 aligned) |
| `name` | `kaizen-optimizer-<project-slug>` |
| `subject` | project directory name (override with `--subject`) |

## Files

| Relative path | Source | Media type |
|---------------|--------|------------|
| `optimizer/analysis.json` | `.kaizen/metrics/optimizer/analysis.json` | `application/json` |
| `optimizer/recommendations.jsonl` | `.kaizen/metrics/optimizer/recommendations.jsonl` | `application/x-ndjson` |

`recommendations.jsonl` is omitted from upload when absent (e.g. insufficient samples).

## Metadata (`POST /packages`)

```json
{
  "schema": "kaizen-agentic/optimizer-evidence/v1",
  "project": "demo-app",
  "project_root": "/path/to/demo-app",
  "producer": "kaizen-agentic",
  "retention_class": "raw-evidence",
  "retention_days": 180,
  "optimized_at": "2026-06-18",
  "agents": ["tdd-workflow", "coach"],
  "files": [
    "optimizer/analysis.json",
    "optimizer/recommendations.jsonl"
  ]
}
```

## Publish workflow

```bash
# 1. Ensure optimizer has run
kaizen-agentic metrics optimize

# 2. Publish (artifact-store must be reachable)
export ARTIFACTSTORE_API_URL=http://127.0.0.1:8000
export ARTIFACTSTORE_API_TOKEN=<write-token>
kaizen-agentic metrics publish --target .
```

Local-only workflows skip publish; `.kaizen/metrics/optimizer/` remains authoritative.

## Related

- [artifact-store ingestion API](https://github.com/coulomb/artifact-store) — `POST /packages`, `/files`, `/finalize`
- [ADR-004](../adr/ADR-004-project-metrics-convention.md)
- [INTEGRATION_PATTERNS.md](../INTEGRATION_PATTERNS.md)