@loopress/cli 0.31.0 → 0.32.0

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.
Files changed (72) hide show
  1. package/README.md +440 -221
  2. package/dist/commands/acf/diff.d.ts +2 -2
  3. package/dist/commands/acf/diff.js +3 -1
  4. package/dist/commands/acf/list.d.ts +1 -0
  5. package/dist/commands/acf/list.js +2 -1
  6. package/dist/commands/acf/pull.d.ts +1 -0
  7. package/dist/commands/acf/pull.js +2 -1
  8. package/dist/commands/acf/push.d.ts +7 -2
  9. package/dist/commands/acf/push.js +12 -4
  10. package/dist/commands/acf/rollback.d.ts +2 -2
  11. package/dist/commands/acf/rollback.js +3 -1
  12. package/dist/commands/composer/pull.js +1 -1
  13. package/dist/commands/diff.d.ts +1 -0
  14. package/dist/commands/diff.js +13 -2
  15. package/dist/commands/doctor.js +1 -1
  16. package/dist/commands/form/list.js +1 -1
  17. package/dist/commands/form/pull.js +1 -1
  18. package/dist/commands/form/push.d.ts +2 -1
  19. package/dist/commands/form/push.js +2 -2
  20. package/dist/commands/init.js +0 -23
  21. package/dist/commands/menu/push.d.ts +2 -1
  22. package/dist/commands/menu/push.js +1 -1
  23. package/dist/commands/option/push.d.ts +2 -1
  24. package/dist/commands/option/push.js +1 -1
  25. package/dist/commands/page/push.d.ts +4 -1
  26. package/dist/commands/page/push.js +40 -8
  27. package/dist/commands/pattern/push.js +1 -1
  28. package/dist/commands/pattern/rm.js +1 -1
  29. package/dist/commands/plugin/audit.js +1 -1
  30. package/dist/commands/plugin/push.js +1 -1
  31. package/dist/commands/plugin/status.js +1 -1
  32. package/dist/commands/pull.d.ts +1 -1
  33. package/dist/commands/pull.js +22 -10
  34. package/dist/commands/push.d.ts +2 -0
  35. package/dist/commands/push.js +29 -9
  36. package/dist/commands/snippet/list.js +1 -1
  37. package/dist/commands/snippet/pull.js +1 -1
  38. package/dist/commands/snippet/push.d.ts +2 -1
  39. package/dist/commands/snippet/push.js +2 -2
  40. package/dist/commands/theme/pull.js +1 -1
  41. package/dist/commands/theme/push.d.ts +1 -0
  42. package/dist/commands/theme/push.js +3 -3
  43. package/dist/commands/theme/style/push.d.ts +2 -1
  44. package/dist/commands/theme/style/push.js +4 -5
  45. package/dist/commands/theme/template/list.js +1 -1
  46. package/dist/commands/theme/template/push.d.ts +11 -1
  47. package/dist/commands/theme/template/push.js +34 -5
  48. package/dist/commands/theme/version/push.js +1 -1
  49. package/dist/lib/declared-type-command.d.ts +2 -1
  50. package/dist/lib/declared-type-command.js +1 -1
  51. package/dist/lib/diff-command.d.ts +1 -0
  52. package/dist/lib/diff-command.js +10 -2
  53. package/dist/lib/php-files-command.d.ts +3 -1
  54. package/dist/lib/php-files-command.js +34 -19
  55. package/dist/lib/plugin-detection.d.ts +1 -0
  56. package/dist/lib/plugin-detection.js +4 -0
  57. package/dist/lib/push-command.d.ts +17 -0
  58. package/dist/lib/push-command.js +42 -3
  59. package/dist/lib/validate-local.js +12 -5
  60. package/dist/lib/wp-client.d.ts +1 -0
  61. package/dist/lib/wp-client.js +13 -0
  62. package/dist/utils/acf-format.d.ts +5 -0
  63. package/dist/utils/acf-format.js +29 -0
  64. package/dist/utils/php-top-level.d.ts +2 -0
  65. package/dist/utils/php-top-level.js +148 -0
  66. package/dist/utils/resource-dirs.d.ts +1 -0
  67. package/dist/utils/resource-dirs.js +7 -1
  68. package/dist/utils/template-format.d.ts +1 -0
  69. package/dist/utils/theme-styles-format.d.ts +2 -0
  70. package/dist/utils/theme-styles-format.js +32 -4
  71. package/oclif.manifest.json +467 -456
  72. package/package.json +2 -2
package/README.md CHANGED
@@ -21,7 +21,7 @@ $ npm install -g @loopress/cli
21
21
  $ lps COMMAND
22
22
  running command...
23
23
  $ lps (--version)
24
- @loopress/cli/0.31.0 linux-x64 node-v24.21.0
24
+ @loopress/cli/0.32.0 linux-x64 node-v24.21.0
25
25
  $ lps --help [COMMAND]
26
26
  USAGE
27
27
  $ lps COMMAND
@@ -145,6 +145,11 @@ report.
145
145
  * [`lps role remove SLUG`](#lps-role-remove-slug)
146
146
  * [`lps role rm SLUG`](#lps-role-rm-slug)
147
147
  * [`lps role rollback [PATH]`](#lps-role-rollback-path)
148
+ * [`lps scf diff [PATH]`](#lps-scf-diff-path)
149
+ * [`lps scf list`](#lps-scf-list)
150
+ * [`lps scf pull [PATH]`](#lps-scf-pull-path)
151
+ * [`lps scf push [PATH]`](#lps-scf-push-path)
152
+ * [`lps scf rollback [PATH]`](#lps-scf-rollback-path)
148
153
  * [`lps snippet diff [PATH]`](#lps-snippet-diff-path)
149
154
  * [`lps snippet list`](#lps-snippet-list)
150
155
  * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
@@ -198,6 +203,9 @@ DESCRIPTION
198
203
  Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a
199
204
  WordPress environment, or between two environments
200
205
 
206
+ ALIASES
207
+ $ lps scf diff
208
+
201
209
  EXAMPLES
202
210
  $ lps acf diff
203
211
 
@@ -206,11 +214,11 @@ EXAMPLES
206
214
  $ lps acf diff --env staging --against production
207
215
  ```
208
216
 
209
- _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/acf/diff.ts)_
217
+ _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/acf/diff.ts)_
210
218
 
211
219
  ## `lps acf list`
212
220
 
213
- List ACF field groups, post types, taxonomies, and options pages from WordPress
221
+ List ACF field groups, post types, taxonomies, and options pages currently on WordPress
214
222
 
215
223
  ```
216
224
  USAGE
@@ -225,7 +233,10 @@ GLOBAL FLAGS
225
233
  --json Format output as json.
226
234
 
227
235
  DESCRIPTION
228
- List ACF field groups, post types, taxonomies, and options pages from WordPress
236
+ List ACF field groups, post types, taxonomies, and options pages currently on WordPress
237
+
238
+ ALIASES
239
+ $ lps scf list
229
240
 
230
241
  EXAMPLES
231
242
  $ lps acf list
@@ -233,11 +244,11 @@ EXAMPLES
233
244
  $ lps acf list --type field-groups
234
245
  ```
235
246
 
236
- _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/acf/list.ts)_
247
+ _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/acf/list.ts)_
237
248
 
238
249
  ## `lps acf pull [PATH]`
239
250
 
240
- Pull ACF field groups, post types, taxonomies, and options pages from WordPress
251
+ Pull ACF field groups, post types, taxonomies, and options pages from WordPress into local files
241
252
 
242
253
  ```
243
254
  USAGE
@@ -258,7 +269,10 @@ GLOBAL FLAGS
258
269
  --json Format output as json.
259
270
 
260
271
  DESCRIPTION
261
- Pull ACF field groups, post types, taxonomies, and options pages from WordPress
272
+ Pull ACF field groups, post types, taxonomies, and options pages from WordPress into local files
273
+
274
+ ALIASES
275
+ $ lps scf pull
262
276
 
263
277
  EXAMPLES
264
278
  $ lps acf pull
@@ -266,11 +280,11 @@ EXAMPLES
266
280
  $ lps acf pull --type field-groups
267
281
  ```
268
282
 
269
- _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/acf/pull.ts)_
283
+ _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/acf/pull.ts)_
270
284
 
271
285
  ## `lps acf push [PATH]`
272
286
 
273
- Push ACF field groups, post types, taxonomies, and options pages to WordPress
287
+ Push local ACF field groups, post types, taxonomies, and options pages to WordPress
274
288
 
275
289
  ```
276
290
  USAGE
@@ -284,7 +298,8 @@ FLAGS
284
298
  -d, --dry-run Show what would change without making changes
285
299
  -y, --yes Answer yes to confirmation prompts
286
300
  --env=<value> Target environment by name (default: "local", or the project's only environment)
287
- --overwrite Push even over changes made on the site outside Loopress since your last push
301
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also
302
+ take over a same-slug page Loopress did not create
288
303
  --type=<option>... Limit to specific ACF object types
289
304
  <options: field-groups|post-types|taxonomies|options-pages>
290
305
 
@@ -292,7 +307,10 @@ GLOBAL FLAGS
292
307
  --json Format output as json.
293
308
 
294
309
  DESCRIPTION
295
- Push ACF field groups, post types, taxonomies, and options pages to WordPress
310
+ Push local ACF field groups, post types, taxonomies, and options pages to WordPress
311
+
312
+ ALIASES
313
+ $ lps scf push
296
314
 
297
315
  EXAMPLES
298
316
  $ lps acf push
@@ -300,7 +318,7 @@ EXAMPLES
300
318
  $ lps acf push --type field-groups
301
319
  ```
302
320
 
303
- _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/acf/push.ts)_
321
+ _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/acf/push.ts)_
304
322
 
305
323
  ## `lps acf rollback [PATH]`
306
324
 
@@ -327,6 +345,9 @@ DESCRIPTION
327
345
  Restore ACF field groups, post types, taxonomies, and options pages to a snapshot taken automatically before an
328
346
  earlier `lps acf push`
329
347
 
348
+ ALIASES
349
+ $ lps scf rollback
350
+
330
351
  EXAMPLES
331
352
  $ lps acf rollback
332
353
 
@@ -337,7 +358,7 @@ EXAMPLES
337
358
  $ lps acf rollback --dry-run
338
359
  ```
339
360
 
340
- _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/acf/rollback.ts)_
361
+ _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/acf/rollback.ts)_
341
362
 
342
363
  ## `lps api diff [PATH]`
343
364
 
@@ -369,11 +390,11 @@ EXAMPLES
369
390
  $ lps api diff --env staging --against production
370
391
  ```
371
392
 
372
- _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/diff.ts)_
393
+ _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/diff.ts)_
373
394
 
374
395
  ## `lps api list`
375
396
 
376
- List custom API route files from WordPress
397
+ List custom API route files currently on WordPress
377
398
 
378
399
  ```
379
400
  USAGE
@@ -386,13 +407,13 @@ GLOBAL FLAGS
386
407
  --json Format output as json.
387
408
 
388
409
  DESCRIPTION
389
- List custom API route files from WordPress
410
+ List custom API route files currently on WordPress
390
411
 
391
412
  EXAMPLES
392
413
  $ lps api list
393
414
  ```
394
415
 
395
- _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/list.ts)_
416
+ _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/list.ts)_
396
417
 
397
418
  ## `lps api publish [PATH]`
398
419
 
@@ -415,11 +436,11 @@ EXAMPLES
415
436
  $ lps api publish ./api
416
437
  ```
417
438
 
418
- _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/publish.ts)_
439
+ _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/publish.ts)_
419
440
 
420
441
  ## `lps api pull [PATH]`
421
442
 
422
- Pull custom API route files from WordPress
443
+ Pull custom API route files from WordPress into local files
423
444
 
424
445
  ```
425
446
  USAGE
@@ -437,7 +458,7 @@ GLOBAL FLAGS
437
458
  --json Format output as json.
438
459
 
439
460
  DESCRIPTION
440
- Pull custom API route files from WordPress
461
+ Pull custom API route files from WordPress into local files
441
462
 
442
463
  EXAMPLES
443
464
  $ lps api pull
@@ -445,11 +466,11 @@ EXAMPLES
445
466
  $ lps api pull --path ./api
446
467
  ```
447
468
 
448
- _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/pull.ts)_
469
+ _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/pull.ts)_
449
470
 
450
471
  ## `lps api push [PATH]`
451
472
 
452
- Push custom API route files to WordPress
473
+ Push local custom API route files to WordPress
453
474
 
454
475
  ```
455
476
  USAGE
@@ -462,14 +483,15 @@ FLAGS
462
483
  -d, --dry-run Show what would change without making changes
463
484
  -y, --yes Answer yes to confirmation prompts
464
485
  --env=<value> Target environment by name (default: "local", or the project's only environment)
465
- --overwrite Push even over changes made on the site outside Loopress since your last push
486
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
487
+ over a same-slug page Loopress did not create
466
488
  --prune Delete server-side route files not present locally after pushing
467
489
 
468
490
  GLOBAL FLAGS
469
491
  --json Format output as json.
470
492
 
471
493
  DESCRIPTION
472
- Push custom API route files to WordPress
494
+ Push local custom API route files to WordPress
473
495
 
474
496
  EXAMPLES
475
497
  $ lps api push
@@ -479,11 +501,11 @@ EXAMPLES
479
501
  $ lps api push --prune
480
502
  ```
481
503
 
482
- _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/push.ts)_
504
+ _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/push.ts)_
483
505
 
484
506
  ## `lps api remove FILENAME`
485
507
 
486
- Remove a custom API route file from WordPress
508
+ Remove one custom API route file from WordPress
487
509
 
488
510
  ```
489
511
  USAGE
@@ -501,7 +523,7 @@ GLOBAL FLAGS
501
523
  --json Format output as json.
502
524
 
503
525
  DESCRIPTION
504
- Remove a custom API route file from WordPress
526
+ Remove one custom API route file from WordPress
505
527
 
506
528
  ALIASES
507
529
  $ lps api remove
@@ -514,7 +536,7 @@ EXAMPLES
514
536
 
515
537
  ## `lps api rm FILENAME`
516
538
 
517
- Remove a custom API route file from WordPress
539
+ Remove one custom API route file from WordPress
518
540
 
519
541
  ```
520
542
  USAGE
@@ -532,7 +554,7 @@ GLOBAL FLAGS
532
554
  --json Format output as json.
533
555
 
534
556
  DESCRIPTION
535
- Remove a custom API route file from WordPress
557
+ Remove one custom API route file from WordPress
536
558
 
537
559
  ALIASES
538
560
  $ lps api remove
@@ -543,7 +565,7 @@ EXAMPLES
543
565
  $ lps api remove hello --yes
544
566
  ```
545
567
 
546
- _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/rm.ts)_
568
+ _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/rm.ts)_
547
569
 
548
570
  ## `lps api rollback [PATH]`
549
571
 
@@ -579,7 +601,7 @@ EXAMPLES
579
601
  $ lps api rollback --dry-run
580
602
  ```
581
603
 
582
- _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/api/rollback.ts)_
604
+ _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/api/rollback.ts)_
583
605
 
584
606
  ## `lps app list`
585
607
 
@@ -602,7 +624,7 @@ EXAMPLES
602
624
  $ lps app list
603
625
  ```
604
626
 
605
- _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/app/list.ts)_
627
+ _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/app/list.ts)_
606
628
 
607
629
  ## `lps app pull [PATH]`
608
630
 
@@ -630,7 +652,7 @@ EXAMPLES
630
652
  $ lps app pull
631
653
  ```
632
654
 
633
- _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/app/pull.ts)_
655
+ _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/app/pull.ts)_
634
656
 
