truthmark 2.2.6 → 2.2.7

package/docs/README.md

@@ -11,7 +11,7 @@ source_of_truth:
 
 ## Purpose
 
-`docs/` is Truthmark's canonical repository documentation tree. It keeps repository-wide agent rules, reusable standards, current architecture, and current lane-separated truth docs separate from onboarding copy and historical planning notes.
+`docs/` is Truthmark's repository documentation tree. It keeps repository-wide agent rules, reusable standards, current architecture, current lane-separated truth docs, and non-canonical research notes separate from onboarding copy.
 
 `AGENTS.md` is the agent entry point, but it delegates repository-wide rules to [docs/ai/repo-rules.md](ai/repo-rules.md). [README.md](../README.md) remains the human onboarding and product entry point. [docs/user-guide.md](user-guide.md) owns detailed human-facing command, workflow, and configuration guidance. `.truthmark/config.yml` defines the committed hierarchy contract.
 
@@ -35,6 +35,7 @@ Repository-wide conflict order and completion policy live in [docs/ai/repo-rules
 - `docs/truthmark/product/` for product capability promises, boundaries, and acceptance criteria
 - `docs/truthmark/engineering/` for current implementation behavior, architecture, contracts, workflows, and operations
 - `docs/architecture/` for repository-specific architecture guardrails
+- `docs/research/` for non-canonical research and planning notes
 - `docs/truthmark/templates/` for editable scaffold templates used to create new docs
 - `docs/truthmark/engineering/contracts/` for stable contracts the CLI exposes
 
@@ -45,16 +46,17 @@ Repository-wide conflict order and completion policy live in [docs/ai/repo-rules
 
 ## Directory Map
 
-| Path | Type | Primary audience | Purpose |
-| --- | --- | --- | --- |
-| `docs/ai/` | agent rules | agent | Repository-wide rules and fast onboarding |
-| `docs/truthmark/routes/` | routing | both | Truth-routing metadata such as `areas.md` and `areas/**/*.md` |
-| `docs/standards/` | standard | agent | Reusable constraints, verification rules, completion gates |
-| `docs/truthmark/product/` | product truth | agent | Product capability promises, boundaries, decisions, and acceptance criteria |
-| `docs/truthmark/engineering/` | engineering truth | agent | Current implementation behavior for init, check, contracts, workflows, and operations |
-| `docs/architecture/` | architecture | agent | Repository-specific architecture guardrails |
-| `docs/truthmark/templates/` | template | both | Editable templates for scaffolded docs; templates are not Truth Sync targets |
-| `docs/user-guide.md` | guide | human | Detailed usage guide kept out of the root README so onboarding stays concise |
+| Path                          | Type              | Primary audience | Purpose                                                                               |
+| ----------------------------- | ----------------- | ---------------- | ------------------------------------------------------------------------------------- |
+| `docs/ai/`                    | agent rules       | agent            | Repository-wide rules and fast onboarding                                             |
+| `docs/truthmark/routes/`      | routing           | both             | Truth-routing metadata such as `areas.md` and `areas/**/*.md`                         |
+| `docs/standards/`             | standard          | agent            | Reusable constraints, verification rules, completion gates                            |
+| `docs/truthmark/product/`     | product truth     | agent            | Product capability promises, boundaries, decisions, and acceptance criteria           |
+| `docs/truthmark/engineering/` | engineering truth | agent            | Current implementation behavior for init, check, contracts, workflows, and operations |
+| `docs/architecture/`          | architecture      | agent            | Repository-specific architecture guardrails                                           |
+| `docs/research/`              | research          | human            | Non-canonical research, comparison, and planning notes                                |
+| `docs/truthmark/templates/`   | template          | both             | Editable templates for scaffolded docs; templates are not Truth Sync targets          |
+| `docs/user-guide.md`          | guide             | human            | Detailed usage guide kept out of the root README so onboarding stays concise          |
 
 ## Frontmatter Policy
 

package/docs/readmes/README.ar.md

@@ -223,3 +223,7 @@ Truthmark صغير عمداً: محلي، ملتزم به، مرتبط بالف
 ## الترخيص
 
 MIT. راجع [LICENSE](../../LICENSE).
+
+## إزالة آمنة
+
+استخدم `truthmark uninstall --dry-run` لمراجعة أسطح الاستضافة المولّدة بدقة، ثم `truthmark uninstall --apply` لإزالتها. يتم الاحتفاظ بـ truth المؤلفة والتكوين والقوالب ومخرجات البوابة وملفات Gemini والملفات غير المتعلقة بالمستخدم؛ أزل التثبيت العالمي لـ npm بشكل منفصل عبر مدير الحزم.

package/docs/readmes/README.de.md

@@ -223,3 +223,7 @@ Es ist kein gehosteter Dienst, MCP-Server, keine Vektordatenbank, versteckte Mem
 ## Lizenz
 
 MIT. Siehe [LICENSE](../../LICENSE).
+
+## Sichere Entfernung
+
+Verwenden Sie `truthmark uninstall --dry-run`, um die exakt erzeugten Host-Surfaces zu prüfen, und anschließend `truthmark uninstall --apply`, um sie zu entfernen. Erstellte truth, Konfiguration, Templates, Portal-Ausgabe, Gemini-Dateien und nicht zusammenhängende Benutzerdateien bleiben erhalten; entfernen Sie eine globale npm-Installation separat mit Ihrem Paketmanager.

package/docs/readmes/README.el.md

@@ -223,3 +223,7 @@ keep the result reviewable in Git
 ## Άδεια
 
 MIT. Δείτε [LICENSE](../../LICENSE).
+
+## Ασφαλής κατάργηση
+
+Χρησιμοποιήστε το `truthmark uninstall --dry-run` για να ελέγξετε τις ακριβώς παραγόμενες επιφάνειες host και στη συνέχεια το `truthmark uninstall --apply` για να τις αφαιρέσετε. Το δημιουργημένο truth, η διαμόρφωση, τα templates, η έξοδος του Portal, τα αρχεία Gemini και τα μη σχετιζόμενα αρχεία χρήστη διατηρούνται. Καταργήστε την παγκόσμια εγκατάσταση του npm ξεχωριστά με το εργαλείο διαχείρισης πακέτων σας.

package/docs/readmes/README.es.md

@@ -223,3 +223,7 @@ No es un servicio alojado, servidor MCP, base de datos vectorial, capa de memori
 ## Licencia
 
 MIT. Consulta [LICENSE](../../LICENSE).
+
+## Eliminación segura
+
+Use `truthmark uninstall --dry-run` para revisar las superficies de host generadas exactas, luego `truthmark uninstall --apply` para eliminarlas. Los truth creados, la configuración, las plantillas, la salida de Portal, los archivos de Gemini y los archivos de usuario no relacionados se conservan; quite una instalación global de npm por separado con su gestor de paquetes.

package/docs/readmes/README.fr.md

@@ -223,3 +223,7 @@ Ce n’est pas un service hébergé, un serveur MCP, une base de données vector
 ## Licence
 
 MIT. Voir [LICENSE](../../LICENSE).
+
+## Suppression sûre
+
+Utilisez `truthmark uninstall --dry-run` pour examiner précisément les surfaces hôtes générées, puis `truthmark uninstall --apply` pour les supprimer. Les truth rédigées, la configuration, les templates, la sortie Portal, les fichiers Gemini et les fichiers utilisateur non liés sont conservés ; supprimez séparément une installation npm globale avec votre gestionnaire de paquets.

package/docs/readmes/README.id.md

@@ -223,3 +223,7 @@ Ini bukan layanan ter-host, server MCP, basis data vektor, lapisan memori tersem
 ## Lisensi
 
 MIT. Lihat [LICENSE](../../LICENSE).
+
+## Penghapusan aman
+
+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.

package/docs/readmes/README.it.md

@@ -223,3 +223,7 @@ Non è un servizio ospitato, un server MCP, un database vettoriale, un livello d
 ## Licenza
 
 MIT. Vedi [LICENSE](../../LICENSE).
+
+## Rimozione sicura
+
+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.

package/docs/readmes/README.ja.md

@@ -223,3 +223,7 @@ Truthmark は意図的に小さく保たれています：ローカル、コミ
 ## ライセンス
 
 MIT。[LICENSE](../../LICENSE) を参照してください。
+
+## 安全な削除
+
+`truthmark uninstall --dry-run` を使用して正確に生成されたホストサーフェスを確認し、次に `truthmark uninstall --apply` でそれらを削除します。作成した truth、設定、テンプレート、Portal の出力、Gemini ファイル、関連のないユーザーファイルは保持されます。npm のグローバルインストールはパッケージマネージャーで別途削除してください。

package/docs/readmes/README.ko.md

@@ -223,3 +223,7 @@ Truthmark는 호스팅 서비스, MCP 서버, 벡터 데이터베이스, 숨겨
 ## 라이선스
 
 MIT. [LICENSE](../../LICENSE)를 참조하세요.
+
+## 안전한 제거
+
+`truthmark uninstall --dry-run`을(를) 사용하여 정확히 생성된 호스트 표면을 검토한 후 `truthmark uninstall --apply`를 사용해 제거하세요. 작성된 truth, 구성, 템플릿, Portal 출력, Gemini 파일 및 관련 없는 사용자 파일은 보존되며, npm 전역 설치는 패키지 관리자에서 별도로 제거하십시오.

package/docs/readmes/README.pl.md

@@ -223,3 +223,7 @@ Nie jest usługą hostowaną, serwerem MCP, wektorową bazą danych, ukrytą war
 ## Licencja
 
 MIT. Zobacz [LICENSE](../../LICENSE).
+
+## Bezpieczne usuwanie
+
+Użyj `truthmark uninstall --dry-run`, aby przejrzeć dokładnie wygenerowane powierzchnie hosta, a następnie `truthmark uninstall --apply`, aby je usunąć. Utworzone truth, konfiguracja, szablony, wyjście Portalu, pliki Gemini i niezwiązane pliki użytkownika są zachowane; globalną instalację npm usuń oddzielnie za pomocą swojego menedżera pakietów.

package/docs/readmes/README.pt.md

@@ -223,3 +223,7 @@ Ele não é um serviço hospedado, servidor MCP, banco de dados vetorial, camada
 ## Licença
 
 MIT. Veja [LICENSE](../../LICENSE).
+
+## Remoção segura
+
+Use `truthmark uninstall --dry-run` para revisar as superfícies de host geradas com precisão, e depois `truthmark uninstall --apply` para removê-las. Truth criada, configuração, templates, saída do Portal, arquivos Gemini e arquivos de usuário não relacionados são preservados; remova uma instalação global de npm separadamente com seu gerenciador de pacotes.

package/docs/readmes/README.ru.md

@@ -223,3 +223,7 @@ Truthmark намеренно мал: локальный, закоммиченн
 ## Лицензия
 
 MIT. См. [LICENSE](../../LICENSE).
+
+## Безопасное удаление
+
+Используйте `truthmark uninstall --dry-run` для проверки точно сгенерированных host-поверхностей, затем `truthmark uninstall --apply` для их удаления. Сформированные truth, конфигурация, шаблоны, вывод Portal, файлы Gemini и несвязанные пользовательские файлы сохраняются; глобальную установку npm удаляйте отдельно через менеджер пакетов.

package/docs/readmes/README.tr.md

@@ -223,3 +223,7 @@ Barındırılan bir hizmet, MCP sunucusu, vektör veritabanı, gizli bellek katm
 ## Lisans
 
 MIT. Bkz. [LICENSE](../../LICENSE).
+
+## Güvenli kaldırma
+
+`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.

package/docs/readmes/README.vi.md

@@ -223,3 +223,7 @@ Nó không phải dịch vụ lưu trữ, máy chủ MCP, cơ sở dữ liệu v
 ## Giấy phép
 
 MIT. Xem [LICENSE](../../LICENSE).
+
+## Gỡ cài đặt an toàn
+
+Sử dụng `truthmark uninstall --dry-run` để xem lại chính xác các bề mặt host đã tạo ra, rồi `truthmark uninstall --apply` để loại bỏ chúng. Các truth đã tạo, cấu hình, mẫu, đầu ra Portal, tệp Gemini và các tệp người dùng không liên quan sẽ được giữ nguyên; hãy gỡ bỏ cài đặt npm toàn cục riêng biệt bằng trình quản lý gói của bạn.

package/docs/readmes/README.zh.md

@@ -223,3 +223,7 @@ Truthmark 有意保持小而明确：本地、已提交、按分支生效、可
 ## 许可证
 
 MIT。见 [LICENSE](../../LICENSE)。
+
+## 安全移除
+
+使用 `truthmark uninstall --dry-run` 查看精确生成的主机表面（host surfaces），然后使用 `truthmark uninstall --apply` 将其移除。已创建的 truth、配置、模板、Portal 输出、Gemini 文件以及不相关的用户文件将被保留；请使用包管理器单独移除全局 npm 安装。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truthmark",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "description": "Git-native, branch-scoped truth workflow installer for local AI coding agents.",
   "license": "MIT",
   "type": "module",
@@ -50,12 +50,12 @@
     "build": "tsup",
     "prepack": "npm run build",
     "dev": "tsx src/cli/main.ts",
-    "format:check": "prettier --check eslint.config.js package.json package-lock.json tests/package-files.test.ts tsconfig.json vitest.config.ts",
+    "format:check": "prettier --check eslint.config.js package.json package-lock.json tests/package-files.test.ts tsconfig.json",
     "lint": "eslint .",
-    "package:check": "vitest run tests/package-files.test.ts",
+    "package:check": "node --import tsx --test --test-concurrency=1 tests/package-files.test.ts",
     "release:check": "npm run lint && npm run format:check && npm run typecheck && npm run test && npm run build && npm run package:check && npm audit --omit=dev",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "node --import tsx --test --test-concurrency=1 \"tests/**/*.test.ts\"",
+    "test:watch": "node --watch --import tsx --test --test-concurrency=1 \"tests/**/*.test.ts\"",
     "typecheck": "tsc --noEmit",
     "check": "npm run lint && npm run typecheck && npm run test && npm run build"
   },
@@ -75,11 +75,11 @@
     "@eslint/js": "^9.39.4",
     "@types/node": "^24.9.1",
     "eslint": "^9.39.4",
+    "expect": "^30.2.0",
     "prettier": "^3.8.3",
     "tsup": "^8.5.0",
     "tsx": "^4.20.6",
-    "typescript-eslint": "^8.59.2",
-    "vitest": "^4.0.8"
+    "typescript-eslint": "^8.59.2"
   },
   "overrides": {
     "esbuild": "0.28.1"