@loopress/cli 0.29.0 → 0.30.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 (132) hide show
  1. package/README.md +1301 -345
  2. package/dist/commands/cpt/diff.js +5 -0
  3. package/dist/commands/cpt/list.d.ts +2 -0
  4. package/dist/commands/cpt/list.js +4 -0
  5. package/dist/commands/cpt/pull.d.ts +2 -0
  6. package/dist/commands/cpt/pull.js +4 -0
  7. package/dist/commands/cpt/push.d.ts +2 -0
  8. package/dist/commands/cpt/push.js +4 -0
  9. package/dist/commands/cpt/rm.d.ts +2 -0
  10. package/dist/commands/cpt/rm.js +3 -0
  11. package/dist/commands/cpt/rollback.js +5 -0
  12. package/dist/commands/dev.js +14 -4
  13. package/dist/commands/diff.js +1 -1
  14. package/dist/commands/doctor.d.ts +1 -0
  15. package/dist/commands/doctor.js +30 -2
  16. package/dist/commands/meta/diff.d.ts +2 -0
  17. package/dist/commands/meta/diff.js +5 -0
  18. package/dist/commands/meta/list.d.ts +19 -0
  19. package/dist/commands/meta/list.js +21 -0
  20. package/dist/commands/meta/pull.d.ts +2 -0
  21. package/dist/commands/meta/pull.js +4 -0
  22. package/dist/commands/meta/push.d.ts +2 -0
  23. package/dist/commands/meta/push.js +4 -0
  24. package/dist/commands/meta/rm.d.ts +2 -0
  25. package/dist/commands/meta/rm.js +3 -0
  26. package/dist/commands/meta/rollback.d.ts +2 -0
  27. package/dist/commands/meta/rollback.js +5 -0
  28. package/dist/commands/option/list.js +2 -8
  29. package/dist/commands/pattern/diff.d.ts +2 -0
  30. package/dist/commands/pattern/diff.js +5 -0
  31. package/dist/commands/pattern/list.d.ts +2 -0
  32. package/dist/commands/pattern/list.js +3 -0
  33. package/dist/commands/pattern/pull.d.ts +2 -0
  34. package/dist/commands/pattern/pull.js +4 -0
  35. package/dist/commands/pattern/push.d.ts +2 -0
  36. package/dist/commands/pattern/push.js +4 -0
  37. package/dist/commands/pattern/rm.d.ts +2 -0
  38. package/dist/commands/pattern/rm.js +3 -0
  39. package/dist/commands/pattern/rollback.d.ts +2 -0
  40. package/dist/commands/pattern/rollback.js +5 -0
  41. package/dist/commands/plugin/audit.js +2 -1
  42. package/dist/commands/project/config.d.ts +1 -0
  43. package/dist/commands/project/config.js +20 -1
  44. package/dist/commands/project/list.d.ts +1 -1
  45. package/dist/commands/project/list.js +6 -6
  46. package/dist/commands/project/pull.js +11 -8
  47. package/dist/commands/project/push.js +23 -18
  48. package/dist/commands/project/remove.js +1 -1
  49. package/dist/commands/project/switch.d.ts +0 -1
  50. package/dist/commands/project/switch.js +16 -36
  51. package/dist/commands/pull.js +7 -2
  52. package/dist/commands/push.js +9 -2
  53. package/dist/commands/role/diff.d.ts +2 -0
  54. package/dist/commands/role/diff.js +5 -0
  55. package/dist/commands/role/list.d.ts +2 -0
  56. package/dist/commands/role/list.js +4 -0
  57. package/dist/commands/role/pull.d.ts +2 -0
  58. package/dist/commands/role/pull.js +4 -0
  59. package/dist/commands/role/push.d.ts +2 -0
  60. package/dist/commands/role/push.js +4 -0
  61. package/dist/commands/role/rm.d.ts +2 -0
  62. package/dist/commands/role/rm.js +3 -0
  63. package/dist/commands/role/rollback.d.ts +2 -0
  64. package/dist/commands/role/rollback.js +5 -0
  65. package/dist/commands/status.d.ts +2 -3
  66. package/dist/commands/status.js +21 -53
  67. package/dist/commands/taxonomy/diff.d.ts +2 -0
  68. package/dist/commands/taxonomy/diff.js +5 -0
  69. package/dist/commands/taxonomy/list.d.ts +2 -0
  70. package/dist/commands/taxonomy/list.js +5 -0
  71. package/dist/commands/taxonomy/pull.d.ts +2 -0
  72. package/dist/commands/taxonomy/pull.js +4 -0
  73. package/dist/commands/taxonomy/push.d.ts +2 -0
  74. package/dist/commands/taxonomy/push.js +4 -0
  75. package/dist/commands/taxonomy/rm.d.ts +2 -0
  76. package/dist/commands/taxonomy/rm.js +3 -0
  77. package/dist/commands/taxonomy/rollback.d.ts +2 -0
  78. package/dist/commands/taxonomy/rollback.js +5 -0
  79. package/dist/commands/theme/template/push.d.ts +2 -0
  80. package/dist/commands/theme/template/push.js +26 -5
  81. package/dist/config/project-config.manager.d.ts +3 -3
  82. package/dist/config/project-config.manager.js +22 -31
  83. package/dist/hooks/finally.js +11 -3
  84. package/dist/lib/api-client.js +2 -1
  85. package/dist/lib/app-build.js +3 -1
  86. package/dist/lib/base.d.ts +1 -2
  87. package/dist/lib/base.js +30 -38
  88. package/dist/lib/declared-type-command.d.ts +35 -0
  89. package/dist/lib/declared-type-command.js +192 -0
  90. package/dist/lib/dev-watch.d.ts +1 -1
  91. package/dist/lib/dev-watch.js +7 -3
  92. package/dist/lib/github-release.js +4 -0
  93. package/dist/lib/local-callback-server.js +3 -1
  94. package/dist/lib/push-command.d.ts +1 -0
  95. package/dist/lib/push-command.js +31 -10
  96. package/dist/lib/put-or-create.js +3 -4
  97. package/dist/lib/resource-state.js +33 -80
  98. package/dist/lib/rollback-materialize.js +13 -24
  99. package/dist/lib/spinner.d.ts +2 -0
  100. package/dist/lib/spinner.js +72 -0
  101. package/dist/lib/temp-admin.d.ts +10 -1
  102. package/dist/lib/temp-admin.js +27 -2
  103. package/dist/lib/validate-local.js +31 -9
  104. package/dist/lib/wp-client.d.ts +1 -0
  105. package/dist/lib/wp-client.js +7 -1
  106. package/dist/lib/wp-site-diagnostic.js +3 -2
  107. package/dist/types/global-config.generated.d.ts +1 -5
  108. package/dist/types/project-config.generated.d.ts +28 -4
  109. package/dist/utils/composer.js +2 -1
  110. package/dist/utils/declared-type-format.d.ts +52 -0
  111. package/dist/utils/declared-type-format.js +233 -0
  112. package/dist/utils/resource-dirs.d.ts +9 -3
  113. package/dist/utils/resource-dirs.js +16 -4
  114. package/dist/utils/template-format.d.ts +1 -0
  115. package/dist/utils/theme-css.d.ts +19 -0
  116. package/dist/utils/theme-css.js +100 -0
  117. package/oclif.manifest.json +3012 -1133
  118. package/package.json +28 -15
  119. package/schemas/global-config.schema.json +2 -6
  120. package/schemas/project-config.schema.json +37 -7
  121. package/dist/commands/seo/diff.js +0 -5
  122. package/dist/commands/seo/list.d.ts +0 -18
  123. package/dist/commands/seo/list.js +0 -58
  124. package/dist/commands/seo/pull.d.ts +0 -24
  125. package/dist/commands/seo/pull.js +0 -89
  126. package/dist/commands/seo/push.d.ts +0 -29
  127. package/dist/commands/seo/push.js +0 -178
  128. package/dist/commands/seo/rollback.js +0 -5
  129. package/dist/utils/seo-format.d.ts +0 -29
  130. package/dist/utils/seo-format.js +0 -18
  131. /package/dist/commands/{seo → cpt}/diff.d.ts +0 -0
  132. /package/dist/commands/{seo → cpt}/rollback.d.ts +0 -0
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.29.0 linux-x64 node-v24.21.0
24
+ @loopress/cli/0.30.0 linux-x64 node-v24.21.0
25
25
  $ lps --help [COMMAND]
26
26
  USAGE
27
27
  $ lps COMMAND
@@ -67,6 +67,13 @@ 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 cpt diff [PATH]`](#lps-cpt-diff-path)
71
+ * [`lps cpt list`](#lps-cpt-list)
72
+ * [`lps cpt pull [PATH]`](#lps-cpt-pull-path)
73
+ * [`lps cpt push [PATH]`](#lps-cpt-push-path)
74
+ * [`lps cpt remove SLUG`](#lps-cpt-remove-slug)
75
+ * [`lps cpt rm SLUG`](#lps-cpt-rm-slug)
76
+ * [`lps cpt rollback [PATH]`](#lps-cpt-rollback-path)
70
77
  * [`lps dev`](#lps-dev)
71
78
  * [`lps diff`](#lps-diff)
72
79
  * [`lps doctor`](#lps-doctor)
@@ -91,6 +98,13 @@ report.
91
98
  * [`lps menu pull [PATH]`](#lps-menu-pull-path)
92
99
  * [`lps menu push [PATH]`](#lps-menu-push-path)
93
100
  * [`lps menu rollback [PATH]`](#lps-menu-rollback-path)
101
+ * [`lps meta diff [PATH]`](#lps-meta-diff-path)
102
+ * [`lps meta list`](#lps-meta-list)
103
+ * [`lps meta pull [PATH]`](#lps-meta-pull-path)
104
+ * [`lps meta push [PATH]`](#lps-meta-push-path)
105
+ * [`lps meta remove SLUG`](#lps-meta-remove-slug)
106
+ * [`lps meta rm SLUG`](#lps-meta-rm-slug)
107
+ * [`lps meta rollback [PATH]`](#lps-meta-rollback-path)
94
108
  * [`lps option add NAME`](#lps-option-add-name)
95
109
  * [`lps option diff [PATH]`](#lps-option-diff-path)
96
110
  * [`lps option list`](#lps-option-list)
@@ -101,6 +115,13 @@ report.
101
115
  * [`lps page diff [PATH]`](#lps-page-diff-path)
102
116
  * [`lps page list`](#lps-page-list)
103
117
  * [`lps page push [SLUG]`](#lps-page-push-slug)
118
+ * [`lps pattern diff [PATH]`](#lps-pattern-diff-path)
119
+ * [`lps pattern list`](#lps-pattern-list)
120
+ * [`lps pattern pull [PATH]`](#lps-pattern-pull-path)
121
+ * [`lps pattern push [PATH]`](#lps-pattern-push-path)
122
+ * [`lps pattern remove SLUG`](#lps-pattern-remove-slug)
123
+ * [`lps pattern rm SLUG`](#lps-pattern-rm-slug)
124
+ * [`lps pattern rollback [PATH]`](#lps-pattern-rollback-path)
104
125
  * [`lps plugin add SLUG`](#lps-plugin-add-slug)
105
126
  * [`lps plugin audit`](#lps-plugin-audit)
106
127
  * [`lps plugin pull`](#lps-plugin-pull)
@@ -116,11 +137,13 @@ report.
116
137
  * [`lps promote FROM TO`](#lps-promote-from-to)
117
138
  * [`lps pull`](#lps-pull)
118
139
  * [`lps push`](#lps-push)
119
- * [`lps seo diff [PATH]`](#lps-seo-diff-path)
120
- * [`lps seo list`](#lps-seo-list)
121
- * [`lps seo pull [PATH]`](#lps-seo-pull-path)
122
- * [`lps seo push [PATH]`](#lps-seo-push-path)
123
- * [`lps seo rollback [PATH]`](#lps-seo-rollback-path)
140
+ * [`lps role diff [PATH]`](#lps-role-diff-path)
141
+ * [`lps role list`](#lps-role-list)
142
+ * [`lps role pull [PATH]`](#lps-role-pull-path)
143
+ * [`lps role push [PATH]`](#lps-role-push-path)
144
+ * [`lps role remove SLUG`](#lps-role-remove-slug)
145
+ * [`lps role rm SLUG`](#lps-role-rm-slug)
146
+ * [`lps role rollback [PATH]`](#lps-role-rollback-path)
124
147
  * [`lps snippet diff [PATH]`](#lps-snippet-diff-path)
125
148
  * [`lps snippet list`](#lps-snippet-list)
126
149
  * [`lps snippet publish [PATH]`](#lps-snippet-publish-path)
@@ -128,6 +151,13 @@ report.
128
151
  * [`lps snippet push [PATH]`](#lps-snippet-push-path)
129
152
  * [`lps snippet rollback [PATH]`](#lps-snippet-rollback-path)
130
153
  * [`lps status`](#lps-status)
154
+ * [`lps taxonomy diff [PATH]`](#lps-taxonomy-diff-path)
155
+ * [`lps taxonomy list`](#lps-taxonomy-list)
156
+ * [`lps taxonomy pull [PATH]`](#lps-taxonomy-pull-path)
157
+ * [`lps taxonomy push [PATH]`](#lps-taxonomy-push-path)
158
+ * [`lps taxonomy remove SLUG`](#lps-taxonomy-remove-slug)
159
+ * [`lps taxonomy rm SLUG`](#lps-taxonomy-rm-slug)
160
+ * [`lps taxonomy rollback [PATH]`](#lps-taxonomy-rollback-path)
131
161
  * [`lps telemetry disable`](#lps-telemetry-disable)
132
162
  * [`lps telemetry enable`](#lps-telemetry-enable)
133
163
  * [`lps theme add SLUG`](#lps-theme-add-slug)
@@ -158,7 +188,7 @@ ARGUMENTS
158
188
 
159
189
  FLAGS
160
190
  --against=<value> Compare the primary environment against this second environment instead of against local files
161
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
191
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
162
192
 
163
193
  GLOBAL FLAGS
164
194
  --json Format output as json.
@@ -175,7 +205,7 @@ EXAMPLES
175
205
  $ lps acf diff --env staging --against production
176
206
  ```
177
207
 
178
- _See code: [src/commands/acf/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/diff.ts)_
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)_
179
209
 
180
210
  ## `lps acf list`
181
211
 
@@ -186,7 +216,7 @@ USAGE
186
216
  $ lps acf list [--json] [--env <value>] [--type field-groups|post-types|taxonomies|options-pages...]
187
217
 
188
218
  FLAGS
189
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
219
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
190
220
  --type=<option>... Limit to specific ACF object types
191
221
  <options: field-groups|post-types|taxonomies|options-pages>
192
222
 
@@ -202,7 +232,7 @@ EXAMPLES
202
232
  $ lps acf list --type field-groups
203
233
  ```
204
234
 
205
- _See code: [src/commands/acf/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/list.ts)_
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)_
206
236
 
207
237
  ## `lps acf pull [PATH]`
208
238
 
@@ -219,7 +249,7 @@ ARGUMENTS
219
249
  FLAGS
220
250
  -d, --dry-run Show what would change without making changes
221
251
  -y, --yes Answer yes to confirmation prompts
222
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
252
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
223
253
  --type=<option>... Limit to specific ACF object types
224
254
  <options: field-groups|post-types|taxonomies|options-pages>
225
255
 
@@ -235,7 +265,7 @@ EXAMPLES
235
265
  $ lps acf pull --type field-groups
236
266
  ```
