Self-Serve Activation Funnel

The self-serve activation funnel turns the shipped trust stack into a guided first-run path. It is intentionally value-first: users see public proof before signup pressure, then move through real product evidence instead of dark-pattern prompts.

Milestones

1. Public score viewed
2. Sample or own repository analyzed
3. First workspace change created
4. Verified deploy created
5. Team invite sent
6. Policy simulation run

Each milestone has a product route, completion proof, and trust note. Downstream steps stay locked until the next incomplete action, which keeps the path focused without hiding evidence.

Runtime Behavior

• The dashboard renders ActivationFunnelCard from getUserActivationFunnel.
• GET /api/activation/funnel?periodDays=90 returns the signed-in user's private funnel snapshot for client surfaces and integrations.
• The service derives progress from analysis history, CODE/Workbench sessions, team invites, deploy analytics, policy analytics, and public score/trust events.
• Deploy completion is captured by POST /api/deploy through deploy_succeeded or deploy_failed product analytics.
• The pure model lives in lib/activation/funnel.ts; persistence mapping lives in lib/activation/service.ts.
• The score is weighted toward real value creation: public proof 10, sample analysis 20, workspace change 25, verified deploy 20, team invite 10, and policy simulation 15.

User API

GET /api/activation/funnel?periodDays=90

The response contains the authenticated user's activation funnel:

{
  "funnel": {
    "status": "guided",
    "score": 55,
    "completedSteps": 3,
    "totalSteps": 6,
    "currentStep": {
      "id": "verified_deploy_created",
      "status": "available"
    }
  }
}

The endpoint is private to the signed-in user and returns a short-lived private cache header.

Trust Guardrails

• Public score evidence comes before deeper capture.
• Activation advances through visible product value, not scarcity.
• Progress is derived from explainable product events and durable user actions.
• Security, deploy, and policy blockers remain visible even when a later upgrade or team path exists.

Operator Notes

The funnel is not a replacement for the Growth & Monetization Flywheel. The flywheel measures aggregate conversion quality; the activation funnel guides an individual account through the first high-value product loop.