@funnelsgrove/cli 0.1.147 → 0.1.150

package/README.md

@@ -68,7 +68,7 @@ for the same local diff.
 
 Use `fgrove env pull` from a synced folder to refresh only the ignored local `.env` file after project settings change, without replacing source files. The generated file identifies the current hosted draft through `NEXT_PUBLIC_FUNNEL_VERSION_ID`, so transactional steps such as email capture work during local QA.
 
-`fgrove offer-sets sync` reports the applied offer set and written generated files before waiting for GitHub. By default it waits for the exact GitHub sync job. If that job is still pending or running when the wait times out, the command continues with a warning on stderr and asks you to check the eventual result with `fgrove github status`. Terminal job failures, missing jobs, and API failures still exit non-zero. Pass `--no-github-sync` to skip the wait entirely when the generated file will be committed through the normal repository workflow.
+Offer sets and payment mappings are runtime configuration. They are resolved remotely for preview and published funnels; `sync down` does not generate or download an offer-set source file.
 
 Create an experiment draft from a strict JSON spec:
 

package/dist/cli.d.ts

@@ -149,9 +149,8 @@ type SyncTargetIdInput = {
     active?: Pick<ActiveContext, 'workspaceId' | 'funnelId'> | null;
     defaultWorkspaceId?: string;
 };
