@codiac.io/codiac-cli 1.3.285 → 1.3.287

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @codiac.io/codiac-cli
 $ codiac COMMAND
 running command...
 $ codiac (--version|-v)
-@codiac.io/codiac-cli/1.3.285 linux-x64 node-v22.15.1
+@codiac.io/codiac-cli/1.3.287 linux-x64 node-v22.15.1
 $ codiac --help [COMMAND]
 USAGE
   $ codiac COMMAND
@@ -531,7 +531,7 @@ EXAMPLES
     $ codiac ai agent csp add --agent hermes-agent --cabinet bens-agent --login data-aws --provider aws
 ```
 
-_See code: [src/commands/ai/agent/csp/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/agent/csp/add.ts)_
+_See code: [src/commands/ai/agent/csp/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/agent/csp/add.ts)_
 
 ## `codiac ai agent csp delete`
 
@@ -562,7 +562,7 @@ EXAMPLES
     $ codiac ai agent csp delete --agent hermes-agent --login prod-az
 ```
 
-_See code: [src/commands/ai/agent/csp/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/agent/csp/delete.ts)_
+_See code: [src/commands/ai/agent/csp/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/agent/csp/delete.ts)_
 
 ## `codiac ai agent csp list`
 
@@ -591,7 +591,7 @@ EXAMPLES
     $ codiac ai agent csp list --agent hermes-agent
 ```
 
-_See code: [src/commands/ai/agent/csp/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/agent/csp/list.ts)_
+_See code: [src/commands/ai/agent/csp/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/agent/csp/list.ts)_
 
 ## `codiac ai agent csp ls`
 
@@ -731,7 +731,7 @@ EXAMPLES
     $ codiac ai agent install -e ben -t hermes -c dev --to-script
 ```
 
-_See code: [src/commands/ai/agent/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/agent/install.ts)_
+_See code: [src/commands/ai/agent/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/agent/install.ts)_
 
 ## `codiac ai model attach`
 
@@ -766,7 +766,7 @@ EXAMPLES
     $ codiac ai model attach -e ben -m qwen3-dev --agent hermes-agent -c dev --silent
 ```
 
-_See code: [src/commands/ai/model/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/model/attach.ts)_
+_See code: [src/commands/ai/model/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/model/attach.ts)_
 
 ## `codiac ai model install`
 
@@ -838,7 +838,7 @@ EXAMPLES
     $ codiac ai model install -e ben --source served -m qwen3 --runtime cpu -c dev --to-script
 ```
 
-_See code: [src/commands/ai/model/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/model/install.ts)_
+_See code: [src/commands/ai/model/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/model/install.ts)_
 
 ## `codiac ai model list`
 
@@ -894,7 +894,7 @@ EXAMPLES
     $ codiac ai model list -e ben --silent
 ```
 
-_See code: [src/commands/ai/model/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/model/list.ts)_
+_See code: [src/commands/ai/model/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/model/list.ts)_
 
 ## `codiac ai model ls`
 
@@ -1018,7 +1018,7 @@ EXAMPLES
     $ codiac ai model uninstall -e ben -m qwen3-dev -c dev --silent
 ```
 
-_See code: [src/commands/ai/model/uninstall.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/model/uninstall.ts)_
+_See code: [src/commands/ai/model/uninstall.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/model/uninstall.ts)_
 
 ## `codiac ai model view`
 
@@ -1063,7 +1063,7 @@ EXAMPLES
     $ codiac ai model view -e ben -m qwen3-dev --silent
 ```
 
-_See code: [src/commands/ai/model/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/ai/model/view.ts)_
+_See code: [src/commands/ai/model/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/ai/model/view.ts)_
 
 ## `codiac asset create`
 
@@ -1184,7 +1184,7 @@ EXAMPLES
     $ codiac asset create -e myEnterprise -n redis --helm --chart redis --chart-repo bitnami --silent
 ```
 
-_See code: [src/commands/asset/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/create.ts)_
+_See code: [src/commands/asset/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/create.ts)_
 
 ## `codiac asset edit`
 
@@ -1274,7 +1274,7 @@ EXAMPLES
     $ codiac asset edit -e myEnterprise -n my-api --registry devCodiacContainers --silent
 ```
 
-_See code: [src/commands/asset/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/edit.ts)_
+_See code: [src/commands/asset/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/edit.ts)_
 
 ## `codiac asset entrypoint`
 
@@ -1395,7 +1395,7 @@ EXAMPLES
     $ codiac asset entrypoint delete -e ml -a my-worker -v '>=1.2.3' --silent
 ```
 
-_See code: [src/commands/asset/entrypoint/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/entrypoint/delete.ts)_
+_See code: [src/commands/asset/entrypoint/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/entrypoint/delete.ts)_
 
 ## `codiac asset entrypoint set`
 
@@ -1464,7 +1464,7 @@ EXAMPLES
       --input=/backup/workflows'
 ```
 
-_See code: [src/commands/asset/entrypoint/set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/entrypoint/set.ts)_
+_See code: [src/commands/asset/entrypoint/set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/entrypoint/set.ts)_
 
 ## `codiac asset get [CMD]`
 
@@ -1490,7 +1490,8 @@ FLAGS
   -a, --asset=<value>        The name of the asset to view.
   -c, --cabinet=<value>      The name of the cabinet from which the content is to be drawn.
   -e, --enterprise=<value>   The name of the enterprise containing the asset being viewed.
-  -f, --logsFollow           (requires type=logs) Follow (aka watch, tail, stream) the output.
+  -f, --logsFollow           (type=logs or type=events; also accepted as --follow) Keep streaming new output — log
+                             lines, or Kubernetes events as they happen — until interrupted (ctrl-c).
   -h, --help                 Show CLI help.
   -l, --logsTail=<value>     [default: 10] (type=logs or type=events) For type=logs: lines of recent logs to include
                              (enter -1 for the entire log history stored in the container). For type=events: number of
@@ -1518,6 +1519,35 @@ ALIASES
   $ codiac asset monitor
   $ codiac asset mon
   $ codiac asset get
+
+EXAMPLES
+  Pick the asset, cabinet and content type interactively.
+
+    $ codiac asset get
+
+  Live pod status monitor for an asset in a cabinet (interactive terminals; ctrl-c to quit).
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t status
+
+  The 25 most recent Kubernetes events for the asset (scheduling, image pulls, probe failures, restarts), then exit.
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t events -l 25
+
+  Show recent events, then keep streaming new ones as they happen (ctrl-c to quit). -f and --follow are the same flag.
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t events -f
+
+  Tail the logs of any one replica, following new lines.
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t logs -r any -f
+
+  Non-interactive events dump for scripts and CI (writes to stdout; fails instead of prompting).
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t events --silent
+
+  Run a one-off command inside a replica.
+
+    $ codiac asset get -e my-enterprise -a my-api -n prod -c orders -t exec -r any -- ls -la /app
 ```
 
 ## `codiac asset list`
@@ -1572,7 +1602,7 @@ EXAMPLES
     $ codiac asset list -e myEnterprise --to-script
 ```
 
-_See code: [src/commands/asset/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/list.ts)_
+_See code: [src/commands/asset/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/list.ts)_
 
 ## `codiac asset mon [CMD]`
 
@@ -1598,7 +1628,8 @@ FLAGS
   -a, --asset=<value>        The name of the asset to view.
   -c, --cabinet=<value>      The name of the cabinet from which the content is to be drawn.
   -e, --enterprise=<value>   The name of the enterprise containing the asset being viewed.
-  -f, --logsFollow           (requires type=logs) Follow (aka watch, tail, stream) the output.
+  -f, --logsFollow           (type=logs or type=events; also accepted as --follow) Keep streaming new output — log
+                             lines, or Kubernetes events as they happen — until interrupted (ctrl-c).
   -h, --help                 Show CLI help.
   -l, --logsTail=<value>     [default: 10] (type=logs or type=events) For type=logs: lines of recent logs to include
                              (enter -1 for the entire log history stored in the container). For type=events: number of
@@ -1626,6 +1657,35 @@ ALIASES
   $ codiac asset monitor
   $ codiac asset mon
   $ codiac asset get
+
+EXAMPLES
+  Pick the asset, cabinet and content type interactively.
+
+    $ codiac asset mon
+
+  Live pod status monitor for an asset in a cabinet (interactive terminals; ctrl-c to quit).
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t status
+
+  The 25 most recent Kubernetes events for the asset (scheduling, image pulls, probe failures, restarts), then exit.
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t events -l 25
+
+  Show recent events, then keep streaming new ones as they happen (ctrl-c to quit). -f and --follow are the same flag.
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t events -f
+
+  Tail the logs of any one replica, following new lines.
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t logs -r any -f
+
+  Non-interactive events dump for scripts and CI (writes to stdout; fails instead of prompting).
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t events --silent
+
+  Run a one-off command inside a replica.
+
+    $ codiac asset mon -e my-enterprise -a my-api -n prod -c orders -t exec -r any -- ls -la /app
 ```
 
 ## `codiac asset monitor [CMD]`
@@ -1652,7 +1712,8 @@ FLAGS
   -a, --asset=<value>        The name of the asset to view.
   -c, --cabinet=<value>      The name of the cabinet from which the content is to be drawn.
   -e, --enterprise=<value>   The name of the enterprise containing the asset being viewed.
-  -f, --logsFollow           (requires type=logs) Follow (aka watch, tail, stream) the output.
+  -f, --logsFollow           (type=logs or type=events; also accepted as --follow) Keep streaming new output — log
+                             lines, or Kubernetes events as they happen — until interrupted (ctrl-c).
   -h, --help                 Show CLI help.
   -l, --logsTail=<value>     [default: 10] (type=logs or type=events) For type=logs: lines of recent logs to include
                              (enter -1 for the entire log history stored in the container). For type=events: number of
@@ -1680,6 +1741,35 @@ ALIASES
   $ codiac asset monitor
   $ codiac asset mon
   $ codiac asset get
