@simplysf/simply 6.10.7 → 6.12.0

package/README.md

@@ -2546,7 +2546,7 @@ FLAG DESCRIPTIONS
     The path to write the generated HTML report to.
 ```
 
-_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.4.4/packages/simply-permissions/lib/commands/simply/permissions/analyze.js)_
+_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.6.0/packages/simply-permissions/lib/commands/simply/permissions/analyze.js)_
 
 ## `sf simply permissions assignment delete`
 
@@ -2589,7 +2589,7 @@ EXAMPLES
   $ sf simply permissions assignment delete --permission-set-group-name My_Permission_Set_Group --target-org myOrg
 ```
 
-_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.4.4/packages/simply-permissions/lib/commands/simply/permissions/assignment/delete.js)_
+_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.6.0/packages/simply-permissions/lib/commands/simply/permissions/assignment/delete.js)_
 
 ## `sf simply permissions build`
 
@@ -2599,12 +2599,14 @@ Generate permission sets from Salesforce source metadata.
 USAGE
   $ sf simply permissions build [--json] [--flags-dir <value>] [-f <value> | --type read-only|view-all|modify-all | -n <value>
     | -d <value> | --output <value> | -c <value> | --include-record-types | --label <value> | --description <value>]
+    [--check]
 
 FLAGS
   -c, --config=<value>        Path to a permission set configuration file
   -d, --directory=<value>     Path to the Salesforce project directory
   -f, --file=<value>          Path to a permission sets file declaring every permission set to generate
   -n, --name=<value>          API name for the permission set
+      --check                 Check that the generated permission sets are up to date, without writing them
       --description=<value>   Description for the permission set
       --include-record-types  Include record type visibilities
       --label=<value>         Label for the permission set
@@ -2630,7 +2632,9 @@ DESCRIPTION
   shared by every entry, and any entry can override them. An entry's "config" is either a path to a --config file or the
   same overrides inline. Relative paths are resolved against the current directory, as they are for flags. The whole
   file, including referenced override files and source directories, is validated before anything is written, and each
-  source directory is scanned only once.
+  source directory is scanned only once. Name the file with the .psbuild.json suffix (for example
+  config/app.psbuild.json): that's how `sf simply cicd build check-permission-sets` finds permission sets files, and
+  this command warns about a file without it.
 
   {
   "defaults": {
@@ -2654,6 +2658,12 @@ DESCRIPTION
   ]
   }
 
+  To check in CI that the committed permission sets still match their source metadata, add --check. It builds each
+  permission set as usual but writes nothing: it compares each one with the file already at its output path and reports
+  it as "up-to-date", "drifted", or "missing". If any permission set has drifted or is missing, the command exits with
+  code 1. Formatting differences, such as indentation, line endings, or comments, don't count as drift, so files
+  reformatted by Prettier still pass. Any other difference does, including hand edits and reordered entries.
+
 EXAMPLES
   $ sf simply permissions build --type read-only --name My_Read_Only_Access --directory force-app --output force-app/main/default/permissionsets
 
@@ -2661,7 +2671,11 @@ EXAMPLES
 
   Regenerate every permission set declared in a permission sets file:
 
-    $ sf simply permissions build --file config/permission-sets.json
+    $ sf simply permissions build --file config/app.psbuild.json
+
+  In CI, fail if any permission set declared in a permission sets file needs to be regenerated:
+
+    $ sf simply permissions build --file config/app.psbuild.json --check
 
 FLAG DESCRIPTIONS
   -c, --config=<value>  Path to a permission set configuration file
@@ -2678,13 +2692,20 @@ FLAG DESCRIPTIONS
 
     The path to a JSON file with a "permissionSets" array, each entry describing one permission set to generate ("name",
     "type", and optionally "label", "description", "directory", "output", "includeRecordTypes", "config"), and an
-    optional "defaults" object. Can't be combined with the flags that describe a single permission set.
+    optional "defaults" object. Name it with the .psbuild.json suffix; any other name works but prints a warning. Can't
+    be combined with the flags that describe a single permission set.
 
   -n, --name=<value>  API name for the permission set
 
     The API name for the generated permission set; also used to derive the output filename. Required unless --file is
     used.
 
+  --check  Check that the generated permission sets are up to date, without writing them
+
+    Instead of writing each permission set, compare what would be generated with the file already at its output path.
+    Exits with code 1 if any permission set has drifted or is missing. Works with --file and with the
+    single-permission-set flags.
+
   --include-record-types  Include record type visibilities
 
     Automatically include record type visibilities discovered from the source metadata, marked as visible by default.
@@ -2700,7 +2721,7 @@ FLAG DESCRIPTIONS
     Required unless --file is used.
 ```
 
-_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.4.4/packages/simply-permissions/lib/commands/simply/permissions/build.js)_
+_See code: [@simplysf/simply-permissions](https://github.com/SimplySF/simply-plugins/blob/@simplysf/simply-permissions@1.6.0/packages/simply-permissions/lib/commands/simply/permissions/build.js)_
 
 ## `sf simply project update api-version`
 

package/oclif.manifest.json

@@ -1,4 +1,4 @@
 {
   "commands": {},
-  "version": "6.10.7"
+  "version": "6.12.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply",
   "description": "Salesforce CLI Plugins created by @SimplySF",
-  "version": "6.10.7",
+  "version": "6.12.0",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-plugins",
   "bugs": "https://github.com/SimplySF/simply-plugins/issues",
@@ -83,7 +83,7 @@
     "@simplysf/simply-document": "^0.4.13",
     "@simplysf/simply-flow": "^0.4.16",
     "@simplysf/simply-package": "^3.1.7",
-    "@simplysf/simply-permissions": "^1.4.4",
+    "@simplysf/simply-permissions": "^1.6.0",
     "@simplysf/simply-project": "^1.2.29",
     "@simplysf/simply-schema": "^0.3.34",
     "@simplysf/simply-settings": "^0.3.2",
@@ -180,5 +180,5 @@
       "output": []
     }
   },
-  "gitHead": "7bd4cc96688ad9379ae8440a6a945f61d1d004bc"
+  "gitHead": "cfc320bc665f61d2ab5c702ea9120bddc34b6078"
 }