Forge v0.3.4

Forge v0.3.4 makes file editing more reliable, keeps context compaction under
explicit user control, and strengthens the interactive terminal lifecycle.

Highlights

• Unified model-facing file creation, patching, and rewriting behind
  edit_file, with operation-specific contracts and approval previews.
• Added content-hash guards so stale edits cannot silently overwrite concurrent
  user changes; create never overwrites and rewrite never creates.
• Kept legacy v0.3.3 tool exchanges readable during resume while advertising
  only the current edit_file contract to new model requests.
• Split the interactive CLI into focused activity, approval, context,
  lifecycle, prompt, provider, resource, transcript, and type modules while
  preserving the public facade.
• Renamed context modes to Manual and Automatic. Manual remains the permanent
  default; Automatic is an explicit session or saved user opt-in.
• Added one-time migration from v0.3.3 warn/compact configuration and
  pressure records to canonical manual/automatic names.
• Fixed terminal listener cleanup across repeated render, exit, and resume
  cycles, with regression tests and a real Ghostty smoke.

Install

Forge requires Node.js 24 or later.

npm install --global @jslee124/forge@0.3.4
forge --version

Existing configuration and session history migrate conservatively. Automatic
compaction is not enabled during upgrade.

Verification

The exact implementation candidate passed the full offline matrix: 360 tests,
71 deterministic evaluation checks, documentation validation, clean package
installation, and a real Ghostty exit/resume smoke. See the
v0.3.4 Milestone 15 release gates.

The authorized DeepSeek trials were development evidence rather than
exact-release-commit evidence. Native OpenAI API behavior was not live-tested
for this release, and live model quality is not inferred from deterministic
fixtures.

Full Changelog: v0.3.3...v0.3.4