+
+EXAMPLES
+  Pick the asset, cabinet and content type interactively.
+
+    $ codiac asset monitor
+
+  Live pod status monitor for an asset in a cabinet (interactive terminals; ctrl-c to quit).
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t status
+
+  The 25 most recent Kubernetes events for the asset (scheduling, image pulls, probe failures, restarts), then exit.
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t events -l 25
+
+  Show recent events, then keep streaming new ones as they happen (ctrl-c to quit). -f and --follow are the same flag.
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t events -f
+
+  Tail the logs of any one replica, following new lines.
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t logs -r any -f
+
+  Non-interactive events dump for scripts and CI (writes to stdout; fails instead of prompting).
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t events --silent
+
+  Run a one-off command inside a replica.
+
+    $ codiac asset monitor -e my-enterprise -a my-api -n prod -c orders -t exec -r any -- ls -la /app
 ```
 
 ## `codiac asset new`
@@ -1833,7 +1923,7 @@ EXAMPLES
   $ codiac asset obliterate -e main -n my-api
 ```
 
-_See code: [src/commands/asset/obliterate.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/obliterate.ts)_
+_See code: [src/commands/asset/obliterate.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/obliterate.ts)_
 
 ## `codiac asset probe create [CMD]`
 
@@ -1926,7 +2016,7 @@ EXAMPLES
     $ codiac asset probe create -n acme -a myapi --predefined builtin-heartbeat-file-exists --to-script
 ```
 
-_See code: [src/commands/asset/probe/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/probe/create.ts)_
+_See code: [src/commands/asset/probe/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/probe/create.ts)_
 
 ## `codiac asset probe delete`
 
@@ -1981,7 +2071,7 @@ EXAMPLES
   $ codiac asset probe delete
 ```
 
-_See code: [src/commands/asset/probe/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/probe/delete.ts)_
+_See code: [src/commands/asset/probe/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/probe/delete.ts)_
 
 ## `codiac asset probe list`
 
@@ -2033,7 +2123,7 @@ EXAMPLES
   $ codiac asset probe list
 ```
 
-_See code: [src/commands/asset/probe/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/probe/list.ts)_
+_See code: [src/commands/asset/probe/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/probe/list.ts)_
 
 ## `codiac asset recycle`
 
@@ -2073,7 +2163,7 @@ DESCRIPTION
   Deploys a given asset to a given cabinet.  Defaults to current version.
 ```
 
-_See code: [src/commands/asset/recycle.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/recycle.ts)_
+_See code: [src/commands/asset/recycle.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/recycle.ts)_
 
 ## `codiac asset undeploy`
 
@@ -2117,7 +2207,7 @@ EXAMPLES
     $ codiac asset undeploy -e myEnterprise -a myApi -c dev --to-script
 ```
 
-_See code: [src/commands/asset/undeploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/undeploy.ts)_
+_See code: [src/commands/asset/undeploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/undeploy.ts)_
 
 ## `codiac asset view [CMD]`
 
@@ -2143,7 +2233,8 @@ FLAGS
   -a, --asset=<value>        The name of the asset to view.
   -c, --cabinet=<value>      The name of the cabinet from which the content is to be drawn.
   -e, --enterprise=<value>   The name of the enterprise containing the asset being viewed.
-  -f, --logsFollow           (requires type=logs) Follow (aka watch, tail, stream) the output.
+  -f, --logsFollow           (type=logs or type=events; also accepted as --follow) Keep streaming new output — log
+                             lines, or Kubernetes events as they happen — until interrupted (ctrl-c).
   -h, --help                 Show CLI help.
   -l, --logsTail=<value>     [default: 10] (type=logs or type=events) For type=logs: lines of recent logs to include
                              (enter -1 for the entire log history stored in the container). For type=events: number of
@@ -2171,9 +2262,38 @@ ALIASES
   $ codiac asset monitor
   $ codiac asset mon
   $ codiac asset get
+
+EXAMPLES
+  Pick the asset, cabinet and content type interactively.
+
+    $ codiac asset view
+
+  Live pod status monitor for an asset in a cabinet (interactive terminals; ctrl-c to quit).
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t status
+
+  The 25 most recent Kubernetes events for the asset (scheduling, image pulls, probe failures, restarts), then exit.
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t events -l 25
+
+  Show recent events, then keep streaming new ones as they happen (ctrl-c to quit). -f and --follow are the same flag.
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t events -f
+
+  Tail the logs of any one replica, following new lines.
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t logs -r any -f
+
+  Non-interactive events dump for scripts and CI (writes to stdout; fails instead of prompting).
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t events --silent
+
+  Run a one-off command inside a replica.
+
+    $ codiac asset view -e my-enterprise -a my-api -n prod -c orders -t exec -r any -- ls -la /app
 ```
 
-_See code: [src/commands/asset/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/view.ts)_
+_See code: [src/commands/asset/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/view.ts)_
 
 ## `codiac asset vol add [MOUNTPATH]`
 
@@ -2444,7 +2564,7 @@ ALIASES
   $ codiac asset volume add
 ```
 
-_See code: [src/commands/asset/volume/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/volume/create.ts)_
+_See code: [src/commands/asset/volume/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/volume/create.ts)_
 
 ## `codiac asset volume del`
 
@@ -2532,7 +2652,7 @@ EXAMPLES
     $ codiac asset volume delete -e myEnterprise -n myMount --to-script
 ```
 
-_See code: [src/commands/asset/volume/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/volume/delete.ts)_
+_See code: [src/commands/asset/volume/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/volume/delete.ts)_
 
 ## `codiac asset volume list`
 
@@ -2581,7 +2701,7 @@ EXAMPLES
     $ codiac asset volume list -e myEnterprise --silent
 ```
 
-_See code: [src/commands/asset/volume/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/volume/list.ts)_
+_See code: [src/commands/asset/volume/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/volume/list.ts)_
 
 ## `codiac asset volumes del`
 
@@ -2748,7 +2868,7 @@ EXAMPLES
   $ codiac asset where -e main -a my-api --silent
 ```
 
-_See code: [src/commands/asset/where.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/asset/where.ts)_
+_See code: [src/commands/asset/where.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/asset/where.ts)_
 
 ## `codiac auth cab allow`
 
@@ -2910,7 +3030,7 @@ EXAMPLES
   $ codiac auth cabinet allow -e qa -c shasta -r productmanager -p read
 ```
 
-_See code: [src/commands/auth/cabinet/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/cabinet/allow.ts)_
+_See code: [src/commands/auth/cabinet/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/cabinet/allow.ts)_
 
 ## `codiac auth cabinet allowed`
 
@@ -2958,7 +3078,7 @@ EXAMPLES
   $ codiac auth cabinet allowed --enterprise modeling -e qa -c sprint5
 ```
 
-_See code: [src/commands/auth/cabinet/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/cabinet/allowed.ts)_
+_See code: [src/commands/auth/cabinet/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/cabinet/allowed.ts)_
 
 ## `codiac auth ent allow`
 
@@ -3149,7 +3269,7 @@ EXAMPLES
   $ codiac auth enterprise allow -r deployer -p none
 ```
 
-_See code: [src/commands/auth/enterprise/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/enterprise/allow.ts)_
+_See code: [src/commands/auth/enterprise/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/enterprise/allow.ts)_
 
 ## `codiac auth enterprise allow onEnvironments`
 
@@ -3203,7 +3323,7 @@ EXAMPLES
   $ codiac auth enterprise allow onEnvironments --enterprise dyno -r productmanager -p read
 ```
 
-_See code: [src/commands/auth/enterprise/allow/onEnvironments.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/enterprise/allow/onEnvironments.ts)_
+_See code: [src/commands/auth/enterprise/allow/onEnvironments.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/enterprise/allow/onEnvironments.ts)_
 
 ## `codiac auth enterprise allowed`
 
@@ -3244,7 +3364,7 @@ EXAMPLES
   $ codiac auth enterprise allowed --enterprise modeling
 ```
 
-_See code: [src/commands/auth/enterprise/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/enterprise/allowed.ts)_
+_See code: [src/commands/auth/enterprise/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/enterprise/allowed.ts)_
 
 ## `codiac auth env allowed`
 
@@ -3451,7 +3571,7 @@ EXAMPLES
   $ codiac auth environment allow -e qa -r productmanager -p read
 ```
 
-_See code: [src/commands/auth/environment/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/environment/allow.ts)_
+_See code: [src/commands/auth/environment/allow.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/environment/allow.ts)_
 
 ## `codiac auth environment allow onCabinets`
 
@@ -3508,7 +3628,7 @@ EXAMPLES
   $ codiac auth environment allow onCabinets -e qa -r productmanager -p read
 ```
 
-_See code: [src/commands/auth/environment/allow/onCabinets.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/environment/allow/onCabinets.ts)_
+_See code: [src/commands/auth/environment/allow/onCabinets.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/environment/allow/onCabinets.ts)_
 
 ## `codiac auth environment allowed`
 
@@ -3553,7 +3673,7 @@ EXAMPLES
   $ codiac auth environment allowed --enterprise modeling -e dev
 ```
 
-_See code: [src/commands/auth/environment/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/environment/allowed.ts)_
+_See code: [src/commands/auth/environment/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/environment/allowed.ts)_
 
 ## `codiac auth register`
 
@@ -3599,7 +3719,7 @@ EXAMPLES
   $ codiac auth register
 ```
 
-_See code: [src/commands/auth/register.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/register.ts)_
+_See code: [src/commands/auth/register.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/register.ts)_
 
 ## `codiac auth role allowed [NAME]`
 
@@ -3646,7 +3766,7 @@ EXAMPLES
   $ codiac auth role allowed -n deployer -e main
 ```
 
-_See code: [src/commands/auth/role/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/allowed.ts)_
+_See code: [src/commands/auth/role/allowed.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/allowed.ts)_
 
 ## `codiac auth role assign`
 
