tegwick
b48a2102d7
Add Helix Forge correlation (HELIX_SESSION_UID env, metrics correlate), artifact-store publish (metrics publish), activity-core ActivityDefinition references, integration patterns docs, and canon/knowledge design artifacts.
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# 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) |