truthmark 2.2.7 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,229 +1,194 @@
1
1
  # Truthmark
2
2
 
3
- **Ajanlarınız kod yazar. Truthmark, insanlara yönelik ve Git üzerinden incelenebilir belgeleri korur.**
3
+ **Ajanlarınız kod yazar. Truthmark, insanlara yönelik ve Git üzerinden incelenebilir belgeleri güncel tutar.**
4
+
5
+ Truthmark, AI kodlama ajanlarının mevcut kod ve testlerden yeni ürün ve mühendislik belgeleri oluşturmasını, her kod değişikliğinden sonra bunları güncel tutmasını ve incelemeniz için sıradan Markdown farkları sunmasını sağlayan Git'e özgü iş akışlarını kurar.
6
+
7
+ [![npm sürümü](https://img.shields.io/npm/v/truthmark?color=cb3837&label=npm)](https://www.npmjs.com/package/truthmark)
8
+ [![CI](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
9
+ [![Lisans: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
10
+ [![Node.js >=24](https://img.shields.io/badge/node-%3E%3D24-339933?logo=node.js&logoColor=white)](../../package.json)
11
+
12
+ [Başlayın](#hızlı-başlangıç-ilk-truth-belgenizi-oluşturun) · [Web sitesi](https://merlinhu1.github.io/truthmark/) · [Kullanıcı kılavuzu](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
13
+
14
+ <details>
15
+ <summary>Bu README'yi 16 dilden birinde okuyun</summary>
4
16
 
5
17
  [🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
6
18
 
7
- ![Truthmark afişi](../assets/truthmark-banner.png)
19
+ </details>
8
20
 
9
- ## 🚀 Hızlı Başlangıç: beş dakikada yerelde çalıştırma
21
+ ## İlk belgeleri oluşturun. Doğru kalmalarını sağlayın.
10
22
 
11
- Bunu Truthmark tarafından yönetilmesini istediğiniz Git deposunun içinde çalıştırın:
23
+ Çoğu dokümantasyon aracı üretimden sonra durur. Truthmark, ajanlara doğrudan deponuzun içinde eksiksiz bir dokümantasyon yaşam döngüsü sunar:
12
24
 
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark config
17
- ```
25
+ - **Çalışan yazılımdan yeni belgeler oluşturun.** Truth Document kodu ve testleri okur, ardından sınırları belirli ürün veya mühendislik belgeleri oluşturur.
26
+ - **Belgeleri otomatik olarak uyumlu tutun.** Truth Sync, işlevsel kod değişikliklerinden sonra ajan tesliminde çalışır ve iş tamamlanmadan önce depo gerçeğini günceller.
27
+ - **Belgeleri yeniden koda dönüştürün.** Truth Realize, temiz bir doc-first iş akışını korurken onaylanmış truth belgelerini uygular.
28
+ - **Kod tabanı büyürken sahipliği onarın.** Truth Structure, yeni veya aşırı yüklenmiş alanlar için sınırları belirli rotalar ve başlangıç belgeleri oluşturur.
29
+ - **Her şeyi Git'te inceleyin.** Kod, kararlar, sözleşmeler, mimari, operasyonlar ve davranış aynı dalla birlikte ilerler.
18
30
 
19
- Gerçekten kullandığınız AI ana makinesini etkinleştirin. Yeni yapılandırmalar ana makineden bağımsızdır; bu yüzden başlatmadan önce `.truthmark/config.yml` dosyasına üst düzey bir `platforms` listesi ekleyin:
20
-
21
- ```yaml
22
- version: 2
23
- platforms:
24
- - codex # or: claude-code, github-copilot, opencode, antigravity, cursor
25
- truthmark:
26
- workspace: docs/truthmark
27
- generated:
28
- portal:
29
- enabled: false
30
- ```
31
+ Barındırılan bilgi tabanı yok. Özel ajan belleği yok. Sohbet geçmişine hapsolmuş dokümantasyon yok.
31
32
 
32
- Ardından depoya yerel gerçeklik belgelerini, yönlendirmeyi ve ajan iş akışı yüzeylerini kurun:
33
+ ## Hızlı başlangıç: ilk truth belgenizi oluşturun
34
+
35
+ **Gereksinimler:** Node.js 24 veya daha yenisi, bir Git deposu ve ajan iş akışları için desteklenen bir AI kodlama ana bilgisayarı.
36
+
37
+ Aşağıdaki komutları Truthmark'ın yönetmesini istediğiniz deponun içinde çalıştırın:
33
38
 
34
39
  ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
35
42
  truthmark init
36
- truthmark check
37
- git diff
38
43
  ```
39
44
 
40
- Şimdi en yaygın benimseme yolunu deneyin: kod ve testlerden mevcut bir davranışı belgeleyin. AI kodlama ana makinenizde, kurulu akışına şunu isteyin:
45
+ `truthmark init`; Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor veya ana bilgisayardan bağımsız bir komut satırı arayüzü kurulumu seçmenizi sağlar.
46
+
47
+ Şimdi yapılandırılmış ajanınızdan gerçek bir davranışı belgelemesini isteyin:
41
48
 
42
49
  ```text
43
50
  /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
44
51
  ```
45
52
 
46
- Bundan sonra kullanıcılar normalde Truth Sync'i doğrudan çağırmamalıdır. AI ana makineniz üzerinden kod yazmaya devam edin; kurulu depo yönergeleri, işlevsel kod değiştiğinde teslimden önce ajana ilgili testleri çalıştırmasını ve Truth Sync incelemesini yapmasını söyler. Siz ortaya çıkan kod farkını ve truth-belge farkını incelersiniz.
47
-
48
- Yalnızca CLI doğrulaması istiyor ve henüz ana makineye özgü AI iş akışları istemiyorsanız, `platforms` alanını dışarıda bırakıp `truthmark init && truthmark check` çalıştırın; daha sonra bir platform ekleyip `truthmark init` komutunu yeniden çalıştırabilirsiniz.
49
-
50
- ## 💡 Sorun: AI dokümantasyon boşluğu
53
+ Truth Document, henüz yoksa sınırları belirli yeni bir truth belgesi oluşturur; varsa mevcut sahibini günceller ve gerektiğinde yönlendirmeyi yeniler. İşlevsel kodu değiştirmez.
51
54
 
52
- AI kodlama ajanları hızlı kod yazma konusunda olağanüstüdür. Ancak bu hız tehlikeli yeni bir hata biçimi yaratır: **deponun anlattığı hikâye gerçeklikten uzaklaşır.**
55
+ Sonucu inceleyin:
53
56
 
54
- * Davranış, geçici sohbet geçmişlerinde kaybolur.
55
- * Mimari belgeleri hızla geride kalır.
56
- * Ürün kararları teslimden sonra kaybolur.
57
- * Kod inceleyenler, "neden"i anlamadan ham kod farklarını incelemek zorunda kalır.
58
- * Her yeni AI oturumu, deponuzun gerçeğini sıfırdan yeniden keşfetmeye zorlanır.
59
-
60
- ## 🎯 Çözüm: Truthmark
61
-
62
- **Truthmark**, deponuza Git'e özgü bir iş akışı katmanı kurar. AI geliştirmesinde genellikle bozulan kısmı düzeltir: belgelerin kodla uyumlu kalmasına yardımcı olmak.
63
-
64
- İnsanların ve AI ajanlarının belgeleri güncellemeyi hatırlamasını ummak yerine, Truthmark dokümantasyonu doğrudan deponuzun içinde sistematik ve incelenebilir bir alışkanlığa dönüştürür.
65
-
66
- ### ✨ Truthmark neden benzersizdir
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
67
62
 
68
- Truthmark sıradan bir dokümantasyon aracı değildir. AI iş akışına derinlemesine entegredir:
63
+ Artık şunlara sahip olmalısınız:
69
64
 
70
- * **🚫 Tedarikçi kilidi yok:** Barındırılan hizmet yok, gizli veritabanı yok, işletilecek ek sunucu yok.
71
- * **🌳 %100 Git'e özgü:** Her şey deponuzda yaşar. Gerçek, dalınızla birlikte hareket eder.
72
- * **🤝 İnsanların sahip olduğu, ajanların izlediği sözleşme:** Bakımcılar depo sözleşmesine sahiptir; ajanlar kod yazarken kurulu talimatları izler.
73
- * **✅ Doğrulama yoluyla güven:** Davranışı değiştiren işlerde insan tarafından incelenebilir bir gerçeklik belgesi kararı veya farkı bulunduğu için AI çalışmasına güvenmek kolaylaşır.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
74
69
 
75
- ## 🔄 Nasıl çalışır
70
+ Kesin yollar, deponuzun sahiplik yapısını izler. Yeni dosyalar `git status` içinde, izlenen dosyalardaki değişiklikler ise `git diff` içinde görünür.
76
71
 
77
- Bir AI ajanı kodunuzu değiştirdiğinde bitmiş sayılmaz. Truthmark, ajanların teslimden önce izlediği bir bitiş zamanı akışı koruması kurar:
72
+ Çağırma biçimi ana bilgisayara göre değişir. OpenCode `/skill truthmark-document`, Antigravity `@truthmark-document` kullanır; desteklenen diğer ana bilgisayarlar ise kendi yerel beceri veya eğik çizgi komutu yüzeylerini kullanır. Kesin komutlar için [platform tablosuna](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) bakın.
78
73
 
79
- 1. 💻 **Kod:** Ajan işlevsel kodu değiştirir.
80
- 2. 🧪 **Test:** İlgili testler çalıştırılır.
81
- 3. 🔍 **Kontrol:** Truthmark, kurulu bitiş incelemesinin parçası olarak eşlenen dokümantasyonu kontrol eder.
82
- 4. 📝 **Belgeleme:** Depo gerçeği değiştiğinde belgeler ajan tarafından güncellenir.
83
- 5. 👀 **İnceleme:** Bir insan *kod farkını* + *gerçeklik farkını* inceler.
74
+ Betikler ve sürekli entegrasyon için seçilen platformları açıkça iletin:
84
75
 
85
- ## 🛠 Truthmark ile nasıl etkileşirsiniz
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
86
80
 
87
- Truthmark’ın depo yerelinde tek bir sözleşmesi ve onu kullanmanın iki yolu vardır.
81
+ Ana bilgisayardan bağımsız bir depo için etkileşimli olarak `none` seçin veya `truthmark init --clear-platforms` çalıştırın. Daha sonra `truthmark init` komutunu yeniden çalıştırarak ajan platformları ekleyebilirsiniz.
88
82
 
89
- ### İnsanlar sözleşmeyi kurar ve doğrular
83
+ Dala göre güncellik tanılaması için bir Git tabanı iletin:
90
84
 
91
- Bakımcılar ve CI, CLI kullanır:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
92
88
 
93
- * `truthmark config` - ilk yapılandırmayı oluşturur.
94
- * `truthmark init` - yönlendirmeyi, truth-doc iskelelerini ve AI ana makine talimatlarını kurar veya yeniler.
95
- * `truthmark check` - depo gerçeğini terminalden doğrular.
89
+ ## Truthmark nasıl çalışır
96
90
 
97
- ### Ajanlar kod yazarken sözleşmeyi izler
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Truthmark nasıl çalışır" width="1440">
94
+ </picture>
98
95
 
99
- Truthmark, Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor gibi desteklenen AI kodlama ana makineleri için depo yerelinde talimatlar kurar.
96
+ Truthmark komut satırı arayüzü depo sözleşmesini kurar ve doğrular. Kodlama ajanınız, kurulu ve ana bilgisayara özgü akışları üzerinden kanıt incelemesini ve dokümantasyon çalışmasını gerçekleştirir.
100
97
 
101
- Normal döngü basittir:
98
+ Normal bir kod değişikliği tek ve basit bir döngü izler:
102
99
 
103
- 1. Ajanınızdan kod değişikliği isteyin veya mevcut bir davranışı belgelemesini isteyin.
104
- 2. Kurulu talimatlar ajana ne zaman test edeceğini, ne zaman truth dokümanlarını güncelleyeceğini ve ne zaman insan incelemesi için duracağını söyler.
105
- 3. Siz sıradan Git diff’lerini incelersiniz: kod ve varsa truth-doc değişiklikleri.
100
+ 1. Ajan işlevsel kodu değiştirir.
101
+ 2. İlgili testler çalıştırılır.
102
+ 3. Truth Sync, eşlenen belgeleri kontrol eder.
103
+ 4. Depo gerçeği değiştiğinde ajan belgeleri ve yönlendirmeyi oluşturur veya günceller.
104
+ 5. Kod farkını ve truth farkını birlikte incelersiniz.
106
105
 
107
- Kullanıcı tarafından başlatılan ajan istekleri bilinçli olarak azdır:
106
+ ## İş akışları
108
107
 
109
- * `/truthmark-document` - kod ve testlerden mevcut uygulanmış davranışı belgeler.
110
- * `/truthmark-realize` - mevcut truth dokümanlarından kod uygular.
111
- * `/truthmark-check` - depo gerçeğini denetler.
108
+ | İş akışı | Ne zaman kullanılır | Sonuç |
109
+ | -------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
110
+ | **Truth Document** | Mevcut kodun belgelenmesi gerekir | Kanıta dayalı ürün ve mühendislik belgeleri oluşturur veya günceller |
111
+ | **Truth Sync** | İşlevsel kod değişmiştir | Teslimden önce eşlenen belgeleri ve yönlendirmeyi uyumlu tutar |
112
+ | **Truth Structure** | Yeni bir alanın sahipliğe ihtiyacı vardır veya mevcut belgeler fazla geniştir | Sınırları belirli rotalar ve iskelet başlangıç belgeleri oluşturur |
113
+ | **Truth Realize** | Onaylanmış bir truth belgesi çalışan yazılıma dönüşmelidir | İşlevsel kodu dokümantasyondan günceller |
114
+ | **Truth Check** | Depo gerçeğinin denetlenmesi gerekir | Yönlendirme, sahiplik, kanıt ve dokümantasyon sorunlarını bildirir |
115
+ | **Truthmark Portal** | Ekip, göz atılabilir bir dokümantasyon sitesi ister | Markdown truth belgelerinden commit edilmiş statik bir HTML sunumu üretir |
112
116
 
113
- Truth Sync işe başlamanın olağan yolu değildir; işlevsel kod değişikliklerinden sonraki bitiş incelemesidir.
114
- Truth Structure günlük bir komut değildir; yalnızca çalışmayı engellediğinde yönlendirmeyi veya sahipliği onarır.
117
+ Truthmark bu akışlarını Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için yerel depo yüzeyleri olarak kurar.
115
118
 
116
119
  ## Neler elde edersiniz
117
120
 
118
- | Yetenek | Ne yapar |
119
- | --- | --- |
120
- | Git'e özgü gerçeklik | Depo gerçeğini commit edilmiş Markdown ve yapılandırmada tutar. |
121
- | Dal kapsamlı dokümantasyon | Gerçek, özel bir oturumda yaşamak yerine dalla birlikte hareket eder. |
122
- | İnsan CLI'si | Bakımcılara kurulum, yenileme, doğrulama ve inceleme komutları sağlar. |
123
- | Kurulu ajan rehberliği | Kodlama ajanlarına ne zaman belge yazacağını, test edeceğini, gerçeği senkronize edeceğini, denetleyeceğini veya inceleme için duracağını söyler. |
124
- | Açık yönlendirme | Kod alanlarını kanonik gerçeklik belgelerine eşler. |
125
- | İncelenebilir teslimler | Hem kod hem de gerçeklik belgeleri için sıradan Git farkları üretir. |
126
- | Yerel-öncelikli çalışma | Barındırılan hizmet, daemon, veritabanı veya MCP sunucusu gerektirmez. |
127
- | Daha güvenli yazma sınırları | Kod-öncelikli, belge-öncelikli, salt-okunur ve yalnızca-belge iş akışlarını ayırır. |
128
- | Doğrulama | Yönlendirme, yetki, frontmatter, bağlantı, üretilmiş yüzey, dal kapsamı, güncellik ve kapsam sorunlarını raporlar. |
129
- | İsteğe bağlı Portal | Açıkça etkinleştirilip istendiğinde Markdown gerçeklik belgelerinden commit edilmiş statik bir HTML sunum sitesi üretir. |
130
-
131
- ## Görsel genel bakış
132
-
133
- ![Truthmark özellikleri](../assets/truthmark-features.png)
134
-
135
- **Özellikler:** Truthmark'ın ne kurduğu ve iş akışı yüzeyinin nasıl bölündüğü.
136
-
137
- ![Truthmark konumu](../assets/truthmark-position.png)
121
+ ### Gerçeklikten başlayan dokümantasyon
138
122
 
139
- **Konum:** Truthmark'ın istemlere, belleğe ve spesifikasyonakışlarına göre nerede yer aldığı.
123
+ Truthmark; ürün yetenekleri, uygulama davranışı, uygulama programlama arayüzleri, mimari, akışları, operasyonlar ve testler için belgeler oluşturabilir. Kod ve testler kanıtı sağlar; sınırları belirli Markdown belgeleri sonucu kalıcılaştırır.
140
124
 
141
- ![Truthmark senkronizasyon akışı](../assets/truthmark-syncflow.png)
125
+ ### Bir sonraki değişiklikten sağ çıkan dokümantasyon
142
126
 
143
- **Senkronizasyon akışı:** Truth Sync'in normal kod değişikliklerini teslimden önce nasıl kapattığı.
127
+ Rotalar, kod alanlarını kanonik belgelere bağlar. Ajanlar davranışı değiştirdiğinde Truth Sync, ilgili gerçeğin nereye ait olduğunu bilir ve teslimi incelenebilir tutar.
144
128
 
145
- ## Ekipler neden benimser
129
+ ### Ayrı kulvarlarda ürün ve mühendislik gerçeği
146
130
 
147
- Truthmark, AI ajanlarının kod üretebildiğini zaten bilen ekipler içindir.
131
+ Ürün gerçeği; kullanıcıya dönük vaatleri, sınırları, kararları ve kabul kriterlerini kapsar. Mühendislik gerçeği; mevcut davranışı, sözleşmeleri, mimariyi, iş akışlarını, operasyonları ve test davranışını kapsar.
148
132
 
149
- Sıradaki sorun yönetişimdir.
133
+ ### Git'e özgü iş birliği
150
134
 
151
- Tören anlamında yönetişim değil. Basit bir soru olarak yönetişim:
135
+ Önemli olan her şey commit edilmiş depo dosyalarında yaşar. Gerçek dalla birlikte ilerler, sıradan pull request'lerle çalışır ve her bakımcı ile kodlama ajanına görünür kalır.
152
136
 
153
- > Bu AI destekli değişiklikten sonra depo hâlâ gerçeği söylüyor mu?
137
+ ### Yerel öncelikli çalışma
154
138
 
155
- Truthmark, commit edilmiş dosyalar, açık yönlendirme ve incelenebilir farklarla ekiplerin buna yanıt vermesine yardımcı olur.
156
-
157
- Şunlara ihtiyaç duyduğunuzda yararlıdır:
158
-
159
- - daha az dokümantasyon kayması
160
- - daha iyi teslimler
161
- - dala özgü ürün gerçeği
162
- - kalıcı mimari ve API dokümantasyonu
163
- - belgeler ile kod arasında açık sahiplik
164
- - daha güvenli ajan yazma sınırları
165
- - gizli bellek yerine incelenebilir dokümantasyon
166
- - commit edilmiş depo dosyalarından çalışmaya devam eden AI iş akışları
139
+ Truthmark barındırılan hizmet, daemon, veritabanı, vektör deposu veya Model Context Protocol sunucusu gerektirmez. Depo kendi dokümantasyon iş akışını taşır.
167
140
 
168
141
  ## Truthmark nerede yer alır
169
142
 
170
- Truthmark istemlerin, belleğin, spesifikasyonların, testlerin veya kod incelemesinin yerini almaz.
171
-
172
- Bu akışlarına Git içinde kalıcı bir iniş alanı sağlar.
143
+ | İhtiyaç | En iyi seçenek |
144
+ | ---------------------------------------------------- | ------------------------------ |
145
+ | Tek bir ajan oturumundan daha iyi çıktı | Daha iyi prompt |
146
+ | Kişisel veya oturum düzeyinde süreklilik | Bellek aracı |
147
+ | Plan öncelikli özellik çalışması | Spesifikasyon iş akışı |
148
+ | Kodla birlikte ilerleyen, dal kapsamlı dokümantasyon | **Truthmark** |
149
+ | Davranış doğruluğu | Testler ve kod incelemesi |
150
+ | İncelenebilir, AI destekli dokümantasyon | **Truthmark + Git incelemesi** |
173
151
 
174
- | İhtiyaç | Daha uygun seçenek |
175
- | --- | --- |
176
- | Tek bir ajan oturumundan daha iyi çıktı | Daha iyi istem |
177
- | Kişisel veya oturum düzeyinde süreklilik | Bellek aracı |
178
- | Plan-öncelikli özellik çalışması | Spesifikasyon iş akışı |
179
- | Kodla birlikte taşınan dal kapsamlı gerçek | Truthmark |
180
- | Davranış doğruluğunu doğrulama | Testler ve inceleme |
181
- | AI destekli dokümantasyon değişikliklerini inceleme | Truthmark artı Git incelemesi |
152
+ Truthmark, AI kodlama ajanlarını zaten kullanan ve depo gerçeğinin kod kadar hızlı güncellenmesini isteyen bakımcılar ile mühendislik ekipleri için tasarlanmıştır.
182
153
 
183
- Truthmark'ın alanı tasarım gereği dardır:
184
-
185
- ```text
186
- make repository truth explicit
187
- route it to code
188
- etrafına ajan rehberliği kurmak
189
- keep the result reviewable in Git
190
- ```
154
+ ## Desteklenen ana bilgisayarlar ve komut satırı
191
155
 
192
- ## Daha derine inin
156
+ Desteklenen ajan ana bilgisayarları:
193
157
 
194
- README vitrin görevi görür: hızlı bağlam, hızlı başlangıç ve temel zihinsel model.
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
195
164
 
196
- Komut komut kullanım, yüzey karşılaştırmaları, desteklenen platform ayrıntıları, yapılandırma, yönlendirme, Portal ve örnekler için [Truthmark Kullanıcı Kılavuzu](../user-guide.md) sayfasını okuyun.
165
+ <details>
166
+ <summary>Komut satırı başvurusu</summary>
197
167
 
198
- ## Proje durumu
168
+ | Komut | Amaç |
169
+ | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Yapılandırmayı, yönlendirmeyi, şablonları ve seçilen ana bilgisayar iş akışlarını oluşturur veya yeniler |
171
+ | `truthmark check [--base <ref>]` | Depo gerçeğini doğrular ve isteğe bağlı olarak dal güncelliği tanılamasını çalıştırır |
172
+ | `truthmark index --json` | Türetilmiş depo ve yönlendirme meta verilerini inceler |
173
+ | `truthmark impact --base <ref> --json` | Değişen dosyaları belgelere, sahiplerine ve yakındaki testlere eşler |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | İş akışının uygulanabilirliğini ve hedeflerini inceler |
175
+ | `truthmark validate ...` | İş akışı raporlarını ve yazma kiralarını doğrular |
176
+ | `truthmark uninstall --dry-run\|--apply` | Yazılmış truth belgelerini koruyarak oluşturulan ana bilgisayar yüzeylerini önizler veya kaldırır |
199
177
 
200
- Mevcut sürüm şunları sağlar:
178
+ Betikler ve sürekli entegrasyon için komut satırı arayüzünün tamamında yapılandırılmış JSON çıktısı bulunur.
201
179
 
202
- - config, init, check, index, impact ve iş akışı durumu için yerel CLI komutları
203
- - Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için oluşturulan depo yerelinde ajan talimatları
204
- - yönlendirme, yetki, frontmatter, bağlantı, güncellik, üretilmiş yüzey, dal kapsamı ve kapsam tanıları
205
- - dal kapsamlı gerçeklik belgeleri ve türetilmiş depo zekâsı artefaktları
180
+ </details>
206
181
 
207
- ## Dokümantasyon
182
+ ## Daha fazlasını öğrenin
208
183
 
209
- - [Kullanıcı kılavuzu](../user-guide.md)
210
- - [Dokümanlar dizini](../README.md)
211
- - [Mimari genel bakışı](../truthmark/engineering/architecture/overview.md)
212
- - [API ve CLI sözleşmeleri](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
213
- - [Depo gerçeği bakım kılavuzu](../standards/maintaining-repository-truth.md)
184
+ - [Truthmark kullanıcı kılavuzu](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Dokümantasyon dizini](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Mimariye genel bakış](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Yapılandırma, yönlendirme ve komut sözleşmeleri](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Katkıda bulunma](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
214
189
 
215
- Yerel geliştirme ve katkı komutları için [CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın.
216
-
217
- ## Tasarım sınırları
218
-
219
- Truthmark bilinçli olarak küçüktür: yerel, commit edilmiş, dal kapsamlı ve incelenebilir.
220
-
221
- Barındırılan bir hizmet, MCP sunucusu, vektör veritabanı, gizli bellek katmanı, CI yaptırım ürünü veya otonom kod yeniden yazma motoru değildir. Depo gerçeğinin görünür kalmasına yardımcı olur; testlerin, kod incelemesinin veya insan yargısının yerini almaz.
190
+ **Truthmark'ı kurun, kodlama ana bilgisayarınızı seçin ve gerçek bir davranışı bugün belgeye dönüştürün.**
222
191
 
223
192
  ## Lisans
224
193
 
225
194
  MIT. Bkz. [LICENSE](../../LICENSE).
226
-
227
- ## Güvenli kaldırma
228
-
229
- `truthmark uninstall --dry-run` komutunu kullanarak tam olarak oluşturulan ana bilgisayar yüzeylerini inceleyin, ardından kaldırmak için `truthmark uninstall --apply` komutunu çalıştırın. Oluşturulan truth, yapılandırma, şablonlar, Portal çıktısı, Gemini dosyaları ve alakasız kullanıcı dosyaları korunur; global npm kurulumunu paket yöneticinizle ayrı olarak kaldırın.