feat: add Phase 2 resources - forms, companies, notes, stages, assets, tags, categories, pages, webhooks, fields, reports, points

12 new command modules with full test coverage (117 tests total).
All endpoints validated against live Mautic 6.0.6 and official API docs.

Author: introfini

src/mautic_cli/commands/__init__.py

@@ -8,9 +8,33 @@ def register_commands(cli):
     from mautic_cli.commands.emails import emails
     from mautic_cli.commands.campaigns import campaigns
     from mautic_cli.commands.auth_cmd import auth
+    from mautic_cli.commands.forms import forms
+    from mautic_cli.commands.companies import companies
+    from mautic_cli.commands.notes import notes
+    from mautic_cli.commands.stages import stages
+    from mautic_cli.commands.assets import assets
+    from mautic_cli.commands.tags import tags
+    from mautic_cli.commands.categories import categories
+    from mautic_cli.commands.pages import pages
+    from mautic_cli.commands.webhooks import webhooks
+    from mautic_cli.commands.fields import fields
+    from mautic_cli.commands.reports import reports
+    from mautic_cli.commands.points import points
 
     cli.add_command(contacts)
     cli.add_command(segments)
     cli.add_command(emails)
     cli.add_command(campaigns)
     cli.add_command(auth)
+    cli.add_command(forms)
+    cli.add_command(companies)
+    cli.add_command(notes)
+    cli.add_command(stages)
+    cli.add_command(assets)
+    cli.add_command(tags)
+    cli.add_command(categories)
+    cli.add_command(pages)
+    cli.add_command(webhooks)
+    cli.add_command(fields)
+    cli.add_command(reports)
+    cli.add_command(points)

src/mautic_cli/commands/assets.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import click
+
+from mautic_cli.context import pass_context, MauticContext
+from mautic_cli.client import MauticApiError
+
+
+@click.group()
+def assets():
+    """Manage Mautic assets."""
+
+
+@assets.command("list")
+@click.option("--search", default=None, help="Mautic search string.")
+@click.option("--limit", default=30, type=int)
+@click.option("--offset", default=0, type=int)
+@pass_context
+def list_assets(mctx: MauticContext, search, limit, offset):
+    """List assets."""
+    params = {"limit": limit, "start": offset}
+    if search:
+        params["search"] = search
+    if mctx.published_only:
+        params["search"] = ((params.get("search") or "") + " is:published").strip()
+    try:
+        data = mctx.client.get("/assets", params=params)
+        mctx.output_list(data, "assets")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@assets.command()
+@click.argument("id", type=int)
+@pass_context
+def get(mctx: MauticContext, id):
+    """Get an asset by ID."""
+    try:
+        data = mctx.client.get(f"/assets/{id}")
+        mctx.output_single(data, "asset")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)

