@funnelsgrove/cli 0.1.27 → 0.1.29

package/README.md

@@ -39,7 +39,9 @@ connected, commit and push source changes with normal git, then run `fgrove
 github pull` to sync GitHub into the hosted draft. Do not run `fgrove sync up`
 for the same local diff.
 
-Use `fgrove env pull` from a synced folder to refresh only the ignored local `.env` file after project settings change, without replacing source files.
+Use `fgrove env pull` from a synced folder to refresh only the ignored local `.env` file after project settings change, without replacing source files. The generated file identifies the current hosted draft through `NEXT_PUBLIC_FUNNEL_VERSION_ID`, so transactional steps such as email capture work during local QA.
+
+`fgrove offer-sets sync` reports the applied offer set and written generated files before waiting for GitHub. By default it waits for the exact GitHub sync job. If that job is still pending or running when the wait times out, the command continues with a warning on stderr and asks you to check the eventual result with `fgrove github status`. Terminal job failures, missing jobs, and API failures still exit non-zero. Pass `--no-github-sync` to skip the wait entirely when the generated file will be committed through the normal repository workflow.
 
 Create an experiment draft from a strict JSON spec:
 
@@ -70,6 +72,12 @@ fgrove publish --funnel claimbee-general --env preview
 The GitHub commands use the FunnelsGrove API only. `fgrove github pull` pulls
 the repository into the hosted draft after you push normal git commits.
 `fgrove publish` waits for the current draft to reach GitHub before publishing.
+If the exact job is still pending or running when that wait times out, publish
+continues with a warning on stderr and asks you to check the eventual result
+with `fgrove github status`. Terminal job failures, missing jobs, and API
+failures remain fatal. Use `--no-github-sync` to skip only that CLI pre-publish
+wait when the hosted draft is already known to match GitHub; the publish worker
+still performs its normal best-effort post-publish GitHub synchronization.
 `fgrove github push` still exists for explicit hosted-draft-to-GitHub recovery
 work, but it is not the normal path for local source changes. Local `.env*`
 files remain CLI-local runtime material from `sync down`; they are not sent to

package/dist/cli.d.ts

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { type ActiveContext } from './authStore.js';
 import { type SourceFile, type SyncManifest } from './localSync.js';
 import { type GitHubStatusResponse } from './githubOutput.js';
+import { syncGitHubDraftIfConnected } from './githubSyncFlow.js';
 import { type DocsExitCode } from './docsOutput.js';
 import { type DocsDiagnostic, type DocsStatus } from './docsTransaction.js';
 import { type FunnelValidationExitCode, type FunnelValidationResult } from './diagnosticOutput.js';
