compass-kb-validation 2.9.0__tar.gz → 3.0.0__tar.gz

{compass_kb_validation-2.9.0 → compass_kb_validation-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compass-kb-validation
-Version: 2.9.0
+Version: 3.0.0
 Summary: Knowledge-base readiness validation for RAG & AI agents — config-driven, deterministic pipeline integrity checks.
 Author: COMPASS
 License: MIT
@@ -303,7 +303,7 @@ a mock ingestion API — see **[integration/README.md](integration/README.md)**.
 compass/
 ├── run_validation.py              # Entry point — live ingestion validation
 ├── discover_and_validate.py       # Entry point — post-hoc discovery
-├── ingestion_validation/          # Main package
+├── compass/          # Main package
 │   ├── models/                    # StepResult / PipelineResult (stdlib dataclasses)
 │   ├── config/                    # Layered YAML config + typed Settings
 │   ├── utils/                     # Run-id, logging, polling w/ backoff
@@ -391,9 +391,9 @@ environments:
 Steps are declarative — register a validator and reference it in `pipeline.steps`:
 
 ```python
-from ingestion_validation.validators.base import BaseValidator
-from ingestion_validation.validators.registry import register_step, StepSpec
-from ingestion_validation.models import StepResult, StepStatus
+from compass.validators.base import BaseValidator
+from compass.validators.registry import register_step, StepSpec
+from compass.models import StepResult, StepStatus
 
 class PiiRedactionValidator(BaseValidator):
     step_name = "PII Redaction"
@@ -420,7 +420,7 @@ the KB is not retrieval-ready. Every entry point returns a CI-friendly exit
 code — **0 = gate passed, 1 = gate failed, 2 = config error** — and emits JUnit
 XML for any CI system.
 
-> **Reliable exit codes:** invoke the gate via `python -m ingestion_validation discover …`
+> **Reliable exit codes:** invoke the gate via `python -m compass discover …`
 > or the `compass-discover` console script — both `sys.exit()` the code directly. Avoid
 > piping (`… | tee`) which returns the pipe's exit code, and note that the `compass` shim in
 > Git-Bash on Windows can drop the code. To verify in a shell: `… ; echo $?` (bash) or

{compass_kb_validation-2.9.0 → compass_kb_validation-3.0.0}/README.md

@@ -236,7 +236,7 @@ a mock ingestion API — see **[integration/README.md](integration/README.md)**.
 compass/
 ├── run_validation.py              # Entry point — live ingestion validation
 ├── discover_and_validate.py       # Entry point — post-hoc discovery
-├── ingestion_validation/          # Main package
+├── compass/          # Main package
 │   ├── models/                    # StepResult / PipelineResult (stdlib dataclasses)
 │   ├── config/                    # Layered YAML config + typed Settings
 │   ├── utils/                     # Run-id, logging, polling w/ backoff
@@ -324,9 +324,9 @@ environments:
 Steps are declarative — register a validator and reference it in `pipeline.steps`:
 
 ```python
-from ingestion_validation.validators.base import BaseValidator
-from ingestion_validation.validators.registry import register_step, StepSpec
-from ingestion_validation.models import StepResult, StepStatus
+from compass.validators.base import BaseValidator
+from compass.validators.registry import register_step, StepSpec
+from compass.models import StepResult, StepStatus
 
 class PiiRedactionValidator(BaseValidator):
     step_name = "PII Redaction"
@@ -353,7 +353,7 @@ the KB is not retrieval-ready. Every entry point returns a CI-friendly exit
 code — **0 = gate passed, 1 = gate failed, 2 = config error** — and emits JUnit
 XML for any CI system.
 
-> **Reliable exit codes:** invoke the gate via `python -m ingestion_validation discover …`
+> **Reliable exit codes:** invoke the gate via `python -m compass discover …`
 > or the `compass-discover` console script — both `sys.exit()` the code directly. Avoid
 > piping (`… | tee`) which returns the pipe's exit code, and note that the `compass` shim in
 > Git-Bash on Windows can drop the code. To verify in a shell: `… ; echo $?` (bash) or

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/__init__.py

@@ -5,4 +5,4 @@ end-to-end: API upload -> object storage -> knowledge graph -> vector store ->
 retrieval quality, plus cross-store consistency.
 """
 
-__version__ = "2.9.0"
+__version__ = "3.0.0"

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/__main__.py

@@ -1,4 +1,4 @@
-"""Allow `python -m ingestion_validation ...` as a portable entry point.
+"""Allow `python -m compass ...` as a portable entry point.
 
 A reliable fallback when the installed `compass` console script isn't on PATH or
 hits a permission quirk (e.g. Git Bash on Windows resolving the non-exe wrapper).
@@ -6,7 +6,7 @@ hits a permission quirk (e.g. Git Bash on Windows resolving the non-exe wrapper)
 
 import sys
 
-from ingestion_validation.cli import main
+from compass.cli import main
 
 if __name__ == "__main__":
     sys.exit(main(sys.argv[1:]))

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/ask.py

@@ -15,8 +15,8 @@ from __future__ import annotations
 import struct
 from typing import Any
 
-from ingestion_validation.config import Settings
-from ingestion_validation.providers import get_adapter
+from compass.config import Settings
+from compass.providers import get_adapter
 
 
 def pack_f32(vec: list[float]) -> bytes:

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/cli.py

@@ -154,7 +154,7 @@ reports/
 """
 
 # A ready GitHub Actions gate: validate the KB on every push and fail the build on a
-# regression. `python -m ingestion_validation` (not the `compass` shim) so the exit code
+# regression. `python -m compass` (not the `compass` shim) so the exit code
 # is never dropped by a wrapper.
 _CI_WORKFLOW = """\
 # COMPASS knowledge-base validation gate. Fails the build if the KB regresses.
@@ -183,7 +183,7 @@ jobs:
           REDIS_PASSWORD: ${{{{ secrets.REDIS_PASSWORD }}}}
           # OPENAI_API_KEY: ${{{{ secrets.OPENAI_API_KEY }}}}
         run: |
-          python -m ingestion_validation discover --project {name} \\
+          python -m compass discover --project {name} \\
             --fail-under 99 \\
             --against baselines/{name}.json --fail-on-regression
 """
@@ -214,7 +214,7 @@ def cmd_init(argv: list[str]) -> int:
             print("  --interactive needs a terminal (stdin is not a TTY). "
                   "Run `compass init <name>` for the non-interactive scaffold.")
             return 2
-        from ingestion_validation.init_wizard import run_wizard
+        from compass.init_wizard import run_wizard
         print("  COMPASS project wizard - answer a few questions (Enter accepts the default).\n")
         result = run_wizard(name)
         name, project_yaml, env_example = result["name"], result["project_yaml"], result["env_example"]
@@ -282,8 +282,8 @@ def cmd_lint(argv: list[str]) -> int:
                    help="Exit non-zero on warnings AND advisories too, not just errors.")
     args = p.parse_args(argv)
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.config_lint import format_findings, lint_settings
+    from compass.config import load_settings, project_config_file
+    from compass.config_lint import format_findings, lint_settings
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -316,7 +316,7 @@ def _reach(fn) -> tuple[bool, str]:
 
 def _diag_lines(target: str, default_port: int, *, tls=None) -> list[str]:
     """Run DNS/TCP/TLS diagnostics on one endpoint and format them for the console."""
