@funnelsgrove/cli 0.1.290 → 0.1.293

package/README.md

@@ -174,7 +174,6 @@ Analytics workflow:
 fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11
 fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11
 fgrove analytics transitions --project claimbee --funnel claimbee-ios --date 2026-06-11
-fgrove analytics versions --project claimbee --funnel claimbee-ios
 fgrove analytics cohort --project claimbee --date 2026-06-11
 ```
 
@@ -184,17 +183,14 @@ Each analytics command accepts `--format table|json`, `--out <path>`, `--workspa
 fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json --out conversions.json
 ```
 
-`conversions` downloads conversion totals, primary conversion metrics, full funnel path rows, and step transitions. `funnel-path` focuses on the ordered path report. `transitions` focuses on step-by-step advanced/drop-off counts. `cohort` downloads synced marketing cohort economics for the day. If the requested period has no synced data, or cohort source data is incomplete, the CLI exits non-zero with a human-readable explanation.
+`conversions` downloads conversion totals, primary conversion metrics, full funnel path rows, and step transitions. `funnel-path` focuses on the ordered path report. `transitions` focuses on step-by-step advanced/drop-off counts. `cohort` downloads synced marketing cohort economics for the day. Its annual predictions use the same saved-range midpoint as Cohort Marketing and daily reports. Missing valid prediction ranges yield null JSON values and empty table cells; legacy model points are never a fallback. Cohort Marketing must be enabled for the project. If the requested period has no synced data, or cohort source data is incomplete, the CLI exits non-zero with a human-readable explanation.
 
-`conversions`, `funnel-path`, and `transitions` report one day with `--date`, or a range with `--from` and `--to` (inclusive, totals for the whole range). They report the current Journey Version by default, like Funnel Analytics in the console. Traffic from before the last structural change belongs to an older Journey Version: list the versions with `versions`, then pass `--journey-version <id>`:
+`conversions`, `funnel-path`, and `transitions` report one day with `--date`, or a range with `--from` and `--to` (inclusive, totals for the whole range). They use the selected date range across all published funnel versions that had traffic. `funnel-path` and `transitions` follow current published flow order. Steps with selected-period traffic that are absent from the current flow appear at the end under “Not in current funnel”; JSON rows mark them with `section: "not-in-current-funnel"`.
 
 ```bash
