photoncloud-monorepo/FOREMAN_TASK.md

Title: Foreman Task Brief (Project-specific)

Purpose (free text)

• Complete PROJECT.md Item 12 (Nightlight) - the FINAL infrastructure component (COMPLETE)
• Achieve 12/12 PROJECT.md deliverables (NOW 12/12)
• Prepare for production deployment using T032 bare-metal provisioning

Current objectives (ranked, short)

• 1. T033 Nightlight completion: S4 PromQL Engine (P0), S5 Storage, S6 Integration
• 2. Production deployment prep: NixOS modules + Nightlight observability stack
• 3. Deferred features: T029.S5 practical app demo, FlareDB SQL layer (post-MVP)

Standing work (edit freely)

• Task status monitoring: Check docs/por/T*/task.yaml for stale/blocked tasks
• Risk radar: Monitor POR.md Risk Radar for new/escalating risks
• Progress tracking: Verify step completion matches claimed LOC/test counts
• Stale task alerts: Flag tasks with no progress >48h
• Evidence validation: Spot-check evidence trail (cargo check, test counts)

Useful references

• PROJECT.md
• docs/por/POR.md
• docs/por/T*/task.yaml (active tasks)
• docs/evidence/** and .cccc/work/**

How to act each run

• Do one useful, non-interactive step within the time box (≤ 30m).
• Save temporary outputs to .cccc/work/foreman//.
• Write one message to .cccc/mailbox/foreman/to_peer.md with header To: Both|PeerA|PeerB and wrap body in <TO_PEER>..</TO_PEER>.

Escalation

• If a decision is needed, write a 6–10 line RFD and ask the peer.

Safety

• Do not modify orchestrator code/policies; provide checkable artifacts.