635
657
  ## `lps app push [NAME]`
636
658
 
@@ -648,7 +670,8 @@ FLAGS
648
670
  -y, --yes Answer yes to confirmation prompts
649
671
  --[no-]build Run the app's package.json build script before pushing
650
672
  --env=<value> Target environment by name (default: "local", or the project's only environment)
651
- --overwrite Push even over changes made on the site outside Loopress since your last push
673
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
674
+ over a same-slug page Loopress did not create
652
675
 
653
676
  GLOBAL FLAGS
654
677
  --json Format output as json.
@@ -666,7 +689,7 @@ EXAMPLES
666
689
  $ lps app push --no-build
667
690
  ```
668
691
 
669
- _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/app/push.ts)_
692
+ _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/app/push.ts)_
670
693
 
671
694
  ## `lps app remove NAME`
672
695
 
@@ -695,7 +718,7 @@ EXAMPLES
695
718
  $ lps app remove search
696
719
  ```
697
720
 
698
- _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/app/remove.ts)_
721
+ _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/app/remove.ts)_
699
722
 
700
723
  ## `lps composer init`
701
724
 
@@ -718,11 +741,11 @@ EXAMPLES
718
741
  $ lps composer init --dry-run
719
742
  ```
720
743
 
721
- _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/composer/init.ts)_
744
+ _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/composer/init.ts)_
722
745
 
723
746
  ## `lps composer pull`
724
747
 
725
- Pull composer.json and composer.lock from WordPress
748
+ Pull composer.json and composer.lock from WordPress into local files
726
749
 
727
750
  ```
728
751
  USAGE
@@ -736,7 +759,7 @@ GLOBAL FLAGS
736
759
  --json Format output as json.
737
760
 
738
761
  DESCRIPTION
739
- Pull composer.json and composer.lock from WordPress
762
+ Pull composer.json and composer.lock from WordPress into local files
740
763
 
741
764
  EXAMPLES
742
765
  $ lps composer pull
@@ -744,7 +767,7 @@ EXAMPLES
744
767
  $ lps composer pull --dry-run
745
768
  ```
746
769
 
747
- _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/composer/pull.ts)_
770
+ _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/composer/pull.ts)_
748
771
 
749
772
  ## `lps composer push`
750
773
 
@@ -759,7 +782,8 @@ FLAGS
759
782
  -y, --yes Answer yes to confirmation prompts
760
783
  --env=<value> Target environment by name (default: "local", or the project's only environment)
761
784
  --force Allow downgrades and take over plugins/themes installed outside Loopress
762
- --overwrite Push even over changes made on the site outside Loopress since your last push
785
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
786
+ over a same-slug page Loopress did not create
763
787
 
764
788
  GLOBAL FLAGS
765
789
  --json Format output as json.
@@ -773,7 +797,7 @@ EXAMPLES
773
797
  $ lps composer push --dry-run
774
798
  ```
775
799
 
776
- _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/composer/push.ts)_
800
+ _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/composer/push.ts)_
777
801
 
778
802
  ## `lps content copy FROM`
779
803
 
@@ -804,7 +828,7 @@ EXAMPLES
804
828
  $ lps content copy staging --dry-run
805
829
  ```
806
830
 
807
- _See code: [src/commands/content/copy.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/content/copy.ts)_
831
+ _See code: [src/commands/content/copy.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/content/copy.ts)_
808
832
 
809
833
  ## `lps cpt diff [PATH]`
810
834
 
@@ -836,7 +860,7 @@ EXAMPLES
836
860
  $ lps cpt diff --env staging --against production
837
861
  ```
838
862
 
839
- _See code: [src/commands/cpt/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/diff.ts)_
863
+ _See code: [src/commands/cpt/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/diff.ts)_
840
864
 
841
865
  ## `lps cpt list`
842
866
 
@@ -860,7 +884,7 @@ EXAMPLES
860
884
  $ lps cpt list
861
885
  ```
862
886
 
863
- _See code: [src/commands/cpt/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/list.ts)_
887
+ _See code: [src/commands/cpt/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/list.ts)_
864
888
 
865
889
  ## `lps cpt pull [PATH]`
866
890
 
@@ -889,7 +913,7 @@ EXAMPLES
889
913
  $ lps cpt pull
890
914
  ```
891
915
 
892
- _See code: [src/commands/cpt/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/pull.ts)_
916
+ _See code: [src/commands/cpt/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/pull.ts)_
893
917
 
894
918
  ## `lps cpt push [PATH]`
895
919
 
@@ -906,7 +930,8 @@ FLAGS
906
930
  -d, --dry-run Show what would change without making changes
907
931
  -y, --yes Answer yes to confirmation prompts
