@ojokesusu/lintasai 1.1.3 → 1.2.1

package/tests/npx-init.Tests.ps1

@@ -0,0 +1,237 @@
+#Requires -Module Pester
+
+<#
+.SYNOPSIS
+  Pester 5+ regression tests untuk v1.1.3 fix - npx-init flow (setup-pola-b.ps1
+  via npm wrapper dengan -ProjectRoot eksplisit).
+
+.DESCRIPTION
+  v1.1.3 fix area:
+    1) AGENTS.md.template HARUS ke-bundle di tarball (sebelumnya hilang krn glob).
+    2) setup-pola-b.ps1 HARUS terima -ProjectRoot tanpa error (parameter exists).
+    3) Saat -ProjectRoot dipakai, $ProjectRoot != Split-Path -Parent $KitDir
+       (npm cache path BUKAN root proyek user).
+    4) Saat $KitDir bukan child of $ProjectRoot/.claude-kit, script auto-copy
+       isi kit dari $PSScriptRoot ke $ProjectRoot/.claude-kit.
+    5) Project name di-derive dari leaf $ProjectRoot (bukan parent KitDir).
+    6) Setelah init: AGENTS.md ada di $ProjectRoot (bukan di npm cache).
+    7) Setelah init: .claude-kit/setup-pola-b.ps1 ada di $ProjectRoot.
+
+  Strategi:
+    - BeforeAll: bikin temp dir mock-npm-cache (simulasi $KitDir) + temp dir
+      mock-project-root. Copy kit minimal (atau seluruh kit) ke mock-npm-cache.
+    - Jalankan setup-pola-b.ps1 -ProjectRoot <mockProjectRoot> -Force -SkipTeamFiles
+      dari mock-npm-cache.
+    - Assert hasil: AGENTS.md ada di $mockProjectRoot, .claude-kit/setup-pola-b.ps1
+      ada di $mockProjectRoot, dst.
+    - AfterAll: cleanup kedua temp dir.
+
+  Catatan:
+    - Test #1 (tarball content) pakai `npm pack --dry-run --json` untuk
+      enumerate file list TANPA bikin tarball asli (faster + no disk write).
+    - Test #2 (parameter exists) pakai AST static check (tidak invoke script).
+    - Test #3-7 perlu actual invocation tapi `-DryRun` tidak cukup karena
+      v1.1.3 copy step harus betul-betul dieksekusi untuk verifikasi.
+#>
+
+BeforeAll {
+    $ErrorActionPreference = 'Stop'
+
+    # ---- Resolve repo root (kit folder yang berisi setup-pola-b.ps1) ----
+    $script:KitRepoRoot = Resolve-Path (Join-Path $PSScriptRoot '..') | Select-Object -ExpandProperty Path
+    $script:SetupScript = Join-Path $script:KitRepoRoot 'setup-pola-b.ps1'
+    $script:PackageJson = Join-Path $script:KitRepoRoot 'package.json'
+    $script:AgentsTemplate = Join-Path $script:KitRepoRoot 'AGENTS.md.template'
+
+    if (-not (Test-Path $script:SetupScript)) {
+        throw "setup-pola-b.ps1 not found at $script:SetupScript"
+    }
+
+    # ---- Temp dir untuk mock-npm-cache + mock-project-root ----
+    $stamp = Get-Date -Format 'yyyyMMddHHmmssfff'
+    $script:TempBase = Join-Path $env:TEMP "lintasAI-npx-init-tests-$stamp"
+    $script:MockNpmCache = Join-Path $script:TempBase 'npm-cache-kit'
+    $script:MockProjectRoot = Join-Path $script:TempBase 'my-shiny-project'
+
+    New-Item -ItemType Directory -Path $script:MockNpmCache -Force | Out-Null
+    New-Item -ItemType Directory -Path $script:MockProjectRoot -Force | Out-Null
+
+    # ---- Copy seluruh kit ke mock-npm-cache (simulasi npm extract tarball) ----
+    # Pakai robocopy supaya cepat, exclude tests/ supaya tidak rekursif.
+    $robocopyArgs = @(
+        $script:KitRepoRoot,
+        $script:MockNpmCache,
+        '/E',           # include subdirs (empty too)
+        '/NFL', '/NDL', '/NJH', '/NJS', '/NC', '/NS', '/NP',  # quiet
+        '/XD', 'node_modules', '.git'
+    )
+    & robocopy @robocopyArgs | Out-Null
+    # robocopy exit 0-7 = success; 8+ = error
+    if ($LASTEXITCODE -ge 8) {
+        throw "robocopy failed with exit code $LASTEXITCODE"
+    }
+
+    $script:MockSetupScript = Join-Path $script:MockNpmCache 'setup-pola-b.ps1'
+    if (-not (Test-Path $script:MockSetupScript)) {
+        throw "Mock kit setup script missing at $script:MockSetupScript - copy failed"
+    }
+}
+
+AfterAll {
+    if ($script:TempBase -and (Test-Path $script:TempBase)) {
+        Remove-Item -Path $script:TempBase -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}
+
+Describe "v1.1.3 - npm pack bundles AGENTS.md.template" {
+    It "AGENTS.md.template appears in npm pack file list" {
+        # `npm pack --dry-run --json` returns metadata including the file list
+        # without actually creating a tarball on disk.
+        Push-Location $script:KitRepoRoot
+        try {
+            $packJson = & npm pack --dry-run --json 2>$null | Out-String
+            $packJson | Should -Not -BeNullOrEmpty
+            $packData = $packJson | ConvertFrom-Json
+            # npm returns array of package objects
+            $pkg = if ($packData -is [array]) { $packData[0] } else { $packData }
+            $files = $pkg.files | ForEach-Object { $_.path }
+            $files | Should -Contain 'AGENTS.md.template'
+        } finally {
+            Pop-Location
+        }
+    }
+}
+
+Describe "v1.1.3 - setup-pola-b.ps1 accepts -ProjectRoot parameter" {
+    It "Has -ProjectRoot parameter declared in param block (AST check)" {
+        $tokens = $null
+        $errors = $null
+        $ast = [System.Management.Automation.Language.Parser]::ParseFile(
+            $script:SetupScript, [ref]$tokens, [ref]$errors
+        )
+        $errors | Where-Object { $_.IncompleteInput -eq $false } | Should -BeNullOrEmpty
+
+        # Find top-level param block
+        $paramBlock = $ast.ParamBlock
+        $paramBlock | Should -Not -BeNullOrEmpty
+
+        $paramNames = $paramBlock.Parameters | ForEach-Object { $_.Name.VariablePath.UserPath }
+        $paramNames | Should -Contain 'ProjectRoot'
+    }
+
+    It "Invokes without parameter binding error when -ProjectRoot supplied" {
+        # Quick sanity: -DryRun -Force -SkipTeamFiles + -ProjectRoot should
+        # at minimum get past param binding (may fail later for other reasons
+        # but NOT ParameterBindingException).
+        $sandboxRoot = Join-Path $script:TempBase 'paramcheck-root'
+        New-Item -ItemType Directory -Path $sandboxRoot -Force | Out-Null
+
+        $output = & powershell.exe -NoProfile -ExecutionPolicy Bypass `
+            -File $script:MockSetupScript `
+            -ProjectRoot $sandboxRoot `
+            -DryRun -Force -SkipTeamFiles 2>&1 | Out-String
+
+        # ParameterBindingException = test fail
+        $output | Should -Not -Match 'ParameterBindingException'
+        $output | Should -Not -Match "parameter cannot be found that matches"
+    }
+}
+
+Describe "v1.1.3 - ProjectRoot resolution (npx wrapper mode)" {
+    It "When -ProjectRoot supplied, root = explicit value (NOT parent of KitDir)" {
+        # Run setup with -ProjectRoot = mockProjectRoot. KitDir = mockNpmCache.
+        # If fix broken: $ProjectRoot would default to Split-Path -Parent $KitDir
+        #               = $script:TempBase (parent of mockNpmCache), WRONG.
+        # If fix works: $ProjectRoot stays at mockProjectRoot.
+        # Verify by checking that AGENTS.md lands in mockProjectRoot, not TempBase.
+
+        # Clean target first to avoid stale state from prior tests
+        $targetRoot = Join-Path $script:TempBase 'resolve-check-root'
+        if (Test-Path $targetRoot) { Remove-Item -Path $targetRoot -Recurse -Force }
+        New-Item -ItemType Directory -Path $targetRoot -Force | Out-Null
+
+        $output = & powershell.exe -NoProfile -ExecutionPolicy Bypass `
+            -File $script:MockSetupScript `
+            -ProjectRoot $targetRoot `
+            -Force -SkipTeamFiles 2>&1 | Out-String
+
+        # AGENTS.md must exist in targetRoot (explicit -ProjectRoot honored)
+        $agentsInTarget = Join-Path $targetRoot 'AGENTS.md'
+        Test-Path $agentsInTarget | Should -BeTrue -Because "AGENTS.md should land in -ProjectRoot ($targetRoot), got output:`n$output"
+
+        # AGENTS.md must NOT exist in TempBase (parent of MockNpmCache)
+        $agentsInParent = Join-Path $script:TempBase 'AGENTS.md'
+        Test-Path $agentsInParent | Should -BeFalse -Because "AGENTS.md must NOT leak to parent of KitDir"
+    }
+}
+
+Describe "v1.1.3 - Auto-copy kit when ProjectRoot lacks .claude-kit" {
+    It "Triggers copy from `$PSScriptRoot when target .claude-kit absent" {
+        # Setup: fresh project root WITHOUT .claude-kit. Run setup with
+        # -ProjectRoot pointing there. Script should detect npx mode and copy
+        # kit contents from $KitDir (mockNpmCache) to $ProjectRoot/.claude-kit.
+
+        $autoCopyRoot = Join-Path $script:TempBase 'autocopy-root'
+        if (Test-Path $autoCopyRoot) { Remove-Item -Path $autoCopyRoot -Recurse -Force }
+        New-Item -ItemType Directory -Path $autoCopyRoot -Force | Out-Null
+
+        # Pre-condition: no .claude-kit yet
+        $kitTargetDir = Join-Path $autoCopyRoot '.claude-kit'
+        Test-Path $kitTargetDir | Should -BeFalse
+
+        $output = & powershell.exe -NoProfile -ExecutionPolicy Bypass `
+            -File $script:MockSetupScript `
+            -ProjectRoot $autoCopyRoot `
+            -Force -SkipTeamFiles 2>&1 | Out-String
+
+        # Post-condition: .claude-kit created with key files
+        Test-Path $kitTargetDir | Should -BeTrue -Because "Script should auto-copy kit to .claude-kit, output:`n$output"
+        Test-Path (Join-Path $kitTargetDir 'setup-pola-b.ps1') | Should -BeTrue
+        Test-Path (Join-Path $kitTargetDir 'CHANGELOG.md') | Should -BeTrue
+    }
+}
+
+Describe "v1.1.3 - Project name derived from -ProjectRoot leaf" {
+    It "Project name = Split-Path -Leaf `$ProjectRoot (not KitDir parent)" {
+        $namedRoot = Join-Path $script:TempBase 'unique-project-name-xyz'
+        if (Test-Path $namedRoot) { Remove-Item -Path $namedRoot -Recurse -Force }
+        New-Item -ItemType Directory -Path $namedRoot -Force | Out-Null
+
+        $output = & powershell.exe -NoProfile -ExecutionPolicy Bypass `
+            -File $script:MockSetupScript `
+            -ProjectRoot $namedRoot `
+            -Force -SkipTeamFiles 2>&1 | Out-String
+
+        $agentsPath = Join-Path $namedRoot 'AGENTS.md'
+        Test-Path $agentsPath | Should -BeTrue -Because "AGENTS.md must exist before name check, output:`n$output"
+
+        # Project name appears in deployed AGENTS.md (template fills it in heading)
+        $agentsContent = Get-Content -Path $agentsPath -Raw
+        $expectedName = Split-Path -Leaf $namedRoot
+        $agentsContent | Should -Match ([regex]::Escape($expectedName)) -Because "AGENTS.md should reference project name '$expectedName' from -ProjectRoot leaf"
+    }
+}
+
+Describe "v1.1.3 - Post-init artifacts in `$ProjectRoot" {
+    BeforeAll {
+        # One init run shared by both `It` blocks below
+        $script:PostInitRoot = Join-Path $script:TempBase 'postinit-root'
+        if (Test-Path $script:PostInitRoot) { Remove-Item -Path $script:PostInitRoot -Recurse -Force }
+        New-Item -ItemType Directory -Path $script:PostInitRoot -Force | Out-Null
+
+        $script:PostInitOutput = & powershell.exe -NoProfile -ExecutionPolicy Bypass `
+            -File $script:MockSetupScript `
+            -ProjectRoot $script:PostInitRoot `
+            -Force -SkipTeamFiles 2>&1 | Out-String
+    }
+
+    It "AGENTS.md exists at `$ProjectRoot root" {
+        $agentsPath = Join-Path $script:PostInitRoot 'AGENTS.md'
+        Test-Path $agentsPath | Should -BeTrue -Because "Post-init AGENTS.md must exist, output:`n$script:PostInitOutput"
+    }
+
+    It ".claude-kit/setup-pola-b.ps1 exists at `$ProjectRoot/.claude-kit" {
+        $kitSetup = Join-Path $script:PostInitRoot '.claude-kit\setup-pola-b.ps1'
+        Test-Path $kitSetup | Should -BeTrue -Because "Post-init kit setup script must exist in deployed .claude-kit"
+    }
+}

package/tests/package-bundle.Tests.ps1

@@ -0,0 +1,130 @@
+#Requires -Module Pester
+
+<#
+.SYNOPSIS
+    Regression tests untuk package.json files[] bundle.
+
+.DESCRIPTION
+    Memastikan `npm pack` mem-bundle SEMUA file kritikal kit
+    (AGENTS.md.template, bin/lintasai.js, lib/, templates/, docs/, tests/).
+
+    Latar belakang: pernah ada regression di mana AGENTS.md.template
+    hilang dari tarball karena pattern files[] tidak match.
+    Test ini = guard supaya regression yang sama tidak terulang.
+
+.NOTES
+    Pakai `npm pack --dry-run --json` untuk parsing deterministic.
+#>
+
+BeforeAll {
+    $script:KitRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
+    $script:PackageJsonPath = Join-Path $script:KitRoot 'package.json'
+
+    # Run `npm pack --dry-run --json` SEKALI di BeforeAll (mahal).
+    Push-Location $script:KitRoot
+    try {
+        $rawOutput = & npm pack --dry-run --json 2>&1
+        $exitCode = $LASTEXITCODE
+    } finally {
+        Pop-Location
+    }
+
+    if ($exitCode -ne 0) {
+        throw "npm pack --dry-run gagal (exit $exitCode). Output: $rawOutput"
+    }
+
+    # npm pack --json kadang campur stderr ke stdout; ambil JSON array/object di akhir.
+    $jsonText = ($rawOutput | Out-String).Trim()
+    # Cari posisi '[' atau '{' pertama yang masuk akal — npm pack --json balikin array.
+    $jsonStart = $jsonText.IndexOf('[')
+    if ($jsonStart -lt 0) { $jsonStart = $jsonText.IndexOf('{') }
+    if ($jsonStart -gt 0) {
+        $jsonText = $jsonText.Substring($jsonStart)
+    }
+
+    $script:PackInfo = $jsonText | ConvertFrom-Json
+    # npm pack --json returns array; ambil entry pertama.
+    if ($script:PackInfo -is [array]) {
+        $script:PackInfo = $script:PackInfo[0]
+    }
+
+    # File list (relative path di dalam tarball).
+    $script:PackFiles = @($script:PackInfo.files | ForEach-Object { $_.path })
+}
+
+Describe "package.json structural integrity" {
+    It "package.json adalah valid JSON" {
+        { Get-Content -Raw -Path $script:PackageJsonPath | ConvertFrom-Json } | Should -Not -Throw
+    }
+
+    It "package.json punya files[] array" {
+        $pkg = Get-Content -Raw -Path $script:PackageJsonPath | ConvertFrom-Json
+        $pkg.files | Should -Not -BeNullOrEmpty
+        $pkg.files.Count | Should -BeGreaterThan 0
+    }
+
+    It "files[] include pattern untuk AGENTS.md.template (explicit atau via wildcard)" {
+        $pkg = Get-Content -Raw -Path $script:PackageJsonPath | ConvertFrom-Json
+        $patterns = @($pkg.files)
+
+        # Match jika ada salah satu: explicit "AGENTS.md.template", wildcard "*.template", atau wildcard "*.md".
+        $hasExplicit = $patterns -contains 'AGENTS.md.template'
+        $hasTemplateWildcard = $patterns -contains '*.template'
+        $hasMdWildcard = $patterns -contains '*.md'
+
+        ($hasExplicit -or $hasTemplateWildcard -or $hasMdWildcard) | Should -BeTrue `
+            -Because "AGENTS.md.template harus ter-cover oleh pattern di files[] (explicit atau wildcard)"
+    }
+}
+
+Describe "npm pack --dry-run bundle coverage" {
+    It "Tarball memuat AGENTS.md.template" {
+        $script:PackFiles | Should -Contain 'AGENTS.md.template' `
+            -Because "AGENTS.md.template adalah file kritikal kit; tanpa ini setup Pola B di project gagal"
+    }
+
+    It "Tarball memuat bin/lintasai.js" {
+        $script:PackFiles | Should -Contain 'bin/lintasai.js' `
+            -Because "Entry point CLI; tanpa ini `npx lintasai` tidak jalan"
+    }
+
+    It "Tarball memuat file di lib/" {
+        $libFiles = @($script:PackFiles | Where-Object { $_ -like 'lib/*' })
+        $libFiles.Count | Should -BeGreaterThan 0 -Because "lib/ harus ada di tarball"
+    }
+
+    It "Tarball memuat file di templates/" {
+        $templateFiles = @($script:PackFiles | Where-Object { $_ -like 'templates/*' })
+        $templateFiles.Count | Should -BeGreaterThan 0 -Because "templates/ harus ada di tarball"
+    }
+
+    It "Tarball memuat file di docs/" {
+        $docsFiles = @($script:PackFiles | Where-Object { $_ -like 'docs/*' })
+        $docsFiles.Count | Should -BeGreaterThan 0 -Because "docs/ harus ada di tarball"
+    }
+
+    It "Tarball memuat file di tests/" {
+        $testFiles = @($script:PackFiles | Where-Object { $_ -like 'tests/*' })
+        $testFiles.Count | Should -BeGreaterThan 0 -Because "tests/ harus ada di tarball (untuk konsumen yang mau re-verify)"
+    }
+}
+
+Describe "Tarball size & file count sanity" {
+    It "Tarball size < 2 MB" {
+        # npm pack --json balikin `size` (unpacked) dan `unpackedSize`. Pakai size (tarball compressed) kalau ada.
+        $size = if ($null -ne $script:PackInfo.size) { $script:PackInfo.size } else { $script:PackInfo.unpackedSize }
+        $size | Should -Not -BeNullOrEmpty
+        $size | Should -BeLessThan (2 * 1024 * 1024) `
+            -Because "Kit harus stay lightweight (<2MB). Saat ini: $([math]::Round($size/1024,1)) KB"
+    }
+
+    It "Tarball entryCount > 50 (sanity check, bukan empty bundle)" {
+        $entryCount = if ($null -ne $script:PackInfo.entryCount) {
+            $script:PackInfo.entryCount
+        } else {
+            $script:PackFiles.Count
+        }
+        $entryCount | Should -BeGreaterThan 50 `
+            -Because "Kit punya banyak file (templates, docs, lib, tests). <50 = something missing. Actual: $entryCount"
+    }
+}

package/tests/setup-pola-b.Tests.ps1

@@ -0,0 +1,288 @@
+#Requires -Module Pester
+
+<#
+.SYNOPSIS
+  Pester 5+ tests untuk setup-pola-b.ps1 (ProjectRoot resolution + npx mode copy).
+
+.DESCRIPTION
+  Empat invocation branches yang di-test:
+    1. No -ProjectRoot, kit at <tmp>/.claude-kit/setup-pola-b.ps1
+       -> project = parent of kit (traditional Pola B mode).
+    2. -ProjectRoot supplied (valid path)
+       -> project = that explicit path (no derivation).
+    3. -ProjectRoot non-existent path
+       -> script errors out clearly (not silent fail). Resolve-Path -ErrorAction Stop
+          melempar terminating error; test assert exit code non-zero.
+    4. -ProjectRoot supplied + kit at npm-cache-like path (TEMP\nodemod-test\@ojokesusu\lintasai)
+       -> npx mode auto-detect, kit di-COPY ke $ProjectRoot/.claude-kit/.
+
+  Plus:
+    5. Manifest sanity: setelah setup sukses, .install-manifest.json terbuat.
+
+  Strategi:
+    - Real kit (parent dari folder tests/) jadi source-of-truth file.
+    - Per-test fake project root di $env:TEMP dengan layout sesuai branch.
+    - Branch 1, 2, 4, 5: pakai -Force -SkipTeamFiles untuk skip prompt + faster run.
+    - Branch 3: pakai path yang sengaja tidak ada, assert exit != 0 + pesan error.
+    - Test memanggil script di child PowerShell -NoProfile -NonInteractive supaya
+      env caller tidak ke-pollute (Set-StrictMode di lib/manifest.ps1 dll).
+#>
+
+BeforeAll {
+    # ---- Resolve repo root (kit folder asli, parent dari tests/) ----
+    $script:KitRepoRoot = Resolve-Path (Join-Path $PSScriptRoot '..') | Select-Object -ExpandProperty Path
+    $script:SetupScript = Join-Path $script:KitRepoRoot 'setup-pola-b.ps1'
+
+    # ---- Canonical TEMP (long form) ----
+    # $env:TEMP sering return 8.3 short path (mis. C:\Users\ADMINI~1\AppData\Local\Temp\2).
+    # Setup script pakai $PSScriptRoot (long form) untuk derive ProjectRoot di traditional
+    # mode, dan Resolve-Path tidak expand 8.3 -> long. Akibatnya: output script pakai long
+    # form, regex test pakai short form -> tidak match. Pakai (Get-Item).FullName supaya
+    # canonical long form di semua test path.
+    $script:TempCanonical = (Get-Item -LiteralPath $env:TEMP).FullName
+
+    if (-not (Test-Path $script:SetupScript)) {
+        throw "setup-pola-b.ps1 not found at $script:SetupScript - tests assume layout tests/ sibling to setup-pola-b.ps1"
+    }
+
+    # ---- Helper: copy kit asli ke target folder (jadi .claude-kit di fake project) ----
+    function script:Copy-RealKit {
+        param(
+            [Parameter(Mandatory)][string]$Destination
+        )
+        if (-not (Test-Path -LiteralPath $Destination)) {
+            $null = New-Item -ItemType Directory -Path $Destination -Force
+        }
+        # Copy semua isi kit kecuali subfolder yang bisa bikin loop/lambat (kalau ada)
+        Get-ChildItem -Path $script:KitRepoRoot -Force | Where-Object {
+            $_.Name -notin @('.git', 'node_modules')
+        } | ForEach-Object {
+            $dest = Join-Path $Destination $_.Name
+            if ($_.PSIsContainer) {
+                Copy-Item -LiteralPath $_.FullName -Destination $dest -Recurse -Force
+            } else {
+                Copy-Item -LiteralPath $_.FullName -Destination $dest -Force
+            }
+        }
+    }
+
+    # ---- Helper: bikin file dummy supaya proyek "tidak hampir kosong" ----
+    # setup-pola-b.ps1 skip docs/ skeleton kalau project root hampir kosong (heuristic
+    # menghitung non-hidden file/dir). Test branch 1/2/4/5 mau real flow, jadi taruh
+    # 2 file dummy supaya nonHiddenFiles.Count > 1.
+    function script:Add-ProjectContent {
+        param([Parameter(Mandatory)][string]$Root)
+        [System.IO.File]::WriteAllText(
+            (Join-Path $Root 'README.md'),
+            "# Test Project`nDummy content untuk lewatin proyek-hampir-kosong heuristic.`n",
+            (New-Object System.Text.UTF8Encoding $false)
+        )
+        [System.IO.File]::WriteAllText(
+            (Join-Path $Root 'package.json'),
+            '{"name":"test","version":"0.0.1"}',
+            (New-Object System.Text.UTF8Encoding $false)
+        )
+    }
+
+    # ---- Helper: run setup-pola-b.ps1 di child PowerShell, capture stdout + exit ----
+    function script:Invoke-Setup {
+        param(
+            [Parameter(Mandatory)][string]$ScriptPath,
+            [string[]]$Args = @()
+        )
+        $pwshExe = (Get-Process -Id $PID).Path
+        if (-not $pwshExe) { $pwshExe = 'powershell.exe' }
+        $allArgs = @('-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', $ScriptPath) + $Args
+        $output = & $pwshExe @allArgs 2>&1 | Out-String
+        return [pscustomobject]@{
+            Output   = $output
+            ExitCode = $LASTEXITCODE
+        }
+    }
+
+    # ---- Helper: cleanup folder kalau ada ----
+    function script:Remove-TestRoot {
+        param([Parameter(Mandatory)][string]$Path)
+        if (Test-Path -LiteralPath $Path) {
+            Remove-Item -Recurse -Force -LiteralPath $Path -ErrorAction SilentlyContinue
+        }
+    }
+}
+
+Describe "setup-pola-b.ps1 Branch 1: traditional invocation (no -ProjectRoot)" {
+    BeforeAll {
+        # Layout: <tmp>/<project>/.claude-kit/setup-pola-b.ps1
+        $script:Root1 = Join-Path $script:TempCanonical ("lintasAI-setup-test-traditional-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $null = New-Item -ItemType Directory -Path $script:Root1 -Force
+        script:Add-ProjectContent -Root $script:Root1
+        $script:Kit1 = Join-Path $script:Root1 '.claude-kit'
+        script:Copy-RealKit -Destination $script:Kit1
+        $script:SetupInKit1 = Join-Path $script:Kit1 'setup-pola-b.ps1'
+    }
+
+    AfterAll {
+        script:Remove-TestRoot -Path $script:Root1
+    }
+
+    It "Resolves project root = parent of kit folder" {
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInKit1 -Args @('-Force', '-SkipTeamFiles')
+        $result.ExitCode | Should -Be 0
+        # Output harus mention root proyek sesuai $Root1.
+        $result.Output | Should -Match ([regex]::Escape($script:Root1))
+        # AGENTS.md harus dideploy di project root.
+        (Test-Path -LiteralPath (Join-Path $script:Root1 'AGENTS.md')) | Should -BeTrue
+    }
+
+    It "Does NOT print npx mode banner" {
+        # Traditional mode: tidak boleh ada string "[npx] Mode" karena ProjectRoot tidak di-pass.
+        # Re-run dengan -DryRun supaya tidak duplicate setup di same root.
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInKit1 -Args @('-Force', '-SkipTeamFiles', '-DryRun')
+        $result.Output | Should -Not -Match '\[npx\] Mode'
+    }
+}
+
+Describe "setup-pola-b.ps1 Branch 2: -ProjectRoot supplied (valid path)" {
+    BeforeAll {
+        # Layout: <tmp>/<project>/.claude-kit/setup-pola-b.ps1 (kit lives standard place)
+        # but we ALSO pass -ProjectRoot explicitly to exercise the npx-mode code path
+        # bahkan kalau path-nya same. Script harus treat sebagai npx mode.
+        $script:Root2 = Join-Path $script:TempCanonical ("lintasAI-setup-test-explicitroot-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $null = New-Item -ItemType Directory -Path $script:Root2 -Force
+        script:Add-ProjectContent -Root $script:Root2
+        $script:Kit2 = Join-Path $script:Root2 '.claude-kit'
+        script:Copy-RealKit -Destination $script:Kit2
+        $script:SetupInKit2 = Join-Path $script:Kit2 'setup-pola-b.ps1'
+    }
+
+    AfterAll {
+        script:Remove-TestRoot -Path $script:Root2
+    }
+
+    It "Uses the explicit ProjectRoot path (no derivation)" {
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInKit2 -Args @(
+            '-Force', '-SkipTeamFiles', '-ProjectRoot', $script:Root2
+        )
+        $result.ExitCode | Should -Be 0
+        # Banner npx mode harus muncul (proves the branch executed).
+        $result.Output | Should -Match '\[npx\] Mode: explicit ProjectRoot'
+        # AGENTS.md harus ada di explicit root.
+        (Test-Path -LiteralPath (Join-Path $script:Root2 'AGENTS.md')) | Should -BeTrue
+    }
+}
+
+Describe "setup-pola-b.ps1 Branch 3: -ProjectRoot non-existent path" {
+    BeforeAll {
+        # Kit lives di TEMP/<kit-folder>/.claude-kit dengan parent project legit, tapi
+        # we pass -ProjectRoot ke path yang tidak ada -> Resolve-Path -ErrorAction Stop
+        # harus throw -> exit code non-zero, with clear error message (not silent).
+        $script:Root3 = Join-Path $script:TempCanonical ("lintasAI-setup-test-badroot-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $null = New-Item -ItemType Directory -Path $script:Root3 -Force
+        script:Add-ProjectContent -Root $script:Root3
+        $script:Kit3 = Join-Path $script:Root3 '.claude-kit'
+        script:Copy-RealKit -Destination $script:Kit3
+        $script:SetupInKit3 = Join-Path $script:Kit3 'setup-pola-b.ps1'
+        # Path yang DIJAMIN tidak ada
+        $script:BadRoot = Join-Path $script:TempCanonical ("lintasAI-DOES-NOT-EXIST-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+    }
+
+    AfterAll {
+        script:Remove-TestRoot -Path $script:Root3
+        script:Remove-TestRoot -Path $script:BadRoot   # defensive (script harusnya tidak create)
+    }
+
+    It "Errors out (non-zero exit) with clear message" {
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInKit3 -Args @(
+            '-Force', '-SkipTeamFiles', '-ProjectRoot', $script:BadRoot
+        )
+        $result.ExitCode | Should -Not -Be 0
+        # Pesan harus include "Resolve-Path" / "not exist" / nama path yang tidak valid -
+        # apa pun yang membuktikan ini BUKAN silent fail.
+        # Resolve-Path throws "Cannot find path '...' because it does not exist."
+        $result.Output | Should -Match '(?i)(cannot find path|does not exist|not exist|tidak ditemukan|tidak ada)'
+    }
+
+    It "Does NOT create .claude-kit at the bogus path" {
+        # Script tidak boleh men-create folder di path yang tidak ada (defensive guard).
+        (Test-Path -LiteralPath $script:BadRoot) | Should -BeFalse
+    }
+}
+
+Describe "setup-pola-b.ps1 Branch 4: -ProjectRoot + kit at npm-cache-like path" {
+    BeforeAll {
+        # Layout simulasi npx:
+        #   <tmp>\nodemod-test\@ojokesusu\lintasai\setup-pola-b.ps1   (kit di npm cache)
+        #   <tmp>\<project-root>\                                     (target project, beda parent)
+        # Script harus detect mismatch ($KitDir tidak dalam $ProjectRoot/.claude-kit/)
+        # dan COPY isi kit ke $ProjectRoot/.claude-kit/.
+        $script:Root4 = Join-Path $script:TempCanonical ("lintasAI-setup-test-npx-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $null = New-Item -ItemType Directory -Path $script:Root4 -Force
+        script:Add-ProjectContent -Root $script:Root4
+
+        # Kit DIPASANG di npm-cache-like location (BUKAN di $script:Root4/.claude-kit)
+        $script:NpmCacheRoot = Join-Path $script:TempCanonical ("nodemod-test-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $script:KitInNpmCache = Join-Path $script:NpmCacheRoot '@ojokesusu\lintasai'
+        $null = New-Item -ItemType Directory -Path $script:KitInNpmCache -Force
+        script:Copy-RealKit -Destination $script:KitInNpmCache
+        $script:SetupInNpmCache = Join-Path $script:KitInNpmCache 'setup-pola-b.ps1'
+    }
+
+    AfterAll {
+        script:Remove-TestRoot -Path $script:Root4
+        script:Remove-TestRoot -Path $script:NpmCacheRoot
+    }
+
+    It "Detects npx mode and copies kit to <ProjectRoot>/.claude-kit/" {
+        # Pre-assert: target .claude-kit tidak ada sebelum jalan.
+        $targetKit = Join-Path $script:Root4 '.claude-kit'
+        (Test-Path -LiteralPath $targetKit) | Should -BeFalse
+
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInNpmCache -Args @(
+            '-Force', '-SkipTeamFiles', '-ProjectRoot', $script:Root4
+        )
+        $result.ExitCode | Should -Be 0
+        # Verifikasi log npx mode + copy
+        $result.Output | Should -Match '\[npx\] Mode: explicit ProjectRoot'
+        $result.Output | Should -Match '(?i)\[npx\] Copy kit'
+
+        # Hasil: .claude-kit di project root harus ada, berisi setup-pola-b.ps1 yang ke-copy
+        (Test-Path -LiteralPath $targetKit) | Should -BeTrue
+        (Test-Path -LiteralPath (Join-Path $targetKit 'setup-pola-b.ps1')) | Should -BeTrue
+        (Test-Path -LiteralPath (Join-Path $targetKit 'CHANGELOG.md')) | Should -BeTrue
+        (Test-Path -LiteralPath (Join-Path $targetKit 'lib\manifest.ps1')) | Should -BeTrue
+    }
+}
+
+Describe "setup-pola-b.ps1 manifest creation" {
+    BeforeAll {
+        # Reuse pattern Branch 1 (traditional) – setelah setup sukses, manifest harus
+        # terbuat di .claude-kit/.install-manifest.json. Pakai fresh root supaya hash
+        # & state-nya independent dari describe lain.
+        $script:Root5 = Join-Path $script:TempCanonical ("lintasAI-setup-test-manifest-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $null = New-Item -ItemType Directory -Path $script:Root5 -Force
+        script:Add-ProjectContent -Root $script:Root5
+        $script:Kit5 = Join-Path $script:Root5 '.claude-kit'
+        script:Copy-RealKit -Destination $script:Kit5
+        $script:SetupInKit5 = Join-Path $script:Kit5 'setup-pola-b.ps1'
+    }
+
+    AfterAll {
+        script:Remove-TestRoot -Path $script:Root5
+    }
+
+    It "Creates .install-manifest.json after successful setup" {
+        $result = script:Invoke-Setup -ScriptPath $script:SetupInKit5 -Args @('-Force', '-SkipTeamFiles')
+        $result.ExitCode | Should -Be 0
+        $manifestPath = Join-Path $script:Kit5 '.install-manifest.json'
+        (Test-Path -LiteralPath $manifestPath) | Should -BeTrue
+    }
+
+    It "Manifest is valid JSON with expected top-level fields" {
+        $manifestPath = Join-Path $script:Kit5 '.install-manifest.json'
+        (Test-Path -LiteralPath $manifestPath) | Should -BeTrue
+        $json = Get-Content -LiteralPath $manifestPath -Raw -Encoding UTF8
+        { $json | ConvertFrom-Json -ErrorAction Stop } | Should -Not -Throw
+        $obj = $json | ConvertFrom-Json
+        $obj.PSObject.Properties.Name | Should -Contain 'schema_version'
+        $obj.PSObject.Properties.Name | Should -Contain 'files'
+    }
+}