npm - @funnelsgrove/cli - Versions diffs - 0.1.35 → 0.1.43 - Mend

@funnelsgrove/cli 0.1.35 → 0.1.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/dist/cli.d.ts CHANGED Viewed

@@ -197,6 +197,50 @@ export declare function buildGeneratedConfigSyncInput(input: {
 };
 export declare function selectGeneratedConfigFiles(files: SourceFile[], kinds: GeneratedConfigKind[]): SourceFile[];
 export declare function assertCanDraftSyncSource(status: GitHubStatusResponse): void;
+type PublishDeploymentStatus = {
+    id: string;
+    state: string;
+    qa_summary?: string | null;
+    deployment_url?: string | null;
+    version_id?: string | null;
+    metadata?: unknown;
+};
+type PublishAcknowledgement = {
+    deploymentUrl: string;
+    publishedVersionId: string | null;
+    publishedVersionSeq: number | null;
+};
+export declare const formatPublishTerminalSuccess: (input: {
+    acknowledgement: PublishAcknowledgement;
+    deployment: PublishDeploymentStatus;
+}) => string;
+type FunnelDetailResponse = {
+    deployments: PublishDeploymentStatus[];
+};
+type PublishCommandBackend = {
+    publish: (input: {
+        token: string;
+        workspaceId: string;
+        funnelId: string;
+        message?: string;
+        domains?: string[];
+    }) => Promise<PublishAcknowledgement & {
+        deploymentId: string;
+    }>;
+    detail: (input: {
+        token: string;
+        workspaceId: string;
+        funnelId: string;
+    }) => Promise<FunnelDetailResponse>;
+};
+export declare const executePublishAndWait: (input: {
+    token: string;
+    workspaceId: string;
+    funnelId: string;
+    message?: string;
+    domains?: string[];
+    backend?: PublishCommandBackend;
+}) => Promise<string>;
 export type GitHubSyncTimeoutPolicy = 'strict' | 'continue';
 export declare const PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
 export declare const OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;

package/dist/cli.js CHANGED Viewed

@@ -1135,6 +1135,26 @@ export function assertCanDraftSyncSource(status) {
         throw new Error('This funnel is connected to GitHub. Commit and push changes with git, then run `fgrove github pull` to sync the hosted draft. Do not use `fgrove sync up` for the same change.');
     }
 }
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+export const formatPublishTerminalSuccess = (input) => {
+    const versionId = input.deployment.version_id?.trim();
+    if (!versionId) {
+        throw new Error(`Ready publish deployment ${input.deployment.id} is missing a bound version_id.`);
+    }
+    const metadata = input.deployment.metadata;
+    const publishPreparation = isRecord(metadata) ? metadata.publishPreparation : undefined;
+    const publishedVersionSeq = isRecord(publishPreparation)
+        ? publishPreparation.publishedVersionSeq
+        : undefined;
+    if (typeof publishedVersionSeq !== 'number'
+        || !Number.isInteger(publishedVersionSeq)
+        || publishedVersionSeq <= 0) {
+        throw new Error(`Ready publish deployment ${input.deployment.id} has invalid metadata.publishPreparation.publishedVersionSeq.`);
+    }
+    const deploymentUrl = input.deployment.deployment_url?.trim()
+        || input.acknowledgement.deploymentUrl;
+    return `${deploymentUrl}\tv${publishedVersionSeq}\t${versionId}`;
+};
 const getApiUrl = () => {
     const options = program.opts();
     return options.apiUrl || process.env.FUNNELSGROVE_API_URL || DEFAULT_API_URL;
@@ -1170,15 +1190,17 @@ const isTerminalDeploymentState = (state) => {
 const waitForPublishDeployment = async (input) => {
     const deadline = Date.now() + PUBLISH_WAIT_TIMEOUT_MS;
     while (Date.now() <= deadline) {
-        const detail = await callApi({
-            path: 'funnels.detail',
-            type: 'query',
-            token: input.token,
-            data: {
-                workspaceId: input.workspaceId,
-                funnelId: input.funnelId,
-            },
-        });
+        const detail = input.detail
+            ? await input.detail(input)
+            : await callApi({
+                path: 'funnels.detail',
+                type: 'query',
+                token: input.token,
+                data: {
+                    workspaceId: input.workspaceId,
+                    funnelId: input.funnelId,
+                },
+            });
         const deployment = detail.deployments.find((item) => item.id === input.deploymentId);
         if (deployment && isTerminalDeploymentState(deployment.state)) {
             if (deployment.state === 'failed') {
@@ -1193,6 +1215,45 @@ const waitForPublishDeployment = async (input) => {
     }
     throw new Error(`Timed out waiting for publish deployment ${input.deploymentId}.`);
 };
+export const executePublishAndWait = async (input) => {
+    const backend = input.backend ?? {
+        publish: async (request) => callApi({
+            path: 'funnels.publish',
+            type: 'mutation',
+            token: request.token,
+            data: {
+                workspaceId: request.workspaceId,
+                funnelId: request.funnelId,
+                message: request.message,
+                domains: request.domains,
+            },
+        }),
+        detail: async (request) => callApi({
+            path: 'funnels.detail',
+            type: 'query',
+            token: request.token,
+            data: {
+                workspaceId: request.workspaceId,
+                funnelId: request.funnelId,
+            },
+        }),
+    };
+    const acknowledgement = await backend.publish({
+        token: input.token,
+        workspaceId: input.workspaceId,
+        funnelId: input.funnelId,
+        message: input.message,
+        domains: input.domains,
+    });
+    const deployment = await waitForPublishDeployment({
+        token: input.token,
+        workspaceId: input.workspaceId,
+        funnelId: input.funnelId,
+        deploymentId: acknowledgement.deploymentId,
+        detail: backend.detail,
+    });
+    return formatPublishTerminalSuccess({ acknowledgement, deployment });
+};
 const readCodeFromStdin = async () => {
     const rl = createInterface({
         input: process.stdin,
@@ -2273,24 +2334,13 @@ addExamples(program
             timeoutPolicy: PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY,
         });
     }
-    const result = await callApi({
-        path: 'funnels.publish',
-        type: 'mutation',
-        token,
-        data: {
-            workspaceId: target.workspaceId,
-            funnelId: target.funnelId,
-            message: options.message,
-            domains: publishEnv === 'production' && options.domain ? [options.domain] : undefined,
-        },
-    });
-    const readyDeployment = await waitForPublishDeployment({
+    console.log(await executePublishAndWait({
         token,
         workspaceId: target.workspaceId,
         funnelId: target.funnelId,
-        deploymentId: result.deploymentId,
-    });
-    console.log(`${readyDeployment.deployment_url || result.deploymentUrl}\tv${result.publishedVersionSeq}\t${result.publishedVersionId}`);
+        message: options.message,
+        domains: publishEnv === 'production' && options.domain ? [options.domain] : undefined,
+    }));
 });
 const githubCommand = addExamples(program.command('github').description('Manage GitHub funnel sync'), [
     'fgrove github status --funnel claimbee-general',

package/funnel-contract-compatibility.json CHANGED Viewed

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.35",
+      "repositoryCliVersion": "0.1.43",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.23",
+        "bundleVersion": "2.0.31",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -21,11 +21,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -37,7 +37,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -45,11 +45,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bd7ae81ac8617e8d297268a1091e1bea5fb6b412346f6e891a0f08ab49520686"
+            "sha256": "ba0ca2563f34ffb8ab23da1600ffbbaa225e9aa1fb2e87b5404a356edd2ae0fc"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "5c2a6798dd3e13269526d43af4a3db1e4c85c748f49f768417f8dcb827803603"
+            "sha256": "b5ff393f6429e787a599fe1b3a1a9e3e06346de5654acb9094741ee0089206f8"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.34",
+      "repositoryCliVersion": "0.1.42",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.22",
+        "bundleVersion": "2.0.30",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -168,11 +168,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -184,7 +184,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -192,11 +192,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "849a3a60cbe89e30e667ab77dcd6459fa2374ec73223182cbf837d5ae0cf3c78"
+            "sha256": "1f2981c692dd0454fa69aa5381478adfbfe7951e032309344e0e1edb99cb60ea"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "f5399c6e73f637684b8ce470aca7449b5f90c43efbe2fc88d444759cf1647de1"
+            "sha256": "85762fb469f1bcd929536f2c5fbe2418a489bae327f100ac9fba49d95eda58fa"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.33",
+      "repositoryCliVersion": "0.1.41",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.21",
+        "bundleVersion": "2.0.29",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -315,11 +315,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -331,7 +331,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -339,11 +339,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "28443021c76a8744a7a1bbd07ecdc8f3ee72053e3c40fceb7a359cedf786d943"
+            "sha256": "4ba56674e8297aec8977e6fe0e3bb472513603accfe7b6361f78a2d6ac96c8ee"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "1d3c3cd2fd3aef9faf5f0d1b3a11b6d019f02d7056a20408083361da8e1db0d3"
+            "sha256": "38801a3066a005dd3151e4c77fbb1dabc0cff901a6db02ae98dd3f890adb1e66"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.32",
+      "repositoryCliVersion": "0.1.40",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.20",
+        "bundleVersion": "2.0.28",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -462,11 +462,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -478,7 +478,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -486,11 +486,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "1254e4fb9cdf2e470c5997d9df92dffb9fd4276abab955de247b297eaac0a585"
+            "sha256": "3c7f166a28b5b66498630c41e2930f4592a836d0d2c90847fedf0ee5656cc612"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "4f59ba03061e03db39b8b13f044be7a9012ebde01a825e0385fddfe3130ce4e1"
+            "sha256": "a7d4ddf4971f4d7e9ae4f0751c0e208cc41d5bdb6ebee292f42727482fcb9a6b"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.31",
+      "repositoryCliVersion": "0.1.39",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.19",
+        "bundleVersion": "2.0.27",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -609,11 +609,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -625,7 +625,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -633,11 +633,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "4c8843a38778d6a445195e7c46fc71aafd60056ac225c061892fb66003862636"
+            "sha256": "ff280739dacf549dca60ca7ca6ce6188081dada4ad8f3ae6dd80865e574d6863"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "3367ba96679da38fbdbeace2952fa6a5df6e16c9e7014f7231156e851f135614"
+            "sha256": "205aa6a5afbf15e411e8d9916f44ed0792957f916640afa9e9a1a92c55b89971"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.30",
+      "repositoryCliVersion": "0.1.38",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.18",
+        "bundleVersion": "2.0.26",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -756,11 +756,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -772,7 +772,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -780,11 +780,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "e39e33c49ad2669ccc88016df2ca803e0860ec58972956b1a72020fb3a83939c"
+            "sha256": "287760126630942ff35929b6ede25f5601a21f3cfce8a170de280934c51f5572"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "64d969e839025d3d6956c0cd0a7632c5a3e887d52425fddd0b1a54f1a5a48440"
+            "sha256": "45b8fc9ae7c6174dff17344a36fa11fa9496bb091249bd4ef4945ae96e203e87"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.29",
+      "repositoryCliVersion": "0.1.37",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.17",
+        "bundleVersion": "2.0.25",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -903,11 +903,11 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
-            "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+            "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -919,7 +919,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+            "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -927,11 +927,11 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bf7171b1101096ac3b205aa8f251379de1c66e16c20b5ca6054e84fd0ab17862"
+            "sha256": "b2e68b9471c2237037a166dfaaa81d5489a1ce7298f3c75205fa173c47d893aa"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
-            "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+            "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
           },
           {
             "path": "docs/funnelsgrove/qa/local.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "87d325180a8e9e501cf5c2a00174f99fae58a612b7a93cfe9753bf1f149e46a4"
+            "sha256": "c503890f0244c45a0b0a8799e5241dedd2d3180bcd0b939e6aeb1d6bba7017e9"
           }
         ]
       }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.35",
+  "version": "0.1.43",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,12 +34,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.1.62",
+    "@funnelsgrove/runtime": "0.1.63",
     "commander": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.1.39",
+    "@funnelsgrove/analytics": "0.1.41",
+    "@funnelsgrove/payments": "0.1.58",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.23",
+  "bundleVersion": "2.0.31",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -14,11 +14,11 @@
     },
     {
       "path": "docs/funnelsgrove/START-HERE.md",
-      "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+      "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
     },
     {
       "path": "docs/funnelsgrove/contracts/analytics-events.md",
-      "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+      "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
     },
     {
       "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -30,7 +30,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+      "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
     },
     {
       "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -38,11 +38,11 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bd7ae81ac8617e8d297268a1091e1bea5fb6b412346f6e891a0f08ab49520686"
+      "sha256": "ba0ca2563f34ffb8ab23da1600ffbbaa225e9aa1fb2e87b5404a356edd2ae0fc"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
-      "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+      "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
     },
     {
       "path": "docs/funnelsgrove/qa/local.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c2a6798dd3e13269526d43af4a3db1e4c85c748f49f768417f8dcb827803603"
+      "sha256": "b5ff393f6429e787a599fe1b3a1a9e3e06346de5654acb9094741ee0089206f8"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/START-HERE.md CHANGED Viewed

@@ -54,7 +54,10 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 - A paywall presents purchasable plans. A loading, reveal, or “ready” screen is an interstitial.
 - Every choice declares `choice.answerKey`, stores stable option IDs in the exact scalar/array shape, and uses `useStepChoices`.
 - Email capture uses `submitEmailCapture`; it never manually sends analytics or hard-codes paywall navigation.
-- `subscription-started` is the `purchase_completed` terminal. Browser terminal reach is not Quiz completed; only the trusted backend records `purchase_completed` after verifying an initial purchase.
+- Quiz completed counts each unique user who reaches a paywall step.
+- `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed.
+- Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+- `subscription-started` remains the contract-v3 `purchase_completed` terminal type, and only the trusted backend records the purchase event after verifying an initial purchase.
 - Let the controller distinguish completion from exit and suppress provider delivery in preview.
 ## Standard workflow

package/template_docs/docs/funnelsgrove/contracts/analytics-events.md CHANGED Viewed

@@ -24,7 +24,9 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 | `step_exited` | `step_exited` | `step_exit` | `any` | `any` | `controller` | `true` | `step-visit` | `funnelId`, `funnelVersionId`, `environment`, `stepContractVersion`, `stepId`, `stepName`, `stepType` |
 | `step_started` | `step_started` | `step_start` | `any` | `any` | `controller` | `true` | `step-visit` | `funnelId`, `funnelVersionId`, `environment`, `stepContractVersion`, `stepId`, `stepName`, `stepType` |
-The `purchase_completed` event is owned by `trusted-server` and is recorded only after the backend verifies a successful initial purchase. Entering the browser terminal or emitting `funnel_completed` does not create this business conversion. The separate `registration_completed` event remains owned by `trusted-server` for the later app-link claim. The `email_captured` event is owned by `transactional-server` and uses `logical-email-conversion` deduplication.
+Quiz completed counts each unique user who reaches a paywall step. `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed. Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+The `purchase_completed` event is owned by `trusted-server` and is recorded only after the backend verifies a successful initial purchase. The separate `registration_completed` event remains owned by `trusted-server` for the later app-link claim. The `email_captured` event is owned by `transactional-server` and uses `logical-email-conversion` deduplication.
 <!-- funnelsgrove:generated:end contract-v3/contract/analytics-events -->
 ## Ownership rules
@@ -34,7 +36,7 @@ The `purchase_completed` event is owned by `trusted-server` and is recorded only
 - `submitEmailCapture` creates `email_captured` transactionally, then routes only after success.
 - Named payment helpers emit checkout semantic events at real payment boundaries.
 - The terminal helper owns funnel completion.
-- A trusted backend owns `purchase_completed` after verifying an initial subscription or one-time payment; browser code never emits it, and terminal reach does not count as Quiz completed.
+- A trusted backend owns `purchase_completed` after verifying an initial subscription or one-time payment; browser code never emits it. This purchase event is independent from the paywall-reach definition of Quiz completed.
 - A separate trusted server claim owns `registration_completed` when the purchased subscription is later linked in the app.
 - Provider adapters and the durable outbox own PostHog and server Meta delivery.

package/template_docs/docs/funnelsgrove/contracts/payments.md CHANGED Viewed

@@ -37,6 +37,8 @@ A paywall presents purchasable plans. A reveal, loading state, calculation, or
 ## Purchase completion separation
-The canonical `subscription-started` route keeps its stable identity but uses the `purchase_completed` terminal type in contract v3. It may emit lifecycle-only `funnel_completed`, but entering it never counts as Quiz completed. Only the trusted backend emits `purchase_completed` after verifying an initial subscription or one-time payment; renewals, pending payments, and browser checkout returns do not qualify. `registration_completed` remains the later app-link conversion.
+Quiz completed counts each unique user who reaches a paywall step. `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed. Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+The canonical `subscription-started` route keeps its stable identity and remains the `purchase_completed` terminal type in contract v3. Only the trusted backend emits the purchase event after verifying an initial subscription or one-time payment; renewals, pending payments, and browser checkout returns do not qualify. `registration_completed` remains the later app-link conversion.
 Before publishing, complete [paywall/checkout QA](../qa/paywall-checkout.md) and [publish QA](../qa/publish.md).

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 ### Package release order
-Release `@funnelsgrove/runtime` `0.1.62` first, then `@funnelsgrove/analytics` `0.1.39`, then `@funnelsgrove/payments` `0.1.56`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.35`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.63` first, then `@funnelsgrove/analytics` `0.1.41`, then `@funnelsgrove/payments` `0.1.58`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.43`. 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/docs/funnelsgrove/qa/analytics.md CHANGED Viewed

@@ -32,7 +32,9 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 - Choice steps save the exact stable ID shape before completion.
 - Email success creates one server conversion; duplicate capture skips browser fanout; failure changes no state/lifecycle/route.
 - Checkout helpers fire only at real boundaries with complete metadata and stable event IDs.
-- Quiz completed requires trusted-server `purchase_completed`, deduplicated by `provider-payment`; browser `funnel_completed` is lifecycle-only and never satisfies it.
+- Quiz completed counts each unique user who reaches a paywall step.
+- `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed.
+- Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
 - `registration_completed` remains the separate later app-link claim.
 - Preview sends no API/provider analytics.
 - No component sends PostHog or server Meta directly.

package/template_docs/funnel-docs.config.json CHANGED Viewed

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

package/template_scaffold/.funnelsgrove-docs.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.23",
+  "bundleVersion": "2.0.31",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -14,11 +14,11 @@
     },
     {
       "path": "docs/funnelsgrove/START-HERE.md",
-      "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d"
+      "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
     },
     {
       "path": "docs/funnelsgrove/contracts/analytics-events.md",
-      "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6"
+      "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9"
     },
     {
       "path": "docs/funnelsgrove/contracts/content-answers.md",
@@ -30,7 +30,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60"
+      "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d"
     },
     {
       "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -38,11 +38,11 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bd7ae81ac8617e8d297268a1091e1bea5fb6b412346f6e891a0f08ab49520686"
+      "sha256": "ba0ca2563f34ffb8ab23da1600ffbbaa225e9aa1fb2e87b5404a356edd2ae0fc"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
-      "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d"
+      "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab"
     },
     {
       "path": "docs/funnelsgrove/qa/local.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c2a6798dd3e13269526d43af4a3db1e4c85c748f49f768417f8dcb827803603"
+      "sha256": "b5ff393f6429e787a599fe1b3a1a9e3e06346de5654acb9094741ee0089206f8"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "e00d4d9300d169131cf55df1d9ff45ddb43f369da52d96db47b2a8ee00c0705e",
+  "sourceTreeHash": "248b8b8dab9727597328fa39d488a5a015c985a6e8db0b1f8cf0da373fe325e5",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.23",
+  "docsBundleVersion": "2.0.31",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "777509183cdfb38967f70038bbf70737da8321fc52cc82ac60954374b10ea18d",
+      "sha256": "1ed236d8cef95a216c5def1abe7cdeee368c35363be3487ff0aaae0d61d98a81",
       "mode": "100644"
     },
     {
@@ -71,12 +71,12 @@
     },
     {
       "path": "docs/funnelsgrove/START-HERE.md",
-      "sha256": "638615b66f771a36015d747fd8e8a1bf0af311ed24631c3dd041388e8e73c09d",
+      "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5",
       "mode": "100644"
     },
     {
       "path": "docs/funnelsgrove/contracts/analytics-events.md",
-      "sha256": "743ca0d6b3a19b3b9e0bd489b228dab7be73d26073a86aab513a90477da481c6",
+      "sha256": "496ebab7c1fd00b40f9a5b29a5d3f8b6605549bf5927eb4280ccdc3023acd3c9",
       "mode": "100644"
     },
     {
@@ -91,7 +91,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "1a003f83fa01dba60bd4bb3365fd0a753dadd73d13fed84fd16b70d1df3d2b60",
+      "sha256": "3614a2c6e4d48411c9eba21400ce2699a49782d802aa08acc72335ed4ef2421d",
       "mode": "100644"
     },
     {
@@ -101,12 +101,12 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bd7ae81ac8617e8d297268a1091e1bea5fb6b412346f6e891a0f08ab49520686",
+      "sha256": "ba0ca2563f34ffb8ab23da1600ffbbaa225e9aa1fb2e87b5404a356edd2ae0fc",
       "mode": "100644"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
-      "sha256": "5ac36e547155546be230b9f1df144c7875824686627859c97b43e33d6e3e116d",
+      "sha256": "1a42fcb7fccfb35f41fe2df297aadd67d6ea86fa3a9de2960c861664f32cf9ab",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c2a6798dd3e13269526d43af4a3db1e4c85c748f49f768417f8dcb827803603",
+      "sha256": "b5ff393f6429e787a599fe1b3a1a9e3e06346de5654acb9094741ee0089206f8",
       "mode": "100644"
     },
     {
@@ -261,12 +261,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "4107cec6df7d25471893b22de2ed514e2e9c381a9f3faa861e6642cd7ed5ceed",
+      "sha256": "1753c85db32177e3eb0341a0ff5c4b2d658924a10c156a94f2fc69fc3e678578",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "2b9dc1e23e4cab876849b7f4c9abb5ae1cd2769129ccb970268cf8791e0886d9",
+      "sha256": "d116d70fb57dc62fff99e9aa673e423cc995e972c634453635fead6d19f02b77",
       "mode": "100644"
     },
     {
@@ -926,7 +926,7 @@
     },
     {
       "path": "tests/funnel-agent-docs.test.ts",
-      "sha256": "6005c77980962cdf41beff3ba7554e389684e19d218a4c88441d28769b75f60e",
+      "sha256": "050d253bcdd9de14d2310574faeaa58cfd06243ffc6f4246ad942b2063c9c4f5",
       "mode": "100644"
     },
     {
@@ -1069,6 +1069,11 @@
       "sha256": "d8886cd69d1895576e821ca1c1c8fc2d6e75b9741390b3a3a57b123f18695be3",
       "mode": "100644"
     },
+    {
+      "path": "vercel.json",
+      "sha256": "b2ca3677c797f6006864cf604eee0ad15713d2d2b5f8b8b8b6f74a683095f428",
+      "mode": "100644"
+    },
     {
       "path": "vitest.config.ts",
       "sha256": "60019594865106f483d16e204d47e894fdc0f12d6c759a0d40a2b24af480117d",

package/template_scaffold/docs/funnelsgrove/START-HERE.md CHANGED Viewed

@@ -54,7 +54,10 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 - A paywall presents purchasable plans. A loading, reveal, or “ready” screen is an interstitial.
 - Every choice declares `choice.answerKey`, stores stable option IDs in the exact scalar/array shape, and uses `useStepChoices`.
 - Email capture uses `submitEmailCapture`; it never manually sends analytics or hard-codes paywall navigation.
-- `subscription-started` is the `purchase_completed` terminal. Browser terminal reach is not Quiz completed; only the trusted backend records `purchase_completed` after verifying an initial purchase.
+- Quiz completed counts each unique user who reaches a paywall step.
+- `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed.
+- Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+- `subscription-started` remains the contract-v3 `purchase_completed` terminal type, and only the trusted backend records the purchase event after verifying an initial purchase.
 - Let the controller distinguish completion from exit and suppress provider delivery in preview.
 ## Standard workflow

package/template_scaffold/docs/funnelsgrove/contracts/analytics-events.md CHANGED Viewed

@@ -24,7 +24,9 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 | `step_exited` | `step_exited` | `step_exit` | `any` | `any` | `controller` | `true` | `step-visit` | `funnelId`, `funnelVersionId`, `environment`, `stepContractVersion`, `stepId`, `stepName`, `stepType` |
 | `step_started` | `step_started` | `step_start` | `any` | `any` | `controller` | `true` | `step-visit` | `funnelId`, `funnelVersionId`, `environment`, `stepContractVersion`, `stepId`, `stepName`, `stepType` |
-The `purchase_completed` event is owned by `trusted-server` and is recorded only after the backend verifies a successful initial purchase. Entering the browser terminal or emitting `funnel_completed` does not create this business conversion. The separate `registration_completed` event remains owned by `trusted-server` for the later app-link claim. The `email_captured` event is owned by `transactional-server` and uses `logical-email-conversion` deduplication.
+Quiz completed counts each unique user who reaches a paywall step. `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed. Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+The `purchase_completed` event is owned by `trusted-server` and is recorded only after the backend verifies a successful initial purchase. The separate `registration_completed` event remains owned by `trusted-server` for the later app-link claim. The `email_captured` event is owned by `transactional-server` and uses `logical-email-conversion` deduplication.
 <!-- funnelsgrove:generated:end contract-v3/contract/analytics-events -->
 ## Ownership rules
@@ -34,7 +36,7 @@ The `purchase_completed` event is owned by `trusted-server` and is recorded only
 - `submitEmailCapture` creates `email_captured` transactionally, then routes only after success.
 - Named payment helpers emit checkout semantic events at real payment boundaries.
 - The terminal helper owns funnel completion.
-- A trusted backend owns `purchase_completed` after verifying an initial subscription or one-time payment; browser code never emits it, and terminal reach does not count as Quiz completed.
+- A trusted backend owns `purchase_completed` after verifying an initial subscription or one-time payment; browser code never emits it. This purchase event is independent from the paywall-reach definition of Quiz completed.
 - A separate trusted server claim owns `registration_completed` when the purchased subscription is later linked in the app.
 - Provider adapters and the durable outbox own PostHog and server Meta delivery.

package/template_scaffold/docs/funnelsgrove/contracts/payments.md CHANGED Viewed

@@ -37,6 +37,8 @@ A paywall presents purchasable plans. A reveal, loading state, calculation, or
 ## Purchase completion separation
-The canonical `subscription-started` route keeps its stable identity but uses the `purchase_completed` terminal type in contract v3. It may emit lifecycle-only `funnel_completed`, but entering it never counts as Quiz completed. Only the trusted backend emits `purchase_completed` after verifying an initial subscription or one-time payment; renewals, pending payments, and browser checkout returns do not qualify. `registration_completed` remains the later app-link conversion.
+Quiz completed counts each unique user who reaches a paywall step. `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed. Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
+The canonical `subscription-started` route keeps its stable identity and remains the `purchase_completed` terminal type in contract v3. Only the trusted backend emits the purchase event after verifying an initial subscription or one-time payment; renewals, pending payments, and browser checkout returns do not qualify. `registration_completed` remains the later app-link conversion.
 Before publishing, complete [paywall/checkout QA](../qa/paywall-checkout.md) and [publish QA](../qa/publish.md).

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 ### Package release order
-Release `@funnelsgrove/runtime` `0.1.62` first, then `@funnelsgrove/analytics` `0.1.39`, then `@funnelsgrove/payments` `0.1.56`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.35`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.63` first, then `@funnelsgrove/analytics` `0.1.41`, then `@funnelsgrove/payments` `0.1.58`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.43`. 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/docs/funnelsgrove/qa/analytics.md CHANGED Viewed

@@ -32,7 +32,9 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
 - Choice steps save the exact stable ID shape before completion.
 - Email success creates one server conversion; duplicate capture skips browser fanout; failure changes no state/lifecycle/route.
 - Checkout helpers fire only at real boundaries with complete metadata and stable event IDs.
-- Quiz completed requires trusted-server `purchase_completed`, deduplicated by `provider-payment`; browser `funnel_completed` is lifecycle-only and never satisfies it.
+- Quiz completed counts each unique user who reaches a paywall step.
+- `purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed.
+- Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.
 - `registration_completed` remains the separate later app-link claim.
 - Preview sends no API/provider analytics.
 - No component sends PostHog or server Meta directly.

package/template_scaffold/funnel-docs.config.json CHANGED Viewed

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

package/template_scaffold/package-lock.json CHANGED Viewed

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.39",
-        "@funnelsgrove/payments": "^0.1.56",
-        "@funnelsgrove/runtime": "^0.1.62",
+        "@funnelsgrove/analytics": "^0.1.41",
+        "@funnelsgrove/payments": "^0.1.58",
+        "@funnelsgrove/runtime": "^0.1.63",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -891,17 +891,17 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.1.39",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.39.tgz",
-      "integrity": "sha512-c7cBRHrq7FYOJLPJWCRH778ccWLAIK+4ArgD9xrjwSOcHBHeBpt87DMMtvL6vnD/kPSJIu4oLucD3eF3CZ900g==",
+      "version": "0.1.41",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.41.tgz",
+      "integrity": "sha512-RrAlBajsJawxpG1ijthRhGcuyqoPCP29r4XNu3K980zrtkWidYu0E4TqBPdPHTmhBb6WNnMcfVHV6H7XaqkQ8A==",
       "dependencies": {
-        "@funnelsgrove/runtime": "0.1.62"
+        "@funnelsgrove/runtime": "0.1.63"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.1.56",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.1.56.tgz",
-      "integrity": "sha512-3I+LlKKPOJOc/cL2NeqENyFrXiQSjtHbtqXbMRAYoxFK1Zrt3z8kkCq5JPDzOfD/In5xOaDUnxorVuuMXMvXog==",
+      "version": "0.1.58",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.1.58.tgz",
+      "integrity": "sha512-y1caUil8SFNiuYf/TxptheEf/cnK2urafy2eF2gFdfugfaybFiqUiyTzEVen+K+uKtX8tDCk2UtNeyWMO8inAA==",
       "dependencies": {
         "@funnelsgrove/analytics": "^0.1.28",
         "@funnelsgrove/runtime": "^0.1.54",
@@ -913,9 +913,9 @@
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.1.62",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.1.62.tgz",
-      "integrity": "sha512-S27kA3f7Y30CsqNxajcGwfkdyz19UOlWtjlqYLiM8Mn0HzJoyxGpU4xpMopROqrpArhmy/S9dzvF250pSpgeBw==",
+      "version": "0.1.63",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.1.63.tgz",
+      "integrity": "sha512-D0y7l/GwVc519CBr3TCxsXvr3H+B9RmcvebBUKks+FqdDx5j2AO5qdUbB838bqkBNCCjHOtcbs3u2Gsm4Qhk4w==",
       "dependencies": {
         "posthog-js": "^1.369.2",
         "react": "19.2.3",

package/template_scaffold/package.json CHANGED Viewed

@@ -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.39",
-    "@funnelsgrove/payments": "^0.1.56",
-    "@funnelsgrove/runtime": "^0.1.62",
+    "@funnelsgrove/analytics": "^0.1.41",
+    "@funnelsgrove/payments": "^0.1.58",
+    "@funnelsgrove/runtime": "^0.1.63",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",

package/template_scaffold/tests/funnel-agent-docs.test.ts CHANGED Viewed

@@ -300,21 +300,31 @@ describe('funnel agent documentation supply', () => {
     }
   });
-  it('requires trusted purchase completion for the Quiz completed QA assertion', async () => {
-    const content = await readFile(
-      join(templateRoot, 'docs/funnelsgrove/qa/analytics.md'),
-      'utf8',
-    );
-    expect(content).toContain(
-      'Quiz completed requires trusted-server `purchase_completed`, deduplicated by `provider-payment`',
-    );
-    expect(content).toContain(
-      'browser `funnel_completed` is lifecycle-only and never satisfies it',
-    );
-    expect(content).toContain(
-      '`registration_completed` remains the separate later app-link claim',
-    );
+  it('defines Quiz completed by unique paywall reach without conflating purchase verification', async () => {
+    const paths = [
+      'docs/funnelsgrove/qa/analytics.md',
+      'docs/funnelsgrove/contracts/analytics-events.md',
+      'docs/funnelsgrove/START-HERE.md',
+      'docs/funnelsgrove/contracts/payments.md',
+    ];
+    const contents = await Promise.all(paths.map(async (path) => ({
+      path,
+      content: await readFile(join(templateRoot, path), 'utf8'),
+    })));
+    for (const { path, content } of contents) {
+      expect(content, path).toContain(
+        'Quiz completed counts each unique user who reaches a paywall step.',
+      );
+      expect(content, path).toContain(
+        '`purchase_completed` remains trusted-server-only purchase verification and does not define Quiz completed.',
+      );
+      expect(content, path).toContain(
+        'Browser terminal reach and `funnel_completed` remain lifecycle-only and are not purchase conversions.',
+      );
+      expect(content, path).not.toMatch(/Quiz completed requires[^.]*purchase_completed/i);
+      expect(content, path).not.toMatch(/terminal reach[^.]*not (?:count|counts) as Quiz completed/i);
+    }
   });
   it('preserves the implementation-owned visitor metric while linking event ownership', async () => {
@@ -340,7 +350,7 @@ describe('funnel agent documentation supply', () => {
     expect(manifest).toMatchObject({
       schemaVersion: 1,
-      bundleVersion: '2.0.23',
+      bundleVersion: '2.0.31',
       stepContractVersion: contract.stepContractVersion,
       contractHash: contract.contractHash,
     });

package/template_scaffold/vercel.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "git": {
+    "deploymentEnabled": false
+  }
+}