tegwick ea5fbe0bf3 feat(WP-0002): complete Triggers & Ops workstream

Delivers all 12 tasks (T22–T33): Temporal Schedule manager + startup
sync, NATS JetStream event router, FastAPI CRUD + manual trigger,
Prometheus metrics wiring, custom search-attribute tagging, and
operational runbook. Marks workplan status as done.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-28 01:04:43 +01:00

4.4 KiB

Raw Blame History

type

domain

repo

status

state_hub_workstream_id

tasks

custodian-WP-0002

workplan

custodian

activity-core

done

3a4f47d9-8bc1-434e-acb4-bed5d4dacda0

id	title	status	state_hub_task_id
T22	Write schedule_manager.py	done	e50550d1-9904-41d7-afd8-492a1f1e91b8

id	title	status	state_hub_task_id
T23	Bootstrap script to sync schedules on startup	done	5a1f7fa3-acb9-4f60-9892-c9eaa120272e

id	title	status	state_hub_task_id
T24	Handle misfire policy in schedule config	done	00231668-95c5-447f-b3d0-1fb8c20b487f

id	title	status	state_hub_task_id
T25	Test schedule pause/resume lifecycle	done	7abfd375-ea9d-4209-8371-e5664dc2c6c4

id	title	status	state_hub_task_id
T26	Implement Event Router service	done	68b6610b-159c-4f1c-92a9-7128efea0961

id	title	status	state_hub_task_id
T27	Implement routing rules (event.type + filters → activity_ids)	done	9348efea-a7e9-4f92-b866-8fc82cf28fee

id	title	status	state_hub_task_id
T28	Start/signal workflow from Event Router	done	cac1f45a-7391-471a-9566-97cdbd96eb2d

id	title	status	state_hub_task_id
T29	Integration test — publish event → observe workflow run	done	7f10b5a3-7cad-4914-b603-d57508c85629

id	title	status	state_hub_task_id
T30	REST API (FastAPI) — CRUD for ActivityDefinition	done	b27e54a1-5dcc-476d-8f4a-c995aea6a8c2

id	title	status	state_hub_task_id
T31	Wire Temporal SDK metrics to Prometheus	done	0eafb60c-f00e-4fd7-a921-7de75fcfe81e

id	title	status	state_hub_task_id
T32	Tag workflows with activity_id for Temporal visibility search	done	7bdfc5c2-1f06-4fce-aac3-fae036dcb47e

id	title	status	state_hub_task_id
T33	Write operational runbook	done	766d602d-1b23-4247-a46d-03c0d3b8e498

activity-core Triggers & Ops

Workstream: activity-core Triggers & Ops Hub ID: 3a4f47d9-8bc1-434e-acb4-bed5d4dacda0 Depends on: custodian-WP-0001 (Foundation — Temporal Backbone) Status: DONE (2026-03-28)

Purpose

Add automated triggering (time-based via Temporal Schedules and event-driven via Event Router), a REST admin API, Prometheus metrics, and an operational runbook. Transforms the manually-triggered backbone from WP-0001 into a self-operating service.

Decisions resolved

Event broker choice (hub: bc47c9c2-5643-4a88-8114-601738a2f64e): NATS + JetStream chosen.

Phase 4 — Time-Based Triggers (Temporal Schedules) ✓

Task	Priority	Status
T22: Write schedule_manager.py	medium	done
T23: Bootstrap script to sync schedules on startup	medium	done
T24: Handle misfire policy in schedule config	medium	done
T25: Test schedule pause/resume lifecycle	medium	done

Phase 5 — Event-Driven Triggers ✓

Task	Priority	Status
T26: Implement Event Router service	medium	done
T27: Implement routing rules (event.type + filters → activity_ids)	medium	done
T28: Start/signal workflow from Event Router	medium	done
T29: Integration test — publish event → observe workflow run	medium	done

Phase 6 — Observability & Admin ✓

Task	Priority	Status
T30: REST API (FastAPI) — CRUD for ActivityDefinition	low	done
T31: Wire Temporal SDK metrics to Prometheus	low	done
T32: Tag workflows with activity_id for Temporal visibility search	low	done
T33: Write operational runbook	low	done

Files produced

File	Purpose
`src/activity_core/schedule_manager.py`	T22/T24: upsert/delete/list Temporal Schedules
`src/activity_core/sync_schedules.py`	T23: bootstrap schedule sync
`src/activity_core/event_router.py`	T26/T27/T28: NATS JetStream → Temporal
`src/activity_core/api.py`	T30: FastAPI CRUD + manual trigger
`tests/test_schedule_lifecycle.py`	T25: schedule lifecycle unit tests
`tests/test_event_router.py`	T29: event router unit + integration tests
`docs/runbook.md`	T33: operational runbook
`docker-compose.dev.yml`	added NATS service

Completion criteria ✓

Schedules fire RunActivityWorkflow automatically on cron cadence ✓
External event published to NATS reaches the correct ActivityDefinition end-to-end ✓
ActivityDefinitions are manageable via REST API ✓
Prometheus metrics are scraped ✓
Runbook is written ✓

4.4 KiB Raw Blame History