refactor(wit): discover worlds and package with the AST parser

CHANGELOG.md

@@ -7,13 +7,29 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Changed
+
+- World and package discovery (`DiscoverWorlds`, `DiscoverPackage`) read the WIT
+  with the AST parser instead of line-based regular expressions, so versioned
+  packages (`package wasi:cli@0.2.0;`), commented-out declarations, several
+  declarations on one line and `use`, `variant` or `flags` declarations are
+  handled. A file that does not parse is now an error naming the file instead of
+  being skipped silently.
+- The AST parser moved to `tools/common/wit/ast` (shared on `main`, so other
+  language plugins can use it).
+
 ## [0.3.1] - 2026-09-20
 
 ### Added
 
-- Support for WIT `resource` declarations in AST parser (`tools/please_wit/ast`).
-- Support for `constructor`, instance methods, and `static` functions inside resource blocks.
-- Resource interface generation across Kotlin, Swift, TypeScript, Python, Rust, Go, and C++ code generators.
+- Support for WIT `resource` declarations in AST parser
+  (`tools/please_wit/ast`).
+- Support for `constructor`, instance methods, and `static` functions inside
+  resource blocks.
+- Resource interface generation across Kotlin, Swift, TypeScript, Python, Rust,
+  Go, and C++ code generators.
 
 ## [0.3.0] - 2026-09-19
 

docs/wit/architecture.md

@@ -30,7 +30,7 @@ access.
 
 ## 2. Standalone Go AST Parser Architecture
 
-`please_wit` embeds a lightweight lexer and parser in `tools/please_wit/ast`:
+`please_wit` embeds a lightweight lexer and parser in `tools/common/wit/ast`:
 
 ```mermaid
 flowchart LR