908
932
  --env=<value> Target environment by name (default: "local", or the project's only environment)
909
- --overwrite Push even over changes made on the site outside Loopress since your last push
933
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
934
+ over a same-slug page Loopress did not create
910
935
 
911
936
  GLOBAL FLAGS
912
937
  --json Format output as json.
@@ -919,7 +944,7 @@ EXAMPLES
919
944
  $ lps cpt push
920
945
  ```
921
946
 
922
- _See code: [src/commands/cpt/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/push.ts)_
947
+ _See code: [src/commands/cpt/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/push.ts)_
923
948
 
924
949
  ## `lps cpt remove SLUG`
925
950
 
@@ -985,7 +1010,7 @@ EXAMPLES
985
1010
  $ lps cpt remove <slug> --yes
986
1011
  ```
987
1012
 
988
- _See code: [src/commands/cpt/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/rm.ts)_
1013
+ _See code: [src/commands/cpt/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/rm.ts)_
989
1014
 
990
1015
  ## `lps cpt rollback [PATH]`
991
1016
 
@@ -1021,7 +1046,7 @@ EXAMPLES
1021
1046
  $ lps cpt rollback --dry-run
1022
1047
  ```
1023
1048
 
1024
- _See code: [src/commands/cpt/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/cpt/rollback.ts)_
1049
+ _See code: [src/commands/cpt/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/cpt/rollback.ts)_
1025
1050
 
1026
1051
  ## `lps dev`
1027
1052
 
@@ -1049,11 +1074,11 @@ EXAMPLES
1049
1074
  $ lps dev --skip=plugins
1050
1075
  ```
1051
1076
 
1052
- _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/dev.ts)_
1077
+ _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/dev.ts)_
1053
1078
 
1054
1079
  ## `lps diff`
1055
1080
 
1056
- Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, Options, Menus, Theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
1081
+ Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers snippets, forms, ACF, API routes, hooks, templates, template parts, pages, menus, custom post types, taxonomies, post meta, roles, block patterns, options, theme styles, and Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
1057
1082
 
1058
1083
  ```
1059
1084
  USAGE
@@ -1077,9 +1102,10 @@ GLOBAL FLAGS
1077
1102
 
1078
1103
  DESCRIPTION
1079
1104
  Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers
1080
- snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, Options, Menus, Theme styles, and Composer.
1081
- Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a
1082
- resource could not be compared, so it doubles as a CI drift gate.
1105
+ snippets, forms, ACF, API routes, hooks, templates, template parts, pages, menus, custom post types, taxonomies, post
1106
+ meta, roles, block patterns, options, theme styles, and Composer. Plugins and themes have their own `lps plugin
1107
+ status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a resource could not be compared, so it doubles
1108
+ as a CI drift gate.
1083
1109
 
1084
1110
  EXAMPLES
1085
1111
  $ lps diff
@@ -1093,11 +1119,11 @@ EXAMPLES
1093
1119
  $ lps diff --skip composer
1094
1120
  ```
1095
1121
 
1096
- _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/diff.ts)_
1122
+ _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/diff.ts)_
1097
1123
 
1098
1124
  ## `lps doctor`
1099
1125
 
1100
- Diagnose connectivity, plugin and credential problems for the targeted environment
1126
+ Diagnose connectivity, plugin, credential and hook problems for the targeted environment
1101
1127
 
1102
1128
  ```
1103
1129
  USAGE
@@ -1110,7 +1136,7 @@ GLOBAL FLAGS
1110
1136
  --json Format output as json.
1111
1137
 
1112
1138
  DESCRIPTION
1113
- Diagnose connectivity, plugin and credential problems for the targeted environment
1139
+ Diagnose connectivity, plugin, credential and hook problems for the targeted environment
1114
1140
 
1115
1141
  EXAMPLES
1116
1142
  $ lps doctor
@@ -1118,7 +1144,7 @@ EXAMPLES
1118
1144
  $ lps doctor --env production
1119
1145
  ```
1120
1146
 
1121
- _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/doctor.ts)_
1147
+ _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/doctor.ts)_
1122
1148
 
1123
1149
  ## `lps form diff [PATH]`
1124
1150
 
@@ -1149,11 +1175,11 @@ EXAMPLES
1149
1175
  $ lps form diff --env staging --against production
1150
1176
  ```
1151
1177
 
1152
- _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/form/diff.ts)_
1178
+ _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/form/diff.ts)_
1153
1179
 
1154
1180
  ## `lps form list`
1155
1181
 
1156
- List forms from WordPress
1182
+ List forms currently on WordPress
1157
1183
 
1158
1184
  ```
1159
1185
  USAGE
@@ -1166,17 +1192,17 @@ GLOBAL FLAGS
1166
1192
  --json Format output as json.
1167
1193
 
1168
1194
  DESCRIPTION
1169
- List forms from WordPress
1195
+ List forms currently on WordPress
1170
1196
 
1171
1197
  EXAMPLES
1172
1198
  $ lps form list
1173
1199
  ```
1174
1200
 
1175
- _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/form/list.ts)_
1201
+ _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/form/list.ts)_
1176
1202
 
1177
1203
  ## `lps form pull [PATH]`
1178
1204
 
1179
- Pull forms from WordPress
1205
+ Pull forms from WordPress into local files
1180
1206
 
1181
1207
  ```
1182
1208
  USAGE
@@ -1194,17 +1220,17 @@ GLOBAL FLAGS
1194
1220
  --json Format output as json.
1195
1221
 
1196
1222
  DESCRIPTION
1197
- Pull forms from WordPress
1223
+ Pull forms from WordPress into local files
1198
1224
 
1199
1225
  EXAMPLES
1200
1226
  $ lps form pull
1201
1227
  ```
1202
1228
 
1203
- _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/form/pull.ts)_
1229
+ _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/form/pull.ts)_
1204
1230
 
1205
1231
  ## `lps form push [PATH]`
1206
1232
 
1207
- Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.
1233
+ Push local form files to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json` convention.
1208
1234
 
1209
1235
  ```
1210
1236
  USAGE
@@ -1220,14 +1246,15 @@ FLAGS
1220
1246
  messages). Off by default: the server keeps its own so a stray push can't redirect
1221
1247
  submissions.
1222
1248
  --env=<value> Target environment by name (default: "local", or the project's only environment)
1223
- --overwrite Push even over changes made on the site outside Loopress since your last push
1249
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also
1250
+ take over a same-slug page Loopress did not create
1224
1251
 
1225
1252
  GLOBAL FLAGS
1226
1253
  --json Format output as json.
1227
1254
 
1228
1255
  DESCRIPTION
1229
- Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json`
1230
- convention.
1256
+ Push local form files to WordPress. Local files created or updated remotely are renamed on disk to the
1257
+ `<id>-<slug>.json` convention.
1231
1258
 
1232
1259
  EXAMPLES
1233
1260
  $ lps form push
@@ -1235,7 +1262,7 @@ EXAMPLES
1235
1262
  $ lps form push --allow-notifications
1236
1263
  ```
1237
1264
 
1238
- _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/form/push.ts)_
1265
+ _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/form/push.ts)_
1239
1266
 
1240
1267
  ## `lps form rollback [PATH]`
1241
1268
 
@@ -1271,7 +1298,7 @@ EXAMPLES
1271
1298
  $ lps form rollback --dry-run
1272
1299
  ```
1273
1300
 
1274
- _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/form/rollback.ts)_
1301
+ _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/form/rollback.ts)_
1275
1302
 
1276
1303
  ## `lps help [COMMAND]`
1277
1304
 
@@ -1322,11 +1349,11 @@ EXAMPLES
1322
1349
  $ lps hook diff --env staging --against production
1323
1350
  ```
1324
1351
 
1325
- _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/diff.ts)_
1352
+ _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/diff.ts)_
1326
1353
 
1327
1354
  ## `lps hook list`
1328
1355
 
1329
- List hook files (actions, filters, cron) from WordPress
1356
+ List hook files (actions, filters, cron) currently on WordPress
1330
1357
 
1331
1358
  ```
1332
1359
  USAGE
@@ -1339,17 +1366,17 @@ GLOBAL FLAGS
1339
1366
  --json Format output as json.
1340
1367
 
1341
1368
  DESCRIPTION
1342
- List hook files (actions, filters, cron) from WordPress
1369
+ List hook files (actions, filters, cron) currently on WordPress
1343
1370
 
1344
1371
  EXAMPLES
1345
1372
  $ lps hook list
1346
1373
  ```
1347
1374
 
1348
- _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/list.ts)_
1375
+ _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/list.ts)_
1349
1376
 
1350
1377
  ## `lps hook pull [PATH]`
1351
1378
 
1352
- Pull hook files (actions, filters, cron) from WordPress
1379
+ Pull hook files (actions, filters, cron) from WordPress into local files
1353
1380
 
1354
1381
  ```
1355
1382
  USAGE
@@ -1367,7 +1394,7 @@ GLOBAL FLAGS
1367
1394
  --json Format output as json.
1368
1395
 
1369
1396
  DESCRIPTION
1370
- Pull hook files (actions, filters, cron) from WordPress
1397
+ Pull hook files (actions, filters, cron) from WordPress into local files
1371
1398
 
1372
1399
  EXAMPLES
1373
1400
  $ lps hook pull
@@ -1375,11 +1402,11 @@ EXAMPLES
1375
1402
  $ lps hook pull --path ./hooks
1376
1403
  ```
1377
1404
 
1378
- _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/pull.ts)_
1405
+ _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/pull.ts)_
1379
1406
 
1380
1407
  ## `lps hook push [PATH]`
1381
1408
 
1382
- Push hook files (actions, filters, cron) to WordPress
1409
+ Push local hook files (actions, filters, cron) to WordPress
1383
1410
 
1384
1411
  ```
1385
1412
  USAGE
@@ -1392,14 +1419,15 @@ FLAGS
1392
1419
  -d, --dry-run Show what would change without making changes
1393
1420
  -y, --yes Answer yes to confirmation prompts
1394
1421
  --env=<value> Target environment by name (default: "local", or the project's only environment)
1395
- --overwrite Push even over changes made on the site outside Loopress since your last push
1422
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
1423
+ over a same-slug page Loopress did not create
1396
1424
  --prune Delete server-side hook files not present locally after pushing
1397
1425
 
1398
1426
  GLOBAL FLAGS
1399
1427
  --json Format output as json.
1400
1428
 
1401
1429
  DESCRIPTION
1402
- Push hook files (actions, filters, cron) to WordPress
1430
+ Push local hook files (actions, filters, cron) to WordPress
1403
1431
 
1404
1432
  EXAMPLES
1405
1433
  $ lps hook push
@@ -1409,11 +1437,11 @@ EXAMPLES
1409
1437
  $ lps hook push --prune
1410
1438
  ```
1411
1439
 
1412
- _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/push.ts)_
1440
+ _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/push.ts)_
1413
1441
 
1414
1442
  ## `lps hook remove FILENAME`
1415
1443
 
1416
- Remove a hook file (action, filter, cron) from WordPress
1444
+ Remove one hook file (action, filter, cron) from WordPress
1417
1445
 
