Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions mintlify/ar/changelog/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: "سجل تغييرات Forge CLI"
description: "تحديثات المنتج الأسبوعية لـ Forge CLI — أوامر وعلامات ومتغيرات بيئة جديدة، وتغييرات في السياسات، وإصلاحات الأخطاء التي شُحنت إلى المستخدمين."
---

<Update label="July 19, 2026">

## ميزات جديدة

**علامة ملف تعريف السياسة لـ `forge init`.** أصبح بإمكانك الآن اختيار مجموعة القواعد وقت التهيئة عبر `forge init --profile <name>`. القيم المدعومة هي `minimal` (مجموعة قواعد أخف للمستودعات الصغيرة أو forks المساهمين) و`standard` (الحزمة الكاملة الافتراضية — قواعد الذاكرة المشتركة، وتحليل الأثر، ومجموعة خطافات الحواجز الكاملة). القيم غير الصالحة تُجهض العملية قبل كتابة أي ملفات أو دمج أي إعدادات، حتى لا يترك خطأ إملائي مستودعًا مُهيَّأً نصفيًا خلفه. راجع [علامات `forge init`](/ar/cli/core#init-flags).

**دمج قابل للتراجع لإعدادات الجلوبال.** علامتان جديدتان تمنحانك تحكمًا أدق في دمج ملف `~/.claude/settings.json` الجلوبال الذي يُجريه `forge init`:

- `--no-settings` — تهيئة المستودع فقط؛ اترك ملف الإعدادات الجلوبال دون مساس.
- `--remove-settings` — تراجع عن دمج سابق. تُزال الخطافات والصلاحيات وstatusline والعلامة `_forge` ذات الشكل الخاص بـ Forge، مع الحفاظ على مدخلاتك الخاصة، وتُكتب نسخة احتياطية موسومة بالوقت أولًا. `install.sh --uninstall` يستدعي هذا نيابةً عنك.

توجد أيضًا `--settings-only` للحالة العكسية: توصيل الخطافات الجلوبال دون المساس بالمستودع الحالي. التفاصيل في [علامات `forge init`](/ar/cli/core#init-flags).

**`FORGE_GUARD_STRICT` لحجب صارم لإخفاء الأسرار.** اضبط `FORGE_GUARD_STRICT=1` لترقية تحذير `DEGRADED` لمُنقّي الأسرار إلى خروج حاجب. افتراضيًا، يطبع فشل الإخفاء إلى stderr ويترك المخرَج يمر؛ الوضع الصارم يرفض إصدار أي شيء لم يستطع المنقّي تنظيفه كاملًا. مُوصى به في CI والأجهزة المشتركة حيث سطر غير مُخفَى أسوأ من أمر فاشل. راجع [مرجع متغيرات البيئة](/ar/cli/overview#environment-variables).

## تحديثات

**تقليص مجموعة ملفات تعريف السياسة إلى اثنين.** قائمة ملفات التعريف صارت فقط `minimal` و`standard`. الأسماء القديمة `web-app` و`backend-service` و`library` و`regulated` هي أسماء بديلة مهجورة لـ `standard` — لا تزال تعمل، ويُحذّر `forge init` مرة واحدة، وتتزامن الإعدادات القائمة بوصفها `standard`. ينبغي للمستودعات الجديدة استخدام `standard` مباشرة. السياق الكامل في [ملفات تعريف السياسة](/ar/cli/core#policy-profiles).

**متغيرات البيئة موثقة الآن في مكان واحد.** تحتوي نظرة عامة على CLI الآن على جدول جديد لـ [متغيرات البيئة](/ar/cli/overview#environment-variables) يغطي `FORGE_ENFORCE` و`FORGE_GUARD_STRICT` و`FORGE_NO_UPDATE_CHECK` و`FORGE_NO_HINT` و`FORGE_VERBOSE` و`FORGE_EMBED` في مكان واحد.

## إصلاحات الأخطاء

**`forge init` يفشل بصوت عالٍ عند دمج إعدادات معطوب.** إذا رُفض دمج الإعدادات الجلوبال أو حدث خطأ فيه، يخرج `forge init` الآن برمز 1 ويكتب السبب إلى stderr بدلًا من الإبلاغ بالنجاح. سابقًا، كان الدمج الجزئي أو المتخطَّى قد يبدو كتشغيل نظيف.

</Update>
31 changes: 31 additions & 0 deletions mintlify/changelog/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: "Forge CLI changelog"
description: "Weekly product updates for the Forge CLI — new commands, flags, environment variables, policy changes, and bug fixes shipped to users."
---

<Update label="July 19, 2026">

## New features

**Policy profile flag for `forge init`.** You can now pick a ruleset at scaffold time with `forge init --profile <name>`. The supported values are `minimal` (leaner ruleset for small repos or contributor forks) and `standard` (the default full pack — shared memory rules, impact analysis, and the complete guardrail hook set). Invalid values abort before any files are written or settings are merged, so a typo can't leave a half-configured repo behind. See [`forge init` flags](/cli/core#init-flags).

**Reversible global settings merge.** Two new flags give you finer control over the global `~/.claude/settings.json` merge that `forge init` performs:

- `--no-settings` — scaffold the repo only; leave the global settings file untouched.
- `--remove-settings` — undo a previous merge. Forge-shaped hooks, permissions, statusline, and the `_forge` marker are removed, your own entries are preserved, and a timestamped backup is written first. `install.sh --uninstall` calls this for you.

There's also `--settings-only` for the reverse case: wire up global hooks without touching the current repo. Details in [`forge init` flags](/cli/core#init-flags).

**`FORGE_GUARD_STRICT` for hard-blocking secret redaction.** Set `FORGE_GUARD_STRICT=1` to promote the secret redactor's `DEGRADED` warning into a blocking exit. By default a redaction failure prints to stderr and lets output through; strict mode refuses to emit anything the redactor couldn't fully scrub. Recommended for CI and shared machines where an unredacted line is worse than a failed command. See the [environment variables reference](/cli/overview#environment-variables).

## Updates

**Policy profile set collapsed to two.** The profile list is now just `minimal` and `standard`. The legacy names `web-app`, `backend-service`, `library`, and `regulated` are deprecated aliases of `standard` — they still work, `forge init` warns once, and existing configs sync as `standard`. New repos should use `standard` directly. Full context in [Policy profiles](/cli/core#policy-profiles).

**Environment variables now documented in one place.** The CLI overview has a new [Environment variables](/cli/overview#environment-variables) table covering `FORGE_ENFORCE`, `FORGE_GUARD_STRICT`, `FORGE_NO_UPDATE_CHECK`, `FORGE_NO_HINT`, `FORGE_VERBOSE`, and `FORGE_EMBED` in one place.

## Bug fixes

**`forge init` fails loudly on a broken settings merge.** If the global settings merge is refused or errors, `forge init` now exits with code 1 and writes the reason to stderr instead of reporting success. Previously a partial or skipped merge could look like a clean run.

</Update>
31 changes: 31 additions & 0 deletions mintlify/cn/changelog/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: "Forge CLI 更新日志"
description: "Forge CLI 每周产品更新——面向用户上线的新命令、标志、环境变量、策略变更和 bug 修复。"
---

<Update label="July 19, 2026">

## 新功能

**`forge init` 的策略档位标志。** 现在可以在脚手架阶段用 `forge init --profile <name>` 挑选一套规则集。支持的取值是 `minimal`(面向小型仓库或贡献者 fork 的精简规则集)和 `standard`(默认的完整包——共享记忆规则、影响分析和完整的护栏 hook 集合)。取值非法时会在任何文件写入或设置合并之前中止,所以一个拼写错误不会给你留下一个配置到一半的仓库。参见 [`forge init` 标志](/cn/cli/core#init-flags)。

**可撤销的全局设置合并。** 两个新标志让你对 `forge init` 执行的全局 `~/.claude/settings.json` 合并有更细的控制:

- `--no-settings` —— 只搭建仓库脚手架;不动全局设置文件。
- `--remove-settings` —— 撤销一次之前的合并。Forge 形态的 hooks、permissions、statusline 以及 `_forge` 标记会被移除,你自己的条目保留,并会先写入一份带时间戳的备份。`install.sh --uninstall` 会替你调用它。

反向场景也有对应的 `--settings-only`:接入全局 hooks,但不动当前仓库。细节见 [`forge init` 标志](/cn/cli/core#init-flags)。

**`FORGE_GUARD_STRICT` 用于硬阻塞式秘密脱敏。** 设置 `FORGE_GUARD_STRICT=1` 可以把秘密脱敏器的 `DEGRADED` 警告升级为阻塞式退出。默认情况下,一次脱敏失败会把信息打到 stderr 并放行输出;严格模式则拒绝输出任何脱敏器没能完全清洗干净的内容。推荐在 CI 和共享机器上使用——那里一行未脱敏内容比一次失败的命令更糟。参见[环境变量参考](/cn/cli/overview#environment-variables)。

## 更新

**策略档位集合收敛为两个。** 档位列表现在只有 `minimal` 和 `standard`。旧名称 `web-app`、`backend-service`、`library` 和 `regulated` 已弃用,作为 `standard` 的别名——它们仍然可用,`forge init` 会警告一次,已有配置会同步为 `standard`。新仓库应直接使用 `standard`。完整上下文见[策略档位](/cn/cli/core#policy-profiles)。

**环境变量现在集中在一处记录。** CLI 概览新增了一张[环境变量](/cn/cli/overview#environment-variables)表,把 `FORGE_ENFORCE`、`FORGE_GUARD_STRICT`、`FORGE_NO_UPDATE_CHECK`、`FORGE_NO_HINT`、`FORGE_VERBOSE` 和 `FORGE_EMBED` 集中放在了一起。

## Bug 修复

**`forge init` 在设置合并失败时会明确报错。** 如果全局设置合并被拒绝或出错,`forge init` 现在会以退出码 1 退出,并把原因写到 stderr,而不是汇报成功。以前部分合并或跳过合并可能看起来像一次干净的运行。

</Update>
60 changes: 60 additions & 0 deletions mintlify/docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,16 @@
]
}
]
},
{
"tab": "Changelog",
"icon": "clock-rotate-left",
"groups": [
{
"group": "Changelog",
"pages": ["changelog/overview"]
}
]
}
]
},
Expand Down Expand Up @@ -129,6 +139,16 @@
]
}
]
},
{
"tab": "更新日志",
"icon": "clock-rotate-left",
"groups": [
{
"group": "更新日志",
"pages": ["cn/changelog/overview"]
}
]
}
]
},
Expand Down Expand Up @@ -186,6 +206,16 @@
]
}
]
},
{
"tab": "سجل التغييرات",
"icon": "clock-rotate-left",
"groups": [
{
"group": "سجل التغييرات",
"pages": ["ar/changelog/overview"]
}
]
}
]
},
Expand Down Expand Up @@ -243,6 +273,16 @@
]
}
]
},
{
"tab": "चेंजलॉग",
"icon": "clock-rotate-left",
"groups": [
{
"group": "चेंजलॉग",
"pages": ["hi/changelog/overview"]
}
]
}
]
},
Expand Down Expand Up @@ -300,6 +340,16 @@
]
}
]
},
{
"tab": "更新日志",
"icon": "clock-rotate-left",
"groups": [
{
"group": "更新日志",
"pages": ["zh-CN/changelog/overview"]
}
]
}
]
},
Expand Down Expand Up @@ -357,6 +407,16 @@
]
}
]
},
{
"tab": "更新日志",
"icon": "clock-rotate-left",
"groups": [
{
"group": "更新日志",
"pages": ["zh-Hans/changelog/overview"]
}
]
}
]
}
Expand Down
31 changes: 31 additions & 0 deletions mintlify/hi/changelog/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: "Forge CLI चेंजलॉग"
description: "Forge CLI के लिए साप्ताहिक उत्पाद अपडेट — उपयोगकर्ताओं तक पहुँचाए गए नए कमांड, फ़्लैग, एन्वायरनमेंट वेरिएबल्स, नीति परिवर्तन, और बग फ़िक्स।"
---

