Inpoxia Tooling Workflow

Run Inpoxia repo tasks with consistent commands and validation gates.

Quick Start

1. Detect task type: CLI behavior, GraphMail library behavior, configuration/auth flow, or packaging/release.
2. Run the narrowest command that validates the change first (single test module or targeted command).
3. Run broader checks before finishing: tests plus static checks relevant to changed files.
4. Report exact commands executed and key results.

⚠️ Critical: Search vs Filter

Before using messages search or messages filter, read references/search-vs-filter.md.

• filter = Exact field matching + date ranges (OData $filter)
• search = Fuzzy/full-text search (Microsoft Graph $search)
• These are mutually exclusive — you cannot combine $search with $filter in Microsoft Graph.

Common mistake: Trying to use --from <email> with search (expects fuzzy KQL syntax, not flags). Use messages filter for exact matches instead.

Use Repo Commands

Use uv-managed tools in this repo.

• Run tests: pytest
• Run targeted tests: pytest tests/inpoxia/test_cli_messages.py -q
• Run type checks: pyright
• Run lint checks: ruff check .
• Run formatting: ruff format .
• Run CLI locally: ./.venv/bin/inpoxia --help

Prefer targeted test selection first, then expand scope as confidence increases.

Validate By Change Type

CLI command/output changes (src/inpoxia/cli/**)

1. Run the relevant CLI test module under tests/inpoxia/.
2. Run related GraphMail tests if the command calls inpoxia.graphmail.
3. Run ruff check . and pyright.

GraphMail library changes (src/inpoxia/graphmail/**)

1. Run matching tests under tests/inpoxia/graphmail/.
2. Run full tests/inpoxia/graphmail/ suite when behavior contracts change.
3. Run pyright and ruff check ..

Config/auth/token handling changes

1. Run tests/inpoxia/test_config*.py, tests/inpoxia/test_cli_auth.py, and tests/inpoxia/test_auth_manager.py as applicable.
2. Confirm token resolution order and error handling behavior remain consistent.

Use References

• references/command-recipes.md: Compact command map and task-to-test routing.
• references/search-vs-filter.md: Critical guide to choosing between messages search (fuzzy) and messages filter (exact match). Read this to avoid AI agents attempting fuzzy searches with filters or vice versa.