1418
1446
  ```
1419
1447
  USAGE
@@ -1431,7 +1459,7 @@ GLOBAL FLAGS
1431
1459
  --json Format output as json.
1432
1460
 
1433
1461
  DESCRIPTION
1434
- Remove a hook file (action, filter, cron) from WordPress
1462
+ Remove one hook file (action, filter, cron) from WordPress
1435
1463
 
1436
1464
  ALIASES
1437
1465
  $ lps hook remove
@@ -1444,7 +1472,7 @@ EXAMPLES
1444
1472
 
1445
1473
  ## `lps hook rm FILENAME`
1446
1474
 
1447
- Remove a hook file (action, filter, cron) from WordPress
1475
+ Remove one hook file (action, filter, cron) from WordPress
1448
1476
 
1449
1477
  ```
1450
1478
  USAGE
@@ -1462,7 +1490,7 @@ GLOBAL FLAGS
1462
1490
  --json Format output as json.
1463
1491
 
1464
1492
  DESCRIPTION
1465
- Remove a hook file (action, filter, cron) from WordPress
1493
+ Remove one hook file (action, filter, cron) from WordPress
1466
1494
 
1467
1495
  ALIASES
1468
1496
  $ lps hook remove
@@ -1473,7 +1501,7 @@ EXAMPLES
1473
1501
  $ lps hook remove hello --yes
1474
1502
  ```
1475
1503
 
1476
- _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/rm.ts)_
1504
+ _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/rm.ts)_
1477
1505
 
1478
1506
  ## `lps hook rollback [PATH]`
1479
1507
 
@@ -1509,7 +1537,7 @@ EXAMPLES
1509
1537
  $ lps hook rollback --dry-run
1510
1538
  ```
1511
1539
 
1512
- _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/hook/rollback.ts)_
1540
+ _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/hook/rollback.ts)_
1513
1541
 
1514
1542
  ## `lps init`
1515
1543
 
@@ -1526,7 +1554,7 @@ EXAMPLES
1526
1554
  $ lps init
1527
1555
  ```
1528
1556
 
1529
- _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/init.ts)_
1557
+ _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/init.ts)_
1530
1558
 
1531
1559
  ## `lps login`
1532
1560
 
@@ -1543,7 +1571,7 @@ EXAMPLES
1543
1571
  $ lps login
1544
1572
  ```
1545
1573
 
1546
- _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/login.ts)_
1574
+ _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/login.ts)_
1547
1575
 
1548
1576
  ## `lps logout`
1549
1577
 
@@ -1560,7 +1588,7 @@ EXAMPLES
1560
1588
  $ lps logout
1561
1589
  ```
1562
1590
 
1563
- _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/logout.ts)_
1591
+ _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/logout.ts)_
1564
1592
 
1565
1593
  ## `lps menu diff [PATH]`
1566
1594
 
@@ -1592,7 +1620,7 @@ EXAMPLES
1592
1620
  $ lps menu diff --env staging --against production
1593
1621
  ```
1594
1622
 
1595
- _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/menu/diff.ts)_
1623
+ _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/menu/diff.ts)_
1596
1624
 
1597
1625
  ## `lps menu list`
1598
1626
 
@@ -1615,7 +1643,7 @@ EXAMPLES
1615
1643
  $ lps menu list
1616
1644
  ```
1617
1645
 
1618
- _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/menu/list.ts)_
1646
+ _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/menu/list.ts)_
1619
1647
 
1620
1648
  ## `lps menu pull [PATH]`
1621
1649
 
@@ -1643,7 +1671,7 @@ EXAMPLES
1643
1671
  $ lps menu pull
1644
1672
  ```
1645
1673
 
1646
- _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/menu/pull.ts)_
1674
+ _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/menu/pull.ts)_
1647
1675
 
1648
1676
  ## `lps menu push [PATH]`
1649
1677
 
@@ -1660,7 +1688,8 @@ FLAGS
1660
1688
  -d, --dry-run Show what would change without making changes
1661
1689
  -y, --yes Answer yes to confirmation prompts
1662
1690
  --env=<value> Target environment by name (default: "local", or the project's only environment)
1663
- --overwrite Push even over changes made on the site outside Loopress since your last push
1691
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
1692
+ over a same-slug page Loopress did not create
1664
1693
 
1665
1694
  GLOBAL FLAGS
1666
1695
  --json Format output as json.
@@ -1674,7 +1703,7 @@ EXAMPLES
1674
1703
  $ lps menu push
1675
1704
  ```
1676
1705
 
1677
- _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/menu/push.ts)_
1706
+ _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/menu/push.ts)_
1678
1707
 
1679
1708
  ## `lps menu rollback [PATH]`
1680
1709
 
@@ -1710,7 +1739,7 @@ EXAMPLES
1710
1739
  $ lps menu rollback --dry-run
1711
1740
  ```
1712
1741
 
1713
- _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/menu/rollback.ts)_
1742
+ _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/menu/rollback.ts)_
1714
1743
 
1715
1744
  ## `lps meta diff [PATH]`
1716
1745
 
@@ -1742,7 +1771,7 @@ EXAMPLES
1742
1771
  $ lps meta diff --env staging --against production
1743
1772
  ```
1744
1773
 
1745
- _See code: [src/commands/meta/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/diff.ts)_
1774
+ _See code: [src/commands/meta/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/diff.ts)_
1746
1775
 
1747
1776
  ## `lps meta list`
1748
1777
 
@@ -1766,7 +1795,7 @@ EXAMPLES
1766
1795
  $ lps meta list
1767
1796
  ```
1768
1797
 
1769
- _See code: [src/commands/meta/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/list.ts)_
1798
+ _See code: [src/commands/meta/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/list.ts)_
1770
1799
 
1771
1800
  ## `lps meta pull [PATH]`
1772
1801
 
@@ -1795,7 +1824,7 @@ EXAMPLES
1795
1824
  $ lps meta pull
1796
1825
  ```
1797
1826
 
1798
- _See code: [src/commands/meta/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/pull.ts)_
1827
+ _See code: [src/commands/meta/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/pull.ts)_
1799
1828
 
1800
1829
  ## `lps meta push [PATH]`
1801
1830
 
@@ -1812,7 +1841,8 @@ FLAGS
1812
1841
  -d, --dry-run Show what would change without making changes
1813
1842
  -y, --yes Answer yes to confirmation prompts
1814
1843
  --env=<value> Target environment by name (default: "local", or the project's only environment)
1815
- --overwrite Push even over changes made on the site outside Loopress since your last push
1844
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
1845
+ over a same-slug page Loopress did not create
1816
1846
 
1817
1847
  GLOBAL FLAGS
1818
1848
  --json Format output as json.
@@ -1825,7 +1855,7 @@ EXAMPLES
1825
1855
  $ lps meta push
1826
1856
  ```
1827
1857
 
1828
- _See code: [src/commands/meta/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/push.ts)_
1858
+ _See code: [src/commands/meta/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/push.ts)_
1829
1859
 
1830
1860
  ## `lps meta remove SLUG`
1831
1861
 
@@ -1891,7 +1921,7 @@ EXAMPLES
1891
1921
  $ lps meta remove <slug> --yes
1892
1922
  ```
1893
1923
 
1894
- _See code: [src/commands/meta/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/rm.ts)_
1924
+ _See code: [src/commands/meta/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/rm.ts)_
1895
1925
 
1896
1926
  ## `lps meta rollback [PATH]`
1897
1927
 
@@ -1927,7 +1957,7 @@ EXAMPLES
1927
1957
  $ lps meta rollback --dry-run
1928
1958
  ```
1929
1959
 
1930
- _See code: [src/commands/meta/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/meta/rollback.ts)_
1960
+ _See code: [src/commands/meta/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/meta/rollback.ts)_
1931
1961
 
1932
1962
  ## `lps option add NAME`
1933
1963
 
@@ -1958,7 +1988,7 @@ EXAMPLES
1958
1988
  $ lps option add siteurl
1959
1989
  ```
1960
1990
 
1961
- _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/add.ts)_
1991
+ _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/add.ts)_
1962
1992
 
1963
1993
  ## `lps option diff [PATH]`
1964
1994
 
@@ -1990,7 +2020,7 @@ EXAMPLES
1990
2020
  $ lps option diff --env staging --against production
1991
2021
  ```
1992
2022
 
1993
- _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/diff.ts)_
2023
+ _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/diff.ts)_
1994
2024
 
1995
2025
  ## `lps option list`
1996
2026
 
@@ -2020,7 +2050,7 @@ EXAMPLES
2020
2050
  $ lps option list --no-core
2021
2051
  ```
2022
2052
 
2023
- _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/list.ts)_
2053
+ _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/list.ts)_
2024
2054
 
2025
2055
  ## `lps option pull [PATH]`
2026
2056
 
@@ -2049,7 +2079,7 @@ EXAMPLES
2049
2079
  $ lps option pull
2050
2080
  ```
2051
2081
 
2052
- _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/pull.ts)_
2082
+ _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/pull.ts)_
2053
2083
 
2054
2084
  ## `lps option push [PATH]`
2055
2085
 
@@ -2066,7 +2096,8 @@ FLAGS
2066
2096
  -d, --dry-run Show what would change without making changes
2067
2097
  -y, --yes Answer yes to confirmation prompts
2068
2098
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2069
- --overwrite Push even over changes made on the site outside Loopress since your last push
2099
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2100
+ over a same-slug page Loopress did not create
2070
2101
 
2071
2102
  GLOBAL FLAGS
2072
2103
  --json Format output as json.
@@ -2079,7 +2110,7 @@ EXAMPLES
2079
2110
  $ lps option push
2080
2111
  ```
2081
2112
 
2082
- _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/push.ts)_
2113
+ _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/push.ts)_
2083
2114
 
2084
2115
  ## `lps option remove NAME`
2085
2116
 
@@ -2112,7 +2143,7 @@ EXAMPLES
2112
2143
  $ lps option remove wpseo_titles --local-only
2113
2144
  ```
2114
2145
 
2115
- _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/remove.ts)_
2146
+ _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/remove.ts)_
2116
2147
 
2117
2148
  ## `lps option rollback [PATH]`
2118
2149
 
@@ -2148,7 +2179,7 @@ EXAMPLES
2148
2179
  $ lps option rollback --dry-run
2149
2180
  ```
2150
2181
 
2151
- _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/option/rollback.ts)_
2182
+ _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/option/rollback.ts)_
2152
2183
 
2153
2184
  ## `lps page diff [PATH]`
2154
2185
 
@@ -2179,7 +2210,7 @@ EXAMPLES
2179
2210
  $ lps page diff --env staging --against production
2180
2211
  ```
