# Function getCachedLifecycleStatistics

- getCachedLifecycleStatistics(
  corpusSize?: number,
  ): LifecycleStatisticsModel | null

  Returns the cached lifecycle-statistics model for the given corpus size if present and unexpired, otherwise `null`. Never triggers a rebuild and never blocks.

  Intended for request-path callers (e.g. `monitor_legislative_pipeline`) that need to avoid the cold-cache corpus rebuild competing with their own rate-limited `/events` fan-out. Out-of-band warmup (background jobs, sibling tools whose primary purpose is the corpus itself) should keep using getLifecycleStatistics which will rebuild on miss.

  #### Parameters

  - corpusSize: number = CORPUS_SIZE

    Sample size to look up (default: CORPUS_SIZE).

  #### Returns LifecycleStatisticsModel | null

  The cached model, or `null` on cache miss / expiry.

  #### Security

  No network calls; safe to use inside tight request budgets.

  #### Since

  0.8.0

  - Defined in utils/lifecycleStatistics.ts:451