@funnelsgrove/cli 0.1.139 → 0.1.142

package/README.md

@@ -107,5 +107,18 @@ fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 202
 `conversions` downloads the one-day conversion totals, primary conversion metrics, full funnel path rows, and step transitions. `funnel-path` focuses on the ordered path report. `transitions` focuses on step-by-step advanced/drop-off counts. `cohort` downloads synced marketing cohort economics for the day. If the requested day has no synced data, or cohort source data is incomplete, the CLI exits non-zero with a human-readable explanation.
 
 The package also keeps the longer `funnelsgrove` command as a compatibility alias.
+
+Edit profitability expenses through a local JSON file:
+
+```bash
+fgrove expenses pull --project claimbee --file expenses.json
+# edit expenses.json; omit id and updatedAt for new expenses
+fgrove expenses publish --project claimbee --file expenses.json
+```
+
+Publishing creates new rows and updates rows already present in the file. It never
+deletes remote expenses that are absent from the file, and it refuses to overwrite
+rows changed since the last pull. Pull again to resolve a concurrent edit.
+
 Use `--api-url` or `FUNNELSGROVE_API_URL` for non-production APIs.
 Use `--config` or `FUNNELSGROVE_CONFIG` to keep test credentials separate from the default `~/.funnelsgrove/config.json`.

package/dist/cli.js

@@ -15,6 +15,7 @@ import { buildCommittedSyncManifest, buildDownloadedSyncManifest, buildSourceCan
 import { mergeTextSourceWithGit } from './sourceRebase.js';
 import { executeExperimentCreate, formatExperimentCreateSuccess, recoverExperimentCreateTransaction, } from './experimentCreate.js';
 import { pullEnvFile } from './envSync.js';
+import { executeExpensePublish, executeExpensePull } from './expenseCommands.js';
 import { executeEmailPull, executeEmailPush, executeEmailSend, executeEmailUpdateVariables, executeEmailSequenceAddStep, executeEmailSequenceCancel, executeEmailSequenceCreate, executeEmailSequencePublish, executeEmailSequenceSetActive, executeEmailTemplatePublish, executeEmailValidate, parseEmailVariablesJson, } from './emailCommands.js';
 import { formatGitHubConnectRows, formatGitHubJobRows, formatGitHubStatusRows, } from './githubOutput.js';
 import { GitHubSyncTimeoutError, syncGitHubDraftIfConnected, } from './githubSyncFlow.js';
@@ -1957,6 +1958,42 @@ addExamples(projectsCommand
     const projects = await listProjects(token, workspaceId);
     printRows(projects, ['id', 'name', 'slug']);
 });
