empuno 1.0.1 → 1.1.0

package/README.md

@@ -51,6 +51,22 @@ komutu CLI güncellemesi olmadan görünür.
 - `--json '{…}'` / `--json @govde.json`, `--dry-run`, `--output yol`,
   `--profile ad` (birden çok firma).
 
+## Talepler (empuno ekibine)
+
+Ajanınız yapamadığı bir işlemi, bir hatayı ya da geliştirme önerisini empuno
+ekibine talep olarak iletir; yazışma çok mesajlıdır, ekip yanıtlar ve kapatır.
+
+```bash
+empuno tickets open "Toplu izin onayı" --kind feature --body "Bekleyen izinleri tek komutla onaylamak istiyoruz." --command leave-requests.approve
+empuno tickets --unread                     # ekibin yanıtladıkları
+empuno tickets show TK-7Q3M9X               # yazışmayı oku
+empuno tickets reply TK-7Q3M9X "Her ay sonu gerekiyor."
+empuno tickets close TK-7Q3M9X --note "Çözüldü"
+```
+
+Türler: `feature`, `bug`, `criticism`, `question`, `missing_command`, `docs`.
+Gövde için `--body @not.md` ya da `--body -` (stdin) kullanılabilir.
+
 ## Çıktı sözleşmesi
 
 - stdout **her zaman JSON** (TTY'de girintili).
@@ -66,6 +82,8 @@ empuno İK sistemine `empuno` CLI ile erişimin var. Önce `empuno commands <ana
 ile komutu bul, `empuno describe <komut>` ile parametrelerini öğren, sonra çalıştır.
 422 → `errors` alanlarını düzeltip tekrar dene; 403 → yetki yetmiyor, kullanıcıya
 `required_permission`ı söyle. Geri alınamaz işlemlerden önce kullanıcıdan onay al.
+Yapamadığın işlem / hata / öneri için: empuno tickets open "<başlık>" --kind missing_command|bug|feature --body "…";
+yanıtları `empuno tickets --unread` ile kontrol et.
 ```
 
 ## Güvenlik

package/empuno.mjs

@@ -21,7 +21,7 @@ import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
 
-const VERSION = '1.0.1'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
+const VERSION = '1.1.0'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
 const NPM_PACKAGE = 'empuno';
 const DEFAULT_URL = 'https://empuno.com';
 const CATALOG_TTL_MS = 10 * 60 * 1000;
@@ -89,7 +89,8 @@ function resolveAuth(flags) {
     const profile = cfg.profiles?.[profileName] || {};
     const key = flags.key || process.env.EMPUNO_API_KEY || profile.key || null;
     const url = (flags.url || process.env.EMPUNO_URL || profile.url || DEFAULT_URL).replace(/\/+$/, '');
-    return { key, url, profileName };
+    const staffToken = flags.token || process.env.EMPUNO_STAFF_TOKEN || profile.staff_token || null;
+    return { key, url, profileName, staffToken };
 }
 
 function requireKey(auth) {
@@ -103,14 +104,15 @@ function requireKey(auth) {
 
 // ─── argüman ayrıştırma ────────────────────────────────────────────────────
 
-const GLOBAL_FLAGS = new Set(['key', 'url', 'profile', 'pretty', 'compact', 'text', 'json-out', 'dry-run', 'output', 'refresh', 'all', 'full', 'module', 'writes', 'reads', 'help', 'key-stdin', 'query', 'json', 'file', 'quiet']);
+const GLOBAL_FLAGS = new Set(['key', 'token', 'url', 'profile', 'pretty', 'compact', 'text', 'json-out', 'dry-run', 'output', 'refresh', 'all', 'full', 'module', 'writes', 'reads', 'help', 'key-stdin', 'query', 'json', 'file', 'quiet']);
 const BOOLEAN_FLAGS = new Set(['pretty', 'compact', 'text', 'json-out', 'dry-run', 'refresh', 'all', 'full', 'writes', 'reads', 'help', 'key-stdin', 'quiet']);
 
 /**
  * argv → { positional: [], flags: {global}, fields: [[name, rawValue]] }.
  * `--ad değer`, `--ad=değer`, tekrar eden bayrak → dizi, `--` sonrası hep positional.
  */
-function parseArgs(argv) {
+function parseArgs(argv, extraBooleans = []) {
+    const extraBool = new Set(extraBooleans);
     const positional = [];
     const flags = { query: [], file: [] };
     const fields = [];
@@ -134,7 +136,7 @@ function parseArgs(argv) {
             name = name.slice(0, eq);
         }
 
-        if (GLOBAL_FLAGS.has(name) && BOOLEAN_FLAGS.has(name)) {
+        if ((GLOBAL_FLAGS.has(name) && BOOLEAN_FLAGS.has(name)) || extraBool.has(name)) {
             flags[name] = value === undefined ? true : !['0', 'false', 'no'].includes(value);
             i++;
             continue;
@@ -393,7 +395,7 @@ async function findCommand(auth, name, flags) {
     if (cmd) {
         const need = cmd.requires_company_admin ? ['company_admin'] : cmd.permissions;
         const err = new UsageError(`"${name}" bu anahtarın kapsamında değil. Gereken yetki: ${need.join(', ') || '—'}. Anahtar kapsamını panelden genişletin (Firma Ayarları → API).`);
-        err.payload = { ok: false, error: 'scope_required', command: name, required: need };
+        err.payload = { ok: false, error: 'scope_required', command: name, required: need, hint: 'Kapsamı anahtar sahibi panelden genişletir; kullanıcıya bildirin.' };
         throw err;
     }
 
@@ -402,7 +404,13 @@ async function findCommand(auth, name, flags) {
         .filter((c) => c.includes(name.split('.')[0]) || name.includes(c.split('.')[0]))
         .slice(0, 8);
     const err = new UsageError(`bilinmeyen komut "${name}".${suggestions.length ? ` Şunlardan biri mi: ${suggestions.join(', ')}` : ' `empuno commands` ile listeleyin.'}`);
-    err.payload = { ok: false, error: 'unknown_command', command: name, suggestions };
+    err.payload = {
+        ok: false,
+        error: 'unknown_command',
+        command: name,
+        suggestions,
+        hint: `Gereken işlem yoksa talep açın: empuno tickets open "<başlık>" --kind missing_command --command ${name} --body "<ne yapmak istediğiniz>"`,
+    };
     throw err;
 }
 
@@ -671,6 +679,241 @@ async function cmdUpdate(args) {
     return 0;
 }
 
+// ─── talepler (ticket) ─────────────────────────────────────────────────────
+
+const TICKET_KINDS = {
+    feature: 'Geliştirme isteği',
+    bug: 'Hata bildirimi',
+    criticism: 'Eleştiri / geri bildirim',
+    question: 'Soru',
+    missing_command: 'Eksik komut / işlem',
+    docs: 'Dokümantasyon',
+};
+
+/** Alan bayraklarını nesneye çevirir (son değer kazanır). */
+function fieldMap(fields) {
+    const out = {};
+    for (const [k, v] of fields) out[k] = v;
+    return out;
+}
+
+/** "@dosya.md" → dosya içeriği; "-" → stdin; diğerleri olduğu gibi. */
+function readText(value) {
+    if (value === undefined || value === null || value === true) return undefined;
+    const text = String(value);
+    if (text === '-') return fs.readFileSync(0, 'utf8');
+    if (text.startsWith('@') && text.length > 1) {
+        const file = text.slice(1);
+        if (!fs.existsSync(file)) throw new UsageError(`dosya bulunamadı: ${file}`);
+        return fs.readFileSync(file, 'utf8');
+    }
+    return text;
+}
+
+function ticketNumber(value) {
+    if (!value) throw new UsageError('talep numarası gerekli (ör. TK-7Q3M9X)');
+    const n = String(value).toUpperCase();
+    return n.startsWith('TK-') ? n : `TK-${n}`;
+}
+
+function printTicketList(result, perspective) {
+    if (!wantsText() || !Array.isArray(result?.data)) {
+        print(result);
+        return;
+    }
+    for (const t of result.data) {
+        const dot = t.unread ? '●' : ' ';
+        const who = perspective === 'staff' && t.company ? ` · ${t.company.name}` : '';
+        process.stdout.write(`${dot} ${t.number}  ${t.status.padEnd(8)} ${t.kind.padEnd(15)} ${t.title}${who}\n`);
+    }
+    const total = result.meta?.total ?? result.data.length;
+    process.stdout.write(`\n${total} talep. Ayrıntı: empuno ${perspective === 'staff' ? 'support' : 'tickets'} show <numara>\n`);
+}
+
+function printTicket(result) {
+    const t = result?.data;
+    if (!wantsText() || !t?.messages) {
+        print(result);
+        return;
+    }
+    process.stdout.write(`${t.number} · ${t.title}\n${t.kind_label} · öncelik ${t.priority} · ${t.status}${t.company ? ` · ${t.company.name}` : ''}\n`);
+    for (const m of t.messages) {
+        if (m.author_type === 'system') {
+            process.stdout.write(`\n  — ${m.body} (${m.created_at})\n`);
+            continue;
+        }
+        process.stdout.write(`\n[${m.author_type === 'staff' ? 'empuno' : 'ajan'}] ${m.author} — ${m.created_at}\n${m.body}\n`);
+    }
+}
+
+async function cmdTickets(args) {
+    const { flags, fields, positional } = args;
+    const auth = resolveAuth(flags);
+    requireKey(auth);
+    const opts = fieldMap(fields);
+    const [action = 'list', ...rest] = positional;
+    const base = '/api/company/v1/tickets';
+
+    const send = async (method, urlPath, body = null, query = {}) => {
+        const response = await request(auth, method, urlPath, { body, query, dryRun: flags['dry-run'] });
+        return response;
+    };
+
+    switch (action) {
+        case 'list':
+        case 'ls': {
+            const query = {};
+            if (opts.status) query.status = opts.status;
+            if (flags.mine) query.mine = 1;
+            if (flags.unread) query.unread = 1;
+            if (opts.page) query.page = opts.page;
+            if (opts.per_page) query.per_page = opts.per_page;
+            const r = await send('GET', base, null, query);
+            if (r.dryRun) return print(r.result), 0;
+            printTicketList(r.result, 'agent');
+            return r.ok ? 0 : 1;
+        }
+        case 'open':
+        case 'new': {
+            const title = rest[0] ?? opts.title;
+            const body = readText(opts.body ?? rest[1]);
+            const kind = opts.kind ?? 'feature';
+            if (!title || !body) {
+                throw new UsageError('kullanım: empuno tickets open "<başlık>" --kind feature|bug|criticism|question|missing_command|docs --body "<açıklama>"|@dosya.md');
+            }
+            let context = opts.context ? readJsonArg(String(opts.context)) : {};
+            if (opts.command) context = { ...context, command: String(opts.command) };
+            const r = await send('POST', base, { title: String(title), kind, body, priority: opts.priority, context: Object.keys(context).length ? context : undefined });
+            if (r.dryRun) return print(r.result), 0;
+            print(r.result);
+            return r.ok ? 0 : 1;
+        }
+        case 'show':
+        case 'get': {
+            const r = await send('GET', `${base}/${ticketNumber(rest[0])}`);
+            if (r.dryRun) return print(r.result), 0;
+            printTicket(r.result);
+            return r.ok ? 0 : 1;
+        }
+        case 'reply': {
+            const body = readText(opts.body ?? rest[1]);
+            if (!body) throw new UsageError('kullanım: empuno tickets reply <numara> "<mesaj>" (ya da --body @dosya.md)');
+            const r = await send('POST', `${base}/${ticketNumber(rest[0])}/messages`, { body });
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'close': {
+            const note = readText(opts.note ?? rest[1]);
+            const r = await send('POST', `${base}/${ticketNumber(rest[0])}/close`, note ? { note } : {});
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'kinds':
+            print({ kinds: TICKET_KINDS, priorities: ['low', 'normal', 'high'] });
+            return 0;
+        default:
+            throw new UsageError(`bilinmeyen tickets işlemi "${action}". Kullanım: empuno tickets [list|open|show|reply|close|kinds]`);
+    }
+}
+
+// ─── destek (yalnız empuno ekibinin ajanları — emp_staff_ jetonu) ────────────
+
+function requireStaff(auth) {
+    if (!auth.staffToken) {
+        throw new UsageError('destek jetonu yok. `empuno support login` ya da EMPUNO_STAFF_TOKEN. Jeton: empuno root paneli → Ajan Talepleri → Destek ajanları.');
+    }
+    if (!auth.staffToken.startsWith('emp_staff_')) {
+        throw new UsageError('geçersiz destek jetonu biçimi (emp_staff_ ile başlamalı).');
+    }
+    return { ...auth, key: auth.staffToken };
+}
+
+async function cmdSupport(args) {
+    const { flags, fields, positional } = args;
+    const opts = fieldMap(fields);
+    const [action = 'tickets', ...rest] = positional;
+    const base = '/api/support/v1';
+
+    if (action === 'login') {
+        let token = flags.token || process.env.EMPUNO_STAFF_TOKEN || rest[0];
+        if (flags['token-stdin'] || (!token && !process.stdin.isTTY)) token = fs.readFileSync(0, 'utf8').trim();
+        else if (!token) token = await prompt('Destek jetonu (emp_staff_…): ');
+        const auth = requireStaff({ ...resolveAuth(flags), staffToken: token?.trim() });
+        const { ok, result } = await request(auth, 'GET', `${base}/me`);
+        if (!ok) {
+            print(result);
+            return 1;
+        }
+        const cfg = readConfig();
+        cfg.profiles = cfg.profiles || {};
+        const name = auth.profileName;
+        cfg.profiles[name] = { ...(cfg.profiles[name] || { url: auth.url }), staff_token: auth.key };
+        if (!cfg.default || !cfg.profiles[cfg.default]) cfg.default = name;
+        writeConfig(cfg);
+        print({ ok: true, profile: name, token: result.token, counts: result.counts });
+        return 0;
+    }
+
+    const auth = requireStaff(resolveAuth(flags));
+    const call = (method, urlPath, body = null, query = {}) => request(auth, method, urlPath, { body, query, dryRun: flags['dry-run'] });
+
+    switch (action) {
+        case 'whoami':
+        case 'me': {
+            const r = await call('GET', `${base}/me`);
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'tickets':
+        case 'list':
+        case 'ls': {
+            const query = {};
+            for (const k of ['status', 'kind', 'company', 'q', 'page', 'per_page']) if (opts[k] !== undefined) query[k] = opts[k];
+            if (flags.unread) query.unread = 1;
+            const r = await call('GET', `${base}/tickets`, null, query);
+            if (r.dryRun) return print(r.result), 0;
+            printTicketList(r.result, 'staff');
+            return r.ok ? 0 : 1;
+        }
+        case 'show':
+        case 'get': {
+            const r = await call('GET', `${base}/tickets/${ticketNumber(rest[0])}`);
+            if (r.dryRun) return print(r.result), 0;
+            printTicket(r.result);
+            return r.ok ? 0 : 1;
+        }
+        case 'reply': {
+            const body = readText(opts.body ?? rest[1]);
+            if (!body) throw new UsageError('kullanım: empuno support reply <numara> "<yanıt>" [--close]');
+            const r = await call('POST', `${base}/tickets/${ticketNumber(rest[0])}/messages`, { body, close: flags.close ? true : undefined });
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'close': {
+            const note = readText(opts.note ?? rest[1]);
+            const r = await call('POST', `${base}/tickets/${ticketNumber(rest[0])}/close`, note ? { note } : {});
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'reopen': {
+            const r = await call('POST', `${base}/tickets/${ticketNumber(rest[0])}/reopen`);
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        case 'set': {
+            const body = {};
+            if (opts.kind) body.kind = opts.kind;
+            if (opts.priority) body.priority = opts.priority;
+            if (!Object.keys(body).length) throw new UsageError('kullanım: empuno support set <numara> [--kind bug] [--priority high]');
+            const r = await call('PATCH', `${base}/tickets/${ticketNumber(rest[0])}`, body);
+            print(r.result);
+            return r.ok || r.dryRun ? 0 : 1;
+        }
+        default:
+            throw new UsageError(`bilinmeyen support işlemi "${action}". Kullanım: empuno support [login|whoami|tickets|show|reply|close|reopen|set]`);
+    }
+}
+
 const HELP = `empuno ${VERSION} — empuno İK sistemini komut satırından (ve ajanlardan) yönetin
 
 KURULUM
@@ -700,6 +943,18 @@ ALANLAR
   --alan @./dosya.pdf | --file alan=./dosya.pdf   # multipart yükleme
   --query anahtar=değer              # yazma isteğinde ek sorgu parametresi
 
+TALEPLER (geliştirme isteği, hata, eleştiri, soru → empuno ekibi)
+  empuno tickets [--status active|open|answered|closed|all] [--unread] [--mine]
+  empuno tickets open "Toplu izin onayı" --kind feature --body "…"|@not.md [--priority high] [--command leave-requests.approve]
+  empuno tickets show TK-7Q3M9X           # yazışmayı okur (okunmadı bayrağı düşer)
+  empuno tickets reply TK-7Q3M9X "Ek bilgi…"
+  empuno tickets close TK-7Q3M9X [--note "Çözüldü"]
+  empuno tickets kinds                    # feature, bug, criticism, question, missing_command, docs
+
+EMPUNO EKİBİ (destek jetonu emp_staff_…, EMPUNO_STAFF_TOKEN)
+  empuno support login | whoami | tickets [--unread] [--status] [--kind] [--company]
+  empuno support show|reply|close|reopen <numara> ["mesaj"] [--close]   ·   empuno support set <numara> --priority high
+
 GENEL BAYRAKLAR
   --profile ad   --key emp_live_…   --url https://empuno.com   --dry-run   --output yol
   --text | --json-out   --pretty | --compact   --refresh (katalog önbelleğini tazele)
@@ -714,7 +969,8 @@ BELGE: https://empuno.com/api-docs/agent
 
 async function main() {
     const argv = process.argv.slice(2);
-    const args = parseArgs(argv);
+    const ticketish = ['tickets', 'ticket', 'support'].includes(argv.find((a) => !a.startsWith('--')) ?? '');
+    const args = parseArgs(argv, ticketish ? ['mine', 'unread', 'close', 'token-stdin'] : []);
     const [sub, ...rest] = args.positional;
     args.positional = rest;
 
@@ -723,6 +979,10 @@ async function main() {
         return 0;
     }
     if (args.flags.help) {
+        if (['tickets', 'ticket', 'support', 'login', 'commands', 'describe', 'call', 'api'].includes(sub)) {
+            process.stdout.write(HELP);
+            return 0;
+        }
         args.positional = [sub];
         return cmdDescribe(args);
     }
@@ -750,6 +1010,11 @@ async function main() {
             return cmdApi(args);
         case 'update':
             return cmdUpdate(args);
+        case 'tickets':
+        case 'ticket':
+            return cmdTickets(args);
+        case 'support':
+            return cmdSupport(args);
         case 'run':
             if (!args.positional[0]) throw new UsageError('kullanım: empuno run <komut> …');
             return cmdRun({ ...args, positional: args.positional.slice(1) }, args.positional[0]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empuno",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "empuno İK platformunun komut satırı: yönetim panelindeki tüm işlemleri (izin, bordro, vardiya, PDKS, zimmet, masraf, işe alım) yapay zekâ ajanlarına ve otomasyonlara açar.",
   "type": "module",
   "bin": {