diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06cb647..166cc42 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -28,6 +28,9 @@
   loaded, imported, or configured external Jai files.
 - Indexed external Jai roots so find-usages can cross project/library boundaries.
 - Rename and find-usages support for declaration names and resolved references.
+- PSI-aware formatter with operator and punctuation spacing, block indentation,
+  directive-flag handling, and preservation of opaque `#asm` bodies; formatting
+  is idempotent across all 714 corpus files.
 
 ### Known gaps
 
diff --git a/README.md b/README.md
index 09bb581..03ec3ff 100644
--- a/README.md
+++ b/README.md
@@ -25,10 +25,13 @@ never from online material (see `AGENTS.md`).
   `#import`/`#load`, including configured external roots
 - Indexed external Jai roots so find-usages can cross project/library boundaries
 - Rename and find-usages for declaration names and their resolved references
+- PSI-aware formatting for operator and punctuation spacing, block indentation,
+  directive flags, and opaque `#asm` bodies; formatting is idempotent across the
+  full local corpus
 
 Remaining code-insight gaps include completion and symbol resolution for struct
-fields and other type-qualified members. Formatting, inspections, and compiler
-integration are planned later.
+fields and other type-qualified members. Inspections and compiler integration
+are planned later.
 See `docs/BUILD_PLAN.md` for the phase plan.
 
 ## Install it locally