@funnelsgrove/cli 0.1.262 → 0.1.264

package/dist/cli.js

@@ -29,7 +29,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, buildTransitionReportPayload, formatAnalyticsJson, formatCohortTable, formatConversionsTable, formatFunnelPathTable, formatTransitionsTable, normalizeAnalyticsOutputFormat, parseAnalyticsDate, } from './analyticsOutput.js';
+import { assertHasCohortData, assertHasConversionData, assertHasFunnelPathData, assertHasTransitionData, buildCohortReportPayload, buildConversionReportPayload, buildFunnelPathReportPayload, buildJourneyVersionsReportPayload, buildTransitionReportPayload, formatAnalyticsJson, formatCohortTable, formatConversionsTable, formatFunnelPathTable, formatJourneyVersionsTable, formatTransitionsTable, journeyVersionLabel, normalizeAnalyticsOutputFormat, parseAnalyticsDate, parseAnalyticsPeriod, } from './analyticsOutput.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const toKebabCase = (value) => value
     .trim()
@@ -1115,6 +1115,21 @@ 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) {
     return {
         workspaceId: input.workspaceId,
@@ -2169,9 +2184,10 @@ 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 loadFunnelAnalyticsContext = async (options) => {
+const resolveFunnelAnalyticsTarget = async (options) => {
     const token = await readAuthToken();
     const workspace = await resolveWorkspace(token, options.workspace);
     const project = await resolveAnalyticsProject({
@@ -2189,7 +2205,13 @@ const loadFunnelAnalyticsContext = async (options) => {
         workspace,
         project,
         funnel,
-        commandInput: buildAnalyticsCommandInput(options),
+    };
+};
+const loadFunnelAnalyticsContext = async (options) => {
+    const commandInput = buildFunnelAnalyticsCommandInput(options);
+    return {
+        ...await resolveFunnelAnalyticsTarget(options),
+        commandInput,
     };
 };
 const loadProjectAnalyticsContext = async (options) => {
@@ -2216,8 +2238,9 @@ const fetchStepDropoffAnalytics = async (input, apiCall = callApi) => {
             workspaceId: input.workspaceId,
             projectId: input.projectId,
             funnelId: input.funnelId,
-            from: input.commandInput.from,
-            to: input.commandInput.to,
+            ...(input.commandInput.journeyVersion === 'current' ? {} : { versionId: input.commandInput.journeyVersion }),
+            from: input.commandInput.period.fromIso,
+            to: input.commandInput.period.toIso,
             timezone: input.commandInput.timezone,
         },
     });
@@ -2235,24 +2258,79 @@ 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),
     ]);
-    return { stepDropoff, publishedFunnelFlow };
+    return {
+        stepDropoff,
+        pathFlow: publishedFunnelFlow.status === 'ready' ? publishedFunnelFlow.flow : null,
+    };
 };
-addExamples(analyticsCommand
-    .command('conversions')
-    .description('Download one-day conversion data, full funnel path, and step transitions')
+// 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')
     .option('--funnel <id-or-slug-or-name>', 'Funnel id, slug, or name')
-    .requiredOption('--date <yyyy-mm-dd>', 'Analytics date')
+    .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'), [
+    .option('--timezone <iana-timezone>', 'Analytics timezone, for example America/Los_Angeles');
+addExamples(addFunnelReportOptions(analyticsCommand
+    .command('conversions')
+    .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',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
@@ -2265,8 +2343,8 @@ addExamples(analyticsCommand
                 workspaceId: context.workspace.id,
                 projectId: context.project.id,
                 funnelId: context.funnel.id,
-                from: context.commandInput.from,
-                to: context.commandInput.to,
+                from: context.commandInput.period.fromIso,
+                to: context.commandInput.period.toIso,
                 timezone: context.commandInput.timezone,
                 limit: 20_000,
             },
@@ -2279,81 +2357,66 @@ addExamples(analyticsCommand
             commandInput: context.commandInput,
         }),
     ]);
-    const { stepDropoff, publishedFunnelFlow } = pathAnalytics;
-    assertHasConversionData(context.commandInput.date, overview, stepDropoff);
-    const payload = buildConversionReportPayload({
-        date: context.commandInput.date,
-        workspaceId: context.workspace.id,
-        project: context.project,
-        overview,
+    const { stepDropoff, pathFlow } = pathAnalytics;
+    assertHasConversionData(context.commandInput.period.label, overview, stepDropoff);
+    const report = {
+        period: context.commandInput.period,
+        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
-        publishedFunnelFlow,
-    });
+        overview,
+        pathFlow,
+    };
     await writeOrPrintAnalyticsOutput({
         format: context.commandInput.format,
-        payload,
-        table: formatConversionsTable({
-            date: context.commandInput.date,
-            overview,
-            stepDropoff,
-            publishedFunnelFlow,
+        payload: buildConversionReportPayload({
+            ...report,
+            workspaceId: context.workspace.id,
+            project: context.project,
         }),
+        table: formatConversionsTable(report),
         out: options.out,
     });
 });
