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.
This commit is contained in:
2026-06-16 01:53:01 +02:00
parent 4a9c2d9bea
commit b48a2102d7
22 changed files with 1451 additions and 408 deletions

View File

@@ -58,17 +58,45 @@ Helix session UIDs on project execution records for correlation.
**Workplan:** KAIZEN-WP-0004 Part 1.
#### Worked example
A TDD8 session captured by Helix Forge and closed with kaizen metrics:
```bash
# Helix capture sets (or operator exports) session identity
export HELIX_SESSION_UID="claude:17092961-abc"
export HELIX_REPO="kaizen-agentic"
export HELIX_FLAVOR="claude"
export HELIX_TOKENS="12500"
# Session close — project layer
kaizen-agentic metrics record tdd-workflow --success --time 4200 --quality 0.92
# Inspect project record (includes correlation fields)
kaizen-agentic metrics show tdd-workflow
# Fleet lookup — read-only, no ingestion in kaizen-agentic
export HELIX_STORE_DB=~/.helix-forge/store.db
kaizen-agentic metrics correlate claude:17092961-abc
```
Project `executions.jsonl` carries `helix_session_uid` for audit; fleet analytics
remain in agentic-resources digest store. Coach `memory brief` surfaces project
`## Performance Summary`; correlate adds fleet context when needed.
Contract: [docs/integrations/helix-forge-correlation.md](../docs/integrations/helix-forge-correlation.md).
### activity-core (P1)
**Event bridge** — scheduled and event-driven task creation.
Example ActivityDefinitions (after metrics CLI ships):
ActivityDefinition reference copies (sync into activity-core to activate):
- Weekly: run `kaizen-agentic metrics optimize` on repos with `.kaizen/`
- On low success_rate threshold: create review task in issue-core
- Post agent install: verify metrics scaffold exists
- [weekly-metrics-optimize](../docs/integrations/activity-definitions/weekly-metrics-optimize.md)
- [post-install-metrics-scaffold](../docs/integrations/activity-definitions/post-install-metrics-scaffold.md)
- [low-success-rate-review](../docs/integrations/activity-definitions/low-success-rate-review.md)
**Workplan:** KAIZEN-WP-0004 Part 2.
**Workplan:** KAIZEN-WP-0004 Part 2. Patterns: [docs/INTEGRATION_PATTERNS.md](../docs/INTEGRATION_PATTERNS.md).
### artifact-store (P1)
@@ -82,6 +110,13 @@ Register after optimizer runs:
Retention class: `raw-evidence` (180d default, aligned with ADR-004).
```bash
kaizen-agentic metrics optimize
kaizen-agentic metrics publish # requires ARTIFACTSTORE_API_URL + TOKEN
```
Manifest: [docs/integrations/optimizer-artifact-manifest.md](../docs/integrations/optimizer-artifact-manifest.md).
**Workplan:** KAIZEN-WP-0004 Part 3.
### info-tech-canon (P2)