survey-scribe 0.1.0__tar.gz

survey_scribe-0.1.0/.gitignore

@@ -0,0 +1,73 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+.venv/
+venv/
+env/
+*.egg-info/
+dist/
+build/
+site/
+
+# Environment variables - NEVER commit these files
+.env
+.env.*
+!.env.example
+
+# Generated outputs
+output/*
+!output/.gitkeep
+survey-scribe.toml
+**/.survey-scribe/
+*_svis.json
+!tests/fixtures/**/*_svis.json
+craft_mlt_25k.zip
+english_g2.zip
+
+# Test samples-  questionnaire PDFs may be restricted data
+tests/samples/*
+!tests/samples/.gitkeep
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Jupyter
+.ipynb_checkpoints/
+*.ipynb
+
+# Local uv configuration
+uv.toml
+
+# Test and tooling caches
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+.cache/
+
+# Quarto book
+book/_book/
+book/.quarto/
+
+/.quarto/
+**/*.quarto_ipynb
+
+tmp/
+
+# Compound GPID managed items (junctions + copied file - do not commit)
+.compound-gpid/managed-files.json
+.kilo/AGENTS.md
+.kilo/agents
+.kilo/commands
+.kilo/instructions
+.kilo/kilo.json
+.kilo/shared
+.kilo/skills

survey_scribe-0.1.0/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to Survey Scribe are documented in this file. The format is
+based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the
+project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- PyPI-ready project metadata and MIT license declaration.
+- MkDocs documentation with installation, usage, examples, and API reference.
+- Coverage enforcement and release-artifact validation in CI.
+- Additive routed SVIS models, deterministic directed-multigraph validation,
+  source-grounded evidence, and append-only discrepancy review.
+- `QuestionnaireRouter` with native XLSForm routing and structured-provider integration.
+- Deterministic routing-quality evaluation, routing-schema export, and routing documentation.
+- Validated static metadata headers and per-attempt auxiliary secret headers for
+  direct `AzureOpenAIProvider` injection through compatible gateways.
+- Extraction-first public guides for completed questionnaires, skip patterns,
+  Palantir Foundry, Microsoft Foundry, mAI Factory, and AI providers.
+
+### Changed
+
+- Runtime dependencies now use compatible ranges while the committed `uv.lock`
+  retains exact engineering versions.
+
+### Fixed
+
+- Native XLSForm `source_format="xlsform"` now binds to its validated XLSX
+  snapshot for provider-free questionnaire routing.
+- Public installation guidance no longer presents an unavailable PyPI release or
+  a stale source revision as the primary installation path.
+
+## 0.1.0 - Unpublished
+
+This version remains a source-tree milestone. No approved package-index or GitHub
+release is available.
+
+### Added
+
+- Installable `survey-scribe` package with typed SVIS Pydantic models.
+- Bootstrap `survey-scribe` command.
+- Legacy schema re-export and characterization suite.
+- Cross-platform Python 3.11-3.13 CI and clean-wheel installation checks.
+
+[Unreleased]: https://github.com/GMD-hub/survey-scribe/commits/main

survey_scribe-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Survey Scribe contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