src/mautic_cli/commands/categories.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import click
+
+from mautic_cli.context import pass_context, MauticContext
+from mautic_cli.client import MauticApiError
+from mautic_cli.json_input import parse_json_input
+
+
+@click.group()
+def categories():
+    """Manage Mautic categories."""
+
+
+@categories.command("list")
+@click.option("--search", default=None, help="Mautic search string.")
+@click.option("--limit", default=30, type=int)
+@click.option("--offset", default=0, type=int)
+@click.option("--bundle", default=None, help="Filter by bundle type (e.g. email, asset).")
+@pass_context
+def list_categories(mctx: MauticContext, search, limit, offset, bundle):
+    """List categories."""
+    params = {"limit": limit, "start": offset}
+    if search:
+        params["search"] = search
+    if mctx.published_only:
+        params["search"] = ((params.get("search") or "") + " is:published").strip()
+    if bundle:
+        params["bundle"] = bundle
+    try:
+        data = mctx.client.get("/categories", params=params)
+        mctx.output_list(data, "categories")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@categories.command()
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def create(mctx: MauticContext, json_str):
+    """Create a new category."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.post("/categories/new", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)

src/mautic_cli/commands/companies.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+import click
+
+from mautic_cli.context import pass_context, MauticContext
+from mautic_cli.client import MauticApiError
+from mautic_cli.json_input import parse_json_input
+
+
+@click.group()
+def companies():
+    """Manage Mautic companies."""
+
+
+@companies.command("list")
+@click.option("--search", default=None, help="Mautic search string.")
+@click.option("--limit", default=30, type=int)
+@click.option("--offset", default=0, type=int)
+@pass_context
+def list_companies(mctx: MauticContext, search, limit, offset):
+    """List companies."""
+    params = {"limit": limit, "start": offset}
+    if search:
+        params["search"] = search
+    if mctx.published_only:
+        params["search"] = ((params.get("search") or "") + " is:published").strip()
+    try:
+        data = mctx.client.get("/companies", params=params)
+        mctx.output_list(data, "companies")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command()
+@click.argument("id", type=int)
+@pass_context
+def get(mctx: MauticContext, id):
+    """Get a company by ID."""
+    try:
+        data = mctx.client.get(f"/companies/{id}")
+        mctx.output_single(data, "company")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command()
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def create(mctx: MauticContext, json_str):
+    """Create a new company."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.post("/companies/new", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command()
+@click.argument("id", type=int)
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def edit(mctx: MauticContext, id, json_str):
+    """Edit a company."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.patch(f"/companies/{id}/edit", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command()
+@click.argument("id", type=int)
+@pass_context
+def delete(mctx: MauticContext, id):
+    """Delete a company."""
+    try:
+        data = mctx.client.delete(f"/companies/{id}/delete")
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command("add-contact")
+@click.argument("company_id", type=int)
+@click.argument("contact_id", type=int)
+@pass_context
+def add_contact(mctx: MauticContext, company_id, contact_id):
+    """Add a contact to a company."""
+    try:
+        data = mctx.client.post(f"/companies/{company_id}/contact/{contact_id}/add")
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@companies.command("remove-contact")
+@click.argument("company_id", type=int)
+@click.argument("contact_id", type=int)
+@pass_context
+def remove_contact(mctx: MauticContext, company_id, contact_id):
+    """Remove a contact from a company."""
+    try:
+        data = mctx.client.post(f"/companies/{company_id}/contact/{contact_id}/remove")
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)

src/mautic_cli/commands/fields.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+import click
+
+from mautic_cli.context import pass_context, MauticContext
+from mautic_cli.client import MauticApiError
+from mautic_cli.json_input import parse_json_input
+
+
+@click.group()
+def fields():
+    """Manage Mautic custom fields."""
+
+
+@fields.command("list")
+@click.option("--search", default=None, help="Mautic search string.")
+@click.option("--limit", default=30, type=int)
+@click.option("--offset", default=0, type=int)
+@pass_context
+def list_fields(mctx: MauticContext, search, limit, offset):
+    """List custom fields."""
+    params = {"limit": limit, "start": offset}
+    if search:
+        params["search"] = search
+    if mctx.published_only:
+        params["search"] = ((params.get("search") or "") + " is:published").strip()
+    try:
+        data = mctx.client.get("/fields/contact", params=params)
+        mctx.output_list(data, "fields")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@fields.command()
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def create(mctx: MauticContext, json_str):
+    """Create a new custom field."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.post("/fields/contact/new", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)

src/mautic_cli/commands/forms.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import click
+
+from mautic_cli.context import pass_context, MauticContext
+from mautic_cli.client import MauticApiError
+
+
+@click.group()
+def forms():
+    """Manage Mautic forms."""
+
+
+@forms.command("list")
+@click.option("--search", default=None, help="Mautic search string.")
+@click.option("--limit", default=30, type=int)
+@click.option("--offset", default=0, type=int)
+@pass_context
+def list_forms(mctx: MauticContext, search, limit, offset):
+    """List forms."""
+    params = {"limit": limit, "start": offset}
+    if search:
+        params["search"] = search
+    if mctx.published_only:
+        params["search"] = ((params.get("search") or "") + " is:published").strip()
+    try:
+        data = mctx.client.get("/forms", params=params)
+        mctx.output_list(data, "forms")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@forms.command()
+@click.argument("id", type=int)
+@pass_context
+def get(mctx: MauticContext, id):
+    """Get a form by ID."""
+    try:
+        data = mctx.client.get(f"/forms/{id}")
+        mctx.output_single(data, "form")
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@forms.command()
+@click.argument("id", type=int)
+@click.option("--limit", default=30, type=int)
+@pass_context
+def submissions(mctx: MauticContext, id, limit):
+    """List form submissions."""
+    try:
+        data = mctx.client.get(f"/forms/{id}/submissions", params={"limit": limit})
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@forms.command()
+@click.argument("id", type=int)
+@pass_context
+def delete(mctx: MauticContext, id):
+    """Delete a form."""
+    try:
+        data = mctx.client.delete(f"/forms/{id}/delete")
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)