truthmark 2.2.3 → 2.2.5

package/docs/readmes/README.fr.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Vos agents écrivent du code. Truthmark maintient une documentation destinée aux humains et vérifiable dans Git.**
+
+[🇺🇸 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)
+
+![Bannière Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Démarrage rapide : exécution locale en cinq minutes
+
+Exécutez ceci dans le dépôt Git que vous voulez faire gérer par Truthmark :
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Activez l’hôte d’IA que vous utilisez réellement. Les nouvelles configurations sont neutres vis-à-vis des hôtes ; ajoutez donc une liste `platforms` de premier niveau à `.truthmark/config.yml` avant l’initialisation :
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Installez ensuite les documents de vérité locaux au dépôt, le routage et les surfaces de workflow pour agents :
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Essayez maintenant le chemin d’adoption le plus courant : documenter, à partir du code et des tests, un comportement existant. Dans votre hôte de codage IA, demandez au workflow installé :
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+Après cela, les utilisateurs ne devraient normalement pas invoquer Truth Sync directement. Continuez à coder dans votre hôte d’IA ; les instructions installées dans le dépôt indiquent à l’agent d’exécuter les tests pertinents et d’effectuer la revue Truth Sync avant la remise lorsqu’il y a des changements de code fonctionnel. Vous examinez le diff de code obtenu ainsi que le diff des documents de vérité.
+
+Si vous voulez seulement la validation CLI et ne voulez pas encore de workflows IA propres à un hôte, laissez `platforms` omis et exécutez `truthmark init && truthmark check` ; vous pourrez ajouter une plateforme plus tard et relancer `truthmark init`.
+
+## 💡 Le problème : l’écart de documentation avec l’IA
+
+Les agents de codage IA sont incroyablement efficaces pour écrire du code rapidement. Mais cette vitesse crée un nouveau mode de défaillance dangereux : **le récit du dépôt s’éloigne de la réalité.**
+
+* Les comportements se perdent dans des historiques de discussion éphémères.
+* Les documents d’architecture deviennent vite obsolètes.
+* Les décisions produit disparaissent après la remise.
+* Les réviseurs de code se retrouvent face à des diffs de code bruts sans comprendre le « pourquoi ».
+* Chaque nouvelle session IA est contrainte de redécouvrir la vérité de votre dépôt depuis zéro.
+
+## 🎯 La solution : Truthmark
+
+**Truthmark** installe dans votre dépôt une couche de workflow native Git. Il corrige la partie du développement avec l’IA qui casse généralement : aider la documentation à rester alignée sur le code.
+
+Au lieu d’espérer que les humains et les agents IA se souviennent de mettre les docs à jour, Truthmark transforme la documentation en habitude systématique et vérifiable directement dans votre dépôt.
+
+### ✨ Pourquoi Truthmark est unique
+
+Truthmark n’est pas simplement un autre outil de documentation. Il est profondément intégré au workflow IA :
+
+* **🚫 Zéro dépendance fournisseur :** aucun service hébergé, aucune base de données cachée, aucun serveur supplémentaire à exploiter.
+* **🌳 100 % natif Git :** tout vit dans votre dépôt. La vérité se déplace avec votre branche.
+* **🤝 Contrat possédé par les humains, suivi par les agents :** Les mainteneurs possèdent le contrat du dépôt ; les agents suivent les instructions installées pendant qu’ils codent.
+* **✅ Confiance par la vérification :** le travail de l’IA devient plus facile à faire confiance, car tout travail qui change le comportement inclut une décision ou un diff de document de vérité vérifiable par un humain.
+
+## 🔄 Fonctionnement
+
+Lorsqu’un agent IA modifie votre code, le travail n’est pas terminé. Truthmark installe une garde de workflow de fin de tâche que les agents suivent avant la remise :
+
+1. 💻 **Code :** l’agent modifie le code fonctionnel.
+2. 🧪 **Test :** les tests pertinents sont exécutés.
+3. 🔍 **Vérifier :** Truthmark vérifie la documentation mappée dans le cadre de la revue de fin installée.
+4. 📝 **Documentation :** les docs sont mises à jour par l’agent lorsque la vérité du dépôt a changé.
+5. 👀 **Revue :** un humain examine le *diff de code* + le *diff de vérité*.
+
+## 🛠 Comment vous utilisez Truthmark
+
+Truthmark fournit un contrat local au dépôt, avec deux façons de l’utiliser.
+
+### Les humains installent et valident le contrat
+
+Les mainteneurs et la CI utilisent la CLI :
+
+* `truthmark config` - crée la configuration initiale.
+* `truthmark init` - installe ou actualise le routage, les échafaudages de documents de vérité et les instructions pour les hôtes IA.
+* `truthmark check` - valide la vérité du dépôt depuis le terminal.
+
+### Les agents suivent le contrat pendant qu’ils codent
+
+Truthmark installe des instructions locales au dépôt pour les hôtes de codage IA pris en charge, comme Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity et Cursor.
+
+La boucle normale est simple :
+
+1. Demandez à votre agent de modifier du code ou de documenter un comportement existant.
+2. Les instructions installées indiquent à l’agent quand tester, quand mettre à jour les documents de vérité et quand s’arrêter pour une revue humaine.
+3. Vous relisez des diffs Git ordinaires : le code plus les éventuels changements de documents de vérité.
+
+Les demandes agent lancées par l’utilisateur restent volontairement peu nombreuses :
+
+* `/truthmark-document` - documente un comportement implémenté existant à partir du code et des tests.
+* `/truthmark-realize` - implémente le code à partir de documents de vérité existants.
+* `/truthmark-check` - audite la vérité du dépôt.
+
+Truth Sync n’est pas la façon habituelle de commencer un travail ; c’est la revue de fin après des changements de code fonctionnel.
+Truth Structure n’est pas une commande quotidienne ; elle répare le routage ou la propriété uniquement lorsque cela bloque le travail.
+
+## Ce que vous obtenez
+
+| Capacité | Ce qu’elle fait |
+| --- | --- |
+| Vérité native Git | Conserve la vérité du dépôt dans du Markdown et de la configuration commités. |
+| Documentation limitée à la branche | La vérité se déplace avec la branche au lieu de vivre dans une session privée. |
+| CLI humaine | Fournit aux mainteneurs des commandes de configuration, d’actualisation, de validation et d’inspection. |
+| Guidance agent installée | Indique aux agents de codage quand documenter, tester, synchroniser la vérité, auditer ou s’arrêter pour revue. |
+| Routage explicite | Mappe les zones de code vers des documents de vérité canoniques. |
+| Remises vérifiables | Produit des diffs Git ordinaires pour le code comme pour les documents de vérité. |
+| Fonctionnement local d’abord | Ne nécessite aucun service hébergé, démon, base de données ni serveur MCP. |
+| Limites d’écriture plus sûres | Sépare les workflows code-first, doc-first, read-only et doc-only. |
+| Validation | Signale les problèmes de routage, d’autorité, de frontmatter, de liens, de surfaces générées, de portée de branche, de fraîcheur et de couverture. |
+| Portal optionnel | Génère, lorsqu’il est explicitement activé et demandé, un site de présentation HTML statique commité à partir des documents de vérité Markdown. |
+
+## Aperçu visuel
+
+![Fonctionnalités Truthmark](../assets/truthmark-features.png)
+
+**Fonctionnalités :** ce que Truthmark installe et comment les agents utilisent les instructions locales au dépôt.
+
+![Position de Truthmark](../assets/truthmark-position.png)
+
+**Position :** où Truthmark se situe par rapport aux prompts, à la mémoire et aux workflows de spécification.
+
+![Flux de synchronisation Truthmark](../assets/truthmark-syncflow.png)
+
+**Flux de synchronisation :** comment Truth Sync conclut les changements de code ordinaires avant la remise.
+
+## Pourquoi les équipes l’adoptent
+
+Truthmark s’adresse aux équipes qui savent déjà que les agents IA peuvent générer du code.
+
+Le prochain problème est la gouvernance.
+
+Pas la gouvernance comme cérémonie. La gouvernance comme une question simple :
+
+> Après ce changement assisté par l’IA, le dépôt dit-il encore la vérité ?
+
+Truthmark aide les équipes à y répondre avec des fichiers commités, un routage explicite et des diffs vérifiables.
+
+Il est utile lorsque vous avez besoin de :
+
+- moins de dérive documentaire
+- meilleures remises
+- vérité produit spécifique à la branche
+- documentation d’architecture et d’API durable
+- propriété explicite entre docs et code
+- limites d’écriture d’agents plus sûres
+- documentation vérifiable plutôt que mémoire cachée
+- une guidance agent qui fonctionne toujours depuis des fichiers commités dans le dépôt
+
+## Où Truthmark se situe
+
+Truthmark ne remplace pas les prompts, la mémoire, les spécifications, les tests ni la revue de code.
+
+Il donne à ces workflows un endroit durable où atterrir dans Git.
+
+| Besoin | Meilleur choix |
+| --- | --- |
+| Meilleure sortie d’une session d’agent | Meilleur prompt |
+| Continuité personnelle ou au niveau de la session | Outil de mémoire |
+| Travail fonctionnel planifié d’abord | Workflow de spécification |
+| Vérité limitée à une branche qui voyage avec le code | Truthmark |
+| Validation de la correction du comportement | Tests et revue |
+| Revue de changements de documentation assistés par l’IA | Truthmark plus revue Git |
+
+Le périmètre de Truthmark est étroit par conception :
+
+```text
+make repository truth explicit
+route it to code
+installer une guidance agent autour d’elle
+keep the result reviewable in Git
+```
+
+## Aller plus loin
+
+Le README est la vitrine : contexte rapide, démarrage rapide et modèle mental central.
+
+Pour l’utilisation commande par commande, les comparaisons de surfaces, les détails des plateformes prises en charge, la configuration, le routage, Portal et des exemples, lisez le [guide d’utilisation Truthmark](../user-guide.md).
+
+## État du projet
+
+La version actuelle fournit :
+
+- des commandes CLI locales pour config, init, check, index, impact et l’état des workflows
+- instructions agent locales au dépôt générées pour Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity et Cursor
+- des diagnostics de routage, d’autorité, de frontmatter, de liens, de fraîcheur, de surfaces générées, de portée de branche et de couverture
+- des documents de vérité limités à la branche et des artefacts dérivés d’intelligence du dépôt
+
+## Documentation
+
+- [Guide d’utilisation](../user-guide.md)
+- [Index des docs](../README.md)
+- [Vue d’ensemble de l’architecture](../truthmark/engineering/architecture/overview.md)
+- [Contrats API et CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Guide de maintenance de la vérité du dépôt](../standards/maintaining-repository-truth.md)
+
+Pour les commandes de développement local et de contribution, consultez [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Limites de conception
+
+Truthmark est volontairement petit : local, commité, limité à la branche et vérifiable.
+
+Ce n’est pas un service hébergé, un serveur MCP, une base de données vectorielle, une couche de mémoire cachée, un produit d’application CI ni un moteur autonome de réécriture de code. Il aide la vérité du dépôt à rester visible ; il ne remplace pas les tests, la revue de code ni le jugement humain.
+
+## Licence
+
+MIT. Voir [LICENSE](../../LICENSE).

package/docs/readmes/README.id.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Agen Anda menulis kode. Truthmark memelihara dokumentasi yang ditujukan untuk manusia dan dapat ditinjau melalui Git.**
+
+[🇺🇸 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)
+
+![Banner Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Mulai cepat: berjalan lokal dalam lima menit
+
+Jalankan ini di dalam repositori Git yang ingin Anda kelola dengan Truthmark:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Aktifkan host AI yang benar-benar Anda gunakan. Konfigurasi baru bersifat netral terhadap host, jadi tambahkan daftar `platforms` tingkat atas ke `.truthmark/config.yml` sebelum inisialisasi:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Kemudian pasang dokumen kebenaran lokal repositori, perutean, dan permukaan alur kerja agen:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+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:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+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.
+
+Jika Anda hanya menginginkan validasi CLI dan belum menginginkan alur kerja AI khusus host, biarkan `platforms` tidak dicantumkan dan jalankan `truthmark init && truthmark check`; Anda dapat menambahkan platform nanti dan menjalankan ulang `truthmark init`.
+
+## 💡 Masalah: kesenjangan dokumentasi AI
+
+Agen pengodean AI luar biasa dalam menulis kode dengan cepat. Namun kecepatan ini menciptakan mode kegagalan baru yang berbahaya: **cerita repositori menyimpang dari kenyataan.**
+
+* Perilaku hilang dalam riwayat chat yang sementara.
+* Dokumen arsitektur cepat tertinggal.
+* Keputusan produk lenyap setelah serah terima.
+* Peninjau kode dibiarkan memeriksa diff kode mentah tanpa memahami "mengapa".
+* Setiap sesi AI baru dipaksa menemukan ulang kebenaran repositori Anda dari awal.
+
+## 🎯 Solusi: Truthmark
+
+**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.
+
+Alih-alih berharap manusia dan agen AI ingat memperbarui dokumen, Truthmark menjadikan dokumentasi sebagai kebiasaan sistematis dan dapat ditinjau langsung di dalam repositori Anda.
+
+### ✨ Mengapa Truthmark unik
+
+Truthmark bukan sekadar alat dokumentasi lain. Ia terintegrasi mendalam ke dalam alur kerja AI:
+
+* **🚫 Tanpa ketergantungan vendor:** Tidak ada layanan ter-host, tidak ada basis data tersembunyi, tidak ada server tambahan untuk dioperasikan.
+* **🌳 100% native Git:** Semuanya hidup di repositori Anda. Kebenaran bergerak bersama branch Anda.
+* **🤝 Kontrak yang dimiliki manusia dan diikuti agen:** Pemelihara memiliki kontrak repositori; agen mengikuti instruksi yang terpasang saat membuat kode.
+* **✅ Kepercayaan melalui verifikasi:** Pekerjaan AI menjadi lebih mudah dipercaya karena pekerjaan yang mengubah perilaku menyertakan keputusan atau diff dokumen kebenaran yang dapat ditinjau manusia.
+
+## 🔄 Cara kerjanya
+
+Ketika agen AI memodifikasi kode Anda, pekerjaannya belum selesai. Truthmark memasang penjaga alur kerja saat penyelesaian yang diikuti agen sebelum serah terima:
+
+1. 💻 **Kode:** Agen memodifikasi kode fungsional.
+2. 🧪 **Uji:** Pengujian yang relevan dijalankan.
+3. 🔍 **Periksa:** Truthmark memeriksa dokumentasi yang dipetakan sebagai bagian dari tinjauan akhir yang terpasang.
+4. 📝 **Dokumentasikan:** Dokumen diperbarui oleh agen ketika kebenaran repositori berubah.
+5. 👀 **Tinjau:** Manusia meninjau *diff kode* + *diff kebenaran*.
+
+## 🛠 Cara Anda berinteraksi dengan Truthmark
+
+Truthmark memiliki satu kontrak lokal repositori dengan dua cara pemakaian.
+
+### Manusia memasang dan memvalidasi kontrak
+
+Pemelihara dan CI menggunakan CLI:
+
+* `truthmark config` - membuat konfigurasi awal.
+* `truthmark init` - memasang atau menyegarkan perutean, scaffold dokumen kebenaran, dan instruksi host AI.
+* `truthmark check` - memvalidasi kebenaran repositori dari terminal.
+
+### Agen mengikuti kontrak saat membuat kode
+
+Truthmark memasang instruksi lokal repositori untuk host pengodean AI yang didukung seperti Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
+
+Alur normalnya sederhana:
+
+1. Minta agen Anda melakukan perubahan kode, atau minta ia mendokumentasikan perilaku yang sudah ada.
+2. Instruksi yang terpasang memberi tahu agen kapan harus menguji, kapan memperbarui dokumen kebenaran, dan kapan berhenti untuk tinjauan manusia.
+3. Anda meninjau diff Git biasa: kode plus perubahan dokumen kebenaran apa pun.
+
+Permintaan agen yang dimulai pengguna sengaja dibuat sedikit:
+
+* `/truthmark-document` - mendokumentasikan perilaku terimplementasi yang sudah ada dari kode dan pengujian.
+* `/truthmark-realize` - mengimplementasikan kode dari dokumen kebenaran yang sudah ada.
+* `/truthmark-check` - mengaudit kebenaran repositori.
+
+Truth Sync bukan cara biasa untuk memulai pekerjaan; itu adalah tinjauan akhir setelah perubahan kode fungsional.
+Truth Structure bukan perintah harian; ia memperbaiki perutean atau kepemilikan hanya ketika hal itu memblokir pekerjaan.
+
+## Yang Anda dapatkan
+
+| Kapabilitas | Apa yang dilakukan |
+| --- | --- |
+| Kebenaran native Git | Menyimpan kebenaran repositori dalam Markdown dan konfigurasi yang di-commit. |
+| Dokumentasi berlingkup branch | Kebenaran bergerak bersama branch alih-alih hidup dalam sesi privat. |
+| CLI manusia | Memberi pemelihara perintah penyiapan, penyegaran, validasi, dan inspeksi. |
+| Kontrak agen terpasang | Memberi agen panduan native host untuk dokumentasi, realisasi, audit, sinkronisasi akhir, dan perbaikan perutean terbatas. |
+| Perutean eksplisit | Memetakan area kode ke dokumen kebenaran kanonis. |
+| Serah terima yang dapat ditinjau | Menghasilkan diff Git biasa untuk kode maupun dokumen kebenaran. |
+| Operasi lokal terlebih dahulu | Tidak membutuhkan layanan ter-host, daemon, basis data, atau server MCP. |
+| Batas tulis yang lebih aman | Memisahkan alur kerja code-first, doc-first, read-only, dan doc-only. |
+| Validasi | Melaporkan masalah perutean, otoritas, frontmatter, tautan, permukaan yang dihasilkan, cakupan branch, kesegaran, dan coverage. |
+| Portal opsional | Menghasilkan situs presentasi HTML statis yang di-commit dari dokumen kebenaran Markdown ketika diaktifkan dan diminta secara eksplisit. |
+
+## Gambaran visual
+
+![Fitur Truthmark](../assets/truthmark-features.png)
+
+**Fitur:** apa yang dipasang Truthmark dan bagaimana permukaan alur kerja dibagi.
+
+![Posisi Truthmark](../assets/truthmark-position.png)
+
+**Posisi:** di mana Truthmark berada relatif terhadap prompt, memori, dan alur kerja spesifikasi.
+
+![Alur sinkronisasi Truthmark](../assets/truthmark-syncflow.png)
+
+**Alur sinkronisasi:** bagaimana Truth Sync menutup perubahan kode normal sebelum serah terima.
+
+## Mengapa tim mengadopsinya
+
+Truthmark ditujukan untuk tim yang sudah tahu bahwa agen AI dapat menghasilkan kode.
+
+Masalah berikutnya adalah tata kelola.
+
+Bukan tata kelola sebagai seremoni. Tata kelola sebagai pertanyaan sederhana:
+
+> Setelah perubahan berbantuan AI ini, apakah repositori masih mengatakan kebenaran?
+
+Truthmark membantu tim menjawabnya dengan file yang di-commit, perutean eksplisit, dan diff yang dapat ditinjau.
+
+Ini berguna saat Anda membutuhkan:
+
+- penyimpangan dokumentasi yang lebih kecil
+- serah terima yang lebih baik
+- kebenaran produk khusus branch
+- dokumentasi arsitektur dan API yang tahan lama
+- kepemilikan eksplisit antara dokumen dan kode
+- batas tulis agen yang lebih aman
+- dokumentasi yang dapat ditinjau alih-alih memori tersembunyi
+- alur kerja AI yang tetap bekerja dari file repositori yang di-commit
+
+## Di mana Truthmark cocok
+
+Truthmark tidak menggantikan prompt, memori, spesifikasi, pengujian, atau tinjauan kode.
+
+Ia memberi alur kerja tersebut tempat yang tahan lama untuk mendarat di Git.
+
+| Kebutuhan | Lebih cocok |
+| --- | --- |
+| Output lebih baik dari satu sesi agen | Prompt yang lebih baik |
+| Kontinuitas pribadi atau tingkat sesi | Alat memori |
+| Pekerjaan fitur yang dimulai dengan rencana | Alur kerja spesifikasi |
+| Truth berlingkup branch yang ikut bersama kode | Truthmark |
+| Memvalidasi kebenaran perilaku | Pengujian dan tinjauan |
+| Meninjau perubahan dokumentasi berbantuan AI | Truthmark plus tinjauan Git |
+
+Jalur Truthmark sengaja dirancang sempit:
+
+```text
+make repository truth explicit
+route it to code
+memasang panduan agen di sekelilingnya
+keep the result reviewable in Git
+```
+
+## Pelajari lebih dalam
+
+README adalah etalase: konteks cepat, mulai cepat, dan model mental inti.
+
+Untuk penggunaan per perintah, perbandingan permukaan, detail platform yang didukung, konfigurasi, perutean, Portal, dan contoh, baca [Panduan Pengguna Truthmark](../user-guide.md).
+
+## Status proyek
+
+Rilis saat ini menyediakan:
+
+- perintah CLI lokal untuk config, init, check, index, impact, dan status alur kerja
+- instruksi agen lokal repositori yang dihasilkan untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor
+- diagnostik perutean, otoritas, frontmatter, tautan, kesegaran, permukaan yang dihasilkan, cakupan branch, dan coverage
+- dokumen kebenaran berlingkup branch dan artefak kecerdasan repositori turunan
+
+## Dokumentasi
+
+- [Panduan pengguna](../user-guide.md)
+- [Indeks dokumen](../README.md)
+- [Ikhtisar arsitektur](../truthmark/engineering/architecture/overview.md)
+- [Kontrak API dan CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Panduan pemeliharaan kebenaran repositori](../standards/maintaining-repository-truth.md)
+
+Untuk perintah pengembangan lokal dan kontribusi, lihat [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Batas desain
+
+Truthmark sengaja kecil: lokal, di-commit, berlingkup branch, dan dapat ditinjau.
+
+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.
+
+## Lisensi
+
+MIT. Lihat [LICENSE](../../LICENSE).

package/docs/readmes/README.it.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**I tuoi agenti scrivono codice. Truthmark mantiene documentazione pensata per le persone e revisionabile in Git.**
+
+[🇺🇸 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)
+
+![Banner di Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Avvio rapido: eseguirlo localmente in cinque minuti
+
+Esegui questo comando nel repository Git che vuoi far gestire a Truthmark:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Abilita l’host IA che usi davvero. Le nuove configurazioni sono neutrali rispetto all’host, quindi aggiungi un elenco `platforms` di primo livello a `.truthmark/config.yml` prima dell’inizializzazione:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Poi installa i documenti di verità locali al repository, il routing e le superfici di workflow per agenti:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Ora prova il percorso di adozione più comune: documentare un comportamento esistente a partire da codice e test. Nel tuo host di coding IA, chiedi al workflow installato:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+Dopo questo, di norma gli utenti non dovrebbero invocare Truth Sync direttamente. Continua a scrivere codice tramite il tuo host IA; le istruzioni installate nel repository dicono all’agente di eseguire i test pertinenti e svolgere la revisione Truth Sync prima della consegna quando cambiano parti di codice funzionale. Tu revisioni il diff di codice risultante insieme al diff dei documenti di verità.
+
+Se vuoi solo la validazione CLI e non vuoi ancora workflow IA specifici per un host, lascia `platforms` omesso ed esegui `truthmark init && truthmark check`; potrai aggiungere una piattaforma più tardi e rieseguire `truthmark init`.
+
+## 💡 Il problema: il divario di documentazione dell’IA
+
+Gli agenti di coding IA sono straordinari nello scrivere codice rapidamente. Ma questa velocità crea una nuova modalità di errore pericolosa: **la storia del repository si allontana dalla realtà.**
+
+* Il comportamento si perde in cronologie chat effimere.
+* I documenti di architettura restano rapidamente indietro.
+* Le decisioni di prodotto scompaiono dopo la consegna.
+* I revisori del codice si ritrovano a esaminare diff di codice grezzi senza capire il “perché”.
+* Ogni nuova sessione IA è costretta a riscoprire da zero la verità del repository.
+
+## 🎯 La soluzione: Truthmark
+
+**Truthmark** installa nel tuo repository un livello di workflow nativo di Git. Risolve la parte dello sviluppo con IA che di solito si rompe: aiutare la documentazione a restare allineata al codice.
+
+Invece di sperare che persone e agenti IA si ricordino di aggiornare la documentazione, Truthmark rende la documentazione un’abitudine sistematica e revisionabile direttamente nel repository.
+
+### ✨ Perché Truthmark è unico
+
+Truthmark non è semplicemente un altro strumento di documentazione. È profondamente integrato nel workflow IA:
+
+* **🚫 Nessun lock-in del fornitore:** nessun servizio ospitato, nessun database nascosto, nessun server aggiuntivo da gestire.
+* **🌳 100% nativo di Git:** tutto vive nel tuo repository. La verità si muove con il tuo branch.
+* **🤝 Contratto posseduto dagli umani e seguito dagli agenti:** I maintainer possiedono il contratto del repository; gli agenti seguono le istruzioni installate mentre scrivono codice.
+* **✅ Fiducia tramite verifica:** il lavoro dell’IA diventa più facile da fidare perché il lavoro che cambia comportamento include una decisione o un diff di documento di verità revisionabile da una persona.
+
+## 🔄 Come funziona
+
+Quando un agente IA modifica il tuo codice, il lavoro non è finito. Truthmark installa una protezione di workflow a fine attività che gli agenti seguono prima della consegna:
+
+1. 💻 **Codice:** l’agente modifica codice funzionale.
+2. 🧪 **Test:** vengono eseguiti i test pertinenti.
+3. 🔍 **Controllo:** Truthmark controlla la documentazione mappata come parte della revisione finale installata.
+4. 📝 **Documentazione:** i docs vengono aggiornati dall’agente quando la verità del repository è cambiata.
+5. 👀 **Revisione:** una persona revisiona il *diff di codice* + il *diff di verità*.
+
+## 🛠 Come interagisci con Truthmark
+
+Truthmark ha un contratto locale al repository e due modi per usarlo.
+
+### Gli esseri umani installano e validano il contratto
+
+Maintainer e CI usano la CLI:
+
+* `truthmark config` - crea la configurazione iniziale.
+* `truthmark init` - installa o aggiorna routing, scaffold dei documenti di verità e istruzioni per host IA.
+* `truthmark check` - valida la verità del repository dal terminale.
+
+### Gli agenti seguono il contratto mentre scrivono codice
+
+Truthmark installa istruzioni locali al repository per host di coding IA supportati come Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
+
+Il ciclo normale è semplice:
+
+1. Chiedi al tuo agente una modifica al codice o di documentare un comportamento esistente.
+2. Le istruzioni installate dicono all’agente quando testare, quando aggiornare i documenti di verità e quando fermarsi per la revisione umana.
+3. Tu revisioni normali diff Git: codice più eventuali modifiche ai documenti di verità.
+
+Le richieste agente avviate dall’utente sono intenzionalmente poche:
+
+* `/truthmark-document` - documenta comportamento implementato esistente da codice e test.
+* `/truthmark-realize` - implementa codice da documenti di verità esistenti.
+* `/truthmark-check` - audita la verità del repository.
+
+Truth Sync non è il modo abituale per iniziare il lavoro; è la revisione finale dopo modifiche funzionali al codice.
+Truth Structure non è un comando quotidiano; ripara routing o ownership solo quando ciò blocca il lavoro.
+
+## Cosa ottieni
+
+| Capacità | Cosa fa |
+| --- | --- |
+| Verità nativa di Git | Mantiene la verità del repository in Markdown e configurazione committati. |
+| Documentazione con ambito di branch | La verità si muove con il branch invece di vivere in una sessione privata. |
+| CLI umana | Offre ai maintainer comandi di setup, aggiornamento, validazione e ispezione. |
+| Guida agente installata | Dice agli agenti di coding quando documentare, testare, sincronizzare la verità, auditare o fermarsi per revisione. |
+| Routing esplicito | Mappa aree di codice a documenti di verità canonici. |
+| Consegne revisionabili | Produce normali diff Git sia per il codice sia per i documenti di verità. |
+| Operatività local-first | Non richiede servizi ospitati, daemon, database o server MCP. |
+| Confini di scrittura più sicuri | Separa workflow code-first, doc-first, read-only e doc-only. |
+| Validazione | Segnala problemi di routing, autorità, frontmatter, link, superfici generate, ambito di branch, freschezza e copertura. |
+| Portal opzionale | Genera, quando esplicitamente abilitato e richiesto, un sito statico HTML committato a partire da documenti di verità Markdown. |
+
+## Panoramica visiva
+
+![Funzionalità di Truthmark](../assets/truthmark-features.png)
+
+**Funzionalità:** cosa installa Truthmark e come è divisa la superficie di workflow.
+
+![Posizione di Truthmark](../assets/truthmark-position.png)
+
+**Posizione:** dove Truthmark si colloca rispetto a prompt, memoria e workflow di specifica.
+
+![Flusso di sincronizzazione di Truthmark](../assets/truthmark-syncflow.png)
+
+**Flusso di sincronizzazione:** come Truth Sync conclude le normali modifiche di codice prima della consegna.
+
+## Perché i team lo adottano
+
+Truthmark è per team che sanno già che gli agenti IA possono generare codice.
+
+Il problema successivo è la governance.
+
+Non governance come cerimonia. Governance come una semplice domanda:
+
+> Dopo questa modifica assistita dall’IA, il repository dice ancora la verità?
+
+Truthmark aiuta i team a rispondere con file committati, routing esplicito e diff revisionabili.
+
+È utile quando hai bisogno di:
+
+- meno deriva della documentazione
+- consegne migliori
+- verità di prodotto specifica per branch
+- documentazione durevole di architettura e API
+- ownership esplicita tra docs e codice
+- confini di scrittura degli agenti più sicuri
+- documentazione revisionabile invece di memoria nascosta
+- guida agente che funziona ancora da file committati nel repository
+
+## Dove si colloca Truthmark
+
+Truthmark non sostituisce prompt, memoria, specifiche, test o code review.
+
+Offre a questi workflow un luogo durevole in cui atterrare in Git.
+
+| Esigenza | Scelta migliore |
+| --- | --- |
+| Output migliore da una sessione di agente | Prompt migliore |
+| Continuità personale o a livello di sessione | Strumento di memoria |
+| Lavoro su funzionalità guidato prima da un piano | Workflow di specifica |
+| Verità con ambito di branch che viaggia con il codice | Truthmark |
+| Validare la correttezza del comportamento | Test e revisione |
+| Revisionare modifiche di documentazione assistite dall’IA | Truthmark più revisione Git |
+
+La corsia di Truthmark è stretta per progettazione:
+
+```text
+make repository truth explicit
+route it to code
+installare guida agente intorno a essa
+keep the result reviewable in Git
+```
+
+## Approfondisci
+
+Il README è la vetrina: contesto rapido, avvio rapido e il modello mentale centrale.
+
+Per l’uso comando per comando, confronti tra superfici, dettagli sulle piattaforme supportate, configurazione, routing, Portal ed esempi, leggi la [guida utente di Truthmark](../user-guide.md).
+
+## Stato del progetto
+
+La release attuale fornisce:
+
+- comandi CLI locali per config, init, check, index, impact e stato dei workflow
+- istruzioni agente locali al repository generate per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
+- diagnostica su routing, autorità, frontmatter, link, freschezza, superfici generate, ambito di branch e copertura
+- documenti di verità con ambito di branch e artefatti derivati di intelligence del repository
+
+## Documentazione
+
+- [Guida utente](../user-guide.md)
+- [Indice docs](../README.md)
+- [Panoramica dell’architettura](../truthmark/engineering/architecture/overview.md)
+- [Contratti API e CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Guida alla manutenzione della verità del repository](../standards/maintaining-repository-truth.md)
+
+Per i comandi di sviluppo locale e contribuzione, vedi [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Confini di progettazione
+
+Truthmark è intenzionalmente piccolo: locale, committato, con ambito di branch e revisionabile.
+
+Non è un servizio ospitato, un server MCP, un database vettoriale, un livello di memoria nascosto, un prodotto di enforcement CI o un motore autonomo di riscrittura del codice. Aiuta la verità del repository a restare visibile; non sostituisce test, code review o giudizio umano.
+
+## Licenza
+
+MIT. Vedi [LICENSE](../../LICENSE).