lastgen-cli 1.0.0

package/README.md

@@ -0,0 +1,269 @@
+# QAI CLI
+
+> **Lastgen Software CLI Project**
+
+OpenAI uyumlu (`/v1/chat/completions`, `/v1/models`) herhangi bir API'ye bağlanan,
+terminal içinde tam ekran **TUI** arayüzüyle çalışan Global / Kurumsal AI Terminal Asistanı.
+
+Kurumsal LiteLLM proxy, GLM z.ai, OpenAI, OpenRouter, Groq, Together, LM Studio,
+Ollama gibi tüm OpenAI uyumlu endpoint'lerle çalışır.
+
+---
+
+## Kurulum
+
+```bash
+npm install
+npm run build
+npm link        # global "qai" komutu
+```
+
+---
+
+## Kullanım
+
+```bash
+qai
+```
+
+İlk çalıştırmada yapılandırma yoksa otomatik olarak `/login` akışı başlar.
+
+---
+
+## Tam Ekran TUI
+
+```
+╭──────────────────────────────────────╮
+│  lastGen pixel logo                  │
+│  QAI CLI · Global / Kurumsal AI      │
+│  Lastgen Software CLI Project        │
+╰──────────────────────────────────────╯
+
+◢ QAI  Merhaba! Bugün ne keşfediyoruz?
+
+  ╭─────────────────────────────────╮
+  │ kullanıcı mesajı (beyaz balon)  │
+  ╰─────────────────────────────────╯
+
+◢ QAI · glm-5.2
+Yanıt token token akar (daktilo efekti)...
+↳ 312 tok  ·  4.1s
+
+  ┄──────────────────────────────────
+  [1] kuyrukta bekleyen mesaj         ← Ctrl+O ile genişlet/daralt
+  ┄──────────────────────────────────
+╭──────────────────────────────────────╮
+│ › /trello-write-plan▌                │
+╰─────────────────── total token: 1.2k╯
+```
+
+**TUI özellikleri:**
+
+| Özellik | Açıklama |
+|---------|----------|
+| Tam ekran alternate buffer | Resize'da bozulma yok, synchronized output |
+| Daktilo efekti | QAI yanıtları token token yazılır (Markdown render) |
+| Düşünme animasyonu | Türkçe cümleler glitch→decode efektiyle geçiş yapar |
+| Scroll | `↑`/`↓` satır satır, `PgUp`/`PgDn` yarım ekran |
+| Kuyruk (queue) | QAI meşgulken mesajlar sıraya girer, `↑`/`↓` ile düzenle |
+| Ctrl+O | Tool call stack'ini genişlet/daralt |
+| Paste desteği | Bracketed paste — çok satırlı metin `⌗1  47 satır` olarak gösterilir |
+| Komut renklendirme | `/login` mavi, bilinmeyen komut kırmızı |
+| Syntax highlighting | Kod blokları VS Code Dark+ temasına yakın renklendirilir |
+| Rich formatting | Dosya yolu (mavi), class (cyan), fonksiyon (yeşil), satır no (sarı) |
+| Token göstergesi | Her yanıtta `↳ tok · s` (yeşil), sağ altta `total token` |
+| Karşılama / veda | Açılışta logo decode animasyonu + Türkçe karşılama, CTRL+C'de veda mesajı |
+| Lastgen logosu | Banner'da piksel bazlı LED dot-matrix, açılışta glitch→decode efekti |
+| Ekstra bağlam | write-plan'da kart/issue seçildikten sonra "Seçilen Task" kutusu + opsiyonel ekstra bilgi girişi |
+
+### Klavye kısayolları
+
+| Tuş | İşlev |
+|-----|-------|
+| `Enter` | Mesaj gönder |
+| `↑` / `↓` | Scroll (normal) · Kuyruk gezme (QAI meşgulken) |
+| `PgUp` / `PgDn` | Yarım ekran scroll |
+| `Ctrl+O` | Tool call stack genişlet/daralt (write-plan sırasında) |
+| `Ctrl+C` | Veda animasyonu + kayıt + çıkış |
+
+---
+
+## Oturum Yönetimi
+
+```
+~/.qai/
+├── config.json         # API yapılandırması
+├── current-session     # Aktif oturum ID'si
+└── sessions/
+    ├── 20260618-153000-ab12.json
+    └── ...
+```
+
+- **Yeni oturum**: `qai` her açıldığında yeni oturum başlar
+- **Geçiş**: `/resume` ile ok tuşlu seçici açılır
+- **Silme**: Session picker'da `D` tuşu
+
+---
+
+## Komutlar
+
+| Komut | Açıklama |
+|-------|----------|
+| `/login` | Endpoint türü seç (Kurumsal / Global), key gir, doğrula, kaydet |
+| `/models` | Modelleri listele ve aktif modeli seç |
+| `/trello` | Trello kartından geliştirme planı üret ve dosyaya kaydet |
+| `/trello-login` | Trello App Key ve Token ayarla |
+| `/trello-write-plan` | Trello kartını AI ile analiz et, JSON uygulama planı üret |
+| `/trello-execute-plan` | Kaydedilen planı seçip Coding Agent ile uygula |
+| `/jira <KEY>` | Jira task'ından geliştirme planı üret |
+| `/jira-login` | Jira base URL ve PAT ayarla |
+| `/export` | Aktif oturumu Markdown dosyasına aktar |
+| `/prompt` | Sistem prompt editörü |
+| `/config` | Mevcut bağlantı ayarlarını göster |
+| `/clear` | Ekranı temizle |
+| `/reset` | Sohbet geçmişini sıfırla |
+| `/resume` | Ok tuşlu seçiciyle kayıtlı oturumlar arasında geçiş yap |
+| `/session-delete` | Eski oturumları sil |
+| `/help` | Yardımı göster |
+| `/exit` | Çıkış (Ctrl+C de çalışır) |
+
+---
+
+## Coding Agent Pipeline
+
+### `/trello-write-plan`
+
+Trello kartını gerçek kaynak kodla analiz ederek atomik uygulama planı üretir.
+
+```
+1. Pano seçici (ok tuşlu) → Kart seçici (ok tuşlu)
+2. Seçilen Task kutusu + ekstra bilgi promptu (opsiyonel)
+3. AI araştırma: list_files + read_file ile proje incelenir
+   ⚙ 34 araç çağrısı  Ctrl+O genişlet
+4. Araştırma özeti → bağlam sıkıştırma
+5. JSON plan üretimi (temperature: 0.3, token limiti yok)
+6. .trello_plans/{id}.json olarak kaydedilir
+```
+
+Plan formatı (JSON):
+```json
+{
+  "task_source": "Trello",
+  "task_id": "AbCdEfGh",
+  "title": "Görev başlığı",
+  "summary": "Teknik özet",
+  "affected_files": ["src/services/UserService.java"],
+  "steps": [
+    {
+      "step_number": 1,
+      "description": "UUID import ekle",
+      "target_file": "src/utils/UsernameGenerator.java",
+      "instructions": "generateUsername() metodunu güncelle..."
+    }
+  ],
+  "verification_command": "mvn test"
+}
+```
+
+### `/trello-execute-plan`
+
+Kaydedilen planı seçip Coding Agent ile uygular.
+
+```
+1. Plan seçici (ok tuşlu)
+2. Onay
+3. Agent döngüsü:
+   - Her adım: read_file → apply_patch → run_command (test)
+   - Test başarısızsa: hata analiz → yeni patch → tekrar test
+   - Döngü sonu: verification_command otomatik çalıştırılır
+4. Tüm çıktılar TUI transcript'e yazılır
+```
+
+**Güvenlik:**
+- Yalnızca proje dizini içindeki dosyalara erişim
+- İzinli komutlar: `pytest`, `npm test`, `mvn test`, `go test`, `cd && ...` vb.
+- Her `apply_patch` `.{timestamp}.bak` yedek oluşturur
+
+---
+
+## Endpoint Türleri
+
+| Tür | Açıklama |
+|-----|----------|
+| **Kurumsal** | Endpoint elle girilir, `verifySsl`/`caBundlePath` desteklenir |
+| **Global (GLM z.ai)** | `https://api.z.ai/api/coding/paas/v4` sabit, sadece API key istenir |
+
+---
+
+## Yapılandırma
+
+`~/.qai/config.json`:
+
+```json
+{
+  "provider": "external",
+  "baseUrl": "https://api.z.ai/api/coding/paas/v4",
+  "apiKey": "<Z_AI_API_KEY>",
+  "model": "glm-5.2",
+  "trelloKey": "<TRELLO_APP_KEY>",
+  "trelloToken": "<TRELLO_USER_TOKEN>",
+  "trelloBoardId": "<BOARD_ID>",
+  "trelloBoardName": "My Board",
+  "jiraBaseUrl": "https://jira.sirket.com",
+  "jiraToken": "<JIRA_PAT>"
+}
+```
+
+---
+
+## Ortam Değişkenleri
+
+| Değişken | Açıklama |
+|----------|----------|
+| `QAI_CONFIG_DIR` | Yapılandırma dizini (varsayılan: `~/.qai`) |
+| `QAI_NO_TUI` | `1` → TUI devre dışı, klasik readline modu |
+
+---
+
+## Geliştirme
+
+```bash
+npm test          # Vitest birim testleri (96 test)
+npm run typecheck # TypeScript tip kontrolü
+npm run build     # dist/ çıktısı (tsup, ESM)
+```
+
+Proje yapısı:
+
+```
+src/
+├── index.ts            # Giriş noktası
+├── repl.ts             # Ana döngü ve başlangıç
+├── tui.ts              # Tam ekran TUI (~1250 satır) — logo decode animasyonu
+├── session-picker.ts   # Ok tuşlu oturum seçici
+├── sessions.ts         # Oturum kayıt/yükleme sistemi
+├── history.ts          # Geriye dönük uyumluluk
+├── commands.ts         # Slash komutları + agent fonksiyonları + ekstra bağlam
+├── agent-tools.ts      # list_files, read_file, apply_patch, run_command
+├── agent-loop.ts       # Execute agent döngüsü, self-correction
+├── agent-plan.ts       # Write-plan: araştırma, özet, JSON plan
+├── rich-format.ts      # Terminal rich formatting
+├── api.ts              # OpenAI uyumlu streaming + retry
+├── markdown.ts         # Markdown→ANSI renderer + syntax highlighting
+├── ui.ts               # Terminal yardımcıları, renkler, animasyon, banner, logo decode, promptExtraContext
+├── config.ts           # Yapılandırma okuma/yazma
+├── providers.ts        # Endpoint preset sistemi
+├── jira.ts             # Jira REST API istemcisi
+├── trello.ts           # Trello API + kart/pano seçici
+├── context.ts          # Proje dosyası tarayıcı
+└── plan.ts             # Jira geliştirme planı üretici
+
+scripts/
+└── png-to-blocks.mjs   # PNG → terminal half-block karakter dönüştürücü
+```
+
+---
+
+## Lisans
+
+MIT

package/dist/agent-init-CBHFO47V.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  LASTGEN_CONTEXT_FILE,
+  generateLastgenContext,
+  hasLastgenContext,
+  lastgenContextPath,
+  readLastgenContext
+} from "./chunk-UV67GGHZ.js";
+export {
+  LASTGEN_CONTEXT_FILE,
+  generateLastgenContext,
+  hasLastgenContext,
+  lastgenContextPath,
+  readLastgenContext
+};