Function main

ci/debug_attached.py:1157–1395

Main entry point.

()

def main() -> int:
    """Main entry point."""
    args = parse_args()

    build_dir = args.project_dir.resolve()

    # Verify platformio.ini exists
    if not (build_dir / "platformio.ini").exists():
        print(f"❌ Error: platformio.ini not found in {build_dir}")
        print("   Make sure you're running this from a PlatformIO project directory")
        return 1

    if args.environment is None:
        from ci.util.pio_package_daemon import get_default_environment

        default_environment = get_default_environment(str(build_dir))
        if default_environment is None:
            print("Error: fbuild requires an environment.")
            print("   Set default_envs in platformio.ini or pass --env <environment>.")
            return 1
        args.environment = default_environment

    # Handle sketch argument and set PLATFORMIO_SRC_DIR environment variable
    if args.sketch:
        try:
            resolved_sketch = resolve_sketch_path(args.sketch, build_dir)

            # Detect if user is trying to run AutoResearch sketch directly (only with --check-usage)
            sketch_name = Path(resolved_sketch).name
            if args.check_usage and sketch_name.lower() == "autoresearch":
                # Display red banner error
                print()
                print(f"{Fore.RED}{'=' * 60}")
                print(f"{Fore.RED}⚠️  ERROR: DO NOT USE 'bash debug AutoResearch'")
                print(f"{Fore.RED}{'=' * 60}")
                print(
                    f"{Fore.RED}The AutoResearch sketch requires specific --expect and --fail-on"
                )
                print(
                    f"{Fore.RED}patterns to work correctly. Use the dedicated wrapper instead:"
                )
                print()
                print(f"{Fore.YELLOW}  bash autoresearch{Style.RESET_ALL}")
                print()
                print(
                    f"{Fore.RED}This ensures proper pattern matching and prevents false positives."
                )
                print(f"{Fore.RED}{'=' * 60}{Style.RESET_ALL}")
                print()
                return 1

            # Use absolute path for PLATFORMIO_SRC_DIR (matches autoresearch.py behavior)
            absolute_sketch_path = str(build_dir / resolved_sketch)
            os.environ["PLATFORMIO_SRC_DIR"] = absolute_sketch_path
            print(f"📁 Sketch: {resolved_sketch}")
        except SystemExit:
            # resolve_sketch_path already printed error message
            return 1