build(scripts): add linting infrastructure with npm scripts

- add package.json with lint:md, lint:ps, lint:links, spell-check scripts
- migrate .markdownlint.json to .markdownlint-cli2.jsonc with ignores
- add PowerShell linting scripts from hve-core pattern
- add LintingHelpers module for GitHub Actions integration

🔧 - Generated by Copilot

Author: WilliamBerryiii

.markdownlint-cli2.jsonc

@@ -0,0 +1,78 @@
+{
+  "ignores": [
+    "**/node_modules/**",
+    ".copilot-tracking/**",
+    "venv/**"
+  ],
+  "config": {
+    "default": true,
+    "extends": null,
+    "MD001": true,
+    "MD003": { "style": "consistent" },
+    "MD004": { "style": "consistent" },
+    "MD005": true,
+    "MD007": { "indent": 2, "start_indented": false, "start_indent": 2 },
+    "MD009": { "br_spaces": 2, "list_item_empty_lines": false, "strict": false },
+    "MD010": { "code_blocks": true, "ignore_code_languages": [], "spaces_per_tab": 1 },
+    "MD011": true,
+    "MD012": { "maximum": 1 },
+    "MD013": {
+      "line_length": 500,
+      "heading_line_length": 80,
+      "code_block_line_length": 1200,
+      "code_blocks": true,
+      "tables": false,
+      "headings": true,
+      "strict": false,
+      "stern": false
+    },
+    "MD014": true,
+    "MD018": true,
+    "MD019": true,
+    "MD020": true,
+    "MD021": true,
+    "MD022": { "lines_above": 1, "lines_below": 1 },
+    "MD023": true,
+    "MD024": { "siblings_only": false },
+    "MD025": { "level": 1, "front_matter_title": "^\\s*title\\s*[:=]" },
+    "MD026": { "punctuation": ".,;:!。，；：！" },
+    "MD027": true,
+    "MD028": true,
+    "MD029": { "style": "one_or_ordered" },
+    "MD030": { "ul_single": 1, "ol_single": 1, "ul_multi": 1, "ol_multi": 1 },
+    "MD031": { "list_items": true },
+    "MD032": true,
+    "MD033": { "allowed_elements": ["details", "summary"] },
+    "MD034": true,
+    "MD035": { "style": "consistent" },
+    "MD036": { "punctuation": ".,;:!?。，；：！？" },
+    "MD037": true,
+    "MD038": true,
+    "MD039": true,
+    "MD040": { "allowed_languages": [], "language_only": false },
+    "MD041": { "level": 1, "front_matter_title": "^\\s*title\\s*[:=]" },
+    "MD042": true,
+    "MD043": false,
+    "MD044": { "names": [], "code_blocks": true, "html_elements": true },
+    "MD045": true,
+    "MD046": { "style": "consistent" },
+    "MD047": true,
+    "MD048": { "style": "consistent" },
+    "MD049": { "style": "consistent" },
+    "MD050": { "style": "consistent" },
+    "MD051": { "ignore_case": false },
+    "MD052": { "shortcut_syntax": false },
+    "MD053": { "ignored_definitions": ["//"] },
+    "MD054": {
+      "autolink": true,
+      "inline": true,
+      "full": true,
+      "collapsed": true,
+      "shortcut": true,
+      "url_inline": true
+    },
+    "MD055": { "style": "consistent" },
+    "MD056": true,
+    "MD058": true
+  }
+}

.markdownlint.json

@@ -0,0 +1,28 @@
+{
+  "name": "azure-nvidia-robotics-reference-architecture",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Azure NVIDIA Robotics Reference Architecture",
+  "scripts": {
+    "spell-check": "cspell \"**/*.{md,ts,js,json,yaml,yml,py,sh}\"",
+    "spell-check:fix": "cspell \"**/*.{md,ts,js,json,yaml,yml,py,sh}\" --show-suggestions",
+    "lint:md": "markdownlint-cli2 \"**/*.md\"",
+    "lint:md:fix": "markdownlint-cli2 \"**/*.md\" --fix",
+    "lint:ps": "pwsh -File scripts/linting/Invoke-PSScriptAnalyzer.ps1",
+    "lint:links": "pwsh -File scripts/linting/Invoke-LinkLanguageCheck.ps1",
+    "lint:all": "npm run lint:md && npm run lint:ps && npm run lint:links",
+    "format:tables": "markdown-table-formatter \"**/*.md\""
+  },
+  "devDependencies": {
+    "cspell": "9.4.0",
+    "markdown-link-check": "3.14.2",
+    "markdown-table-formatter": "^1.6.0",
+    "markdownlint-cli2": "^0.19.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Azure-Samples/azure-nvidia-robotics-reference-architecture.git"
+  },
+  "author": "Microsoft",
+  "license": "MIT"
+}

