@posthog/wizard 2.44.0 → 2.46.0

package/dist/{posthog-integration-BhLKCFsI.js → posthog-integration-Do997QON.js}

@@ -1,18 +1,19 @@
-import { L as Integration, P as HAIKU_MODEL, T as DETECTION_TIMEOUT_MS, _ as evaluateWizardReadiness, f as getUI, g as SIGNUP_WIZARD_READINESS_CONFIG, pt as getSkillsBaseUrl, rt as WIZARD_INTERACTION_EVENT_NAME, s as logToFile, v as getBlockingServiceKeys } from "./debug-DXfQFmcM.js";
-import { n as analytics } from "./analytics-DSlQuwOT.js";
-import { i as withUtm, n as openTrackedLink } from "./telemetry-DZShaH-y.js";
-import { i as tryGetPackageJson, n as isUsingTypeScript } from "./setup-utils-BQCl28D8.js";
-import { r as requestDeepLink } from "./provisioning-jVZm2E-A.js";
-import "./wizard-session-BAZql11N.js";
-import { i as wizardAbort } from "./wizard-abort-C14PzXZ8.js";
-import { n as runAgent } from "./agent-runner-BF6_f8Qh.js";
-import { i as runAgent$1, p as AgentSignals, r as initializeAgent } from "./agent-interface-BvTxWiol.js";
-import { t as WIZARD_TOOL_NAMES } from "./wizard-tools-B7SLjCic.js";
-import { r as detectNodePackageManagers } from "./package-manager-C6R_zpML.js";
-import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-DcoBCMQR.js";
+import { B as Integration, L as HAIKU_MODEL, O as DETECTION_TIMEOUT_MS, _ as evaluateWizardReadiness, f as getUI, g as SIGNUP_WIZARD_READINESS_CONFIG, s as logToFile, st as WIZARD_INTERACTION_EVENT_NAME, v as getBlockingServiceKeys, vt as getSkillsBaseUrl, x as AGENTIC_DETECTION_TIMEOUT_MS } from "./debug-C9HmIrwx.js";
+import { n as analytics } from "./analytics-k76OWsl0.js";
+import { i as withUtm, n as openTrackedLink } from "./telemetry-CYr4HgS2.js";
+import { i as tryGetPackageJson, n as isUsingTypeScript } from "./setup-utils-Cb5uACEO.js";
+import { r as requestDeepLink } from "./provisioning-DpqnGk3z.js";
+import "./wizard-session-tp4Zdbwl.js";
+import { i as wizardAbort } from "./wizard-abort-FuyIaI_0.js";
+import { n as runAgent, o as authenticate } from "./agent-runner-CV3qh_2p.js";
+import { i as runAgent$1, p as AgentSignals, r as initializeAgent, v as WIZARD_TOOL_NAMES } from "./agent-interface-B8roB2UP.js";
+import { m as EVENT_PLAN_FILE } from "./yara-hooks-DdYRRxfH.js";
+import { r as detectNodePackageManagers } from "./package-manager-CAD9Uklp.js";
+import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-DT58jEYr.js";
+import { n as safeReadFile, r as walkProjectFiles } from "./file-utils-CLMcNIKi.js";
 import * as semver from "semver";
