Skip to content
Skip to main content
Novel Systems home
Decision log
D-023August 4, 2026

A green dot is a claim, and a code comment is not a disclosure

Decided

/integrations now carries a visitor-facing sentence stating that the connected states and sync times describe a sample workspace. The data did not change and the cards were not removed.

What was wrong. The connector cards render a green dot and a line reading "Synced 2 min ago" for every connector the active sample workspace has switched on, including Salesforce, QuickBooks Online and Stripe Billing. That figure is lastSyncMinutesAgo, an authored constant in lib/integrations.ts. The file's header comment has always said so, and so did the comment directly above the rendering code. Neither is visible to anyone reading the page.

This is the failure mode worth naming: the codebase was honest with itself and not with its reader. Internal candour is not disclosure. A code comment explaining that a number is fabricated documents the fabrication; it does not withdraw it. The register (FLAGGED-CLAIMS.md, items 5, D9, H1, H12) had already identified this correctly, which makes it the second failure — a finding recorded and then left live is a finding that has been filed rather than fixed.

Why disclose rather than delete. Removing the sync line would have been easier and would have cost the page something real. The field mappings, the declared system of record per entity, the auth methods and the directions of travel are the actual contract each adapter implements, and they are the part an IT reviewer came to read. A blanket "everything on this page is illustrative" would tell that reviewer to discount the mappings too, which would be its own inaccuracy in the other direction. So the sentence draws the line where the line actually is: the states and times are illustrative, the mappings are the contract.

What would have to change for this to be wrong. If the page is ever wired to a real tenant's integration health, the disclosure must go at the same commit that wires it — a stale disclaimer under live data is as misleading as undisclosed sample data, just in the opposite direction.