survey_scribe-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: survey-scribe
+Version: 0.1.0
+Summary: Local-first questionnaire extraction to the Survey Variable Information Schema
+Project-URL: Homepage, https://github.com/GMD-hub/survey-scribe
+Project-URL: Documentation, https://gmd-hub.github.io/survey-scribe/
+Project-URL: Repository, https://github.com/GMD-hub/survey-scribe.git
+Project-URL: Issues, https://github.com/GMD-hub/survey-scribe/issues
+Project-URL: Changelog, https://github.com/GMD-hub/survey-scribe/blob/main/CHANGELOG.md
+Author: World Bank Global Monitoring Database team
+License-Expression: MIT
+License-File: LICENSE
+Keywords: SVIS,data extraction,household surveys,metadata,pydantic,questionnaires,schema,structured data,survey harmonization,survey metadata
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: <3.14,>=3.11
+Requires-Dist: defusedxml<1,>=0.7.1
+Requires-Dist: pydantic<3,>=2.11.7
+Provides-Extra: anthropic
+Requires-Dist: anthropic<1,>=0.64.0; extra == 'anthropic'
+Requires-Dist: instructor<2,>=1.10.0; extra == 'anthropic'
+Provides-Extra: openai
+Requires-Dist: instructor<2,>=1.10.0; extra == 'openai'
+Requires-Dist: openai<2,>=1.99.9; extra == 'openai'
+Requires-Dist: tenacity<10,>=9.1.2; extra == 'openai'
+Requires-Dist: tiktoken<1,>=0.11.0; extra == 'openai'
+Provides-Extra: pdf
+Requires-Dist: docling<3,>=2.125.0; extra == 'pdf'
+Requires-Dist: easyocr<2,>=1.7.2; extra == 'pdf'
+Requires-Dist: lingua-language-detector<3,>=2.1.1; extra == 'pdf'
+Requires-Dist: pymupdf<2,>=1.26.4; extra == 'pdf'
+Provides-Extra: tabular
+Requires-Dist: openpyxl<4,>=3.1.5; extra == 'tabular'
+Description-Content-Type: text/markdown
+
+# Survey Scribe
+
+[![CI](https://github.com/GMD-hub/survey-scribe/actions/workflows/ci.yml/badge.svg)](https://github.com/GMD-hub/survey-scribe/actions/workflows/ci.yml)
+[![Python 3.11-3.13](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Survey Scribe converts local survey questionnaires to the typed Survey Variable
+Information Schema (SVIS). It provides synchronous, asynchronous, and batch APIs,
+provider adapters, safe local source normalization, deterministic chunking,
+questionnaire routing graphs, secure configuration, and versioned artifacts.
+
+> **Alpha status:** The source tree declares version `0.1.0` and contains the
+> public `SurveyScribe` API, conversion CLI, typed models, source and provider
+> adapters, transactional artifacts, and `QuestionnaireRouter`. No approved PyPI
+> release is currently available.
+
+## Features
+
+- Typed SVIS models with Pydantic validation and JSON serialization.
+- Stable top-level imports for schema consumers.
+- Numeric, categorical, text, date, and other variable classifications.
+- Missing-category, source-provenance, confidence, and review metadata.
+- Local PDF, DOCX, XLSX, CSV, HTML, Markdown, and text normalization.
+- Token-aware chunking with stable overlap and table provenance.
+- Credential-safe configuration and versioned artifact manifests.
+- Source-grounded directed routing multigraphs with separate evidence and audit history.
+- Native XLSForm relevance and repeat routing without a provider call.
+- Caller-defined structured pipelines for completed-form records.
+- A PEP 561 `py.typed` marker for editor and type-checker support.
+- An installed CLI for single and batch conversion, configuration checks,
+  provider listing, and deterministic routing-schema export.
+
+The standard client extracts questionnaire instrument metadata. It does not
+produce respondent microdata, classify skipped answers, execute routing, or
+expand repeat instances.
+
+## Installation
+
+After publication is approved, install the base schema package with:
+
+```console
+pip install survey-scribe
+```
+
+For development from this repository, use the locked environment:
+
+```console
+uv sync --locked --python 3.11
+```
+
+Optional dependency groups are available for provider and document adapters:
+
+```console
+pip install "survey-scribe[openai]"
+pip install "survey-scribe[anthropic]"
+pip install "survey-scribe[pdf]"
+pip install "survey-scribe[tabular]"
+```
+
+The base package includes the CLI. Install provider and source extras required by
+the selected conversion path.
+
+## Quick Start
+
+```python
+from datetime import date
+
+from survey_scribe.sources import SourceRegistry
+
+conversion = SourceRegistry.default().convert_for_svis(
+    "questionnaire.xlsx",
+    extraction_date=date.today(),
+)
+if conversion.svis is None:
+    raise RuntimeError("The workbook is not a supported XLSForm")
+
+review_codes = tuple(item.code for item in conversion.document.diagnostics)
+if conversion.native is not None:
+    review_codes += tuple(item.code for item in conversion.native.diagnostics)
+if review_codes:
+    raise RuntimeError(f"Review XLSForm diagnostics before use: {review_codes}")
+
+survey = conversion.svis
+```
+
+This native XLSForm path makes no provider call. PDF, DOCX, and other
+questionnaire instruments use `SurveyScribe` with a configured provider.
+
+Inspect the installed command without loading optional providers:
+
+```console
+survey-scribe --help
+survey-scribe --version
+survey-scribe providers
+survey-scribe config check
+survey-scribe convert questionnaire.pdf --output-dir output
+survey-scribe batch questionnaire-a.pdf questionnaire-b.xlsx --output-dir output
+survey-scribe schema export routing > questionnaire-routing-graph-v1.0.json
+```
+
+Set credentials with environment variables or use `--prompt-api-key` /
+`--prompt-bearer-token`. The CLI writes sidecars and manifests by default,
+refuses existing artifacts unless `--overwrite` is present, and supports
+`--strict` when partial output must produce a nonzero exit. See the
+[CLI guide](docs/cli.md) and [migration guide](docs/migration.md).
+
+## Documentation
+
+The public website includes end-to-end questionnaire extraction, completed-form
+contracts, skip-pattern examples, Palantir Foundry deployment, Microsoft Foundry,
+mAI Factory, AI provider setup, artifacts, security, privacy, and generated API
+references.
+
+- [Documentation website](https://gmd-hub.github.io/survey-scribe/)
+- [DeepWiki project guide](https://deepwiki.com/GMD-hub/survey-scribe)
+- [Extraction guide](docs/guides/extraction.md)
+- [Completed questionnaires](docs/guides/completed-questionnaires.md)
+- [Skip patterns](docs/guides/skip-patterns.md)
+- [Palantir Foundry](docs/platforms/palantir-foundry.md)
+- [mAI Factory](docs/integrations/mai-factory.md)
+- [AI providers](docs/guides/ai-providers.md)
+
+```console
+uv run mkdocs serve
+```
+
+The local site is available at `http://127.0.0.1:8000/` while the server runs.
+Pushes to `main` build and deploy the strict static site to GitHub Pages through
+`.github/workflows/deploy-docs.yml`.
+
+## Development
+
+```console
+uv run ruff check .
+uv run ruff format --check .
+uv run pyright
+uv run pytest tests/unit tests/characterization tests/test_schema.py \
+  --cov=survey_scribe --cov-branch --cov-report=term-missing
+uv run mkdocs build --strict
+uv build
+uv run twine check --strict dist/*
+```
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for fixture controls and pull request
+requirements. Security reports follow [`SECURITY.md`](SECURITY.md).
+
+## Versioning
+
+Survey Scribe uses PEP 440 and Semantic Versioning. The current static version is
+declared once in `pyproject.toml`; the runtime `survey_scribe.__version__` value
+is read from installed distribution metadata. Release changes are recorded in
+[`CHANGELOG.md`](CHANGELOG.md).
+
+## License
+
+Survey Scribe is licensed under the [MIT License](LICENSE). Package publication
+is a separate operational decision and remains gated.

survey_scribe-0.1.0/README.md

@@ -0,0 +1,157 @@
+# Survey Scribe
+
+[![CI](https://github.com/GMD-hub/survey-scribe/actions/workflows/ci.yml/badge.svg)](https://github.com/GMD-hub/survey-scribe/actions/workflows/ci.yml)
+[![Python 3.11-3.13](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Survey Scribe converts local survey questionnaires to the typed Survey Variable
+Information Schema (SVIS). It provides synchronous, asynchronous, and batch APIs,
+provider adapters, safe local source normalization, deterministic chunking,
+questionnaire routing graphs, secure configuration, and versioned artifacts.
+
+> **Alpha status:** The source tree declares version `0.1.0` and contains the
+> public `SurveyScribe` API, conversion CLI, typed models, source and provider
+> adapters, transactional artifacts, and `QuestionnaireRouter`. No approved PyPI
+> release is currently available.
+
+## Features
+
+- Typed SVIS models with Pydantic validation and JSON serialization.
+- Stable top-level imports for schema consumers.
+- Numeric, categorical, text, date, and other variable classifications.
+- Missing-category, source-provenance, confidence, and review metadata.
+- Local PDF, DOCX, XLSX, CSV, HTML, Markdown, and text normalization.
+- Token-aware chunking with stable overlap and table provenance.
+- Credential-safe configuration and versioned artifact manifests.
+- Source-grounded directed routing multigraphs with separate evidence and audit history.
+- Native XLSForm relevance and repeat routing without a provider call.
+- Caller-defined structured pipelines for completed-form records.
+- A PEP 561 `py.typed` marker for editor and type-checker support.
+- An installed CLI for single and batch conversion, configuration checks,
+  provider listing, and deterministic routing-schema export.
+
+The standard client extracts questionnaire instrument metadata. It does not
+produce respondent microdata, classify skipped answers, execute routing, or
+expand repeat instances.
+
+## Installation
+
+After publication is approved, install the base schema package with:
+
+```console
+pip install survey-scribe
+```
+
+For development from this repository, use the locked environment:
+
+```console
+uv sync --locked --python 3.11
+```
+
+Optional dependency groups are available for provider and document adapters:
+
+```console
+pip install "survey-scribe[openai]"
+pip install "survey-scribe[anthropic]"
+pip install "survey-scribe[pdf]"
+pip install "survey-scribe[tabular]"
+```
+
+The base package includes the CLI. Install provider and source extras required by
+the selected conversion path.
+
+## Quick Start
+
+```python
+from datetime import date
+
+from survey_scribe.sources import SourceRegistry
+
+conversion = SourceRegistry.default().convert_for_svis(
+    "questionnaire.xlsx",
+    extraction_date=date.today(),
+)
+if conversion.svis is None:
+    raise RuntimeError("The workbook is not a supported XLSForm")
+
+review_codes = tuple(item.code for item in conversion.document.diagnostics)
+if conversion.native is not None:
+    review_codes += tuple(item.code for item in conversion.native.diagnostics)
+if review_codes:
+    raise RuntimeError(f"Review XLSForm diagnostics before use: {review_codes}")
+
+survey = conversion.svis
+```
+
+This native XLSForm path makes no provider call. PDF, DOCX, and other
+questionnaire instruments use `SurveyScribe` with a configured provider.
+
+Inspect the installed command without loading optional providers:
+
+```console
+survey-scribe --help
+survey-scribe --version
+survey-scribe providers
+survey-scribe config check
+survey-scribe convert questionnaire.pdf --output-dir output
+survey-scribe batch questionnaire-a.pdf questionnaire-b.xlsx --output-dir output
+survey-scribe schema export routing > questionnaire-routing-graph-v1.0.json
+```
+
+Set credentials with environment variables or use `--prompt-api-key` /
+`--prompt-bearer-token`. The CLI writes sidecars and manifests by default,
+refuses existing artifacts unless `--overwrite` is present, and supports
+`--strict` when partial output must produce a nonzero exit. See the
+[CLI guide](docs/cli.md) and [migration guide](docs/migration.md).
+
+## Documentation
+
+The public website includes end-to-end questionnaire extraction, completed-form
+contracts, skip-pattern examples, Palantir Foundry deployment, Microsoft Foundry,
+mAI Factory, AI provider setup, artifacts, security, privacy, and generated API
+references.
+
+- [Documentation website](https://gmd-hub.github.io/survey-scribe/)
+- [DeepWiki project guide](https://deepwiki.com/GMD-hub/survey-scribe)
+- [Extraction guide](docs/guides/extraction.md)
+- [Completed questionnaires](docs/guides/completed-questionnaires.md)
+- [Skip patterns](docs/guides/skip-patterns.md)
+- [Palantir Foundry](docs/platforms/palantir-foundry.md)
+- [mAI Factory](docs/integrations/mai-factory.md)
+- [AI providers](docs/guides/ai-providers.md)
+
+```console
+uv run mkdocs serve
+```
+
+The local site is available at `http://127.0.0.1:8000/` while the server runs.
+Pushes to `main` build and deploy the strict static site to GitHub Pages through
+`.github/workflows/deploy-docs.yml`.
+
+## Development
+
+```console
+uv run ruff check .
+uv run ruff format --check .
+uv run pyright
+uv run pytest tests/unit tests/characterization tests/test_schema.py \
+  --cov=survey_scribe --cov-branch --cov-report=term-missing
+uv run mkdocs build --strict
+uv build
+uv run twine check --strict dist/*
+```
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for fixture controls and pull request
+requirements. Security reports follow [`SECURITY.md`](SECURITY.md).
+
+## Versioning
+
+Survey Scribe uses PEP 440 and Semantic Versioning. The current static version is
+declared once in `pyproject.toml`; the runtime `survey_scribe.__version__` value
+is read from installed distribution metadata. Release changes are recorded in
+[`CHANGELOG.md`](CHANGELOG.md).
+
+## License
+
+Survey Scribe is licensed under the [MIT License](LICENSE). Package publication
+is a separate operational decision and remains gated.

survey_scribe-0.1.0/pyproject.toml

@@ -0,0 +1,184 @@
+[build-system]
+requires = ["hatchling==1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "survey-scribe"
+version = "0.1.0"
+description = "Local-first questionnaire extraction to the Survey Variable Information Schema"
+readme = "README.md"
+requires-python = ">=3.11,<3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  {name = "World Bank Global Monitoring Database team"},
+]
+keywords = [
+  "data extraction",
+  "household surveys",
+  "metadata",
+  "pydantic",
+  "questionnaires",
+  "schema",
+  "structured data",
+  "survey harmonization",
+  "survey metadata",
+  "SVIS",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Typing :: Typed",
+]
+dependencies = [
+  "defusedxml>=0.7.1,<1",
+  "pydantic>=2.11.7,<3",
+]
+
+[project.optional-dependencies]
+openai = [
+  "instructor>=1.10.0,<2",
+  "openai>=1.99.9,<2",
+  "tenacity>=9.1.2,<10",
+  "tiktoken>=0.11.0,<1",
+]
+anthropic = [
+  "anthropic>=0.64.0,<1",
+  "instructor>=1.10.0,<2",
+]
+pdf = [
+  "docling>=2.125.0,<3",
+  "easyocr>=1.7.2,<2",
+  "lingua-language-detector>=2.1.1,<3",
+  "pymupdf>=1.26.4,<2",
+]
+tabular = [
+  "openpyxl>=3.1.5,<4",
+]
+
+[project.urls]
+Homepage = "https://github.com/GMD-hub/survey-scribe"
+Documentation = "https://gmd-hub.github.io/survey-scribe/"
+Repository = "https://github.com/GMD-hub/survey-scribe.git"
+Issues = "https://github.com/GMD-hub/survey-scribe/issues"
+Changelog = "https://github.com/GMD-hub/survey-scribe/blob/main/CHANGELOG.md"
+
+[[tool.uv.index]]
+url = "https://pypi.org/simple"
+default = true
+
+[project.scripts]
+survey-scribe = "survey_scribe.cli:main"
+
+[dependency-groups]
+dev = [
+  "axe-playwright-python==0.1.8",
+  "bandit==1.9.4",
+  "build==1.3.0",
+  "check-wheel-contents==0.6.3",
+  "cyclonedx-bom==7.3.1",
+  "detect-secrets==1.5.0",
+  "hatchling==1.27.0",
+  "loguru==0.7.3",
+  "mkdocs==1.6.1",
+  "mkdocs-material==9.7.7",
+  "mkdocstrings[python]==0.30.0",
+  "pip-audit==2.10.1",
+  "playwright==1.62.0",
+  "pyright==1.1.404",
+  "pytest==9.1.1",
+  "pytest-asyncio==1.4.0",
+  "pytest-cov==6.2.1",
+  "pytest-socket==0.8.1",
+  "linkchecker==10.6.0",
+  "pyyaml==6.0.3",
+  "ruff==0.12.8",
+  "tomli==2.2.1",
+  "twine==6.1.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/survey_scribe"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/CHANGELOG.md",
+  "/LICENSE",
+  "/README.md",
+  "/pyproject.toml",
+  "/src/survey_scribe",
+  "/uv.lock",
+]
+exclude = ["/.gitignore"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers --strict-config"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+asyncio_default_test_loop_scope = "function"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["B", "E", "F", "I", "SIM", "UP", "W"]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pyright]
+pythonVersion = "3.11"
+typeCheckingMode = "basic"
+include = [
+  "src",
+  "tests/characterization",
+  "tests/cli",
+  "tests/compat",
+  "tests/contract",
+  "tests/architecture",
+  "tests/browser",
+  "tests/docs",
+  "tests/integration",
+  "tests/package",
+  "tests/quality",
+  "tests/security",
+  "tests/test_schema.py",
+  "tests/unit",
+  "scripts/check_workflow_policy.py",
+  "scripts/build_wheel_sbom.py",
+  "scripts/generate_docs_reference.py",
+  "scripts/evaluate_quality.py",
+  "scripts/evaluate_routing.py",
+  "scripts/run_security_gates.py",
+  "scripts/validate_ocr_artifacts.py",
+  "scripts/validate_routing_fixtures.py",
+  "scripts/cg_pr_preflight.py",
+  "docling_pipeline.py",
+]
+
+[tool.coverage.run]
+source = ["survey_scribe"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 95
+precision = 1
+show_missing = true
+skip_covered = true
+exclude_also = [
+  "if TYPE_CHECKING:",
+  "raise NotImplementedError",
+]
+
+[tool.check-wheel-contents]
+toplevel = ["survey_scribe"]