package.json

@@ -0,0 +1,109 @@
+#!/usr/bin/env pwsh
+#
+# Invoke-LinkLanguageCheck.ps1
+#
+# Purpose: Wrapper for Link-Lang-Check.ps1 with GitHub Actions integration
+
+[CmdletBinding()]
+param()
+
+Import-Module (Join-Path $PSScriptRoot "Modules/LintingHelpers.psm1") -Force
+
+$repoRoot = git rev-parse --show-toplevel 2>$null
+if ($LASTEXITCODE -ne 0) {
+    Write-Error "Not in a git repository"
+    exit 1
+}
+
+$logsDir = Join-Path $repoRoot "logs"
+if (-not (Test-Path $logsDir)) {
+    New-Item -ItemType Directory -Path $logsDir -Force | Out-Null
+}
+
+Write-Host "🔍 Checking for URLs with language paths..." -ForegroundColor Cyan
+
+$jsonOutput = & (Join-Path $PSScriptRoot "Link-Lang-Check.ps1") 2>&1
+
+try {
+    $results = $jsonOutput | ConvertFrom-Json
+
+    if ($results -and $results.Count -gt 0) {
+        Write-Host "Found $($results.Count) URLs with 'en-us' language paths`n" -ForegroundColor Yellow
+
+        foreach ($item in $results) {
+            Write-GitHubAnnotation `
+                -Type 'warning' `
+                -Message "URL contains language path: $($item.original_url)" `
+                -File $item.file `
+                -Line $item.line_number
+        }
+
+        $outputData = @{
+            timestamp = (Get-Date).ToUniversalTime().ToString("o")
+            script    = "link-lang-check"
+            summary   = @{
+                total_issues   = $results.Count
+                files_affected = ($results | Select-Object -ExpandProperty file -Unique).Count
+            }
+            issues    = $results
+        }
+        $outputData | ConvertTo-Json -Depth 3 | Out-File (Join-Path $logsDir "link-lang-check-results.json") -Encoding utf8
+
+        Set-GitHubOutput -Name "issues" -Value $results.Count
+        Set-GitHubEnv -Name "LINK_LANG_FAILED" -Value "true"
+
+        $uniqueFiles = $results | Select-Object -ExpandProperty file -Unique
+
+        Write-GitHubStepSummary -Content @"
+## Link Language Path Check Results
+
+⚠️ **Status**: Issues Found
+
+Found $($results.Count) URL(s) containing language path 'en-us'.
+
+**Why this matters:**
+Language-specific URLs don't adapt to user preferences and may break for non-English users.
+
+**To fix locally:**
+``````powershell
+scripts/linting/Link-Lang-Check.ps1 -Fix
+``````
+
+**Files affected:**
+$(($uniqueFiles | ForEach-Object { $count = ($results | Where-Object file -eq $_).Count; "- $_ ($count occurrence(s))" }) -join "`n")
+"@
+
+        exit 1
+    }
+    else {
+        Write-Host "✅ No URLs with language paths found" -ForegroundColor Green
+
+        $emptyResults = @{
+            timestamp = (Get-Date).ToUniversalTime().ToString("o")
+            script    = "link-lang-check"
+            summary   = @{
+                total_issues   = 0
+                files_affected = 0
+            }
+            issues    = @()
+        }
+        $emptyResults | ConvertTo-Json -Depth 3 | Out-File (Join-Path $logsDir "link-lang-check-results.json") -Encoding utf8
+
+        Set-GitHubOutput -Name "issues" -Value "0"
+
+        Write-GitHubStepSummary -Content @"
+## Link Language Path Check Results
+
+✅ **Status**: Passed
+
+No URLs with language-specific paths detected.
+"@
+
+        exit 0
+    }
+}
+catch {
+    Write-Error "Error parsing results: $_"
+    Write-Host "Raw output: $jsonOutput"
+    exit 1
+}