rakit-cli 2.0.1__py3-none-any.whl

rakit_cli/templates/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: rakit
+description: >-
+  Skill orkestrator alur kerja AI & pengembang untuk ekosistem RAKIT v2.0.
+  Membimbing siklus hidup pengembangan dari ide (PRD, User Story, ADR, DB Design, Prototipe),
+  interaksi tiket backlog via MCP/CLI (/rakit, /rakit-status, /rakit-claim-ticket, /rakit-sync-progress, /rakit-ask-human),
+  hingga quality gates (G1 Spec, G2 QA/UAT, G3 Production Release).
+---
+
+# RAKIT v2.0 AI Assistant Skill
+
+Skill ini menginstruksikan asisten AI (Antigravity, Claude Code, Cursor, Windsurf, Gemini CLI, dll.)
+untuk bekerja secara disiplin, terstruktur, dan terintegrasi dengan orkestrator **RAKIT v2.0**.
+
+---
+
+## 0. Prinsip Eksekusi Utama (Non-Negotiable)
+
+1. **Eksekusi Riil vs Simulasi Teks**:
+   - **DILARANG KERAS** hanya mensimulasikan hasil kerja di obrolan chat tanpa tindakan nyata!
+   - Saat diperintahkan klaim tiket, sinkronkan progres, atau uji kode, agen **WAJIB** menjalankan
+     tool MCP terkait (`rakit_claim_ticket`, `rakit_sync_progress`, dll.) atau mengeksekusi perintah
+     terminal nyata (`rakit ...`, `uv run ...`, `flutter test`, dll.).
+
+2. **Gerbang Spesifikasi G1 (No Ghost Code)**:
+   - Dilarang menulis kode fitur baru sebelum tiket aktif diklaim dan kriteria penerimaan
+     berformat *Given-When-Then (GWT)* telah dipahami dari berkas `.rakit/PROMPT.md`.
+
+3. **Pagar Keamanan Ketat (Zero Leakage)**:
+   - Jangan pernah membaca, memodifikasi, atau membocorkan berkas rahasia: `.env*`, `*.pem`, `*.key`,
+     token akses, serta direktori `secrets/`.
+   - Selalu sensor data sensitif sebelum melaporkan progres ke server.
+
+4. **Disiplin TDD & Quality Gate G2**:
+   - Setiap baris logika bisnis atau perbaikan bug **WAJIB** disertai Unit Test yang sesuai.
+   - Semua pengujian harus lulus (`uv run pytest` / `flutter test`) sebelum tiket diajukan ke tahap verifikasi.
+
+---
+
+## 1. Katalog Perintah Slash & Alur Kerja
+
+Gunakan perintah-perintah berikut di chat untuk memicu alur kerja terstruktur RAKIT:
+
+### A. Perintah Inti MCP & Sinkronisasi
+| Perintah | Alat yang Dipanggil | Deskripsi |
+| :--- | :--- | :--- |
+| `/rakit` | MCP `rakit_status` / CLI `rakit banner` | Menampilkan ringkasan status orkestrasi, tiket aktif, dan panduan cepat. |
+| `/rakit-status` | MCP `rakit_status` / CLI `rakit status` | Membaca status workspace lokal, tiket aktif, dan progres `TASKS.md`. |
+| `/rakit-claim-ticket <KEY>` | MCP `rakit_claim_ticket` / CLI `rakit start <KEY>` | Mengklaim tiket aktif dari backlog, mengikat workspace, & membuat `.rakit/PROMPT.md`. |
+| `/rakit-sync-progress [note]` | MCP `rakit_sync_progress` / CLI `rakit sync --note` | Menyaring rahasia, mencatat event ke antrean luring idempoten, & sinkron ke Web Console. |
+| `/rakit-ask-human <tanya>` | MCP `rakit_ask_human` | Menjeda pengerjaan, ubah status ke `NEEDS_HUMAN`, & kirim eskalasi ke Web Console/HP dev. |
+
+### B. Perintah Rekayasa Kebutuhan & Desain (Lifecycle dari Awal)
+| Perintah | Keluaran / Artefak | Deskripsi |
+| :--- | :--- | :--- |
+| `/rakit-new-task <judul>` | `TASKS.md` & BACKLOG Server | Merumuskan task baru berformat GWT, menentukan pagar modul, & mendaftarkan ke backlog. |
+| `/rakit-prd <nama_fitur>` | `docs/prd/<fitur>.md` | Menyusun dokumen PRD lengkap (Problem, Goals, Non-Goals, Scope, Security, Edge Cases). |
+| `/rakit-user-story <fitur>` | `docs/prd/user-stories/<fitur>.md` | Memecah PRD menjadi User Stories tajam dengan Acceptance Criteria GWT dan estimasi poin. |
+| `/rakit-adr <judul>` | `docs/adr/ADR-XXX-<judul>.md` | Membuat Architectural Decision Record standar Nygard untuk keputusan teknik krusial. |
+| `/rakit-db-design <modul>` | Model Django / ERD / Migrasi | Merancang skema database relasional, tenant isolation, audit trails, dan validasi constraint. |
+| `/rakit-proto <komponen>` | Template Cotton / Widget M3 | Merancang spesifikasi prototipe UI (Dasa UI v2, Cotton, HTMX, atau Flutter Pastel). |
+
+### C. Perintah Verifikasi, QA & Rilis
+| Perintah | Keluaran / Tindakan | Deskripsi |
+| :--- | :--- | :--- |
+| `/rakit-verify` | CLI `rakit verify` + `uv run pytest` | Menjalankan audit linter, unit test, cakupan coverage, dan kesiapan Gerbang G2 (QA). |
+| `/rakit-uat <skenario>` | `docs/uat/<fitur>.md` & Playwright | Menyusun skenario Acceptance Test Plan dan skrip flow otomatis Playwright E2E. |
+| `/rakit-e2e-run` | Playwright Runner & rekaman mp4 | Menjalankan suite kontainer rootless E2E dan mengumpulkan laporan video transaksi. |
+| `/rakit-release <versi>` | `pyproject.toml`, `CHANGELOG.md` | Memeriksa Gerbang G3, bump SemVer, update log perubahan, dan verifikasi artefak rilis. |
+
+---
+
+## 2. Panduan Eksekusi Langkah demi Langkah untuk AI
+
+### Alur 1: Saat Menerima Instruksi 'Lanjutkan Pekerjaan dari RAKIT'
+1. Panggil MCP `rakit_status` untuk mengetahui proyek dan tiket aktif.
+2. Periksa apakah berkas `.rakit/PROMPT.md` sudah tersedia:
+   - Jika belum, jalankan `rakit prompt <KEY>` atau panggil `rakit_claim_ticket`.
+3. Baca `.rakit/PROMPT.md` secara cermat: perhatikan `allowed_paths`, `forbidden_paths`, dan skenario `acceptance_criteria` (GWT).
+4. Buat rencana kerja di `TASKS.md` bila belum ada to-do terperinci.
+5. Kerjakan kode secara nyata di direktori yang diizinkan.
+6. Buat unit test yang sesuai dan jalankan pengujian sampai lulus hijau.
+7. Lakukan sinkronisasi progres berkala: panggil MCP `rakit_sync_progress` atau jalankan `rakit sync --note "..."`.
+
+### Alur 2: Merumuskan Fitur Baru dari Nol (/rakit-new-task, /rakit-prd)
+1. Bantu pengguna merumuskan problem statement dan target persona.
+2. Buat dokumen PRD di `docs/prd/<nama_fitur>.md` dengan struktur:
+   - Ringkasan Eksekutif & Latar Belakang Masalah
+   - Tujuan (Goals) & Hal di Luar Cakupan (Non-Goals)
+   - Persyaratan Fungsional (FR) & Kriteria Penerimaan (GWT)
+   - Pertimbangan Keamanan, Privasi & Multi-tenancy
+   - Batasan Jalur Berkas (`allowed_paths`)
+3. Pecah FR menjadi User Stories di `docs/prd/user-stories/`.
+4. Jika menyangkut keputusan arsitektur baru, buat ADR di `docs/adr/`.
+5. Daftarkan butir-butir to-do ke `TASKS.md` lokal, lalu jalankan `rakit scan --persist` agar draf tiket terkirim ke Web Console RAKIT.
+
+### Alur 3: Menyelesaikan dan Memverifikasi Tiket (/rakit-verify)
+1. Pastikan seluruh to-do terkait di `TASKS.md` sudah bertanda `[x]`.
+2. Jalankan linter dan format checker sesuai `verification.lint_command` di `rakit.yaml` (mis. `uv run ruff check .`).
+3. Jalankan unit test & E2E sesuai `rakit.yaml` (mis. `uv run pytest`).
+4. Jalankan perintah `rakit verify`.
+5. Panggil MCP `rakit_sync_progress` dengan ringkasan keberhasilan.
+6. Informasikan kepada pengguna bahwa tiket telah siap untuk ditinjau oleh QA / pengujian UAT (Gerbang G2).
+
+---
+
+## 3. Penanganan Hambatan & Komunikasi (Human-in-the-Loop)
+
+Jika kamu (AI) menemukan:
+- Konflik keputusan arsitektur yang tidak tercantum di dokumen ADR,
+- Ambiguitas kebutuhan bisnis atau kriteria penerimaan,
+- Kegagalan sistem eksternal atau kebutuhan kredensial khusus,
+
+**JANGAN PERNAH** membuat asumsi sepihak atau mem-bypass aturan keamanan.
+Segera panggil tool MCP:
+```json
+{
+  "name": "rakit_ask_human",
+  "arguments": {
+    "question": "Jelaskan dengan ringkas apa yang menjadi blocker dan pilihan solusi yang kamu rekomendasikan."
+  }
+}
+```
+Ini akan otomatis mengubah status tiket di peladen RAKIT menjadi `NEEDS_HUMAN` dan menyalakan notifikasi di Web Console pengembang serta aplikasi mobile Flutter.
+

