p-dev-harness 0.3.1 → 0.4.0

package/dist/observability/local-state.js

@@ -0,0 +1,107 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { OBSERVABILITY_LOCAL_FILE } from "./constants.js";
+export function resolveObservabilityLocalStatePath(workspaceDir) {
+    return path.join(workspaceDir, OBSERVABILITY_LOCAL_FILE);
+}
+function createDefaultState(now = new Date().toISOString()) {
+    return {
+        schemaVersion: 1,
+        analyticsPreference: null,
+        errorReportingPreference: null,
+        disclosureShown: false,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function parseState(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.schemaVersion !== 1) {
+            return null;
+        }
+        return {
+            schemaVersion: 1,
+            installationId: typeof parsed.installationId === "string"
+                ? parsed.installationId
+                : undefined,
+            analyticsPreference: normalizePreference(parsed.analyticsPreference),
+            errorReportingPreference: normalizePreference(parsed.errorReportingPreference),
+            disclosureShown: parsed.disclosureShown === true,
+            createdAt: typeof parsed.createdAt === "string"
+                ? parsed.createdAt
+                : new Date().toISOString(),
+            updatedAt: typeof parsed.updatedAt === "string"
+                ? parsed.updatedAt
+                : new Date().toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function normalizePreference(value) {
+    if (value === "enabled" || value === "disabled") {
+        return value;
+    }
+    return null;
+}
+export async function readObservabilityLocalState(workspaceDir) {
+    const filePath = resolveObservabilityLocalStatePath(workspaceDir);
+    try {
+        const raw = await readFile(filePath, "utf8");
+        return parseState(raw) ?? createDefaultState();
+    }
+    catch {
+        return createDefaultState();
+    }
+}
+export async function writeObservabilityLocalState(workspaceDir, state) {
+    const filePath = resolveObservabilityLocalStatePath(workspaceDir);
+    const harnessDir = path.dirname(filePath);
+    await mkdir(harnessDir, { recursive: true });
+    const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    const payload = `${JSON.stringify(state, null, 2)}\n`;
+    await writeFile(tempPath, payload, { encoding: "utf8", mode: 0o600 });
+    await rename(tempPath, filePath);
+}
+export async function resetObservabilityLocalState(workspaceDir) {
+    const filePath = resolveObservabilityLocalStatePath(workspaceDir);
+    try {
+        await rm(filePath, { force: true });
+    }
+    catch {
+        // ignore missing file
+    }
+}
+export async function updateObservabilityPreferences(workspaceDir, input) {
+    const current = await readObservabilityLocalState(workspaceDir);
+    const now = new Date().toISOString();
+    const next = {
+        ...current,
+        updatedAt: now,
+    };
+    if (input.analyticsPreference !== undefined) {
+        next.analyticsPreference = input.analyticsPreference;
+    }
+    if (input.errorReportingPreference !== undefined) {
+        next.errorReportingPreference = input.errorReportingPreference;
+    }
+    if (input.disclosureShown !== undefined) {
+        next.disclosureShown = input.disclosureShown;
+    }
+    if (input.installationId === null) {
+        delete next.installationId;
+    }
+    else if (typeof input.installationId === "string") {
+        next.installationId = input.installationId;
+    }
+    await writeObservabilityLocalState(workspaceDir, next);
+    return next;
+}
+export function isFirstLaunchForPDevHome(state) {
+    return (state.analyticsPreference === null &&
+        state.errorReportingPreference === null &&
+        !state.disclosureShown);
+}
+//# sourceMappingURL=local-state.js.map

package/dist/observability/local-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-state.js","sourceRoot":"","sources":["../../src/observability/local-state.ts"],"names":[],"mappings":"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"}

package/dist/observability/package-config.d.ts

@@ -0,0 +1,11 @@
+import type { ObservabilityPublicConfig } from "./types.js";
+export interface ResolvedObservabilityPublicConfig extends ObservabilityPublicConfig {
+    sourcePath: string;
+}
+export declare function parseObservabilityPublicConfigJson(raw: string, sourceLabel: string): ObservabilityPublicConfig;
+export declare function resolveTrackedObservabilityPublicConfigPath(repoRoot: string): string;
+export declare function resolvePackagedObservabilityPublicConfigPath(packageRoot: string): string;
+export declare function readObservabilityPublicConfigFromPath(configPath: string): ResolvedObservabilityPublicConfig;
+export declare function readObservabilityPublicConfig(moduleUrl?: string, env?: NodeJS.ProcessEnv): ResolvedObservabilityPublicConfig | null;
+export declare function resolveObservabilityPublicConfigForPrepare(repoRoot: string): ObservabilityPublicConfig;
+//# sourceMappingURL=package-config.d.ts.map

package/dist/observability/package-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-config.d.ts","sourceRoot":"","sources":["../../src/observability/package-config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAW5D,MAAM,WAAW,iCACf,SAAQ,yBAAyB;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAgDD,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,yBAAyB,CAE3B;AAED,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,4CAA4C,CAC1D,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,wBAAgB,qCAAqC,CACnD,UAAU,EAAE,MAAM,GACjB,iCAAiC,CAMnC;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,GAAE,MAAwB,EACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iCAAiC,GAAG,IAAI,CA2D1C;AAED,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,MAAM,GACf,yBAAyB,CAU3B"}

package/dist/observability/package-config.js

@@ -0,0 +1,117 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { resolvePackageRootFromModule, normalizeModuleReferenceToPath } from "../p-dev/package-paths.js";
+import { isPackagedPDevRuntime } from "../p-dev/runtime-mode.js";
+import { OBSERVABILITY_PUBLIC_CONFIG_FILENAME, OBSERVABILITY_SCHEMA_VERSION, P_DEV_POSTHOG_HOST_ENV, P_DEV_POSTHOG_PROJECT_TOKEN_ENV, P_DEV_SENTRY_DSN_ENV, TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE, } from "./constants.js";
+const PRIVILEGED_KEY_PATTERNS = [
+    /auth[_-]?token/i,
+    /personal[_-]?api[_-]?key/i,
+    /secret/i,
+    /phx_/i,
+    /organization/i,
+    /management/i,
+];
+function assertPublicConfigShape(parsed, sourceLabel) {
+    if (!parsed || typeof parsed !== "object") {
+        throw new Error(`${sourceLabel} must be a JSON object.`);
+    }
+    const record = parsed;
+    if (record.observabilitySchemaVersion !== OBSERVABILITY_SCHEMA_VERSION) {
+        throw new Error(`${sourceLabel} has unsupported observabilitySchemaVersion.`);
+    }
+    for (const key of Object.keys(record)) {
+        if (PRIVILEGED_KEY_PATTERNS.some((pattern) => pattern.test(key))) {
+            throw new Error(`${sourceLabel} contains forbidden privileged credential key: ${key}`);
+        }
+    }
+    const sentryPublicDsn = typeof record.sentryPublicDsn === "string" ? record.sentryPublicDsn : "";
+    const posthogProjectToken = typeof record.posthogProjectToken === "string"
+        ? record.posthogProjectToken
+        : "";
+    const posthogIngestionHost = typeof record.posthogIngestionHost === "string" &&
+        record.posthogIngestionHost.trim()
+        ? record.posthogIngestionHost.trim()
+        : "https://us.i.posthog.com";
+    if (posthogProjectToken.startsWith("phx_")) {
+        throw new Error(`${sourceLabel} must not contain a PostHog personal API key.`);
+    }
+    return {
+        observabilitySchemaVersion: OBSERVABILITY_SCHEMA_VERSION,
+        sentryPublicDsn,
+        posthogProjectToken,
+        posthogIngestionHost,
+    };
+}
+export function parseObservabilityPublicConfigJson(raw, sourceLabel) {
+    return assertPublicConfigShape(JSON.parse(raw), sourceLabel);
+}
+export function resolveTrackedObservabilityPublicConfigPath(repoRoot) {
+    return path.join(repoRoot, TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE);
+}
+export function resolvePackagedObservabilityPublicConfigPath(packageRoot) {
+    return path.join(packageRoot, OBSERVABILITY_PUBLIC_CONFIG_FILENAME);
+}
+export function readObservabilityPublicConfigFromPath(configPath) {
+    const raw = readFileSync(configPath, "utf8");
+    return {
+        ...parseObservabilityPublicConfigJson(raw, configPath),
+        sourcePath: configPath,
+    };
+}
+export function readObservabilityPublicConfig(moduleUrl = import.meta.url, env = process.env) {
+    const candidates = [];
+    const modulePath = normalizeModuleReferenceToPath(moduleUrl);
+    const repoRoot = path.resolve(path.dirname(modulePath), "../..");
+    candidates.push(resolveTrackedObservabilityPublicConfigPath(repoRoot));
+    try {
+        candidates.push(resolvePackagedObservabilityPublicConfigPath(resolvePackageRootFromModule(moduleUrl)));
+    }
+    catch {
+        // packaged root unavailable in some test contexts
+    }
+    let base = null;
+    for (const candidate of candidates) {
+        try {
+            base = readObservabilityPublicConfigFromPath(candidate);
+            break;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    if (!base) {
+        if (!isPackagedPDevRuntime(env)) {
+            return null;
+        }
+        const sentryPublicDsn = env[P_DEV_SENTRY_DSN_ENV]?.trim() ?? "";
+        const posthogProjectToken = env[P_DEV_POSTHOG_PROJECT_TOKEN_ENV]?.trim() ?? "";
+        const posthogIngestionHost = env[P_DEV_POSTHOG_HOST_ENV]?.trim() || "https://us.i.posthog.com";
+        if (!sentryPublicDsn && !posthogProjectToken) {
+            return null;
+        }
+        return {
+            observabilitySchemaVersion: OBSERVABILITY_SCHEMA_VERSION,
+            sentryPublicDsn,
+            posthogProjectToken,
+            posthogIngestionHost,
+            sourcePath: "env",
+        };
+    }
+    return {
+        ...base,
+        sentryPublicDsn: env[P_DEV_SENTRY_DSN_ENV]?.trim() || base.sentryPublicDsn.trim(),
+        posthogProjectToken: env[P_DEV_POSTHOG_PROJECT_TOKEN_ENV]?.trim() ||
+            base.posthogProjectToken.trim(),
+        posthogIngestionHost: env[P_DEV_POSTHOG_HOST_ENV]?.trim() || base.posthogIngestionHost,
+    };
+}
+export function resolveObservabilityPublicConfigForPrepare(repoRoot) {
+    const resolved = readObservabilityPublicConfigFromPath(resolveTrackedObservabilityPublicConfigPath(repoRoot));
+    return {
+        observabilitySchemaVersion: resolved.observabilitySchemaVersion,
+        sentryPublicDsn: resolved.sentryPublicDsn,
+        posthogProjectToken: resolved.posthogProjectToken,
+        posthogIngestionHost: resolved.posthogIngestionHost,
+    };
+}
+//# sourceMappingURL=package-config.js.map

package/dist/observability/package-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-config.js","sourceRoot":"","sources":["../../src/observability/package-config.ts"],"names":[],"mappings":"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"}

package/dist/observability/posthog-dashboard-contract.d.ts

@@ -0,0 +1,46 @@
+import { ANALYTICS_EVENT_NAMES } from "./privacy-schema.js";
+import { GUIDED_DISPLAY_STEP_IDS } from "./analytics-schemas.js";
+export declare const POSTHOG_ONBOARDING_HEALTH_DASHBOARD_NAME: "p-dev Packaged Onboarding Health";
+export declare const POSTHOG_ONBOARDING_HEALTH_DASHBOARD_DESCRIPTION: "Consent-gated packaged product analytics for p-dev-harness onboarding and workspace provisioning. Only installations that affirmatively enable anonymous analytics are visible. Counts must not be interpreted as total installs, and this dashboard must not be used to calculate a consent rate.";
+export declare const POSTHOG_ONBOARDING_HEALTH_DEFAULT_DATE_RANGE: "-30d";
+export declare const POSTHOG_DASHBOARD_FILTER_PROPERTIES: readonly ["package_version", "release_sha", "os_family"];
+export declare const POSTHOG_DASHBOARD_EXCLUDED_METRICS: readonly ["consent_rate", "analytics_opt_in_rate", "error_reporting_opt_in_rate"];
+export declare const POSTHOG_INTERPRETATION_MARKDOWN = "## Interpretation\n\nThis dashboard contains only anonymous product analytics from packaged p-dev-harness installations that affirmatively enabled analytics.\n\nNon-consenting installations are intentionally invisible. Do not calculate adoption or consent rates from this data.\n\nUse package_version and release_sha to compare releases. Telemetry is supporting evidence, not an authoritative trigger for releases, security actions, or product decisions.";
+export declare const CONFIGURE_FUNNEL_SUCCESS_OUTCOMES: readonly ["success", "skipped_already_complete"];
+export type PostHogDashboardInsightKind = "text" | "trends" | "funnel" | "breakdown";
+export interface PostHogDashboardInsightSpec {
+    name: string;
+    kind: PostHogDashboardInsightKind;
+    events: readonly (typeof ANALYTICS_EVENT_NAMES)[number][];
+    breakdownProperties?: readonly string[];
+    secondaryBreakdownProperties?: readonly string[];
+    display?: "line" | "bar" | "stacked_bar" | "table";
+    funnelStepFilters?: readonly ConfigureFunnelStepFilter[];
+}
+export interface ConfigureFunnelStepFilter {
+    stepId: (typeof GUIDED_DISPLAY_STEP_IDS)[number];
+    completionOutcomes: readonly (typeof CONFIGURE_FUNNEL_SUCCESS_OUTCOMES)[number][];
+}
+export declare const CONFIGURE_FUNNEL_STEP_FILTERS: readonly ConfigureFunnelStepFilter[];
+export declare const CONFIGURE_FUNNEL_STEPS_1_4: readonly ConfigureFunnelStepFilter[];
+export declare const CONFIGURE_FUNNEL_STEPS_5_8: readonly ConfigureFunnelStepFilter[];
+export declare const POSTHOG_ONBOARDING_HEALTH_INSIGHTS: readonly PostHogDashboardInsightSpec[];
+export declare const POSTHOG_ONBOARDING_HEALTH_REQUIRED_INSIGHT_NAMES: string[];
+export declare const POSTHOG_ONBOARDING_HEALTH_OPTIONAL_SPLIT_FUNNEL_NAMES: readonly ["Configure Funnel — Steps 1–4", "Configure Funnel — Steps 5–8"];
+export declare function assertDashboardContractUsesAllowlistedEvents(): void;
+export declare function assertDashboardContractUsesAllowlistedProperties(): void;
+export declare function configureFunnelStepNumber(stepId: (typeof GUIDED_DISPLAY_STEP_IDS)[number]): number;
+export declare const POSTHOG_DASHBOARD_SCHEMA_VERSION: 1;
+export declare function configureStepEventProperties(stepId: (typeof GUIDED_DISPLAY_STEP_IDS)[number]): Array<{
+    key: string;
+    type: "event";
+    operator: "exact";
+    value: string[];
+}>;
+export declare function buildConfigureFunnelSeries(steps: readonly ConfigureFunnelStepFilter[]): Array<{
+    kind: "EventsNode";
+    event: "p_dev_configure_step_completed";
+    name: string;
+    properties: ReturnType<typeof configureStepEventProperties>;
+}>;
+//# sourceMappingURL=posthog-dashboard-contract.d.ts.map

package/dist/observability/posthog-dashboard-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-dashboard-contract.d.ts","sourceRoot":"","sources":["../../src/observability/posthog-dashboard-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EAExB,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,wCAAwC,EACnD,kCAA2C,CAAC;AAE9C,eAAO,MAAM,+CAA+C,EAC1D,oSAA6S,CAAC;AAEhT,eAAO,MAAM,4CAA4C,EAAG,MAAe,CAAC;AAE5E,eAAO,MAAM,mCAAmC,0DAItC,CAAC;AAEX,eAAO,MAAM,kCAAkC,mFAIrC,CAAC;AAEX,eAAO,MAAM,+BAA+B,2cAMkI,CAAC;AAE/K,eAAO,MAAM,iCAAiC,kDAGpC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACnC,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1D,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,OAAO,CAAC;IACnD,iBAAiB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;IACjD,kBAAkB,EAAE,SAAS,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;CACnF;AAWD,eAAO,MAAM,6BAA6B,EAAE,SAAS,yBAAyB,EAC5B,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAE,SAAS,yBAAyB,EAChC,CAAC;AAE5C,eAAO,MAAM,0BAA0B,EAAE,SAAS,yBAAyB,EACnC,CAAC;AAEzC,eAAO,MAAM,kCAAkC,EAAE,SAAS,2BAA2B,EAqGzE,CAAC;AAEb,eAAO,MAAM,gDAAgD,UAO1B,CAAC;AAEpC,eAAO,MAAM,qDAAqD,2EAGxD,CAAC;AAEX,wBAAgB,4CAA4C,IAAI,IAAI,CASnE;AAED,wBAAgB,gDAAgD,IAAI,IAAI,CAiBvE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,GAC/C,MAAM,CAER;AAED,eAAO,MAAM,gCAAgC,GAA+B,CAAC;AAE7E,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,GAC/C,KAAK,CAAC;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CAeD;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,yBAAyB,EAAE,GAC1C,KAAK,CAAC;IACP,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,gCAAgC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAC7D,CAAC,CAOD"}

package/dist/observability/posthog-dashboard-contract.js

@@ -0,0 +1,200 @@
+import { ANALYTICS_EVENT_NAMES, allowedAnalyticsPropertyKeysForEvent, } from "./privacy-schema.js";
+import { GUIDED_DISPLAY_STEP_IDS, guidedDisplayStepNumber, } from "./analytics-schemas.js";
+import { OBSERVABILITY_SCHEMA_VERSION } from "./constants.js";
+export const POSTHOG_ONBOARDING_HEALTH_DASHBOARD_NAME = "p-dev Packaged Onboarding Health";
+export const POSTHOG_ONBOARDING_HEALTH_DASHBOARD_DESCRIPTION = "Consent-gated packaged product analytics for p-dev-harness onboarding and workspace provisioning. Only installations that affirmatively enable anonymous analytics are visible. Counts must not be interpreted as total installs, and this dashboard must not be used to calculate a consent rate.";
+export const POSTHOG_ONBOARDING_HEALTH_DEFAULT_DATE_RANGE = "-30d";
+export const POSTHOG_DASHBOARD_FILTER_PROPERTIES = [
+    "package_version",
+    "release_sha",
+    "os_family",
+];
+export const POSTHOG_DASHBOARD_EXCLUDED_METRICS = [
+    "consent_rate",
+    "analytics_opt_in_rate",
+    "error_reporting_opt_in_rate",
+];
+export const POSTHOG_INTERPRETATION_MARKDOWN = `## Interpretation
+
+This dashboard contains only anonymous product analytics from packaged p-dev-harness installations that affirmatively enabled analytics.
+
+Non-consenting installations are intentionally invisible. Do not calculate adoption or consent rates from this data.
+
+Use package_version and release_sha to compare releases. Telemetry is supporting evidence, not an authoritative trigger for releases, security actions, or product decisions.`;
+export const CONFIGURE_FUNNEL_SUCCESS_OUTCOMES = [
+    "success",
+    "skipped_already_complete",
+];
+function configureStepFilter(stepId) {
+    return {
+        stepId,
+        completionOutcomes: CONFIGURE_FUNNEL_SUCCESS_OUTCOMES,
+    };
+}
+export const CONFIGURE_FUNNEL_STEP_FILTERS = GUIDED_DISPLAY_STEP_IDS.map(configureStepFilter);
+export const CONFIGURE_FUNNEL_STEPS_1_4 = CONFIGURE_FUNNEL_STEP_FILTERS.slice(0, 4);
+export const CONFIGURE_FUNNEL_STEPS_5_8 = CONFIGURE_FUNNEL_STEP_FILTERS.slice(4);
+export const POSTHOG_ONBOARDING_HEALTH_INSIGHTS = [
+    {
+        name: "Interpretation",
+        kind: "text",
+        events: [],
+    },
+    {
+        name: "Packaged Sessions by Release",
+        kind: "trends",
+        events: ["p_dev_session_started"],
+        breakdownProperties: ["package_version"],
+        display: "line",
+    },
+    {
+        name: "Packaged Sessions by OS",
+        kind: "trends",
+        events: ["p_dev_session_started"],
+        breakdownProperties: ["os_family"],
+        display: "bar",
+    },
+    {
+        name: "Session to Setup Completion",
+        kind: "funnel",
+        events: ["p_dev_session_started", "p_dev_setup_completed"],
+        breakdownProperties: ["package_version"],
+    },
+    {
+        name: "Configure Step Completion Funnel",
+        kind: "funnel",
+        events: ["p_dev_configure_step_completed"],
+        funnelStepFilters: CONFIGURE_FUNNEL_STEP_FILTERS,
+    },
+    {
+        name: "Configure Funnel — Steps 1–4",
+        kind: "funnel",
+        events: ["p_dev_configure_step_completed"],
+        funnelStepFilters: CONFIGURE_FUNNEL_STEPS_1_4,
+    },
+    {
+        name: "Configure Funnel — Steps 5–8",
+        kind: "funnel",
+        events: ["p_dev_configure_step_completed"],
+        funnelStepFilters: CONFIGURE_FUNNEL_STEPS_5_8,
+    },
+    {
+        name: "Configure Outcomes by Step",
+        kind: "breakdown",
+        events: ["p_dev_configure_step_completed"],
+        breakdownProperties: ["step_id"],
+        secondaryBreakdownProperties: ["completion_outcome"],
+        display: "stacked_bar",
+    },
+    {
+        name: "Workspace Provisioning Outcomes",
+        kind: "trends",
+        events: [
+            "p_dev_workspace_provision_started",
+            "p_dev_workspace_provision_completed",
+            "p_dev_workspace_provision_failed",
+        ],
+        breakdownProperties: ["package_version"],
+        display: "line",
+    },
+    {
+        name: "Provisioning Failure Categories",
+        kind: "breakdown",
+        events: ["p_dev_workspace_provision_failed"],
+        breakdownProperties: ["failure_category"],
+        display: "bar",
+    },
+    {
+        name: "Provisioning Duration Buckets",
+        kind: "breakdown",
+        events: [
+            "p_dev_workspace_provision_completed",
+            "p_dev_workspace_provision_failed",
+        ],
+        breakdownProperties: ["duration_bucket"],
+        display: "bar",
+    },
+    {
+        name: "Provisioning Retry Buckets",
+        kind: "breakdown",
+        events: [
+            "p_dev_workspace_provision_completed",
+            "p_dev_workspace_provision_failed",
+        ],
+        breakdownProperties: ["retry_count_bucket"],
+        display: "bar",
+    },
+    {
+        name: "Rate-Limit Pause Buckets",
+        kind: "breakdown",
+        events: [
+            "p_dev_workspace_provision_completed",
+            "p_dev_workspace_provision_failed",
+        ],
+        breakdownProperties: ["rate_limit_pause_count_bucket"],
+        display: "bar",
+    },
+];
+export const POSTHOG_ONBOARDING_HEALTH_REQUIRED_INSIGHT_NAMES = POSTHOG_ONBOARDING_HEALTH_INSIGHTS.filter((insight) => insight.kind !== "text")
+    .filter((insight) => insight.name !== "Configure Funnel — Steps 1–4" &&
+    insight.name !== "Configure Funnel — Steps 5–8")
+    .map((insight) => insight.name);
+export const POSTHOG_ONBOARDING_HEALTH_OPTIONAL_SPLIT_FUNNEL_NAMES = [
+    "Configure Funnel — Steps 1–4",
+    "Configure Funnel — Steps 5–8",
+];
+export function assertDashboardContractUsesAllowlistedEvents() {
+    const allowed = new Set(ANALYTICS_EVENT_NAMES);
+    for (const insight of POSTHOG_ONBOARDING_HEALTH_INSIGHTS) {
+        for (const eventName of insight.events) {
+            if (!allowed.has(eventName)) {
+                throw new Error(`Dashboard insight "${insight.name}" uses unknown event.`);
+            }
+        }
+    }
+}
+export function assertDashboardContractUsesAllowlistedProperties() {
+    for (const insight of POSTHOG_ONBOARDING_HEALTH_INSIGHTS) {
+        for (const eventName of insight.events) {
+            const event = { type: eventName };
+            const allowed = new Set(allowedAnalyticsPropertyKeysForEvent(event));
+            for (const property of [
+                ...(insight.breakdownProperties ?? []),
+                ...(insight.secondaryBreakdownProperties ?? []),
+            ]) {
+                if (!allowed.has(property)) {
+                    throw new Error(`Dashboard insight "${insight.name}" uses disallowed property "${property}".`);
+                }
+            }
+        }
+    }
+}
+export function configureFunnelStepNumber(stepId) {
+    return guidedDisplayStepNumber(stepId);
+}
+export const POSTHOG_DASHBOARD_SCHEMA_VERSION = OBSERVABILITY_SCHEMA_VERSION;
+export function configureStepEventProperties(stepId) {
+    return [
+        {
+            key: "step_id",
+            type: "event",
+            operator: "exact",
+            value: [stepId],
+        },
+        {
+            key: "completion_outcome",
+            type: "event",
+            operator: "exact",
+            value: [...CONFIGURE_FUNNEL_SUCCESS_OUTCOMES],
+        },
+    ];
+}
+export function buildConfigureFunnelSeries(steps) {
+    return steps.map((step) => ({
+        kind: "EventsNode",
+        event: "p_dev_configure_step_completed",
+        name: step.stepId,
+        properties: configureStepEventProperties(step.stepId),
+    }));
+}
+//# sourceMappingURL=posthog-dashboard-contract.js.map

package/dist/observability/posthog-dashboard-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-dashboard-contract.js","sourceRoot":"","sources":["../../src/observability/posthog-dashboard-contract.ts"],"names":[],"mappings":"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"}

package/dist/observability/privacy-schema.d.ts

@@ -0,0 +1,13 @@
+import type { AnalyticsEvent, DurationBucket } from "./types.js";
+export declare const ANALYTICS_EVENT_NAMES: readonly ["p_dev_session_started", "p_dev_configure_step_viewed", "p_dev_configure_step_completed", "p_dev_workspace_provision_started", "p_dev_workspace_provision_completed", "p_dev_workspace_provision_failed", "p_dev_setup_completed"];
+export declare const COMMON_ANALYTICS_PROPERTY_KEYS: readonly ["observability_schema_version", "package_version", "release_sha", "runtime_mode", "os_family", "cpu_arch_family", "node_major_version", "session_id", "first_launch_for_p_dev_home", "workspace_kind", "distinct_id", "$process_person_profile"];
+export declare const FORBIDDEN_PROPERTY_KEY_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+export declare const ALLOWED_SENTRY_TAG_KEYS: readonly ["observability_schema_version", "package_version", "release_sha", "session_id", "runtime_mode", "os_family", "cpu_arch_family", "node_major_version", "lifecycle_phase", "configure_step_id", "product_error_code", "error_category", "operation_resumed", "remote_mutation_begun", "durable_recovery_state_exists", "duration_bucket", "retry_count_bucket", "rate_limit_pause_count_bucket"];
+export declare function bucketDurationMs(durationMs: number): DurationBucket;
+export declare function bucketProvisioningDurationMs(durationMs: number): DurationBucket;
+export declare function bucketCount(value: number): string;
+export declare function bucketSnapshotFileCount(count: number): string;
+export declare function assertAllowedPropertyKeys(properties: Record<string, unknown>, allowedKeys: readonly string[]): void;
+export declare function analyticsEventToProperties(event: AnalyticsEvent): Record<string, unknown>;
+export declare function allowedAnalyticsPropertyKeysForEvent(event: AnalyticsEvent): string[];
+//# sourceMappingURL=privacy-schema.d.ts.map

package/dist/observability/privacy-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-schema.d.ts","sourceRoot":"","sources":["../../src/observability/privacy-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,qBAAqB,8OAQxB,CAAC;AAEX,eAAO,MAAM,8BAA8B,4PAajC,CAAC;AAEX,eAAO,MAAM,+BAA+B,2MAyBlC,CAAC;AAEX,eAAO,MAAM,uBAAuB,0YAmB1B,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAiBnE;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,GACjB,cAAc,CAchB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc7D;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,IAAI,CAUN;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0DzB;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,cAAc,GACpB,MAAM,EAAE,CAKV"}