@ojokesusu/lintasai 1.1.3 → 1.2.0

package/CHANGELOG.md

@@ -20,6 +20,50 @@ Slot tambahan untuk perubahan berikutnya sebelum versi v1.0.2.
 
 ---
 
+## v1.2.0 [2026-06-06]
+
+### Fixed (Critical)
+
+#### NPX Wrapper Bugs (v1.1.3 regression discovered via audit)
+- **L1-RUN-001**: `npx lintasai uninstall` hard-fail karena wrapper kirim `-ProjectRoot` ke uninstall.ps1 yang tidak support param
+  - Fix: uninstall.ps1 sekarang accept `[string]$ProjectRoot` param + resolve via fallback chain
+- **L1-RUN-002**: `npx lintasai update` hard-fail sama issue
+  - Fix: update-kit.ps1 accept `-ProjectRoot` param
+- **L1-RUN-003**: `npx lintasai doctor/version/rollback` inspect kit di npm cache (silent false diagnostic)
+  - Fix: kit.ps1 accept `-ProjectRoot`, inspect `.claude-kit/` di user CWD bukan $PSScriptRoot
+  - Fix: bin/lintasai.js pass `-ProjectRoot` ke kit.ps1 subcommands juga
+
+#### Code Quality
+- **L1-RUN-004**: null comparison style consistency `$null -ne $x` (PSScriptAnalyzer warning eliminated)
+
+### Added (New Features)
+
+#### CLI Commands
+- **`lintasai status`**: 1-layar overview kit health (version, install mode, AGENTS.md, manifest signed, last update, tier setup)
+- **`lintasai diff`**: show files yang berubah sejak install (modified/missing/extra) untuk debugging Tier C delegate
+
+#### Tests (Regression Coverage)
+- `tests/npx-init.Tests.ps1`: regression test untuk v1.1.3 fix (tarball content + ProjectRoot param + npx-mode copy)
+- `tests/package-bundle.Tests.ps1`: assert npm pack mengandung semua file deployment-needed
+- `tests/setup-pola-b.Tests.ps1`: cover 4 invocation branches (traditional, ProjectRoot valid, ProjectRoot invalid, npx-mode)
+
+#### Documentation
+- `docs/NPX_INSTALL.md`: troubleshooting Bahasa Indonesia untuk staff IT non-programmer
+  (node version, EACCES/EPERM, ExecutionPolicy, proxy, kit verification, rollback, uninstall, update, status, diff, support contact)
+
+### Removed
+- `FIRST_SESSION_PROMPT_v1.md` (deprecated stub, no active consumers verified)
+
+### Notes
+Ready untuk mass distribution ke 20-30 staff IT. Audit verdict upgraded YELLOW -> GREEN.
+
+Deferred to v1.2.1 (lower priority):
+- Remove 5 more deprecated stubs (need cross-ref update first)
+- Security advisory items (HMAC salt, staging dir verify, etc.)
+- Refactor dead variables ($signatureValid, $libSafety, $shouldPreserve)
+
+---
+
 ## v1.1.3 [2026-06-06]
 
 ### Fixed

package/bin/lintasai.js

