@ojokesusu/lintasai 1.1.2

package/setup-pola-b.ps1

@@ -0,0 +1,687 @@
+<#
+.SYNOPSIS
+  setup-pola-b.ps1 - Setup Pola B di root proyek (kit embed sebagai subfolder)
+.DESCRIPTION
+  Asumsi: kamu sudah extract zip kit ini jadi <proyek>\.claude-kit\, lalu jalanin
+  script ini dari folder <proyek>\.claude-kit\.
+
+  Script ini ORCHESTRATOR — heavy-lifting di delegate ke lib/*.ps1:
+    - lib\manifest.ps1          : Initialize/Add/Save manifest (.install-manifest.json)
+    - lib\template-deploy.ps1   : Copy template + placeholder substitution
+    - lib\git-helpers.ps1       : Strip .git + Unblock MOTW
+    - lib\agents-md.ps1         : Deploy AGENTS.md (template fill + backup)
+    - lib\version-detect.ps1    : Parse versi kit dari CHANGELOG.md
+    - lib\manifest-signing.ps1  : HMAC sign manifest (loaded via Save-Manifest)
+    - lib\safety.ps1            : Path safety helpers
+
+  Tugas orchestrator:
+    1. Project root validation + nested-extract detection
+    2. Interactive prompts (popup CLAUDE.md, nama, repo, AGENTS.md overwrite)
+    3. Verifikasi file inti kit ada (via lib\kit-files.psd1)
+    4. Call lib functions untuk actual deploy
+    5. Final summary report
+
+  TIDAK install ke ~/.claude/ (itu Pola Global, pakai install-windows.ps1).
+.PARAMETER Force
+  Timpa AGENTS.md yang sudah ada (backup otomatis ke .backup-<timestamp>).
+  Saat -Force aktif, prompt opsional Nama/URL repo di-skip (placeholder default dipakai).
+.PARAMETER DryRun
+  Tampilkan rencana aksi tanpa nulis/copy file apapun.
+.NOTES
+  Versi  : 2.0 (orchestrator refactor, 2026-06-06)
+  Run    : powershell -ExecutionPolicy Bypass -File .\setup-pola-b.ps1
+  Atau   : cd <proyek>\.claude-kit; .\setup-pola-b.ps1
+  Lebih ringkas: .\.claude-kit\kit.ps1 setup
+#>
+
+[CmdletBinding()]
+param(
+    [switch]$Force,
+    [switch]$DryRun,
+    [switch]$SkipTeamFiles
+)
+
+$ErrorActionPreference = 'Stop'
+
+# ---- Resolve folder kit (tempat script ini berada) ----
+$KitDir = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
+
+# ---- Dot-source library helpers (heavy-lifting) ----
+# Order penting: agents-md.ps1 dot-source SEBELUM manifest.ps1.
+# agents-md.ps1 punya guard `if ($script:__lintasAI_AgentsMdLoaded)` (anti-redefine).
+# manifest.ps1 set `Set-StrictMode -Version Latest` yang kebawa ke caller scope —
+# strict mode reject access ke variable yang belum di-set. Kalau order kebalik,
+# guard agents-md crash karena `$script:__lintasAI_AgentsMdLoaded` belum ada.
+$script:__lintasAI_AgentsMdLoaded = $null
+. (Join-Path $KitDir 'lib\safety.ps1')
+. (Join-Path $KitDir 'lib\agents-md.ps1')
+. (Join-Path $KitDir 'lib\template-deploy.ps1')
+. (Join-Path $KitDir 'lib\git-helpers.ps1')
+. (Join-Path $KitDir 'lib\version-detect.ps1')
+. (Join-Path $KitDir 'lib\manifest.ps1')
+# manifest-signing.ps1 di-load on-demand oleh Save-Manifest (lib\manifest.ps1)
+
+# ---- Deteksi NESTED extract (zip extract jadi folder dalam folder) ----
+# Skenario: Windows Explorer "Extract All" sering bikin .claude-kit\<kit-folder>\...
+$kitFolderName = Split-Path -Leaf $KitDir
+$parentDir = Split-Path -Parent $KitDir
+$parentFolderName = Split-Path -Leaf $parentDir
+
+if ($kitFolderName -ne '.claude-kit' -and $parentFolderName -eq '.claude-kit') {
+    Write-Host "DETEKSI: Kit ter-extract NESTED - script ada di '$kitFolderName' di dalam '.claude-kit'." -ForegroundColor Yellow
+    Write-Host "        Ini biasa terjadi kalau extract pakai Windows Explorer (Extract All)." -ForegroundColor Yellow
+    Write-Host ""
+
+    if (-not $Force -and -not $DryRun) {
+        # Wrap Read-Host di try/catch — gracefully handle NonInteractive shell.
+        # Default ke 'N' (abort, jangan auto-flatten destruktif tanpa user consent).
+        $autoFix = 'N'
+        try {
+            $autoFix = Read-Host "Mau aku auto-flatten? (pindahkan isi '$kitFolderName' ke '.claude-kit', hapus folder kosong) [Y/N]"
+        } catch {
+            Write-Host "INFO: Shell NonInteractive terdeteksi. Auto-flatten butuh konfirmasi user — abort." -ForegroundColor Yellow
+            Write-Host "      Jalankan di PowerShell window untuk pilih Y/N, atau pakai -Force untuk auto-yes." -ForegroundColor Yellow
+            $autoFix = 'N'
+        }
+        if ($autoFix -notmatch '^[Yy]') {
+            Write-Host "Dibatalkan. Untuk fix manual:" -ForegroundColor Yellow
+            Write-Host "  1. Pindahkan SEMUA isi '$KitDir' ke parent '$parentDir'." -ForegroundColor Yellow
+            Write-Host "  2. Hapus folder kosong '$KitDir'." -ForegroundColor Yellow
+            Write-Host "  3. Jalankan ulang setup-pola-b.ps1 dari '$parentDir\setup-pola-b.ps1'." -ForegroundColor Yellow
+            exit 1
+        }
+    }
+
+    if ($DryRun) {
+        Write-Host "[DRY] Akan flatten: pindahkan '$KitDir\*' ke '$parentDir\', hapus '$KitDir'." -ForegroundColor Yellow
+        Write-Host "[DRY] Setelah flatten, validasi 13 file inti + setup AGENTS.md akan jalan dari '$parentDir'." -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "Mode DRY-RUN: berhenti setelah preview nested. Jalankan ulang tanpa -DryRun untuk eksekusi sungguhan." -ForegroundColor Cyan
+        exit 0
+    } else {
+        try {
+            Write-Host "FLATTEN: $KitDir\* -> $parentDir\" -ForegroundColor Cyan
+            Get-ChildItem -Path $KitDir -Force | Move-Item -Destination $parentDir -Force
+            Remove-Item -Path $KitDir -Recurse -Force
+            Write-Host "OK    Flatten selesai." -ForegroundColor Green
+            $KitDir = $parentDir
+            $kitFolderName = Split-Path -Leaf $KitDir
+            Write-Host ""
+        } catch {
+            Write-Host "GAGAL flatten: $_" -ForegroundColor Red
+            Write-Host "       Fix manual: pindahkan isi $KitDir ke parent, hapus folder kosong." -ForegroundColor Red
+            $sisaFiles = Get-ChildItem -Path $KitDir -Force -ErrorAction SilentlyContinue
+            if ($sisaFiles) {
+                Write-Host "       File yang masih di ${KitDir}:" -ForegroundColor Yellow
+                $sisaFiles | ForEach-Object { Write-Host "         $($_.Name)" -ForegroundColor Yellow }
+            }
+            exit 1
+        }
+    }
+}
+
+# ---- Validasi: kit harus berada di subfolder bernama .claude-kit ----
+if ($kitFolderName -ne '.claude-kit') {
+    Write-Host "PERINGATAN: Folder kit ini bernama '$kitFolderName', bukan '.claude-kit'." -ForegroundColor Yellow
+    Write-Host "          Pola B mengasumsikan kit ada di '<proyek>\.claude-kit\'." -ForegroundColor Yellow
+    Write-Host "          Aku tetap lanjut, tapi AGENTS.md akan rujuk path '.\$kitFolderName\'" -ForegroundColor Yellow
+    Write-Host "          - kalau mau path standar, rename folder ini jadi '.claude-kit' dulu." -ForegroundColor Yellow
+    Write-Host ""
+}
+
+# ---- Resolve root proyek (parent dari folder kit) ----
+$ProjectRoot = Split-Path -Parent $KitDir
+$ProjectName = Split-Path -Leaf $ProjectRoot
+$Today = Get-Date -Format 'yyyy-MM-dd'
+$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+
+# ---- Init manifest state (lib\manifest.ps1) ----
+$manifestState = Initialize-Manifest -ProjectRoot $ProjectRoot
+
+# ---- Resolve label versi kit dari CHANGELOG.md (lib\version-detect.ps1) ----
+$kitChangelog = Join-Path $KitDir 'CHANGELOG.md'
+$detectedVersion = Get-KitVersionFromChangelog -ChangelogPath $kitChangelog
+$KitVersion = if ($detectedVersion) { $detectedVersion } else { 'pre-launch (testing)' }
+
+# ---- Validasi: root proyek terlihat valid ----
+if (-not (Test-Path $ProjectRoot)) {
+    Write-Host "ERROR: Root proyek tidak ditemukan: $ProjectRoot" -ForegroundColor Red
+    Write-Host "       Pastikan folder kit ini ada di dalam folder proyek." -ForegroundColor Red
+    exit 1
+}
+
+# ---- Strip .claude-kit/.git/ (lib\git-helpers.ps1) ----
+# Saat kit di-clone (bukan zip-extract), folder .git/ ikut ke project. Bersihkan
+# SEKALI di awal setup. Idempotent: skip kalau folder tidak ada.
+if (-not $DryRun) {
+    $gitOk = Remove-GitMetadata -Path $KitDir
+    if ($gitOk) {
+        # Only print success kalau folder memang sempat ada (Remove-GitMetadata
+        # return $true juga untuk no-op). Cek silent: kalau .git masih ada = gagal.
+        if (-not (Test-Path -LiteralPath (Join-Path $KitDir '.git'))) {
+            # Silent kalau no-op (cleaner output); kit-clone case akan log via Write-Verbose.
+        }
+    } else {
+        Write-Host "WARN  Gagal hapus .claude-kit\.git\ (lihat Write-Warning di atas)" -ForegroundColor Yellow
+    }
+}
+
+# ---- Mark-of-the-Web unblock (lib\git-helpers.ps1) ----
+if (-not $DryRun) {
+    $motwOk = Remove-MotwBlock -Path $KitDir
+    if ($motwOk) {
+        Write-Host "OK    Mark-of-the-Web di-unblock untuk semua file kit." -ForegroundColor Green
+    } else {
+        Write-Host "PERINGATAN: Unblock-File gagal (script tetap lanjut, mungkin perlu Unblock-File manual)" -ForegroundColor Yellow
+    }
+}
+
+# ---- Deteksi CLAUDE.md existing (proyek setengah jadi mungkin punya aturan custom) ----
+$claudeMdPath = Join-Path $ProjectRoot 'CLAUDE.md'
+if (Test-Path $claudeMdPath) {
+    Write-Host ""
+    Write-Host "DETEKSI: CLAUDE.md sudah ada di root proyek ($claudeMdPath)." -ForegroundColor Yellow
+    Write-Host "        Pola B pakai AGENTS.md (BUKAN CLAUDE.md) untuk override proyek." -ForegroundColor Yellow
+    Write-Host "        Kalau punya 2 file aturan, AI bisa bingung mana yang menang."
+    if (-not $Force -and -not $DryRun) {
+        Write-Host ""
+        Write-Host "Pilih aksi:" -ForegroundColor Cyan
+        Write-Host "  [1] Rename CLAUDE.md jadi CLAUDE.md.legacy-$Timestamp lalu lanjut setup"
+        Write-Host "  [2] Biarkan dua-duanya (AGENTS.md proyek menang per Path resolution rule)"
+        Write-Host "  [3] Batalkan setup (mau merge manual dulu)"
+        $choice = '2'
+        try {
+            $choice = Read-Host "Pilih [1/2/3]"
+            if ([string]::IsNullOrWhiteSpace($choice)) { $choice = '2' }
+        } catch {
+            Write-Host "INFO: Shell NonInteractive terdeteksi, pakai default [2] biarkan CLAUDE.md." -ForegroundColor Yellow
+            Write-Host "      (Jalankan di PowerShell window kalau mau pilih [1]/[3], atau pakai -Force untuk skip prompt.)" -ForegroundColor Yellow
+            $choice = '2'
+        }
+        switch ($choice) {
+            '1' {
+                $legacyName = "$claudeMdPath.legacy-$Timestamp"
+                try {
+                    Move-Item $claudeMdPath $legacyName -Force
+                    Write-Host "RENAMED  $claudeMdPath -> $legacyName" -ForegroundColor Green
+                } catch {
+                    Write-Host "GAGAL rename CLAUDE.md: $_" -ForegroundColor Red
+                    Write-Host "       Kemungkinan file lagi di-open di editor (VS Code/Notepad)." -ForegroundColor Red
+                    Write-Host "       Tutup editor + jalankan ulang script, atau pilih opsi [2] biarkan." -ForegroundColor Red
+                    exit 1
+                }
+            }
+            '3' {
+                Write-Host "Dibatalkan. Setup tidak dilanjutkan." -ForegroundColor Yellow
+                exit 0
+            }
+            default {
+                Write-Host "INFO: Membiarkan CLAUDE.md existing. AGENTS.md baru akan dibuat." -ForegroundColor Cyan
+                Write-Host "      Pastikan tim paham: AGENTS.md menang untuk override per Path resolution rule." -ForegroundColor Cyan
+            }
+        }
+    } elseif ($DryRun) {
+        Write-Host "[DRY] (interactive mode bakal tanya rename/biarkan/batal - pakai -Force untuk skip prompt)" -ForegroundColor Yellow
+    }
+    Write-Host ""
+}
+
+Write-Host ""
+Write-Host "=== Setup Pola B (kit embed di proyek) ===" -ForegroundColor Cyan
+Write-Host "Folder kit    : $KitDir"
+Write-Host "Root proyek   : $ProjectRoot"
+Write-Host "Nama proyek   : $ProjectName"
+Write-Host "Tanggal       : $Today"
+if ($DryRun) {
+    Write-Host "Mode          : DRY-RUN (tidak ada file yang ditulis)" -ForegroundColor Yellow
+}
+Write-Host ""
+
+# ---- Verifikasi file inti kit ada ----
+# Source of truth: lib\kit-files.psd1 (single manifest, di-load semua konsumen)
+$kitFilesPsd1 = Join-Path $KitDir 'lib\kit-files.psd1'
+if (-not (Test-Path $kitFilesPsd1)) {
+    Write-Host "ERROR: lib\kit-files.psd1 hilang. Extract ulang zip kit." -ForegroundColor Red
+    exit 1
+}
+$kitFiles = Import-PowerShellDataFile -Path $kitFilesPsd1
+$wajibAda = @(
+    $kitFiles.core_prompts +
+    $kitFiles.universal_rules +
+    $kitFiles.scripts +
+    $kitFiles.lib_files +
+    $kitFiles.templates +
+    $kitFiles.docs +
+    $kitFiles.tests +
+    $kitFiles.ci +
+    $kitFiles.meta
+) | ForEach-Object { $_ -replace '/', '\' }
+
+$missing = @()
+foreach ($f in $wajibAda) {
+    $p = Join-Path $KitDir $f
+    if (-not (Test-Path $p)) { $missing += $f }
+}
+
+if ($missing.Count -gt 0) {
+    Write-Host "ERROR: Kit tidak lengkap. File hilang:" -ForegroundColor Red
+    foreach ($f in $missing) { Write-Host "        - $f" -ForegroundColor Red }
+    Write-Host ""
+    Write-Host "       Extract ulang zip kit ke folder ini, lalu jalankan script lagi." -ForegroundColor Red
+    exit 1
+}
+Write-Host ("OK    {0} file inti kit terverifikasi" -f $wajibAda.Count) -ForegroundColor Green
+
+# ---- Deploy lib/ helper scripts (track ke manifest) ----
+$libDir = Join-Path $KitDir 'lib'
+if (-not (Test-Path $libDir)) {
+    if (-not $DryRun) {
+        New-Item -ItemType Directory -Path $libDir -Force | Out-Null
+        Add-DirToManifest -State $manifestState -DirPath $libDir
+        Write-Host "CREATED $libDir\" -ForegroundColor Green
+    } else {
+        Write-Host "[DRY] CREATE $libDir\" -ForegroundColor Yellow
+    }
+}
+$libFiles = @('rollback.ps1', 'safety.ps1', 'manifest-signing.ps1')
+foreach ($lf in $libFiles) {
+    $lfPath = Join-Path $libDir $lf
+    if (Test-Path $lfPath) {
+        if (-not $DryRun) {
+            Add-ToManifest -State $manifestState -FilePath $lfPath -Kind 'lib' -From ('.claude-kit/lib/' + $lf)
+            Write-Host ("OK    {0} (tracked)" -f $lfPath) -ForegroundColor Green
+        } else {
+            Write-Host ("[DRY] TRACK {0}" -f $lfPath) -ForegroundColor Yellow
+        }
+    } else {
+        Write-Host ("WARN  lib file tidak ditemukan: {0} (skip track)" -f $lfPath) -ForegroundColor Yellow
+    }
+}
+
+# ---- Tanya optional info untuk fill placeholder ----
+$ownerName = ''
+$repoUrl = ''
+if (-not $Force -and -not $DryRun) {
+    Write-Host ""
+    Write-Host "Optional: isi info berikut untuk pre-fill AGENTS.md (Enter = pakai default):" -ForegroundColor Cyan
+    try {
+        $ownerName = Read-Host ("Nama kamu (default: {0})" -f $env:USERNAME)
+        $repoUrl = Read-Host "URL repo standar tim (Enter = 'belum-ada')"
+    } catch {
+        Write-Host "INFO: Shell NonInteractive terdeteksi, pakai default value." -ForegroundColor Yellow
+        Write-Host "      (Jalankan setup langsung di PowerShell window kalau mau isi prompt.)" -ForegroundColor Yellow
+    }
+}
+# Fallback default kalau kosong (skip prompt karena -Force/-DryRun, atau user tekan Enter)
+if (-not $ownerName) { $ownerName = $env:USERNAME }
+if (-not $repoUrl) { $repoUrl = 'belum-ada (solo project)' }
+
+# ---- Setup AGENTS.md di root proyek (lib\agents-md.ps1) ----
+$agentsTemplate = Join-Path $KitDir 'AGENTS.md.template'
+$agentsTarget = Join-Path $ProjectRoot 'AGENTS.md'
+
+# Decide preserve vs overwrite + handle interactive prompt
+$shouldPreserve = $false
+if (Test-Path $agentsTarget) {
+    if (-not $Force -and -not $DryRun) {
+        Write-Host ""
+        Write-Host "PERHATIAN: $agentsTarget sudah ada." -ForegroundColor Yellow
+        Write-Host "          Pakai -Force untuk backup + timpa." -ForegroundColor Yellow
+        Write-Host "          Atau hapus AGENTS.md existing manual, lalu jalankan script lagi." -ForegroundColor Yellow
+        $answer = 'N'
+        try {
+            $answer = Read-Host "Backup AGENTS.md existing + timpa dengan template baru? (Y/N)"
+        } catch {
+            Write-Host "INFO: Shell NonInteractive terdeteksi. AGENTS.md existing dipertahankan (default safe)." -ForegroundColor Yellow
+            Write-Host "      Pakai -Force kalau memang mau timpa, atau jalankan di PowerShell window." -ForegroundColor Yellow
+            $answer = 'N'
+        }
+        if ($answer -notmatch '^[Yy]') {
+            Write-Host "Dibatalkan oleh user. AGENTS.md existing tidak diubah." -ForegroundColor Yellow
+            Write-Host "Setup tetap OK - kit di .claude-kit\ siap dipakai." -ForegroundColor Green
+            exit 0
+        }
+    }
+}
+
+# Build placeholder set (shared dengan docs/ templates di bawah)
+$agentsPlaceholders = @{
+    '<NAMA_PROYEK>'      = $ProjectName
+    '<TANGGAL_HARI_INI>' = $Today
+    '<NAMA_KAMU>'        = $ownerName
+    '<URL_REPO_STANDAR>' = $repoUrl
+    '<VERSI_KIT>'        = $KitVersion
+}
+
+if ($DryRun) {
+    Write-Host "[DRY] DEPLOY AGENTS.md (template fill + backup kalau existing)" -ForegroundColor Yellow
+    Write-Host "[DRY] Placeholders: NAMA_PROYEK='$ProjectName', TANGGAL_HARI_INI='$Today', VERSI_KIT='$KitVersion'" -ForegroundColor Yellow
+} else {
+    try {
+        $deployResult = Deploy-AgentsMd `
+            -ProjectRoot $ProjectRoot `
+            -TemplatePath $agentsTemplate `
+            -Placeholders $agentsPlaceholders
+        # Track backup ke manifest kalau ada
+        if ($deployResult.backup_path) {
+            Add-ToManifest -State $manifestState -FilePath $deployResult.backup_path -Kind 'backup' -From 'AGENTS.md (pre-Force backup)'
+            Write-Host "BACKUP $agentsTarget -> $($deployResult.backup_path)" -ForegroundColor Yellow
+        }
+        Add-ToManifest -State $manifestState -FilePath $deployResult.target_path -Kind 'filled_template' -From 'AGENTS.md.template'
+        Write-Host "OK    $($deployResult.target_path)" -ForegroundColor Green
+        $filled = "NAMA_PROYEK='$ProjectName', TANGGAL_HARI_INI='$Today', NAMA_KAMU='$ownerName', URL_REPO_STANDAR='$repoUrl', VERSI_KIT='$KitVersion'"
+        Write-Host "      Pre-filled: $filled" -ForegroundColor Green
+    } catch {
+        Write-Host "GAGAL deploy AGENTS.md: $_" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# ---- Bootstrap docs/ skeleton ----
+$docsDir = Join-Path $ProjectRoot 'docs'
+
+# Sanity check: proyek hampir kosong? Skip docs/ skeleton supaya tidak prematur.
+$excludeNames = @(
+    '.git', '.claude-kit', 'AGENTS.md', 'docs',
+    'node_modules', 'vendor', 'dist', 'build', 'out', 'target',
+    '__pycache__', '.venv', 'venv', '.next', '.nuxt', '.turbo', '.cache'
+)
+$nonHiddenFiles = @(Get-ChildItem -Path $ProjectRoot -Force -ErrorAction SilentlyContinue | Where-Object {
+    $_.Name -notin $excludeNames -and -not $_.Name.StartsWith('.')
+})
+$proyekHampirKosong = ($nonHiddenFiles.Count -le 1)
+
+if ($proyekHampirKosong) {
+    Write-Host ""
+    Write-Host "INFO: Proyek terlihat hampir kosong - skip docs/ skeleton (terlalu prematur)." -ForegroundColor Cyan
+    Write-Host "      Setelah ada code, jalankan ulang AI dengan prompt PROJECT_LIFECYCLE_PROMPT_v1.md (Stage B: Bootstrap Docs)" -ForegroundColor Cyan
+} else {
+    if (-not (Test-Path $docsDir)) {
+        if (-not $DryRun) {
+            New-Item -ItemType Directory -Path $docsDir -Force | Out-Null
+            Add-DirToManifest -State $manifestState -DirPath $docsDir
+            Write-Host ""
+            Write-Host "CREATED $docsDir\" -ForegroundColor Green
+        } else {
+            Write-Host "[DRY] CREATE $docsDir\" -ForegroundColor Yellow
+        }
+    }
+
+    # Templates dengan placeholder substitution
+    $docsTemplatesWithPlaceholder = @(
+        @{ Src = 'templates\architecture.md'; Dst = (Join-Path $docsDir 'architecture.md'); From = 'templates/architecture.md'; Placeholders = @{
+            '<NAMA_PROYEK>' = $ProjectName
+            '[TBD: tanggal hari ini, format YYYY-MM-DD]' = $Today
+            '[TBD: YYYY-MM-DD]' = $Today
+        }},
+        @{ Src = 'templates\glossary.md'; Dst = (Join-Path $docsDir 'glossary.md'); From = 'templates/glossary.md'; Placeholders = @{
+            '<NAMA_PROYEK>' = $ProjectName
+            '<YYYY-MM-DD>' = $Today
+        }}
+    )
+    foreach ($t in $docsTemplatesWithPlaceholder) {
+        $tSrc = Join-Path $KitDir $t.Src
+        $tDst = $t.Dst
+        if (Test-Path $tDst) {
+            Write-Host "SKIP    $tDst (sudah ada, tidak di-overwrite)" -ForegroundColor Yellow
+        } elseif (-not (Test-Path $tSrc)) {
+            Write-Host ("WARN  Template tidak ditemukan: {0} (skip)" -f $tSrc) -ForegroundColor Yellow
+        } elseif (-not $DryRun) {
+            $r = Copy-TemplateWithPlaceholder -SourcePath $tSrc -TargetPath $tDst -Placeholders $t.Placeholders -IfExists 'Skip'
+            if ($r.copied) {
+                Add-ToManifest -State $manifestState -FilePath $tDst -Kind 'skeleton' -From $t.From
+                Write-Host ("OK    {0} (skeleton, pre-filled NAMA_PROYEK='{1}')" -f $tDst, $ProjectName) -ForegroundColor Green
+            } elseif ($r.action -eq 'missing') {
+                Write-Host ("GAGAL copy {0}: source missing" -f $t.Dst) -ForegroundColor Red
+            }
+        } else {
+            Write-Host "[DRY] COPY  $tSrc -> $tDst" -ForegroundColor Yellow
+        }
+    }
+
+    # 3 file template tambahan (tanpa placeholder substitution, plain copy)
+    $extraTemplates = @(
+        @{ TemplateName = '_PATTERNS.md';          TargetName = '_PATTERNS.md';          Desc = 'aturan dokumentasi tim profesional generic' },
+        @{ TemplateName = '_EXAMPLE.md';           TargetName = '_EXAMPLE.md';           Desc = 'contoh format .md pendamping siap-copy' },
+        @{ TemplateName = 'architecture_auto.md';  TargetName = 'architecture_auto.md';  Desc = 'registry TOC AI-maintained skeleton' }
+    )
+    foreach ($t in $extraTemplates) {
+        $tSrc = Join-Path $KitDir ('templates\' + $t.TemplateName)
+        $tDst = Join-Path $docsDir $t.TargetName
+        if (Test-Path $tDst) {
+            Write-Host "SKIP    $tDst (sudah ada, tidak di-overwrite)" -ForegroundColor Yellow
+        } elseif (-not (Test-Path $tSrc)) {
+            Write-Host ("WARN  Template tidak ditemukan: {0} (skip)" -f $tSrc) -ForegroundColor Yellow
+        } elseif (-not $DryRun) {
+            $r = Copy-StaticTemplate -SourcePath $tSrc -TargetPath $tDst -IfExists 'Skip'
+            if ($r.copied) {
+                Add-ToManifest -State $manifestState -FilePath $tDst -Kind 'skeleton' -From ('templates/' + $t.TemplateName)
+                Write-Host ("OK    {0} ({1})" -f $tDst, $t.Desc) -ForegroundColor Green
+            } elseif ($r.action -eq 'missing') {
+                Write-Host ("GAGAL copy {0}: source missing" -f $t.TargetName) -ForegroundColor Red
+            }
+        } else {
+            Write-Host "[DRY] COPY  $tSrc -> $tDst" -ForegroundColor Yellow
+        }
+    }
+}
+
+# ---- Bootstrap TIM files (Team Mode T = default) ----
+if (-not $SkipTeamFiles -and -not $proyekHampirKosong) {
+    Write-Host ""
+    Write-Host "=== Copy file tim (Team Mode) ===" -ForegroundColor Cyan
+
+    # Buat folder .github/ + workflows + scripts kalau belum ada
+    $githubDir = Join-Path $ProjectRoot '.github'
+    $workflowsDir = Join-Path $githubDir 'workflows'
+    $scriptsDir = Join-Path $githubDir 'scripts'
+    foreach ($d in @($githubDir, $workflowsDir, $scriptsDir)) {
+        if (-not (Test-Path $d) -and -not $DryRun) {
+            New-Item -ItemType Directory -Path $d -Force | Out-Null
+            Add-DirToManifest -State $manifestState -DirPath $d
+            Write-Host ("CREATED {0}\" -f $d) -ForegroundColor Green
+        }
+    }
+
+    # Buat folder docs/decisions/ kalau belum ada
+    $decisionsDir = Join-Path $docsDir 'decisions'
+    if (-not (Test-Path $decisionsDir) -and -not $DryRun) {
+        New-Item -ItemType Directory -Path $decisionsDir -Force | Out-Null
+        Add-DirToManifest -State $manifestState -DirPath $decisionsDir
+        Write-Host ("CREATED {0}\" -f $decisionsDir) -ForegroundColor Green
+    }
+
+    # Mapping file tim: src (di .claude-kit) -> dst (di project root)
+    $teamFiles = @(
+        @{ Src = 'templates\github\workflows\ai-review.yml';    Dst = (Join-Path $workflowsDir 'ai-review.yml');     Desc = 'GitHub Action Senior AI Reviewer' },
+        @{ Src = 'templates\github\workflows\backup-schemas.yml'; Dst = (Join-Path $workflowsDir 'backup-schemas.yml'); Desc = 'GitHub Action daily backup pg_dump per-schema (L3 backup)' },
+        @{ Src = 'templates\github\scripts\ai-review.js';       Dst = (Join-Path $scriptsDir 'ai-review.js');        Desc = 'Script Senior AI Reviewer' },
+        @{ Src = 'templates\github\CODEOWNERS.template';        Dst = (Join-Path $githubDir 'CODEOWNERS');           Desc = 'CODEOWNERS template (WAJIB edit dengan username actual)' },
+        @{ Src = 'templates\github\pull_request_template.md';   Dst = (Join-Path $githubDir 'pull_request_template.md'); Desc = 'PR template tim' },
+        @{ Src = 'templates\CLAUDE_TEAM_GUIDE.md';     Dst = (Join-Path $docsDir 'CLAUDE_TEAM_GUIDE.md');   Desc = 'Panduan tim AI-first' },
+        @{ Src = 'templates\PROMPT_LIBRARY.md';        Dst = (Join-Path $docsDir 'PROMPT_LIBRARY.md');      Desc = '15 prompt pattern siap-pakai (1-10 generic + 11-15 chat-driven)' },
+        @{ Src = 'templates\ONBOARDING.md';            Dst = (Join-Path $docsDir 'ONBOARDING.md');          Desc = 'Playbook dev baru' },
+        @{ Src = 'templates\STACK_GUIDE.md';           Dst = (Join-Path $docsDir 'STACK_GUIDE.md');         Desc = 'Next.js + Vercel + SEO + security' },
+        @{ Src = 'templates\STACK_MIGRATION_GUIDE.md'; Dst = (Join-Path $docsDir 'STACK_MIGRATION_GUIDE.md'); Desc = 'Migrasi Vercel -> Railway/Render (ADVANCED post-launch)' },
+        @{ Src = 'templates\MCP_SETUP.md';             Dst = (Join-Path $docsDir 'MCP_SETUP.md');           Desc = 'MCP setup + Decision Tree Postgres/Supabase' },
+        @{ Src = 'templates\RLS_SETUP_PROMPT.md';      Dst = (Join-Path $docsDir 'RLS_SETUP_PROMPT.md');    Desc = 'RLS setup prompt untuk staff IT schema-scoped' },
+        @{ Src = 'templates\DB_SCHEMA_SCAN_PROMPT.md'; Dst = (Join-Path $docsDir 'DB_SCHEMA_SCAN_PROMPT.md'); Desc = 'Scan DB schema -> docs/db-schema.md' },
+        @{ Src = 'templates\GLOSSARY_NON_PROGRAMMER.md'; Dst = (Join-Path $docsDir 'GLOSSARY_NON_PROGRAMMER.md'); Desc = 'Glossary istilah teknis untuk non-programmer (WAJIB baca dulu)' },
+        @{ Src = 'templates\ANALOGI_LIBRARY.md';        Dst = (Join-Path $docsDir 'ANALOGI_LIBRARY.md');     Desc = '30 jargon teknis x 3-layer analogi tools digital populer Indonesia (cadangan rujukan AI)' },
+        @{ Src = 'templates\UPDATE_GUIDE.md';           Dst = (Join-Path $docsDir 'UPDATE_GUIDE.md');        Desc = 'Panduan staff IT non-programmer cara update kit (4-tier strategy + analogi tools digital)' },
+        @{ Src = 'templates\SECURITY_INCIDENT_PLAYBOOK.md'; Dst = (Join-Path $docsDir 'SECURITY_INCIDENT_PLAYBOOK.md'); Desc = 'Security incident playbook (kalau token bocor / data leak)' },
+        @{ Src = 'templates\feature-flags-advanced.md'; Dst = (Join-Path $docsDir 'feature-flags-advanced.md'); Desc = 'Feature flag pattern (ADVANCED, post-launch only)' },
+        @{ Src = 'templates\decisions\_TEMPLATE.md';   Dst = (Join-Path $decisionsDir '_TEMPLATE.md');      Desc = 'ADR template' },
+        @{ Src = 'templates\decisions\README.md';      Dst = (Join-Path $decisionsDir 'README.md');         Desc = 'ADR folder README' }
+    )
+
+    foreach ($t in $teamFiles) {
+        $tSrc = Join-Path $KitDir $t.Src
+        $tDst = $t.Dst
+        if (Test-Path $tDst) {
+            Write-Host ("SKIP    {0} (sudah ada, tidak di-overwrite)" -f $tDst) -ForegroundColor Yellow
+        } elseif (-not (Test-Path $tSrc)) {
+            Write-Host ("WARN  File tim tidak ditemukan di kit: {0} (skip)" -f $tSrc) -ForegroundColor Yellow
+        } elseif (-not $DryRun) {
+            $r = Copy-StaticTemplate -SourcePath $tSrc -TargetPath $tDst -IfExists 'Skip'
+            if ($r.copied) {
+                # Pakai forward slash di field 'from' supaya konsisten cross-platform di JSON
+                $fromRel = $t.Src.Replace('\','/')
+                Add-ToManifest -State $manifestState -FilePath $tDst -Kind 'team_file' -From $fromRel
+                Write-Host ("OK    {0} ({1})" -f $tDst, $t.Desc) -ForegroundColor Green
+            } elseif ($r.action -eq 'missing') {
+                Write-Host ("GAGAL copy {0}: source missing" -f $t.Src) -ForegroundColor Red
+            }
+        } else {
+            Write-Host "[DRY] COPY  $tSrc -> $tDst" -ForegroundColor Yellow
+        }
+    }
+
+    # Copy docs/SIGNED_RELEASE.md (sourced dari kit's docs/ folder, bukan templates/)
+    $signedReleaseSrc = Join-Path $KitDir 'docs\SIGNED_RELEASE.md'
+    $signedReleaseDst = Join-Path $docsDir 'SIGNED_RELEASE.md'
+    if (Test-Path $signedReleaseDst) {
+        Write-Host ("SKIP    {0} (sudah ada, tidak di-overwrite)" -f $signedReleaseDst) -ForegroundColor Yellow
+    } elseif (-not (Test-Path $signedReleaseSrc)) {
+        Write-Host ("WARN  docs/SIGNED_RELEASE.md tidak ditemukan di kit: {0} (skip)" -f $signedReleaseSrc) -ForegroundColor Yellow
+    } elseif (-not $DryRun) {
+        # Pastikan docs/ ada (edge case kalau heuristic skip creation tapi user disable -SkipTeamFiles)
+        if (-not (Test-Path $docsDir)) {
+            New-Item -ItemType Directory -Path $docsDir -Force | Out-Null
+            Add-DirToManifest -State $manifestState -DirPath $docsDir
+        }
+        $r = Copy-StaticTemplate -SourcePath $signedReleaseSrc -TargetPath $signedReleaseDst -IfExists 'Skip'
+        if ($r.copied) {
+            Add-ToManifest -State $manifestState -FilePath $signedReleaseDst -Kind 'team_file' -From 'docs/SIGNED_RELEASE.md'
+            Write-Host ("OK    {0} (panduan verifikasi signed release)" -f $signedReleaseDst) -ForegroundColor Green
+        }
+    } else {
+        Write-Host "[DRY] COPY  $signedReleaseSrc -> $signedReleaseDst" -ForegroundColor Yellow
+    }
+
+    Write-Host ""
+    Write-Host "REMINDER untuk Team Mode:" -ForegroundColor Cyan
+    Write-Host "  1. Edit .github\CODEOWNERS - ganti placeholder dengan GitHub username actual."
+    Write-Host "  2. Setup ANTHROPIC_API_KEY di GitHub repo Settings -> Secrets -> Actions."
+    Write-Host "  3. Baca docs\CLAUDE_TEAM_GUIDE.md (panduan tim) + docs\PROMPT_LIBRARY.md."
+    Write-Host "  4. Kalau pakai DB: setup schema isolation + RLS:"
+    Write-Host "       - docs\MCP_SETUP.md (PostgreSQL MCP default, Supabase MCP owner-only)"
+    Write-Host "       - docs\RLS_SETUP_PROMPT.md (paste prompt RLS untuk staff IT)"
+    Write-Host "       - docs\DB_SCHEMA_SCAN_PROMPT.md (paste prompt scan schema -> docs\db-schema.md)"
+} elseif ($SkipTeamFiles) {
+    Write-Host ""
+    Write-Host "INFO: -SkipTeamFiles aktif (advanced escape hatch) - skip copy .github/ + docs tim." -ForegroundColor Cyan
+}
+
+# ---- Save install manifest (lib\manifest.ps1 — merge + HMAC sign + write JSON) ----
+if (-not $DryRun) {
+    try {
+        $saveResult = Save-Manifest `
+            -State $manifestState `
+            -KitDir $KitDir `
+            -KitVersion $KitVersion `
+            -ProjectName $ProjectName
+
+        # ---- Ensure .claude-kit/.gitignore ignore manifest + backup files ----
+        # APPEND-if-missing pattern: preserve existing .gitignore, tambah entries yang belum ada.
+        $gitignorePath = Join-Path $KitDir '.gitignore'
+        $requiredEntries = @(
+            '.install-manifest.json',
+            '*.bak',
+            '*.backup-*',
+            '*.env',
+            '*.env.local',
+            '*.pem',
+            '*.key'
+        )
+        $existingLines = @()
+        if (Test-Path -LiteralPath $gitignorePath) {
+            $existingLines = @(Get-Content -LiteralPath $gitignorePath -Encoding UTF8 -ErrorAction SilentlyContinue)
+        }
+        $missingEntries = @($requiredEntries | Where-Object { $existingLines -notcontains $_ })
+        if ($missingEntries.Count -gt 0) {
+            $appendBlock = "`n# Auto-appended oleh setup-pola-b.ps1 (lintasAI safe-uninstall hardening):`n# Cegah leak environment metadata + secret kalau user run ``git add .claude-kit/``.`n"
+            $appendBlock += ($missingEntries -join "`n") + "`n"
+            if ($existingLines.Count -gt 0) {
+                [System.IO.File]::AppendAllText($gitignorePath, $appendBlock, (New-Object System.Text.UTF8Encoding $false))
+            } else {
+                [System.IO.File]::WriteAllText($gitignorePath, $appendBlock.TrimStart("`n"), (New-Object System.Text.UTF8Encoding $false))
+            }
+        }
+
+        Write-Host ""
+        Write-Host ("OK    .install-manifest.json written ({0} file + {1} dir tracked)" -f $saveResult.FilesCount, $saveResult.DirsCount) -ForegroundColor Green
+        if ($saveResult.Merged) {
+            Write-Host "      Merged dengan manifest sebelumnya (re-run setup detected)." -ForegroundColor DarkGray
+        }
+        if ($saveResult.Signed) {
+            Write-Host "      HMAC-signed (tamper-detection aktif)." -ForegroundColor DarkGray
+        }
+        Write-Host "      Dipakai uninstall.ps1 untuk safe delete (hash-based pristine detection)." -ForegroundColor DarkGray
+        Write-Host "      Anonymized: project_root='<PROJECT_ROOT>', installed_by='<USER>' (tidak leak env)." -ForegroundColor DarkGray
+    } catch {
+        Write-Host "WARN  Gagal tulis .install-manifest.json: $_" -ForegroundColor Yellow
+        Write-Host "      Setup TETAP berhasil, tapi uninstall.ps1 nanti minta fallback manual." -ForegroundColor Yellow
+    }
+}
+
+# ---- Ringkasan akhir (structured + actionable) ----
+Write-Host ""
+Write-Host "================================================================" -ForegroundColor Green
+Write-Host ("  OK    KIT lintasAI - TER-INSTALL DI {0}" -f $ProjectName) -ForegroundColor Green
+Write-Host "================================================================" -ForegroundColor Green
+Write-Host ""
+
+Write-Host "SUDAH AKTIF (auto-load tiap sesi AI):" -ForegroundColor Cyan
+Write-Host "  [x] Aturan AI         : 4 rule docs + Tinjauan Multi-Divisi (12 divisi)"
+if ($proyekHampirKosong) {
+    Write-Host "  [ ] docs/             : SKIP (proyek hampir kosong) - akan auto-generate saat ada code"
+    Write-Host "  [ ] .github/          : SKIP (proyek hampir kosong) - team files belum di-copy"
+} else {
+    Write-Host "  [x] docs/             : skeleton + panduan tim (architecture, glossary, _PATTERNS, dst.)"
+    if (-not $SkipTeamFiles) {
+        Write-Host "  [x] .github/          : ai-review.yml + CODEOWNERS + PR template"
+    } else {
+        Write-Host "  [ ] .github/          : SKIP (-SkipTeamFiles aktif)"
+    }
+}
+Write-Host "  [x] Path resolution   : ~/.claude/ -> .claude-kit/"
+Write-Host ""
+
+Write-Host "ACTION ITEMS - PERLU KAMU LAKUKAN MANUAL:" -ForegroundColor Yellow
+$itemIdx = 1
+if (-not $SkipTeamFiles -and -not $proyekHampirKosong) {
+    Write-Host ("  [ ] ({0}) ~5 menit  Edit .github/CODEOWNERS - ganti placeholder @username dengan GitHub username actual." -f $itemIdx)
+    $itemIdx++
+    Write-Host ("  [ ] ({0}) ~2 menit  Setup ANTHROPIC_API_KEY di GitHub: Settings -> Secrets and variables -> Actions -> New secret." -f $itemIdx)
+    $itemIdx++
+}
+Write-Host ("  [ ] ({0}) opsional  Baca docs/CLAUDE_TEAM_GUIDE.md (panduan tim) + docs/PROMPT_LIBRARY.md." -f $itemIdx)
+$itemIdx++
+Write-Host ("  [ ] ({0}) opsional  Commit setup ke git: git add AGENTS.md .claude-kit/ docs/ .github/ && git commit -m 'chore: setup standar tim IT'" -f $itemIdx)
+Write-Host ""
+
+Write-Host "LANGKAH SELANJUTNYA - 1 PERINTAH:" -ForegroundColor Cyan
+Write-Host ("  Buka Claude Code di {0}, paste isi:" -f $ProjectRoot)
+Write-Host ("    {0}\JALANKAN_KIT.md" -f $KitDir) -ForegroundColor Green
+Write-Host ""
+Write-Host "  AI akan otomatis pandu kamu lewat 3 interactive popup:" -ForegroundColor Cyan
+Write-Host "    1. Team Mode?      (T) scan + bulk-bootstrap  /  (skip) langsung kerja"
+Write-Host "    2. Bulk-bootstrap? (1) all  /  (2) per kategori  /  (3) skeleton-first  -- kalau pilih T"
+Write-Host "    3. Skenario?       (a) proyek baru  /  (c) proyek setengah jadi  /  (d) langsung ngoding"
+Write-Host ""
+Write-Host "  Default tiap popup (kosong/Enter):  T -> 1 -> d   (owner-grade full docs)" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Alternatif (skip JALANKAN_KIT): langsung ngoding aja - aturan AI tetap auto-load tiap"
+Write-Host "  sesi, LAZY-GENERATE aktif saat sentuh code CRITICAL."
+Write-Host ""
+Write-Host "UPDATE KIT KE VERSI BARU:" -ForegroundColor Cyan
+Write-Host "  .\.claude-kit\update-kit.ps1   (auto re-clone + backup + detect [BREAKING]/[SCAN-REQUIRED])"
+Write-Host ""
+
+if ($DryRun) {
+    Write-Host "Mode DRY-RUN: jalankan ulang tanpa -DryRun untuk eksekusi sungguhan." -ForegroundColor Yellow
+}
+Write-Host "Status: SIAP NGODING" -ForegroundColor Green
+Write-Host ""
+exit 0