diff --git a/gitnexus/CHANGELOG.md b/gitnexus/CHANGELOG.md
index 7b75b9ec0..67073782e 100644
--- a/gitnexus/CHANGELOG.md
+++ b/gitnexus/CHANGELOG.md
@@ -2,6 +2,18 @@
 
 All notable changes to GitNexus will be documented in this file.
 
+## [Unreleased]
+
+### Added
+- Phase 8: Field and Property Type Resolution
+  - Field-type maps for TypeScript class/interface declarations
+  - Language-agnostic FieldExtractor interface and registry
+  - Chained property resolution support
+- Phase 9: Return-Type-Aware Variable Binding
+  - Call-result variable binding in TypeEnv
+  - FQN-aware return type lookup
+  - Enhanced pending assignment processing
+
 ## [1.4.8] - 2026-03-23
 
 ### Added
diff --git a/gitnexus/README.md b/gitnexus/README.md
index 43979d6ab..f9b361753 100644
--- a/gitnexus/README.md
+++ b/gitnexus/README.md
@@ -103,6 +103,8 @@ GitNexus builds a complete knowledge graph of your codebase through a multi-phas
 1. **Structure** — Walks the file tree and maps folder/file relationships
 2. **Parsing** — Extracts functions, classes, methods, and interfaces using Tree-sitter ASTs
 3. **Resolution** — Resolves imports and function calls across files with language-aware logic
+   - **Field & Property Type Resolution** — Tracks field types across classes and interfaces for deep chain resolution (e.g., `user.address.city.getName()`)
+   - **Return-Type-Aware Variable Binding** — Infers variable types from function return types, enabling accurate call-result binding
 4. **Clustering** — Groups related symbols into functional communities
 5. **Processes** — Traces execution flows from entry points through call chains
 6. **Search** — Builds hybrid search indexes for fast retrieval