datalegion-cli 1.1.0__tar.gz → 1.2.0__tar.gz

datalegion_cli-1.2.0/.github/dependabot.yml

@@ -0,0 +1,42 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "09:00"
+      timezone: "America/Los_Angeles"
+    cooldown:
+      default-days: 1
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "09:00"
+      timezone: "America/Los_Angeles"
+    cooldown:
+      default-days: 1
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      actions:
+        patterns:
+          - "*"

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/.github/workflows/ci.yml

@@ -8,11 +8,11 @@ jobs:
   lint:
     runs-on: blacksmith-2vcpu-ubuntu-2404
     steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v9.0.0
         with:
           enable-cache: true
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@v7
         with:
           python-version: "3.11"
       - run: uv sync --group dev
@@ -22,11 +22,11 @@ jobs:
   test:
     runs-on: blacksmith-2vcpu-ubuntu-2404
     steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v9.0.0
         with:
           enable-cache: true
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@v7
         with:
           python-version: "3.11"
       - run: uv sync --group dev

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/.github/workflows/release.yml

@@ -18,10 +18,10 @@ jobs:
       contents: read
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v9.0.0
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
@@ -57,10 +57,10 @@ jobs:
         python-version: ["3.11", "3.12", "3.13"]
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v9.0.0
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
@@ -88,10 +88,10 @@ jobs:
       id-token: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v9.0.0
 
       - name: Set up Python
         run: uv python install 3.11
@@ -200,7 +200,7 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           ref: main
           token: ${{ secrets.GH_PAT }}
@@ -216,7 +216,7 @@ jobs:
           git push
 
       - name: Create Release
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             const tag = context.ref.replace('refs/tags/', '');

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datalegion-cli
-Version: 1.1.0
+Version: 1.2.0
 Summary: CLI for the Data Legion API — agent-friendly, fully async
 Project-URL: Homepage, https://www.datalegion.ai
 Project-URL: Documentation, https://www.datalegion.ai/docs