@@ -3678,7 +3798,7 @@ EXAMPLES
   $ codiac auth role assign -r deployer -u joe.cool@yourdomain.com
 ```
 
-_See code: [src/commands/auth/role/assign.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/assign.ts)_
+_See code: [src/commands/auth/role/assign.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/assign.ts)_
 
 ## `codiac auth role create [NAME]`
 
@@ -3711,7 +3831,7 @@ EXAMPLES
   $ codiac auth role create -n deployer
 ```
 
-_See code: [src/commands/auth/role/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/create.ts)_
+_See code: [src/commands/auth/role/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/create.ts)_
 
 ## `codiac auth role delete [NAME]`
 
@@ -3747,7 +3867,7 @@ EXAMPLES
   $ codiac auth role delete --id abc123def456
 ```
 
-_See code: [src/commands/auth/role/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/delete.ts)_
+_See code: [src/commands/auth/role/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/delete.ts)_
 
 ## `codiac auth role list`
 
@@ -3783,7 +3903,7 @@ EXAMPLES
   $ codiac auth role list -o yaml > roles.yaml
 ```
 
-_See code: [src/commands/auth/role/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/list.ts)_
+_See code: [src/commands/auth/role/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/list.ts)_
 
 ## `codiac auth role unassign`
 
@@ -3815,7 +3935,7 @@ EXAMPLES
   $ codiac auth role unassign -r deployer -u joe.cool@yourdomain.com
 ```
 
-_See code: [src/commands/auth/role/unassign.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/role/unassign.ts)_
+_See code: [src/commands/auth/role/unassign.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/role/unassign.ts)_
 
 ## `codiac auth user invite`
 
@@ -3855,7 +3975,7 @@ EXAMPLES
   $ codiac auth user invite
 ```
 
-_See code: [src/commands/auth/user/invite.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/user/invite.ts)_
+_See code: [src/commands/auth/user/invite.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/user/invite.ts)_
 
 ## `codiac auth user list`
 
@@ -3891,7 +4011,7 @@ EXAMPLES
   $ codiac auth user list -o yaml > users.yaml
 ```
 
-_See code: [src/commands/auth/user/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/auth/user/list.ts)_
+_See code: [src/commands/auth/user/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/auth/user/list.ts)_
 
 ## `codiac autocomplete [SHELL]`
 
@@ -3941,7 +4061,7 @@ DESCRIPTION
   Creates a new branch for the parent project and any sourced dependencies.
 ```
 
-_See code: [src/commands/branch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/branch.ts)_
+_See code: [src/commands/branch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/branch.ts)_
 
 ## `codiac branch current`
 
@@ -3961,7 +4081,7 @@ ALIASES
   $ codiac branches current
 ```
 
-_See code: [src/commands/branch/current.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/branch/current.ts)_
+_See code: [src/commands/branch/current.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/branch/current.ts)_
 
 ## `codiac branch list`
 
@@ -3983,7 +4103,7 @@ ALIASES
   $ codiac branches list
 ```
 
-_See code: [src/commands/branch/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/branch/list.ts)_
+_See code: [src/commands/branch/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/branch/list.ts)_
 
 ## `codiac branches current`
 
@@ -4073,7 +4193,7 @@ DESCRIPTION
   Builds the project and the docker container
 ```
 
-_See code: [src/commands/build.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/build.ts)_
+_See code: [src/commands/build.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/build.ts)_
 
 ## `codiac cab attach`
 
@@ -4822,7 +4942,7 @@ EXAMPLES
       prod-cluster-1 --to-script
 ```
 
-_See code: [src/commands/cabinet/cluster/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/cluster/attach.ts)_
+_See code: [src/commands/cabinet/cluster/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/cluster/attach.ts)_
 
 ## `codiac cabinet contents`
 
@@ -4866,7 +4986,7 @@ EXAMPLES
     $ codiac cabinet contents -e main -c my-spike --to-script > show-contents.sh
 ```
 
-_See code: [src/commands/cabinet/contents.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/contents.ts)_
+_See code: [src/commands/cabinet/contents.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/contents.ts)_
 
 ## `codiac cabinet create [CABINET]`
 
@@ -4933,7 +5053,7 @@ EXAMPLES
     cod cabinet create my-cab-name --enterprise main -e dev-environemt -c my-cluster --silent
 ```
 
-_See code: [src/commands/cabinet/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/create.ts)_
+_See code: [src/commands/cabinet/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/create.ts)_
 
 ## `codiac cabinet define [CABINET]`
 
@@ -4995,7 +5115,7 @@ EXAMPLES
     $ codiac cabinet define my-cab --enterprise main --environment dev-environment --cluster my-cluster --silent
 ```
 
-_See code: [src/commands/cabinet/define.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/define.ts)_
+_See code: [src/commands/cabinet/define.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/define.ts)_
 
 ## `codiac cabinet destroy [CABINET]`
 
@@ -5053,7 +5173,7 @@ EXAMPLES
       --environment dev --silent
 ```
 
-_See code: [src/commands/cabinet/destroy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/destroy.ts)_
+_See code: [src/commands/cabinet/destroy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/destroy.ts)_
 
 ## `codiac cabinet detach [CABINET]`
 
@@ -5110,7 +5230,7 @@ EXAMPLES
       main --environment dev
 ```
 
-_See code: [src/commands/cabinet/detach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/detach.ts)_
+_See code: [src/commands/cabinet/detach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/detach.ts)_
 
 ## `codiac cabinet forget [CABINET]`
 
@@ -5165,7 +5285,7 @@ EXAMPLES
     $ codiac cabinet forget --to-script
 ```
 
-_See code: [src/commands/cabinet/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/forget.ts)_
+_See code: [src/commands/cabinet/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/forget.ts)_
 
 ## `codiac cabinet list`
 
@@ -5216,7 +5336,7 @@ EXAMPLES
     $ codiac cabinet list -e myEnterprise --silent
 ```
 
-_See code: [src/commands/cabinet/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/list.ts)_
+_See code: [src/commands/cabinet/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/list.ts)_
 
 ## `codiac cabinet obliterate [CABINET]`
 
@@ -5258,7 +5378,7 @@ ALIASES
   $ codiac infrx cab obliterate
 ```
 
-_See code: [src/commands/cabinet/obliterate.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/obliterate.ts)_
+_See code: [src/commands/cabinet/obliterate.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/obliterate.ts)_
 
 ## `codiac cabinet restore`
 
@@ -5325,7 +5445,7 @@ EXAMPLES
     $ codiac cabinet restore --cluster prod-cluster-1 --to-script
 ```
 
-_See code: [src/commands/cabinet/restore.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cabinet/restore.ts)_
+_See code: [src/commands/cabinet/restore.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cabinet/restore.ts)_
 
 ## `codiac cfg add`
 
@@ -5363,9 +5483,9 @@ FLAGS
 
   -t, --type=<option>
       Filters for the settings types that do not land in a config file (such as... env: OS environment variables,
-      footprint: container footprint specs, helm: helm chart settings, label: container meta labels, annotation: container
-      platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations applied to the deployment/service/ingress — see
-      examples).
+      footprint: container footprint specs (replicas, cpu/memory, scaling.*, rollout.*), helm: helm chart settings, label:
+      container meta labels, annotation: container platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations
+      applied to the deployment/service/ingress — see examples).
       <options: annotation|env|footprint|filestore|helm|k8spatch|label|namespace|onpostdeploy|onpredeploy|permit|probing>
 
   --condition=<value>
@@ -5460,7 +5580,8 @@ EXAMPLES
       "mywebsite.com")}'
 
   Sibling @{$hostmap_path(...)} returns the path component for path-form strategies (cab_dot_domain_slash_service,
-  domain_slash_service). Returns empty string for host-only strategies.
+  domain_slash_service). Returns empty string for host-only strategies (eg svc_dot_cab_dot_domain,
+  svc_dash_env_dot_domain).
 
     cod config set -a my-asset -c dev -t helm --setting ingress.path --value \
       '@{$hostmap_path("cab_dot_domain_slash_service", "my-company.com")}'
@@ -5477,6 +5598,31 @@ EXAMPLES
     cod config set -a my-asset -e prod -t helm --setting 'statefulSet.patch[1].value.env[5].value' --value 'false' \
       --value-type string
 
+  Rollout — zero-downtime deploys: never take an old pod down until its replacement is Ready (Codiac then surges one
+  extra pod at a time, ie maxSurge 1, unless you set maxSurge). Pair it with a readiness probe (`cod asset probe
+  create`) — without one, "Ready" only means "started". With no rollout settings, Codiac keeps its historical
+  behavior: replace everything at once (maxUnavailable/maxSurge 100%).
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxUnavailable --value 0
+
+  Rollout — faster zero-downtime: alongside maxUnavailable 0, surge up to a quarter extra pods at a time (integer or
+  0%-100%). Set every rollout.* field at the SAME scope: a rollout set on a cabinet replaces one set on its
+  environment entirely, and a field left unset falls back to 100%.
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxSurge --value 25%
+
+  Rollout — Recreate for singletons that must never run twice (a lock-holding queue consumer, a single-writer
+  database): stop the old pod, then start the new one. Expect a brief gap; maxUnavailable/maxSurge are rejected with
+  Recreate.
+
+    cod config set -a my-worker -c orders -t footprint --setting rollout.strategy --value Recreate
+
+  Rollout — zero-downtime for every cabinet in an environment, scripted, then deploy and watch the new pods become
+  Ready.
+
+    cod config set -a my-asset -e prod -t footprint --setting rollout.maxUnavailable --value 0 --silent && cod asset \
+      deploy -a my-asset -u 1.4.2 -c orders --follow --silent
+
   Apply a raw Kubernetes patch with `-t k8spatch`. The value is a JSON-Patch (RFC-6902) ARRAY of {op, path, value}
   operations targeting `deployment`, `service`, or `ingress` — it is NOT a partial manifest, so a top-level
   `spec.template...` shape is silently ignored. Always pass `--value-type string` so the JSON array is stored verbatim
@@ -5647,7 +5793,7 @@ DESCRIPTION
   Applies settings to the Codiac CLI itself (scoped to the local machine).
 ```
 
