This file is the rolling anchor for documentation sync. It records the last
commit at which a full docs sweep confirmed the docs/ tree (and
.claude/skills/forge.md) reflect the code. The /sync-docs process reads it
so each run only has to cover changes since the anchor, not all of history.
Current anchor
| Field | Value |
|---|---|
| Anchor commit | 2f0649e (main HEAD audited by this sweep) |
| Anchor tag/context | v0.17.1 → v0.18.1 (120 commits / ~42 PRs) |
| Last full sweep | 2026-08-21 |
The next sweep only needs git diff 2f0649e..main --name-only.
How to run the next sweep
git diff <anchor>..main --name-only— the code that changed since the anchor.- Map each changed path to its docs via the table in the
/sync-docsskill. - For each mapped doc, verify it reflects the change; edit where stale/missing.
- Broken-link check (
greploop in the skill). - Update Anchor commit above to the new
mainHEAD and commit.
Between full sweeps, per-PR /sync-docs still updates docs inline with each
feature; this anchor is the backstop that catches anything a per-PR run missed.
Baseline sweep (v0.17.1 → v0.18.1)
A full sweep (5 parallel domain audits) covered everything merged between
v0.17.1 (the previous CHANGELOG rollover) and v0.18.1. Gaps found and filled:
- forge-yaml-schema.md — added the entire
mcp:block (auth types, grants, tools), theapis:block (per-op API tools), thepdp:block, and egressallowed_tcp/allowed_private_cidrs; addeddeferapprover fields. - audit-logging.md — added
llm_call_failed+mcp_auth_required/resolved/timeoutto the event catalog; documented always-onfields.errorredaction, channel-sender attribution onauth_verify, andllm_call.urluserinfo stripping. - defer-decisions.md — corrected the stale “deferral abandoned / cap timeout ≤ 6m” note for the #402 task-detach (task now survives caller disconnect).
- tools-and-builtins.md — removed the deleted
openapi_calladapter; documented per-opapis.servers→<name>__<op>tools (#400). - memory-system.md — the
remotesession store attaches independent ofmemory.persistence(#372/#373). - platform-policy.md — new managed PDP section (#399).
- tenancy.md — platform-callout
Org-Id/Workspace-Idheaders. - channels.md — Slack raw-JSON suppression +
<<ctxzip:…>>marker stripping (#384). - skill-md-format.md / writing-custom-skills.md — fixed stale “runs via bash” → per-interpreter (#405 D2).
- cli-reference.md — added the
forge mcpsection and the startup version banner (#335/#336). - mcp/ — de-staled the “seven events” framing + added consent-gate events; tool-name regex (#370); delegated-token 5-min TTL cap (#380).
- .claude/skills/forge.md — de-staled R10 (delegated identity is implemented, not proposed; correct event names).