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.
- package/README.md +119 -166
- package/dist/main.js +2156 -1914
- package/dist/main.js.map +1 -1
- package/docs/README.md +49 -37
- package/docs/assets/truthmark-workflow-mobile.svg +118 -0
- package/docs/assets/truthmark-workflow.svg +182 -0
- package/docs/readmes/README.ar.md +125 -160
- package/docs/readmes/README.de.md +127 -162
- package/docs/readmes/README.el.md +127 -162
- package/docs/readmes/README.es.md +125 -160
- package/docs/readmes/README.fr.md +125 -160
- package/docs/readmes/README.id.md +126 -161
- package/docs/readmes/README.it.md +125 -160
- package/docs/readmes/README.ja.md +126 -161
- package/docs/readmes/README.ko.md +127 -162
- package/docs/readmes/README.pl.md +125 -160
- package/docs/readmes/README.pt.md +126 -161
- package/docs/readmes/README.ru.md +124 -159
- package/docs/readmes/README.tr.md +125 -160
- package/docs/readmes/README.vi.md +126 -161
- package/docs/readmes/README.zh.md +128 -163
- package/package.json +3 -1
|
@@ -1,229 +1,194 @@
|
|
|
1
1
|
# Truthmark
|
|
2
2
|
|
|
3
|
-
**وكلاؤك يكتبون الكود.
|
|
3
|
+
**وكلاؤك يكتبون الكود. ويحافظ Truthmark على التوثيق الموجّه للبشر والقابل للمراجعة عبر Git.**
|
|
4
|
+
|
|
5
|
+
يثبّت Truthmark مسارات عمل أصلية لـ Git تتيح لوكلاء البرمجة بالذكاء الاصطناعي إنشاء توثيق جديد للمنتج والهندسة من الكود والاختبارات الموجودة، والحفاظ على حداثته بعد كل تغيير في الكود، وتسليمك فروق Markdown عادية لمراجعتها.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
11
|
+
|
|
12
|
+
[ابدأ الآن](#البدء-السريع-أنشئ-أول-وثيقة-حقيقة) · [الموقع](https://merlinhu1.github.io/truthmark/) · [دليل المستخدم](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
13
|
+
|
|
14
|
+
<details>
|
|
15
|
+
<summary>اقرأ ملف README هذا بـ 16 لغة</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
|
-
|
|
19
|
+
</details>
|
|
8
20
|
|
|
9
|
-
##
|
|
21
|
+
## أنشئ الوثائق الأولى. وحافظ على صدقها.
|
|
10
22
|
|
|
11
|
-
|
|
23
|
+
تتوقف معظم أدوات التوثيق بعد التوليد. أما Truthmark فيمنح الوكلاء دورة حياة كاملة للتوثيق داخل مستودعك:
|
|
12
24
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
25
|
+
- **أنشئ توثيقاً جديداً من برمجيات عاملة.** يقرأ Truth Document الكود والاختبارات، ثم ينشئ توثيقاً محدد النطاق للمنتج أو الهندسة.
|
|
26
|
+
- **حافظ على توافق الوثائق تلقائياً.** يعمل Truth Sync عند تسليم الوكيل بعد تغييرات الكود الوظيفية، ويحدّث حقيقة المستودع قبل اكتمال العمل.
|
|
27
|
+
- **حوّل الوثائق مجدداً إلى كود.** ينفّذ Truth Realize وثائق الحقيقة المعتمدة مع الحفاظ على مسار عمل نظيف يبدأ بالتوثيق.
|
|
28
|
+
- **أصلح الملكية مع نمو قاعدة الكود.** ينشئ Truth Structure مسارات محددة النطاق ووثائق أولية للمناطق الجديدة أو المثقلة.
|
|
29
|
+
- **راجع كل شيء في Git.** ينتقل الكود والقرارات والعقود والمعمارية والعمليات والسلوك معاً ضمن الفرع.
|
|
18
30
|
|
|
19
|
-
|
|
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
|
+
لا قاعدة معرفة مستضافة. لا ذاكرة خاصة للوكلاء. لا توثيق عالق في سجل المحادثات.
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
## البدء السريع: أنشئ أول وثيقة حقيقة
|
|
34
|
+
|
|
35
|
+
**المتطلبات:** Node.js 24 أو أحدث، ومستودع Git، ومضيف برمجة بالذكاء الاصطناعي مدعوم لمسارات عمل الوكلاء.
|
|
36
|
+
|
|
37
|
+
شغّل ما يلي داخل المستودع الذي تريد أن يديره 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
|
-
|
|
45
|
+
يتيح لك `truthmark init` اختيار Codex أو Claude Code أو GitHub Copilot أو OpenCode أو Antigravity أو Cursor أو إعداد واجهة سطر أوامر محايد تجاه المضيف.
|
|
46
|
+
|
|
47
|
+
اطلب الآن من الوكيل الذي أعددته توثيق سلوك حقيقي واحد:
|
|
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
|
-
|
|
47
|
-
|
|
48
|
-
إذا كنت تريد فقط التحقق عبر CLI ولا تريد بعدُ مسارات عمل ذكاء اصطناعي خاصة بمضيف، فاترك `platforms` محذوفة وشغّل `truthmark init && truthmark check`؛ يمكنك إضافة منصة لاحقاً وإعادة تشغيل `truthmark init`.
|
|
49
|
-
|
|
50
|
-
## 💡 المشكلة: فجوة توثيق الذكاء الاصطناعي
|
|
53
|
+
ينشئ Truth Document وثيقة حقيقة جديدة محددة النطاق عند عدم وجودها، ويحدّث الوثيقة المالكة الموجودة عند وجودها، ويحدّث التوجيه عند الحاجة. ولا يغيّر الكود الوظيفي.
|
|
51
54
|
|
|
52
|
-
|
|
55
|
+
راجع النتيجة:
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
## 🎯 الحل: Truthmark
|
|
61
|
-
|
|
62
|
-
يثبّت **Truthmark** طبقة سير عمل أصلية لـ Git داخل مستودعك. وهو يعالج الجزء الذي يتعطل عادةً في تطوير الذكاء الاصطناعي: مساعدة التوثيق على البقاء متوافقاً مع الكود.
|
|
63
|
-
|
|
64
|
-
بدلاً من الأمل في أن يتذكر البشر ووكلاء الذكاء الاصطناعي تحديث الوثائق، يجعل Truthmark التوثيق عادةً منهجية قابلة للمراجعة داخل مستودعك مباشرةً.
|
|
65
|
-
|
|
66
|
-
### ✨ لماذا يتميّز Truthmark
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
67
62
|
|
|
68
|
-
|
|
63
|
+
ينبغي أن يصبح لديك الآن:
|
|
69
64
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
74
69
|
|
|
75
|
-
|
|
70
|
+
تتبع المسارات الدقيقة بنية الملكية في مستودعك. تظهر الملفات الجديدة في `git status`، وتظهر تغييرات الملفات المتتبعة في `git diff`.
|
|
76
71
|
|
|
77
|
-
|
|
72
|
+
تختلف طريقة الاستدعاء بحسب المضيف. يستخدم OpenCode الأمر `/skill truthmark-document`، ويستخدم Antigravity الأمر `@truthmark-document`، بينما تستخدم المضيفات الأخرى المدعومة واجهتها الأصلية للمهارات أو أوامر الشرطة المائلة. راجع [جدول المنصات](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) لمعرفة الأوامر الدقيقة.
|
|
78
73
|
|
|
79
|
-
|
|
80
|
-
2. 🧪 **الاختبار:** تُشغّل الاختبارات ذات الصلة.
|
|
81
|
-
3. 🔍 **التحقق:** يتحقق Truthmark من التوثيق المربوط كجزء من مراجعة وقت الإنهاء المثبّتة.
|
|
82
|
-
4. 📝 **التوثيق:** يحدّث الوكيل الوثائق عندما تتغير حقيقة المستودع.
|
|
83
|
-
5. 👀 **المراجعة:** يراجع إنسان *فرق الكود* + *فرق الحقيقة*.
|
|
74
|
+
بالنسبة إلى السكربتات والتكامل المستمر، مرّر المنصات المختارة صراحةً:
|
|
84
75
|
|
|
85
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
86
80
|
|
|
87
|
-
|
|
81
|
+
اختر `none` تفاعلياً أو شغّل `truthmark init --clear-platforms` للحصول على مستودع محايد تجاه المضيف. ويمكنك إضافة منصات الوكلاء لاحقاً بإعادة تشغيل `truthmark init`.
|
|
88
82
|
|
|
89
|
-
|
|
83
|
+
للحصول على تشخيصات الحداثة نسبةً إلى الفرع، مرّر مرجع Git أساسياً:
|
|
90
84
|
|
|
91
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
92
88
|
|
|
93
|
-
|
|
94
|
-
* `truthmark init` - تثبيت أو تحديث التوجيه، وقوالب وثائق الحقيقة، وتعليمات مضيف الذكاء الاصطناعي.
|
|
95
|
-
* `truthmark check` - التحقق من حقيقة المستودع من الطرفية.
|
|
89
|
+
## كيف يعمل Truthmark
|
|
96
90
|
|
|
97
|
-
|
|
91
|
+
<picture>
|
|
92
|
+
<source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
|
|
93
|
+
<img src="../assets/truthmark-workflow.svg" alt="كيف يعمل Truthmark" width="1440">
|
|
94
|
+
</picture>
|
|
98
95
|
|
|
99
|
-
|
|
96
|
+
تثبّت واجهة سطر أوامر Truthmark عقد المستودع وتتحقق منه. وينفّذ وكيل البرمجة مراجعة الأدلة وأعمال التوثيق من خلال مسارات العمل الأصلية للمضيف التي جرى تثبيتها.
|
|
100
97
|
|
|
101
|
-
|
|
98
|
+
يتبع تغيير الكود المعتاد حلقة بسيطة:
|
|
102
99
|
|
|
103
|
-
1.
|
|
104
|
-
2.
|
|
105
|
-
3.
|
|
100
|
+
1. يغيّر الوكيل الكود الوظيفي.
|
|
101
|
+
2. تُشغّل الاختبارات ذات الصلة.
|
|
102
|
+
3. يتحقق Truth Sync من التوثيق المرتبط.
|
|
103
|
+
4. ينشئ الوكيل الوثائق والتوجيه أو يحدّثهما عندما تتغير حقيقة المستودع.
|
|
104
|
+
5. تراجع فرق الكود وفرق الحقيقة معاً.
|
|
106
105
|
|
|
107
|
-
|
|
106
|
+
## مسارات العمل
|
|
108
107
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
108
|
+
| مسار العمل | متى تستخدمه | النتيجة |
|
|
109
|
+
| -------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------- |
|
|
110
|
+
| **Truth Document** | يحتاج الكود الموجود إلى توثيق | ينشئ توثيقاً للمنتج والهندسة مدعوماً بالأدلة أو يحدّثه |
|
|
111
|
+
| **Truth Sync** | تغيّر الكود الوظيفي | يحافظ على توافق الوثائق المرتبطة والتوجيه قبل التسليم |
|
|
112
|
+
| **Truth Structure** | تحتاج منطقة جديدة إلى ملكية أو أصبحت الوثائق الموجودة واسعة أكثر من اللازم | ينشئ مسارات محددة النطاق وهياكل أولية للوثائق |
|
|
113
|
+
| **Truth Realize** | ينبغي تحويل وثيقة حقيقة معتمدة إلى برمجيات عاملة | يحدّث الكود الوظيفي انطلاقاً من التوثيق |
|
|
114
|
+
| **Truth Check** | تحتاج حقيقة المستودع إلى تدقيق | يبلّغ عن مشكلات التوجيه والملكية والأدلة والتوثيق |
|
|
115
|
+
| **Truthmark Portal** | يريد الفريق موقع توثيق سهل التصفح | ينشئ عرض HTML ثابتاً وملتزماً به من وثائق الحقيقة بصيغة Markdown |
|
|
112
116
|
|
|
113
|
-
|
|
114
|
-
Truth Structure ليس أمراً يومياً؛ إنه يصلح التوجيه أو الملكية فقط عندما يعيق ذلك العمل.
|
|
117
|
+
يثبّت Truthmark مسارات العمل هذه كأسطح أصلية للمستودع في Codex وClaude Code وGitHub Copilot وOpenCode وAntigravity وCursor.
|
|
115
118
|
|
|
116
119
|
## ما الذي تحصل عليه
|
|
117
120
|
|
|
118
|
-
|
|
119
|
-
| --- | --- |
|
|
120
|
-
| حقيقة أصلية لـ Git | تُبقي حقيقة المستودع في Markdown وإعدادات ملتزم بها. |
|
|
121
|
-
| توثيق مرتبط بالفرع | تنتقل الحقيقة مع الفرع بدلاً من العيش في جلسة خاصة. |
|
|
122
|
-
| CLI بشري | يمنح الصائنين أوامر للإعداد والتحديث والتحقق والفحص. |
|
|
123
|
-
| إرشادات الوكيل المثبّتة | تخبر وكلاء البرمجة متى يوثقون، أو يختبرون، أو يزامنون الحقيقة، أو يدققون، أو يتوقفون للمراجعة. |
|
|
124
|
-
| توجيه صريح | يربط مناطق الكود بوثائق الحقيقة المعتمدة. |
|
|
125
|
-
| تسليمات قابلة للمراجعة | ينتج فروق Git عادية لكل من الكود ووثائق الحقيقة. |
|
|
126
|
-
| تشغيل محلي أولاً | لا يتطلب خدمة مستضافة أو daemon أو قاعدة بيانات أو خادم MCP. |
|
|
127
|
-
| حدود كتابة أكثر أماناً | يفصل بين مسارات العمل التي تبدأ بالكود، أو تبدأ بالتوثيق، أو للقراءة فقط، أو للتوثيق فقط. |
|
|
128
|
-
| التحقق | يبلّغ عن مشكلات التوجيه والسلطة وfrontmatter والروابط والأسطح المولّدة ونطاق الفرع والحداثة والتغطية. |
|
|
129
|
-
| Portal اختياري | يولّد موقع عرض HTML ثابتاً وملتزماً به من وثائق حقيقة Markdown عندما يُفعّل ويُطلب ذلك صراحةً. |
|
|
130
|
-
|
|
131
|
-
## نظرة بصرية عامة
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
**الميزات:** ما يثبّته Truthmark وكيف ينقسم سطح سير العمل.
|
|
136
|
-
|
|
137
|
-
|
|
121
|
+
### توثيق يبدأ من الواقع
|
|
138
122
|
|
|
139
|
-
|
|
123
|
+
يستطيع Truthmark إنشاء توثيق لقدرات المنتج وسلوك التنفيذ وواجهات برمجة التطبيقات والمعمارية ومسارات العمل والعمليات والاختبارات. يقدّم الكود والاختبارات الأدلة، وتحفظ وثائق Markdown محددة النطاق النتيجة.
|
|
140
124
|
|
|
141
|
-
|
|
125
|
+
### توثيق يصمد أمام التغيير التالي
|
|
142
126
|
|
|
143
|
-
|
|
127
|
+
تربط المسارات مناطق الكود بالوثائق المعتمدة. وعندما يغيّر الوكلاء السلوك، يعرف Truth Sync أين تنتمي الحقيقة المقابلة ويحافظ على قابلية مراجعة التسليم.
|
|
144
128
|
|
|
145
|
-
|
|
129
|
+
### حقيقة المنتج والهندسة في مسارين منفصلين
|
|
146
130
|
|
|
147
|
-
|
|
131
|
+
تسجّل حقيقة المنتج الوعود الموجّهة للمستخدم والحدود والقرارات ومعايير القبول. وتسجّل حقيقة الهندسة السلوك الحالي والعقود والمعمارية ومسارات العمل والعمليات وسلوك الاختبارات.
|
|
148
132
|
|
|
149
|
-
|
|
133
|
+
### تعاون أصلي لـ Git
|
|
150
134
|
|
|
151
|
-
|
|
135
|
+
يعيش كل ما يهم في ملفات المستودع الملتزم بها. تتبع الحقيقة الفرع، وتعمل مع طلبات السحب العادية، وتبقى مرئية لكل صائن ووكيل برمجة.
|
|
152
136
|
|
|
153
|
-
|
|
137
|
+
### تشغيل محلي أولاً
|
|
154
138
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
يكون مفيداً عندما تحتاج إلى:
|
|
158
|
-
|
|
159
|
-
- انحراف أقل في التوثيق
|
|
160
|
-
- تسليمات أفضل
|
|
161
|
-
- حقيقة منتج خاصة بالفرع
|
|
162
|
-
- توثيق معماري وAPI دائم
|
|
163
|
-
- ملكية صريحة بين الوثائق والكود
|
|
164
|
-
- حدود كتابة أكثر أماناً للوكلاء
|
|
165
|
-
- توثيق قابل للمراجعة بدلاً من ذاكرة مخفية
|
|
166
|
-
- مسارات عمل ذكاء اصطناعي تستمر في العمل من ملفات المستودع الملتزم بها
|
|
139
|
+
لا يحتاج Truthmark إلى خدمة مستضافة أو برنامج خفي أو قاعدة بيانات أو مخزن متجهات أو خادم Model Context Protocol. يحمل المستودع مسار عمل التوثيق الخاص به.
|
|
167
140
|
|
|
168
141
|
## أين يندرج Truthmark
|
|
169
142
|
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
143
|
+
| الحاجة | الأنسب |
|
|
144
|
+
| -------------------------------------------- | -------------------------- |
|
|
145
|
+
| مخرجات أفضل من جلسة وكيل واحدة | مطالبة أفضل |
|
|
146
|
+
| استمرارية شخصية أو على مستوى الجلسة | أداة ذاكرة |
|
|
147
|
+
| تطوير ميزات يبدأ بالخطة | مسار عمل للمواصفات |
|
|
148
|
+
| توثيق مرتبط بالفرع ينتقل مع الكود | **Truthmark** |
|
|
149
|
+
| صحة السلوك | الاختبارات ومراجعة الكود |
|
|
150
|
+
| توثيق مدعوم بالذكاء الاصطناعي وقابل للمراجعة | **Truthmark + مراجعة Git** |
|
|
173
151
|
|
|
174
|
-
|
|
175
|
-
| --- | --- |
|
|
176
|
-
| مخرجات أفضل من جلسة وكيل واحدة | مطالبة أفضل |
|
|
177
|
-
| استمرارية شخصية أو على مستوى الجلسة | أداة ذاكرة |
|
|
178
|
-
| عمل ميزات يبدأ بالخطة | سير عمل مواصفات |
|
|
179
|
-
| حقيقة مرتبطة بالفرع تنتقل مع الكود | Truthmark |
|
|
180
|
-
| التحقق من صحة السلوك | الاختبارات والمراجعة |
|
|
181
|
-
| مراجعة تغييرات التوثيق المدعومة بالذكاء الاصطناعي | Truthmark مع مراجعة Git |
|
|
152
|
+
صُمّم Truthmark للصائنين وفرق الهندسة التي تستخدم بالفعل وكلاء البرمجة بالذكاء الاصطناعي وتريد أن يواصل المستودع قول الحقيقة بالسرعة نفسها التي يتغير بها الكود.
|
|
182
153
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
```text
|
|
186
|
-
make repository truth explicit
|
|
187
|
-
route it to code
|
|
188
|
-
تثبيت إرشادات الوكلاء حولها
|
|
189
|
-
keep the result reviewable in Git
|
|
190
|
-
```
|
|
154
|
+
## المضيفات المدعومة وسطر الأوامر
|
|
191
155
|
|
|
192
|
-
|
|
156
|
+
مضيفات الوكلاء المدعومة:
|
|
193
157
|
|
|
194
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
195
164
|
|
|
196
|
-
|
|
165
|
+
<details>
|
|
166
|
+
<summary>مرجع سطر الأوامر</summary>
|
|
197
167
|
|
|
198
|
-
|
|
168
|
+
| الأمر | الغرض |
|
|
169
|
+
| ----------------------------------------------------------------- | ------------------------------------------------------------------------- |
|
|
170
|
+
| `truthmark init` | ينشئ الإعدادات والتوجيه والقوالب ومسارات عمل المضيفات المختارة أو يحدّثها |
|
|
171
|
+
| `truthmark check [--base <ref>]` | يتحقق من حقيقة المستودع ويشغّل اختيارياً تشخيصات حداثة الفرع |
|
|
172
|
+
| `truthmark index --json` | يفحص بيانات المستودع والتوجيه الوصفية المشتقة |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | يربط الملفات المتغيرة بالوثائق والمالكين والاختبارات القريبة |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | يفحص قابلية تطبيق مسار العمل وأهدافه |
|
|
175
|
+
| `truthmark validate ...` | يتحقق من تقارير مسارات العمل وتصاريح الكتابة |
|
|
176
|
+
| `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | يعاين أسطح المضيف المولّدة أو يزيلها مع الحفاظ على الحقيقة المؤلّفة |
|
|
199
177
|
|
|
200
|
-
|
|
178
|
+
تتوفر مخرجات JSON منظّمة في جميع أجزاء واجهة سطر الأوامر للسكربتات والتكامل المستمر.
|
|
201
179
|
|
|
202
|
-
|
|
203
|
-
- تعليمات وكلاء محلية مولّدة لـ Codex وClaude Code وGitHub Copilot وOpenCode وAntigravity وCursor
|
|
204
|
-
- تشخيصات للتوجيه والسلطة وfrontmatter والروابط والحداثة والأسطح المولّدة ونطاق الفرع والتغطية
|
|
205
|
-
- وثائق حقيقة مرتبطة بالفرع وعناصر مستمدة لاستخبارات المستودع
|
|
180
|
+
</details>
|
|
206
181
|
|
|
207
|
-
##
|
|
182
|
+
## اعرف المزيد
|
|
208
183
|
|
|
209
|
-
- [دليل
|
|
210
|
-
- [فهرس
|
|
211
|
-
- [نظرة عامة على المعمارية](
|
|
212
|
-
- [عقود
|
|
213
|
-
- [
|
|
184
|
+
- [دليل مستخدم Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
|
|
185
|
+
- [فهرس التوثيق](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
|
|
186
|
+
- [نظرة عامة على المعمارية](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
|
|
187
|
+
- [عقود الإعداد والتوجيه والأوامر](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
188
|
+
- [المساهمة](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
|
|
214
189
|
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
## حدود التصميم
|
|
218
|
-
|
|
219
|
-
Truthmark صغير عمداً: محلي، ملتزم به، مرتبط بالفرع، وقابل للمراجعة.
|
|
220
|
-
|
|
221
|
-
إنه ليس خدمة مستضافة، ولا خادم MCP، ولا قاعدة بيانات متجهات، ولا طبقة ذاكرة مخفية، ولا منتج إنفاذ CI، ولا محركاً مستقلاً لإعادة كتابة الكود. يساعد حقيقة المستودع على البقاء مرئية؛ ولا يستبدل الاختبارات أو مراجعة الكود أو حكم البشر.
|
|
190
|
+
**ثبّت Truthmark، واختر مضيف البرمجة، وحوّل سلوكاً حقيقياً إلى توثيق اليوم.**
|
|
222
191
|
|
|
223
192
|
## الترخيص
|
|
224
193
|
|
|
225
194
|
MIT. راجع [LICENSE](../../LICENSE).
|
|
226
|
-
|
|
227
|
-
## إزالة آمنة
|
|
228
|
-
|
|
229
|
-
استخدم `truthmark uninstall --dry-run` لمراجعة أسطح الاستضافة المولّدة بدقة، ثم `truthmark uninstall --apply` لإزالتها. يتم الاحتفاظ بـ truth المؤلفة والتكوين والقوالب ومخرجات البوابة وملفات Gemini والملفات غير المتعلقة بالمستخدم؛ أزل التثبيت العالمي لـ npm بشكل منفصل عبر مدير الحزم.
|