fix: quote wildcard patterns in YAML and warn on unmatched workspaces

Quote wildcard patterns starting with * in YAML examples to prevent
YAML alias interpretation. Add warning when exact workspace names in
a mixed wildcard/exact filter don't match any discovered workspace.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Peter Hauge

docs/commands/extract.md

@@ -102,7 +102,7 @@ To extract only specific resources, pass a YAML filter file with `--filter`. Fil
 apis:
   - echo-api
   - petstore-api
-  - prod-*              # Wildcard: all APIs starting with prod-
+  - 'prod-*'             # Wildcard: all APIs starting with prod-
 products:
   - starter
 backends:

docs/getting-started.md

@@ -61,7 +61,7 @@ Extract only the APIs you care about. Create a `filter.yaml`:
 apiNames:
   - pet-store-api
   - user-api
-  - staging-*           # Wildcard: all APIs starting with staging-
+  - 'staging-*'          # Wildcard: all APIs starting with staging-
 ```
 
 ```bash

src/services/workspace-extractor.ts

@@ -71,6 +71,16 @@ export async function extractWorkspaces(
             : pattern.toLowerCase() === name.toLowerCase()
         )
       );
+
+      // Warn about exact (non-wildcard) entries that didn't match any discovered workspace
+      for (const entry of filter.workspaces) {
+        if (!isWildcardPattern(entry)) {
+          const matched = discovered.some((d) => d.toLowerCase() === entry.toLowerCase());
+          if (!matched) {
+            logger.warn(`Workspace filter entry "${entry}" did not match any discovered workspace`);
+          }
+        }
+      }
     } else {
       workspaceNames = filter.workspaces;
     }

src/templates/configs/filter-config.ts

@@ -15,8 +15,8 @@ export function generateFilterConfig(): string {
 # apis:
 #   - echo-api
 #   - petstore-api
-#   - prod-*                        # Wildcard: all APIs starting with prod-
-#   - *-internal-*                  # Wildcard: all APIs containing -internal-
+#   - 'prod-*'                       # Wildcard: all APIs starting with prod-
+#   - '*-internal-*'                 # Wildcard: all APIs containing -internal-
 
 # Advanced: Filter API sub-resources (operations, diagnostics, schemas, releases)
 # apis:
@@ -25,7 +25,7 @@ export function generateFilterConfig(): string {
 #       operations:
 #         - get-pets
 #         - create-pet
-#         - list-*                    # Wildcard: all operations starting with list-
+#         - 'list-*'                  # Wildcard: all operations starting with list-
 #       diagnostics:
 #         - applicationinsights
 #       schemas: []                   # Exclude all schemas