CLI Başvurusu

@tecof/cli paketi tecof komutunu kurar. Bu sayfa tüm komutları ve seçenekleri, ortam değişkenlerini, çıkış kodlarını, JSON makbuzlarını, yok sayma kurallarını ve sınırları listeler. Adım adım akış için Tema Geliştirme: Hızlı Başlangıç ve Hızlı Başlangıç: Tecof CLI sayfalarına bakın.

npm install -g @tecof/cli    # Node.js 20+
tecof --help                 # tüm komutlar
tecof theme                  # bir grubun komutları
tecof theme push --help      # tek komutun seçenekleri

Mesajlar Türkçedir; TECOF_LANG=en İngilizce çıktı verir. TECOF_LANG tanımlı değilse ve sistem dili (LC_ALL, LC_MESSAGES ya da LANG) en ile başlıyorsa da İngilizce kullanılır; Türkçeyi zorlamak için TECOF_LANG=tr.

Genel Seçenekler#

Alan kimlikleri thm_… (tema) ya da app_… (uygulama) biçimindedir. Sürümlere v12, 12 ya da sürüm kimliğiyle başvurulur.

Hesap#

tecof doctor denetimleri:

Alanlar#

Tema#

theme ls ve theme init dışındaki tema komutları, bulunduğunuz klasörden yukarı doğru ilk .tecof/space.json bağını kullanır.

tecof theme dev seçenekleri:

tecof theme push seçenekleri:

Uygulama#

Uygulama komutları bulunduğunuz klasörden yukarı doğru ilk tecof.app.json dosyasını kullanır. Alan kimliği app_<tecof.app.json içindeki id> olur.

Sürüm komutları:

Sürüm komutları yalnız Tecof barındırmalı uygulamalarda çalışır; hosting: "external" uygulamada hata verir.

Diğer uygulama komutları:

Ayrıntılar: Hızlı Başlangıç: Tecof CLI.

Token'lar#

Kapsamlı token'la tokens ls, tokens create ve başka bir token için tokens revoke çalışmaz. Ayrıntı: Güvenlik ve CI.

Kurulum#

Ayrıntı: Güvenlik ve CI → Kodlama ajanları.

Ortam Değişkenleri#

Çıkış Kodları#

Geliştirme sunucusu komutları (theme dev, app dev) Ctrl+C ile kesilince 130 döner; yerel theme dev aksi hâlde geliştirme sunucusunun çıkış kodunu iletir.

JSON Makbuzları#

--json ile her komut tek bir JSON belgesi basar: başarıda stdout'a, hatada stderr'e. Başka satır basılmaz; uyarılar makbuzun diagnostics dizisine girer.

Başarı makbuzu (tecof theme push --json; version nesnesi kısaltılmıştır):

{
  "ok": true,
  "command": "theme push",
  "space": "thm_66f1a2b3c4d5e6f7a8b9c0d1",
  "version": {
    "number": 12,
    "ref": "v12",
    "source": "cli",
    "target": "staged",
    "status": "ready",
    "live": false,
    "servedBefore": false,
    "commitSha": "4d2c9e…",
    "baseSha": "a1b2c3…",
    "message": "Yeni ana sayfa",
    "url": "https://tecof-theme-butik-3k9x2a1b7-tecof.vercel.app",
    "liveUrl": null,
    "stats": { "files": 312, "uploaded": 3, "reused": 0, "deleted": 1, "unchanged": 309, "bytes": 18234 }
  },
  "activation": { "outcome": "staged", "liveVersion": 11, "rolledBack": false, "diagnostics": [] },
  "push": { "files": 312, "uploaded": 3, "deleted": 1, "unchanged": 309, "bytes": 18234 },
  "next": { "action": "promote", "command": "tecof theme promote v12" },
  "diagnostics": []
}

Hata makbuzu (tecof theme promote v12 --yes --json, stderr):

