Skip to content

Commit 98625f5

Browse files
docs: add changelog entry for init flags, profiles, and FORGE_GUARD_STRICT
1 parent dbae96f commit 98625f5

2 files changed

Lines changed: 41 additions & 0 deletions

File tree

mintlify/changelog/overview.mdx

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: "Changelog"
3+
description: "Product updates for the Forge CLI."
4+
---
5+
6+
<Update label="July 19, 2026">
7+
8+
## New features
9+
10+
**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).
11+
12+
**Reversible global settings merge.** Two new flags give you finer control over the global `~/.claude/settings.json` merge that `forge init` performs:
13+
14+
- `--no-settings` — scaffold the repo only; leave the global settings file untouched.
15+
- `--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.
16+
17+
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).
18+
19+
**`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).
20+
21+
## Updates
22+
23+
**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).
24+
25+
**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.
26+
27+
## Bug fixes
28+
29+
**`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.
30+
31+
</Update>

mintlify/docs.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,16 @@
7272
]
7373
}
7474
]
75+
},
76+
{
77+
"tab": "Changelog",
78+
"icon": "clock-rotate-left",
79+
"groups": [
80+
{
81+
"group": "Changelog",
82+
"pages": ["changelog/overview"]
83+
}
84+
]
7585
}
7686
]
7787
},

0 commit comments

Comments
 (0)