<Update label="July 19, 2026">

## नई सुविधाएँ

**`forge init` के लिए पॉलिसी प्रोफ़ाइल फ़्लैग।** अब आप स्कैफ़ोल्ड समय पर `forge init --profile <name>` के साथ एक ruleset चुन सकते हैं। समर्थित मान `minimal` (छोटे रेपो या कॉन्ट्रिब्यूटर फ़ोर्क्स के लिए हल्का ruleset) और `standard` (डिफ़ॉल्ट पूर्ण पैक — साझा मेमोरी नियम, इम्पैक्ट विश्लेषण, और पूरा guardrail hook सेट) हैं। अमान्य मान किसी भी फ़ाइल के लिखे जाने या settings मर्ज होने से पहले ही रोक देते हैं, इसलिए एक टाइपो आधे-कॉन्फ़िगर्ड रेपो को पीछे नहीं छोड़ सकता। देखें [`forge init` flags](/hi/cli/core#init-flags).

**प्रत्यावर्तनीय ग्लोबल settings मर्ज।** दो नए फ़्लैग आपको उस ग्लोबल `~/.claude/settings.json` मर्ज पर बेहतर नियंत्रण देते हैं जिसे `forge init` करता है:

- `--no-settings` — केवल रेपो स्कैफ़ोल्ड करें; ग्लोबल settings फ़ाइल को अछूता छोड़ दें।
- `--remove-settings` — पिछले मर्ज को पूर्ववत करें। Forge-आकार के hooks, permissions, statusline, और `_forge` मार्कर हटा दिए जाते हैं, आपकी अपनी प्रविष्टियाँ संरक्षित रहती हैं, और पहले एक टाइमस्टैम्प्ड बैकअप लिखा जाता है। `install.sh --uninstall` आपके लिए यह कॉल करता है।

विपरीत स्थिति के लिए `--settings-only` भी है: वर्तमान रेपो को छुए बिना ग्लोबल hooks वायर करें। विवरण [`forge init` flags](/hi/cli/core#init-flags) में।

**हार्ड-ब्लॉकिंग secret redaction के लिए `FORGE_GUARD_STRICT`।** secret redactor की `DEGRADED` चेतावनी को एक ब्लॉकिंग exit में बदलने के लिए `FORGE_GUARD_STRICT=1` सेट करें। डिफ़ॉल्ट रूप से एक redaction विफलता stderr पर प्रिंट होती है और आउटपुट को पास होने देती है; strict मोड कुछ भी उत्सर्जित करने से मना कर देता है जिसे redactor पूरी तरह स्क्रब नहीं कर सका। CI और साझा मशीनों के लिए अनुशंसित जहाँ एक बिना-redacted पंक्ति एक विफल कमांड से बुरी हो। देखें [environment variables reference](/hi/cli/overview#environment-variables).

## अपडेट

**पॉलिसी प्रोफ़ाइल सेट सिमटकर दो पर।** प्रोफ़ाइल सूची अब केवल `minimal` और `standard` है। पुराने नाम `web-app`, `backend-service`, `library`, और `regulated` अब `standard` के डेप्रिकेटेड उपनाम हैं — वे अब भी काम करते हैं, `forge init` एक बार चेतावनी देता है, और मौजूदा configs `standard` के रूप में सिंक होते हैं। नए रेपो को सीधे `standard` का उपयोग करना चाहिए। पूरा संदर्भ [पॉलिसी प्रोफ़ाइल्स](/hi/cli/core#policy-profiles) में।

**एन्वायरनमेंट वेरिएबल्स अब एक जगह प्रलेखित।** CLI अवलोकन में एक नई [एन्वायरनमेंट वेरिएबल्स](/hi/cli/overview#environment-variables) तालिका है जो `FORGE_ENFORCE`, `FORGE_GUARD_STRICT`, `FORGE_NO_UPDATE_CHECK`, `FORGE_NO_HINT`, `FORGE_VERBOSE`, और `FORGE_EMBED` को एक जगह कवर करती है।

## बग फ़िक्स

**टूटे settings मर्ज पर `forge init` ज़ोर से विफल होता है।** यदि ग्लोबल settings मर्ज अस्वीकृत होता है या त्रुटि देता है, तो `forge init` अब सफलता की रिपोर्ट करने के बजाय exit कोड 1 के साथ बाहर निकलता है और stderr पर कारण लिखता है। पहले एक आंशिक या छोड़ा गया मर्ज एक साफ़ रन जैसा दिख सकता था।

</Update>
Loading