-import { readFileSync } from "fs";
-import { isAbsolute, join } from "path";
+import { existsSync, readFileSync, statSync } from "fs";
+import { isAbsolute, join, resolve, sep } from "path";
 import { Text } from "ink";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -263,8 +264,9 @@ const PROJECT_MANIFESTS = [
 function manifestGlob() {
 	return `**/{${PROJECT_MANIFESTS.join(",")}}`;
 }
-function buildPrompt(cwd, targets, purpose) {
+function buildPrompt(cwd, targets, purpose, recommend) {
 	const targetList = targets.map((t) => `- ${t.id} → ${t.name}`).join("\n");
+	const projectShape = `{"path":string,"framework":string,"targetId":string|null,"hasPostHog":boolean${recommend ? ",\"recommended\":boolean" : ""}}`;
 	return [
 		`You are scanning a code repository to ${purpose}. Be fast and mechanical — do not over-explore. Keep any reasoning to one short sentence, then run the tool calls and output the JSON.`,
 		"",
@@ -280,16 +282,18 @@ function buildPrompt(cwd, targets, purpose) {
 		"   - the matching target id from the list below. That list is ordered by priority — most specific first — so when a project could match more than one target (e.g. it uses several of the listed technologies), pick the one listed EARLIEST. Use null only if none matches,",
 		`   - hasPostHog: true if any dependency is a PostHog SDK. This includes: a name containing "posthog" in any ecosystem (e.g. posthog-js, posthog-node, @posthog/*, posthog for pip/gem/hex, a com.posthog:* gradle/maven coordinate, a PostHog NuGet PackageReference); an SPM package named "PostHog" or a repositoryURL of github.com/PostHog/posthog-ios (in Package.swift or a .pbxproj); or a "pod 'PostHog'" line in a Podfile. Else false.`,
 		"   Do NOT read any file other than these manifests.",
+		...recommend ? ["4. Pick exactly ONE project as recommended — the main user-facing client application. Prefer a frontend web app or a mobile app over backend servers/APIs, libraries, CLIs, tooling, and example/demo/docs apps. If several client apps exist, pick the primary production app; if no client app exists, pick the primary application project."] : [],
 		"",
 		"Target ids (id → name), in priority order — most specific first; if several match a project, keep the one listed earliest:",
 		targetList,
 		"",
 		"Output requirements:",
 		"- Respond with ONLY a single JSON object. No prose, no markdown code fences.",
-		"- Shape: {\"repoType\":\"monorepo\"|\"single\",\"projects\":[{\"path\":string,\"framework\":string,\"targetId\":string|null,\"hasPostHog\":boolean}]}",
+		`- Shape: {"repoType":"monorepo"|"single","projects":[${projectShape}]}`,
 		"- \"path\" is the project directory relative to the working directory; use \".\" for the repo root.",
 		"- \"targetId\" MUST be exactly one of the target ids above when it matches; if several match, use the one listed earliest; otherwise null.",
 		"- Include projects whose stack matches no target too (targetId: null).",
+		...recommend ? ["- Exactly one project has \"recommended\": true; every other project has \"recommended\": false."] : [],
 		`- If there are no manifests at all, respond with exactly: ${AgentSignals.ABORT} detection failed`
 	].join("\n");
 }
@@ -311,107 +315,2125 @@ function coercePath(raw) {
 	if (isAbsolute(raw) || raw.split(/[\\/]/).includes("..")) return ".";
 	return raw;
 }
+/** Resolve an agent-reported path to an absolute dir clamped to the root — the caller-side counterpart of coercePath. */
+function resolveProjectDir(installDir, rel) {
+	if (typeof rel !== "string" || rel === ".") return installDir;
+	const root = resolve(installDir);
+	const dir = resolve(root, rel);
+	return dir === root || dir.startsWith(root + sep) ? dir : root;
+}
+/**
+* Validate the agent's raw JSON into a report, clamping each targetId to the
+* supplied set and each path to a repo-relative dir. Exported for testing.
+* `recommended` is stripped unless requested; at most one (the first) survives.
+*/
+function coerceAgenticReport(parsed, validTargetIds, options) {
+	const recommend = options?.recommend === true;
+	const obj = parsed ?? {};
+	const repoType = obj.repoType === "monorepo" ? "monorepo" : "single";
+	const rawProjects = Array.isArray(obj.projects) ? obj.projects : [];
+	let recommendedSeen = false;
+	return {
+		repoType,
+		projects: rawProjects.map((raw) => {
+			const p = raw ?? {};
+			const targetId = typeof p.targetId === "string" && validTargetIds.includes(p.targetId) ? p.targetId : null;
+			const recommended = recommend && !recommendedSeen && p.recommended === true;
+			recommendedSeen ||= recommended;
+			return {
+				path: coercePath(p.path),
+				framework: typeof p.framework === "string" ? p.framework : "Unknown",
+				targetId,
+				hasPostHog: p.hasPostHog === true,
+				...recommend ? { recommended } : {}
+			};
+		})
+	};
+}
+function formatToolUse(block) {
+	const name = typeof block?.name === "string" ? block.name : "tool";
+	const input = block?.input ?? {};
+	const detail = input.file_path || input.pattern || input.path || "";
+	return detail ? `${name} ${detail}` : name;
+}
+function sessionToWizardOptions(session) {
+	return {
+		installDir: session.installDir,
+		ci: session.ci,
+		debug: session.debug,
+		default: false,
+		benchmark: session.benchmark,
+		yaraReport: session.yaraReport,
+		signup: session.signup,
+		apiKey: session.apiKey,
+		projectId: session.projectId,
+		localMcp: session.localMcp
+	};
+}
+const NOOP_SPINNER = {
+	start: () => void 0,
+	stop: () => void 0,
+	message: () => void 0
+};
+/**
+* Drive the wizard's agent loop on HAIKU_MODEL to scan the repo and return a
+* structured detection report. Reuses the same setup every program uses, so
+* MCP, tools, and credentials are wired identically.
+*/
+async function detectProjectsWithAgent(session, options) {
+	if (!session.credentials) throw new Error("Detection requires authenticated credentials.");
+	const { targets, purpose = "set up a PostHog integration", recommend = false, onEvent } = options;
+	const { accessToken, host } = session.credentials;
+	const cwd = session.installDir;
+	const runOptions = sessionToWizardOptions(session);
+	const agent = await initializeAgent({
+		workingDirectory: cwd,
+		posthogMcpUrl: host.mcpUrl,
+		posthogApiKey: accessToken,
+		host,
+		detectPackageManager: detectNodePackageManagers,
+		skillsBaseUrl: getSkillsBaseUrl(session.localMcp),
+		integrationLabel: "agentic-detect",
+		allowedTools: [
+			"Read",
+			"Grep",
+			"Glob"
+		],
+		modelOverride: HAIKU_MODEL
+	}, runOptions);
+	const collected = [];
+	let resultText = "";
+	const result = await runAgent$1(agent, buildPrompt(cwd, targets, purpose, recommend), runOptions, NOOP_SPINNER, {
+		spinnerMessage: "Scanning the repo...",
+		successMessage: "Detection complete",
+		errorMessage: "Detection failed",
+		requestRemark: false
+	}, {
+		onMessage: (message) => {
+			if (message?.type === "assistant") {
+				for (const block of message.message?.content ?? []) if (block?.type === "text" && typeof block.text === "string") {
+					collected.push(block.text);
+					const line = block.text.trim();
+					if (line && onEvent) onEvent(line.length > 100 ? `${line.slice(0, 100)}…` : line);
+				} else if (block?.type === "tool_use") onEvent?.(formatToolUse(block));
+			} else if (message?.type === "result" && typeof message.result === "string") resultText = message.result;
+		},
+		finalize: (_resultMessage, _durationMs) => void 0
+	});
+	if (result.error) throw new Error(result.message || `Agent error: ${result.error}`);
+	const output = resultText || collected.join("\n");
+	try {
+		return coerceAgenticReport(extractJson(output), targets.map((t) => t.id), { recommend });
+	} catch (err) {
+		if (output.includes(AgentSignals.ABORT)) return {
+			repoType: "single",
+			projects: []
+		};
+		throw err;
+	}
+}
+//#endregion
+//#region src/lib/detection/project-scope.ts
+/** Non-interactive project scoping — scan the repo agentically and pick which project the run integrates. */
+/** Integration framework targets for the agentic detector (id → display name). */
+const INTEGRATION_TARGETS = Object.entries(FRAMEWORK_REGISTRY).map(([id, config]) => ({
+	id,
+	name: config.metadata.name
+}));
+/** Run the agentic detector for the wizard's integration frameworks — the single home of targets + purpose. */
+async function detectIntegrationProjects(session, options = {}) {
+	return detectProjectsWithAgent(session, {
+		...options,
+		targets: INTEGRATION_TARGETS,
+		purpose: "set up a PostHog SDK integration"
+	});
+}
+/** Pick the recommended-if-supported project (even with PostHog — the main app wins), else the first supported PostHog-free one. */
+function chooseIntegrationProject(projects) {
+	return projects.find((p) => p.recommended === true && p.targetId != null) ?? projects.find((p) => p.targetId != null && !p.hasPostHog);
+}
+/** Sentinel for a scan that outran AGENTIC_DETECTION_TIMEOUT_MS. */
+const TIMED_OUT = Symbol("timed-out");
+function captureOutcome(outcome, properties = {}) {
+	analytics.wizardCapture("agentic detection", {
+		outcome,
+		...properties
+	});
+}
+/** Flag-gated non-interactive monorepo phase: scan, auto-choose the recommended project, re-point session.installDir; every failure leaves the session untouched. */
+async function scopeInstallDirToProject(session) {
+	await authenticate(session, "posthog-integration");
+	if ((await analytics.getAllFlagsForWizard())["wizard-basic-integration-agentic-detection"] !== "true") {
+		captureOutcome("flag-off");
+		return;
+	}
+	getUI().log.info("Scanning the repo for projects...");
+	const startedAt = Date.now();
+	let report;
+	try {
+		report = await Promise.race([detectIntegrationProjects(session, {
+			recommend: true,
+			onEvent: (line) => logToFile("[agentic detect]", line)
+		}), new Promise((resolve) => setTimeout(() => resolve(TIMED_OUT), AGENTIC_DETECTION_TIMEOUT_MS))]);
+	} catch (err) {
+		const error = err instanceof Error ? err : new Error(String(err));
+		analytics.captureException(error, { step: "agentic_detection" });
+		captureOutcome("error", {
+			duration_ms: Date.now() - startedAt,
+			error_message: error.message
+		});
+		getUI().log.warn(`Project scan failed (${error.message}); continuing with the install dir as-is.`);
+		return;
+	}
+	if (report === TIMED_OUT) {
+		captureOutcome("timeout", { duration_ms: Date.now() - startedAt });
+		getUI().log.warn(`Project scan timed out after ${AGENTIC_DETECTION_TIMEOUT_MS / 1e3}s; continuing with the install dir as-is.`);
+		return;
+	}
+	const { projects } = report;
+	const recommended = projects.find((p) => p.recommended === true);
+	const scanProperties = {
+		duration_ms: Date.now() - startedAt,
+		repo_type: report.repoType,
+		project_count: projects.length,
+		supported_count: projects.filter((p) => p.targetId != null).length,
+		has_recommendation: recommended !== void 0,
+		recommended_path: recommended?.path ?? null,
+		projects
+	};
+	const project = chooseIntegrationProject(projects);
+	if (!project) {
+		captureOutcome("no-project", scanProperties);
+		getUI().log.info("The scan found no supported project; continuing with the install dir as-is.");
+		return;
+	}
+	session.installDir = resolveProjectDir(session.installDir, project.path);
+	captureOutcome(project.recommended ? "recommended" : "first-instrumentable", {
+		...scanProperties,
+		chosen_framework: project.targetId,
+		chosen_path: project.path
+	});
+	getUI().log.info(`Continuing with ${project.path} (${project.framework}).`);
+}
+//#endregion
+//#region src/lib/warehouse-sources/registry.ts
+const SOURCE_DETECTORS = [
+	{
+		kind: "Postgres",
+		label: "PostgreSQL",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"pg",
+				"postgres",
+				"postgres.js",
+				"knex",
+				"sequelize"
+			],
+			python: [
+				"psycopg",
+				"psycopg2",
+				"psycopg2-binary",
+				"asyncpg"
+			],
+			ruby: ["pg"],
+			envKeys: [
+				/^DATABASE_URL$/,
+				/^POSTGRES_/,
+				/^PG(HOST|DATABASE|USER|PORT)$/
+			]
+		}
+	},
+	{
+		kind: "MySQL",
+		label: "MySQL",
+		mode: "in-cli",
+		signals: {
+			npm: ["mysql", "mysql2"],
+			python: [
+				"pymysql",
+				"mysqlclient",
+				"mysql-connector-python"
+			],
+			ruby: ["mysql2"],
+			envKeys: [/^MYSQL_/]
+		}
+	},
+	{
+		kind: "MongoDB",
+		label: "MongoDB",
+		mode: "in-cli",
+		signals: {
+			npm: ["mongodb", "mongoose"],
+			python: ["pymongo", "motor"],
+			ruby: ["mongo", "mongoid"],
+			envKeys: [/^MONGO(DB)?_/]
+		}
+	},
+	{
+		kind: "Snowflake",
+		label: "Snowflake",
+		mode: "in-cli",
+		signals: {
+			npm: ["snowflake-sdk"],
+			python: ["snowflake-connector-python", "snowflake-sqlalchemy"],
+			envKeys: [/^SNOWFLAKE_/]
+		}
+	},
+	{
+		kind: "BigQuery",
+		label: "BigQuery",
+		mode: "in-cli",
+		signals: {
+			npm: ["@google-cloud/bigquery"],
+			python: ["google-cloud-bigquery"],
+			envKeys: [/^BIGQUERY_/]
+		}
+	},
+	{
+		kind: "Redshift",
+		label: "Redshift",
+		mode: "in-cli",
+		signals: {
+			npm: ["node-redshift"],
+			python: ["redshift-connector"],
+			envKeys: [/^REDSHIFT_/]
+		}
+	},
+	{
+		kind: "MSSQL",
+		label: "SQL Server",
+		mode: "in-cli",
+		signals: {
+			npm: ["mssql", "tedious"],
+			python: ["pyodbc", "pymssql"],
+			envKeys: [/^MSSQL_/]
+		}
+	},
+	{
+		kind: "Supabase",
+		label: "Supabase",
+		mode: "in-cli",
+		signals: {
+			npm: ["@supabase/supabase-js"],
+			python: ["supabase"],
+			envKeys: [/^SUPABASE_/]
+		}
+	},
+	{
+		kind: "ClickHouse",
+		label: "ClickHouse",
+		mode: "in-cli",
+		signals: {
+			npm: ["@clickhouse/client"],
+			python: ["clickhouse-connect", "clickhouse-driver"],
+			envKeys: [/^CLICKHOUSE_/]
+		}
+	},
+	{
+		kind: "Convex",
+		label: "Convex",
+		mode: "in-cli",
+		signals: {
+			npm: ["convex"],
+			python: ["convex"],
+			envKeys: [/^CONVEX_/, /^NEXT_PUBLIC_CONVEX_URL$/]
+		}
+	},
+	{
+		kind: "Stripe",
+		label: "Stripe",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"stripe",
+				"@stripe/stripe-js",
+				"@stripe/react-stripe-js"
+			],
+			python: ["stripe"],
+			ruby: ["stripe"],
+			envKeys: [/^STRIPE_(SECRET|API)_KEY$/]
+		}
+	},
+	{
+		kind: "Clerk",
+		label: "Clerk",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@clerk/nextjs",
+				"@clerk/clerk-react",
+				"@clerk/backend",
+				"@clerk/express",
+				"@clerk/fastify",
+				"@clerk/remix"
+			],
+			envKeys: [/^CLERK_SECRET_KEY$/, /^NEXT_PUBLIC_CLERK_/]
+		}
+	},
+	{
+		kind: "Resend",
+		label: "Resend",
+		mode: "in-cli",
+		signals: {
+			npm: ["resend"],
+			python: ["resend"],
+			envKeys: [/^RESEND_API_KEY$/]
+		}
+	},
+	{
+		kind: "Shopify",
+		label: "Shopify",
+		mode: "in-cli",
+		signals: {
+			npm: ["@shopify/shopify-api", "shopify-api-node"],
+			python: ["shopifyapi"],
+			envKeys: [/^SHOPIFY_/]
+		}
+	},
+	{
+		kind: "Klaviyo",
+		label: "Klaviyo",
+		mode: "in-cli",
+		signals: {
+			npm: ["klaviyo-api"],
+			python: ["klaviyo-api"],
+			envKeys: [/^KLAVIYO_/]
+		}
+	},
+	{
+		kind: "Chargebee",
+		label: "Chargebee",
+		mode: "in-cli",
+		signals: {
+			npm: ["chargebee"],
+			python: ["chargebee"],
+			envKeys: [/^CHARGEBEE_/]
+		}
+	},
+	{
+		kind: "Paddle",
+		label: "Paddle",
+		mode: "in-cli",
+		signals: {
+			npm: ["@paddle/paddle-node-sdk", "@paddle/paddle-js"],
+			envKeys: [/^PADDLE_/]
+		}
+	},
+	{
+		kind: "Polar",
+		label: "Polar",
+		mode: "in-cli",
+		signals: {
+			npm: ["@polar-sh/sdk", "@polar-sh/nextjs"],
+			envKeys: [/^POLAR_/]
+		}
+	},
+	{
+		kind: "Mailchimp",
+		label: "Mailchimp",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mailchimp/mailchimp_marketing"],
+			python: ["mailchimp-marketing"],
+			envKeys: [/^MAILCHIMP_/]
+		}
+	},
+	{
+		kind: "CustomerIO",
+		label: "Customer.io",
+		mode: "in-cli",
+		signals: {
+			npm: ["customerio-node"],
+			python: ["customerio"],
+			envKeys: [/^CUSTOMER_?IO_/]
+		}
+	},
+	{
+		kind: "Typeform",
+		label: "Typeform",
+		mode: "in-cli",
+		signals: {
+			npm: ["@typeform/api-client"],
+			envKeys: [/^TYPEFORM_/]
+		}
+	},
+	{
+		kind: "Sentry",
+		label: "Sentry",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@sentry/node",
+				"@sentry/browser",
+				"@sentry/react",
+				"@sentry/nextjs"
+			],
+			python: ["sentry-sdk"],
+			ruby: ["sentry-ruby"]
+		}
+	},
+	{
+		kind: "Plaid",
+		label: "Plaid",
+		mode: "in-cli",
+		signals: {
+			npm: ["plaid"],
+			python: ["plaid-python", "plaid"],
+			ruby: ["plaid"],
+			envKeys: [/^PLAID_/]
+		}
+	},
+	{
+		kind: "Braintree",
+		label: "Braintree",
+		mode: "in-cli",
+		signals: {
+			npm: ["braintree"],
+			python: ["braintree"],
+			ruby: ["braintree"],
+			envKeys: [/^BRAINTREE_/]
+		}
+	},
+	{
+		kind: "Square",
+		label: "Square",
+		mode: "in-cli",
+		signals: {
+			npm: ["square"],
+			python: ["squareup"],
+			ruby: ["square"],
+			envKeys: [/^SQUARE_/]
+		}
+	},
+	{
+		kind: "GoCardless",
+		label: "GoCardless",
+		mode: "in-cli",
+		signals: {
+			npm: ["gocardless-nodejs"],
+			python: ["gocardless-pro"],
+			ruby: ["gocardless_pro"],
+			envKeys: [/^GOCARDLESS_/]
+		}
+	},
+	{
+		kind: "Mollie",
+		label: "Mollie",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mollie/api-client"],
+			python: ["mollie-api-python"],
+			envKeys: [/^MOLLIE_/]
+		}
+	},
+	{
+		kind: "CheckoutCom",
+		label: "Checkout.com",
+		mode: "in-cli",
+		signals: {
+			npm: ["checkout-sdk-node"],
+			python: ["checkout-sdk"],
+			envKeys: [/^CKO_/, /^CHECKOUT_COM_/]
+		}
+	},
+	{
+		kind: "Recurly",
+		label: "Recurly",
+		mode: "in-cli",
+		signals: {
+			npm: ["recurly"],
+			python: ["recurly"],
+			ruby: ["recurly"],
+			envKeys: [/^RECURLY_/]
+		}
+	},
+	{
+		kind: "RevenueCat",
+		label: "RevenueCat",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@revenuecat/purchases-js",
+				"react-native-purchases",
+				"@revenuecat/purchases-capacitor"
+			],
+			envKeys: [/^REVENUE_?CAT_/]
+		}
+	},
+	{
+		kind: "Twilio",
+		label: "Twilio",
+		mode: "in-cli",
+		signals: {
+			npm: ["twilio"],
+			python: ["twilio"],
+			ruby: ["twilio-ruby"],
+			envKeys: [/^TWILIO_/]
+		}
+	},
+	{
+		kind: "SendGrid",
+		label: "SendGrid",
+		mode: "in-cli",
+		signals: {
+			npm: ["@sendgrid/mail", "@sendgrid/client"],
+			python: ["sendgrid"],
+			ruby: ["sendgrid-ruby"],
+			envKeys: [/^SENDGRID_/]
+		}
+	},
+	{
+		kind: "Mailgun",
+		label: "Mailgun",
+		mode: "in-cli",
+		signals: {
+			npm: ["mailgun.js", "mailgun-js"],
+			python: ["mailgun"],
+			ruby: ["mailgun-ruby"],
+			envKeys: [/^MAILGUN_/]
+		}
+	},
+	{
+		kind: "Postmark",
+		label: "Postmark",
+		mode: "in-cli",
+		signals: {
+			npm: ["postmark"],
+			python: ["postmarker"],
+			ruby: ["postmark"],
+			envKeys: [/^POSTMARK_/]
+		}
+	},
+	{
+		kind: "Brevo",
+		label: "Brevo",
+		mode: "in-cli",
+		signals: {
+			npm: ["@getbrevo/brevo", "sib-api-v3-sdk"],
+			python: ["sib-api-v3-sdk"],
+			envKeys: [/^BREVO_/]
+		}
+	},
+	{
+		kind: "MailerLite",
+		label: "MailerLite",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mailerlite/mailerlite-nodejs"],
+			python: ["mailerlite"],
+			envKeys: [/^MAILERLITE_/]
+		}
+	},
+	{
+		kind: "Mailjet",
+		label: "Mailjet",
+		mode: "in-cli",
+		signals: {
+			npm: ["node-mailjet"],
+			python: ["mailjet-rest"],
+			envKeys: [/^MAILJET_/, /^MJ_APIKEY_/]
+		}
+	},
+	{
+		kind: "LaunchDarkly",
+		label: "LaunchDarkly",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"launchdarkly-node-server-sdk",
+				"@launchdarkly/node-server-sdk",
+				"launchdarkly-js-client-sdk",
+				"launchdarkly-react-client-sdk"
+			],
+			python: ["launchdarkly-server-sdk"],
+			ruby: ["launchdarkly-server-sdk"],
+			envKeys: [/^LAUNCHDARKLY_/, /^LD_SDK_KEY$/]
+		}
+	},
+	{
+		kind: "Optimizely",
+		label: "Optimizely",
+		mode: "in-cli",
+		signals: {
+			npm: ["@optimizely/optimizely-sdk"],
+			python: ["optimizely-sdk"],
+			envKeys: [/^OPTIMIZELY_/]
+		}
+	},
+	{
+		kind: "Braze",
+		label: "Braze",
+		mode: "in-cli",
+		signals: {
+			npm: ["@braze/web-sdk", "@braze/react-native-sdk"],
+			python: ["braze-client"],
+			envKeys: [/^BRAZE_/]
+		}
+	},
+	{
+		kind: "Rollbar",
+		label: "Rollbar",
+		mode: "in-cli",
+		signals: {
+			npm: ["rollbar"],
+			python: ["rollbar", "pyrollbar"],
+			ruby: ["rollbar"],
+			envKeys: [/^ROLLBAR_/]
+		}
+	},
+	{
+		kind: "Okta",
+		label: "Okta",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@okta/okta-sdk-nodejs",
+				"@okta/okta-auth-js",
+				"@okta/okta-react"
+			],
+			python: ["okta"],
+			envKeys: [/^OKTA_/]
+		}
+	},
+	{
+		kind: "WorkOS",
+		label: "WorkOS",
+		mode: "in-cli",
+		signals: {
+			npm: ["@workos-inc/node"],
+			python: ["workos"],
+			envKeys: [/^WORKOS_/]
+		}
+	},
+	{
+		kind: "Notion",
+		label: "Notion",
+		mode: "in-cli",
+		signals: {
+			npm: ["@notionhq/client"],
+			python: ["notion-client"],
+			envKeys: [/^NOTION_/]
+		}
+	},
+	{
+		kind: "FullStory",
+		label: "FullStory",
+		mode: "in-cli",
+		signals: {
+			npm: ["@fullstory/browser", "@fullstory/react-native"],
+			envKeys: [/^FULLSTORY_/]
+		}
+	},
+	{
+		kind: "Amplitude",
+		label: "Amplitude",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@amplitude/analytics-browser",
+				"@amplitude/analytics-node",
+				"@amplitude/analytics-react-native",
+				"amplitude-js"
+			],
+			python: ["amplitude-analytics"],
+			envKeys: [/^AMPLITUDE_/]
+		}
+	},
+	{
+		kind: "Mixpanel",
+		label: "Mixpanel",
+		mode: "in-cli",
+		signals: {
+			npm: ["mixpanel", "mixpanel-browser"],
+			python: ["mixpanel"],
+			ruby: ["mixpanel-ruby"],
+			envKeys: [/^MIXPANEL_/]
+		}
+	},
+	{
+		kind: "Pendo",
+		label: "Pendo",
+		mode: "in-cli",
+		signals: {
+			npm: ["@pendo/agent"],
+			envKeys: [/^PENDO_/]
+		}
+	},
+	{
+		kind: "Salesforce",
+		label: "Salesforce",
+		mode: "deep-link",
+		signals: {
+			npm: ["jsforce"],
+			python: ["simple-salesforce"],
+			envKeys: [/^SALESFORCE_/]
+		}
+	},
+	{
+		kind: "Hubspot",
+		label: "HubSpot",
+		mode: "deep-link",
+		signals: {
+			npm: ["@hubspot/api-client"],
+			python: ["hubspot-api-client"],
+			envKeys: [/^HUBSPOT_/]
+		}
+	},
+	{
+		kind: "Zendesk",
+		label: "Zendesk",
+		mode: "deep-link",
+		signals: {
+			npm: ["node-zendesk"],
+			python: ["zenpy"],
+			envKeys: [/^ZENDESK_/]
+		}
+	},
+	{
+		kind: "Intercom",
+		label: "Intercom",
+		mode: "deep-link",
+		signals: {
+			npm: ["intercom-client", "@intercom/messenger-js-sdk"],
+			python: ["python-intercom"],
+			envKeys: [/^INTERCOM_/]
+		}
+	},
+	{
+		kind: "Linear",
+		label: "Linear",
+		mode: "deep-link",
+		signals: {
+			npm: ["@linear/sdk"],
+			envKeys: [/^LINEAR_API_KEY$/]
+		}
+	},
+	{
+		kind: "Slack",
+		label: "Slack",
+		mode: "deep-link",
+		signals: {
+			npm: ["@slack/web-api", "@slack/bolt"],
+			python: ["slack-sdk", "slack-bolt"],
+			envKeys: [/^SLACK_(BOT|APP|SIGNING|CLIENT)_/]
+		}
+	},
+	{
+		kind: "Github",
+		label: "GitHub",
+		mode: "deep-link",
+		signals: {
+			npm: [
+				"@octokit/rest",
+				"@octokit/core",
+				"@octokit/graphql",
+				"octokit"
+			],
+			python: ["pygithub"],
+			ruby: ["octokit"]
+		}
+	},
+	{
+		kind: "OpenAI",
+		label: "OpenAI",
+		mode: "in-cli",
+		signals: {
+			npm: ["openai"],
+			python: ["openai"],
+			envKeys: [/^OPENAI_/]
+		}
+	},
+	{
+		kind: "Anthropic",
+		label: "Anthropic",
+		mode: "in-cli",
+		signals: {
+			npm: ["@anthropic-ai/sdk"],
+			python: ["anthropic"],
+			envKeys: [/^ANTHROPIC_/]
+		}
+	},
+	{
+		kind: "Cohere",
+		label: "Cohere",
+		mode: "in-cli",
+		signals: {
+			npm: ["cohere-ai"],
+			python: ["cohere"],
+			envKeys: [/^COHERE_/]
+		}
+	},
+	{
+		kind: "MistralAI",
+		label: "Mistral AI",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mistralai/mistralai"],
+			python: ["mistralai"],
+			envKeys: [/^MISTRAL_/]
+		}
+	},
+	{
+		kind: "Groq",
+		label: "Groq",
+		mode: "in-cli",
+		signals: {
+			npm: ["groq-sdk"],
+			python: ["groq"],
+			envKeys: [/^GROQ_/]
+		}
+	},
+	{
+		kind: "TogetherAI",
+		label: "Together AI",
+		mode: "in-cli",
+		signals: {
+			npm: ["together-ai"],
+			python: ["together"],
+			envKeys: [/^TOGETHER_/]
+		}
+	},
+	{
+		kind: "FireworksAI",
+		label: "Fireworks AI",
+		mode: "in-cli",
+		signals: {
+			python: ["fireworks-ai"],
+			envKeys: [/^FIREWORKS_/]
+		}
+	},
+	{
+		kind: "Replicate",
+		label: "Replicate",
+		mode: "in-cli",
+		signals: {
+			npm: ["replicate"],
+			python: ["replicate"],
+			envKeys: [/^REPLICATE_/]
+		}
+	},
+	{
+		kind: "HuggingFace",
+		label: "Hugging Face",
+		mode: "in-cli",
+		signals: {
+			npm: ["@huggingface/inference"],
+			python: ["huggingface-hub"],
+			envKeys: [/^HUGGINGFACE_/, /^HF_TOKEN$/]
+		}
+	},
+	{
+		kind: "ElevenLabs",
+		label: "ElevenLabs",
+		mode: "in-cli",
+		signals: {
+			npm: ["@elevenlabs/elevenlabs-js", "elevenlabs"],
+			python: ["elevenlabs"],
+			envKeys: [/^ELEVENLABS_/, /^ELEVEN_LABS_/]
+		}
+	},
+	{
+		kind: "Deepgram",
+		label: "Deepgram",
+		mode: "in-cli",
+		signals: {
+			npm: ["@deepgram/sdk"],
+			python: ["deepgram-sdk"],
+			envKeys: [/^DEEPGRAM_/]
+		}
+	},
+	{
+		kind: "AssemblyAI",
+		label: "AssemblyAI",
+		mode: "in-cli",
+		signals: {
+			npm: ["assemblyai"],
+			python: ["assemblyai"],
+			envKeys: [/^ASSEMBLYAI_/]
+		}
+	},
+	{
+		kind: "Langfuse",
+		label: "Langfuse",
+		mode: "in-cli",
+		signals: {
+			npm: ["langfuse"],
+			python: ["langfuse"],
+			envKeys: [/^LANGFUSE_/]
+		}
+	},
+	{
+		kind: "LangSmith",
+		label: "LangSmith",
+		mode: "in-cli",
+		signals: {
+			npm: ["langsmith"],
+			python: ["langsmith"],
+			envKeys: [/^LANGSMITH_/, /^LANGCHAIN_API_KEY$/]
+		}
+	},
+	{
+		kind: "Firecrawl",
+		label: "Firecrawl",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mendable/firecrawl-js"],
+			python: ["firecrawl-py"],
+			envKeys: [/^FIRECRAWL_/]
+		}
+	},
+	{
+		kind: "Mem0",
+		label: "Mem0",
+		mode: "in-cli",
+		signals: {
+			npm: ["mem0ai"],
+			python: ["mem0ai"],
+			envKeys: [/^MEM0_/]
+		}
+	},
+	{
+		kind: "Vellum",
+		label: "Vellum",
+		mode: "in-cli",
+		signals: {
+			npm: ["vellum-ai"],
+			python: ["vellum-ai"],
+			envKeys: [/^VELLUM_/]
+		}
+	},
+	{
+		kind: "Helicone",
+		label: "Helicone",
+		mode: "in-cli",
+		signals: {
+			npm: ["@helicone/helpers"],
+			envKeys: [/^HELICONE_/]
+		}
+	},
+	{
+		kind: "OpenRouter",
+		label: "OpenRouter",
+		mode: "in-cli",
+		signals: {
+			npm: ["@openrouter/ai-sdk-provider"],
+			envKeys: [/^OPENROUTER_/]
+		}
+	},
+	{
+		kind: "Paystack",
+		label: "Paystack",
+		mode: "in-cli",
+		signals: {
+			python: ["paystackapi"],
+			envKeys: [/^PAYSTACK_/]
+		}
+	},
+	{
+		kind: "Orb",
+		label: "Orb",
+		mode: "in-cli",
+		signals: {
+			npm: ["orb-billing"],
+			python: ["orb-billing"],
+			envKeys: [/^ORB_/]
+		}
+	},
+	{
+		kind: "Lago",
+		label: "Lago",
+		mode: "in-cli",
+		signals: {
+			npm: ["lago-javascript-client"],
+			python: ["lago-python-client"],
+			envKeys: [/^LAGO_/]
+		}
+	},
+	{
+		kind: "Zuora",
+		label: "Zuora",
+		mode: "in-cli",
+		signals: { envKeys: [/^ZUORA_/] }
+	},
+	{
+		kind: "Stigg",
+		label: "Stigg",
+		mode: "in-cli",
+		signals: {
+			npm: ["@stigg/node-server-sdk"],
+			envKeys: [/^STIGG_/]
+		}
+	},
+	{
+		kind: "Ramp",
+		label: "Ramp",
+		mode: "in-cli",
+		signals: { envKeys: [/^RAMP_/] }
+	},
+	{
+		kind: "Brex",
+		label: "Brex",
+		mode: "in-cli",
+		signals: { envKeys: [/^BREX_/] }
+	},
+	{
+		kind: "Tremendous",
+		label: "Tremendous",
+		mode: "in-cli",
+		signals: { envKeys: [/^TREMENDOUS_/] }
+	},
+	{
+		kind: "Maxio",
+		label: "Maxio",
+		mode: "in-cli",
+		signals: { envKeys: [/^MAXIO_/] }
+	},
+	{
+		kind: "Chargify",
+		label: "Chargify",
+		mode: "in-cli",
+		signals: { envKeys: [/^CHARGIFY_/] }
+	},
+	{
+		kind: "Invoiced",
+		label: "Invoiced",
+		mode: "in-cli",
+		signals: {
+			npm: ["invoiced"],
+			python: ["invoiced"],
+			envKeys: [/^INVOICED_/]
+		}
+	},
+	{
+		kind: "SparkPost",
+		label: "SparkPost",
+		mode: "in-cli",
+		signals: {
+			npm: ["sparkpost"],
+			python: ["sparkpost"],
+			envKeys: [/^SPARKPOST_/]
+		}
+	},
+	{
+		kind: "MailerSend",
+		label: "MailerSend",
+		mode: "in-cli",
+		signals: {
+			npm: ["mailersend"],
+			python: ["mailersend"],
+			envKeys: [/^MAILERSEND_/]
+		}
+	},
+	{
+		kind: "Iterable",
+		label: "Iterable",
+		mode: "in-cli",
+		signals: { envKeys: [/^ITERABLE_/] }
+	},
+	{
+		kind: "ConvertKit",
+		label: "ConvertKit",
+		mode: "in-cli",
+		signals: { envKeys: [/^CONVERTKIT_/] }
+	},
+	{
+		kind: "Drip",
+		label: "Drip",
+		mode: "in-cli",
+		signals: {
+			npm: ["drip-nodejs"],
+			envKeys: [/^DRIP_/]
+		}
+	},
+	{
+		kind: "Omnisend",
+		label: "Omnisend",
+		mode: "in-cli",
+		signals: { envKeys: [/^OMNISEND_/] }
+	},
+	{
+		kind: "EmailOctopus",
+		label: "EmailOctopus",
+		mode: "in-cli",
+		signals: { envKeys: [/^EMAILOCTOPUS_/, /^EMAIL_OCTOPUS_/] }
+	},
+	{
+		kind: "Elasticemail",
+		label: "Elastic Email",
+		mode: "in-cli",
+		signals: { envKeys: [/^ELASTICEMAIL_/, /^ELASTIC_EMAIL_/] }
+	},
+	{
+		kind: "CampaignMonitor",
+		label: "Campaign Monitor",
+		mode: "in-cli",
+		signals: {
+			npm: ["createsend-node"],
+			envKeys: [/^CAMPAIGN_MONITOR_/, /^CREATESEND_/]
+		}
+	},
+	{
+		kind: "Lemlist",
+		label: "Lemlist",
+		mode: "in-cli",
+		signals: { envKeys: [/^LEMLIST_/] }
+	},
+	{
+		kind: "Segment",
+		label: "Segment",
+		mode: "in-cli",
+		signals: {
+			npm: ["@segment/analytics-node", "analytics-node"],
+			python: ["segment-analytics-python", "analytics-python"],
+			envKeys: [/^SEGMENT_/]
+		}
+	},
+	{
+		kind: "Snowplow",
+		label: "Snowplow Analytics",
+		mode: "in-cli",
+		signals: {
+			npm: ["@snowplow/node-tracker"],
+			python: ["snowplow-tracker"],
+			envKeys: [/^SNOWPLOW_/]
+		}
+	},
+	{
+		kind: "Matomo",
+		label: "Matomo",
+		mode: "in-cli",
+		signals: {
+			npm: ["matomo-tracker"],
+			envKeys: [/^MATOMO_/]
+		}
+	},
+	{
+		kind: "Plausible",
+		label: "Plausible",
+		mode: "in-cli",
+		signals: {
+			npm: ["plausible-tracker"],
+			envKeys: [/^PLAUSIBLE_/]
+		}
+	},
+	{
+		kind: "ConfigCat",
+		label: "ConfigCat",
+		mode: "in-cli",
+		signals: {
+			npm: ["configcat-node", "configcat-js"],
+			python: ["configcat-client"],
+			envKeys: [/^CONFIGCAT_/]
+		}
+	},
+	{
+		kind: "Flagsmith",
+		label: "Flagsmith",
+		mode: "in-cli",
+		signals: {
+			npm: ["flagsmith-nodejs", "flagsmith"],
+			python: ["flagsmith"],
+			envKeys: [/^FLAGSMITH_/]
+		}
+	},
+	{
+		kind: "Unleash",
+		label: "Unleash",
+		mode: "in-cli",
+		signals: {
+			npm: ["unleash-client"],
+			python: ["unleashclient"],
+			envKeys: [/^UNLEASH_/]
+		}
+	},
+	{
+		kind: "SplitIo",
+		label: "Split.io",
+		mode: "in-cli",
+		signals: {
+			npm: ["@splitsoftware/splitio"],
+			python: ["splitio-client"],
+			envKeys: [/^SPLITIO_/, /^SPLIT_IO_/]
+		}
+	},
+	{
+		kind: "Stytch",
+		label: "Stytch",
+		mode: "in-cli",
+		signals: {
+			npm: ["stytch"],
+			python: ["stytch"],
+			envKeys: [/^STYTCH_/]
+		}
+	},
+	{
+		kind: "Doppler",
+		label: "Doppler",
+		mode: "in-cli",
+		signals: {
+			npm: ["@dopplerhq/node-sdk"],
+			envKeys: [/^DOPPLER_/]
+		}
+	},
+	{
+		kind: "Infisical",
+		label: "Infisical",
+		mode: "in-cli",
+		signals: {
+			npm: ["@infisical/sdk"],
+			python: ["infisicalsdk"],
+			envKeys: [/^INFISICAL_/]
+		}
+	},
+	{
+		kind: "OnePassword",
+		label: "1Password",
+		mode: "in-cli",
+		signals: {
+			npm: ["@1password/sdk"],
+			python: ["onepassword-sdk"],
+			envKeys: [/^ONEPASSWORD_/, /^OP_SERVICE_ACCOUNT_TOKEN$/]
+		}
+	},
+	{
+		kind: "Persona",
+		label: "Persona",
+		mode: "in-cli",
+		signals: { envKeys: [/^PERSONA_/] }
+	},
+	{
+		kind: "Svix",
+		label: "Svix",
+		mode: "in-cli",
+		signals: {
+			npm: ["svix"],
+			python: ["svix"],
+			envKeys: [/^SVIX_/]
+		}
+	},
+	{
+		kind: "Mux",
+		label: "Mux",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mux/mux-node"],
+			python: ["mux-python"],
+			envKeys: [/^MUX_/]
+		}
+	},
+	{
+		kind: "Vapi",
+		label: "Vapi",
+		mode: "in-cli",
+		signals: {
+			npm: ["@vapi-ai/server-sdk"],
+			python: ["vapi-server-sdk"],
+			envKeys: [/^VAPI_/]
+		}
+	},
+	{
+		kind: "Aircall",
+		label: "Aircall",
+		mode: "in-cli",
+		signals: { envKeys: [/^AIRCALL_/] }
+	},
+	{
+		kind: "JustCall",
+		label: "JustCall",
+		mode: "in-cli",
+		signals: { envKeys: [/^JUSTCALL_/] }
+	},
+	{
+		kind: "WooCommerce",
+		label: "WooCommerce",
+		mode: "in-cli",
+		signals: {
+			npm: ["@woocommerce/woocommerce-rest-api"],
+			python: ["woocommerce"],
+			envKeys: [/^WOOCOMMERCE_/]
+		}
+	},
+	{
+		kind: "Recharge",
+		label: "Recharge",
+		mode: "in-cli",
+		signals: { envKeys: [/^RECHARGE_/] }
+	},
+	{
+		kind: "Commercetools",
+		label: "commercetools",
+		mode: "in-cli",
+		signals: {
+			npm: ["@commercetools/platform-sdk"],
+			python: ["commercetools"],
+			envKeys: [/^CTP_/, /^COMMERCETOOLS_/]
+		}
+	},
+	{
+		kind: "Webflow",
+		label: "Webflow",
+		mode: "in-cli",
+		signals: {
+			npm: ["webflow-api"],
+			envKeys: [/^WEBFLOW_/]
+		}
+	},
+	{
+		kind: "Easypost",
+		label: "EasyPost",
+		mode: "in-cli",
+		signals: {
+			npm: ["@easypost/api"],
+			python: ["easypost"],
+			envKeys: [/^EASYPOST_/]
+		}
+	},
+	{
+		kind: "Shippo",
+		label: "Shippo",
+		mode: "in-cli",
+		signals: {
+			npm: ["shippo"],
+			python: ["shippo"],
+			envKeys: [/^SHIPPO_/]
+		}
+	},
+	{
+		kind: "ShipStation",
+		label: "ShipStation",
+		mode: "in-cli",
+		signals: { envKeys: [/^SHIPSTATION_/] }
+	},
+	{
+		kind: "Squarespace",
+		label: "Squarespace",
+		mode: "in-cli",
+		signals: { envKeys: [/^SQUARESPACE_/] }
+	},
+	{
+		kind: "Printify",
+		label: "Printify",
+		mode: "in-cli",
+		signals: { envKeys: [/^PRINTIFY_/] }
+	},
+	{
+		kind: "Freshdesk",
+		label: "Freshdesk",
+		mode: "in-cli",
+		signals: {
+			python: ["python-freshdesk"],
+			envKeys: [/^FRESHDESK_/]
+		}
+	},
+	{
+		kind: "Front",
+		label: "Front",
+		mode: "in-cli",
+		signals: { envKeys: [/^FRONTAPP_/, /^FRONT_API_/] }
+	},
+	{
+		kind: "Gorgias",
+		label: "Gorgias",
+		mode: "in-cli",
+		signals: { envKeys: [/^GORGIAS_/] }
+	},
+	{
+		kind: "Chatwoot",
+		label: "Chatwoot",
+		mode: "in-cli",
+		signals: { envKeys: [/^CHATWOOT_/] }
+	},
+	{
+		kind: "Kustomer",
+		label: "Kustomer",
+		mode: "in-cli",
+		signals: { envKeys: [/^KUSTOMER_/] }
+	},
+	{
+		kind: "Plain",
+		label: "Plain",
+		mode: "in-cli",
+		signals: {
+			npm: ["@team-plain/typescript-sdk"],
+			envKeys: [/^PLAIN_/]
+		}
+	},
+	{
+		kind: "Canny",
+		label: "Canny",
+		mode: "in-cli",
+		signals: { envKeys: [/^CANNY_/] }
+	},
+	{
+		kind: "Pylon",
+		label: "Pylon",
+		mode: "in-cli",
+		signals: { envKeys: [/^PYLON_/] }
+	},
+	{
+		kind: "GitLab",
+		label: "GitLab",
+		mode: "in-cli",
+		signals: {
+			npm: ["@gitbeaker/rest"],
+			python: ["python-gitlab"],
+			ruby: ["gitlab"],
+			envKeys: [/^GITLAB_/]
+		}
+	},
+	{
+		kind: "Bitbucket",
+		label: "Atlassian Bitbucket Cloud",
+		mode: "in-cli",
+		signals: {
+			npm: ["bitbucket"],
+			envKeys: [/^BITBUCKET_/]
+		}
+	},
+	{
+		kind: "Gitea",
+		label: "Gitea",
+		mode: "in-cli",
+		signals: {
+			npm: ["gitea-js"],
+			envKeys: [/^GITEA_/]
+		}
+	},
+	{
+		kind: "Datadog",
+		label: "Datadog",
+		mode: "in-cli",
+		signals: {
+			npm: ["@datadog/datadog-api-client", "dd-trace"],
+			python: ["datadog", "datadog-api-client"],
+			ruby: ["dogapi"],
+			envKeys: [
+				/^DATADOG_/,
+				/^DD_API_KEY$/,
+				/^DD_APP_KEY$/
+			]
+		}
+	},
+	{
+		kind: "NewRelic",
+		label: "New Relic",
+		mode: "in-cli",
+		signals: {
+			npm: ["newrelic"],
+			python: ["newrelic"],
+			ruby: ["newrelic_rpm"],
+			envKeys: [/^NEW_RELIC_/, /^NEWRELIC_/]
+		}
+	},
+	{
+		kind: "Cloudflare",
+		label: "Cloudflare",
+		mode: "in-cli",
+		signals: {
+			npm: ["cloudflare"],
+			python: ["cloudflare"],
+			envKeys: [/^CLOUDFLARE_/, /^CF_API_TOKEN$/]
+		}
+	},
+	{
+		kind: "Elasticsearch",
+		label: "Elasticsearch",
+		mode: "in-cli",
+		signals: {
+			npm: ["@elastic/elasticsearch"],
+			python: ["elasticsearch"],
+			ruby: ["elasticsearch"],
+			envKeys: [/^ELASTICSEARCH_/]
+		}
+	},
+	{
+		kind: "Snyk",
+		label: "Snyk",
+		mode: "in-cli",
+		signals: {
+			npm: ["snyk"],
+			python: ["pysnyk"],
+			envKeys: [/^SNYK_/]
+		}
+	},
+	{
+		kind: "PagerDuty",
+		label: "PagerDuty",
+		mode: "in-cli",
+		signals: {
+			npm: ["@pagerduty/pdjs"],
+			python: ["pdpyras"],
+			envKeys: [/^PAGERDUTY_/, /^PD_API_KEY$/]
+		}
+	},
+	{
+		kind: "Opsgenie",
+		label: "Opsgenie",
+		mode: "in-cli",
+		signals: { envKeys: [/^OPSGENIE_/] }
+	},
+	{
+		kind: "IncidentIo",
+		label: "incident.io",
+		mode: "in-cli",
+		signals: { envKeys: [/^INCIDENT_IO_/, /^INCIDENTIO_/] }
+	},
+	{
+		kind: "Bugsnag",
+		label: "Bugsnag",
+		mode: "in-cli",
+		signals: {
+			npm: ["@bugsnag/js"],
+			python: ["bugsnag"],
+			ruby: ["bugsnag"],
+			envKeys: [/^BUGSNAG_/]
+		}
+	},
+	{
+		kind: "Honeybadger",
+		label: "Honeybadger",
+		mode: "in-cli",
+		signals: {
+			npm: ["@honeybadger-io/js"],
+			python: ["honeybadger"],
+			ruby: ["honeybadger"],
+			envKeys: [/^HONEYBADGER_/]
+		}
+	},
+	{
+		kind: "Raygun",
+		label: "Raygun",
+		mode: "in-cli",
+		signals: {
+			npm: ["raygun"],
+			python: ["raygun4py"],
+			ruby: ["raygun4ruby"],
+			envKeys: [/^RAYGUN_/]
+		}
+	},
+	{
+		kind: "CircleCI",
+		label: "CircleCI",
+		mode: "in-cli",
+		signals: { envKeys: [/^CIRCLECI_/, /^CIRCLE_TOKEN$/] }
+	},
+	{
+		kind: "Upstash",
+		label: "Upstash",
+		mode: "in-cli",
+		signals: {
+			npm: ["@upstash/redis"],
+			python: ["upstash-redis"],
+			envKeys: [/^UPSTASH_/]
+		}
+	},
+	{
+		kind: "Vercel",
+		label: "Vercel",
+		mode: "in-cli",
+		signals: {
+			npm: ["@vercel/sdk"],
+			envKeys: [/^VERCEL_API_TOKEN$/]
+		}
+	},
+	{
+		kind: "Pipedrive",
+		label: "Pipedrive",
+		mode: "in-cli",
+		signals: {
+			npm: ["pipedrive"],
+			envKeys: [/^PIPEDRIVE_/]
+		}
+	},
+	{
+		kind: "Close",
+		label: "Close",
+		mode: "in-cli",
+		signals: {
+			python: ["closeio"],
+			envKeys: [/^CLOSE_API_KEY$/]
+		}
+	},
+	{
+		kind: "Copper",
+		label: "Copper",
+		mode: "in-cli",
+		signals: { envKeys: [/^COPPER_/] }
+	},
+	{
+		kind: "Insightly",
+		label: "Insightly",
+		mode: "in-cli",
+		signals: { envKeys: [/^INSIGHTLY_/] }
+	},
+	{
+		kind: "Salesflare",
+		label: "Salesflare",
+		mode: "in-cli",
+		signals: { envKeys: [/^SALESFLARE_/] }
+	},
+	{
+		kind: "SalesLoft",
+		label: "Salesloft",
+		mode: "in-cli",
+		signals: { envKeys: [/^SALESLOFT_/] }
+	},
+	{
+		kind: "Attio",
+		label: "Attio",
+		mode: "in-cli",
+		signals: {
+			npm: ["attio"],
+			envKeys: [/^ATTIO_/]
+		}
+	},
+	{
+		kind: "ActiveCampaign",
+		label: "ActiveCampaign",
+		mode: "in-cli",
+		signals: { envKeys: [/^ACTIVECAMPAIGN_/, /^ACTIVE_CAMPAIGN_/] }
+	},
+	{
+		kind: "Vitally",
+		label: "Vitally",
+		mode: "in-cli",
+		signals: { envKeys: [/^VITALLY_/] }
+	},
+	{
+		kind: "Asana",
+		label: "Asana",
+		mode: "in-cli",
+		signals: {
+			npm: ["asana"],
+			python: ["asana"],
+			envKeys: [/^ASANA_/]
+		}
+	},
+	{
+		kind: "Trello",
+		label: "Trello",
+		mode: "in-cli",
+		signals: {
+			npm: ["trello"],
+			envKeys: [/^TRELLO_/]
+		}
+	},
+	{
+		kind: "Todoist",
+		label: "Todoist",
+		mode: "in-cli",
+		signals: {
+			npm: ["@doist/todoist-api-typescript"],
+			python: ["todoist-api-python"],
+			envKeys: [/^TODOIST_/]
+		}
+	},
+	{
+		kind: "Monday",
+		label: "monday.com",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mondaydotcomorg/api"],
+			envKeys: [/^MONDAY_/]
+		}
+	},
+	{
+		kind: "ClickUp",
+		label: "ClickUp",
+		mode: "in-cli",
+		signals: { envKeys: [/^CLICKUP_/] }
+	},
+	{
+		kind: "Height",
+		label: "Height",
+		mode: "in-cli",
+		signals: { envKeys: [/^HEIGHT_API_KEY$/] }
+	},
+	{
+		kind: "Shortcut",
+		label: "Shortcut",
+		mode: "in-cli",
+		signals: {
+			npm: ["@shortcut/client"],
+			envKeys: [/^SHORTCUT_/]
+		}
+	},
+	{
+		kind: "Jira",
+		label: "Jira",
+		mode: "in-cli",
+		signals: {
+			npm: ["jira-client"],
+			python: ["jira", "atlassian-python-api"],
+			envKeys: [/^JIRA_/]
+		}
+	},
+	{
+		kind: "Confluence",
+		label: "Confluence",
+		mode: "in-cli",
+		signals: { envKeys: [/^CONFLUENCE_/] }
+	},
+	{
+		kind: "Airtable",
+		label: "Airtable",
+		mode: "in-cli",
+		signals: {
+			npm: ["airtable"],
+			python: ["pyairtable"],
+			envKeys: [/^AIRTABLE_/]
+		}
+	},
+	{
+		kind: "Smartsheet",
+		label: "Smartsheet",
+		mode: "in-cli",
+		signals: {
+			npm: ["smartsheet"],
+			python: ["smartsheet-python-sdk"],
+			envKeys: [/^SMARTSHEET_/]
+		}
+	},
+	{
+		kind: "Coda",
+		label: "Coda",
+		mode: "in-cli",
+		signals: { envKeys: [/^CODA_API_/] }
+	},
+	{
+		kind: "Productboard",
+		label: "Productboard",
+		mode: "in-cli",
+		signals: { envKeys: [/^PRODUCTBOARD_/] }
+	},
+	{
+		kind: "Calendly",
+		label: "Calendly",
+		mode: "in-cli",
+		signals: { envKeys: [/^CALENDLY_/] }
+	},
+	{
+		kind: "CalCom",
+		label: "Cal.com",
+		mode: "in-cli",
+		signals: { envKeys: [/^CALCOM_/, /^CAL_API_KEY$/] }
+	},
+	{
+		kind: "Eventbrite",
+		label: "Eventbrite",
+		mode: "in-cli",
+		signals: {
+			python: ["eventbrite"],
+			envKeys: [/^EVENTBRITE_/]
+		}
+	},
+	{
+		kind: "BambooHR",
+		label: "BambooHR",
+		mode: "in-cli",
+		signals: {
+			python: ["pybamboohr"],
+			envKeys: [/^BAMBOOHR_/, /^BAMBOO_HR_/]
+		}
+	},
+	{
+		kind: "Personio",
+		label: "Personio",
+		mode: "in-cli",
+		signals: { envKeys: [/^PERSONIO_/] }
+	},
+	{
+		kind: "Rippling",
+		label: "Rippling",
+		mode: "in-cli",
+		signals: { envKeys: [/^RIPPLING_/] }
+	},
+	{
+		kind: "Greenhouse",
+		label: "Greenhouse",
+		mode: "in-cli",
+		signals: { envKeys: [/^GREENHOUSE_/] }
+	},
+	{
+		kind: "Ashby",
+		label: "Ashby",
+		mode: "in-cli",
+		signals: { envKeys: [/^ASHBY_/] }
+	},
+	{
+		kind: "Workable",
+		label: "Workable",
+		mode: "in-cli",
+		signals: { envKeys: [/^WORKABLE_/] }
+	},
+	{
+		kind: "GoogleAds",
+		label: "Google Ads",
+		mode: "deep-link",
+		signals: {
+			npm: ["google-ads-api"],
+			python: ["google-ads"],
+			envKeys: [/^GOOGLE_ADS_/]
+		}
+	},
+	{
+		kind: "MetaAds",
+		label: "Meta Ads",
+		mode: "deep-link",
+		signals: {
+			npm: ["facebook-nodejs-business-sdk"],
+			python: ["facebook-business"],
+			envKeys: [/^META_ADS_/, /^FACEBOOK_ADS_/]
+		}
+	},
+	{
+		kind: "LinkedinAds",
+		label: "LinkedIn Ads",
+		mode: "deep-link",
+		signals: { envKeys: [/^LINKEDIN_ADS_/] }
+	},
+	{
+		kind: "TikTokAds",
+		label: "TikTok Ads",
+		mode: "deep-link",
+		signals: { envKeys: [/^TIKTOK_ADS_/] }
+	},
+	{
+		kind: "RedditAds",
+		label: "Reddit Ads",
+		mode: "deep-link",
+		signals: { envKeys: [/^REDDIT_ADS_/] }
+	},
+	{
+		kind: "PinterestAds",
+		label: "Pinterest Ads",
+		mode: "deep-link",
+		signals: { envKeys: [/^PINTEREST_ADS_/] }
+	},
+	{
+		kind: "BingAds",
+		label: "Bing Ads",
+		mode: "deep-link",
+		signals: {
+			python: ["bingads"],
+			envKeys: [/^BING_ADS_/, /^MICROSOFT_ADS_/]
+		}
+	},
+	{
+		kind: "AmazonAds",
+		label: "Amazon Ads",
+		mode: "deep-link",
+		signals: { envKeys: [/^AMAZON_ADS_/] }
+	},
+	{
+		kind: "GoogleAnalytics",
+		label: "Google Analytics",
+		mode: "deep-link",
+		signals: {
+			npm: ["react-ga4"],
+			python: ["google-analytics-data"],
+			envKeys: [/^GOOGLE_ANALYTICS_/, /^GA4_/]
+		}
+	},
+	{
+		kind: "GoogleSearchConsole",
+		label: "Google Search Console",
+		mode: "deep-link",
+		signals: { envKeys: [/^SEARCH_CONSOLE_/, /^GSC_/] }
+	},
+	{
+		kind: "AppsFlyer",
+		label: "AppsFlyer",
+		mode: "in-cli",
+		signals: {
+			npm: ["react-native-appsflyer"],
+			envKeys: [/^APPSFLYER_/]
+		}
+	}
+];
+//#endregion
+//#region src/lib/warehouse-sources/detect.ts
 /**
-* Validate the agent's raw JSON into a report, clamping each targetId to the
-* supplied set and each path to a repo-relative dir. Exported for testing.
+* Data warehouse source detection.
+*
+* Scans a project for codebase signals (npm/python/ruby deps, `.env` key
+* names) and matches them against the `SOURCE_DETECTORS` registry. Pure
+* function: no store mutations, no UI calls. Reads files locally — only the
+* wizard process does this; the agent never sees secret values.
+*
+* Note we only read `.env` KEY NAMES, never values.
 */