-    from ingestion_validation.diagnostics import diagnose_endpoint
+    from compass.diagnostics import diagnose_endpoint
 
     d = diagnose_endpoint(target, default_port, tls=tls)
     out: list[str] = []
@@ -369,7 +369,7 @@ def cmd_doctor(argv: list[str]) -> int:
     if args.all_projects:
         return _doctor_all_projects(args)
 
-    from ingestion_validation.config import find_project_root, load_settings, validate_config
+    from compass.config import find_project_root, load_settings, validate_config
 
     try:
         settings = load_settings(project=args.project, env=args.env)
@@ -404,7 +404,7 @@ def cmd_doctor(argv: list[str]) -> int:
 
 def _doctor_stages(s) -> list:
     """(label, configured?, probe, detail, diagnostic-target, default-port, tls) per stage."""
-    from ingestion_validation.providers import get_adapter
+    from compass.providers import get_adapter
     return [
         ("Vector store", bool(s.redis.host),
          lambda: get_adapter("vectorstore", s.redis.provider, config=s.redis).ping(),
@@ -458,7 +458,7 @@ def _doctor_run(settings, *, verbose: bool, indent: str = "  ") -> tuple[int, bo
 
 def _doctor_all_projects(args) -> int:
     """Run connectivity across every project under config/projects/ (ENH-34)."""
-    from ingestion_validation.config import list_projects, load_settings
+    from compass.config import list_projects, load_settings
 
     names = list_projects()
     if not names:
@@ -518,7 +518,7 @@ def _settings_from_check(args):
     """Build an in-memory Settings from check flags / connection URL (no project YAML)."""
     import os
 
-    from ingestion_validation.config import Settings
+    from compass.config import Settings
 
     settings = Settings()
     r = settings.redis
@@ -598,10 +598,10 @@ def cmd_check(argv: list[str]) -> int:
         return 2
 
     import discover_and_validate as dav
-    from ingestion_validation.corpus import analyze_corpus
-    from ingestion_validation.profiler import apply_profile_to_settings, profile_kb
-    from ingestion_validation.report import generate_batch_dashboard
-    from ingestion_validation.utils import configure_logging, new_run_id
+    from compass.corpus import analyze_corpus
+    from compass.profiler import apply_profile_to_settings, profile_kb
+    from compass.report import generate_batch_dashboard
+    from compass.utils import configure_logging, new_run_id
 
     configure_logging()
     run_id = new_run_id()
@@ -665,7 +665,7 @@ def cmd_check(argv: list[str]) -> int:
 
 def _baseline_step(args, results, corpus, project: str, run_id: str, profile: dict | None) -> bool:
     """Save a baseline and/or diff against one. Returns True if a regression was found."""
-    from ingestion_validation import baseline as bl
+    from compass import baseline as bl
 
     if getattr(args, "save_baseline", None) is not None:
         out = args.save_baseline or f"baselines/{project}.json"
@@ -690,9 +690,9 @@ def cmd_demo(argv: list[str]) -> int:
     p.add_argument("--no-open", action="store_true")
     args = p.parse_args(argv)
 
-    from ingestion_validation.corpus import analyze_corpus
-    from ingestion_validation.models import PipelineResult, StepResult, StepStatus
-    from ingestion_validation.report import generate_batch_dashboard
+    from compass.corpus import analyze_corpus
+    from compass.models import PipelineResult, StepResult, StepStatus
+    from compass.report import generate_batch_dashboard
 
     def _doc(i: int, mode: str) -> dict:
         # mode: "clean" = all pass; "advisory" = PASSED but with warn/neutral misses
@@ -761,7 +761,7 @@ def _supports_filters(provider: str) -> bool:
     Asked of the registered adapter class (a declared capability), never inferred from
     the vendor name - so a new backend that supports filters works with no CLI change.
     """
-    from ingestion_validation.providers import capability
+    from compass.providers import capability
 
     return bool(capability("vectorstore", provider, "supports_metadata_filters", False))
 
@@ -803,10 +803,10 @@ def cmd_ask(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation import __version__
-    from ingestion_validation.ask import ask_kb, format_text, parse_filters
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.eval_interop import normalize_filters, to_eval_case
+    from compass import __version__
+    from compass.ask import ask_kb, format_text, parse_filters
+    from compass.config import load_settings, project_config_file
+    from compass.eval_interop import normalize_filters, to_eval_case
 
     question = " ".join(args.question).strip()
     if not question and not args.batch:
@@ -904,7 +904,7 @@ def cmd_mcp(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.mcp_server import serve, vscode_config
+    from compass.mcp_server import serve, vscode_config
 
     if args.print_config:
         print(_json.dumps(vscode_config(args.project, args.env or None), indent=2))
@@ -918,7 +918,7 @@ def cmd_mcp(argv: list[str]) -> int:
     except Exception:  # noqa: BLE001 - dotenv optional / file absent
         pass
 
-    from ingestion_validation.config import load_settings, project_config_file
+    from compass.config import load_settings, project_config_file
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
         return 2
@@ -965,8 +965,8 @@ def cmd_migrate(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.retrieval_analysis import format_migration, migration_report
+    from compass.config import load_settings, project_config_file
+    from compass.retrieval_analysis import format_migration, migration_report
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -994,7 +994,7 @@ def cmd_migrate(argv: list[str]) -> int:
         return 1
 
     if args.html or args.open:
-        from ingestion_validation.report.analysis import generate_migration_report
+        from compass.report.analysis import generate_migration_report
         html_path = generate_migration_report(payload, args.html or "reports/migration-report.html",
                                                project=args.project or "")
         print(f"  HTML report: {html_path}")
@@ -1066,8 +1066,8 @@ def cmd_coverage(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.retrieval_analysis import coverage_report, format_coverage
+    from compass.config import load_settings, project_config_file
+    from compass.retrieval_analysis import coverage_report, format_coverage
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1084,8 +1084,8 @@ def cmd_coverage(argv: list[str]) -> int:
         print(f"  No questions found in {args.questions}.")
         return 2
 
-    from ingestion_validation.ask import parse_filters
-    from ingestion_validation.eval_interop import normalize_filters
+    from compass.ask import parse_filters
+    from compass.eval_interop import normalize_filters
     filters = parse_filters(args.filter)
     if args.filter_json:
         try:
@@ -1110,7 +1110,7 @@ def cmd_coverage(argv: list[str]) -> int:
         return 1
 
     if args.html or args.open:
-        from ingestion_validation.report.analysis import generate_coverage_report
+        from compass.report.analysis import generate_coverage_report
         html_path = generate_coverage_report(payload, args.html or "reports/coverage-report.html",
                                               project=args.project or "")
         print(f"  HTML report: {html_path}")
@@ -1170,9 +1170,9 @@ def cmd_compare(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.eval_interop import load_ground_truth
-    from ingestion_validation.retrieval_analysis import comparison_report, format_comparison
+    from compass.config import load_settings, project_config_file
+    from compass.eval_interop import load_ground_truth
+    from compass.retrieval_analysis import comparison_report, format_comparison
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1216,7 +1216,7 @@ def cmd_compare(argv: list[str]) -> int:
         return 1
 
     if args.html or args.open:
-        from ingestion_validation.report.analysis import generate_comparison_report
+        from compass.report.analysis import generate_comparison_report
         html_path = generate_comparison_report(payload, args.html or "reports/comparison-report.html",
                                                 project=args.project or "")
         print(f"  HTML report: {html_path}")
@@ -1279,8 +1279,8 @@ def cmd_evidence(argv: list[str]) -> int:
     except Exception:  # noqa: BLE001 - dotenv optional / file absent
         pass
 
-    from ingestion_validation import evidence as ev
-    from ingestion_validation.config import load_settings, project_config_file
+    from compass import evidence as ev
+    from compass.config import load_settings, project_config_file
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1316,7 +1316,7 @@ def cmd_evidence(argv: list[str]) -> int:
         return 1
 
     if args.format == "html":
-        from ingestion_validation.report.audit import generate_evidence_report
+        from compass.report.audit import generate_evidence_report
         out = generate_evidence_report(payload, args.output or f"reports/evidence-{args.project or 'kb'}.html",
                                        project=args.project or "")
         print(f"  HTML report: {out}")
@@ -1342,7 +1342,7 @@ def cmd_evidence(argv: list[str]) -> int:
 
 
 def evidence_mod_all() -> tuple:
-    from ingestion_validation.evidence import ALL_CHECKS
+    from compass.evidence import ALL_CHECKS
     return ALL_CHECKS
 
 
@@ -1362,8 +1362,8 @@ def cmd_quality(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.corpus_health import format_quality, quality_report
+    from compass.config import load_settings, project_config_file
+    from compass.corpus_health import format_quality, quality_report
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1410,8 +1410,8 @@ def cmd_freshness(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.corpus_health import format_freshness, freshness_report
+    from compass.config import load_settings, project_config_file
+    from compass.corpus_health import format_freshness, freshness_report
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1442,8 +1442,8 @@ def _graph_doc_exists(settings):
     """Build a source-existence callback backed by a configured graph, using the
     eval.citation_graph_ask SPARQL ASK template ("{doc}" substituted). Returns None if no
     graph is configured/reachable, so the audit simply skips the extra check."""
-    from ingestion_validation.profiler import _configured_graph
-    from ingestion_validation.providers import get_adapter
+    from compass.profiler import _configured_graph
+    from compass.providers import get_adapter
 
     cfg, provider = _configured_graph(settings)
     template = getattr(settings.eval, "citation_graph_ask", "")
@@ -1489,9 +1489,9 @@ def cmd_grounding_audit(argv: list[str]) -> int:
 
     import json as _json
 
-    from ingestion_validation.config import load_settings, project_config_file
-    from ingestion_validation.grounding import render_report, run_audit
-    from ingestion_validation.providers import get_adapter
+    from compass.config import load_settings, project_config_file
+    from compass.grounding import render_report, run_audit
+    from compass.providers import get_adapter
 
     if args.project and project_config_file(args.project) is None:
         print(f"  Project '{args.project}' not found (config/projects/{args.project}.yaml).")
@@ -1559,7 +1559,7 @@ def cmd_grounding_audit(argv: list[str]) -> int:
     results = [run_audit(rec, adapter, settings.eval, doc_exists=doc_exists) for rec in records]
 
     if args.format == "html":
-        from ingestion_validation.report.audit import generate_grounding_report
+        from compass.report.audit import generate_grounding_report
         out = generate_grounding_report(results, args.output or f"reports/grounding-{args.project or 'kb'}.html",
                                         project=args.project or "")
         print(f"  HTML report: {out}")
@@ -1646,7 +1646,7 @@ def cmd_selftest(argv: list[str]) -> int:
     still sees 0 the code is dropped by a pipe or a stale/wrapped `compass`, not by COMPASS.
     This exits with a distinctive code so the user can check it directly.
     """
-    from ingestion_validation import __version__
+    from compass import __version__
 
     print(f"compass {__version__}")
     print(f"  module: {__file__}")
@@ -1664,9 +1664,9 @@ def cmd_selftest(argv: list[str]) -> int:
     print("    PowerShell:       compass selftest ; echo \"exit=$LASTEXITCODE\"")
     print(f"  If you see exit={_SELFTEST_CODE}: exit codes propagate, so a 0 from a FAILED")
     print("     `compass discover --fail-under ...` is a pipe (e.g. `| tee`) or a wrapper")
-    print("     dropping it - use `python -m ingestion_validation discover ...` in CI.")
+    print("     dropping it - use `python -m compass discover ...` in CI.")
     print("  If you see exit=0 here: your `compass` command is NOT this build (stale/shim);")
-    print("     reinstall, or run `python -m ingestion_validation selftest`.")
+    print("     reinstall, or run `python -m compass selftest`.")
     return _SELFTEST_CODE
 
 
@@ -1710,7 +1710,7 @@ Run `compass <command> --help` for command-specific options.
 def main(argv: list[str] | None = None) -> int:
     argv = list(sys.argv[1:] if argv is None else argv)
     if argv and argv[0] in ("--version", "-V", "version"):
-        from ingestion_validation import __version__
+        from compass import __version__
         print(f"compass {__version__}")
         return 0
     if not argv or argv[0] in ("-h", "--help", "help"):

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/config/__init__.py

@@ -137,7 +137,7 @@ def _default_s3_checks() -> dict[str, bool]:
 @dataclass
 class S3Config:
     # provider selects the storage adapter: s3 | minio | r2 | spaces | wasabi |
-    # azure_blob | gcs | ... (see ingestion_validation/providers/storage.py)
+    # azure_blob | gcs | ... (see compass/providers/storage.py)
     provider: str = "s3"
     # vendor-specific options (e.g. endpoint_url_env, addressing_style) passed
     # verbatim to the adapter.

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/config_lint.py

@@ -138,7 +138,7 @@ def _lint_skip_steps(settings: Any) -> list[Finding]:
     if not skip:
         return []
     try:
-        from ingestion_validation.validators.registry import registered_steps
+        from compass.validators.registry import registered_steps
         known = list(registered_steps())
     except Exception:  # noqa: BLE001 - registry unavailable; skip this check rather than crash lint
         return []

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/corpus_health.py

@@ -13,8 +13,8 @@ from collections import Counter
 from datetime import datetime, timezone
 from typing import Any, Optional
 
-from ingestion_validation.config import Settings
-from ingestion_validation.providers import get_adapter
+from compass.config import Settings
+from compass.providers import get_adapter
 
 _WORD = re.compile(r"\w+")
 _SENTENCE_END = tuple(".!?\"')]}")

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/evidence.py

@@ -17,9 +17,9 @@ import re
 from dataclasses import dataclass, field
 from typing import Any, Optional
 
-from ingestion_validation import text_probes
-from ingestion_validation.providers import get_adapter
-from ingestion_validation.retrieval_analysis import _cosine, _unpack_f32
+from compass import text_probes
+from compass.providers import get_adapter
+from compass.retrieval_analysis import _cosine, _unpack_f32
 
 ALL_CHECKS = ("paraphrase", "boundary_spanning", "exact_term",
               "duplicate_chunks", "near_duplicate", "chunk_boundaries")

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/live_dashboard.py

@@ -14,7 +14,7 @@ import time
 import webbrowser
 from datetime import datetime, timezone
 
-from ingestion_validation.pipeline import PIPELINE_STEPS
+from compass.pipeline import PIPELINE_STEPS
 
 log = logging.getLogger(__name__)
 

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/mcp_server.py

@@ -15,10 +15,10 @@ import json
 import sys
 from typing import Any
 
-from ingestion_validation import __version__
-from ingestion_validation.ask import ask_kb
-from ingestion_validation.config import Settings
-from ingestion_validation.providers import get_adapter
+from compass import __version__
+from compass.ask import ask_kb
+from compass.config import Settings
+from compass.providers import get_adapter
 
 PROTOCOL_VERSION = "2024-11-05"
 
@@ -209,7 +209,7 @@ def serve(settings: Settings, stdin: Any = None, stdout: Any = None) -> None:
 
 def vscode_config(project: str | None, env: str | None) -> dict:
     """A ready-to-paste .vscode/mcp.json snippet for this project."""
-    args = ["-m", "ingestion_validation", "mcp"]
+    args = ["-m", "compass", "mcp"]
     if project:
         args += ["--project", project]
     if env:

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/notifications.py

@@ -14,7 +14,7 @@ import os
 
 import requests
 
-from ingestion_validation.models import PipelineResult
+from compass.models import PipelineResult
 
 log = logging.getLogger(__name__)
 

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/pipeline/__init__.py

@@ -6,11 +6,11 @@ import logging
 import time
 from typing import Callable, Optional
 
-from ingestion_validation.config import Settings
-from ingestion_validation.models import PipelineResult, StepResult, StepStatus
-from ingestion_validation.utils import get_run_id
-from ingestion_validation.validators.base import BaseValidator
-from ingestion_validation.validators.registry import build_validators, get_step, registered_steps
+from compass.config import Settings
+from compass.models import PipelineResult, StepResult, StepStatus
+from compass.utils import get_run_id
+from compass.validators.base import BaseValidator
+from compass.validators.registry import build_validators, get_step, registered_steps
 
 log = logging.getLogger(__name__)
 
@@ -86,7 +86,7 @@ class IngestionPipeline:
 
         ``settings.pipeline.steps`` lets a project declare its own pipeline shape
         and order in YAML, including custom steps registered via
-        :mod:`ingestion_validation.validators.registry`.
+        :mod:`compass.validators.registry`.
         """
         return build_validators(self.settings, self.settings.pipeline.steps or None)
 

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/profiler.py

@@ -13,7 +13,7 @@ from __future__ import annotations
 from collections import Counter
 from typing import Any
 
-from ingestion_validation.providers import get_adapter
+from compass.providers import get_adapter
 
 # Content types that mean "no MIME metadata was set at upload" (informational only).
 _GENERIC_MIME = {"", "(empty)", "binary/octet-stream", "application/octet-stream"}

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/provenance.py

@@ -145,7 +145,7 @@ def probe_provenance(
 
 def inspect_and_extract(body: bytes, file_name: str) -> str:
     """Return the plain text of a source object using the multi-format inspector's extractors."""
-    from ingestion_validation.content_inspect import detect_format
+    from compass.content_inspect import detect_format
 
     fmt = detect_format(body, file_name)
     # Reuse the format handlers but keep only their extracted-text detail. Simpler: pull the
@@ -153,12 +153,12 @@ def inspect_and_extract(body: bytes, file_name: str) -> str:
     if fmt == "pdf":
         return _pdf_text(body)
     if fmt in ("docx", "pptx", "xlsx"):
-        from ingestion_validation.content_inspect import _zip_text
+        from compass.content_inspect import _zip_text
         prefix = {"docx": "word/", "pptx": "ppt/slides/", "xlsx": "xl/"}[fmt]
         text, _ = _zip_text(body, prefix)
         return text or ""
     if fmt in ("html", "xml"):
-        from ingestion_validation.content_inspect import _strip_xml_text
+        from compass.content_inspect import _strip_xml_text
         cleaned = re.sub(rb"(?is)<(script|style)[^>]*>.*?</\1>", b" ", body)
         return _strip_xml_text(cleaned)
     if fmt == "text":

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/providers/__init__.py

@@ -4,7 +4,7 @@ This is the extensibility backbone for supporting additional backends.
 Each backend category — object storage, vector store, knowledge graph — defines
 an adapter ABC. Concrete adapters register themselves under a vendor name:
 
-    from ingestion_validation.providers import register
+    from compass.providers import register
 
     @register("storage", "azure_blob")
     class AzureBlobAdapter(StorageAdapter):
@@ -33,11 +33,11 @@ _REGISTRY: dict[str, dict[str, Type[Any]]] = {}
 # Built-in adapter modules imported lazily on first access of a category, so
 # importing this package never forces optional SDKs (boto3, redis, ...) to load.
 _BUILTIN_MODULES: dict[str, list[str]] = {
-    "storage": ["ingestion_validation.providers.storage"],
-    "vectorstore": ["ingestion_validation.providers.vectorstore"],
-    "graph": ["ingestion_validation.providers.graph"],
-    "source": ["ingestion_validation.providers.source"],
-    "embedding": ["ingestion_validation.providers.embedding"],
+    "storage": ["compass.providers.storage"],
+    "vectorstore": ["compass.providers.vectorstore"],
+    "graph": ["compass.providers.graph"],
+    "source": ["compass.providers.source"],
+    "embedding": ["compass.providers.embedding"],
 }
 
 _loaded_categories: set[str] = set()

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/providers/embedding.py

@@ -24,7 +24,7 @@ import os
 from abc import ABC, abstractmethod
 from typing import Any
 
-from ingestion_validation.providers import register
+from compass.providers import register
 
 log = logging.getLogger(__name__)
 

{compass_kb_validation-2.9.0/ingestion_validation → compass_kb_validation-3.0.0/compass}/providers/graph.py

@@ -20,7 +20,7 @@ import time
 from abc import ABC, abstractmethod
 from typing import Any, Optional
 
-from ingestion_validation.providers import register
+from compass.providers import register
 
 log = logging.getLogger(__name__)