cassis-cli 1.3.0__tar.gz → 1.4.0__tar.gz

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cassis-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: Cassis CLI — run Cassis actions (ontology validation, upload and publish) from your CI pipelines
 License: Apache-2.0
 License-File: LICENSE
@@ -24,7 +24,7 @@ Description-Content-Type: text/markdown
 
 Run Cassis actions from your CI pipelines:
 
-- `cassis ontology check` validates the ontology files in your repository with the exact same checks as the Cassis GitHub PR check (YAML parsing, round-trip, import validation) — so you can gate merges in any CI system, not just GitHub. In a checkout bound to a project (`project.yml`, `--project`, or `CASSIS_PROJECT_ID`), it also cross-checks the tree against the project's source schema: references to tables or columns the warehouse doesn't have print as **warnings** — advisory only (the object may simply not be built or synced yet), never a failed check.
+- `cassis ontology check` validates the ontology files in your repository with the exact same checks as the Cassis GitHub PR check (YAML parsing, round-trip, import validation) — so you can gate merges in any CI system, not just GitHub. It then prints advisory **ontology quality warnings** for a tree that parsed — tables not assigned to any domain, joins/metrics pointing at unknown tables or columns, missing table/column descriptions (the same findings `ontology test` reports, without the agent run). In a checkout bound to a project (`project.yml`, `--project`, or `CASSIS_PROJECT_ID`), it also cross-checks the tree against the project's source schema: references to tables or columns the warehouse doesn't have print as **warnings** too — advisory only (the object may simply not be built or synced yet). Warnings never fail the check.
 - `cassis schema pull` downloads the data source's full source schema (as Cassis last introspected it) into `<base-path>/.schema.json` — a **gitignored** local snapshot (the command maintains the ignore entry) with a `pulled_at` stamp. The warehouse stays authoritative; the snapshot is a cache for offline/bulk work — e.g. a coding agent grepping table and column names during a modeling pass instead of paging through the MCP `get_source_schema` tool. Re-run to refresh.
 - `cassis ontology fmt` rewrites the ontology files in canonical form (think `black`/`gofmt` for the ontology), so hand or agent edits pass the round-trip check.
 - `cassis ontology upload` uploads the ontology files to a Cassis project (full replace) and, by default, publishes them immediately as a new version — so a merge to your main branch can go live in one CI step.

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/README.md

@@ -2,7 +2,7 @@
 
 Run Cassis actions from your CI pipelines:
 
-- `cassis ontology check` validates the ontology files in your repository with the exact same checks as the Cassis GitHub PR check (YAML parsing, round-trip, import validation) — so you can gate merges in any CI system, not just GitHub. In a checkout bound to a project (`project.yml`, `--project`, or `CASSIS_PROJECT_ID`), it also cross-checks the tree against the project's source schema: references to tables or columns the warehouse doesn't have print as **warnings** — advisory only (the object may simply not be built or synced yet), never a failed check.
+- `cassis ontology check` validates the ontology files in your repository with the exact same checks as the Cassis GitHub PR check (YAML parsing, round-trip, import validation) — so you can gate merges in any CI system, not just GitHub. It then prints advisory **ontology quality warnings** for a tree that parsed — tables not assigned to any domain, joins/metrics pointing at unknown tables or columns, missing table/column descriptions (the same findings `ontology test` reports, without the agent run). In a checkout bound to a project (`project.yml`, `--project`, or `CASSIS_PROJECT_ID`), it also cross-checks the tree against the project's source schema: references to tables or columns the warehouse doesn't have print as **warnings** too — advisory only (the object may simply not be built or synced yet). Warnings never fail the check.
 - `cassis schema pull` downloads the data source's full source schema (as Cassis last introspected it) into `<base-path>/.schema.json` — a **gitignored** local snapshot (the command maintains the ignore entry) with a `pulled_at` stamp. The warehouse stays authoritative; the snapshot is a cache for offline/bulk work — e.g. a coding agent grepping table and column names during a modeling pass instead of paging through the MCP `get_source_schema` tool. Re-run to refresh.
 - `cassis ontology fmt` rewrites the ontology files in canonical form (think `black`/`gofmt` for the ontology), so hand or agent edits pass the round-trip check.
 - `cassis ontology upload` uploads the ontology files to a Cassis project (full replace) and, by default, publishes them immediately as a new version — so a merge to your main branch can go live in one CI step.

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/cassis_cli/__init__.py

@@ -1,3 +1,3 @@
 """Cassis CLI — run Cassis actions from your CI pipelines."""
 
