This is a CodeQL extractor that maps a language's parse tree onto a shared AST using the yeast desugaring engine. Swift, the only language so far, is parsed by Apple's swift-syntax rather than by tree-sitter.

• To build the extractor, run scripts/create-extractor-pack.sh

• Swift source is parsed by the swift-syntax-rs crate, which wraps Apple's swift-syntax. The extractor calls swift_syntax_rs::parse_to_json in-process to obtain the parse tree as JSON; the extractor does not invoke a separate parser binary, and there is no grammar in this repository to edit.

• extractor/src/languages/swift/adapter.rs converts that JSON into a yeast AST.

• The raw parse tree's shape is described by extractor/swift_node_types.yml, which is generated from swift-syntax by swift-syntax-rs/schemagen. Do not edit it by hand; regenerate it with scripts/regenerate-node-types.sh after changing the pinned swift-syntax version, then review the diff alongside the mapping in extractor/src/languages/swift/swift.rs.

• The target AST shape is described by extractor/ast_types.yml.

• The mapping from the parse tree to the target AST is found in extractor/src/languages/swift/swift.rs

• To run tests for the parser and mapping, run cargo test in the extractor directory. Since the parser is linked in-process, this needs a working Swift toolchain (so swift-syntax-rs can build). The tests can also be run under Bazel via bazel test //unified/extractor:all_tests.

• Extractor test cases are located at extractor/tests/corpus/swift/*/*.swift.

• Each test case has a corresponding .output file containing its generated output along with a copy of the test case itself.

• Check the output files for correctness but do not edit them manually. Regenerate them with scripts/update-corpus.sh.

• If you changed the extractor code, always rebuild it before running CodeQL tests.

• To run all CodeQL tests, run codeql test run --search-path extractor-pack ql/test

• Do not edit .expected files manually. To update the expected output, pass --learn to the codeql test run command.

• To run a specific test, pass the specific directory to the codeql test run command instead of ql/test.