@speedkit/cli 4.52.1 → 4.52.3

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.
@@ -3543,12 +3543,14 @@
3543
3543
  "tabs.js"
3544
3544
  ]
3545
3545
  },
3546
- "onboarding:cache:clear": {
3546
+ "onboarding:inject:add": {
3547
3547
  "aliases": [],
3548
3548
  "args": {},
3549
- "description": "Empty the local documentHandler cache of a live run",
3549
+ "description": "Inject a script into every navigation, from before the site's own scripts run",
3550
3550
  "examples": [
3551
- "$ sk onboarding cache clear"
3551
+ "$ sk onboarding inject add --recipe mark-timeline",
3552
+ "$ sk onboarding inject add --recipe spy --param path=dataLayer.push",
3553
+ "$ sk onboarding inject add --source 'record(window.SpeedKit?.lastNavigate)' --ttl 0"
3552
3554
  ],
3553
3555
  "flags": {
3554
3556
  "run": {
@@ -3570,11 +3572,49 @@
3570
3572
  "hasDynamicHelp": false,
3571
3573
  "multiple": false,
3572
3574
  "type": "option"
3575
+ },
3576
+ "recipe": {
3577
+ "description": "A recipe from `recipes`. Exclusive with --source",
3578
+ "exclusive": [
3579
+ "source"
3580
+ ],
3581
+ "name": "recipe",
3582
+ "hasDynamicHelp": false,
3583
+ "multiple": false,
3584
+ "type": "option"
3585
+ },
3586
+ "param": {
3587
+ "description": "A recipe argument as name=value; repeat for several. The value is read as JSON when it parses, else as a string",
3588
+ "name": "param",
3589
+ "hasDynamicHelp": false,
3590
+ "multiple": true,
3591
+ "type": "option"
3592
+ },
3593
+ "source": {
3594
+ "description": "Raw JavaScript, run inside the envelope; call record(value) to buffer something. Reach globals through window",
3595
+ "name": "source",
3596
+ "hasDynamicHelp": false,
3597
+ "multiple": false,
3598
+ "type": "option"
3599
+ },
3600
+ "ttl": {
3601
+ "description": "Minutes until it removes itself. Default 30; 0 for no expiry",
3602
+ "name": "ttl",
3603
+ "hasDynamicHelp": false,
3604
+ "multiple": false,
3605
+ "type": "option"
3606
+ },
3607
+ "tab": {
3608
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3609
+ "name": "tab",
3610
+ "hasDynamicHelp": false,
3611
+ "multiple": false,
3612
+ "type": "option"
3573
3613
  }
3574
3614
  },
3575
3615
  "hasDynamicHelp": false,
3576
3616
  "hiddenAliases": [],
3577
- "id": "onboarding:cache:clear",
3617
+ "id": "onboarding:inject:add",
3578
3618
  "pluginAlias": "@speedkit/cli",
3579
3619
  "pluginName": "@speedkit/cli",
3580
3620
  "pluginType": "core",
@@ -3584,16 +3624,16 @@
3584
3624
  "dist",
3585
3625
  "commands",
3586
3626
  "onboarding",
3587
- "cache",
3588
- "clear.js"
3627
+ "inject",
3628
+ "add.js"
3589
3629
  ]
3590
3630
  },
3591
- "onboarding:cache:errors": {
3631
+ "onboarding:inject:clear": {
3592
3632
  "aliases": [],
3593
3633
  "args": {},
3594
- "description": "List the urls the documentHandler is currently failing to build",
3634
+ "description": "Take every injected script out",
3595
3635
  "examples": [
3596
- "$ sk onboarding cache errors"
3636
+ "$ sk onboarding inject clear"
3597
3637
  ],
3598
3638
  "flags": {
3599
3639
  "run": {
@@ -3615,11 +3655,18 @@
3615
3655
  "hasDynamicHelp": false,
3616
3656
  "multiple": false,
3617
3657
  "type": "option"
3658
+ },
3659
+ "tab": {
3660
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3661
+ "name": "tab",
3662
+ "hasDynamicHelp": false,
3663
+ "multiple": false,
3664
+ "type": "option"
3618
3665
  }
3619
3666
  },
3620
3667
  "hasDynamicHelp": false,
3621
3668
  "hiddenAliases": [],
3622
- "id": "onboarding:cache:errors",
3669
+ "id": "onboarding:inject:clear",
3623
3670
  "pluginAlias": "@speedkit/cli",
3624
3671
  "pluginName": "@speedkit/cli",
3625
3672
  "pluginType": "core",
@@ -3629,22 +3676,16 @@
3629
3676
  "dist",
3630
3677
  "commands",
3631
3678
  "onboarding",
3632
- "cache",
3633
- "errors.js"
3679
+ "inject",
3680
+ "clear.js"
3634
3681
  ]
3635
3682
  },
3636
- "onboarding:cache:evict": {
3683
+ "onboarding:inject:list": {
3637
3684
  "aliases": [],
3638
- "args": {
3639
- "key": {
3640
- "description": "Matched as a substring: a homepage url can take every url on the site. The answer names every key that went",
3641
- "name": "key",
3642
- "required": true
3643
- }
3644
- },
3645
- "description": "Drop the cached entries whose key contains the given string, so the next request rebuilds them",
3685
+ "args": {},
3686
+ "description": "List what is injected on a live run",
3646
3687
  "examples": [
3647
- "$ sk onboarding cache evict /p/123"
3688
+ "$ sk onboarding inject list"
3648
3689
  ],
3649
3690
  "flags": {
3650
3691
  "run": {
@@ -3666,11 +3707,18 @@
3666
3707
  "hasDynamicHelp": false,
3667
3708
  "multiple": false,
3668
3709
  "type": "option"
3710
+ },
3711
+ "tab": {
3712
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3713
+ "name": "tab",
3714
+ "hasDynamicHelp": false,
3715
+ "multiple": false,
3716
+ "type": "option"
3669
3717
  }
3670
3718
  },
3671
3719
  "hasDynamicHelp": false,
3672
3720
  "hiddenAliases": [],
3673
- "id": "onboarding:cache:evict",
3721
+ "id": "onboarding:inject:list",
3674
3722
  "pluginAlias": "@speedkit/cli",
3675
3723
  "pluginName": "@speedkit/cli",
3676
3724
  "pluginType": "core",
@@ -3680,24 +3728,22 @@
3680
3728
  "dist",
3681
3729
  "commands",
3682
3730
  "onboarding",
3683
- "cache",
3684
- "evict.js"
3731
+ "inject",
3732
+ "list.js"
3685
3733
  ]
3686
3734
  },
