truthmark 2.3.0 → 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,220 +1,194 @@
1
1
  # Truthmark
2
2
 
3
- **Agen Anda menulis kode. Truthmark memelihara dokumentasi yang ditujukan untuk manusia dan dapat ditinjau melalui Git.**
3
+ **Agen Anda menulis kode. Truthmark menjaga dokumentasi yang ditujukan untuk manusia dan siap ditinjau di Git.**
4
4
 
5
- [🇺🇸 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)
5
+ Truthmark memasang alur kerja native Git yang memungkinkan agen pengodean AI membuat dokumentasi produk dan rekayasa baru dari kode serta pengujian yang sudah ada, menjaganya tetap mutakhir setelah setiap perubahan kode, dan memberikan diff Markdown biasa untuk Anda tinjau.
6
6
 
7
- ![Banner Truthmark](../assets/truthmark-banner.png)
7
+ [![versi npm](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
+ [![Lisensi: 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)
8
11
 
9
- ## 🚀 Mulai cepat: berjalan lokal dalam lima menit
12
+ [Mulai](#mulai-cepat-buat-dokumen-truth-pertama-anda) · [Situs web](https://merlinhu1.github.io/truthmark/) · [Panduan pengguna](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
10
13
 
11
- Jalankan ini di dalam repositori Git yang ingin Anda kelola dengan Truthmark:
14
+ <details>
15
+ <summary>Baca README ini dalam salah satu dari 16 bahasa</summary>
12
16
 
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark init
17
- truthmark check
18
- git diff
19
- ```
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)
20
18
 
21
- Di terminal interaktif, `truthmark init` menampilkan pilihan ganda bernomor. Pilih nol atau lebih platform, atau masukkan `none` untuk penyiapan netral terhadap host yang hanya memakai CLI.
19
+ </details>
22
20
 
23
- Untuk skrip dan CI, ulangi `--platform`; `--json` tidak pernah menampilkan prompt:
21
+ ## Buat dokumentasi pertama. Jaga agar tetap benar.
24
22
 
25
- ```bash
26
- truthmark init --platform codex --platform cursor
27
- truthmark init --json
28
- ```
23
+ Sebagian besar alat dokumentasi berhenti setelah pembuatan. Truthmark memberi agen siklus hidup dokumentasi lengkap di dalam repositori Anda:
29
24
 
30
- Pada proses noninteraktif pertama tanpa `--platform`, penyiapan tetap netral terhadap host; proses berikutnya mempertahankan pilihan yang tersimpan di `.truthmark/config.yml`.
25
+ - **Buat dokumentasi baru dari perangkat lunak yang berfungsi.** Truth Document membaca kode dan pengujian, lalu membuat dokumentasi produk atau rekayasa dengan cakupan yang jelas.
26
+ - **Jaga dokumentasi tetap selaras secara otomatis.** Truth Sync berjalan saat serah terima agen setelah perubahan kode fungsional dan memperbarui kebenaran repositori sebelum pekerjaan dinyatakan selesai.
27
+ - **Ubah dokumentasi kembali menjadi kode.** Truth Realize mengimplementasikan dokumen truth yang disetujui sambil mempertahankan alur kerja doc-first yang rapi.
28
+ - **Perbaiki kepemilikan seiring pertumbuhan basis kode.** Truth Structure membuat rute dengan cakupan jelas dan dokumen awal untuk area baru atau yang terlalu luas.
29
+ - **Tinjau semuanya di Git.** Kode, keputusan, kontrak, arsitektur, operasi, dan perilaku bergerak bersama branch.
31
30
 
32
- Sekarang coba jalur adopsi yang paling umum: dokumentasikan satu perilaku yang sudah ada dari kode dan pengujian. Di host pengodean AI Anda, minta alur kerja yang terpasang:
31
+ Tanpa basis pengetahuan ter-host. Tanpa memori agen privat. Tanpa dokumentasi yang terjebak dalam riwayat chat.
33
32
 
34
- ```text
35
- /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
36
- ```
33
+ ## Mulai cepat: buat dokumen truth pertama Anda
37
34
 
38
- Setelah itu, pengguna biasanya tidak perlu memanggil Truth Sync secara langsung. Teruslah membuat kode melalui host AI Anda; instruksi repositori yang terpasang memberi tahu agen untuk menjalankan pengujian yang relevan dan melakukan tinjauan Truth Sync sebelum serah terima ketika kode fungsional berubah. Anda meninjau diff kode yang dihasilkan beserta diff dokumen truth.
35
+ **Persyaratan:** Node.js 24 atau yang lebih baru, repositori Git, dan host pengodean AI yang didukung untuk alur kerja agen.
39
36
 
40
- Jika Anda hanya menginginkan validasi CLI, pilih `none` lalu jalankan `truthmark check`; Anda dapat menjalankan ulang `truthmark init` nanti untuk memilih platform.
37
+ Jalankan perintah berikut di dalam repositori yang ingin Anda kelola dengan Truthmark:
41
38
 
42
- ## 💡 Masalah: kesenjangan dokumentasi AI
39
+ ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
42
+ truthmark init
43
+ ```
43
44
 
44
- Agen pengodean AI luar biasa dalam menulis kode dengan cepat. Namun kecepatan ini menciptakan mode kegagalan baru yang berbahaya: **cerita repositori menyimpang dari kenyataan.**
45
+ `truthmark init` memungkinkan Anda memilih Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor, atau penyiapan antarmuka baris perintah yang netral terhadap host.
45
46
 
46
- * Perilaku hilang dalam riwayat chat yang sementara.
47
- * Dokumen arsitektur cepat tertinggal.
48
- * Keputusan produk lenyap setelah serah terima.
49
- * Peninjau kode dibiarkan memeriksa diff kode mentah tanpa memahami "mengapa".
50
- * Setiap sesi AI baru dipaksa menemukan ulang kebenaran repositori Anda dari awal.
47
+ Sekarang minta agen yang telah dikonfigurasi untuk mendokumentasikan satu perilaku nyata:
51
48
 
52
- ## 🎯 Solusi: Truthmark
49
+ ```text
50
+ /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
51
+ ```
53
52
 
54
- **Truthmark** memasang lapisan alur kerja native Git ke dalam repositori Anda. Ini memperbaiki bagian pengembangan AI yang biasanya rusak: membantu dokumentasi tetap selaras dengan kode.
53
+ Truth Document membuat dokumen truth baru dengan cakupan jelas jika belum ada, memperbarui pemilik yang sudah ada jika tersedia, dan memperbarui perutean bila diperlukan. Alur ini tidak mengubah kode fungsional.
55
54
 
56
- Alih-alih berharap manusia dan agen AI ingat memperbarui dokumen, Truthmark menjadikan dokumentasi sebagai kebiasaan sistematis dan dapat ditinjau langsung di dalam repositori Anda.
55
+ Tinjau hasilnya:
57
56
 
58
- ### ✨ Mengapa Truthmark unik
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
59
62
 
60
- Truthmark bukan sekadar alat dokumentasi lain. Ia terintegrasi mendalam ke dalam alur kerja AI:
63
+ Sekarang Anda akan memiliki:
61
64
 
62
- * **🚫 Tanpa ketergantungan vendor:** Tidak ada layanan ter-host, tidak ada basis data tersembunyi, tidak ada server tambahan untuk dioperasikan.
63
- * **🌳 100% native Git:** Semuanya hidup di repositori Anda. Kebenaran bergerak bersama branch Anda.
64
- * **🤝 Kontrak yang dimiliki manusia dan diikuti agen:** Pemelihara memiliki kontrak repositori; agen mengikuti instruksi yang terpasang saat membuat kode.
65
- * **✅ Kepercayaan melalui verifikasi:** Pekerjaan AI menjadi lebih mudah dipercaya karena pekerjaan yang mengubah perilaku menyertakan keputusan atau diff dokumen kebenaran yang dapat ditinjau manusia.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
66
69
 
67
- ## 🔄 Cara kerjanya
70
+ Path yang tepat mengikuti struktur kepemilikan repositori Anda. File baru muncul di `git status`; perubahan pada file yang dilacak muncul di `git diff`.
68
71
 
69
- Ketika agen AI memodifikasi kode Anda, pekerjaannya belum selesai. Truthmark memasang penjaga alur kerja saat penyelesaian yang diikuti agen sebelum serah terima:
72
+ Cara pemanggilan berbeda menurut host. OpenCode menggunakan `/skill truthmark-document`, Antigravity menggunakan `@truthmark-document`, dan host lain yang didukung menggunakan permukaan skill atau perintah garis miring native masing-masing. Lihat [tabel platform](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) untuk perintah yang tepat.
70
73
 
71
- 1. 💻 **Kode:** Agen memodifikasi kode fungsional.
72
- 2. 🧪 **Uji:** Pengujian yang relevan dijalankan.
73
- 3. 🔍 **Periksa:** Truthmark memeriksa dokumentasi yang dipetakan sebagai bagian dari tinjauan akhir yang terpasang.
74
- 4. 📝 **Dokumentasikan:** Dokumen diperbarui oleh agen ketika kebenaran repositori berubah.
75
- 5. 👀 **Tinjau:** Manusia meninjau *diff kode* + *diff kebenaran*.
74
+ Untuk skrip dan integrasi berkelanjutan, berikan platform yang dipilih secara eksplisit:
76
75
 
77
- ## 🛠 Cara Anda berinteraksi dengan Truthmark
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
78
80
 
79
- Truthmark memiliki satu kontrak lokal repositori dengan dua cara pemakaian.
81
+ Pilih `none` secara interaktif atau jalankan `truthmark init --clear-platforms` untuk repositori yang netral terhadap host. Anda dapat menambahkan platform agen nanti dengan menjalankan ulang `truthmark init`.
80
82
 
81
- ### Manusia memasang dan memvalidasi kontrak
83
+ Untuk diagnostik kesegaran relatif terhadap branch, berikan basis Git:
82
84
 
83
- Pemelihara dan CI menggunakan CLI:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
84
88
 
85
- * `truthmark init` - membuat atau menyegarkan konfigurasi, memilih nol atau lebih platform, lalu memasang perutean, scaffold dokumen kebenaran, dan instruksi untuk host AI yang dipilih.
86
- * `truthmark check` - memvalidasi kebenaran repositori dari terminal.
89
+ ## Cara kerja Truthmark
87
90
 
88
- ### Agen mengikuti kontrak saat membuat kode
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Cara kerja Truthmark" width="1440">
94
+ </picture>
89
95
 
90
- Truthmark memasang instruksi lokal repositori untuk host pengodean AI yang didukung seperti Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
96
+ Antarmuka baris perintah Truthmark memasang dan memvalidasi kontrak repositori. Agen pengodean Anda melakukan peninjauan bukti dan pekerjaan dokumentasi melalui alur kerja native host yang telah terpasang.
91
97
 
92
- Alur normalnya sederhana:
98
+ Perubahan kode normal mengikuti satu putaran sederhana:
93
99
 
94
- 1. Minta agen Anda melakukan perubahan kode, atau minta ia mendokumentasikan perilaku yang sudah ada.
95
- 2. Instruksi yang terpasang memberi tahu agen kapan harus menguji, kapan memperbarui dokumen kebenaran, dan kapan berhenti untuk tinjauan manusia.
96
- 3. Anda meninjau diff Git biasa: kode plus perubahan dokumen kebenaran apa pun.
100
+ 1. Agen mengubah kode fungsional.
101
+ 2. Pengujian yang relevan dijalankan.
102
+ 3. Truth Sync memeriksa dokumentasi yang dipetakan.
103
+ 4. Agen membuat atau memperbarui dokumentasi dan perutean saat kebenaran repositori berubah.
104
+ 5. Anda meninjau diff kode dan diff truth secara bersamaan.
97
105
 
98
- Permintaan agen yang dimulai pengguna sengaja dibuat sedikit:
106
+ ## Alur kerja
99
107
 
100
- * `/truthmark-document` - mendokumentasikan perilaku terimplementasi yang sudah ada dari kode dan pengujian.
101
- * `/truthmark-realize` - mengimplementasikan kode dari dokumen kebenaran yang sudah ada.
102
- * `/truthmark-check` - mengaudit kebenaran repositori.
108
+ | Alur kerja | Gunakan saat | Hasil |
109
+ | -------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
110
+ | **Truth Document** | Kode yang sudah ada memerlukan dokumentasi | Membuat atau memperbarui dokumentasi produk dan rekayasa berbasis bukti |
111
+ | **Truth Sync** | Kode fungsional berubah | Menjaga dokumentasi yang dipetakan dan perutean tetap selaras sebelum serah terima |
112
+ | **Truth Structure** | Area baru memerlukan kepemilikan atau dokumentasi yang ada terlalu luas | Membuat rute dengan cakupan jelas dan kerangka dokumen awal |
113
+ | **Truth Realize** | Dokumen truth yang disetujui harus menjadi perangkat lunak yang berfungsi | Memperbarui kode fungsional dari dokumentasi |
114
+ | **Truth Check** | Kebenaran repositori perlu diaudit | Melaporkan masalah perutean, kepemilikan, bukti, dan dokumentasi |
115
+ | **Truthmark Portal** | Tim menginginkan situs dokumentasi yang mudah dijelajahi | Menghasilkan presentasi HTML statis yang di-commit dari dokumen truth Markdown |
103
116
 
104
- Truth Sync bukan cara biasa untuk memulai pekerjaan; itu adalah tinjauan akhir setelah perubahan kode fungsional.
105
- Truth Structure bukan perintah harian; ia memperbaiki perutean atau kepemilikan hanya ketika hal itu memblokir pekerjaan.
117
+ Truthmark memasang alur kerja ini sebagai permukaan repositori native untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
106
118
 
107
119
  ## Yang Anda dapatkan
108
120
 
109
- | Kapabilitas | Apa yang dilakukan |
110
- | --- | --- |
111
- | Kebenaran native Git | Menyimpan kebenaran repositori dalam Markdown dan konfigurasi yang di-commit. |
112
- | Dokumentasi berlingkup branch | Kebenaran bergerak bersama branch alih-alih hidup dalam sesi privat. |
113
- | CLI manusia | Memberi pemelihara perintah penyiapan, penyegaran, validasi, dan inspeksi. |
114
- | Kontrak agen terpasang | Memberi agen panduan native host untuk dokumentasi, realisasi, audit, sinkronisasi akhir, dan perbaikan perutean terbatas. |
115
- | Perutean eksplisit | Memetakan area kode ke dokumen kebenaran kanonis. |
116
- | Serah terima yang dapat ditinjau | Menghasilkan diff Git biasa untuk kode maupun dokumen kebenaran. |
117
- | Operasi lokal terlebih dahulu | Tidak membutuhkan layanan ter-host, daemon, basis data, atau server MCP. |
118
- | Batas tulis yang lebih aman | Memisahkan alur kerja code-first, doc-first, read-only, dan doc-only. |
119
- | Validasi | Melaporkan masalah perutean, otoritas, frontmatter, tautan, permukaan yang dihasilkan, cakupan branch, kesegaran, dan coverage. |
120
- | Portal opsional | Menghasilkan situs presentasi HTML statis yang di-commit dari dokumen kebenaran Markdown ketika diaktifkan dan diminta secara eksplisit. |
121
+ ### Dokumentasi yang berawal dari kenyataan
121
122
 
122
- ## Gambaran visual
123
+ Truthmark dapat membuat dokumentasi untuk kapabilitas produk, perilaku implementasi, antarmuka pemrograman aplikasi, arsitektur, alur kerja, operasi, dan pengujian. Kode dan pengujian menyediakan bukti; dokumen Markdown dengan cakupan jelas mempertahankan hasilnya.
123
124
 
124
- ![Fitur Truthmark](../assets/truthmark-features.png)
125
+ ### Dokumentasi yang bertahan melewati perubahan berikutnya
125
126
 
126
- **Fitur:** apa yang dipasang Truthmark dan bagaimana permukaan alur kerja dibagi.
127
+ Rute menghubungkan area kode ke dokumen kanonis. Saat agen mengubah perilaku, Truth Sync mengetahui tempat kebenaran terkait harus berada dan menjaga serah terima tetap dapat ditinjau.
127
128
 
128
- ![Posisi Truthmark](../assets/truthmark-position.png)
129
+ ### Kebenaran produk dan rekayasa di jalur terpisah
129
130
 
130
- **Posisi:** di mana Truthmark berada relatif terhadap prompt, memori, dan alur kerja spesifikasi.
131
+ Kebenaran produk merekam janji kepada pengguna, batasan, keputusan, dan kriteria penerimaan. Kebenaran rekayasa merekam perilaku saat ini, kontrak, arsitektur, alur kerja, operasi, dan perilaku pengujian.
131
132
 
132
- ![Alur sinkronisasi Truthmark](../assets/truthmark-syncflow.png)
133
+ ### Kolaborasi native Git
133
134
 
134
- **Alur sinkronisasi:** bagaimana Truth Sync menutup perubahan kode normal sebelum serah terima.
135
+ Semua yang penting berada dalam file repositori yang di-commit. Kebenaran mengikuti branch, bekerja dengan pull request biasa, dan tetap terlihat oleh setiap pemelihara serta agen pengodean.
135
136
 
136
- ## Mengapa tim mengadopsinya
137
+ ### Operasi yang mengutamakan lokal
137
138
 
138
- Truthmark ditujukan untuk tim yang sudah tahu bahwa agen AI dapat menghasilkan kode.
139
+ Truthmark tidak memerlukan layanan ter-host, daemon, basis data, penyimpanan vektor, atau server Model Context Protocol. Repositori membawa alur kerja dokumentasinya sendiri.
139
140
 
140
- Masalah berikutnya adalah tata kelola.
141
+ ## Posisi Truthmark
141
142
 
142
- Bukan tata kelola sebagai seremoni. Tata kelola sebagai pertanyaan sederhana:
143
+ | Kebutuhan | Pilihan terbaik |
144
+ | ------------------------------------------------- | ---------------------------- |
145
+ | Output yang lebih baik dari satu sesi agen | Prompt yang lebih baik |
146
+ | Kontinuitas pribadi atau tingkat sesi | Alat memori |
147
+ | Pekerjaan fitur yang dimulai dengan perencanaan | Alur kerja spesifikasi |
148
+ | Dokumentasi berlingkup branch yang mengikuti kode | **Truthmark** |
149
+ | Kebenaran perilaku | Pengujian dan tinjauan kode |
150
+ | Dokumentasi berbantuan AI yang dapat ditinjau | **Truthmark + tinjauan Git** |
143
151
 
144
- > Setelah perubahan berbantuan AI ini, apakah repositori masih mengatakan kebenaran?
152
+ Truthmark dibuat untuk pemelihara dan tim rekayasa yang sudah menggunakan agen pengodean AI dan ingin repositori terus menyampaikan kebenaran secepat kode berubah.
145
153
 
146
- Truthmark membantu tim menjawabnya dengan file yang di-commit, perutean eksplisit, dan diff yang dapat ditinjau.
154
+ ## Host yang didukung dan baris perintah
147
155
 
148
- Ini berguna saat Anda membutuhkan:
156
+ Host agen yang didukung:
149
157
 
150
- - penyimpangan dokumentasi yang lebih kecil
151
- - serah terima yang lebih baik
152
- - kebenaran produk khusus branch
153
- - dokumentasi arsitektur dan API yang tahan lama
154
- - kepemilikan eksplisit antara dokumen dan kode
155
- - batas tulis agen yang lebih aman
156
- - dokumentasi yang dapat ditinjau alih-alih memori tersembunyi
157
- - alur kerja AI yang tetap bekerja dari file repositori yang di-commit
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
158
164
 
159
- ## Di mana Truthmark cocok
165
+ <details>
166
+ <summary>Referensi baris perintah</summary>
160
167
 
161
- Truthmark tidak menggantikan prompt, memori, spesifikasi, pengujian, atau tinjauan kode.
168
+ | Perintah | Tujuan |
169
+ | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Membuat atau menyegarkan konfigurasi, perutean, template, dan alur kerja host yang dipilih |
171
+ | `truthmark check [--base <ref>]` | Memvalidasi kebenaran repositori dan secara opsional menjalankan diagnostik kesegaran branch |
172
+ | `truthmark index --json` | Memeriksa metadata turunan repositori dan perutean |
173
+ | `truthmark impact --base <ref> --json` | Memetakan file yang berubah ke dokumentasi, pemilik, dan pengujian terdekat |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Memeriksa penerapan dan target alur kerja |
175
+ | `truthmark validate ...` | Memvalidasi laporan alur kerja dan sewa penulisan |
176
+ | `truthmark uninstall --dry-run\|--apply` | Meninjau atau menghapus permukaan host yang dihasilkan sambil mempertahankan truth yang ditulis pengguna |
162
177
 
163
- Ia memberi alur kerja tersebut tempat yang tahan lama untuk mendarat di Git.
178
+ Output JSON terstruktur tersedia di seluruh antarmuka baris perintah untuk skrip dan integrasi berkelanjutan.
164
179
 
165
- | Kebutuhan | Lebih cocok |
166
- | --- | --- |
167
- | Output lebih baik dari satu sesi agen | Prompt yang lebih baik |
168
- | Kontinuitas pribadi atau tingkat sesi | Alat memori |
169
- | Pekerjaan fitur yang dimulai dengan rencana | Alur kerja spesifikasi |
170
- | Truth berlingkup branch yang ikut bersama kode | Truthmark |
171
- | Memvalidasi kebenaran perilaku | Pengujian dan tinjauan |
172
- | Meninjau perubahan dokumentasi berbantuan AI | Truthmark plus tinjauan Git |
180
+ </details>
173
181
 
174
- Jalur Truthmark sengaja dirancang sempit:
175
-
176
- ```text
177
- make repository truth explicit
178
- route it to code
179
- memasang panduan agen di sekelilingnya
180
- keep the result reviewable in Git
181
- ```
182
+ ## Pelajari lebih lanjut
182
183
 
183
- ## Pelajari lebih dalam
184
+ - [Panduan pengguna Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Indeks dokumentasi](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Ikhtisar arsitektur](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Kontrak konfigurasi, perutean, dan perintah](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Berkontribusi](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
184
189
 
185
- README adalah etalase: konteks cepat, mulai cepat, dan model mental inti.
186
-
187
- Untuk penggunaan per perintah, perbandingan permukaan, detail platform yang didukung, konfigurasi, perutean, Portal, dan contoh, baca [Panduan Pengguna Truthmark](../user-guide.md).
188
-
189
- ## Status proyek
190
-
191
- Rilis saat ini menyediakan:
192
-
193
- - perintah CLI lokal untuk init, check, index, impact, dan status alur kerja
194
- - instruksi agen lokal repositori yang dihasilkan untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor
195
- - diagnostik perutean, otoritas, frontmatter, tautan, kesegaran, permukaan yang dihasilkan, cakupan branch, dan coverage
196
- - dokumen kebenaran berlingkup branch dan artefak kecerdasan repositori turunan
197
-
198
- ## Dokumentasi
199
-
200
- - [Panduan pengguna](../user-guide.md)
201
- - [Indeks dokumen](../README.md)
202
- - [Ikhtisar arsitektur](../truthmark/engineering/architecture/overview.md)
203
- - [Kontrak API dan CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
204
- - [Panduan pemeliharaan kebenaran repositori](../standards/maintaining-repository-truth.md)
205
-
206
- Untuk perintah pengembangan lokal dan kontribusi, lihat [CONTRIBUTING.md](../../CONTRIBUTING.md).
207
-
208
- ## Batas desain
209
-
210
- Truthmark sengaja kecil: lokal, di-commit, berlingkup branch, dan dapat ditinjau.
211
-
212
- Ini bukan layanan ter-host, server MCP, basis data vektor, lapisan memori tersembunyi, produk penegakan CI, atau mesin penulisan ulang kode otonom. Ini membantu kebenaran repositori tetap terlihat; tidak menggantikan pengujian, tinjauan kode, atau penilaian manusia.
190
+ **Pasang Truthmark, pilih host pengodean Anda, dan ubah satu perilaku nyata menjadi dokumentasi hari ini.**
213
191
 
214
192
  ## Lisensi
215
193
 
216
194
  MIT. Lihat [LICENSE](../../LICENSE).
217
-
218
- ## Penghapusan aman
219
-
220
- Gunakan `truthmark uninstall --dry-run` untuk meninjau permukaan host yang tepat dihasilkan, lalu `truthmark uninstall --apply` untuk menghapusnya. Truth hasil penulisan, konfigurasi, template, keluaran Portal, berkas Gemini, dan berkas pengguna yang tidak terkait akan tetap dipertahankan; hapus instalasi npm global secara terpisah melalui pengelola paket Anda.