@funnelsgrove/cli 0.1.268 → 0.1.269

package/README.md

@@ -18,6 +18,38 @@ Use `fgrove update --dry-run` to inspect the installations first. The updater
 runs each installation's sibling `npm`, so duplicate global installs cannot
 silently remain on different CLI versions.
 
+Create a new hosted funnel from one of three starter templates:
+
+```bash
+fgrove whoami
+fgrove projects list
+fgrove templates list
+fgrove templates show one-page-v2
+fgrove funnels create --project fitness --template one-page-v2 --name FitBee --idempotency-key <creation-key> --json
+fgrove sync down --funnel <returned-funnel-id> --dir ./fitbee
+```
+
+Template cards include descriptions, suitable journeys, included screens and a
+create command. `--json` works for both list and show. Discovery reads the
+offered official catalog through the connected account, preserving its names,
+keys and pinned demo/source versions; inspect the demo for the current journey.
+Hosted creation requires an existing project; pass `--workspace`
+when selecting a different workspace. Template slugs match the app: `default`,
+`one-page`, and `one-page-v2`.
+
+`funnels create` uses the same API setup workflow as the app. It waits for a
+downloadable draft, while the automatic initial preview builds separately.
+`--timeout` defaults to 120 seconds. Progress and recovery identity go to stderr;
+stdout contains a tab-separated creation row, or one result object with `--json`.
+Retain the creation key and reuse it if the request outcome is uncertain. A
+wait timeout does not cancel or delete the hosted funnel. Download the returned
+ID with `sync down`; `funnels clone` instead copies an existing funnel.
+
+After downloading, establish the product/audience/offer/brand brief and root
+`Design.md` before customization. The Fstack `create-funnel` skill owns that
+intake workflow; starter artwork, proof and legal/offer copy need adaptation.
+The starter preview includes later local changes only after sync and publish.
+
 Sync a funnel into its own local folder:
 
 ```bash

package/dist/cli.js

@@ -23,6 +23,8 @@ import { executeEmailPull, executeEmailPush, executeEmailSend, executeEmailUpdat
 import { formatGitHubConnectRows, formatGitHubJobRows, formatGitHubStatusRows, } from './githubOutput.js';
 import { GitHubSyncTimeoutError, syncGitHubDraftIfConnected, } from './githubSyncFlow.js';
 import { reskinFunnel } from './reskin.js';
+import { describeFunnelTemplate, renderFunnelTemplate } from './funnelTemplates.js';
+import { createHostedFunnel } from './funnelCreation.js';
 import { TEMPLATE_DOCS_DIR } from './templateDocs.js';
 import { renderDocsHuman, renderDocsJson, } from './docsOutput.js';
 import { applyTemplateDocsUpdate, inspectTemplateDocs, loadBundledDocs, planTemplateDocsUpdate, recoverTemplateDocs, resolveTemplateDocsConflict, } from './docsTransaction.js';
@@ -2055,6 +2057,38 @@ addExpenseScopeOptions(expensesCommand
     const result = await executeExpensePublish(scope);
     console.log(`Published expenses: ${result.created} created, ${result.updated} updated.`);
 });
+const loadFunnelTemplateCards = async (workspace) => {
+    const token = await readAuthToken();
+    const workspaceId = await resolveWorkspaceId(token, workspace);
+    const templates = await callApi({
+        path: 'projects.listFunnelTemplates', type: 'query', token, data: { workspaceId },
+    });
+    return { token, workspaceId, templates: templates.map((template) => describeFunnelTemplate(template, workspaceId)) };
+};
+const templatesCommand = program.command('templates').description('Browse offered funnel templates from your connected account');
+templatesCommand.command('list')
+    .description('List available funnel templates with descriptions and create commands')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--json', 'Emit machine-readable template cards')
+    .action(async (options) => {
+    const { templates } = await loadFunnelTemplateCards(options.workspace);
+    process.stdout.write(options.json
+        ? `${JSON.stringify(templates)}\n`
+        : templates.length ? `${templates.map(renderFunnelTemplate).join('\n\n')}\n` : 'No funnel templates are currently offered.\n');
+});
+templatesCommand.command('show <slug>')
+    .description('Describe an offered template and how to create it')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--json', 'Emit a machine-readable template card')
+    .action(async (slug, options) => {
+    const { templates } = await loadFunnelTemplateCards(options.workspace);
+    const template = templates.find((item) => item.slug === slug);
+    if (!template)
+        throw new Error(`Funnel template "${slug}" is not available. Run fgrove templates list.`);
+    process.stdout.write(options.json
+        ? `${JSON.stringify(template)}\n`
+        : `${renderFunnelTemplate(template)}\n`);
+});
 const funnelsCommand = addExamples(program.command('funnels').description('Manage funnels'), [
     'fgrove funnels list',
     'fgrove funnels clone --funnel claimbee --name claimbee-ios',
@@ -2072,6 +2106,44 @@ addExamples(funnelsCommand
     const funnels = await listFunnels(token, workspaceId);
     printRows(funnels, ['id', 'name', 'slug']);
 });
+addExamples(funnelsCommand
+    .command('create')
+    .description('Create a hosted funnel from a template and wait for downloadable source')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .requiredOption('--project <id-or-slug-or-name>', 'Existing project id, slug, or name')
+    .requiredOption('--template <slug>', 'Template from fgrove templates list')
+    .requiredOption('--name <name>', 'New funnel name')
+    .option('--idempotency-key <key>', 'Reuse this key when retrying the same creation')
+    .option('--timeout <seconds>', 'Maximum wait for draft source (preview continues separately)', '120')
+    .option('--json', 'Emit one machine-readable creation result'), ['fgrove funnels create --project fitness --template default --name FitBee --json'])
+    .action(async (options) => {
+    const name = options.name.trim();
+    if (!/^[a-z0-9][a-z0-9-]{0,119}$/.test(options.template)) {
+        throw new Error('--template must be a catalog key from fgrove templates list.');
+    }
+    const timeout = Number(options.timeout);
+    const idempotencyKey = options.idempotencyKey ?? randomUUID();
+    if (name.length < 2 || name.length > 120)
+        throw new Error('Funnel name must contain 2 to 120 characters.');
+    if (!Number.isFinite(timeout) || timeout < 1 || timeout > 1800) {
+        throw new Error('--timeout must be between 1 and 1800 seconds.');
+    }
+    if (!idempotencyKey.trim() || idempotencyKey !== idempotencyKey.trim() || idempotencyKey.length > 200) {
+        throw new Error('--idempotency-key must contain 1 to 200 characters with no surrounding whitespace.');
+    }
+    const token = await readAuthToken();
+    const workspaceId = await resolveWorkspaceId(token, options.workspace);
+    const project = await resolveProject(token, workspaceId, options.project);
+    const result = await createHostedFunnel({
+        callApi, token, workspaceId, projectId: project.id, template: options.template,
+        name, idempotencyKey, timeoutMs: timeout * 1000,
+        progress: (message) => process.stderr.write(`${message}\n`),
+    });
+    process.stdout.write(options.json
+        ? `${JSON.stringify(result)}\n`
+        : `${result.funnelId}\t${result.name}\t${result.slug}\t${result.template}\t${result.draftVersionId}\n`);
+    process.stderr.write(`Download: fgrove sync down --workspace ${workspaceId} --funnel ${result.funnelId} --dir <new-folder>\n`);
+});
 addExamples(funnelsCommand
     .command('clone')
     .description('Copy an existing funnel')

package/dist/funnelCreation.d.ts

@@ -0,0 +1,28 @@
+type ApiCaller = <T>(input: {
+    path: string;
+    type: 'query' | 'mutation';
+    data?: unknown;
+    token?: string | null;
+}) => Promise<T>;
+export declare const createHostedFunnel: (input: {
+    callApi: ApiCaller;
+    token: string;
+    workspaceId: string;
+    projectId: string;
+    template: string;
+    name: string;
+    idempotencyKey: string;
+    timeoutMs: number;
+    progress: (message: string) => void;
+}) => Promise<{
+    workspaceId: string;
+    projectId: string;
+    funnelId: string;
+    name: string;
+    slug: string;
+    template: string;
+    draftVersionId: string;
+    setupStatus: string;
+    idempotencyKey: string;
+}>;
+export {};

package/dist/funnelCreation.js

@@ -0,0 +1,28 @@
+export const createHostedFunnel = async (input) => {
+    const { workspaceId, projectId, template, name, idempotencyKey } = input;
+    input.progress(`Creating ${template} in project ${projectId}; initial preview builds automatically. Creation key: ${idempotencyKey}`);
+    const created = await input.callApi({
+        path: 'projects.createFunnel', type: 'mutation', token: input.token,
+        data: { workspaceId, projectId, template, name, idempotencyKey },
+    });
+    let funnel = created.funnel;
+    input.progress(`Funnel ${funnel.id} created. Waiting for downloadable source; preview may continue building.`);
+    const deadline = Date.now() + input.timeoutMs;
+    while (!funnel.draft_version_id) {
+        if (funnel.setup_status === 'failed') {
+            throw new Error(`Funnel ${funnel.id} setup failed: ${funnel.setup_error || 'Unknown setup error'}. Keep creation key ${idempotencyKey}; inspect this funnel in FunnelsGrove before retrying.`);
+        }
+        if (Date.now() >= deadline) {
+            throw new Error(`Funnel ${funnel.id} exists, but source is still being prepared. Retry creation with the same --idempotency-key ${idempotencyKey}, or download it later with fgrove sync down --workspace ${workspaceId} --funnel ${funnel.id} --dir <new-folder>.`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1_000));
+        ({ funnel } = await input.callApi({
+            path: 'funnels.detail', type: 'query', token: input.token,
+            data: { workspaceId, funnelId: funnel.id },
+        }));
+    }
+    return {
+        workspaceId, projectId, funnelId: funnel.id, name: funnel.name, slug: funnel.slug,
+        template, draftVersionId: funnel.draft_version_id, setupStatus: funnel.setup_status, idempotencyKey,
+    };
+};

package/dist/funnelTemplates.d.ts

@@ -0,0 +1,17 @@
+export type CatalogFunnelTemplate = {
+    key: string;
+    displayName: string;
+    sourceVersionId: string;
+    demoPath: string;
+};
+export declare const describeFunnelTemplate: (template: CatalogFunnelTemplate, workspaceId: string) => {
+    sourceVersionId: string;
+    demoPath: string;
+    createCommand: string;
+    description: string;
+    bestFor: string;
+    includes: string[];
+    slug: string;
+    name: string;
+};
+export declare const renderFunnelTemplate: (template: ReturnType<typeof describeFunnelTemplate>) => string;

package/dist/funnelTemplates.js

@@ -0,0 +1,38 @@
+const TEMPLATE_DESCRIPTIONS = {
+    default: {
+        description: 'A guided quiz-to-paywall journey with encouragement screens, answer-derived plan preparation and email capture.',
+        bestFor: 'A personalized onboarding journey; the initial catalog example is Gavus Dogs Training.',
+        includes: ['Quiz', 'Encouragement bridges', 'Plan preparation', 'Email capture', 'Long-form paywall'],
+    },
+    'one-page': {
+        description: 'An app-store-style single-page offer with checkout and subscription handoff.',
+        bestFor: 'Visitors who already understand the product and need a concise path to purchase.',
+        includes: ['Single-page offer', 'Checkout', 'Subscription handoff', 'Subscription management'],
+    },
+    'one-page-v2': {
+        description: 'A long-form single-page offer with a sticky app header, feature imagery, FAQ and wallet/card entry.',
+        bestFor: 'A visual product story that needs more explanation and proof before checkout.',
+        includes: ['Long-form offer', 'Feature carousel', 'FAQ', 'Wallet and card entry', 'Subscription management'],
+    },
+};
+export const describeFunnelTemplate = (template, workspaceId) => ({
+    slug: template.key,
+    name: template.displayName,
+    ...(TEMPLATE_DESCRIPTIONS[template.key] ?? {
+        description: `Published ${template.displayName} starter. Inspect its pinned demo before choosing this journey.`,
+        bestFor: 'A product whose journey matches the published template demo.',
+        includes: ['Published template source; inspect the demo for its exact screens'],
+    }),
+    sourceVersionId: template.sourceVersionId,
+    demoPath: template.demoPath,
+    createCommand: `fgrove funnels create --workspace ${workspaceId} --project <project> --template ${template.key} --name <name>`,
+});
+export const renderFunnelTemplate = (template) => [
+    `${template.name} (${template.slug})`,
+    `  ${template.description}`,
+    `  Best for: ${template.bestFor}`,
+    `  Includes: ${template.includes.join(', ')}`,
+    `  Demo: ${template.demoPath} (source version ${template.sourceVersionId})`,
+    '  Inspect the current demo; starter copy, artwork and offer terms need adaptation to your product.',
+    `  Create: ${template.createCommand}`,
+].join('\n');

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.268",
+      "repositoryCliVersion": "0.1.269",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.261",
+        "bundleVersion": "2.0.262",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
+            "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
+            "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.267",
+      "repositoryCliVersion": "0.1.268",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.260",
+        "bundleVersion": "2.0.261",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bfe6ab1080a10b02abd9bb2c6438235b0f741524ebfa38d36f357a47e75a5a5b"
+            "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "cbd2957d78ab7ccb93292dfb53ca9f2bf9b5cdbb14515ac8a8b03cc33d7a1983"
+            "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.266",
+      "repositoryCliVersion": "0.1.267",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.259",
+        "bundleVersion": "2.0.260",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "a73414cd33b42bef5cf55b9d007485751bf84412dc690b2c7dd883e6c7b127f1"
+            "sha256": "bfe6ab1080a10b02abd9bb2c6438235b0f741524ebfa38d36f357a47e75a5a5b"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "8f841dfc3f38d4e3d911aaf74d1911b9e36e1d653594fcf3e4188dbdb45ae82b"
+            "sha256": "cbd2957d78ab7ccb93292dfb53ca9f2bf9b5cdbb14515ac8a8b03cc33d7a1983"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.265",
+      "repositoryCliVersion": "0.1.266",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.258",
+        "bundleVersion": "2.0.259",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "e529cbfc0ab172d5168301efcb09e2f7ed7459d3c8c7f27db9198b4ccce069ba"
+            "sha256": "a73414cd33b42bef5cf55b9d007485751bf84412dc690b2c7dd883e6c7b127f1"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "4cc4c05d6f0048162c5fc0a534050e11a8c14585783a7fae61a98462e880cc65"
+            "sha256": "8f841dfc3f38d4e3d911aaf74d1911b9e36e1d653594fcf3e4188dbdb45ae82b"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.264",
+      "repositoryCliVersion": "0.1.265",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.257",
+        "bundleVersion": "2.0.258",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
+            "sha256": "e529cbfc0ab172d5168301efcb09e2f7ed7459d3c8c7f27db9198b4ccce069ba"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
+            "sha256": "4cc4c05d6f0048162c5fc0a534050e11a8c14585783a7fae61a98462e880cc65"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.263",
+      "repositoryCliVersion": "0.1.264",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.256",
+        "bundleVersion": "2.0.257",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "afba67a5679827efbd37d706d290e393558d4abf13271b5606e069b1694960e8"
+            "sha256": "a299775572c2aac26afb8905d770417e1dd2f5a0ff1026d5212ba080ef1d5e82"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "ac03af2c7446ffefd0acd9e28db1c4d6fa7a04848b1c2a562a3e722d16f9a98a"
+            "sha256": "693f0649aedbb45a62b88661d482cbafeb01eb3fdb5279b473732b1a0c83e8ac"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.262",
+      "repositoryCliVersion": "0.1.263",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.255",
+        "bundleVersion": "2.0.256",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "d733607091b48f87b667e43c68984116b4f5c82cdc5ca04af688ccc7160c0e36"
+            "sha256": "afba67a5679827efbd37d706d290e393558d4abf13271b5606e069b1694960e8"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "3bb975a7ced201ae60030e863b150e51fc8b5d496e0d0fb93fc92c48953e0c39"
+            "sha256": "ac03af2c7446ffefd0acd9e28db1c4d6fa7a04848b1c2a562a3e722d16f9a98a"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.268",
+  "version": "0.1.269",
   "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.261",
+  "bundleVersion": "2.0.262",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
+      "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
+      "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1"
     }
   ]
 }

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.30.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.268`, 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.26.0`, then `@funnelsgrove/analytics` `0.8.0`, then `@funnelsgrove/payments` `0.30.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.269`, 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.261",
+  "bundleVersion": "2.0.262",
   "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.261",
+  "bundleVersion": "2.0.262",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435"
+      "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de"
+      "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "e025e7e02f36b34bdbb7a7ba5c694f057a885769842ec2183163304ed0b6a7c8",
+  "sourceTreeHash": "af198058c64590b2cbc184136fe75ce91ab6adc330cdd233374b3a579596766a",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.261",
+  "docsBundleVersion": "2.0.262",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "175da617d78d007c8faecf9ed92ecaba3242ff3a6aaa20a8e7fd2357a282b648",
+      "sha256": "0eb8888e99f00f1d744be0972ae94edd22c4c7d5397e0914c052c39665541a04",
       "mode": "100644"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "bdb3f01b62ddce29fe8cf51fb4b8a9466d9d8a22768aa09ef11d17f0cf410435",
+      "sha256": "6065bf89f8f09486ae0a83654dc061b57d326dc5e94e3d5f91e9429d47bae702",
       "mode": "100644"
     },
     {
@@ -206,7 +206,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "9ff3b21173e861067ffe9ec0e594d3be6b57c5245f2f1a389c679a6c327fc7de",
+      "sha256": "e4e115c55bd9cc2ffe2ed097bdc10876eb931012730189933c422245b22f80b1",
       "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.30.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.268`, 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.26.0`, then `@funnelsgrove/analytics` `0.8.0`, then `@funnelsgrove/payments` `0.30.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.269`, 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.261",
+  "bundleVersion": "2.0.262",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",