Files
claudemesh/posthog-setup-report.md
Alejandro Gutiérrez ee12510ef1
Some checks failed
CI / Lint (push) Has been cancelled
CI / Typecheck (push) Has been cancelled
CI / Broker tests (Postgres) (push) Has been cancelled
CI / Docker build (linux/amd64) (push) Has been cancelled
refactor: rename cli-v2 → cli, archive legacy cli, plus broker-side grants + auto-migrate
- apps/cli/ is now the canonical CLI (was apps/cli-v2/).
- apps/cli/ legacy v0 archived as branch 'legacy-cli-archive' and tag
  'cli-v0-legacy-final' before deletion; git history preserves it too.
- .github/workflows/release-cli.yml paths updated.
- pnpm-lock.yaml regenerated.

Broker-side peer-grant enforcement (spec: 2026-04-15-per-peer-capabilities):
- 0020_peer-grants.sql adds peer_grants jsonb + GIN index on mesh.member.
- handleSend in broker fetches recipient grant maps once per send, drops
  messages silently when sender lacks the required capability.
- POST /cli/mesh/:slug/grants to update from CLI; broker_messages_dropped_by_grant_total metric.
- CLI grant/revoke/block now mirror to broker via syncToBroker.

Auto-migrate on broker startup:
- apps/broker/src/migrate.ts runs drizzle migrate with pg_advisory_lock
  before the HTTP server binds. Exits non-zero on failure so Coolify
  healthcheck fails closed.
- Dockerfile copies packages/db/migrations into /app/migrations.
- postgres 3.4.5 added as direct broker dep.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 08:44:52 +01:00

3.2 KiB

# PostHog post-wizard report

The wizard has completed a deep integration of PostHog analytics into the claudemesh apps/web Next.js app. The project already had PostHog initialized via the @turbostarter/analytics-web package (which wraps posthog-js and posthog-node), user identification in AnalyticsProvider, and environment variable support. This integration adds 11 targeted track() calls across 10 files covering every critical business action: auth flows, organization lifecycle, team growth, and billing conversion.

Environment variables NEXT_PUBLIC_POSTHOG_KEY and NEXT_PUBLIC_POSTHOG_HOST were updated in apps/web/.env.local.

Event Description File
user_signed_up Fired when a user successfully completes email registration apps/web/src/modules/auth/form/register-form.tsx
user_logged_in Fired when a user successfully signs in with password apps/web/src/modules/auth/form/login/password.tsx
magic_link_requested Fired when a user requests a magic link login email apps/web/src/modules/auth/form/login/magic-link.tsx
social_login_initiated Fired when a user clicks a social provider login button apps/web/src/modules/auth/form/social-providers.tsx
anonymous_login_completed Fired when a user successfully signs in anonymously apps/web/src/modules/auth/form/anonymous.tsx
organization_created Fired when a user successfully creates a new organization apps/web/src/modules/organization/create-organization.tsx
organization_deleted Fired when an organization owner deletes their organization apps/web/src/modules/organization/settings/delete-organization.tsx
organization_left Fired when a user leaves an organization apps/web/src/modules/organization/settings/leave-organization.tsx
member_invited Fired when one or more members are successfully invited to an organization apps/web/src/modules/organization/members/invite-member.tsx
checkout_initiated Fired when a user clicks to start a subscription checkout apps/web/src/modules/billing/pricing/plans/plan/hooks/use-plan.tsx
billing_portal_opened Fired when an existing subscriber opens the billing management portal apps/web/src/modules/billing/pricing/plans/plan/hooks/use-plan.tsx

Next steps

We've built some insights and a dashboard for you to keep an eye on user behavior, based on the events we just instrumented:

Agent skill

We've left an agent skill folder in your project. You can use this context for further agent development when using Claude Code. This will help ensure the model provides the most up-to-date approaches for integrating PostHog.