-_See code: [src/commands/cli.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cli.ts)_
+_See code: [src/commands/cli.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cli.ts)_
 
 ## `codiac cluster agent configure [CLUSTER]`
 
@@ -5715,7 +5861,7 @@ EXAMPLES
     $ codiac cluster agent configure my-cluster --to-script
 ```
 
-_See code: [src/commands/cluster/agent/configure.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/agent/configure.ts)_
+_See code: [src/commands/cluster/agent/configure.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/agent/configure.ts)_
 
 ## `codiac cluster agent install [CLUSTER]`
 
@@ -5771,7 +5917,7 @@ EXAMPLES
     $ codiac cluster agent install my-cluster --to-script
 ```
 
-_See code: [src/commands/cluster/agent/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/agent/install.ts)_
+_See code: [src/commands/cluster/agent/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/agent/install.ts)_
 
 ## `codiac cluster agent uninstall [CLUSTER]`
 
@@ -5819,7 +5965,7 @@ EXAMPLES
     $ codiac cluster agent uninstall my-cluster --to-script
 ```
 
-_See code: [src/commands/cluster/agent/uninstall.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/agent/uninstall.ts)_
+_See code: [src/commands/cluster/agent/uninstall.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/agent/uninstall.ts)_
 
 ## `codiac cluster bootstrap [NAME]`
 
@@ -5882,7 +6028,7 @@ EXAMPLES
     $ codiac cluster bootstrap my-cluster --to-script
 ```
 
-_See code: [src/commands/cluster/bootstrap.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/bootstrap.ts)_
+_See code: [src/commands/cluster/bootstrap.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/bootstrap.ts)_
 
 ## `codiac cluster capture`
 
@@ -5967,7 +6113,7 @@ EXAMPLES
   $ codiac cluster connect my-fav-cluster
 ```
 
-_See code: [src/commands/cluster/connect.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/connect.ts)_
+_See code: [src/commands/cluster/connect.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/connect.ts)_
 
 ## `codiac cluster contents`
 
@@ -6685,7 +6831,7 @@ EXAMPLES
     $ codiac cluster install my-cluster -a my-chart -u 1.2.3 --silent
 ```
 
-_See code: [src/commands/cluster/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/install.ts)_
+_See code: [src/commands/cluster/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/install.ts)_
 
 ## `codiac cluster journal [CLUSTER]`
 
@@ -6974,7 +7120,7 @@ EXAMPLES
   $ codiac cluster stack capture my-fav-cluster
 ```
 
-_See code: [src/commands/cluster/stack/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/stack/capture.ts)_
+_See code: [src/commands/cluster/stack/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/stack/capture.ts)_
 
 ## `codiac cluster stack install [CLUSTER]`
 
@@ -7026,7 +7172,7 @@ EXAMPLES
     $ codiac cluster stack install my-cluster --to-script
 ```
 
-_See code: [src/commands/cluster/stack/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/stack/install.ts)_
+_See code: [src/commands/cluster/stack/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/stack/install.ts)_
 
 ## `codiac cluster stack list`
 
@@ -7192,7 +7338,7 @@ EXAMPLES
   $ codiac cluster start my-fav-cluster
 ```
 
-_See code: [src/commands/cluster/start.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/start.ts)_
+_See code: [src/commands/cluster/start.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/start.ts)_
 
 ## `codiac cluster stop [CLUSTER]`
 
@@ -7229,7 +7375,7 @@ EXAMPLES
   $ codiac cluster start my-fav-cluster
 ```
 
-_See code: [src/commands/cluster/stop.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/cluster/stop.ts)_
+_See code: [src/commands/cluster/stop.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/cluster/stop.ts)_
 
 ## `codiac cluster uninstall`
 
@@ -7291,7 +7437,7 @@ DESCRIPTION
   Commits the currently staged changes on the current branch of the main project and on any sourced dependencies.
 ```
 
-_See code: [src/commands/commit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/commit.ts)_
+_See code: [src/commands/commit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/commit.ts)_
 
 ## `codiac config add`
 
@@ -7329,9 +7475,9 @@ FLAGS
 
   -t, --type=<option>
       Filters for the settings types that do not land in a config file (such as... env: OS environment variables,
-      footprint: container footprint specs, helm: helm chart settings, label: container meta labels, annotation: container
-      platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations applied to the deployment/service/ingress — see
-      examples).
+      footprint: container footprint specs (replicas, cpu/memory, scaling.*, rollout.*), helm: helm chart settings, label:
+      container meta labels, annotation: container platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations
+      applied to the deployment/service/ingress — see examples).
       <options: annotation|env|footprint|filestore|helm|k8spatch|label|namespace|onpostdeploy|onpredeploy|permit|probing>
 
   --condition=<value>
@@ -7426,7 +7572,8 @@ EXAMPLES
       "mywebsite.com")}'
 
   Sibling @{$hostmap_path(...)} returns the path component for path-form strategies (cab_dot_domain_slash_service,
-  domain_slash_service). Returns empty string for host-only strategies.
+  domain_slash_service). Returns empty string for host-only strategies (eg svc_dot_cab_dot_domain,
+  svc_dash_env_dot_domain).
 
     cod config set -a my-asset -c dev -t helm --setting ingress.path --value \
       '@{$hostmap_path("cab_dot_domain_slash_service", "my-company.com")}'
@@ -7443,6 +7590,31 @@ EXAMPLES
     cod config set -a my-asset -e prod -t helm --setting 'statefulSet.patch[1].value.env[5].value' --value 'false' \
       --value-type string
 
+  Rollout — zero-downtime deploys: never take an old pod down until its replacement is Ready (Codiac then surges one
+  extra pod at a time, ie maxSurge 1, unless you set maxSurge). Pair it with a readiness probe (`cod asset probe
+  create`) — without one, "Ready" only means "started". With no rollout settings, Codiac keeps its historical
+  behavior: replace everything at once (maxUnavailable/maxSurge 100%).
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxUnavailable --value 0
+
+  Rollout — faster zero-downtime: alongside maxUnavailable 0, surge up to a quarter extra pods at a time (integer or
+  0%-100%). Set every rollout.* field at the SAME scope: a rollout set on a cabinet replaces one set on its
+  environment entirely, and a field left unset falls back to 100%.
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxSurge --value 25%
+
+  Rollout — Recreate for singletons that must never run twice (a lock-holding queue consumer, a single-writer
+  database): stop the old pod, then start the new one. Expect a brief gap; maxUnavailable/maxSurge are rejected with
+  Recreate.
+
+    cod config set -a my-worker -c orders -t footprint --setting rollout.strategy --value Recreate
+
+  Rollout — zero-downtime for every cabinet in an environment, scripted, then deploy and watch the new pods become
+  Ready.
+
+    cod config set -a my-asset -e prod -t footprint --setting rollout.maxUnavailable --value 0 --silent && cod asset \
+      deploy -a my-asset -u 1.4.2 -c orders --follow --silent
+
   Apply a raw Kubernetes patch with `-t k8spatch`. The value is a JSON-Patch (RFC-6902) ARRAY of {op, path, value}
   operations targeting `deployment`, `service`, or `ingress` — it is NOT a partial manifest, so a top-level
   `spec.template...` shape is silently ignored. Always pass `--value-type string` so the JSON array is stored verbatim
@@ -7466,7 +7638,7 @@ EXAMPLES
       '[{"op":"replace","path":"/spec/replicas","value":2}]' --value-type string
 ```
 
-_See code: [src/commands/config/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/add.ts)_
+_See code: [src/commands/config/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/add.ts)_
 
 ## `codiac config delete [SETTING]`
 
@@ -7535,7 +7707,7 @@ ALIASES
   $ codiac cfg delete
 ```
 
-_See code: [src/commands/config/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/delete.ts)_
+_See code: [src/commands/config/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/delete.ts)_
 
 ## `codiac config deploy`
 
@@ -7576,7 +7748,7 @@ EXAMPLES
     $ codiac config deploy -e myEnterprise -a myApi -c dev --to-script
 ```
 
-_See code: [src/commands/config/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/deploy.ts)_
+_See code: [src/commands/config/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/deploy.ts)_
 
 ## `codiac config import`
 
