{
  "artifacts": {
    "acceptanceAuditJson": "public/data/receivership/us-ca-acceptance-audit.json",
    "artifactHashesJson": "public/data/receivership/us-ca-artifact-hashes.json",
    "companiesCsv": "public/data/receivership/us-ca-companies.csv",
    "companiesJson": "public/data/receivership/us-ca-companies.json",
    "dataDictionaryJson": "public/data/receivership/us-ca-data-dictionary.json",
    "deltaEventsJson": "public/data/receivership/us-ca-delta-events.json",
    "deltaEventsNdjson": "public/data/receivership/us-ca-delta-events.ndjson",
    "eventsJson": "public/data/receivership/us-ca-events.json",
    "eventsNdjson": "public/data/receivership/us-ca-events.ndjson",
    "eventsPagesJson": "public/data/receivership/us-ca-events-pages.json",
    "freshnessJson": "public/data/receivership/us-ca-freshness.json",
    "importTemplateBcCsoCsv": "public/data/receivership/us-ca-import-template-bc-cso.csv",
    "importTemplateOntarioCourtsCsv": "public/data/receivership/us-ca-import-template-ontario-courts.csv",
    "importTemplateOsbBiaCsv": "public/data/receivership/us-ca-import-template-osb-bia.csv",
    "importTemplatePacerCourtCsv": "public/data/receivership/us-ca-import-template-pacer-court.csv",
    "importTemplatesJson": "public/data/receivership/us-ca-import-templates.json",
    "json": "public/data/receivership/us-ca-current.json",
    "productionBlockersJson": "public/data/receivership/us-ca-production-blockers.json",
    "productionEnvironmentJson": "public/data/receivership/us-ca-production-environment.json",
    "productionRunbookJson": "public/data/receivership/us-ca-production-runbook.json",
    "setupPacketMarkdown": "public/data/receivership/us-ca-production-setup-packet.md",
    "sourceDecisionLedgerTemplateJson": "public/data/receivership/us-ca-source-decision-ledger-template.json",
    "sourceDecisionPacketMarkdown": "public/data/receivership/us-ca-source-decision-packet.md",
    "releaseAuditJson": "public/data/receivership/us-ca-release-audit.json",
    "releaseHistoryJson": "public/data/receivership/us-ca-release-history.json",
    "searchJson": "public/data/receivership/us-ca-search.json",
    "setupJson": "public/data/receivership/us-ca-production-setup.json",
    "schemasJson": "public/data/receivership/us-ca-artifact-schemas.json",
    "sourceActivationJson": "public/data/receivership/us-ca-source-activation.json",
    "sourceHealthJson": "public/data/receivership/us-ca-source-health.json",
    "sqlite": "public/data/receivership/us-ca-current.sqlite",
    "streamApiJson": "public/data/receivership/us-ca-stream-api.json",
    "streamCheckpointJson": "public/data/receivership/us-ca-stream-checkpoint.json"
  },
  "companyDatabase": {
    "csvColumns": [
      {
        "name": "generated_at",
        "description": "Artifact generation timestamp in ISO 8601 format.",
        "type": "datetime"
      },
      {
        "name": "source_policy",
        "description": "Always first_party_only for rows in this artifact.",
        "type": "enum"
      },
      {
        "name": "company_id",
        "description": "Stable company row identifier, formatted as company:<case_id>.",
        "type": "string"
      },
      {
        "name": "canonical_name",
        "description": "Canonical company or legal entity name for the proceeding.",
        "type": "string"
      },
      {
        "name": "primary_legal_entity",
        "description": "First legal entity selected for display and matching.",
        "type": "string"
      },
      {
        "name": "legal_entities",
        "description": "Semicolon-separated legal-entity aliases preserved from the source.",
        "type": "string_list"
      },
      {
        "name": "country",
        "description": "ISO-like country code. US and CA only in this artifact.",
        "type": "enum"
      },
      {
        "name": "case_id",
        "description": "Stable receivership catalog case identifier.",
        "type": "string"
      },
      {
        "name": "case_number",
        "description": "Court or regulator case/file number when available.",
        "type": "string"
      },
      {
        "name": "court",
        "description": "Court, regulator, or filing venue named by the primary source.",
        "type": "string"
      },
      {
        "name": "slug",
        "description": "Stable human-readable slug for URL and export usage.",
        "type": "string"
      },
      {
        "name": "is_live",
        "description": "True when the row came from the current live fetch window.",
        "type": "boolean"
      },
      {
        "name": "is_seed_example",
        "description": "True for archive/regression rows kept for test coverage.",
        "type": "boolean"
      },
      {
        "name": "procedure",
        "description": "Normalized proceeding type such as chapter_11, receivership, or ccaa.",
        "type": "enum"
      },
      {
        "name": "stage",
        "description": "Current normalized proceeding stage.",
        "type": "enum"
      },
      {
        "name": "filing_date",
        "description": "Best official filing, initial order, or receivership order date.",
        "type": "date"
      },
      {
        "name": "petition_date",
        "description": "Petition or application date when distinct from filing/order date.",
        "type": "date"
      },
      {
        "name": "primary_source_id",
        "description": "First-party source ID that created the row.",
        "type": "string"
      },
      {
        "name": "primary_source_kind",
        "description": "Source kind, such as court_docket, court_register, or issuer_filing.",
        "type": "enum"
      },
      {
        "name": "primary_source_name",
        "description": "Human-readable primary source name.",
        "type": "string"
      },
      {
        "name": "source_published_at",
        "description": "Date or timestamp published by the primary source.",
        "type": "date_or_datetime"
      },
      {
        "name": "observed_at",
        "description": "Timestamp when the source was observed by the collector.",
        "type": "datetime"
      },
      {
        "name": "source_url",
        "description": "Primary first-party source URL.",
        "type": "url"
      },
      {
        "name": "score",
        "description": "Overall acquisition/discovery score from 0 to 100.",
        "type": "integer"
      },
      {
        "name": "fit_score",
        "description": "Operating-business fit subscore from 0 to 100.",
        "type": "integer"
      },
      {
        "name": "quality_score",
        "description": "Source and entity quality subscore from 0 to 100.",
        "type": "integer"
      },
      {
        "name": "timeliness_score",
        "description": "Timeliness subscore from 0 to 100.",
        "type": "integer"
      },
      {
        "name": "acquisition_signal_score",
        "description": "Acquisition signal subscore from 0 to 100.",
        "type": "integer"
      },
      {
        "name": "business_categories",
        "description": "Semicolon-separated operating business category tags.",
        "type": "string_list"
      },
      {
        "name": "operating_business",
        "description": "True when the company appears to be an operating business.",
        "type": "boolean"
      },
      {
        "name": "excluded_category",
        "description": "Suppression category such as restaurant, real_estate, or personal.",
        "type": "string"
      },
      {
        "name": "website",
        "description": "Company website when known from first-party row context or seed data.",
        "type": "url"
      }
    ],
    "excludedRows": "Personal-debtor rows stay in us-ca-current.json for auditability but are excluded from the company database, CSV, stream, search index, and SQLite company table.",
    "formats": {
      "csv": "public/data/receivership/us-ca-companies.csv",
      "json": "public/data/receivership/us-ca-companies.json",
      "sqlite": "public/data/receivership/us-ca-current.sqlite"
    },
    "primaryKey": "companyId",
    "rowGrain": "One company/legal-entity receivership, CCAA, or bankruptcy proceeding per row."
  },
  "coverage": {
    "asOfDate": "2026-07-20",
    "blockedSourceIds": [
      "us-pacer-court-polling",
      "us-pacer-case-locator",
      "ca-osb-bia-insolvency-records",
      "ca-bc-cso-new-cases",
      "ca-ontario-courts-public-portal"
    ],
    "liveSourcesFresh": true,
    "minimumCoverageDate": "2026-07-05",
    "productionReady": false,
    "requiredLiveSourceIds": [
      "us-sec-edgar-item-103",
      "us-fdic-failed-banks",
      "us-pacer-bankruptcy-rss",
      "ca-osb-ccaa"
    ]
  },
  "database": {
    "ftsTable": "company_search_fts",
    "primaryTable": "companies",
    "schemaVersion": 21,
    "tables": [
      "acceptance_requirement_blockers",
      "acceptance_requirements",
      "business_categories",
      "cases",
      "classification_evidence",
      "companies",
      "current_acceptance_status",
      "current_import_template_readiness",
      "current_raw_snapshot_readiness",
      "current_source_activation",
      "current_coverage_gaps",
      "current_source_refresh_state",
      "current_source_readiness",
      "current_stream_status",
      "coverage_segment_blockers",
      "coverage_segment_sources",
      "coverage_segments",
      "company_events",
      "company_legal_entities",
      "company_search_fts",
      "deadlines",
      "evidence",
      "legal_entities",
      "latest_release_source_health",
      "live_companies",
      "metadata",
      "opportunity_reasons",
      "opportunity_warnings",
      "production_environment_inputs",
      "production_setup_requirements",
      "production_blockers",
      "raw_source_snapshots",
      "release_audit",
      "release_delta_events",
      "release_history",
      "release_source_health",
      "stream_events",
      "source_activation_ready_when",
      "source_activation_steps",
      "source_import_template_fields",
      "source_import_templates",
      "source_official_references",
      "source_verification_commands",
      "source_health",
      "source_refresh_state",
      "sources"
    ]
  },
  "dictionaryVersion": 1,
  "generatedAt": "2026-07-20T08:29:54.271Z",
  "procedures": {
    "expectedTypes": ["chapter_11", "chapter_15", "receivership", "ccaa"],
    "stageValues": [
      "new",
      "active",
      "sale_process",
      "auction",
      "sold",
      "converted",
      "closed",
      "unknown"
    ]
  },
  "regressionChecks": {
    "dozr": {
      "canonicalName": "DOZR Inc.",
      "companyId": "company:dozr-2025-receivership",
      "filingDate": "2025-10-09",
      "petitionDate": "2025-09-26",
      "primarySourceId": "ca-ontario-courts-public-portal"
    }
  },
  "rowCounts": {
    "archiveCompanies": 4,
    "cases": 1004,
    "companies": 937,
    "liveCompanies": 933
  },
  "sourcePolicy": "first_party_only",
  "stream": {
    "apiArtifact": "public/data/receivership/us-ca-stream-api.json",
    "artifact": "public/data/receivership/us-ca-events.ndjson",
    "cadenceSeconds": 3600,
    "checkpointArtifact": "public/data/receivership/us-ca-stream-checkpoint.json",
    "deltaArtifact": "public/data/receivership/us-ca-delta-events.ndjson",
    "deltaEventTypes": [
      "receivership_company_added",
      "receivership_company_changed",
      "receivership_company_removed"
    ],
    "deltaJsonArtifact": "public/data/receivership/us-ca-delta-events.json",
    "eventsJsonArtifact": "public/data/receivership/us-ca-events.json",
    "eventsPagesArtifact": "public/data/receivership/us-ca-events-pages.json",
    "eventSequenceScope": "per_snapshot_newest_first_position",
    "eventFields": [
      {
        "description": "Stable human-readable company name for the proceeding.",
        "name": "canonicalName",
        "type": "string"
      },
      {
        "description": "Alias of canonicalName for stream consumers that expect a companyName field.",
        "name": "companyName",
        "type": "string"
      },
      {
        "description": "Stable company identifier matching companies[].companyId.",
        "name": "companyId",
        "type": "string"
      },
      {
        "description": "Stable case identifier matching the source case row.",
        "name": "caseId",
        "type": "string"
      },
      {
        "description": "Durable event cursor. Store this value when resuming from the newest-first stream.",
        "name": "eventId",
        "type": "string"
      },
      {
        "description": "Current per-snapshot newest-first sequence number. Use eventId, not this field, as the durable cursor.",
        "name": "eventSequence",
        "type": "integer"
      }
    ],
    "eventType": "receivership_company_snapshot",
    "feedVersion": 1,
    "pageSize": 50,
    "releaseAuditArtifact": "public/data/receivership/us-ca-release-audit.json",
    "releaseHistoryArtifact": "public/data/receivership/us-ca-release-history.json",
    "resume": "Poll the checkpoint first. If generatedAt or highWatermark changes, read us-ca-events-pages.json for paginated JSON consumers, or us-ca-events.ndjson/us-ca-events.json from the top until the last consumed eventId is reached. Treat eventSequence as a per-snapshot newest-first position and eventId as the primary durable cursor.",
    "sourceHealthArtifact": "public/data/receivership/us-ca-source-health.json",
    "sort": "eventTime_desc_caseId_asc"
  },
  "targetCountries": ["US", "CA"]
}
