@devoplus/one-sdk 0.0.0-stage → 0.2.0-next.117

package/bin/appOps.mjs

@@ -0,0 +1,336 @@
+// Devoplus One YAYIN ve KULLANIM PANOSU istemcisi (D-86 · D-87). `one publish|promote|rollback|deployments|status`
+// komutları ve Devoplus One MCP sunucusu (`one_publish` · `one_deployments` · `one_app_health`) AYNI modülü kullanır;
+// ikisi aynı backend uçlarını çağırır:
+//
+//   POST api/v1/One/apps/{slug}/deployments            { portalKey?, action, toVersion? } → 202 { id, status, pipelineUrl? }
+//   GET  api/v1/One/apps/{slug}/deployments?portalKey= → yayın istekleri
+//   GET  api/v1/One/apps/{slug}/insights?portalKey=&days= → kullanım ve hata özeti
+//
+// ⛔ Yayın isteği YENİ BİR YETKİ YOLU AÇMAZ: backend yalnız uygulamanın sahibine ya da o portalın şirket yöneticisine
+// izin verir, isteği kayda geçirir ve hattı (D-69) kendisi başlatır; hattın kapıları atlanmaz. Gönderenin kimliği
+// OTURUMDAN (kullanıcının kendi belirteci) gelir; bu modül gövdeye kişi YAZMAZ.
+//
+// ⛔ Kısa ad, portal anahtarı ve sürüm ADRESE girer: biçimleri ağa çıkmadan denetlenir (yol enjeksiyonu yok). Kısa ad ve
+// portal anahtarı kuralları `packages/manifest/src/naming.ts` ile AYNIDIR (eşitlik appOps.test.ts'te kilitli).
+
+import { isSecureBase } from './session.mjs'
+
+export class AppOpsError extends Error {
+  /**
+   * @param {string} message kullanıcıya gösterilecek Türkçe metin
+   * @param {{ status?: number, code?: string }} [details]
+   */
+  constructor(message, details = {}) {
+    super(message)
+    this.name = 'AppOpsError'
+    this.status = details.status
+    this.code = details.code
+  }
+}
+
+/** `packages/manifest/src/naming.ts` → `SLUG_RE` · `SLUG_MAX` · `PORTAL_KEY_RE` (bin derlemesiz olduğu için kopya; test eşitler). */
+export const SLUG_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/
+export const SLUG_MAX = 24
+export const PORTAL_KEY_RE = /^[a-z0-9]{2,16}$/
+/** Manifest `app.version` biçimi (`packages/manifest/src/schema.ts` → semver). */
+export const VERSION_RE = /^\d+\.\d+\.\d+$/
+
+/** Pano gün aralığı: varsayılan 7 (C5). Üst sınır istemcinin makul bir sınırıdır; sunucu daha dar bir sınır uygulayabilir. */
+export const DAYS_DEFAULT = 7
+export const DAYS_MAX = 90
+
+/** Yayın eylemleri: tel adı → kullanıcıya görünen ad. */
+export const ACTIONS = {
+  deploy: 'Test ortamına yayın (önizleme)',
+  promote: 'Bir sonraki ortama terfi',
+  rollback: 'Önceki sürüme geri alma',
+}
+
+/**
+ * Önizleme ortamının (test) uygulama adresi tabanı — mimari §4 "Ortamlar" (D-15). `one publish` her zaman test
+ * ortamına yayınlar (D-86); önizleme adresi bu tabandan kurulur.
+ */
+export const PREVIEW_HOST_BASE = 'test-one.devoplus.dev'
+
+/** Tanınmayan durum adları olduğu gibi gösterilir (sunucunun yeni durumu uydurma bir etikete çevrilmez). */
+const STATUS_LABELS = {
+  queued: 'Sırada',
+  not_configured: 'Yayın hattı yapılandırılmamış',
+}
+
+/** `not_configured` yanıtında kullanıcıya söylenecek TEK cümle — fazlası (kime iletildiği, ne zaman açılacağı) bilinmez. */
+export const NOT_CONFIGURED_MESSAGE = 'Yayın hattı bu ortamda yapılandırılmamış; yayın başlatılmadı.'
+export const INSIGHTS_NOT_CONFIGURED_MESSAGE = 'Kullanım ve hata panosu bu ortamda yapılandırılmamış; veri okunamadı.'
+
+function clean(value) {
+  if (value === undefined || value === null) return undefined
+  const text = String(value).trim()
+  return text === '' ? undefined : text
+}
+
+/** Kısa ad: zorunlu, küçük harfe iner, naming.ts kuralı. */
+export function checkSlug(value) {
+  const slug = clean(value)?.toLowerCase()
+  if (!slug) throw new AppOpsError('Uygulamanın kısa adı zorunludur (one.manifest.json dosyasındaki app.slug).')
+  if (slug.length > SLUG_MAX || !SLUG_RE.test(slug))
+    throw new AppOpsError(`Uygulamanın kısa adı geçersiz: "${slug}" (küçük harf, rakam ve tire; en çok ${SLUG_MAX} karakter).`)
+  return slug
+}
+
+/**
+ * Portal anahtarı: isteğe bağlı; verilirse naming.ts kuralı. Verilmezse `undefined` ve istekte YER ALMAZ — hangi
+ * kurulumun seçileceğine sunucu karar verir (C5 bunu belirtmiyor; backend tarafına öneri: oturumun portalı).
+ */
+export function checkPortalKey(value) {
+  const key = clean(value)?.toLowerCase()
+  if (key === undefined) return undefined
+  if (!PORTAL_KEY_RE.test(key)) throw new AppOpsError(`Portal anahtarı geçersiz: "${key}" (2-16 küçük harf ya da rakam).`)
+  return key
+}
+
+function checkVersion(value) {
+  const version = clean(value)
+  if (version === undefined) return undefined
+  if (!VERSION_RE.test(version)) throw new AppOpsError(`Sürüm "x.y.z" biçiminde olmalı: "${version}".`)
+  return version
+}
+
+/** Gün sayısı: verilmezse 7; 1..DAYS_MAX tam sayı. */
+export function checkDays(value) {
+  const text = clean(value)
+  if (text === undefined) return DAYS_DEFAULT
+  const days = Number(text)
+  if (!/^\d+$/.test(text) || !Number.isInteger(days) || days < 1 || days > DAYS_MAX)
+    throw new AppOpsError(`Gün sayısı 1 ile ${DAYS_MAX} arasında bir tam sayı olmalı: "${text}".`)
+  return days
+}
+
+/**
+ * Yayın isteği gövdesi. `toVersion` yalnız geri almada anlamlıdır; başka eylemde verilirse açık hata (sessizce
+ * düşürülseydi kullanıcı belirli bir sürümü yayımladığını sanırdı).
+ */
+export function buildDeploymentRequest(fields = {}) {
+  const action = clean(fields.action)
+  if (!action || !Object.hasOwn(ACTIONS, action))
+    throw new AppOpsError(`Yayın eylemi tanınmadı: "${fields.action ?? ''}". Geçerli eylemler: ${Object.keys(ACTIONS).join(', ')}.`)
+  const portalKey = checkPortalKey(fields.portalKey)
+  const toVersion = checkVersion(fields.toVersion)
+  if (toVersion !== undefined && action !== 'rollback')
+    throw new AppOpsError('Sürüm (toVersion) yalnız geri almada verilir.')
+  const body = { action }
+  if (portalKey !== undefined) body.portalKey = portalKey
+  if (toVersion !== undefined) body.toVersion = toVersion
+  return body
+}
+
+/** API tabanı `https://…/` biçiminde olmalı (http yalnız yerel adreste); uç yolu ona eklenir. */
+function endpoint(apiBase, path, query = {}) {
+  // Belirteç bu adrese gider: düz http yalnız yerel geliştirme adresinde (RFC 6750 §5.3).
+  if (!isSecureBase(apiBase))
+    throw new AppOpsError(`API tabanı "https://.../" biçiminde ve "/" ile bitmeli (http yalnız localhost): ${apiBase}`)
+  const url = new URL(`api/v1/One/apps/${path}`, apiBase)
+  for (const [name, value] of Object.entries(query)) if (value !== undefined) url.searchParams.set(name, String(value))
+  return url.toString()
+}
+
+/** Sunucunun ProblemDetails yanıtını kullanıcı metnine çevirir; gövde yoksa durum koduna göre sabit cümle. */
+async function failure(response) {
+  let detail
+  let code
+  try {
+    const problem = await response.json()
+    detail = typeof problem?.detail === 'string' ? problem.detail : undefined
+    code = typeof problem?.code === 'string' ? problem.code : undefined
+  } catch {
+    // gövdesiz 401/403 — aşağıdaki sabit metin
+  }
+  const fallback =
+    response.status === 401
+      ? 'Oturumunuz geçersiz ya da süresi dolmuş; yeniden giriş yapın.'
+      : response.status === 403
+        ? 'Bu uygulama için bu işlemi yapma yetkiniz yok.'
+        : response.status === 404
+          ? 'Uygulama ya da kurulum bulunamadı.'
+          : response.status === 429
+            ? 'Çok fazla istek gönderdiniz; bir süre sonra yeniden deneyin.'
+            : `Devoplus isteği başarısız oldu (HTTP ${response.status}).`
+  return new AppOpsError(detail ?? fallback, { status: response.status, code })
+}
+
+/**
+ * @typedef {{ apiBase: string, accessToken: string, fetch?: typeof fetch }} ClientOptions
+ */
+
+async function call(options, path, query, init = {}) {
+  const doFetch = options.fetch ?? fetch
+  if (!options.accessToken) throw new AppOpsError('Oturum yok; önce giriş yapın.', { status: 401 })
+  const url = endpoint(options.apiBase, path, query)
+  let response
+  try {
+    response = await doFetch(url, {
+      ...init,
+      headers: {
+        Accept: 'application/json',
+        Authorization: `Bearer ${options.accessToken}`,
+        ...(init.body ? { 'Content-Type': 'application/json' } : {}),
+      },
+    })
+  } catch {
+    throw new AppOpsError('Devoplus API\'ye ulaşılamadı.')
+  }
+  if (!response.ok) throw await failure(response)
+  try {
+    return await response.json()
+  } catch {
+    throw new AppOpsError('Devoplus API yanıtı okunamadı.', { status: response.status })
+  }
+}
+
+/** Yayın isteği bırakır (deploy · promote · rollback). Dönüş `{ id, status, pipelineUrl? }`. */
+export function requestDeployment(options, slug, body) {
+  const app = checkSlug(slug)
+  const request = buildDeploymentRequest(body)
+  return call(options, `${encodeURIComponent(app)}/deployments`, {}, { method: 'POST', body: JSON.stringify(request) })
+}
+
+/** Uygulamanın (ve verilirse o kurulumun) yayın istekleri. */
+export function listDeployments(options, slug, portalKey) {
+  const app = checkSlug(slug)
+  return call(options, `${encodeURIComponent(app)}/deployments`, { portalKey: checkPortalKey(portalKey) })
+}
+
+/** Kullanım ve hata özeti. */
+export function getInsights(options, slug, { portalKey, days } = {}) {
+  const app = checkSlug(slug)
+  return call(options, `${encodeURIComponent(app)}/insights`, { portalKey: checkPortalKey(portalKey), days: checkDays(days) })
+}
+
+/** Önizleme (test ortamı) adresi; portal anahtarı yoksa kurulamaz → `undefined`. */
+export function previewAddress(slug, portalKey) {
+  const key = checkPortalKey(portalKey)
+  if (key === undefined) return undefined
+  return `https://${checkSlug(slug)}-${key}.${PREVIEW_HOST_BASE}`
+}
+
+function statusLabel(status) {
+  return STATUS_LABELS[status] ?? String(status ?? '?')
+}
+
+/** Tek bir yayın isteğini tek satıra yazar (CLI listesi ve MCP yanıtı). Bilinmeyen alanlar uydurulmaz. */
+export function describeDeployment(row) {
+  const action = ACTIONS[row?.action] ?? (row?.action ? String(row.action) : undefined)
+  const parts = [`${row?.id ?? '?'}  ${statusLabel(row?.status)}`]
+  if (action) parts.push(`, ${action}`)
+  if (row?.portalKey) parts.push(`, portal ${row.portalKey}`)
+  if (row?.toVersion) parts.push(`, hedef sürüm ${row.toVersion}`)
+  if (typeof row?.createdAt === 'string') parts.push(`, ${row.createdAt}`)
+  if (typeof row?.pipelineUrl === 'string') parts.push(`\n    hat: ${row.pipelineUrl}`)
+  return parts.join('')
+}
+
+/**
+ * Yayın isteği yanıtını kullanıcıya söylenecek metne çevirir. `not_configured` başka bir iddia taşımaz.
+ * @param {{ id?: string, status?: string, pipelineUrl?: string }} result
+ * @param {{ action: string, slug: string, portalKey?: string }} request
+ */
+export function describeDeploymentResult(result, request) {
+  if (result?.status === 'not_configured') return NOT_CONFIGURED_MESSAGE
+  const lines = [`Yayın isteği alındı (${ACTIONS[request.action] ?? request.action}): ${describeDeployment({ ...result, action: request.action, portalKey: request.portalKey })}`]
+  if (request.action === 'deploy') {
+    const preview = previewAddress(request.slug, request.portalKey)
+    lines.push(
+      preview
+        ? `Hat bitince önizleme test ortamındadır: test Portal'ından uygulamayı açıp bakabilirsiniz (adres: ${preview}).`
+        : 'Hat bitince önizleme test ortamındadır: test Portal\'ından uygulamayı açıp bakabilirsiniz (adres için portal anahtarını verin).',
+    )
+  }
+  return lines.join('\n')
+}
+
+function percent(part, whole) {
+  if (!Number.isFinite(part) || !Number.isFinite(whole) || whole <= 0) return '?'
+  return `%${((part / whole) * 100).toLocaleString('tr-TR', { maximumFractionDigits: 1 })}`
+}
+
+function number(value) {
+  return Number.isFinite(value) ? Number(value).toLocaleString('tr-TR') : '?'
+}
+
+/** Kullanım özetini çok satırlı Türkçe metne çevirir. `configured: false` başka veri GÖSTERMEZ. */
+export function describeInsights(insights) {
+  if (!insights || insights.configured === false) return INSIGHTS_NOT_CONFIGURED_MESSAGE
+  const totals = insights.totals ?? {}
+  const lines = [
+    `Dönem: ${insights.from ?? '?'} ile ${insights.to ?? '?'} arası`,
+    `İstek: ${number(totals.requests)}, hata: ${number(totals.errors)} (${percent(totals.errors, totals.requests)})`,
+    `İşlemci süresi (istek başına): ortanca ${number(totals.cpuP50Ms)} ms, en yavaş %1 ${number(totals.cpuP99Ms)} ms`,
+  ]
+  const failed = insights.jobs?.failed
+  if (Number.isFinite(failed)) lines.push(`Başarısız arka plan işi: ${number(failed)}`)
+  const daily = Array.isArray(insights.daily) ? insights.daily : []
+  if (daily.length > 0) {
+    lines.push('Günlük:')
+    for (const day of daily) lines.push(`  ${day?.date ?? '?'}  istek ${number(day?.requests)}, hata ${number(day?.errors)}`)
+  }
+  const errors = Array.isArray(insights.recentErrors) ? insights.recentErrors : []
+  if (errors.length > 0) {
+    lines.push('Son hatalar:')
+    for (const e of errors.slice(0, 20)) {
+      const message = String(e?.message ?? '').replace(/\s+/g, ' ').slice(0, 300)
+      lines.push(`  ${e?.time ?? '?'}${e?.path ? ` ${e.path}` : ''}  ${message}`)
+    }
+  } else lines.push('Son hata kaydı yok.')
+  return lines.join('\n')
+}
+
+/**
+ * `one <komut>` argümanlarını ayrıştırır (SAF — testlenir). `argv` komut adından SONRAKİ argümanlardır.
+ * Bilinmeyen seçenek açık hatadır: yazım yanlışı (`--portl`) sessizce yok sayılsaydı istek yanlış kuruluma giderdi.
+ * @param {'publish'|'promote'|'rollback'|'deployments'|'status'} command
+ * @param {string[]} argv
+ */
+export function parseOpsArgs(command, argv) {
+  const allowed = {
+    publish: ['portal', 'app'],
+    promote: ['portal', 'app'],
+    rollback: ['portal', 'app', 'to'],
+    deployments: ['portal', 'app'],
+    status: ['portal', 'app', 'days'],
+  }[command]
+  if (!allowed) throw new AppOpsError(`bilinmeyen komut: ${command}`)
+  const flags = { publish: [], promote: [], rollback: ['yes'], deployments: [], status: [] }[command]
+  const out = { json: false, yes: false }
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+    if (arg === '--json') {
+      out.json = true
+      continue
+    }
+    const name = /^--([a-z-]+)$/.exec(arg)?.[1]
+    if (name && flags.includes(name)) {
+      out[name] = true
+      continue
+    }
+    if (!name || !allowed.includes(name)) throw new AppOpsError(`one ${command}: tanınmayan argüman "${arg}".`)
+    const value = argv[i + 1]
+    if (value === undefined || value.startsWith('--')) throw new AppOpsError(`one ${command}: --${name} bir değer ister.`)
+    out[name] = value
+    i++
+  }
+  const portalKey = checkPortalKey(out.portal)
+  const result = { json: out.json, portalKey, app: out.app }
+  if (command === 'rollback') {
+    result.toVersion = checkVersion(out.to)
+    result.yes = out.yes
+  }
+  if (command === 'status') result.days = checkDays(out.days)
+  return result
+}
+
+/** Komut → yayın eylemi. */
+export const COMMAND_ACTIONS = { publish: 'deploy', promote: 'promote', rollback: 'rollback' }
+
+/** Geri almanın uyarı metni: veri geri alınırsa dönülen noktadan sonra yazılan SİLİNİR (D-43, mimari §4d). */
+export const ROLLBACK_WARNING =
+  'Geri alma uygulamayı önceki sürüme döndürür; veritabanı da o sürümün şemasına dönmek zorundaysa dönülen noktadan ' +
+  'sonra kaydedilen veriler KAYBOLUR. Bu geri alınamaz bir işlemdir.'