@@ -7654,7 +7826,7 @@ EXAMPLES
     $ codiac config import -a my-asset -s ./helm-values.yaml -c dev --escape-expressions
 ```
 
-_See code: [src/commands/config/import.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/import.ts)_
+_See code: [src/commands/config/import.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/import.ts)_
 
 ## `codiac config preview [SETTING]`
 
@@ -7755,9 +7927,9 @@ FLAGS
 
   -t, --type=<option>
       Filters for the settings types that do not land in a config file (such as... env: OS environment variables,
-      footprint: container footprint specs, helm: helm chart settings, label: container meta labels, annotation: container
-      platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations applied to the deployment/service/ingress — see
-      examples).
+      footprint: container footprint specs (replicas, cpu/memory, scaling.*, rollout.*), helm: helm chart settings, label:
+      container meta labels, annotation: container platform key-value pairs, k8spatch: JSON-Patch (RFC-6902) operations
+      applied to the deployment/service/ingress — see examples).
       <options: annotation|env|footprint|filestore|helm|k8spatch|label|namespace|onpostdeploy|onpredeploy|permit|probing>
 
   --condition=<value>
@@ -7852,7 +8024,8 @@ EXAMPLES
       "mywebsite.com")}'
 
   Sibling @{$hostmap_path(...)} returns the path component for path-form strategies (cab_dot_domain_slash_service,
-  domain_slash_service). Returns empty string for host-only strategies.
+  domain_slash_service). Returns empty string for host-only strategies (eg svc_dot_cab_dot_domain,
+  svc_dash_env_dot_domain).
 
     cod config set -a my-asset -c dev -t helm --setting ingress.path --value \
       '@{$hostmap_path("cab_dot_domain_slash_service", "my-company.com")}'
@@ -7869,6 +8042,31 @@ EXAMPLES
     cod config set -a my-asset -e prod -t helm --setting 'statefulSet.patch[1].value.env[5].value' --value 'false' \
       --value-type string
 
+  Rollout — zero-downtime deploys: never take an old pod down until its replacement is Ready (Codiac then surges one
+  extra pod at a time, ie maxSurge 1, unless you set maxSurge). Pair it with a readiness probe (`cod asset probe
+  create`) — without one, "Ready" only means "started". With no rollout settings, Codiac keeps its historical
+  behavior: replace everything at once (maxUnavailable/maxSurge 100%).
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxUnavailable --value 0
+
+  Rollout — faster zero-downtime: alongside maxUnavailable 0, surge up to a quarter extra pods at a time (integer or
+  0%-100%). Set every rollout.* field at the SAME scope: a rollout set on a cabinet replaces one set on its
+  environment entirely, and a field left unset falls back to 100%.
+
+    cod config set -a my-asset -c orders -t footprint --setting rollout.maxSurge --value 25%
+
+  Rollout — Recreate for singletons that must never run twice (a lock-holding queue consumer, a single-writer
+  database): stop the old pod, then start the new one. Expect a brief gap; maxUnavailable/maxSurge are rejected with
+  Recreate.
+
+    cod config set -a my-worker -c orders -t footprint --setting rollout.strategy --value Recreate
+
+  Rollout — zero-downtime for every cabinet in an environment, scripted, then deploy and watch the new pods become
+  Ready.
+
+    cod config set -a my-asset -e prod -t footprint --setting rollout.maxUnavailable --value 0 --silent && cod asset \
+      deploy -a my-asset -u 1.4.2 -c orders --follow --silent
+
   Apply a raw Kubernetes patch with `-t k8spatch`. The value is a JSON-Patch (RFC-6902) ARRAY of {op, path, value}
   operations targeting `deployment`, `service`, or `ingress` — it is NOT a partial manifest, so a top-level
   `spec.template...` shape is silently ignored. Always pass `--value-type string` so the JSON array is stored verbatim
@@ -7960,7 +8158,7 @@ DESCRIPTION
   Shows the list of clusters.
 ```
 
-_See code: [src/commands/config/settings/get.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/settings/get.ts)_
+_See code: [src/commands/config/settings/get.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/settings/get.ts)_
 
 ## `codiac config view [SETTING]`
 
@@ -8025,7 +8223,7 @@ EXAMPLES
     $ codiac config view -e myEnterprise -a myApi -c dev --to-script
 ```
 
-_See code: [src/commands/config/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/config/view.ts)_
+_See code: [src/commands/config/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/config/view.ts)_
 
 ## `codiac csp creds list`
 
@@ -8073,7 +8271,7 @@ EXAMPLES
   $ codiac csp creds list
 ```
 
-_See code: [src/commands/csp/creds/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/csp/creds/list.ts)_
+_See code: [src/commands/csp/creds/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/csp/creds/list.ts)_
 
 ## `codiac csp login [PROVIDER]`
 
@@ -8151,7 +8349,7 @@ EXAMPLES
   cod csp login -u ASIAZ3XYZPDQ123 -p $(cat my-aws-secret-key.txt) --aws-session-token $(cat my-aws-sesh.txt) aws
 ```
 
-_See code: [src/commands/csp/login.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/csp/login.ts)_
+_See code: [src/commands/csp/login.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/csp/login.ts)_
 
 ## `codiac csp logout [PROVIDER]`
 
@@ -8198,7 +8396,7 @@ EXAMPLES
     $ codiac csp logout azure --to-script
 ```
 
-_See code: [src/commands/csp/logout.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/csp/logout.ts)_
+_See code: [src/commands/csp/logout.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/csp/logout.ts)_
 
 ## `codiac dep [NAME]`
 
@@ -8219,7 +8417,7 @@ DESCRIPTION
   Installs a package into current project.
 ```
 
-_See code: [src/commands/dep.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep.ts)_
+_See code: [src/commands/dep.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep.ts)_
 
 ## `codiac dep create [URL]`
 
@@ -8243,7 +8441,7 @@ DESCRIPTION
   package version is used.
 ```
 
-_See code: [src/commands/dep/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/create.ts)_
+_See code: [src/commands/dep/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/create.ts)_
 
 ## `codiac dep install`
 
@@ -8260,7 +8458,7 @@ DESCRIPTION
   installs any missing dependency packages into the local project folder.
 ```
 
-_See code: [src/commands/dep/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/install.ts)_
+_See code: [src/commands/dep/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/install.ts)_
 
 ## `codiac dep list`
 
@@ -8277,7 +8475,7 @@ DESCRIPTION
   Shows the dependencies for the project.
 ```
 
-_See code: [src/commands/dep/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/list.ts)_
+_See code: [src/commands/dep/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/list.ts)_
 
 ## `codiac dep remove [NAME]`
 
@@ -8300,7 +8498,7 @@ DESCRIPTION
   Removes a dependency from the project.
 ```
 
-_See code: [src/commands/dep/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/remove.ts)_
+_See code: [src/commands/dep/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/remove.ts)_
 
 ## `codiac dep source [NAME]`
 
@@ -8326,7 +8524,7 @@ ALIASES
   $ codiac dep src
 ```
 
-_See code: [src/commands/dep/source.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/source.ts)_
+_See code: [src/commands/dep/source.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/source.ts)_
 
 ## `codiac dep src [NAME]`
 
@@ -8370,7 +8568,7 @@ DESCRIPTION
   Publishes the dependency in its current state and upgrades to it in the main project.
 ```
 
-_See code: [src/commands/dep/syncup.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/syncup.ts)_
+_See code: [src/commands/dep/syncup.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/syncup.ts)_
 
 ## `codiac dep unsource [NAME]`
 
@@ -8398,7 +8596,7 @@ ALIASES
   $ codiac dep unsrc
 ```
 
-_See code: [src/commands/dep/unsource.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/unsource.ts)_
+_See code: [src/commands/dep/unsource.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/unsource.ts)_
 
 ## `codiac dep unsrc [NAME]`
 
@@ -8445,7 +8643,7 @@ DESCRIPTION
   describe the command here
 ```
 
-_See code: [src/commands/dep/upgrade.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/dep/upgrade.ts)_
+_See code: [src/commands/dep/upgrade.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/dep/upgrade.ts)_
 
 ## `codiac deploy`
 
@@ -8498,7 +8696,7 @@ EXAMPLES
     $ codiac deploy -e myEnterprise -a myApi -u 1.2.3 -c dev --to-script
 ```
 
-_See code: [src/commands/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/deploy.ts)_
+_See code: [src/commands/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/deploy.ts)_
 
 ## `codiac domain map [DOMAIN]`
 
@@ -8524,7 +8722,15 @@ FLAGS
       Show CLI help.
 
   -n, --naming=<value>
-      The host naming strategy to apply.
+      How each service's hostname (and path) is built from the domain; prompted when omitted. Host-form strategies give
+      every service its own host, served at `/`: svc_dash_env_dot_domain = <service>-<env>.<domain> (one DNS label, so one
+      wildcard DNS record and *.<domain> cert cover every service in every environment), svc_dot_cab_dot_domain =
+      <service>.<cabinet>.<domain>, service_dot_domain = <service>.<domain>. Path-form strategies share one host and route
+      by /<service> (see --strip-path): domain_slash_service = <domain>/<service>, cab_dot_domain_slash_service =
+      <cabinet>.<domain>/<service>, cab_dot_cluster_dot_domain_slash_service = <cabinet>.<cluster>.<domain>/<service>,
+      cab_dot_cluster_dot_enterprise_dot_domain_slash_service = <cabinet>.<cluster>.<enterprise>.<domain>/<service>,
+      globally_shared_domain_slash_service = for a domain shared across tenants and clusters. shared_ingress_ip =
+      <ingress-ip>/<tenant>/<enterprise>/<cabinet>/<service>, no domain needed.
 
   -v, --environment=<value>
       The name of the environment on which to apply this naming strategy. Must be qualified by also setting enterprise if
@@ -8592,6 +8798,13 @@ EXAMPLES
 
     $ codiac domain map dev.my-company.com -e myEnterprise -v dev -n domain_slash_service --echo
 
+  One host per service per environment, served at `/` (Swagger, redirects and self-links work unchanged): the `orders`
+  service in `staging` becomes `orders-staging.internal.my-company.com`. A single wildcard DNS record and wildcard
+  cert (*.internal.my-company.com) cover all services in all environments, so a new environment needs only its own
+  host map.
+
+    $ codiac domain map internal.my-company.com -e main -v staging -n svc_dash_env_dot_domain --silent
+
   Consume a mapping from a helm chart's own ingress spec: after mapping the domain here, reference it from any scoped
   setting via the ${hostmap(strategy, domain)} dynamic variable. See `cod config set --help` for setting-side
   examples.
@@ -8701,7 +8914,7 @@ EXAMPLES
     cod enterprise create my-enterprise-code --silent
 ```
 
-_See code: [src/commands/enterprise/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/enterprise/create.ts)_
+_See code: [src/commands/enterprise/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/enterprise/create.ts)_
 
 ## `codiac enterprise list`
 
@@ -8756,7 +8969,7 @@ EXAMPLES
     $ codiac enterprise list --to-script
 ```
 
-_See code: [src/commands/enterprise/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/enterprise/list.ts)_
+_See code: [src/commands/enterprise/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/enterprise/list.ts)_
 
 ## `codiac env add [SETTING]`
 
@@ -8806,7 +9019,7 @@ EXAMPLES
     $ codiac env add -s MY_VAR -v myValue -n myEnterprise --to-script
 ```
 
-_See code: [src/commands/env/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/env/add.ts)_
+_See code: [src/commands/env/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/env/add.ts)_
 
 ## `codiac enviro cluster attach`
 
@@ -9109,7 +9322,7 @@ ALIASES
   $ codiac infrx enviro cluster attach
 ```
 