2181
2212
 
2182
- _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/page/diff.ts)_
2213
+ _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/page/diff.ts)_
2183
2214
 
2184
2215
  ## `lps page list`
2185
2216
 
@@ -2202,11 +2233,11 @@ EXAMPLES
2202
2233
  $ lps page list
2203
2234
  ```
2204
2235
 
2205
- _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/page/list.ts)_
2236
+ _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/page/list.ts)_
2206
2237
 
2207
2238
  ## `lps page push [SLUG]`
2208
2239
 
2209
- Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is applied on every push.
2240
+ Push local static HTML pages (pages/<slug>.html) to WordPress, or only one when a slug is given. The `status` header (draft or publish, draft by default) is applied on every push.
2210
2241
 
2211
2242
  ```
2212
2243
  USAGE
@@ -2219,14 +2250,15 @@ FLAGS
2219
2250
  -d, --dry-run Show what would change without making changes
2220
2251
  -y, --yes Answer yes to confirmation prompts
2221
2252
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2222
- --overwrite Push even over changes made on the site outside Loopress since your last push
2253
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2254
+ over a same-slug page Loopress did not create
2223
2255
 
2224
2256
  GLOBAL FLAGS
2225
2257
  --json Format output as json.
2226
2258
 
2227
2259
  DESCRIPTION
2228
- Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is
2229
- applied on every push.
2260
+ Push local static HTML pages (pages/<slug>.html) to WordPress, or only one when a slug is given. The `status` header
2261
+ (draft or publish, draft by default) is applied on every push.
2230
2262
 
2231
2263
  EXAMPLES
2232
2264
  $ lps page push
@@ -2234,9 +2266,11 @@ EXAMPLES
2234
2266
  $ lps page push legal-notice
2235
2267
 
2236
2268
  $ lps page push --dry-run
2269
+
2270
+ $ lps page push about --overwrite
2237
2271
  ```
2238
2272
 
2239
- _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/page/push.ts)_
2273
+ _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/page/push.ts)_
2240
2274
 
2241
2275
  ## `lps pattern diff [PATH]`
2242
2276
 
@@ -2268,7 +2302,7 @@ EXAMPLES
2268
2302
  $ lps pattern diff --env staging --against production
2269
2303
  ```
2270
2304
 
2271
- _See code: [src/commands/pattern/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/diff.ts)_
2305
+ _See code: [src/commands/pattern/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/diff.ts)_
2272
2306
 
2273
2307
  ## `lps pattern list`
2274
2308
 
@@ -2292,7 +2326,7 @@ EXAMPLES
2292
2326
  $ lps pattern list
2293
2327
  ```
2294
2328
 
2295
- _See code: [src/commands/pattern/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/list.ts)_
2329
+ _See code: [src/commands/pattern/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/list.ts)_
2296
2330
 
2297
2331
  ## `lps pattern pull [PATH]`
2298
2332
 
@@ -2321,11 +2355,11 @@ EXAMPLES
2321
2355
  $ lps pattern pull
2322
2356
  ```
2323
2357
 
2324
- _See code: [src/commands/pattern/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/pull.ts)_
2358
+ _See code: [src/commands/pattern/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/pull.ts)_
2325
2359
 
2326
2360
  ## `lps pattern push [PATH]`
2327
2361
 
2328
- Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress, registered as loopress/<slug>. Create or update only, never deletes a pattern (use `lps pattern rm`).
2362
+ Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress, registered as loopress/<slug> and referenced with <!-- wp:pattern {"slug":"loopress/<slug>"} /-->. Create or update only, never deletes a pattern (use `lps pattern rm`).
2329
2363
 
2330
2364
  ```
2331
2365
  USAGE
@@ -2338,24 +2372,26 @@ FLAGS
2338
2372
  -d, --dry-run Show what would change without making changes
2339
2373
  -y, --yes Answer yes to confirmation prompts
2340
2374
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2341
- --overwrite Push even over changes made on the site outside Loopress since your last push
2375
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2376
+ over a same-slug page Loopress did not create
2342
2377
 
2343
2378
  GLOBAL FLAGS
2344
2379
  --json Format output as json.
2345
2380
 
2346
2381
  DESCRIPTION
2347
2382
  Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress,
2348
- registered as loopress/<slug>. Create or update only, never deletes a pattern (use `lps pattern rm`).
2383
+ registered as loopress/<slug> and referenced with <!-- wp:pattern {"slug":"loopress/<slug>"} /-->. Create or update
2384
+ only, never deletes a pattern (use `lps pattern rm`).
2349
2385
 
2350
2386
  EXAMPLES
2351
2387
  $ lps pattern push
2352
2388
  ```
2353
2389
 
2354
- _See code: [src/commands/pattern/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/push.ts)_
2390
+ _See code: [src/commands/pattern/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/push.ts)_
2355
2391
 
2356
2392
  ## `lps pattern remove SLUG`
2357
2393
 
2358
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already inserted in posts stay.
2394
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.
2359
2395
 
2360
2396
  ```
2361
2397
  USAGE
@@ -2373,8 +2409,8 @@ GLOBAL FLAGS
2373
2409
  --json Format output as json.
2374
2410
 
2375
2411
  DESCRIPTION
2376
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already
2377
- inserted in posts stay.
2412
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is
2413
+ pushed again, copies already inserted in posts stay.
2378
2414
 
2379
2415
  ALIASES
2380
2416
  $ lps pattern remove
@@ -2387,7 +2423,7 @@ EXAMPLES
2387
2423
 
2388
2424
  ## `lps pattern rm SLUG`
2389
2425
 
2390
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already inserted in posts stay.
2426
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is pushed again, copies already inserted in posts stay.
2391
2427
 
2392
2428
  ```
2393
2429
  USAGE
@@ -2405,8 +2441,8 @@ GLOBAL FLAGS
2405
2441
  --json Format output as json.
2406
2442
 
2407
2443
  DESCRIPTION
2408
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already
2409
- inserted in posts stay.
2444
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing until it is
2445
+ pushed again, copies already inserted in posts stay.
2410
2446
 
2411
2447
  ALIASES
2412
2448
  $ lps pattern remove
@@ -2417,7 +2453,7 @@ EXAMPLES
2417
2453
  $ lps pattern remove <slug> --yes
2418
2454
  ```
2419
2455
 
2420
- _See code: [src/commands/pattern/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/rm.ts)_
2456
+ _See code: [src/commands/pattern/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/rm.ts)_
2421
2457
 
2422
2458
  ## `lps pattern rollback [PATH]`
2423
2459
 
@@ -2453,7 +2489,7 @@ EXAMPLES
2453
2489
  $ lps pattern rollback --dry-run
2454
2490
  ```
2455
2491
 
2456
- _See code: [src/commands/pattern/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pattern/rollback.ts)_
2492
+ _See code: [src/commands/pattern/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pattern/rollback.ts)_
2457
2493
 
2458
2494
  ## `lps plugin add SLUG`
2459
2495
 
@@ -2485,11 +2521,11 @@ EXAMPLES
2485
2521
  $ lps plugin add contact-form-7 --dry-run
2486
2522
  ```
2487
2523
 
2488
- _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/plugin/add.ts)_
2524
+ _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/plugin/add.ts)_
2489
2525
 
2490
2526
  ## `lps plugin audit`
2491
2527
 
2492
- Check the plugins in loopress.json for known vulnerabilities and health issues
2528
+ Check the plugins in loopress.json for known vulnerabilities (wpvulnerability.net) and health issues
2493
2529
 
2494
2530
  ```
2495
2531
  USAGE
@@ -2502,13 +2538,13 @@ GLOBAL FLAGS
2502
2538
  --json Format output as json.
2503
2539
 
2504
2540
  DESCRIPTION
2505
- Check the plugins in loopress.json for known vulnerabilities and health issues
2541
+ Check the plugins in loopress.json for known vulnerabilities (wpvulnerability.net) and health issues
2506
2542
 
2507
2543
  EXAMPLES
2508
2544
  $ lps plugin audit
2509
2545
  ```
2510
2546
 
2511
- _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/plugin/audit.ts)_
2547
+ _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/plugin/audit.ts)_
2512
2548
 
2513
2549
  ## `lps plugin pull`
2514
2550
 
@@ -2538,11 +2574,11 @@ EXAMPLES
2538
2574
  $ lps plugin pull --env production --plugin query-monitor
2539
2575
  ```
2540
2576
 
2541
- _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/plugin/pull.ts)_
2577
+ _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/plugin/pull.ts)_
2542
2578
 
2543
2579
  ## `lps plugin push`
2544
2580
 
2545
- Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
2581
+ Install WordPress.org plugins on WordPress to match loopress.json (active state included) or composer.json, via Composer + WPackagist
2546
2582
 
2547
2583
  ```
2548
2584
  USAGE
@@ -2555,14 +2591,16 @@ FLAGS
2555
2591
  current state and new ones stay inactive
2556
2592
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2557
2593
  --force Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
2558
- --overwrite Push even over changes made on the site outside Loopress since your last push
2594
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2595
+ over a same-slug page Loopress did not create
2559
2596
  --prune Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)
2560
2597
 
2561
2598
  GLOBAL FLAGS
2562
2599
  --json Format output as json.
2563
2600
 
2564
2601
  DESCRIPTION
2565
- Install plugins on WordPress to match loopress.json (or composer.json), via Composer + WPackagist
2602
+ Install WordPress.org plugins on WordPress to match loopress.json (active state included) or composer.json, via
2603
+ Composer + WPackagist
2566
2604
 
2567
2605
  EXAMPLES
2568
2606
  $ lps plugin push
@@ -2572,11 +2610,11 @@ EXAMPLES
2572
2610
  $ lps plugin push --force --prune
2573
2611
  ```
2574
2612
 
2575
- _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/plugin/push.ts)_
2613
+ _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/plugin/push.ts)_
2576
2614
 
2577
2615
  ## `lps plugin status`
2578
2616
 
2579
- Compare the plugins on WordPress against loopress.json and report drift
2617
+ Compare the plugins on WordPress against loopress.json and report drift (missing, wrong version, inactive, untracked)
2580
2618
 
