WP-0004: ecosystem integration complete

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.

docs/integrations/optimizer-artifact-manifest.md

@@ -0,0 +1,60 @@
+# 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)