{
  "ok": false,
  "command": "theme promote",
  "space": "thm_66f1a2b3c4d5e6f7a8b9c0d1",
  "error": {
    "code": "base-moved",
    "message": "main ilerledi (şu an 9f8e7d6); bu push eski tabana dayanıyor (base-moved).",
    "data": { "mainSha": "9f8e7d6…" }
  },
  "next": { "action": "pull", "command": "tecof theme pull" },
  "diagnostics": []
}

Komuta göre ek alanlar gelir: push (yükleme özeti), noop, versions, spaces, detail, tokens, token, url, protected, opened, lines, checks (doctor) vb. whoami ve eski uygulama komutları (app init, link, info, config push, dev, deploy, deployments, secret rotate, open) başarıda daha basit bir JSON basar; hata makbuzları her komutta aynı biçimdedir.

next.action Değerleri#

Sır Maskeleme#

tecof theme open vN bağlantısındaki erişim sırrı ve tecof tokens create ile basılan token, makbuzda --show-secret olmadan maskelenir (x-vercel-protection-bypass=***, tcfd_***). Kayıtlı token'lar ve istemci sırları hiçbir çıktıda basılmaz.

Yok Sayma Kuralları#

CLI şu yolları hiçbir zaman göndermez. Kurallar gitignore anlamındadır: eğik çizgi içermeyen desen her derinlikte eşleşir, sondaki / yalnız klasör demektir.

.git/  .github/  node_modules/  .next/  .vercel/  .turbo/  out/  coverage/  .tecof/
.DS_Store  *.log  .env* (yalnız .env.example gönderilir)  .npmrc
*.pem  *.key  *.p12  *.pfx  id_rsa*  id_ed25519*

• Ardından projenin .gitignore ve .tecofignore dosyaları uygulanır; alt klasörlerdekiler de okunur. Aynı klasörde .tecofignore, .gitignore'dan sonra okunur ve !desen ile .gitignore'un dışladığı bir yolu yeniden dahil edebilir. Dışlanan bir klasörün içindeki dosya yeniden dahil edilemez (git kuralı).
• Yukarıdaki sabit liste proje dosyalarıyla yeniden dahil edilemez.
• Sembolik bağlantılar izlenmez; uyarıyla atlanır.
• .tecofignore normal bir dosyadır ve depoya gönderilir.

Silme kuralı: Push, yerelde olmayan dosyaları depodan siler; ancak sunucu şunları asla silmez: .github/ altındaki her şey, yukarıdaki sabit liste ve depodaki kök .gitignore / .tecofignore desenlerine uyan yollar (push'unuz bu dosyaları değiştiriyorsa yeni desenler de). Sunucu alt klasördeki ignore dosyalarını okumaz: depoda bulunan bir dosyayı yalnız alt klasördeki bir .gitignore ile dışlarsanız CLI onu göndermez ve sunucu onu silinmiş sayar. Depoda kalması gereken ama göndermek istemediğiniz yolları kökteki .tecofignore dosyasına yazın.

# .tecofignore (proje kökü)
# Depoda kalsın, CLI göndermesin
design/
*.psd
# .gitignore "*.woff2" diyorsa bu dosya yine de gönderilsin
!public/fonts/marka.woff2

Push planı her zaman kaç dosyanın yükleneceğini ve silineceğini gösterir: Plan: 3 yüklenecek, 1 silinecek, 309 aynı.

Sınırlar#

İstek gövdesi sınırları (API'yi doğrudan kullananlar için): plan 4 MB, yükleme 14 MB (istek başına en çok 200 dosya), commit 1 MB, bulut geliştirme dosyaları 8 MB, canlıya alma, geri alma, oturum ve token istekleri 64 KB. Sınırı aşan istek 413 payload-too-large döner.

CLI bu sınırları kendisi gözetir: yüklemeleri istek başına en çok 200 dosya ve ≈ 10 MB'lık gruplara böler (10 MB'lık bir dosya tek başına gönderilir), sınırı aşacak bir push'u hiçbir dosya yüklenmeden durdurur. Bulut geliştirmede bir dosya en çok 5 MB olabilir (gövde sınırı 8 MB).