How agent-kilo/jwno works
Project type and purpose
• Jwno is a desktop application—a tiling window manager for Windows 10/11—written primarily in Janet with a small C stub for Win32 integration. It installs as a native Windows executable, hooks into the OS’s window events, provides a customizable REPL, and manages window layouts.
File structure
• Top-level:
• c/ → C source for WinMain stub (boots Janet VM on Windows).
• src/ → Janet modules: core engine (main.janet), window/event handling, hooks, modules (auto-layout, scratch-pad, indicator, UI hints), REPL, config, logging, etc.
• res/, manifest/ → Windows resources (.rc) and application manifest.
• example/ → Sample Janet scripts/configs demonstrating use.
• doc/, doc/scripts → Static site source (Markdown + Janet generators) for documentation.
• script/ → Utility Janet scripts (vcs, build helpers).
• test/ → Janet unit tests exercising core modules.
• CI/config:
• .github/workflows → build and release pipelines (install Janet, build docs, release artifacts).
README for additional insights
• Confirms project is a window manager built in Janet.
• Emphasizes features, interactive REPL, documentation site, installation and development guides.
Final recommendations
• Related modules in clusters (e.g., “Layout Modules”, “UI Modules”).
• Be exhaustive: if a module handles window management, call it out explicitly (e.g., “auto-layout.janet”).
This structure will give a clear, accurate representation of Jwno’s architecture, from process startup through runtime event dispatch to modules and back to the OS.