3687
- "onboarding:cache:get": {
3735
+ "onboarding:inject:read": {
3688
3736
  "aliases": [],
3689
3737
  "args": {
3690
- "key": {
3691
- "description": "A cache key, or an origin url that names exactly one entry. An ambiguous one is refused with the candidates",
3692
- "name": "key",
3693
- "required": true
3738
+ "preload": {
3739
+ "description": "The preload id, e.g. p1. Without one, the answer names them",
3740
+ "name": "preload"
3694
3741
  }
3695
3742
  },
3696
- "description": "Read one cached entry. The body goes to a file; --select and --grep answer what is in it",
3743
+ "description": "Drain what an injected script recorded, newest last",
3697
3744
  "examples": [
3698
- "$ sk onboarding cache get https://www.decathlon.de/",
3699
- "$ sk onboarding cache get https://www.decathlon.de/ --select 'script[src*=\"analytics\"]'",
3700
- "$ sk onboarding cache get /p/123 --grep storeId"
3745
+ "$ sk onboarding inject read p1",
3746
+ "$ sk onboarding inject read p1 --limit 20 --json"
3701
3747
  ],
3702
3748
  "flags": {
3703
3749
  "run": {
@@ -3720,31 +3766,16 @@
3720
3766
  "multiple": false,
3721
3767
  "type": "option"
3722
3768
  },
3723
- "variation": {
3724
- "char": "v",
3725
- "description": "Only this variation's entry, e.g. mobile; default for the one without. With an origin url, names one entry without a cache key",
3726
- "name": "variation",
3727
- "hasDynamicHelp": false,
3728
- "multiple": false,
3729
- "type": "option"
3730
- },
3731
- "select": {
3732
- "description": "Count and sample what this CSS selector matches in the body",
3733
- "name": "select",
3734
- "hasDynamicHelp": false,
3735
- "multiple": false,
3736
- "type": "option"
3737
- },
3738
- "grep": {
3739
- "description": "Match this regular expression against the body, line by line",
3740
- "name": "grep",
3769
+ "limit": {
3770
+ "description": "How many records, newest last. Default 100",
3771
+ "name": "limit",
3741
3772
  "hasDynamicHelp": false,
3742
3773
  "multiple": false,
3743
3774
  "type": "option"
3744
3775
  },
3745
- "maxMatches": {
3746
- "description": "How many select/grep matches to sample. Default 10",
3747
- "name": "maxMatches",
3776
+ "tab": {
3777
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3778
+ "name": "tab",
3748
3779
  "hasDynamicHelp": false,
3749
3780
  "multiple": false,
3750
3781
  "type": "option"
@@ -3752,7 +3783,7 @@
3752
3783
  },
3753
3784
  "hasDynamicHelp": false,
3754
3785
  "hiddenAliases": [],
3755
- "id": "onboarding:cache:get",
3786
+ "id": "onboarding:inject:read",
3756
3787
  "pluginAlias": "@speedkit/cli",
3757
3788
  "pluginName": "@speedkit/cli",
3758
3789
  "pluginType": "core",
@@ -3762,17 +3793,16 @@
3762
3793
  "dist",
3763
3794
  "commands",
3764
3795
  "onboarding",
3765
- "cache",
3766
- "get.js"
3796
+ "inject",
3797
+ "read.js"
3767
3798
  ]
3768
3799
  },
3769
- "onboarding:cache:list": {
3800
+ "onboarding:inject:recipes": {
3770
3801
  "aliases": [],
3771
3802
  "args": {},
3772
- "description": "List what the local documentHandler cache of a live run holds",
3803
+ "description": "List the scripts that can be injected, and what each one takes",
3773
3804
  "examples": [
3774
- "$ sk onboarding cache list",
3775
- "$ sk onboarding cache list --run decathlon.de --json"
3805
+ "$ sk onboarding inject recipes"
3776
3806
  ],
3777
3807
  "flags": {
3778
3808
  "run": {
@@ -3794,11 +3824,18 @@
3794
3824
  "hasDynamicHelp": false,
3795
3825
  "multiple": false,
3796
3826
  "type": "option"
3827
+ },
3828
+ "tab": {
3829
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3830
+ "name": "tab",
3831
+ "hasDynamicHelp": false,
3832
+ "multiple": false,
3833
+ "type": "option"
3797
3834
  }
3798
3835
  },
3799
3836
  "hasDynamicHelp": false,
3800
3837
  "hiddenAliases": [],
3801
- "id": "onboarding:cache:list",
3838
+ "id": "onboarding:inject:recipes",
3802
3839
  "pluginAlias": "@speedkit/cli",
3803
3840
  "pluginName": "@speedkit/cli",
3804
3841
  "pluginType": "core",
@@ -3808,23 +3845,22 @@
3808
3845
  "dist",
3809
3846
  "commands",
3810
3847
  "onboarding",
3811
- "cache",
3812
- "list.js"
3848
+ "inject",
3849
+ "recipes.js"
3813
3850
  ]
3814
3851
  },
3815
- "onboarding:cache:prewarm": {
3852
+ "onboarding:inject:remove": {
3816
3853
  "aliases": [],
3817
3854
  "args": {
3818
- "url": {
3819
- "description": "The page to build, absolute or relative to the origin the run is on. Taken verbatim: a query parameter is part of the identity",
3820
- "name": "url",
3855
+ "preload": {
3856
+ "description": "The preload id, e.g. p1. `list` names them",
3857
+ "name": "preload",
3821
3858
  "required": true
3822
3859
  }
3823
3860
  },
3824
- "description": "Build cache entries for a url nothing has requested: default, each --variation given, or every one with --all. An entry already cached, by a request or a config-change rebuild, is left as it is and reported as alreadyCached, not built",
3861
+ "description": "Take one injected script out, including the copy running in the page",
3825
3862
  "examples": [
3826
- "$ sk onboarding cache prewarm /p/123 -v default -v mobile",
3827
- "$ sk onboarding cache prewarm /p/123 --all"
3863
+ "$ sk onboarding inject remove p1"
3828
3864
  ],
3829
3865
  "flags": {
3830
3866
  "run": {
@@ -3847,27 +3883,17 @@
3847
3883
  "multiple": false,
3848
3884
  "type": "option"
3849
3885
  },
3850
- "all": {
3851
- "description": "Default, every variation the page has produced in this run, and every one the runtime config names. Not tablet unless the page made one",
3852
- "exclusive": [
3853
- "variation"
3854
- ],
3855
- "name": "all",
3856
- "allowNo": false,
3857
- "type": "boolean"
3858
- },
3859
- "variation": {
3860
- "char": "v",
3861
- "description": "A cache variation to build; repeat for several. Omitted means default alone; --all for every one",
3862
- "name": "variation",
3886
+ "tab": {
3887
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
3888
+ "name": "tab",
3863
3889
  "hasDynamicHelp": false,
3864
- "multiple": true,
3890
+ "multiple": false,
3865
3891
  "type": "option"
3866
3892
  }
3867
3893
  },
3868
3894
  "hasDynamicHelp": false,
3869
3895
  "hiddenAliases": [],
3870
- "id": "onboarding:cache:prewarm",
3896
+ "id": "onboarding:inject:remove",
3871
3897
  "pluginAlias": "@speedkit/cli",
3872
3898
  "pluginName": "@speedkit/cli",
3873
3899
  "pluginType": "core",
@@ -3877,23 +3903,17 @@
3877
3903
  "dist",
3878
3904
  "commands",
3879
3905
  "onboarding",
3880
- "cache",
3881
- "prewarm.js"
3906
+ "inject",
3907
+ "remove.js"
3882
3908
  ]
3883
3909
  },
3884
- "onboarding:cache:refresh": {
3910
+ "onboarding:rum:beacons": {
3885
3911
  "aliases": [],
3886
- "args": {
3887
- "key": {
3888
- "description": "Which entries to rebuild: a cache key or an origin url. Omit for all",
3889
- "name": "key",
3890
- "required": false
3891
- }
3892
- },
3893
- "description": "Rebuild cached entries from origin and say whether the origin's bytes changed",
3912
+ "args": {},
3913
+ "description": "The RUM beacons as they left the page — which one carried a field, and when. --follow watches while you act",
3894
3914
  "examples": [
3895
- "$ sk onboarding cache refresh",
3896
- "$ sk onboarding cache refresh https://www.decathlon.de/"
3915
+ "$ sk onboarding rum beacons",
3916
+ "$ sk onboarding rum beacons --key addToCart --follow"
3897
3917
  ],
3898
3918
  "flags": {
3899
3919
  "run": {
@@ -3915,11 +3935,32 @@
3915
3935
  "hasDynamicHelp": false,
3916
3936
  "multiple": false,
3917
3937
  "type": "option"
3938
+ },
3939
+ "key": {
3940
+ "description": "Only beacons carrying this field, anywhere in the payload, with its value",
3941
+ "name": "key",
3942
+ "hasDynamicHelp": false,
3943
+ "multiple": false,
3944
+ "type": "option"
3945
+ },
3946
+ "follow": {
3947
+ "char": "f",
3948
+ "description": "Keep printing new beacons until Ctrl+C: act, and watch",
3949
+ "name": "follow",
3950
+ "allowNo": false,
3951
+ "type": "boolean"
3952
+ },
3953
+ "sinceSeq": {
3954
+ "description": "Only beacons after this sequence number",
3955
+ "name": "sinceSeq",
3956
+ "hasDynamicHelp": false,
3957
+ "multiple": false,
3958
+ "type": "option"
3918
3959
  }
3919
3960
  },
3920
3961
  "hasDynamicHelp": false,
3921
3962
  "hiddenAliases": [],
3922
- "id": "onboarding:cache:refresh",
3963
+ "id": "onboarding:rum:beacons",
3923
3964
  "pluginAlias": "@speedkit/cli",
3924
3965
  "pluginName": "@speedkit/cli",
3925
3966
  "pluginType": "core",
@@ -3929,18 +3970,17 @@
3929
3970
  "dist",
3930
3971
  "commands",
3931
3972
  "onboarding",
3932
- "cache",
3933
- "refresh.js"
3973
+ "rum",
3974
+ "beacons.js"
3934
3975
  ]
3935
3976
  },
3936
- "onboarding:debug:arm": {
3977
+ "onboarding:rum:get": {
3937
3978
  "aliases": [],
3938
3979
  "args": {},
3939
- "description": "Arm breakpoints in the Speed Kit page lifecycle and, by default, reload so they can fire",
3980
+ "description": "Read what Speed Kit tracked for the page: sent data only, unless --flush",
3940
3981
  "examples": [
3941
- "$ sk onboarding debug arm",
3942
- "$ sk onboarding debug arm --bp 3 --then next-nav",
3943
- "$ sk onboarding debug arm --bp 1 --compared"
3982
+ "$ sk onboarding rum get",
3983
+ "$ sk onboarding rum get --key pageType --key variation"
3944
3984
  ],
3945
3985
  "flags": {
3946
3986
  "run": {
@@ -3963,29 +4003,16 @@
3963
4003
  "multiple": false,
3964
4004
  "type": "option"
3965
4005
  },
3966
- "bp": {
3967
- "description": "Which breakpoint, 1–4; repeat for several. Omitted arms all four",
3968
- "name": "bp",
4006
+ "key": {
4007
+ "description": "Only this field; repeat for several",
4008
+ "name": "key",
3969
4009
  "hasDynamicHelp": false,
3970
4010
  "multiple": true,
3971
4011
  "type": "option"
3972
4012
  },
3973
- "then": {
3974
- "description": "reload: load the page again, as a navigation (Speed Kit does not serve a reload from cache). next-nav: catch the next navigation. none: only arm",
3975
- "name": "then",
3976
- "default": "reload",
3977
- "hasDynamicHelp": false,
3978
- "multiple": false,
3979
- "options": [
3980
- "reload",
3981
- "next-nav",
3982
- "none"
3983
- ],
3984
- "type": "option"
3985
- },
3986
- "compared": {
3987
- "description": "Pause BP1 and BP3 where their change-detection pass compares, and expose both sides as window.__skCD",
3988
- "name": "compared",
4013
+ "flush": {
4014
+ "description": "Force a send first, so nothing is missing. It ends the impression being measured: prefer `rum key`",
4015
+ "name": "flush",
3989
4016
  "allowNo": false,
3990
4017
  "type": "boolean"
3991
4018
  },
@@ -3999,7 +4026,7 @@
3999
4026
  },
4000
4027
  "hasDynamicHelp": false,
4001
4028
  "hiddenAliases": [],
4002
- "id": "onboarding:debug:arm",
4029
+ "id": "onboarding:rum:get",
4003
4030
  "pluginAlias": "@speedkit/cli",
4004
4031
  "pluginName": "@speedkit/cli",
4005
4032
  "pluginType": "core",
@@ -4009,17 +4036,22 @@
4009
4036
  "dist",
4010
4037
  "commands",
4011
4038
  "onboarding",
4012
- "debug",
4013
- "arm.js"
4039
+ "rum",
4040
+ "get.js"
4014
4041
  ]
4015
4042
  },
4016
- "onboarding:debug:await": {
4043
+ "onboarding:rum:key": {
4017
4044
  "aliases": [],
4018
- "args": {},
4019
- "description": "Wait until a breakpoint pauses the page, and say what silence means if none does",
4045
+ "args": {
4046
+ "key": {
4047
+ "description": "The RUM field, e.g. a custom dimension. Unsent data included",
4048
+ "name": "key",
4049
+ "required": true
4050
+ }
4051
+ },
4052
+ "description": "Read one RUM field, unsent data included, without ending the impression",
4020
4053
  "examples": [
4021
- "$ sk onboarding debug await",
4022
- "$ sk onboarding debug await --wait 30000"
4054
+ "$ sk onboarding rum key myCustomDimension"
4023
4055
  ],
4024
4056
  "flags": {
4025
4057
  "run": {
@@ -4042,13 +4074,6 @@
4042
4074
  "multiple": false,
4043
4075
  "type": "option"
4044
4076
  },
4045
- "wait": {
4046
- "description": "How long to wait for a pause, in ms. Default 15000",
4047
- "name": "wait",
4048
- "hasDynamicHelp": false,
4049
- "multiple": false,
4050
- "type": "option"
4051
- },
4052
4077
  "tab": {
4053
4078
  "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4054
4079
  "name": "tab",
@@ -4059,7 +4084,7 @@
4059
4084
  },
4060
4085
  "hasDynamicHelp": false,
4061
4086
  "hiddenAliases": [],
4062
- "id": "onboarding:debug:await",
4087
+ "id": "onboarding:rum:key",
4063
4088
  "pluginAlias": "@speedkit/cli",
4064
4089
  "pluginName": "@speedkit/cli",
4065
4090
  "pluginType": "core",
@@ -4069,16 +4094,16 @@
4069
4094
  "dist",
4070
4095
  "commands",
4071
4096
  "onboarding",
4072
- "debug",
4073
- "await.js"
4097
+ "rum",
4098
+ "key.js"
4074
4099
  ]
4075
4100
  },
4076
- "onboarding:debug:disarm": {
4101
+ "onboarding:rum:previous": {
4077
4102
  "aliases": [],
4078
4103
  "args": {},
4079
- "description": "Take every breakpoint this run armed out of the page",
4104
+ "description": "Read the previous page impression: on an SPA, the one that loaded the page",
4080
4105
  "examples": [
4081
- "$ sk onboarding debug disarm"
4106
+ "$ sk onboarding rum previous"
4082
4107
  ],
4083
4108
  "flags": {
4084
4109
  "run": {
@@ -4111,7 +4136,7 @@
4111
4136
  },
4112
4137
  "hasDynamicHelp": false,
4113
4138
  "hiddenAliases": [],
4114
- "id": "onboarding:debug:disarm",
4139
+ "id": "onboarding:rum:previous",
4115
4140
  "pluginAlias": "@speedkit/cli",
4116
4141
  "pluginName": "@speedkit/cli",
4117
4142
  "pluginType": "core",
@@ -4121,23 +4146,16 @@
4121
4146
  "dist",
4122
4147
  "commands",
4123
4148
  "onboarding",
4124
- "debug",
4125
- "disarm.js"
4149
+ "rum",
4150
+ "previous.js"
4126
4151
  ]
4127
4152
  },
4128
- "onboarding:debug:eval": {
4153
+ "onboarding:cache:clear": {
4129
4154
  "aliases": [],
4130
- "args": {
4131
- "expression": {
4132
- "description": "JavaScript, evaluated on the paused frame when paused (its locals are in scope), in the page otherwise. Or --file",
4133
- "name": "expression",
4134
- "required": false
4135
- }
4136
- },
4137
- "description": "Evaluate JavaScript on the paused frame, or in the page when it is not paused",
4155
+ "args": {},
4156
+ "description": "Empty the local documentHandler cache of a live run",
4138
4157
  "examples": [
4139
- "$ sk onboarding debug eval 'document.documentElement.className'",
4140
- "$ sk onboarding debug eval --file probe.js"
4158
+ "$ sk onboarding cache clear"
4141
4159
  ],
4142
4160
  "flags": {
4143
4161
  "run": {
@@ -4159,26 +4177,11 @@
4159
4177
  "hasDynamicHelp": false,
4160
4178
  "multiple": false,
4161
4179
  "type": "option"
4162
- },
4163
- "file": {
4164
- "char": "f",
4165
- "description": "Read the JavaScript from this file instead: for anything longer than a line",
4166
- "name": "file",
4167
- "hasDynamicHelp": false,
4168
- "multiple": false,
4169
- "type": "option"
4170
- },
4171
- "tab": {
4172
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4173
- "name": "tab",
4174
- "hasDynamicHelp": false,
4175
- "multiple": false,
4176
- "type": "option"
4177
4180
  }
4178
4181
  },
4179
4182
  "hasDynamicHelp": false,
4180
4183
  "hiddenAliases": [],
4181
- "id": "onboarding:debug:eval",
4184
+ "id": "onboarding:cache:clear",
4182
4185
  "pluginAlias": "@speedkit/cli",
4183
4186
  "pluginName": "@speedkit/cli",
4184
4187
  "pluginType": "core",
@@ -4188,16 +4191,16 @@
4188
4191
  "dist",
4189
4192
  "commands",
4190
4193
  "onboarding",
4191
- "debug",
4192
- "eval.js"
4194
+ "cache",
4195
+ "clear.js"
4193
4196
  ]
4194
4197
  },
4195
- "onboarding:debug:release": {
4198
+ "onboarding:cache:errors": {
4196
4199
  "aliases": [],
4197
4200
  "args": {},
4198
- "description": "Get the page running, whoever paused it: disarm, clear the panel switches, resume a foreign pause",
4201
+ "description": "List the urls the documentHandler is currently failing to build",
4199
4202
  "examples": [
4200
- "$ sk onboarding debug release"
4203
+ "$ sk onboarding cache errors"
4201
4204
  ],
4202
4205
  "flags": {
4203
4206
  "run": {
@@ -4219,18 +4222,11 @@
4219
4222
  "hasDynamicHelp": false,
4220
4223
  "multiple": false,
4221
4224
  "type": "option"
4222
- },
4223
- "tab": {
4224
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4225
- "name": "tab",
4226
- "hasDynamicHelp": false,
4227
- "multiple": false,
4228
- "type": "option"
4229
4225
  }
4230
4226
  },
4231
4227
  "hasDynamicHelp": false,
4232
4228
  "hiddenAliases": [],
4233
- "id": "onboarding:debug:release",
4229
+ "id": "onboarding:cache:errors",
4234
4230
  "pluginAlias": "@speedkit/cli",
4235
4231
  "pluginName": "@speedkit/cli",
4236
4232
  "pluginType": "core",
@@ -4240,16 +4236,22 @@
4240
4236
  "dist",
4241
4237
  "commands",
4242
4238
  "onboarding",
4243
- "debug",
4244
- "release.js"
4239
+ "cache",
4240
+ "errors.js"
4245
4241
  ]
4246
4242
  },
4247
- "onboarding:debug:resume": {
4243
+ "onboarding:cache:evict": {
4248
4244
  "aliases": [],
4249
- "args": {},
4250
- "description": "Let a paused page continue",
4245
+ "args": {
4246
+ "key": {
4247
+ "description": "Matched as a substring: a homepage url can take every url on the site. The answer names every key that went",
4248
+ "name": "key",
4249
+ "required": true
4250
+ }
4251
+ },
4252
+ "description": "Drop the cached entries whose key contains the given string, so the next request rebuilds them",
4251
4253
  "examples": [
4252
- "$ sk onboarding debug resume"
4254
+ "$ sk onboarding cache evict /p/123"
4253
4255
  ],
4254
4256
  "flags": {
4255
4257
  "run": {
@@ -4271,18 +4273,11 @@
4271
4273
  "hasDynamicHelp": false,
4272
4274
  "multiple": false,
4273
4275
  "type": "option"
4274
- },
4275
- "tab": {
4276
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4277
- "name": "tab",
4278
- "hasDynamicHelp": false,
4279
- "multiple": false,
4280
- "type": "option"
4281
4276
  }
4282
4277
  },
4283
4278
  "hasDynamicHelp": false,
4284
4279
  "hiddenAliases": [],
4285
- "id": "onboarding:debug:resume",
4280
+ "id": "onboarding:cache:evict",
4286
4281
  "pluginAlias": "@speedkit/cli",
4287
4282
  "pluginName": "@speedkit/cli",
4288
4283
  "pluginType": "core",
@@ -4292,16 +4287,24 @@
4292
4287
  "dist",
4293
4288
  "commands",
4294
4289
  "onboarding",
4295
- "debug",
4296
- "resume.js"
4290
+ "cache",
4291
+ "evict.js"
4297
4292
  ]
4298
4293
  },
4299
- "onboarding:debug:status": {
4294
+ "onboarding:cache:get": {
4300
4295
  "aliases": [],
4301
- "args": {},
4302
- "description": "What is armed, what the page has reached, and who holds a pause",
4296
+ "args": {
4297
+ "key": {
4298
+ "description": "A cache key, or an origin url that names exactly one entry. An ambiguous one is refused with the candidates",
4299
+ "name": "key",
4300
+ "required": true
4301
+ }
4302
+ },
4303
+ "description": "Read one cached entry. The body goes to a file; --select and --grep answer what is in it",
4303
4304
  "examples": [
4304
- "$ sk onboarding debug status"
4305
+ "$ sk onboarding cache get https://www.decathlon.de/",
4306
+ "$ sk onboarding cache get https://www.decathlon.de/ --select 'script[src*=\"analytics\"]'",
4307
+ "$ sk onboarding cache get /p/123 --grep storeId"
4305
4308
  ],
4306
4309
  "flags": {
4307
4310
  "run": {
@@ -4324,72 +4327,31 @@
4324
4327
  "multiple": false,
4325
4328
  "type": "option"
4326
4329
  },
4327
- "tab": {
4328
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4329
- "name": "tab",
4330
+ "variation": {
4331
+ "char": "v",
4332
+ "description": "Only this variation's entry, e.g. mobile; default for the one without. With an origin url, names one entry without a cache key",
4333
+ "name": "variation",
4330
4334
  "hasDynamicHelp": false,
4331
4335
  "multiple": false,
4332
4336
  "type": "option"
4333
- }
4334
- },
4335
- "hasDynamicHelp": false,
4336
- "hiddenAliases": [],
4337
- "id": "onboarding:debug:status",
4338
- "pluginAlias": "@speedkit/cli",
4339
- "pluginName": "@speedkit/cli",
4340
- "pluginType": "core",
4341
- "strict": true,
4342
- "isESM": true,
4343
- "relativePath": [
4344
- "dist",
4345
- "commands",
4346
- "onboarding",
4347
- "debug",
4348
- "status.js"
4349
- ]
4350
- },
4351
- "onboarding:debug:step": {
4352
- "aliases": [],
4353
- "args": {
4354
- "kind": {
4355
- "description": "Step over, into or out of the current call",
4356
- "name": "kind",
4357
- "options": [
4358
- "over",
4359
- "into",
4360
- "out"
4361
- ],
4362
- "required": true
4363
- }
4364
- },
4365
- "description": "Step over, into or out of the current call of a paused page",
4366
- "examples": [
4367
- "$ sk onboarding debug step over"
4368
- ],
4369
- "flags": {
4370
- "run": {
4371
- "description": "Which run: its id, its customer name, or the path it was started with. Omit when exactly one run is live.",
4372
- "name": "run",
4337
+ },
4338
+ "select": {
4339
+ "description": "Count and sample what this CSS selector matches in the body",
4340
+ "name": "select",
4373
4341
  "hasDynamicHelp": false,
4374
4342
  "multiple": false,
4375
4343
  "type": "option"
4376
4344
  },
4377
- "json": {
4378
- "description": "The answer as one JSON document on stdout; a failure as { code, message } with exit code 1",
4379
- "name": "json",
4380
- "allowNo": false,
4381
- "type": "boolean"
4382
- },
4383
- "timeout": {
4384
- "description": "How long to wait for the run to answer, in ms. The default suits the op",
4385
- "name": "timeout",
4345
+ "grep": {
4346
+ "description": "Match this regular expression against the body, line by line",
4347
+ "name": "grep",
4386
4348
  "hasDynamicHelp": false,
4387
4349
  "multiple": false,
4388
4350
  "type": "option"
4389
4351
  },
4390
- "tab": {
4391
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4392
- "name": "tab",
4352
+ "maxMatches": {
4353
+ "description": "How many select/grep matches to sample. Default 10",
4354
+ "name": "maxMatches",
4393
4355
  "hasDynamicHelp": false,
4394
4356
  "multiple": false,
4395
4357
  "type": "option"
@@ -4397,7 +4359,7 @@
4397
4359
  },
4398
4360
  "hasDynamicHelp": false,
4399
4361
  "hiddenAliases": [],
4400
- "id": "onboarding:debug:step",
4362
+ "id": "onboarding:cache:get",
4401
4363
  "pluginAlias": "@speedkit/cli",
4402
4364
  "pluginName": "@speedkit/cli",
4403
4365
  "pluginType": "core",
@@ -4407,16 +4369,17 @@
4407
4369
  "dist",
4408
4370
  "commands",
4409
4371
  "onboarding",
4410
- "debug",
4411
- "step.js"
4372
+ "cache",
4373
+ "get.js"
4412
4374
  ]
4413
4375
  },
4414
- "onboarding:files:list": {
4376
+ "onboarding:cache:list": {
4415
4377
  "aliases": [],
4416
4378
  "args": {},
4417
- "description": "List the config files a live run is working with, including the ones it built in memory",
4379
+ "description": "List what the local documentHandler cache of a live run holds",
4418
4380
  "examples": [
4419
- "$ sk onboarding files list"
4381
+ "$ sk onboarding cache list",
4382
+ "$ sk onboarding cache list --run decathlon.de --json"
4420
4383
  ],
4421
4384
  "flags": {
4422
4385
  "run": {
@@ -4442,7 +4405,7 @@
4442
4405
  },
4443
4406
  "hasDynamicHelp": false,
4444
4407
  "hiddenAliases": [],
4445
- "id": "onboarding:files:list",
4408
+ "id": "onboarding:cache:list",
4446
4409
  "pluginAlias": "@speedkit/cli",
4447
4410
  "pluginName": "@speedkit/cli",
4448
4411
  "pluginType": "core",
@@ -4452,23 +4415,23 @@
4452
4415
  "dist",
4453
4416
  "commands",
4454
4417
  "onboarding",
4455
- "files",
4418
+ "cache",
4456
4419
  "list.js"
4457
4420
  ]
4458
4421
  },
4459
- "onboarding:files:read": {
4422
+ "onboarding:cache:prewarm": {
4460
4423
  "aliases": [],
4461
4424
  "args": {
4462
- "name": {
4463
- "description": "The logical name, e.g. config_SpeedKit, custom_documentHandler, bundle_install. `files list` names them",
4464
- "name": "name",
4425
+ "url": {
4426
+ "description": "The page to build, absolute or relative to the origin the run is on. Taken verbatim: a query parameter is part of the identity",
4427
+ "name": "url",
4465
4428
  "required": true
4466
4429
  }
4467
4430
  },
4468
- "description": "Read one config file as the run has it. The content goes to a file; --grep answers what is in it",
4431
+ "description": "Build cache entries for a url nothing has requested: default, each --variation given, or every one with --all. An entry already cached, by a request or a config-change rebuild, is left as it is and reported as alreadyCached, not built",
4469
4432
  "examples": [
4470
- "$ sk onboarding files read bundle_install --grep storeId",
4471
- "$ sk onboarding files read config_SpeedKit"
4433
+ "$ sk onboarding cache prewarm /p/123 -v default -v mobile",
4434
+ "$ sk onboarding cache prewarm /p/123 --all"
4472
4435
  ],
4473
4436
  "flags": {
4474
4437
  "run": {
@@ -4491,24 +4454,27 @@
4491
4454
  "multiple": false,
4492
4455
  "type": "option"
4493
4456
  },
4494
- "grep": {
4495
- "description": "Match this regular expression line by line: \"did my change survive the build\" of a minified bundle",
4496
- "name": "grep",
4497
- "hasDynamicHelp": false,
4498
- "multiple": false,
4499
- "type": "option"
4457
+ "all": {
4458
+ "description": "Default, every variation the page has produced in this run, and every one the runtime config names. Not tablet unless the page made one",
4459
+ "exclusive": [
4460
+ "variation"
4461
+ ],
4462
+ "name": "all",
4463
+ "allowNo": false,
4464
+ "type": "boolean"
4500
4465
  },
4501
- "maxMatches": {
4502
- "description": "How many grep matches to sample. Default 10",
4503
- "name": "maxMatches",
4466
+ "variation": {
4467
+ "char": "v",
4468
+ "description": "A cache variation to build; repeat for several. Omitted means default alone; --all for every one",
4469
+ "name": "variation",
4504
4470
  "hasDynamicHelp": false,
4505
- "multiple": false,
4471
+ "multiple": true,
4506
4472
  "type": "option"
4507
4473
  }
4508
4474
  },
4509
4475
  "hasDynamicHelp": false,
4510
4476
  "hiddenAliases": [],
4511
- "id": "onboarding:files:read",
4477
+ "id": "onboarding:cache:prewarm",
4512
4478
  "pluginAlias": "@speedkit/cli",
4513
4479
  "pluginName": "@speedkit/cli",
4514
4480
  "pluginType": "core",
@@ -4518,17 +4484,23 @@
4518
4484
  "dist",
4519
4485
  "commands",
4520
4486
  "onboarding",
4521
- "files",
4522
- "read.js"
4487
+ "cache",
4488
+ "prewarm.js"
4523
4489
  ]
4524
4490
  },
4525
- "onboarding:files:rebuild": {
4491
+ "onboarding:cache:refresh": {
4526
4492
  "aliases": [],
4527
- "args": {},
4528
- "description": "Rebuild the install resource, the documentHandler or both, as a file change would",
4493
+ "args": {
4494
+ "key": {
4495
+ "description": "Which entries to rebuild: a cache key or an origin url. Omit for all",
4496
+ "name": "key",
4497
+ "required": false
4498
+ }
4499
+ },
4500
+ "description": "Rebuild cached entries from origin and say whether the origin's bytes changed",
4529
4501
  "examples": [
4530
- "$ sk onboarding files rebuild",
4531
- "$ sk onboarding files rebuild --target documentHandler"
4502
+ "$ sk onboarding cache refresh",
4503
+ "$ sk onboarding cache refresh https://www.decathlon.de/"
4532
4504
  ],
4533
4505
  "flags": {
4534
4506
  "run": {
@@ -4550,24 +4522,11 @@
4550
4522
  "hasDynamicHelp": false,
4551
4523
  "multiple": false,
4552
4524
  "type": "option"
4553
- },
4554
- "target": {
4555
- "description": "install: the install resource, then a service worker reinstall. documentHandler: the DH bundle, emptying the dh-cache",
4556
- "name": "target",
4557
- "default": "all",
4558
- "hasDynamicHelp": false,
4559
- "multiple": false,
4560
- "options": [
4561
- "install",
4562
- "documentHandler",
4563
- "all"
4564
- ],
4565
- "type": "option"
4566
4525
  }
4567
4526
  },
4568
4527
  "hasDynamicHelp": false,
4569
4528
  "hiddenAliases": [],
4570
- "id": "onboarding:files:rebuild",
4529
+ "id": "onboarding:cache:refresh",
4571
4530
  "pluginAlias": "@speedkit/cli",
4572
4531
  "pluginName": "@speedkit/cli",
4573
4532
  "pluginType": "core",
@@ -4577,16 +4536,18 @@
4577
4536
  "dist",
4578
4537
  "commands",
4579
4538
  "onboarding",
4580
- "files",
4581
- "rebuild.js"
4539
+ "cache",
4540
+ "refresh.js"
4582
4541
  ]
4583
4542
  },
4584
- "onboarding:files:validate": {
4543
+ "onboarding:debug:arm": {
4585
4544
  "aliases": [],
4586
4545
  "args": {},
4587
- "description": "Check the customer config and the mandatory files",
4546
+ "description": "Arm breakpoints in the Speed Kit page lifecycle and, by default, reload so they can fire",
4588
4547
  "examples": [
4589
- "$ sk onboarding files validate"
4548
+ "$ sk onboarding debug arm",
4549
+ "$ sk onboarding debug arm --bp 3 --then next-nav",
4550
+ "$ sk onboarding debug arm --bp 1 --compared"
4590
4551
  ],
4591
4552
  "flags": {
4592
4553
  "run": {
@@ -4608,11 +4569,44 @@
4608
4569
  "hasDynamicHelp": false,
4609
4570
  "multiple": false,
4610
4571
  "type": "option"
4572
+ },
4573
+ "bp": {
4574
+ "description": "Which breakpoint, 1–4; repeat for several. Omitted arms all four",
4575
+ "name": "bp",
4576
+ "hasDynamicHelp": false,
4577
+ "multiple": true,
4578
+ "type": "option"
4579
+ },
4580
+ "then": {
4581
+ "description": "reload: load the page again, as a navigation (Speed Kit does not serve a reload from cache). next-nav: catch the next navigation. none: only arm",
4582
+ "name": "then",
4583
+ "default": "reload",
4584
+ "hasDynamicHelp": false,
4585
+ "multiple": false,
4586
+ "options": [
4587
+ "reload",
4588
+ "next-nav",
4589
+ "none"
4590
+ ],
4591
+ "type": "option"
4592
+ },
4593
+ "compared": {
4594
+ "description": "Pause BP1 and BP3 where their change-detection pass compares, and expose both sides as window.__skCD",
4595
+ "name": "compared",
4596
+ "allowNo": false,
4597
+ "type": "boolean"
4598
+ },
4599
+ "tab": {
4600
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4601
+ "name": "tab",
4602
+ "hasDynamicHelp": false,
4603
+ "multiple": false,
4604
+ "type": "option"
4611
4605
  }
4612
4606
  },
4613
4607
  "hasDynamicHelp": false,
4614
4608
  "hiddenAliases": [],
4615
- "id": "onboarding:files:validate",
4609
+ "id": "onboarding:debug:arm",
4616
4610
  "pluginAlias": "@speedkit/cli",
4617
4611
  "pluginName": "@speedkit/cli",
4618
4612
  "pluginType": "core",
@@ -4622,18 +4616,17 @@
4622
4616
  "dist",
4623
4617
  "commands",
4624
4618
  "onboarding",
4625
- "files",
4626
- "validate.js"
4619
+ "debug",
4620
+ "arm.js"
4627
4621
  ]
4628
4622
  },
4629
- "onboarding:inject:add": {
4623
+ "onboarding:debug:await": {
4630
4624
  "aliases": [],
4631
4625
  "args": {},
4632
- "description": "Inject a script into every navigation, from before the site's own scripts run",
4626
+ "description": "Wait until a breakpoint pauses the page, and say what silence means if none does",
4633
4627
  "examples": [
4634
- "$ sk onboarding inject add --recipe mark-timeline",
4635
- "$ sk onboarding inject add --recipe spy --param path=dataLayer.push",
4636
- "$ sk onboarding inject add --source 'record(window.SpeedKit?.lastNavigate)' --ttl 0"
4628
+ "$ sk onboarding debug await",
4629
+ "$ sk onboarding debug await --wait 30000"
4637
4630
  ],
4638
4631
  "flags": {
4639
4632
  "run": {
@@ -4656,33 +4649,61 @@
4656
4649
  "multiple": false,
4657
4650
  "type": "option"
4658
4651
  },
4659
- "recipe": {
4660
- "description": "A recipe from `recipes`. Exclusive with --source",
4661
- "exclusive": [
4662
- "source"
4663
- ],
4664
- "name": "recipe",
4652
+ "wait": {
4653
+ "description": "How long to wait for a pause, in ms. Default 15000",
4654
+ "name": "wait",
4665
4655
  "hasDynamicHelp": false,
4666
4656
  "multiple": false,
4667
4657
  "type": "option"
4668
4658
  },
4669
- "param": {
4670
- "description": "A recipe argument as name=value; repeat for several. The value is read as JSON when it parses, else as a string",
4671
- "name": "param",
4659
+ "tab": {
4660
+ "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4661
+ "name": "tab",
4672
4662
  "hasDynamicHelp": false,
4673
- "multiple": true,
4663
+ "multiple": false,
4674
4664
  "type": "option"
4675
- },
4676
- "source": {
4677
- "description": "Raw JavaScript, run inside the envelope; call record(value) to buffer something. Reach globals through window",
4678
- "name": "source",
4665
+ }
4666
+ },
4667
+ "hasDynamicHelp": false,
4668
+ "hiddenAliases": [],
4669
+ "id": "onboarding:debug:await",
4670
+ "pluginAlias": "@speedkit/cli",
4671
+ "pluginName": "@speedkit/cli",
4672
+ "pluginType": "core",
4673
+ "strict": true,
4674
+ "isESM": true,
4675
+ "relativePath": [
4676
+ "dist",
4677
+ "commands",
4678
+ "onboarding",
4679
+ "debug",
4680
+ "await.js"
4681
+ ]
4682
+ },
4683
+ "onboarding:debug:disarm": {
4684
+ "aliases": [],
4685
+ "args": {},
4686
+ "description": "Take every breakpoint this run armed out of the page",
4687
+ "examples": [
4688
+ "$ sk onboarding debug disarm"
4689
+ ],
4690
+ "flags": {
4691
+ "run": {
4692
+ "description": "Which run: its id, its customer name, or the path it was started with. Omit when exactly one run is live.",
4693
+ "name": "run",
4679
4694
  "hasDynamicHelp": false,
4680
4695
  "multiple": false,
4681
4696
  "type": "option"
4682
4697
  },
4683
- "ttl": {
4684
- "description": "Minutes until it removes itself. Default 30; 0 for no expiry",
4685
- "name": "ttl",
4698
+ "json": {
4699
+ "description": "The answer as one JSON document on stdout; a failure as { code, message } with exit code 1",
4700
+ "name": "json",
4701
+ "allowNo": false,
4702
+ "type": "boolean"
4703
+ },
4704
+ "timeout": {
4705
+ "description": "How long to wait for the run to answer, in ms. The default suits the op",
4706
+ "name": "timeout",
4686
4707
  "hasDynamicHelp": false,
4687
4708
  "multiple": false,
4688
4709
  "type": "option"
@@ -4697,7 +4718,7 @@
4697
4718
  },
4698
4719
  "hasDynamicHelp": false,
4699
4720
  "hiddenAliases": [],
4700
- "id": "onboarding:inject:add",
4721
+ "id": "onboarding:debug:disarm",
4701
4722
  "pluginAlias": "@speedkit/cli",
4702
4723
  "pluginName": "@speedkit/cli",
4703
4724
  "pluginType": "core",
@@ -4707,16 +4728,23 @@
4707
4728
  "dist",
4708
4729
  "commands",
4709
4730
  "onboarding",
4710
- "inject",
4711
- "add.js"
4731
+ "debug",
4732
+ "disarm.js"
4712
4733
  ]
4713
4734
  },
4714
- "onboarding:inject:clear": {
4735
+ "onboarding:debug:eval": {
4715
4736
  "aliases": [],
4716
- "args": {},
4717
- "description": "Take every injected script out",
4737
+ "args": {
4738
+ "expression": {
4739
+ "description": "JavaScript, evaluated on the paused frame when paused (its locals are in scope), in the page otherwise. Or --file",
4740
+ "name": "expression",
4741
+ "required": false
4742
+ }
4743
+ },
4744
+ "description": "Evaluate JavaScript on the paused frame, or in the page when it is not paused",
4718
4745
  "examples": [
4719
- "$ sk onboarding inject clear"
4746
+ "$ sk onboarding debug eval 'document.documentElement.className'",
4747
+ "$ sk onboarding debug eval --file probe.js"
4720
4748
  ],
4721
4749
  "flags": {
4722
4750
  "run": {
@@ -4739,6 +4767,14 @@
4739
4767
  "multiple": false,
4740
4768
  "type": "option"
4741
4769
  },
4770
+ "file": {
4771
+ "char": "f",
4772
+ "description": "Read the JavaScript from this file instead: for anything longer than a line",
4773
+ "name": "file",
4774
+ "hasDynamicHelp": false,
4775
+ "multiple": false,
4776
+ "type": "option"
4777
+ },
4742
4778
  "tab": {
4743
4779
  "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4744
4780
  "name": "tab",
@@ -4749,7 +4785,7 @@
4749
4785
  },
4750
4786
  "hasDynamicHelp": false,
4751
4787
  "hiddenAliases": [],
4752
- "id": "onboarding:inject:clear",
4788
+ "id": "onboarding:debug:eval",
4753
4789
  "pluginAlias": "@speedkit/cli",
4754
4790
  "pluginName": "@speedkit/cli",
4755
4791
  "pluginType": "core",
@@ -4759,16 +4795,16 @@
4759
4795
  "dist",
4760
4796
  "commands",
4761
4797
  "onboarding",
4762
- "inject",
4763
- "clear.js"
4798
+ "debug",
4799
+ "eval.js"
4764
4800
  ]
4765
4801
  },
4766
- "onboarding:inject:list": {
4802
+ "onboarding:debug:release": {
4767
4803
  "aliases": [],
4768
4804
  "args": {},
4769
- "description": "List what is injected on a live run",
4805
+ "description": "Get the page running, whoever paused it: disarm, clear the panel switches, resume a foreign pause",
4770
4806
  "examples": [
4771
- "$ sk onboarding inject list"
4807
+ "$ sk onboarding debug release"
4772
4808
  ],
4773
4809
  "flags": {
4774
4810
  "run": {
@@ -4801,7 +4837,7 @@
4801
4837
  },
4802
4838
  "hasDynamicHelp": false,
4803
4839
  "hiddenAliases": [],
4804
- "id": "onboarding:inject:list",
4840
+ "id": "onboarding:debug:release",
4805
4841
  "pluginAlias": "@speedkit/cli",
4806
4842
  "pluginName": "@speedkit/cli",
4807
4843
  "pluginType": "core",
@@ -4811,22 +4847,16 @@
4811
4847
  "dist",
4812
4848
  "commands",
4813
4849
  "onboarding",
4814
- "inject",
4815
- "list.js"
4850
+ "debug",
4851
+ "release.js"
4816
4852
  ]
4817
4853
  },
4818
- "onboarding:inject:read": {
4854
+ "onboarding:debug:resume": {
4819
4855
  "aliases": [],
4820
- "args": {
4821
- "preload": {
4822
- "description": "The preload id, e.g. p1. Without one, the answer names them",
4823
- "name": "preload"
4824
- }
4825
- },
4826
- "description": "Drain what an injected script recorded, newest last",
4856
+ "args": {},
4857
+ "description": "Let a paused page continue",
4827
4858
  "examples": [
4828
- "$ sk onboarding inject read p1",
4829
- "$ sk onboarding inject read p1 --limit 20 --json"
4859
+ "$ sk onboarding debug resume"
4830
4860
  ],
4831
4861
  "flags": {
4832
4862
  "run": {
@@ -4849,13 +4879,6 @@
4849
4879
  "multiple": false,
4850
4880
  "type": "option"
4851
4881
  },
4852
- "limit": {
4853
- "description": "How many records, newest last. Default 100",
4854
- "name": "limit",
4855
- "hasDynamicHelp": false,
4856
- "multiple": false,
4857
- "type": "option"
4858
- },
4859
4882
  "tab": {
4860
4883
  "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
4861
4884
  "name": "tab",
@@ -4866,7 +4889,7 @@
4866
4889
  },
4867
4890
  "hasDynamicHelp": false,
4868
4891
  "hiddenAliases": [],
4869
- "id": "onboarding:inject:read",
4892
+ "id": "onboarding:debug:resume",
4870
4893
  "pluginAlias": "@speedkit/cli",
4871
4894
  "pluginName": "@speedkit/cli",
4872
4895
  "pluginType": "core",
@@ -4876,16 +4899,16 @@
4876
4899
  "dist",
4877
4900
  "commands",
4878
4901
  "onboarding",
4879
- "inject",
4880
- "read.js"
4902
+ "debug",
4903
+ "resume.js"
4881
4904
  ]
4882
4905
  },
4883
- "onboarding:inject:recipes": {
4906
+ "onboarding:debug:status": {
4884
4907
  "aliases": [],
4885
4908
  "args": {},
4886
- "description": "List the scripts that can be injected, and what each one takes",
4909
+ "description": "What is armed, what the page has reached, and who holds a pause",
4887
4910
  "examples": [
4888
- "$ sk onboarding inject recipes"
4911
+ "$ sk onboarding debug status"
4889
4912
  ],
4890
4913
  "flags": {
4891
4914
  "run": {
@@ -4918,7 +4941,7 @@
4918
4941
  },
4919
4942
  "hasDynamicHelp": false,
4920
4943
  "hiddenAliases": [],
4921
- "id": "onboarding:inject:recipes",
4944
+ "id": "onboarding:debug:status",
4922
4945
  "pluginAlias": "@speedkit/cli",
4923
4946
  "pluginName": "@speedkit/cli",
4924
4947
  "pluginType": "core",
@@ -4928,22 +4951,27 @@
4928
4951
  "dist",
4929
4952
  "commands",
4930
4953
  "onboarding",
4931
- "inject",
4932
- "recipes.js"
4954
+ "debug",
4955
+ "status.js"
4933
4956
  ]
4934
4957
  },
4935
- "onboarding:inject:remove": {
4958
+ "onboarding:debug:step": {
4936
4959
  "aliases": [],
4937
4960
  "args": {
4938
- "preload": {
4939
- "description": "The preload id, e.g. p1. `list` names them",
4940
- "name": "preload",
4961
+ "kind": {
4962
+ "description": "Step over, into or out of the current call",
4963
+ "name": "kind",
4964
+ "options": [
4965
+ "over",
4966
+ "into",
4967
+ "out"
4968
+ ],
4941
4969
  "required": true
4942
4970
  }
4943
4971
  },
4944
- "description": "Take one injected script out, including the copy running in the page",
4972
+ "description": "Step over, into or out of the current call of a paused page",
4945
4973
  "examples": [
4946
- "$ sk onboarding inject remove p1"
4974
+ "$ sk onboarding debug step over"
4947
4975
  ],
4948
4976
  "flags": {
4949
4977
  "run": {
@@ -4976,7 +5004,7 @@
4976
5004
  },
4977
5005
  "hasDynamicHelp": false,
4978
5006
  "hiddenAliases": [],
4979
- "id": "onboarding:inject:remove",
5007
+ "id": "onboarding:debug:step",
4980
5008
  "pluginAlias": "@speedkit/cli",
4981
5009
  "pluginName": "@speedkit/cli",
4982
5010
  "pluginType": "core",
@@ -4986,17 +5014,16 @@
4986
5014
  "dist",
4987
5015
  "commands",
4988
5016
  "onboarding",
4989
- "inject",
4990
- "remove.js"
5017
+ "debug",
5018
+ "step.js"
4991
5019
  ]
4992
5020
  },
4993
- "onboarding:rum:beacons": {
5021
+ "onboarding:files:list": {
4994
5022
  "aliases": [],
4995
5023
  "args": {},
4996
- "description": "The RUM beacons as they left the page — which one carried a field, and when. --follow watches while you act",
5024
+ "description": "List the config files a live run is working with, including the ones it built in memory",
4997
5025
  "examples": [
4998
- "$ sk onboarding rum beacons",
4999
- "$ sk onboarding rum beacons --key addToCart --follow"
5026
+ "$ sk onboarding files list"
5000
5027
  ],
5001
5028
  "flags": {
5002
5029
  "run": {
@@ -5018,32 +5045,11 @@
5018
5045
  "hasDynamicHelp": false,
5019
5046
  "multiple": false,
5020
5047
  "type": "option"
5021
- },
5022
- "key": {
5023
- "description": "Only beacons carrying this field, anywhere in the payload, with its value",
5024
- "name": "key",
5025
- "hasDynamicHelp": false,
5026
- "multiple": false,
5027
- "type": "option"
5028
- },
5029
- "follow": {
5030
- "char": "f",
5031
- "description": "Keep printing new beacons until Ctrl+C: act, and watch",
5032
- "name": "follow",
5033
- "allowNo": false,
5034
- "type": "boolean"
5035
- },
5036
- "sinceSeq": {
5037
- "description": "Only beacons after this sequence number",
5038
- "name": "sinceSeq",
5039
- "hasDynamicHelp": false,
5040
- "multiple": false,
5041
- "type": "option"
5042
5048
  }
5043
5049
  },
5044
5050
  "hasDynamicHelp": false,
5045
5051
  "hiddenAliases": [],
5046
- "id": "onboarding:rum:beacons",
5052
+ "id": "onboarding:files:list",
5047
5053
  "pluginAlias": "@speedkit/cli",
5048
5054
  "pluginName": "@speedkit/cli",
5049
5055
  "pluginType": "core",
@@ -5053,17 +5059,23 @@
5053
5059
  "dist",
5054
5060
  "commands",
5055
5061
  "onboarding",
5056
- "rum",
5057
- "beacons.js"
5062
+ "files",
5063
+ "list.js"
5058
5064
  ]
5059
5065
  },
5060
- "onboarding:rum:get": {
5066
+ "onboarding:files:read": {
5061
5067
  "aliases": [],
5062
- "args": {},
5063
- "description": "Read what Speed Kit tracked for the page: sent data only, unless --flush",
5068
+ "args": {
5069
+ "name": {
5070
+ "description": "The logical name, e.g. config_SpeedKit, custom_documentHandler, bundle_install. `files list` names them",
5071
+ "name": "name",
5072
+ "required": true
5073
+ }
5074
+ },
5075
+ "description": "Read one config file as the run has it. The content goes to a file; --grep answers what is in it",
5064
5076
  "examples": [
5065
- "$ sk onboarding rum get",
5066
- "$ sk onboarding rum get --key pageType --key variation"
5077
+ "$ sk onboarding files read bundle_install --grep storeId",
5078
+ "$ sk onboarding files read config_SpeedKit"
5067
5079
  ],
5068
5080
  "flags": {
5069
5081
  "run": {
@@ -5086,22 +5098,16 @@
5086
5098
  "multiple": false,
5087
5099
  "type": "option"
5088
5100
  },
5089
- "key": {
5090
- "description": "Only this field; repeat for several",
5091
- "name": "key",
5101
+ "grep": {
5102
+ "description": "Match this regular expression line by line: \"did my change survive the build\" of a minified bundle",
5103
+ "name": "grep",
5092
5104
  "hasDynamicHelp": false,
5093
- "multiple": true,
5105
+ "multiple": false,
5094
5106
  "type": "option"
5095
5107
  },
5096
- "flush": {
5097
- "description": "Force a send first, so nothing is missing. It ends the impression being measured: prefer `rum key`",
5098
- "name": "flush",
5099
- "allowNo": false,
5100
- "type": "boolean"
5101
- },
5102
- "tab": {
5103
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
5104
- "name": "tab",
5108
+ "maxMatches": {
5109
+ "description": "How many grep matches to sample. Default 10",
5110
+ "name": "maxMatches",
5105
5111
  "hasDynamicHelp": false,
5106
5112
  "multiple": false,
5107
5113
  "type": "option"
@@ -5109,7 +5115,7 @@
5109
5115
  },
5110
5116
  "hasDynamicHelp": false,
5111
5117
  "hiddenAliases": [],
5112
- "id": "onboarding:rum:get",
5118
+ "id": "onboarding:files:read",
5113
5119
  "pluginAlias": "@speedkit/cli",
5114
5120
  "pluginName": "@speedkit/cli",
5115
5121
  "pluginType": "core",
@@ -5119,22 +5125,17 @@
5119
5125
  "dist",
5120
5126
  "commands",
5121
5127
  "onboarding",
5122
- "rum",
5123
- "get.js"
5128
+ "files",
5129
+ "read.js"
5124
5130
  ]
5125
5131
  },
5126
- "onboarding:rum:key": {
5132
+ "onboarding:files:rebuild": {
5127
5133
  "aliases": [],
5128
- "args": {
5129
- "key": {
5130
- "description": "The RUM field, e.g. a custom dimension. Unsent data included",
5131
- "name": "key",
5132
- "required": true
5133
- }
5134
- },
5135
- "description": "Read one RUM field, unsent data included, without ending the impression",
5134
+ "args": {},
5135
+ "description": "Rebuild the install resource, the documentHandler or both, as a file change would",
5136
5136
  "examples": [
5137
- "$ sk onboarding rum key myCustomDimension"
5137
+ "$ sk onboarding files rebuild",
5138
+ "$ sk onboarding files rebuild --target documentHandler"
5138
5139
  ],
5139
5140
  "flags": {
5140
5141
  "run": {
@@ -5157,17 +5158,23 @@
5157
5158
  "multiple": false,
5158
5159
  "type": "option"
5159
5160
  },
5160
- "tab": {
5161
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
5162
- "name": "tab",
5161
+ "target": {
5162
+ "description": "install: the install resource, then a service worker reinstall. documentHandler: the DH bundle, emptying the dh-cache",
5163
+ "name": "target",
5164
+ "default": "all",
5163
5165
  "hasDynamicHelp": false,
5164
5166
  "multiple": false,
5167
+ "options": [
5168
+ "install",
5169
+ "documentHandler",
5170
+ "all"
5171
+ ],
5165
5172
  "type": "option"
5166
5173
  }
5167
5174
  },
5168
5175
  "hasDynamicHelp": false,
5169
5176
  "hiddenAliases": [],
5170
- "id": "onboarding:rum:key",
5177
+ "id": "onboarding:files:rebuild",
5171
5178
  "pluginAlias": "@speedkit/cli",
5172
5179
  "pluginName": "@speedkit/cli",
5173
5180
  "pluginType": "core",
@@ -5177,16 +5184,16 @@
5177
5184
  "dist",
5178
5185
  "commands",
5179
5186
  "onboarding",
5180
- "rum",
5181
- "key.js"
5187
+ "files",
5188
+ "rebuild.js"
5182
5189
  ]
5183
5190
  },
5184
- "onboarding:rum:previous": {
5191
+ "onboarding:files:validate": {
5185
5192
  "aliases": [],
5186
5193
  "args": {},
5187
- "description": "Read the previous page impression: on an SPA, the one that loaded the page",
5194
+ "description": "Check the customer config and the mandatory files",
5188
5195
  "examples": [
5189
- "$ sk onboarding rum previous"
5196
+ "$ sk onboarding files validate"
5190
5197
  ],
5191
5198
  "flags": {
5192
5199
  "run": {
@@ -5208,18 +5215,11 @@
5208
5215
  "hasDynamicHelp": false,
5209
5216
  "multiple": false,
5210
5217
  "type": "option"
5211
- },
5212
- "tab": {
5213
- "description": "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
5214
- "name": "tab",
5215
- "hasDynamicHelp": false,
5216
- "multiple": false,
5217
- "type": "option"
5218
5218
  }
5219
5219
  },
5220
5220
  "hasDynamicHelp": false,
5221
5221
  "hiddenAliases": [],
5222
- "id": "onboarding:rum:previous",
5222
+ "id": "onboarding:files:validate",
5223
5223
  "pluginAlias": "@speedkit/cli",
5224
5224
  "pluginName": "@speedkit/cli",
5225
5225
  "pluginType": "core",
@@ -5229,10 +5229,10 @@
5229
5229
  "dist",
5230
5230
  "commands",
5231
5231
  "onboarding",
5232
- "rum",
5233
- "previous.js"
5232
+ "files",
5233
+ "validate.js"
5234
5234
  ]
5235
5235
  }
5236
5236
  },
5237
- "version": "4.52.1"
5237
+ "version": "4.52.3"
5238
5238
  }