@funnelsgrove/cli 0.1.142 → 0.1.146
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -4
- package/dist/apiClient.d.ts +50 -0
- package/dist/apiClient.js +24 -1
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +115 -28
- package/dist/contractCompatibility.js +1 -1
- package/dist/draftPatchSync.d.ts +39 -0
- package/dist/draftPatchSync.js +132 -0
- package/dist/emailCommands.js +2 -2
- package/dist/localSync.d.ts +1 -0
- package/dist/localSync.js +1 -1
- package/dist/selfUpdate.d.ts +24 -0
- package/dist/selfUpdate.js +82 -0
- package/funnel-contract-compatibility.json +34 -34
- package/package.json +3 -3
- package/template_docs/.funnelsgrove-docs.json +5 -5
- package/template_docs/AGENTS.md +1 -1
- package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md +1 -1
- package/template_docs/docs/funnelsgrove/qa/publish.md +1 -0
- package/template_docs/funnel-docs.config.json +1 -1
- package/template_scaffold/.funnelsgrove-docs.json +5 -5
- package/template_scaffold/.funnelsgrove-scaffold.json +9 -9
- package/template_scaffold/AGENTS.md +1 -1
- package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md +1 -1
- package/template_scaffold/docs/funnelsgrove/qa/publish.md +1 -0
- package/template_scaffold/funnel-docs.config.json +1 -1
- package/template_scaffold/package-lock.json +9 -9
- package/template_scaffold/package.json +2 -2
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { access, realpath } from 'node:fs/promises';
|
|
2
|
+
export type CliInstallation = {
|
|
3
|
+
prefix: string;
|
|
4
|
+
executablePath: string;
|
|
5
|
+
npmExecutablePath: string;
|
|
6
|
+
};
|
|
7
|
+
type RunCommand = (command: string, args: string[]) => Promise<void>;
|
|
8
|
+
export declare const deriveGlobalCliPrefix: (realExecutablePath: string) => string | null;
|
|
9
|
+
export declare const discoverCliInstallations: (input?: {
|
|
10
|
+
pathValue?: string;
|
|
11
|
+
entrypointPath?: string;
|
|
12
|
+
platform?: NodeJS.Platform;
|
|
13
|
+
realpathFn?: typeof realpath;
|
|
14
|
+
accessFn?: typeof access;
|
|
15
|
+
}) => Promise<CliInstallation[]>;
|
|
16
|
+
export declare const updateCliInstallations: (input?: {
|
|
17
|
+
dryRun?: boolean;
|
|
18
|
+
pathValue?: string;
|
|
19
|
+
entrypointPath?: string;
|
|
20
|
+
installations?: CliInstallation[];
|
|
21
|
+
runCommand?: RunCommand;
|
|
22
|
+
report?: (message: string) => void;
|
|
23
|
+
}) => Promise<CliInstallation[]>;
|
|
24
|
+
export {};
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { constants as fsConstants } from 'node:fs';
|
|
2
|
+
import { access, realpath } from 'node:fs/promises';
|
|
3
|
+
import { spawn } from 'node:child_process';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
const CLI_PACKAGE = '@funnelsgrove/cli@latest';
|
|
6
|
+
const runCommandWithInheritedIo = async (command, args) => {
|
|
7
|
+
await new Promise((resolve, reject) => {
|
|
8
|
+
const child = spawn(command, args, { stdio: 'inherit' });
|
|
9
|
+
child.once('error', reject);
|
|
10
|
+
child.once('exit', (code, signal) => {
|
|
11
|
+
if (code === 0) {
|
|
12
|
+
resolve();
|
|
13
|
+
return;
|
|
14
|
+
}
|
|
15
|
+
reject(new Error(signal
|
|
16
|
+
? `${command} was terminated by ${signal}.`
|
|
17
|
+
: `${command} exited with code ${code ?? 'unknown'}.`));
|
|
18
|
+
});
|
|
19
|
+
});
|
|
20
|
+
};
|
|
21
|
+
export const deriveGlobalCliPrefix = (realExecutablePath) => {
|
|
22
|
+
const normalized = path.resolve(realExecutablePath);
|
|
23
|
+
const marker = `${path.sep}lib${path.sep}node_modules${path.sep}@funnelsgrove${path.sep}cli${path.sep}`;
|
|
24
|
+
const markerIndex = normalized.indexOf(marker);
|
|
25
|
+
if (markerIndex < 1)
|
|
26
|
+
return null;
|
|
27
|
+
return normalized.slice(0, markerIndex);
|
|
28
|
+
};
|
|
29
|
+
export const discoverCliInstallations = async (input = {}) => {
|
|
30
|
+
const platform = input.platform || process.platform;
|
|
31
|
+
const realpathFn = input.realpathFn || realpath;
|
|
32
|
+
const accessFn = input.accessFn || access;
|
|
33
|
+
const executableName = platform === 'win32' ? 'fgrove.cmd' : 'fgrove';
|
|
34
|
+
const npmName = platform === 'win32' ? 'npm.cmd' : 'npm';
|
|
35
|
+
const candidates = (input.pathValue ?? process.env.PATH ?? '')
|
|
36
|
+
.split(path.delimiter)
|
|
37
|
+
.filter(Boolean)
|
|
38
|
+
.map((directory) => path.join(directory, executableName));
|
|
39
|
+
if (input.entrypointPath)
|
|
40
|
+
candidates.push(input.entrypointPath);
|
|
41
|
+
const installations = new Map();
|
|
42
|
+
for (const candidate of candidates) {
|
|
43
|
+
try {
|
|
44
|
+
await accessFn(candidate, fsConstants.X_OK);
|
|
45
|
+
const realExecutablePath = await realpathFn(candidate);
|
|
46
|
+
const prefix = deriveGlobalCliPrefix(realExecutablePath);
|
|
47
|
+
if (!prefix || installations.has(prefix))
|
|
48
|
+
continue;
|
|
49
|
+
const executablePath = path.join(prefix, 'bin', executableName);
|
|
50
|
+
const npmExecutablePath = path.join(prefix, 'bin', npmName);
|
|
51
|
+
await accessFn(npmExecutablePath, fsConstants.X_OK);
|
|
52
|
+
installations.set(prefix, { prefix, executablePath, npmExecutablePath });
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
// PATH commonly contains directories without fgrove; those are not installations.
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
return [...installations.values()].sort((left, right) => left.prefix.localeCompare(right.prefix));
|
|
59
|
+
};
|
|
60
|
+
export const updateCliInstallations = async (input = {}) => {
|
|
61
|
+
const installations = input.installations || await discoverCliInstallations({
|
|
62
|
+
pathValue: input.pathValue,
|
|
63
|
+
entrypointPath: input.entrypointPath,
|
|
64
|
+
});
|
|
65
|
+
if (installations.length === 0) {
|
|
66
|
+
throw new Error('No global fgrove installation was found on PATH. Install it with npm install -g @funnelsgrove/cli@latest.');
|
|
67
|
+
}
|
|
68
|
+
const runCommand = input.runCommand || runCommandWithInheritedIo;
|
|
69
|
+
for (const installation of installations) {
|
|
70
|
+
input.report?.(`${input.dryRun ? 'Found' : 'Updating'} fgrove at ${installation.executablePath}`);
|
|
71
|
+
if (input.dryRun)
|
|
72
|
+
continue;
|
|
73
|
+
await runCommand(installation.npmExecutablePath, [
|
|
74
|
+
'install',
|
|
75
|
+
'--global',
|
|
76
|
+
'--prefix',
|
|
77
|
+
installation.prefix,
|
|
78
|
+
CLI_PACKAGE,
|
|
79
|
+
]);
|
|
80
|
+
}
|
|
81
|
+
return installations;
|
|
82
|
+
};
|
|
@@ -4,16 +4,16 @@
|
|
|
4
4
|
"minimumCliVersion": "0.1.20",
|
|
5
5
|
"entries": [
|
|
6
6
|
{
|
|
7
|
-
"repositoryCliVersion": "0.1.
|
|
7
|
+
"repositoryCliVersion": "0.1.146",
|
|
8
8
|
"manifest": {
|
|
9
9
|
"schemaVersion": 1,
|
|
10
|
-
"bundleVersion": "2.0.
|
|
10
|
+
"bundleVersion": "2.0.136",
|
|
11
11
|
"stepContractVersion": 3,
|
|
12
12
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
13
13
|
"managedFiles": [
|
|
14
14
|
{
|
|
15
15
|
"path": "AGENTS.md",
|
|
16
|
-
"sha256": "
|
|
16
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
17
17
|
},
|
|
18
18
|
{
|
|
19
19
|
"path": "CLAUDE.md",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
},
|
|
46
46
|
{
|
|
47
47
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
48
|
-
"sha256": "
|
|
48
|
+
"sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
},
|
|
62
62
|
{
|
|
63
63
|
"path": "docs/funnelsgrove/qa/publish.md",
|
|
64
|
-
"sha256": "
|
|
64
|
+
"sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/funnelsgrove/recipes/add-experiment.md",
|
|
@@ -145,22 +145,22 @@
|
|
|
145
145
|
},
|
|
146
146
|
{
|
|
147
147
|
"path": "funnel-docs.config.json",
|
|
148
|
-
"sha256": "
|
|
148
|
+
"sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942"
|
|
149
149
|
}
|
|
150
150
|
]
|
|
151
151
|
}
|
|
152
152
|
},
|
|
153
153
|
{
|
|
154
|
-
"repositoryCliVersion": "0.1.
|
|
154
|
+
"repositoryCliVersion": "0.1.145",
|
|
155
155
|
"manifest": {
|
|
156
156
|
"schemaVersion": 1,
|
|
157
|
-
"bundleVersion": "2.0.
|
|
157
|
+
"bundleVersion": "2.0.135",
|
|
158
158
|
"stepContractVersion": 3,
|
|
159
159
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
160
160
|
"managedFiles": [
|
|
161
161
|
{
|
|
162
162
|
"path": "AGENTS.md",
|
|
163
|
-
"sha256": "
|
|
163
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
164
164
|
},
|
|
165
165
|
{
|
|
166
166
|
"path": "CLAUDE.md",
|
|
@@ -192,7 +192,7 @@
|
|
|
192
192
|
},
|
|
193
193
|
{
|
|
194
194
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
195
|
-
"sha256": "
|
|
195
|
+
"sha256": "0b3708beaa8d63e1c1fe5ab38e39fdf7a3e12fec39166261a1bad7619d872179"
|
|
196
196
|
},
|
|
197
197
|
{
|
|
198
198
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -208,7 +208,7 @@
|
|
|
208
208
|
},
|
|
209
209
|
{
|
|
210
210
|
"path": "docs/funnelsgrove/qa/publish.md",
|
|
211
|
-
"sha256": "
|
|
211
|
+
"sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
|
|
212
212
|
},
|
|
213
213
|
{
|
|
214
214
|
"path": "docs/funnelsgrove/recipes/add-experiment.md",
|
|
@@ -292,22 +292,22 @@
|
|
|
292
292
|
},
|
|
293
293
|
{
|
|
294
294
|
"path": "funnel-docs.config.json",
|
|
295
|
-
"sha256": "
|
|
295
|
+
"sha256": "7fa793bde89dc1106b24eb408f225d156865bffe37f4feb7aeadb553844643c8"
|
|
296
296
|
}
|
|
297
297
|
]
|
|
298
298
|
}
|
|
299
299
|
},
|
|
300
300
|
{
|
|
301
|
-
"repositoryCliVersion": "0.1.
|
|
301
|
+
"repositoryCliVersion": "0.1.144",
|
|
302
302
|
"manifest": {
|
|
303
303
|
"schemaVersion": 1,
|
|
304
|
-
"bundleVersion": "2.0.
|
|
304
|
+
"bundleVersion": "2.0.134",
|
|
305
305
|
"stepContractVersion": 3,
|
|
306
306
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
307
307
|
"managedFiles": [
|
|
308
308
|
{
|
|
309
309
|
"path": "AGENTS.md",
|
|
310
|
-
"sha256": "
|
|
310
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
311
311
|
},
|
|
312
312
|
{
|
|
313
313
|
"path": "CLAUDE.md",
|
|
@@ -339,7 +339,7 @@
|
|
|
339
339
|
},
|
|
340
340
|
{
|
|
341
341
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
342
|
-
"sha256": "
|
|
342
|
+
"sha256": "fec5ced4b8e8e6c8081f5446b3b4174caefa89ac6d441f03e576fb10e961bc98"
|
|
343
343
|
},
|
|
344
344
|
{
|
|
345
345
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -439,22 +439,22 @@
|
|
|
439
439
|
},
|
|
440
440
|
{
|
|
441
441
|
"path": "funnel-docs.config.json",
|
|
442
|
-
"sha256": "
|
|
442
|
+
"sha256": "efdede3e20f75d3b6f5dc00daa3e8ee1c3c03d56978fa087161b643424add0cc"
|
|
443
443
|
}
|
|
444
444
|
]
|
|
445
445
|
}
|
|
446
446
|
},
|
|
447
447
|
{
|
|
448
|
-
"repositoryCliVersion": "0.1.
|
|
448
|
+
"repositoryCliVersion": "0.1.143",
|
|
449
449
|
"manifest": {
|
|
450
450
|
"schemaVersion": 1,
|
|
451
|
-
"bundleVersion": "2.0.
|
|
451
|
+
"bundleVersion": "2.0.133",
|
|
452
452
|
"stepContractVersion": 3,
|
|
453
453
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
454
454
|
"managedFiles": [
|
|
455
455
|
{
|
|
456
456
|
"path": "AGENTS.md",
|
|
457
|
-
"sha256": "
|
|
457
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
458
458
|
},
|
|
459
459
|
{
|
|
460
460
|
"path": "CLAUDE.md",
|
|
@@ -486,7 +486,7 @@
|
|
|
486
486
|
},
|
|
487
487
|
{
|
|
488
488
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
489
|
-
"sha256": "
|
|
489
|
+
"sha256": "bb6f567146d9c70b209eff612ffcfb5e7c20b7ccb357beec47a187ead887a829"
|
|
490
490
|
},
|
|
491
491
|
{
|
|
492
492
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -586,16 +586,16 @@
|
|
|
586
586
|
},
|
|
587
587
|
{
|
|
588
588
|
"path": "funnel-docs.config.json",
|
|
589
|
-
"sha256": "
|
|
589
|
+
"sha256": "7a7f556fc144e82469dbc56da7d4ce588c3bcc627ebf4b9aec9961f93d672f1f"
|
|
590
590
|
}
|
|
591
591
|
]
|
|
592
592
|
}
|
|
593
593
|
},
|
|
594
594
|
{
|
|
595
|
-
"repositoryCliVersion": "0.1.
|
|
595
|
+
"repositoryCliVersion": "0.1.142",
|
|
596
596
|
"manifest": {
|
|
597
597
|
"schemaVersion": 1,
|
|
598
|
-
"bundleVersion": "2.0.
|
|
598
|
+
"bundleVersion": "2.0.132",
|
|
599
599
|
"stepContractVersion": 3,
|
|
600
600
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
601
601
|
"managedFiles": [
|
|
@@ -633,7 +633,7 @@
|
|
|
633
633
|
},
|
|
634
634
|
{
|
|
635
635
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
636
|
-
"sha256": "
|
|
636
|
+
"sha256": "33d225bcc4f6f7aaa473f3bebe81799b3ec4751c374a4c2d9159afc56415ba74"
|
|
637
637
|
},
|
|
638
638
|
{
|
|
639
639
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -733,16 +733,16 @@
|
|
|
733
733
|
},
|
|
734
734
|
{
|
|
735
735
|
"path": "funnel-docs.config.json",
|
|
736
|
-
"sha256": "
|
|
736
|
+
"sha256": "ea5b05c7f28303245e358598f125a3a31c15175c2ef15ae8873b25be2ded133e"
|
|
737
737
|
}
|
|
738
738
|
]
|
|
739
739
|
}
|
|
740
740
|
},
|
|
741
741
|
{
|
|
742
|
-
"repositoryCliVersion": "0.1.
|
|
742
|
+
"repositoryCliVersion": "0.1.141",
|
|
743
743
|
"manifest": {
|
|
744
744
|
"schemaVersion": 1,
|
|
745
|
-
"bundleVersion": "2.0.
|
|
745
|
+
"bundleVersion": "2.0.131",
|
|
746
746
|
"stepContractVersion": 3,
|
|
747
747
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
748
748
|
"managedFiles": [
|
|
@@ -780,7 +780,7 @@
|
|
|
780
780
|
},
|
|
781
781
|
{
|
|
782
782
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
783
|
-
"sha256": "
|
|
783
|
+
"sha256": "015d013594cabb94c288bb39d7c717f531b68a1fe4754e6baefc0e08bbc5b872"
|
|
784
784
|
},
|
|
785
785
|
{
|
|
786
786
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -880,16 +880,16 @@
|
|
|
880
880
|
},
|
|
881
881
|
{
|
|
882
882
|
"path": "funnel-docs.config.json",
|
|
883
|
-
"sha256": "
|
|
883
|
+
"sha256": "7af952690a2b3c592ce6688b8524aa4c5fe111a0c798dc25106eb0d594c2452b"
|
|
884
884
|
}
|
|
885
885
|
]
|
|
886
886
|
}
|
|
887
887
|
},
|
|
888
888
|
{
|
|
889
|
-
"repositoryCliVersion": "0.1.
|
|
889
|
+
"repositoryCliVersion": "0.1.140",
|
|
890
890
|
"manifest": {
|
|
891
891
|
"schemaVersion": 1,
|
|
892
|
-
"bundleVersion": "2.0.
|
|
892
|
+
"bundleVersion": "2.0.130",
|
|
893
893
|
"stepContractVersion": 3,
|
|
894
894
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
895
895
|
"managedFiles": [
|
|
@@ -927,7 +927,7 @@
|
|
|
927
927
|
},
|
|
928
928
|
{
|
|
929
929
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
930
|
-
"sha256": "
|
|
930
|
+
"sha256": "9988e6f7b4ecf3f4a73ff83cf3f3613f82d765c59d09e55e86b0560d1e3eafa5"
|
|
931
931
|
},
|
|
932
932
|
{
|
|
933
933
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -1027,7 +1027,7 @@
|
|
|
1027
1027
|
},
|
|
1028
1028
|
{
|
|
1029
1029
|
"path": "funnel-docs.config.json",
|
|
1030
|
-
"sha256": "
|
|
1030
|
+
"sha256": "4e81bd56071fa38708c7f18488420038339c8cc984062ffd7e8a4930ab6b06f0"
|
|
1031
1031
|
}
|
|
1032
1032
|
]
|
|
1033
1033
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@funnelsgrove/cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.146",
|
|
4
4
|
"description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -34,12 +34,12 @@
|
|
|
34
34
|
"test": "vitest run"
|
|
35
35
|
},
|
|
36
36
|
"dependencies": {
|
|
37
|
-
"@funnelsgrove/runtime": "0.7.
|
|
37
|
+
"@funnelsgrove/runtime": "0.7.28",
|
|
38
38
|
"commander": "^12.0.0",
|
|
39
39
|
"typescript": "^5.8.3"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
|
-
"@funnelsgrove/analytics": "0.1.
|
|
42
|
+
"@funnelsgrove/analytics": "0.1.77",
|
|
43
43
|
"@funnelsgrove/payments": "0.7.19",
|
|
44
44
|
"vitest": "^3.0.0"
|
|
45
45
|
}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"bundleVersion": "2.0.
|
|
3
|
+
"bundleVersion": "2.0.136",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
5
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
6
6
|
"managedFiles": [
|
|
7
7
|
{
|
|
8
8
|
"path": "AGENTS.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "CLAUDE.md",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
41
|
-
"sha256": "
|
|
41
|
+
"sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
},
|
|
55
55
|
{
|
|
56
56
|
"path": "docs/funnelsgrove/qa/publish.md",
|
|
57
|
-
"sha256": "
|
|
57
|
+
"sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
|
|
58
58
|
},
|
|
59
59
|
{
|
|
60
60
|
"path": "docs/funnelsgrove/recipes/add-experiment.md",
|
|
@@ -138,7 +138,7 @@
|
|
|
138
138
|
},
|
|
139
139
|
{
|
|
140
140
|
"path": "funnel-docs.config.json",
|
|
141
|
-
"sha256": "
|
|
141
|
+
"sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942"
|
|
142
142
|
}
|
|
143
143
|
]
|
|
144
144
|
}
|
package/template_docs/AGENTS.md
CHANGED
|
@@ -29,7 +29,7 @@ This file is generated from the FunnelsGrove step contract. Start at [the agent
|
|
|
29
29
|
|
|
30
30
|
1. Before edits run `fgrove status`, `git status --short`, and `fgrove github status` when the funnel is GitHub-connected.
|
|
31
31
|
2. Never run `fgrove sync down` over changed synced source. Use `--force` only to intentionally discard those local changes.
|
|
32
|
-
3. Sync-up
|
|
32
|
+
3. Sync-up atomically patches changed paths through the base draft version, uploads changed `public/` images directly, and safely replays retries. Disjoint remote edits rebase automatically; on a same-path conflict, run `fgrove sync rebase`, review the merge, rerun checks, and retry.
|
|
33
33
|
4. GitHub-connected changes use git push, `fgrove github pull`, terminal status, then publish; never use `fgrove sync up` for the same diff. Non-GitHub funnels use `fgrove sync up`.
|
|
34
34
|
5. Use `fgrove env pull` when only the ignored `.env` must be refreshed. Environment files never belong in synced source.
|
|
35
35
|
|
|
@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
|
|
|
17
17
|
|
|
18
18
|
### Package release order
|
|
19
19
|
|
|
20
|
-
Release `@funnelsgrove/runtime` `0.7.
|
|
20
|
+
Release `@funnelsgrove/runtime` `0.7.28` first, then `@funnelsgrove/analytics` `0.1.77`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.146`, 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.
|
|
21
21
|
<!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
|
|
22
22
|
|
|
23
23
|
## Version-last policy
|
|
@@ -22,6 +22,7 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
|
|
|
22
22
|
1. Run `fgrove status`, `git status --short`, tests, lint, `fgrove validate`, and relevant local/analytics/payment QA.
|
|
23
23
|
2. Choose exactly one source path. GitHub-connected funnels use git push, `fgrove github pull`, terminal status, then publish; never use `fgrove sync up` for the same diff. Non-GitHub funnels use `fgrove sync up`.
|
|
24
24
|
3. Publish preview with a clear message.
|
|
25
|
+
`fgrove publish` reports validation, GitHub sync, queue, build, image optimization, and upload progress on stderr; its final URL/version row remains the only stdout output. If compatibility guidance requests a newer CLI, run `fgrove update` so every NVM/Homebrew installation visible on `PATH` is updated together.
|
|
25
26
|
4. Test the preview URL across supported breakpoints and real navigation entry points.
|
|
26
27
|
5. Confirm preview-mode suppression and production configuration separation.
|
|
27
28
|
6. Review route, analytics, answer, experiment, and payment evidence.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"bundleVersion": "2.0.
|
|
3
|
+
"bundleVersion": "2.0.136",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
5
|
"contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
|
|
6
6
|
"managedFiles": [
|
|
7
7
|
{
|
|
8
8
|
"path": "AGENTS.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"path": "CLAUDE.md",
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
41
|
-
"sha256": "
|
|
41
|
+
"sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "docs/funnelsgrove/qa/analytics.md",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
},
|
|
55
55
|
{
|
|
56
56
|
"path": "docs/funnelsgrove/qa/publish.md",
|
|
57
|
-
"sha256": "
|
|
57
|
+
"sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603"
|
|
58
58
|
},
|
|
59
59
|
{
|
|
60
60
|
"path": "docs/funnelsgrove/recipes/add-experiment.md",
|
|
@@ -138,7 +138,7 @@
|
|
|
138
138
|
},
|
|
139
139
|
{
|
|
140
140
|
"path": "funnel-docs.config.json",
|
|
141
|
-
"sha256": "
|
|
141
|
+
"sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942"
|
|
142
142
|
}
|
|
143
143
|
]
|
|
144
144
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"sourceTreeHash": "
|
|
3
|
+
"sourceTreeHash": "5f7015815cec65266d11c6c96aae425d72b251107d1ae4541a6405bcd696bf6b",
|
|
4
4
|
"stepContractVersion": 3,
|
|
5
|
-
"docsBundleVersion": "2.0.
|
|
5
|
+
"docsBundleVersion": "2.0.136",
|
|
6
6
|
"files": [
|
|
7
7
|
{
|
|
8
8
|
"path": ".env.example",
|
|
@@ -16,12 +16,12 @@
|
|
|
16
16
|
},
|
|
17
17
|
{
|
|
18
18
|
"path": ".funnelsgrove-docs.json",
|
|
19
|
-
"sha256": "
|
|
19
|
+
"sha256": "3e7fe2377e1251fbfbf00bd8e9fe37b2148e8b43f1b5fa72f3109ae3829cdc9f",
|
|
20
20
|
"mode": "100644"
|
|
21
21
|
},
|
|
22
22
|
{
|
|
23
23
|
"path": "AGENTS.md",
|
|
24
|
-
"sha256": "
|
|
24
|
+
"sha256": "22118f0f909a747f8a27f4eed16ceb5ec2a9283fd9645114fda961c0405a2a6b",
|
|
25
25
|
"mode": "100644"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
},
|
|
102
102
|
{
|
|
103
103
|
"path": "docs/funnelsgrove/migrations/step-contract-v3.md",
|
|
104
|
-
"sha256": "
|
|
104
|
+
"sha256": "f0960bc044d9c4e5a550e5bc968fefd0840c03829ecb94348736798fc8fa9d1b",
|
|
105
105
|
"mode": "100644"
|
|
106
106
|
},
|
|
107
107
|
{
|
|
@@ -121,7 +121,7 @@
|
|
|
121
121
|
},
|
|
122
122
|
{
|
|
123
123
|
"path": "docs/funnelsgrove/qa/publish.md",
|
|
124
|
-
"sha256": "
|
|
124
|
+
"sha256": "67391a8bf5e1ddeab2e7430f48a589c28ce5fb986f06fee74f78f09649086603",
|
|
125
125
|
"mode": "100644"
|
|
126
126
|
},
|
|
127
127
|
{
|
|
@@ -236,7 +236,7 @@
|
|
|
236
236
|
},
|
|
237
237
|
{
|
|
238
238
|
"path": "funnel-docs.config.json",
|
|
239
|
-
"sha256": "
|
|
239
|
+
"sha256": "57bb326172c83897a6656615a8ddc1b19bc9eeee808cd07f33ec2fb708102942",
|
|
240
240
|
"mode": "100644"
|
|
241
241
|
},
|
|
242
242
|
{
|
|
@@ -261,12 +261,12 @@
|
|
|
261
261
|
},
|
|
262
262
|
{
|
|
263
263
|
"path": "package-lock.json",
|
|
264
|
-
"sha256": "
|
|
264
|
+
"sha256": "868bf077f8518811654f8121fb1490a4c8d5817d572bc6d37f672e1a2e68f076",
|
|
265
265
|
"mode": "100644"
|
|
266
266
|
},
|
|
267
267
|
{
|
|
268
268
|
"path": "package.json",
|
|
269
|
-
"sha256": "
|
|
269
|
+
"sha256": "64fd73809a410d0310f6763b4c2d3a9b688c5cd8fd3423686cf23197a04eaadc",
|
|
270
270
|
"mode": "100644"
|
|
271
271
|
},
|
|
272
272
|
{
|
|
@@ -29,7 +29,7 @@ This file is generated from the FunnelsGrove step contract. Start at [the agent
|
|
|
29
29
|
|
|
30
30
|
1. Before edits run `fgrove status`, `git status --short`, and `fgrove github status` when the funnel is GitHub-connected.
|
|
31
31
|
2. Never run `fgrove sync down` over changed synced source. Use `--force` only to intentionally discard those local changes.
|
|
32
|
-
3. Sync-up
|
|
32
|
+
3. Sync-up atomically patches changed paths through the base draft version, uploads changed `public/` images directly, and safely replays retries. Disjoint remote edits rebase automatically; on a same-path conflict, run `fgrove sync rebase`, review the merge, rerun checks, and retry.
|
|
33
33
|
4. GitHub-connected changes use git push, `fgrove github pull`, terminal status, then publish; never use `fgrove sync up` for the same diff. Non-GitHub funnels use `fgrove sync up`.
|
|
34
34
|
5. Use `fgrove env pull` when only the ignored `.env` must be refreshed. Environment files never belong in synced source.
|
|
35
35
|
|
|
@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
|
|
|
17
17
|
|
|
18
18
|
### Package release order
|
|
19
19
|
|
|
20
|
-
Release `@funnelsgrove/runtime` `0.7.
|
|
20
|
+
Release `@funnelsgrove/runtime` `0.7.28` first, then `@funnelsgrove/analytics` `0.1.77`, then `@funnelsgrove/payments` `0.7.19`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.146`, 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.
|
|
21
21
|
<!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
|
|
22
22
|
|
|
23
23
|
## Version-last policy
|
|
@@ -22,6 +22,7 @@ Contract hash: `d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf
|
|
|
22
22
|
1. Run `fgrove status`, `git status --short`, tests, lint, `fgrove validate`, and relevant local/analytics/payment QA.
|
|
23
23
|
2. Choose exactly one source path. GitHub-connected funnels use git push, `fgrove github pull`, terminal status, then publish; never use `fgrove sync up` for the same diff. Non-GitHub funnels use `fgrove sync up`.
|
|
24
24
|
3. Publish preview with a clear message.
|
|
25
|
+
`fgrove publish` reports validation, GitHub sync, queue, build, image optimization, and upload progress on stderr; its final URL/version row remains the only stdout output. If compatibility guidance requests a newer CLI, run `fgrove update` so every NVM/Homebrew installation visible on `PATH` is updated together.
|
|
25
26
|
4. Test the preview URL across supported breakpoints and real navigation entry points.
|
|
26
27
|
5. Confirm preview-mode suppression and production configuration separation.
|
|
27
28
|
6. Review route, analytics, answer, experiment, and payment evidence.
|
|
@@ -8,9 +8,9 @@
|
|
|
8
8
|
"name": "funnel-template",
|
|
9
9
|
"version": "0.1.0",
|
|
10
10
|
"dependencies": {
|
|
11
|
-
"@funnelsgrove/analytics": "^0.1.
|
|
11
|
+
"@funnelsgrove/analytics": "^0.1.77",
|
|
12
12
|
"@funnelsgrove/payments": "^0.7.19",
|
|
13
|
-
"@funnelsgrove/runtime": "^0.7.
|
|
13
|
+
"@funnelsgrove/runtime": "^0.7.28",
|
|
14
14
|
"@stripe/react-stripe-js": "^5.6.0",
|
|
15
15
|
"@stripe/stripe-js": "^8.7.0",
|
|
16
16
|
"lucide-react": "^0.553.0",
|
|
@@ -938,11 +938,11 @@
|
|
|
938
938
|
}
|
|
939
939
|
},
|
|
940
940
|
"node_modules/@funnelsgrove/analytics": {
|
|
941
|
-
"version": "0.1.
|
|
942
|
-
"resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.
|
|
943
|
-
"integrity": "sha512-
|
|
941
|
+
"version": "0.1.77",
|
|
942
|
+
"resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.77.tgz",
|
|
943
|
+
"integrity": "sha512-vzE3DSBWplM0SS0xx2sDIdsBFNF+Rz8JWsDVFrztqPpN0llRzx4BpEXoA8zvo/x0hERQ5XXPHmT0AYVTG3FDsw==",
|
|
944
944
|
"dependencies": {
|
|
945
|
-
"@funnelsgrove/runtime": "0.7.
|
|
945
|
+
"@funnelsgrove/runtime": "0.7.28"
|
|
946
946
|
}
|
|
947
947
|
},
|
|
948
948
|
"node_modules/@funnelsgrove/payments": {
|
|
@@ -961,9 +961,9 @@
|
|
|
961
961
|
}
|
|
962
962
|
},
|
|
963
963
|
"node_modules/@funnelsgrove/runtime": {
|
|
964
|
-
"version": "0.7.
|
|
965
|
-
"resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.
|
|
966
|
-
"integrity": "sha512-
|
|
964
|
+
"version": "0.7.28",
|
|
965
|
+
"resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.7.28.tgz",
|
|
966
|
+
"integrity": "sha512-pHN8nCWDMj7WSwKiTsLwyhEm0uEo/Q1w05ODz6R4qW8E8BzidRDtR2hPDJKy90PQEuMVqViNMuOVAOh85PsDsw==",
|
|
967
967
|
"dependencies": {
|
|
968
968
|
"posthog-js": "^1.369.2",
|
|
969
969
|
"react": "19.2.3",
|