+const addExpenseScopeOptions = (command) => command
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--project <id-or-slug-or-name>', 'Project id, slug, or name')
+    .option('--file <path>', 'Expense JSON file', 'expenses.json');
+const resolveExpenseCommandScope = async (options) => {
+    const token = await readAuthToken();
+    const workspaceId = await resolveWorkspaceId(token, options.workspace);
+    const project = await resolveAnalyticsProject({ token, workspaceId, project: options.project });
+    return {
+        callApi,
+        token,
+        workspaceId,
+        projectId: project.id,
+        filePath: path.resolve(process.cwd(), options.file),
+    };
+};
+const expensesCommand = addExamples(program.command('expenses').description('Edit project profitability expenses'), [
+    'fgrove expenses pull --project claimbee',
+    'fgrove expenses publish --project claimbee',
+]);
+addExpenseScopeOptions(expensesCommand
+    .command('pull')
+    .description('Download profitability expenses to an editable JSON file'))
+    .action(async (options) => {
+    const scope = await resolveExpenseCommandScope(options);
+    const count = await executeExpensePull(scope);
+    console.log(`Pulled ${count} expense${count === 1 ? '' : 's'} to ${scope.filePath}.`);
+});
+addExpenseScopeOptions(expensesCommand
+    .command('publish')
+    .description('Create and update expenses from an edited JSON file'))
+    .action(async (options) => {
+    const scope = await resolveExpenseCommandScope(options);
+    const result = await executeExpensePublish(scope);
+    console.log(`Published expenses: ${result.created} created, ${result.updated} updated.`);
+});
 const funnelsCommand = addExamples(program.command('funnels').description('Manage funnels'), [
     'fgrove funnels list',
     'fgrove funnels clone --funnel claimbee --name claimbee-ios',

package/dist/expenseCommands.d.ts

@@ -0,0 +1,51 @@
+type CallApi = <T>(input: {
+    path: string;
+    type: 'query' | 'mutation';
+    data?: unknown;
+    token?: string | null;
+}) => Promise<T>;
+export type ExpenseApiRow = {
+    id: string;
+    project_id: string;
+    expense_date: string | null;
+    expense_month: string;
+    category: string;
+    vendor: string | null;
+    description: string | null;
+    amount_minor: number;
+    currency: string;
+    updated_at: string;
+};
+export type ExpenseFileItem = {
+    id?: string;
+    updatedAt?: string;
+    date: string;
+    category: string;
+    vendor: string | null;
+    description: string | null;
+    amount: string;
+    currency: string;
+};
+export type ExpenseFile = {
+    schemaVersion: 1;
+    projectId: string;
+    expenses: ExpenseFileItem[];
+};
+type ExpenseCommandScope = {
+    callApi: CallApi;
+    token: string;
+    workspaceId: string;
+    projectId: string;
+};
+export declare const amountToMinor: (amount: string) => number;
+export declare const parseExpenseFile: (contents: string, expectedProjectId: string) => ExpenseFile;
+export declare const executeExpensePull: (input: ExpenseCommandScope & {
+    filePath: string;
+}) => Promise<number>;
+export declare const executeExpensePublish: (input: ExpenseCommandScope & {
+    filePath: string;
+}) => Promise<{
+    created: number;
+    updated: number;
+}>;
+export {};

package/dist/expenseCommands.js

@@ -0,0 +1,183 @@
+import { readFile, writeFile } from 'node:fs/promises';
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const MONEY_PATTERN = /^(0|[1-9]\d*)(\.\d{1,2})?$/;
+const asObject = (value, label) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return value;
+};
+const requiredString = (value, label) => {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`${label} must be a non-empty string.`);
+    return value.trim();
+};
+const nullableString = (value, label) => {
+    if (value === null || value === undefined || value === '')
+        return null;
+    if (typeof value !== 'string')
+        throw new Error(`${label} must be a string or null.`);
+    return value.trim() || null;
+};
+export const amountToMinor = (amount) => {
+    if (!MONEY_PATTERN.test(amount))
+        throw new Error(`Invalid expense amount "${amount}". Use a non-negative value with at most two decimals.`);
+    const [whole, fraction = ''] = amount.split('.');
+    const minor = Number(whole) * 100 + Number(fraction.padEnd(2, '0'));
+    if (!Number.isSafeInteger(minor))
+        throw new Error(`Expense amount "${amount}" is too large.`);
+    return minor;
+};
+const formatAmount = (amountMinor) => {
+    const whole = Math.floor(amountMinor / 100);
+    return `${whole}.${String(amountMinor % 100).padStart(2, '0')}`;
+};
+const rowToFileItem = (row) => ({
+    id: row.id,
+    updatedAt: row.updated_at,
+    date: row.expense_date || row.expense_month,
+    category: row.category,
+    vendor: row.vendor,
+    description: row.description,
+    amount: formatAmount(row.amount_minor),
+    currency: row.currency,
+});
+export const parseExpenseFile = (contents, expectedProjectId) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        throw new Error('Expense file is not valid JSON.');
+    }
+    const root = asObject(parsed, 'Expense file');
+    if (root.schemaVersion !== 1)
+        throw new Error('Expense file schemaVersion must be 1.');
+    const projectId = requiredString(root.projectId, 'projectId');
+    if (projectId !== expectedProjectId) {
+        throw new Error(`Expense file belongs to project ${projectId}, not ${expectedProjectId}.`);
+    }
+    if (!Array.isArray(root.expenses))
+        throw new Error('expenses must be an array.');
+    const seenIds = new Set();
+    const expenses = root.expenses.map((value, index) => {
+        const label = `expenses[${index}]`;
+        const item = asObject(value, label);
+        const id = item.id === undefined ? undefined : requiredString(item.id, `${label}.id`);
+        if (id && !UUID_PATTERN.test(id))
+            throw new Error(`${label}.id must be a UUID.`);
+        if (id && seenIds.has(id))
+            throw new Error(`Duplicate expense id ${id}.`);
+        if (id)
+            seenIds.add(id);
+        const updatedAt = item.updatedAt === undefined
+            ? undefined
+            : requiredString(item.updatedAt, `${label}.updatedAt`);
+        if (id && !updatedAt)
+            throw new Error(`${label}.updatedAt is required when id is present.`);
+        if (!id && updatedAt)
+            throw new Error(`${label}.updatedAt is only valid when id is present.`);
+        const date = requiredString(item.date, `${label}.date`);
+        if (!DATE_PATTERN.test(date))
+            throw new Error(`${label}.date must use YYYY-MM-DD.`);
+        const category = requiredString(item.category, `${label}.category`);
+        if (category.length > 80)
+            throw new Error(`${label}.category must be at most 80 characters.`);
+        const vendor = nullableString(item.vendor, `${label}.vendor`);
+        if (vendor && vendor.length > 160)
+            throw new Error(`${label}.vendor must be at most 160 characters.`);
+        const description = nullableString(item.description, `${label}.description`);
+        if (description && description.length > 500)
+            throw new Error(`${label}.description must be at most 500 characters.`);
+        const amount = requiredString(item.amount, `${label}.amount`);
+        amountToMinor(amount);
+        const currency = requiredString(item.currency, `${label}.currency`).toUpperCase();
+        if (!/^[A-Z]{3}$/.test(currency))
+            throw new Error(`${label}.currency must be a three-letter code.`);
+        return { id, updatedAt, date, category, vendor, description, amount, currency };
+    });
+    return { schemaVersion: 1, projectId, expenses };
+};
+const listExpenses = async (scope) => {
+    const result = await scope.callApi({
+        path: 'projects.profitabilityExpenses',
+        type: 'query',
+        token: scope.token,
+        data: { workspaceId: scope.workspaceId, projectId: scope.projectId },
+    });
+    return result.expenses;
+};
+const serializeExpenseFile = (file) => `${JSON.stringify(file, null, 2)}\n`;
+export const executeExpensePull = async (input) => {
+    const expenses = await listExpenses(input);
+    await writeFile(input.filePath, serializeExpenseFile({
+        schemaVersion: 1,
+        projectId: input.projectId,
+        expenses: expenses.map(rowToFileItem),
+    }), 'utf8');
+    return expenses.length;
+};
+const writeInput = (scope, item) => ({
+    workspaceId: scope.workspaceId,
+    projectId: scope.projectId,
+    expenseDate: item.date,
+    expenseMonth: item.date.slice(0, 7),
+    category: item.category,
+    vendor: item.vendor,
+    description: item.description,
+    amountMinor: amountToMinor(item.amount),
+    currency: item.currency,
+});
+const matchesRemote = (item, row) => (item.date === (row.expense_date || row.expense_month)
+    && item.category === row.category
+    && item.vendor === row.vendor
+    && item.description === row.description
+    && amountToMinor(item.amount) === row.amount_minor
+    && item.currency === row.currency);
+export const executeExpensePublish = async (input) => {
+    const file = parseExpenseFile(await readFile(input.filePath, 'utf8'), input.projectId);
+    const remote = await listExpenses(input);
+    const remoteById = new Map(remote.map((expense) => [expense.id, expense]));
+    for (const item of file.expenses) {
+        if (!item.id)
+            continue;
+        const current = remoteById.get(item.id);
+        if (!current)
+            throw new Error(`Expense ${item.id} no longer exists. Pull expenses again before publishing.`);
+        if (current.updated_at !== item.updatedAt) {
+            throw new Error(`Expense ${item.id} changed remotely. Pull expenses again before publishing.`);
+        }
+    }
+    let created = 0;
+    let updated = 0;
+    const published = [...file.expenses];
+    for (const [index, item] of file.expenses.entries()) {
+        const current = item.id ? remoteById.get(item.id) : undefined;
+        if (current && matchesRemote(item, current)) {
+            published[index] = rowToFileItem(current);
+            continue;
+        }
+        const common = writeInput(input, item);
+        const row = item.id
+            ? await input.callApi({
+                path: 'projects.updateProfitabilityExpense',
+                type: 'mutation',
+                token: input.token,
+                data: { ...common, id: item.id, expectedUpdatedAt: item.updatedAt },
+            })
+            : await input.callApi({
+                path: 'projects.createProfitabilityExpense',
+                type: 'mutation',
+                token: input.token,
+                data: common,
+            });
+        if (item.id)
+            updated += 1;
+        else
+            created += 1;
+        published[index] = rowToFileItem(row);
+        await writeFile(input.filePath, serializeExpenseFile({ ...file, expenses: published }), 'utf8');
+    }
+    return { created, updated };
+};

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.139",
+      "repositoryCliVersion": "0.1.142",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.129",
+        "bundleVersion": "2.0.132",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "2a6ffbd2768cf73b049b4b067c003c81c2e3d3679fea6bf3f2865ddf419983f4"
+            "sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "adda37f1991ccbb5e7abf2b9f1465688c116e6604b08a3d63f104b295a93140b"
+            "sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.138",
+      "repositoryCliVersion": "0.1.141",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.128",
+        "bundleVersion": "2.0.131",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "ac3397d4724b3653080cb43f6b01bfc43e65da4acb867592974ef106d6833bcf"
+            "sha256": "015d013594cabb94c288bb39d7c717f531b68a1fe4754e6baefc0e08bbc5b872"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "793db126d3f299dfc98bd4dd715dfd5183d155557e32ec401491397364da5475"
+            "sha256": "7af952690a2b3c592ce6688b8524aa4c5fe111a0c798dc25106eb0d594c2452b"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.136",
+      "repositoryCliVersion": "0.1.140",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.126",
+        "bundleVersion": "2.0.130",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "6a7b8bea3fa6b4245307e96b51872fe04ab576c3a9161314f90c00cf6415465c"
+            "sha256": "9988e6f7b4ecf3f4a73ff83cf3f3613f82d765c59d09e55e86b0560d1e3eafa5"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "8b1218c5e5343b2c3e00079170da131aff33f5a808365700f8eab62dbf7433b9"
+            "sha256": "4e81bd56071fa38708c7f18488420038339c8cc984062ffd7e8a4930ab6b06f0"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.135",
+      "repositoryCliVersion": "0.1.139",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.125",
+        "bundleVersion": "2.0.129",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "c7a266bb4f6614daa2a1adcfb3248f99330a8d4184866a4611268b93a4352203"
+            "sha256": "2a6ffbd2768cf73b049b4b067c003c81c2e3d3679fea6bf3f2865ddf419983f4"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "ad9e79fd0ee9d6478567615d78e34efa272fc6a1c5f8016cd1aae64ba3e24679"
+            "sha256": "adda37f1991ccbb5e7abf2b9f1465688c116e6604b08a3d63f104b295a93140b"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.132",
+      "repositoryCliVersion": "0.1.138",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.122",
+        "bundleVersion": "2.0.128",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "46f46756190a6085c562b9ceb2fd4a0eac961ea4f985f85a1f6e715827e171a6"
+            "sha256": "ac3397d4724b3653080cb43f6b01bfc43e65da4acb867592974ef106d6833bcf"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "01ad9b12769dd8894b2aaeea0bf21e7b622c3e4ee4612987acdcb2ec5bf93d6f"
+            "sha256": "793db126d3f299dfc98bd4dd715dfd5183d155557e32ec401491397364da5475"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.131",
+      "repositoryCliVersion": "0.1.136",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.121",
+        "bundleVersion": "2.0.126",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "1a8d1f9bf73b24fc07d26b56fa4185fdc9183a45bcf98b9b1996d8e27792bd1e"
+            "sha256": "6a7b8bea3fa6b4245307e96b51872fe04ab576c3a9161314f90c00cf6415465c"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "de523557a1057d95aaaf9a535b518fb4d8ca6bd99eaafdd57aab56db17c7cf1e"
+            "sha256": "8b1218c5e5343b2c3e00079170da131aff33f5a808365700f8eab62dbf7433b9"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.130",
+      "repositoryCliVersion": "0.1.135",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.120",
+        "bundleVersion": "2.0.125",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "875b31938089b6c1542a3210c198e5ff8441d7f1c1b9c462fb9b7539a9b5914f"
+            "sha256": "c7a266bb4f6614daa2a1adcfb3248f99330a8d4184866a4611268b93a4352203"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "af6994cd686529a6ec4d1c52020a729196bd6d7722f404ea4d35e8fd1e187467"
+            "sha256": "ad9e79fd0ee9d6478567615d78e34efa272fc6a1c5f8016cd1aae64ba3e24679"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.139",
+  "version": "0.1.142",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,12 +34,12 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.7.26",
+    "@funnelsgrove/runtime": "0.7.27",
     "commander": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.1.75",