-_See code: [src/commands/environment/cluster/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/environment/cluster/attach.ts)_
+_See code: [src/commands/environment/cluster/attach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/environment/cluster/attach.ts)_
 
 ## `codiac environment cluster detach`
 
@@ -9155,7 +9368,7 @@ ALIASES
   $ codiac infrx enviro cluster detach
 ```
 
-_See code: [src/commands/environment/cluster/detach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/environment/cluster/detach.ts)_
+_See code: [src/commands/environment/cluster/detach.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/environment/cluster/detach.ts)_
 
 ## `codiac environment create [NAME]`
 
@@ -9218,7 +9431,7 @@ EXAMPLES
     cod environment create dev --enterprise main --cluster my-cluster-1 --cluster my-cluster-2 --silent
 ```
 
-_See code: [src/commands/environment/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/environment/create.ts)_
+_See code: [src/commands/environment/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/environment/create.ts)_
 
 ## `codiac environment delete [NAME]`
 
@@ -9279,7 +9492,7 @@ EXAMPLES
     $ codiac environment delete dev --enterprise main --to-script
 ```
 
-_See code: [src/commands/environment/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/environment/delete.ts)_
+_See code: [src/commands/environment/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/environment/delete.ts)_
 
 ## `codiac environment list`
 
@@ -9330,7 +9543,7 @@ EXAMPLES
     $ codiac environment list -e myEnterprise --silent
 ```
 
-_See code: [src/commands/environment/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/environment/list.ts)_
+_See code: [src/commands/environment/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/environment/list.ts)_
 
 ## `codiac fileshare capture`
 
@@ -9414,7 +9627,7 @@ ALIASES
   $ codiac fileshare capture
 ```
 
-_See code: [src/commands/filestore/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/filestore/capture.ts)_
+_See code: [src/commands/filestore/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/filestore/capture.ts)_
 
 ## `codiac filestore forget`
 
@@ -9461,7 +9674,7 @@ EXAMPLES
   $ codiac filestore forget
 ```
 
-_See code: [src/commands/filestore/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/filestore/forget.ts)_
+_See code: [src/commands/filestore/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/filestore/forget.ts)_
 
 ## `codiac filestore list`
 
@@ -9507,7 +9720,7 @@ EXAMPLES
   $ codiac filestore list
 ```
 
-_See code: [src/commands/filestore/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/filestore/list.ts)_
+_See code: [src/commands/filestore/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/filestore/list.ts)_
 
 ## `codiac help [COMMANDS]`
 
@@ -9537,8 +9750,9 @@ Removes a host naming strategy mapping.  ie: UN-maps a domain strategy that was
 USAGE
   $ codiac host delete [-e <value>] [-d <value> | --id <value>] [-n
     cab_dot_cluster_dot_domain_slash_service|cab_dot_cluster_dot_enterprise_dot_domain_slash_service|cab_dot_domain_slas
-    h_service|domain_slash_service|globally_shared_domain_slash_service|service_dot_domain|shared_ingress_ip|svc_dot_cab
-    _dot_domain | ] [-s |  | -v <value> | -c <value>] [--take-defaults | [--silent | --echo | --to-script]]
+    h_service|domain_slash_service|globally_shared_domain_slash_service|service_dot_domain|shared_ingress_ip|svc_dash_en
+    v_dot_domain|svc_dot_cab_dot_domain | ] [-s |  | -v <value> | -c <value>] [--take-defaults | [--silent | --echo |
+    --to-script]]
 
 FLAGS
   -c, --cabinet=<value>
@@ -9557,7 +9771,7 @@ FLAGS
       The host naming strategy to apply.
       <options: cab_dot_cluster_dot_domain_slash_service|cab_dot_cluster_dot_enterprise_dot_domain_slash_service|cab_dot_d
       omain_slash_service|domain_slash_service|globally_shared_domain_slash_service|service_dot_domain|shared_ingress_ip|s
-      vc_dot_cab_dot_domain>
+      vc_dash_env_dot_domain|svc_dot_cab_dot_domain>
 
   -s, --enterprise-scope
       Applies the naming strategy at the enterprise level.
@@ -9593,7 +9807,7 @@ EXAMPLES
   $ codiac host delete
 ```
 
-_See code: [src/commands/host/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/host/delete.ts)_
+_See code: [src/commands/host/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/host/delete.ts)_
 
 ## `codiac host list [DOMAIN]`
 
@@ -9637,7 +9851,7 @@ EXAMPLES
   $ codiac host list
 ```
 
-_See code: [src/commands/host/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/host/list.ts)_
+_See code: [src/commands/host/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/host/list.ts)_
 
 ## `codiac host map [DOMAIN]`
 
@@ -9663,7 +9877,15 @@ FLAGS
       Show CLI help.
 
   -n, --naming=<value>
-      The host naming strategy to apply.
+      How each service's hostname (and path) is built from the domain; prompted when omitted. Host-form strategies give
+      every service its own host, served at `/`: svc_dash_env_dot_domain = <service>-<env>.<domain> (one DNS label, so one
+      wildcard DNS record and *.<domain> cert cover every service in every environment), svc_dot_cab_dot_domain =
+      <service>.<cabinet>.<domain>, service_dot_domain = <service>.<domain>. Path-form strategies share one host and route
+      by /<service> (see --strip-path): domain_slash_service = <domain>/<service>, cab_dot_domain_slash_service =
+      <cabinet>.<domain>/<service>, cab_dot_cluster_dot_domain_slash_service = <cabinet>.<cluster>.<domain>/<service>,
+      cab_dot_cluster_dot_enterprise_dot_domain_slash_service = <cabinet>.<cluster>.<enterprise>.<domain>/<service>,
+      globally_shared_domain_slash_service = for a domain shared across tenants and clusters. shared_ingress_ip =
+      <ingress-ip>/<tenant>/<enterprise>/<cabinet>/<service>, no domain needed.
 
   -v, --environment=<value>
       The name of the environment on which to apply this naming strategy. Must be qualified by also setting enterprise if
@@ -9731,6 +9953,13 @@ EXAMPLES
 
     $ codiac host map dev.my-company.com -e myEnterprise -v dev -n domain_slash_service --echo
 
+  One host per service per environment, served at `/` (Swagger, redirects and self-links work unchanged): the `orders`
+  service in `staging` becomes `orders-staging.internal.my-company.com`. A single wildcard DNS record and wildcard
+  cert (*.internal.my-company.com) cover all services in all environments, so a new environment needs only its own
+  host map.
+
+    $ codiac host map internal.my-company.com -e main -v staging -n svc_dash_env_dot_domain --silent
+
   Consume a mapping from a helm chart's own ingress spec: after mapping the domain here, reference it from any scoped
   setting via the ${hostmap(strategy, domain)} dynamic variable. See `cod config set --help` for setting-side
   examples.
@@ -9738,7 +9967,7 @@ EXAMPLES
     $ codiac host map mywebsite.com -e main -v primero-dev -n svc_dot_cab_dot_domain --silent
 ```
 
-_See code: [src/commands/host/map.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/host/map.ts)_
+_See code: [src/commands/host/map.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/host/map.ts)_
 
 ## `codiac host recapture [CLUSTER]`
 
@@ -9780,7 +10009,7 @@ EXAMPLES
     $ codiac host recapture my-cluster --to-script
 ```
 
-_See code: [src/commands/host/recapture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/host/recapture.ts)_
+_See code: [src/commands/host/recapture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/host/recapture.ts)_
 
 ## `codiac host view [DOMAIN]`
 
@@ -9825,7 +10054,7 @@ EXAMPLES
   $ codiac host view
 ```
 
-_See code: [src/commands/host/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/host/view.ts)_
+_See code: [src/commands/host/view.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/host/view.ts)_
 
 ## `codiac identify [TOKENNAME]`
 
@@ -9897,7 +10126,7 @@ ALIASES
   $ codiac token
 ```
 
-_See code: [src/commands/identity.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/identity.ts)_
+_See code: [src/commands/identity.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/identity.ts)_
 
 ## `codiac identity delete [NAME]`
 
@@ -9922,7 +10151,7 @@ ALIASES
   $ codiac token remove
 ```
 
-_See code: [src/commands/identity/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/identity/delete.ts)_
+_See code: [src/commands/identity/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/identity/delete.ts)_
 
 ## `codiac identity list`
 
@@ -9944,7 +10173,7 @@ ALIASES
   $ codiac token list
 ```
 
-_See code: [src/commands/identity/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/identity/list.ts)_
+_See code: [src/commands/identity/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/identity/list.ts)_
 
 ## `codiac identity remove [NAME]`
 
@@ -10267,7 +10496,7 @@ DESCRIPTION
   Saves a reference to an existing container registry.
 ```
 
-_See code: [src/commands/imageRegistry/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/capture.ts)_
+_See code: [src/commands/imageRegistry/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/capture.ts)_
 
 ## `codiac imageRegistry edit`
 
@@ -10310,7 +10539,7 @@ EXAMPLES
     $ codiac imageRegistry edit --registry devCodiacContainers --url newname.azurecr.io --to-script
 ```
 
-_See code: [src/commands/imageRegistry/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/edit.ts)_
+_See code: [src/commands/imageRegistry/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/edit.ts)_
 
 ## `codiac imageRegistry forget`
 
@@ -10331,7 +10560,7 @@ DESCRIPTION
   Removes the reference to the given container registry for the tenant.  Does NOT delete the registry itself.
 ```
 
-_See code: [src/commands/imageRegistry/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/forget.ts)_
+_See code: [src/commands/imageRegistry/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/forget.ts)_
 
 ## `codiac imageRegistry list`
 
