Skip to content

Plan the encoded-ref probe - #249

Merged
nandanrao merged 1 commit into
mainfrom
docs/encoded-ref-probe-plan
Aug 27, 2026
Merged

Plan the encoded-ref probe#249
nandanrao merged 1 commit into
mainfrom
docs/encoded-ref-probe-plan

Conversation

@nandanrao

Copy link
Copy Markdown
Contributor

Adds planning/encoded-ref-probe-plan.md. Follows the idiom of
planning/ctwa-probe-runbook.md and picks up where
planning/encoded-ref-handover.md §6c leaves off.

Four legs, cheapest first, plus one descoped and said out loud rather than
implied. §1 records what is already settled with citations, so none of it gets
re-measured.

Two findings that shape it, both verified against vprod rather than assumed:

  • ad_attributions holds zero rows. Rows are written only on ad creates,
    so that is consistent with a healthy write path that has had nothing to do —
    and equally with record_ad_attribution never firing. Nothing distinguishes
    them from outside, and every later leg assumes the first. That is leg 0.
  • vlab staging cannot host the end-to-end test the handover assumed. It pins
    adopt v0.0.106 against production's v0.1.79, and toixo-staging.yaml has
    no migrations: block, so the pre-upgrade hook would template an empty image.
    The plan runs against production with a PAUSED ad instead — the posture the
    2026-08-17 CTWA probe used successfully.

It also records the observability gap that retiring the organic counter opened:
a correctly-configured encoded study whose refs stop round-tripping now emits no
signal at all, and thins_its_ref_without_reading_the_mapping does not catch it
because that fires only when a study declares no lookup conf. Written up as a
decision with two options rather than a task, since accepting it is defensible
while the feature is one study wide.

Docs only — no code, no behaviour change.

🤖 Generated with Claude Code

Every layer is tested and the golden vectors match across repos, but the full
path has never carried a real respondent. This plans the legs that would prove
it, cheapest first, and records what is already settled so none of it is
re-measured.

Two findings that shape it, both verified rather than assumed:

  ad_attributions holds zero rows. Rows are written only on ad creates, so that
  is consistent with a healthy write path with nothing to do -- and equally with
  record_ad_attribution never firing. Leg 0 tells those apart, because every
  later leg assumes the first.

  vlab staging cannot host the end-to-end test the handover assumed: it pins
  adopt v0.0.106 and has no migrations block, so the hook would template an
  empty image. The probe runs against production with a PAUSED ad instead.

Also records the observability gap retiring the organic counter opened: a
correctly-configured encoded study whose refs stop round-tripping now emits no
signal at all. That is a decision to make, not a task to schedule.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploy Preview for vlab-dashboard canceled.

Name Link
🔨 Latest commit 18b3fc0
🔍 Latest deploy log https://app.netlify.com/projects/vlab-dashboard/deploys/6a8f7f400ac52a0008fcc40f

@nandanrao
nandanrao merged commit 53a5873 into main Aug 27, 2026
8 of 12 checks passed
@nandanrao
nandanrao deleted the docs/encoded-ref-probe-plan branch August 27, 2026 15:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant