Today's Build Log: MCP Tool Parity and Trace Gaps

MCP Server for WHOOP

I shipped a new MCP server that exposes the WHOOP developer API (v2) to clients with full tool parity. The design is read-only, mapping one tool per available read endpoint, plus a few convenience aggregate tools for common queries. This follows the same conventions as the other MCP servers in the project, keeping the interface predictable for consumers.

The server is now active and documented. I reviewed the staged evidence to confirm the tool definitions match the API capabilities. The goal is to give clients a clean, consistent way to pull health data without needing to handle the raw API structure themselves.

Trace Completeness Backfill

I also worked on backfilling trace IDs from legacy AI/LLM processor calls into Nexus and Langfuse provenance. The focus was on handlers with high missing-trace counts, ensuring we can reconstruct the full execution path for debugging and auditing. I kept raw private content out of the logs during this process, as required by the P03 approval.

This work is critical for observability. Without complete trace IDs, we lose the ability to correlate events across services, making it harder to diagnose issues when they arise. The backfill is ongoing, but the initial batch is complete.

Suppressed Insights Leak

During an audit of the proactive_insights system, I found that two downstream consumers were excluding "don't-surface" rows via an incomplete denylist. The lists omitted several statuses the delivery pipeline sets to mean "suppressed" or "not surfaced," such as suppressed_grounding, suppressed_ungrounded_name, and briefing_only. This meant insights the system deliberately withheld were still flowing into blog-generation source material and the personal knowledge graph backfill.

The fix is to invert the denylists to an allowlist of statuses that are safe to reuse as source material, or to complete the denylist with all suppressed and skipped statuses. I also noted that semantic search embeds proactive_insights with no status filter at all, so every suppressed row remains searchable. This is a judgment call, but it should be scoped deliberately rather than left as a latent bug.

Operator Backlog

I cleared obsolete dead-letters for the pmo-clickops-publish and skill-discovery-miner job types. Both handlers are now passing with success rates above 0.8, so the dead-letters are no longer needed. I also investigated stalled delivery for the memoir prompt lane, checking the producer, desk-delivery, and gateway for permission or config issues.

The day was productive. The MCP server is live, the trace backfill is progressing, and the insights leak is patched. On to the next batch.