From 8fcd2cca05e1087c2c104afb0abbe1b1c98928d8 Mon Sep 17 00:00:00 2001
From: hgranthorner <37941012+hgranthorner@users.noreply.github.com>
Date: Thu, 6 Aug 2026 15:50:54 -0400
Subject: [PATCH] Document formatter support

---
 CHANGELOG.md | 3 +++
 README.md    | 7 +++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

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