GTI_GERENCIADOR_FISCAL/deploy/agent-windows/gti-agent.ps1

<#
  GTI Fiscal Agent - Windows operations script (RC1). No Python editing needed.

  Usage (elevated PowerShell for install/install-auto/start/stop/restart/uninstall):
    .\gti-agent.ps1 install-auto                  bundle downloaded from the panel's "Nova instalação": verifies the
                                                   package's SHA-256, enrolls with the Hub using enrollment.json (deleted
                                                   right after, single use), writes .env, registers the service. Does NOT
                                                   start it — Firebird is still unconfigured; fill it in and run start.
    .\gti-agent.ps1 install                       manual path: create venv, install dependencies, register the Windows Service (does NOT start it)
    .\gti-agent.ps1 configure [-FromTemplate f]   write <install>\.env (secrets are prompted, never echoed, never stored in the package)
    .\gti-agent.ps1 preflight                     PREFLIGHT=PASS|FAIL with blockers (read-only)
    .\gti-agent.ps1 start | stop | restart        service control (start refuses to run when preflight fails)
    .\gti-agent.ps1 status                        service state + last log lines
    .\gti-agent.ps1 uninstall [-Purge]            remove the service; -Purge also deletes venv/logs/state (never the .env unless -Purge)

  The package folder is the install folder. Requires Python 3.12 (64-bit) on PATH and the Firebird client (fbclient.dll) already used by the SGV.
#>
param(
    [Parameter(Position = 0, Mandatory = $true)]
    [ValidateSet('install', 'install-auto', 'configure', 'preflight', 'start', 'stop', 'restart', 'status', 'uninstall')]
    [string]$Command,
    [string]$FromTemplate,
    [switch]$Purge
)

$ErrorActionPreference = 'Stop'
$Root = Split-Path -Parent $MyInvocation.MyCommand.Path
$ServiceName = 'GTIFiscalAgent'
$Venv = Join-Path $Root 'venv'
$Py = Join-Path $Venv 'Scripts\python.exe'
$EnvFile = Join-Path $Root '.env'
$LogFile = Join-Path $Root 'agent\logs\agent.log'

function Assert-Admin {
    $principal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
    if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) { throw 'Run this command from an elevated (Administrator) PowerShell.' }
}

function Read-Plain([string]$Prompt, [string]$Default = '') {
    $suffix = if ($Default) { " [$Default]" } else { '' }
    $value = Read-Host "$Prompt$suffix"
    if ([string]::IsNullOrWhiteSpace($value)) { return $Default } else { return $value.Trim() }
}

function Read-Secret([string]$Prompt) {
    $secure = Read-Host $Prompt -AsSecureString
    $bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
    try { return [Runtime.InteropServices.Marshal]::PtrToStringBSTR($bstr) } finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($bstr) }
}