237
267
 
238
- _See code: [src/commands/acf/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/pull.ts)_
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)_
239
269
 
240
270
  ## `lps acf push [PATH]`
241
271
 
@@ -252,7 +282,7 @@ ARGUMENTS
252
282
  FLAGS
253
283
  -d, --dry-run Show what would change without making changes
254
284
  -y, --yes Answer yes to confirmation prompts
255
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
285
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
256
286
  --type=<option>... Limit to specific ACF object types
257
287
  <options: field-groups|post-types|taxonomies|options-pages>
258
288
 
@@ -268,7 +298,7 @@ EXAMPLES
268
298
  $ lps acf push --type field-groups
269
299
  ```
270
300
 
271
- _See code: [src/commands/acf/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/push.ts)_
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)_
272
302
 
273
303
  ## `lps acf rollback [PATH]`
274
304
 
@@ -284,7 +314,7 @@ ARGUMENTS
284
314
  FLAGS
285
315
  -d, --dry-run Show what would change without making changes
286
316
  -y, --yes Answer yes to confirmation prompts
287
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
317
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
288
318
  --list List available snapshots instead of rolling back
289
319
  --to=<value> Roll back to this snapshot id instead of the most recent one
290
320
 
@@ -305,7 +335,7 @@ EXAMPLES
305
335
  $ lps acf rollback --dry-run
306
336
  ```
307
337
 
308
- _See code: [src/commands/acf/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/acf/rollback.ts)_
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)_
309
339
 
310
340
  ## `lps api diff [PATH]`
311
341
 
@@ -320,7 +350,7 @@ ARGUMENTS
320
350
 
321
351
  FLAGS
322
352
  --against=<value> Compare the primary environment against this second environment instead of against local files
323
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
353
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
324
354
 
325
355
  GLOBAL FLAGS
326
356
  --json Format output as json.
@@ -337,7 +367,7 @@ EXAMPLES
337
367
  $ lps api diff --env staging --against production
338
368
  ```
339
369
 
340
- _See code: [src/commands/api/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/diff.ts)_
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)_
341
371
 
342
372
  ## `lps api list`
343
373
 
@@ -348,7 +378,7 @@ USAGE
348
378
  $ lps api list [--json] [--env <value>]
349
379
 
350
380
  FLAGS
351
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
381
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
352
382
 
353
383
  GLOBAL FLAGS
354
384
  --json Format output as json.
@@ -360,7 +390,7 @@ EXAMPLES
360
390
  $ lps api list
361
391
  ```
362
392
 
363
- _See code: [src/commands/api/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/list.ts)_
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)_
364
394
 
365
395
  ## `lps api publish [PATH]`
366
396
 
@@ -383,7 +413,7 @@ EXAMPLES
383
413
  $ lps api publish ./api
384
414
  ```
385
415
 
386
- _See code: [src/commands/api/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/publish.ts)_
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)_
387
417
 
388
418
  ## `lps api pull [PATH]`
389
419
 
@@ -399,7 +429,7 @@ ARGUMENTS
399
429
  FLAGS
400
430
  -d, --dry-run Show what would change without making changes
401
431
  -y, --yes Answer yes to confirmation prompts
402
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
432
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
403
433
 
404
434
  GLOBAL FLAGS
405
435
  --json Format output as json.
@@ -413,7 +443,7 @@ EXAMPLES
413
443
  $ lps api pull --path ./api
414
444
  ```
415
445
 
416
- _See code: [src/commands/api/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/pull.ts)_
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)_
417
447
 
418
448
  ## `lps api push [PATH]`
419
449
 
@@ -429,7 +459,7 @@ ARGUMENTS
429
459
  FLAGS
430
460
  -d, --dry-run Show what would change without making changes
431
461
  -y, --yes Answer yes to confirmation prompts
432
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
462
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
433
463
  --prune Delete server-side route files not present locally after pushing
434
464
 
435
465
  GLOBAL FLAGS
@@ -446,7 +476,7 @@ EXAMPLES
446
476
  $ lps api push --prune
447
477
  ```
448
478
 
449
- _See code: [src/commands/api/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/push.ts)_
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)_
450
480
 
451
481
  ## `lps api remove FILENAME`
452
482
 
@@ -462,7 +492,7 @@ ARGUMENTS
462
492
  FLAGS
463
493
  -d, --dry-run Show what would change without making changes
464
494
  -y, --yes Answer yes to confirmation prompts
465
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
495
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
466
496
 
467
497
  GLOBAL FLAGS
468
498
  --json Format output as json.
@@ -493,7 +523,7 @@ ARGUMENTS
493
523
  FLAGS
494
524
  -d, --dry-run Show what would change without making changes
495
525
  -y, --yes Answer yes to confirmation prompts
496
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
526
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
497
527
 
498
528
  GLOBAL FLAGS
499
529
  --json Format output as json.
@@ -510,7 +540,7 @@ EXAMPLES
510
540
  $ lps api remove hello --yes
511
541
  ```
512
542
 
513
- _See code: [src/commands/api/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/rm.ts)_
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)_
514
544
 
515
545
  ## `lps api rollback [PATH]`
516
546
 
@@ -526,7 +556,7 @@ ARGUMENTS
526
556
  FLAGS
527
557
  -d, --dry-run Show what would change without making changes
528
558
  -y, --yes Answer yes to confirmation prompts
529
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
559
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
530
560
  --list List available snapshots instead of rolling back
531
561
  --to=<value> Roll back to this snapshot id instead of the most recent one
532
562
 
@@ -546,7 +576,7 @@ EXAMPLES
546
576
  $ lps api rollback --dry-run
547
577
  ```
548
578
 
549
- _See code: [src/commands/api/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/api/rollback.ts)_
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)_
550
580
 
551
581
  ## `lps app list`
552
582
 
@@ -557,7 +587,7 @@ USAGE
557
587
  $ lps app list [--json] [--env <value>]
558
588
 
559
589
  FLAGS
560
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
590
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
561
591
 
562
592
  GLOBAL FLAGS
563
593
  --json Format output as json.
@@ -569,7 +599,7 @@ EXAMPLES
569
599
  $ lps app list
570
600
  ```
571
601
 
572
- _See code: [src/commands/app/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/list.ts)_
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)_
573
603
 
574
604
  ## `lps app pull [PATH]`
575
605
 
@@ -585,7 +615,7 @@ ARGUMENTS
585
615
  FLAGS
586
616
  -d, --dry-run Show what would change without making changes
587
617
  -y, --yes Answer yes to confirmation prompts
588
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
618
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
589
619
 
590
620
  GLOBAL FLAGS
591
621
  --json Format output as json.
@@ -597,7 +627,7 @@ EXAMPLES
597
627
  $ lps app pull
598
628
  ```
599
629
 
600
- _See code: [src/commands/app/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/pull.ts)_
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)_
601
631
 
602
632
  ## `lps app push [NAME]`
603
633
 
@@ -614,7 +644,7 @@ FLAGS
614
644
  -d, --dry-run Show what would change without making changes
615
645
  -y, --yes Answer yes to confirmation prompts
616
646
  --[no-]build Run the app's package.json build script before pushing
617
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
647
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
618
648
 
619
649
  GLOBAL FLAGS
620
650
  --json Format output as json.
@@ -632,7 +662,7 @@ EXAMPLES
632
662
  $ lps app push --no-build
633
663
  ```
634
664
 
635
- _See code: [src/commands/app/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/push.ts)_
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)_
636
666
 
637
667
  ## `lps app remove NAME`
638
668
 
@@ -648,7 +678,7 @@ ARGUMENTS
648
678
  FLAGS
649
679
  -d, --dry-run Show what would change without making changes
650
680
  -y, --yes Answer yes to confirmation prompts
651
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
681
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
652
682
 
653
683
  GLOBAL FLAGS
654
684
  --json Format output as json.
@@ -661,7 +691,7 @@ EXAMPLES
661
691
  $ lps app remove search
662
692
  ```
663
693
 
664
- _See code: [src/commands/app/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/app/remove.ts)_
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)_
665
695
 
666
696
  ## `lps composer init`
667
697
 
@@ -673,7 +703,7 @@ USAGE
673
703
 
674
704
  FLAGS
675
705
  -d, --dry-run Show what would change without making changes
676
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
706
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
677
707
 
678
708
  DESCRIPTION
679
709
  Create a composer.json wired to WPackagist for installing WordPress.org plugins and themes
@@ -684,7 +714,7 @@ EXAMPLES
684
714
  $ lps composer init --dry-run
685
715
  ```
686
716
 
687
- _See code: [src/commands/composer/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/init.ts)_
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)_
688
718
 
689
719
  ## `lps composer pull`
690
720
 
@@ -696,7 +726,7 @@ USAGE
696
726
 
697
727
  FLAGS
698
728
  -d, --dry-run Show what would change without making changes
699
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
729
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
700
730
 
701
731
  GLOBAL FLAGS
702
732
  --json Format output as json.
@@ -710,7 +740,7 @@ EXAMPLES
710
740
  $ lps composer pull --dry-run
711
741
  ```
712
742
 
713
- _See code: [src/commands/composer/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/pull.ts)_
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)_
714
744
 
715
745
  ## `lps composer push`
716
746
 
@@ -723,7 +753,7 @@ USAGE
723
753
  FLAGS
724
754
  -d, --dry-run Show what would change without making changes
725
755
  -y, --yes Answer yes to confirmation prompts
726
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
756
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
727
757
  --force Allow downgrades and take over plugins/themes installed outside Loopress
728
758
 
729
759
  GLOBAL FLAGS
@@ -738,7 +768,223 @@ EXAMPLES
738
768
  $ lps composer push --dry-run
739
769
  ```
740
770
 
741
- _See code: [src/commands/composer/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/composer/push.ts)_
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)_
772
+
773
+ ## `lps cpt diff [PATH]`
774
+
775
+ Show what differs in custom post types between your local cpt/ files and a WordPress environment, or between two environments
776
+
777
+ ```
778
+ USAGE
779
+ $ lps cpt diff [PATH] [--json] [--env <value>] [--against <value>]
780
+
781
+ ARGUMENTS
782
+ [PATH] Path to cpt directory (overrides project config)
783
+
784
+ FLAGS
785
+ --against=<value> Compare the primary environment against this second environment instead of against local files
786
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
787
+
788
+ GLOBAL FLAGS
789
+ --json Format output as json.
790
+
791
+ DESCRIPTION
792
+ Show what differs in custom post types between your local cpt/ files and a WordPress environment, or between two
793
+ environments
794
+
795
+ EXAMPLES
796
+ $ lps cpt diff
797
+
798
+ $ lps cpt diff --env staging
799
+
800
+ $ lps cpt diff --env staging --against production
801
+ ```
802
+
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)_
804
+
805
+ ## `lps cpt list`
806
+
807
+ List the post types registered on WordPress and where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or plugin). Only Loopress ones are pulled and pushed.
808
+
809
+ ```
810
+ USAGE
811
+ $ lps cpt list [--json] [--env <value>]
812
+
813
+ FLAGS
814
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
815
+
816
+ GLOBAL FLAGS
817
+ --json Format output as json.
818
+
819
+ DESCRIPTION
820
+ List the post types registered on WordPress and where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or
821
+ plugin). Only Loopress ones are pulled and pushed.
822
+
823
+ EXAMPLES
824
+ $ lps cpt list
825
+ ```
826
+
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)_
828
+
829
+ ## `lps cpt pull [PATH]`
830
+
831
+ Pull the custom post types Loopress manages on WordPress into cpt/<slug>.json files. Post types registered by a theme or another plugin are never pulled, see `lps cpt list`.
832
+
833
+ ```
834
+ USAGE
835
+ $ lps cpt pull [PATH] [--json] [--env <value>] [-d] [-y]
836
+
837
+ ARGUMENTS
838
+ [PATH] Path to the cpt directory (overrides project config)
839
+
840
+ FLAGS
841
+ -d, --dry-run Show what would change without making changes
842
+ -y, --yes Answer yes to confirmation prompts
843
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
844
+
845
+ GLOBAL FLAGS
846
+ --json Format output as json.
847
+
848
+ DESCRIPTION
849
+ Pull the custom post types Loopress manages on WordPress into cpt/<slug>.json files. Post types registered by a theme
850
+ or another plugin are never pulled, see `lps cpt list`.
851
+
852
+ EXAMPLES
853
+ $ lps cpt pull
854
+ ```
855
+
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)_
857
+
858
+ ## `lps cpt push [PATH]`
859
+
860
+ Push local custom post types (cpt/<slug>.json, register_post_type() arguments) to WordPress. Create or update only, never deletes a post type: use `lps cpt rm` for that.
861
+
862
+ ```
863
+ USAGE
864
+ $ lps cpt push [PATH] [--json] [--env <value>] [-d] [-y]
865
+
866
+ ARGUMENTS
867
+ [PATH] Path to the cpt directory (overrides project config)
868
+
869
+ FLAGS
870
+ -d, --dry-run Show what would change without making changes
871
+ -y, --yes Answer yes to confirmation prompts
872
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
873
+
874
+ GLOBAL FLAGS
875
+ --json Format output as json.
876
+
877
+ DESCRIPTION
878
+ Push local custom post types (cpt/<slug>.json, register_post_type() arguments) to WordPress. Create or update only,
879
+ never deletes a post type: use `lps cpt rm` for that.
880
+
881
+ EXAMPLES
882
+ $ lps cpt push
883
+ ```
884
+
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)_
886
+
887
+ ## `lps cpt remove SLUG`
888
+
889
+ Stop registering a Loopress custom post type on WordPress. Its posts are kept in the database, hidden until the post type is pushed again.
890
+
891
+ ```
892
+ USAGE
893
+ $ lps cpt remove SLUG [--json] [--env <value>] [-d] [-y]
894
+
895
+ ARGUMENTS
896
+ SLUG The post type slug, its cpt/ file name without .json
897
+
898
+ FLAGS
899
+ -d, --dry-run Show what would change without making changes
900
+ -y, --yes Answer yes to confirmation prompts
901
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
902
+
903
+ GLOBAL FLAGS
904
+ --json Format output as json.
905
+
906
+ DESCRIPTION
907
+ Stop registering a Loopress custom post type on WordPress. Its posts are kept in the database, hidden until the post
908
+ type is pushed again.
909
+
910
+ ALIASES
911
+ $ lps cpt remove
912
+
913
+ EXAMPLES
914
+ $ lps cpt rm <slug>
915
+
916
+ $ lps cpt remove <slug> --yes
917
+ ```
918
+
919
+ ## `lps cpt rm SLUG`
920
+
921
+ Stop registering a Loopress custom post type on WordPress. Its posts are kept in the database, hidden until the post type is pushed again.
922
+
923
+ ```
924
+ USAGE
925
+ $ lps cpt rm SLUG [--json] [--env <value>] [-d] [-y]
926
+
927
+ ARGUMENTS
928
+ SLUG The post type slug, its cpt/ file name without .json
929
+
930
+ FLAGS
931
+ -d, --dry-run Show what would change without making changes
932
+ -y, --yes Answer yes to confirmation prompts
933
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
934
+
935
+ GLOBAL FLAGS
936
+ --json Format output as json.
937
+
938
+ DESCRIPTION
939
+ Stop registering a Loopress custom post type on WordPress. Its posts are kept in the database, hidden until the post
940
+ type is pushed again.
941
+
942
+ ALIASES
943
+ $ lps cpt remove
944
+
945
+ EXAMPLES
946
+ $ lps cpt rm <slug>
947
+
948
+ $ lps cpt remove <slug> --yes
949
+ ```
950
+
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)_
952
+
953
+ ## `lps cpt rollback [PATH]`
954
+
955
+ Restore custom post types to a snapshot taken automatically before an earlier `lps cpt push`
956
+
957
+ ```
958
+ USAGE
959
+ $ lps cpt rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
960
+
961
+ ARGUMENTS
962
+ [PATH] Path to cpt directory (overrides project config)
963
+
964
+ FLAGS
965
+ -d, --dry-run Show what would change without making changes
966
+ -y, --yes Answer yes to confirmation prompts
967
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
968
+ --list List available snapshots instead of rolling back
969
+ --to=<value> Roll back to this snapshot id instead of the most recent one
970
+
971
+ GLOBAL FLAGS
972
+ --json Format output as json.
973
+
974
+ DESCRIPTION
975
+ Restore custom post types to a snapshot taken automatically before an earlier `lps cpt push`
976
+
977
+ EXAMPLES
978
+ $ lps cpt rollback
979
+
980
+ $ lps cpt rollback --list
981
+
982
+ $ lps cpt rollback --to 1732000000000
983
+
984
+ $ lps cpt rollback --dry-run
985
+ ```
986
+
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)_
742
988
 
