create-invoke-task

Create a new invoke task accessible via `dda inv <namespace>.<task-name>`. ## Instructions ### Step 1: Gather information from the user Use `AskUserQuestion` to collect the following. If `$ARGUMENTS` provides values, skip those questions. 1. **Task name**: The function name (e.g. `build`, `refresh_assets`). Underscores become hyphens in the CLI. 2. **Namespace**: Which task module does it belong to? - **Existing module** — Add to an existing file in `tasks/` (e.g. `agent`, `linter`, `dogstatsd`). Check `tasks/__init__.py` for the full list. - **New module** — Create a new `tasks/<name>.py` file and register it. 3. **What does the task do?**: Brief description (becomes the docstring / help text). 4. **Parameters**: What CLI flags does the task need? (name, type, default value, description) ### Step 2: Read a reference Read an existing task file matching the desired complexity: - **Simple task** (no params): `tasks/auth.py` - **Task with params**: Pick any task from `tasks/agent.py` or `tasks/linter.py` - **Registration**: `tasks/__init__.py` — to see how modules and tasks are registered ### Step 3: Create the task Add the `@task` decorated function to the appropriate file. Follow the patterns from Step 2. Key rules: - First parameter is always `ctx` (the invoke `Context`) - Use `ctx.run("command")` to execute shell commands - Docstring first line = short description shown in `dda inv --list` - Import from `invoke`: `task`, `Exit` (for errors), `Context` ### Step 4: Register (new modules only) If you created a new module file, edit `tasks/__init__.py`: 1. Add the import in the `from tasks import (...)` block (alphabetical order) 2. Register it: - **As a namespace** (most common): `ns.add_collection(<module>)` — creates `dda inv <module>.<task>` - **As a root task**: `ns.add_task(<task>)` — creates `dda inv <task>` If adding to an existing module, no registration is needed — invoke auto-discovers `@task` functions. ### Step 5: Verify Test the task: ```bash dda inv <namespace>.<task-name> --help ``` ## Usage - `/create-invoke-task` — Interactive: prompts for all details - `/create-invoke-task agent my-task` — Pre-fills namespace and name