Read This First: Index And Recommended Reading Order

This package documents the full traversed codebase under /Users/shubhojeetbera/Downloads/src.

Scope:

• Files traversed: 1902
• Total lines: 514587
• Unreadable files: 0

Recommended reading order:

1. 0100_project_overview_tech_stack_runtime_modes_and_folder_map.md - What the product is, who uses it, runtime modes, and the top-level folder map.
2. 0200_startup_flow_entry_points_and_cold_start_sequence.md - Cold-start and startup sequencing from process boot to the first usable session.
3. 0300_codebase_modules_layers_state_models_and_schemas.md - Module boundaries, state, schemas, tool contracts, and dependency hotspots.
4. 0400_system_architecture_and_design_rationale.md - The architectural shape of the system and why it is designed this way.
5. 0500_interactive_repl_request_flow_end_to_end.md - Interactive REPL request flow from prompt input to tool execution and UI update.
6. 0600_headless_sdk_and_print_mode_request_flow_end_to_end.md - Headless and SDK flow from input to structured streamed output.
7. 0700_mcp_integration_connection_and_tool_call_flow.md - MCP config, connection lifecycle, tool exposure, auth, and result handling.
8. 0800_external_services_sdks_storage_and_local_dependencies.md - External services, SDKs, local execution dependencies, storage, and queue-like behavior.
9. 0900_environment_variables_settings_feature_flags_and_failure_modes.md - Environment variables, config layers, feature flags, and failure modes.
10. 1000_non_obvious_patterns_gotchas_and_debugging_traps.md - Non-obvious decisions and traps that waste time if you do not know them.
11. 1100_full_codebase_file_inventory_grouped_by_directory.md - Complete file-by-file inventory grouped by directory.