743
989
  ## `lps dev`
744
990
 
@@ -749,9 +995,10 @@ USAGE
749
995
  $ lps dev [--only <value>] [--skip <value>]
750
996
 
751
997
  FLAGS
752
- --only=<value> Only watch these resource types (comma-separated): snippets, templates, parts, pages, api, hooks,
753
- plugins
754
- --skip=<value> Skip these resource types (comma-separated): snippets, templates, parts, pages, api, hooks, plugins
998
+ --only=<value> Only watch these resource types (comma-separated): snippets, templates, parts, css, blocks, pages,
999
+ api, hooks, plugins
1000
+ --skip=<value> Skip these resource types (comma-separated): snippets, templates, parts, css, blocks, pages, api,
1001
+ hooks, plugins
755
1002
 
756
1003
  DESCRIPTION
757
1004
  Watch project files and push changes to the local WordPress instance as they happen. Always targets the "local"
@@ -765,34 +1012,37 @@ EXAMPLES
765
1012
  $ lps dev --skip=plugins
766
1013
  ```
767
1014
 
768
- _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/dev.ts)_
1015
+ _See code: [src/commands/dev.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/dev.ts)_
769
1016
 
770
1017
  ## `lps diff`
771
1018
 
772
- 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, SEO, 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.
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.
773
1020
 
774
1021
  ```
775
1022
  USAGE
776
1023
  $ lps diff [--json] [--env <value>] [--against <value>] [--only
777
- snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer...] [--skip
778
- snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer...]
1024
+ snippet|form|acf|api|hook|template|part|page|menu|cpt|taxonomy|meta|role|pattern|option|theme-styles|composer...]
1025
+ [--skip
1026
+ snippet|form|acf|api|hook|template|part|page|menu|cpt|taxonomy|meta|role|pattern|option|theme-styles|composer...]
779
1027
 
780
1028
  FLAGS
781
1029
  --against=<value> Compare the primary environment against this second environment instead of against local files
782
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1030
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
783
1031
  --only=<option>... Only compare these resources
784
- <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer>
1032
+ <options: snippet|form|acf|api|hook|template|part|page|menu|cpt|taxonomy|meta|role|pattern|option|
1033
+ theme-styles|composer>
785
1034
  --skip=<option>... Compare every resource except these
786
- <options: snippet|form|acf|api|hook|template|part|page|seo|menu|option|theme-styles|composer>
1035
+ <options: snippet|form|acf|api|hook|template|part|page|menu|cpt|taxonomy|meta|role|pattern|option|
1036
+ theme-styles|composer>
787
1037
 
788
1038
  GLOBAL FLAGS
789
1039
  --json Format output as json.
790
1040
 
791
1041
  DESCRIPTION
792
1042
  Show what differs between your local tracked files and a WordPress environment, or between two environments. Covers
793
- snippets, forms, ACF, API routes, Hooks, templates, template parts, pages, SEO, Options, Menus, Theme styles, and
794
- Composer. Plugins and themes have their own `lps plugin status` / `lps theme status`. Exit code: 0 in sync, 1 on
795
- drift, 2 when a resource could not be compared, so it doubles as a CI drift gate.
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.
796
1046
 
797
1047
  EXAMPLES
798
1048
  $ lps diff
@@ -806,7 +1056,7 @@ EXAMPLES
806
1056
  $ lps diff --skip composer
807
1057
  ```
808
1058
 
809
- _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/diff.ts)_
1059
+ _See code: [src/commands/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/diff.ts)_
810
1060
 
811
1061
  ## `lps doctor`
812
1062
 
@@ -817,7 +1067,7 @@ USAGE
817
1067
  $ lps doctor [--json] [--env <value>]
818
1068
 
819
1069
  FLAGS
820
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1070
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
821
1071
 
822
1072
  GLOBAL FLAGS
823
1073
  --json Format output as json.
@@ -831,7 +1081,7 @@ EXAMPLES
831
1081
  $ lps doctor --env production
832
1082
  ```
833
1083
 
834
- _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/doctor.ts)_
1084
+ _See code: [src/commands/doctor.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/doctor.ts)_
835
1085
 
836
1086
  ## `lps form diff [PATH]`
837
1087
 
@@ -846,7 +1096,7 @@ ARGUMENTS
846
1096
 
847
1097
  FLAGS
848
1098
  --against=<value> Compare the primary environment against this second environment instead of against local files
849
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1099
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
850
1100
 
851
1101
  GLOBAL FLAGS
852
1102
  --json Format output as json.
@@ -862,7 +1112,7 @@ EXAMPLES
862
1112
  $ lps form diff --env staging --against production
863
1113
  ```
864
1114
 
865
- _See code: [src/commands/form/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/diff.ts)_
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)_
866
1116
 
867
1117
  ## `lps form list`
868
1118
 
@@ -873,7 +1123,7 @@ USAGE
873
1123
  $ lps form list [--json] [--env <value>]
874
1124
 
875
1125
  FLAGS
876
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1126
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
877
1127
 
878
1128
  GLOBAL FLAGS
879
1129
  --json Format output as json.
@@ -885,7 +1135,7 @@ EXAMPLES
885
1135
  $ lps form list
886
1136
  ```
887
1137
 
888
- _See code: [src/commands/form/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/list.ts)_
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)_
889
1139
 
890
1140
  ## `lps form pull [PATH]`
891
1141
 
@@ -901,7 +1151,7 @@ ARGUMENTS
901
1151
  FLAGS
902
1152
  -d, --dry-run Show what would change without making changes
903
1153
  -y, --yes Answer yes to confirmation prompts
904
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1154
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
905
1155
 
906
1156
  GLOBAL FLAGS
907
1157
  --json Format output as json.
@@ -913,7 +1163,7 @@ EXAMPLES
913
1163
  $ lps form pull
914
1164
  ```
915
1165
 
916
- _See code: [src/commands/form/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/pull.ts)_
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)_
917
1167
 
918
1168
  ## `lps form push [PATH]`
919
1169
 
@@ -932,7 +1182,7 @@ FLAGS
932
1182
  --allow-notifications Also push each form's notification and confirmation settings (recipients, sender,
933
1183
  messages). Off by default: the server keeps its own so a stray push can't redirect
934
1184
  submissions.
935
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1185
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
936
1186
 
937
1187
  GLOBAL FLAGS
938
1188
  --json Format output as json.
@@ -947,7 +1197,7 @@ EXAMPLES
947
1197
  $ lps form push --allow-notifications
948
1198
  ```
949
1199
 
950
- _See code: [src/commands/form/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/push.ts)_
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)_
951
1201
 
952
1202
  ## `lps form rollback [PATH]`
953
1203
 
@@ -963,7 +1213,7 @@ ARGUMENTS
963
1213
  FLAGS
964
1214
  -d, --dry-run Show what would change without making changes
965
1215
  -y, --yes Answer yes to confirmation prompts
966
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1216
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
967
1217
  --list List available snapshots instead of rolling back
968
1218
  --to=<value> Roll back to this snapshot id instead of the most recent one
969
1219
 
@@ -983,7 +1233,7 @@ EXAMPLES
983
1233
  $ lps form rollback --dry-run
984
1234
  ```
985
1235
 
986
- _See code: [src/commands/form/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/form/rollback.ts)_
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)_
987
1237
 
988
1238
  ## `lps help [COMMAND]`
989
1239
 
@@ -1003,7 +1253,7 @@ DESCRIPTION
1003
1253
  Display help for lps.
1004
1254
  ```
1005
1255
 
1006
- _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.2/src/commands/help.ts)_
1256
+ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/7.0.4/src/commands/help.ts)_
1007
1257
 
1008
1258
  ## `lps hook diff [PATH]`
1009
1259
 
@@ -1018,7 +1268,7 @@ ARGUMENTS
1018
1268
 
1019
1269
  FLAGS
1020
1270
  --against=<value> Compare the primary environment against this second environment instead of against local files
1021
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1271
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1022
1272
 
1023
1273
  GLOBAL FLAGS
1024
1274
  --json Format output as json.
@@ -1034,7 +1284,7 @@ EXAMPLES
1034
1284
  $ lps hook diff --env staging --against production
1035
1285
  ```
1036
1286
 
1037
- _See code: [src/commands/hook/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/diff.ts)_
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)_
1038
1288
 
1039
1289
  ## `lps hook list`
1040
1290
 
@@ -1045,7 +1295,7 @@ USAGE
1045
1295
  $ lps hook list [--json] [--env <value>]
1046
1296
 
1047
1297
  FLAGS
1048
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1298
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1049
1299
 
1050
1300
  GLOBAL FLAGS
1051
1301
  --json Format output as json.
@@ -1057,7 +1307,7 @@ EXAMPLES
1057
1307
  $ lps hook list
1058
1308
  ```
1059
1309
 
1060
- _See code: [src/commands/hook/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/list.ts)_
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)_
1061
1311
 
1062
1312
  ## `lps hook pull [PATH]`
1063
1313
 
@@ -1073,7 +1323,7 @@ ARGUMENTS
1073
1323
  FLAGS
1074
1324
  -d, --dry-run Show what would change without making changes
1075
1325
  -y, --yes Answer yes to confirmation prompts
1076
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1326
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1077
1327
 
1078
1328
  GLOBAL FLAGS
1079
1329
  --json Format output as json.
@@ -1087,7 +1337,7 @@ EXAMPLES
1087
1337
  $ lps hook pull --path ./hooks
1088
1338
  ```
1089
1339
 
1090
- _See code: [src/commands/hook/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/pull.ts)_
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)_
1091
1341
 
1092
1342
  ## `lps hook push [PATH]`
1093
1343
 
@@ -1103,7 +1353,7 @@ ARGUMENTS
1103
1353
  FLAGS
1104
1354
  -d, --dry-run Show what would change without making changes
1105
1355
  -y, --yes Answer yes to confirmation prompts
1106
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1356
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1107
1357
  --prune Delete server-side hook files not present locally after pushing
1108
1358
 
1109
1359
  GLOBAL FLAGS
@@ -1120,7 +1370,7 @@ EXAMPLES
1120
1370
  $ lps hook push --prune
1121
1371
  ```
1122
1372
 
1123
- _See code: [src/commands/hook/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/push.ts)_
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)_
1124
1374
 
1125
1375
  ## `lps hook remove FILENAME`
1126
1376
 
@@ -1136,7 +1386,7 @@ ARGUMENTS
1136
1386
  FLAGS
1137
1387
  -d, --dry-run Show what would change without making changes
1138
1388
  -y, --yes Answer yes to confirmation prompts
1139
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1389
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1140
1390
 
1141
1391
  GLOBAL FLAGS
1142
1392
  --json Format output as json.
@@ -1167,7 +1417,7 @@ ARGUMENTS
1167
1417
  FLAGS
1168
1418
  -d, --dry-run Show what would change without making changes
1169
1419
  -y, --yes Answer yes to confirmation prompts
1170
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1420
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1171
1421
 
1172
1422
  GLOBAL FLAGS
1173
1423
  --json Format output as json.
@@ -1184,7 +1434,7 @@ EXAMPLES
1184
1434
  $ lps hook remove hello --yes
1185
1435
  ```
1186
1436
 
1187
- _See code: [src/commands/hook/rm.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/rm.ts)_
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)_
1188
1438
 
1189
1439
  ## `lps hook rollback [PATH]`
1190
1440
 
@@ -1200,7 +1450,7 @@ ARGUMENTS
1200
1450
  FLAGS
1201
1451
  -d, --dry-run Show what would change without making changes
1202
1452
  -y, --yes Answer yes to confirmation prompts
1203
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1453
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1204
1454
  --list List available snapshots instead of rolling back
1205
1455
  --to=<value> Roll back to this snapshot id instead of the most recent one
1206
1456
 
@@ -1220,7 +1470,7 @@ EXAMPLES
1220
1470
  $ lps hook rollback --dry-run
1221
1471
  ```
1222
1472
 
1223
- _See code: [src/commands/hook/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/hook/rollback.ts)_
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)_
1224
1474
 
1225
1475
  ## `lps init`
1226
1476
 
@@ -1237,7 +1487,7 @@ EXAMPLES
1237
1487
  $ lps init
1238
1488
  ```
1239
1489
 
1240
- _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/init.ts)_
1490
+ _See code: [src/commands/init.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/init.ts)_
1241
1491
 
1242
1492
  ## `lps login`
1243
1493
 
@@ -1254,7 +1504,7 @@ EXAMPLES
1254
1504
  $ lps login
1255
1505
  ```
1256
1506
 
1257
- _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/login.ts)_
1507
+ _See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/login.ts)_
1258
1508
 
1259
1509
  ## `lps logout`
1260
1510
 
@@ -1271,7 +1521,7 @@ EXAMPLES
1271
1521
  $ lps logout
1272
1522
  ```
1273
1523
 
1274
- _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/logout.ts)_
1524
+ _See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/logout.ts)_
1275
1525
 
1276
1526
  ## `lps menu diff [PATH]`
1277
1527
 
@@ -1286,7 +1536,7 @@ ARGUMENTS
1286
1536
 
1287
1537
  FLAGS
1288
1538
  --against=<value> Compare the primary environment against this second environment instead of against local files
1289
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1539
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1290
1540
 
1291
1541
  GLOBAL FLAGS
1292
1542
  --json Format output as json.
@@ -1303,7 +1553,7 @@ EXAMPLES
1303
1553
  $ lps menu diff --env staging --against production
1304
1554
  ```
