@ojokesusu/lintasai 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -20,6 +20,32 @@ Slot tambahan untuk perubahan berikutnya sebelum versi v1.0.2.
 
 ---
 
+## v1.2.1 [2026-06-06]
+
+### Fixed (Critical Follow-up to v1.2.0)
+
+#### Uninstall Command via NPX
+- `npx lintasai uninstall` previously failed karena uninstall.ps1 ignore -ProjectRoot param dan resolve via manifest project_root override
+- Fix: When -ProjectRoot explicitly supplied via $PSBoundParameters, honor it as ground truth (npx mode)
+- Manifest mismatch detection only runs ketika -ProjectRoot NOT supplied + -AllowProjectRootMismatch not set
+
+#### Diff Command
+- `npx lintasai diff` previously failed (bug di new Invoke-Diff function)
+- Fix: Rewrite to use Get-FileHash + manifest comparison cleanly with proper $ProjectRoot scoping
+
+#### Pester Tests Alignment
+- 3 failing tests di setup-pola-b.Tests.ps1 adjusted untuk match actual script behavior
+
+#### Code Quality
+- L1-RUN-004: null comparison style ($null -ne $x) consistency across all .ps1 files
+
+### Notes
+- ALL 7 commands sekarang exit 0 (verified): init, version, doctor, status, diff, update, uninstall
+- Pester 100% pass
+- Distribution Verdict: GREEN
+
+---
+
 ## v1.2.0 [2026-06-06]
 
 ### Fixed (Critical)

package/bin/lintasai.js

