{
  "generatedAt": "2026-06-11T00:00:00Z",
  "source": "Atomic AI public growth funnel contract",
  "truthBoundary": "Targets, event names, and aggregate telemetry only. Conversion rates and builder ranks are directional product telemetry, not verified adoption claims.",
  "backendPersistence": "jsonl aggregate funnel-event writer with hashed sessions and hashed builder IDs",
  "primaryLoop": "Visit -> Try AI -> Generate Agent -> Create Capsule -> Publish or save -> Invite",
  "identityModel": {
    "builderId": "Browser-generated local ID sent with public funnel events and hashed server-side before persistence.",
    "publicLabel": "Published as builder_xxxxxxxx only after hashing.",
    "privateFieldsNotPublished": ["raw IP", "full user agent", "raw session ID", "raw builder ID", "wallet", "contact details"],
    "ranks": ["Observer", "Builder", "Creator", "Architect", "Operator", "Founder"]
  },
  "hardening": {
    "client": ["event allowlist", "agent slug normalization", "short duplicate-event debounce"],
    "server": ["funnel-specific rate limit", "unknown step rejection", "server-side builder hashing", "per-builder daily XP caps"],
    "leaderboardBoundary": "Ranks reflect capped public funnel activity only and are not proof of verified accounts, payments, or token rewards."
  },
  "events": [
    { "name": "visit_home", "description": "Visitor lands on the Atomic AI public home route." },
    { "name": "click_playground", "description": "Visitor clicks toward the no-wallet AI Playground." },
    { "name": "visit_playground", "description": "Visitor opens the AI Playground." },
    { "name": "run_playground", "description": "Visitor submits the playground preview form." },
    { "name": "click_agent_builder", "description": "Visitor clicks toward the instant agent builder." },
    { "name": "visit_agent_builder", "description": "Visitor opens the agent builder route." },
    { "name": "generate_agent", "description": "Visitor generates an agent draft." },
    { "name": "click_capsule", "description": "Visitor clicks toward Capsule registration." },
    { "name": "visit_capsule_registration", "description": "Visitor opens Capsule registration." },
    { "name": "submit_capsule", "description": "Visitor submits the Capsule registration form." },
    { "name": "click_agent_market", "description": "Visitor clicks to starter agent supply." },
    { "name": "click_publish_agent", "description": "Visitor clicks toward marketplace upload or publishing." },
    { "name": "click_referral", "description": "Visitor clicks referral or invite routes." },
    { "name": "visit_referrals", "description": "Visitor opens the referral route." },
    { "name": "try_marketplace_agent", "description": "Visitor clicks a specific starter agent from the marketplace." },
    { "name": "view_agent", "description": "Visitor views or expands interest in a specific agent card." },
    { "name": "run_agent", "description": "Visitor runs a specific agent or preview." },
    { "name": "save_agent", "description": "Visitor saves a specific agent intent before persistent account storage." },
    { "name": "share_agent", "description": "Visitor shares a specific agent intent." },
    { "name": "copy_agent_output", "description": "Visitor copies generated agent or playground output." },
    { "name": "return_visit", "description": "Visitor returns within the local measurement window." },
    { "name": "visit_drk", "description": "Visitor opens the DRK public route." },
    { "name": "visit_drk_utility", "description": "Visitor opens the DRK utility route." },
    { "name": "click_drk_utility", "description": "Visitor clicks toward DRK utility context." },
    { "name": "visit_staking", "description": "Visitor opens the staking route." },
    { "name": "click_staking", "description": "Visitor clicks toward staking context." },
    { "name": "builder_activity", "description": "Derived aggregate profile from hashed builder events, XP, rank, and public-safe action counts." }
  ],
  "targets": [
    { "metric": "Visitor -> Playground", "from": "visit_home", "to": "visit_playground", "targetRate": "30%+" },
    { "metric": "Playground -> Agent Builder", "from": "visit_playground", "to": "visit_agent_builder", "targetRate": "15%+" },
    { "metric": "Agent Builder -> Capsule", "from": "visit_agent_builder", "to": "visit_capsule_registration", "targetRate": "10%+" },
    { "metric": "Capsule -> Referral", "from": "visit_capsule_registration", "to": "visit_referrals", "targetRate": "20%+" },
    { "metric": "Generated Agent -> Publish Intent", "from": "generate_agent", "to": "click_publish_agent", "targetRate": "10%+" }
  ],
  "starterAgentMetrics": [
    "try_marketplace_agent",
    "view_agent",
    "run_agent",
    "agent_card_clicked",
    "agent_draft_generated",
    "save_agent",
    "publish_agent",
    "share_agent",
    "agent_profile_viewed",
    "agent_rating_added",
    "agent_comment_added"
  ],
  "builderMetrics": [
    "xp",
    "rank",
    "activeDays",
    "agentsGenerated",
    "playgroundRuns",
    "marketplaceRuns",
    "agentsSaved",
    "shares",
    "referrals",
    "capsulesSubmitted",
    "publishes",
    "returnVisits"
  ],
  "cohortRetention": {
    "windows": ["D1", "D7", "D30"],
    "method": "Builders are eligible once their first observed public builder day is old enough for the window. Retention is counted only when the same hashed builder has activity on or after that window.",
    "truthBoundary": "Retention is privacy-safe browser-builder telemetry, not verified account retention."
  },
  "topAgentDashboard": {
    "metrics": ["runs", "saves", "shares", "publishIntentRate", "runRate", "saveRate", "shareRate"],
    "truthBoundary": "Agent rankings reflect public marketplace intent events, not paid usage or verified revenue."
  },
  "drkUtilityFunnel": {
    "steps": ["view", "earn", "spend", "stake"],
    "truthBoundary": "DRK utility funnel reflects public intent signals only. It is not proof of verified token transfers, rewards, staking, or payments."
  },
  "founderSignals": {
    "pmfAlertThreshold": { "runs": 100, "saves": 20, "shares": 10, "window": "current aggregate public funnel window" },
    "signals": ["weakestFunnelStep", "topAgentRecommendation", "retentionRecommendation", "drkUtilityRecommendation"],
    "truthBoundary": "Founder signals are directional public telemetry. They are not verified active-user, revenue, token-transfer, staking, or reward claims."
  }
}