Refactor: Extract bootstrap and command handlers into separate modules

[chinmaymk]

Summary

This refactor extracts the monolithic src/index.ts into focused, single-responsibility modules to improve maintainability and testability. The main entry point now orchestrates three distinct phases: early exits (help, version, exec), bootstrap (config + subsystem initialization), and interface launching.

Key Changes

• New src/bootstrap.ts: Centralizes all subsystem initialization (provider, tools, middleware, skills, memory, MCP, observability) into a single bootstrap() function that returns an AppContext object. This eliminates ~200 lines of setup code from the main entry point and makes the initialization sequence explicit and reusable.

• New src/interfaces/commands.ts: Extracts standalone command handlers (runExecScript, runSkillCommand, showContext, runMemoryCommand) that don't require a full interface loop. These were previously inline in main().

• New src/interfaces/help.ts: Moves the HELP text constant to a dedicated module for better organization and to reduce clutter in the main entry point.

• Refactored src/index.ts: Restructured into three logical phases:

  1. Early exits (handleEarlyExits): Version, help, exec, skill commands — no config/bootstrap needed
  2. Standalone commands (handleStandaloneCommands): Show context, memory operations — need bootstrap but no interface
  3. Interface launchers: Separate functions for each interface type (CLI, REPL, HTTP, MCP) that consume the AppContext

• Signal handling: Extracted onSignals() helper to centralize SIGINT/SIGTERM registration and removal, making cleanup more consistent across interfaces.

Implementation Details

• The AppContext type encapsulates all state needed by interface layers, eliminating the need to pass dozens of individual parameters.
• Bootstrap is now a pure function with no side effects on the main process (no signal handlers, no process.exit calls).
• Interface launchers are now independent functions that can be tested or reused without coupling to the main entry point.
• The refactor maintains 100% behavioral compatibility — no changes to CLI flags, config loading, or runtime behavior.

https://claude.ai/code/session_01RVH28SjMU97CoJVbkfWK8T