rakit_cli-2.0.1.dist-info/METADATA

@@ -0,0 +1,108 @@
+Metadata-Version: 2.5
+Name: rakit-cli
+Version: 2.0.1
+Summary: Pendamping folder notebook lokal & server MCP stdio untuk RAKIT v2.0
+Project-URL: Homepage, https://github.com/radianapp/rakit
+Project-URL: Documentation, https://github.com/radianapp/rakit
+Project-URL: Repository, https://github.com/radianapp/rakit
+Author-email: RAKIT Team <rakitsbs@gmail.com>
+License: MIT
+Keywords: agentic,ai,developer-tools,mcp,orchestration,workflow
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# rakit-cli
+
+[![PyPI version](https://img.shields.io/pypi/v/rakit-cli.svg)](https://pypi.org/project/rakit-cli/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**rakit-cli** adalah pendamping baris perintah (CLI) dan server MCP (Model Context Protocol) berbasis `stdio` untuk ekosistem **RAKIT v2.0 (Radian Agentic Kit & Interactive Tracking)**.
+
+Alat ini digunakan oleh pengembang perangkat lunak dan asisten agen AI (seperti Cursor, Claude Code, Windsurf, Copilot, atau Antigravity) untuk mengikat folder notebook lokal ke peladen RAKIT, menyinkronkan progres tiket, dan menjalankan gerbang verifikasi kualitas.
+
+---
+
+## Fitur Utama
+
+- 🔒 **SecretFilter Bawaan**: Mencegah kebocoran berkas sensitif (`.env*`, `*.pem`, `*.key`, token, dan kredensial) secara lokal sebelum dikirim ke server.
+- 📦 **Zero Runtime Dependencies**: Murni menggunakan pustaka bawaan Python 3.12+ (*standard library*), sangat ringan dan cepat dipasang.
+- 🤖 **Server MCP Stdio (`rakit-mcp`)**: Menyediakan perkakas `rakit_status`, `rakit_claim_ticket`, `rakit_sync_progress`, dan `rakit_ask_human` langsung ke agen AI di editor Anda.
+- ⚡ **Offline-First Synchronization**: Perubahan status dan progres tiket dicatat di buffer lokal saat koneksi internet terputus dan disinkronkan otomatis saat kembali online.
+- 🛡️ **Verifikasi Otomatis**: Integrasi linter dan test suite lokal (`rakit verify`) sebelum mengajukan tiket ke gerbang QA/UAT.
+
+---
+
+## Instalasi
+
+### Menggunakan `pip` (Standar)
+```bash
+pip install rakit-cli
+```
+
+### Menggunakan `pipx` (Direkomendasikan untuk CLI Terisolasi)
+```bash
+pipx install rakit-cli
+```
+
+### Menggunakan `uv tool`
+```bash
+uv tool install rakit-cli
+```
+
+---
+
+## Panduan Penggunaan Singkat
+
+### 1. Inisialisasi Proyek Lokal
+Arahkan terminal ke direktori proyek lokal Anda, lalu hubungkan ke server RAKIT:
+
+```bash
+cd /jalur/ke/folder/proyek-anda
+rakit init --project siaga --api-url http://localhost:8000/api/v1 --token <TOKEN_API_ANDA>
+```
+
+> **Tip Token API:** Dapatkan token autentikasi Anda dari Web Console RAKIT di menu **Profil & Token API** (`http://localhost:8000/accounts/profile/`).
+
+### 2. Memindai Struktur Proyek (Smart Scan)
+```bash
+rakit scan
+```
+
+### 3. Mengklaim Tiket Kerja
+```bash
+rakit start TIKET-101
+```
+
+### 4. Menjalankan Verifikasi Kualitas
+```bash
+rakit verify
+```
+
+### 5. Mengaktifkan Server MCP untuk AI
+Tambahkan konfigurasi berikut ke berkas MCP editor Anda (`claude_desktop_config.json` atau settings Cursor/VS Code):
+
+```json
+{
+  "mcpServers": {
+    "rakit-dev": {
+      "command": "rakit-mcp",
+      "args": ["--workspace", "/jalur/ke/folder/proyek-anda"]
+    }
+  }
+}
+```
+
+---
+
+## Lisensi
+
+Didistribusikan di bawah lisensi MIT. Lihat berkas `LICENSE` untuk rincian lengkap.
+

rakit_cli-2.0.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+rakit_cli/__init__.py,sha256=Y5JjdNQCDnkFK9d-aNJbLz_2k1pwGoM-Dj5RqcGDyO8,116
+rakit_cli/branding.py,sha256=r5pNAzCxaDEtqBOvgsyFeh67NObDXJvzOhjiw_qZNTo,799
+rakit_cli/config.py,sha256=mf3o4ibZdgPAn7EeWpf28stWLuIu8h-AIKWtegZ-aVQ,10254
+rakit_cli/main.py,sha256=dheGzHlK3LU_d4vbCltZKQB4dAEXkYcwXbsvcfF6Byg,56150
+rakit_cli/mcp_server.py,sha256=nBkssJD3LCJNPhBA3E175YYtjrpxxkvYWREi0k7bb20,11156
+rakit_cli/security.py,sha256=DM2Pgx7zg5Xpr27J_3OksR465dggZXd7RGQxG9kmpHE,2410
+rakit_cli/skill_installer.py,sha256=yzmKQ6C6PyF7MKWZDOCF8_c6K4hjupB-eyDMgGOCKJ4,8559
+rakit_cli/tasks_parser.py,sha256=Q_Pr_lbPwep238YqifZYaDL2m-NCaBNf0UJv29pyyZQ,1698
+rakit_cli/templates/SKILL.md,sha256=ld3z9GkGUGKEzxpNInlRXTBwl4d_vLsETyQfr50ASGw,7346
+rakit_cli-2.0.1.dist-info/METADATA,sha256=Ngh4K0gtk0az_fj2kJUgtZ2j6AzX5W8kSn9DAeMJySU,3771
+rakit_cli-2.0.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+rakit_cli-2.0.1.dist-info/entry_points.txt,sha256=7xiDa8F9PF5trBm1utZW64z56i4JiOsapD6CeixMOI0,84
+rakit_cli-2.0.1.dist-info/RECORD,,

rakit_cli-2.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

rakit_cli-2.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+rakit = rakit_cli.main:main
+rakit-mcp = rakit_cli.mcp_server:main