Skip to content

chore(integration): snapshot the legacy library pages - #454

Closed
eli-r-ph wants to merge 3 commits into
mainfrom
chore/legacy-docs-snapshots
Closed

eli-r-ph wants to merge 3 commits into
mainfrom
chore/legacy-docs-snapshots

Conversation

@eli-r-ph

@eli-r-ph eli-r-ph commented Nov 3, 2026 •

Copy link
Copy Markdown

Problem

Many skills build their references from the live posthog.com library pages for python, node, go, rust, ios, android, flutter, django and flask. Those pages move to the capture v1 majors on each SDK's release day, and the next build would turn every legacy skill v1-shaped while the wizard still installs the legacy majors.

Changes

  • context/docs-snapshots/legacy/: copies of the thirteen pages, taken 2026-11-02, with a README listing each source and when to refresh.
  • A docs_urls entry without a scheme is a repo file. A missing one fails the build. The dev server watches the snapshots and rebuilds the skills that read an edited one.
  • Every skill that read one of those pages now reads the snapshot: the integration variants, the error-tracking and feature-flags steps, the standalone error-tracking, feature-flags, AI observability and MCP analytics skills, and the three omnibus skills. Verified with a full build: the generated references are byte-identical.

Must be released before the docs pages change.

Test plan

Tests for the local read, the missing and out-of-repo paths, that every referenced snapshot exists, that no config fetches one of the pages live, and the file naming. pnpm test.

LLM context

Written with Claude Code (Claude Fable 5.1).

🤖 Generated with Claude Code

The posthog.com library pages for python, node, go, rust, ios, android,
flutter, django and flask move to the capture v1 majors on each SDK's
release day. The legacy integration variants now read copies taken on
2026-11-02 from context/docs-snapshots/legacy instead of the live pages,
so they keep describing the majors they install. A docs_urls entry without
a scheme is a repo file; a missing one fails the build. The generated
references are byte-identical to today's build.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown

🧙 Wizard CI

Run the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands:

Test all apps:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci ai-observability
  • /wizard-ci basic-integration
  • /wizard-ci feature-flags
  • /wizard-ci mcp-analytics
  • /wizard-ci replay-vision
  • /wizard-ci revenue
  • /wizard-ci self-driving
  • /wizard-ci warehouse
  • /wizard-ci warehouse-seeded

Test an individual app:

  • /wizard-ci ai-observability/anthropic
  • /wizard-ci ai-observability/google-adk
  • /wizard-ci ai-observability/groq
Show more apps
  • /wizard-ci ai-observability/manual-capture
  • /wizard-ci ai-observability/openai
  • /wizard-ci ai-observability/openai-agents
  • /wizard-ci ai-observability/opentelemetry
  • /wizard-ci ai-observability/vercel-ai
  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/flutter
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci feature-flags/django
  • /wizard-ci feature-flags/next-js
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci replay-vision/javascript-node
  • /wizard-ci replay-vision/next-js
  • /wizard-ci replay-vision/react-vite
  • /wizard-ci revenue/stripe
  • /wizard-ci self-driving/astro
  • /wizard-ci self-driving/fastapi
  • /wizard-ci self-driving/nuxt
  • /wizard-ci self-driving/react-router
  • /wizard-ci self-driving/sveltekit
  • /wizard-ci warehouse/monorepo-env
  • /wizard-ci warehouse/multi-source-next
  • /wizard-ci warehouse/stripe-node
  • /wizard-ci warehouse/zero-source
  • /wizard-ci warehouse-seeded/next-stripe
  • /wizard-ci warehouse-seeded/next-stripe-declined

Test against a wizard branch:

  • /wizard-ci all wizard:my-branch

Add wizard:<branch> to any command above to pin the wizard branch. It defaults to main.

Results will be posted here when complete.

The aggregated integration skills fetch the same pages; after the docs
flip they would describe the v1 majors while a legacy-pinned run can still
pick them from the integration category.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@eli-r-ph
eli-r-ph requested a review from a team November 3, 2026 00:26
The error-tracking and feature-flags steps, the standalone error-tracking,
feature-flags, AI observability and MCP analytics skills and the third
omnibus skill fetched the same pages live. The dev server now watches the
snapshots and rebuilds the skills that read an edited one.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@@ -1,5 +1,7 @@
# Integration skills - example-based (code + docs)
# `framework` = the detection id a variant serves; `default: true` marks the family default. Both are emitted into skill-menu.json.
# Legacy SDK variants read `context/docs-snapshots/legacy/*.md` (copies of the library pages) instead of the live pages,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nit] #453 also adds a comment at line 3 of this file, so whichever stack lands second will conflict here.

tags: [android, java, kotlin]
docs_urls:
- https://posthog.com/docs/libraries/android.md
- context/docs-snapshots/legacy/android.md

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[suggestion] #453 says an untagged variant serves either mode, so a v1 run could get these 3.x docs. Could we tag android, swift and flutter capture_mode: legacy?

tags: [flutter, dart, mobile]
docs_urls:
- https://posthog.com/docs/libraries/flutter.md
- context/docs-snapshots/legacy/flutter.md

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[question] #479 bumps the android/swift/flutter example apps to 4.0/6.0 while these variants read the 3.x/5.x snapshots, so agents would get 3.x docs next to 4.0 code. We could keep 3.x/5.x copies of the example apps for the legacy variants, or add capture_mode: v1 variants that read the live pages and the 4.0 examples. Which do we prefer?

@edwinyjlim

Copy link
Copy Markdown
Member

Closing this stack. The design comes back after the agent DAG refactor, where the wizard picks each SDK's major, and the skills written for it, from project traits and context-mill tags. The branch stays.

@edwinyjlim edwinyjlim closed this Nov 11, 2026
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.

3 participants