-type GeneratedConfigKind = 'offerSets' | 'experiments';
-export declare const SYNC_DOWN_GENERATED_CONFIG_KINDS: GeneratedConfigKind[];
-export declare const EXPERIMENT_TRANSACTION_RECOVERY_COMMANDS: readonly ["sync down", "sync rebase", "sync up", "experiments sync", "offer-sets sync"];
+type GeneratedConfigKind = 'experiments';
+export declare const EXPERIMENT_TRANSACTION_RECOVERY_COMMANDS: readonly ["sync down", "sync rebase", "sync up", "experiments sync"];
 export declare function resolveSyncTargetIds(input: SyncTargetIdInput): {
     workspaceId: string;
     funnelId?: string;
@@ -182,16 +181,6 @@ export declare function formatSourceCandidateSyncSuccess(input: {
     deletedFileCount: number;
     versionId: string;
 }): string;
-export declare function buildSyncOfferSetPlansInput(input: {
-    workspaceId: string;
-    funnelId: string;
-    offerSet: string;
-}): {
-    workspaceId: string;
-    funnelId: string;
-    offerSetId?: string;
-    offerSetKey?: string;
-};
 export declare function buildGeneratedConfigSyncInput(input: {
     workspaceId: string;
     funnelId: string;
@@ -262,12 +251,10 @@ export declare const buildCloneFunnelMutationInput: (input: {
 };
 export type GitHubSyncTimeoutPolicy = 'strict' | 'continue';
 export declare const PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
-export declare const OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
 export declare const SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
 export declare const SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
 export declare const GITHUB_SYNC_TIMEOUT_POLICIES: {
     readonly publish: "continue";
-    readonly offerSetsSync: "continue";
     readonly syncUpNoLocalChanges: "strict";
     readonly syncUpCommittedChanges: "strict";
 };
@@ -282,10 +269,6 @@ export declare const syncGitHubDraftForCli: (input: {
 export declare const shouldSyncGitHubDraft: (options: {
     githubSync?: boolean;
 }) => boolean;
-export declare const formatOfferSetSyncSuccess: (input: {
-    offerSetLabel: string;
-    generatedFileCount: number;
-}) => string[];
 type ExperimentLifecycleAction = 'start' | 'stop' | 'restart' | 'end';
 type ExperimentLifecycleResult = {
     id: string;

package/dist/cli.js

@@ -11,7 +11,7 @@ import { CURRENT_STEP_CONTRACT_VERSION, FUNNEL_CONTRACT_DIAGNOSTIC_CODES, PREVIO
 import { abortFunnelSourceCandidate, applyFunnelDraftPatch, beginFunnelSourceCandidate, callTrpcProcedure, createFunnelExperimentFromSpec, finalizeFunnelDirectAssetUpload, finalizeFunnelSourceCandidate, prepareFunnelDirectAssetUpload, stageFunnelSourceCandidate, } from './apiClient.js';
 import { cliReleaseIdentity } from './cliIdentity.js';
 import { clearActiveContext, getDefaultAuthConfigPath, loadActiveContext, loadAuthToken, saveActiveContext, saveAuthToken, } from './authStore.js';
-import { buildCommittedSyncManifest, buildDownloadedSyncManifest, buildSourceCandidateOperations, collectChangedSourceFiles, collectSourceFiles, collectSourceSnapshot, ensureGitignore, formatSyncUploadSummary, hasLocalSourceChanges, rebaseSourceFiles, readSyncManifest, replaceSourceFiles, runSyncDownLocalLifecycle, runSourceCandidateSync, writeLocalEnvFile, writeSourceFiles, writeSourceRebaseBackup, writeSyncManifest, } from './localSync.js';
+import { buildCommittedSyncManifest, buildDownloadedSyncManifest, buildSourceCandidateOperations, collectChangedSourceFiles, collectSourceFiles, collectSourceSnapshot, ensureGitignore, filterSyncableSourceFiles, formatSyncUploadSummary, hasLocalSourceChanges, rebaseSourceFiles, readSyncManifest, replaceSourceFiles, runSyncDownLocalLifecycle, runSourceCandidateSync, writeLocalEnvFile, writeSourceFiles, writeSourceRebaseBackup, writeSyncManifest, } from './localSync.js';
 import { mergeTextSourceWithGit } from './sourceRebase.js';
 import { executeExperimentCreate, formatExperimentCreateSuccess, recoverExperimentCreateTransaction, } from './experimentCreate.js';
 import { pullEnvFile } from './envSync.js';
@@ -1069,16 +1069,13 @@ export async function executeCreateFunnel(input) {
     }
 }
 const GENERATED_CONFIG_PATH_BY_KIND = {
-    offerSets: 'src/config/offer-sets.generated.ts',
     experiments: 'src/config/experiments.generated.ts',
 };
-export const SYNC_DOWN_GENERATED_CONFIG_KINDS = ['offerSets'];
 export const EXPERIMENT_TRANSACTION_RECOVERY_COMMANDS = [
     'sync down',
     'sync rebase',
     'sync up',
     'experiments sync',
-    'offer-sets sync',
 ];
 const experimentTransactionRecoveryCommands = new Set(EXPERIMENT_TRANSACTION_RECOVERY_COMMANDS);
 export function resolveSyncTargetIds(input) {
@@ -1133,17 +1130,6 @@ export function formatSourceCandidateSyncSuccess(input) {
         : '';
     return `Synced ${synced}${deleted} to draft version ${input.versionId}`;
 }
-export function buildSyncOfferSetPlansInput(input) {
-    const offerSet = input.offerSet.trim();
-    if (!offerSet) {
-        throw new Error('--offer-set is required');
-    }
-    return {
-        workspaceId: input.workspaceId,
-        funnelId: input.funnelId,
-        ...(UUID_PATTERN.test(offerSet) ? { offerSetId: offerSet } : { offerSetKey: offerSet }),
-    };
-}
 export function buildGeneratedConfigSyncInput(input) {
     return {
         workspaceId: input.workspaceId,
@@ -1573,12 +1559,10 @@ const summarizeGitHubSyncResult = (result) => {
         : `GitHub already synced${remoteSha}`;
 };
 export const PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY = 'continue';
-export const OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY = 'continue';
 export const SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY = 'strict';
 export const SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY = 'strict';
 export const GITHUB_SYNC_TIMEOUT_POLICIES = {
     publish: PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY,
-    offerSetsSync: OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY,
     syncUpNoLocalChanges: SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
     syncUpCommittedChanges: SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
 };
@@ -1606,10 +1590,6 @@ export const syncGitHubDraftForCli = async (input) => {
 };
 const formatGeneratedFileCount = (count) => `${count} generated config ${count === 1 ? 'file' : 'files'}`;
 export const shouldSyncGitHubDraft = (options) => options.githubSync !== false;
-export const formatOfferSetSyncSuccess = (input) => [
-    `Synced offer set ${input.offerSetLabel} to funnel draft`,
-    `Wrote ${formatGeneratedFileCount(input.generatedFileCount)}`,
-];
 export const formatExperimentLifecycleSuccess = (action, result, json) => {
     const payload = {
         experimentId: result.id,
@@ -2100,58 +2080,6 @@ addExamples(funnelsCommand
     });
     console.log(`${result.funnel.id}\t${result.funnel.name}\t${result.funnel.slug}`);
 });
-const offerSetsCommand = addExamples(program.command('offer-sets').alias('offers').description('Manage project offer sets'), [
-    'fgrove offer-sets sync --offer-set default-paywall',
-    'fgrove offers sync --funnel claimbee-ios --offer-set three-month-test',
-]);
-addExamples(offerSetsCommand
-    .command('sync')
-    .description('Apply an offer set to a funnel draft billing snapshot')
-    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
-    .option('--funnel <id-or-slug>', 'Funnel id or slug')
-    .option('--dir <path>', 'Local source directory for reading sync manifest', '.')
-    .option('--no-github-sync', 'Skip waiting for an additional GitHub draft push')
-    .requiredOption('--offer-set <key-or-id>', 'Offer set key or id'), [
-    'fgrove offer-sets sync --offer-set default-paywall',
-    'fgrove offers sync --funnel claimbee-ios --offer-set quarterly-test',
-])
-    .action(async (options) => {
-    const token = await readAuthToken();
-    const target = await resolveSyncTarget({
-        token,
-        workspace: options.workspace,
-        funnel: options.funnel,
-        dir: options.dir,
-    });
-    const result = await callApi({
-        path: 'funnels.syncOfferSetPlans',
-        type: 'mutation',
-        token,
-        data: buildSyncOfferSetPlansInput({
-            workspaceId: target.workspaceId,
-            funnelId: target.funnelId,
-            offerSet: options.offerSet,
-        }),
-    });
-    const generatedFiles = await syncGeneratedConfigFilesForCli({
-        token,
-        target,
-        kinds: ['offerSets'],
-    });
-    const offerSetLabel = result.offerSet?.key || result.offerSet?.display_name || options.offerSet.trim();
-    console.log(formatOfferSetSyncSuccess({
-        offerSetLabel,
-        generatedFileCount: generatedFiles.length,
-    }).join('\n'));
-    if (shouldSyncGitHubDraft(options)) {
-        await syncGitHubDraftForCli({
-            token,
-            workspaceId: target.workspaceId,
-            funnelId: target.funnelId,
-            timeoutPolicy: OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY,
-        });
-    }
-});
 const experimentsCommand = addExamples(program.command('experiments').description('Manage funnel experiments'), [
     'fgrove experiments create --spec experiment.json --dir .',
     'fgrove experiments sync',
@@ -2541,11 +2469,12 @@ addExamples(syncCommand
             funnelId: target.funnelId,
         },
     });
+    const sourceFiles = filterSyncableSourceFiles(result.files);
     const downloadedSyncManifest = buildDownloadedSyncManifest({
         workspaceId: target.workspaceId,
         funnelId: target.funnelId,
         draftVersionId: result.draftVersionId,
-        files: result.files,
+        files: sourceFiles,
     });
     if (options.force && target.manifest && hasLocalChanges) {
         const localFiles = await collectSourceFiles(target.sourceDir);
@@ -2558,12 +2487,7 @@ addExamples(syncCommand
         console.log(`Saved the pre-force source backup to ${path.join(target.sourceDir, backupPath)}`);
     }
     await mkdir(target.sourceDir, { recursive: true });
-    await writeSourceFiles(target.sourceDir, result.files);
-    const generatedFiles = await syncGeneratedConfigFilesForCli({
-        token,
-        target,
-        kinds: SYNC_DOWN_GENERATED_CONFIG_KINDS,
-    });
+    await writeSourceFiles(target.sourceDir, sourceFiles);
     await writeLocalEnvFile(target.sourceDir, result.envFile);
     await ensureGitignore(target.sourceDir);
     await runSyncDownLocalLifecycle({
@@ -2582,8 +2506,7 @@ addExamples(syncCommand
         },
         writeSyncState: async () => writeSyncManifest(target.sourceDir, downloadedSyncManifest),
     });
-    console.log(`Synced ${result.files.length} files to ${target.sourceDir}`);
-    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
+    console.log(`Synced ${sourceFiles.length} files to ${target.sourceDir}`);
 });
 addExamples(syncCommand
     .command('rebase')
@@ -2631,12 +2554,14 @@ addExamples(syncCommand
     if (base.draftVersionId !== target.manifest.draftVersionId) {
         throw Object.assign(new Error('The hosted historical export returned the wrong sync baseline. The rebase was not applied.'), { code: 'FG-SYNC-REBASE-BASE' });
     }
-    assertHistoricalSyncBaseline({ manifest: target.manifest, files: base.files });
+    const remoteFiles = filterSyncableSourceFiles(remote.files);
+    const baseFiles = filterSyncableSourceFiles(base.files);
+    assertHistoricalSyncBaseline({ manifest: target.manifest, files: baseFiles });
     const localFiles = await collectSourceFiles(target.sourceDir);
     const merged = await rebaseSourceFiles({
-        baseFiles: base.files,
+        baseFiles,
         localFiles,
-        remoteFiles: remote.files,
+        remoteFiles,
         remoteOwnedPaths: await loadManagedSyncPaths(),
         mergeText: mergeTextSourceWithGit,
     });
@@ -2659,18 +2584,13 @@ addExamples(syncCommand
         workspaceId: target.workspaceId,
         funnelId: target.funnelId,
         draftVersionId: remote.draftVersionId,
-        files: remote.files,
+        files: remoteFiles,
     });
     await replaceSourceFiles({
         rootDir: target.sourceDir,
         currentFiles: localFiles,
         nextFiles: merged.files,
     });
-    const generatedFiles = await syncGeneratedConfigFilesForCli({
-        token,
-        target,
-        kinds: SYNC_DOWN_GENERATED_CONFIG_KINDS,
-    });
     await writeLocalEnvFile(target.sourceDir, remote.envFile);
     await ensureGitignore(target.sourceDir);
     await runSyncDownLocalLifecycle({
@@ -2691,7 +2611,6 @@ addExamples(syncCommand
     });
     const localChanges = await collectChangedSourceFiles(target.sourceDir, downloadedSyncManifest);
     console.log(`Rebased ${localChanges.files.length + localChanges.deletedPaths.length} local changes onto hosted draft ${remote.draftVersionId}.`);
-    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
     console.log('Run `fgrove validate`, review the diff, then run `fgrove sync up`.');
 });
 const envCommand = addExamples(program.command('env').description('Manage local funnel environment files'), [

package/dist/localSync.d.ts

@@ -1,4 +1,5 @@
 export declare const SYNC_MANIFEST_FILE = ".funnelsgrove-sync.json";
+export declare const LEGACY_OFFER_SETS_GENERATED_PATH = "src/config/offer-sets.generated.ts";
 export type SyncManifestFile = {
     path: string;
     hash: string;
@@ -109,6 +110,7 @@ export declare const writeSafeRootFile: (rootDir: string, relativePath: string,
 export declare function normalizeSyncPath(filePath: string): string;
 export declare function assertSafeSyncPath(filePath: string): string;
 export declare function shouldSyncFile(filePath: string): boolean;
+export declare function filterSyncableSourceFiles(files: readonly SourceFile[]): SourceFile[];
 export declare function buildSyncManifest(rootDir: string, input: SyncManifestInput): Promise<SyncManifest>;
 export declare function buildCommittedSyncManifest(input: {
     workspaceId: string;

package/dist/localSync.js

@@ -3,6 +3,7 @@ import { constants } from 'node:fs';
 import { lstat, mkdir, open, readdir, realpath, rename, rm, stat } from 'node:fs/promises';
 import path from 'node:path';
 export const SYNC_MANIFEST_FILE = '.funnelsgrove-sync.json';
+export const LEGACY_OFFER_SETS_GENERATED_PATH = 'src/config/offer-sets.generated.ts';
 export const DEFAULT_PATCH_BATCH_CONTENT_CHARS = 12_000_000;
 export const DEFAULT_SOURCE_CANDIDATE_BATCH_CONTENT_BYTES = 12_000_000;
 export const MAX_SOURCE_CANDIDATE_OPERATIONS = 200 * 500;
@@ -264,11 +265,17 @@ export function shouldSyncFile(filePath) {
     if (fileName === SYNC_MANIFEST_FILE) {
         return false;
     }
+    if (normalized === LEGACY_OFFER_SETS_GENERATED_PATH) {
+        return false;
+    }
     if (fileName === '.env' || (fileName.startsWith('.env.') && fileName !== '.env.example')) {
         return false;
     }
     return true;
 }
+export function filterSyncableSourceFiles(files) {
+    return files.filter((file) => shouldSyncFile(file.path));
+}
 export async function buildSyncManifest(rootDir, input) {
     const resolvedRoot = await resolveSafeRoot(rootDir, false);
     const files = await collectSyncFiles(resolvedRoot, resolvedRoot);

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.147",
+      "repositoryCliVersion": "0.1.150",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.137",
+        "bundleVersion": "2.0.140",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "d540fec73ced6fdcc2d118aac9a2f1f1131dfbd7d4fa6df80d988733725ffcbb"
+            "sha256": "5d96c365d4f41305b091305f76052aaf612d11cad2b37559506b76bcaaee4d8d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "66145b48217b80e9e5eb0b21d2d4d8de7186ed980a54b01b56b2a23202822503"
+            "sha256": "1692333f3ae1e1c15b1034581e2c0f4c6bcc6c1e0912ec40c4caf7020e7663d4"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.146",
+      "repositoryCliVersion": "0.1.149",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.136",
+        "bundleVersion": "2.0.139",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b"
+            "sha256": "ed37af8588ac8dd5ee2a501db570b95a5aeedb69b2f1f8eaad88d3645dba6fee"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942"
+            "sha256": "ee72e689f98df87616b6c4a8ac3ac43ec223a3786b3605b343c5289e9391848e"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.145",
+      "repositoryCliVersion": "0.1.148",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.135",
+        "bundleVersion": "2.0.138",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "0b3708beaa8d63e1c1fe5ab38e39fdf7a3e12fec39166261a1bad7619d872179"
+            "sha256": "ccbc9d8fdcd40ff40b3aed6171f0496d856f8dfc6bd9c6cb96ee5bfeddaaaa01"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "7fa793bde89dc1106b24eb408f225d156865bffe37f4feb7aeadb553844643c8"
+            "sha256": "09e75871d05290fe9e44817ab35504638d180217242522893ad68cd516deae0f"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.144",
+      "repositoryCliVersion": "0.1.147",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.134",
+        "bundleVersion": "2.0.137",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "fec5ced4b8e8e6c8081f5446b3b4174caefa89ac6d441f03e576fb10e961bc98"
+            "sha256": "d540fec73ced6fdcc2d118aac9a2f1f1131dfbd7d4fa6df80d988733725ffcbb"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -502,7 +502,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
-            "sha256": "82b05b8c6eebf25d32d2cff6f05b08bc39661dcbb46caa6b912de6b803aed39c"
+            "sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "efdede3e20f75d3b6f5dc00daa3e8ee1c3c03d56978fa087161b643424add0cc"
+            "sha256": "66145b48217b80e9e5eb0b21d2d4d8de7186ed980a54b01b56b2a23202822503"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.143",
+      "repositoryCliVersion": "0.1.146",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.133",
+        "bundleVersion": "2.0.136",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bb6f567146d9c70b209eff612ffcfb5e7c20b7ccb357beec47a187ead887a829"
+            "sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -649,7 +649,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
-            "sha256": "82b05b8c6eebf25d32d2cff6f05b08bc39661dcbb46caa6b912de6b803aed39c"
+            "sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
@@ -733,22 +733,22 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "7a7f556fc144e82469dbc56da7d4ce588c3bcc627ebf4b9aec9961f93d672f1f"
+            "sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.142",
+      "repositoryCliVersion": "0.1.145",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.132",
+        "bundleVersion": "2.0.135",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
           {
             "path": "AGENTS.md",
-            "sha256": "952fbafb5841b8f2e6fadab5032374c98390ef90c1ca0ed27747a38d0cc009d7"
+            "sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
           },
           {
             "path": "CLAUDE.md",
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74"
+            "sha256": "0b3708beaa8d63e1c1fe5ab38e39fdf7a3e12fec39166261a1bad7619d872179"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -796,7 +796,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
-            "sha256": "82b05b8c6eebf25d32d2cff6f05b08bc39661dcbb46caa6b912de6b803aed39c"
+            "sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
@@ -880,22 +880,22 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e"
+            "sha256": "7fa793bde89dc1106b24eb408f225d156865bffe37f4feb7aeadb553844643c8"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.141",
+      "repositoryCliVersion": "0.1.144",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.131",
+        "bundleVersion": "2.0.134",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
           {
             "path": "AGENTS.md",
-            "sha256": "952fbafb5841b8f2e6fadab5032374c98390ef90c1ca0ed27747a38d0cc009d7"
+            "sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
           },
           {
             "path": "CLAUDE.md",
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "015d013594cabb94c288bb39d7c717f531b68a1fe4754e6baefc0e08bbc5b872"
+            "sha256": "fec5ced4b8e8e6c8081f5446b3b4174caefa89ac6d441f03e576fb10e961bc98"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "7af952690a2b3c592ce6688b8524aa4c5fe111a0c798dc25106eb0d594c2452b"
+            "sha256": "efdede3e20f75d3b6f5dc00daa3e8ee1c3c03d56978fa087161b643424add0cc"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.147",
+  "version": "0.1.150",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,13 +34,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.7.28",
+    "@funnelsgrove/runtime": "0.7.29",
     "commander": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.1.77",
-    "@funnelsgrove/payments": "0.7.19",
+    "@funnelsgrove/analytics": "0.1.78",
+    "@funnelsgrove/payments": "0.7.20",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.137",
+  "bundleVersion": "2.0.140",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d540fec73ced6fdcc2d118aac9a2f1f1131dfbd7d4fa6df80d988733725ffcbb"
+      "sha256": "5d96c365d4f41305b091305f76052aaf612d11cad2b37559506b76bcaaee4d8d"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "66145b48217b80e9e5eb0b21d2d4d8de7186ed980a54b01b56b2a23202822503"
+      "sha256": "1692333f3ae1e1c15b1034581e2c0f4c6bcc6c1e0912ec40c4caf7020e7663d4"
     }
   ]
 }

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/runtime` `0.7.28` first, then `@funnelsgrove/analytics` `0.1.77`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.147`, 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/runtime` `0.7.29` first, then `@funnelsgrove/analytics` `0.1.78`, then `@funnelsgrove/payments` `0.7.20`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.150`, 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.137",
+  "bundleVersion": "2.0.140",
   "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.137",
+  "bundleVersion": "2.0.140",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d540fec73ced6fdcc2d118aac9a2f1f1131dfbd7d4fa6df80d988733725ffcbb"
+      "sha256": "5d96c365d4f41305b091305f76052aaf612d11cad2b37559506b76bcaaee4d8d"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "66145b48217b80e9e5eb0b21d2d4d8de7186ed980a54b01b56b2a23202822503"
+      "sha256": "1692333f3ae1e1c15b1034581e2c0f4c6bcc6c1e0912ec40c4caf7020e7663d4"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "8da6658b5eeea395b12f5c678e5a2da0b8b091bc15e1697f5d3e15fa5d9bc8a2",
+  "sourceTreeHash": "84596fa7dd6822f2f4a330134d245c0b9cde8c0102409865badd6539c42ecbfb",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.137",
+  "docsBundleVersion": "2.0.140",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "82a866e08ec6245d26cc6f754960f78e39f8c9086c44eb3eea141c09add16090",
+      "sha256": "e08dfdb7fe5e880c1a135abba5d6a35ece9eb06989d89222dad908044b715936",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "d540fec73ced6fdcc2d118aac9a2f1f1131dfbd7d4fa6df80d988733725ffcbb",
+      "sha256": "5d96c365d4f41305b091305f76052aaf612d11cad2b37559506b76bcaaee4d8d",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "66145b48217b80e9e5eb0b21d2d4d8de7186ed980a54b01b56b2a23202822503",
+      "sha256": "1692333f3ae1e1c15b1034581e2c0f4c6bcc6c1e0912ec40c4caf7020e7663d4",
       "mode": "100644"
     },
     {
@@ -261,12 +261,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "868bf077f8518811654f8121fb1490a4c8d5817d572bc6d37f672e1a2e68f076",
+      "sha256": "0dbafb677a43549036fd901c44aa1e397ce6852b764d32d7d1e08d52c1d342cf",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "64fd73809a410d0310f6763b4c2d3a9b688c5cd8fd3423686cf23197a04eaadc",
+      "sha256": "f3708e132a46d583c38b678171858876a3c02842dfe5f81a969dfa0458fdf609",
       "mode": "100644"
     },
     {
@@ -551,7 +551,7 @@
     },
     {
       "path": "src/steps/step-32-paywall.tsx",
-      "sha256": "0d1439a122117ad07b460be3d17490bcd3323d88ea3513b1c182846e4d468ce2",
+      "sha256": "69ff9519cbc5123e97f417dd8d0c3a368d59cb8293709bc6a51c012e1e0d4c75",
       "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/runtime` `0.7.28` first, then `@funnelsgrove/analytics` `0.1.77`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.147`, 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/runtime` `0.7.29` first, then `@funnelsgrove/analytics` `0.1.78`, then `@funnelsgrove/payments` `0.7.20`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.150`, 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.137",
+  "bundleVersion": "2.0.140",
   "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.1.77",
-        "@funnelsgrove/payments": "^0.7.19",
-        "@funnelsgrove/runtime": "^0.7.28",
+        "@funnelsgrove/analytics": "^0.1.78",
+        "@funnelsgrove/payments": "^0.7.20",
+        "@funnelsgrove/runtime": "^0.7.29",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -938,20 +938,20 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.1.77",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.77.tgz",
-      "integrity": "sha512-vzE3DSBWplM0SS0xx2sDIdsBFNF+Rz8JWsDVFrztqPpN0llRzx4BpEXoA8zvo/x0hERQ5XXPHmT0AYVTG3FDsw==",
+      "version": "0.1.78",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.78.tgz",
+      "integrity": "sha512-5H6iv2o7FfBNxpYJbXJtk9jh/vj+xsutkJ0/xNxLiVhH9GPvEI/Kt9KO44AvYEd1NBPVsXbc7dBIVQEN4Pz19Q==",
       "dependencies": {
-        "@funnelsgrove/runtime": "0.7.28"
+        "@funnelsgrove/runtime": "0.7.29"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.7.19",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.7.19.tgz",
-      "integrity": "sha512-7nyQ1KW1ul4vsnkeroGrDCW4UQBT3YhDhdCjx1TI9rLQ54Ho9oGasB8MOOxzl8WAOCBKcys2rLF2GoO568E+cQ==",
+      "version": "0.7.20",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.7.20.tgz",
+      "integrity": "sha512-cX+hVT1vNvYt94Xoe1OKsbJZ4DZqkectqnyQpkyIA088GGm2APxAanuoZSqFbo9TieOfE9Wi5FcyWugzjR+ytw==",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.67",
-        "@funnelsgrove/runtime": "^0.7.19",
+        "@funnelsgrove/analytics": "^0.1.78",
+        "@funnelsgrove/runtime": "^0.7.29",
         "@solidgate/react-sdk": "1.34.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
@@ -961,9 +961,9 @@
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.7.28",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.28.tgz",
-      "integrity": "sha512-pHN8nCWDMj7WSwKiTsLwyhEm0uEo/Q1w05ODz6R4qW8E8BzidRDtR2hPDJKy90PQEuMVqViNMuOVAOh85PsDsw==",
+      "version": "0.7.29",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.29.tgz",
+      "integrity": "sha512-zy42uD/x5E0ozS40GaGnzBGDGKau2MkA5p8tZuRQkzM8jERjQPpdEIuoyv58cuF3H+ltJZuEyqSd8kF6lUqYvw==",
       "dependencies": {
         "posthog-js": "^1.369.2",
         "react": "19.2.3",

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.1.77",
-    "@funnelsgrove/payments": "^0.7.19",
-    "@funnelsgrove/runtime": "^0.7.28",
+    "@funnelsgrove/analytics": "^0.1.78",
+    "@funnelsgrove/payments": "^0.7.20",
+    "@funnelsgrove/runtime": "^0.7.29",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",

package/template_scaffold/src/steps/step-32-paywall.tsx

@@ -137,7 +137,7 @@ function StepPaywallRuntime({
 }: StepPaywallProps = {}) {
   const [runtimeMode] = useRuntimeMode();
   const checkoutMode = runtimeMode;
-  const { user, setUser, attributes, featureFlags, completeStep } = useFunnel();
+  const { user, setUser, attributes, featureFlags, completeStep, userBootstrapped } = useFunnel();
   const publishedRuntime = useFunnelRuntimeConfig();
   const content = usePreviewStepLocalizedContent(
     stepPaywallId,
@@ -396,7 +396,7 @@ function StepPaywallRuntime({
     && activeBillingRuntime.offerSetId.trim()
     && selectedPlan?.funnelPlanKey?.trim(),
   );
-  const checkoutDisabled = !selectedPlan || !selectedDisplayPlan || (
+  const checkoutDisabled = !userBootstrapped || !selectedPlan || !selectedDisplayPlan || (
     checkoutProvider === 'solidgate'
       ? !solidgateCheckoutConfigured
       : !checkoutSession.configured
@@ -559,7 +559,7 @@ function StepPaywallRuntime({
       return;
     }
 
-    const readyClientSecret = await checkoutSession.prepareCardCheckout({ checkoutStartSource: 'checkout_render' });
+    const readyClientSecret = await checkoutSession.prepareCardCheckout({ checkoutStartSource: 'card_click' });
     if (readyClientSecret) {
       setCheckoutDialogOpen(true);
     }
@@ -590,7 +590,7 @@ function StepPaywallRuntime({
     }
 
     const readyClientSecret =
-      checkoutSession.activeClientSecret ?? await checkoutSession.prepareCardCheckout({ checkoutStartSource: 'checkout_render' });
+      checkoutSession.activeClientSecret ?? await checkoutSession.prepareCardCheckout({ checkoutStartSource: 'card_click' });
     if (readyClientSecret) {
       setCheckoutDialogOpen(true);
     }