feat: add native Windows local orchestration

tests/local-dev.tests.ps1

@@ -0,0 +1,73 @@
+$ErrorActionPreference = 'Stop'
+
+$modulePath = Join-Path $PSScriptRoot '..\scripts\LocalDev.psm1'
+Import-Module $modulePath -Force
+
+function Assert-Equal {
+    param($Expected, $Actual, [string]$Message)
+
+    if ($Expected -ne $Actual) {
+        throw "$Message (expected '$Expected', got '$Actual')"
+    }
+}
+
+function Assert-Throws {
+    param([scriptblock]$Action, [string]$Pattern, [string]$Message)
+
+    try {
+        & $Action
+    }
+    catch {
+        if ($_.Exception.Message -notmatch $Pattern) {
+            throw "$Message (unexpected error: $($_.Exception.Message))"
+        }
+        return
+    }
+    throw "$Message (no error was thrown)"
+}
+
+$fixture = Join-Path ([System.IO.Path]::GetTempPath()) ("zarinpal-local-dev-" + [guid]::NewGuid())
+New-Item -ItemType Directory -Path $fixture | Out-Null
+
+try {
+    $validEnv = Join-Path $fixture '.env'
+    @(
+        '# ignored comment'
+        'PLAIN=value'
+        'QUOTED="value with spaces"'
+        'EMPTY='
+    ) | Set-Content -LiteralPath $validEnv -Encoding utf8
+
+    $values = Read-DotEnvFile -Path $validEnv
+    Assert-Equal 'value' $values.PLAIN 'Plain dotenv values should parse'
+    Assert-Equal 'value with spaces' $values.QUOTED 'Quoted dotenv values should parse'
+    Assert-Equal '' $values.EMPTY 'Blank dotenv values should parse'
+
+    $duplicateEnv = Join-Path $fixture 'duplicate.env'
+    @('KEY=one', 'KEY=two') | Set-Content -LiteralPath $duplicateEnv -Encoding utf8
+    Assert-Throws { Read-DotEnvFile -Path $duplicateEnv } 'duplicate variable' 'Duplicate variables must fail closed'
+
+    $invalidEnv = Join-Path $fixture 'invalid.env'
+    'NOT A KEY=value' | Set-Content -LiteralPath $invalidEnv -Encoding utf8
+    Assert-Throws { Read-DotEnvFile -Path $invalidEnv } 'invalid dotenv entry' 'Malformed variables must fail closed'
+
+    $backend = Join-Path $fixture 'backend'
+    $frontend = Join-Path $fixture 'frontend'
+    New-Item -ItemType Directory -Path (Join-Path $backend 'cmd\api') -Force | Out-Null
+    New-Item -ItemType Directory -Path (Join-Path $backend 'cmd\worker') -Force | Out-Null
+    New-Item -ItemType Directory -Path $frontend -Force | Out-Null
+    '{"scripts":{"dev":"vite"}}' | Set-Content -LiteralPath (Join-Path $frontend 'package.json') -Encoding utf8
+
+    $commands = Resolve-LocalDevCommands -BackendPath $backend -FrontendPath $frontend
+    Assert-Equal './cmd/api' $commands.Api.Arguments[1] 'API command should follow the backend contract'
+    Assert-Equal './cmd/worker' $commands.Worker.Arguments[1] 'Worker command should follow the backend contract'
+    Assert-Equal 'run' $commands.Frontend.Arguments[0] 'Frontend should use its checked-in dev script'
+
+    Remove-Item -LiteralPath (Join-Path $backend 'cmd\worker') -Recurse
+    Assert-Throws { Resolve-LocalDevCommands -BackendPath $backend -FrontendPath $frontend } 'cmd/worker' 'A missing worker entrypoint must be actionable'
+
+    Write-Output 'local-dev tests passed'
+}
+finally {
+    Remove-Item -LiteralPath $fixture -Recurse -Force -ErrorAction SilentlyContinue
+}