Forge Engineering Notes¶
User docs: Forge chapter · Abstractions Package API: python/pulsing/forge/README.md
Implementation-focused notes for pulsing-forge (Rust) and pulsing.forge (Python).
Crates and modules¶
| Layer | Path |
|---|---|
| Rust handlers | crates/pulsing-forge/ |
| PyO3 binding | crates/pulsing-py/src/forge.rs → pulsing._core.ForgeRuntime |
| Python API | python/pulsing/forge/ |
| Craft Host | python/pulsing/craft/agent/forge_*.py |
Architecture¶
Host (LLM + ToolSession)
→ HybridForgeRuntime / ToolWorkerActor
→ pulsing-forge ToolRuntime
→ handlers + sandbox + MCP
→ tell_forge_event → ForgeEventInbox → Host
Related design docs¶
| Doc | Topic |
|---|---|
| Craft architecture | Forge × Craft integration |
| Naming | Package and gossip names |
| Session REPL | pulsing forge repl trace/replay |
Full Chinese engineering detail: see engineering.zh.md in this directory.