Add flag to turn power assertions on/off (#1419)

docs/modules/pkl-cli/pages/index.adoc

@@ -454,6 +454,16 @@ output {
 ----
 ====
 
+[[power-assertions-eval]]
+.--power-assertions, --no-power-assertions
+[%collapsible]
+====
+Default: enabled +
+Enable or disable power assertions for detailed assertion failure messages.
+When enabled, type constraint failures will show intermediate values in the assertion expression.
+Use `--no-power-assertions` to disable this feature if you prefer simpler output or better performance.
+====
+
 This command also takes <<common-options, common options>>.
 
 [[command-server]]
@@ -524,6 +534,16 @@ Force generation of expected examples. +
 The old expected files will be deleted if present.
 ====
 
+[[power-assertions-test]]
+.--power-assertions, --no-power-assertions
+[%collapsible]
+====
+Default: enabled +
+Enable or disable power assertions for detailed assertion failure messages.
+When enabled, test failures will show intermediate values in the assertion expression, making it easier to understand why a test failed.
+Use `--no-power-assertions` to disable this feature if you prefer simpler output.
+====
+
 This command also takes <<common-options, common options>>.
 
 [[command-repl]]

docs/modules/pkl-gradle/pages/index.adoc

@@ -322,6 +322,16 @@ Default: `false` +
 Whether to ignore expected example files and generate them again.
 ====
 
+[[power-assertions-test]]
+.powerAssertions: Property<Boolean>
+[%collapsible]
+====
+Default: `true` (for test tasks) +
+Example: `powerAssertions = false` +
+Enable or disable power assertions for detailed assertion failure messages.
+When enabled, test failures will show intermediate values in the assertion expression, making it easier to understand why a test failed.
+====
+
 Common properties:
 
 include::../partials/gradle-modules-properties.adoc[]

docs/modules/pkl-gradle/partials/gradle-common-properties.adoc

@@ -118,3 +118,13 @@ The left-hand side describes the source prefix, and the right-hand describes the
 This option is commonly used to enable package mirroring.
 The above example will rewrite URL `\https://pkg.pkl-lang.org/pkl-k8s/k8s@1.0.0` to `\https://my.internal.mirror/pkl-k8s/k8s@1.0.0`.
 ====
+
+.powerAssertions: Property<Boolean>
+[%collapsible]
+====
+Default: `false` (except for test tasks, which default to `true`) +
+Example: `powerAssertions = true` +
+Enable power assertions for detailed assertion failure messages.
+When enabled, type constraint failures will show intermediate values in the assertion expression.
+This option has a performance impact when constraint failures occur.
+====