+    "@funnelsgrove/analytics": "0.1.76",
     "@funnelsgrove/payments": "0.7.19",
     "vitest": "^3.0.0"
   }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.129",
+  "bundleVersion": "2.0.132",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "2a6ffbd2768cf73b049b4b067c003c81c2e3d3679fea6bf3f2865ddf419983f4"
+      "sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "adda37f1991ccbb5e7abf2b9f1465688c116e6604b08a3d63f104b295a93140b"
+      "sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e"
     }
   ]
 }

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.7.26` first, then `@funnelsgrove/analytics` `0.1.75`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.139`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.7.27` first, then `@funnelsgrove/analytics` `0.1.76`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.142`, 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.129",
+  "bundleVersion": "2.0.132",
   "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.129",
+  "bundleVersion": "2.0.132",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "2a6ffbd2768cf73b049b4b067c003c81c2e3d3679fea6bf3f2865ddf419983f4"
+      "sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "adda37f1991ccbb5e7abf2b9f1465688c116e6604b08a3d63f104b295a93140b"
+      "sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "1a0c798df5c5dead5025036f207f2b08a007662721a51530d73f2583face8fa9",
+  "sourceTreeHash": "17a2b4d922e272fe5b1097d38e22604cb9ea2418e9428c658c5c83f4ba095fd5",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.129",
+  "docsBundleVersion": "2.0.132",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "4787e89c601c86fa74bbd5f28cfab16686c90ef58cdffe750847c3d1b7baafdd",
+      "sha256": "a651235159c3d3aba55878722394461a4e0b25da1e084841a3686b82bd59f71f",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "2a6ffbd2768cf73b049b4b067c003c81c2e3d3679fea6bf3f2865ddf419983f4",
+      "sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "adda37f1991ccbb5e7abf2b9f1465688c116e6604b08a3d63f104b295a93140b",
+      "sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e",
       "mode": "100644"
     },
     {
@@ -256,17 +256,17 @@
     },
     {
       "path": "next.config.ts",
-      "sha256": "cd5ff10c989cf4ae5d54b78638843d56e32e3999f2334cb0cbc9277aae68356c",
+      "sha256": "9d2213c2270579568fa5ae409d5173594c08048bcaf91350b4d946293022ce74",
       "mode": "100644"
     },
     {
       "path": "package-lock.json",
-      "sha256": "09e020ec8442cb7a0a87a1ffddec86d6caee3a54b494ed844407007063ff68a2",
+      "sha256": "8f60d0578889cf9433a5b383f9d243da0f36b22b50bc76354d44c35adf2eba56",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "a965a1abeef3d228a57be9f89275144d9530cafec0d85351cf541fdcc5b8d1ac",
+      "sha256": "931094eb8a5eb373bb956422ec4ba0d50abb25c4525867b22bad6b64ef034318",
       "mode": "100644"
     },
     {

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.7.26` first, then `@funnelsgrove/analytics` `0.1.75`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.139`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.7.27` first, then `@funnelsgrove/analytics` `0.1.76`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.142`, 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.129",
+  "bundleVersion": "2.0.132",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/next.config.ts

@@ -3,6 +3,7 @@ import path from 'node:path';
 import type { NextConfig } from 'next';
 
 const isStaticExportBuild = process.env.NEXT_EXPORT === '1';
+const runtimeConfigOrigin = process.env.FUNNEL_RUNTIME_CONFIG_ORIGIN?.trim().replace(/\/+$/, '') || '';
 
 // Inside the funnelsgrove monorepo, alias @funnelsgrove/* to the package
 // sources so changes there rebuild live. Standalone copies (funnels created
@@ -31,6 +32,12 @@ const nextConfig: NextConfig = {
     ? { output: 'export' as const }
     : {
         rewrites: async () => [
+          ...(runtimeConfigOrigin
+            ? [{
+                source: '/api/funnel-config/:path*',
+                destination: `${runtimeConfigOrigin}/api/funnel-config/:path*`,
+              }]
+            : []),
           {
             source: '/ingest/static/:path*',
             destination: 'https://us-assets.i.posthog.com/static/:path*',

package/template_scaffold/package-lock.json

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.75",
+        "@funnelsgrove/analytics": "^0.1.76",
         "@funnelsgrove/payments": "^0.7.19",
-        "@funnelsgrove/runtime": "^0.7.26",
+        "@funnelsgrove/runtime": "^0.7.27",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -938,11 +938,11 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.1.75",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.75.tgz",
-      "integrity": "sha512-q7hOSmSuyHQEN/95MBcgjAwWqewUTUlbH3BgaSaYBPabGZyZxMC3Zopmyva/OieXmQ0f3J8JQlpxhdEB7ssftA==",
+      "version": "0.1.76",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.76.tgz",
+      "integrity": "sha512-5Zf0zxZ4GXRpwfHTAcJX1sk07tiFrfC7TVB1dZueyNosFcKl6+o9omVE5/euoJ0uJsblPGTzJDW8+wdyK2MbzA==",
       "dependencies": {
-        "@funnelsgrove/runtime": "0.7.26"
+        "@funnelsgrove/runtime": "0.7.27"
       }
     },
     "node_modules/@funnelsgrove/payments": {
@@ -961,9 +961,9 @@
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.7.26",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.26.tgz",
-      "integrity": "sha512-PbdmEC23bJpGo/dRNhhHTbp2y8a/IZ3Ggs3746UwZQOxxzV9ImkNVeWQl0zlmnGvBLWGOWcpTW48nuneR0uwuw==",
+      "version": "0.7.27",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.27.tgz",
+      "integrity": "sha512-FiVI6rmV8BhtRowV46Cm4bqgr2UvYUCI/yyW41lhiYYcnolVxNYyaO++j8FlkqXn99JvPPauSHC6dtLvmojeEg==",
       "dependencies": {
         "posthog-js": "^1.369.2",
         "react": "19.2.3",

package/template_scaffold/package.json

@@ -12,9 +12,9 @@
     "validate:funnel": "vite-node --config src/contract/funnel-validator.vite.config.ts src/contract/validate-funnel.cli.ts"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "^0.1.75",
+    "@funnelsgrove/analytics": "^0.1.76",
     "@funnelsgrove/payments": "^0.7.19",
-    "@funnelsgrove/runtime": "^0.7.26",
+    "@funnelsgrove/runtime": "^0.7.27",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",