upstream-data 3.39.0__py3-none-any.whl

upstream_data/__init__.py

@@ -0,0 +1,16 @@
+"""Upstream Data — synthetic healthcare claims for testing your RCM pipeline.
+
+    pip install upstream-data
+
+    from upstream_data import UpstreamClient
+
+    client = UpstreamClient(api_key="sk-...")
+    result = client.synthesize(pack="aba", rows=50_000)
+    client.download(result["dataset_id"], "aba_test.csv")
+"""
+
+__all__ = ["__version__", "UpstreamClient"]
+
+__version__ = "3.39.0"
+
+from upstream_data.client import UpstreamClient

upstream_data/_version_registry.py

@@ -0,0 +1,116 @@
+"""Centralized schema version registry for all upstream-data artifacts.
+
+This file is the single source of truth for all version constants.
+Modules import their version from here rather than defining locally.
+Adding a new artifact? Register its version here.
+"""
+
+from __future__ import annotations
+
+# ═══════════════════════════════════════════════════════════════════
+# Source / Registry / Prior
+# ═══════════════════════════════════════════════════════════════════
+PUBLIC_SOURCE_REGISTRY_VERSION: str = "2026-05-27.v3.0"
+SOURCE_REGISTRY_VERSION: str = "2026-05-26.v1.8"
+
+# ═══════════════════════════════════════════════════════════════════
+# Models / Schema
+# ═══════════════════════════════════════════════════════════════════
+SCHEMA_VERSION: str = "0.4.0"  # canonical — used by build_pack_schema()
+ARTIFACT_SCHEMA_VERSION: str = "upstream-data-artifacts-v1.8"
+DATASET_EULA_VERSION: str = "upstream-data-dataset-eula-v0"
+
+# ═══════════════════════════════════════════════════════════════════
+# Claim Generators / Encounters
+# ═══════════════════════════════════════════════════════════════════
+CLAIM_REALISM_VERSION: str = "upstream-data-claim-realism-v1.7"
+CLAIM_EDIT_SIMULATION_VERSION: str = "upstream-data-claim-edits-v1.7"
+ADJUDICATION_TRACE_VERSION: str = "upstream-data-adjudication-trace-v1.7"
+TRANSACTION_ARTIFACT_VERSION: str = "upstream-data-transactions-v1.3"
+TRANSACTION_SURFACE_ARTIFACT_VERSION: str = "upstream-data-transaction-surface-v2.0"
+CONTRACT_FEE_SCHEDULE_VERSION: str = "upstream-data-contract-fee-schedule-v3.4"
+PAYER_POLICY_VERSION: str = "upstream-data-policy-engine-v3.3"
+PAYER_CONTRACT_SIMULATOR_VERSION: str = "upstream-data-payer-contract-simulator-v2.3"
+
+# ═══════════════════════════════════════════════════════════════════
+# World / Economy / Demographics
+# ═══════════════════════════════════════════════════════════════════
+WORLD_ARTIFACT_VERSION: str = "upstream-data-world-model-v2.1"
+ECONOMY_KERNEL_VERSION: str = "2026-05-28.v3.33"
+
+# ═══════════════════════════════════════════════════════════════════
+# Episodes / Events / Scenarios
+# ═══════════════════════════════════════════════════════════════════
+EPISODE_ARTIFACT_VERSION: str = "upstream-data-episodes-v1.8"
+EVENT_SIMULATION_ARTIFACT_VERSION: str = "upstream-data-events-v1.4"
+SCENARIO_DSL_VERSION: str = "upstream-data-scenario-dsl-v1.8"
+SCENARIO_MANIFEST_VERSION: str = "2026-05-26.v1.4"
+
+# ═══════════════════════════════════════════════════════════════════
+# Quality / Validation / Data Science
+# ═══════════════════════════════════════════════════════════════════
+QUALITY_REPORT_VERSION: str = "2026-05-26.v2.1"
+POPULATION_CONTROL_REPORT_VERSION: str = "2026-05-27.v3.1"
+EVALUATION_REPORT_VERSION: str = "2026-05-27.v2.3"
+EVALUATION_ARTIFACT_VERSION: str = "upstream-data-evaluation-v2.3"
+SPECIALTY_REALISM_VERSION: str = "2026-05-26.v1.8"
+
+# ═══════════════════════════════════════════════════════════════════
+# Twin / Simulator / Operating
+# ═══════════════════════════════════════════════════════════════════
+SYNTHETIC_TWIN_VERSION: str = "upstream-data-synthetic-twin-v3.2"
+
+# ═══════════════════════════════════════════════════════════════════
+# CI / Certification / Cohort
+# ═══════════════════════════════════════════════════════════════════
+CI_REGRESSION_VERSION: str = "2026-05-28.v3.32"
+CERTIFICATION_SIGNING_VERSION: str = "upstream-data-cert-v1.0"
+COHORT_ROTATION_VERSION: str = "upstream-data-cohort-v1.0"
+
+# ═══════════════════════════════════════════════════════════════════
+# Integration / Bridge / Distribution
+# ═══════════════════════════════════════════════════════════════════
+BRIDGE_VERSION: str = "2026-05-27.v3.4"
+SYNTHETIC_HEALTHCARE_CONTRACT_VERSION: str = "2026-05-27.v3.6"
+PAYLOAD_VERSION: str = "2026-05-26.v1.8"
+ADJACENT_AUDIT_VERSION: str = "2026-05-28.v3.34"
+PACKAGE_CATALOG_VERSION: str = "upstream-data-packaging-v2.3"
+
+# ═══════════════════════════════════════════════════════════════════
+# Operating System / Replay / Preview
+# ═══════════════════════════════════════════════════════════════════
+COMPANY_OPERATING_SYSTEM_VERSION: str = "2026-05-27.v3.7"
+OPERATING_ARTIFACT_GRAPH_VERSION: str = "2026-05-28.v3.22"
+REPLAY_OS_VERSION: str = "2026-05-28.v3.34"
+REPLAY_RUNTIME_VERSION: str = "2026-05-28.v3.31"
+WORKFLOW_REPLAY_ENGINE_VERSION: str = "2026-05-28.v3.29"
+WORKFLOW_REPLAY_FORMAT_VERSION: str = "2026-05-28.v3.27"
+PREVIEW_DEPTH_GATE_VERSION: str = "2026-05-28.v3.39"
+FLAGSHIP_WORLD_VERSION: str = "2026-05-28.v3.38"
+CONTROL_PLANE_VERSION: str = "2026-05-27.v3.11"
+JOB_QUEUE_VERSION: str = "2026-05-27.v3.13"
+
+# ═══════════════════════════════════════════════════════════════════
+# Providers / Service / Marketplace
+# ═══════════════════════════════════════════════════════════════════
+PROVIDER_CONTRACT_VERSION: str = "2026-05-26.v1.8"
+PROVIDER_READINESS_VERSION: str = "2026-05-27.v3.15"
+PROVIDER_RUNTIME_VERSION: str = "2026-05-28.v3.37"
+HOSTED_FULFILLMENT_VERSION: str = "2026-05-28.v3.37"
+DELIVERY_CONTACTS_VERSION: str = "2026-05-29.v1"
+PRODUCT_CANON_EXPORT_VERSION: str = "2026-05-27.v3.8"
+
+# ═══════════════════════════════════════════════════════════════════
+# Category / Commercial / Launch
+# ═══════════════════════════════════════════════════════════════════
+CATEGORY_OWNERSHIP_VERSION: str = "2026-05-27.v3.16"
+CATEGORY_STANDARD_VERSION: str = "2026-05-27.v3.17"
+CATEGORY_FLYWHEEL_VERSION: str = "2026-05-28.v3.30"
+COMMERCIAL_LAUNCH_VERSION: str = "2026-05-28.v3.19"
+DEVELOPER_DISTRIBUTION_VERSION: str = "2026-05-27.v3.18"
+EMBEDDED_PLATFORM_MOAT_VERSION: str = "2026-05-28.v3.23"
+NETWORK_EFFECTS_MOAT_VERSION: str = "2026-05-28.v3.25"
+PLATFORM_PRODUCT_CANON_VERSION: str = "2026-05-28.v3.26"
+ECOSYSTEM_STANDARD_VERSION: str = "2026-05-28.v3.24"
+ENTERPRISE_LAUNCH_COMPILER_VERSION: str = "2026-05-28.v3.38"
+OPERATOR_LAUNCH_PROOF_VERSION: str = "2026-05-28.v3.20"

