Add workbook catalog, validation, and scrubbing infrastructure

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{workbook,json}]
+indent_style = space
+indent_size = 2
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,11 @@
+# Workbook templates are JSON; tell GitHub to highlight and diff them as such.
+*.workbook linguist-language=JSON text eol=lf
+
+# Keep generated and source files on LF so diffs stay clean across platforms.
+*.md text eol=lf
+*.py text eol=lf
+*.yml text eol=lf
+*.json text eol=lf
+
+# The catalog is generated by scripts/build_catalog.py.
+CATALOG.md linguist-generated=true

.github/workflows/validate.yml

@@ -0,0 +1,29 @@
+name: Validate workbooks
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Validate workbook JSON and check for leaked resource IDs
+        run: python scripts/validate_workbooks.py
+
+      - name: Check placeholders are in use
+        run: python scripts/scrub_resource_ids.py --check
+
+      - name: Check CATALOG.md is up to date
+        run: python scripts/build_catalog.py --check

Authoring, Templates & Examples/FindmySyntax v0.2.3.workbook

@@ -36,7 +36,7 @@
             },
             "queryType": 1,
             "resourceType": "microsoft.resourcegraph/resources",
-            "value": "/subscriptions/7b76bfbc-cb1e-4df1-b6e8-b826eef6c592/resourceGroups/SOC/providers/Microsoft.OperationalInsights/workspaces/CyberSecuritySOC"
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace"
           },
           {
             "id": "9fa77675-1222-4936-89d0-285da325bba0",

Authoring, Templates & Examples/api test v1-2.workbook

@@ -30,7 +30,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/44e4eff8-1fcb-4a22-a7d6-992ac7286382/resourceGroups/soc/providers/Microsoft.OperationalInsights/workspaces/CyberSecurityDemo",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/api test v1-4.1.workbook

@@ -26,7 +26,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/7b76bfbc-cb1e-4df1-b6e8-b826eef6c592/resourceGroups/SOC/providers/Microsoft.OperationalInsights/workspaces/CyberSecuritySoc",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/api test v1.4.2.workbook

@@ -26,7 +26,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/82931e73-05c6-4da8-a666-bc4a7dd1bd3e/resourceGroups/fabrikamltdprodrg/providers/Microsoft.OperationalInsights/workspaces/fabrikamltdprod",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/api test v1.4.3.workbook

@@ -11,7 +11,7 @@
             "version": "KqlParameterItem/1.0",
             "name": "Subscription",
             "type": 6,
-            "value": "/subscriptions/7b76bfbc-cb1e-4df1-b6e8-b826eef6c592",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000",
             "typeSettings": {
               "additionalResourceOptions": [],
               "includeAll": false
@@ -26,7 +26,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/7b76bfbc-cb1e-4df1-b6e8-b826eef6c592/resourceGroups/SOC/providers/Microsoft.OperationalInsights/workspaces/CyberSecuritySOC",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/api test v1.4.4 (1).workbook

@@ -26,7 +26,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/7b76bfbc-cb1e-4df1-b6e8-b826eef6c592/resourceGroups/soc/providers/Microsoft.OperationalInsights/workspaces/cybersecuritysoc",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/api test v1.4.5 (2).workbook

@@ -26,7 +26,7 @@
             "crossComponentResources": [
               "{Subscription}"
             ],
-            "value": "/subscriptions/82931e73-05c6-4da8-a666-bc4a7dd1bd3e/resourceGroups/fabrikamltdprodrg/providers/Microsoft.OperationalInsights/workspaces/fabrikamltdprod",
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace",
             "typeSettings": {
               "additionalResourceOptions": []
             },

Authoring, Templates & Examples/withHelpandTabsandGroups.workbook

@@ -46,7 +46,7 @@
                   },
                   "queryType": 1,
                   "resourceType": "microsoft.resourcegraph/resources",
-                  "value": "/subscriptions/04a8ebe3-0389-4b0f-8461-30f81896e97e/resourceGroups/weu-management-rg/providers/Microsoft.OperationalInsights/workspaces/pcadmintest"
+                  "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/placeholder-rg/providers/Microsoft.OperationalInsights/workspaces/placeholder-workspace"
                 },
                 {
                   "id": "9fa77675-1222-4936-89d0-285da325bba0",