[CLI] The aaz dev server, on import of a new spec in a workspace, will create the examples without the required quotes.

[abossard]

Summary

When working on the health models extension generation I noticed this issue:

Original example:
https://github.com/Azure/azure-rest-api-specs/blob/9ee5902c9557817bc4a859ebc13f757515aac5d7/specification/cloudhealth/CloudHealth.Management/examples/2025-05-01-preview/Entities_CreateOrUpdate.json#L12

has a display name with space in it.

After importing into aaz-dev:

the example doesn't have the required quotes around the `--displayName` parameter.

Steps to reproduce

1. Create a new workspace
2. Import e.g. the cloudhealth api sepcs
3. Check the imported example

Expected behavior

Ideally it would add the quotes in that situation

az ... --display-name "My entity" ...

[abossard]

Disclaimer: Copilot-assisted, human-verified.

Smallest fix

When examples are drafted from swagger, then it uses serialize() to work on the parameters.

The unquoted rendering comes from serialize() in src/aaz_dev/command/controller/shorthand.py.

• Dict/list argument values are wrapped in "…" (and inner leaves get single-quoted by dfs)
• but a top-level scalar string seems to fall through to the final else and is returned verbatim,
• this mean: a value that contains spaces is emitted without quotes.

Example for a change: shell-quote all top-level scalar strings via stdlib shlex.quote:

+import shlex
+
 def serialize(obj):
     def dfs(obj):
         ...
-    return '"' + dfs(obj) + '"' if isinstance(obj, dict) or isinstance(obj, list) else obj
+    if isinstance(obj, dict) or isinstance(obj, list):
+        return '"' + dfs(obj) + '"'
+    return shlex.quote(obj) if isinstance(obj, str) else obj

Behavior after the change:

input	before	after
My entity	My entity	'My entity'
rgopenapi, PT1M, 2025-12-11T10:00:00Z	unchanged	unchanged (safe tokens left as-is)
monitor's	-	'monitor'"'"'s'
{displayName: "My entity"} (dict)	"{displayName:'My entity'}"	unchanged

Notes:

• Scoped to top-level scalar strings only; dict/list handling is untouched and non-string scalars (ints/floats) are returned as before.
• The existing command/tests/editor_tests/test_serialize_shorthand.py cases still pass (their dict output is unchanged).
• This fixes newly drafted examples. Examples already stored on a command are copied verbatim at (re)generation time, so previously-generated unquoted examples would need a re-draft (or a manual edit) to pick up the quoting.

I don't know the codebase well, so take this just as idea. Happy to assist with testing.