@@ -10373,7 +10602,7 @@ EXAMPLES
     $ codiac imageRegistry list -o yaml > registries.yaml
 ```
 
-_See code: [src/commands/imageRegistry/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/list.ts)_
+_See code: [src/commands/imageRegistry/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/list.ts)_
 
 ## `codiac imageRegistry pullSecret set`
 
@@ -10409,7 +10638,7 @@ ALIASES
   $ codiac pullsecret
 ```
 
-_See code: [src/commands/imageRegistry/pullSecret/set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/pullSecret/set.ts)_
+_See code: [src/commands/imageRegistry/pullSecret/set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/pullSecret/set.ts)_
 
 ## `codiac imageRegistry pullSecret unset`
 
@@ -10436,7 +10665,7 @@ ALIASES
   $ codiac pullsecret unset
 ```
 
-_See code: [src/commands/imageRegistry/pullSecret/unset.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/imageRegistry/pullSecret/unset.ts)_
+_See code: [src/commands/imageRegistry/pullSecret/unset.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/imageRegistry/pullSecret/unset.ts)_
 
 ## `codiac images add [IMAGENAME]`
 
@@ -10497,7 +10726,7 @@ EXAMPLES
     $ codiac images add your-company/your-image --to-script
 ```
 
-_See code: [src/commands/images/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/add.ts)_
+_See code: [src/commands/images/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/add.ts)_
 
 ## `codiac images list`
 
@@ -10520,7 +10749,7 @@ ALIASES
   $ codiac img list
 ```
 
-_See code: [src/commands/images/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/list.ts)_
+_See code: [src/commands/images/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/list.ts)_
 
 ## `codiac images patch IMAGENAME`
 
@@ -10550,7 +10779,7 @@ ALIASES
   $ codiac img patch
 ```
 
-_See code: [src/commands/images/patch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/patch.ts)_
+_See code: [src/commands/images/patch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/patch.ts)_
 
 ## `codiac images remove IMAGENAME`
 
@@ -10576,7 +10805,7 @@ ALIASES
   $ codiac img delete
 ```
 
-_See code: [src/commands/images/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/remove.ts)_
+_See code: [src/commands/images/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/remove.ts)_
 
 ## `codiac images version NAME`
 
@@ -10602,7 +10831,7 @@ ALIASES
   $ codiac img version get
 ```
 
-_See code: [src/commands/images/version.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/version.ts)_
+_See code: [src/commands/images/version.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/version.ts)_
 
 ## `codiac images version bump NAME`
 
@@ -10635,7 +10864,7 @@ ALIASES
   $ codiac img version bump
 ```
 
-_See code: [src/commands/images/version/bump.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/images/version/bump.ts)_
+_See code: [src/commands/images/version/bump.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/images/version/bump.ts)_
 
 ## `codiac img [IMAGENAME]`
 
@@ -10968,7 +11197,7 @@ EXAMPLES
   $ codiac import cluster --run-in-cluster --enterprise myco --environment dev --cluster mycluster --generate-cabinet --generate-secret-store --subscription-id 00000000-0000-0000-0000-000000000000
 ```
 
-_See code: [src/commands/import/cluster.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/import/cluster.ts)_
+_See code: [src/commands/import/cluster.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/import/cluster.ts)_
 
 ## `codiac infrx cab create [CABINET]`
 
@@ -11853,7 +12082,7 @@ DESCRIPTION
   Declares the given folder as a project root
 ```
 
-_See code: [src/commands/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/init.ts)_
 
 ## `codiac kit create`
 
@@ -11896,7 +12125,7 @@ EXAMPLES
     $ codiac kit create -e myEnterprise -a myApi --to-script
 ```
 
-_See code: [src/commands/kit/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/kit/create.ts)_
+_See code: [src/commands/kit/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/kit/create.ts)_
 
 ## `codiac login`
 
@@ -11955,7 +12184,7 @@ EXAMPLES
     $ codiac login -u joe.cool@fyaml.dev --password $PW --tokenOut
 ```
 
-_See code: [src/commands/login.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/login.ts)_
 
 ## `codiac logout`
 
@@ -11988,7 +12217,7 @@ EXAMPLES
     $ codiac logout --to-script
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/logout.ts)_
 
 ## `codiac merge [BRANCH]`
 
@@ -12009,7 +12238,7 @@ DESCRIPTION
   Merges the given branch into the current branch of the main project and on any sourced dependencies.
 ```
 
-_See code: [src/commands/merge.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/merge.ts)_
+_See code: [src/commands/merge.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/merge.ts)_
 
 ## `codiac noc cluster capture`
 
@@ -12061,7 +12290,7 @@ EXAMPLES
     cod cluster capture -n my-cluster -p aws -s 123456789012 -l us-east-1
 ```
 
-_See code: [src/commands/noc/cluster/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/capture.ts)_
+_See code: [src/commands/noc/cluster/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/capture.ts)_
 
 ## `codiac noc cluster create [NAME]`
 
@@ -12151,7 +12380,7 @@ FLAG DESCRIPTIONS
     initialization is always skipped in that mode.
 ```
 
-_See code: [src/commands/noc/cluster/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/create.ts)_
+_See code: [src/commands/noc/cluster/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/create.ts)_
 
 ## `codiac noc cluster credentials-set [NAME]`
 
@@ -12206,7 +12435,7 @@ EXAMPLES
     $ codiac noc cluster credentials-set my-cluster --file ~/.kube/my-cluster.yaml --silent
 ```
 
-_See code: [src/commands/noc/cluster/credentials-set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/credentials-set.ts)_
+_See code: [src/commands/noc/cluster/credentials-set.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/credentials-set.ts)_
 
 ## `codiac noc cluster define [NAME]`
 
@@ -12280,7 +12509,7 @@ EXAMPLES
     $ codiac noc cluster define my-cluster --to-script
 ```
 
-_See code: [src/commands/noc/cluster/define.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/define.ts)_
+_See code: [src/commands/noc/cluster/define.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/define.ts)_
 
 ## `codiac noc cluster deinit`
 
@@ -12320,7 +12549,7 @@ EXAMPLES
     $ codiac noc cluster deinit -n my-cluster --to-script
 ```
 
-_See code: [src/commands/noc/cluster/deinit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/deinit.ts)_
+_See code: [src/commands/noc/cluster/deinit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/deinit.ts)_
 
 ## `codiac noc cluster destroy [NAME]`
 
@@ -12354,7 +12583,7 @@ ALIASES
   $ codiac cluster destroy
 ```
 
-_See code: [src/commands/noc/cluster/destroy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/destroy.ts)_
+_See code: [src/commands/noc/cluster/destroy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/destroy.ts)_
 
 ## `codiac noc cluster edit [NAME]`
 
@@ -12409,7 +12638,7 @@ EXAMPLES
     $ codiac noc cluster edit my-cluster --server-url https://10.110.128.10:443 --to-script
 ```
 
-_See code: [src/commands/noc/cluster/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/edit.ts)_
+_See code: [src/commands/noc/cluster/edit.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/edit.ts)_
 
 ## `codiac noc cluster forget`
 
@@ -12460,7 +12689,7 @@ EXAMPLES
     $ codiac noc cluster forget --running
 ```
 
-_See code: [src/commands/noc/cluster/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/forget.ts)_
+_See code: [src/commands/noc/cluster/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/forget.ts)_
 
 ## `codiac noc cluster grant`
 
@@ -12498,7 +12727,7 @@ EXAMPLES
     $ codiac noc cluster grant -c my-cluster -u user@example.com --to-script
 ```
 
-_See code: [src/commands/noc/cluster/grant.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/grant.ts)_
+_See code: [src/commands/noc/cluster/grant.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/grant.ts)_
 
 ## `codiac noc cluster init`
 
@@ -12544,7 +12773,7 @@ EXAMPLES
     $ codiac noc cluster init -n my-cluster --to-script
 ```
 
-_See code: [src/commands/noc/cluster/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/init.ts)_
+_See code: [src/commands/noc/cluster/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/init.ts)_
 
 ## `codiac noc cluster journal [CLUSTER]`
 
@@ -12593,7 +12822,7 @@ EXAMPLES
   $ codiac noc cluster journal -o yaml --silent dev-west-aws-02 > myfiles/journal.yaml
 ```
 
-_See code: [src/commands/noc/cluster/journal.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/journal.ts)_
+_See code: [src/commands/noc/cluster/journal.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/journal.ts)_
 
 ## `codiac noc cluster list`
 
@@ -12654,7 +12883,7 @@ EXAMPLES
     $ codiac noc cluster list -e myEnterprise --to-script
 ```
 
-_See code: [src/commands/noc/cluster/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/list.ts)_
+_See code: [src/commands/noc/cluster/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/list.ts)_
 
 ## `codiac noc cluster restore [NAME]`
 
@@ -12714,7 +12943,7 @@ EXAMPLES
     $ codiac noc cluster restore prod-cluster-1 --to-script
 ```
 
-_See code: [src/commands/noc/cluster/restore.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/noc/cluster/restore.ts)_
+_See code: [src/commands/noc/cluster/restore.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/noc/cluster/restore.ts)_
 
 ## `codiac pkg add [DEFINITIONFILE]`
 
@@ -12748,7 +12977,7 @@ DESCRIPTION
   Configures a package to be built and published by the project.
 ```
 
-_See code: [src/commands/pkg/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pkg/add.ts)_
+_See code: [src/commands/pkg/add.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pkg/add.ts)_
 
 ## `codiac pkg delete [PACKAGENAME]`
 
@@ -12786,7 +13015,7 @@ DESCRIPTION
   Renders the list of packages that are configured as project exports.
 ```
 
-_See code: [src/commands/pkg/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pkg/list.ts)_
+_See code: [src/commands/pkg/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pkg/list.ts)_
 
 ## `codiac pkg patch PACKAGENAME`
 
@@ -12812,7 +13041,7 @@ DESCRIPTION
   registryUrl and/or environment.
 ```
 
-_See code: [src/commands/pkg/patch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pkg/patch.ts)_
+_See code: [src/commands/pkg/patch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pkg/patch.ts)_
 
 ## `codiac pkg remove [PACKAGENAME]`
 