switch ($Command) {
    'install' {
        Assert-Admin
        if (-not (Get-Command python -ErrorAction SilentlyContinue)) { throw 'Python 3.12 (64-bit) is required on PATH.' }
        if (-not (Test-Path $Py)) { python -m venv $Venv }
        & $Py -m pip install --upgrade pip | Out-Null
        & $Py -m pip install -r (Join-Path $Root 'requirements-agent.txt')
        $post = Join-Path $Venv 'Scripts\pywin32_postinstall.py'
        if (Test-Path $post) { & $Py $post -install | Out-Null }
        $svc = Join-Path $Root 'agent\service\gti_agent_windows_service.py'
        & $Py $svc --startup=auto install
        sc.exe failure $ServiceName reset= 86400 actions= restart/60000/restart/60000/restart/60000 | Out-Null
        Write-Host "Service $ServiceName registered (Automatic). Next: .\gti-agent.ps1 configure ; .\gti-agent.ps1 preflight ; .\gti-agent.ps1 start"
    }
    'install-auto' {
        Assert-Admin
        $EnrollmentFile = Join-Path $Root 'enrollment.json'
        $ManifestFile = Join-Path $Root 'MANIFEST.json'

        # Idempotent: a second run after a successful enroll must not re-enroll,
        # re-register the service, or touch the existing identity.
        if ((Test-Path $EnvFile) -and (Select-String -Path $EnvFile -Pattern '^AGENT_TOKEN=\S' -Quiet) -and (Get-Service $ServiceName -ErrorAction SilentlyContinue)) {
            Write-Host "Already enrolled and installed ($EnvFile exists, service $ServiceName registered). Nothing to do."
            exit 0
        }
        if (-not (Test-Path $EnrollmentFile)) { throw "enrollment.json not found in $Root — this bundle was already installed, or was not downloaded from a pending installation link." }
        if (-not (Get-Command python -ErrorAction SilentlyContinue)) { throw 'Python 3.12 (64-bit) is required on PATH.' }

        $enrollment = Get-Content $EnrollmentFile -Raw | ConvertFrom-Json
        if ($enrollment.hub_url -notmatch '^https://') { throw "Refusing: hub_url must be https:// (got: $($enrollment.hub_url))" }

        # Package integrity: every file this manifest lists must still match its
        # recorded SHA-256 — catches a corrupted or tampered extraction before
        # anything in it runs or is installed as a service.
        if (Test-Path $ManifestFile) {
            $manifest = Get-Content $ManifestFile -Raw | ConvertFrom-Json
            $checked = 0
            foreach ($entry in $manifest.files.PSObject.Properties) {
                $target = Join-Path $Root $entry.Name
                if (-not (Test-Path $target)) { throw "SHA256_VALIDATION=FAIL: missing file $($entry.Name)" }
                $actual = (Get-FileHash -Path $target -Algorithm SHA256).Hash.ToLower()
                if ($actual -ne $entry.Value) { throw "SHA256_VALIDATION=FAIL: $($entry.Name) does not match the published manifest" }
                $checked++
            }
            Write-Host "SHA256_VALIDATION=PASS ($checked files)"
        } else {
            Write-Host 'SHA256_VALIDATION=SKIPPED (no MANIFEST.json in this bundle)'
        }

        $agentVersion = ((Get-Content (Join-Path $Root 'VERSION') -Raw) -replace '\s', '')
        $machineId = try { (Get-CimInstance Win32_ComputerSystemProduct -ErrorAction Stop).UUID } catch { '' }
        $body = @{
            installation_id    = $enrollment.installation_id
            enrollment_token   = $enrollment.enrollment_token
            agent_version      = $agentVersion
            hostname           = $env:COMPUTERNAME
            platform           = 'windows'
            machine_fingerprint = $machineId
        } | ConvertTo-Json

        Write-Host "Enrolling installation $($enrollment.installation_id) at $($enrollment.hub_url)..."
        try {
            $response = Invoke-RestMethod -Method Post -Uri "$($enrollment.hub_url)$($enrollment.enroll_path)" -Body $body -ContentType 'application/json'
        } catch {
            throw "ENROLLMENT_REJECTED: $($_.Exception.Message)"
        }
        if ($response.hostname_mismatch) {
            Write-Warning 'hostname_mismatch=true: the operator expected a different hostname for this installation. Enrollment still succeeded — confirm this is the intended machine.'
        }

        # The Hub already rejects any reuse of this token, but the bundle's own
        # copy is deleted immediately too, so it never lingers on disk.
        Remove-Item $EnrollmentFile -Force

        $lines = @(
            "GTI_HUB_URL=$($response.hub_url)", "AGENT_TOKEN=$($response.agent_token)", "AGENT_ID=$($response.agent_id)",
            'FISCAL_MODE=DRY_RUN', 'FIREBIRD_WRITES=0', 'POLL_INTERVAL_SECONDS=5', "AGENT_VERSION=$agentVersion",
            'FIREBIRD_DATABASE_PATH=', 'FB_USER=SYSDBA', 'FB_PASSWORD=', 'COMPANY_CODE=', 'COMPANY_CNPJ=', 'COMPANY_CRT_SOURCE=AUTO'
        )
        Set-Content -Path $EnvFile -Value $lines -Encoding UTF8
        # Only Administrators and SYSTEM may read the file that now holds AGENT_TOKEN.
        icacls $EnvFile /inheritance:r /grant:r 'Administrators:(F)' 'SYSTEM:(F)' | Out-Null

        if (-not (Test-Path $Py)) { python -m venv $Venv }
        & $Py -m pip install --upgrade pip | Out-Null
        & $Py -m pip install -r (Join-Path $Root 'requirements-agent.txt')
        $post = Join-Path $Venv 'Scripts\pywin32_postinstall.py'
        if (Test-Path $post) { & $Py $post -install | Out-Null }
        $svc = Join-Path $Root 'agent\service\gti_agent_windows_service.py'
        & $Py $svc --startup=auto install
        sc.exe failure $ServiceName reset= 86400 actions= restart/60000/restart/60000/restart/60000 | Out-Null

        Write-Host ''
        Write-Host "ENROLLMENT_SUCCEEDED: agent_id=$($response.agent_id) hub=$($response.hub_url)"
        Write-Host "Service $ServiceName registered (Automatic) but NOT started — Firebird is still unconfigured (by design: this script never guesses a client's database path or credentials)."
        Write-Host "Next: edit $EnvFile (FIREBIRD_DATABASE_PATH, FB_USER, FB_PASSWORD, and COMPANY_CODE/COMPANY_CNPJ if needed),"
        Write-Host '      then: .\gti-agent.ps1 preflight ; .\gti-agent.ps1 start'
    }
    'configure' {
        if ($FromTemplate) {
            Copy-Item -Path $FromTemplate -Destination $EnvFile -Force
            Write-Host "Template copied to $EnvFile. Fill the empty secret values (AGENT_TOKEN, FB_PASSWORD) with a text editor, then run preflight."
        } else {
            $hub = Read-Plain 'Hub URL (https://...)'
            $token = Read-Secret 'AGENT_TOKEN (from register_agent.py)'
            $agentId = Read-Plain 'AGENT_ID (label for this installation)'
            $db = Read-Plain 'FIREBIRD_DATABASE_PATH (real path of the SGV .FDB on THIS host)'
            $fbUser = Read-Plain 'FB_USER (read-only account)' 'SYSDBA'
            $fbPass = Read-Secret 'FB_PASSWORD'
            $code = Read-Plain 'COMPANY_CODE (C000004.CODIGO; empty = auto when unambiguous)'
            $cnpj = Read-Plain 'COMPANY_CNPJ (digits; optional alternative to COMPANY_CODE)'
            $crtSource = Read-Plain 'COMPANY_CRT_SOURCE (AUTO | EMISSOR | C000004)' 'AUTO'
            $lines = @(
                "GTI_HUB_URL=$hub", "AGENT_TOKEN=$token", "AGENT_ID=$agentId",
                "COMPANY_CODE=$code", "COMPANY_CNPJ=$cnpj", "COMPANY_CRT_SOURCE=$crtSource",
                "FIREBIRD_DATABASE_PATH=$db", "FB_USER=$fbUser", "FB_PASSWORD=$fbPass",
                'FISCAL_MODE=DRY_RUN', 'FIREBIRD_WRITES=0', 'POLL_INTERVAL_SECONDS=5', 'AGENT_VERSION=1.1.0'
            )
            Set-Content -Path $EnvFile -Value $lines -Encoding UTF8
        }
        # Only Administrators and SYSTEM may read the file that holds the secrets.
        icacls $EnvFile /inheritance:r /grant:r 'Administrators:(F)' 'SYSTEM:(F)' | Out-Null
        Write-Host "Configuration saved to $EnvFile (restricted ACL). Secrets are not part of the package."
    }
    'preflight' {
        if (-not (Test-Path $Py)) { throw 'Run install first.' }
        & $Py (Join-Path $Root 'agent\scripts\preflight.py') --env-file $EnvFile
        exit $LASTEXITCODE
    }
    'start' {
        Assert-Admin
        & $Py (Join-Path $Root 'agent\scripts\preflight.py') --env-file $EnvFile
        if ($LASTEXITCODE -ne 0) { throw 'PREFLIGHT=FAIL: fix the blockers above before starting the service.' }
        Start-Service $ServiceName
        Write-Host "$ServiceName started."
    }
    'stop' { Assert-Admin; Stop-Service $ServiceName -Force; Write-Host "$ServiceName stopped." }
    'restart' {
        Assert-Admin
        & $Py (Join-Path $Root 'agent\scripts\preflight.py') --env-file $EnvFile
        if ($LASTEXITCODE -ne 0) { throw 'PREFLIGHT=FAIL: not restarting.' }
        Restart-Service $ServiceName -Force
        Write-Host "$ServiceName restarted."
    }
    'status' {
        $svc = Get-Service $ServiceName -ErrorAction SilentlyContinue
        if ($null -eq $svc) { Write-Host 'Service not installed.'; exit 1 }
        Write-Host ("Service {0}: {1} (StartType {2})" -f $svc.Name, $svc.Status, $svc.StartType)
        if (Test-Path $LogFile) { Write-Host '--- last log lines ---'; Get-Content $LogFile -Tail 15 }
    }
    'uninstall' {
        Assert-Admin
        $svcScript = Join-Path $Root 'agent\service\gti_agent_windows_service.py'
        if (Get-Service $ServiceName -ErrorAction SilentlyContinue) {
            Stop-Service $ServiceName -Force -ErrorAction SilentlyContinue
            if (Test-Path $Py) { & $Py $svcScript remove }
        }
        if ($Purge) {
            foreach ($p in @($Venv, (Join-Path $Root 'agent\logs'), (Join-Path $Root 'agent\agent_state.sqlite'), $EnvFile)) { if (Test-Path $p) { Remove-Item $p -Recurse -Force } }
            Write-Host 'Service removed; venv, logs, state and .env deleted.'
        } else {
            Write-Host 'Service removed. Configuration (.env), logs and state were kept (use -Purge to delete them).'
        }
    }
}