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
- **I tuoi agenti scrivono codice. Truthmark mantiene documentazione pensata per le persone e revisionabile in Git.**
3
+ **I tuoi agenti scrivono codice. Truthmark mantiene la documentazione pensata per le persone e revisionabile in Git.**
4
+
5
+ Truthmark installa workflow nativi di Git che permettono agli agenti di coding IA di creare nuova documentazione di prodotto e ingegneria a partire dal codice e dai test esistenti, mantenerla aggiornata dopo ogni modifica al codice e consegnarti normali diff Markdown da revisionare.
6
+
7
+ [![versione 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
+ [![Licenza: 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
+ [Inizia](#avvio-rapido-crea-il-tuo-primo-documento-di-verità) · [Sito web](https://merlinhu1.github.io/truthmark/) · [Guida utente](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
13
+
14
+ <details>
15
+ <summary>Leggi questo README in 16 lingue</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
- ![Banner di Truthmark](../assets/truthmark-banner.png)
19
+ </details>
8
20
 
9
- ## 🚀 Avvio rapido: eseguirlo localmente in cinque minuti
21
+ ## Crea i primi documenti. Mantienili fedeli alla realtà.
10
22
 
11
- Esegui questo comando nel repository Git che vuoi far gestire a Truthmark:
23
+ La maggior parte degli strumenti di documentazione si ferma dopo la generazione. Truthmark offre agli agenti un ciclo di vita completo della documentazione all’interno del tuo repository:
12
24
 
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark config
17
- ```
25
+ - **Crea nuova documentazione da software funzionante.** Truth Document legge codice e test, quindi crea documentazione di prodotto o ingegneria con un perimetro definito.
26
+ - **Mantieni la documentazione allineata automaticamente.** Truth Sync viene eseguito al passaggio di consegne dell’agente dopo modifiche funzionali al codice e aggiorna la verità del repository prima che il lavoro sia concluso.
27
+ - **Trasforma nuovamente la documentazione in codice.** Truth Realize implementa documenti di verità approvati mantenendo un workflow pulito che parte dalla documentazione.
28
+ - **Ripristina la proprietà man mano che la codebase cresce.** Truth Structure crea percorsi delimitati e documenti iniziali per aree nuove o sovraccariche.
29
+ - **Revisiona tutto in Git.** Codice, decisioni, contratti, architettura, operazioni e comportamento viaggiano insieme al branch.
18
30
 
19
- 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:
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
+ Nessuna knowledge base ospitata. Nessuna memoria privata degli agenti. Nessuna documentazione intrappolata nella cronologia delle chat.
31
32
 
32
- Poi installa i documenti di verità locali al repository, il routing e le superfici di workflow per agenti:
33
+ ## Avvio rapido: crea il tuo primo documento di verità
34
+
35
+ **Requisiti:** Node.js 24 o versione successiva, un repository Git e un host di coding IA supportato per i workflow degli agenti.
36
+
37
+ Esegui quanto segue nel repository che vuoi far gestire a Truthmark:
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
- 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:
45
+ `truthmark init` permette di selezionare Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor oppure una configurazione dell’interfaccia a riga di comando neutrale rispetto all’host.
46
+
47
+ Ora chiedi all’agente configurato di documentare un comportamento reale:
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
- 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à.
47
-
48
- 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`.
49
-
50
- ## 💡 Il problema: il divario di documentazione dell’IA
53
+ Truth Document crea un nuovo documento di verità delimitato quando non ne esiste uno, aggiorna il documento proprietario esistente quando è presente e aggiorna il routing quando necessario. Non modifica il codice funzionale.
51
54
 
52
- 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à.**
55
+ Revisiona il risultato:
53
56
 
54
- * Il comportamento si perde in cronologie chat effimere.
55
- * I documenti di architettura restano rapidamente indietro.
56
- * Le decisioni di prodotto scompaiono dopo la consegna.
57
- * I revisori del codice si ritrovano a esaminare diff di codice grezzi senza capire il “perché”.
58
- * Ogni nuova sessione IA è costretta a riscoprire da zero la verità del repository.
59
-
60
- ## 🎯 La soluzione: Truthmark
61
-
62
- **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.
63
-
64
- 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.
65
-
66
- ### ✨ Perché Truthmark è unico
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
67
62
 
68
- Truthmark non è semplicemente un altro strumento di documentazione. È profondamente integrato nel workflow IA:
63
+ Ora dovresti avere:
69
64
 
70
- * **🚫 Nessun lock-in del fornitore:** nessun servizio ospitato, nessun database nascosto, nessun server aggiuntivo da gestire.
71
- * **🌳 100% nativo di Git:** tutto vive nel tuo repository. La verità si muove con il tuo branch.
72
- * **🤝 Contratto posseduto dagli umani e seguito dagli agenti:** I maintainer possiedono il contratto del repository; gli agenti seguono le istruzioni installate mentre scrivono codice.
73
- * **✅ 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.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
74
69
 
75
- ## 🔄 Come funziona
70
+ I percorsi esatti seguono la struttura di proprietà del tuo repository. I nuovi file compaiono in `git status`; le modifiche ai file tracciati compaiono in `git diff`.
76
71
 
77
- 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:
72
+ La modalità di invocazione varia in base all’host. OpenCode usa `/skill truthmark-document`, Antigravity usa `@truthmark-document` e gli altri host supportati utilizzano la propria interfaccia nativa per skill o comandi slash. Consulta la [tabella delle piattaforme](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) per i comandi esatti.
78
73
 
79
- 1. 💻 **Codice:** l’agente modifica codice funzionale.
80
- 2. 🧪 **Test:** vengono eseguiti i test pertinenti.
81
- 3. 🔍 **Controllo:** Truthmark controlla la documentazione mappata come parte della revisione finale installata.
82
- 4. 📝 **Documentazione:** i docs vengono aggiornati dall’agente quando la verità del repository è cambiata.
83
- 5. 👀 **Revisione:** una persona revisiona il *diff di codice* + il *diff di verità*.
74
+ Per script e integrazione continua, passa esplicitamente le piattaforme selezionate:
84
75
 
85
- ## 🛠 Come interagisci con Truthmark
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
86
80
 
87
- Truthmark ha un contratto locale al repository e due modi per usarlo.
81
+ Scegli `none` in modalità interattiva oppure esegui `truthmark init --clear-platforms` per ottenere un repository neutrale rispetto all’host. Puoi aggiungere piattaforme per agenti in seguito rieseguendo `truthmark init`.
88
82
 
89
- ### Gli esseri umani installano e validano il contratto
83
+ Per la diagnostica di aggiornamento relativa al branch, passa una base Git:
90
84
 
91
- Maintainer e CI usano la CLI:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
92
88
 
93
- * `truthmark config` - crea la configurazione iniziale.
94
- * `truthmark init` - installa o aggiorna routing, scaffold dei documenti di verità e istruzioni per host IA.
95
- * `truthmark check` - valida la verità del repository dal terminale.
89
+ ## Come funziona Truthmark
96
90
 
97
- ### Gli agenti seguono il contratto mentre scrivono codice
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Come funziona Truthmark" width="1440">
94
+ </picture>
98
95
 
99
- Truthmark installa istruzioni locali al repository per host di coding IA supportati come Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
96
+ L’interfaccia a riga di comando di Truthmark installa e convalida il contratto del repository. Il tuo agente di coding esegue la revisione delle evidenze e il lavoro di documentazione attraverso i workflow nativi dell’host installati.
100
97
 
101
- Il ciclo normale è semplice:
98
+ Una normale modifica al codice segue un ciclo semplice:
102
99
 
103
- 1. Chiedi al tuo agente una modifica al codice o di documentare un comportamento esistente.
104
- 2. Le istruzioni installate dicono all’agente quando testare, quando aggiornare i documenti di verità e quando fermarsi per la revisione umana.
105
- 3. Tu revisioni normali diff Git: codice più eventuali modifiche ai documenti di verità.
100
+ 1. L’agente modifica il codice funzionale.
101
+ 2. Vengono eseguiti i test pertinenti.
102
+ 3. Truth Sync controlla la documentazione mappata.
103
+ 4. L’agente crea o aggiorna documentazione e routing quando cambia la verità del repository.
104
+ 5. Revisioni insieme il diff del codice e il diff della verità.
106
105
 
107
- Le richieste agente avviate dall’utente sono intenzionalmente poche:
106
+ ## Workflow
108
107
 
109
- * `/truthmark-document` - documenta comportamento implementato esistente da codice e test.
110
- * `/truthmark-realize` - implementa codice da documenti di verità esistenti.
111
- * `/truthmark-check` - audita la verità del repository.
108
+ | Workflow | Quando usarlo | Risultato |
109
+ | -------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
110
+ | **Truth Document** | Il codice esistente ha bisogno di documentazione | Crea o aggiorna documentazione di prodotto e ingegneria basata su evidenze |
111
+ | **Truth Sync** | Il codice funzionale è cambiato | Mantiene allineati la documentazione mappata e il routing prima della consegna |
112
+ | **Truth Structure** | Una nuova area ha bisogno di proprietà o la documentazione esistente è troppo ampia | Crea percorsi delimitati e strutture iniziali per i documenti |
113
+ | **Truth Realize** | Un documento di verità approvato deve diventare software funzionante | Aggiorna il codice funzionale a partire dalla documentazione |
114
+ | **Truth Check** | La verità del repository deve essere sottoposta ad audit | Segnala problemi di routing, proprietà, evidenze e documentazione |
115
+ | **Truthmark Portal** | Il team desidera un sito di documentazione navigabile | Genera una presentazione HTML statica e versionata dai documenti di verità Markdown |
112
116
 
113
- Truth Sync non è il modo abituale per iniziare il lavoro; è la revisione finale dopo modifiche funzionali al codice.
114
- Truth Structure non è un comando quotidiano; ripara routing o ownership solo quando ciò blocca il lavoro.
117
+ Truthmark installa questi workflow come superfici native del repository per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
115
118
 
116
119
  ## Cosa ottieni
117
120
 
118
- | Capacità | Cosa fa |
119
- | --- | --- |
120
- | Verità nativa di Git | Mantiene la verità del repository in Markdown e configurazione committati. |
121
- | Documentazione con ambito di branch | La verità si muove con il branch invece di vivere in una sessione privata. |
122
- | CLI umana | Offre ai maintainer comandi di setup, aggiornamento, validazione e ispezione. |
123
- | Guida agente installata | Dice agli agenti di coding quando documentare, testare, sincronizzare la verità, auditare o fermarsi per revisione. |
124
- | Routing esplicito | Mappa aree di codice a documenti di verità canonici. |
125
- | Consegne revisionabili | Produce normali diff Git sia per il codice sia per i documenti di verità. |
126
- | Operatività local-first | Non richiede servizi ospitati, daemon, database o server MCP. |
127
- | Confini di scrittura più sicuri | Separa workflow code-first, doc-first, read-only e doc-only. |
128
- | Validazione | Segnala problemi di routing, autorità, frontmatter, link, superfici generate, ambito di branch, freschezza e copertura. |
129
- | Portal opzionale | Genera, quando esplicitamente abilitato e richiesto, un sito statico HTML committato a partire da documenti di verità Markdown. |
130
-
131
- ## Panoramica visiva
132
-
133
- ![Funzionalità di Truthmark](../assets/truthmark-features.png)
134
-
135
- **Funzionalità:** cosa installa Truthmark e come è divisa la superficie di workflow.
136
-
137
- ![Posizione di Truthmark](../assets/truthmark-position.png)
121
+ ### Documentazione che parte dalla realtà
138
122
 
139
- **Posizione:** dove Truthmark si colloca rispetto a prompt, memoria e workflow di specifica.
123
+ Truthmark può creare documentazione per funzionalità di prodotto, comportamento dell’implementazione, interfacce di programmazione delle applicazioni, architettura, workflow, operazioni e test. Codice e test forniscono le evidenze; documenti Markdown delimitati conservano il risultato.
140
124
 
141
- ![Flusso di sincronizzazione di Truthmark](../assets/truthmark-syncflow.png)
125
+ ### Documentazione che supera il cambiamento successivo
142
126
 
143
- **Flusso di sincronizzazione:** come Truth Sync conclude le normali modifiche di codice prima della consegna.
127
+ I percorsi collegano le aree di codice ai documenti canonici. Quando gli agenti modificano il comportamento, Truth Sync sa dove deve risiedere la verità corrispondente e mantiene la consegna revisionabile.
144
128
 
145
- ## Perché i team lo adottano
129
+ ### Verità di prodotto e ingegneria su percorsi separati
146
130
 
147
- Truthmark è per team che sanno già che gli agenti IA possono generare codice.
131
+ La verità di prodotto raccoglie promesse rivolte agli utenti, limiti, decisioni e criteri di accettazione. La verità di ingegneria raccoglie comportamento corrente, contratti, architettura, workflow, operazioni e comportamento dei test.
148
132
 
149
- Il problema successivo è la governance.
133
+ ### Collaborazione nativa di Git
150
134
 
151
- Non governance come cerimonia. Governance come una semplice domanda:
135
+ Tutto ciò che conta risiede in file versionati del repository. La verità segue il branch, funziona con normali pull request e rimane visibile a ogni maintainer e agente di coding.
152
136
 
153
- > Dopo questa modifica assistita dall’IA, il repository dice ancora la verità?
137
+ ### Operatività local-first
154
138
 
155
- Truthmark aiuta i team a rispondere con file committati, routing esplicito e diff revisionabili.
156
-
157
- È utile quando hai bisogno di:
158
-
159
- - meno deriva della documentazione
160
- - consegne migliori
161
- - verità di prodotto specifica per branch
162
- - documentazione durevole di architettura e API
163
- - ownership esplicita tra docs e codice
164
- - confini di scrittura degli agenti più sicuri
165
- - documentazione revisionabile invece di memoria nascosta
166
- - guida agente che funziona ancora da file committati nel repository
139
+ Truthmark non richiede servizi ospitati, daemon, database, archivi vettoriali o server Model Context Protocol. Il repository contiene il proprio workflow di documentazione.
167
140
 
168
141
  ## Dove si colloca Truthmark
169
142
 
170
- Truthmark non sostituisce prompt, memoria, specifiche, test o code review.
171
-
172
- Offre a questi workflow un luogo durevole in cui atterrare in Git.
143
+ | Esigenza | Soluzione migliore |
144
+ | ------------------------------------------------------------- | ----------------------------- |
145
+ | Output migliore da una sessione di agente | Un prompt migliore |
146
+ | Continuità personale o a livello di sessione | Uno strumento di memoria |
147
+ | Sviluppo di funzionalità che parte da un piano | Un workflow di specifica |
148
+ | Documentazione con ambito di branch che viaggia con il codice | **Truthmark** |
149
+ | Correttezza del comportamento | Test e code review |
150
+ | Documentazione assistita dall’IA e revisionabile | **Truthmark + revisione Git** |
173
151
 
174
- | Esigenza | Scelta migliore |
175
- | --- | --- |
176
- | Output migliore da una sessione di agente | Prompt migliore |
177
- | Continuità personale o a livello di sessione | Strumento di memoria |
178
- | Lavoro su funzionalità guidato prima da un piano | Workflow di specifica |
179
- | Verità con ambito di branch che viaggia con il codice | Truthmark |
180
- | Validare la correttezza del comportamento | Test e revisione |
181
- | Revisionare modifiche di documentazione assistite dall’IA | Truthmark più revisione Git |
152
+ Truthmark è progettato per maintainer e team di ingegneria che usano già agenti di coding IA e vogliono che il repository continui a dire la verità con la stessa rapidità con cui cambia il codice.
182
153
 
183
- La corsia di Truthmark è stretta per progettazione:
184
-
185
- ```text
186
- make repository truth explicit
187
- route it to code
188
- installare guida agente intorno a essa
189
- keep the result reviewable in Git
190
- ```
154
+ ## Host supportati e riga di comando
191
155
 
192
- ## Approfondisci
156
+ Host per agenti supportati:
193
157
 
194
- Il README è la vetrina: contesto rapido, avvio rapido e il modello mentale centrale.
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
195
164
 
196
- 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).
165
+ <details>
166
+ <summary>Riferimento della riga di comando</summary>
197
167
 
198
- ## Stato del progetto
168
+ | Comando | Scopo |
169
+ | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Crea o aggiorna configurazione, routing, template e workflow degli host selezionati |
171
+ | `truthmark check [--base <ref>]` | Convalida la verità del repository e, facoltativamente, esegue la diagnostica di aggiornamento del branch |
172
+ | `truthmark index --json` | Ispeziona i metadati derivati del repository e del routing |
173
+ | `truthmark impact --base <ref> --json` | Mappa i file modificati su documenti, proprietari e test vicini |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Ispeziona applicabilità e obiettivi del workflow |
175
+ | `truthmark validate ...` | Convalida i report dei workflow e le concessioni di scrittura |
176
+ | `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | Mostra in anteprima o rimuove le superfici host generate preservando la verità creata |
199
177
 
200
- La release attuale fornisce:
178
+ L’output JSON strutturato è disponibile in tutta l’interfaccia a riga di comando per script e integrazione continua.
201
179
 
202
- - comandi CLI locali per config, init, check, index, impact e stato dei workflow
203
- - istruzioni agente locali al repository generate per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
204
- - diagnostica su routing, autorità, frontmatter, link, freschezza, superfici generate, ambito di branch e copertura
205
- - documenti di verità con ambito di branch e artefatti derivati di intelligence del repository
180
+ </details>
206
181
 
207
- ## Documentazione
182
+ ## Scopri di più
208
183
 
209
- - [Guida utente](../user-guide.md)
210
- - [Indice docs](../README.md)
211
- - [Panoramica dell’architettura](../truthmark/engineering/architecture/overview.md)
212
- - [Contratti API e CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
213
- - [Guida alla manutenzione della verità del repository](../standards/maintaining-repository-truth.md)
184
+ - [Guida utente di Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Indice della documentazione](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Panoramica dell’architettura](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Contratti di configurazione, routing e comandi](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Contribuire](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
214
189
 
215
- Per i comandi di sviluppo locale e contribuzione, vedi [CONTRIBUTING.md](../../CONTRIBUTING.md).
216
-
217
- ## Confini di progettazione
218
-
219
- Truthmark è intenzionalmente piccolo: locale, committato, con ambito di branch e revisionabile.
220
-
221
- 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.
190
+ **Installa Truthmark, seleziona il tuo host di coding e trasforma oggi stesso un comportamento reale in documentazione.**
222
191
 
223
192
  ## Licenza
224
193
 
225
194
  MIT. Vedi [LICENSE](../../LICENSE).
226
-
227
- ## Rimozione sicura
228
-
229
- Usa `truthmark uninstall --dry-run` per rivedere le superfici host generate con precisione, quindi `truthmark uninstall --apply` per rimuoverle. I truth creati, la configurazione, i template, l’output di Portal, i file Gemini e i file utente non correlati vengono preservati; rimuovi separatamente un’installazione npm globale con il tuo gestore pacchetti.