docs: note that platform.initStart is assumed to follow Invoke

lym953 · claude · lym953 · commit 418cf992e93a · 2026-07-13T16:11:16.000-04:00
Co-Authored-By: Claude Sonnet 5 &lt;noreply@anthropic.com&gt;
diff --git a/bottlecap/src/lifecycle/invocation/processor.rs b/bottlecap/src/lifecycle/invocation/processor.rs
@@ -113,6 +113,9 @@ pub struct Processor {
     init_duration_metric_emitted: bool,
     /// Timestamp of the cold-start invocation metric in On-Demand mode, held back until
     /// `platform.initStart` sets the durable tag so it's not missed on invocation #1.
+    ///
+    /// This assumes `platform.initStart` always arrives after the Invoke event, which is what
+    /// we've observed in production.
     pending_first_invocation_metric_timestamp: Option<i64>,
 }
 

Original file line number	Diff line number	Diff line change
`@@ -113,6 +113,9 @@ pub struct Processor {`
`113`	`113`	`init_duration_metric_emitted: bool,`
`114`	`114`	`/// Timestamp of the cold-start invocation metric in On-Demand mode, held back until`
`115`	`115`	/// `platform.initStart` sets the durable tag so it's not missed on invocation #1.
	`116`	`+ ///`
	`117`	+ /// This assumes `platform.initStart` always arrives after the Invoke event, which is what
	`118`	`+ /// we've observed in production.`
`116`	`119`	`pending_first_invocation_metric_timestamp: Option<i64>,`
`117`	`120`	`}`
`118`	`121`