1305
1555
 
1306
- _See code: [src/commands/menu/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/diff.ts)_
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)_
1307
1557
 
1308
1558
  ## `lps menu list`
1309
1559
 
@@ -1314,7 +1564,7 @@ USAGE
1314
1564
  $ lps menu list [--json] [--env <value>]
1315
1565
 
1316
1566
  FLAGS
1317
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1567
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1318
1568
 
1319
1569
  GLOBAL FLAGS
1320
1570
  --json Format output as json.
@@ -1326,7 +1576,7 @@ EXAMPLES
1326
1576
  $ lps menu list
1327
1577
  ```
1328
1578
 
1329
- _See code: [src/commands/menu/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/list.ts)_
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)_
1330
1580
 
1331
1581
  ## `lps menu pull [PATH]`
1332
1582
 
@@ -1342,7 +1592,7 @@ ARGUMENTS
1342
1592
  FLAGS
1343
1593
  -d, --dry-run Show what would change without making changes
1344
1594
  -y, --yes Answer yes to confirmation prompts
1345
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1595
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1346
1596
 
1347
1597
  GLOBAL FLAGS
1348
1598
  --json Format output as json.
@@ -1354,7 +1604,7 @@ EXAMPLES
1354
1604
  $ lps menu pull
1355
1605
  ```
1356
1606
 
1357
- _See code: [src/commands/menu/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/pull.ts)_
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)_
1358
1608
 
1359
1609
  ## `lps menu push [PATH]`
1360
1610
 
@@ -1370,7 +1620,7 @@ ARGUMENTS
1370
1620
  FLAGS
1371
1621
  -d, --dry-run Show what would change without making changes
1372
1622
  -y, --yes Answer yes to confirmation prompts
1373
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1623
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1374
1624
 
1375
1625
  GLOBAL FLAGS
1376
1626
  --json Format output as json.
@@ -1384,7 +1634,7 @@ EXAMPLES
1384
1634
  $ lps menu push
1385
1635
  ```
1386
1636
 
1387
- _See code: [src/commands/menu/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/push.ts)_
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)_
1388
1638
 
1389
1639
  ## `lps menu rollback [PATH]`
1390
1640
 
@@ -1400,7 +1650,7 @@ ARGUMENTS
1400
1650
  FLAGS
1401
1651
  -d, --dry-run Show what would change without making changes
1402
1652
  -y, --yes Answer yes to confirmation prompts
1403
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1653
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1404
1654
  --list List available snapshots instead of rolling back
1405
1655
  --to=<value> Roll back to this snapshot id instead of the most recent one
1406
1656
 
@@ -1420,207 +1670,203 @@ EXAMPLES
1420
1670
  $ lps menu rollback --dry-run
1421
1671
  ```
1422
1672
 
1423
- _See code: [src/commands/menu/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/menu/rollback.ts)_
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)_
1424
1674
 
1425
- ## `lps option add NAME`
1675
+ ## `lps meta diff [PATH]`
1426
1676
 
1427
- Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
1677
+ Show what differs in post meta keys between your local meta/ files and a WordPress environment, or between two environments
1428
1678
 
1429
1679
  ```
1430
1680
  USAGE
1431
- $ lps option add NAME [--json] [--env <value>] [-d] [--path <value>]
1681
+ $ lps meta diff [PATH] [--json] [--env <value>] [--against <value>]
1432
1682
 
1433
1683
  ARGUMENTS
1434
- NAME Option name to start tracking (see `lps option list`)
1684
+ [PATH] Path to meta directory (overrides project config)
1435
1685
 
1436
1686
  FLAGS
1437
- -d, --dry-run Show what would change without making changes
1438
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1439
- --path=<value> Path to options directory (overrides project config)
1687
+ --against=<value> Compare the primary environment against this second environment instead of against local files
1688
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1440
1689
 
1441
1690
  GLOBAL FLAGS
1442
1691
  --json Format output as json.
1443
1692
 
1444
1693
  DESCRIPTION
1445
- Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this
1446
- copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
1694
+ Show what differs in post meta keys between your local meta/ files and a WordPress environment, or between two
1695
+ environments
1447
1696
 
1448
1697
  EXAMPLES
1449
- $ lps option add wpseo_titles
1698
+ $ lps meta diff
1450
1699
 
1451
- $ lps option add siteurl
1700
+ $ lps meta diff --env staging
1701
+
1702
+ $ lps meta diff --env staging --against production
1452
1703
  ```
1453
1704
 
1454
- _See code: [src/commands/option/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/add.ts)_
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)_
1455
1706
 
1456
- ## `lps option diff [PATH]`
1707
+ ## `lps meta list`
1457
1708
 
1458
- Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two environments
1709
+ List the meta keys registered for each post type on WordPress (with register_post_meta()), and whether Loopress declares them. Only Loopress ones are pulled and pushed.
1459
1710
 
1460
1711
  ```
1461
1712
  USAGE
1462
- $ lps option diff [PATH] [--json] [--env <value>] [--against <value>]
1463
-
1464
- ARGUMENTS
1465
- [PATH] Path to options directory (overrides project config)
1713
+ $ lps meta list [--json] [--env <value>]
1466
1714
 
1467
1715
  FLAGS
1468
- --against=<value> Compare the primary environment against this second environment instead of against local files
1469
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1716
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1470
1717
 
1471
1718
  GLOBAL FLAGS
1472
1719
  --json Format output as json.
1473
1720
 
1474
1721
  DESCRIPTION
1475
- Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two
1476
- environments
1722
+ List the meta keys registered for each post type on WordPress (with register_post_meta()), and whether Loopress
1723
+ declares them. Only Loopress ones are pulled and pushed.
1477
1724
 
1478
1725
  EXAMPLES
1479
- $ lps option diff
1480
-
1481
- $ lps option diff --env staging
1482
-
1483
- $ lps option diff --env staging --against production
1726
+ $ lps meta list
1484
1727
  ```
1485
1728
 
1486
- _See code: [src/commands/option/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/diff.ts)_
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)_
1487
1730
 
1488
- ## `lps option list`
1731
+ ## `lps meta pull [PATH]`
1489
1732
 
1490
- List WordPress option names currently on the site (names and autoload only, never values). CORE flags a WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option you want, then `lps option add <name>` to track it.
1733
+ Pull the post meta keys Loopress manages on WordPress into meta/<post-type>.json files, never their values. Keys registered by a theme or another plugin are never pulled, see `lps meta list`.
1491
1734
 
1492
1735
  ```
1493
1736
  USAGE
1494
- $ lps option list [--json] [--env <value>] [--no-core]
1737
+ $ lps meta pull [PATH] [--json] [--env <value>] [-d] [-y]
1738
+
1739
+ ARGUMENTS
1740
+ [PATH] Path to the meta directory (overrides project config)
1495
1741
 
1496
1742
  FLAGS
1497
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1498
- --no-core Exclude WordPress-native default options and the CORE column from the output, including --json
1743
+ -d, --dry-run Show what would change without making changes
1744
+ -y, --yes Answer yes to confirmation prompts
1745
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1499
1746
 
1500
1747
  GLOBAL FLAGS
1501
1748
  --json Format output as json.
1502
1749
 
1503
1750
  DESCRIPTION
1504
- List WordPress option names currently on the site (names and autoload only, never values). CORE flags a
1505
- WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active
1506
- plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is
1507
- that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option
1508
- you want, then `lps option add <name>` to track it.
1751
+ Pull the post meta keys Loopress manages on WordPress into meta/<post-type>.json files, never their values. Keys
1752
+ registered by a theme or another plugin are never pulled, see `lps meta list`.
1509
1753
 
1510
1754
  EXAMPLES
1511
- $ lps option list
1512
-
1513
- $ lps option list --no-core
1755
+ $ lps meta pull
1514
1756
  ```
1515
1757
 
1516
- _See code: [src/commands/option/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/list.ts)_
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)_
1517
1759
 
1518
- ## `lps option pull [PATH]`
1760
+ ## `lps meta push [PATH]`
1519
1761
 
1520
- Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>` for those first.
1762
+ Push local post meta keys (meta/<post-type>.json, each key mapped to its register_post_meta() arguments) to WordPress. Create or update only, never deletes (use `lps meta rm`), never touches meta values.
1521
1763
 
1522
1764
  ```
1523
1765
  USAGE
1524
- $ lps option pull [PATH] [--json] [--env <value>] [-d] [-y]
1766
+ $ lps meta push [PATH] [--json] [--env <value>] [-d] [-y]
1525
1767
 
1526
1768
  ARGUMENTS
1527
- [PATH] Path to options directory (overrides project config)
1769
+ [PATH] Path to the meta directory (overrides project config)
1528
1770
 
1529
1771
  FLAGS
1530
1772
  -d, --dry-run Show what would change without making changes
1531
1773
  -y, --yes Answer yes to confirmation prompts
1532
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1774
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1533
1775
 
1534
1776
  GLOBAL FLAGS
1535
1777
  --json Format output as json.
1536
1778
 
1537
1779
  DESCRIPTION
1538
- Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>`
1539
- for those first.
1780
+ Push local post meta keys (meta/<post-type>.json, each key mapped to its register_post_meta() arguments) to WordPress.
1781
+ Create or update only, never deletes (use `lps meta rm`), never touches meta values.
1540
1782
 
1541
1783
  EXAMPLES
1542
- $ lps option pull
1784
+ $ lps meta push
1543
1785
  ```
1544
1786
 
1545
- _See code: [src/commands/option/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/pull.ts)_
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)_
1546
1788
 
1547
- ## `lps option push [PATH]`
1789
+ ## `lps meta remove SLUG`
1548
1790
 
1549
- Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options marked "readonly": true in their local file are skipped, edit the file to override.
1791
+ Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values are kept in the database.
1550
1792
 
1551
1793
  ```
1552
1794
  USAGE
1553
- $ lps option push [PATH] [--json] [--env <value>] [-d] [-y]
1795
+ $ lps meta remove SLUG [--json] [--env <value>] [-d] [-y]
1554
1796
 
1555
1797
  ARGUMENTS
1556
- [PATH] Path to options directory (overrides project config)
1798
+ SLUG The post meta slug, its meta/ file name without .json
1557
1799
 
1558
1800
  FLAGS
1559
1801
  -d, --dry-run Show what would change without making changes
1560
1802
  -y, --yes Answer yes to confirmation prompts
1561
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1803
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1562
1804
 
1563
1805
  GLOBAL FLAGS
1564
1806
  --json Format output as json.
1565
1807
 
1566
1808
  DESCRIPTION
1567
- Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options
1568
- marked "readonly": true in their local file are skipped, edit the file to override.
1809
+ Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values
1810
+ are kept in the database.
1811
+
1812
+ ALIASES
1813
+ $ lps meta remove
1569
1814
 
1570
1815
  EXAMPLES
1571
- $ lps option push
1572
- ```
1816
+ $ lps meta rm <slug>
1573
1817
 
1574
- _See code: [src/commands/option/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/push.ts)_
1818
+ $ lps meta remove <slug> --yes
1819
+ ```
1575
1820
 
1576
- ## `lps option remove NAME`
1821
+ ## `lps meta rm SLUG`
1577
1822
 
1578
- Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass --local-only to skip the WordPress delete and only stop tracking.
1823
+ Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values are kept in the database.
1579
1824
 
1580
1825
  ```
1581
1826
  USAGE
1582
- $ lps option remove NAME [--json] [--env <value>] [-d] [-y] [--local-only] [--path <value>]
1827
+ $ lps meta rm SLUG [--json] [--env <value>] [-d] [-y]
1583
1828
 
1584
1829
  ARGUMENTS
1585
- NAME Option name to stop tracking
1830
+ SLUG The post meta slug, its meta/ file name without .json
1586
1831
 
1587
1832
  FLAGS
1588
- -d, --dry-run Show what would change without making changes
1589
- -y, --yes Answer yes to confirmation prompts
1590
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1591
- --local-only Untrack locally without deleting the option on WordPress
1592
- --path=<value> Path to options directory (overrides project config)
1833
+ -d, --dry-run Show what would change without making changes
1834
+ -y, --yes Answer yes to confirmation prompts
1835
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1593
1836
 
1594
1837
  GLOBAL FLAGS
1595
1838
  --json Format output as json.
1596
1839
 
1597
1840
  DESCRIPTION
1598
- Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass
1599
- --local-only to skip the WordPress delete and only stop tracking.
1841
+ Stop registering the Loopress meta keys of one post type (its meta/<post-type>.json file) on WordPress. Their values
1842
+ are kept in the database.
1843
+
1844
+ ALIASES
1845
+ $ lps meta remove
1600
1846
 
1601
1847
  EXAMPLES
1602
- $ lps option remove wpseo_titles
1848
+ $ lps meta rm <slug>
1603
1849
 
1604
- $ lps option remove wpseo_titles --local-only
1850
+ $ lps meta remove <slug> --yes
1605
1851
  ```
1606
1852
 
1607
- _See code: [src/commands/option/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/remove.ts)_
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)_
1608
1854
 
1609
- ## `lps option rollback [PATH]`
1855
+ ## `lps meta rollback [PATH]`
1610
1856
 
1611
- Restore tracked options to a snapshot taken automatically before an earlier `lps option push`
1857
+ Restore post meta keys to a snapshot taken automatically before an earlier `lps meta push`
1612
1858
 
1613
1859
  ```
1614
1860
  USAGE
1615
- $ lps option rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
1861
+ $ lps meta rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
1616
1862
 
1617
1863
  ARGUMENTS
1618
- [PATH] Path to options directory (overrides project config)
1864
+ [PATH] Path to meta directory (overrides project config)
1619
1865
 
1620
1866
  FLAGS
1621
1867
  -d, --dry-run Show what would change without making changes
1622
1868
  -y, --yes Answer yes to confirmation prompts
1623
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1869
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1624
1870
  --list List available snapshots instead of rolling back
1625
1871
  --to=<value> Roll back to this snapshot id instead of the most recent one
1626
1872
 
@@ -1628,106 +1874,542 @@ GLOBAL FLAGS
1628
1874
  --json Format output as json.
1629
1875
 
1630
1876
  DESCRIPTION
1631
- Restore tracked options to a snapshot taken automatically before an earlier `lps option push`
1877
+ Restore post meta keys to a snapshot taken automatically before an earlier `lps meta push`
1632
1878
 
1633
1879
  EXAMPLES
1634
- $ lps option rollback
1880
+ $ lps meta rollback
1635
1881
 
1636
- $ lps option rollback --list
1882
+ $ lps meta rollback --list
1637
1883
 
1638
- $ lps option rollback --to 1732000000000
1884
+ $ lps meta rollback --to 1732000000000
1639
1885
 
1640
- $ lps option rollback --dry-run
1886
+ $ lps meta rollback --dry-run
1641
1887
  ```
1642
1888
 
1643
- _See code: [src/commands/option/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/option/rollback.ts)_
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)_
1644
1890
 
1645
- ## `lps page diff [PATH]`
1891
+ ## `lps option add NAME`
1646
1892
 
1647
- Show what differs in static pages between your local files and a WordPress environment, or between two environments
1893
+ Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
1648
1894
 
1649
1895
  ```
