From 63ef33c42fbb4882f0777228e75c14b159ae8df1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 19 Jul 2026 05:27:22 +0000 Subject: [PATCH 1/2] docs: add changelog with July 19 entry --- mintlify/changelog/overview.mdx | 30 ++++++++++++++++++++++++++++++ mintlify/docs.json | 10 ++++++++++ 2 files changed, 40 insertions(+) create mode 100644 mintlify/changelog/overview.mdx diff --git a/mintlify/changelog/overview.mdx b/mintlify/changelog/overview.mdx new file mode 100644 index 0000000..0ed5cb2 --- /dev/null +++ b/mintlify/changelog/overview.mdx @@ -0,0 +1,30 @@ +--- +title: "Changelog" +description: "What's new in Forge." +--- + + + +## Updates + +**`forge verify --deep` now reports a four-state result.** The multi-lens +consensus run no longer collapses to a binary pass/fail. You'll see one of +`PASS`, `FAIL`, `INCOMPLETE`, or `NOT_CONFIGURED`, so a stalled lens or an +unconfigured repo can't quietly read as green. Only `PASS` counts as verified, +and `PASS` now also requires the underlying `forge verify` tests status to be +`PASS` — a green deep run can never outrun a red base run. + +See [Quality commands](/cli/quality) and +[Verification gates](/concepts/verification-gates). + +**Completion gate requires test evidence for code changes.** For any session +that touched source code, the Stop-path completion gate no longer accepts a +`forge handoff` snapshot on its own. You'll need either a test file in the +session's diff or a fresh passing `forge verify` against the current changes. +Doc-only, config-only, and other non-code sessions are unaffected. + +When the gate blocks, the repair checklist now leads with `forge verify` so +the evidence gets recorded before the handoff snapshot. See +[Cross-session memory](/concepts/cross-session-memory). + + diff --git a/mintlify/docs.json b/mintlify/docs.json index 4100b2d..0c5bfd8 100644 --- a/mintlify/docs.json +++ b/mintlify/docs.json @@ -72,6 +72,16 @@ ] } ] + }, + { + "tab": "Changelog", + "icon": "newspaper", + "groups": [ + { + "group": "Changelog", + "pages": ["changelog/overview"] + } + ] } ] }, From bdcacb71fc405fd480362aaacea7ab0ab932aaac Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 19 Jul 2026 05:30:48 +0000 Subject: [PATCH 2/2] docs: translate changelog and improve English SEO frontmatter --- mintlify/ar/changelog/overview.mdx | 31 +++++++++++++++ mintlify/changelog/overview.mdx | 4 +- mintlify/cn/changelog/overview.mdx | 18 +++++++++ mintlify/docs.json | 50 +++++++++++++++++++++++++ mintlify/hi/changelog/overview.mdx | 31 +++++++++++++++ mintlify/zh-CN/changelog/overview.mdx | 18 +++++++++ mintlify/zh-Hans/changelog/overview.mdx | 18 +++++++++ 7 files changed, 168 insertions(+), 2 deletions(-) create mode 100644 mintlify/ar/changelog/overview.mdx create mode 100644 mintlify/cn/changelog/overview.mdx create mode 100644 mintlify/hi/changelog/overview.mdx create mode 100644 mintlify/zh-CN/changelog/overview.mdx create mode 100644 mintlify/zh-Hans/changelog/overview.mdx diff --git a/mintlify/ar/changelog/overview.mdx b/mintlify/ar/changelog/overview.mdx new file mode 100644 index 0000000..6d26e39 --- /dev/null +++ b/mintlify/ar/changelog/overview.mdx @@ -0,0 +1,31 @@ +--- +title: "سجل التغييرات: آخر تحديثات وميزات منصة Forge الرسمية" +description: "استعرض أحدث ميزات Forge وتحسيناته، بما في ذلك تحديثات نتائج التحقق العميق متعدد الحالات وبوابات إكمال الجلسات المُطوَّرة حديثاً لضمان الجودة." +--- + + + +## التحديثات + +**`forge verify --deep` أصبح يُبلّغ الآن عن نتيجة رباعية الحالات.** لم يعد +تشغيل الإجماع متعدد العدسات يُختزل إلى نجاح أو فشل ثنائي. سترى إحدى النتائج +`PASS` أو `FAIL` أو `INCOMPLETE` أو `NOT_CONFIGURED`، بحيث لا يمكن لعدسة +متوقفة أو مستودع غير مُهيّأ أن يظهر بصمت على أنه أخضر. فقط `PASS` تُحتسب على +أنها متحقق منها، كما أن `PASS` تتطلب الآن أيضاً أن تكون حالة اختبارات +`forge verify` الأساسية `PASS` — فلا يمكن أبداً لتشغيل عميق أخضر أن يتجاوز +تشغيلاً أساسياً أحمر. + +راجع [أوامر الجودة](/ar/cli/quality) و +[بوابات التحقق](/ar/concepts/verification-gates). + +**بوابة الإكمال تتطلب دليلاً من الاختبارات لتغييرات الكود.** لأي جلسة +مسّت الكود المصدري، لم تعد بوابة إكمال مسار Stop تقبل لقطة `forge handoff` +وحدها. ستحتاج إما إلى ملف اختبار في تغييرات الجلسة أو إلى تشغيل ناجح جديد +لـ `forge verify` مقابل التغييرات الحالية. أما الجلسات الخاصة بالوثائق فقط +أو بالإعدادات فقط أو الجلسات غير البرمجية الأخرى فلا تتأثر. + +عندما تُغلق البوابة الطريق، تبدأ قائمة الإصلاح الآن بـ `forge verify` كي +يُسجَّل الدليل قبل لقطة التسليم. راجع +[الذاكرة عبر الجلسات](/ar/concepts/cross-session-memory). + + diff --git a/mintlify/changelog/overview.mdx b/mintlify/changelog/overview.mdx index 0ed5cb2..435974a 100644 --- a/mintlify/changelog/overview.mdx +++ b/mintlify/changelog/overview.mdx @@ -1,6 +1,6 @@ --- -title: "Changelog" -description: "What's new in Forge." +title: "Changelog: what's new in Forge" +description: "Weekly release notes for Forge — new features, updates, and fixes for the CLI, verification gates, and cross-session memory layer." --- diff --git a/mintlify/cn/changelog/overview.mdx b/mintlify/cn/changelog/overview.mdx new file mode 100644 index 0000000..2c2b894 --- /dev/null +++ b/mintlify/cn/changelog/overview.mdx @@ -0,0 +1,18 @@ +--- +title: "更新日志" +description: "了解 Forge 的最新动态、功能改进与行为变更，帮助你及时掌握每次发布中影响验证、会话与交接流程的关键更新。" +--- + + + +## 更新内容 + +**`forge verify --deep` 现在会报告四态结果。** 多视角共识运行不再折叠为二元的通过/失败。你会看到 `PASS`、`FAIL`、`INCOMPLETE` 或 `NOT_CONFIGURED` 中的其中一个，因此停滞的视角或未配置的仓库不会悄悄被视为通过。只有 `PASS` 才算已验证，并且 `PASS` 现在还要求底层 `forge verify` 测试状态也为 `PASS` —— 绿色的深度运行永远无法覆盖红色的基础运行。 + +参见 [质量命令](/cn/cli/quality) 和 [验证门](/cn/concepts/verification-gates)。 + +**完成门要求对代码变更提供测试证据。** 对于任何涉及源代码的会话，Stop 路径的完成门不再单独接受 `forge handoff` 快照。你需要在会话的差异中包含测试文件，或针对当前变更提供一次新鲜且通过的 `forge verify`。仅文档、仅配置以及其他非代码类会话不受影响。 + +当该门拦截时，修复清单现在会以 `forge verify` 为首，以便在生成交接快照之前先记录证据。参见 [跨会话记忆](/cn/concepts/cross-session-memory)。 + + diff --git a/mintlify/docs.json b/mintlify/docs.json index 0c5bfd8..774764a 100644 --- a/mintlify/docs.json +++ b/mintlify/docs.json @@ -139,6 +139,16 @@ ] } ] + }, + { + "tab": "更新日志", + "icon": "newspaper", + "groups": [ + { + "group": "更新日志", + "pages": ["cn/changelog/overview"] + } + ] } ] }, @@ -196,6 +206,16 @@ ] } ] + }, + { + "tab": "سجل التغييرات", + "icon": "newspaper", + "groups": [ + { + "group": "سجل التغييرات", + "pages": ["ar/changelog/overview"] + } + ] } ] }, @@ -253,6 +273,16 @@ ] } ] + }, + { + "tab": "चेंजलॉग", + "icon": "newspaper", + "groups": [ + { + "group": "चेंजलॉग", + "pages": ["hi/changelog/overview"] + } + ] } ] }, @@ -310,6 +340,16 @@ ] } ] + }, + { + "tab": "更新日志", + "icon": "newspaper", + "groups": [ + { + "group": "更新日志", + "pages": ["zh-CN/changelog/overview"] + } + ] } ] }, @@ -367,6 +407,16 @@ ] } ] + }, + { + "tab": "更新日志", + "icon": "newspaper", + "groups": [ + { + "group": "更新日志", + "pages": ["zh-Hans/changelog/overview"] + } + ] } ] } diff --git a/mintlify/hi/changelog/overview.mdx b/mintlify/hi/changelog/overview.mdx new file mode 100644 index 0000000..72f25a5 --- /dev/null +++ b/mintlify/hi/changelog/overview.mdx @@ -0,0 +1,31 @@ +--- +title: "चेंजलॉग: Forge के नवीनतम रिलीज़ और अपडेट का विवरण" +description: "Forge में नया क्या है — नवीनतम रिलीज़, सुधार, वेरिफिकेशन गेट में बदलाव, नई सुविधाएँ, और डेवलपर वर्कफ़्लो अपडेट का पूरा विवरण यहाँ पढ़ें।" +--- + + + +## अपडेट + +**`forge verify --deep` अब चार-स्थिति वाला परिणाम रिपोर्ट करता है।** मल्टी-लेंस +कंसेंसस रन अब बाइनरी पास/फेल में सिमटकर नहीं रह जाता। आपको `PASS`, `FAIL`, +`INCOMPLETE`, या `NOT_CONFIGURED` में से एक दिखाई देगा, ताकि कोई अटका हुआ लेंस +या अनकॉन्फ़िगर्ड रेपो चुपचाप हरा न पढ़ा जा सके। केवल `PASS` को ही वेरिफाइड माना +जाता है, और अब `PASS` के लिए यह भी आवश्यक है कि अंतर्निहित `forge verify` +टेस्ट स्थिति `PASS` हो — एक हरा डीप रन कभी भी लाल बेस रन से आगे नहीं निकल सकता। + +देखें [Quality commands](/hi/cli/quality) और +[Verification gates](/hi/concepts/verification-gates)। + +**कोड परिवर्तनों के लिए कंप्लीशन गेट को टेस्ट साक्ष्य की आवश्यकता है।** किसी भी +ऐसे सेशन के लिए जिसने सोर्स कोड को छुआ हो, Stop-path कंप्लीशन गेट अब अकेले +`forge handoff` स्नैपशॉट को स्वीकार नहीं करता। आपको या तो सेशन के डिफ़ में एक +टेस्ट फ़ाइल की आवश्यकता होगी, या मौजूदा परिवर्तनों के विरुद्ध एक ताज़ा पासिंग +`forge verify` की। केवल-दस्तावेज़, केवल-कॉन्फ़िग, और अन्य गैर-कोड सेशन प्रभावित +नहीं होते। + +जब गेट ब्लॉक करता है, तो रिपेयर चेकलिस्ट अब `forge verify` से शुरू होती है ताकि +हैंडऑफ़ स्नैपशॉट से पहले साक्ष्य दर्ज हो जाए। देखें +[Cross-session memory](/hi/concepts/cross-session-memory)। + + diff --git a/mintlify/zh-CN/changelog/overview.mdx b/mintlify/zh-CN/changelog/overview.mdx new file mode 100644 index 0000000..c49cfe2 --- /dev/null +++ b/mintlify/zh-CN/changelog/overview.mdx @@ -0,0 +1,18 @@ +--- +title: "更新日志" +description: "Forge 的最新变化、功能更新与改进说明,帮助你及时掌握验证、会话与命令行工具的所有关键升级信息。" +--- + + + +## 更新内容 + +**`forge verify --deep` 现在返回四态结果。** 多视角共识运行不再折叠为二元的通过/失败结果。你将看到 `PASS`、`FAIL`、`INCOMPLETE` 或 `NOT_CONFIGURED` 中的一种,因此停滞的视角或未配置的仓库不会再被悄悄标记为绿色。只有 `PASS` 才算作已验证,而 `PASS` 现在还要求底层 `forge verify` 的测试状态也为 `PASS`——绿色的深度运行永远无法凌驾于红色的基础运行之上。 + +参见[质量命令](/zh-CN/cli/quality)和[验证门](/zh-CN/concepts/verification-gates)。 + +**完成门要求代码变更提供测试证据。** 对于任何触及源代码的会话,Stop 路径上的完成门不再单独接受 `forge handoff` 快照。你需要在会话的 diff 中包含一个测试文件,或针对当前变更提供一次新鲜通过的 `forge verify`。仅涉及文档、仅涉及配置以及其他非代码类会话不受影响。 + +当此门拦截时,修复检查清单现在会以 `forge verify` 作为首要步骤,以便在生成 handoff 快照之前先记录证据。参见[跨会话记忆](/zh-CN/concepts/cross-session-memory)。 + + diff --git a/mintlify/zh-Hans/changelog/overview.mdx b/mintlify/zh-Hans/changelog/overview.mdx new file mode 100644 index 0000000..acf2d01 --- /dev/null +++ b/mintlify/zh-Hans/changelog/overview.mdx @@ -0,0 +1,18 @@ +--- +title: "更新日志" +description: "了解 Forge 的最新变化、功能更新与关键行为调整，帮助你及时掌握验证门与会话记忆等核心能力的演进。" +--- + + + +## 更新内容 + +**`forge verify --deep` 现在会报告四种状态的结果。** 多视角共识运行不再折叠成"通过/失败"的二元结果。你会看到 `PASS`、`FAIL`、`INCOMPLETE` 或 `NOT_CONFIGURED` 中的一种，因此停滞的视角或未配置的仓库不再会被悄悄识别为通过。只有 `PASS` 才算作已验证，并且 `PASS` 现在还要求底层 `forge verify` 测试状态也为 `PASS`——一次绿色的深度运行永远无法盖过一次红色的基础运行。 + +参见 [质量命令](/zh-Hans/cli/quality) 与 [验证门](/zh-Hans/concepts/verification-gates)。 + +**完成门要求代码变更提供测试证据。** 对于任何触及源代码的会话，Stop 路径的完成门都不再仅凭一次 `forge handoff` 快照就予以放行。你需要会话 diff 中包含测试文件，或者针对当前变更提供一次新鲜的、通过的 `forge verify`。仅涉及文档、仅涉及配置以及其他非代码会话不受影响。 + +当完成门拦截时，修复清单现在会以 `forge verify` 起头，以便先记录证据，再进行 handoff 快照。参见 [跨会话记忆](/zh-Hans/concepts/cross-session-memory)。 + +