-__version__ = "1.2.0"
+__version__ = "1.4.0"

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/cassis_cli/api.py

@@ -139,9 +139,10 @@ def post_ontology_check(
 ) -> dict[str, Any]:
     """POST the ontology tree to the check endpoint and return the response body.
 
+    Both routes return advisory ``audit`` quality findings in ``warnings``.
     With ``project_id``, calls the project-scoped route, which additionally
-    cross-checks the tree against the project's source schema and returns
-    advisory ``warnings``; without it, the pure tree check.
+    cross-checks the tree against the project's source schema and adds
+    ``references`` warnings; without it, the pure tree check.
     """
     if project_id:
         url = api_url.rstrip("/") + f"/api/ci/projects/{project_id}/ontology/check"

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/cassis_cli/ontology.py

@@ -85,11 +85,14 @@ def check(
     """Validate the ontology files in a repository checkout.
 
     Runs the same checks as the Cassis GitHub PR check (YAML parsing,
-    round-trip, import validation). When the checkout is bound to a project
+    round-trip, import validation), then prints advisory quality warnings
+    (unassigned tables, broken joins/metrics, missing descriptions) for a
+    tree that parsed. When the checkout is bound to a project
     (``project.yml``, ``--project``, or ``CASSIS_PROJECT_ID``), the tree is
     additionally cross-checked against the project's source schema; unmatched
-    references print as warnings and never fail the check. Exits 0 when valid,
-    1 when validation fails, 2 on usage errors, 3 on transport/API errors.
+    references print as warnings too. Warnings never fail the check or change
+    the exit code. Exits 0 when valid, 1 when validation fails, 2 on usage
+    errors, 3 on transport/API errors.
     """
     api_key = _require_api_key(api_key)
     files, base_path = _collect_tree(path, base_path)
@@ -114,13 +117,17 @@ def check(
         raise typer.Exit(EXIT_TRANSPORT) from exc
 
     warnings = result.get("warnings") or []
+    ref_warnings = [w for w in warnings if w.get("stage") == "references"]
+    # Everything else is the quality audit; bucketing by "not references" keeps
+    # a warning stage this CLI predates visible instead of silently dropped.
+    audit_warnings = [w for w in warnings if w.get("stage") != "references"]
     if json_output:
         typer.echo(json.dumps(result, indent=2))
     elif result["passed"]:
         typer.secho(f"✓ {result['summary']}", fg=typer.colors.GREEN)
         # Disambiguate silence: "no warnings" must never read as "references
         # verified" when the stage didn't run.
-        if project_id and result.get("references_checked") and not warnings:
+        if project_id and result.get("references_checked") and not ref_warnings:
             typer.secho("✓ Schema references resolve against the source schema.", fg=typer.colors.GREEN)
         elif project_id and not result.get("references_checked"):
             typer.secho(
@@ -135,14 +142,23 @@ def check(
             location = f"{base_path}/{finding.get('path')}: " if finding.get("path") else ""
             typer.echo(f"  {location}{finding.get('message', '')} ({finding.get('stage', '?')})")
 
-    if warnings and not json_output:
+    if ref_warnings and not json_output:
         typer.secho(
-            f"{len(warnings)} schema reference warning(s) — advisory, expected if the objects "
+            f"{len(ref_warnings)} schema reference warning(s) — advisory, expected if the objects "
             "haven't been built or synced yet:",
             fg=typer.colors.YELLOW,
             bold=True,
         )
-        for warning in warnings:
+        for warning in ref_warnings:
+            typer.secho(f"  {warning.get('message', '')}", fg=typer.colors.YELLOW)
+    if audit_warnings and not json_output:
+        # Same wording as `ontology test` so the two commands read alike.
+        typer.secho(
+            f"{len(audit_warnings)} ontology quality warning(s) — advisory, never fail the check:",
+            fg=typer.colors.YELLOW,
+            bold=True,
+        )
+        for warning in audit_warnings:
             typer.secho(f"  {warning.get('message', '')}", fg=typer.colors.YELLOW)
 
     raise typer.Exit(EXIT_OK if result["passed"] else EXIT_VALIDATION_FAILED)

{cassis_cli-1.3.0 → cassis_cli-1.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cassis-cli"
-version = "1.3.0"
+version = "1.4.0"
 description = "Cassis CLI — run Cassis actions (ontology validation, upload and publish) from your CI pipelines"
 readme = "README.md"
 license = { text = "Apache-2.0" }