1650
1896
  USAGE
1651
- $ lps page diff [PATH] [--json] [--env <value>] [--against <value>]
1897
+ $ lps option add NAME [--json] [--env <value>] [-d] [--path <value>]
1652
1898
 
1653
1899
  ARGUMENTS
1654
- [PATH] Path to pages directory (overrides project config)
1900
+ NAME Option name to start tracking (see `lps option list`)
1655
1901
 
1656
1902
  FLAGS
1657
- --against=<value> Compare the primary environment against this second environment instead of against local files
1658
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
1903
+ -d, --dry-run Show what would change without making changes
1904
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1905
+ --path=<value> Path to options directory (overrides project config)
1659
1906
 
1660
1907
  GLOBAL FLAGS
1661
1908
  --json Format output as json.
1662
1909
 
1663
1910
  DESCRIPTION
1664
- Show what differs in static pages between your local files and a WordPress environment, or between two environments
1911
+ Fetch a WordPress option by name and start tracking it locally. Run `lps option list` first to find the name: this
1912
+ copies a raw value across environments, verify it does not embed post/user IDs before pushing it elsewhere.
1665
1913
 
1666
1914
  EXAMPLES
1667
- $ lps page diff
1668
-
1669
- $ lps page diff --env staging
1915
+ $ lps option add wpseo_titles
1670
1916
 
1671
- $ lps page diff --env staging --against production
1917
+ $ lps option add siteurl
1672
1918
  ```
1673
1919
 
1674
- _See code: [src/commands/page/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/diff.ts)_
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)_
1675
1921
 
1676
- ## `lps page list`
1922
+ ## `lps option diff [PATH]`
1923
+
1924
+ Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two environments
1925
+
1926
+ ```
1927
+ USAGE
1928
+ $ lps option diff [PATH] [--json] [--env <value>] [--against <value>]
1929
+
1930
+ ARGUMENTS
1931
+ [PATH] Path to options directory (overrides project config)
1932
+
1933
+ FLAGS
1934
+ --against=<value> Compare the primary environment against this second environment instead of against local files
1935
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1936
+
1937
+ GLOBAL FLAGS
1938
+ --json Format output as json.
1939
+
1940
+ DESCRIPTION
1941
+ Show what differs, for locally tracked options, between your local files and a WordPress environment, or between two
1942
+ environments
1943
+
1944
+ EXAMPLES
1945
+ $ lps option diff
1946
+
1947
+ $ lps option diff --env staging
1948
+
1949
+ $ lps option diff --env staging --against production
1950
+ ```
1951
+
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)_
1953
+
1954
+ ## `lps option list`
1955
+
1956
+ List WordPress option names currently on the site (names and autoload only, never values). CORE flags a WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option you want, then `lps option add <name>` to track it.
1957
+
1958
+ ```
1959
+ USAGE
1960
+ $ lps option list [--json] [--env <value>] [--no-core]
1961
+
1962
+ FLAGS
1963
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1964
+ --no-core Exclude WordPress-native default options and the CORE column from the output, including --json
1965
+
1966
+ GLOBAL FLAGS
1967
+ --json Format output as json.
1968
+
1969
+ DESCRIPTION
1970
+ List WordPress option names currently on the site (names and autoload only, never values). CORE flags a
1971
+ WordPress-native default (certain); SOURCE? is a best-effort guessed plugin slug, found by name or by scanning active
1972
+ plugins' own PHP source (uncertain unless confirmed, occasionally wrong or blank, never trust it over CORE); PLUGIN is
1973
+ that slug's own declared display name, a label only, no confidence of its own. Use this to find the name of the option
1974
+ you want, then `lps option add <name>` to track it.
1975
+
1976
+ EXAMPLES
1977
+ $ lps option list
1978
+
1979
+ $ lps option list --no-core
1980
+ ```
1981
+
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)_
1983
+
1984
+ ## `lps option pull [PATH]`
1985
+
1986
+ Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>` for those first.
1987
+
1988
+ ```
1989
+ USAGE
1990
+ $ lps option pull [PATH] [--json] [--env <value>] [-d] [-y]
1991
+
1992
+ ARGUMENTS
1993
+ [PATH] Path to options directory (overrides project config)
1994
+
1995
+ FLAGS
1996
+ -d, --dry-run Show what would change without making changes
1997
+ -y, --yes Answer yes to confirmation prompts
1998
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1999
+
2000
+ GLOBAL FLAGS
2001
+ --json Format output as json.
2002
+
2003
+ DESCRIPTION
2004
+ Refresh locally tracked options from WordPress. Options not yet tracked are never pulled, run `lps option add <name>`
2005
+ for those first.
2006
+
2007
+ EXAMPLES
2008
+ $ lps option pull
2009
+ ```
2010
+
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)_
2012
+
2013
+ ## `lps option push [PATH]`
2014
+
2015
+ Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options marked "readonly": true in their local file are skipped, edit the file to override.
2016
+
2017
+ ```
2018
+ USAGE
2019
+ $ lps option push [PATH] [--json] [--env <value>] [-d] [-y]
2020
+
2021
+ ARGUMENTS
2022
+ [PATH] Path to options directory (overrides project config)
2023
+
2024
+ FLAGS
2025
+ -d, --dry-run Show what would change without making changes
2026
+ -y, --yes Answer yes to confirmation prompts
2027
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2028
+
2029
+ GLOBAL FLAGS
2030
+ --json Format output as json.
2031
+
2032
+ DESCRIPTION
2033
+ Push locally tracked, non-readonly options to WordPress (upsert only, never deletes an untracked option). Options
2034
+ marked "readonly": true in their local file are skipped, edit the file to override.
2035
+
2036
+ EXAMPLES
2037
+ $ lps option push
2038
+ ```
2039
+
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)_
2041
+
2042
+ ## `lps option remove NAME`
2043
+
2044
+ Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass --local-only to skip the WordPress delete and only stop tracking.
2045
+
2046
+ ```
2047
+ USAGE
2048
+ $ lps option remove NAME [--json] [--env <value>] [-d] [-y] [--local-only] [--path <value>]
2049
+
2050
+ ARGUMENTS
2051
+ NAME Option name to stop tracking
2052
+
2053
+ FLAGS
2054
+ -d, --dry-run Show what would change without making changes
2055
+ -y, --yes Answer yes to confirmation prompts
2056
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2057
+ --local-only Untrack locally without deleting the option on WordPress
2058
+ --path=<value> Path to options directory (overrides project config)
2059
+
2060
+ GLOBAL FLAGS
2061
+ --json Format output as json.
2062
+
2063
+ DESCRIPTION
2064
+ Stop tracking an option locally and delete it from WordPress. Local untracking always happens (git-reversible); pass
2065
+ --local-only to skip the WordPress delete and only stop tracking.
2066
+
2067
+ EXAMPLES
2068
+ $ lps option remove wpseo_titles
2069
+
2070
+ $ lps option remove wpseo_titles --local-only
2071
+ ```
2072
+
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)_
2074
+
2075
+ ## `lps option rollback [PATH]`
2076
+
2077
+ Restore tracked options to a snapshot taken automatically before an earlier `lps option push`
2078
+
2079
+ ```
2080
+ USAGE
2081
+ $ lps option rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2082
+
2083
+ ARGUMENTS
2084
+ [PATH] Path to options directory (overrides project config)
2085
+
2086
+ FLAGS
2087
+ -d, --dry-run Show what would change without making changes
2088
+ -y, --yes Answer yes to confirmation prompts
2089
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2090
+ --list List available snapshots instead of rolling back
2091
+ --to=<value> Roll back to this snapshot id instead of the most recent one
2092
+
2093
+ GLOBAL FLAGS
2094
+ --json Format output as json.
2095
+
2096
+ DESCRIPTION
2097
+ Restore tracked options to a snapshot taken automatically before an earlier `lps option push`
2098
+
2099
+ EXAMPLES
2100
+ $ lps option rollback
2101
+
2102
+ $ lps option rollback --list
2103
+
2104
+ $ lps option rollback --to 1732000000000
2105
+
2106
+ $ lps option rollback --dry-run
2107
+ ```
2108
+
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)_
2110
+
2111
+ ## `lps page diff [PATH]`
2112
+
2113
+ Show what differs in static pages between your local files and a WordPress environment, or between two environments
2114
+
2115
+ ```
2116
+ USAGE
2117
+ $ lps page diff [PATH] [--json] [--env <value>] [--against <value>]
2118
+
2119
+ ARGUMENTS
2120
+ [PATH] Path to pages directory (overrides project config)
2121
+
2122
+ FLAGS
2123
+ --against=<value> Compare the primary environment against this second environment instead of against local files
2124
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2125
+
2126
+ GLOBAL FLAGS
2127
+ --json Format output as json.
2128
+
2129
+ DESCRIPTION
2130
+ Show what differs in static pages between your local files and a WordPress environment, or between two environments
2131
+
2132
+ EXAMPLES
2133
+ $ lps page diff
2134
+
2135
+ $ lps page diff --env staging
2136
+
2137
+ $ lps page diff --env staging --against production
2138
+ ```
2139
+
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)_
2141
+
2142
+ ## `lps page list`
1677
2143
 
1678
2144
  List the static pages managed by Loopress on WordPress
1679
2145
 
1680
2146
  ```
1681
2147
  USAGE
1682
- $ lps page list [--json] [--env <value>]
2148
+ $ lps page list [--json] [--env <value>]
2149
+
2150
+ FLAGS
2151
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2152
+
2153
+ GLOBAL FLAGS
2154
+ --json Format output as json.
2155
+
2156
+ DESCRIPTION
2157
+ List the static pages managed by Loopress on WordPress
2158
+
2159
+ EXAMPLES
2160
+ $ lps page list
2161
+ ```
2162
+
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)_
2164
+
2165
+ ## `lps page push [SLUG]`
2166
+
2167
+ Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is applied on every push.
2168
+
2169
+ ```
2170
+ USAGE
2171
+ $ lps page push [SLUG] [--json] [--env <value>] [-d] [-y]
2172
+
2173
+ ARGUMENTS
2174
+ [SLUG] Push only this page (its file name without .html). Pushes every page when omitted.
2175
+
2176
+ FLAGS
2177
+ -d, --dry-run Show what would change without making changes
2178
+ -y, --yes Answer yes to confirmation prompts
2179
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2180
+
2181
+ GLOBAL FLAGS
2182
+ --json Format output as json.
2183
+
2184
+ 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.
2187
+
2188
+ EXAMPLES
2189
+ $ lps page push
2190
+
2191
+ $ lps page push legal-notice
2192
+
2193
+ $ lps page push --dry-run
2194
+ ```
2195
+
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)_
2197
+
2198
+ ## `lps pattern diff [PATH]`
2199
+
2200
+ Show what differs in block patterns between your local patterns/ files and a WordPress environment, or between two environments
2201
+
2202
+ ```
2203
+ USAGE
2204
+ $ lps pattern diff [PATH] [--json] [--env <value>] [--against <value>]
2205
+
2206
+ ARGUMENTS
2207
+ [PATH] Path to patterns directory (overrides project config)
2208
+
2209
+ FLAGS
2210
+ --against=<value> Compare the primary environment against this second environment instead of against local files
2211
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2212
+
2213
+ GLOBAL FLAGS
2214
+ --json Format output as json.
2215
+
2216
+ DESCRIPTION
2217
+ Show what differs in block patterns between your local patterns/ files and a WordPress environment, or between two
2218
+ environments
2219
+
2220
+ EXAMPLES
2221
+ $ lps pattern diff
2222
+
2223
+ $ lps pattern diff --env staging
2224
+
2225
+ $ lps pattern diff --env staging --against production
2226
+ ```
2227
+
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)_
2229
+
2230
+ ## `lps pattern list`
2231
+
2232
+ List the block patterns registered on WordPress by Loopress, the theme and plugins (not WordPress core). Only Loopress ones are pulled and pushed.
2233
+
2234
+ ```
2235
+ USAGE
2236
+ $ lps pattern list [--json] [--env <value>]
2237
+
2238
+ FLAGS
2239
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2240
+
2241
+ GLOBAL FLAGS
2242
+ --json Format output as json.
2243
+
2244
+ DESCRIPTION
2245
+ List the block patterns registered on WordPress by Loopress, the theme and plugins (not WordPress core). Only Loopress
2246
+ ones are pulled and pushed.
2247
+
2248
+ EXAMPLES
2249
+ $ lps pattern list
2250
+ ```
2251
+
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)_
2253
+
2254
+ ## `lps pattern pull [PATH]`
2255
+
2256
+ Pull the block patterns Loopress manages on WordPress into patterns/<slug>.html files. Patterns registered by the theme or a plugin are never pulled, see `lps pattern list`.
2257
+
2258
+ ```
2259
+ USAGE
2260
+ $ lps pattern pull [PATH] [--json] [--env <value>] [-d] [-y]
2261
+
2262
+ ARGUMENTS
2263
+ [PATH] Path to the patterns directory (overrides project config)
2264
+
2265
+ FLAGS
2266
+ -d, --dry-run Show what would change without making changes
2267
+ -y, --yes Answer yes to confirmation prompts
2268
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2269
+
2270
+ GLOBAL FLAGS
2271
+ --json Format output as json.
2272
+
2273
+ DESCRIPTION
2274
+ Pull the block patterns Loopress manages on WordPress into patterns/<slug>.html files. Patterns registered by the
2275
+ theme or a plugin are never pulled, see `lps pattern list`.
2276
+
2277
+ EXAMPLES
2278
+ $ lps pattern pull
2279
+ ```
2280
+
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)_
2282
+
2283
+ ## `lps pattern push [PATH]`
2284
+
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`).
2286
+
2287
+ ```
2288
+ USAGE
2289
+ $ lps pattern push [PATH] [--json] [--env <value>] [-d] [-y]
2290
+
2291
+ ARGUMENTS
2292
+ [PATH] Path to the patterns directory (overrides project config)
2293
+
2294
+ FLAGS
2295
+ -d, --dry-run Show what would change without making changes
2296
+ -y, --yes Answer yes to confirmation prompts
2297
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2298
+
2299
+ GLOBAL FLAGS
2300
+ --json Format output as json.
2301
+
2302
+ DESCRIPTION
2303
+ 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`).
2305
+
2306
+ EXAMPLES
2307
+ $ lps pattern push
2308
+ ```
2309
+
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)_
2311
+
2312
+ ## `lps pattern remove SLUG`
2313
+
2314
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already inserted in posts stay.
2315
+
2316
+ ```
2317
+ USAGE
2318
+ $ lps pattern remove SLUG [--json] [--env <value>] [-d] [-y]
2319
+
2320
+ ARGUMENTS
2321
+ SLUG The pattern slug, its patterns/ file name without .html
1683
2322
 
1684
2323
  FLAGS
1685
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2324
+ -d, --dry-run Show what would change without making changes
2325
+ -y, --yes Answer yes to confirmation prompts
2326
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1686
2327
 
1687
2328
  GLOBAL FLAGS
1688
2329
  --json Format output as json.
1689
2330
 
1690
2331
  DESCRIPTION
1691
- List the static pages managed by Loopress on WordPress
2332
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already
2333
+ inserted in posts stay.
2334
+
2335
+ ALIASES
2336
+ $ lps pattern remove
1692
2337
 
1693
2338
  EXAMPLES
1694
- $ lps page list
2339
+ $ lps pattern rm <slug>
2340
+
2341
+ $ lps pattern remove <slug> --yes
1695
2342
  ```