package/bin/dataCommand.mjs

@@ -0,0 +1,131 @@
+// `one data generate [--check]` — tanımlayıcı veri modeli (D-84). one.data.json → yeni migration (yalnız ekleyen) +
+// src/data/types.ts + migrations/.one-data-snapshot.json. Üretim kuralları SDK'nın `data/ddl.ts` modülündedir (saf,
+// testlenir); bu dosya yalnız dosyaları okur ve yazar.
+//
+// Kural kaynağı: yayımlanmış pakette derlenmiş `dist/data/ddl.js`; çalışma alanında (kaynak varken) `src/data/ddl.ts`
+// — eski bir derleme çıktısı yanlış farka yol açmasın diye kaynak önceliklidir.
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+export class DataCommandError extends Error {}
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+
+export async function loadDataTools() {
+  const src = join(HERE, '../src/data/ddl.ts')
+  const dist = join(HERE, '../dist/data/ddl.js')
+  const target = existsSync(src) ? src : dist
+  if (!existsSync(target)) throw new DataCommandError('Devoplus One SDK eksik kurulmuş (veri modeli üreticisi bulunamadı); "pnpm install" çalıştırın.')
+  return import(pathToFileURL(target).href)
+}
+
+function readOptional(path) {
+  try {
+    return readFileSync(path, 'utf8')
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return null
+    throw err
+  }
+}
+
+const USAGE = `kullanım: one data generate [--check]
+
+  one.data.json'daki veri modelinden şunları üretir:
+    migrations/NNNN_one_data.sql        yalnız ekleyen değişiklik (yeni tablo, kolon, dizin); değişiklik yoksa yazılmaz
+    src/data/types.ts                   kayıt ve girdi tipleri + createCrudHandler'a verilen dataModel
+    migrations/.one-data-snapshot.json  bir sonraki farkın alındığı model (elle düzenlenmez)
+  --check   hiçbir şey yazmaz; dosyalar güncel değilse ya da model hatalıysa 1 ile çıkar.
+
+Silme, yeniden adlandırma, tür değişikliği, zorunlu/isteğe bağlı değişikliği ve seçim değeri kaldırma üretilmez; komut
+nedenini söyleyip durur. Seçim alanına yeni değer eklemek migration gerektirmez (yalnız tipler yenilenir).`
+
+/**
+ * Komutu çalıştırır; çıkış kodu döner. `io.log` / `io.error` çıktıyı yazar (testte toplanır).
+ * @param {{ cwd: string, args: string[], log?: (s: string) => void, error?: (s: string) => void }} io
+ */
+export async function runDataCommand({ cwd, args, log = console.log, error = console.error }) {
+  const [sub, ...rest] = args
+  if (!sub || sub === '--help' || sub === '-h') {
+    log(USAGE)
+    return sub ? 0 : 1
+  }
+  if (sub !== 'generate') {
+    error(`one data: bilinmeyen alt komut "${sub}".\n${USAGE}`)
+    return 1
+  }
+  const unknown = rest.filter((a) => a !== '--check')
+  if (unknown.length > 0) {
+    error(`one data generate: bilinmeyen seçenek ${unknown.join(' ')}`)
+    return 1
+  }
+  const check = rest.includes('--check')
+  const tools = await loadDataTools()
+
+  const modelRaw = readOptional(join(cwd, tools.DATA_MODEL_FILE))
+  if (modelRaw === null) {
+    error(`one data: bu dizinde ${tools.DATA_MODEL_FILE} yok. Veri modelini önce bu dosyaya yazın (belge: "Veri modeli ve kayıt işlemleri").`)
+    return 1
+  }
+  let model
+  try {
+    model = JSON.parse(modelRaw)
+  } catch (err) {
+    error(`one data: ${tools.DATA_MODEL_FILE} geçerli JSON değil (${err instanceof Error ? err.message : String(err)}).`)
+    return 1
+  }
+  const migrationsDir = join(cwd, 'migrations')
+  const existing = existsSync(migrationsDir)
+    ? readdirSync(migrationsDir)
+        .filter((f) => f.endsWith('.sql'))
+        .sort()
+        .map((name) => ({ name, sql: readFileSync(join(migrationsDir, name), 'utf8') }))
+    : []
+  const snapshotPath = join(migrationsDir, tools.DATA_SNAPSHOT_FILE)
+  let plan
+  try {
+    plan = tools.planDataGeneration({ model, snapshot: readOptional(snapshotPath), existing })
+  } catch (err) {
+    if (err instanceof Error && err.name === 'DataModelError') {
+      error(`one data: değişiklik üretilmedi.\n${err.message}`)
+      return 1
+    }
+    throw err
+  }
+
+  const typesPath = join(cwd, tools.DATA_TYPES_FILE)
+  const writes = []
+  if (plan.migration) writes.push({ path: join(migrationsDir, plan.migration.name), content: plan.migration.sql, label: `migrations/${plan.migration.name}` })
+  if (readOptional(typesPath) !== plan.types) writes.push({ path: typesPath, content: plan.types, label: tools.DATA_TYPES_FILE })
+  if (readOptional(snapshotPath) !== plan.snapshot) writes.push({ path: snapshotPath, content: plan.snapshot, label: `migrations/${tools.DATA_SNAPSHOT_FILE}` })
+
+  const describe = (c) =>
+    c.kind === 'create-table'
+      ? `yeni tablo: ${c.entity}`
+      : c.kind === 'add-column'
+        ? `yeni alan: ${c.entity}.${c.field}`
+        : c.kind === 'add-search-column'
+          ? `arama kolonu: ${c.entity}.${c.field}`
+          : `yeni dizin: ${c.entity}.${c.field}`
+  for (const c of plan.changes) log(`  ${describe(c)}`)
+
+  if (check) {
+    if (writes.length === 0) {
+      log('one data: dosyalar güncel.')
+      return 0
+    }
+    log(`one data: güncel değil; "one data generate" şunları yazar:\n${writes.map((w) => `  ${w.label}`).join('\n')}`)
+    return 1
+  }
+  if (writes.length === 0) {
+    log('one data: değişiklik yok; dosyalar güncel.')
+    return 0
+  }
+  for (const w of writes) {
+    mkdirSync(dirname(w.path), { recursive: true })
+    writeFileSync(w.path, w.content)
+    log(`yazıldı: ${w.label}`)
+  }
+  if (plan.migration) log('Sıradaki adım: "one migrate" (yerel veritabanına uygular). Yayında migration platform tarafından uygulanır.')
+  return 0
+}

