@funnelsgrove/cli 0.1.26 → 0.1.28

package/README.md

@@ -39,7 +39,9 @@ connected, commit and push source changes with normal git, then run `fgrove
 github pull` to sync GitHub into the hosted draft. Do not run `fgrove sync up`
 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.
+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. Pass `--no-github-sync` when the generated file will be committed through the normal repository workflow and the command must not wait for the shared GitHub queue.
 
 Create an experiment draft from a strict JSON spec:
 
@@ -70,6 +72,9 @@ fgrove publish --funnel claimbee-general --env preview
 The GitHub commands use the FunnelsGrove API only. `fgrove github pull` pulls
 the repository into the hosted draft after you push normal git commits.
 `fgrove publish` waits for the current draft to reach GitHub before publishing.
+Use `--no-github-sync` to bypass only that CLI pre-publish wait when the hosted
+draft is already known to match GitHub; the publish worker still performs its
+normal best-effort post-publish GitHub synchronization.
 `fgrove github push` still exists for explicit hosted-draft-to-GitHub recovery
 work, but it is not the normal path for local source changes. Local `.env*`
 files remain CLI-local runtime material from `sync down`; they are not sent to

package/dist/analyticsOutput.d.ts

@@ -101,6 +101,7 @@ export type MarketingCohortPerformanceRow = {
     funnelUrl: string;
     mediaSource: string;
     spend: number;
+    spendCurrency: string | null;
     subscribers: number;
     subscribersAlive: number;
     subscribersAlivePercent: number | null;
@@ -108,6 +109,16 @@ export type MarketingCohortPerformanceRow = {
     revenueDay3: number;
     revenueDay90: number;
     revenueDay180: number;
+    revenueCurrency: string | null;
+    revenueCurrencySafe: boolean;
+    predictedNetRevenueDay3Minor: number | null;
+    predictedNetRevenueDay3Currency: string | null;
+    predictedNetRevenueDay90Minor: number | null;
+    predictedNetRevenueDay90Currency: string | null;
+    predictedNetRevenueDay180Minor: number | null;
+    predictedNetRevenueDay180Currency: string | null;
+    predictedNetRevenueDay365Minor: number | null;
+    predictedNetRevenueDay365Currency: string | null;
     pLtvCurrency: string | null;
     pLtv: number | null;
     pLtvPredictedNetRevenueDay365Minor: number | null;

package/dist/analyticsOutput.js

@@ -226,9 +226,16 @@ export const formatConversionsTable = (input) => {
 };
 const flattenCohortRows = (rows) => rows.flatMap((row) => [row, ...(row.segments || []), ...(row.children || [])]);
 const normalizeCurrency = (value) => {
-    const currency = value?.trim().toUpperCase() || '';
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const currency = value.trim().toUpperCase();
     return /^[A-Z]{3}$/.test(currency) ? currency : null;
 };
+const sameCurrency = (left, right) => {
+    const normalizedLeft = normalizeCurrency(left);
+    return normalizedLeft !== null && normalizedLeft === normalizeCurrency(right);
+};
 const predictedAverageLtv = (row) => {
     if (!normalizeCurrency(row.pLtvCurrency)) {
         return null;
@@ -245,19 +252,49 @@ const predictedAverageLtv = (row) => {
         ? row.pLtv
         : null;
 };
-const ratioToSpend = (value, spend) => (Number.isFinite(value) && Number.isFinite(spend) && spend !== 0 ? value / spend : null);
+const ratioToSpend = (value, spend) => (Number.isFinite(value) && Number.isFinite(spend) && spend > 0 ? value / spend : null);
 const formatRoi = (profit, spend) => {
     const ratio = ratioToSpend(profit, spend);
     return ratio === null ? '' : `${(ratio * 100).toFixed(2)}%`;
 };
-const formatRoas = (revenue, spend) => {
-    const ratio = ratioToSpend(revenue, spend);
-    return ratio === null ? '' : `${ratio.toFixed(2)}x`;
+const forecastDefinitions = {
+    day3: {
+        minor: 'predictedNetRevenueDay3Minor',
+        currency: 'predictedNetRevenueDay3Currency',
+    },
+    day90: {
+        minor: 'predictedNetRevenueDay90Minor',
+        currency: 'predictedNetRevenueDay90Currency',
+    },
+    day180: {
+        minor: 'predictedNetRevenueDay180Minor',
+        currency: 'predictedNetRevenueDay180Currency',
+    },
+    day365: {
+        minor: 'predictedNetRevenueDay365Minor',
+        currency: 'predictedNetRevenueDay365Currency',
+    },
+};
+const formatForecastRoas = (row, forecast) => {
+    const minor = row[forecast.minor];
+    if (typeof minor !== 'number'
+        || !Number.isFinite(minor)
+        || !Number.isFinite(row.spend)
+        || row.spend <= 0) {
+        return '';
+    }
+    if (!normalizeCurrency(row.spendCurrency)) {
+        return '';
+    }
+    if (minor !== 0 && !sameCurrency(row[forecast.currency], row.spendCurrency)) {
+        return '';
+    }
+    return `${((minor / 100 / row.spend) * 100).toFixed(2)}%`;
 };
 export const formatCohortTable = (input) => {
     const lines = [
         `Cohort\t${input.date}`,
-        'cohort\tmediaSource\tfunnelUrl\tspend\tsubscribers\taliveRate\trevenue\tpLtv\tpLtvCurrency\tcpa\tpredictedProfit\tpROI\tROAS\tROAS d3\tROAS d90\tROAS d180',
+        'cohort\tmediaSource\tfunnelUrl\tspend\tsubscribers\taliveRate\trevenue\tpLtv\tpLtvCurrency\tcpa\tpRevenue\tpredictedProfit\tpROI\tROAS\tROAS d3\tROAS d90\tROAS d180',
     ];
     for (const row of flattenCohortRows(input.cohort.rows)) {
         const cpa = row.subscribers > 0 ? row.spend / row.subscribers : 0;
@@ -265,31 +302,41 @@ export const formatCohortTable = (input) => {
         const predictedRevenue = averageLtv === null
             ? null
             : averageLtv * row.subscribers;
-        const predictedProfit = predictedRevenue === null
-            ? null
-            : predictedRevenue - row.spend;
+        const predictedProfit = predictedRevenue !== null
+            && sameCurrency(row.pLtvCurrency, row.spendCurrency)
+            ? predictedRevenue - row.spend
+            : null;
+        const spendCurrency = normalizeCurrency(row.spendCurrency);
+        const revenueCurrency = row.revenueCurrencySafe === true
+            ? normalizeCurrency(row.revenueCurrency)
+            : null;
         const pLtvCurrency = normalizeCurrency(row.pLtvCurrency);
         lines.push([
             row.cohortDate,
             row.mediaSource,
             row.funnelUrl,
-            formatCurrency(row.spend),
+            spendCurrency === null ? '' : formatCurrency(row.spend, spendCurrency),
             formatNumber(row.subscribers),
             formatPercentPoints(row.subscribersAlivePercent),
-            formatCurrency(row.revenue),
+            revenueCurrency === null ? '' : formatCurrency(row.revenue, revenueCurrency),
             row.pLtv === null || pLtvCurrency === null
                 ? ''
                 : formatCurrency(row.pLtv, pLtvCurrency),
             pLtvCurrency || '',
-            row.subscribers > 0 ? formatCurrency(cpa) : '',
+            row.subscribers > 0 && spendCurrency !== null
+                ? formatCurrency(cpa, spendCurrency)
+                : '',
+            predictedRevenue === null || pLtvCurrency === null
+                ? ''
+                : formatCurrency(predictedRevenue, pLtvCurrency),
             predictedProfit === null
                 ? ''
                 : formatCurrency(predictedProfit, pLtvCurrency || 'USD'),
             predictedProfit === null ? '' : formatRoi(predictedProfit, row.spend),
-            formatRoas(row.revenue, row.spend),
-            formatRoas(row.revenueDay3, row.spend),
-            formatRoas(row.revenueDay90, row.spend),
-            formatRoas(row.revenueDay180, row.spend),
+            formatForecastRoas(row, forecastDefinitions.day365),
+            formatForecastRoas(row, forecastDefinitions.day3),
+            formatForecastRoas(row, forecastDefinitions.day90),
+            formatForecastRoas(row, forecastDefinitions.day180),
         ].join('\t'));
     }
     return `${lines.join('\n')}\n`;

package/dist/cli.d.ts

@@ -196,6 +196,13 @@ export declare function buildGeneratedConfigSyncInput(input: {
 };
 export declare function selectGeneratedConfigFiles(files: SourceFile[], kinds: GeneratedConfigKind[]): SourceFile[];
 export declare function assertCanDraftSyncSource(status: GitHubStatusResponse): void;
+export declare const shouldSyncGitHubDraft: (options: {
+    githubSync?: boolean;
+}) => boolean;
+export declare const formatOfferSetSyncSuccess: (input: {
+    offerSetLabel: string;
+    generatedFileCount: number;
+}) => string[];
 export declare const program: Command;
 type AnalyticsApiCall = (input: {
     path: string;

package/dist/cli.js

@@ -1412,6 +1412,11 @@ 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)}`,
+];
 const syncGeneratedConfigFilesForCli = async (input) => {
     const result = await callApi({
         path: 'funnels.generatedConfigFiles',
@@ -1621,6 +1626,7 @@ addExamples(offerSetsCommand
     .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',
@@ -1648,14 +1654,18 @@ addExamples(offerSetsCommand
         target,
         kinds: ['offerSets'],
     });
-    await syncGitHubDraftForCli({
-        token,
-        workspaceId: target.workspaceId,
-        funnelId: target.funnelId,
-    });
     const offerSetLabel = result.offerSet?.key || result.offerSet?.display_name || options.offerSet.trim();
-    console.log(`Synced offer set ${offerSetLabel} to funnel draft`);
-    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
+    console.log(formatOfferSetSyncSuccess({
+        offerSetLabel,
+        generatedFileCount: generatedFiles.length,
+    }).join('\n'));
+    if (shouldSyncGitHubDraft(options)) {
+        await syncGitHubDraftForCli({
+            token,
+            workspaceId: target.workspaceId,
+            funnelId: target.funnelId,
+        });
+    }
 });
 const experimentsCommand = addExamples(program.command('experiments').description('Manage funnel experiments'), [
     'fgrove experiments create --spec experiment.json --dir .',
@@ -2209,7 +2219,8 @@ addExamples(program
     .option('--dir <path>', 'Local source directory for reading sync manifest', '.')
     .option('--env <preview-or-production>', 'Publish environment', 'preview')
     .option('--domain <domain>', 'Production custom domain')
-    .option('--message <message>', 'Publish version message'), [
+    .option('--message <message>', 'Publish version message')
+    .option('--no-github-sync', 'Skip the pre-publish GitHub draft push wait'), [
     'fgrove publish --env preview --message "Preview copy updates"',
     'fgrove publish --env production --domain claimbee.example.com --message "Launch"',
 ])
@@ -2230,11 +2241,13 @@ addExamples(program
         funnel: options.funnel,
         dir: options.dir,
     });
-    await syncGitHubDraftForCli({
-        token,
-        workspaceId: target.workspaceId,
-        funnelId: target.funnelId,
-    });
+    if (shouldSyncGitHubDraft(options)) {
+        await syncGitHubDraftForCli({
+            token,
+            workspaceId: target.workspaceId,
+            funnelId: target.funnelId,
+        });
+    }
     const result = await callApi({
         path: 'funnels.publish',
         type: 'mutation',

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.26",
+      "repositoryCliVersion": "0.1.28",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.14",
+        "bundleVersion": "2.0.16",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "b9d539ce9e5330d267afbf694529cf5b7e7be7fc2d28a9d9deceba88f85d5044"
+            "sha256": "b2e3022c5ce21cf70f125c49502b367156abd0eb23d728727c2956d46cf53b2e"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "1ac242e7ed583c7688fc8939536f9cd212c88db0fcafe34a4abee1280de52c1c"
+            "sha256": "7281cd1676e9bd30c9dd7c5f1b7aac8b24f923f6f9772e427fd7b75c15171eec"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.25",
+      "repositoryCliVersion": "0.1.27",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.13",
+        "bundleVersion": "2.0.15",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "66cd0134a5c0be3e28e966513370c0fc4d8fa427a8927620d4f5f688b96422ca"
+            "sha256": "790e5f36fb47f256da4ab25b1b1fbe453f1de61af2d278c400cb9a5edfeedeaf"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "556e7f6ce51fceaae062f60e98fd891c3344e40faf088d22174af4345fc7917c"
+            "sha256": "1e57699834211909ee3a9a6eabfc957e5cc4952a07d4621b26fc7328be960973"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.24",
+      "repositoryCliVersion": "0.1.26",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.12",
+        "bundleVersion": "2.0.14",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "2a25df4203ff0ca8a8532a22bdb5c11ab687b00b369894e3a3376caa378028d7"
+            "sha256": "b9d539ce9e5330d267afbf694529cf5b7e7be7fc2d28a9d9deceba88f85d5044"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "06ea750a825821a578161e287b01388d229ec1c82e3c2fbc956a7e57a0c3888d"
+            "sha256": "1ac242e7ed583c7688fc8939536f9cd212c88db0fcafe34a4abee1280de52c1c"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.23",
+      "repositoryCliVersion": "0.1.25",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.11",
+        "bundleVersion": "2.0.13",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "5b135f70a2d005a2818f4992f79cd71865e00429f7adb73fc9aa88d2b3e1c2e4"
+            "sha256": "66cd0134a5c0be3e28e966513370c0fc4d8fa427a8927620d4f5f688b96422ca"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "84fb5735b12d84f76796ed17f1697e4891e27e416316e57027a629b54cd15fd5"
+            "sha256": "556e7f6ce51fceaae062f60e98fd891c3344e40faf088d22174af4345fc7917c"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.22",
+      "repositoryCliVersion": "0.1.24",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.10",
+        "bundleVersion": "2.0.12",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "b481733e085697910f34bbd62d830edb8248990d00660a24a73b6ee45b967241"
+            "sha256": "2a25df4203ff0ca8a8532a22bdb5c11ab687b00b369894e3a3376caa378028d7"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "f7a7894dfbd8a8e254e6dfe49b4f52cd25e19f6525a0296f7c666a7eef178e53"
+            "sha256": "06ea750a825821a578161e287b01388d229ec1c82e3c2fbc956a7e57a0c3888d"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.21",
+      "repositoryCliVersion": "0.1.23",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.9",
+        "bundleVersion": "2.0.11",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "5ff5fdbbe6d1dabfc7d1ba5b19eaf5cc146de57b255dffbe747927bca59afb89"
+            "sha256": "5b135f70a2d005a2818f4992f79cd71865e00429f7adb73fc9aa88d2b3e1c2e4"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "251d4e0d416a94dd43dd9a7d0c0765904efed4a98ad298d38064f55c10c19283"
+            "sha256": "84fb5735b12d84f76796ed17f1697e4891e27e416316e57027a629b54cd15fd5"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.20",
+      "repositoryCliVersion": "0.1.22",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.8",
+        "bundleVersion": "2.0.10",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "963e849027819a4b924ea0af2a09e23c610b838125477bd3a79d104cdbda3d8d"
+            "sha256": "b481733e085697910f34bbd62d830edb8248990d00660a24a73b6ee45b967241"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -947,7 +947,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "832b4331d6690d0596800c5aeb969f608dd62cf63d9ae527054e832fb60f8abd"
+            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "734116ac17d631bcf7b5e34b2cf58097aef7952a36b47f3bd7f0533223ff4ed2"
+            "sha256": "f7a7894dfbd8a8e254e6dfe49b4f52cd25e19f6525a0296f7c666a7eef178e53"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "type": "module",
   "bin": {

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.14",
+  "bundleVersion": "2.0.16",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "b9d539ce9e5330d267afbf694529cf5b7e7be7fc2d28a9d9deceba88f85d5044"
+      "sha256": "b2e3022c5ce21cf70f125c49502b367156abd0eb23d728727c2956d46cf53b2e"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1ac242e7ed583c7688fc8939536f9cd212c88db0fcafe34a4abee1280de52c1c"
+      "sha256": "7281cd1676e9bd30c9dd7c5f1b7aac8b24f923f6f9772e427fd7b75c15171eec"
     }
   ]
 }

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.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.26`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.28`. 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.14",
+  "bundleVersion": "2.0.16",
   "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.14",
+  "bundleVersion": "2.0.16",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "b9d539ce9e5330d267afbf694529cf5b7e7be7fc2d28a9d9deceba88f85d5044"
+      "sha256": "b2e3022c5ce21cf70f125c49502b367156abd0eb23d728727c2956d46cf53b2e"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1ac242e7ed583c7688fc8939536f9cd212c88db0fcafe34a4abee1280de52c1c"
+      "sha256": "7281cd1676e9bd30c9dd7c5f1b7aac8b24f923f6f9772e427fd7b75c15171eec"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "a271052a1c008ebf769480051d47c0f941cb4987a2a9aa5f3475c01892e23b78",
+  "sourceTreeHash": "502e7627544f88ecfa05d71d230538a3006f0eb1b3e0433d80468a74d603fb85",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.14",
+  "docsBundleVersion": "2.0.16",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "fafd9bbf52e7eb1a5dd3c4f429b6b004d8b8afa3ce652f40b55ea8743e26ce84",
+      "sha256": "8642026a790d2e0bfb45999299d5114666cc9e80375843ed34e2a7924132c44b",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "b9d539ce9e5330d267afbf694529cf5b7e7be7fc2d28a9d9deceba88f85d5044",
+      "sha256": "b2e3022c5ce21cf70f125c49502b367156abd0eb23d728727c2956d46cf53b2e",
       "mode": "100644"
     },
     {
@@ -236,12 +236,12 @@
     },
     {
       "path": "funnel-agent-docs.test.ts",
-      "sha256": "0a44b1c46be244ba95237c34ed157306932f82ea2e30654cb0e35b9dfa2f0a84",
+      "sha256": "e557366cf246340c74681736ce0cc2dd7ef0b2e4166dcd005197576b4d195088",
       "mode": "100644"
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1ac242e7ed583c7688fc8939536f9cd212c88db0fcafe34a4abee1280de52c1c",
+      "sha256": "7281cd1676e9bd30c9dd7c5f1b7aac8b24f923f6f9772e427fd7b75c15171eec",
       "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.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.26`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.28`. 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-agent-docs.test.ts

@@ -340,7 +340,7 @@ describe('funnel agent documentation supply', () => {
 
     expect(manifest).toMatchObject({
       schemaVersion: 1,
-      bundleVersion: '2.0.14',
+      bundleVersion: '2.0.16',
       stepContractVersion: contract.stepContractVersion,
       contractHash: contract.contractHash,
     });

package/template_scaffold/funnel-docs.config.json

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