Metadata-Version: 2.5
Name: rakit-cli
Version: 2.2.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_list_ready_tickets`, `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/`).

> **Format keluaran:** di terminal interaktif, hasil `rakit` otomatis ditampilkan sebagai JSON berindentasi agar mudah dibaca. Bila keluarannya dipipa (skrip atau agen AI), tetap satu baris JSON per perintah. Paksa lewat `rakit --format pretty|json <perintah>` atau env `RAKIT_OUTPUT=pretty|json`.

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

