fix(agy): support --model, --add-dir workspace, and pre-prompt extra args

[timoyan]

Summary

Fixes three bugs in AgyIntegration that together prevented specify workflow run from working correctly with agy. Closes #4480.

Bugs Fixed

1. --model was silently ignored

build_exec_args() had a comment # agy does not support --model ... both params are ignored and hardcoded no --model flag. agy >=1.20 fully supports agy --model <name> --print <prompt>. Workflow YAML model: pins had no effect.

Fix: Pass --model <model> before --print when model is set.

2. EXTRA_ARGS were appended after --print (silently absorbed as prompt text)

agy treats every token after --print as part of the prompt string, not as CLI flags. Operator flags like --dangerously-skip-permissions or --print-timeout 30m set via SPECKIT_INTEGRATION_AGY_EXTRA_ARGS were appended after --print and silently became part of the prompt.

Fix: _apply_extra_args_env_var() is now called before args.extend(['--print', prompt]).

3. No workspace passed to agy -- 'no active workspace'

The base dispatch_command() sets cwd=project_root for the subprocess, but agy does not read cwd as its workspace root -- it requires an explicit --add-dir <path> flag. Without it, agy falls back to its own scratch directory, cannot locate .agents/skills/, and reports 'no active workspace' -- making all installed Spec Kit skills invisible.

Fix: build_exec_args() now accepts project_root: Path | None and injects --add-dir <project_root> before --print when project_root is given. dispatch_command() is overridden in AgyIntegration to thread project_root through to build_exec_args().

Flag Order Guarantee

All flags appear before --print so agy parses them correctly:

agy [--model <m>] [--add-dir <d>] [<EXTRA_ARGS>] --print <prompt>

Tests

• Updated ignores_model -> honors_model (asserts --model is now included)
• Updated extra_args_honors -> extra_args_before_print (asserts extra args come BEFORE --print)
• Added: test_build_exec_args_add_dir_for_workspace
• Added: test_build_exec_args_no_add_dir_when_project_root_is_none
• Added: test_build_exec_args_no_model_flag_when_model_is_none
• Added: test_build_exec_args_combined_flag_order

All 47 tests pass.

AI Assistance Disclosure

This PR was drafted with substantial AI assistance (Google Antigravity / agy). The bugs were discovered while personally running specify workflow run against a real project and observing the failures firsthand. The root cause analysis, fix design, and test verification were reviewed and validated by me. AI was used to write the code, tests, commit message, and PR body.

[mnriem]

Thanks — and this is a model report→fix loop (#4480 + this), with genuinely exemplary disclosure and the bugs verified on a real project. The build_exec_args fix is right: --model/--add-dir/extra-args before --print, prompt last. One design question before merge: this overrides dispatch_command to thread project_root through as --add-dir, which duplicates the base class's subprocess/shutil.which/streaming/timeout logic in the agy integration — that's a maintenance surface that can drift from the base. Is there a lighter path (e.g. threading project_root through the base dispatch_command so all integrations can use --add-dir-style hints), rather than a full override here? I'll trigger the automated review in parallel. Also relates to the systemic build_exec_args() audit in #2416.

[Copilot]

🟡 Changes recommended

The production dispatch path lacks a regression test confirming that it forwards the workspace argument.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Fixes agy workflow dispatch by correctly ordering CLI flags and supplying workspace context.

Changes:

• Adds --model and --add-dir support.
• Places extra arguments before --print.
• Expands argument-building tests.

File summaries

File	Description
src/specify_cli/integrations/agy/__init__.py	Updates argument construction and dispatch.
tests/integrations/test_integration_agy.py	Tests flag inclusion and ordering.

Review details

• Files reviewed: 2/2 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[timoyan]

Thanks — and this is a model report→fix loop (#4480 + this), with genuinely exemplary disclosure and the bugs verified on a real project. The build_exec_args fix is right: --model/--add-dir/extra-args before --print, prompt last. One design question before merge: this overrides dispatch_command to thread project_root through as --add-dir, which duplicates the base class's subprocess/shutil.which/streaming/timeout logic in the agy integration — that's a maintenance surface that can drift from the base. Is there a lighter path (e.g. threading project_root through the base dispatch_command so all integrations can use --add-dir-style hints), rather than a full override here? I'll trigger the automated review in parallel. Also relates to the systemic build_exec_args() audit in #2416.

@mnriem I think you're right, we could have project_root from base. Please check the latest commmit. :)