Skip to main content

Intended Canonical Writer

The current-packet writer is:
This path is the L2 rolling-state synthesis layer. It reads the prior packet, loads only source documents added since the prior watermark, adds deterministic project facts, and writes one current packet for the project target.

Live Read-Back Status

The 2026-06-22 live packet read-back showed this current state: The 2026-06-22 cleanup removed the old public packet-writer entry points from runtime configuration and API routes. If a live read-back does not show fresh project_intelligence_synthesis_v1 rows, the system is not healthy; do not use another packet writer as a fallback.

Product Meaning

Project Intelligence is not currently healthy until the newest writer produces fresh current packets. The frontend can render existing packets, but it is reading stale legacy data. The frontend staleness threshold is eight hours. Any packet older than that must be treated as stale for executive or project-management decisions.

Source Pipeline Status

Source ingestion and embedding health are separate from packet health. The latest source embedding check showed meetings, Outlook email, Teams messages, SharePoint documents, and OneDrive documents successfully embedded after terminal exclusions. That proves source coverage, not Project Intelligence activation.

Failure-Loudly Rule

Project Intelligence is considered failed when any of these are true:
  • No current packet was generated in the freshness window.
  • The active current packets are not written by the intended compiler version.
  • Packet evidence does not link back to source documents.
  • A source item reaches indexed_for_rag but never reaches project_intelligence_updated.