@loopress/cli 0.30.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 (86) hide show
  1. package/README.md +494 -222
  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 +14 -5
  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/composer/push.d.ts +1 -0
  14. package/dist/commands/composer/push.js +13 -0
  15. package/dist/commands/content/copy.d.ts +28 -0
  16. package/dist/commands/content/copy.js +97 -0
  17. package/dist/commands/diff.d.ts +1 -0
  18. package/dist/commands/diff.js +13 -2
  19. package/dist/commands/doctor.d.ts +1 -0
  20. package/dist/commands/doctor.js +29 -2
  21. package/dist/commands/form/list.js +1 -1
  22. package/dist/commands/form/pull.js +1 -1
  23. package/dist/commands/form/push.d.ts +2 -1
  24. package/dist/commands/form/push.js +6 -3
  25. package/dist/commands/init.js +0 -23
  26. package/dist/commands/menu/push.d.ts +2 -1
  27. package/dist/commands/menu/push.js +1 -1
  28. package/dist/commands/option/push.d.ts +2 -1
  29. package/dist/commands/option/push.js +5 -3
  30. package/dist/commands/page/push.d.ts +4 -1
  31. package/dist/commands/page/push.js +43 -10
  32. package/dist/commands/pattern/push.js +1 -1
  33. package/dist/commands/pattern/rm.js +1 -1
  34. package/dist/commands/plugin/audit.js +42 -25
  35. package/dist/commands/plugin/push.js +1 -1
  36. package/dist/commands/plugin/status.js +1 -1
  37. package/dist/commands/promote.d.ts +1 -0
  38. package/dist/commands/promote.js +7 -3
  39. package/dist/commands/pull.d.ts +2 -1
  40. package/dist/commands/pull.js +37 -5
  41. package/dist/commands/push.d.ts +6 -2
  42. package/dist/commands/push.js +64 -19
  43. package/dist/commands/snippet/list.js +1 -1
  44. package/dist/commands/snippet/pull.js +1 -1
  45. package/dist/commands/snippet/push.d.ts +3 -1
  46. package/dist/commands/snippet/push.js +26 -5
  47. package/dist/commands/theme/pull.js +1 -1
  48. package/dist/commands/theme/push.d.ts +1 -0
  49. package/dist/commands/theme/push.js +3 -3
  50. package/dist/commands/theme/style/push.d.ts +2 -1
  51. package/dist/commands/theme/style/push.js +4 -5
  52. package/dist/commands/theme/template/list.js +1 -1
  53. package/dist/commands/theme/template/push.d.ts +11 -1
  54. package/dist/commands/theme/template/push.js +34 -5
  55. package/dist/commands/theme/version/pull.js +6 -1
  56. package/dist/commands/theme/version/push.js +1 -1
  57. package/dist/lib/base.d.ts +1 -0
  58. package/dist/lib/base.js +3 -0
  59. package/dist/lib/declared-type-command.d.ts +2 -1
  60. package/dist/lib/declared-type-command.js +1 -1
  61. package/dist/lib/diff-command.d.ts +3 -0
  62. package/dist/lib/diff-command.js +34 -5
  63. package/dist/lib/load-snippets.js +4 -0
  64. package/dist/lib/php-files-command.d.ts +11 -1
  65. package/dist/lib/php-files-command.js +39 -19
  66. package/dist/lib/plugin-detection.d.ts +1 -0
  67. package/dist/lib/plugin-detection.js +4 -0
  68. package/dist/lib/push-command.d.ts +21 -2
  69. package/dist/lib/push-command.js +105 -6
  70. package/dist/lib/resource-state.js +5 -5
  71. package/dist/lib/rollback-command.js +9 -2
  72. package/dist/lib/validate-local.js +21 -8
  73. package/dist/lib/wp-client.d.ts +1 -0
  74. package/dist/lib/wp-client.js +27 -1
  75. package/dist/types/snippet.d.ts +1 -0
  76. package/dist/utils/acf-format.d.ts +5 -0
  77. package/dist/utils/acf-format.js +29 -0
  78. package/dist/utils/php-top-level.d.ts +2 -0
  79. package/dist/utils/php-top-level.js +148 -0
  80. package/dist/utils/resource-dirs.d.ts +1 -0
  81. package/dist/utils/resource-dirs.js +7 -1
  82. package/dist/utils/template-format.d.ts +1 -0
  83. package/dist/utils/theme-styles-format.d.ts +2 -0
  84. package/dist/utils/theme-styles-format.js +32 -4
  85. package/oclif.manifest.json +1132 -919
  86. package/package.json +6 -3
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.30.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
@@ -67,6 +67,7 @@ report.
67
67
  * [`lps composer init`](#lps-composer-init)
68
68
  * [`lps composer pull`](#lps-composer-pull)
69
69
  * [`lps composer push`](#lps-composer-push)
70
+ * [`lps content copy FROM`](#lps-content-copy-from)
70
71
  * [`lps cpt diff [PATH]`](#lps-cpt-diff-path)
71
72
  * [`lps cpt list`](#lps-cpt-list)
72
73
  * [`lps cpt pull [PATH]`](#lps-cpt-pull-path)
@@ -144,6 +145,11 @@ report.
144
145
  * [`lps role remove SLUG`](#lps-role-remove-slug)
145
146
  * [`lps role rm SLUG`](#lps-role-rm-slug)
146
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)
147
153
  * [`lps snippet diff [PATH]`](#lps-snippet-diff-path)
148
154
  * [`lps snippet list`](#lps-snippet-list)
149
155
  * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
@@ -197,6 +203,9 @@ DESCRIPTION
197
203
  Show what differs in ACF field groups, post types, taxonomies, and options pages between your local files and a
198
204
  WordPress environment, or between two environments
199
205
 
206
+ ALIASES
207
+ $ lps scf diff
208
+
200
209
  EXAMPLES
201
210
  $ lps acf diff
202
211
 
@@ -205,11 +214,11 @@ EXAMPLES
205
214
  $ lps acf diff --env staging --against production
206
215
  ```
207
216
 
208
- _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
209
218
 
210
219
  ## `lps acf list`
211
220
 
212
- 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
213
222
 
214
223
  ```
215
224
  USAGE
@@ -224,7 +233,10 @@ GLOBAL FLAGS
224
233
  --json Format output as json.
225
234
 
226
235
  DESCRIPTION
227
- 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
228
240
 
229
241
  EXAMPLES
230
242
  $ lps acf list
@@ -232,11 +244,11 @@ EXAMPLES
232
244
  $ lps acf list --type field-groups
233
245
  ```
234
246
 
235
- _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
236
248
 
237
249
  ## `lps acf pull [PATH]`
238
250
 
239
- 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
240
252
 
241
253
  ```
242
254
  USAGE
@@ -257,7 +269,10 @@ GLOBAL FLAGS
257
269
  --json Format output as json.
258
270
 
259
271
  DESCRIPTION
260
- 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
261
276
 
262
277
  EXAMPLES
263
278
  $ lps acf pull
@@ -265,15 +280,15 @@ EXAMPLES
265
280
  $ lps acf pull --type field-groups
266
281
  ```
267
282
 
268
- _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
269
284
 
270
285
  ## `lps acf push [PATH]`
271
286
 
272
- 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
273
288
 
274
289
  ```
275
290
  USAGE
276
- $ lps acf push [PATH] [--json] [--env <value>] [-d] [-y] [--type
291
+ $ lps acf push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y] [--type
277
292
  field-groups|post-types|taxonomies|options-pages...]
278
293
 
279
294
  ARGUMENTS
@@ -283,6 +298,8 @@ FLAGS
283
298
  -d, --dry-run Show what would change without making changes
284
299
  -y, --yes Answer yes to confirmation prompts
285
300
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
286
303
  --type=<option>... Limit to specific ACF object types
287
304
  <options: field-groups|post-types|taxonomies|options-pages>
288
305
 
@@ -290,7 +307,10 @@ GLOBAL FLAGS
290
307
  --json Format output as json.
291
308
 
292
309
  DESCRIPTION
293
- 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
294
314
 
295
315
  EXAMPLES
296
316
  $ lps acf push
@@ -298,7 +318,7 @@ EXAMPLES
298
318
  $ lps acf push --type field-groups
299
319
  ```
300
320
 
301
- _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
302
322
 
303
323
  ## `lps acf rollback [PATH]`
304
324
 
@@ -325,6 +345,9 @@ DESCRIPTION
325
345
  Restore ACF field groups, post types, taxonomies, and options pages to a snapshot taken automatically before an
326
346
  earlier `lps acf push`
327
347
 
348
+ ALIASES
349
+ $ lps scf rollback
350
+
328
351
  EXAMPLES
329
352
  $ lps acf rollback
330
353
 
@@ -335,7 +358,7 @@ EXAMPLES
335
358
  $ lps acf rollback --dry-run
336
359
  ```
337
360
 
338
- _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
339
362
 
340
363
  ## `lps api diff [PATH]`
341
364
 
@@ -367,11 +390,11 @@ EXAMPLES
367
390
  $ lps api diff --env staging --against production
368
391
  ```
369
392
 
370
- _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
371
394
 
372
395
  ## `lps api list`
373
396
 
374
- List custom API route files from WordPress
397
+ List custom API route files currently on WordPress
375
398
 
376
399
  ```
377
400
  USAGE
@@ -384,13 +407,13 @@ GLOBAL FLAGS
384
407
  --json Format output as json.
385
408
 
386
409
  DESCRIPTION
387
- List custom API route files from WordPress
410
+ List custom API route files currently on WordPress
388
411
 
389
412
  EXAMPLES
390
413
  $ lps api list
391
414
  ```
392
415
 
393
- _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
394
417
 
395
418
  ## `lps api publish [PATH]`
396
419
 
@@ -413,11 +436,11 @@ EXAMPLES
413
436
  $ lps api publish ./api
414
437
  ```
415
438
 
416
- _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
417
440
 
418
441
  ## `lps api pull [PATH]`
419
442
 
420
- Pull custom API route files from WordPress
443
+ Pull custom API route files from WordPress into local files
421
444
 
422
445
  ```
423
446
  USAGE
@@ -435,7 +458,7 @@ GLOBAL FLAGS
435
458
  --json Format output as json.
436
459
 
437
460
  DESCRIPTION
438
- Pull custom API route files from WordPress
461
+ Pull custom API route files from WordPress into local files
439
462
 
440
463
  EXAMPLES
441
464
  $ lps api pull
@@ -443,15 +466,15 @@ EXAMPLES
443
466
  $ lps api pull --path ./api
444
467
  ```
445
468
 
446
- _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
447
470
 
448
471
  ## `lps api push [PATH]`
449
472
 
450
- Push custom API route files to WordPress
473
+ Push local custom API route files to WordPress
451
474
 
452
475
  ```
453
476
  USAGE
454
- $ lps api push [PATH] [--json] [--env <value>] [-d] [-y] [--prune]
477
+ $ lps api push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y] [--prune]
455
478
 
456
479
  ARGUMENTS
457
480
  [PATH] Path to api directory (overrides project config)
@@ -460,13 +483,15 @@ FLAGS
460
483
  -d, --dry-run Show what would change without making changes
461
484
  -y, --yes Answer yes to confirmation prompts
462
485
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
463
488
  --prune Delete server-side route files not present locally after pushing
464
489
 
465
490
  GLOBAL FLAGS
466
491
  --json Format output as json.
467
492
 
468
493
  DESCRIPTION
469
- Push custom API route files to WordPress
494
+ Push local custom API route files to WordPress
470
495
 
471
496
  EXAMPLES
472
497
  $ lps api push
@@ -476,11 +501,11 @@ EXAMPLES
476
501
  $ lps api push --prune
477
502
  ```
478
503
 
479
- _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
480
505
 
481
506
  ## `lps api remove FILENAME`
482
507
 
483
- Remove a custom API route file from WordPress
508
+ Remove one custom API route file from WordPress
484
509
 
485
510
  ```
486
511
  USAGE
@@ -498,7 +523,7 @@ GLOBAL FLAGS
498
523
  --json Format output as json.
499
524
 
500
525
  DESCRIPTION
501
- Remove a custom API route file from WordPress
526
+ Remove one custom API route file from WordPress
502
527
 
503
528
  ALIASES
504
529
  $ lps api remove
@@ -511,7 +536,7 @@ EXAMPLES
511
536
 
512
537
  ## `lps api rm FILENAME`
513
538
 
514
- Remove a custom API route file from WordPress
539
+ Remove one custom API route file from WordPress
515
540
 
516
541
  ```
517
542
  USAGE
@@ -529,7 +554,7 @@ GLOBAL FLAGS
529
554
  --json Format output as json.
530
555
 
531
556
  DESCRIPTION
532
- Remove a custom API route file from WordPress
557
+ Remove one custom API route file from WordPress
533
558
 
534
559
  ALIASES
535
560
  $ lps api remove
@@ -540,7 +565,7 @@ EXAMPLES
540
565
  $ lps api remove hello --yes
541
566
  ```
542
567
 
543
- _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
544
569
 
545
570
  ## `lps api rollback [PATH]`
546
571
 
@@ -576,7 +601,7 @@ EXAMPLES
576
601
  $ lps api rollback --dry-run
577
602
  ```
578
603
 
579
- _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
580
605
 
581
606
  ## `lps app list`
582
607
 
@@ -599,7 +624,7 @@ EXAMPLES
599
624
  $ lps app list
600
625
  ```
601
626
 
602
- _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
603
628
 
604
629
  ## `lps app pull [PATH]`
605
630
 
@@ -627,7 +652,7 @@ EXAMPLES
627
652
  $ lps app pull
628
653
  ```
629
654
 
630
- _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
631
656
 
632
657
  ## `lps app push [NAME]`
633
658
 
@@ -635,7 +660,7 @@ Build and push single-page app bundles to WordPress. Each app is an `apps/<name>
635
660
 
636
661
  ```
637
662
  USAGE
638
- $ lps app push [NAME] [--json] [--env <value>] [--build] [-d] [-y]
663
+ $ lps app push [NAME] [--json] [--env <value>] [--overwrite] [--build] [-d] [-y]
639
664
 
640
665
  ARGUMENTS
641
666
  [NAME] Push only this app (defaults to every app in the directory)
@@ -645,6 +670,8 @@ FLAGS
645
670
  -y, --yes Answer yes to confirmation prompts
646
671
  --[no-]build Run the app's package.json build script before pushing
647
672
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
648
675
 
649
676
  GLOBAL FLAGS
650
677
  --json Format output as json.
@@ -662,7 +689,7 @@ EXAMPLES
662
689
  $ lps app push --no-build
663
690
  ```
664
691
 
665
- _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
666
693
 
667
694
  ## `lps app remove NAME`
668
695
 
@@ -691,7 +718,7 @@ EXAMPLES
691
718
  $ lps app remove search
692
719
  ```
693
720
 
694
- _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
695
722
 
696
723
  ## `lps composer init`
697
724
 
@@ -714,11 +741,11 @@ EXAMPLES
714
741
  $ lps composer init --dry-run
715
742
  ```
716
743
 
717
- _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
718
745
 
719
746
  ## `lps composer pull`
720
747
 
721
- Pull composer.json and composer.lock from WordPress
748
+ Pull composer.json and composer.lock from WordPress into local files
722
749
 
723
750
  ```
724
751
  USAGE
@@ -732,7 +759,7 @@ GLOBAL FLAGS
732
759
  --json Format output as json.
733
760
 
734
761
  DESCRIPTION
735
- Pull composer.json and composer.lock from WordPress
762
+ Pull composer.json and composer.lock from WordPress into local files
736
763
 
737
764
  EXAMPLES
738
765
  $ lps composer pull
@@ -740,7 +767,7 @@ EXAMPLES
740
767
  $ lps composer pull --dry-run
741
768
  ```
742
769
 
743
- _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
744
771
 
745
772
  ## `lps composer push`
746
773
 
@@ -748,13 +775,15 @@ Push composer.json to WordPress and run Composer to resolve and install dependen
748
775
 
749
776
  ```
750
777
  USAGE
751
- $ lps composer push [--json] [--env <value>] [-d] [-y] [--force]
778
+ $ lps composer push [--json] [--env <value>] [--overwrite] [-d] [-y] [--force]
752
779
 
753
780
  FLAGS
754
781
  -d, --dry-run Show what would change without making changes
755
782
  -y, --yes Answer yes to confirmation prompts
756
783
  --env=<value> Target environment by name (default: "local", or the project's only environment)
757
784
  --force Allow downgrades and take over plugins/themes installed outside Loopress
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
758
787
 
759
788
  GLOBAL FLAGS
760
789
  --json Format output as json.
@@ -768,7 +797,38 @@ EXAMPLES
768
797
  $ lps composer push --dry-run
769
798
  ```
770
799
 
771
- _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
801
+
802
+ ## `lps content copy FROM`
803
+
804
+ Replace the local site's content (posts, pages, public custom post types, terms) with the content of <from>, then push the project to the local site so tracked configuration wins. Media stay served by <from>, users, comments and orders are never copied.
805
+
806
+ ```
807
+ USAGE
808
+ $ lps content copy FROM [--json] [-d] [-y]
809
+
810
+ ARGUMENTS
811
+ FROM Environment to copy the content from
812
+
813
+ FLAGS
814
+ -d, --dry-run Show what would change without making changes
815
+ -y, --yes Answer yes to confirmation prompts
816
+
817
+ GLOBAL FLAGS
818
+ --json Format output as json.
819
+
820
+ DESCRIPTION
821
+ Replace the local site's content (posts, pages, public custom post types, terms) with the content of <from>, then push
822
+ the project to the local site so tracked configuration wins. Media stay served by <from>, users, comments and orders
823
+ are never copied.
824
+
825
+ EXAMPLES
826
+ $ lps content copy production
827
+
828
+ $ lps content copy staging --dry-run
829
+ ```
830
+
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)_
772
832
 
773
833
  ## `lps cpt diff [PATH]`
774
834
 
@@ -800,7 +860,7 @@ EXAMPLES
800
860
  $ lps cpt diff --env staging --against production
801
861
  ```
802
862
 
803
- _See code: [src/commands/cpt/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
804
864
 
805
865
  ## `lps cpt list`
806
866
 
@@ -824,7 +884,7 @@ EXAMPLES
824
884
  $ lps cpt list
825
885
  ```
826
886
 
827
- _See code: [src/commands/cpt/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
828
888
 
829
889
  ## `lps cpt pull [PATH]`
830
890
 
@@ -853,7 +913,7 @@ EXAMPLES
853
913
  $ lps cpt pull
854
914
  ```
855
915
 
856
- _See code: [src/commands/cpt/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
857
917
 
858
918
  ## `lps cpt push [PATH]`
859
919
 
@@ -861,7 +921,7 @@ Push local custom post types (cpt/<slug>.json, register_post_type() arguments) t
861
921
 
862
922
  ```
863
923
  USAGE
864
- $ lps cpt push [PATH] [--json] [--env <value>] [-d] [-y]
924
+ $ lps cpt push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
865
925
 
866
926
  ARGUMENTS
867
927
  [PATH] Path to the cpt directory (overrides project config)
@@ -870,6 +930,8 @@ FLAGS
870
930
  -d, --dry-run Show what would change without making changes
871
931
  -y, --yes Answer yes to confirmation prompts
872
932
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
873
935
 
874
936
  GLOBAL FLAGS
875
937
  --json Format output as json.
@@ -882,7 +944,7 @@ EXAMPLES
882
944
  $ lps cpt push
883
945
  ```
884
946
 
885
- _See code: [src/commands/cpt/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
886
948
 
887
949
  ## `lps cpt remove SLUG`
888
950
 
@@ -948,7 +1010,7 @@ EXAMPLES
948
1010
  $ lps cpt remove <slug> --yes
949
1011
  ```
950
1012
 
951
- _See code: [src/commands/cpt/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
952
1014
 
953
1015
  ## `lps cpt rollback [PATH]`
954
1016
 
@@ -984,7 +1046,7 @@ EXAMPLES
984
1046
  $ lps cpt rollback --dry-run
985
1047
  ```
986
1048
 
987
- _See code: [src/commands/cpt/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
988
1050
 
989
1051
  ## `lps dev`
990
1052
 
@@ -1012,11 +1074,11 @@ EXAMPLES
1012
1074
  $ lps dev --skip=plugins
1013
1075
  ```
1014
1076
 
1015
- _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1016
1078
 
1017
1079
  ## `lps diff`
1018
1080
 
1019
- 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.
1020
1082
 
1021
1083
  ```
1022
1084
  USAGE
@@ -1040,9 +1102,10 @@ GLOBAL FLAGS
1040
1102
 
1041
1103
  DESCRIPTION
1042
1104
  Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers
1043
- snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, Options, Menus, Theme styles, and Composer.
1044
- Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on drift, 2 when a
1045
- 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.
1046
1109
 
1047
1110
  EXAMPLES
1048
1111
  $ lps diff
@@ -1056,11 +1119,11 @@ EXAMPLES
1056
1119
  $ lps diff --skip composer
1057
1120
  ```
1058
1121
 
1059
- _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1060
1123
 
1061
1124
  ## `lps doctor`
1062
1125
 
1063
- Diagnose connectivity, plugin and credential problems for the targeted environment
1126
+ Diagnose connectivity, plugin, credential and hook problems for the targeted environment
1064
1127
 
1065
1128
  ```
1066
1129
  USAGE
@@ -1073,7 +1136,7 @@ GLOBAL FLAGS
1073
1136
  --json Format output as json.
1074
1137
 
1075
1138
  DESCRIPTION
1076
- Diagnose connectivity, plugin and credential problems for the targeted environment
1139
+ Diagnose connectivity, plugin, credential and hook problems for the targeted environment
1077
1140
 
1078
1141
  EXAMPLES
1079
1142
  $ lps doctor
@@ -1081,7 +1144,7 @@ EXAMPLES
1081
1144
  $ lps doctor --env production
1082
1145
  ```
1083
1146
 
1084
- _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1085
1148
 
1086
1149
  ## `lps form diff [PATH]`
1087
1150
 
@@ -1112,11 +1175,11 @@ EXAMPLES
1112
1175
  $ lps form diff --env staging --against production
1113
1176
  ```
1114
1177
 
1115
- _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1116
1179
 
1117
1180
  ## `lps form list`
1118
1181
 
1119
- List forms from WordPress
1182
+ List forms currently on WordPress
1120
1183
 
1121
1184
  ```
1122
1185
  USAGE
@@ -1129,17 +1192,17 @@ GLOBAL FLAGS
1129
1192
  --json Format output as json.
1130
1193
 
1131
1194
  DESCRIPTION
1132
- List forms from WordPress
1195
+ List forms currently on WordPress
1133
1196
 
1134
1197
  EXAMPLES
1135
1198
  $ lps form list
1136
1199
  ```
1137
1200
 
1138
- _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1139
1202
 
1140
1203
  ## `lps form pull [PATH]`
1141
1204
 
1142
- Pull forms from WordPress
1205
+ Pull forms from WordPress into local files
1143
1206
 
1144
1207
  ```
1145
1208
  USAGE
@@ -1157,21 +1220,21 @@ GLOBAL FLAGS
1157
1220
  --json Format output as json.
1158
1221
 
1159
1222
  DESCRIPTION
1160
- Pull forms from WordPress
1223
+ Pull forms from WordPress into local files
1161
1224
 
1162
1225
  EXAMPLES
1163
1226
  $ lps form pull
1164
1227
  ```
1165
1228
 
1166
- _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1167
1230
 
1168
1231
  ## `lps form push [PATH]`
1169
1232
 
1170
- 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.
1171
1234
 
1172
1235
  ```
1173
1236
  USAGE
1174
- $ lps form push [PATH] [--json] [--env <value>] [-d] [-y] [--allow-notifications]
1237
+ $ lps form push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y] [--allow-notifications]
1175
1238
 
1176
1239
  ARGUMENTS
1177
1240
  [PATH] Path to forms directory (overrides project config)
@@ -1183,13 +1246,15 @@ FLAGS
1183
1246
  messages). Off by default: the server keeps its own so a stray push can't redirect
1184
1247
  submissions.
1185
1248
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
1186
1251
 
1187
1252
  GLOBAL FLAGS
1188
1253
  --json Format output as json.
1189
1254
 
1190
1255
  DESCRIPTION
1191
- Push forms to WordPress. Local files created or updated remotely are renamed on disk to the `<id>-<slug>.json`
1192
- 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.
1193
1258
 
1194
1259
  EXAMPLES
1195
1260
  $ lps form push
@@ -1197,7 +1262,7 @@ EXAMPLES
1197
1262
  $ lps form push --allow-notifications
1198
1263
  ```
1199
1264
 
1200
- _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1201
1266
 
1202
1267
  ## `lps form rollback [PATH]`
1203
1268
 
@@ -1233,7 +1298,7 @@ EXAMPLES
1233
1298
  $ lps form rollback --dry-run
1234
1299
  ```
1235
1300
 
1236
- _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1237
1302
 
1238
1303
  ## `lps help [COMMAND]`
1239
1304
 
@@ -1284,11 +1349,11 @@ EXAMPLES
1284
1349
  $ lps hook diff --env staging --against production
1285
1350
  ```
1286
1351
 
1287
- _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1288
1353
 
1289
1354
  ## `lps hook list`
1290
1355
 
1291
- List hook files (actions, filters, cron) from WordPress
1356
+ List hook files (actions, filters, cron) currently on WordPress
1292
1357
 
1293
1358
  ```
1294
1359
  USAGE
@@ -1301,17 +1366,17 @@ GLOBAL FLAGS
1301
1366
  --json Format output as json.
1302
1367
 
1303
1368
  DESCRIPTION
1304
- List hook files (actions, filters, cron) from WordPress
1369
+ List hook files (actions, filters, cron) currently on WordPress
1305
1370
 
1306
1371
  EXAMPLES
1307
1372
  $ lps hook list
1308
1373
  ```
1309
1374
 
1310
- _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1311
1376
 
1312
1377
  ## `lps hook pull [PATH]`
1313
1378
 
1314
- Pull hook files (actions, filters, cron) from WordPress
1379
+ Pull hook files (actions, filters, cron) from WordPress into local files
1315
1380
 
1316
1381
  ```
1317
1382
  USAGE
@@ -1329,7 +1394,7 @@ GLOBAL FLAGS
1329
1394
  --json Format output as json.
1330
1395
 
1331
1396
  DESCRIPTION
1332
- Pull hook files (actions, filters, cron) from WordPress
1397
+ Pull hook files (actions, filters, cron) from WordPress into local files
1333
1398
 
1334
1399
  EXAMPLES
1335
1400
  $ lps hook pull
@@ -1337,15 +1402,15 @@ EXAMPLES
1337
1402
  $ lps hook pull --path ./hooks
1338
1403
  ```
1339
1404
 
1340
- _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1341
1406
 
1342
1407
  ## `lps hook push [PATH]`
1343
1408
 
1344
- Push hook files (actions, filters, cron) to WordPress
1409
+ Push local hook files (actions, filters, cron) to WordPress
1345
1410
 
1346
1411
  ```
1347
1412
  USAGE
1348
- $ lps hook push [PATH] [--json] [--env <value>] [-d] [-y] [--prune]
1413
+ $ lps hook push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y] [--prune]
1349
1414
 
1350
1415
  ARGUMENTS
1351
1416
  [PATH] Path to hooks directory (overrides project config)
@@ -1354,13 +1419,15 @@ FLAGS
1354
1419
  -d, --dry-run Show what would change without making changes
1355
1420
  -y, --yes Answer yes to confirmation prompts
1356
1421
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
1357
1424
  --prune Delete server-side hook files not present locally after pushing
1358
1425
 
1359
1426
  GLOBAL FLAGS
1360
1427
  --json Format output as json.
1361
1428
 
1362
1429
  DESCRIPTION
1363
- Push hook files (actions, filters, cron) to WordPress
1430
+ Push local hook files (actions, filters, cron) to WordPress
1364
1431
 
1365
1432
  EXAMPLES
1366
1433
  $ lps hook push
@@ -1370,11 +1437,11 @@ EXAMPLES
1370
1437
  $ lps hook push --prune
1371
1438
  ```
1372
1439
 
1373
- _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1374
1441
 
1375
1442
  ## `lps hook remove FILENAME`
1376
1443
 
1377
- Remove a hook file (action, filter, cron) from WordPress
1444
+ Remove one hook file (action, filter, cron) from WordPress
1378
1445
 
1379
1446
  ```
1380
1447
  USAGE
@@ -1392,7 +1459,7 @@ GLOBAL FLAGS
1392
1459
  --json Format output as json.
1393
1460
 
1394
1461
  DESCRIPTION
1395
- Remove a hook file (action, filter, cron) from WordPress
1462
+ Remove one hook file (action, filter, cron) from WordPress
1396
1463
 
1397
1464
  ALIASES
1398
1465
  $ lps hook remove
@@ -1405,7 +1472,7 @@ EXAMPLES
1405
1472
 
1406
1473
  ## `lps hook rm FILENAME`
1407
1474
 
1408
- Remove a hook file (action, filter, cron) from WordPress
1475
+ Remove one hook file (action, filter, cron) from WordPress
1409
1476
 
1410
1477
  ```
1411
1478
  USAGE
@@ -1423,7 +1490,7 @@ GLOBAL FLAGS
1423
1490
  --json Format output as json.
1424
1491
 
1425
1492
  DESCRIPTION
1426
- Remove a hook file (action, filter, cron) from WordPress
1493
+ Remove one hook file (action, filter, cron) from WordPress
1427
1494
 
1428
1495
  ALIASES
1429
1496
  $ lps hook remove
@@ -1434,7 +1501,7 @@ EXAMPLES
1434
1501
  $ lps hook remove hello --yes
1435
1502
  ```
1436
1503
 
1437
- _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1438
1505
 
1439
1506
  ## `lps hook rollback [PATH]`
1440
1507
 
@@ -1470,7 +1537,7 @@ EXAMPLES
1470
1537
  $ lps hook rollback --dry-run
1471
1538
  ```
1472
1539
 
1473
- _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1474
1541
 
1475
1542
  ## `lps init`
1476
1543
 
@@ -1487,7 +1554,7 @@ EXAMPLES
1487
1554
  $ lps init
1488
1555
  ```
1489
1556
 
1490
- _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1491
1558
 
1492
1559
  ## `lps login`
1493
1560
 
@@ -1504,7 +1571,7 @@ EXAMPLES
1504
1571
  $ lps login
1505
1572
  ```
1506
1573
 
1507
- _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1508
1575
 
1509
1576
  ## `lps logout`
1510
1577
 
@@ -1521,7 +1588,7 @@ EXAMPLES
1521
1588
  $ lps logout
1522
1589
  ```
1523
1590
 
1524
- _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1525
1592
 
1526
1593
  ## `lps menu diff [PATH]`
1527
1594
 
@@ -1553,7 +1620,7 @@ EXAMPLES
1553
1620
  $ lps menu diff --env staging --against production
1554
1621
  ```
1555
1622
 
1556
- _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1557
1624
 
1558
1625
  ## `lps menu list`
1559
1626
 
@@ -1576,7 +1643,7 @@ EXAMPLES
1576
1643
  $ lps menu list
1577
1644
  ```
1578
1645
 
1579
- _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1580
1647
 
1581
1648
  ## `lps menu pull [PATH]`
1582
1649
 
@@ -1604,7 +1671,7 @@ EXAMPLES
1604
1671
  $ lps menu pull
1605
1672
  ```
1606
1673
 
1607
- _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1608
1675
 
1609
1676
  ## `lps menu push [PATH]`
1610
1677
 
@@ -1612,7 +1679,7 @@ Push local nav menus and the active theme menu locations to WordPress. Each menu
1612
1679
 
1613
1680
  ```
1614
1681
  USAGE
1615
- $ lps menu push [PATH] [--json] [--env <value>] [-d] [-y]
1682
+ $ lps menu push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
1616
1683
 
1617
1684
  ARGUMENTS
1618
1685
  [PATH] Path to menus directory (overrides project config)
@@ -1621,6 +1688,8 @@ FLAGS
1621
1688
  -d, --dry-run Show what would change without making changes
1622
1689
  -y, --yes Answer yes to confirmation prompts
1623
1690
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
1624
1693
 
1625
1694
  GLOBAL FLAGS
1626
1695
  --json Format output as json.
@@ -1634,7 +1703,7 @@ EXAMPLES
1634
1703
  $ lps menu push
1635
1704
  ```
1636
1705
 
1637
- _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1638
1707
 
1639
1708
  ## `lps menu rollback [PATH]`
1640
1709
 
@@ -1670,7 +1739,7 @@ EXAMPLES
1670
1739
  $ lps menu rollback --dry-run
1671
1740
  ```
1672
1741
 
1673
- _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1674
1743
 
1675
1744
  ## `lps meta diff [PATH]`
1676
1745
 
@@ -1702,7 +1771,7 @@ EXAMPLES
1702
1771
  $ lps meta diff --env staging --against production
1703
1772
  ```
1704
1773
 
1705
- _See code: [src/commands/meta/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1706
1775
 
1707
1776
  ## `lps meta list`
1708
1777
 
@@ -1726,7 +1795,7 @@ EXAMPLES
1726
1795
  $ lps meta list
1727
1796
  ```
1728
1797
 
1729
- _See code: [src/commands/meta/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1730
1799
 
1731
1800
  ## `lps meta pull [PATH]`
1732
1801
 
@@ -1755,7 +1824,7 @@ EXAMPLES
1755
1824
  $ lps meta pull
1756
1825
  ```
1757
1826
 
1758
- _See code: [src/commands/meta/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1759
1828
 
1760
1829
  ## `lps meta push [PATH]`
1761
1830
 
@@ -1763,7 +1832,7 @@ Push local post meta keys (meta/<post-type>.json, each key mapped to its registe
1763
1832
 
1764
1833
  ```
1765
1834
  USAGE
1766
- $ lps meta push [PATH] [--json] [--env <value>] [-d] [-y]
1835
+ $ lps meta push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
1767
1836
 
1768
1837
  ARGUMENTS
1769
1838
  [PATH] Path to the meta directory (overrides project config)
@@ -1772,6 +1841,8 @@ FLAGS
1772
1841
  -d, --dry-run Show what would change without making changes
1773
1842
  -y, --yes Answer yes to confirmation prompts
1774
1843
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
1775
1846
 
1776
1847
  GLOBAL FLAGS
1777
1848
  --json Format output as json.
@@ -1784,7 +1855,7 @@ EXAMPLES
1784
1855
  $ lps meta push
1785
1856
  ```
1786
1857
 
1787
- _See code: [src/commands/meta/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1788
1859
 
1789
1860
  ## `lps meta remove SLUG`
1790
1861
 
@@ -1850,7 +1921,7 @@ EXAMPLES
1850
1921
  $ lps meta remove <slug> --yes
1851
1922
  ```
1852
1923
 
1853
- _See code: [src/commands/meta/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1854
1925
 
1855
1926
  ## `lps meta rollback [PATH]`
1856
1927
 
@@ -1886,7 +1957,7 @@ EXAMPLES
1886
1957
  $ lps meta rollback --dry-run
1887
1958
  ```
1888
1959
 
1889
- _See code: [src/commands/meta/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1890
1961
 
1891
1962
  ## `lps option add NAME`
1892
1963
 
@@ -1917,7 +1988,7 @@ EXAMPLES
1917
1988
  $ lps option add siteurl
1918
1989
  ```
1919
1990
 
1920
- _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1921
1992
 
1922
1993
  ## `lps option diff [PATH]`
1923
1994
 
@@ -1949,7 +2020,7 @@ EXAMPLES
1949
2020
  $ lps option diff --env staging --against production
1950
2021
  ```
1951
2022
 
1952
- _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1953
2024
 
1954
2025
  ## `lps option list`
1955
2026
 
@@ -1979,7 +2050,7 @@ EXAMPLES
1979
2050
  $ lps option list --no-core
1980
2051
  ```
1981
2052
 
1982
- _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
1983
2054
 
1984
2055
  ## `lps option pull [PATH]`
1985
2056
 
@@ -2008,7 +2079,7 @@ EXAMPLES
2008
2079
  $ lps option pull
2009
2080
  ```
2010
2081
 
2011
- _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2012
2083
 
2013
2084
  ## `lps option push [PATH]`
2014
2085
 
@@ -2016,7 +2087,7 @@ Push locally tracked, non-readonly options to WordPress (upsert only, never dele
2016
2087
 
2017
2088
  ```
2018
2089
  USAGE
2019
- $ lps option push [PATH] [--json] [--env <value>] [-d] [-y]
2090
+ $ lps option push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
2020
2091
 
2021
2092
  ARGUMENTS
2022
2093
  [PATH] Path to options directory (overrides project config)
@@ -2025,6 +2096,8 @@ FLAGS
2025
2096
  -d, --dry-run Show what would change without making changes
2026
2097
  -y, --yes Answer yes to confirmation prompts
2027
2098
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
2028
2101
 
2029
2102
  GLOBAL FLAGS
2030
2103
  --json Format output as json.
@@ -2037,7 +2110,7 @@ EXAMPLES
2037
2110
  $ lps option push
2038
2111
  ```
2039
2112
 
2040
- _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2041
2114
 
2042
2115
  ## `lps option remove NAME`
2043
2116
 
@@ -2070,7 +2143,7 @@ EXAMPLES
2070
2143
  $ lps option remove wpseo_titles --local-only
2071
2144
  ```
2072
2145
 
2073
- _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2074
2147
 
2075
2148
  ## `lps option rollback [PATH]`
2076
2149
 
@@ -2106,7 +2179,7 @@ EXAMPLES
2106
2179
  $ lps option rollback --dry-run
2107
2180
  ```
2108
2181
 
2109
- _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2110
2183
 
2111
2184
  ## `lps page diff [PATH]`
2112
2185
 
@@ -2137,7 +2210,7 @@ EXAMPLES
2137
2210
  $ lps page diff --env staging --against production
2138
2211
  ```
2139
2212
 
2140
- _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2141
2214
 
2142
2215
  ## `lps page list`
2143
2216
 
@@ -2160,15 +2233,15 @@ EXAMPLES
2160
2233
  $ lps page list
2161
2234
  ```
2162
2235
 
2163
- _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2164
2237
 
2165
2238
  ## `lps page push [SLUG]`
2166
2239
 
2167
- 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.
2168
2241
 
2169
2242
  ```
2170
2243
  USAGE
2171
- $ lps page push [SLUG] [--json] [--env <value>] [-d] [-y]
2244
+ $ lps page push [SLUG] [--json] [--env <value>] [--overwrite] [-d] [-y]
2172
2245
 
2173
2246
  ARGUMENTS
2174
2247
  [SLUG] Push only this page (its file name without .html). Pushes every page when omitted.
@@ -2177,13 +2250,15 @@ FLAGS
2177
2250
  -d, --dry-run Show what would change without making changes
2178
2251
  -y, --yes Answer yes to confirmation prompts
2179
2252
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
2180
2255
 
2181
2256
  GLOBAL FLAGS
2182
2257
  --json Format output as json.
2183
2258
 
2184
2259
  DESCRIPTION
2185
- Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is
2186
- 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.
2187
2262
 
2188
2263
  EXAMPLES
2189
2264
  $ lps page push
@@ -2191,9 +2266,11 @@ EXAMPLES
2191
2266
  $ lps page push legal-notice
2192
2267
 
2193
2268
  $ lps page push --dry-run
2269
+
2270
+ $ lps page push about --overwrite
2194
2271
  ```
2195
2272
 
2196
- _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2197
2274
 
2198
2275
  ## `lps pattern diff [PATH]`
2199
2276
 
@@ -2225,7 +2302,7 @@ EXAMPLES
2225
2302
  $ lps pattern diff --env staging --against production
2226
2303
  ```
2227
2304
 
2228
- _See code: [src/commands/pattern/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2229
2306
 
2230
2307
  ## `lps pattern list`
2231
2308
 
@@ -2249,7 +2326,7 @@ EXAMPLES
2249
2326
  $ lps pattern list
2250
2327
  ```
2251
2328
 
2252
- _See code: [src/commands/pattern/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2253
2330
 
2254
2331
  ## `lps pattern pull [PATH]`
2255
2332
 
@@ -2278,15 +2355,15 @@ EXAMPLES
2278
2355
  $ lps pattern pull
2279
2356
  ```
2280
2357
 
2281
- _See code: [src/commands/pattern/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2282
2359
 
2283
2360
  ## `lps pattern push [PATH]`
2284
2361
 
2285
- 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`).
2286
2363
 
2287
2364
  ```
2288
2365
  USAGE
2289
- $ lps pattern push [PATH] [--json] [--env <value>] [-d] [-y]
2366
+ $ lps pattern push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
2290
2367
 
2291
2368
  ARGUMENTS
2292
2369
  [PATH] Path to the patterns directory (overrides project config)
@@ -2295,23 +2372,26 @@ FLAGS
2295
2372
  -d, --dry-run Show what would change without making changes
2296
2373
  -y, --yes Answer yes to confirmation prompts
2297
2374
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
2298
2377
 
2299
2378
  GLOBAL FLAGS
2300
2379
  --json Format output as json.
2301
2380
 
2302
2381
  DESCRIPTION
2303
2382
  Push local block patterns (patterns/<slug>.html, block markup under a title/categories header) to WordPress,
2304
- 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`).
2305
2385
 
2306
2386
  EXAMPLES
2307
2387
  $ lps pattern push
2308
2388
  ```
2309
2389
 
2310
- _See code: [src/commands/pattern/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2311
2391
 
2312
2392
  ## `lps pattern remove SLUG`
2313
2393
 
2314
- 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.
2315
2395
 
2316
2396
  ```
2317
2397
  USAGE
@@ -2329,8 +2409,8 @@ GLOBAL FLAGS
2329
2409
  --json Format output as json.
2330
2410
 
2331
2411
  DESCRIPTION
2332
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already
2333
- 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.
2334
2414
 
2335
2415
  ALIASES
2336
2416
  $ lps pattern remove
@@ -2343,7 +2423,7 @@ EXAMPLES
2343
2423
 
2344
2424
  ## `lps pattern rm SLUG`
2345
2425
 
2346
- 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.
2347
2427
 
2348
2428
  ```
2349
2429
  USAGE
@@ -2361,8 +2441,8 @@ GLOBAL FLAGS
2361
2441
  --json Format output as json.
2362
2442
 
2363
2443
  DESCRIPTION
2364
- Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already
2365
- 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.
2366
2446
 
2367
2447
  ALIASES
2368
2448
  $ lps pattern remove
@@ -2373,7 +2453,7 @@ EXAMPLES
2373
2453
  $ lps pattern remove <slug> --yes
2374
2454
  ```
2375
2455
 
2376
- _See code: [src/commands/pattern/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2377
2457
 
2378
2458
  ## `lps pattern rollback [PATH]`
2379
2459
 
@@ -2409,7 +2489,7 @@ EXAMPLES
2409
2489
  $ lps pattern rollback --dry-run
2410
2490
  ```
2411
2491
 
2412
- _See code: [src/commands/pattern/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2413
2493
 
2414
2494
  ## `lps plugin add SLUG`
2415
2495
 
@@ -2441,11 +2521,11 @@ EXAMPLES
2441
2521
  $ lps plugin add contact-form-7 --dry-run
2442
2522
  ```
2443
2523
 
2444
- _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2445
2525
 
2446
2526
  ## `lps plugin audit`
2447
2527
 
2448
- 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
2449
2529
 
2450
2530
  ```
2451
2531
  USAGE
@@ -2458,13 +2538,13 @@ GLOBAL FLAGS
2458
2538
  --json Format output as json.
2459
2539
 
2460
2540
  DESCRIPTION
2461
- 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
2462
2542
 
2463
2543
  EXAMPLES
2464
2544
  $ lps plugin audit
2465
2545
  ```
2466
2546
 
2467
- _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2468
2548
 
2469
2549
  ## `lps plugin pull`
2470
2550
 
@@ -2494,15 +2574,15 @@ EXAMPLES
2494
2574
  $ lps plugin pull --env production --plugin query-monitor
2495
2575
  ```
2496
2576
 
2497
- _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2498
2578
 
2499
2579
  ## `lps plugin push`
2500
2580
 
2501
- 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
2502
2582
 
2503
2583
  ```
2504
2584
  USAGE
2505
- $ lps plugin push [--json] [--env <value>] [-d] [-y] [--activate] [--force] [--prune]
2585
+ $ lps plugin push [--json] [--env <value>] [--overwrite] [-d] [-y] [--activate] [--force] [--prune]
2506
2586
 
2507
2587
  FLAGS
2508
2588
  -d, --dry-run Show what would change without making changes
@@ -2511,13 +2591,16 @@ FLAGS
2511
2591
  current state and new ones stay inactive
2512
2592
  --env=<value> Target environment by name (default: "local", or the project's only environment)
2513
2593
  --force Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
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
2514
2596
  --prune Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)
2515
2597
 
2516
2598
  GLOBAL FLAGS
2517
2599
  --json Format output as json.
2518
2600
 
2519
2601
  DESCRIPTION
2520
- 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
2521
2604
 
2522
2605
  EXAMPLES
2523
2606
  $ lps plugin push
@@ -2527,11 +2610,11 @@ EXAMPLES
2527
2610
  $ lps plugin push --force --prune
2528
2611
  ```
2529
2612
 
2530
- _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2531
2614
 
2532
2615
  ## `lps plugin status`
2533
2616
 
2534
- 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)
2535
2618
 
2536
2619
  ```
2537
2620
  USAGE
@@ -2544,13 +2627,13 @@ GLOBAL FLAGS
2544
2627
  --json Format output as json.
2545
2628
 
2546
2629
  DESCRIPTION
2547
- 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)
2548
2631
 
2549
2632
  EXAMPLES
2550
2633
  $ lps plugin status
2551
2634
  ```
2552
2635
 
2553
- _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2554
2637
 
2555
2638
  ## `lps project config`
2556
2639
 
@@ -2568,7 +2651,7 @@ EXAMPLES
2568
2651
  $ lps project config
2569
2652
  ```
2570
2653
 
2571
- _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2572
2655
 
2573
2656
  ## `lps project list`
2574
2657
 
@@ -2588,7 +2671,7 @@ EXAMPLES
2588
2671
  $ lps project list
2589
2672
  ```
2590
2673
 
2591
- _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2592
2675
 
2593
2676
  ## `lps project pull`
2594
2677
 
@@ -2605,7 +2688,7 @@ EXAMPLES
2605
2688
  $ lps project pull
2606
2689
  ```
2607
2690
 
2608
- _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2609
2692
 
2610
2693
  ## `lps project push`
2611
2694
 
@@ -2625,7 +2708,7 @@ EXAMPLES
2625
2708
  $ lps project push
2626
2709
  ```
2627
2710
 
2628
- _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2629
2712
 
2630
2713
  ## `lps project remove`
2631
2714
 
@@ -2642,7 +2725,7 @@ EXAMPLES
2642
2725
  $ lps project remove
2643
2726
  ```
2644
2727
 
2645
- _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2646
2729
 
2647
2730
  ## `lps project rotate`
2648
2731
 
@@ -2664,7 +2747,7 @@ EXAMPLES
2664
2747
  $ lps project rotate --env staging
2665
2748
  ```
2666
2749
 
2667
- _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2668
2751
 
2669
2752
  ## `lps project switch`
2670
2753
 
@@ -2681,7 +2764,7 @@ EXAMPLES
2681
2764
  $ lps project switch
2682
2765
  ```
2683
2766
 
2684
- _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2685
2768
 
2686
2769
  ## `lps promote FROM TO`
2687
2770
 
@@ -2689,15 +2772,17 @@ Copy every tracked resource from one environment to another by pulling from <fro
2689
2772
 
2690
2773
  ```
2691
2774
  USAGE
2692
- $ lps promote FROM TO [--json] [-d] [-y]
2775
+ $ lps promote FROM TO [--json] [-d] [-y] [--overwrite]
2693
2776
 
2694
2777
  ARGUMENTS
2695
2778
  FROM Environment to copy the configuration from
2696
2779
  TO Environment to copy the configuration to
2697
2780
 
2698
2781
  FLAGS
2699
- -d, --dry-run Show what would change without making changes
2700
- -y, --yes Answer yes to confirmation prompts
2782
+ -d, --dry-run Show what would change without making changes
2783
+ -y, --yes Answer yes to confirmation prompts
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
2701
2786
 
2702
2787
  GLOBAL FLAGS
2703
2788
  --json Format output as json.
@@ -2713,11 +2798,11 @@ EXAMPLES
2713
2798
  $ lps promote production staging --dry-run
2714
2799
  ```
2715
2800
 
2716
- _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2717
2802
 
2718
2803
  ## `lps pull`
2719
2804
 
2720
- 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
2721
2806
 
2722
2807
  ```
2723
2808
  USAGE
@@ -2732,8 +2817,8 @@ GLOBAL FLAGS
2732
2817
  --json Format output as json.
2733
2818
 
2734
2819
  DESCRIPTION
2735
- Pull all content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes, hooks,
2736
- 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
2737
2822
 
2738
2823
  EXAMPLES
2739
2824
  $ lps pull
@@ -2743,27 +2828,30 @@ EXAMPLES
2743
2828
  $ lps pull --dry-run
2744
2829
  ```
2745
2830
 
2746
- _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2747
2832
 
2748
2833
  ## `lps push`
2749
2834
 
2750
- 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
2751
2836
 
2752
2837
  ```
2753
2838
  USAGE
2754
- $ lps push [--json] [--env <value>] [-d] [-y]
2839
+ $ lps push [--json] [--env <value>] [-d] [-y] [--overwrite]
2755
2840
 
2756
2841
  FLAGS
2757
2842
  -d, --dry-run Show what would change without making changes
2758
2843
  -y, --yes Answer yes to confirmation prompts
2759
2844
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
2760
2847
 
2761
2848
  GLOBAL FLAGS
2762
2849
  --json Format output as json.
2763
2850
 
2764
2851
  DESCRIPTION
2765
- Push all local content, plugins, composer dependencies, post types, taxonomies, post meta, roles, ACF, API routes,
2766
- 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
2767
2855
 
2768
2856
  EXAMPLES
2769
2857
  $ lps push
@@ -2773,7 +2861,7 @@ EXAMPLES
2773
2861
  $ lps push --dry-run
2774
2862
  ```
2775
2863
 
2776
- _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2777
2865
 
2778
2866
  ## `lps role diff [PATH]`
2779
2867
 
@@ -2804,7 +2892,7 @@ EXAMPLES
2804
2892
  $ lps role diff --env staging --against production
2805
2893
  ```
2806
2894
 
2807
- _See code: [src/commands/role/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2808
2896
 
2809
2897
  ## `lps role list`
2810
2898
 
@@ -2828,7 +2916,7 @@ EXAMPLES
2828
2916
  $ lps role list
2829
2917
  ```
2830
2918
 
2831
- _See code: [src/commands/role/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2832
2920
 
2833
2921
  ## `lps role pull [PATH]`
2834
2922
 
@@ -2857,7 +2945,7 @@ EXAMPLES
2857
2945
  $ lps role pull
2858
2946
  ```
2859
2947
 
2860
- _See code: [src/commands/role/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2861
2949
 
2862
2950
  ## `lps role push [PATH]`
2863
2951
 
@@ -2865,7 +2953,7 @@ Push local roles (roles/<slug>.json, a "name" and its "capabilities") to WordPre
2865
2953
 
2866
2954
  ```
2867
2955
  USAGE
2868
- $ lps role push [PATH] [--json] [--env <value>] [-d] [-y]
2956
+ $ lps role push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
2869
2957
 
2870
2958
  ARGUMENTS
2871
2959
  [PATH] Path to the roles directory (overrides project config)
@@ -2874,6 +2962,8 @@ FLAGS
2874
2962
  -d, --dry-run Show what would change without making changes
2875
2963
  -y, --yes Answer yes to confirmation prompts
2876
2964
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
2877
2967
 
2878
2968
  GLOBAL FLAGS
2879
2969
  --json Format output as json.
@@ -2886,7 +2976,7 @@ EXAMPLES
2886
2976
  $ lps role push
2887
2977
  ```
2888
2978
 
2889
- _See code: [src/commands/role/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2890
2980
 
2891
2981
  ## `lps role remove SLUG`
2892
2982
 
@@ -2952,7 +3042,7 @@ EXAMPLES
2952
3042
  $ lps role remove <slug> --yes
2953
3043
  ```
2954
3044
 
2955
- _See code: [src/commands/role/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
2956
3046
 
2957
3047
  ## `lps role rollback [PATH]`
2958
3048
 
@@ -2988,7 +3078,176 @@ EXAMPLES
2988
3078
  $ lps role rollback --dry-run
2989
3079
  ```
2990
3080
 
2991
- _See code: [src/commands/role/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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
+ ```
2992
3251
 
2993
3252
  ## `lps snippet diff [PATH]`
2994
3253
 
@@ -3019,11 +3278,11 @@ EXAMPLES
3019
3278
  $ lps snippet diff --env staging --against production
3020
3279
  ```
3021
3280
 
3022
- _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3023
3282
 
3024
3283
  ## `lps snippet list`
3025
3284
 
3026
- List snippets from WordPress
3285
+ List snippets currently on WordPress
3027
3286
 
3028
3287
  ```
3029
3288
  USAGE
@@ -3036,13 +3295,13 @@ GLOBAL FLAGS
3036
3295
  --json Format output as json.
3037
3296
 
3038
3297
  DESCRIPTION
3039
- List snippets from WordPress
3298
+ List snippets currently on WordPress
3040
3299
 
3041
3300
  EXAMPLES
3042
3301
  $ lps snippet list
3043
3302
  ```
3044
3303
 
3045
- _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3046
3305
 
3047
3306
  ## `lps snippet publish [PATH]`
3048
3307
 
@@ -3065,11 +3324,11 @@ EXAMPLES
3065
3324
  $ lps snippet publish ./snippets
3066
3325
  ```
3067
3326
 
3068
- _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3069
3328
 
3070
3329
  ## `lps snippet pull [PATH]`
3071
3330
 
3072
- Pull snippets from WordPress
3331
+ Pull snippets from WordPress into local files
3073
3332
 
3074
3333
  ```
3075
3334
  USAGE
@@ -3087,7 +3346,7 @@ GLOBAL FLAGS
3087
3346
  --json Format output as json.
3088
3347
 
3089
3348
  DESCRIPTION
3090
- Pull snippets from WordPress
3349
+ Pull snippets from WordPress into local files
3091
3350
 
3092
3351
  EXAMPLES
3093
3352
  $ lps snippet pull
@@ -3095,15 +3354,15 @@ EXAMPLES
3095
3354
  $ lps snippet pull ./snippets
3096
3355
  ```
3097
3356
 
3098
- _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3099
3358
 
3100
3359
  ## `lps snippet push [PATH]`
3101
3360
 
3102
- 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.
3103
3362
 
3104
3363
  ```
3105
3364
  USAGE
3106
- $ lps snippet push [PATH] [--json] [--env <value>] [-d] [-y]
3365
+ $ lps snippet push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
3107
3366
 
3108
3367
  ARGUMENTS
3109
3368
  [PATH] Path to snippets directory (overrides project config)
@@ -3112,13 +3371,15 @@ FLAGS
3112
3371
  -d, --dry-run Show what would change without making changes
3113
3372
  -y, --yes Answer yes to confirmation prompts
3114
3373
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
3115
3376
 
3116
3377
  GLOBAL FLAGS
3117
3378
  --json Format output as json.
3118
3379
 
3119
3380
  DESCRIPTION
3120
- Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>`
3121
- 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.
3122
3383
 
3123
3384
  EXAMPLES
3124
3385
  $ lps snippet push
@@ -3126,7 +3387,7 @@ EXAMPLES
3126
3387
  $ lps snippet push ./snippets
3127
3388
  ```
3128
3389
 
3129
- _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3130
3391
 
3131
3392
  ## `lps snippet rollback [PATH]`
3132
3393
 
@@ -3162,7 +3423,7 @@ EXAMPLES
3162
3423
  $ lps snippet rollback --dry-run
3163
3424
  ```
3164
3425
 
3165
- _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3166
3427
 
3167
3428
  ## `lps status`
3168
3429
 
@@ -3187,7 +3448,7 @@ EXAMPLES
3187
3448
  $ lps status --env staging
3188
3449
  ```
3189
3450
 
3190
- _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3191
3452
 
3192
3453
  ## `lps taxonomy diff [PATH]`
3193
3454
 
@@ -3219,7 +3480,7 @@ EXAMPLES
3219
3480
  $ lps taxonomy diff --env staging --against production
3220
3481
  ```
3221
3482
 
3222
- _See code: [src/commands/taxonomy/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3223
3484
 
3224
3485
  ## `lps taxonomy list`
3225
3486
 
@@ -3243,7 +3504,7 @@ EXAMPLES
3243
3504
  $ lps taxonomy list
3244
3505
  ```
3245
3506
 
3246
- _See code: [src/commands/taxonomy/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3247
3508
 
3248
3509
  ## `lps taxonomy pull [PATH]`
3249
3510
 
@@ -3272,7 +3533,7 @@ EXAMPLES
3272
3533
  $ lps taxonomy pull
3273
3534
  ```
3274
3535
 
3275
- _See code: [src/commands/taxonomy/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3276
3537
 
3277
3538
  ## `lps taxonomy push [PATH]`
3278
3539
 
@@ -3280,7 +3541,7 @@ Push local taxonomies (taxonomies/<slug>.json, register_taxonomy() arguments plu
3280
3541
 
3281
3542
  ```
3282
3543
  USAGE
3283
- $ lps taxonomy push [PATH] [--json] [--env <value>] [-d] [-y]
3544
+ $ lps taxonomy push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
3284
3545
 
3285
3546
  ARGUMENTS
3286
3547
  [PATH] Path to the taxonomies directory (overrides project config)
@@ -3289,6 +3550,8 @@ FLAGS
3289
3550
  -d, --dry-run Show what would change without making changes
3290
3551
  -y, --yes Answer yes to confirmation prompts
3291
3552
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
3292
3555
 
3293
3556
  GLOBAL FLAGS
3294
3557
  --json Format output as json.
@@ -3301,7 +3564,7 @@ EXAMPLES
3301
3564
  $ lps taxonomy push
3302
3565
  ```
3303
3566
 
3304
- _See code: [src/commands/taxonomy/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3305
3568
 
3306
3569
  ## `lps taxonomy remove SLUG`
3307
3570
 
@@ -3367,7 +3630,7 @@ EXAMPLES
3367
3630
  $ lps taxonomy remove <slug> --yes
3368
3631
  ```
3369
3632
 
3370
- _See code: [src/commands/taxonomy/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3371
3634
 
3372
3635
  ## `lps taxonomy rollback [PATH]`
3373
3636
 
@@ -3403,7 +3666,7 @@ EXAMPLES
3403
3666
  $ lps taxonomy rollback --dry-run
3404
3667
  ```
3405
3668
 
3406
- _See code: [src/commands/taxonomy/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3407
3670
 
3408
3671
  ## `lps telemetry disable`
3409
3672
 
@@ -3420,7 +3683,7 @@ EXAMPLES
3420
3683
  $ lps telemetry disable
3421
3684
  ```
3422
3685
 
3423
- _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3424
3687
 
3425
3688
  ## `lps telemetry enable`
3426
3689
 
@@ -3437,7 +3700,7 @@ EXAMPLES
3437
3700
  $ lps telemetry enable
3438
3701
  ```
3439
3702
 
3440
- _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3441
3704
 
3442
3705
  ## `lps theme add SLUG`
3443
3706
 
@@ -3467,11 +3730,11 @@ EXAMPLES
3467
3730
  $ lps theme add generatepress --version 3.4.0
3468
3731
  ```
3469
3732
 
3470
- _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3471
3734
 
3472
3735
  ## `lps theme pull`
3473
3736
 
3474
- 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
3475
3738
 
3476
3739
  ```
3477
3740
  USAGE
@@ -3485,7 +3748,7 @@ GLOBAL FLAGS
3485
3748
  --json Format output as json.
3486
3749
 
3487
3750
  DESCRIPTION
3488
- 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
3489
3752
 
3490
3753
  EXAMPLES
3491
3754
  $ lps theme pull
@@ -3495,11 +3758,11 @@ EXAMPLES
3495
3758
  $ lps theme pull --dry-run
3496
3759
  ```
3497
3760
 
3498
- _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3499
3762
 
3500
3763
  ## `lps theme push`
3501
3764
 
3502
- 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.
3503
3766
 
3504
3767
  ```
3505
3768
  USAGE
@@ -3515,7 +3778,8 @@ GLOBAL FLAGS
3515
3778
  --json Format output as json.
3516
3779
 
3517
3780
  DESCRIPTION
3518
- 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.
3519
3783
 
3520
3784
  EXAMPLES
3521
3785
  $ lps theme push
@@ -3525,7 +3789,7 @@ EXAMPLES
3525
3789
  $ lps theme push --dry-run
3526
3790
  ```
3527
3791
 
3528
- _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3529
3793
 
3530
3794
  ## `lps theme status`
3531
3795
 
@@ -3548,7 +3812,7 @@ EXAMPLES
3548
3812
  $ lps theme status
3549
3813
  ```
3550
3814
 
3551
- _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3552
3816
 
3553
3817
  ## `lps theme style diff [PATH]`
3554
3818
 
@@ -3580,7 +3844,7 @@ EXAMPLES
3580
3844
  $ lps theme style diff --env staging --against production
3581
3845
  ```
3582
3846
 
3583
- _See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3584
3848
 
3585
3849
  ## `lps theme style pull [PATH]`
3586
3850
 
@@ -3607,7 +3871,7 @@ EXAMPLES
3607
3871
  $ lps theme style pull
3608
3872
  ```
3609
3873
 
3610
- _See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3611
3875
 
3612
3876
  ## `lps theme style push [PATH]`
3613
3877
 
@@ -3615,7 +3879,7 @@ Push the local Global Styles file to the active block theme's Site Editor > Styl
3615
3879
 
3616
3880
  ```
3617
3881
  USAGE
3618
- $ lps theme style push [PATH] [--json] [--env <value>] [-d] [-y]
3882
+ $ lps theme style push [PATH] [--json] [--env <value>] [--overwrite] [-d] [-y]
3619
3883
 
3620
3884
  ARGUMENTS
3621
3885
  [PATH] Path to theme styles directory (overrides project config)
@@ -3624,6 +3888,8 @@ FLAGS
3624
3888
  -d, --dry-run Show what would change without making changes
3625
3889
  -y, --yes Answer yes to confirmation prompts
3626
3890
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
3627
3893
 
3628
3894
  GLOBAL FLAGS
3629
3895
  --json Format output as json.
@@ -3635,7 +3901,7 @@ EXAMPLES
3635
3901
  $ lps theme style push
3636
3902
  ```
3637
3903
 
3638
- _See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3639
3905
 
3640
3906
  ## `lps theme style rollback [PATH]`
3641
3907
 
@@ -3671,7 +3937,7 @@ EXAMPLES
3671
3937
  $ lps theme style rollback --dry-run
3672
3938
  ```
3673
3939
 
3674
- _See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3675
3941
 
3676
3942
  ## `lps theme template diff`
3677
3943
 
@@ -3700,11 +3966,11 @@ EXAMPLES
3700
3966
  $ lps theme template diff --env staging --against production
3701
3967
  ```
3702
3968
 
3703
- _See code: [src/commands/theme/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3704
3970
 
3705
3971
  ## `lps theme template list`
3706
3972
 
3707
- 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
3708
3974
 
3709
3975
  ```
3710
3976
  USAGE
@@ -3717,13 +3983,14 @@ GLOBAL FLAGS
3717
3983
  --json Format output as json.
3718
3984
 
3719
3985
  DESCRIPTION
3720
- 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
3721
3988
 
3722
3989
  EXAMPLES
3723
3990
  $ lps theme template list
3724
3991
  ```
3725
3992
 
3726
- _See code: [src/commands/theme/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3727
3994
 
3728
3995
  ## `lps theme template push`
3729
3996
 
@@ -3731,12 +3998,14 @@ Push block templates (theme/templates/<slug>.html), template parts (theme/parts/
3731
3998
 
3732
3999
  ```
3733
4000
  USAGE
3734
- $ lps theme template push [--json] [--env <value>] [-d] [-y]
4001
+ $ lps theme template push [--json] [--env <value>] [--overwrite] [-d] [-y]
3735
4002
 
3736
4003
  FLAGS
3737
4004
  -d, --dry-run Show what would change without making changes
3738
4005
  -y, --yes Answer yes to confirmation prompts
3739
4006
  --env=<value> Target environment by name (default: "local", or the project's only environment)
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
3740
4009
 
3741
4010
  GLOBAL FLAGS
3742
4011
  --json Format output as json.
@@ -3753,7 +4022,7 @@ EXAMPLES
3753
4022
  $ lps theme template push --dry-run
3754
4023
  ```
3755
4024
 
3756
- _See code: [src/commands/theme/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3757
4026
 
3758
4027
  ## `lps theme version pull`
3759
4028
 
@@ -3777,27 +4046,30 @@ EXAMPLES
3777
4046
  $ lps theme version pull
3778
4047
  ```
3779
4048
 
3780
- _See code: [src/commands/theme/version/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3781
4050
 
3782
4051
  ## `lps theme version push`
3783
4052
 
3784
- 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)
3785
4054
 
3786
4055
  ```
3787
4056
  USAGE
3788
- $ lps theme version push [--json] [--env <value>] [-d] [-y] [--force]
4057
+ $ lps theme version push [--json] [--env <value>] [--overwrite] [-d] [-y] [--force]
3789
4058
 
3790
4059
  FLAGS
3791
4060
  -d, --dry-run Show what would change without making changes
3792
4061
  -y, --yes Answer yes to confirmation prompts
3793
4062
  --env=<value> Target environment by name (default: "local", or the project's only environment)
3794
4063
  --force Allow downgrades and take over themes installed outside Loopress
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
3795
4066
 
3796
4067
  GLOBAL FLAGS
3797
4068
  --json Format output as json.
3798
4069
 
3799
4070
  DESCRIPTION
3800
- 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)
3801
4073
 
3802
4074
  EXAMPLES
3803
4075
  $ lps theme version push
@@ -3805,7 +4077,7 @@ EXAMPLES
3805
4077
  $ lps theme version push --force
3806
4078
  ```
3807
4079
 
3808
- _See code: [src/commands/theme/version/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3809
4081
 
3810
4082
  ## `lps validate`
3811
4083
 
@@ -3825,5 +4097,5 @@ EXAMPLES
3825
4097
  $ lps validate
3826
4098
  ```
3827
4099
 
3828
- _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.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)_
3829
4101
  <!-- commandsstop -->