qodev-apollo-cli 1.2.1__tar.gz → 1.3.0__tar.gz

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/.gitignore

@@ -7,3 +7,8 @@ dist/
 .coverage
 .pytest_cache/
 .ruff_cache/
+.mypy_cache/
+
+# Local secrets — never commit
+.env
+.env.*

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-07-09
+
+### Added
+
+- `deals create` command — create a deal/opportunity from the CLI: `deals create --name "…" [--owner-id] [--account-id] [--amount] [--stage-id | --stage-name] [--closed-date]`. `--name` is the only required flag; `--stage-name` resolves to an ID via the stage list (same helper as `deals search`), and passing both `--stage-id` and `--stage-name` is a validation error. Requires a master Apollo API key (non-master keys get a 403).
+
+### Changed
+
+- Require `qodev-apollo-api>=0.4.0` (adds `create_deal`, and ships the fixed `update_opportunity_roles` payload so `deals set-role` now works, plus `search_accounts` filter validation).
+
 ## [1.2.1] - 2026-07-08
 
 Follow-ups from code review of the v1.2.0 changes.

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qodev-apollo-cli
-Version: 1.2.1
+Version: 1.3.0
 Summary: Agent-friendly CLI for the Apollo API
 Project-URL: Homepage, https://github.com/qodevai/apollo-cli
 Project-URL: Repository, https://github.com/qodevai/apollo-cli
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: cyclopts>=3.0
-Requires-Dist: qodev-apollo-api>=0.3.1
+Requires-Dist: qodev-apollo-api>=0.4.0
 Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.13.0; extra == 'dev'

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qodev-apollo-cli"
-version = "1.2.1"
+version = "1.3.0"
 description = "Agent-friendly CLI for the Apollo API"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -20,7 +20,7 @@ classifiers = [
 dependencies = [
     "cyclopts>=3.0",
     "rich>=13.0",
-    "qodev-apollo-api>=0.3.1",
+    "qodev-apollo-api>=0.4.0",
 ]
 
 [project.optional-dependencies]

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/src/apollo_cli/commands/deals.py

@@ -66,6 +66,50 @@ async def get(
     output(deal, ctx=ctx, format_fn=format_deal_detail)
 
 
+@deals_app.command
+async def create(
+    *,
+    name: Annotated[str, Parameter(name="--name", help="Deal name (required)")],
+    owner_id: Annotated[str | None, Parameter(name="--owner-id", help="Deal owner (team member) ID")] = None,
+    account_id: Annotated[str | None, Parameter(name="--account-id", help="Target account/company ID")] = None,
+    amount: Annotated[float | None, Parameter(name="--amount", help="Deal value (no currency symbol)")] = None,
+    stage_id: Annotated[str | None, Parameter(name="--stage-id", help="Deal stage ID")] = None,
+    stage_name: Annotated[
+        str | None,
+        Parameter(name="--stage-name", help="Deal stage name (resolved to an ID; avoids a `pipelines stages` lookup)"),
+    ] = None,
+    closed_date: Annotated[str | None, Parameter(name="--closed-date", help="Expected close date (YYYY-MM-DD)")] = None,
+) -> None:
+    """Create a new deal/opportunity.
+
+    Requires a master Apollo API key (non-master keys get a 403). ``--name`` is the
+    only required field. Use ``--stage-name`` to set the stage by name instead of ID.
+    """
+    if stage_id and stage_name:
+        error("Pass either --stage-id or --stage-name, not both.", ctx=ctx, code="conflicting_args", exit_code=2)
+        return
+
+    fields: dict[str, Any] = {}
+    if owner_id:
+        fields["owner_id"] = owner_id
+    if account_id:
+        fields["account_id"] = account_id
+    if amount is not None:
+        fields["amount"] = amount
+    if closed_date:
+        fields["closed_date"] = closed_date
+
+    async with ctx.client() as client:
+        if stage_name:
+            all_stages = await client.list_all_stages()
+            stage_id = resolve_stage_id(stage_name, all_stages.items, kind="deal stage")
+        if stage_id:
+            fields["opportunity_stage_id"] = stage_id
+        deal = await client.create_deal(name, **fields)
+
+    output(deal, ctx=ctx, format_fn=format_deal_detail)
+
+
 ROLE_TYPE_COLUMNS = [("ID", "id"), ("Name", "name"), ("Display Order", "display_order")]
 
 

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/tests/test_commands.py

@@ -502,6 +502,60 @@ class TestDealRoleCommands:
         assert all("opportunity_contact_role_type_id" not in r for r in roles)
 
 
+class TestDealCreate:
+    @pytest.mark.asyncio
+    async def test_create_passes_name_and_optional_fields(self, sample_deal: dict, capsys) -> None:
+        """deals create forwards --name plus only the optional fields that were provided."""
+        mock_client = MagicMock()
+        mock_client.create_deal = AsyncMock(return_value=sample_deal)
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.deals import create
+
+            await create(name="Big One", owner_id="o1", amount=5000, stage_id="st1")
+
+        name_arg = mock_client.create_deal.call_args.args[0]
+        fields = mock_client.create_deal.call_args.kwargs
+        assert name_arg == "Big One"
+        assert fields == {"owner_id": "o1", "amount": 5000, "opportunity_stage_id": "st1"}
+
+    @pytest.mark.asyncio
+    async def test_create_resolves_stage_name(self, sample_deal: dict, capsys) -> None:
+        """deals create --stage-name resolves to opportunity_stage_id."""
+        mock_client = MagicMock()
+        mock_client.list_all_stages = AsyncMock(
+            return_value=MockSearchResult(items=[{"id": "st-neg", "name": "Negotiation"}], total=1, page=1)
+        )
+        mock_client.create_deal = AsyncMock(return_value=sample_deal)
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.deals import create
+
+            await create(name="Deal", stage_name="negotiation")
+
+        assert mock_client.create_deal.call_args.kwargs["opportunity_stage_id"] == "st-neg"
+
+    @pytest.mark.asyncio
+    async def test_create_rejects_both_stage_id_and_name(self, capsys) -> None:
+        """Passing both --stage-id and --stage-name is a validation error; no API call is made."""
+        mock_client = MagicMock()
+        mock_client.create_deal = AsyncMock()
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.deals import create
+
+            with pytest.raises(SystemExit):
+                await create(name="Deal", stage_id="st1", stage_name="Negotiation")
+
+        mock_client.create_deal.assert_not_called()
+
+
 class TestCustomFieldsCommand:
     @pytest.mark.asyncio
     async def test_custom_fields_list_filters_by_modality(self, capsys) -> None:

{qodev_apollo_cli-1.2.1 → qodev_apollo_cli-1.3.0}/uv.lock

@@ -472,7 +472,7 @@ wheels = [
 
 [[package]]
 name = "qodev-apollo-api"
-version = "0.3.2"
+version = "0.4.0"
 source = { directory = "../apollo-api" }
 dependencies = [
     { name = "httpx" },