empuno 1.1.0 → 1.2.0

package/README.md

@@ -38,6 +38,7 @@ empuno leave-requests.approve 123
 empuno leave-requests.reject 124 --rejection_reason "Yoğun dönem"
 empuno employees.documents.store 45 --document_type is_sozlesmesi --file file=./sozlesme.pdf
 empuno leave-reports.download 12 --output ./rapor.pdf
+empuno reference sgk_exit_codes              # bir alanın geçerli değerleri
 empuno call POST /manager/leave-requests/123/approve    # ham çağrı
 empuno api leaves --status approved                     # salt-okuma Company API
 ```
@@ -50,6 +51,9 @@ komutu CLI güncellemesi olmadan görünür.
 - `--alan @dosya` ya da `--file alan=dosya` → multipart yükleme.
 - `--json '{…}'` / `--json @govde.json`, `--dry-run`, `--output yol`,
   `--profile ad` (birden çok firma).
+- Listeler `--per_page` (≤100) ve `--page` alır; yeni kaydın kimliği yanıtta
+  `flash.created` ya da `redirect.params` içindedir.
+- Geçmiş veri aktarımı (`data-migration.*`) davet/e-posta/bildirim göndermez.
 
 ## Talepler (empuno ekibine)
 

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.1.0'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
+const VERSION = '1.2.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;
@@ -95,7 +95,7 @@ function resolveAuth(flags) {
 
 function requireKey(auth) {
     if (!auth.key) {
-        throw new UsageError('API anahtarı yok. `empuno login` çalıştırın ya da EMPUNO_API_KEY ortam değişkenini ayarlayın. Anahtar: empuno paneli → Firma Ayarları → API → "Ajan" türünde anahtar.');
+        throw new UsageError('API anahtarı yok. `empuno login` çalıştırın ya da EMPUNO_API_KEY ortam değişkenini ayarlayın. Anahtar: empuno paneli → Firma Ayarları → API & Ajan → "Ajan" türünde anahtar.');
     }
     if (!auth.key.startsWith('emp_live_')) {
         throw new UsageError('Geçersiz anahtar biçimi (emp_live_ ile başlamalı).');
@@ -234,7 +234,7 @@ function compareVersions(a, b) {
     return 0;
 }
 
-async function request(auth, method, urlPath, { query = {}, body = null, files = [], output = null, dryRun = false } = {}) {
+async function request(auth, method, urlPath, { query = {}, body = null, files = [], output = null, dryRun = false, headers: extraHeaders = {} } = {}) {
     const url = new URL(urlPath.startsWith('http') ? urlPath : auth.url + urlPath);
     for (const [k, v] of Object.entries(query)) {
         if (Array.isArray(v)) v.forEach((item) => url.searchParams.append(`${k}[]`, String(item)));
@@ -246,6 +246,7 @@ async function request(auth, method, urlPath, { query = {}, body = null, files =
         Accept: 'application/json',
         'User-Agent': `empuno-cli/${VERSION} node/${process.versions.node}`,
         'X-Empuno-Cli': VERSION,
+        ...extraHeaders,
     };
 
     let sendMethod = method;
@@ -382,7 +383,7 @@ async function findCommand(auth, name, flags) {
     if (cmd) return cmd;
 
     if (catalog.access === 'read') {
-        const err = new UsageError('bu anahtar salt-okuma ("read") türünde: panel komutlarını çalıştıramaz, yalnız `empuno api …`. Firma Ayarları → API sekmesinden "Ajan" anahtarı oluşturun.');
+        const err = new UsageError('bu anahtar salt-okuma ("read") türünde: panel komutlarını çalıştıramaz, yalnız `empuno api …`. Firma Ayarları → API & Ajan sekmesinden "Ajan" anahtarı oluşturun.');
         err.payload = { ok: false, error: 'read_only_key' };
         throw err;
     }
@@ -394,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).`);
+        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 & Ajan).`);
         err.payload = { ok: false, error: 'scope_required', command: name, required: need, hint: 'Kapsamı anahtar sahibi panelden genişletir; kullanıcıya bildirin.' };
         throw err;
     }
@@ -647,6 +648,23 @@ function installedViaNpm() {
     }
 }
 
+async function cmdReference(args) {
+    const auth = resolveAuth(args.flags);
+    requireKey(auth);
+    const name = args.positional[0];
+    const { ok, result } = await request(auth, 'GET', `/api/company/v1/reference${name ? `/${encodeURIComponent(name)}` : ''}`);
+    if (wantsText() && ok && name && Array.isArray(result?.data)) {
+        for (const row of result.data) {
+            const key = row.code ?? row.value ?? row.id;
+            const label = row.label ?? row.name ?? '';
+            process.stdout.write(`${String(key).padEnd(24)} ${label}\n`);
+        }
+        return 0;
+    }
+    print(result);
+    return ok ? 0 : 1;
+}
+
 async function cmdUpdate(args) {
     if (installedViaNpm()) {
         // npm'in yönettiği dosyanın üzerine yazmak sürüm kaydını bozar.
@@ -748,14 +766,20 @@ function printTicket(result) {
 
 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'] });
+    if (action === 'kinds') {
+        print({ kinds: TICKET_KINDS, priorities: ['low', 'normal', 'high'] });
+        return 0;
+    }
+
+    const auth = resolveAuth(flags);
+    requireKey(auth);
+
+    const send = async (method, urlPath, body = null, query = {}, headers = {}) => {
+        const response = await request(auth, method, urlPath, { body, query, headers, dryRun: flags['dry-run'] });
         return response;
     };
 
@@ -783,7 +807,10 @@ async function cmdTickets(args) {
             }
             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 });
+            // Aynı içerik → aynı anahtar: betik yeniden denese de ikinci talep açılmaz
+            // (sunucu mevcut talebi duplicate=true ile döner).
+            const idem = crypto.createHash('sha256').update(`${title}|${kind}|${body}`).digest('hex').slice(0, 40);
+            const r = await send('POST', base, { title: String(title), kind, body, priority: opts.priority, context: Object.keys(context).length ? context : undefined }, {}, { 'Idempotency-Key': opts['idempotency-key'] ? String(opts['idempotency-key']) : idem });
             if (r.dryRun) return print(r.result), 0;
             print(r.result);
             return r.ok ? 0 : 1;
@@ -808,9 +835,6 @@ async function cmdTickets(args) {
             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]`);
     }
@@ -925,7 +949,8 @@ KURULUM
 KEŞİF
   empuno whoami                      # firma, anahtar türü, kimin adına çalıştığı
   empuno commands [ara] [--module leaves] [--writes|--reads] [--all] [--full]
-  empuno describe <komut>            # yöntem, yol, yol parametreleri, alanlar/kurallar, gereken yetki
+  empuno describe <komut>            # yöntem, yol, yol parametreleri, alanlar/kurallar, gereken yetki, hız sınırı
+  empuno reference [ad]              # geçerli değerler: sgk_exit_codes, employee_document_types, departments, branches, leave_types…
 
 ÇALIŞTIRMA (komut = panel rotası; listeden)
   empuno leave-requests.index --status pending --per_page 50
@@ -1013,6 +1038,9 @@ async function main() {
         case 'tickets':
         case 'ticket':
             return cmdTickets(args);
+        case 'reference':
+        case 'ref':
+            return cmdReference(args);
         case 'support':
             return cmdSupport(args);
         case 'run':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empuno",
-  "version": "1.1.0",
+  "version": "1.2.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": {