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:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user