@@ -35,7 +35,7 @@ Description-Content-Type: text/markdown
 
 The official command-line interface for the [Data Legion](https://www.datalegion.ai) API. Built for both humans and AI agents.
 
-Look up people and companies by email, phone, name, domain, LinkedIn, or ticker symbol. Search across 1.5B+ contacts and 200M+ companies using SQL syntax. Clean, hash, and validate data fields before or after enrichment. Track credit usage and manage your configuration — all from the terminal.
+Look up people and companies by email, phone, name, domain, LinkedIn, or ticker symbol. Search using SQL syntax. Clean, hash, and validate data fields before or after enrichment. Track credit usage and manage your configuration — all from the terminal.
 
 ```bash
 pip install datalegion-cli
@@ -159,13 +159,20 @@ datalegion-cli person enrich --email john@example.com --multiple --min-confidenc
 datalegion-cli person enrich --email john@example.com --fields "full_name,emails,phones"
 ```
 
-### Person search
+### Person search (Beta)
 
 ```bash
 # SQL-based search
 datalegion-cli person search "SELECT * FROM people WHERE company_name ILIKE '%google%' AND state = 'CA'" --limit 5
 ```
 
+### Person discovery (Beta)
+
+```bash
+# Natural-language search
+datalegion-cli person discover "software engineers in San Francisco who know Rust" --limit 10
+```
+
 ### Company enrichment
 
 ```bash
@@ -179,13 +186,20 @@ datalegion-cli company enrich --ticker AAPL
 datalegion-cli company enrich --name "Stripe" --industry "Financial Services"
 ```
 
-### Company search
+### Company search (Beta)
 
 ```bash
 # SQL-based search
 datalegion-cli company search "SELECT * FROM companies WHERE industry ILIKE '%software%' AND legion_employee_count > 100"
 ```
 
+### Company discovery (Beta)
+
+```bash
+# Natural-language search
+datalegion-cli company discover "fintech startups in New York with under 50 employees"
+```
+
 ### Utility commands
 
 ```bash
@@ -197,6 +211,10 @@ datalegion-cli utility hash john@example.com
 
 # Validate fields before enrichment
 datalegion-cli utility validate --email "test@example.com" --phone "+15551234567"
+
+# Report a data issue on a record (no credit cost; include --correct or --comment)
+datalegion-cli utility report person --legion-id abc123 --issue-type outdated \
+    --issue-level field --field job_title --observed "CTO" --correct "CEO"
 ```
 
 ### Credits

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/README.md

@@ -2,7 +2,7 @@
 
 The official command-line interface for the [Data Legion](https://www.datalegion.ai) API. Built for both humans and AI agents.
 
-Look up people and companies by email, phone, name, domain, LinkedIn, or ticker symbol. Search across 1.5B+ contacts and 200M+ companies using SQL syntax. Clean, hash, and validate data fields before or after enrichment. Track credit usage and manage your configuration — all from the terminal.
+Look up people and companies by email, phone, name, domain, LinkedIn, or ticker symbol. Search using SQL syntax. Clean, hash, and validate data fields before or after enrichment. Track credit usage and manage your configuration — all from the terminal.
 
 ```bash
 pip install datalegion-cli
@@ -126,13 +126,20 @@ datalegion-cli person enrich --email john@example.com --multiple --min-confidenc
 datalegion-cli person enrich --email john@example.com --fields "full_name,emails,phones"
 ```
 
-### Person search
+### Person search (Beta)
 
 ```bash
 # SQL-based search
 datalegion-cli person search "SELECT * FROM people WHERE company_name ILIKE '%google%' AND state = 'CA'" --limit 5
 ```
 
+### Person discovery (Beta)
+
+```bash
+# Natural-language search
+datalegion-cli person discover "software engineers in San Francisco who know Rust" --limit 10
+```
+
 ### Company enrichment
 
 ```bash
@@ -146,13 +153,20 @@ datalegion-cli company enrich --ticker AAPL
 datalegion-cli company enrich --name "Stripe" --industry "Financial Services"
 ```
 
-### Company search
+### Company search (Beta)
 
 ```bash
 # SQL-based search
 datalegion-cli company search "SELECT * FROM companies WHERE industry ILIKE '%software%' AND legion_employee_count > 100"
 ```
 
+### Company discovery (Beta)
+
+```bash
+# Natural-language search
+datalegion-cli company discover "fintech startups in New York with under 50 employees"
+```
+
 ### Utility commands
 
 ```bash
@@ -164,6 +178,10 @@ datalegion-cli utility hash john@example.com
 
 # Validate fields before enrichment
 datalegion-cli utility validate --email "test@example.com" --phone "+15551234567"
+
+# Report a data issue on a record (no credit cost; include --correct or --comment)
+datalegion-cli utility report person --legion-id abc123 --issue-type outdated \
+    --issue-level field --field job_title --observed "CTO" --correct "CEO"
 ```
 
 ### Credits

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "datalegion-cli"
-version = "1.1.0"
+version = "1.2.0"
 description = "CLI for the Data Legion API — agent-friendly, fully async"
 readme = "README.md"
 requires-python = ">=3.11"

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/src/datalegion_cli/client.py

@@ -111,8 +111,8 @@ class LegionClient:
     async def person_search(self, **kwargs: Any) -> dict[str, Any]:
         return await self.request("POST", "/person/search", payload=_strip(kwargs))
 
-    # async def person_discover(self, **kwargs: Any) -> dict[str, Any]:
-    #     return await self.request("POST", "/person/discover", payload=_strip(kwargs))
+    async def person_discover(self, **kwargs: Any) -> dict[str, Any]:
+        return await self.request("POST", "/person/discover", payload=_strip(kwargs))
 
     async def person_bulk(self, **kwargs: Any) -> dict[str, Any]:
         return await self.request("POST", "/person/enrich/bulk", payload=_strip(kwargs))
@@ -123,8 +123,8 @@ class LegionClient:
     async def company_search(self, **kwargs: Any) -> dict[str, Any]:
         return await self.request("POST", "/company/search", payload=_strip(kwargs))
 
-    # async def company_discover(self, **kwargs: Any) -> dict[str, Any]:
-    #     return await self.request("POST", "/company/discover", payload=_strip(kwargs))
+    async def company_discover(self, **kwargs: Any) -> dict[str, Any]:
+        return await self.request("POST", "/company/discover", payload=_strip(kwargs))
 
     async def company_bulk(self, **kwargs: Any) -> dict[str, Any]:
         return await self.request("POST", "/company/enrich/bulk", payload=_strip(kwargs))
@@ -138,6 +138,9 @@ class LegionClient:
     async def utility_validate(self, **kwargs: Any) -> dict[str, Any]:
         return await self.request("POST", "/utility/validate", payload=_strip(kwargs))
 
+    async def utility_report(self, kind: str, **kwargs: Any) -> dict[str, Any]:
+        return await self.request("POST", f"/utility/report/{kind}", payload=_strip(kwargs))
+
     async def credits_balance(self) -> dict[str, Any]:
         return await self.request("GET", "/credits")
 

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/src/datalegion_cli/commands/company.py

@@ -1,4 +1,4 @@
-"""Company enrichment and search commands."""
+"""Company enrichment, search, and discovery commands."""
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from datalegion_cli.async_typer import async_command
 from datalegion_cli.client import APIError, LegionClient
 from datalegion_cli.output import emit_credits, emit_error, emit_json
 
-app = typer.Typer(name="company", help="Company enrichment and search.")
+app = typer.Typer(name="company", help="Company enrichment, search, and discovery.")
 
 # ── Shared options ───────────────────────────────────────────────────
 
@@ -110,7 +110,7 @@ async def search(
     include_fields: FieldsInclude = None,
     exclude_fields: FieldsExclude = None,
 ) -> None:
-    """Search for companies using SQL WHERE syntax.
+    """Search for companies using SQL WHERE syntax (Beta).
 
     Examples:
         datalegion-cli company search "industry = 'Software' AND employee_count > 100"
@@ -135,30 +135,32 @@ async def search(
         await client.close()
 
 
-# TODO: Uncomment when discover is ready
-# @app.command()
-# @async_command
-# async def discover(
-#     query: Annotated[str, typer.Argument(help="Natural language company search query.")],
-#     limit: LimitOpt = 10,
-#     titlecase: TitleOpt = False,
-#     include_fields: FieldsInclude = None,
-#     exclude_fields: FieldsExclude = None,
-# ) -> None:
-#     """Search for companies using natural language."""
-#     client = LegionClient()
-#     try:
-#         result = await client.company_discover(
-#             query=query, limit=limit, titlecase=titlecase,
-#             include_fields=include_fields, exclude_fields=exclude_fields,
-#         )
-#         emit_json(result)
-#         emit_credits(client.last_credits_used, client.last_credits_remaining)
-#     except APIError as e:
-#         emit_error(e.message, code=e.error, details=e.details, as_json=True)
-#         raise typer.Exit(1) from e
-#     finally:
-#         await client.close()
+@app.command()
+@async_command
+async def discover(
+    query: Annotated[str, typer.Argument(help="Natural language company search query.")],
+    limit: LimitOpt = 10,
+    titlecase: TitleOpt = False,
+    include_fields: FieldsInclude = None,
+    exclude_fields: FieldsExclude = None,
+) -> None:
+    """Search for companies using natural language (Beta)."""
+    client = LegionClient()
+    try:
+        result = await client.company_discover(
+            query=query,
+            limit=limit,
+            titlecase=titlecase,
+            include_fields=include_fields,
+            exclude_fields=exclude_fields,
+        )
+        emit_json(result)
+        emit_credits(client.last_credits_used, client.last_credits_remaining)
+    except APIError as e:
+        emit_error(e.message, code=e.error, details=e.details, as_json=True)
+        raise typer.Exit(1) from e
+    finally:
+        await client.close()
 
 
 # TODO: Uncomment when bulk enrichment is ready

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/src/datalegion_cli/commands/person.py

@@ -1,4 +1,4 @@
-"""Person enrichment and search commands."""
+"""Person enrichment, search, and discovery commands."""
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from datalegion_cli.async_typer import async_command
 from datalegion_cli.client import APIError, LegionClient
 from datalegion_cli.output import emit_credits, emit_error, emit_json
 
-app = typer.Typer(name="person", help="Person enrichment and search.")
+app = typer.Typer(name="person", help="Person enrichment, search, and discovery.")
 
 # ── Shared options ───────────────────────────────────────────────────
 
@@ -136,7 +136,7 @@ async def search(
     include_fields: FieldsInclude = None,
     exclude_fields: FieldsExclude = None,
 ) -> None:
-    """Search for people using SQL WHERE syntax.
+    """Search for people using SQL WHERE syntax (Beta).
 
     Examples:
         datalegion-cli person search "job_title = 'CEO' AND company = 'Acme Corp'"
@@ -161,30 +161,32 @@ async def search(
         await client.close()
 
 
-# TODO: Uncomment when discover is ready
-# @app.command()
-# @async_command
-# async def discover(
-#     query: Annotated[str, typer.Argument(help="Natural language search query.")],
-#     limit: LimitOpt = 10,
-#     titlecase: TitleOpt = False,
-#     include_fields: FieldsInclude = None,
-#     exclude_fields: FieldsExclude = None,
-# ) -> None:
-#     """Search for people using natural language."""
-#     client = LegionClient()
-#     try:
-#         result = await client.person_discover(
-#             query=query, limit=limit, titlecase=titlecase,
-#             include_fields=include_fields, exclude_fields=exclude_fields,
-#         )
-#         emit_json(result)
-#         emit_credits(client.last_credits_used, client.last_credits_remaining)
-#     except APIError as e:
-#         emit_error(e.message, code=e.error, details=e.details, as_json=True)
-#         raise typer.Exit(1) from e
-#     finally:
-#         await client.close()
+@app.command()
+@async_command
+async def discover(
+    query: Annotated[str, typer.Argument(help="Natural language search query.")],
+    limit: LimitOpt = 10,
+    titlecase: TitleOpt = False,
+    include_fields: FieldsInclude = None,
+    exclude_fields: FieldsExclude = None,
+) -> None:
+    """Search for people using natural language (Beta)."""
+    client = LegionClient()
+    try:
+        result = await client.person_discover(
+            query=query,
+            limit=limit,
+            titlecase=titlecase,
+            include_fields=include_fields,
+            exclude_fields=exclude_fields,
+        )
+        emit_json(result)
+        emit_credits(client.last_credits_used, client.last_credits_remaining)
+    except APIError as e:
+        emit_error(e.message, code=e.error, details=e.details, as_json=True)
+        raise typer.Exit(1) from e
+    finally:
+        await client.close()
 
 
 # TODO: Uncomment when bulk enrichment is ready

{datalegion_cli-1.1.0 → datalegion_cli-1.2.0}/src/datalegion_cli/commands/utility.py

@@ -1,4 +1,4 @@
-"""Utility commands — clean, hash, validate."""
+"""Utility commands — clean, hash, validate, report."""
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from datalegion_cli.async_typer import async_command
 from datalegion_cli.client import APIError, LegionClient
 from datalegion_cli.output import emit_error, emit_json
 
-app = typer.Typer(name="utility", help="Data cleaning, hashing, and validation.")
+app = typer.Typer(name="utility", help="Data cleaning, hashing, validation, and issue reporting.")
 
 
 @app.command()
@@ -120,3 +120,69 @@ async def validate(
         raise typer.Exit(1) from e
     finally:
         await client.close()
+
+
+@app.command()
+@async_command
+async def report(
+    kind: Annotated[str, typer.Argument(help="Record type: person or company.")],
+    legion_id: Annotated[str, typer.Option("--legion-id", help="Legion ID of the record.")],
+    issue_type: Annotated[
+        str,
+        typer.Option(
+            "--issue-type",
+            help=(
+                "Issue type: incorrect, outdated, misattributed, frankenstein, "
+                "not_a_real_person (person only), or duplicate."
+            ),
+        ),
+    ],
+    issue_level: Annotated[
+        str,
+        typer.Option("--issue-level", help="Issue level: record, group, or field."),
+    ] = "record",
+    field: Annotated[
+        str | None,
+        typer.Option("--field", help="Group or field name (for group/field level issues)."),
+    ] = None,
+    observed_value: Annotated[
+        str | None, typer.Option("--observed", help="The incorrect value you observed.")
+    ] = None,
+    correct_value: Annotated[
+        str | None, typer.Option("--correct", help="The correct value, if known.")
+    ] = None,
+    comment: Annotated[
+        str | None, typer.Option("--comment", help="Free-form description of the issue.")
+    ] = None,
+) -> None:
+    """Report a data issue on a person or company record (no credit cost).
+
+    Include at least one of --correct or --comment.
+
+    Examples:
+        datalegion-cli utility report person --legion-id abc123 --issue-type outdated \\
+            --issue-level field --field job_title --observed "CTO" --correct "CEO"
+        datalegion-cli utility report company --legion-id xyz789 --issue-type duplicate \\
+            --comment "Same company as legion_id def456"
+    """
+    if kind not in ("person", "company"):
+        raise typer.BadParameter("kind must be 'person' or 'company'.")
+
+    client = LegionClient()
+    try:
+        result = await client.utility_report(
+            kind,
+            legion_id=legion_id,
+            issue_type=issue_type,
+            issue_level=issue_level,
+            field=field,
+            observed_value=observed_value,
+            correct_value=correct_value,
+            comment=comment,
+        )
+        emit_json(result)
+    except APIError as e:
+        emit_error(e.message, code=e.error, details=e.details, as_json=True)
+        raise typer.Exit(1) from e
+    finally:
+        await client.close()