@@ -196,6 +197,32 @@ export declare function buildGeneratedConfigSyncInput(input: {
 };
 export declare function selectGeneratedConfigFiles(files: SourceFile[], kinds: GeneratedConfigKind[]): SourceFile[];
 export declare function assertCanDraftSyncSource(status: GitHubStatusResponse): void;
+export type GitHubSyncTimeoutPolicy = 'strict' | 'continue';
+export declare const PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
+export declare const OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
+export declare const SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
+export declare const SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY: GitHubSyncTimeoutPolicy;
+export declare const GITHUB_SYNC_TIMEOUT_POLICIES: {
+    readonly publish: "continue";
+    readonly offerSetsSync: "continue";
+    readonly syncUpNoLocalChanges: "strict";
+    readonly syncUpCommittedChanges: "strict";
+};
+export declare const syncGitHubDraftForCli: (input: {
+    token: string;
+    workspaceId: string;
+    funnelId: string;
+    timeoutPolicy: GitHubSyncTimeoutPolicy;
+    sync?: typeof syncGitHubDraftIfConnected;
+    warn?: (message: string) => void;
+}) => Promise<void>;
+export declare const shouldSyncGitHubDraft: (options: {
+    githubSync?: boolean;
+}) => boolean;
+export declare const formatOfferSetSyncSuccess: (input: {
+    offerSetLabel: string;
+    generatedFileCount: number;
+}) => string[];
 export declare const program: Command;
 type AnalyticsApiCall = (input: {
     path: string;

package/dist/cli.js

@@ -15,7 +15,7 @@ import { buildSyncManifest, buildCommittedSyncManifest, buildSourceCandidateOper
 import { executeExperimentCreate, formatExperimentCreateSuccess, recoverExperimentCreateTransaction, } from './experimentCreate.js';
 import { pullEnvFile } from './envSync.js';
 import { formatGitHubConnectRows, formatGitHubJobRows, formatGitHubStatusRows, } from './githubOutput.js';
-import { syncGitHubDraftIfConnected } from './githubSyncFlow.js';
+import { GitHubSyncTimeoutError, syncGitHubDraftIfConnected, } from './githubSyncFlow.js';
 import { reskinFunnel } from './reskin.js';
 import { TEMPLATE_DOCS_DIR } from './templateDocs.js';
 import { renderDocsHuman, renderDocsJson, } from './docsOutput.js';
@@ -1400,18 +1400,44 @@ const summarizeGitHubSyncResult = (result) => {
         ? `GitHub synced${remoteSha}`
         : `GitHub already synced${remoteSha}`;
 };
-const syncGitHubDraftForCli = async (input) => {
-    const summary = summarizeGitHubSyncResult(await syncGitHubDraftIfConnected({
-        callApi,
-        token: input.token,
-        workspaceId: input.workspaceId,
-        funnelId: input.funnelId,
-    }));
+export const PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY = 'continue';
+export const OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY = 'continue';
+export const SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY = 'strict';
+export const SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY = 'strict';
+export const GITHUB_SYNC_TIMEOUT_POLICIES = {
+    publish: PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY,
+    offerSetsSync: OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY,
+    syncUpNoLocalChanges: SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
+    syncUpCommittedChanges: SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
+};
+export const syncGitHubDraftForCli = async (input) => {
+    let result;
+    try {
+        result = await (input.sync || syncGitHubDraftIfConnected)({
+            callApi,
+            token: input.token,
+            workspaceId: input.workspaceId,
+            funnelId: input.funnelId,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof GitHubSyncTimeoutError) || input.timeoutPolicy === 'strict') {
+            throw error;
+        }
+        (input.warn || console.warn)(`GitHub sync job ${error.jobId} is still ${error.jobStatus} after the wait timeout. Continuing the requested operation; check its eventual result with \`fgrove github status\`.`);
+        return;
+    }
+    const summary = summarizeGitHubSyncResult(result);
     if (summary) {
         console.log(summary);
     }
 };
 const formatGeneratedFileCount = (count) => `${count} generated config ${count === 1 ? 'file' : 'files'}`;
+export const shouldSyncGitHubDraft = (options) => options.githubSync !== false;
+export const formatOfferSetSyncSuccess = (input) => [
+    `Synced offer set ${input.offerSetLabel} to funnel draft`,
+    `Wrote ${formatGeneratedFileCount(input.generatedFileCount)}`,
+];
 const syncGeneratedConfigFilesForCli = async (input) => {
     const result = await callApi({
         path: 'funnels.generatedConfigFiles',
@@ -1621,6 +1647,7 @@ addExamples(offerSetsCommand
     .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
     .option('--funnel <id-or-slug>', 'Funnel id or slug')
     .option('--dir <path>', 'Local source directory for reading sync manifest', '.')
+    .option('--no-github-sync', 'Skip waiting for an additional GitHub draft push')
     .requiredOption('--offer-set <key-or-id>', 'Offer set key or id'), [
     'fgrove offer-sets sync --offer-set default-paywall',
     'fgrove offers sync --funnel claimbee-ios --offer-set quarterly-test',
@@ -1648,14 +1675,19 @@ addExamples(offerSetsCommand
         target,
         kinds: ['offerSets'],
     });
-    await syncGitHubDraftForCli({
-        token,
-        workspaceId: target.workspaceId,
-        funnelId: target.funnelId,
-    });
     const offerSetLabel = result.offerSet?.key || result.offerSet?.display_name || options.offerSet.trim();
-    console.log(`Synced offer set ${offerSetLabel} to funnel draft`);
-    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
+    console.log(formatOfferSetSyncSuccess({
+        offerSetLabel,
+        generatedFileCount: generatedFiles.length,
+    }).join('\n'));
+    if (shouldSyncGitHubDraft(options)) {
+        await syncGitHubDraftForCli({
+            token,
+            workspaceId: target.workspaceId,
+            funnelId: target.funnelId,
+            timeoutPolicy: OFFER_SETS_GITHUB_SYNC_TIMEOUT_POLICY,
+        });
+    }
 });
 const experimentsCommand = addExamples(program.command('experiments').description('Manage funnel experiments'), [
     'fgrove experiments create --spec experiment.json --dir .',
@@ -2102,6 +2134,7 @@ addExamples(syncCommand
             token,
             workspaceId: target.workspaceId,
             funnelId: target.funnelId,
+            timeoutPolicy: SYNC_UP_NO_LOCAL_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
         });
         return;
     }
@@ -2194,6 +2227,7 @@ addExamples(syncCommand
         token,
         workspaceId: target.workspaceId,
         funnelId: target.funnelId,
+        timeoutPolicy: SYNC_UP_COMMITTED_CHANGES_GITHUB_SYNC_TIMEOUT_POLICY,
     });
     console.log(formatSourceCandidateSyncSuccess({
         syncedFileCount,
@@ -2209,7 +2243,8 @@ addExamples(program
     .option('--dir <path>', 'Local source directory for reading sync manifest', '.')
     .option('--env <preview-or-production>', 'Publish environment', 'preview')
     .option('--domain <domain>', 'Production custom domain')
-    .option('--message <message>', 'Publish version message'), [
+    .option('--message <message>', 'Publish version message')
+    .option('--no-github-sync', 'Skip the pre-publish GitHub draft push wait'), [
     'fgrove publish --env preview --message "Preview copy updates"',
     'fgrove publish --env production --domain claimbee.example.com --message "Launch"',
 ])
@@ -2230,11 +2265,14 @@ addExamples(program
         funnel: options.funnel,
         dir: options.dir,
     });
-    await syncGitHubDraftForCli({
-        token,
-        workspaceId: target.workspaceId,
-        funnelId: target.funnelId,
-    });
+    if (shouldSyncGitHubDraft(options)) {
+        await syncGitHubDraftForCli({
+            token,
+            workspaceId: target.workspaceId,
+            funnelId: target.funnelId,
+            timeoutPolicy: PUBLISH_GITHUB_SYNC_TIMEOUT_POLICY,
+        });
+    }
     const result = await callApi({
         path: 'funnels.publish',
         type: 'mutation',

package/dist/githubSyncFlow.d.ts

@@ -15,6 +15,12 @@ export type GitHubSyncFlowResult = {
     remoteSha: string | null;
     versionId: string | null;
 };
+type PendingGitHubSyncJobStatus = 'pending' | 'running';
+export declare class GitHubSyncTimeoutError extends Error {
+    readonly jobId: string;
+    readonly jobStatus: PendingGitHubSyncJobStatus;
+    constructor(jobId: string, jobStatus: PendingGitHubSyncJobStatus);
+}
 export declare const syncGitHubDraftIfConnected: (input: {
     callApi: GitHubFlowCallApi;
     token: string;

package/dist/githubSyncFlow.js

@@ -1,3 +1,13 @@
+export class GitHubSyncTimeoutError extends Error {
+    jobId;
+    jobStatus;
+    constructor(jobId, jobStatus) {
+        super(`Timed out waiting for GitHub sync job ${jobId}.`);
+        this.name = 'GitHubSyncTimeoutError';
+        this.jobId = jobId;
+        this.jobStatus = jobStatus;
+    }
+}
 const TERMINAL_JOB_STATUSES = new Set(['completed', 'skipped', 'failed']);
 const DEFAULT_POLL_INTERVAL_MS = 2_000;
 const DEFAULT_TIMEOUT_MS = 600_000;
@@ -9,6 +19,18 @@ const sleepDefault = async (ms) => {
 const findJob = (status, jobId) => {
     return status.syncJobs.find((job) => job.id === jobId) || null;
 };
+const readJob = async (input) => {
+    const status = await input.callApi({
+        path: 'github.status',
+        type: 'query',
+        token: input.token,
+        data: {
+            workspaceId: input.workspaceId,
+            funnelId: input.funnelId,
+        },
+    });
+    return findJob(status, input.jobId);
+};
 const assertSuccessfulTerminalJob = (job) => {
     if (job.status === 'failed' || (job.status === 'skipped' && job.errorMessage)) {
         throw new Error(job.errorMessage || 'GitHub sync failed.');
@@ -49,17 +71,14 @@ export const syncGitHubDraftIfConnected = async (input) => {
     const timeoutMs = input.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const sleep = input.sleep || sleepDefault;
     const deadline = Date.now() + timeoutMs;
-    while (Date.now() <= deadline) {
-        const nextStatus = await input.callApi({
-            path: 'github.status',
-            type: 'query',
+    while (Date.now() < deadline) {
+        const job = await readJob({
+            callApi: input.callApi,
             token: input.token,
-            data: {
-                workspaceId: input.workspaceId,
-                funnelId: input.funnelId,
-            },
+            workspaceId: input.workspaceId,
+            funnelId: input.funnelId,
+            jobId: pushResult.jobId,
         });
-        const job = findJob(nextStatus, pushResult.jobId);
         if (job && TERMINAL_JOB_STATUSES.has(job.status)) {
             assertSuccessfulTerminalJob(job);
             return {
@@ -69,7 +88,33 @@ export const syncGitHubDraftIfConnected = async (input) => {
                 versionId: job.appliedVersionId,
             };
         }
-        await sleep(pollIntervalMs);
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0) {
+            break;
+        }
+        await sleep(Math.min(pollIntervalMs, remainingMs));
+    }
+    const finalJob = await readJob({
+        callApi: input.callApi,
+        token: input.token,
+        workspaceId: input.workspaceId,
+        funnelId: input.funnelId,
+        jobId: pushResult.jobId,
+    });
+    if (!finalJob) {
+        throw new Error(`GitHub sync job ${pushResult.jobId} was not found while waiting.`);
+    }
+    if (TERMINAL_JOB_STATUSES.has(finalJob.status)) {
+        assertSuccessfulTerminalJob(finalJob);
+        return {
+            status: finalJob.status,
+            jobId: finalJob.id,
+            remoteSha: finalJob.targetRemoteSha,
+            versionId: finalJob.appliedVersionId,
+        };
+    }
+    if (finalJob.status === 'pending' || finalJob.status === 'running') {
+        throw new GitHubSyncTimeoutError(pushResult.jobId, finalJob.status);
     }
     throw new Error(`Timed out waiting for GitHub sync job ${pushResult.jobId}.`);
 };

package/funnel-contract-compatibility.json

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

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
+    "directory": "apps/cli"
+  },
   "type": "module",
   "bin": {
     "fgrove": "dist/cli.js",

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.15",
+  "bundleVersion": "2.0.17",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "790e5f36fb47f256da4ab25b1b1fbe453f1de61af2d278c400cb9a5edfeedeaf"
+      "sha256": "bf7171b1101096ac3b205aa8f251379de1c66e16c20b5ca6054e84fd0ab17862"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1e57699834211909ee3a9a6eabfc957e5cc4952a07d4621b26fc7328be960973"
+      "sha256": "87d325180a8e9e501cf5c2a00174f99fae58a612b7a93cfe9753bf1f149e46a4"
     }
   ]
 }

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.27`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.29`. 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.15",
+  "bundleVersion": "2.0.17",
   "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.15",
+  "bundleVersion": "2.0.17",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "790e5f36fb47f256da4ab25b1b1fbe453f1de61af2d278c400cb9a5edfeedeaf"
+      "sha256": "bf7171b1101096ac3b205aa8f251379de1c66e16c20b5ca6054e84fd0ab17862"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1e57699834211909ee3a9a6eabfc957e5cc4952a07d4621b26fc7328be960973"
+      "sha256": "87d325180a8e9e501cf5c2a00174f99fae58a612b7a93cfe9753bf1f149e46a4"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "ec68d0d8147e5b8161cda226ee964b567c7b335c1c416cd7f36c7f11eb74c761",
+  "sourceTreeHash": "31d74efe474f7afcf393de1e73b36e4caa060806e1e632b6ba1e396e863e8f82",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.15",
+  "docsBundleVersion": "2.0.17",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "c0f1b282d57a38f3ba864fd452ffcda1afccd444a42b469afd057a382f6229b4",
+      "sha256": "ec2ae4a38af84f481994924e736a3f9e76b9a132973b0107fcd00a7bd11510b1",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "790e5f36fb47f256da4ab25b1b1fbe453f1de61af2d278c400cb9a5edfeedeaf",
+      "sha256": "bf7171b1101096ac3b205aa8f251379de1c66e16c20b5ca6054e84fd0ab17862",
       "mode": "100644"
     },
     {
@@ -236,12 +236,12 @@
     },
     {
       "path": "funnel-agent-docs.test.ts",
-      "sha256": "cb4d020d4e204bd7d10bf8f20fbd3056cb276824fbd8742bffc0b66da12f73b4",
+      "sha256": "ecf210609282fa186eaedbdea39e7ce226fbe5f76fded2b4d77a57b858f6713a",
       "mode": "100644"
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "1e57699834211909ee3a9a6eabfc957e5cc4952a07d4621b26fc7328be960973",
+      "sha256": "87d325180a8e9e501cf5c2a00174f99fae58a612b7a93cfe9753bf1f149e46a4",
       "mode": "100644"
     },
     {

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

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.27`. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/runtime` `0.1.60` first, then `@funnelsgrove/analytics` `0.1.37`, then `@funnelsgrove/payments` `0.1.55`. Deploy the API and funnel template, then confirm production `/health` reports the new docs identity. Only then publish `@funnelsgrove/cli` `0.1.29`. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-agent-docs.test.ts

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

package/template_scaffold/funnel-docs.config.json

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