alef-generated-bindings

name	alef-generated-bindings
description	Alef-managed generated bindings in packages/* and binding crates — the regeneration workflow (task alef:generate / alef:format), Go DocumentExtractor→Extractor rename mapping, the git-diff freshness check, and the key alef.toml sections. Load before editing anything under packages/* or a binding crate, or when regenerating, formatting, or verifying Alef output.

Alef-Generated Bindings

Files in packages/*/ and binding crates are generated by Alef — DO NOT manually edit.

Workflow

1. Check alef.toml before editing anything in packages/*/ or binding crates
2. Modify Rust source files or alef.toml itself
3. Run task alef:generate to regenerate all Alef-managed output without formatting (alef all --clean --format=false)
4. Run task alef:format explicitly if Alef post-generation formatting is needed
5. Run task e2e:test or task e2e:all to verify
6. Commit Rust source + alef.toml + regenerated bindings atomically

Rename Mappings (from alef.toml)

• Go: DocumentExtractor → Extractor
• All other languages: no renames

Freshness Check

task alef:generate && git diff --exit-code packages/ crates/xberg-node/ crates/xberg-wasm/ crates/xberg-ffi/

Key alef.toml Sections

• [crate] — Rust source files parsed for type/function extraction
• [languages.*] — per-language output path, module name, rename mappings
• [e2e] — e2e test generation: fixtures dir, output dir, per-language call overrides
• [readme] — README template generation per language package

Canonical e2e tasks are task e2e:generate, task e2e:build, task e2e:test, and task e2e:all. Do not add legacy aliases.