feat!: Add editable Farm and Queue fields

.github/workflows/build_installers.yml

@@ -26,6 +26,7 @@ on:
         type: choice
         options:
         - mainline
+        - release
 
 jobs:
   BuildInstaller:

AGENTS.md

@@ -0,0 +1,148 @@
+# AGENTS.md - AWS Deadline Cloud Client
+
+This document provides guidance for AI agents working with this codebase.
+
+## Project Overview
+
+AWS Deadline Cloud client is a Python library and CLI tool for interacting with [AWS Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/what-is-deadline-cloud.html). It supports job submission, file transfer via job attachments, and provides both CLI and GUI interfaces.
+
+**Package name:** `deadline`
+**Python versions:** 3.8 - 3.13
+**Platforms:** Linux, Windows, macOS
+
+## Repository Structure
+
+```
+src/deadline/
+├── client/           # Main client library
+│   ├── api/          # Boto3 wrappers and AWS API helpers
+│   ├── cli/          # CLI entry points (deadline command)
+│   ├── config/       # Configuration (~/.deadline/*)
+│   ├── ui/           # Qt/PySide GUI components
+│   ├── job_bundle/   # Job bundle handling and history
+│   └── dataclasses/  # Data structures
+├── job_attachments/  # File transfer to/from S3
+│   ├── api/          # Public job attachments API
+│   ├── caches/       # Hash and S3 check caches
+│   └── asset_manifests/  # Manifest handling
+├── mcp/              # MCP server (public)
+├── _mcp/             # MCP server (internal)
+└── common/           # Shared utilities
+```
+
+## Key Commands
+
+Always use `hatch` for running builds, tests, formatting, and linting.
+If running just a few tests, always add `--numprocesses=1` to the `hatch run test`
+command so that it starts quicker.
+
+```bash
+# Development
+hatch build              # Build wheel/sdist
+hatch run test           # Run unit tests
+hatch run test --numprocesses=1 -k "selected_test_name" # Run just a few tests
+hatch run all:test       # Test all Python versions
+hatch run integ:test     # Integration tests (requires AWS)
+hatch run lint           # Check formatting
+hatch run fmt            # Auto-format code
+hatch shell              # Enter dev environment
+
+# CLI usage
+deadline farm list
+deadline bundle submit <path>
+deadline job list
+deadline job get
+deadline job logs --job-id <id>
+```
+
+## Code Conventions
+
+### Module Naming
+- **Private modules:** `_module.py` - internal implementation
+- **Public modules:** `module.py` - part of public API
+- Symbols not starting with `_` define the public contract
+
+### Import Style (Public Modules)
+```python
+import os as _os  # Private import
+from typing import Dict as _Dict  # Private import
+
+class PublicClass:  # Public
+    pass
+
+class _PrivateClass:  # Private
+    pass
+```
+
+### Commit Messages
+Use [conventional commits](https://www.conventionalcommits.org/):
+- `feat:` - New features
+- `fix:` - Bug fixes
+- `docs:` - Documentation
+- `test:` - Tests only
+- `refactor:` - Code refactoring
+- `perf:` - Performance improvements
+- `feat!:` or `fix!:` - Breaking changes (Also include `BREAKING CHANGES:` section in message body)
+
+## Testing
+
+- **Unit tests:** `test/unit/` - Run with `hatch run test`
+- **Integration tests:** `test/integ/` - Requires AWS resources
+- **Squish GUI tests:** `test/squish/` - Requires Squish license
+- **Docker tests:** `scripts/run_sudo_tests.sh` - For permission tests
+
+Tests use pytest with unittest.mock. Coverage target: 80%.
+
+## Public API Contracts
+
+Breaking changes require conventional commit syntax (`feat!:`, `fix!:`).
+
+**CLI contracts:**
+- Subcommand names and arguments
+- Default values and behaviors
+
+**Python API contracts:**
+- All non-underscore-prefixed functions/classes in public modules
+- Function signatures (adding required params is breaking)
+- Default argument values
+
+## Qt/GUI Guidelines
+
+Never call AWS APIs from the main Qt thread. Use:
+1. Background threads for API calls
+2. Qt Signals to return results to widgets
+3. Cancellation flags for thread cleanup
+
+See `deadline_config_dialog.py` for examples.
+
+## Dependencies
+
+Minimize new dependencies. This library is used from embedded Python within
+applications where dependency conflicts are possible. When adding:
+- Evaluate if functionality can be implemented locally
+- Check library quality (maintenance, downloads, stars)
+- Ensure license compatibility (Apache-2.0)
+- Document in THIRD_PARTY_LICENSES
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `pyproject.toml` | Project config, dependencies |
+| `CONTRIBUTING.md` | Contribution guidelines |
+| `DEVELOPMENT.md` | Development setup and workflows |
+| `CHANGELOG_GUIDELINES.md` | Changelog formatting rules |
+| `scripts/README.md` | API change detection scripts |
+
+## Environment Variables
+
+- `DEADLINE_CONFIG_FILE_PATH` - Override config location (default: `~/.deadline/config`)
+- `AWS_ENDPOINT_URL_DEADLINE` - Custom Deadline Cloud endpoint
+
+## Optional Features
+
+Install with extras:
+```bash
+pip install "deadline[gui]"  # Qt GUI components
+pip install "deadline[mcp]"  # MCP server for AI assistants
+```