@ojokesusu/lintasai 1.1.2 → 1.1.3

package/.gitignore

@@ -0,0 +1,55 @@
+# File yang JANGAN di-commit ke repo standar tim
+# (Kit ini sendiri tidak generate file build, tapi standar untuk repo)
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+ehthumbs.db
+ehthumbs_vista.db
+
+# Editor / IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.history/
+.project
+.classpath
+
+# Backup yang dihasilkan install-windows.ps1 saat re-install
+*.backup-*
+*.bak
+*.old
+
+# Log
+*.log
+npm-debug.log*
+yarn-debug.log*
+
+# Secret — JANGAN PERNAH commit
+.env
+.env.local
+.env.*.local
+*.pem
+*.key
+credentials*
+secrets/
+
+# Build / output (kalau kit di-extend dengan tools nantinya)
+node_modules/
+dist/
+build/
+out/
+.next/
+.cache/
+
+# Test coverage
+coverage/
+*.lcov
+
+# Paket lokal saat zipping/testing
+*.zip
+*.tar.gz
+*.tgz

package/AGENTS.md.template

@@ -0,0 +1,91 @@
+# AGENTS.md — Aturan Proyek <NAMA_PROYEK>
+
+> v1 · <TANGGAL_HARI_INI> · ikut standar tim IT (Pola B)
+
+<!-- Header di atas auto-isi oleh setup-pola-b.ps1 (nama proyek dari folder root, tanggal dari sistem). Kalau setup manual, isi sendiri. -->
+
+---
+
+## Pengantar
+
+Proyek ini ikut **standar kerja tim IT** (kit terpasang di `./.claude-kit/`).
+Aturan utama (cara coding, dokumentasi, larangan) ada di **`./.claude-kit/CLAUDE_universal_v1.md`** — wajib dibaca AI tiap sesi.
+File ini cuma berisi **override khusus proyek** + instruksi resolusi path supaya AI tidak nyasar ke folder global.
+
+---
+
+## Path resolution (PENTING — instruksi untuk AI)
+
+Kit ini di-embed di subfolder `./.claude-kit/` (bukan di `%USERPROFILE%\.claude\`).
+Saat baca/merujuk file kit, **kamu (AI) wajib mengganti** path lama jadi path lokal:
+
+- `%USERPROFILE%\.claude\<NAMA_FILE>` → `./.claude-kit/<NAMA_FILE>`
+- `~/.claude/<NAMA_FILE>` → `./.claude-kit/<NAMA_FILE>`
+
+Kalau install global **dan** `./.claude-kit/` sama-sama ada → **`./.claude-kit/` menang** (version-locked per proyek).
+
+---
+
+## Versi kit aktif
+
+- Versi kit di `./.claude-kit/`: **<VERSI_KIT>** <!-- ISI manual setelah cek `./.claude-kit/CHANGELOG.md`. Tulis literal (tanpa kurung siku). -->
+- Sumber kit (repo standar tim): **<URL_REPO_STANDAR>** <!-- ISI: URL repo git tempat kit dirilis. -->
+
+---
+
+## Override khusus proyek
+
+Centang `[x]` cuma yang **beda dari default kit**. Yang tidak dicentang = ikut default.
+Contoh: `- [x] Bahasa docs: EN (override dari default ID karena klien minta)`.
+
+- [ ] Bahasa docs: <!-- default ID -->
+- [ ] Format commit: <!-- default Conventional Commits -->
+- [ ] Folder `docs/`: <!-- default ikut `./.claude-kit/templates/architecture.md` -->
+- [ ] Tech stack: <!-- default React/Next.js + Tailwind + shadcn -->
+- [ ] Branch utama: <!-- default `main` -->
+- [ ] Pakai GitHub Issue: <!-- default Tidak — pakai chat. Ubah ke `Ya` kalau ada klien eksternal yang tracking via Issue. -->
+- [ ] Channel chat task: <!-- link Slack/Discord/Telegram/WhatsApp tempat staff posting task -->
+- [ ] Lain-lain:
+
+---
+
+## Workflow & Komunikasi Task
+
+Tim ini pakai workflow chat-driven (tanpa GitHub Issue by default). Detail di `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 5b.
+
+- **Channel chat task**: <!-- ISI: link Slack/Discord/Telegram/WhatsApp -->
+- **Pakai GitHub Issue?** Tidak (default tim). Ubah ke "Ya" kalau proyek punya klien eksternal yang tracking via Issue.
+- **Format prompt task**: lihat `./.claude-kit/templates/PROMPT_LIBRARY.md` section "Prompts untuk Workflow Chat-Driven Task".
+- **Risk Level decision tree**: lihat `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 7b (Low/Medium/High klasifikasi task).
+- **Rollback playbook**: lihat `./.claude-kit/templates/CLAUDE_TEAM_GUIDE.md` section 13b (git revert <5 menit).
+- **Feature flag** = advanced/post-launch (kit early-stage default = staging-only). Lihat `./.claude-kit/templates/feature-flags-advanced.md` kalau butuh.
+
+---
+
+## Skenario adopsi (pilih SATU, hapus 3 sisanya)
+
+- **(a) Proyek baru / from scratch** → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage A: Kickoff)
+- **(b) Proyek lama tanpa docs** → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage B: Bootstrap Docs)
+- **(c) Proyek setengah jadi (sudah ada sebagian docs)** → `./.claude-kit/PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration)
+- **(d) Sudah siap kerja task biasa (tidak butuh kickoff/migrasi)** → langsung pakai
+
+Sesi pertama tim member baru: jalankan `./.claude-kit/SETUP_POLA_B_PROMPT_v1.md`.
+
+---
+
+## Catatan tim
+
+<!-- Kosongkan section ini kalau proyek solo. -->
+
+- Owner standar tim: <!-- nama + email/handle PIC kit -->
+- Channel diskusi: <!-- link Slack/Discord/Telegram -->
+
+---
+
+## Riwayat update kit di proyek ini
+
+| Versi kit | Tanggal update     | Siapa update | Catatan              |
+|-----------|--------------------|--------------|----------------------|
+| <VERSI_KIT> | <TANGGAL_HARI_INI> | <NAMA_KAMU>  | Setup awal Pola B    |
+
+<!-- Tambah baris baru tiap update isi `./.claude-kit/` ke versi lebih baru. -->