upstream_data/access_policy.py

@@ -0,0 +1,324 @@
+"""Access-policy compiler for public, paid, and service-token artifacts."""
+
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import Field
+
+from upstream_data.models.base import UpstreamBaseModel
+
+AccessPolicy = Literal[
+    "public-read",
+    "paid-api-key",
+    "account-authenticated",
+    "service-token",
+    "webhook-secret",
+]
+RedactionClass = Literal["public_teaser", "schema_only", "paid_depth", "internal_ops"]
+
+PUBLIC_SAFE_ARTIFACT_IDS: frozenset[str] = frozenset(
+    {
+        "community_fixture_exports",
+        "integration_guardrails",
+        "public_sample_manifest",
+        "public_source_manifest",
+        "synthetic_only_attestation",
+        "dataset",
+        "readme",
+        "LICENSE",
+        "specialty_realism_teasers",
+        "skill_prompt_fixtures",
+        "workflow_replay_public_index",
+    }
+)
+
+SCHEMA_ONLY_PUBLIC_ARTIFACT_IDS: frozenset[str] = frozenset(
+    {
+        "marketplace_catalog",
+    }
+)
+
+PAID_DEPTH_ARTIFACT_IDS: frozenset[str] = frozenset(
+    {
+        "adjudication_trace",
+        "adjudication_trace_summary",
+        "attachment_275_workflows",
+        "claim_status_276_277",
+        "claim_edit_simulation_report",
+        "claim_edit_simulation_reports",
+        "claim_envelopes",
+        "claim_realism_report",
+        "ci_drift_report",
+        "ci_failure_report",
+        "ci_junit_report",
+        "ci_markdown_report",
+        "ci_phi_leakage_report",
+        "ci_run_manifest",
+        "ci_scorecard",
+        "ci_validation",
+        "contract_fee_schedule_lines",
+        "contract_fee_schedule_manifest",
+        "contract_fee_schedule_report",
+        "contract_terms",
+        "economy_claim_intents",
+        "economy_impact_report",
+        "economy_kernel_manifest",
+        "economy_kernel_validation",
+        "economy_operating_timeline",
+        "episode_journeys",
+        "episode_manifest",
+        "episode_validation_report",
+        "artifact_trace_graph",
+        "event_simulation_manifest",
+        "event_validation_report",
+        "evaluation_harness_report",
+        "evaluation_suite_manifest",
+        "fhir_claim_eob_bundle",
+        "pack_readiness_reports",
+        "pack_scenarios",
+        "pack_source_summaries",
+        "payer_contract_simulation_manifest",
+        "payer_contract_simulation_report",
+        "payer_contract_simulator_config",
+        "payer_policy_rules",
+        "payer_policy_decision_summary",
+        "payer_policy_decisions",
+        "population_control_report",
+        "scorecard",
+        "scorecard_taxonomy",
+        "synthetic_twin_aggregate_config",
+        "synthetic_twin_calibration_report",
+        "synthetic_twin_reproducibility_packet",
+        "qa_package_manifest",
+        "reproducibility_packet",
+        "validation_scorecard",
+        "checksum_manifest",
+        "remittance_advices",
+        "replay_runtime_audit_trace",
+        "replay_runtime_events",
+        "replay_runtime_report",
+        "replay_runtime_task_scores",
+        "replay_runtime_validation",
+        "trace_audit",
+        "failure_cases",
+        "rcm_os_bundle_manifest",
+        "revenue_cycle_events",
+        "specialty_realism_catalog",
+        "synthetic_edi_transactions",
+        "transaction_bundle_manifest",
+        "transaction_surface_manifest",
+        "transaction_surface_validation_report",
+        "transaction_validation_report",
+        "operations_states",
+        "operating_artifact_graph_manifest",
+        "operating_artifact_graph_validation",
+        "operating_timeline",
+        "synthetic_documents",
+        "workflow_replays",
+        "workflow_replay_engine_manifest",
+        "workflow_replay_engine_validation",
+        "world_entities",
+        "world_model_manifest",
+        "world_validation_report",
+        "certification_manifest",
+    }
+)
+
+INTERNAL_OPS_ARTIFACT_IDS: frozenset[str] = frozenset(
+    {
+        "api_contracts",
+        "consumer_repos",
+        "audit_log",
+        "generation_job_request",
+        "generation_job_status",
+        "governance_gate_report",
+        "publication_candidates",
+        "launch_readiness_checklist",
+        "mcp_tool_hints",
+        "moat_report",
+        "openapi_fragments",
+        "pack_bindings",
+        "provider_dry_run_bundle",
+        "route_readiness_matrix",
+        "upstream_bridge_handoff",
+        "usage_metering_events",
+    }
+)
+
+PUBLIC_FORBIDDEN_SUBSTRINGS: tuple[str, ...] = (
+    "adjudication_trace",
+    "agent_evaluation_tasks",
+    "attachment_275_workflows",
+    "claim_status_276_277",
+    "claim_edit_simulation",
+    "claim_envelopes",
+    "claim_realism_report",
+    "ci_",
+    "contract_fee_schedule",
+    "contract_terms",
+    "economy_",
+    "artifact_trace_graph",
+    "episode_journeys",
+    "episode_validation_report",
+    "evaluation_harness",
+    "evaluation_suite",
+    "generation_job",
+    "governance_gate",
+    "fhir_claim_eob_bundle",
+    "moat_report",
+    "pack_readiness_reports",
+    "pack_scenarios",
+    "payer_contract_simulation",
+    "payer_contract_simulator",
+    "payer_policy_rules",
+    "payer_policy_decision",
+    "population_control",
+    "scorecard_taxonomy",
+    "synthetic_twin",
+    "qa_package",
+    "reproducibility_packet",
+    "validation_scorecard",
+    "checksum_manifest",
+    "provider_dry_run",
+    "publication_candidates",
+    "release_ledger",
+    "remittance_advices",
+    "replay_runtime",
+    "trace_audit",
+    "failure_cases",
+    "rcm_os_bundle",
+    "revenue_cycle_events",
+    "specialty_realism_catalog",
+    "synthetic_edi_transactions",
+    "transaction_bundle",
+    "transaction_surface",
+    "transaction_validation_report",
+    "operations_states",
+    "operating_artifact_graph",
+    "operating_timeline",
+    "synthetic_documents",
+    "workflow_replays",
+    "workflow_replay_engine",
+    "world_entities",
+    "world_model",
+    "world_validation",
+    "usage_metering",
+    "audit_log",
+)
+
+
+class ArtifactAccessPolicy(UpstreamBaseModel):
+    artifact_id: str
+    access_policy: AccessPolicy
+    redaction_class: RedactionClass
+    publishable: bool
+    max_public_rows: int = Field(ge=0)
+    rationale: str
+
+
+class AccessPolicyIssue(UpstreamBaseModel):
+    artifact_id: str
+    severity: Literal["error", "warning"]
+    code: str
+    detail: str
+
+
+class AccessPolicyValidationReport(UpstreamBaseModel):
+    passed: bool
+    issues: tuple[AccessPolicyIssue, ...]
+
+
+def classify_artifact_access(artifact_id: str, access_policy: AccessPolicy) -> ArtifactAccessPolicy:
+    """Classify an artifact into public, paid, or internal policy lanes."""
+    if artifact_id in PUBLIC_SAFE_ARTIFACT_IDS:
+        return ArtifactAccessPolicy(
+            artifact_id=artifact_id,
+            access_policy=access_policy,
+            redaction_class="public_teaser",
+            publishable=access_policy == "public-read",
+            max_public_rows=0,
+            rationale="Public-safe teaser or methodology metadata with paid-depth fields redacted.",
+        )
+    if artifact_id in SCHEMA_ONLY_PUBLIC_ARTIFACT_IDS:
+        return ArtifactAccessPolicy(
+            artifact_id=artifact_id,
+            access_policy=access_policy,
+            redaction_class="schema_only",
+            publishable=access_policy == "public-read",
+            max_public_rows=0,
+            rationale="Public schema/catalog metadata only; no generated row payloads.",
+        )
+    if artifact_id in PAID_DEPTH_ARTIFACT_IDS:
+        return ArtifactAccessPolicy(
+            artifact_id=artifact_id,
+            access_policy=access_policy,
+            redaction_class="paid_depth",
+            publishable=False,
+            max_public_rows=5,
+            rationale=(
+                "Commercial-depth artifact must stay behind paid API key or tiny fixture approval."
+            ),
+        )
+    return ArtifactAccessPolicy(
+        artifact_id=artifact_id,
+        access_policy=access_policy,
+        redaction_class="internal_ops",
+        publishable=False,
+        max_public_rows=0,
+        rationale="Operational integration payload for backend or service-token consumers.",
+    )
+
+
+def validate_artifact_access_policy(
+    artifact_id: str,
+    access_policy: AccessPolicy,
+    publishable: bool,
+    path: str,
+) -> AccessPolicyValidationReport:
+    """Fail closed when public/publishable surfaces expose paid or internal artifacts."""
+    policy = classify_artifact_access(artifact_id, access_policy)
+    issues: list[AccessPolicyIssue] = []
+    path_text = path.lower()
+    if policy.redaction_class in {"paid_depth", "internal_ops"} and publishable:
+        issues.append(
+            AccessPolicyIssue(
+                artifact_id=artifact_id,
+                severity="error",
+                code="publishable_paid_or_internal_artifact",
+                detail=f"redaction_class={policy.redaction_class}",
+            )
+        )
+    if access_policy == "public-read" and artifact_id in PAID_DEPTH_ARTIFACT_IDS:
+        issues.append(
+            AccessPolicyIssue(
+                artifact_id=artifact_id,
+                severity="error",
+                code="paid_artifact_public_read",
+                detail=f"artifact_id={artifact_id}",
+            )
+        )
+    if access_policy == "public-read" and any(
+        forbidden in path_text for forbidden in PUBLIC_FORBIDDEN_SUBSTRINGS
+    ):
+        issues.append(
+            AccessPolicyIssue(
+                artifact_id=artifact_id,
+                severity="error",
+                code="public_path_reveals_paid_depth",
+                detail=f"path={path}",
+            )
+        )
+    if publishable != policy.publishable:
+        issues.append(
+            AccessPolicyIssue(
+                artifact_id=artifact_id,
+                severity="error",
+                code="publishable_policy_mismatch",
+                detail=f"publishable={publishable} expected={policy.publishable}",
+            )
+        )
+    return AccessPolicyValidationReport(
+        passed=not issues,
+        issues=tuple(issues),
+    )

upstream_data/adjudication/__init__.py

@@ -0,0 +1,19 @@
+"""Adjudication explainability artifacts."""
+
+from upstream_data.adjudication.traces import (
+    ADJUDICATION_TRACE_FILE,
+    ADJUDICATION_TRACE_SUMMARY_FILE,
+    AdjudicationTraceArtifacts,
+    build_adjudication_trace_summary,
+    build_adjudication_traces,
+    write_adjudication_trace_bundle,
+)
+
+__all__ = [
+    "ADJUDICATION_TRACE_FILE",
+    "ADJUDICATION_TRACE_SUMMARY_FILE",
+    "AdjudicationTraceArtifacts",
+    "build_adjudication_trace_summary",
+    "build_adjudication_traces",
+    "write_adjudication_trace_bundle",
+]