@@ -18,6 +18,7 @@ const COMMANDS = {
   "version": ["kit.ps1", "version"],
   "rollback": ["kit.ps1", "rollback"],
   "setup": ["kit.ps1", "setup"],
+  "status": ["kit.ps1", "status"],
 };
 
 function showHelp() {
@@ -31,6 +32,7 @@ function showHelp() {
   console.log("  init           Setup kit di project (alias setup-pola-b)");
   console.log("  update         Update kit ke versi terbaru");
   console.log("  doctor         Verify kit integrity");
+  console.log("  status         Show kit status ringkas (1-layar)");
   console.log("  version        Show kit version");
   console.log("  rollback       Rollback ke versi sebelumnya");
   console.log("  uninstall      Remove kit dari project");
@@ -71,8 +73,19 @@ const userCwd = process.cwd();
 const shouldPassProjectRoot = ["init", "update", "uninstall"].includes(command);
 let psArgs;
 if (Array.isArray(target)) {
-  // kit.ps1 subcommand
-  psArgs = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", path.join(KIT_ROOT, target[0]), target[1], ...args];
+  // kit.ps1 subcommand. Inject -ProjectRoot so kit.ps1 inspects the kit di USER CWD
+  // (.claude-kit di project), bukan di npm cache ($PSScriptRoot). L1-RUN-003.
+  psArgs = [
+    "-NoProfile",
+    "-ExecutionPolicy",
+    "Bypass",
+    "-File",
+    path.join(KIT_ROOT, target[0]),
+    target[1],
+    "-ProjectRoot",
+    userCwd,
+    ...args,
+  ];
 } else if (shouldPassProjectRoot) {
   // Direct script call with -ProjectRoot
   psArgs = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", path.join(KIT_ROOT, target), "-ProjectRoot", userCwd, ...args];

package/docs/NPX_INSTALL.md

@@ -0,0 +1,217 @@
+# NPX Install Guide - lintasAI Kit
+
+## Untuk Siapa
+
+Panduan ini ditujukan untuk **staff IT non-programmer** yang mau install lintasAI Kit ke project menggunakan `npx` (lebih cepat dari `git clone`, tidak perlu paham git, dan otomatis dapat versi terbaru).
+
+Kalau kamu sudah familiar dengan terminal & PowerShell, install via npx adalah cara paling singkat: cukup 1 perintah, kit langsung terpasang di folder project.
+
+---
+
+## Cara Install (1 perintah)
+
+1. Buka **PowerShell** (bukan CMD).
+2. Pindah ke folder project tempat kit mau dipasang:
+   ```powershell
+   cd D:\Users\Administrator\projects\nama-project
+   ```
+3. Jalankan perintah install:
+   ```powershell
+   npx @ojokesusu/lintasai init
+   ```
+4. Tunggu sampai muncul pesan `Kit installed successfully`. Biasanya 30 detik - 2 menit tergantung koneksi.
+
+Setelah selesai, folder `.claude-kit/` + `AGENTS.md` akan otomatis dibuat di project root.
+
+---
+
+## Verify Install Berhasil
+
+Cek status kit:
+```powershell
+npx @ojokesusu/lintasai status
+```
+
+Output yang **benar** harus menampilkan:
+- `Kit version: v1.x.x`
+- `AGENTS.md present: yes`
+- `Manifest signed: yes`
+- `Files: <jumlah> / <jumlah> OK`
+
+Kalau ada `MISSING` atau `MODIFIED` di output, lihat section Troubleshooting di bawah.
+
+---
+
+## Troubleshooting
+
+### Error: "node tidak ditemukan" / "'npx' is not recognized"
+
+**Penyebab**: Node.js belum terinstall di PC.
+
+**Fix**:
+1. Download Node.js LTS dari https://nodejs.org/ (versi LTS, BUKAN Current).
+2. Install dengan opsi default. Pastikan checkbox `Add to PATH` aktif.
+3. Tutup & buka ulang PowerShell.
+4. Cek versi: `node --version` (harus muncul `v20.x.x` atau lebih baru).
+5. Ulangi perintah `npx @ojokesusu/lintasai init`.
+
+### Error: "EACCES" atau "EPERM" di Windows
+
+**Penyebab**: Permission ditolak. Biasanya karena Node.js terinstall di `Program Files` (perlu admin), atau folder project read-only.
+
+**Fix (pilih salah satu)**:
+- **Opsi A (cepat)**: Klik kanan PowerShell -> `Run as Administrator`, lalu ulangi perintah init.
+- **Opsi B (rekomendasi)**: Uninstall Node.js dari Program Files, install ulang di user folder (`C:\Users\<username>\nodejs\`). Ini menghindari masalah permission permanen.
+- **Opsi C**: Pastikan folder project tidak read-only. Klik kanan folder -> Properties -> uncheck `Read-only`.
+
+### Error: "ExecutionPolicy" PowerShell block
+
+**Penyebab**: Windows default block menjalankan script PowerShell yang tidak signed.
+
+**Fix**:
+1. Buka PowerShell sebagai user biasa (tidak perlu admin).
+2. Jalankan:
+   ```powershell
+   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
+   ```
+3. Pilih `Y` saat ditanya konfirmasi.
+4. Ulangi perintah init.
+
+Catatan: `RemoteSigned` aman — hanya allow local script + script remote yang ber-signature. Tidak membuka full security risk.
+
+### Error: Behind corporate proxy / firewall
+
+**Penyebab**: Kantor pakai proxy yang block koneksi npm registry langsung.
+
+**Fix**:
+1. Tanya admin IT kantor untuk URL proxy (biasanya `http://proxy.company.local:8080`).
+2. Set npm config:
+   ```powershell
+   npm config set proxy http://proxy.company.local:8080
+   npm config set https-proxy http://proxy.company.local:8080
+   ```
+3. Kalau proxy butuh auth, format jadi: `http://username:password@proxy.company.local:8080`.
+4. Ulangi perintah init.
+
+Kalau masih gagal, coba registry mirror: `npm config set registry https://registry.npmmirror.com/`.
+
+### Error: "Kit tidak lengkap" / "File hilang"
+
+**Penyebab**: Download terputus di tengah jalan, atau cache npm corrupt.
+
+**Fix**:
+1. Clear cache npm:
+   ```powershell
+   npm cache clean --force
+   ```
+2. Hapus folder `.claude-kit/` yang sudah ada (kalau sebagian terinstall):
+   ```powershell
+   Remove-Item -Recurse -Force .\.claude-kit\
+   ```
+3. Retry:
+   ```powershell
+   npx @ojokesusu/lintasai@latest init
+   ```
+
+### Error: "Root proyek" salah deteksi (npm cache path)
+
+**Penyebab**: Bug di versi kit **pre-v1.1.3** — kit salah deteksi root project ke folder npm cache, bukan ke folder project user.
+
+**Tanda**: Folder `.claude-kit/` muncul di `C:\Users\<username>\AppData\Roaming\npm-cache\...` bukan di project folder.
+
+**Fix**:
+1. Hapus install yang salah:
+   ```powershell
+   npx @ojokesusu/lintasai uninstall
+   ```
+2. Upgrade ke versi terbaru (v1.2.0+):
+   ```powershell
+   npx @ojokesusu/lintasai@latest init
+   ```
+3. Versi v1.2.0+ sudah fix deteksi root via `process.cwd()` (folder PowerShell aktif).
+
+---
+
+## Rollback ke Versi Sebelumnya
+
+Kalau update terbaru bermasalah, rollback ke versi sebelumnya:
+
+```powershell
+npx @ojokesusu/lintasai rollback
+```
+
+Perintah ini akan restore file dari snapshot otomatis yang dibuat saat last update. Snapshot disimpan di `.claude-kit/.snapshots/`.
+
+---
+
+## Uninstall
+
+Hapus kit dari project secara aman (sambil keep file user-custom):
+
+```powershell
+npx @ojokesusu/lintasai uninstall
+```
+
+Perintah ini akan:
+- Hapus folder `.claude-kit/`.
+- Hapus `AGENTS.md` (kalau belum dimodifikasi user).
+- **TIDAK** hapus `docs/`, `src/`, atau file project user lain.
+
+Kalau `AGENTS.md` sudah dimodifikasi, kit akan tanya konfirmasi sebelum hapus.
+
+---
+
+## Cara Update Kit
+
+Update ke versi terbaru:
+
+```powershell
+npx @ojokesusu/lintasai update
+```
+
+Perintah ini akan:
+1. Buat snapshot dari versi current.
+2. Download versi terbaru dari npm.
+3. Merge file yang dimodifikasi user (kalau ada).
+4. Update manifest signature.
+
+Kalau ada konflik merge, kit akan tampilkan diff & tanya pilihan: `keep mine`, `take theirs`, atau `manual merge`.
+
+---
+
+## Cara Cek Apakah Kit Saya Up-to-date
+
+Cek status + versi:
+```powershell
+npx @ojokesusu/lintasai status
+```
+
+Lihat file yang berubah dari versi original:
+```powershell
+npx @ojokesusu/lintasai diff
+```
+
+Output `diff` akan tampilkan:
+- File yang **MODIFIED** (diubah user setelah install).
+- File yang **MISSING** (terhapus).
+- File yang **ADDED** (file baru di luar manifest).
+
+Untuk lihat versi terbaru yang tersedia di npm:
+```powershell
+npm view @ojokesusu/lintasai version
+```
+
+Bandingkan dengan `Kit version` di output `status`. Kalau beda, jalankan `update`.
+
+---
+
+## Kontak Support
+
+- **Discord channel**: `#lintasai-support` (link invite di internal docs tim).
+- **Owner**: dokterbrutal@gmail.com — gunakan Signal/Telegram untuk hal sensitif (kredensial, API key bocor, security incident).
+- **Bug report**: buka issue di GitHub repo `@ojokesusu/lintasai` (link di npm page).
+
+Untuk error yang **tidak** ada di troubleshooting di atas:
+1. Jalankan `npx @ojokesusu/lintasai status --verbose` (output lengkap).
+2. Screenshot output + share di Discord channel.
+3. Jangan paste output yang berisi password / API key — mask dulu.

package/kit.ps1

@@ -12,6 +12,7 @@
     uninstall - Hapus kit dari proyek dengan AMAN (manifest-based, delegate ke uninstall.ps1)
     doctor    - Diagnostic: cek versi + file utuh + broken cross-ref + integrity (sha256)
     scan      - Re-run scan project (tanpa setup) — generate ringkasan kandidat CRITICAL
+    status    - Ringkasan 1-layar (versi, install mode, AGENTS.md, manifest, tier)
     version   - Print versi kit aktif (dari manifest)
     rollback  - Rollback kit ke snapshot sebelum update (delegate ke lib\rollback.ps1)
     help      - Tampilkan usage
@@ -47,9 +48,11 @@
 [CmdletBinding()]
 param(
     [Parameter(Position = 0)]
-    [ValidateSet('setup', 'update', 'uninstall', 'doctor', 'scan', 'version', 'rollback', 'help', '')]
+    [ValidateSet('setup', 'update', 'uninstall', 'doctor', 'scan', 'version', 'rollback', 'status', 'help', '')]
     [string]$Command = '',
 
+    [string]$ProjectRoot = $null,
+
     [Parameter(ValueFromRemainingArguments = $true)]
     [string[]]$ExtraArgs
 )
@@ -57,12 +60,31 @@ param(
 $ErrorActionPreference = 'Stop'
 
 # ---- Resolve paths ----
-$KitDir = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
-$ProjectRoot = Split-Path -Parent $KitDir
+# Script's own location (npm cache when invoked via `npx`, project's .claude-kit when invoked directly).
+$ScriptRoot = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
+
+# Kit-to-inspect: when -ProjectRoot is passed (npx launcher case), inspect the kit di USER CWD
+# (.claude-kit di project), BUKAN script's own location ($ScriptRoot di npm cache). Tanpa
+# -ProjectRoot (direct invocation via .\.claude-kit\kit.ps1), $ScriptRoot SUDAH .claude-kit
+# project, jadi fallback pakai $ScriptRoot.
+if ($ProjectRoot) {
+    $KitDir = Join-Path $ProjectRoot '.claude-kit'
+} else {
+    $KitDir = $ScriptRoot
+    $ProjectRoot = Split-Path -Parent $KitDir
+}
+
+# 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')) {
+    Write-Host ("Inspecting kit at: {0}" -f $KitDir) -ForegroundColor Cyan
+}
 
 # ---- Resolve lib paths (optional dependencies) ----
-$libRollback = Join-Path $PSScriptRoot 'lib\rollback.ps1'
-$libSafety = Join-Path $PSScriptRoot 'lib\safety.ps1'
+# Pakai $KitDir (bukan $PSScriptRoot) supaya respect -ProjectRoot override — saat dipanggil
+# via npx launcher, kit yang di-inspect ada di project (.claude-kit), bukan di npm cache.
+$libRollback = Join-Path $KitDir 'lib\rollback.ps1'
+$libSafety = Join-Path $KitDir 'lib\safety.ps1'
 
 # ---- Helper: detect kit version (defense-in-depth fallback chain) ----
 # Source 1: .install-manifest.json -> metadata.kit_version (PRIMARY — what was installed)
@@ -139,6 +161,9 @@ function Show-Help {
     Write-Host "  scan      - Re-run scan project untuk identifikasi kandidat CRITICAL"
     Write-Host "              (tanpa setup ulang)"
     Write-Host ""
+    Write-Host "  status    - Ringkasan 1-layar: versi, install mode, AGENTS.md, manifest, tier"
+    Write-Host "              (no args)"
+    Write-Host ""
     Write-Host "  version   - Print versi kit aktif (dari .install-manifest.json)"
     Write-Host ""
     Write-Host "  rollback  - Rollback kit ke snapshot sebelum update terakhir"
@@ -426,6 +451,111 @@ function Invoke-Scan {
     return 0
 }
 
+# ---- Helper: status ringkas (1-layar) ----
+# Mirror Invoke-Doctor structure tapi output lebih ringkas — fokus pada snapshot cepat,
+# bukan diagnostic mendalam. Kalau user butuh detail (file inti, integrity sha256, dst.),
+# arahkan ke `doctor`.
+function Invoke-Status {
+    Write-Host ""
+    Write-Host "=== Kit Status (ringkas) ===" -ForegroundColor Cyan
+    Write-Host ""
+
+    # 1. Kit version
+    $version = Get-KitVersion
+    $versionDisplay = if ($version -match '^v') { $version } elseif ($version -eq 'unknown') { 'unknown' } else { "v$version" }
+    Write-Host ("Kit version    : {0}" -f $versionDisplay) -ForegroundColor Green
+
+    # 2. Install mode (npx-mode vs git-clone-mode)
+    # Heuristic: kalau $ScriptRoot path mengandung 'node_modules' atau 'npm-cache' atau
+    # '_npx' (Windows npx cache), itu npx-mode. Selain itu git-clone-mode (atau direct).
+    # Catatan: $ScriptRoot = lokasi kit.ps1 yang lagi running, $KitDir = kit yang di-inspect.
+    $installMode = 'git-clone-mode'
+    if ($ScriptRoot -match '(node_modules|npm-cache|_npx|AppData[\\/]+Local[\\/]+npm-cache)') {
+        $installMode = 'npx-mode'
+    }
+    Write-Host ("Install mode   : {0}" -f $installMode) -ForegroundColor Green
+
+    # 3. AGENTS.md present (Y/N + last modified)
+    $agentsAtRoot = Join-Path $ProjectRoot 'AGENTS.md'
+    if (Test-Path $agentsAtRoot) {
+        try {
+            $agentsMtime = (Get-Item $agentsAtRoot -ErrorAction Stop).LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss')
+            Write-Host ("AGENTS.md      : Y (last modified: {0})" -f $agentsMtime) -ForegroundColor Green
+        } catch {
+            Write-Host "AGENTS.md      : Y (mtime unavailable)" -ForegroundColor Yellow
+        }
+    } else {
+        Write-Host "AGENTS.md      : N (belum di-copy ke project root)" -ForegroundColor Yellow
+    }
+
+    # 4. Manifest signed (Y/N + verify result)
+    # "Signed" di sini = manifest punya field 'signature' atau 'sha256_of_manifest' atau
+    # equivalent. Sekarang kit pakai per-file sha256 di manifest.files[].sha256 — anggap
+    # itu "signed" kalau minimal ada N file dengan sha256 valid.
+    $manifestPath = Join-Path $KitDir '.install-manifest.json'
+    $manifestSignedDisplay = 'N (manifest hilang)'
+    $manifestSignedColor = 'Yellow'
+    $lastUpdateDisplay = 'unknown'
+    if (Test-Path $manifestPath) {
+        try {
+            $manifestJson = [System.IO.File]::ReadAllText($manifestPath, [System.Text.Encoding]::UTF8)
+            $manifest = ConvertFrom-Json $manifestJson -ErrorAction Stop
+
+            # Cek "signed": ada signature field, atau minimal entries dengan sha256
+            $hasSignature = $false
+            if ($manifest.signature) { $hasSignature = $true }
+            if (-not $hasSignature) {
+                $entries = @()
+                if ($manifest.files) { $entries = $manifest.files }
+                elseif ($manifest.entries) { $entries = $manifest.entries }
+                $shaCount = @($entries | Where-Object { $_.sha256 }).Count
+                if ($shaCount -gt 0) {
+                    $hasSignature = $true
+                    $manifestSignedDisplay = ("Y ({0} files w/ sha256)" -f $shaCount)
+                    $manifestSignedColor = 'Green'
+                }
+            } else {
+                $manifestSignedDisplay = 'Y (signature field present)'
+                $manifestSignedColor = 'Green'
+            }
+
+            if (-not $hasSignature) {
+                $manifestSignedDisplay = 'N (manifest ada tapi tidak signed)'
+                $manifestSignedColor = 'Yellow'
+            }
+
+            # Last update timestamp dari manifest
+            if ($manifest.metadata -and $manifest.metadata.installed_at) {
+                $lastUpdateDisplay = $manifest.metadata.installed_at
+            } elseif ($manifest.metadata -and $manifest.metadata.updated_at) {
+                $lastUpdateDisplay = $manifest.metadata.updated_at
+            } elseif ($manifest.installed_at) {
+                $lastUpdateDisplay = $manifest.installed_at
+            }
+        } catch {
+            $manifestSignedDisplay = ("N (gagal parse: {0})" -f $_.Exception.Message)
+            $manifestSignedColor = 'Red'
+        }
+    }
+    Write-Host ("Manifest signed: {0}" -f $manifestSignedDisplay) -ForegroundColor $manifestSignedColor
+
+    # 5. Last update timestamp
+    Write-Host ("Last update    : {0}" -f $lastUpdateDisplay) -ForegroundColor Green
+
+    # 6. Tier setup (.staff-profile.md present?)
+    $staffProfile = Join-Path $ProjectRoot '.staff-profile.md'
+    if (Test-Path $staffProfile) {
+        Write-Host "Tier setup     : Y (.staff-profile.md ada)" -ForegroundColor Green
+    } else {
+        Write-Host "Tier setup     : N (.staff-profile.md belum dibuat — solo/owner mode)" -ForegroundColor Yellow
+    }
+
+    Write-Host ""
+    Write-Host "Untuk detail lebih lengkap: .\.claude-kit\kit.ps1 doctor" -ForegroundColor Cyan
+    Write-Host ""
+    return 0
+}
+
 # ---- Helper: print version ----
 # Uses Get-KitVersion fallback chain (manifest -> $script:KIT_VERSION -> CHANGELOG -> "unknown").
 function Show-Version {
@@ -471,6 +601,10 @@ switch ($Command) {
         $code = Invoke-Scan
         exit $code
     }
+    'status' {
+        $code = Invoke-Status
+        exit $code
+    }
     'version' {
         Show-Version
         exit 0

package/lib/kit-files.psd1

@@ -81,7 +81,6 @@
     # Tier 5b: Deprecated stubs (legacy prompts, still on disk, akan dihapus)
     deprecated_stubs = @(
         'BOOTSTRAP_PROJECT_DOCS_PROMPT_v1.md',
-        'FIRST_SESSION_PROMPT_v1.md',
         'PROJECT_KICKOFF_PROMPT_v1.md',
         'PROJECT_MIGRATION_PROMPT_v1.md',
         'SETUP_POLA_B_PROMPT_v1.md',

package/package.json

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

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,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.