package/CHANGELOG.md

@@ -20,6 +20,26 @@ Slot tambahan untuk perubahan berikutnya sebelum versi v1.0.2.
 
 ---
 
+## v1.1.3 [2026-06-06]
+
+### Fixed
+
+#### NPX Invocation Bugs (Distribution Blocker)
+- **Bug 1**: AGENTS.md.template tidak ter-bundle ke npm tarball — fix di package.json files array (added "*.template", "AGENTS.md.template", "decisions/", "LICENSE")
+- **Bug 2**: bin/lintasai.js tidak pass user CWD ke setup-pola-b.ps1, sehingga script salah deteksi "Root proyek" sebagai npm cache folder bukan user folder
+  - Fix: bin/lintasai.js sekarang pass `-ProjectRoot $process.cwd()` untuk command init/update/uninstall
+  - Fix: setup-pola-b.ps1 sekarang accept `-ProjectRoot` parameter
+  - Fix: setup-pola-b.ps1 detect "npx mode" (kit source di npm cache vs project) lalu COPY kit ke $ProjectRoot/.claude-kit/
+
+### Migration
+Staff yang baru install via `npx @ojokesusu/lintasai init` sekarang akan dapat behavior yang benar:
+- Kit copy dari npm cache ke <user-project>/.claude-kit/
+- "Root proyek" = folder user CWD
+- "Nama proyek" = nama folder user
+- AGENTS.md.template ada di tarball, deploy berhasil
+
+---
+
 ## v1.1.2 [2026-06-06]
 
 ### Changed

package/bin/lintasai.js

@@ -66,16 +66,22 @@ if (!target) {
 }
 
 // Build powershell command
+const userCwd = process.cwd();
+// For init/update/uninstall: pass user CWD explicitly so script knows real project root
+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];
+} else if (shouldPassProjectRoot) {
+  // Direct script call with -ProjectRoot
+  psArgs = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", path.join(KIT_ROOT, target), "-ProjectRoot", userCwd, ...args];
 } else {
   // Direct script call
   psArgs = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", path.join(KIT_ROOT, target), ...args];
 }
 