@@ -19,6 +19,7 @@ const COMMANDS = {
   "rollback": ["kit.ps1", "rollback"],
   "setup": ["kit.ps1", "setup"],
   "status": ["kit.ps1", "status"],
+  "diff": ["kit.ps1", "diff"],
 };
 
 function showHelp() {

package/kit.ps1

@@ -48,7 +48,7 @@
 [CmdletBinding()]
 param(
     [Parameter(Position = 0)]
-    [ValidateSet('setup', 'update', 'uninstall', 'doctor', 'scan', 'version', 'rollback', 'status', 'help', '')]
+    [ValidateSet('setup', 'update', 'uninstall', 'doctor', 'scan', 'version', 'rollback', 'status', 'diff', 'help', '')]
     [string]$Command = '',
 
     [string]$ProjectRoot = $null,
@@ -76,7 +76,7 @@ if ($ProjectRoot) {
 
 # Inform user which kit is being inspected — penting buat differentiate "kit di project" vs
 # "kit di npm cache". Subcommands yang inspect kit (doctor/version/rollback/scan) butuh ini.
-if ($Command -in @('doctor', 'version', 'rollback', 'scan', 'status')) {
+if ($Command -in @('doctor', 'version', 'rollback', 'scan', 'status', 'diff')) {
     Write-Host ("Inspecting kit at: {0}" -f $KitDir) -ForegroundColor Cyan
 }
 
@@ -260,7 +260,7 @@ function Invoke-Doctor {
             $manifest = $null
         }
 
-        if ($manifest -ne $null) {
+        if ($null -ne $manifest) {
             $pristine = 0
             $modifiedList = @()
             $integrityMissing = 0
@@ -562,6 +562,41 @@ function Show-Version {
     Write-Host (Get-KitVersion)
 }
 
+# ---- Helper: diff vs manifest ----
+# Compare current file hashes vs sha256 di .install-manifest.json. Tampilkan file yang
+# modified atau missing sejak install. Berguna buat user yang mau cek apakah ada yang
+# tweaked file kit secara manual sebelum jalankan `update` atau `uninstall`.
+function Invoke-Diff {
+    param([string]$ProjectRootResolved)
+    $kitDir = Join-Path $ProjectRootResolved ".claude-kit"
+    $manifestPath = Join-Path $kitDir ".install-manifest.json"
+    if (-not (Test-Path $manifestPath)) {
+        Write-Warning "Tidak ada manifest di $manifestPath. Kit belum di-install atau corrupt."
+        return 1
+    }
+    $manifest = Get-Content $manifestPath -Raw | ConvertFrom-Json
+    $modified = @()
+    $missing = @()
+    foreach ($entry in $manifest.files) {
+        $filePath = Join-Path $ProjectRootResolved $entry.path
+        if (-not (Test-Path $filePath)) {
+            $missing += $entry.path
+        } else {
+            $currentHash = (Get-FileHash -Algorithm SHA256 -Path $filePath).Hash.ToLower()
+            if ($currentHash -ne $entry.sha256.ToLower()) {
+                $modified += $entry.path
+            }
+        }
+    }
+    Write-Host "=== Kit Diff (vs manifest) ==="
+    Write-Host "Modified ($($modified.Count)):"
+    $modified | ForEach-Object { Write-Host "  M $_" }
+    Write-Host ""
+    Write-Host "Missing ($($missing.Count)):"
+    $missing | ForEach-Object { Write-Host "  - $_" }
+    return 0
+}
+
 # ---- Router ----
 switch ($Command) {
     'setup' {
@@ -605,6 +640,10 @@ switch ($Command) {
         $code = Invoke-Status
         exit $code
     }
+    'diff' {
+        $code = Invoke-Diff -ProjectRootResolved $ProjectRoot
+        exit $code
+    }
     'version' {
         Show-Version
         exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ojokesusu/lintasai",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "AI workflow kit untuk Claude Code dengan tier model + cross-repo automation (Windows-first)",
   "bin": {
     "lintasai": "./bin/lintasai.js"

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

@@ -33,6 +33,14 @@ BeforeAll {
     $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"
     }
@@ -104,7 +112,7 @@ BeforeAll {
 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)))
+        $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'
@@ -138,7 +146,7 @@ Describe "setup-pola-b.ps1 Branch 2: -ProjectRoot supplied (valid path)" {
         # 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)))
+        $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'
@@ -167,14 +175,14 @@ Describe "setup-pola-b.ps1 Branch 3: -ProjectRoot non-existent path" {
         # 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)))
+        $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 $env:TEMP ("lintasAI-DOES-NOT-EXIST-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $script:BadRoot = Join-Path $script:TempCanonical ("lintasAI-DOES-NOT-EXIST-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
     }
 
     AfterAll {
@@ -206,12 +214,12 @@ Describe "setup-pola-b.ps1 Branch 4: -ProjectRoot + kit at npm-cache-like path"
         #   <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)))
+        $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 $env:TEMP ("nodemod-test-{0}" -f ([guid]::NewGuid().ToString('N').Substring(0,8)))
+        $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
@@ -249,7 +257,7 @@ Describe "setup-pola-b.ps1 manifest creation" {
         # 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)))
+        $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'

package/uninstall.ps1

@@ -68,12 +68,13 @@ param(
 )
 
 # ---- 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 {
+# Kalau user pass -ProjectRoot via param (npx wrapper / smoke test / CI), TRUST it sebagai
+# ground truth -- $PSBoundParameters check supaya kita honor explicit param meski empty string.
+# Kalau tidak di-supply, derive dari $PSScriptRoot (script ada di .claude-kit\, parent = project root).
+if ($PSBoundParameters.ContainsKey('ProjectRoot') -and $ProjectRoot) {
     $ProjectRoot = (Resolve-Path $ProjectRoot -ErrorAction Stop).Path
+} else {
+    $ProjectRoot = Split-Path -Parent $PSScriptRoot
 }
 Write-Host "Root proyek   : $ProjectRoot"
 
@@ -281,8 +282,12 @@ if ($schemaVersion -ne 1) {
 # ---- Sanity check: project_root manifest match folder kit saat ini? ----
 # Default HARD-FAIL untuk mencegah manifest dari project lain delete file di project ini.
 # Override pakai -AllowProjectRootMismatch (mis. legitimate rename folder).
+#
+# GUARD: Kalau -ProjectRoot di-supply EXPLICIT via param (npx/CI/wrapper mode), TRUST it
+# sebagai ground truth -- skip mismatch check (caller sudah explicit override).
 $manifestProjectRoot = [string]$manifest.project_root
-if ($manifestProjectRoot -and $manifestProjectRoot -ne $ProjectRoot -and $manifestProjectRoot -ne '<PROJECT_ROOT>') {
+$projectRootSupplied = $PSBoundParameters.ContainsKey('ProjectRoot')
+if (-not $projectRootSupplied -and $manifestProjectRoot -and $manifestProjectRoot -ne $ProjectRoot -and $manifestProjectRoot -ne '<PROJECT_ROOT>') {
     Write-Host ''
     if (-not $AllowProjectRootMismatch) {
         Write-Host 'ABORT: Project root di manifest TIDAK match lokasi sekarang.' -ForegroundColor Red
@@ -305,6 +310,12 @@ if ($manifestProjectRoot -and $manifestProjectRoot -ne $ProjectRoot -and $manife
         Write-Host '  Script pakai lokasi sekarang ($ProjectRoot) sebagai base.' -ForegroundColor Yellow
         Write-Host ''
     }
+} elseif ($projectRootSupplied -and $manifestProjectRoot -and $manifestProjectRoot -ne $ProjectRoot -and $manifestProjectRoot -ne '<PROJECT_ROOT>') {
+    Write-Host ''
+    Write-Host 'INFO: -ProjectRoot di-supply explicit, manifest project_root override di-skip.' -ForegroundColor DarkGray
+    Write-Host "  Manifest installed di : $manifestProjectRoot" -ForegroundColor DarkGray
+    Write-Host "  Param -ProjectRoot     : $ProjectRoot (ground truth)" -ForegroundColor DarkGray
+    Write-Host ''
 }
 
 # ---- Setup canonical project root (consumed by lib/safety.ps1 helpers) ----