feat(kiloclaw): add claw_trial_started and claw_transaction PostHog events

[pedroheyerdahl]

Summary

Adds two server-side PostHog events to close the KiloClaw funnel visibility gap between signup and paid conversion:

• claw_trial_started — fires in ensureProvisionAccess when a new trial subscription row is created during first provisioning. Properties: user_id, plan, trial_ends_at.
• claw_transaction — fires on invoice.paid for KiloClaw subscription invoices with amount_paid > 0. Wires up the previously-unused invoiceLooksLikeKiloClawByPriceId classifier. Properties: user_id, plan, amount_cents, currency, stripe_invoice_id, stripe_subscription_id.

Both events use google_user_email as distinctId, matching the codebase convention. claw_transaction runs inside after() with IS_IN_AUTOMATED_TEST guard, matching the organization-seats.ts pattern for Stripe webhook PostHog events. claw_trial_started captures inline, matching the user.ts pattern for tRPC-context events.

Verification

• pnpm typecheck — passes (no new errors, all pre-existing)
• oxfmt --list-different — passes
• oxlint — passes (0 warnings, 0 errors)
• eslint — passes
• Pre-push hook (format + lint + typecheck) — passes

Visual Changes

N/A

Reviewer Notes

• The changes are additive — no existing queries or handler logic is modified. The INSERT in ensureProvisionAccess is unchanged (no .returning() chain).
• invoiceLooksLikeKiloClawByPriceId was written previously but never wired up — this PR connects it to the invoice.paid handler in stripe.ts.
• PostHog captures are no-ops outside production (the client returns stubs in dev/test), so these changes cannot affect test behavior.

[kilo-code-bot]

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	1
SUGGESTION	0

Fix these issues in Kilo Cloud

Issue Details (click to expand)

WARNING

File	Line	Issue
src/lib/kiloclaw/stripe-handlers.ts	787	Drops claw_transaction when invoice snapshot metadata is missing

Other Observations (not in diff)

N/A

Files Reviewed (3 files)

• src/lib/kiloclaw/stripe-handlers.ts - 1 issue
• src/lib/stripe.ts - 0 issues
• src/routers/kiloclaw-router.ts - 0 issues

---

_{Reviewed by gpt-5.4-20260305 · 939,259 tokens}

[kilo-code-bot]

WARNING: Missing fallback when the invoice snapshot omits subscription metadata

processStripePaymentEventHook has already classified this invoice as KiloClaw by price ID, but this handler drops the analytics event whenever invoice.parent?.subscription_details?.metadata.kiloUserId is absent. The Kilo Pass invoice.paid path handles the same case by refetching the Stripe subscription and falling back to subscription.metadata; without that fallback here, claw_transaction silently undercounts paid conversions on invoices whose embedded snapshot metadata is missing or stale.