-const child = spawn("powershell.exe", psArgs, { stdio: "inherit" });
+const child = spawn("powershell.exe", psArgs, { stdio: "inherit", cwd: userCwd });
 child.on("close", (code) => {
   process.exit(code || 0);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ojokesusu/lintasai",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "AI workflow kit untuk Claude Code dengan tier model + cross-repo automation (Windows-first)",
   "bin": {
     "lintasai": "./bin/lintasai.js"
@@ -8,12 +8,18 @@
   "files": [
     "bin/",
     "*.ps1",
+    "*.psm1",
     "lib/",
     "templates/",
     "docs/",
     "tests/",
     "*.md",
-    ".github/"
+    "*.template",
+    "AGENTS.md.template",
+    ".github/",
+    "decisions/",
+    "LICENSE",
+    ".gitignore"
   ],
   "scripts": {
     "test": "echo \"Pester tests run via ./tests/Run-Tests.ps1\" && exit 0"

package/setup-pola-b.ps1

@@ -38,7 +38,8 @@
 param(
     [switch]$Force,
     [switch]$DryRun,
-    [switch]$SkipTeamFiles
+    [switch]$SkipTeamFiles,
+    [string]$ProjectRoot = $null
 )
 
 $ErrorActionPreference = 'Stop'
@@ -46,6 +47,50 @@ $ErrorActionPreference = 'Stop'
 # ---- Resolve folder kit (tempat script ini berada) ----
 $KitDir = if ($PSScriptRoot) { $PSScriptRoot } elseif ($MyInvocation.MyCommand.Path) { Split-Path -Parent $MyInvocation.MyCommand.Path } else { (Get-Location).Path }
 
+# ---- Resolve ProjectRoot (npm wrapper vs traditional invocation) ----
+# Traditional: kit lives at <project>/.claude-kit/, $ProjectRoot = parent of $KitDir.
+# NPX wrapper: $ProjectRoot passed explicitly; kit source at $KitDir (npm cache) must
+#              be COPIED to $ProjectRoot/.claude-kit/ before setup continues.
+$script:__lintasAI_NpxMode = $false
+if (-not $ProjectRoot) {
+    # Traditional invocation - kit lives at <project>/.claude-kit/, parent is project
+    $ProjectRoot = Split-Path -Parent $KitDir
+} else {
+    # NPX wrapper invocation - $ProjectRoot passed explicitly
+    Write-Host "[npx] Mode: explicit ProjectRoot = $ProjectRoot" -ForegroundColor Cyan
+    $script:__lintasAI_NpxMode = $true
+}
+$ProjectRoot = (Resolve-Path $ProjectRoot -ErrorAction Stop).Path
+
+# ---- NPX mode: copy kit from $KitDir (npm cache) to $ProjectRoot/.claude-kit/ ----
+# Detection: if $KitDir is NOT already inside $ProjectRoot/.claude-kit/, we need to copy.
+$expectedKitDir = Join-Path $ProjectRoot '.claude-kit'
+$kitDirResolved = (Resolve-Path $KitDir -ErrorAction Stop).Path
+$expectedKitDirNormalized = $expectedKitDir.TrimEnd('\','/')
+$kitDirNormalized = $kitDirResolved.TrimEnd('\','/')
+if ($script:__lintasAI_NpxMode -and ($kitDirNormalized -ne $expectedKitDirNormalized)) {
+    Write-Host "[npx] Copy kit: $KitDir -> $expectedKitDir" -ForegroundColor Cyan
+    if (-not $DryRun) {
+        if (-not (Test-Path $expectedKitDir)) {
+            New-Item -ItemType Directory -Path $expectedKitDir -Force | Out-Null
+        }
+        # Robocopy or Copy-Item: use Copy-Item for cross-platform-ish behavior
+        Get-ChildItem -Path $KitDir -Force | ForEach-Object {
+            $destPath = Join-Path $expectedKitDir $_.Name
+            if ($_.PSIsContainer) {
+                Copy-Item -Path $_.FullName -Destination $destPath -Recurse -Force
+            } else {
+                Copy-Item -Path $_.FullName -Destination $destPath -Force
+            }
+        }
+        Write-Host "[npx] Kit copied successfully." -ForegroundColor Green
+    } else {
+        Write-Host "[DRY] [npx] Would copy kit contents from $KitDir to $expectedKitDir" -ForegroundColor Yellow
+    }
+    # Pivot $KitDir to the deployed location so rest of script operates on project copy
+    $KitDir = $expectedKitDir
+}
+
 # ---- Dot-source library helpers (heavy-lifting) ----
 # Order penting: agents-md.ps1 dot-source SEBELUM manifest.ps1.
 # agents-md.ps1 punya guard `if ($script:__lintasAI_AgentsMdLoaded)` (anti-redefine).
@@ -130,7 +175,11 @@ if ($kitFolderName -ne '.claude-kit') {
 }
 
 # ---- Resolve root proyek (parent dari folder kit) ----
-$ProjectRoot = Split-Path -Parent $KitDir
+# NOTE: $ProjectRoot sudah di-resolve di atas (param eksplisit atau Split-Path -Parent $KitDir).
+# Re-derive di sini HANYA kalau belum di-set (defensif). Skip kalau npx mode (sudah eksplisit).
+if (-not $ProjectRoot) {
+    $ProjectRoot = Split-Path -Parent $KitDir
+}
 $ProjectName = Split-Path -Leaf $ProjectRoot
 $Today = Get-Date -Format 'yyyy-MM-dd'
 $Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'