【NIC x Ops（にこぷす）通信】（Terraform編）環境構築スクリプト（setup.ps1）と pre-commit × AI自律化で実現するコード品質管理ガイド

################################################################################
# setup.ps1
# このリポジトリの開発環境を自動セットアップするスクリプト
#
# 実行方法（リポジトリルートで 1 回だけ実行）:
#   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
#   .\setup.ps1
################################################################################

$ErrorActionPreference = "Stop"

Write-Host ""
Write-Host "============================================" -ForegroundColor Cyan
Write-Host " Terraform 開発環境セットアップ" -ForegroundColor Cyan
Write-Host "============================================" -ForegroundColor Cyan
Write-Host ""

# ------------------------------------------------------------------------------
# 前提条件チェック（Git for Windows / Python+pip）
# ------------------------------------------------------------------------------
Write-Host "[前提確認] 必須ツールの確認..." -ForegroundColor Yellow
$prereqOk = $true

# Git for Windows の確認
$gitPath = "C:\Program Files\Git\bin\git.exe"
if (Test-Path $gitPath) {
    $gitVer = & $gitPath --version 2>&1
    Write-Host "  [OK] Git for Windows: $gitVer" -ForegroundColor Green
} else {
    Write-Host "  [NG] Git for Windows が見つかりません" -ForegroundColor Red
    Write-Host "       https://git-scm.com/download/win からインストールしてください" -ForegroundColor Red
    $prereqOk = $false
}

# Python + pip の確認
$pythonOk = $false
try {
    $pyVer = python --version 2>&1 | Out-String
    $pipVer = pip --version 2>&1 | Out-String
    if ($pyVer -match "Python \d") {
        Write-Host "  [OK] $($pyVer.Trim())" -ForegroundColor Green
        Write-Host "  [OK] $($pipVer.Trim())" -ForegroundColor Green
        $pythonOk = $true
    }
} catch {}
if (-not $pythonOk) {
    Write-Host "  [NG] Python / pip が見つかりません" -ForegroundColor Red
    Write-Host "       https://www.python.org/downloads/ からインストールしてください" -ForegroundColor Red
    $prereqOk = $false
}

if (-not $prereqOk) {
    Write-Host ""
    Write-Host "[!] 前提条件を満たしていません。上記のツールをインストール後、再度実行してください。" -ForegroundColor Red
    exit 1
}

Write-Host ""

# 1. ツールのインストール（winget）
Write-Host "[1/4] ツールのインストール..." -ForegroundColor Yellow

$tools = @(
    @{ Id = "Hashicorp.Terraform";           Name = "Terraform" },
    @{ Id = "TerraformLinters.tflint";       Name = "TFLint" },
    @{ Id = "Terraform-docs.Terraform-docs"; Name = "terraform-docs" }
)

foreach ($tool in $tools) {
    $installed = winget list --id $tool.Id 2>&1 | Select-String $tool.Id
    if ($installed) {
        Write-Host "  [OK] $($tool.Name) は導入済みです" -ForegroundColor Green
    } else {
        Write-Host "  [..] $($tool.Name) をインストール中..." -ForegroundColor Cyan
        winget install $tool.Id --accept-source-agreements --accept-package-agreements
    }
}

# 2. pre-commit のインストール（pip）
Write-Host ""
Write-Host "[2/4] pre-commit のインストール..." -ForegroundColor Yellow

$pcInstalled = pip show pre-commit 2>&1 | Select-String "Name: pre-commit"
if ($pcInstalled) {
    Write-Host "  [OK] pre-commit は導入済みです" -ForegroundColor Green
} else {
    Write-Host "  [..] pre-commit をインストール中..." -ForegroundColor Cyan
    pip install pre-commit
}

# 3. システム PATH への登録
Write-Host ""
Write-Host "[3/4] PATH の設定..." -ForegroundColor Yellow

function Add-ToUserPath($p) {
    $cur = [System.Environment]::GetEnvironmentVariable("PATH", "User")
    if ($cur -notlike "*$p*") {
        [System.Environment]::SetEnvironmentVariable("PATH", "$p;$cur", "User")
        Write-Host "  [+] PATH に追加: $p" -ForegroundColor Green
    } else {
        Write-Host "  [OK] PATH 登録済み: $p" -ForegroundColor Green
    }
}

# Git bash
@("C:\Program Files\Git\bin", "C:\Program Files\Git\usr\bin") | ForEach-Object {
    if (Test-Path $_) { Add-ToUserPath $_ }
}

# winget 製ツール
$wingetBase = "$env:LOCALAPPDATA\Microsoft\WinGet\Packages"
$pkgs = @(
    @{ Dir = "Hashicorp.Terraform_Microsoft.Winget.Source_8wekyb3d8bbwe";            Exe = "terraform.exe" },
    @{ Dir = "TerraformLinters.tflint_Microsoft.Winget.Source_8wekyb3d8bbwe";        Exe = "tflint.exe" },
    @{ Dir = "Terraform-docs.Terraform-docs_Microsoft.Winget.Source_8wekyb3d8bbwe";  Exe = "terraform-docs.exe" }
)
foreach ($pkg in $pkgs) {
    $dir = Get-ChildItem "$wingetBase\$($pkg.Dir)" -Filter $pkg.Exe -Recurse -ErrorAction SilentlyContinue |
           Select-Object -First 1 -ExpandProperty DirectoryName
    if ($dir) { Add-ToUserPath $dir }
}

# pip Scripts
$pipMatch = [regex]::Match((pip --version 2>&1 | Out-String), 'from (.+?)\\Lib\\'); $pipScripts = if ($pipMatch.Success) { $pipMatch.Groups[1].Value + '\Scripts' } else { "" }
if ($pipScripts -and (Test-Path $pipScripts)) { Add-ToUserPath $pipScripts }

# 4. pre-commit フックの登録
Write-Host ""
Write-Host "[4/4] pre-commit フックの登録..." -ForegroundColor Yellow

$env:PATH = "$pipScripts;C:\Program Files\Git\bin;" + $env:PATH

if (Test-Path ".pre-commit-config.yaml") {
    pre-commit install
    Write-Host "  [OK] pre-commit フックを登録しました" -ForegroundColor Green
} else {
    Write-Host "  [!] .pre-commit-config.yaml が見つかりません。スキップします" -ForegroundColor DarkYellow
}

Write-Host ""
Write-Host "============================================" -ForegroundColor Cyan
Write-Host " セットアップ完了！" -ForegroundColor Cyan
Write-Host "============================================" -ForegroundColor Cyan

repos:
  - repo: https://github.com/antonbabenko/pre-commit-terraform
    rev: v1.105.0
    hooks:
      # 1. Terraform コードの自動フォーマット
      - id: terraform_fmt
        exclude: ^test/

      # 2. TFLint による静的解析（.tflint.hcl を使用）
      - id: terraform_tflint
        exclude: ^test/
        args:
          - --args=--config=__GIT_WORKING_DIR__/.tflint.hcl

      # 3. terraform-docs による README.md 内ドキュメントの自動挿入
      - id: terraform_docs
        exclude: ^test/
        args:
          - --args=--config=.terraform-docs.yml