docs(zsh): require canonical option spellings

.github/instructions/zsh-scripting.instructions.md

@@ -326,6 +326,21 @@ execution profile.
 
 ## Options and emulation
 
+### `zsh/options/canonical-spelling`
+
+- Level: `required`
+- Profiles: `standalone-executable`, `startup-file`, `sourced-library`, `autoload-function`, `test-fixture`
+- Minimum Zsh: `null`
+- Basis: `mixed`
+- Evidence: `options`
+- Enforcement: `human-review`
+
+Write option names in the canonical underscore-separated form used by the Zsh
+manual, including in `setopt`, `unsetopt`, option tests, and documentation. For
+example, use `local_options`, `no_auto_pushd`, and `warn_create_global`, not
+accepted separator-free aliases such as `localoptions`, `noautopushd`, and
+`warncreateglobal`.
+
 ### `zsh/options/declare-correctness-state`
 
 - Level: `required`

lib/zsh-standard-policy.json

@@ -319,6 +319,21 @@
       "evidence": ["functions", "options"],
       "enforcement": ["runtime-test"]
     },
+    {
+      "id": "zsh/options/canonical-spelling",
+      "level": "required",
+      "profiles": [
+        "standalone-executable",
+        "startup-file",
+        "sourced-library",
+        "autoload-function",
+        "test-fixture"
+      ],
+      "minimum_zsh": null,
+      "basis": "mixed",
+      "evidence": ["options"],
+      "enforcement": ["human-review"]
+    },
     {
       "id": "zsh/options/declare-correctness-state",
       "level": "required",

scripts/test_validate_zsh_standard_policy.py

@@ -203,6 +203,7 @@ def test_startup_profile_has_exact_rule_membership(self) -> None:
             "zsh/review/report-without-rewrite",
             "zsh/change/conform-touched-code",
             "zsh/completion/preserve-trust-boundaries",
+            "zsh/options/canonical-spelling",
             "zsh/options/declare-correctness-state",
             "zsh/options/localize",
             "zsh/options/no-blanket-error-mode",
@@ -249,7 +250,7 @@ def test_startup_profile_has_exact_rule_membership(self) -> None:
             [rule["id"] for rule in matching_rules],
             expected_rule_ids,
         )
-        self.assertEqual(len(matching_rules), 48)
+        self.assertEqual(len(matching_rules), 49)
         for rule in matching_rules:
             with self.subTest(rule_id=rule["id"]):
                 if rule["id"] == "zsh/completion/preserve-trust-boundaries":
@@ -1977,7 +1978,7 @@ def test_repair_2_consumer_parser_outputs_match_frozen_golden(self) -> None:
             },
             "parsed_rules": validator._markdown_rules(instruction),
         }
-        self.assertEqual(len(snapshot["rule_blocks"]), 63)
+        self.assertEqual(len(snapshot["rule_blocks"]), 64)
         digest = hashlib.sha256(
             json.dumps(
                 snapshot,
@@ -1989,7 +1990,7 @@ def test_repair_2_consumer_parser_outputs_match_frozen_golden(self) -> None:
 
         self.assertEqual(
             digest,
-            "15d3c2c6f7bcf5192f8fe4beb1b8e324262f0ea5779407b0c0609beadc13151c",
+            "e385f4d4c34496495e808b602b59adb88d5ace192619e04669c70f4020afc981",
         )
 
     def test_rejects_list_and_nested_container_rule_headings(self) -> None:

scripts/validate-zsh-standard-policy.py

@@ -145,6 +145,7 @@
     "zsh/test/isolate-environment",
     "zsh/test/declare-negative-fixtures",
     "zsh/test/match-production-profile",
+    "zsh/options/canonical-spelling",
     "zsh/options/declare-correctness-state",
     "zsh/options/localize",
     "zsh/options/no-top-level-leak",
@@ -202,6 +203,7 @@
     "zsh/review/report-without-rewrite",
     "zsh/change/conform-touched-code",
     "zsh/completion/preserve-trust-boundaries",
+    "zsh/options/canonical-spelling",
     "zsh/options/declare-correctness-state",
     "zsh/options/localize",
     "zsh/options/no-blanket-error-mode",