@ojokesusu/lintasai 1.1.2 → 1.2.0

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

@@ -0,0 +1,280 @@
+#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'
+
+    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 $env:TEMP ("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 $env:TEMP ("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 $env:TEMP ("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 $env:TEMP ("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 $env:TEMP ("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 $env:TEMP ("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 $env:TEMP ("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'
+    }
+}

package/uninstall.ps1

@@ -63,9 +63,20 @@ param(
     [switch]$DeleteAgents,
     [switch]$KeepKit,
     [switch]$Yes,
-    [switch]$AllowProjectRootMismatch
+    [switch]$AllowProjectRootMismatch,
+    [string]$ProjectRoot = $null
 )
 
+# ---- Resolve $ProjectRoot early (param-driven, fallback to script location) ----
+# Kalau user pass -ProjectRoot pakai itu (untuk smoke test / CI). Kalau tidak, derive dari
+# $PSScriptRoot (script ada di .claude-kit\, parent = project root).
+if (-not $ProjectRoot) {
+    $ProjectRoot = Split-Path -Parent $PSScriptRoot
+} else {
+    $ProjectRoot = (Resolve-Path $ProjectRoot -ErrorAction Stop).Path
+}
+Write-Host "Root proyek   : $ProjectRoot"
+
 # ---- Deprecation handling: -Force jadi alias backward-compat untuk -AllowModified ----
 # Sebelumnya -Force overloaded (modified bypass + signature bypass). Pisahkan supaya
 # intent jelas. -Force masih bekerja untuk backward-compat tapi warn user.
@@ -81,8 +92,8 @@ if ($Force) {
 $ErrorActionPreference = 'Stop'
 
 # ---- Resolve folder kit (tempat script ini berada) ----
+# $ProjectRoot sudah di-resolve di awal (param-driven). Jangan override.
 $KitDir = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
-$ProjectRoot = Split-Path -Parent $KitDir
 $ProjectName = Split-Path -Leaf $ProjectRoot
 $Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
 

package/update-kit.ps1

@@ -70,11 +70,22 @@ param(
     [switch]$DryRun,
     [switch]$AllowUntrustedRepo,
     [switch]$Force,
-    [switch]$AllowUnsignedTag
+    [switch]$AllowUnsignedTag,
+    [string]$ProjectRoot = $null
 )
 
 $ErrorActionPreference = 'Stop'
 
+# ---- Resolve $ProjectRoot early (param-driven, fallback to script location) ----
+# Kalau user pass -ProjectRoot pakai itu (untuk smoke test / CI). Kalau tidak, derive dari
+# $PSScriptRoot (script ada di .claude-kit\, parent = project root).
+if (-not $ProjectRoot) {
+    $ProjectRoot = Split-Path -Parent $PSScriptRoot
+} else {
+    $ProjectRoot = (Resolve-Path $ProjectRoot -ErrorAction Stop).Path
+}
+Write-Host "Root proyek   : $ProjectRoot"
+
 # ---- Deprecation handling: -Force jadi alias backward-compat untuk -AllowUntrustedRepo ----
 # Sebelumnya -Force overloaded (GPG bypass + RepoUrl bypass). GPG bypass sekarang lewat
 # -AllowUnsignedTag; -Force narrowed jadi alias RepoUrl-allowlist-bypass saja, dengan warn.
@@ -89,9 +100,11 @@ if ($Force) {
 }
 
 # ---- Resolve paths (do this FIRST, sebelum Move-Item rename folder) ----
+# $ProjectRoot (PascalCase) sudah di-resolve dari param di awal. $projectRoot (camelCase)
+# di-alias supaya legacy code di bawah tetap jalan tanpa rename massal.
 $kitDir = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
 $kitFolderName = Split-Path -Leaf $kitDir
-$projectRoot = Split-Path -Parent $kitDir
+$projectRoot = $ProjectRoot
 $timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
 $backupDir = "$kitDir.backup-$timestamp"
 

package/FIRST_SESSION_PROMPT_v1.md

@@ -1,7 +0,0 @@
-# DEPRECATED (lintasAI v1.0.0 republish 2026-06-04)
-
-File ini deprecated. First-session workflow sudah jadi bagian dari JALANKAN_KIT.md.
-
--> Pakai [JALANKAN_KIT.md](JALANKAN_KIT.md)
-
-Content lama bisa dicek di git history sebelum 2026-06-04.