@funnelsgrove/cli 0.1.270 → 0.1.273

package/README.md

@@ -50,6 +50,25 @@ After downloading, establish the product/audience/offer/brand brief and root
 intake workflow; starter artwork, proof and legal/offer copy need adaptation.
 The starter preview includes later local changes only after sync and publish.
 
+Find visual examples in the public Funnel Screens library without an account:
+
+```bash
+fgrove references categories
+fgrove references list --category 'Health Fitness' --step-type single-choice
+fgrove references show <funnel-id> --json
+fgrove references steps <funnel-id>
+fgrove references step <funnel-id> <screen-id-or-position> --json
+```
+
+`show` returns the complete recorded journey; `steps` gives compact ordered
+summaries; `step` returns one screen with its image link, visible text, button and
+option labels, and a brief visual description when available. Positions start
+at 1. Every command supports `--json` and `--site-url` (default:
+`https://www.funnelsgrove.com`). These commands use the public reference service
+independently of your account API and do not change the active funnel. Content
+is automatic observation with uncertainty notes; inspect the actual images before
+adapting a design. Unavailable observations are marked explicitly.
+
 Sync a funnel into its own local folder:
 
 ```bash

package/dist/cli.js

@@ -25,6 +25,7 @@ import { GitHubSyncTimeoutError, syncGitHubDraftIfConnected, } from './githubSyn
 import { reskinFunnel } from './reskin.js';
 import { describeFunnelTemplate, renderFunnelTemplate } from './funnelTemplates.js';
 import { createHostedFunnel } from './funnelCreation.js';
+import { DEFAULT_REFERENCE_SITE_URL, readFunnelReferences, renderFunnelReferences } from './referenceClient.js';
 import { TEMPLATE_DOCS_DIR } from './templateDocs.js';
 import { renderDocsHuman, renderDocsJson, } from './docsOutput.js';
 import { applyTemplateDocsUpdate, inspectTemplateDocs, loadBundledDocs, planTemplateDocsUpdate, recoverTemplateDocs, resolveTemplateDocsConflict, } from './docsTransaction.js';
@@ -2057,6 +2058,37 @@ addExpenseScopeOptions(expensesCommand
     const result = await executeExpensePublish(scope);
     console.log(`Published expenses: ${result.created} created, ${result.updated} updated.`);
 });
+const addReferenceOptions = (command) => command
+    .option('--site-url <url>', 'Public Funnel Screens website URL', DEFAULT_REFERENCE_SITE_URL)
+    .option('--json', 'Emit one machine-readable reference response');
+const runReferenceCommand = async (query, options) => {
+    const result = await readFunnelReferences(query, options.siteUrl);
+    process.stdout.write(options.json ? JSON.stringify(result) + '\n' : renderFunnelReferences(result));
+};
+const referencesCommand = addExamples(program.command('references').description('Browse public Funnel Screens references without logging in'), [
+    'fgrove references categories',
+    'fgrove references list --json',
+    'fgrove references show <funnel-id> --json',
+    'fgrove references steps <funnel-id>',
+    'fgrove references step <funnel-id> 1',
+]);
+addReferenceOptions(referencesCommand.command('categories')
+    .description('List industry categories and their funnel and screen counts'))
+    .action(async (options) => runReferenceCommand({ view: 'categories' }, options));
+addReferenceOptions(referencesCommand.command('list')
+    .description('List recorded funnel references')
+    .option('--category <category>', 'Filter by industry category')
+    .option('--step-type <type>', 'Filter by observed screen type'))
+    .action(async (options) => runReferenceCommand({ category: options.category, stepType: options.stepType }, options));
+addReferenceOptions(referencesCommand.command('show <funnel-id>')
+    .description('Show a complete recorded journey with every screen’s content and image URL'))
+    .action(async (funnel, options) => runReferenceCommand({ funnel }, options));
+addReferenceOptions(referencesCommand.command('steps <funnel-id>')
+    .description('List ordered screen descriptions for a recorded funnel'))
+    .action(async (funnel, options) => runReferenceCommand({ funnel, view: 'steps' }, options));
+addReferenceOptions(referencesCommand.command('step <funnel-id> <step-id-or-position>')
+    .description('Show one screen’s text, buttons, options, appearance and image URL; positions start at 1'))
+    .action(async (funnel, screen, options) => runReferenceCommand({ funnel, screen }, options));
 const loadFunnelTemplateCards = async (workspace) => {
     const token = await readAuthToken();
     const workspaceId = await resolveWorkspaceId(token, workspace);

package/dist/referenceClient.d.ts

@@ -0,0 +1,76 @@
+export declare const DEFAULT_REFERENCE_SITE_URL = "https://www.funnelsgrove.com";
+export type ReferenceQuery = {
+    category?: string;
+    stepType?: string;
+    view?: 'categories' | 'steps';
+    funnel?: string;
+    screen?: string;
+};
+type FunnelSummary = {
+    id: string;
+    name: string;
+    industry: string;
+    capturedAt: string;
+    capturedScreenCount: number;
+    availableScreenCount: number;
+    reachedPaywall: boolean;
+    url: string;
+    previewImageUrl: string;
+    stepTypes: string[];
+    screenTypes?: string[];
+};
+type ReferenceList = {
+    version: 1;
+    totalScreenCount: number;
+    funnels: FunnelSummary[];
+};
+type ReferenceCategories = {
+    version: 1;
+    categories: Array<{
+        category: string;
+        funnelCount: number;
+        screenCount: number;
+    }>;
+};
+type StepContent = {
+    text: string;
+    buttons: string[];
+    options: string[];
+    visualDescription: string;
+    screenType: string;
+    notes: string[];
+    source: 'image-analysis';
+};
+type ReferenceStepSummary = {
+    id: string;
+    position: number;
+    label: string;
+    type: string;
+    screenType: string;
+    description: string | null;
+    contentStatus: 'available' | 'unavailable';
+    imageUrl: string;
+    url: string;
+};
+type ReferenceStep = ReferenceStepSummary & {
+    width: number;
+    height: number;
+    sha256: string;
+    content: StepContent | null;
+};
+type ReferenceFunnel = {
+    version: 1;
+    funnel: FunnelSummary & {
+        referenceScope?: string;
+        steps: Array<ReferenceStep | ReferenceStepSummary>;
+    };
+};
+type ReferenceSingleStep = {
+    version: 1;
+    funnel: FunnelSummary;
+    step: ReferenceStep;
+};
+type ReferenceResult = ReferenceList | ReferenceCategories | ReferenceFunnel | ReferenceSingleStep;
+export declare function readFunnelReferences(query: ReferenceQuery, siteUrl: string): Promise<ReferenceResult>;
+export declare function renderFunnelReferences(result: ReferenceResult): string;
+export {};

package/dist/referenceClient.js

@@ -0,0 +1,114 @@
+export const DEFAULT_REFERENCE_SITE_URL = 'https://www.funnelsgrove.com';
+const isRecord = (value) => (typeof value === 'object' && value !== null && !Array.isArray(value));
+const isStringArray = (value) => (Array.isArray(value) && value.every((item) => typeof item === 'string'));
+const isCount = (value) => (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0);
+const isSummary = (value) => isRecord(value)
+    && ['id', 'name', 'industry', 'capturedAt', 'url', 'previewImageUrl'].every((field) => typeof value[field] === 'string')
+    && isCount(value.capturedScreenCount) && isCount(value.availableScreenCount)
+    && typeof value.reachedPaywall === 'boolean' && isStringArray(value.stepTypes)
+    && (value.screenTypes === undefined || isStringArray(value.screenTypes));
+const isStepContent = (value) => isRecord(value)
+    && ['text', 'visualDescription', 'screenType'].every((field) => typeof value[field] === 'string')
+    && isStringArray(value.buttons) && isStringArray(value.options) && isStringArray(value.notes)
+    && value.source === 'image-analysis';
+const isStepSummary = (value) => isRecord(value)
+    && ['id', 'label', 'type', 'screenType', 'imageUrl', 'url'].every((field) => typeof value[field] === 'string')
+    && isCount(value.position) && value.position > 0
+    && ((value.contentStatus === 'available' && typeof value.description === 'string')
+        || (value.contentStatus === 'unavailable' && value.description === null));
+const isStep = (value) => isStepSummary(value)
+    && typeof value.sha256 === 'string' && isCount(value.width) && isCount(value.height)
+    && (value.contentStatus === 'available' ? isStepContent(value.content) : value.content === null);
+const isReferenceResult = (value, query) => {
+    if (!isRecord(value) || value.version !== 1)
+        return false;
+    if (query.view === 'categories') {
+        return Array.isArray(value.categories) && value.categories.every((category) => isRecord(category)
+            && typeof category.category === 'string' && isCount(category.funnelCount) && isCount(category.screenCount));
+    }
+    if (query.screen !== undefined)
+        return isSummary(value.funnel) && isStep(value.step);
+    if (query.funnel !== undefined) {
+        return isSummary(value.funnel)
+            && (query.view === 'steps' || typeof value.funnel.referenceScope === 'string')
+            && Array.isArray(value.funnel.steps) && value.funnel.steps.every(query.view === 'steps' ? isStepSummary : isStep);
+    }
+    return isCount(value.totalScreenCount) && Array.isArray(value.funnels) && value.funnels.every(isSummary);
+};
+export async function readFunnelReferences(query, siteUrl) {
+    let url;
+    try {
+        url = new URL('/api/funnel-references', siteUrl);
+        if (!['https:', 'http:'].includes(url.protocol) || url.username || url.password)
+            throw new Error('Invalid reference site');
+    }
+    catch {
+        throw new Error('Reference site URL must be an HTTP or HTTPS URL without credentials.');
+    }
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined)
+            url.searchParams.set(key, value);
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15_000);
+    try {
+        const response = await fetch(url, {
+            headers: { authorization: 'Bearer 123', accept: 'application/json' },
+            signal: controller.signal,
+        });
+        const body = await response.json().catch(() => null);
+        if (!response.ok) {
+            const detail = isRecord(body) && typeof body.error === 'string' ? ': ' + body.error : '';
+            throw new Error('Reference API returned HTTP ' + response.status + detail);
+        }
+        if (!isReferenceResult(body, query)) {
+            throw new Error('Reference API returned an invalid version 1 response.');
+        }
+        return body;
+    }
+    catch (error) {
+        if (controller.signal.aborted)
+            throw new Error('Reference API request timed out after 15 seconds.');
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+const renderStep = (step) => {
+    const lines = [step.position + '. ' + step.label + ' [' + step.id + ']', 'Type: ' + step.screenType];
+    if (step.description)
+        lines.push(step.description);
+    if ('content' in step && step.content) {
+        lines.push('Text:', step.content.text, 'Appearance: ' + step.content.visualDescription);
+        for (const [label, values] of [['Buttons', step.content.buttons], ['Options', step.content.options], ['Notes', step.content.notes]]) {
+            if (values.length)
+                lines.push(label + ':', ...values.map((value) => '  - ' + value));
+        }
+    }
+    else if (step.contentStatus === 'unavailable') {
+        lines.push('Content unavailable');
+    }
+    lines.push('Image: ' + step.imageUrl, 'View: ' + step.url);
+    return lines.join('\n');
+};
+export function renderFunnelReferences(result) {
+    if ('categories' in result) {
+        return result.categories.length
+            ? result.categories.map((category) => [category.category, category.funnelCount + ' funnels', category.screenCount + ' screens'].join('\t')).join('\n') + '\n'
+            : 'No reference categories are available.\n';
+    }
+    if ('funnel' in result) {
+        const { funnel } = result;
+        if ('step' in result)
+            return funnel.name + ' [' + funnel.id + ']\n\n' + renderStep(result.step) + '\n';
+        const detail = result.funnel;
+        return [funnel.name + ' [' + funnel.id + ']', funnel.industry + ' · ' + funnel.availableScreenCount + ' screens',
+            'Captured: ' + funnel.capturedAt, 'Screen types: ' + (funnel.screenTypes?.join(', ') || 'Not available'),
+            detail.referenceScope, ...detail.steps.map(renderStep)].filter(Boolean).join('\n\n') + '\n';
+    }
+    return result.funnels.length
+        ? result.funnels.map((funnel) => [funnel.id, funnel.name, funnel.industry, funnel.availableScreenCount + ' screens',
+            'Types: ' + (funnel.screenTypes?.join(', ') || 'Not available'), funnel.url].join('\t')).join('\n') + '\n'
+        : 'No funnel references match these filters.\n';
+}

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.270",
+      "repositoryCliVersion": "0.1.273",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.263",
+        "bundleVersion": "2.0.266",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "55cbdd50d399a22529388527b087ba7f3abc808c2c3591eca2eee80abf3a010d"
+            "sha256": "c70753edc90c84360869c7c2d8e3b7431c6fc6486845e8dc6a114edcc6a222d9"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "c05b94f4374b482ecbd21f3f5e20c03fb9b293358f9a48956923b7d2acd9e691"
+            "sha256": "8a2b3ef99715282070a4b49ff375b67267e25aae17e1ba3657a2e27764bac033"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.269",
+      "repositoryCliVersion": "0.1.272",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.262",
+        "bundleVersion": "2.0.265",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702"
+            "sha256": "6826dc07fe3398e810b1fae1fc241e0cb9030e2c6ffa02b9bfd8e70607b43709"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1"
+            "sha256": "1044bf23876439e0ada156189f05b32bfd1d55e084b8ee6d0af000d104dc2be7"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.268",
+      "repositoryCliVersion": "0.1.271",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.261",
+        "bundleVersion": "2.0.264",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
+            "sha256": "ff692baa77dc8a35fe9f7712ad9729165cd60922b9d89b255b720ee9a6a8ec18"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
+            "sha256": "d08b11a59a90c0f38929c6a2bd63690239b08a42ef24239a03ad67b2aba5a394"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.267",
+      "repositoryCliVersion": "0.1.270",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.260",
+        "bundleVersion": "2.0.263",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bfe6ab1080a10b02abd9bb2c6438235b0f741524ebfa38d36f357a47e75a5a5b"
+            "sha256": "55cbdd50d399a22529388527b087ba7f3abc808c2c3591eca2eee80abf3a010d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "cbd2957d78ab7ccb93292dfb53ca9f2bf9b5cdbb14515ac8a8b03cc33d7a1983"
+            "sha256": "c05b94f4374b482ecbd21f3f5e20c03fb9b293358f9a48956923b7d2acd9e691"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.266",
+      "repositoryCliVersion": "0.1.269",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.259",
+        "bundleVersion": "2.0.262",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "a73414cd33b42bef5cf55b9d007485751bf84412dc690b2c7dd883e6c7b127f1"
+            "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "8f841dfc3f38d4e3d911aaf74d1911b9e36e1d653594fcf3e4188dbdb45ae82b"
+            "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.265",
+      "repositoryCliVersion": "0.1.268",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.258",
+        "bundleVersion": "2.0.261",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "e529cbfc0ab172d5168301efcb09e2f7ed7459d3c8c7f27db9198b4ccce069ba"
+            "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "4cc4c05d6f0048162c5fc0a534050e11a8c14585783a7fae61a98462e880cc65"
+            "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.264",
+      "repositoryCliVersion": "0.1.267",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.257",
+        "bundleVersion": "2.0.260",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
+            "sha256": "bfe6ab1080a10b02abd9bb2c6438235b0f741524ebfa38d36f357a47e75a5a5b"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
+            "sha256": "cbd2957d78ab7ccb93292dfb53ca9f2bf9b5cdbb14515ac8a8b03cc33d7a1983"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.270",
+  "version": "0.1.273",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.263",
+  "bundleVersion": "2.0.266",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "55cbdd50d399a22529388527b087ba7f3abc808c2c3591eca2eee80abf3a010d"
+      "sha256": "c70753edc90c84360869c7c2d8e3b7431c6fc6486845e8dc6a114edcc6a222d9"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "c05b94f4374b482ecbd21f3f5e20c03fb9b293358f9a48956923b7d2acd9e691"
+      "sha256": "8a2b3ef99715282070a4b49ff375b67267e25aae17e1ba3657a2e27764bac033"
     }
   ]
 }

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.26.0`, then `@funnelsgrove/analytics` `0.8.0`, then `@funnelsgrove/payments` `0.31.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.270`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.28.0`, then `@funnelsgrove/analytics` `0.10.0`, then `@funnelsgrove/payments` `0.33.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.273`, 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.263",
+  "bundleVersion": "2.0.266",
   "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.263",
+  "bundleVersion": "2.0.266",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "55cbdd50d399a22529388527b087ba7f3abc808c2c3591eca2eee80abf3a010d"
+      "sha256": "c70753edc90c84360869c7c2d8e3b7431c6fc6486845e8dc6a114edcc6a222d9"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "c05b94f4374b482ecbd21f3f5e20c03fb9b293358f9a48956923b7d2acd9e691"
+      "sha256": "8a2b3ef99715282070a4b49ff375b67267e25aae17e1ba3657a2e27764bac033"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "af123f25e67c2564cc74de066629b614af1a4d18099f9374aaf2e1692333ef92",
+  "sourceTreeHash": "862969f38fff14ca83ac25dcdcc56e11826e6505467a68b834dfaf3b21785d83",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.263",
+  "docsBundleVersion": "2.0.266",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "3703effa85c5152534af2e11f67a050c288cfbbea7823f974b9b9be22dcd1bcd",
+      "sha256": "9c508e6966aea47bf370e81dbf033ec136f9d1185461bc529509f2b6fcbebcd0",
       "mode": "100644"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "55cbdd50d399a22529388527b087ba7f3abc808c2c3591eca2eee80abf3a010d",
+      "sha256": "c70753edc90c84360869c7c2d8e3b7431c6fc6486845e8dc6a114edcc6a222d9",
       "mode": "100644"
     },
     {
@@ -206,7 +206,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "c05b94f4374b482ecbd21f3f5e20c03fb9b293358f9a48956923b7d2acd9e691",
+      "sha256": "8a2b3ef99715282070a4b49ff375b67267e25aae17e1ba3657a2e27764bac033",
       "mode": "100644"
     },
     {

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.26.0`, then `@funnelsgrove/analytics` `0.8.0`, then `@funnelsgrove/payments` `0.31.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.270`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.28.0`, then `@funnelsgrove/analytics` `0.10.0`, then `@funnelsgrove/payments` `0.33.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.273`, 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.263",
+  "bundleVersion": "2.0.266",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",