-function coerceAgenticReport(parsed, validTargetIds) {
-	const obj = parsed ?? {};
-	return {
-		repoType: obj.repoType === "monorepo" ? "monorepo" : "single",
-		projects: (Array.isArray(obj.projects) ? obj.projects : []).map((raw) => {
-			const p = raw ?? {};
-			const targetId = typeof p.targetId === "string" && validTargetIds.includes(p.targetId) ? p.targetId : null;
-			return {
-				path: coercePath(p.path),
-				framework: typeof p.framework === "string" ? p.framework : "Unknown",
-				targetId,
-				hasPostHog: p.hasPostHog === true
-			};
-		})
-	};
+const MAX_DEPTH = 3;
+/**
+* Detect which warehouse sources the project at `installDir` appears to use.
+* Returns one `DetectedSource` per matched registry entry (kinds are unique,
+* so the result is naturally deduped).
+*/
+function detectWarehouseSources(installDir) {
+	const signals = collectSignals(installDir);
+	const detected = [];
+	for (const detector of SOURCE_DETECTORS) {
+		const match = matchDetector(detector, signals);
+		if (match) detected.push({
+			kind: detector.kind,
+			label: detector.label,
+			mode: detector.mode,
+			matchedSignal: match
+		});
+	}
+	return detected;
 }
-function formatToolUse(block) {
-	const name = typeof block?.name === "string" ? block.name : "tool";
-	const input = block?.input ?? {};
-	const detail = input.file_path || input.pattern || input.path || "";
-	return detail ? `${name} ${detail}` : name;
+/** Returns a human-readable description of the first matching signal, or null. */
+function matchDetector(detector, signals) {
+	const { npm, python, ruby, envKeys } = detector.signals;
+	const npmHit = npm?.find((dep) => signals.npm.has(dep));
+	if (npmHit) return `found \`${npmHit}\` in package.json`;
+	const pyHit = python?.find((dep) => signals.python.has(dep));
+	if (pyHit) return `found \`${pyHit}\` in Python dependencies`;
+	const rubyHit = ruby?.find((gem) => signals.ruby.has(gem));
+	if (rubyHit) return `found \`${rubyHit}\` in Gemfile`;
+	if (envKeys) {
+		for (const key of signals.envKeys) if (envKeys.some((re) => re.test(key))) return `found \`${key}\` in .env`;
+	}
+	return null;
 }
-function sessionToWizardOptions(session) {
-	return {
-		installDir: session.installDir,
-		ci: session.ci,
-		debug: session.debug,
-		default: false,
-		benchmark: session.benchmark,
-		yaraReport: session.yaraReport,
-		signup: session.signup,
-		apiKey: session.apiKey,
-		projectId: session.projectId,
-		localMcp: session.localMcp
+function collectSignals(installDir) {
+	const signals = {
+		npm: /* @__PURE__ */ new Set(),
+		python: /* @__PURE__ */ new Set(),
+		ruby: /* @__PURE__ */ new Set(),
+		envKeys: /* @__PURE__ */ new Set()
 	};
+	walkProjectFiles(installDir, (name, fullPath) => ingestFile(name, fullPath, signals), MAX_DEPTH);
+	return signals;
 }
-const NOOP_SPINNER = {
-	start: () => void 0,
-	stop: () => void 0,
-	message: () => void 0
-};
 /**
-* Drive the wizard's agent loop on HAIKU_MODEL to scan the repo and return a
-* structured detection report. Reuses the same setup every program uses, so
-* MCP, tools, and credentials are wired identically.
+* Route a file to the right parser BY NAME, reading its contents only when the
+* name matches one of the ~6 manifests we care about. Checking the name first
+* avoids slurping every file in the tree (lockfiles, binaries, assets) into
+* memory just to discard it.
 */
-async function detectProjectsWithAgent(session, options) {
-	if (!session.credentials) throw new Error("Detection requires authenticated credentials.");
-	const { targets, purpose = "set up a PostHog integration", onEvent } = options;
-	const { accessToken, host } = session.credentials;
-	const cwd = session.installDir;
-	const runOptions = sessionToWizardOptions(session);
-	const agent = await initializeAgent({
-		workingDirectory: cwd,
-		posthogMcpUrl: host.mcpUrl,
-		posthogApiKey: accessToken,
-		host,
-		detectPackageManager: detectNodePackageManagers,
-		skillsBaseUrl: getSkillsBaseUrl(session.localMcp),
-		integrationLabel: "agentic-detect",
-		allowedTools: [
-			"Read",
-			"Grep",
-			"Glob"
-		],
-		modelOverride: HAIKU_MODEL
-	}, runOptions);
-	const collected = [];
-	let resultText = "";
-	const result = await runAgent$1(agent, buildPrompt(cwd, targets, purpose), runOptions, NOOP_SPINNER, {
-		spinnerMessage: "Scanning the repo...",
-		successMessage: "Detection complete",
-		errorMessage: "Detection failed",
-		requestRemark: false
-	}, {
-		onMessage: (message) => {
-			if (message?.type === "assistant") {
-				for (const block of message.message?.content ?? []) if (block?.type === "text" && typeof block.text === "string") {
-					collected.push(block.text);
-					const line = block.text.trim();
-					if (line && onEvent) onEvent(line.length > 100 ? `${line.slice(0, 100)}…` : line);
-				} else if (block?.type === "tool_use") onEvent?.(formatToolUse(block));
-			} else if (message?.type === "result" && typeof message.result === "string") resultText = message.result;
-		},
-		finalize: (_resultMessage, _durationMs) => void 0
-	});
-	if (result.error) throw new Error(result.message || `Agent error: ${result.error}`);
-	const output = resultText || collected.join("\n");
+function ingestFile(name, fullPath, signals) {
+	const ingest = ingestorFor(name);
+	if (!ingest) return;
+	const content = safeReadFile(fullPath);
+	if (content === null) return;
+	ingest(content, signals);
+}
+/** Pick the parser for a manifest filename, or null if it's not one we read. */
+function ingestorFor(name) {
+	if (name === "package.json") return addNpmDeps;
+	if (name === "requirements.txt") return (c, s) => parseRequirementsTxt(c).forEach((d) => s.python.add(d));
+	if (name === "pyproject.toml") return (c, s) => parsePyprojectToml(c).forEach((d) => s.python.add(d));
+	if (name === "Pipfile") return (c, s) => parsePipfile(c).forEach((d) => s.python.add(d));
+	if (name === "Gemfile") return (c, s) => parseGemfile(c).forEach((g) => s.ruby.add(g));
+	if (name.startsWith(".env")) return (c, s) => parseEnvKeys(c).forEach((k) => s.envKeys.add(k));
+	return null;
+}
+function addNpmDeps(content, signals) {
 	try {
-		return coerceAgenticReport(extractJson(output), targets.map((t) => t.id));
-	} catch (err) {
-		if (output.includes(AgentSignals.ABORT)) return {
-			repoType: "single",
-			projects: []
-		};
-		throw err;
+		const pkg = JSON.parse(content);
+		for (const dep of Object.keys({
+			...pkg.dependencies,
+			...pkg.devDependencies
+		})) signals.npm.add(dep);
+	} catch (error) {
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), { step: "detectWarehouseSources.parsePackageJson" });
+	}
+}
+/** Extract gem names from `gem 'name'` declarations. */
+function parseGemfile(content) {
+	const gems = [];
+	for (const match of content.matchAll(/^\s*gem\s+['"]([^'"]+)['"]/gm)) gems.push(match[1]);
+	return gems;
+}
+/** Extract KEY NAMES from a dotenv file. Values are intentionally discarded. */
+function parseEnvKeys(content) {
+	const keys = [];
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		const match = trimmed.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+		if (match) keys.push(match[1]);
+	}
+	return keys;
+}
+//#endregion
+//#region src/lib/programs/warehouse-source/detect.ts
+/**
+* Warehouse-source program detection step.
+*
+* Thin adapter over `detectWarehouseSources` that writes results into
+* frameworkContext for the intro screen, plus the `[ABORT]` cases the
+* data-warehouse-source-setup skill can emit.
+*/
+/** frameworkContext key holding the detected sources (set on success). */
+const DETECTED_WAREHOUSE_SOURCES_KEY = "detectedWarehouseSources";
+/**
+* Read the detected sources out of frameworkContext. Single accessor shared by
+* the intro screen and the prompt builder so the key + cast live in one place.
+*/
+function getDetectedWarehouseSources(session) {
+	return session.frameworkContext["detectedWarehouseSources"] ?? [];
+}
+/** `[ABORT] <reason>` cases the skill can emit. */
+const WAREHOUSE_ABORT_CASES = [{
+	match: /^no data sources? detected\.?$/i,
+	message: "No data source detected",
+	body: "The agent could not confirm a data warehouse source to connect. Run this command from a project that uses a supported source (a database, Stripe, etc.).",
+	docsUrl: "https://posthog.com/docs/data-warehouse"
+}, {
+	match: /^source creation failed\.?$/i,
+	message: "Source creation failed",
+	body: "PostHog could not create the data warehouse source with the credentials provided. Double-check the connection details and try again, or set the source up directly in the PostHog app.",
+	docsUrl: "https://posthog.com/docs/data-warehouse"
+}];
+/**
+* Scan `session.installDir` for warehouse-source signals. Writes the detected
+* sources (or a `detectError`) into frameworkContext for the intro screen.
+*/
+function detectWarehousePrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext("detectError", error);
+	const installDir = session.installDir;
+	if (!existsSync(installDir)) {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "missing"
+		});
+		return;
+	}
+	try {
+		if (!statSync(installDir).isDirectory()) {
+			fail({
+				kind: "bad-directory",
+				path: installDir,
+				reason: "not-dir"
+			});
+			return;
+		}
+	} catch (error) {
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), {
+			step: "detectWarehousePrerequisites.stat",
+			path: installDir
+		});
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "unreadable"
+		});
+		return;
+	}
+	const sources = detectWarehouseSources(installDir);
+	if (sources.length === 0) {
+		fail({ kind: "no-sources" });
+		return;
 	}