1696
2343
 
1697
- _See code: [src/commands/page/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/list.ts)_
2344
+ ## `lps pattern rm SLUG`
1698
2345
 
1699
- ## `lps page push [SLUG]`
2346
+ Stop registering a Loopress block pattern on WordPress. A wp:pattern reference to it renders nothing, copies already inserted in posts stay.
1700
2347
 
1701
- Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is applied on every push.
2348
+ ```
2349
+ USAGE
2350
+ $ lps pattern rm SLUG [--json] [--env <value>] [-d] [-y]
2351
+
2352
+ ARGUMENTS
2353
+ SLUG The pattern slug, its patterns/ file name without .html
2354
+
2355
+ FLAGS
2356
+ -d, --dry-run Show what would change without making changes
2357
+ -y, --yes Answer yes to confirmation prompts
2358
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2359
+
2360
+ GLOBAL FLAGS
2361
+ --json Format output as json.
2362
+
2363
+ 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.
2366
+
2367
+ ALIASES
2368
+ $ lps pattern remove
2369
+
2370
+ EXAMPLES
2371
+ $ lps pattern rm <slug>
2372
+
2373
+ $ lps pattern remove <slug> --yes
2374
+ ```
2375
+
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)_
2377
+
2378
+ ## `lps pattern rollback [PATH]`
2379
+
2380
+ Restore block patterns to a snapshot taken automatically before an earlier `lps pattern push`
1702
2381
 
1703
2382
  ```
1704
2383
  USAGE
1705
- $ lps page push [SLUG] [--json] [--env <value>] [-d] [-y]
2384
+ $ lps pattern rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
1706
2385
 
1707
2386
  ARGUMENTS
1708
- [SLUG] Push only this page (its file name without .html). Pushes every page when omitted.
2387
+ [PATH] Path to patterns directory (overrides project config)
1709
2388
 
1710
2389
  FLAGS
1711
2390
  -d, --dry-run Show what would change without making changes
1712
2391
  -y, --yes Answer yes to confirmation prompts
1713
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2392
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2393
+ --list List available snapshots instead of rolling back
2394
+ --to=<value> Roll back to this snapshot id instead of the most recent one
1714
2395
 
1715
2396
  GLOBAL FLAGS
1716
2397
  --json Format output as json.
1717
2398
 
1718
2399
  DESCRIPTION
1719
- Push static HTML pages (pages/<slug>.html) to WordPress. The `status` header (draft or publish, draft by default) is
1720
- applied on every push.
2400
+ Restore block patterns to a snapshot taken automatically before an earlier `lps pattern push`
1721
2401
 
1722
2402
  EXAMPLES
1723
- $ lps page push
2403
+ $ lps pattern rollback
1724
2404
 
1725
- $ lps page push legal-notice
2405
+ $ lps pattern rollback --list
1726
2406
 
1727
- $ lps page push --dry-run
2407
+ $ lps pattern rollback --to 1732000000000
2408
+
2409
+ $ lps pattern rollback --dry-run
1728
2410
  ```
1729
2411
 
1730
- _See code: [src/commands/page/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/page/push.ts)_
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)_
1731
2413
 
1732
2414
  ## `lps plugin add SLUG`
1733
2415
 
@@ -1742,7 +2424,7 @@ ARGUMENTS
1742
2424
 
1743
2425
  FLAGS
1744
2426
  -d, --dry-run Show what would change without making changes
1745
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2427
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1746
2428
  --version=<value> Exact version to pin (default: "latest", tracked on every push)
1747
2429
 
1748
2430
  GLOBAL FLAGS
@@ -1759,7 +2441,7 @@ EXAMPLES
1759
2441
  $ lps plugin add contact-form-7 --dry-run
1760
2442
  ```
1761
2443
 
1762
- _See code: [src/commands/plugin/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/add.ts)_
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)_
1763
2445
 
1764
2446
  ## `lps plugin audit`
1765
2447
 
@@ -1770,7 +2452,7 @@ USAGE
1770
2452
  $ lps plugin audit [--json] [--env <value>]
1771
2453
 
1772
2454
  FLAGS
1773
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2455
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1774
2456
 
1775
2457
  GLOBAL FLAGS
1776
2458
  --json Format output as json.
@@ -1782,7 +2464,7 @@ EXAMPLES
1782
2464
  $ lps plugin audit
1783
2465
  ```
1784
2466
 
1785
- _See code: [src/commands/plugin/audit.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/audit.ts)_
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)_
1786
2468
 
1787
2469
  ## `lps plugin pull`
1788
2470
 
@@ -1795,7 +2477,7 @@ USAGE
1795
2477
  FLAGS
1796
2478
  -d, --dry-run Show what would change without making changes
1797
2479
  -y, --yes Answer yes to confirmation prompts
1798
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2480
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1799
2481
  --plugin=<value>... Start tracking this installed plugin too, without asking (repeatable)
1800
2482
 
1801
2483
  GLOBAL FLAGS
@@ -1812,7 +2494,7 @@ EXAMPLES
1812
2494
  $ lps plugin pull --env production --plugin query-monitor
1813
2495
  ```
1814
2496
 
1815
- _See code: [src/commands/plugin/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/pull.ts)_
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)_
1816
2498
 
1817
2499
  ## `lps plugin push`
1818
2500
 
@@ -1827,7 +2509,7 @@ FLAGS
1827
2509
  -y, --yes Answer yes to confirmation prompts
1828
2510
  --activate composer.json projects only: activate every plugin it declares. Without it, plugins keep their
1829
2511
  current state and new ones stay inactive
1830
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2512
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1831
2513
  --force Allow downgrades and let Loopress take over plugins installed outside it (replaces their files)
1832
2514
  --prune Deactivate plugins that are active on the site but absent from loopress.json (or composer.json)
1833
2515
 
@@ -1845,7 +2527,7 @@ EXAMPLES
1845
2527
  $ lps plugin push --force --prune
1846
2528
  ```
1847
2529
 
1848
- _See code: [src/commands/plugin/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/push.ts)_
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)_
1849
2531
 
1850
2532
  ## `lps plugin status`
1851
2533
 
@@ -1856,7 +2538,7 @@ USAGE
1856
2538
  $ lps plugin status [--json] [--env <value>]
1857
2539
 
1858
2540
  FLAGS
1859
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2541
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1860
2542
 
1861
2543
  GLOBAL FLAGS
1862
2544
  --json Format output as json.
@@ -1868,7 +2550,7 @@ EXAMPLES
1868
2550
  $ lps plugin status
1869
2551
  ```
1870
2552
 
1871
- _See code: [src/commands/plugin/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/plugin/status.ts)_
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)_
1872
2554
 
1873
2555
  ## `lps project config`
1874
2556
 
@@ -1886,7 +2568,7 @@ EXAMPLES
1886
2568
  $ lps project config
1887
2569
  ```
1888
2570
 
1889
- _See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/config.ts)_
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)_
1890
2572
 
1891
2573
  ## `lps project list`
1892
2574
 
@@ -1906,7 +2588,7 @@ EXAMPLES
1906
2588
  $ lps project list
1907
2589
  ```
1908
2590
 
1909
- _See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/list.ts)_
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)_
1910
2592
 
1911
2593
  ## `lps project pull`
1912
2594
 
@@ -1923,7 +2605,7 @@ EXAMPLES
1923
2605
  $ lps project pull
1924
2606
  ```
1925
2607
 
1926
- _See code: [src/commands/project/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/pull.ts)_
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)_
1927
2609
 
1928
2610
  ## `lps project push`
1929
2611
 
@@ -1943,7 +2625,7 @@ EXAMPLES
1943
2625
  $ lps project push
1944
2626
  ```
1945
2627
 
1946
- _See code: [src/commands/project/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/push.ts)_
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)_
1947
2629
 
1948
2630
  ## `lps project remove`
1949
2631
 
@@ -1960,7 +2642,7 @@ EXAMPLES
1960
2642
  $ lps project remove
1961
2643
  ```
1962
2644
 
1963
- _See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/remove.ts)_
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)_
1964
2646
 
1965
2647
  ## `lps project rotate`
1966
2648
 
@@ -1971,7 +2653,7 @@ USAGE
1971
2653
  $ lps project rotate [--env <value>]
1972
2654
 
1973
2655
  FLAGS
1974
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2656
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
1975
2657
 
1976
2658
  DESCRIPTION
1977
2659
  Rotate the WordPress application password for the current (or --env) environment
@@ -1982,24 +2664,24 @@ EXAMPLES
1982
2664
  $ lps project rotate --env staging
1983
2665
  ```
1984
2666
 
1985
- _See code: [src/commands/project/rotate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/rotate.ts)_
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)_
1986
2668
 
1987
2669
  ## `lps project switch`
1988
2670
 
1989
- Switch the active project and environment
2671
+ Switch the active project (pass --env to target a non-local environment)
1990
2672
 
1991
2673
  ```
1992
2674
  USAGE
1993
2675
  $ lps project switch
1994
2676
 
1995
2677
  DESCRIPTION
1996
- Switch the active project and environment
2678
+ Switch the active project (pass --env to target a non-local environment)
1997
2679
 
1998
2680
  EXAMPLES
1999
2681
  $ lps project switch
2000
2682
  ```
2001
2683
 
2002
- _See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/project/switch.ts)_
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)_
2003
2685
 
2004
2686
  ## `lps promote FROM TO`
2005
2687
 
@@ -2031,11 +2713,11 @@ EXAMPLES
2031
2713
  $ lps promote production staging --dry-run
2032
2714
  ```
2033
2715
 
2034
- _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/promote.ts)_
2716
+ _See code: [src/commands/promote.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/promote.ts)_
2035
2717
 
2036
2718
  ## `lps pull`
2037
2719
 
2038
- Pull all content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, menus, options, and snippets, from WordPress
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
2039
2721
 
2040
2722
  ```
2041
2723
  USAGE
@@ -2044,14 +2726,14 @@ USAGE
2044
2726
  FLAGS
2045
2727
  -d, --dry-run Show what would change without making changes
2046
2728
  -y, --yes Answer yes to confirmation prompts
2047
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2729
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2048
2730
 
2049
2731
  GLOBAL FLAGS
2050
2732
  --json Format output as json.
2051
2733
 
2052
2734
  DESCRIPTION
2053
- Pull all content, plugins, composer dependencies, ACF, API routes, hooks, forms, SEO, menus, options, and snippets,
2054
- from WordPress
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
2055
2737
 
2056
2738
  EXAMPLES
2057
2739
  $ lps pull
@@ -2061,11 +2743,11 @@ EXAMPLES
2061
2743
  $ lps pull --dry-run
2062
2744
  ```
2063
2745
 
2064
- _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/pull.ts)_
2746
+ _See code: [src/commands/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/pull.ts)_
2065
2747
 
2066
2748
  ## `lps push`
2067
2749
 
2068
- Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus, options, and snippets, to WordPress
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
2069
2751
 
2070
2752
  ```
2071
2753
  USAGE
@@ -2074,14 +2756,14 @@ USAGE
2074
2756
  FLAGS
2075
2757
  -d, --dry-run Show what would change without making changes
2076
2758
  -y, --yes Answer yes to confirmation prompts
2077
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2759
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2078
2760
 
2079
2761
  GLOBAL FLAGS
2080
2762
  --json Format output as json.
2081
2763
 
2082
2764
  DESCRIPTION
2083
- Push all local content, plugins, composer dependencies, ACF, API routes, hooks, forms, templates, pages, SEO, menus,
2084
- options, and snippets, to WordPress
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
2085
2767
 
2086
2768
  EXAMPLES
2087
2769
  $ lps push
@@ -2091,145 +2773,202 @@ EXAMPLES
2091
2773
  $ lps push --dry-run
2092
2774
  ```
2093
2775
 
2094
- _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/push.ts)_
2776
+ _See code: [src/commands/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/push.ts)_
2095
2777
 
2096
- ## `lps seo diff [PATH]`
2778
+ ## `lps role diff [PATH]`
2097
2779
 
2098
- Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or between two environments
2780
+ Show what differs in roles between your local roles/ files and a WordPress environment, or between two environments
2099
2781
 
2100
2782
  ```
2101
2783
  USAGE
2102
- $ lps seo diff [PATH] [--json] [--env <value>] [--against <value>]
2784
+ $ lps role diff [PATH] [--json] [--env <value>] [--against <value>]
2103
2785
 
2104
2786
  ARGUMENTS
2105
- [PATH] Path to SEO directory (overrides project config)
2787
+ [PATH] Path to roles directory (overrides project config)
2106
2788
 
2107
2789
  FLAGS
2108
2790
  --against=<value> Compare the primary environment against this second environment instead of against local files
2109
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2791
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2110
2792
 
2111
2793
  GLOBAL FLAGS
2112
2794
  --json Format output as json.
2113
2795
 
2114
2796
  DESCRIPTION
2115
- Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or
2116
- between two environments
2797
+ Show what differs in roles between your local roles/ files and a WordPress environment, or between two environments
2117
2798
 
2118
2799
  EXAMPLES
2119
- $ lps seo diff
2800
+ $ lps role diff
2120
2801
 
2121
- $ lps seo diff --env staging
2802
+ $ lps role diff --env staging
2122
2803
 
2123
- $ lps seo diff --env staging --against production
2804
+ $ lps role diff --env staging --against production
2124
2805
  ```
2125
2806
 
2126
- _See code: [src/commands/seo/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/diff.ts)_
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)_
2127
2808
 
2128
- ## `lps seo list`
2809
+ ## `lps role list`
2129
2810
 
2130
- List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress
2811
+ List the user roles on WordPress, where each comes from (Loopress, WordPress, a plugin) and how many users have it. Only Loopress ones are pulled and pushed.
2131
2812
 
2132
2813
  ```
2133
2814
  USAGE
2134
- $ lps seo list [--json] [--env <value>] [--post-type <value>...]
2815
+ $ lps role list [--json] [--env <value>]
2135
2816
 
2136
2817
  FLAGS
2137
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2138
- --post-type=<value>... Limit to specific post types
2818
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2139
2819
 
2140
2820
  GLOBAL FLAGS
2141
2821
  --json Format output as json.
2142
2822
 
2143
2823
  DESCRIPTION
2144
- List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress
2824
+ List the user roles on WordPress, where each comes from (Loopress, WordPress, a plugin) and how many users have it.
2825
+ Only Loopress ones are pulled and pushed.
2145
2826
 
2146
2827
  EXAMPLES
2147
- $ lps seo list
2828
+ $ lps role list
2829
+ ```
2830
+
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)_
2148
2832
 
