@nibgat/aide 0.0.0-stage → 0.2.0

package/src/commands.mjs

@@ -0,0 +1,360 @@
+/**
+ * Panel işlevleri → API komut tablosu ve çalıştırıcısı. Hem tek seferlik komutlar (`aide team list`) hem etkileşimli
+ * oturumdaki `/aide team list` aynı dağıtıcıyı kullanır.
+ */
+import { AideError, call, confirm } from './client.mjs';
+import { print, unwrap, renderMarkdown, c } from './ui.mjs';
+
+/**
+ * `:param` konumsal argümanlarla sırayla doldurulur; `bodyArg` kalan argümanları o gövde alanına koyar; `body` sabit
+ * gövde; `k=v` ve `--data '{…}'` gövdeye eklenir; `confirm` geri alınamaz işler; `query` bayraktan sorgu parametresi.
+ */
+const ROUTES = [
+    // Sohbetler
+    ['sessions', 'list', 'GET', '/api/chat/sessions', 'Sohbetleri listele', { columns: ['id', 'title', 'messageCount', 'updatedAt'] }],
+    ['sessions', 'show', 'GET', '/api/chat/sessions/:id', 'Sohbetin mesajlarını göster', { render: 'messages' }],
+    ['sessions', 'new', 'POST', '/api/chat/sessions', 'Yeni sohbet aç', { bodyArg: 'title' }],
+    ['sessions', 'rename', 'PATCH', '/api/chat/sessions/:id', 'Sohbetin başlığını değiştir', { bodyArg: 'title', required: true }],
+    ['sessions', 'clear', 'POST', '/api/chat/sessions/:id/clear', 'Sohbetin mesajlarını temizle', { confirm: true }],
+    ['sessions', 'rm', 'DELETE', '/api/chat/sessions/:id', 'Sohbeti sil', { confirm: true }],
+    ['sessions', 'cancel', 'POST', '/api/chat/cancel', 'Süren yanıtı durdur', { bodyArg: 'sessionId' }],
+    // Ekip
+    ['team', 'list', 'GET', '/api/employees', 'Personeli listele', { columns: ['id', 'name', 'role', 'department', 'hierarchyRole'] }],
+    ['team', 'show', 'GET', '/api/employees/:id', 'Personel ayrıntısı'],
+    ['team', 'add', 'POST', '/api/employees', 'Personel ekle (name= role= department= skillSets=[...] …)'],
+    ['team', 'set', 'PUT', '/api/employees/:id', 'Personeli güncelle (k=v …)'],
+    ['team', 'rm', 'DELETE', '/api/employees/:id', 'Personeli sil', { confirm: true }],
+    ['team', 'task', 'POST', '/api/engine/agents/:id/task', 'Personele iş ver', { bodyArg: 'instruction', required: true, render: 'answer' }],
+    ['team', 'chat', 'POST', '/api/engine/agents/:id/chat', 'Personelle özel sohbet', { bodyArg: 'message', required: true, render: 'answer' }],
+    ['team', 'history', 'GET', '/api/engine/agents/:id/chat', 'Özel sohbet geçmişi', { render: 'messages' }],
+    ['team', 'tools', 'GET', '/api/employees/:id/tools', 'Personelin araçları'],
+    ['team', 'roles', 'GET', '/api/employees/hierarchy-roles', 'Hiyerarşi rolleri'],
+    // Yetenek setleri
+    ['skills', 'list', 'GET', '/api/skillsets', 'Yetenek setlerini listele', { columns: ['id', 'name', 'tools', 'description'] }],
+    ['skills', 'add', 'POST', '/api/skillsets', 'Yetenek seti ekle (name= description= tools=[...] …)'],
+    ['skills', 'set', 'PUT', '/api/skillsets/:id', 'Yetenek setini güncelle'],
+    ['skills', 'rm', 'DELETE', '/api/skillsets/:id', 'Yetenek setini sil', { confirm: true }],
+    ['skills', 'assign', 'POST', '/api/skillsets/assign', 'Personele yetenek seti ata (employeeId= skillSetId= …)'],
+    // Veri kaynakları
+    ['data', 'list', 'GET', '/api/datasources', 'Veri kaynaklarını listele', { columns: ['name', 'driver', 'status', 'entities'] }],
+    ['data', 'add', 'PUT', '/api/datasources/:name', 'Veri kaynağı ekle/güncelle (driver= host= database= …)'],
+    ['data', 'test', 'POST', '/api/datasources/:name/test', 'Bağlantıyı dene'],
+    ['data', 'discover', 'POST', '/api/datasources/:name/discover', 'Şemayı yeniden keşfet'],
+    ['data', 'describe', 'POST', '/api/datasources/:name/describe', 'Veri sözlüğünü (AI açıklamaları) üret'],
+    ['data', 'catalog', 'GET', '/api/datasources/:name/catalog', 'Katalog (tablolar, alanlar, sözlük)'],
+    ['data', 'note', 'PATCH', '/api/datasources/:name/catalog/:entity', 'Tablo açıklaması/alan notu düzelt (description= …)'],
+    ['data', 'rm', 'DELETE', '/api/datasources/:name', 'Veri kaynağını sil', { confirm: true }],
+    // Otomasyonlar
+    ['auto', 'list', 'GET', '/api/automations', 'Kuralları listele', { columns: ['id', 'name', 'enabled', 'trigger', 'action'] }],
+    ['auto', 'add', 'POST', '/api/automations', 'Kural ekle (--data \'{…}\')'],
+    ['auto', 'set', 'PATCH', '/api/automations/:id', 'Kuralı güncelle'],
+    ['auto', 'enable', 'PATCH', '/api/automations/:id', 'Kuralı aç', { body: { enabled: true } }],
+    ['auto', 'disable', 'PATCH', '/api/automations/:id', 'Kuralı kapat', { body: { enabled: false } }],
+    ['auto', 'rm', 'DELETE', '/api/automations/:id', 'Kuralı sil', { confirm: true }],
+    ['auto', 'events', 'GET', '/api/automations/events', 'Olay kaydı'],
+    ['auto', 'schedules', 'GET', '/api/automations/schedules', 'Zamanlanmış rutinler'],
+    ['auto', 'schedule', 'POST', '/api/automations/schedules', 'Rutin ekle ("Muhasebe her gün 09:00 …")', { bodyArg: 'text', required: true }],
+    ['auto', 'schedule-set', 'PATCH', '/api/automations/schedules/:employeeId/:taskId', 'Rutini güncelle (enabled=false …)'],
+    ['auto', 'schedule-rm', 'DELETE', '/api/automations/schedules/:employeeId/:taskId', 'Rutini sil', { confirm: true }],
+    // Notlar, hesap, organizasyon
+    ['notes', 'list', 'GET', '/api/me/notes', 'Notlarım', { columns: ['id', 'text', 'source', 'createdAt'] }],
+    ['notes', 'add', 'POST', '/api/me/notes', 'Not ekle', { bodyArg: 'text', required: true }],
+    ['notes', 'rm', 'DELETE', '/api/me/notes/:id', 'Notu sil', { confirm: true }],
+    ['reminders', 'list', 'GET', '/api/me/reminders', 'Hatırlatmalarım ve alarmlarım', { columns: ['id', 'text', 'describe', 'status', 'dueAt'] }],
+    ['reminders', 'add', 'POST', '/api/me/reminders', 'Hatırlatma kur ("yarın 14:00 Ahmet Bey\'i ara")', { bodyArg: 'text', required: true, render: 'reminder' }],
+    ['reminders', 'done', 'PATCH', '/api/me/reminders/:id', 'Tamamlandı say', { body: { action: 'done' } }],
+    ['reminders', 'snooze', 'PATCH', '/api/me/reminders/:id', 'Ertele (minutes=10)', { body: { action: 'snooze' } }],
+    ['reminders', 'cancel', 'PATCH', '/api/me/reminders/:id', 'İptal et', { body: { action: 'cancel' } }],
+    ['reminders', 'rm', 'DELETE', '/api/me/reminders/:id', 'Hatırlatmayı sil', { confirm: true }],
+    ['prefs', 'show', 'GET', '/api/me/notification-prefs', 'Bildirim kanallarım'],
+    ['prefs', 'set', 'PUT', '/api/me/notification-prefs', 'Kanalları ayarla (channels=\'["inapp","telegram"]\' telegramChatId= phone= quietHours=\'{"from":"22:00","to":"08:00"}\')'],
+    ['prefs', 'test', 'POST', '/api/me/notification-prefs/test', 'Kanallara deneme bildirimi gönder'],
+    ['project', 'list', 'GET', '/api/projects', 'Projeler', { columns: ['id', 'title', 'status', 'progress', 'updatedAt'] }],
+    ['project', 'start', 'POST', '/api/projects', 'Proje başlat (hedefi yazın; arka planda planlanır)', { bodyArg: 'goal', required: true }],
+    ['project', 'show', 'GET', '/api/projects/:id', 'Proje ayrıntısı (görevler, olaylar, özet)', { render: 'project' }],
+    ['project', 'pause', 'POST', '/api/projects/:id/pause', 'Duraklat (çalışan görev biter, yenisi alınmaz)'],
+    ['project', 'resume', 'POST', '/api/projects/:id/resume', 'Devam ettir'],
+    ['project', 'cancel', 'POST', '/api/projects/:id/cancel', 'İptal et', { confirm: true }],
+    ['project', 'message', 'POST', '/api/projects/:id/messages', 'Araya mesaj (yeni istek/yön değişikliği)', { bodyArg: 'text', required: true }],
+    ['project', 'task', 'PATCH', '/api/projects/:id/tasks/:taskId', 'Görev sırası: first (öne al) · skip (atla) · reopen (yeniden aç)', { bodyArg: 'action', required: true }],
+    ['questions', 'list', 'GET', '/api/questions', 'Bana sorulanlar (--all: hepsi)', { columns: ['id', 'text', 'options', 'defaultOption', 'status'] }],
+    ['questions', 'answer', 'POST', '/api/questions/:id/answer', 'Soruyu yanıtla', { bodyArg: 'answer', required: true }],
+    ['me', 'profile', 'GET', '/api/me/profile', 'Profilim'],
+    ['me', 'set', 'PUT', '/api/me/profile', 'Profili güncelle (name= …)'],
+    ['me', 'password', 'POST', '/api/me/password', 'Şifre değiştir (currentPassword= newPassword=)'],
+    ['org', 'members', 'GET', '/api/me/organization/members', 'Üyeler', { columns: ['id', 'name', 'email', 'orgRole', 'status'] }],
+    ['org', 'invite', 'POST', '/api/me/organization/members', 'Üye davet et (email= name= orgRole=)'],
+    ['org', 'member-set', 'PATCH', '/api/me/organization/members/:memberId', 'Üye rolünü değiştir (orgRole=admin|member)'],
+    ['org', 'member-rm', 'DELETE', '/api/me/organization/members/:memberId', 'Üyeyi çıkar', { confirm: true }],
+    ['org', 'audit', 'GET', '/api/me/organization/audit', 'Denetim kaydı'],
+    ['culture', 'list', 'GET', '/api/culture', 'Şirket kültürü kuralları'],
+    ['culture', 'add', 'POST', '/api/culture/rule', 'Kural ekle (title= description=)'],
+    ['culture', 'rm', 'DELETE', '/api/culture/rule/:id', 'Kuralı sil', { confirm: true }],
+    // Entegrasyonlar
+    ['integrations', 'list', 'GET', '/api/connectors', 'Entegrasyonlar (e-posta, WhatsApp …)'],
+    ['integrations', 'set', 'PUT', '/api/connectors/:type', 'Entegrasyon ayarla (k=v …)'],
+    ['integrations', 'test', 'POST', '/api/connectors/:type/test', 'Entegrasyonu dene'],
+    ['integrations', 'rm', 'DELETE', '/api/connectors/:type', 'Entegrasyonu kaldır', { confirm: true }],
+    // Şirket yönetimi, bildirimler
+    ['company', 'status', 'GET', '/api/engine/status', 'Motor durumu (modeller, kuyruk, hız)'],
+    ['company', 'panel', 'GET', '/api/engine/panel', 'Şirket Yönetimi Paneli verisi'],
+    ['company', 'messages', 'GET', '/api/engine/agent-messages', 'Personel yazışmaları', { columns: ['at', 'kind', 'fromAgentId', 'toAgentId', 'title'] }],
+    ['notify', 'list', 'GET', '/api/engine/notifications', 'Bildirimler (--since ISO tarih)', { query: ['since'] }],
+    // Sistem (platform yöneticisi)
+    ['system', 'host', 'GET', '/api/system/model-host', 'Model sunucusu durumu'],
+    ['system', 'cleanup', 'POST', '/api/system/model-host/cleanup', 'Sahipsiz model süreçlerini temizle (--dry: yalnızca göster)', { dryFlag: true }],
+    ['system', 'update', 'POST', '/api/system/model-host/update', 'Model sunucusu ajanını güncelle'],
+    ['system', 'rollback', 'POST', '/api/system/model-host/rollback', 'Ajanı önceki sürüme döndür', { confirm: true }]
+].map(([group, action, method, url, summary, options = {}]) => ({ group, action, method, url, summary, ...options }));
+
+const GROUP_TITLES = {
+    sessions: 'Sohbetler',
+    team: 'Ekip (personel)',
+    skills: 'Yetenek setleri',
+    data: 'Veri kaynakları',
+    auto: 'Otomasyonlar ve rutinler',
+    notes: 'Notlarım',
+    reminders: 'Hatırlatmalar ve alarmlar',
+    project: 'Projeler (uzun soluklu işler)',
+    questions: 'Bana sorulanlar',
+    prefs: 'Bildirim tercihleri',
+    me: 'Hesabım',
+    org: 'Organizasyon',
+    culture: 'Şirket kültürü',
+    integrations: 'Entegrasyonlar',
+    company: 'Şirket yönetimi',
+    notify: 'Bildirimler',
+    system: 'Sistem (platform yöneticisi)'
+};
+
+const VALUE_FLAGS = new Set(['server', 'token', 'email', 'password', 'session', 'data', 'file', 'since', 'columns', 'workspace']);
+
+/** `count=3` → 3, `enabled=true` → true, `skillSets=["developer"]` → dizi; diğerleri metin. */
+const parseValue = (value) => {
+    if(/^(true|false|null|-?\d+(\.\d+)?|\[.*\]|\{.*\})$/s.test(value)) {
+        try {
+            return JSON.parse(value);
+        } catch {
+            return value;
+        }
+    }
+
+    return value;
+};
+
+/** `--anahtar değer`, `--bayrak`, `anahtar=değer` (gövde alanı) ve konumsal argümanlar ayrılır. */
+const parseArgs = (argv) => {
+    const flags = {};
+    const fields = {};
+    const positional = [];
+
+    for(let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+
+        if(arg.startsWith('--')) {
+            const [key, inline] = arg.slice(2).split(/=(.*)/s);
+            const next = argv[index + 1];
+
+            if(inline !== undefined) {
+                flags[key] = inline;
+            } else if(VALUE_FLAGS.has(key) && next !== undefined) {
+                flags[key] = next;
+                index += 1;
+            } else {
+                flags[key] = true;
+            }
+        } else if(/^[A-Za-z_][\w.]*=/.test(arg)) {
+            const [key, value] = arg.split(/=(.*)/s);
+
+            fields[key] = parseValue(value);
+        } else {
+            positional.push(arg);
+        }
+    }
+
+    return { flags, fields, positional };
+};
+
+/** Tırnakları dikkate alarak satırı argümanlara böler (etkileşimli `/aide …` için). */
+const splitLine = (line) => (line.match(/"[^"]*"|'[^']*'|\S+/g) || []).map((part) => part.replace(/^(["'])(.*)\1$/s, '$2'));
+
+const renderMessages = (value) => {
+    const messages = Array.isArray(value) ? value : value?.messages || [];
+
+    if(messages.length === 0) {
+        console.log(c.dim('(mesaj yok)'));
+        return;
+    }
+
+    messages.forEach((message) => {
+        console.log(message.role === 'user' ? c.bold('❯ Siz') : c.accent('✻ Ai-de'));
+        console.log(`${message.role === 'user' ? (message.content || '') : renderMarkdown(message.content || message.text || '')}\n`);
+    });
+};
+
+const runRoute = async (spec, { flags, fields, positional }) => {
+    const params = (spec.url.match(/:\w+/g) || []).map((param) => param.slice(1));
+    const usage = `aide ${spec.group} ${spec.action} ${params.map((param) => `<${param}>`).join(' ')}${spec.bodyArg ? ` "<${spec.bodyArg}>"` : ''}`.trim();
+
+    if(positional.length < params.length) {
+        throw new AideError(`Eksik argüman: ${usage}`);
+    }
+
+    let url = spec.url;
+
+    params.forEach((param, index) => {
+        url = url.replace(`:${param}`, encodeURIComponent(positional[index]));
+    });
+
+    const rest = positional.slice(params.length);
+    const query = (spec.query || []).filter((key) => flags[key]).map((key) => `${key}=${encodeURIComponent(flags[key])}`);
+
+    if(query.length > 0) {
+        url += `?${query.join('&')}`;
+    }
+
+    if(spec.required && rest.length === 0 && fields[spec.bodyArg] === undefined) {
+        throw new AideError(`Eksik argüman: ${usage}`);
+    }
+
+    const body = spec.method === 'GET' || spec.method === 'DELETE' ? undefined : {
+        ...(spec.body || {}),
+        ...(spec.bodyArg && rest.length > 0 ? { [spec.bodyArg]: rest.join(' ') } : {}),
+        ...(spec.dryFlag ? { dryRun: Boolean(flags.dry) } : {}),
+        ...fields,
+        ...(flags.data ? JSON.parse(String(flags.data)) : {})
+    };
+
+    if(spec.confirm && !(await confirm(flags, `${spec.summary}: ${positional.slice(0, params.length).join(' ')} — emin misiniz?`))) {
+        console.log(c.dim('Vazgeçildi.'));
+        return;
+    }
+
+    const json = await call(flags, spec.method, url, body);
+
+    if(flags.json) {
+        console.log(JSON.stringify(json, null, 2));
+    } else if(spec.render === 'messages') {
+        renderMessages(unwrap(json));
+    } else if(spec.render === 'answer') {
+        const value = unwrap(json);
+        const text = typeof value === 'string' ? value : value?.output || value?.answer || value?.reply || value?.text || value?.content;
+
+        console.log(text ? renderMarkdown(text) : '');
+
+        if(!text) {
+            print(json, flags, spec);
+        }
+    } else if(spec.render === 'reminder') {
+        const reminder = unwrap(json);
+
+        console.log(`${c.green('✓')} ${reminder.isAlarm ? 'Alarm' : 'Hatırlatma'} kuruldu: ${c.bold(reminder.text)} — ${reminder.describe}`);
+    } else if(spec.render === 'project') {
+        renderProject(unwrap(json));
+    } else {
+        print(json, flags, spec);
+    }
+};
+
+const PROJECT_STATUS = { awaiting_acceptance: 'teslim onayı bekliyor', reviewing: 'teslim hazırlanıyor', staffing: 'kadro bekliyor', planning: 'planlanıyor', cancelled: 'iptal', running: 'çalışıyor', paused: 'duraklatıldı', failed: 'başarısız', done: 'tamamlandı' };
+const STATUS_ICONS = { done: c.green('✓'), skipped: c.dim('↷'), running: c.accent('●'), ready: c.yellow('○'), pending: c.dim('○'), waiting_input: c.yellow('?'), cancelled: c.dim('✗') };
+
+/** Proje ayrıntısı: durum, ilerleme, görev listesi (durum simgesiyle), son olaylar, özet. */
+const renderProject = (project) => {
+    if(!project?.id) {
+        print(project);
+        return;
+    }
+
+    console.log(`${c.bold(project.title)} ${c.dim(`· ${PROJECT_STATUS[project.status] || project.status} · ${project.progress?.done ?? 0}/${project.progress?.total ?? 0} · ${project.id}`)}`);
+    console.log(c.dim(project.goal || ''));
+    (project.tasks || []).forEach((task) => console.log(`  ${STATUS_ICONS[task.status] || '·'} ${task.title} ${c.dim(`(${task.status}${task.attempts > 1 ? ` · ${task.attempts}. deneme` : ''})`)}`));
+
+    if(project.summary) {
+        console.log(`\n${renderMarkdown(project.summary)}`);
+    }
+
+    if(project.acceptanceReport?.length) {
+        console.log(c.bold('\nKabul ölçütleri'));
+        project.acceptanceReport.forEach((item) => console.log(`  ${item.status === 'met' ? c.green('✓') : item.status === 'missing' ? c.red('✗') : c.dim('?')} ${item.criterion}${item.note ? c.dim(` — ${item.note}`) : ''}`));
+    }
+
+    if(project.status === 'awaiting_acceptance') {
+        console.log(c.yellow('\nTeslim onayınızı bekliyor: aide questions list → aide questions answer <id> "Kabul ediyorum" | "Düzeltme istiyorum: …"'));
+    }
+
+    const events = (project.events || []).slice(0, 5);
+
+    if(events.length > 0) {
+        console.log(c.dim(`\nSon olaylar: ${events.map((item) => item.type).join(' · ')}`));
+    }
+};
+
+/** Her uç nokta: aide api GET /api/engine/panel · aide api POST /api/me/notes text="..." · --data '{…}' */
+const runApi = async ({ flags, fields, positional }) => {
+    const [method, url] = positional;
+
+    if(!method || !url) {
+        throw new AideError('Kullanım: aide api <GET|POST|PUT|PATCH|DELETE> </api/...> [k=v …] [--data \'{…}\']');
+    }
+
+    const upper = method.toUpperCase();
+    const body = upper === 'GET' ? undefined : { ...fields, ...(flags.data ? JSON.parse(String(flags.data)) : {}) };
+    // Git Bash "/api/x" argümanını Windows yoluna çevirir ("C:/Program Files/Git/api/x"); "api/x" de kabul edilir
+    const normalized = url.replace(/\\/g, '/');
+    const start = normalized.search(/(^|\/)api\//);
+    const route = start >= 0 ? `/${normalized.slice(start).replace(/^\//, '')}` : normalized;
+
+    print(await call(flags, upper, route, body), flags);
+};
+
+const routesTable = (flags) => {
+    if(flags.json) {
+        console.log(JSON.stringify(ROUTES.map(({ group, action, method, url, summary }) => ({ command: `aide ${group} ${action}`, method, url, summary })), null, 2));
+        return;
+    }
+
+    ROUTES.forEach((spec) => console.log(`${`aide ${spec.group} ${spec.action}`.padEnd(30)} ${c.dim(spec.method.padEnd(6))} ${spec.url}`));
+    console.log(c.dim(`\n${ROUTES.length} adlandırılmış komut. Diğer her uç nokta için: aide api <METOT> <yol>`));
+};
+
+const groupHelp = (group) => {
+    console.log(c.bold(GROUP_TITLES[group]));
+    ROUTES.filter((spec) => spec.group === group).forEach((spec) => {
+        const params = (spec.url.match(/:\w+/g) || []).map((param) => `<${param.slice(1)}>`).join(' ');
+        const usage = `aide ${spec.group} ${spec.action}${params ? ` ${params}` : ''}${spec.bodyArg ? ` "<${spec.bodyArg}>"` : ''}`;
+
+        console.log(`  ${usage.padEnd(62)}${c.dim(spec.summary)}`);
+    });
+};
+
+/** Grup komutunu çalıştırır (`team list`); grup yoksa false döner. */
+const runGroupCommand = async (command, args) => {
+    if(!GROUP_TITLES[command]) {
+        return false;
+    }
+
+    const [action = 'list', ...positional] = args.positional;
+    const spec = ROUTES.find((item) => item.group === command && item.action === action);
+
+    if(!spec) {
+        groupHelp(command);
+        throw new AideError(`Bilinmeyen işlem: aide ${command} ${action}`);
+    }
+
+    await runRoute(spec, { ...args, positional });
+
+    return true;
+};
+
+export {
+    runGroupCommand,
+    GROUP_TITLES,
+    routesTable,
+    parseValue,
+    groupHelp,
+    parseArgs,
+    splitLine,
+    ROUTES,
+    runApi
+};