@funnelsgrove/cli 0.1.53 → 0.1.62

package/dist/cli.d.ts

@@ -267,7 +267,7 @@ export declare const formatOfferSetSyncSuccess: (input: {
     offerSetLabel: string;
     generatedFileCount: number;
 }) => string[];
-type ExperimentLifecycleAction = 'start' | 'stop' | 'restart';
+type ExperimentLifecycleAction = 'start' | 'stop' | 'restart' | 'end';
 type ExperimentLifecycleResult = {
     id: string;
     funnel_id: string;

package/dist/cli.js

@@ -1048,7 +1048,7 @@ const GENERATED_CONFIG_PATH_BY_KIND = {
     offerSets: 'src/config/offer-sets.generated.ts',
     experiments: 'src/config/experiments.generated.ts',
 };
-export const SYNC_DOWN_GENERATED_CONFIG_KINDS = ['offerSets', 'experiments'];
+export const SYNC_DOWN_GENERATED_CONFIG_KINDS = ['offerSets'];
 export const EXPERIMENT_TRANSACTION_RECOVERY_COMMANDS = [
     'sync down',
     'sync up',
@@ -1508,7 +1508,13 @@ export const formatExperimentLifecycleSuccess = (action, result, json) => {
     if (json) {
         return `${JSON.stringify(payload)}\n`;
     }
-    const verb = action === 'stop' ? 'Stopped' : action === 'restart' ? 'Restarted' : 'Started';
+    const verb = action === 'stop'
+        ? 'Stopped'
+        : action === 'restart'
+            ? 'Restarted'
+            : action === 'end'
+                ? 'Ended'
+                : 'Started';
     return `${verb} experiment ${result.name?.trim() || result.id} (${result.status})\n`;
 };
 /**
@@ -1809,6 +1815,22 @@ const registerExperimentLifecycleCommand = (action, description) => {
 registerExperimentLifecycleCommand('start', 'Start a draft or stopped experiment');
 registerExperimentLifecycleCommand('stop', 'Stop traffic without ending the experiment');
 registerExperimentLifecycleCommand('restart', 'Stop and start an experiment, preserving its variants');
+registerExperimentLifecycleCommand('end', 'Permanently end and archive an experiment');
+addExamples(experimentsCommand
+    .command('delete <id>')
+    .description('Delete a draft experiment')
+    .option('--json', 'Emit one machine-readable success object'), ['fgrove experiments delete 22222222-2222-4222-8222-222222222222'])
+    .action(async (id, options) => {
+    await callApi({
+        path: 'funnelExperiments.delete',
+        type: 'mutation',
+        token: await readAuthToken(),
+        data: { id },
+    });
+    process.stdout.write(options.json === true
+        ? `${JSON.stringify({ experimentId: id, deleted: true })}\n`
+        : `Deleted experiment ${id}\n`);
+});
 addExamples(experimentsCommand
     .command('sync')
     .description('Write generated experiment config for a funnel')

package/dist/experimentCreate.d.ts

@@ -11,7 +11,7 @@ export type AgentExperimentVariant = {
     isControl: boolean;
 };
 export type AgentPricingExperimentVariant = AgentExperimentVariant & {
-    offerSetKey: string;
+    offerSetId: string;
 };
 type SharedAgentExperimentSpec = {
     id: string;
@@ -47,7 +47,7 @@ export type ExperimentCreateResponse = {
         is_control: boolean;
     }>;
     draftVersionId: string;
-    generatedFiles: [GeneratedExperimentFile, GeneratedExperimentFile];
+    generatedFiles: [];
     githubConnected: boolean;
 };
 export declare class ExperimentCreateContractError extends Error {
@@ -81,19 +81,14 @@ export type ExperimentCreateSuccess = {
     experimentId: string;
     experimentKey: string;
     draftVersionId: string;
-    writtenPaths: [...typeof EXPERIMENT_GENERATED_PATHS];
+    writtenPaths: [];
     githubConnected: boolean;
 };
 type ExecuteExperimentCreateDependencies = {
     recover: typeof recoverExperimentCreateTransaction;
     readManifest: typeof readSyncManifest;
     readSpec: typeof readAgentExperimentSpec;
-    assertGeneratedFilesUnchanged: typeof assertGeneratedExperimentFilesUnchanged;
     parseResponse: typeof parseExperimentCreateResponse;
-    install: (sourceDir: string, input: {
-        generatedFiles: unknown;
-        manifest: SyncManifest;
-    }) => Promise<void>;
 };
 export declare function executeExperimentCreate(input: ExecuteExperimentCreateInput, dependencyOverrides?: Partial<ExecuteExperimentCreateDependencies>): Promise<ExperimentCreateSuccess>;
 export declare function formatExperimentCreateSuccess(result: ExperimentCreateSuccess, json: boolean): string;

package/dist/experimentCreate.js

@@ -11,6 +11,7 @@ export const EXPERIMENT_GENERATED_PATHS = [
 ];
 const EXPERIMENT_GENERATED_CONTENT_TYPE = 'text/typescript';
 const LOWERCASE_SHA256 = /^[a-f0-9]{64}$/;
+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 EXPERIMENT_METRICS = [
     'step_completion',
     'next_step_reached',
@@ -54,6 +55,13 @@ const requireString = (value, fieldPath, maxLength) => {
     }
     return trimmed;
 };
+const requireUuid = (value, fieldPath) => {
+    const parsed = requireString(value, fieldPath, 36);
+    if (!UUID_PATTERN.test(parsed)) {
+        fail(fieldPath, 'must be a UUID');
+    }
+    return parsed;
+};
 const requireBoolean = (value, fieldPath) => {
     if (typeof value !== 'boolean') {
         fail(fieldPath, 'must be a boolean');
@@ -95,7 +103,7 @@ const parseVariant = (value, index, type) => {
         'routeToStepId',
         'trafficPercent',
         'isControl',
-        ...(type === 'pricing' ? ['offerSetKey'] : []),
+        ...(type === 'pricing' ? ['offerSetId'] : []),
     ];
     assertExactKeys(record, keys, fieldPath);
     const shared = {
@@ -110,7 +118,7 @@ const parseVariant = (value, index, type) => {
     }
     return {
         ...shared,
-        offerSetKey: requireString(record.offerSetKey, `${fieldPath}.offerSetKey`, 200),
+        offerSetId: requireUuid(record.offerSetId, `${fieldPath}.offerSetId`),
     };
 };
 export function parseAgentExperimentSpec(value) {
@@ -257,7 +265,7 @@ const expectedConversionConfig = (spec) => (spec.type === 'pricing'
         source: 'agent',
         type: 'pricing',
         paywallStepId: spec.stepId,
-        offerSetKeys: spec.variants.map((variant) => variant.offerSetKey),
+        offerSetIds: spec.variants.map((variant) => variant.offerSetId),
     }
     : {
         source: 'agent',
@@ -343,13 +351,15 @@ export function parseExperimentCreateResponse(value, requestedSpec, expectedFunn
         fail('variants', 'must contain unique persisted variant ids');
     }
     const draftVersionId = requireString(response.draftVersionId, 'draftVersionId');
-    const generatedFiles = parseGeneratedExperimentFiles(response.generatedFiles);
+    if (!Array.isArray(response.generatedFiles) || response.generatedFiles.length !== 0) {
+        fail('generatedFiles', 'must be empty because experiments are runtime artifacts');
+    }
     const githubConnected = requireBoolean(response.githubConnected, 'githubConnected');
     return {
         experiment: experiment,
         variants,
         draftVersionId,
-        generatedFiles,
+        generatedFiles: [],
         githubConnected,
     };
 }
@@ -830,9 +840,7 @@ const executeExperimentCreateDependencies = {
     recover: recoverExperimentCreateTransaction,
     readManifest: readSyncManifest,
     readSpec: readAgentExperimentSpec,
-    assertGeneratedFilesUnchanged: assertGeneratedExperimentFilesUnchanged,
     parseResponse: parseExperimentCreateResponse,
-    install: installExperimentCreateTransaction,
 };
 export async function executeExperimentCreate(input, dependencyOverrides = {}) {
     const dependencies = { ...executeExperimentCreateDependencies, ...dependencyOverrides };
@@ -842,7 +850,6 @@ export async function executeExperimentCreate(input, dependencyOverrides = {}) {
         throw new Error(`No ${SYNC_MANIFEST_FILE} found. Run \`fgrove sync down --dir ${input.sourceDir}\` first.`);
     }
     const spec = await dependencies.readSpec(input.specPath);
-    await dependencies.assertGeneratedFilesUnchanged(input.sourceDir, manifest);
     const rawResponse = await input.createFromSpec({
         workspaceId: manifest.workspaceId,
         funnelId: manifest.funnelId,
@@ -850,17 +857,11 @@ export async function executeExperimentCreate(input, dependencyOverrides = {}) {
         spec,
     });
     const response = dependencies.parseResponse(rawResponse, spec, manifest.funnelId);
-    await dependencies.assertGeneratedFilesUnchanged(input.sourceDir, manifest);
-    const nextManifest = buildExperimentCreateManifest(manifest, response.draftVersionId, response.generatedFiles);
-    await dependencies.install(input.sourceDir, {
-        generatedFiles: response.generatedFiles,
-        manifest: nextManifest,
-    });
     return {
         experimentId: response.experiment.id,
         experimentKey: response.experiment.posthog_flag_key,
         draftVersionId: response.draftVersionId,
-        writtenPaths: [...EXPERIMENT_GENERATED_PATHS],
+        writtenPaths: [],
         githubConnected: response.githubConnected,
     };
 }
@@ -875,12 +876,12 @@ export function formatExperimentCreateSuccess(result, json) {
         return `${JSON.stringify(machineOutput, null, 2)}\n`;
     }
     const guidance = result.githubConnected
-        ? 'For this GitHub-connected funnel, commit and push the generated source files with your other source changes, then run `fgrove github pull`.'
-        : 'Run `fgrove sync up` to deliver the local funnel changes.';
+        ? 'The experiment is stored in FunnelsGrove. Commit and push any variant source changes, then run `fgrove github pull`; no generated experiment files were written.'
+        : 'The experiment is stored in FunnelsGrove. Run `fgrove sync up` only if the local funnel source also changed; no generated experiment files were written.';
     return [
         `Created experiment ${result.experimentId} (${result.experimentKey})`,
         `Draft version ${result.draftVersionId}`,
-        `Wrote ${result.writtenPaths.join(', ')}`,
+        'Wrote no generated experiment files',
         guidance,
         '',
     ].join('\n');

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.53",
+      "repositoryCliVersion": "0.1.62",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.41",
+        "bundleVersion": "2.0.51",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "7993d09cd90636290a43ee9ed0cdebf62a4fea99c77625b7880d2641b6175ba0"
+            "sha256": "10cd5853ffbe09a300fe222b18d1f7d7c1dd0f61a02693dd8e6d586b283f2121"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -65,7 +65,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "7b2d28d84042c7b22f1cc26f0407389c4bfc6d38f82b473cb128a822f750b0d8"
+            "sha256": "c63a0f15884b2bf5d65f28d127345bd97641a7b38d047907d6d66f091e15a44a"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "dd7eeb6a8028af400f7c28565b622a3ae824e67c9830b71f4c83fbb2487d2159"
+            "sha256": "06c7a3e1b2885129c83e8dd405a9d37ef6f87a14702d92c420772e5bf733f9cc"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.52",
+      "repositoryCliVersion": "0.1.61",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.40",
+        "bundleVersion": "2.0.50",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "bbde1c301b2d4ca0a7a3cbfd9b198263a9106d1c42a2dfd0ef802f581fd45988"
+            "sha256": "88942be6d27cf6f8526d01dfbf143948dd7f82f4b9a17469e18243900a736139"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -212,7 +212,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "7b2d28d84042c7b22f1cc26f0407389c4bfc6d38f82b473cb128a822f750b0d8"
+            "sha256": "c63a0f15884b2bf5d65f28d127345bd97641a7b38d047907d6d66f091e15a44a"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "9b68227426254a9b5563019abb36c552d598ccc2fed3266b432421e3908ddbc7"
+            "sha256": "a39599a33bdbed2eaa5660371d25912dae392a5cefda40798014bd8b933db50e"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.51",
+      "repositoryCliVersion": "0.1.60",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.39",
+        "bundleVersion": "2.0.49",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "26382941b09aa65edc147d2aa7336a745179047b6ec9a308c9572f88516c5e01"
+            "sha256": "f0294b0f21fc24ab69d2f41917869a885a5901d6138d25df11140174e4fb4e72"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -359,7 +359,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
+            "sha256": "dda3f6d812a18ec6be690f76ba82a520ba9e07b4a23f2278e14a0eecb801c729"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "61864db071b802bc5570df67e5eecd8bf43dfbd3e0c5c08abe3a1745df662503"
+            "sha256": "70200599749b518b879b32539ea67ada93bd138237c1a5fab57d64203c06cda1"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.50",
+      "repositoryCliVersion": "0.1.59",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.38",
+        "bundleVersion": "2.0.48",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "056fccc3085ebde480cf0725fab45410bc369fc1434754cd25187e44d3615e28"
+            "sha256": "ad72376d6e98c3908bc57e6853387008dca3367f9dba2d7b43cdc4b90148ef4e"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -506,7 +506,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
+            "sha256": "ccc216612e0d532790a81d556111417876b0408944cae0eb8cd13e758a196bb8"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "d3643ea1a8b9c63b28a18465e4afae1771aab6972559828ebf4802c7ad1df8cb"
+            "sha256": "9d1cb3d86bb1eaa518d04151829b71bb72c21a13c175fcec5ad798393b2f4340"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.49",
+      "repositoryCliVersion": "0.1.58",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.37",
+        "bundleVersion": "2.0.47",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "6268f1d754bc29586cc134032f199bcb7d449a096eafe90cf917e501b9768fe6"
+            "sha256": "4ea96f97ccad5bd9b01f0eeb30936557dec46f9b272599f12f96ffc6bcdc1883"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -653,7 +653,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
+            "sha256": "ccc216612e0d532790a81d556111417876b0408944cae0eb8cd13e758a196bb8"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "99bc93eab4e586a84507821d8ad859f20e87d839a6d9eee2cdf83f72de4a51ae"
+            "sha256": "acd7e0c21d82218ed385a5606c1824af2d452368e0e9857cf2b2ddf341f1b855"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.48",
+      "repositoryCliVersion": "0.1.57",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.36",
+        "bundleVersion": "2.0.46",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "196f56b9138501b1cec0678422c1434d462a01ca5578ebfec607d323b1801234"
+            "sha256": "f7c68708397ff163bfbb29bf49d3e92a8d043100587efe9401478a2365f797c8"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -800,7 +800,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
+            "sha256": "ccc216612e0d532790a81d556111417876b0408944cae0eb8cd13e758a196bb8"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "3f95a918c742c06e3130b20e2edc0820aee8ed213cd6bcdeb09cacb8c428143b"
+            "sha256": "00a3c1130a35be8d05380788e2d73444c78a65f661eb45963b929b5b7eda005a"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.47",
+      "repositoryCliVersion": "0.1.56",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.35",
+        "bundleVersion": "2.0.44",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "164ce4a6860a5d44cf6fad9a9df4c711cc246f1b3982501679645c9971173c70"
+            "sha256": "3bec55a8b14cb0c308d83597af78a59e3c5e8056605a0edc11411ee4e9441c93"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -947,7 +947,7 @@
           },
           {
             "path": "docs/funnelsgrove/recipes/add-experiment.md",
-            "sha256": "9918b577f47a9577c3c98d9a6a7a8762ddfeedb667efe13000900d1a1daee1f9"
+            "sha256": "ccc216612e0d532790a81d556111417876b0408944cae0eb8cd13e758a196bb8"
           },
           {
             "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "d4195ce4a134209e1dd5afb93744d5fbf3ff27f0e64f1c19ff210d09487368b1"
+            "sha256": "bcfdb025c8123433ec0c8647fc7f4ce899b49479f91b10d06b354315854302cf"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.53",
+  "version": "0.1.62",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,13 +34,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.2.0",
+    "@funnelsgrove/runtime": "0.7.0",
     "commander": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.1.44",
-    "@funnelsgrove/payments": "0.2.0",
+    "@funnelsgrove/analytics": "0.1.49",
+    "@funnelsgrove/payments": "0.7.0",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.41",
+  "bundleVersion": "2.0.51",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "7993d09cd90636290a43ee9ed0cdebf62a4fea99c77625b7880d2641b6175ba0"
+      "sha256": "10cd5853ffbe09a300fe222b18d1f7d7c1dd0f61a02693dd8e6d586b283f2121"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -58,7 +58,7 @@
     },
     {
       "path": "docs/funnelsgrove/recipes/add-experiment.md",
-      "sha256": "7b2d28d84042c7b22f1cc26f0407389c4bfc6d38f82b473cb128a822f750b0d8"
+      "sha256": "c63a0f15884b2bf5d65f28d127345bd97641a7b38d047907d6d66f091e15a44a"
     },
     {
       "path": "docs/funnelsgrove/recipes/add-step.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "dd7eeb6a8028af400f7c28565b622a3ae824e67c9830b71f4c83fbb2487d2159"
+      "sha256": "06c7a3e1b2885129c83e8dd405a9d37ef6f87a14702d92c420772e5bf733f9cc"
     }
   ]
 }

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.2.0` first, then `@funnelsgrove/analytics` `0.1.44`, then `@funnelsgrove/payments` `0.2.0`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.53`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.7.0` first, then `@funnelsgrove/analytics` `0.1.49`, then `@funnelsgrove/payments` `0.7.0`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.62`. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_docs/docs/funnelsgrove/recipes/add-experiment.md

@@ -38,7 +38,7 @@ Use only the documented fields. Unknown top-level and variant fields are rejecte
 
 All experiment types require non-empty `id`, `name`, and `stepId`; one `primaryMetric`; at least one unique `trackedMetrics` entry containing the primary metric; and two to five variants. Each variant requires a unique non-empty `variantKey`, `label`, and `routeToStepId`, an integer `trafficPercent` from 0 through 100, and `isControl`. Exactly one variant is the control and traffic must total 100.
 
-Length limits are enforced after surrounding whitespace is trimmed: `variantKey` is at most 120 characters. `id`, `name`, `stepId`, `label`, `routeToStepId`, and `offerSetKey` are each at most 200 characters after trimming. `offerSetKey` applies only to pricing variants.
+Length limits are enforced after surrounding whitespace is trimmed: `variantKey` is at most 120 characters. `id`, `name`, `stepId`, `label`, and `routeToStepId` are each at most 200 characters after trimming. Pricing variants additionally require `offerSetId` as a UUID.
 
 Metrics are exactly `step_completion`, `next_step_reached`, `checkout_opened`, `funnel_completed`, or `paying_customer`.
 
@@ -112,7 +112,7 @@ Like `step`, every variant has a route target. Use `type: "paywall"` when the ro
 
 ### Pricing experiment
 
-Each pricing variant also requires a non-empty `offerSetKey`, and every `routeToStepId` must exactly equal the top-level `stepId`.
+Each pricing variant also requires the immutable UUID `offerSetId` of an active offer set in the same project. Every `routeToStepId` must exactly equal the top-level `stepId`.
 
 ```json
 {
@@ -132,7 +132,7 @@ Each pricing variant also requires a non-empty `offerSetKey`, and every `routeTo
       "routeToStepId": "paywall",
       "trafficPercent": 50,
       "isControl": true,
-      "offerSetKey": "default-paywall"
+      "offerSetId": "11111111-1111-4111-8111-111111111111"
     },
     {
       "variantKey": "annual_focus",
@@ -140,7 +140,7 @@ Each pricing variant also requires a non-empty `offerSetKey`, and every `routeTo
       "routeToStepId": "paywall",
       "trafficPercent": 50,
       "isControl": false,
-      "offerSetKey": "annual-focus"
+      "offerSetId": "22222222-2222-4222-8222-222222222222"
     }
   ]
 }
@@ -156,13 +156,15 @@ Creation always produces a draft. It does not create or activate a PostHog flag,
 fgrove experiments start <experiment-uuid>
 fgrove experiments stop <experiment-uuid>
 fgrove experiments restart <experiment-uuid>
+fgrove experiments end <experiment-uuid>
+fgrove experiments delete <experiment-uuid>
 ```
 
-`stop` is reversible: it pauses traffic and keeps the experiment, variants, and PostHog flag available for a later `start`. `restart` stops a running experiment when necessary and starts it again while preserving the existing definition. Each command updates PostHog and commits the final experiment status to the hosted generated funnel config. Use `--json` for agent-readable output. Run `fgrove experiments sync` afterward when the local generated config also needs to reflect the lifecycle change.
+`stop` is reversible: it pauses traffic and keeps the experiment, variants, and PostHog flag available for a later `start`. `restart` stops a running experiment when necessary and starts it again while preserving the existing definition. `end` permanently archives the experiment; `delete` removes a draft. Each command updates PostHog when required and persists the final status in the control plane. Use `--json` for agent-readable output.
 
-The corresponding authenticated API mutations are `funnelExperiments.start`, `funnelExperiments.stop`, and `funnelExperiments.restart`; each accepts `{ "id": "<experiment-uuid>" }`.
+The corresponding authenticated API mutations are agent-only. Normal browser sessions cannot call experiment lifecycle mutations.
 
-The API creates the experiment and variants atomically, commits the matching generated snapshot to the hosted draft, and only then returns. The draft is immediately visible in the FunnelsGrove UI and hosted previews use the same snapshot. The CLI installs the exact returned bytes at `src/config/experiments.generated.ts` and `src/config/experiments.ts`, then updates the sync manifest last. `.funnelsgrove-sync.json` stays local and ignored; never commit or push it.
+The API creates the experiment and variants atomically through ordinary data services. Experiments are stored in the control plane and included in the version-bound runtime artifact when the funnel is published. `src/config/experiments.generated.ts` and `src/config/experiments.ts` are deprecated compatibility files: new funnels and experiment creation do not generate, install, or update them.
 
 ## Recovery and errors
 
@@ -170,8 +172,7 @@ The API creates the experiment and variants atomically, commits the matching gen
 - Invalid local JSON or `[FG-EXPERIMENT-SPEC]`: fix the reported field and retry with the same stable `id`.
 - `[FG-EXPERIMENT-STALE-DRAFT]`: do not overwrite remote work. Download the latest draft into a clean temporary directory, merge deliberately, rerun validation, and retry the same exact spec.
 - `[FG-EXPERIMENT-DRAFT-CONFLICT]`: the stable key already belongs to a different definition, owner, or lifecycle state. Reuse the original exact definition for a retry, or choose a new stable `id` only for a genuinely new experiment.
-- Locally changed generated experiment files are never overwritten. Resolve those edits before retrying.
-- If the API succeeded but the process stopped, retry safely with the same `id`. A ready local journal is automatically recovered before the next create or sync command; an interruption before the journal simply repeats the exact API request.
+- If the API succeeded but the process stopped, retry safely with the same `id`; no source transaction is required.
 
 ## Validate and deliver
 
@@ -184,7 +185,7 @@ git status --short
 
 For a funnel without GitHub source sync, deliver all local source changes with `fgrove sync up`.
 
-For a GitHub-connected funnel, commit and push the generated source files with the rest of the source change, then run `fgrove github pull`. Never use `fgrove sync up` for the same GitHub-connected diff, and never add `.funnelsgrove-sync.json` to git.
+For a GitHub-connected funnel, commit and push only the variant step or offer-set source changes, then run `fgrove github pull`. The experiment itself is stored in the control plane and does not create a source file. Never use `fgrove sync up` for the same GitHub-connected diff; `.funnelsgrove-sync.json` stays local and ignored.
 
 ## Pre-activation QA
 

package/template_docs/funnel-docs.config.json

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

package/template_scaffold/.funnelsgrove-contract-tools.json

@@ -5,7 +5,7 @@
   "managedFiles": [
     {
       "path": "src/contract/funnel-project.validation.ts",
-      "sha256": "b0ec02eac1bd56812eef773be71628ae4e94f80fcd88837bbc5c8bf04e73a62c"
+      "sha256": "99299cfb96414dd24272439cd1c57191a0863749c920a5eb03ff786f7972ab0e"
     },
     {
       "path": "src/contract/funnel-validator.vite.config.ts",