2581
2619
  ```
2582
2620
  USAGE
@@ -2589,13 +2627,13 @@ GLOBAL FLAGS
2589
2627
  --json Format output as json.
2590
2628
 
2591
2629
  DESCRIPTION
2592
- Compare the plugins on WordPress against loopress.json and report drift
2630
+ Compare the plugins on WordPress against loopress.json and report drift (missing, wrong version, inactive, untracked)
2593
2631
 
2594
2632
  EXAMPLES
2595
2633
  $ lps plugin status
2596
2634
  ```
2597
2635
 
2598
- _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/plugin/status.ts)_
2636
+ _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/plugin/status.ts)_
2599
2637
 
2600
2638
  ## `lps project config`
2601
2639
 
@@ -2613,7 +2651,7 @@ EXAMPLES
2613
2651
  $ lps project config
2614
2652
  ```
2615
2653
 
2616
- _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/config.ts)_
2654
+ _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/config.ts)_
2617
2655
 
2618
2656
  ## `lps project list`
2619
2657
 
@@ -2633,7 +2671,7 @@ EXAMPLES
2633
2671
  $ lps project list
2634
2672
  ```
2635
2673
 
2636
- _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/list.ts)_
2674
+ _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/list.ts)_
2637
2675
 
2638
2676
  ## `lps project pull`
2639
2677
 
@@ -2650,7 +2688,7 @@ EXAMPLES
2650
2688
  $ lps project pull
2651
2689
  ```
2652
2690
 
2653
- _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/pull.ts)_
2691
+ _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/pull.ts)_
2654
2692
 
2655
2693
  ## `lps project push`
2656
2694
 
@@ -2670,7 +2708,7 @@ EXAMPLES
2670
2708
  $ lps project push
2671
2709
  ```
2672
2710
 
2673
- _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/push.ts)_
2711
+ _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/push.ts)_
2674
2712
 
2675
2713
  ## `lps project remove`
2676
2714
 
@@ -2687,7 +2725,7 @@ EXAMPLES
2687
2725
  $ lps project remove
2688
2726
  ```
2689
2727
 
2690
- _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/remove.ts)_
2728
+ _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/remove.ts)_
2691
2729
 
2692
2730
  ## `lps project rotate`
2693
2731
 
@@ -2709,7 +2747,7 @@ EXAMPLES
2709
2747
  $ lps project rotate --env staging
2710
2748
  ```
2711
2749
 
2712
- _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/rotate.ts)_
2750
+ _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/rotate.ts)_
2713
2751
 
2714
2752
  ## `lps project switch`
2715
2753
 
@@ -2726,7 +2764,7 @@ EXAMPLES
2726
2764
  $ lps project switch
2727
2765
  ```
2728
2766
 
2729
- _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/project/switch.ts)_
2767
+ _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/project/switch.ts)_
2730
2768
 
2731
2769
  ## `lps promote FROM TO`
2732
2770
 
@@ -2743,7 +2781,8 @@ ARGUMENTS
2743
2781
  FLAGS
2744
2782
  -d, --dry-run Show what would change without making changes
2745
2783
  -y, --yes Answer yes to confirmation prompts
2746
- --overwrite Push even over changes made on the site outside Loopress since your last push
2784
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take over
2785
+ a same-slug page Loopress did not create
2747
2786
 
2748
2787
  GLOBAL FLAGS
2749
2788
  --json Format output as json.
@@ -2759,11 +2798,11 @@ EXAMPLES
2759
2798
  $ lps promote production staging --dry-run
2760
2799
  ```
2761
2800
 
2762
- _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/promote.ts)_
2801
+ _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/promote.ts)_
2763
2802
 
2764
2803
  ## `lps pull`
2765
2804
 
2766
- Pull all content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, menus, options, and snippets, from WordPress
2805
+ Pull every tracked resource from WordPress into local files in one run: composer dependencies, plugins, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, Global Styles, menus, options, and snippets
2767
2806
 
2768
2807
  ```
2769
2808
  USAGE
@@ -2778,8 +2817,8 @@ GLOBAL FLAGS
2778
2817
  --json Format output as json.
2779
2818
 
2780
2819
  DESCRIPTION
2781
- Pull all content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks,
2782
- forms, patterns, menus, options, and snippets, from WordPress
2820
+ Pull every tracked resource from WordPress into local files in one run: composer dependencies, plugins, post types,
2821
+ taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, Global Styles, menus, options, and snippets
2783
2822
 
2784
2823
  EXAMPLES
2785
2824
  $ lps pull
@@ -2789,11 +2828,11 @@ EXAMPLES
2789
2828
  $ lps pull --dry-run
2790
2829
  ```
2791
2830
 
2792
- _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/pull.ts)_
2831
+ _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/pull.ts)_
2793
2832
 
2794
2833
  ## `lps push`
2795
2834
 
2796
- Push all local content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, templates, pages, menus, options, and snippets, to WordPress
2835
+ Push every local resource to WordPress in one run: plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks, forms, patterns, templates and parts, Global Styles, pages, menus, options, and snippets
2797
2836
 
2798
2837
  ```
2799
2838
  USAGE
@@ -2803,14 +2842,16 @@ FLAGS
2803
2842
  -d, --dry-run Show what would change without making changes
2804
2843
  -y, --yes Answer yes to confirmation prompts
2805
2844
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2806
- --overwrite Push even over changes made on the site outside Loopress since your last push
2845
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2846
+ over a same-slug page Loopress did not create
2807
2847
 
2808
2848
  GLOBAL FLAGS
2809
2849
  --json Format output as json.
2810
2850
 
2811
2851
  DESCRIPTION
2812
- Push all local content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes,
2813
- hooks, forms, patterns, templates, pages, menus, options, and snippets, to WordPress
2852
+ Push every local resource to WordPress in one run: plugins, composer dependencies, post types, taxonomies, post meta,
2853
+ roles, ACF, API routes, hooks, forms, patterns, templates and parts, Global Styles, pages, menus, options, and
2854
+ snippets
2814
2855
 
2815
2856
  EXAMPLES
2816
2857
  $ lps push
@@ -2820,7 +2861,7 @@ EXAMPLES
2820
2861
  $ lps push --dry-run
2821
2862
  ```
2822
2863
 
2823
- _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/push.ts)_
2864
+ _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/push.ts)_
2824
2865
 
2825
2866
  ## `lps role diff [PATH]`
2826
2867
 
@@ -2851,7 +2892,7 @@ EXAMPLES
2851
2892
  $ lps role diff --env staging --against production
2852
2893
  ```
2853
2894
 
2854
- _See code: [src/commands/role/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/diff.ts)_
2895
+ _See code: [src/commands/role/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/diff.ts)_
2855
2896
 
2856
2897
  ## `lps role list`
2857
2898
 
@@ -2875,7 +2916,7 @@ EXAMPLES
2875
2916
  $ lps role list
2876
2917
  ```
2877
2918
 
2878
- _See code: [src/commands/role/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/list.ts)_
2919
+ _See code: [src/commands/role/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/list.ts)_
2879
2920
 
2880
2921
  ## `lps role pull [PATH]`
2881
2922
 
@@ -2904,7 +2945,7 @@ EXAMPLES
2904
2945
  $ lps role pull
2905
2946
  ```
2906
2947
 
2907
- _See code: [src/commands/role/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/pull.ts)_
2948
+ _See code: [src/commands/role/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/pull.ts)_
2908
2949
 
2909
2950
  ## `lps role push [PATH]`
2910
2951
 
@@ -2921,7 +2962,8 @@ FLAGS
2921
2962
  -d, --dry-run Show what would change without making changes
2922
2963
  -y, --yes Answer yes to confirmation prompts
2923
2964
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2924
- --overwrite Push even over changes made on the site outside Loopress since your last push
2965
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
2966
+ over a same-slug page Loopress did not create
2925
2967
 
2926
2968
  GLOBAL FLAGS
2927
2969
  --json Format output as json.
@@ -2934,7 +2976,7 @@ EXAMPLES
2934
2976
  $ lps role push
2935
2977
  ```
2936
2978
 
2937
- _See code: [src/commands/role/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/push.ts)_
2979
+ _See code: [src/commands/role/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/push.ts)_
2938
2980
 
2939
2981
  ## `lps role remove SLUG`
2940
2982
 
@@ -3000,7 +3042,7 @@ EXAMPLES
3000
3042
  $ lps role remove <slug> --yes
3001
3043
  ```
3002
3044
 
3003
- _See code: [src/commands/role/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/rm.ts)_
3045
+ _See code: [src/commands/role/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/rm.ts)_
3004
3046
 
3005
3047
  ## `lps role rollback [PATH]`
3006
3048
 
@@ -3036,7 +3078,176 @@ EXAMPLES
3036
3078
  $ lps role rollback --dry-run
3037
3079
  ```
3038
3080
 