2149
- $ lps seo list --post-type post
2833
+ ## `lps role pull [PATH]`
2834
+
2835
+ Pull the roles Loopress manages on WordPress into roles/<slug>.json files. Built-in roles and roles created by a plugin are never pulled, see `lps role list`.
2836
+
2837
+ ```
2838
+ USAGE
2839
+ $ lps role pull [PATH] [--json] [--env <value>] [-d] [-y]
2840
+
2841
+ ARGUMENTS
2842
+ [PATH] Path to the roles directory (overrides project config)
2843
+
2844
+ FLAGS
2845
+ -d, --dry-run Show what would change without making changes
2846
+ -y, --yes Answer yes to confirmation prompts
2847
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2848
+
2849
+ GLOBAL FLAGS
2850
+ --json Format output as json.
2851
+
2852
+ DESCRIPTION
2853
+ Pull the roles Loopress manages on WordPress into roles/<slug>.json files. Built-in roles and roles created by a
2854
+ plugin are never pulled, see `lps role list`.
2855
+
2856
+ EXAMPLES
2857
+ $ lps role pull
2150
2858
  ```
2151
2859
 
2152
- _See code: [src/commands/seo/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/list.ts)_
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)_
2153
2861
 
2154
- ## `lps seo pull [PATH]`
2862
+ ## `lps role push [PATH]`
2155
2863
 
2156
- Pull SEO settings, post meta, and (if supported) redirects from WordPress
2864
+ Push local roles (roles/<slug>.json, a "name" and its "capabilities") to WordPress. Create or update only, never deletes a role (use `lps role rm`), never changes which users have it.
2157
2865
 
2158
2866
  ```
2159
2867
  USAGE
2160
- $ lps seo pull [PATH] [--json] [--env <value>] [-d] [-y] [--post-type <value>...]
2868
+ $ lps role push [PATH] [--json] [--env <value>] [-d] [-y]
2161
2869
 
2162
2870
  ARGUMENTS
2163
- [PATH] Path to SEO directory (overrides project config)
2871
+ [PATH] Path to the roles directory (overrides project config)
2164
2872
 
2165
2873
  FLAGS
2166
- -d, --dry-run Show what would change without making changes
2167
- -y, --yes Answer yes to confirmation prompts
2168
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2169
- --post-type=<value>... Limit post meta to specific post types
2874
+ -d, --dry-run Show what would change without making changes
2875
+ -y, --yes Answer yes to confirmation prompts
2876
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2170
2877
 
2171
2878
  GLOBAL FLAGS
2172
2879
  --json Format output as json.
2173
2880
 
2174
2881
  DESCRIPTION
2175
- Pull SEO settings, post meta, and (if supported) redirects from WordPress
2882
+ Push local roles (roles/<slug>.json, a "name" and its "capabilities") to WordPress. Create or update only, never
2883
+ deletes a role (use `lps role rm`), never changes which users have it.
2176
2884
 
2177
2885
  EXAMPLES
2178
- $ lps seo pull
2886
+ $ lps role push
2887
+ ```
2888
+
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)_
2890
+
2891
+ ## `lps role remove SLUG`
2892
+
2893
+ Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role is pushed again.
2179
2894
 
2180
- $ lps seo pull --post-type post --post-type page
2181
2895
  ```
2896
+ USAGE
2897
+ $ lps role remove SLUG [--json] [--env <value>] [-d] [-y]
2898
+
2899
+ ARGUMENTS
2900
+ SLUG The role slug, its roles/ file name without .json
2901
+
2902
+ FLAGS
2903
+ -d, --dry-run Show what would change without making changes
2904
+ -y, --yes Answer yes to confirmation prompts
2905
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2906
+
2907
+ GLOBAL FLAGS
2908
+ --json Format output as json.
2909
+
2910
+ DESCRIPTION
2911
+ Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role
2912
+ is pushed again.
2913
+
2914
+ ALIASES
2915
+ $ lps role remove
2916
+
2917
+ EXAMPLES
2918
+ $ lps role rm <slug>
2182
2919
 
2183
- _See code: [src/commands/seo/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/pull.ts)_
2920
+ $ lps role remove <slug> --yes
2921
+ ```
2184
2922
 
2185
- ## `lps seo push [PATH]`
2923
+ ## `lps role rm SLUG`
2186
2924
 
2187
- Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.
2925
+ Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role is pushed again.
2188
2926
 
2189
2927
  ```
2190
2928
  USAGE
2191
- $ lps seo push [PATH] [--json] [--env <value>] [-d] [-y] [--allow-external-redirects]
2929
+ $ lps role rm SLUG [--json] [--env <value>] [-d] [-y]
2192
2930
 
2193
2931
  ARGUMENTS
2194
- [PATH] Path to SEO directory (overrides project config)
2932
+ SLUG The role slug, its roles/ file name without .json
2195
2933
 
2196
2934
  FLAGS
2197
- -d, --dry-run Show what would change without making changes
2198
- -y, --yes Answer yes to confirmation prompts
2199
- --allow-external-redirects Allow pushing a redirect whose target points off this site. Off by default: the server
2200
- rejects an off-site `urlTo` so a stray push can't 301 traffic away.
2201
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2935
+ -d, --dry-run Show what would change without making changes
2936
+ -y, --yes Answer yes to confirmation prompts
2937
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2202
2938
 
2203
2939
  GLOBAL FLAGS
2204
2940
  --json Format output as json.
2205
2941
 
2206
2942
  DESCRIPTION
2207
- Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to
2208
- the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.
2943
+ Stop registering a Loopress role on WordPress. Its users keep it in their profile, with no capability until the role
2944
+ is pushed again.
2945
+
2946
+ ALIASES
2947
+ $ lps role remove
2209
2948
 
2210
2949
  EXAMPLES
2211
- $ lps seo push
2950
+ $ lps role rm <slug>
2212
2951
 
2213
- $ lps seo push --allow-external-redirects
2952
+ $ lps role remove <slug> --yes
2214
2953
  ```
2215
2954
 
2216
- _See code: [src/commands/seo/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/push.ts)_
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)_
2217
2956
 
2218
- ## `lps seo rollback [PATH]`
2957
+ ## `lps role rollback [PATH]`
2219
2958
 
2220
- Restore SEO settings, post meta, and redirects to a snapshot taken automatically before an earlier `lps seo push`
2959
+ Restore roles to a snapshot taken automatically before an earlier `lps role push`
2221
2960
 
2222
2961
  ```
2223
2962
  USAGE
2224
- $ lps seo rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2963
+ $ lps role rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
2225
2964
 
2226
2965
  ARGUMENTS
2227
- [PATH] Path to SEO directory (overrides project config)
2966
+ [PATH] Path to roles directory (overrides project config)
2228
2967
 
2229
2968
  FLAGS
2230
2969
  -d, --dry-run Show what would change without making changes
2231
2970
  -y, --yes Answer yes to confirmation prompts
2232
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
2971
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2233
2972
  --list List available snapshots instead of rolling back
2234
2973
  --to=<value> Roll back to this snapshot id instead of the most recent one
2235
2974
 
@@ -2237,19 +2976,19 @@ GLOBAL FLAGS
2237
2976
  --json Format output as json.
2238
2977
 
2239
2978
  DESCRIPTION
2240
- Restore SEO settings, post meta, and redirects to a snapshot taken automatically before an earlier `lps seo push`
2979
+ Restore roles to a snapshot taken automatically before an earlier `lps role push`
2241
2980
 
2242
2981
  EXAMPLES
2243
- $ lps seo rollback
2982
+ $ lps role rollback
2244
2983
 
2245
- $ lps seo rollback --list
2984
+ $ lps role rollback --list
2246
2985
 
2247
- $ lps seo rollback --to 1732000000000
2986
+ $ lps role rollback --to 1732000000000
2248
2987
 
2249
- $ lps seo rollback --dry-run
2988
+ $ lps role rollback --dry-run
2250
2989
  ```
2251
2990
 
2252
- _See code: [src/commands/seo/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/seo/rollback.ts)_
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)_
2253
2992
 
2254
2993
  ## `lps snippet diff [PATH]`
2255
2994
 
@@ -2264,7 +3003,7 @@ ARGUMENTS
2264
3003
 
2265
3004
  FLAGS
2266
3005
  --against=<value> Compare the primary environment against this second environment instead of against local files
2267
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3006
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2268
3007
 
2269
3008
  GLOBAL FLAGS
2270
3009
  --json Format output as json.
@@ -2280,7 +3019,7 @@ EXAMPLES
2280
3019
  $ lps snippet diff --env staging --against production
2281
3020
  ```
2282
3021
 
2283
- _See code: [src/commands/snippet/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/diff.ts)_
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)_
2284
3023
 
2285
3024
  ## `lps snippet list`
2286
3025
 
@@ -2291,7 +3030,7 @@ USAGE
2291
3030
  $ lps snippet list [--json] [--env <value>]
2292
3031
 
2293
3032
  FLAGS
2294
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3033
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2295
3034
 
2296
3035
  GLOBAL FLAGS
2297
3036
  --json Format output as json.
@@ -2303,7 +3042,7 @@ EXAMPLES
2303
3042
  $ lps snippet list
2304
3043
  ```
2305
3044
 
2306
- _See code: [src/commands/snippet/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/list.ts)_
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)_
2307
3046
 
2308
3047
  ## `lps snippet publish [PATH]`
2309
3048
 
@@ -2326,7 +3065,7 @@ EXAMPLES
2326
3065
  $ lps snippet publish ./snippets
2327
3066
  ```
2328
3067
 
2329
- _See code: [src/commands/snippet/publish.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/publish.ts)_
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)_
2330
3069
 
2331
3070
  ## `lps snippet pull [PATH]`
2332
3071
 
@@ -2342,7 +3081,7 @@ ARGUMENTS
2342
3081
  FLAGS
2343
3082
  -d, --dry-run Show what would change without making changes
2344
3083
  -y, --yes Answer yes to confirmation prompts
2345
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3084
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2346
3085
 
2347
3086
  GLOBAL FLAGS
2348
3087
  --json Format output as json.
@@ -2356,7 +3095,7 @@ EXAMPLES
2356
3095
  $ lps snippet pull ./snippets
2357
3096
  ```
2358
3097
 
2359
- _See code: [src/commands/snippet/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/pull.ts)_
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)_
2360
3099
 
2361
3100
  ## `lps snippet push [PATH]`
2362
3101
 
@@ -2372,7 +3111,7 @@ ARGUMENTS
2372
3111
  FLAGS
2373
3112
  -d, --dry-run Show what would change without making changes
2374
3113
  -y, --yes Answer yes to confirmation prompts
2375
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3114
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2376
3115
 
2377
3116
  GLOBAL FLAGS
2378
3117
  --json Format output as json.
@@ -2387,7 +3126,7 @@ EXAMPLES
2387
3126
  $ lps snippet push ./snippets
2388
3127
  ```
2389
3128
 
2390
- _See code: [src/commands/snippet/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/push.ts)_
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)_
2391
3130
 
2392
3131
  ## `lps snippet rollback [PATH]`
2393
3132
 
@@ -2403,7 +3142,7 @@ ARGUMENTS
2403
3142
  FLAGS
2404
3143
  -d, --dry-run Show what would change without making changes
2405
3144
  -y, --yes Answer yes to confirmation prompts
2406
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3145
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2407
3146
  --list List available snapshots instead of rolling back
2408
3147
  --to=<value> Roll back to this snapshot id instead of the most recent one
2409
3148
 
@@ -2423,7 +3162,7 @@ EXAMPLES
2423
3162
  $ lps snippet rollback --dry-run
2424
3163
  ```
2425
3164
 
2426
- _See code: [src/commands/snippet/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/snippet/rollback.ts)_
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)_
2427
3166
 
2428
3167
  ## `lps status`
2429
3168
 
@@ -2448,7 +3187,223 @@ EXAMPLES
2448
3187
  $ lps status --env staging