-addExamples(analyticsCommand
+addExamples(addFunnelReportOptions(analyticsCommand
     .command('funnel-path')
-    .description('Download the full one-day funnel path report')
-    .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')
-    .requiredOption('--date <yyyy-mm-dd>', 'Analytics date')
-    .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'), [
+    .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>',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
-    const { stepDropoff, publishedFunnelFlow } = await fetchFunnelPathAnalytics({
+    const { stepDropoff, pathFlow } = await fetchFunnelPathAnalytics({
         token: context.token,
         workspaceId: context.workspace.id,
         projectId: context.project.id,
         funnelId: context.funnel.id,
         commandInput: context.commandInput,
     });
-    assertHasFunnelPathData(context.commandInput.date, stepDropoff, publishedFunnelFlow);
-    const payload = buildFunnelPathReportPayload({
-        date: context.commandInput.date,
-        workspaceId: context.workspace.id,
-        project: context.project,
+    assertHasFunnelPathData(context.commandInput.period.label, stepDropoff, pathFlow);
+    const report = {
+        period: context.commandInput.period,
+        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
-        publishedFunnelFlow,
-    });
+        pathFlow,
+    };
     await writeOrPrintAnalyticsOutput({
         format: context.commandInput.format,
-        payload,
-        table: formatFunnelPathTable({
-            date: context.commandInput.date,
-            stepDropoff,
-            publishedFunnelFlow,
+        payload: buildFunnelPathReportPayload({
+            ...report,
+            workspaceId: context.workspace.id,
+            project: context.project,
         }),
+        table: formatFunnelPathTable(report),
         out: options.out,
     });
 });
-addExamples(analyticsCommand
+addExamples(addFunnelReportOptions(analyticsCommand
     .command('transitions')
-    .description('Download one-day step transitions and drop-offs')
-    .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')
-    .requiredOption('--date <yyyy-mm-dd>', 'Analytics date')
-    .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'), [
+    .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>',
 ])
     .action(async (options) => {
     const context = await loadFunnelAnalyticsContext(options);
@@ -2364,20 +2427,55 @@ addExamples(analyticsCommand
         funnelId: context.funnel.id,
         commandInput: context.commandInput,
     });
-    assertHasTransitionData(context.commandInput.date, stepDropoff);
-    const payload = buildTransitionReportPayload({
-        date: context.commandInput.date,
-        workspaceId: context.workspace.id,
-        project: context.project,
+    assertHasTransitionData(context.commandInput.period.label, stepDropoff);
+    const report = {
+        period: context.commandInput.period,
+        journeyVersion: context.commandInput.journeyVersion,
         stepDropoff,
-    });
+    };
     await writeOrPrintAnalyticsOutput({
         format: context.commandInput.format,
-        payload,
-        table: formatTransitionsTable({
-            date: context.commandInput.date,
-            stepDropoff,
+        payload: buildTransitionReportPayload({
+            ...report,
+            workspaceId: context.workspace.id,
+            project: context.project,
+        }),
+        table: formatTransitionsTable(report),
+        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,
     });
 });

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.262",
+      "repositoryCliVersion": "0.1.264",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.255",
+        "bundleVersion": "2.0.257",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "d733607091b48f87b667e43c68984116b4f5c82cdc5ca04af688ccc7160c0e36"
+            "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "3bb975a7ced201ae60030e863b150e51fc8b5d496e0d0fb93fc92c48953e0c39"
+            "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.261",
+      "repositoryCliVersion": "0.1.263",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.254",
+        "bundleVersion": "2.0.256",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "92a56af5007b51ced39aec37795aeab3a94552e1d242c13f3dbd056a353ebdef"
+            "sha256": "afba67a5679827efbd37d706d290e393558d4abf13271b5606e069b1694960e8"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "68a262476d89d22cf3206316ccbf935ae3cf1686a7d951f2024cfffc9e93384d"
+            "sha256": "ac03af2c7446ffefd0acd9e28db1c4d6fa7a04848b1c2a562a3e722d16f9a98a"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.260",
+      "repositoryCliVersion": "0.1.262",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.253",
+        "bundleVersion": "2.0.255",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "3f4c093fce58c01bd66604a5dd371bdd1f3cf3743bc7e556e2a1e871e0b24866"
+            "sha256": "d733607091b48f87b667e43c68984116b4f5c82cdc5ca04af688ccc7160c0e36"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "dea21f974e2601112ec12aac3493ece0c0955eb612c6eb790874add999a11822"
+            "sha256": "3bb975a7ced201ae60030e863b150e51fc8b5d496e0d0fb93fc92c48953e0c39"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.259",
+      "repositoryCliVersion": "0.1.261",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.252",
+        "bundleVersion": "2.0.254",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "d1ca070960305b60bc78dae50355a59c8c068b59ea161b4acc9403ec1848b04c"
+            "sha256": "92a56af5007b51ced39aec37795aeab3a94552e1d242c13f3dbd056a353ebdef"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "b683d23440209016d94de8319f46040e4e174567d3cc0a1f8ede194c29cc3e76"
+            "sha256": "68a262476d89d22cf3206316ccbf935ae3cf1686a7d951f2024cfffc9e93384d"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.258",
+      "repositoryCliVersion": "0.1.260",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.251",
+        "bundleVersion": "2.0.253",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "871dd4aa34ed91d4bf366e8ca7f0882f78d9ae1098ee2c587064743ecd81feba"
+            "sha256": "3f4c093fce58c01bd66604a5dd371bdd1f3cf3743bc7e556e2a1e871e0b24866"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "c41f35a830e5a58e5896f76afb97d4313308734ad93c0cc3636b4495927d170e"
+            "sha256": "dea21f974e2601112ec12aac3493ece0c0955eb612c6eb790874add999a11822"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.256",
+      "repositoryCliVersion": "0.1.259",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.249",
+        "bundleVersion": "2.0.252",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "800853d3acaf8ccb9f56891b7d83a1a17c8fe8e63f40bc46029bc7b76cdb2ddd"
+            "sha256": "d1ca070960305b60bc78dae50355a59c8c068b59ea161b4acc9403ec1848b04c"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -788,7 +788,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
-            "sha256": "97da7e26c5dbe8f63e654e4e0a035a4ecfbb9bcfd80db67d45c627141d6a2756"
+            "sha256": "c8a83c33cd33bea6d5efde91d7c479505f77077f16de8073064baacbfad98e5f"
           },
           {
             "path": "docs/funnelsgrove/qa/paywall-checkout.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "5358d40a9accbc34e79924d07053d17f74915bb90db963756c208c00e90541e8"
+            "sha256": "b683d23440209016d94de8319f46040e4e174567d3cc0a1f8ede194c29cc3e76"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.255",
+      "repositoryCliVersion": "0.1.258",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.248",
+        "bundleVersion": "2.0.251",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -911,7 +911,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
-            "sha256": "17c8a91800ec1d2247b1e0fd12cc80fbfce162297aa928432cc0a574acd9fc06"
+            "sha256": "38cd477fa65cb00718c6609ede520bc5b7538f331072c888a6cc32e8d0130d27"
           },
           {
             "path": "docs/funnelsgrove/contracts/flow-routing.md",
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "19ea25028aebc54e553c223385ed1bf704a4f2bdef817250e01e566866034673"
+            "sha256": "871dd4aa34ed91d4bf366e8ca7f0882f78d9ae1098ee2c587064743ecd81feba"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -935,7 +935,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
-            "sha256": "97da7e26c5dbe8f63e654e4e0a035a4ecfbb9bcfd80db67d45c627141d6a2756"
+            "sha256": "c8a83c33cd33bea6d5efde91d7c479505f77077f16de8073064baacbfad98e5f"
           },
           {
             "path": "docs/funnelsgrove/qa/paywall-checkout.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "07db87377a3d12b6bcf119d01bebffbbbb4702bb3cf83b8059132adbd2486a21"
+            "sha256": "c41f35a830e5a58e5896f76afb97d4313308734ad93c0cc3636b4495927d170e"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.262",
+  "version": "0.1.264",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -41,7 +41,7 @@
   },
   "devDependencies": {
     "@funnelsgrove/analytics": "0.7.0",
-    "@funnelsgrove/payments": "0.26.0",
+    "@funnelsgrove/payments": "0.27.0",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.255",
+  "bundleVersion": "2.0.257",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d733607091b48f87b667e43c68984116b4f5c82cdc5ca04af688ccc7160c0e36"
+      "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "3bb975a7ced201ae60030e863b150e51fc8b5d496e0d0fb93fc92c48953e0c39"
+      "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
     }
   ]
 }

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.25.0`, then `@funnelsgrove/analytics` `0.7.0`, then `@funnelsgrove/payments` `0.26.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.262`, 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.25.0`, then `@funnelsgrove/analytics` `0.7.0`, then `@funnelsgrove/payments` `0.27.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.264`, 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.255",
+  "bundleVersion": "2.0.257",
   "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.255",
+  "bundleVersion": "2.0.257",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d733607091b48f87b667e43c68984116b4f5c82cdc5ca04af688ccc7160c0e36"
+      "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "3bb975a7ced201ae60030e863b150e51fc8b5d496e0d0fb93fc92c48953e0c39"
+      "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
     }
   ]
 }