3039
- _See code: [src/commands/role/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/role/rollback.ts)_
3081
+ _See code: [src/commands/role/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/role/rollback.ts)_
3082
+
3083
+ ## `lps scf diff [PATH]`
3084
+
3085
+ Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a WordPress environment, or between two environments
3086
+
3087
+ ```
3088
+ USAGE
3089
+ $ lps scf diff [PATH] [--json] [--env <value>] [--against <value>]
3090
+
3091
+ ARGUMENTS
3092
+ [PATH] Path to ACF directory (overrides project config)
3093
+
3094
+ FLAGS
3095
+ --against=<value> Compare the primary environment against this second environment instead of against local files
3096
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3097
+
3098
+ GLOBAL FLAGS
3099
+ --json Format output as json.
3100
+
3101
+ DESCRIPTION
3102
+ Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a
3103
+ WordPress environment, or between two environments
3104
+
3105
+ ALIASES
3106
+ $ lps scf diff
3107
+
3108
+ EXAMPLES
3109
+ $ lps acf diff
3110
+
3111
+ $ lps acf diff --env staging
3112
+
3113
+ $ lps acf diff --env staging --against production
3114
+ ```
3115
+
3116
+ ## `lps scf list`
3117
+
3118
+ List ACF field groups, post types, taxonomies, and options pages currently on WordPress
3119
+
3120
+ ```
3121
+ USAGE
3122
+ $ lps scf list [--json] [--env <value>] [--type field-groups|post-types|taxonomies|options-pages...]
3123
+
3124
+ FLAGS
3125
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3126
+ --type=<option>... Limit to specific ACF object types
3127
+ <options: field-groups|post-types|taxonomies|options-pages>
3128
+
3129
+ GLOBAL FLAGS
3130
+ --json Format output as json.
3131
+
3132
+ DESCRIPTION
3133
+ List ACF field groups, post types, taxonomies, and options pages currently on WordPress
3134
+
3135
+ ALIASES
3136
+ $ lps scf list
3137
+
3138
+ EXAMPLES
3139
+ $ lps acf list
3140
+
3141
+ $ lps acf list --type field-groups
3142
+ ```
3143
+
3144
+ ## `lps scf pull [PATH]`
3145
+
3146
+ Pull ACF field groups, post types, taxonomies, and options pages from WordPress into local files
3147
+
3148
+ ```
3149
+ USAGE
3150
+ $ lps scf pull [PATH] [--json] [--env <value>] [-d] [-y] [--type
3151
+ field-groups|post-types|taxonomies|options-pages...]
3152
+
3153
+ ARGUMENTS
3154
+ [PATH] Path to ACF directory (overrides project config)
3155
+
3156
+ FLAGS
3157
+ -d, --dry-run Show what would change without making changes
3158
+ -y, --yes Answer yes to confirmation prompts
3159
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3160
+ --type=<option>... Limit to specific ACF object types
3161
+ <options: field-groups|post-types|taxonomies|options-pages>
3162
+
3163
+ GLOBAL FLAGS
3164
+ --json Format output as json.
3165
+
3166
+ DESCRIPTION
3167
+ Pull ACF field groups, post types, taxonomies, and options pages from WordPress into local files
3168
+
3169
+ ALIASES
3170
+ $ lps scf pull
3171
+
3172
+ EXAMPLES
3173
+ $ lps acf pull
3174
+
3175
+ $ lps acf pull --type field-groups
3176
+ ```
3177
+
3178
+ ## `lps scf push [PATH]`
3179
+
3180
+ Push local ACF field groups, post types, taxonomies, and options pages to WordPress
3181
+
3182
+ ```
3183
+ USAGE
3184
+ $ lps scf push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y] [--type
3185
+ field-groups|post-types|taxonomies|options-pages...]
3186
+
3187
+ ARGUMENTS
3188
+ [PATH] Path to ACF directory (overrides project config)
3189
+
3190
+ FLAGS
3191
+ -d, --dry-run Show what would change without making changes
3192
+ -y, --yes Answer yes to confirmation prompts
3193
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3194
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also
3195
+ take over a same-slug page Loopress did not create
3196
+ --type=<option>... Limit to specific ACF object types
3197
+ <options: field-groups|post-types|taxonomies|options-pages>
3198
+
3199
+ GLOBAL FLAGS
3200
+ --json Format output as json.
3201
+
3202
+ DESCRIPTION
3203
+ Push local ACF field groups, post types, taxonomies, and options pages to WordPress
3204
+
3205
+ ALIASES
3206
+ $ lps scf push
3207
+
3208
+ EXAMPLES
3209
+ $ lps acf push
3210
+
3211
+ $ lps acf push --type field-groups
3212
+ ```
3213
+
3214
+ ## `lps scf rollback [PATH]`
3215
+
3216
+ Restore ACF field groups, post types, taxonomies, and options pages to a snapshot taken automatically before an earlier `lps acf push`
3217
+
3218
+ ```
3219
+ USAGE
3220
+ $ lps scf rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
3221
+
3222
+ ARGUMENTS
3223
+ [PATH] Path to ACF directory (overrides project config)
3224
+
3225
+ FLAGS
3226
+ -d, --dry-run Show what would change without making changes
3227
+ -y, --yes Answer yes to confirmation prompts
3228
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3229
+ --list List available snapshots instead of rolling back
3230
+ --to=<value> Roll back to this snapshot id instead of the most recent one
3231
+
3232
+ GLOBAL FLAGS
3233
+ --json Format output as json.
3234
+
3235
+ DESCRIPTION
3236
+ Restore ACF field groups, post types, taxonomies, and options pages to a snapshot taken automatically before an
3237
+ earlier `lps acf push`
3238
+
3239
+ ALIASES
3240
+ $ lps scf rollback
3241
+
3242
+ EXAMPLES
3243
+ $ lps acf rollback
3244
+
3245
+ $ lps acf rollback --list
3246
+
3247
+ $ lps acf rollback --to 1732000000000
3248
+
3249
+ $ lps acf rollback --dry-run
3250
+ ```
3040
3251
 
3041
3252
  ## `lps snippet diff [PATH]`
3042
3253
 
@@ -3067,11 +3278,11 @@ EXAMPLES
3067
3278
  $ lps snippet diff --env staging --against production
3068
3279
  ```
3069
3280
 
3070
- _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/diff.ts)_
3281
+ _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/diff.ts)_
3071
3282
 
3072
3283
  ## `lps snippet list`
3073
3284
 
3074
- List snippets from WordPress
3285
+ List snippets currently on WordPress
3075
3286
 
3076
3287
  ```
3077
3288
  USAGE
@@ -3084,13 +3295,13 @@ GLOBAL FLAGS
3084
3295
  --json Format output as json.
3085
3296
 
3086
3297
  DESCRIPTION
3087
- List snippets from WordPress
3298
+ List snippets currently on WordPress
3088
3299
 
3089
3300
  EXAMPLES
3090
3301
  $ lps snippet list
3091
3302
  ```
3092
3303
 
3093
- _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/list.ts)_
3304
+ _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/list.ts)_
3094
3305
 
3095
3306
  ## `lps snippet publish [PATH]`
3096
3307
 
@@ -3113,11 +3324,11 @@ EXAMPLES
3113
3324
  $ lps snippet publish ./snippets
3114
3325
  ```
3115
3326
 
3116
- _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/publish.ts)_
3327
+ _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/publish.ts)_
3117
3328
 
3118
3329
  ## `lps snippet pull [PATH]`
3119
3330
 
3120
- Pull snippets from WordPress
3331
+ Pull snippets from WordPress into local files
3121
3332
 
3122
3333
  ```
3123
3334
  USAGE
@@ -3135,7 +3346,7 @@ GLOBAL FLAGS
3135
3346
  --json Format output as json.
3136
3347
 
3137
3348
  DESCRIPTION
3138
- Pull snippets from WordPress
3349
+ Pull snippets from WordPress into local files
3139
3350
 
3140
3351
  EXAMPLES
3141
3352
  $ lps snippet pull
@@ -3143,11 +3354,11 @@ EXAMPLES
3143
3354
  $ lps snippet pull ./snippets
3144
3355
  ```
3145
3356
 
3146
- _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/pull.ts)_
3357
+ _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/pull.ts)_
3147
3358
 
3148
3359
  ## `lps snippet push [PATH]`
3149
3360
 
3150
- Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
3361
+ Push local snippet files to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.
3151
3362
 
3152
3363
  ```
3153
3364
  USAGE
@@ -3160,14 +3371,15 @@ FLAGS
3160
3371
  -d, --dry-run Show what would change without making changes
3161
3372
  -y, --yes Answer yes to confirmation prompts
3162
3373
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3163
- --overwrite Push even over changes made on the site outside Loopress since your last push
3374
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
3375
+ over a same-slug page Loopress did not create
3164
3376
 
3165
3377
  GLOBAL FLAGS
3166
3378
  --json Format output as json.
3167
3379
 
3168
3380
  DESCRIPTION
3169
- Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>`
3170
- convention.
3381
+ Push local snippet files to WordPress. Local snippet files created or updated remotely are renamed on disk to the
3382
+ `<id>-<slug>` convention.
3171
3383
 
3172
3384
  EXAMPLES
3173
3385
  $ lps snippet push
@@ -3175,7 +3387,7 @@ EXAMPLES
3175
3387
  $ lps snippet push ./snippets
3176
3388
  ```
3177
3389
 
3178
- _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/push.ts)_
3390
+ _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/push.ts)_
3179
3391
 
3180
3392
  ## `lps snippet rollback [PATH]`
3181
3393
 
@@ -3211,7 +3423,7 @@ EXAMPLES
3211
3423
  $ lps snippet rollback --dry-run
3212
3424
  ```
3213
3425
 
3214
- _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/snippet/rollback.ts)_
3426
+ _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/snippet/rollback.ts)_
3215
3427
 
3216
3428
  ## `lps status`
3217
3429
 
@@ -3236,7 +3448,7 @@ EXAMPLES
3236
3448
  $ lps status --env staging
3237
3449
  ```
3238
3450
 
3239
- _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/status.ts)_
3451
+ _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/status.ts)_
3240
3452
 
3241
3453
  ## `lps taxonomy diff [PATH]`
3242
3454
 
@@ -3268,7 +3480,7 @@ EXAMPLES
3268
3480
  $ lps taxonomy diff --env staging --against production
3269
3481
  ```
3270
3482
 
3271
- _See code: [src/commands/taxonomy/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/diff.ts)_
3483
+ _See code: [src/commands/taxonomy/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/diff.ts)_
3272
3484
 
3273
3485
  ## `lps taxonomy list`
3274
3486
 
@@ -3292,7 +3504,7 @@ EXAMPLES
3292
3504
  $ lps taxonomy list
3293
3505
  ```
3294
3506
 
3295
- _See code: [src/commands/taxonomy/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/list.ts)_
3507
+ _See code: [src/commands/taxonomy/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/list.ts)_
3296
3508
 
3297
3509
  ## `lps taxonomy pull [PATH]`
3298
3510
 
@@ -3321,7 +3533,7 @@ EXAMPLES
3321
3533
  $ lps taxonomy pull
3322
3534
  ```
3323
3535
 
3324
- _See code: [src/commands/taxonomy/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/pull.ts)_
3536
+ _See code: [src/commands/taxonomy/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/pull.ts)_
3325
3537
 
3326
3538
  ## `lps taxonomy push [PATH]`
3327
3539
 
@@ -3338,7 +3550,8 @@ FLAGS
3338
3550
  -d, --dry-run Show what would change without making changes
3339
3551
  -y, --yes Answer yes to confirmation prompts
3340
3552
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3341
- --overwrite Push even over changes made on the site outside Loopress since your last push
3553
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
3554
+ over a same-slug page Loopress did not create
3342
3555
 
3343
3556
  GLOBAL FLAGS
3344
3557
  --json Format output as json.
@@ -3351,7 +3564,7 @@ EXAMPLES
3351
3564
  $ lps taxonomy push
3352
3565
  ```
3353
3566
 
3354
- _See code: [src/commands/taxonomy/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/push.ts)_
3567
+ _See code: [src/commands/taxonomy/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/push.ts)_
3355
3568
 
3356
3569
  ## `lps taxonomy remove SLUG`
3357
3570
 
@@ -3417,7 +3630,7 @@ EXAMPLES
3417
3630
  $ lps taxonomy remove <slug> --yes
3418
3631
  ```