@@ -12835,7 +13064,7 @@ ALIASES
   $ codiac pkg delete
 ```
 
-_See code: [src/commands/pkg/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pkg/remove.ts)_
+_See code: [src/commands/pkg/remove.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pkg/remove.ts)_
 
 ## `codiac portal`
 
@@ -12868,7 +13097,7 @@ EXAMPLES
     $ codiac portal --to-script
 ```
 
-_See code: [src/commands/portal.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/portal.ts)_
+_See code: [src/commands/portal.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/portal.ts)_
 
 ## `codiac probe create [CMD]`
 
@@ -12992,7 +13221,7 @@ DESCRIPTION
   Publishes the exports (packages and images) declared in the ProjectConfig.
 ```
 
-_See code: [src/commands/publish.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/publish.ts)_
+_See code: [src/commands/publish.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/publish.ts)_
 
 ## `codiac pull [NAME]`
 
@@ -13016,7 +13245,7 @@ DESCRIPTION
   Pulls all commits from upstream to local.
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pull.ts)_
 
 ## `codiac pullsecret`
 
@@ -13099,7 +13328,7 @@ DESCRIPTION
   Pushes all local commits upstream.
 ```
 
-_See code: [src/commands/push.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/push.ts)_
 
 ## `codiac pvc create`
 
@@ -13183,7 +13412,7 @@ EXAMPLES
     $ codiac pvc create -e myEnt --name shared-files --type AzureFileStorage --echo
 ```
 
-_See code: [src/commands/pvc/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pvc/create.ts)_
+_See code: [src/commands/pvc/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pvc/create.ts)_
 
 ## `codiac pvc delete`
 
@@ -13230,7 +13459,7 @@ EXAMPLES
     $ codiac pvc delete --id <fileStoreDefId> --silent
 ```
 
-_See code: [src/commands/pvc/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pvc/delete.ts)_
+_See code: [src/commands/pvc/delete.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pvc/delete.ts)_
 
 ## `codiac pvc get`
 
@@ -13271,7 +13500,7 @@ EXAMPLES
   $ codiac pvc get --name app-documents-share --silent -o json
 ```
 
-_See code: [src/commands/pvc/get.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pvc/get.ts)_
+_See code: [src/commands/pvc/get.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pvc/get.ts)_
 
 ## `codiac pvc list`
 
@@ -13314,7 +13543,7 @@ EXAMPLES
   $ codiac pvc list -o yaml
 ```
 
-_See code: [src/commands/pvc/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/pvc/list.ts)_
+_See code: [src/commands/pvc/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/pvc/list.ts)_
 
 ## `codiac relay-version`
 
@@ -13331,7 +13560,7 @@ EXAMPLES
   $ codiac relay-version
 ```
 
-_See code: [src/commands/relay-version.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/relay-version.ts)_
+_See code: [src/commands/relay-version.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/relay-version.ts)_
 
 ## `codiac run`
 
@@ -13373,7 +13602,7 @@ DESCRIPTION
   Runs the latest build of the api container locally.
 ```
 
-_See code: [src/commands/run.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/run.ts)_
 
 ## `codiac secretStore`
 
@@ -13491,7 +13720,7 @@ EXAMPLES
     $ codiac secretStore capture --echo
 ```
 
-_See code: [src/commands/secretStore/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/secretStore/capture.ts)_
+_See code: [src/commands/secretStore/capture.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/secretStore/capture.ts)_
 
 ## `codiac secretStore forget`
 
@@ -13512,7 +13741,7 @@ DESCRIPTION
   Removes the reference to the given secret store for the tenant.  Does NOT delete the store itself.
 ```
 
-_See code: [src/commands/secretStore/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/secretStore/forget.ts)_
+_See code: [src/commands/secretStore/forget.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/secretStore/forget.ts)_
 
 ## `codiac secretStore list`
 
@@ -13557,7 +13786,7 @@ EXAMPLES
   $ codiac secretStore list
 ```
 
-_See code: [src/commands/secretStore/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/secretStore/list.ts)_
+_See code: [src/commands/secretStore/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/secretStore/list.ts)_
 
 ## `codiac shell init`
 
@@ -13595,7 +13824,7 @@ EXAMPLES
     Invoke-Expression (codiac shell init --shell powershell)
 ```
 
-_See code: [src/commands/shell/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/shell/init.ts)_
+_See code: [src/commands/shell/init.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/shell/init.ts)_
 
 ## `codiac skill install`
 
@@ -13630,7 +13859,7 @@ EXAMPLES
     $ codiac skill install --force
 ```
 
-_See code: [src/commands/skill/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/skill/install.ts)_
+_See code: [src/commands/skill/install.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/skill/install.ts)_
 
 ## `codiac skill path`
 
@@ -13653,7 +13882,7 @@ EXAMPLES
     $ codiac skill path
 ```
 
-_See code: [src/commands/skill/path.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/skill/path.ts)_
+_See code: [src/commands/skill/path.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/skill/path.ts)_
 
 ## `codiac skill show`
 
@@ -13692,7 +13921,7 @@ EXAMPLES
     $ codiac skill show --list
 ```
 
-_See code: [src/commands/skill/show.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/skill/show.ts)_
+_See code: [src/commands/skill/show.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/skill/show.ts)_
 
 ## `codiac snapshot deploy`
 
@@ -13720,7 +13949,7 @@ DESCRIPTION
   Deploys all assets in a snapshot to a target cabinet.
 ```
 
-_See code: [src/commands/snapshot/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/snapshot/deploy.ts)_
+_See code: [src/commands/snapshot/deploy.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/snapshot/deploy.ts)_
 
 ## `codiac snapshot list`
 
@@ -13769,7 +13998,7 @@ EXAMPLES
     $ codiac snapshot list -e myEnterprise --silent
 ```
 
-_See code: [src/commands/snapshot/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/snapshot/list.ts)_
+_See code: [src/commands/snapshot/list.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/snapshot/list.ts)_
 
 ## `codiac snapshot tag`
 
@@ -13812,7 +14041,7 @@ EXAMPLES
     $ codiac snapshot tag -e myEnterprise -v 5CJRH7XB -t production --to-script
 ```
 
-_See code: [src/commands/snapshot/tag.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/snapshot/tag.ts)_
+_See code: [src/commands/snapshot/tag.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/snapshot/tag.ts)_
 
 ## `codiac snapshot untag`
 
@@ -13855,7 +14084,7 @@ EXAMPLES
     $ codiac snapshot untag -e myEnterprise -v 5CJRH7XB -t production --to-script
 ```
 
-_See code: [src/commands/snapshot/untag.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/snapshot/untag.ts)_
+_See code: [src/commands/snapshot/untag.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/snapshot/untag.ts)_
 
 ## `codiac stage [FILES]`
 
@@ -13877,7 +14106,7 @@ DESCRIPTION
   Flags files to be included in the next commit.
 ```
 
-_See code: [src/commands/stage.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/stage.ts)_
+_See code: [src/commands/stage.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/stage.ts)_
 
 ## `codiac stash [FILE]`
 
@@ -13899,7 +14128,7 @@ DESCRIPTION
   describe the command here
 ```
 
-_See code: [src/commands/stash.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/stash.ts)_
+_See code: [src/commands/stash.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/stash.ts)_
 
 ## `codiac status`
 
@@ -13918,7 +14147,7 @@ DESCRIPTION
   Shows the current uncommitted changes in the current branch.
 ```
 
-_See code: [src/commands/status.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/status.ts)_
+_See code: [src/commands/status.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/status.ts)_
 
 ## `codiac stop`
 
@@ -13936,7 +14165,7 @@ DESCRIPTION
   Stops the running container for this project
 ```
 
-_See code: [src/commands/stop.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/stop.ts)_
+_See code: [src/commands/stop.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/stop.ts)_
 
 ## `codiac switch [NAME]`
 
@@ -13956,7 +14185,7 @@ DESCRIPTION
   Changes branch on the main project and any sourced dependencies.
 ```
 
-_See code: [src/commands/switch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/switch.ts)_
+_See code: [src/commands/switch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/switch.ts)_
 
 ## `codiac sync [NAME]`
 
@@ -13981,7 +14210,7 @@ DESCRIPTION
   Merges the given branch into the current branch.
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/sync.ts)_
 
 ## `codiac tenant create [NAME]`
 
@@ -14024,7 +14253,7 @@ EXAMPLES
     $ codiac tenant create -n 'Acme Corp' -c acme --to-script
 ```
 
-_See code: [src/commands/tenant/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/tenant/create.ts)_
+_See code: [src/commands/tenant/create.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/tenant/create.ts)_
 
 ## `codiac tenant switch [CODE]`
 
@@ -14064,7 +14293,7 @@ EXAMPLES
     $ codiac tenant switch my-tenant-code --to-script
 ```
 
-_See code: [src/commands/tenant/switch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/tenant/switch.ts)_
+_See code: [src/commands/tenant/switch.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/tenant/switch.ts)_
 
 ## `codiac token [TOKENNAME]`
 
@@ -14186,7 +14415,7 @@ DESCRIPTION
   Flags files to be included in the next commit.
 ```
 
-_See code: [src/commands/unstage.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/unstage.ts)_
+_See code: [src/commands/unstage.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/unstage.ts)_
 
 ## `codiac update [CHANNEL]`
 
@@ -14373,7 +14602,7 @@ EXAMPLES
     $ codiac whereami --to-script
 ```
 
-_See code: [src/commands/whereami.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/whereami.ts)_
+_See code: [src/commands/whereami.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/whereami.ts)_
 
 ## `codiac whoami`
 
@@ -14415,5 +14644,5 @@ EXAMPLES
     $ codiac whoami --to-script
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/codiac/codiac-cli/blob/v1.3.285/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/codiac/codiac-cli/blob/v1.3.287/src/commands/whoami.ts)_
 <!-- commandsstop -->