paratix 0.10.0 → 0.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -29,11 +29,14 @@ If you want the fastest path, scaffold a project first:
29
29
  ```bash
30
30
  npm create paratix my-server
31
31
  cd my-server
32
+ npm run apply:first-run:dry
33
+ npm run apply:first-run
32
34
  npm run apply:dry
33
- npm run apply -- --first-run
34
35
  npm run apply
35
36
  ```
36
37
 
38
+ Use the first-run dry-run to preview the bootstrap changes before hardening a fresh server.
39
+
37
40
  If you want to install `paratix` directly:
38
41
 
39
42
  ```bash
@@ -120,6 +123,7 @@ Paratix can also manage file-backed swap directly. Use `swap.file(...)` to provi
120
123
  paratix apply <file> [options]
121
124
 
122
125
  Options:
126
+ --diff
123
127
  --dry-run
124
128
  --env <key=value>
125
129
  --env-file <path>
@@ -132,6 +136,8 @@ Options:
132
136
 
133
137
  `--first-run` is meant for explicit bootstrap flows where a fresh server must be hardened first and the rest of the system should only be applied later.
134
138
 
139
+ `--diff` only works together with `--dry-run`. When enabled, modules that opt in print a unified diff below their status line, showing exactly which lines or values would change. Without `--diff`, the dry-run output is unchanged. Diff-producing modules: `file.copy`, `file.template`, `sysctl.set`, `hostname.set`, `swap.file`, `swap.swappiness`, `swap.vfsCachePressure`, `cron.job`, `cron.absent`, `timer.scheduled`, `timer.absent`, `net.hosts`, `quadlet.container`.
140
+
135
141
  ## Documentation
136
142
 
137
143
  - For project scaffolding, see [`create-paratix`](https://www.npmjs.com/package/create-paratix).