Forge v0.3.3
Forge v0.3.3 focuses on long-session reliability, faithful resume behavior,
safer approvals, and clearer terminal feedback.
Highlights
- Added context-pressure reporting, explicit compaction controls, prompt-cache
observability, and memory-only scoped session approvals. - Replaced text-only resume reconstruction with provider-neutral canonical
conversation history while keeping completed tool calls and results paired. - Added session schema v3, checkpoint v2 validation, conservative migration,
and cross-layer resume contract tests. - Prevented oversized snapshots from replacing the previous durable snapshot
and preserved safety context when cancellation follows a tool side effect. - Hardened destructive-command classification across absolute paths and common
shell or interpreter wrappers. - Improved approval previews, semantic file diffs, visible edit activity, and
descriptor-driven unavailable choices. - Added versioned documentation roles and clean-installed checks for packaged
documentation and built-in Skills.
Install
Forge requires Node.js 24 or later.
npm install --global @jslee124/forge@0.3.3
forge --versionExisting text-only sessions migrate conservatively. Historical tool output
never restores approval, policy, trust, process, or continuation authority.
Context compaction remains opt-in and defaults to warn.
Verification
The deterministic post-fix matrix, dependency audit, clean package install, and
bounded live-provider resume evidence are recorded in the
v0.3.3 release report.
The live smoke covered native DeepSeek and Luna Codex Engine through a ChatGPT
subscription. Native OpenAI API behavior was not part of that smoke. Prompt
cache hit rates and live task quality are not inferred from deterministic
fixtures.
Full Changelog: v0.3.2...v0.3.3