Files
coulomb-loop/docs/integrations/activity-core-handoff.md
tegwick 245b7fcbfe Document atomic schedule promote; sync roster phase to operate
Fleet layer aligned via kaizen-agentic schedule promote --fleet-only.
2026-06-19 01:57:50 +02:00

2.5 KiB

activity-core Handoff — coulomb-loop Bootstrap

Customer: coulomb-loop Status: weekly operate phase — sync required

Prerequisites (done)

  • Pilot roster: loops/kaizen-stack/roster.yaml
  • .kaizen/schedule.yml on kaizen-agentic, the-custodian, activity-core
  • ActivityDefinition copies in coulomb-loop/activity-definitions/

activity-core checklist

  • Implement discover_kaizen_scheduled_repos + discover_kaizen_projects (activity_core/context_resolvers/kaizen.py; types kaizen / resolver / shell)
  • Dry-run: 6 scheduled_runs for pilot roster (2026-06-18)
  • ACTIVITY_DEFINITION_DIRS includes coulomb-loop; sync_activity_definitions (7 upserted)
  • Dev stack up (docker compose, alembic, worker + API on 8010)
  • E2E manual trigger: metrics optimize → 6 tasks (2026-06-18)
  • Enable daily kaizen stack — crons 08:00/09:00/10:00 (DEC-005)
  • Bootstrap exit 3/3 E2E cycles; definition files renamed hourly→daily (2026-06-18)
  • Promote to weekly operate phase (DEC-008, 2026-06-19); daily→weekly definition rename
  • Sync weekly definitions — disable retired coulomb-daily-*, upsert coulomb-weekly-*

Smoke commands (pilot)

kaizen-agentic schedule validate --target /home/worsch/kaizen-agentic
kaizen-agentic schedule prepare coach --target /home/worsch/kaizen-agentic
kaizen-agentic metrics optimize --target /home/worsch/kaizen-agentic

Definition enable order

  1. weekly-metrics-optimize (enabled)
  2. weekly-coach-orientation (enabled)
  3. weekly-optimization-review (enabled)
  4. low-success-rate-review (enabled — event primary)
  5. weekly-metrics-health-sweep (backup, disabled)
  6. weekly-registry-hygiene-sweep (enabled — ACTIVITY-WP-0013)
  7. weekly-loop-health-collector (after instruction executor)

Blocked on activity-core

  • Instruction executor for loop health collector
  • Weekly loop-health-collector — cron 0 11 * * 1 (disabled)

Closed (activity-core)

  • R2 reuse_surface_report_gaps — ACTIVITY-WP-0013 (2078915); sweep enabled
  • R1 event-payload — ACTIVITY-WP-0011; low-success-rate-review live

Next operator action

Use atomic promote (all three layers — cadence, definitions, fleet, sync):

kaizen-agentic schedule promote \
  --engagement-repo /home/worsch/coulomb-loop \
  --fleet-only \
  --activity-core /home/worsch/activity-core

--fleet-only skips cadence/definition transforms when those are already committed. Omit --fleet-only for a full stabilize→operate promotion on future loops.