package/bin/devConfig.mjs

@@ -0,0 +1,132 @@
+// `one` komutunun SAF yardımcıları (D-72): manifest → yerel çalışma ortamı yapılandırması + komut argümanları.
+// Ağ ve dosya sistemi YOK → testlenir (devConfig.test.ts). Komutun kendisi one.mjs'tedir.
+//
+// Yerel çalışma ortamı uygulama deposuna yapılandırma dosyası BIRAKMAZ: yapılandırma her komutta manifest'ten
+// `.one/dev.jsonc`'a yeniden üretilir ve yerel veri `.one/state/` altında durur (ikisi de .gitignore'da). Gerçek
+// yüklemede yapılandırmayı one-ci üretir; buradaki adlar ve kimlikler yalnız yereldir.
+
+export const DEV_DIR = '.one'
+export const DEV_CONFIG_FILE = 'dev.jsonc'
+export const DEV_STATE_DIR = 'state'
+/** Yerelde Devoplus servislerine giden istekler bu tabana gider (test ortamı); `--api-base` ya da ONE_API_BASE ile değişir. */
+export const DEFAULT_API_BASE = 'https://test-api.devoplus.dev/'
+/** Çalışma ortamı sürüm tarihi — platformun yüklemede kullandığıyla aynı tutulur. */
+export const COMPATIBILITY_DATE = '2026-10-01'
+
+const SLUG_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/
+const ENTRY_RE = /^[\w./-]+\.(ts|js|mjs)$/
+const RENAMED = { d1: 'database', r2: 'files', kv: 'cache' }
+
+export class OneCliError extends Error {}
+
+/**
+ * Manifest'ten yalnız yerel çalışma için gereken alanları okur. Tam doğrulama one-ci'dedir (`one-ci validate`);
+ * burada yalnız komutun yanlış bir şey çalıştırmasına yol açacak hatalar yakalanır.
+ */
+export function readDevManifest(raw) {
+  let m
+  try {
+    m = JSON.parse(raw)
+  } catch {
+    throw new OneCliError('one.manifest.json okunamadı: geçerli JSON değil.')
+  }
+  const slug = m?.app?.slug
+  if (typeof slug !== 'string' || !SLUG_RE.test(slug)) throw new OneCliError('one.manifest.json: app.slug eksik ya da geçersiz.')
+  const entry = m?.entry
+  if (typeof entry !== 'string' || !ENTRY_RE.test(entry) || entry.split('/').includes('..'))
+    throw new OneCliError('one.manifest.json: entry eksik ya da geçersiz (ör. "src/index.ts").')
+  const services = m?.services ?? {}
+  for (const [old, next] of Object.entries(RENAMED))
+    if (old in services) throw new OneCliError(`one.manifest.json: "services.${old}" kaldırıldı; yerine "services.${next}" yazın.`)
+  return {
+    slug,
+    entry,
+    database: services.database !== false,
+    files: services.files === true,
+    cache: services.cache === true,
+  }
+}
+
+/** Yerel yapılandırma (`.one/dev.jsonc`). Göreli yollar bu dosyanın dizinine (`.one/`) göredir. */
+export function devConfig(manifest, options = {}) {
+  const apiBase = options.apiBase || DEFAULT_API_BASE
+  if (!/^https?:\/\/[^\s]+\/$/.test(apiBase)) throw new OneCliError(`API tabanı "http(s)://.../" biçiminde ve "/" ile bitmeli: ${apiBase}`)
+  const local = `one-local-${manifest.slug}`
+  const config = {
+    name: local,
+    main: `../${manifest.entry}`,
+    compatibility_date: COMPATIBILITY_DATE,
+    vars: { API_BASE: apiBase },
+  }
+  if (manifest.database)
+    config.d1_databases = [{ binding: 'DB', database_name: local, database_id: 'local', migrations_dir: '../migrations' }]
+  if (manifest.files) config.r2_buckets = [{ binding: 'FILES', bucket_name: local }]
+  if (manifest.cache) config.kv_namespaces = [{ binding: 'CACHE', id: 'local' }]
+  return config
+}
+
+export const COMMANDS = ['dev', 'migrate', 'build']
+
+/**
+ * Komut → çalışma ortamı aracının argümanları. `dev` ve `migrate` aynı yerel veri dizinini kullanır; aksi hâlde
+ * `one migrate`'in kurduğu tablolar `one dev`'de görünmezdi.
+ */
+export function commandArgs(command, options = {}) {
+  const config = `${DEV_DIR}/${DEV_CONFIG_FILE}`
+  const state = `${DEV_DIR}/${DEV_STATE_DIR}`
+  switch (command) {
+    case 'dev': {
+      const args = ['dev', '-c', config, '--persist-to', state]
+      if (options.port !== undefined) {
+        const port = Number(options.port)
+        if (!Number.isInteger(port) || port < 1 || port > 65535) throw new OneCliError(`--port geçersiz: ${options.port}`)
+        args.push('--port', String(port))
+      }
+      return args
+    }
+    case 'migrate':
+      return ['d1', 'migrations', 'apply', 'DB', '--local', '-c', config, '--persist-to', state]
+    case 'build':
+      // Çıktı dizini MUTLAK verilir: göreli yol aracın sürümüne göre yapılandırma dizinine ya da çalışma dizinine
+      // göre çözülüyor ve çıktı iki yere bölünüyordu (ölçüldü, 17.10.2026).
+      if (!options.outDir) throw new OneCliError('build için çıktı dizini verilmedi.')
+      return ['deploy', '--dry-run', '--outdir', options.outDir, '-c', config]
+    default:
+      throw new OneCliError(`bilinmeyen komut: ${command} (${COMMANDS.join(', ')})`)
+  }
+}
+
+/** `migrate` veritabanı olmayan uygulamada anlamsızdır; açık hata verilir. */
+export function assertCommandFits(command, manifest) {
+  if (command === 'migrate' && !manifest.database)
+    throw new OneCliError('Bu uygulama veritabanı kullanmıyor (services.database: false); "one migrate" gerekmez.')
+}
+
+export const USAGE = `kullanım: one <komut> [seçenekler]
+
+  one dev       uygulamayı yerelde çalıştırır (Devoplus One çalışma ortamı)
+                  --port <n>          dinlenecek port
+                  --api-base <url>    Devoplus API tabanı (varsayılan ${DEFAULT_API_BASE}; ONE_API_BASE ile de verilir)
+  one migrate   migrations/ altındaki SQL dosyalarını yerel veritabanına uygular
+  one build     yükleme provası: kodu paketler, hiçbir yere göndermez (çıktı .one/dist/)
+  one data generate [--check]
+                one.data.json veri modelinden migration + src/data/types.ts üretir (yalnız ekleyen değişiklik)
+
+  one login     Devoplus hesabınızla giriş (tarayıcıda kod onayı; portal orada seçilir)
+                  --env <test|uat|prod>   ortam (varsayılan test; ONE_ENV ile de verilir)
+                  --client-id <kimlik>    sabit istemci (verilmezse bu bilgisayar kendini bir kez kaydeder)
+  one logout    bu bilgisayardaki oturumu siler
+  one request <tür> ...  yöneticiden eksik izni ister (kurulum, DEXA sorgusu, uygulama izni gibi); "one request" türleri listeler
+  one requests [kimlik] taleplerinizi ve durumlarını listeler
+  one context   oturumdaki portalın adını ve var olan kısa adını (portal anahtarı) gösterir   [--json]
+
+  one publish   uygulamayı test ortamına yayınlar (paylaşılabilir önizleme)   [--portal <anahtar>]
+  one promote   sürümü bir sonraki ortama taşır (testten uat'a, sonra canlıya) [--portal <anahtar>]
+  one rollback  önceki sürüme döner (veri kaybı olabilir; --yes ister)       [--portal <anahtar>] [--to <x.y.z>] --yes
+  one deployments  yayın isteklerinizi ve durumlarını listeler              [--portal <anahtar>]
+  one status    kullanım ve hata özeti                                       [--portal <anahtar>] [--days 7]
+                  Yayın komutları "one login" oturumuyla çalışır; yayını Devoplus hattı yapar, kapıları atlanmaz.
+                  --portal verilmezse istek portal anahtarı taşımaz, kurulumu sunucu seçer; --app <kısa ad>, --json
+
+Yerel yapılandırma ve veri .one/ altındadır; depoya girmez. Gerçek yükleme Devoplus hattıyla yapılır; bu bilgisayardan
+yükleme yoktur.`