2449
3188
  ```
2450
3189
 
2451
- _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/status.ts)_
3190
+ _See code: [src/commands/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/status.ts)_
3191
+
3192
+ ## `lps taxonomy diff [PATH]`
3193
+
3194
+ Show what differs in taxonomies between your local taxonomies/ files and a WordPress environment, or between two environments
3195
+
3196
+ ```
3197
+ USAGE
3198
+ $ lps taxonomy diff [PATH] [--json] [--env <value>] [--against <value>]
3199
+
3200
+ ARGUMENTS
3201
+ [PATH] Path to taxonomies directory (overrides project config)
3202
+
3203
+ FLAGS
3204
+ --against=<value> Compare the primary environment against this second environment instead of against local files
3205
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3206
+
3207
+ GLOBAL FLAGS
3208
+ --json Format output as json.
3209
+
3210
+ DESCRIPTION
3211
+ Show what differs in taxonomies between your local taxonomies/ files and a WordPress environment, or between two
3212
+ environments
3213
+
3214
+ EXAMPLES
3215
+ $ lps taxonomy diff
3216
+
3217
+ $ lps taxonomy diff --env staging
3218
+
3219
+ $ lps taxonomy diff --env staging --against production
3220
+ ```
3221
+
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)_
3223
+
3224
+ ## `lps taxonomy list`
3225
+
3226
+ List the taxonomies registered on WordPress, where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or plugin) and the post types it attaches to. Only Loopress ones are pulled and pushed.
3227
+
3228
+ ```
3229
+ USAGE
3230
+ $ lps taxonomy list [--json] [--env <value>]
3231
+
3232
+ FLAGS
3233
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3234
+
3235
+ GLOBAL FLAGS
3236
+ --json Format output as json.
3237
+
3238
+ DESCRIPTION
3239
+ List the taxonomies registered on WordPress, where each comes from (Loopress, WordPress, ACF, CPT UI, a theme or
3240
+ plugin) and the post types it attaches to. Only Loopress ones are pulled and pushed.
3241
+
3242
+ EXAMPLES
3243
+ $ lps taxonomy list
3244
+ ```
3245
+
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)_
3247
+
3248
+ ## `lps taxonomy pull [PATH]`
3249
+
3250
+ Pull the taxonomies Loopress manages on WordPress into taxonomies/<slug>.json files, never their terms. Taxonomies registered by a theme or another plugin are never pulled, see `lps taxonomy list`.
3251
+
3252
+ ```
3253
+ USAGE
3254
+ $ lps taxonomy pull [PATH] [--json] [--env <value>] [-d] [-y]
3255
+
3256
+ ARGUMENTS
3257
+ [PATH] Path to the taxonomies directory (overrides project config)
3258
+
3259
+ FLAGS
3260
+ -d, --dry-run Show what would change without making changes
3261
+ -y, --yes Answer yes to confirmation prompts
3262
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3263
+
3264
+ GLOBAL FLAGS
3265
+ --json Format output as json.
3266
+
3267
+ DESCRIPTION
3268
+ Pull the taxonomies Loopress manages on WordPress into taxonomies/<slug>.json files, never their terms. Taxonomies
3269
+ registered by a theme or another plugin are never pulled, see `lps taxonomy list`.
3270
+
3271
+ EXAMPLES
3272
+ $ lps taxonomy pull
3273
+ ```
3274
+
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)_
3276
+
3277
+ ## `lps taxonomy push [PATH]`
3278
+
3279
+ Push local taxonomies (taxonomies/<slug>.json, register_taxonomy() arguments plus "object_type") to WordPress. Create or update only, never deletes a taxonomy (use `lps taxonomy rm`), never touches its terms.
3280
+
3281
+ ```
3282
+ USAGE
3283
+ $ lps taxonomy push [PATH] [--json] [--env <value>] [-d] [-y]
3284
+
3285
+ ARGUMENTS
3286
+ [PATH] Path to the taxonomies directory (overrides project config)
3287
+
3288
+ FLAGS
3289
+ -d, --dry-run Show what would change without making changes
3290
+ -y, --yes Answer yes to confirmation prompts
3291
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3292
+
3293
+ GLOBAL FLAGS
3294
+ --json Format output as json.
3295
+
3296
+ DESCRIPTION
3297
+ Push local taxonomies (taxonomies/<slug>.json, register_taxonomy() arguments plus "object_type") to WordPress. Create
3298
+ or update only, never deletes a taxonomy (use `lps taxonomy rm`), never touches its terms.
3299
+
3300
+ EXAMPLES
3301
+ $ lps taxonomy push
3302
+ ```
3303
+
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)_
3305
+
3306
+ ## `lps taxonomy remove SLUG`
3307
+
3308
+ Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is pushed again.
3309
+
3310
+ ```
3311
+ USAGE
3312
+ $ lps taxonomy remove SLUG [--json] [--env <value>] [-d] [-y]
3313
+
3314
+ ARGUMENTS
3315
+ SLUG The taxonomy slug, its taxonomies/ file name without .json
3316
+
3317
+ FLAGS
3318
+ -d, --dry-run Show what would change without making changes
3319
+ -y, --yes Answer yes to confirmation prompts
3320
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3321
+
3322
+ GLOBAL FLAGS
3323
+ --json Format output as json.
3324
+
3325
+ DESCRIPTION
3326
+ Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is
3327
+ pushed again.
3328
+
3329
+ ALIASES
3330
+ $ lps taxonomy remove
3331
+
3332
+ EXAMPLES
3333
+ $ lps taxonomy rm <slug>
3334
+
3335
+ $ lps taxonomy remove <slug> --yes
3336
+ ```
3337
+
3338
+ ## `lps taxonomy rm SLUG`
3339
+
3340
+ Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is pushed again.
3341
+
3342
+ ```
3343
+ USAGE
3344
+ $ lps taxonomy rm SLUG [--json] [--env <value>] [-d] [-y]
3345
+
3346
+ ARGUMENTS
3347
+ SLUG The taxonomy slug, its taxonomies/ file name without .json
3348
+
3349
+ FLAGS
3350
+ -d, --dry-run Show what would change without making changes
3351
+ -y, --yes Answer yes to confirmation prompts
3352
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3353
+
3354
+ GLOBAL FLAGS
3355
+ --json Format output as json.
3356
+
3357
+ DESCRIPTION
3358
+ Stop registering a Loopress taxonomy on WordPress. Its terms are kept in the database, hidden until the taxonomy is
3359
+ pushed again.
3360
+
3361
+ ALIASES
3362
+ $ lps taxonomy remove
3363
+
3364
+ EXAMPLES
3365
+ $ lps taxonomy rm <slug>
3366
+
3367
+ $ lps taxonomy remove <slug> --yes
3368
+ ```
3369
+
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)_
3371
+
3372
+ ## `lps taxonomy rollback [PATH]`
3373
+
3374
+ Restore taxonomies to a snapshot taken automatically before an earlier `lps taxonomy push`
3375
+
3376
+ ```
3377
+ USAGE
3378
+ $ lps taxonomy rollback [PATH] [--json] [--env <value>] [-d] [-y] [--list] [--to <value>]
3379
+
3380
+ ARGUMENTS
3381
+ [PATH] Path to taxonomies directory (overrides project config)
3382
+
3383
+ FLAGS
3384
+ -d, --dry-run Show what would change without making changes
3385
+ -y, --yes Answer yes to confirmation prompts
3386
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
3387
+ --list List available snapshots instead of rolling back
3388
+ --to=<value> Roll back to this snapshot id instead of the most recent one
3389
+
3390
+ GLOBAL FLAGS
3391
+ --json Format output as json.
3392
+
3393
+ DESCRIPTION
3394
+ Restore taxonomies to a snapshot taken automatically before an earlier `lps taxonomy push`
3395
+
3396
+ EXAMPLES
3397
+ $ lps taxonomy rollback
3398
+
3399
+ $ lps taxonomy rollback --list
3400
+
3401
+ $ lps taxonomy rollback --to 1732000000000
3402
+
3403
+ $ lps taxonomy rollback --dry-run
3404
+ ```
3405
+
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)_
2452
3407
 
2453
3408
  ## `lps telemetry disable`
2454
3409
 
@@ -2465,7 +3420,7 @@ EXAMPLES
2465
3420
  $ lps telemetry disable
2466
3421
  ```
2467
3422
 
2468
- _See code: [src/commands/telemetry/disable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/telemetry/disable.ts)_
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)_
2469
3424
 
2470
3425
  ## `lps telemetry enable`
2471
3426
 
@@ -2482,7 +3437,7 @@ EXAMPLES
2482
3437
  $ lps telemetry enable
2483
3438
  ```
2484
3439
 
2485
- _See code: [src/commands/telemetry/enable.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/telemetry/enable.ts)_
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)_
2486
3441
 
2487
3442
  ## `lps theme add SLUG`
2488
3443
 
@@ -2497,7 +3452,7 @@ ARGUMENTS
2497
3452
 
2498
3453
  FLAGS
2499
3454
  -d, --dry-run Show what would change without making changes
2500
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3455
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2501
3456
  --version=<value> Exact version to pin (default: "latest")
2502
3457
 
2503
3458
  GLOBAL FLAGS
@@ -2512,7 +3467,7 @@ EXAMPLES
2512
3467
  $ lps theme add generatepress --version 3.4.0
2513
3468
  ```
2514
3469
 
2515
- _See code: [src/commands/theme/add.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/add.ts)_
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)_
2516
3471
 
2517
3472
  ## `lps theme pull`
2518
3473
 
@@ -2524,7 +3479,7 @@ USAGE
2524
3479
 
2525
3480
  FLAGS
2526
3481
  -d, --dry-run Show what would change without making changes
2527
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3482
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2528
3483
 
2529
3484
  GLOBAL FLAGS
2530
3485
  --json Format output as json.
@@ -2540,7 +3495,7 @@ EXAMPLES
2540
3495
  $ lps theme pull --dry-run
2541
3496
  ```
2542
3497
 
2543
- _See code: [src/commands/theme/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/pull.ts)_
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)_
2544
3499
 
2545
3500
  ## `lps theme push`
2546
3501
 
@@ -2553,7 +3508,7 @@ USAGE
2553
3508
  FLAGS
2554
3509
  -d, --dry-run Show what would change without making changes
2555
3510
  -y, --yes Answer yes to confirmation prompts
2556
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3511
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2557
3512
  --force Passed to `lps theme version push`
2558
3513
 
2559
3514
  GLOBAL FLAGS
@@ -2570,7 +3525,7 @@ EXAMPLES
2570
3525
  $ lps theme push --dry-run
2571
3526
  ```
2572
3527
 
2573
- _See code: [src/commands/theme/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/push.ts)_
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)_
2574
3529
 
2575
3530
  ## `lps theme status`
2576
3531
 
@@ -2581,7 +3536,7 @@ USAGE
2581
3536
  $ lps theme status [--json] [--env <value>]
2582
3537
 
2583
3538
  FLAGS
2584
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3539
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2585
3540
 
2586
3541
  GLOBAL FLAGS
2587
3542
  --json Format output as json.
@@ -2593,7 +3548,7 @@ EXAMPLES
2593
3548
  $ lps theme status
2594
3549
  ```
2595
3550
 
2596
- _See code: [src/commands/theme/status.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/status.ts)_
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)_
2597
3552
 
2598
3553
  ## `lps theme style diff [PATH]`
2599
3554
 
@@ -2608,7 +3563,7 @@ ARGUMENTS
2608
3563
 
2609
3564
  FLAGS
2610
3565
  --against=<value> Compare the primary environment against this second environment instead of against local files
2611
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3566
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2612
3567
 
2613
3568
  GLOBAL FLAGS
2614
3569
  --json Format output as json.
@@ -2625,7 +3580,7 @@ EXAMPLES
2625
3580
  $ lps theme style diff --env staging --against production
2626
3581
  ```
2627
3582
 
2628
- _See code: [src/commands/theme/style/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/diff.ts)_
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)_
2629
3584
 
2630
3585
  ## `lps theme style pull [PATH]`
2631
3586
 
@@ -2640,7 +3595,7 @@ ARGUMENTS
2640
3595
 
2641
3596
  FLAGS
2642
3597
  -d, --dry-run Show what would change without making changes
2643
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3598
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2644
3599
 
2645
3600
  GLOBAL FLAGS
2646
3601
  --json Format output as json.
@@ -2652,7 +3607,7 @@ EXAMPLES
2652
3607
  $ lps theme style pull
2653
3608
  ```
2654
3609
 
2655
- _See code: [src/commands/theme/style/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/pull.ts)_
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)_
2656
3611
 
2657
3612
  ## `lps theme style push [PATH]`
2658
3613
 
@@ -2668,7 +3623,7 @@ ARGUMENTS
2668
3623
  FLAGS
2669
3624
  -d, --dry-run Show what would change without making changes
2670
3625
  -y, --yes Answer yes to confirmation prompts
2671
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3626
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2672
3627
 
2673
3628
  GLOBAL FLAGS
2674
3629
  --json Format output as json.
@@ -2680,7 +3635,7 @@ EXAMPLES
2680
3635
  $ lps theme style push
2681
3636
  ```
2682
3637
 
2683
- _See code: [src/commands/theme/style/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/push.ts)_
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)_
2684
3639
 
2685
3640
  ## `lps theme style rollback [PATH]`
2686
3641
 
@@ -2696,7 +3651,7 @@ ARGUMENTS
2696
3651
  FLAGS
2697
3652
  -d, --dry-run Show what would change without making changes
2698
3653
  -y, --yes Answer yes to confirmation prompts
2699
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3654
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2700
3655
  --list List available snapshots instead of rolling back
2701
3656
  --to=<value> Roll back to this snapshot id instead of the most recent one
2702
3657
 
@@ -2716,7 +3671,7 @@ EXAMPLES
2716
3671
  $ lps theme style rollback --dry-run
2717
3672
  ```
2718
3673
 
2719
- _See code: [src/commands/theme/style/rollback.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/style/rollback.ts)_
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)_
2720
3675
 
2721
3676
  ## `lps theme template diff`
2722
3677
 
@@ -2728,7 +3683,7 @@ USAGE
2728
3683
 
2729
3684
  FLAGS
2730
3685
  --against=<value> Compare the primary environment against this second environment instead of against local files
2731
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3686
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2732
3687
 
2733
3688
  GLOBAL FLAGS
2734
3689
  --json Format output as json.
@@ -2745,7 +3700,7 @@ EXAMPLES
2745
3700
  $ lps theme template diff --env staging --against production
2746
3701
  ```
2747
3702
 
2748
- _See code: [src/commands/theme/template/diff.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/diff.ts)_
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)_
2749
3704
 
2750
3705
  ## `lps theme template list`
2751
3706
 
@@ -2756,7 +3711,7 @@ USAGE
2756
3711
  $ lps theme template list [--json] [--env <value>]
2757
3712
 
2758
3713
  FLAGS
2759
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3714
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2760
3715
 
2761
3716
  GLOBAL FLAGS
2762
3717
  --json Format output as json.
@@ -2768,11 +3723,11 @@ EXAMPLES
2768
3723
  $ lps theme template list
2769
3724
  ```
2770
3725
 
2771
- _See code: [src/commands/theme/template/list.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/list.ts)_
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)_
2772
3727
 
2773
3728
  ## `lps theme template push`
2774
3729
 
2775
- Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.
3730
+ Push block templates (theme/templates/<slug>.html), template parts (theme/parts/<slug>.html) and the theme CSS (theme/css/style.css, theme/blocks/<namespace>/<block>.css, bundled with esbuild) as the files of a child theme of the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is never activated for you.
2776
3731
 
2777
3732
  ```
2778
3733
  USAGE
@@ -2781,15 +3736,16 @@ USAGE
2781
3736
  FLAGS
2782
3737
  -d, --dry-run Show what would change without making changes
2783
3738
  -y, --yes Answer yes to confirmation prompts
2784
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3739
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2785
3740
 
2786
3741
  GLOBAL FLAGS
2787
3742
  --json Format output as json.
2788
3743
 
2789
3744
  DESCRIPTION
2790
- Push block templates (templates/<slug>.html) and template parts (parts/<slug>.html) as the files of a child theme of
2791
- the active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it.
2792
- It is never activated for you.
3745
+ Push block templates (theme/templates/<slug>.html), template parts (theme/parts/<slug>.html) and the theme CSS
3746
+ (theme/css/style.css, theme/blocks/<namespace>/<block>.css, bundled with esbuild) as the files of a child theme of the
3747
+ active block theme, <parent>-loopress. The child mirrors the project: files removed locally are removed from it. It is
3748
+ never activated for you.
2793
3749
 
2794
3750
  EXAMPLES
2795
3751
  $ lps theme template push
@@ -2797,7 +3753,7 @@ EXAMPLES
2797
3753
  $ lps theme template push --dry-run
2798
3754
  ```
2799
3755
 
2800
- _See code: [src/commands/theme/template/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/template/push.ts)_
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)_
2801
3757
 
2802
3758
  ## `lps theme version pull`
2803
3759
 
@@ -2809,7 +3765,7 @@ USAGE
2809
3765
 
2810
3766
  FLAGS
2811
3767
  -d, --dry-run Show what would change without making changes
2812
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3768
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2813
3769
 
2814
3770
  GLOBAL FLAGS
2815
3771
  --json Format output as json.
@@ -2821,7 +3777,7 @@ EXAMPLES
2821
3777
  $ lps theme version pull
2822
3778
  ```
2823
3779
 
2824
- _See code: [src/commands/theme/version/pull.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/version/pull.ts)_
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)_
2825
3781
 
2826
3782
  ## `lps theme version push`
2827
3783
 
@@ -2834,7 +3790,7 @@ USAGE
2834
3790
  FLAGS
2835
3791
  -d, --dry-run Show what would change without making changes
2836
3792
  -y, --yes Answer yes to confirmation prompts
2837
- --env=<value> Target environment by name, overriding the globally active one (lps project switch)
3793
+ --env=<value> Target environment by name (default: "local", or the project's only environment)
2838
3794
  --force Allow downgrades and take over themes installed outside Loopress
2839
3795
 
2840
3796
  GLOBAL FLAGS
@@ -2849,7 +3805,7 @@ EXAMPLES
2849
3805
  $ lps theme version push --force
2850
3806
  ```
2851
3807
 
2852
- _See code: [src/commands/theme/version/push.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/theme/version/push.ts)_
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)_
2853
3809
 
2854
3810
  ## `lps validate`
2855
3811
 
@@ -2869,5 +3825,5 @@ EXAMPLES
2869
3825
  $ lps validate
2870
3826
  ```
2871
3827
 
2872
- _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.29.0/cli/src/commands/validate.ts)_
3828
+ _See code: [src/commands/validate.ts](https://github.com/loopress/loopress/blob/%40loopress%2Fcli%400.30.0/cli/src/commands/validate.ts)_
2873
3829
  <!-- commandsstop -->