3419
3632
 
3420
- _See code: [src/commands/taxonomy/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/rm.ts)_
3633
+ _See code: [src/commands/taxonomy/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/rm.ts)_
3421
3634
 
3422
3635
  ## `lps taxonomy rollback [PATH]`
3423
3636
 
@@ -3453,7 +3666,7 @@ EXAMPLES
3453
3666
  $ lps taxonomy rollback --dry-run
3454
3667
  ```
3455
3668
 
3456
- _See code: [src/commands/taxonomy/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/taxonomy/rollback.ts)_
3669
+ _See code: [src/commands/taxonomy/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/taxonomy/rollback.ts)_
3457
3670
 
3458
3671
  ## `lps telemetry disable`
3459
3672
 
@@ -3470,7 +3683,7 @@ EXAMPLES
3470
3683
  $ lps telemetry disable
3471
3684
  ```
3472
3685
 
3473
- _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/telemetry/disable.ts)_
3686
+ _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/telemetry/disable.ts)_
3474
3687
 
3475
3688
  ## `lps telemetry enable`
3476
3689
 
@@ -3487,7 +3700,7 @@ EXAMPLES
3487
3700
  $ lps telemetry enable
3488
3701
  ```
3489
3702
 
3490
- _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/telemetry/enable.ts)_
3703
+ _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/telemetry/enable.ts)_
3491
3704
 
3492
3705
  ## `lps theme add SLUG`
3493
3706
 
@@ -3517,11 +3730,11 @@ EXAMPLES
3517
3730
  $ lps theme add generatepress --version 3.4.0
3518
3731
  ```
3519
3732
 
3520
- _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/add.ts)_
3733
+ _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/add.ts)_
3521
3734
 
3522
3735
  ## `lps theme pull`
3523
3736
 
3524
- Pull everything theme related from WordPress: theme versions and Global Styles
3737
+ Pull everything theme related from WordPress: theme versions into loopress.json, then Global Styles into a local file
3525
3738
 
3526
3739
  ```
3527
3740
  USAGE
@@ -3535,7 +3748,7 @@ GLOBAL FLAGS
3535
3748
  --json Format output as json.
3536
3749
 
3537
3750
  DESCRIPTION
3538
- Pull everything theme related from WordPress: theme versions and Global Styles
3751
+ Pull everything theme related from WordPress: theme versions into loopress.json, then Global Styles into a local file
3539
3752
 
3540
3753
  EXAMPLES
3541
3754
  $ lps theme pull
@@ -3545,11 +3758,11 @@ EXAMPLES
3545
3758
  $ lps theme pull --dry-run
3546
3759
  ```
3547
3760
 
3548
- _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/pull.ts)_
3761
+ _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/pull.ts)_
3549
3762
 
3550
3763
  ## `lps theme push`
3551
3764
 
3552
- Push everything theme related to WordPress: theme versions, templates and parts, then Global Styles
3765
+ Push everything theme related to WordPress: theme versions from loopress.json, then block templates and parts, then Global Styles. Never switches the active theme.
3553
3766
 
3554
3767
  ```
3555
3768
  USAGE
@@ -3565,7 +3778,8 @@ GLOBAL FLAGS
3565
3778
  --json Format output as json.
3566
3779
 
3567
3780
  DESCRIPTION
3568
- Push everything theme related to WordPress: theme versions, templates and parts, then Global Styles
3781
+ Push everything theme related to WordPress: theme versions from loopress.json, then block templates and parts, then
3782
+ Global Styles. Never switches the active theme.
3569
3783
 
3570
3784
  EXAMPLES
3571
3785
  $ lps theme push
@@ -3575,7 +3789,7 @@ EXAMPLES
3575
3789
  $ lps theme push --dry-run
3576
3790
  ```
3577
3791
 
3578
- _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/push.ts)_
3792
+ _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/push.ts)_
3579
3793
 
3580
3794
  ## `lps theme status`
3581
3795
 
@@ -3598,7 +3812,7 @@ EXAMPLES
3598
3812
  $ lps theme status
3599
3813
  ```
3600
3814
 
3601
- _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/status.ts)_
3815
+ _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/status.ts)_
3602
3816
 
3603
3817
  ## `lps theme style diff [PATH]`
3604
3818
 
@@ -3630,7 +3844,7 @@ EXAMPLES
3630
3844
  $ lps theme style diff --env staging --against production
3631
3845
  ```
3632
3846
 
3633
- _See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/style/diff.ts)_
3847
+ _See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/style/diff.ts)_
3634
3848
 
3635
3849
  ## `lps theme style pull [PATH]`
3636
3850
 
@@ -3657,7 +3871,7 @@ EXAMPLES
3657
3871
  $ lps theme style pull
3658
3872
  ```
3659
3873
 
3660
- _See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/style/pull.ts)_
3874
+ _See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/style/pull.ts)_
3661
3875
 
3662
3876
  ## `lps theme style push [PATH]`
3663
3877
 
@@ -3674,7 +3888,8 @@ FLAGS
3674
3888
  -d, --dry-run Show what would change without making changes
3675
3889
  -y, --yes Answer yes to confirmation prompts
3676
3890
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3677
- --overwrite Push even over changes made on the site outside Loopress since your last push
3891
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
3892
+ over a same-slug page Loopress did not create
3678
3893
 
3679
3894
  GLOBAL FLAGS
3680
3895
  --json Format output as json.
@@ -3686,7 +3901,7 @@ EXAMPLES
3686
3901
  $ lps theme style push
3687
3902
  ```
3688
3903
 
3689
- _See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/style/push.ts)_
3904
+ _See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/style/push.ts)_
3690
3905
 
3691
3906
  ## `lps theme style rollback [PATH]`
3692
3907
 
@@ -3722,7 +3937,7 @@ EXAMPLES
3722
3937
  $ lps theme style rollback --dry-run
3723
3938
  ```
3724
3939
 
3725
- _See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/style/rollback.ts)_
3940
+ _See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/style/rollback.ts)_
3726
3941
 
3727
3942
  ## `lps theme template diff`
3728
3943
 
@@ -3751,11 +3966,11 @@ EXAMPLES
3751
3966
  $ lps theme template diff --env staging --against production
3752
3967
  ```
3753
3968
 
3754
- _See code: [src/commands/theme/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/template/diff.ts)_
3969
+ _See code: [src/commands/theme/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/template/diff.ts)_
3755
3970
 
3756
3971
  ## `lps theme template list`
3757
3972
 
3758
- Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
3973
+ Show the Loopress child theme of the active block theme: whether it is active, its templates and parts, and those edited in the Site Editor
3759
3974
 
3760
3975
  ```
3761
3976
  USAGE
@@ -3768,13 +3983,14 @@ GLOBAL FLAGS
3768
3983
  --json Format output as json.
3769
3984
 
3770
3985
  DESCRIPTION
3771
- Show the Loopress child theme of the active block theme: its templates, parts, and those edited in the Site Editor
3986
+ Show the Loopress child theme of the active block theme: whether it is active, its templates and parts, and those
3987
+ edited in the Site Editor
3772
3988
 
3773
3989
  EXAMPLES
3774
3990
  $ lps theme template list
3775
3991
  ```
3776
3992
 
3777
- _See code: [src/commands/theme/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/template/list.ts)_
3993
+ _See code: [src/commands/theme/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/template/list.ts)_
3778
3994
 
3779
3995
  ## `lps theme template push`
3780
3996
 
@@ -3788,7 +4004,8 @@ FLAGS
3788
4004
  -d, --dry-run Show what would change without making changes
3789
4005
  -y, --yes Answer yes to confirmation prompts
3790
4006
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3791
- --overwrite Push even over changes made on the site outside Loopress since your last push
4007
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
4008
+ over a same-slug page Loopress did not create
3792
4009
 
3793
4010
  GLOBAL FLAGS
3794
4011
  --json Format output as json.
@@ -3805,7 +4022,7 @@ EXAMPLES
3805
4022
  $ lps theme template push --dry-run
3806
4023
  ```
3807
4024
 
3808
- _See code: [src/commands/theme/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/template/push.ts)_
4025
+ _See code: [src/commands/theme/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/template/push.ts)_
3809
4026
 
3810
4027
  ## `lps theme version pull`
3811
4028
 
@@ -3829,11 +4046,11 @@ EXAMPLES
3829
4046
  $ lps theme version pull
3830
4047
  ```
3831
4048
 
3832
- _See code: [src/commands/theme/version/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/version/pull.ts)_
4049
+ _See code: [src/commands/theme/version/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/version/pull.ts)_
3833
4050
 
3834
4051
  ## `lps theme version push`
3835
4052
 
3836
- Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
4053
+ Install WordPress.org themes on WordPress to match loopress.json, via Composer + WPackagist (versions only, never switches the active theme)
3837
4054
 
3838
4055
  ```
3839
4056
  USAGE
@@ -3844,13 +4061,15 @@ FLAGS
3844
4061
  -y, --yes Answer yes to confirmation prompts
3845
4062
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3846
4063
  --force Allow downgrades and take over themes installed outside Loopress
3847
- --overwrite Push even over changes made on the site outside Loopress since your last push
4064
+ --overwrite Push even over changes made on the site outside Loopress since your last push. Pages: also take
4065
+ over a same-slug page Loopress did not create
3848
4066
 
3849
4067
  GLOBAL FLAGS
3850
4068
  --json Format output as json.
3851
4069
 
3852
4070
  DESCRIPTION
3853
- Install themes on WordPress to match loopress.json (versions only, never switches the active theme)
4071
+ Install WordPress.org themes on WordPress to match loopress.json, via Composer + WPackagist (versions only, never
4072
+ switches the active theme)
3854
4073
 
3855
4074
  EXAMPLES
3856
4075
  $ lps theme version push
@@ -3858,7 +4077,7 @@ EXAMPLES
3858
4077
  $ lps theme version push --force
3859
4078
  ```
3860
4079
 
3861
- _See code: [src/commands/theme/version/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/theme/version/push.ts)_
4080
+ _See code: [src/commands/theme/version/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/theme/version/push.ts)_
3862
4081
 
3863
4082
  ## `lps validate`
3864
4083
 
@@ -3878,5 +4097,5 @@ EXAMPLES
3878
4097
  $ lps validate
3879
4098
  ```
3880
4099
 
3881
- _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.31.0/cli/src/commands/validate.ts)_
4100
+ _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.32.0/cli/src/commands/validate.ts)_
3882
4101
  <!-- commandsstop -->