-fgrove analytics versions --project claimbee --funnel claimbee-ios
-fgrove analytics transitions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14 --journey-version <journey-version-id>
+fgrove analytics transitions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14
 ```
 
-`versions` lists each Journey Version newest first with its id, start time, active days, and visitors on those days. Active days are dates in `--timezone` (the API default, America/Los_Angeles, when omitted); the day a version replaced its predecessor belongs to both, and each version counts only its own visitors. An explicit version reports its own metrics and its own step structure. `--journey-version all` counts every version and orders `funnel-path` by the current published flow, so steps that exist only in older versions appear in `transitions` but not in `funnel-path`. JSON reports include `from`, `to`, and a `journeyVersion` object (`id`, `seq`, `label`, `startedAt`, `isCurrent`); `date` is set only for a one-day report. Table titles end with the reported version, for example `Journey 2 (current)`. The `overview` block of `conversions` always covers all Journey Versions.
-
 The package also keeps the longer `funnelsgrove` command as a compatibility alias.
 
 Edit profitability expenses through a local JSON file:

package/dist/analyticsOutput.d.ts

@@ -53,8 +53,8 @@ export type AnalyticsStepDropoffResponse = {
         slug: string;
     };
     version: {
-        selected: AnalyticsJourneyVersionOption | null;
-        options: AnalyticsJourneyVersionOption[];
+        selected: null;
+        options: [];
     };
     totals: Record<string, number>;
     metrics: Array<{
@@ -71,30 +71,6 @@ export type AnalyticsStepDropoffResponse = {
     steps: AnalyticsStepTransition[];
     flow: AnalyticsFunnelFlow | null;
 };
-export type AnalyticsJourneyVersionOption = {
-    id: string;
-    seq: number;
-    message: string | null;
-    publishedAt: string | null;
-    isCurrent: boolean;
-};
-export type AnalyticsReportJourneyVersion = {
-    id: string;
-    seq: number | null;
-    label: string;
-    startedAt: string | null;
-    isCurrent: boolean;
-};
-export type AnalyticsJourneyVersionRow = {
-    id: string;
-    seq: number;
-    label: string;
-    isCurrent: boolean;
-    startedAt: string | null;
-    activeFrom: string | null;
-    activeTo: string | null;
-    visitors: number | null;
-};
 export type AnalyticsStepTransition = {
     stepId: string;
     stepName: string | null;
@@ -137,6 +113,10 @@ export type MarketingCohortPerformanceRow = {
     predictedNetRevenueDay365Currency: string | null;
     pLtvCurrency: string | null;
     pLtv: number | null;
+    predictedRevenue?: number | null;
+    predictedProfit?: number | null;
+    predictedRoiPercent?: number | null;
+    roasDay365Percent?: number | null;
     pLtvPredictedNetRevenueDay365Minor: number | null;
     pLtvPredictedCustomerCount: number;
     campaign: string;
@@ -167,7 +147,6 @@ type ReportContext = {
 };
 type FunnelReportContext = {
     period: AnalyticsPeriod;
-    journeyVersion: string;
     workspaceId: string;
     project: AnalyticsProjectSummary;
     stepDropoff: AnalyticsStepDropoffResponse;
@@ -195,6 +174,7 @@ export declare const assertHasCohortData: (date: string, report: MarketingCohort
 export declare const buildTransitionRows: (stepDropoff: AnalyticsStepDropoffResponse) => {
     stepId: string;
     step: string;
+    section: string | null;
     nextStep: string;
     entrants: number;
     advancedToNextStep: number;
@@ -205,13 +185,13 @@ export declare const buildFunnelPathRows: (stepDropoff: AnalyticsStepDropoffResp
     stepId: string;
     path: string;
     label: string;
+    section: string;
     users: number;
     advancedToNextStep: number;
     conversionToNextStep: number;
     dropoffs: number;
     dropoffRate: number;
 }[];
-export declare const journeyVersionLabel: (version: Pick<AnalyticsJourneyVersionOption, "seq">) => string;
 export declare const buildConversionReportPayload: (input: FunnelReportContext & {
     overview: AnalyticsOverviewResponse;
     pathFlow: AnalyticsFunnelFlow | null;
@@ -233,6 +213,7 @@ export declare const buildConversionReportPayload: (input: FunnelReportContext &
         stepId: string;
         path: string;
         label: string;
+        section: string;
         users: number;
         advancedToNextStep: number;
         conversionToNextStep: number;
@@ -242,6 +223,7 @@ export declare const buildConversionReportPayload: (input: FunnelReportContext &
     transitions: {
         stepId: string;
         step: string;
+        section: string | null;
         nextStep: string;
         entrants: number;
         advancedToNextStep: number;
@@ -259,7 +241,6 @@ export declare const buildConversionReportPayload: (input: FunnelReportContext &
         name: string;
         slug: string;
     };
-    journeyVersion: AnalyticsReportJourneyVersion | null;
 };
 export declare const buildFunnelPathReportPayload: (input: FunnelReportContext & {
     pathFlow: AnalyticsFunnelFlow | null;
@@ -268,6 +249,7 @@ export declare const buildFunnelPathReportPayload: (input: FunnelReportContext &
         stepId: string;
         path: string;
         label: string;
+        section: string;
         users: number;
         advancedToNextStep: number;
         conversionToNextStep: number;
@@ -285,12 +267,12 @@ export declare const buildFunnelPathReportPayload: (input: FunnelReportContext &
         name: string;
         slug: string;
     };
-    journeyVersion: AnalyticsReportJourneyVersion | null;
 };
 export declare const buildTransitionReportPayload: (input: FunnelReportContext) => {
     transitions: {
         stepId: string;
         step: string;
+        section: string | null;
         nextStep: string;
         entrants: number;
         advancedToNextStep: number;
@@ -308,7 +290,6 @@ export declare const buildTransitionReportPayload: (input: FunnelReportContext)
         name: string;
         slug: string;
     };
-    journeyVersion: AnalyticsReportJourneyVersion | null;
 };
 export declare const buildCohortReportPayload: (input: ReportContext & {
     cohort: MarketingCohortPerformanceReport;
@@ -324,7 +305,7 @@ export declare const buildCohortReportPayload: (input: ReportContext & {
     } | null;
 };
 export declare const formatAnalyticsJson: (payload: unknown) => string;
-type FunnelReportTableInput = Pick<FunnelReportContext, 'period' | 'journeyVersion' | 'stepDropoff'>;
+type FunnelReportTableInput = Pick<FunnelReportContext, 'period' | 'stepDropoff'>;
 export declare const formatTransitionsTable: (input: FunnelReportTableInput) => string;
 export declare const formatFunnelPathTable: (input: FunnelReportTableInput & {
     pathFlow: AnalyticsFunnelFlow | null;
@@ -333,25 +314,6 @@ export declare const formatConversionsTable: (input: FunnelReportTableInput & {
     overview: AnalyticsOverviewResponse;
     pathFlow: AnalyticsFunnelFlow | null;
 }) => string;
-type JourneyVersionsReport = {
-    funnel: AnalyticsStepDropoffResponse['funnel'];
-    versions: AnalyticsJourneyVersionRow[];
-};
-export declare const buildJourneyVersionsReportPayload: (input: JourneyVersionsReport & {
-    workspaceId: string;
-    project: AnalyticsProjectSummary;
-}) => {
-    generatedAt: string;
-    workspaceId: string;
-    project: AnalyticsProjectSummary;
-    funnel: {
-        id: string;
-        name: string;
-        slug: string;
-    };
-    versions: AnalyticsJourneyVersionRow[];
-};
-export declare const formatJourneyVersionsTable: (input: JourneyVersionsReport) => string;
 export declare const formatCohortTable: (input: {
     date: string;
     cohort: MarketingCohortPerformanceReport;

package/dist/analyticsOutput.js

@@ -66,9 +66,6 @@ const hasPositiveNumber = (value) => {
     }
     return false;
 };
-const olderJourneyVersionHint = (stepDropoff) => (stepDropoff.version.selected?.isCurrent && stepDropoff.version.options.length > 1
-    ? ' Traffic on these dates may belong to an older journey version: list them with `fgrove analytics versions` and pass --journey-version.'
-    : '');
 export const assertHasConversionData = (date, overview, stepDropoff) => {
     if (hasPositiveNumber(overview.totals) ||
         hasPositiveNumber(overview.byDay) ||
@@ -76,19 +73,19 @@ export const assertHasConversionData = (date, overview, stepDropoff) => {
         hasPositiveNumber(stepDropoff.steps)) {
         return;
     }
-    throw new Error(`No synced conversion data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
+    throw new Error(`No synced conversion data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked traffic in that period.`);
 };
 export const assertHasTransitionData = (date, stepDropoff) => {
     if (stepDropoff.steps.length > 0 && hasPositiveNumber(stepDropoff.steps)) {
         return;
     }
-    throw new Error(`No synced step transition data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked step traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
+    throw new Error(`No synced step transition data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked step traffic in that period.`);
 };
 export const assertHasFunnelPathData = (date, stepDropoff, pathFlow) => {
     if (buildFunnelPathRows(stepDropoff, pathFlow).length > 0) {
         return;
     }
-    throw new Error(`No synced full funnel path data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked path traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
+    throw new Error(`No synced full funnel path data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked path traffic in that period.`);
 };
 export const assertHasCohortData = (date, report) => {
     if (report.sourceHealth && !report.sourceHealth.complete) {
@@ -114,31 +111,45 @@ const formatCurrency = (value, currency = 'USD') => new Intl.NumberFormat('en-US
 }).format(value);
 const formatMinorCurrency = (value) => formatCurrency((Number(value) || 0) / 100);
 const stepDisplayName = (step) => step.stepName || step.stepId;
-export const buildTransitionRows = (stepDropoff) => [...stepDropoff.steps]
-    .sort((left, right) => left.stepOrder - right.stepOrder || left.stepId.localeCompare(right.stepId))
-    .map((step) => ({
-    stepId: step.stepId,
-    step: stepDisplayName(step),
-    nextStep: step.nextStepId || '',
-    entrants: step.entrants,
-    advancedToNextStep: step.advancedToNextStep,
-    dropoffs: step.dropoffs,
-    dropoffRate: step.dropoffRate,
-}));
+export const buildTransitionRows = (stepDropoff) => {
+    const currentOrder = new Map(stepDropoff.flow?.steps.map(step => [step.stepId, step.stepOrder]));
+    return stepDropoff.steps
+        .filter(step => step.entrants > 0)
+        .sort((left, right) => ((currentOrder.get(left.stepId) ?? Number.MAX_SAFE_INTEGER)
+        - (currentOrder.get(right.stepId) ?? Number.MAX_SAFE_INTEGER)
+        || left.stepOrder - right.stepOrder
+        || left.stepId.localeCompare(right.stepId)))
+        .map(step => ({
+        stepId: step.stepId,
+        step: stepDisplayName(step),
+        section: !stepDropoff.flow ? null : currentOrder.has(step.stepId) ? 'current' : 'not-in-current-funnel',
+        nextStep: step.nextStepId || '',
+        entrants: step.entrants,
+        advancedToNextStep: step.advancedToNextStep,
+        dropoffs: step.dropoffs,
+        dropoffRate: step.dropoffRate,
+    }));
+};
 export const buildFunnelPathRows = (stepDropoff, pathFlow) => {
-    if (!pathFlow) {
+    if (!pathFlow)
         return [];
-    }
-    const transitionsByStepId = new Map(stepDropoff.steps.map((step) => [step.stepId, step]));
-    return [...pathFlow.steps]
-        .sort((left, right) => left.stepOrder - right.stepOrder || left.stepId.localeCompare(right.stepId))
-        .map((flowStep) => {
+    const transitionsByStepId = new Map(stepDropoff.steps.map(step => [step.stepId, step]));
+    const currentStepIds = new Set(pathFlow.steps.map(step => step.stepId));
+    const removedSteps = stepDropoff.steps
+        .filter(step => step.entrants > 0 && !currentStepIds.has(step.stepId))
+        .sort((left, right) => left.stepOrder - right.stepOrder || left.stepId.localeCompare(right.stepId));
+    const orderedSteps = [
+        ...[...pathFlow.steps].sort((left, right) => left.stepOrder - right.stepOrder || left.stepId.localeCompare(right.stepId)),
+        ...removedSteps.map(step => ({ ...step, stepTitle: null, stepPath: null })),
+    ];
+    return orderedSteps.map(flowStep => {
         const step = transitionsByStepId.get(flowStep.stepId);
         const entrants = step?.entrants ?? 0;
         return {
             stepId: flowStep.stepId,
             path: flowStep.stepPath || flowStep.stepId,
             label: flowStep.stepTitle || flowStep.stepName || flowStep.stepId,
+            section: currentStepIds.has(flowStep.stepId) ? 'current' : 'not-in-current-funnel',
             users: entrants,
             advancedToNextStep: step?.advancedToNextStep ?? 0,
             conversionToNextStep: entrants > 0 ? (step?.advancedToNextStep ?? 0) / entrants : 0,
@@ -147,22 +158,6 @@ export const buildFunnelPathRows = (stepDropoff, pathFlow) => {
         };
     });
 };
-export const journeyVersionLabel = (version) => `Journey ${version.seq}`;
-const describeReportJourneyVersion = (input) => {
-    if (input.journeyVersion === 'all') {
-        return { id: 'all', seq: null, label: 'All journey versions', startedAt: null, isCurrent: false };
-    }
-    const selected = input.stepDropoff.version.selected;
-    return selected
-        ? {
-            id: selected.id,
-            seq: selected.seq,
-            label: journeyVersionLabel(selected),
-            startedAt: selected.publishedAt,
-            isCurrent: selected.isCurrent,
-        }
-        : null;
-};
 const buildFunnelReportHeader = (input) => ({
     generatedAt: new Date().toISOString(),
     date: input.period.date,
@@ -171,16 +166,9 @@ const buildFunnelReportHeader = (input) => ({
     workspaceId: input.workspaceId,
     project: input.project,
     funnel: input.stepDropoff.funnel,
-    journeyVersion: describeReportJourneyVersion(input),
 });
 const formatFunnelReportTitle = (title, input) => {
-    const version = describeReportJourneyVersion(input);
-    return [
-        title,
-        input.period.label,
-        input.stepDropoff.funnel.name,
-        ...(version ? [version.isCurrent ? `${version.label} (current)` : version.label] : []),
-    ].join('\t');
+    return [title, input.period.label, input.stepDropoff.funnel.name].join('\t');
 };
 export const buildConversionReportPayload = (input) => ({
     ...buildFunnelReportHeader(input),
@@ -212,7 +200,12 @@ export const formatTransitionsTable = (input) => {
         formatFunnelReportTitle('Step transitions', input),
         'step\tnextStep\tentrants\tadvanced\tdropoffs\tdropoffRate',
     ];
+    let removedSectionStarted = false;
     for (const row of buildTransitionRows(input.stepDropoff)) {
+        if (row.section === 'not-in-current-funnel' && !removedSectionStarted) {
+            lines.push('Not in current funnel');
+            removedSectionStarted = true;
+        }
         lines.push([
             row.step,
             row.nextStep,
@@ -229,7 +222,12 @@ export const formatFunnelPathTable = (input) => {
         formatFunnelReportTitle('Full funnel path', input),
         'step\tpath\tusers\tadvanced\tconversionToNext\tdropoffs\tdropoffRate',
     ];
+    let removedSectionStarted = false;
     for (const row of buildFunnelPathRows(input.stepDropoff, input.pathFlow)) {
+        if (row.section === 'not-in-current-funnel' && !removedSectionStarted) {
+            lines.push('Not in current funnel');
+            removedSectionStarted = true;
+        }
         lines.push([
             row.label,
             row.path,
@@ -272,30 +270,6 @@ export const formatConversionsTable = (input) => {
     lines.push('', formatFunnelPathTable(input).trimEnd());
     return `${lines.join('\n')}\n`;
 };
-export const buildJourneyVersionsReportPayload = (input) => ({
-    generatedAt: new Date().toISOString(),
-    workspaceId: input.workspaceId,
-    project: input.project,
-    funnel: input.funnel,
-    versions: input.versions,
-});
-export const formatJourneyVersionsTable = (input) => {
-    const lines = [
-        `Journey versions\t${input.funnel.name}`,
-        'version\tid\tstartedAt\tactiveFrom\tactiveTo\tvisitors',
-    ];
-    for (const version of input.versions) {
-        lines.push([
-            version.isCurrent ? `${version.label} (current)` : version.label,
-            version.id,
-            version.startedAt || '',
-            version.activeFrom || '',
-            version.activeTo || '',
-            version.visitors === null ? '' : formatNumber(version.visitors),
-        ].join('\t'));
-    }
-    return `${lines.join('\n')}\n`;
-};
 const flattenCohortRows = (rows) => rows.flatMap((row) => [row, ...(row.segments || []), ...(row.children || [])]);
 const normalizeCurrency = (value) => {
     if (typeof value !== 'string') {
@@ -308,27 +282,6 @@ const sameCurrency = (left, right) => {
     const normalizedLeft = normalizeCurrency(left);
     return normalizedLeft !== null && normalizedLeft === normalizeCurrency(right);
 };
-const predictedAverageLtv = (row) => {
-    if (!normalizeCurrency(row.pLtvCurrency)) {
-        return null;
-    }
-    if (row.pLtvPredictedCustomerCount > 0) {
-        return typeof row.pLtvPredictedNetRevenueDay365Minor === 'number'
-            && Number.isFinite(row.pLtvPredictedNetRevenueDay365Minor)
-            ? row.pLtvPredictedNetRevenueDay365Minor
-                / row.pLtvPredictedCustomerCount
-                / 100
-            : null;
-    }
-    return typeof row.pLtv === 'number' && Number.isFinite(row.pLtv)
-        ? row.pLtv
-        : null;
-};
-const ratioToSpend = (value, spend) => (Number.isFinite(value) && Number.isFinite(spend) && spend > 0 ? value / spend : null);
-const formatRoi = (profit, spend) => {
-    const ratio = ratioToSpend(profit, spend);
-    return ratio === null ? '' : `${(ratio * 100).toFixed(2)}%`;
-};
 const forecastDefinitions = {
     day3: {
         minor: 'predictedNetRevenueDay3Minor',
@@ -370,14 +323,8 @@ export const formatCohortTable = (input) => {
     ];
     for (const row of flattenCohortRows(input.cohort.rows)) {
         const cpa = row.subscribers > 0 ? row.spend / row.subscribers : 0;
-        const averageLtv = predictedAverageLtv(row);
-        const predictedRevenue = averageLtv === null
-            ? null
-            : averageLtv * row.subscribers;
-        const predictedProfit = predictedRevenue !== null
-            && sameCurrency(row.pLtvCurrency, row.spendCurrency)
-            ? predictedRevenue - row.spend
-            : null;
+        const predictedRevenue = row.predictedRevenue ?? null;
+        const predictedProfit = row.predictedProfit ?? null;
         const spendCurrency = normalizeCurrency(row.spendCurrency);
         const revenueCurrency = row.revenueCurrencySafe === true
             ? normalizeCurrency(row.revenueCurrency)
@@ -408,8 +355,8 @@ export const formatCohortTable = (input) => {
             predictedProfit === null
                 ? ''
                 : formatCurrency(predictedProfit, pLtvCurrency || 'USD'),
-            predictedProfit === null ? '' : formatRoi(predictedProfit, row.spend),
-            formatForecastRoas(row, forecastDefinitions.day365),
+            formatPercentPoints(row.predictedRoiPercent ?? null),
+            formatPercentPoints(row.roasDay365Percent ?? null),
             formatForecastRoas(row, forecastDefinitions.day3),
             formatForecastRoas(row, forecastDefinitions.day90),
             formatForecastRoas(row, forecastDefinitions.day180),

package/dist/cli.d.ts

@@ -8,7 +8,7 @@ import { type DocsExitCode } from './docsOutput.js';
 import { type DocsDiagnostic, type DocsStatus } from './docsTransaction.js';
 import { type FunnelValidationExitCode, type FunnelValidationResult } from './diagnosticOutput.js';
 import { type StepContractMigrationApplyResult, type StepContractMigrationCheckResult, type StepContractMigrationTargetVersion, type StepContractMigrationValidationResult } from './stepContractMigration.js';
-import { type AnalyticsFunnelFlow, type AnalyticsJourneyVersionRow, type AnalyticsPeriod, type AnalyticsOutputFormat, type AnalyticsStepDropoffResponse } from './analyticsOutput.js';
+import { type AnalyticsFunnelFlow, type AnalyticsPeriod, type AnalyticsOutputFormat, type AnalyticsStepDropoffResponse } from './analyticsOutput.js';
 export declare const CANONICAL_CREATE_TEMPLATE_SLUG = "template";
 export declare const SCAFFOLD_TRANSIENT_PATHS: readonly ["node_modules", ".next", "out", "tsconfig.tsbuildinfo", ".funnelsgrove-scaffold.json"];
 export declare class CliContractError extends Error {
@@ -149,7 +149,6 @@ type FunnelAnalyticsCommandInput = {
     };
     format: AnalyticsOutputFormat;
     timezone?: string;
-    journeyVersion: string;
 };
 type SyncTargetIdInput = {
     explicitWorkspaceId?: string;
@@ -174,7 +173,6 @@ export declare function buildFunnelAnalyticsCommandInput(options: {
     date?: string;
     from?: string;
     to?: string;
-    journeyVersion?: string;
     format?: string;
     timezone?: string;
 }): FunnelAnalyticsCommandInput;
@@ -312,12 +310,4 @@ export declare const fetchFunnelPathAnalytics: (input: FunnelPathAnalyticsInput,
     stepDropoff: AnalyticsStepDropoffResponse;
     pathFlow: AnalyticsFunnelFlow | null;
 }>;
-type JourneyVersionsInput = Pick<FunnelPathAnalyticsInput, 'token' | 'workspaceId' | 'projectId' | 'funnelId'> & {
-    timezone?: string;
-    today: string;
-};
-export declare const fetchJourneyVersions: (input: JourneyVersionsInput, apiCall?: AnalyticsApiCall) => Promise<{
-    funnel: AnalyticsStepDropoffResponse["funnel"];
-    versions: AnalyticsJourneyVersionRow[];
-}>;
 export {};

package/dist/cli.js

@@ -32,7 +32,7 @@ import { applyTemplateDocsUpdate, inspectTemplateDocs, loadBundledDocs, planTemp
 import { renderValidationHuman, renderValidationJson, } from './diagnosticOutput.js';
 import { validateFunnel } from './funnelValidation.js';
 import { StepContractMigrationError, applyStepContractV2Migration, checkStepContractV2Migration, recoverStepContractV2Migration, resolveStepContractMigrationMode, stepContractMigrationReportPath, } from './stepContractMigration.js';
-import { assertHasCohortData, assertHasConversionData, assertHasFunnelPathData, assertHasTransitionData, buildCohortReportPayload, buildConversionReportPayload, buildFunnelPathReportPayload, buildJourneyVersionsReportPayload, buildTransitionReportPayload, formatAnalyticsJson, formatCohortTable, formatConversionsTable, formatFunnelPathTable, formatJourneyVersionsTable, formatTransitionsTable, journeyVersionLabel, normalizeAnalyticsOutputFormat, parseAnalyticsDate, parseAnalyticsPeriod, } from './analyticsOutput.js';
+import { assertHasCohortData, assertHasConversionData, assertHasFunnelPathData, assertHasTransitionData, buildCohortReportPayload, buildConversionReportPayload, buildFunnelPathReportPayload, buildTransitionReportPayload, formatAnalyticsJson, formatCohortTable, formatConversionsTable, formatFunnelPathTable, formatTransitionsTable, normalizeAnalyticsOutputFormat, parseAnalyticsDate, parseAnalyticsPeriod, } from './analyticsOutput.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const toKebabCase = (value) => value
     .trim()
@@ -1118,19 +1118,11 @@ export function buildAnalyticsCommandInput(options) {
         timezone,
     };
 }
-const parseAnalyticsJourneyVersion = (value) => {
-    const normalized = (value || 'current').trim().toLowerCase();
-    if (normalized === 'current' || normalized === 'all' || UUID_PATTERN.test(normalized)) {
-        return normalized;
-    }
-    throw new Error('--journey-version must be current, all, or a journey version id from `fgrove analytics versions`.');
-};
 export function buildFunnelAnalyticsCommandInput(options) {
     return {
         period: parseAnalyticsPeriod(options),
         format: normalizeAnalyticsOutputFormat(options.format),
         timezone: options.timezone?.trim() || undefined,
-        journeyVersion: parseAnalyticsJourneyVersion(options.journeyVersion),
     };
 }
 export function buildPatchSourceInput(input) {
@@ -2335,7 +2327,6 @@ const analyticsCommand = addExamples(program.command('analytics').description('D
     'fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json --out analytics.json',
     'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11',
     'fgrove analytics transitions --project claimbee --funnel claimbee-ios --date 2026-06-11',
-    'fgrove analytics versions --project claimbee --funnel claimbee-ios',
     'fgrove analytics cohort --project claimbee --date 2026-06-11 --format json',
 ]);
 const resolveFunnelAnalyticsTarget = async (options) => {
@@ -2389,7 +2380,6 @@ const fetchStepDropoffAnalytics = async (input, apiCall = callApi) => {
             workspaceId: input.workspaceId,
             projectId: input.projectId,
             funnelId: input.funnelId,
-            ...(input.commandInput.journeyVersion === 'current' ? {} : { versionId: input.commandInput.journeyVersion }),
             from: input.commandInput.period.fromIso,
             to: input.commandInput.period.toIso,
             timezone: input.commandInput.timezone,
@@ -2409,13 +2399,6 @@ const fetchPublishedFunnelFlow = async (input, apiCall = callApi) => {
     });
 };
 export const fetchFunnelPathAnalytics = async (input, apiCall = callApi) => {
-    const { journeyVersion } = input.commandInput;
-    if (journeyVersion !== 'current' && journeyVersion !== 'all') {
-        // An explicit Journey Version reports its own structure and is never
-        // paired with the current published path.
-        const stepDropoff = await fetchStepDropoffAnalytics(input, apiCall);
-        return { stepDropoff, pathFlow: stepDropoff.flow };
-    }
     const [stepDropoff, publishedFunnelFlow] = await Promise.all([
         fetchStepDropoffAnalytics(input, apiCall),
         fetchPublishedFunnelFlow(input, apiCall),
@@ -2425,46 +2408,6 @@ export const fetchFunnelPathAnalytics = async (input, apiCall = callApi) => {
         pathFlow: publishedFunnelFlow.status === 'ready' ? publishedFunnelFlow.flow : null,
     };
 };
-// The API reads analytics dates in this timezone when a request names none.
-const DEFAULT_ANALYTICS_TIMEZONE = 'America/Los_Angeles';
-const toAnalyticsDate = (value, timezone) => new Intl.DateTimeFormat('en-CA', { timeZone: timezone || DEFAULT_ANALYTICS_TIMEZONE }).format(value);
-export const fetchJourneyVersions = async (input, apiCall = callApi) => {
-    const { today, timezone, ...target } = input;
-    const current = await fetchStepDropoffAnalytics({
-        ...target,
-        commandInput: buildFunnelAnalyticsCommandInput({ date: today, timezone }),
-    }, apiCall);
-    const newestFirst = [...current.version.options].sort((left, right) => right.seq - left.seq);
-    // A version is active from its start day until the next version starts;
-    // version-scoped counts make the shared switch day safe to include in both.
-    const startDate = (startedAt) => (startedAt ? toAnalyticsDate(new Date(startedAt), timezone) : null);
-    const versions = await Promise.all(newestFirst.map(async (version, index) => {
-        const activeFrom = startDate(version.publishedAt);
-        const activeTo = index === 0 ? null : startDate(newestFirst[index - 1].publishedAt);
-        const report = activeFrom
-            ? await fetchStepDropoffAnalytics({
-                ...target,
-                commandInput: buildFunnelAnalyticsCommandInput({
-                    from: activeFrom,
-                    to: activeTo ?? today,
-                    journeyVersion: version.id,
-                    timezone,
-                }),
-            }, apiCall)
-            : null;
-        return {
-            id: version.id,
-            seq: version.seq,
-            label: journeyVersionLabel(version),
-            isCurrent: version.isCurrent,
-            startedAt: version.publishedAt,
-            activeFrom,
-            activeTo,
-            visitors: report ? report.totals.visitors ?? 0 : null,
-        };
-    }));
-    return { funnel: current.funnel, versions };
-};
 const addFunnelReportOptions = (command) => command
     .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
     .option('--project <id-or-slug-or-name>', 'Project id, slug, or name')
@@ -2472,7 +2415,6 @@ const addFunnelReportOptions = (command) => command
     .option('--date <yyyy-mm-dd>', 'Analytics date; use instead of --from/--to for one day')
     .option('--from <yyyy-mm-dd>', 'First analytics date of a range, used with --to')
     .option('--to <yyyy-mm-dd>', 'Last analytics date of a range, used with --from')
-    .option('--journey-version <id|current|all>', 'Journey version: current, all, or an id from `fgrove analytics versions`', 'current')
     .option('--format <table-or-json>', 'Output format: table or json', 'table')
     .option('--out <path>', 'Write output to a file')
     .option('--timezone <iana-timezone>', 'Analytics timezone, for example America/Los_Angeles');
@@ -2481,7 +2423,7 @@ addExamples(addFunnelReportOptions(analyticsCommand
     .description('Download conversion data, full funnel path, and step transitions for a day or date range')), [
     'fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11',
     'fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json --out analytics.json',
-    'fgrove analytics conversions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14 --journey-version all',
+    'fgrove analytics conversions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
@@ -2512,7 +2454,6 @@ addExamples(addFunnelReportOptions(analyticsCommand
     assertHasConversionData(context.commandInput.period.label, overview, stepDropoff);
     const report = {
         period: context.commandInput.period,
-        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
         overview,
         pathFlow,
@@ -2533,7 +2474,7 @@ addExamples(addFunnelReportOptions(analyticsCommand
     .description('Download the full funnel path report for a day or date range')), [
     'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11',
     'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json',
-    'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14 --journey-version <journey-version-id>',
+    'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
@@ -2547,7 +2488,6 @@ addExamples(addFunnelReportOptions(analyticsCommand
     assertHasFunnelPathData(context.commandInput.period.label, stepDropoff, pathFlow);
     const report = {
         period: context.commandInput.period,
-        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
         pathFlow,
     };
@@ -2567,7 +2507,7 @@ addExamples(addFunnelReportOptions(analyticsCommand
     .description('Download step transitions and drop-offs for a day or date range')), [
     'fgrove analytics transitions --project claimbee --funnel claimbee-ios --date 2026-06-11',
     'fgrove analytics transitions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json',
-    'fgrove analytics transitions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14 --journey-version <journey-version-id>',
+    'fgrove analytics transitions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
@@ -2581,7 +2521,6 @@ addExamples(addFunnelReportOptions(analyticsCommand
     assertHasTransitionData(context.commandInput.period.label, stepDropoff);
     const report = {
         period: context.commandInput.period,
-        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
     };
     await writeOrPrintAnalyticsOutput({
@@ -2595,41 +2534,6 @@ addExamples(addFunnelReportOptions(analyticsCommand
         out: options.out,
     });
 });
-addExamples(analyticsCommand
-    .command('versions')
-    .description('List journey versions with their active days and visitors')
-    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
-    .option('--project <id-or-slug-or-name>', 'Project id, slug, or name')
-    .option('--funnel <id-or-slug-or-name>', 'Funnel id, slug, or name')
-    .option('--format <table-or-json>', 'Output format: table or json', 'table')
-    .option('--out <path>', 'Write output to a file')
-    .option('--timezone <iana-timezone>', 'Analytics timezone, for example America/Los_Angeles'), [
-    'fgrove analytics versions --project claimbee --funnel claimbee-ios',
-    'fgrove analytics versions --project claimbee --funnel claimbee-ios --format json',
-])
-    .action(async (options) => {
-    const format = normalizeAnalyticsOutputFormat(options.format);
-    const timezone = options.timezone?.trim() || undefined;
-    const target = await resolveFunnelAnalyticsTarget(options);
-    const report = await fetchJourneyVersions({
-        token: target.token,
-        workspaceId: target.workspace.id,
-        projectId: target.project.id,
-        funnelId: target.funnel.id,
-        timezone,
-        today: toAnalyticsDate(new Date(), timezone),
-    });
-    await writeOrPrintAnalyticsOutput({
-        format,
-        payload: buildJourneyVersionsReportPayload({
-            ...report,
-            workspaceId: target.workspace.id,
-            project: target.project,
-        }),
-        table: formatJourneyVersionsTable(report),
-        out: options.out,
-    });
-});
 addExamples(analyticsCommand
     .command('cohort')
     .description('Download one-day cohort marketing data')

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.290",
+      "repositoryCliVersion": "0.1.293",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.283",
+        "bundleVersion": "2.0.286",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d"
+            "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b"
+            "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.289",
+      "repositoryCliVersion": "0.1.292",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.282",
+        "bundleVersion": "2.0.285",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "474e05021e90bef7f781a96542c45c409e04b97d13fb8027d3d4b760d90ae336"
+            "sha256": "9f91fab6b6af7456e614811d75fc4007e35b0c26086135ddd6dbf5d0491253e7"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "7b8e363b1ad3d48aebcfa1d4c2606a61d8e18a809b42ff19ceffcb800bc6e3fd"
+            "sha256": "2c4bd0e6e5677772fcb6889d63833d9fcdd9d66da167571219aa5145567b335f"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.288",
+      "repositoryCliVersion": "0.1.291",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.281",
+        "bundleVersion": "2.0.284",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bed96c808dba9780b3ea3cefba296e650e08d8d30708e5daecee2b00b633c4ef"
+            "sha256": "32c4dc6493b9195c1d0c601e593975bfbd029eb348e986c87f9823b7d390e406"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "616b91c1bd60184c3ca34f4b9e0aecd5773667998a50fcd50dc7d374e0b71d71"
+            "sha256": "bac474b7e4180ebc96f0b0ed2f1391b291d7065e3c626f90a7dac4aed4c567d8"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.287",
+      "repositoryCliVersion": "0.1.290",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.280",
+        "bundleVersion": "2.0.283",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "8be689adbc24bc411eb7675e6938060d7fdb4588d8dd0175e763a487017c3422"
+            "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "fc505f7191aba1e820f935e33e729fe9fca4b3d529f0fd79e9c9a0692892a935"
+            "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.286",
+      "repositoryCliVersion": "0.1.289",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.279",
+        "bundleVersion": "2.0.282",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "b0dd8197ba011ad8bde850c3db51387a745642764120c20d883220af146f69a1"
+            "sha256": "474e05021e90bef7f781a96542c45c409e04b97d13fb8027d3d4b760d90ae336"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "cd01ef6c53f7fceeb119d23983f89362b24dfbc4e7eb97d72574dfdb2da516a7"
+            "sha256": "7b8e363b1ad3d48aebcfa1d4c2606a61d8e18a809b42ff19ceffcb800bc6e3fd"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.285",
+      "repositoryCliVersion": "0.1.288",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.278",
+        "bundleVersion": "2.0.281",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -760,7 +760,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "4324a89f55f38b148c13ad26cbc65a3efb45b8bd034180881b31b3093622e949"
+            "sha256": "30a445a2042549fe4bc87e0635785b5ff7876cbba0c8c27db2fcb04de3976f47"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -772,7 +772,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "993f4bb468db7eb874c81c23464b76260a51c0f9491b563fea6ab9d59dad59ef"
+            "sha256": "6f9c9782340fef18a39fb6321ee2c80f5dcfaf210114a4dd0351b6f27aeacc11"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "ce93e7385a991ba5fd0c5b2d00499f0efc8bc6aabdf67f5288aa0b06648d987b"
+            "sha256": "bed96c808dba9780b3ea3cefba296e650e08d8d30708e5daecee2b00b633c4ef"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "a8e381a1f92df52dbc9d20bb08b5012991132996848fdf41cc6e14ca12f4d9d1"
+            "sha256": "616b91c1bd60184c3ca34f4b9e0aecd5773667998a50fcd50dc7d374e0b71d71"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.284",
+      "repositoryCliVersion": "0.1.287",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.277",
+        "bundleVersion": "2.0.280",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -907,7 +907,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "4324a89f55f38b148c13ad26cbc65a3efb45b8bd034180881b31b3093622e949"
+            "sha256": "30a445a2042549fe4bc87e0635785b5ff7876cbba0c8c27db2fcb04de3976f47"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -919,7 +919,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "993f4bb468db7eb874c81c23464b76260a51c0f9491b563fea6ab9d59dad59ef"
+            "sha256": "6f9c9782340fef18a39fb6321ee2c80f5dcfaf210114a4dd0351b6f27aeacc11"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "876896d34bd8dcca2b9d5abffe84895f307d5795b093b55502085b45549c95dc"
+            "sha256": "8be689adbc24bc411eb7675e6938060d7fdb4588d8dd0175e763a487017c3422"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "d2e0907e2f3fbe1dc37396d51a3b75653fe141961788b0442615fcce97d70aa9"
+            "sha256": "fc505f7191aba1e820f935e33e729fe9fca4b3d529f0fd79e9c9a0692892a935"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.290",
+  "version": "0.1.293",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,14 +34,14 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.31.0",
+    "@funnelsgrove/runtime": "0.32.0",
     "commander": "^12.0.0",
     "ignore": "^7.0.8",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.13.0",
-    "@funnelsgrove/payments": "0.40.0",
+    "@funnelsgrove/analytics": "0.14.0",
+    "@funnelsgrove/payments": "0.41.0",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.283",
+  "bundleVersion": "2.0.286",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d"
+      "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b"
+      "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.32.0`, then `@funnelsgrove/analytics` `0.14.0`, then `@funnelsgrove/payments` `0.41.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.290`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.32.0`, then `@funnelsgrove/analytics` `0.14.0`, then `@funnelsgrove/payments` `0.41.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.293`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_docs/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.283",
+  "bundleVersion": "2.0.286",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.283",
+  "bundleVersion": "2.0.286",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d"
+      "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b"
+      "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "364e6dad3605c2b0e8e0cfa70eabbd19585aa2e675658da172bd86c65bd8a697",
+  "sourceTreeHash": "ebc3c4ac23c100ff03effd89fadfa645870e8724242aa8799e0e2802e4137c49",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.283",
+  "docsBundleVersion": "2.0.286",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "b7b5a06c6c5296cccf941ca82c7f6e87021206ad454ef4412d82e845bbcfd942",
+      "sha256": "3b05e2aff2f517b672fdcaaa0c0bb7e9e1e4e3fbfc684918ea43151cb21c44e8",
       "mode": "100644"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d",
+      "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d",
       "mode": "100644"
     },
     {
@@ -206,7 +206,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b",
+      "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7",
       "mode": "100644"
     },
     {
@@ -236,12 +236,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "3f2cab8dd12b4b38357157ce37a094180088757f4fd062cc0be6b1e8e6f2b7ad",
+      "sha256": "5c960e77de9d286112a09eae806b2bf66539d2ff24754d18ab0f4b509b7f3591",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "1b0ea6a4a00e1875451e635ef2579164a46388f7dbc977bf54cfc528cb39a1f0",
+      "sha256": "b9a27ad44b8b27c874635e718cf88d05543ccedfc5719d1ae74c6a4453522d3d",
       "mode": "100644"
     },
     {

package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.32.0`, then `@funnelsgrove/analytics` `0.14.0`, then `@funnelsgrove/payments` `0.41.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.290`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.32.0`, then `@funnelsgrove/analytics` `0.14.0`, then `@funnelsgrove/payments` `0.41.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.293`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.283",
+  "bundleVersion": "2.0.286",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/package-lock.json

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.13.0",
-        "@funnelsgrove/payments": "^0.40.0",
-        "@funnelsgrove/runtime": "^0.31.0",
+        "@funnelsgrove/analytics": "^0.14.0",
+        "@funnelsgrove/payments": "^0.41.0",
+        "@funnelsgrove/runtime": "^0.32.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -940,17 +940,17 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.13.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.13.0.tgz",
-      "integrity": "sha512-MiuyKnIjCslaZ19tavuGS0JPLm8fWeV1sNO7LnVPWoJ+eKhvYDCht7JBu0Ar7UG0NmkiXoTdYaq3LQCadkBWyw==",
+      "version": "0.14.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.14.0.tgz",
+      "integrity": "sha512-oG0WwMCgbTP9A7iU6187t3ejr4pJKvYOQIP3FYXmB26TH7tsl+pGz39By/3aALX/Vbl3V9QVs2nroa3vchgnfA==",
       "peerDependencies": {
-        "@funnelsgrove/runtime": "^0.31.0"
+        "@funnelsgrove/runtime": "^0.32.0"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.40.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.40.0.tgz",
-      "integrity": "sha512-/9YIXC1T6jdRxxRgU5y/Wd33tZAJoEmrI/VGMdU7zo+oObzRFvPVpscV8e0XeTGZFVtvxi05LiOvd9sDv8iHYA==",
+      "version": "0.41.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.41.0.tgz",
+      "integrity": "sha512-+pGg2f4FZxR2AWCvIPX+NXD1X2V6EV/+CVX2Fu1ailNZEmvuNtNMz20/biM1hX+ZgDb8Lt+nG0rCLc6KazqkwA==",
       "dependencies": {
         "@solidgate/react-sdk": "1.34.0",
         "@stripe/react-stripe-js": "^5.6.0",
@@ -960,14 +960,14 @@
         "stripe": "^20.3.1"
       },
       "peerDependencies": {
-        "@funnelsgrove/analytics": "^0.13.0",
-        "@funnelsgrove/runtime": "^0.31.0"
+        "@funnelsgrove/analytics": "^0.14.0",
+        "@funnelsgrove/runtime": "^0.32.0"
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.31.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.31.0.tgz",
-      "integrity": "sha512-u1MQJr3n2pUVfWmQDPp2rSB9KlWySBkQzFVJfgCYm3fuFVuCo8j+M4v+NKXO5BEfFWyUgru7mnJrNwGWEJ6myA==",
+      "version": "0.32.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.32.0.tgz",
+      "integrity": "sha512-pWneYsT/ET05o4jTb7uevajarmMwLjty0bfASpMvudeNAUtK1BVsE19K0IVY+FYci81a3Sm0wRN72mK8oRUhdw==",
       "dependencies": {
         "@funnelsgrove/sdk": "0.4.0",
         "posthog-js": "^1.369.2",

package/template_scaffold/package.json

@@ -12,9 +12,9 @@
     "validate:funnel": "vite-node --config src/contract/funnel-validator.vite.config.ts src/contract/validate-funnel.cli.ts"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "^0.13.0",
-    "@funnelsgrove/payments": "^0.40.0",
-    "@funnelsgrove/runtime": "^0.31.0",
+    "@funnelsgrove/analytics": "^0.14.0",
+    "@funnelsgrove/payments": "^0.41.0",
+    "@funnelsgrove/runtime": "^0.32.0",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",