+	analytics.setTag("warehouse_source_kinds", sources.map((s) => s.kind).join(","));
+	analytics.setTag("warehouse_source_modes", sources.map((s) => `${s.kind}:${s.mode}`).join(","));
+	analytics.setTag("warehouse_source_count", sources.length);
+	setFrameworkContext(DETECTED_WAREHOUSE_SOURCES_KEY, sources);
 }
 //#endregion
 //#region src/lib/programs/shared/health-check-step.ts
@@ -472,8 +2494,41 @@ async function detectPostHogIntegration(ctx) {
 		if (versionResult.supported !== true) ctx.setUnsupportedVersion(versionResult.supported);
 	}
 	for (const feature of discoverFeatures(installDir)) ctx.addDiscoveredFeature(feature);
+	detectWarehouseSourcesForSuggestion(ctx, installDir);
 	ctx.setDetectionComplete();
 }
+/**
+* Scan for data warehouse source signals (Postgres, Stripe, Hubspot, …) and,
+* when found, stash them for a `wizard warehouse` suggestion on the outro.
+*
+* Deliberately a suggestion, not an inline agent run: a second credential-
+* collecting agent run before the outro could `process.exit()` on any of its
+* failure paths and cost the user the success outro on a run where PostHog
+* installed fine.
+*
+* Calls `detectWarehouseSources` (a pure scan) rather than the warehouse
+* program's `detectWarehousePrerequisites`, which writes a `detectError` when
+* it finds nothing — that's right for `wizard warehouse` but here would show a
+* spurious error and trip the CI prerequisites abort. No sources is a no-op.
+*
+* Best-effort: never let a scan failure break the surrounding detect step.
+*/
+function detectWarehouseSourcesForSuggestion(ctx, installDir) {
+	try {
+		const sources = detectWarehouseSources(installDir);
+		analytics.wizardCapture("warehouse sources detected", {
+			warehouse_source_count: sources.length,
+			warehouse_source_kinds: sources.map((s) => s.kind),
+			warehouse_source_modes: sources.map((s) => s.mode)
+		});
+		if (sources.length === 0) return;
+		analytics.setTag("warehouse_source_kinds", sources.map((s) => s.kind).join(","));
+		analytics.setTag("warehouse_source_count", sources.length);
+		ctx.setFrameworkContext(DETECTED_WAREHOUSE_SOURCES_KEY, sources);
+	} catch (error) {
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), { step: "detectWarehouseSourcesForSuggestion" });
+	}
+}
 //#endregion
 //#region src/lib/programs/posthog-integration/steps.ts
 function needsSetup(session) {
@@ -1560,15 +3615,53 @@ function resolveContinueUrl(sess, host, deepLink) {
 	if (typeof deepLink === "string" && deepLink) return deepLink;
 	return withUtm(`${host.appHost}/products?source=wizard`, "outro-continue");
 }
+/**
+* Outro suggestion for data sources found in the project but not connected.
+*
+* A pointer at `wizard warehouse`, not an inline flow. Connecting a source
+* needs interactive credential collection, and chaining that as a second agent
+* run before the outro would let any of its terminal failure paths
+* `process.exit()` — costing the user the success outro and the post-outro
+* MCP / Slack steps on a run where PostHog installed fine.
+*
+* Returns undefined when nothing was detected, so the outro is unchanged for
+* projects with no connectable source.
+*/
+function buildWarehouseNextSteps(sess) {
+	const sources = getDetectedWarehouseSources(sess);
+	if (sources.length === 0) return void 0;
+	return {
+		heading: "Query your other data in PostHog:",
+		items: [`Found in this project: ${sources.map((s) => s.label).join(", ")}`, "Import it into the data warehouse with: npx @posthog/wizard warehouse"]
+	};
+}
+/**
+* Prompt fragment asking the agent to note the detected data sources in the
+* setup report's checklist.
+*
+* Empty string when nothing was detected, so the prompt is byte-identical to
+* today for projects with no connectable source. Best-effort by nature — the
+* agent may word it differently or skip it. That is acceptable here precisely
+* because it is a note in a report: the outro `nextSteps` bullet carries the
+* same information deterministically, so nothing is lost if the agent drops it.
+*/
+function warehouseReportInstruction(sess) {
+	const sources = getDetectedWarehouseSources(sess);
+	if (sources.length === 0) return "";
+	return `Finally: this project also contains data sources PostHog can import (${sources.map((s) => s.label).join(", ")}). In the setup report's "Verify before merging" checklist, add one item noting these were found and that \`npx @posthog/wizard warehouse\` will connect them to PostHog's data warehouse. Do not attempt to set them up yourself in this run.`;
+}
 const SETUP_REPORT_FILE = "posthog-setup-report.md";
 const posthogIntegrationConfig = {
 	command: "integrate",
 	description: "Set up PostHog SDK integration",
 	id: "posthog-integration",
+	agentFlow: "integration-v2",
+	eventPlanFile: EVENT_PLAN_FILE,
 	steps: POSTHOG_INTEGRATION_PROGRAM,
 	getContentBlocks,
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
 	ciPreRun: async (session) => {
+		await scopeInstallDirToProject(session);
 		const integration = await detectFramework(session.installDir);
 		if (!integration) {
 			await wizardAbort({ message: "Could not auto-detect your framework for this project." });
@@ -1599,7 +3692,7 @@ const posthogIntegrationConfig = {
 		if (usesPackageJson) {
 			const packageJson = await tryGetPackageJson({ installDir: session.installDir });
 			if (packageJson) {
-				const { hasDeclaredDependency } = await import("./package-json-CDs1ZVKu.js").then((n) => n.i);
+				const { hasDeclaredDependency } = await import("./package-json-DCuoye-H.js").then((n) => n.i);
 				if (!hasDeclaredDependency(config.detection.packageName, packageJson)) getUI().log.warn(`${config.detection.packageDisplayName} does not seem to be installed. Continuing anyway — the agent will handle it.`);
 				frameworkVersion = config.detection.getVersion(packageJson);
 			} else getUI().log.warn("Could not find package.json. Continuing anyway — the agent will handle it.");
@@ -1661,13 +3754,13 @@ STEP 5: Set up environment variables for PostHog using the wizard-tools MCP serv
 
 Important: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses, then run its install command to add the SDK. Do not manually search for lockfiles or config files. If a file already EXISTS, read it immediately before you edit or overwrite it — writing from a stale read causes a tool failure. Creating a brand-new file needs no prior read: never read a path that does not exist yet; just write it.
 
-
+${warehouseReportInstruction(session)}
 `;
 			},
 			postRun: async (sess, credentials) => {
 				const envVars = config.environment.getEnvVars(credentials.projectApiKey, credentials.host.apiHost);
 				if (config.environment.uploadToHosting) {
-					const { uploadEnvironmentVariablesStep } = await import("./steps-erepgD0V.js");
+					const { uploadEnvironmentVariablesStep } = await import("./steps-DyEKYM4I.js");
 					const uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {
 						integration: config.metadata.integration,
 						session: sess
@@ -1699,6 +3792,7 @@ Important: Use the detect_package_manager tool (from the wizard-tools MCP server
 					changes: [...config.ui.getOutroChanges(frameworkContext), Object.keys(envVars).length > 0 ? "Added environment variables to .env file" : ""].filter(Boolean),
 					docsUrl: config.metadata.docsUrl,
 					continueUrl,
+					nextSteps: buildWarehouseNextSteps(sess),
 					notebookUrl: sess.notebookUrl ?? void 0,
 					handoffPrompt: buildCodingAgentPrompt(SETUP_REPORT_FILE)
 				};
@@ -1721,6 +3815,6 @@ const integrationRunStep = {
 	isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
 };
 //#endregion
-export { gatherFrameworkContext as _, LINE_CHART_BLOCK as a, parseRequirementsTxt as b, TextBlock as c, isLinesBlock as d, isObjectBlock as f, detectProjectsWithAgent as g, HEALTH_CHECK_STEP as h, FUNNEL_BLOCK as i, computeVisibleRange as l, Icons as m, integrationRunStep as n, PRODUCT_SUITE_BLOCK as o, Colors as p, posthogIntegrationConfig as r, StatusPeekTrigger as s, SETUP_REPORT_FILE as t, isClearBlock as u, parsePipfile as v, parsePyprojectToml as y };
+export { gatherFrameworkContext as S, detectWarehousePrerequisites as _, LINE_CHART_BLOCK as a, detectProjectsWithAgent as b, TextBlock as c, isLinesBlock as d, isObjectBlock as f, WAREHOUSE_ABORT_CASES as g, HEALTH_CHECK_STEP as h, FUNNEL_BLOCK as i, computeVisibleRange as l, Icons as m, integrationRunStep as n, PRODUCT_SUITE_BLOCK as o, Colors as p, posthogIntegrationConfig as r, StatusPeekTrigger as s, SETUP_REPORT_FILE as t, isClearBlock as u, getDetectedWarehouseSources as v, resolveProjectDir as x, detectIntegrationProjects as y };
 
-//# sourceMappingURL=posthog-integration-BhLKCFsI.js.map
+//# sourceMappingURL=posthog-integration-Do997QON.js.map