medicafe 0.250812.4__tar.gz → 0.250812.5__tar.gz

{medicafe-0.250812.4 → medicafe-0.250812.5}/MediBot/MediBot.bat

@@ -2,11 +2,31 @@
 @echo off
 setlocal enabledelayedexpansion
 
-:: Debug mode selection
+:: Clear screen before launcher header
+cls
+
+:: Launcher header
 echo ========================================
 echo           MediCafe Launcher
 echo ========================================
 echo.
+
+:: Hidden debug access: 1-second Enter-to-open gate; otherwise start normal mode
+echo Press Enter within 1 second to open Debug Options... (otherwise starting Normal Mode)
+rem Prefer timeout for key-break; fall back to ping if unavailable
+where timeout >nul 2>&1
+if errorlevel 1 (
+    rem Fallback: simple 1-second delay (no key detection on XP fallback)
+    ping -n 2 127.0.0.1 >nul
+    goto start_normal_mode
+) else (
+    timeout /t 1 >nul 2>nul
+    if errorlevel 1 goto show_debug_menu
+    goto start_normal_mode
+)
+
+:show_debug_menu
+echo.
 echo Choose your mode:
 echo 1. Normal Mode - Production
 echo 2. Debug Mode - Full diagnostics (Interactive)
@@ -127,6 +147,8 @@ set "claims_status_script=..\MediLink\MediLink_ClaimStatus.py"
 set "deductible_script=..\MediLink\MediLink_Deductible.py"
 set "package_version="
 set PYTHONWARNINGS=ignore
+set "PRES_WARN_UPDATE_SCRIPT=0"
+set "PRES_WARN_NO_INTERNET=0"
 
 :: Check if Python is installed
 python --version >nul 2>&1
@@ -186,6 +208,7 @@ if defined package_version (
 ping -n 1 google.com >nul 2>&1
 if errorlevel 1 (
     set "internet_available=0"
+    set "PRES_WARN_NO_INTERNET=1"
 ) else (
     set "internet_available=1"
     echo Internet connection detected.
@@ -322,6 +345,7 @@ if exist "%upgrade_medicafe_local%" (
             ping -n 2 127.0.0.1 >nul
         ) else (
             echo update_medicafe.py not detected in any known location.
+            set "PRES_WARN_UPDATE_SCRIPT=1"
             echo.
             echo Checked locations:
             echo   - Site-packages: C:\Python34\Lib\site-packages\MediBot\update_medicafe.py
@@ -351,6 +375,16 @@ echo              .//*  Welcome to MediCafe  *\\.
 echo --------------------------------------------------------------
 echo. 
 
+:: Preserve important warnings/errors from boot sequence
+if "%PRES_WARN_UPDATE_SCRIPT%"=="1" (
+  echo [WARNING] Update helper script not detected during startup. Update features may be limited.
+  echo.
+)
+if "%PRES_WARN_NO_INTERNET%"=="1" (
+  echo [WARNING] No internet connectivity detected during startup.
+  echo.
+)
+
 if "!internet_available!"=="0" (
 echo NOTE: No internet detected. Options 1-5 require internet.
     echo.

{medicafe-0.250812.4 → medicafe-0.250812.5}/MediBot/MediBot.py

@@ -73,6 +73,45 @@ except ImportError as e:
         # Make API client optional - don't log warning for now
         pass
 
+# Buffer for startup warnings/errors so we can re-display them after clearing the console
+STARTUP_NOTICES = []
+
+def record_startup_warning(message):
+    """Record a startup warning, log it, and print it immediately.
+    Stored warnings will be reprinted after the screen is cleared.
+    """
+    try:
+        STARTUP_NOTICES.append(('WARNING', message))
+    except Exception:
+        pass
+    try:
+        if MediLink_ConfigLoader:
+            MediLink_ConfigLoader.log(message, level="WARNING")
+    except Exception:
+        pass
+    try:
+        print(message)
+    except Exception:
+        pass
+
+def record_startup_error(message):
+    """Record a startup error, log it, and print it immediately.
+    Stored errors will be reprinted after the screen is cleared.
+    """
+    try:
+        STARTUP_NOTICES.append(('ERROR', message))
+    except Exception:
+        pass
+    try:
+        if MediLink_ConfigLoader:
+            MediLink_ConfigLoader.log(message, level="ERROR")
+    except Exception:
+        pass
+    try:
+        print(message)
+    except Exception:
+        pass
+
 def identify_field(header, field_mapping):
     for medisoft_field, patterns in field_mapping.items():
         for pattern in patterns:
@@ -448,12 +487,10 @@ class ExecutionState:
                 MediLink_ConfigLoader.log("Crosswalk update completed successfully.", level="INFO")
                 print("Crosswalk update completed successfully.")
             else:
-                MediLink_ConfigLoader.log("Crosswalk update failed.", level="ERROR")
-                print("Crosswalk update failed.")
+                record_startup_error("Crosswalk update failed.")
 
         except Exception as e:
-            MediLink_ConfigLoader.log("MediBot: Failed to load or update configuration: {}".format(e), level="ERROR")
-            print("MediBot: Failed to load or update configuration: {}".format(e))
+            record_startup_error("MediBot: Failed to load or update configuration: {}".format(e))
             raise  # Re-throwing the exception or using a more sophisticated error handling mechanism might be needed
             # Handle the exception somehow (e.g., retry, halt, log)??
         
@@ -544,9 +581,18 @@ if __name__ == "__main__":
         MediLink_ConfigLoader.log("Load Complete event triggered. Clearing console. Displaying Menu...", level="INFO")
         # Windows XP console buffer fix: Use cls with echo to reset buffer state
         # Add a debug switch to optionally skip clearing the console for debugging purposes
-        CLEAR_CONSOLE_ON_LOAD = False  # Set to False to keep previous output visible for debugging
+        CLEAR_CONSOLE_ON_LOAD = True  # Clear screen before menu for cleaner UI
         if CLEAR_CONSOLE_ON_LOAD:
             _ = os.system('cls && echo.')
+            # Re-display critical startup notices so the user still sees them
+            if STARTUP_NOTICES:
+                print("Important notices from startup:")
+                for lvl, msg in STARTUP_NOTICES:
+                    try:
+                        print("[{}] {}".format(lvl, msg))
+                    except Exception:
+                        print(msg)
+                print("-" * 60)
         
         proceed, selected_patient_ids, selected_indices, fixed_values = user_interaction(csv_data, interaction_mode, error_message, reverse_mapping)
 
@@ -556,7 +602,7 @@ if __name__ == "__main__":
             
             # Check if MAPAT_MED_PATH is missing or invalid
             if (not _ac()) or (not _ac().get_mapat_med_path()) or (not os.path.exists(_ac().get_mapat_med_path())):
-                print("Warning: MAPAT.MED PATH is missing or invalid. Please check the path configuration.")
+                record_startup_warning("Warning: MAPAT.MED PATH is missing or invalid. Please check the path configuration.")
 
             # Perform the existing patients check
             existing_patients, patients_to_process = MediBot_Preprocessor.check_existing_patients(selected_patient_ids, _ac().get_mapat_med_path() if _ac() else '')

{medicafe-0.250812.4 → medicafe-0.250812.5}/MediCafe/api_core.py

@@ -79,6 +79,9 @@ class ConfigLoader:
             print("Attempting to load Swagger file: {}".format(swagger_path))
             with open(swagger_path, 'r') as swagger_file:
                 if swagger_path.endswith('.yaml') or swagger_path.endswith('.yml'):
+                    if yaml is None:
+                        print("YAML parsing not available (PyYAML not installed). Please install PyYAML or provide a JSON Swagger file.")
+                        return None
                     print("Parsing YAML file: {}".format(swagger_path))
                     swagger_data = yaml.safe_load(swagger_file)
                 elif swagger_path.endswith('.json'):

{medicafe-0.250812.4 → medicafe-0.250812.5}/MediCafe/graphql_utils.py

@@ -109,7 +109,7 @@ class GraphQLQueryBuilder:
         This is for testing purposes to verify the endpoint is working.
         """
         return {
-            "query": "query Query($input: EligibilityInput!) { checkEligibility(input: $input) { eligibility { eligibilityInfo { trnId member { memberId firstName lastName middleName suffix dateOfBirth gender relationship relationshipCode relationshipTypeCode individualRelationshipCode dependentSequenceNumber } contact { addresses { type street1 street2 city state country zip zip4 } } insuranceInfo { policyNumber eligibilityStartDate eligibilityEndDate planStartDate planEndDate policyStatus planTypeDescription planVariation reportingCode stateOfIssueCode productType productId productCode payerId lineOfBusiness lineOfBusinessCode coverageTypes { typeCode description } } associatedIds { alternateId medicaidRecipientId exchangeMemberId alternateSubscriberId hicNumber mbiNumber subscriberMemberFacingIdentifier survivingSpouseId subscriberId memberReplacementId legacyMemberId customerAccountIdentifier } planLevels { level family { networkStatus planAmount planAmountFrequency remainingAmount } individual { networkStatus planAmount planAmountFrequency remainingAmount } } delegatedInfo { entity payerId contact { phone fax email } addresses { type street1 street2 city state country zip zip4 } } additionalInfo { isReferralRequired } } primaryCarePhysician { isPcpFound lastName firstName middleName phoneNumber address { type street1 street2 city state country zip zip4 } networkStatusCode affiliateHospitalName providerGroupName } coordinationOfBenefit { coordinationOfBenefitDetails { payer { name phoneNumber address { type street1 street2 city state country zip zip4 } } cobPrimacy { indicator description message } } uhgPrimacyStatus { policyEffectiveDate policyTerminationDate primacy { indicator description message } } } idCardImages { side content contentType } providerNetwork { status tier } extendedAttributes { fundingCode fundingType hsa cdhp governmentProgramCode cmsPackageBenefitPlanCode cmsSegmentId cmsContractId marketType obligorId marketSite benefitPlanId virtualVisit planVariation groupNumber legacyPanelNumber coverageLevel sharedArrangement productServiceCode designatedVirtualClinicNetwork medicaidVariableCode healthInsuranceExchangeId memberDiv legalEntityCode } otherBeneficiaries { memberId firstName lastName middleName suffix dateOfBirth gender relationship relationshipCode relationshipTypeCode individualRelationshipCode dependentSequenceNumber } serviceLevels { family { networkStatus services { isVendorOnly service serviceCode serviceDate text status coPayAmount coPayFrequency coInsurancePercent planAmount remainingAmount metYearToDateAmount isReferralObtainedCopay isReferralObtainedCoInsurance referralCopayAmount referralCoInsurancePercent benefitsAllowedFrequencies benefitsRemainingFrequencies message { note { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPay { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coInsurance { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } deductible { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsAllowed { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsRemaining { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPayList coInsuranceList } } } individual { networkStatus services { isVendorOnly service serviceCode serviceDate text status coPayAmount coPayFrequency coInsurancePercent planAmount remainingAmount metYearToDateAmount isReferralObtainedCopay isReferralObtainedCoInsurance referralCopayAmount referralCoInsurancePercent benefitsAllowedFrequencies benefitsRemainingFrequencies message { note { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPay { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coInsurance { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } deductible { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsAllowed { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsRemaining { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPayList coInsuranceList } } } } } } }",
+            "query": "query Query($input: EligibilityInput!) { checkEligibility(input: $input) { eligibility { eligibilityInfo { trnId member { memberId firstName lastName middleName suffix dateOfBirth gender relationship relationshipCode relationshipTypeCode individualRelationshipCode dependentSequenceNumber } contact { addresses { type street1 street2 city state country zip zip4 } } insuranceInfo { policyNumber eligibilityStartDate eligibilityEndDate planStartDate planEndDate policyStatus planTypeDescription planVariation reportingCode stateOfIssueCode productType productId productCode payerId lineOfBusiness lineOfBusinessCode coverageTypes { typeCode description } } associatedIds { alternateId medicaidRecipientId exchangeMemberId alternateSubscriberId hicNumber mbiNumber subscriberMemberFacingIdentifier survivingSpouseId subscriberId memberReplacementId legacyMemberId customerAccountIdentifier } planLevels { level family { networkStatus planAmount planAmountFrequency remainingAmount } individual { networkStatus planAmount planAmountFrequency remainingAmount } } delegatedInfo { entity payerId contact { phone fax email } addresses { type street1 street2 city state country zip zip4 } } additionalInfo { isReferralRequired } } primaryCarePhysician { isPcpFound lastName firstName middleName phoneNumber address { type street1 street2 city state country zip zip4 } networkStatusCode affiliateHospitalName providerGroupName } coordinationOfBenefit { coordinationOfBenefitDetails { payer { name phoneNumber address { type street1 street2 city state country zip zip4 } } cobPrimacy { indicator description message } } uhgPrimacyStatus { policyEffectiveDate policyTerminationDate primacy { indicator description message } } } idCardImages { side content contentType } providerNetwork { status tier } extendedAttributes { fundingCode fundingType hsa cdhp governmentProgramCode cmsPackageBenefitPlanCode cmsSegmentId cmsContractId marketType obligorId marketSite benefitPlanId virtualVisit planVariation groupNumber legacyPanelNumber coverageLevel sharedArrangement productServiceCode designatedVirtualClinicNetwork medicaidVariableCode healthInsuranceExchangeId memberDiv legalEntityCode } otherBeneficiaries { memberId firstName lastName middleName suffix dateOfBirth gender relationship relationshipCode relationshipTypeCode individualRelationshipCode dependentSequenceNumber } serviceLevels { family { networkStatus services { isVendorOnly service serviceCode serviceDate text status coPayAmount coPayFrequency coInsurancePercent planAmount remainingAmount metYearToDateAmount isReferralObtainedCopay isReferralObtainedCoInsurance referralCopayAmount referralCoInsurancePercent benefitsAllowedFrequencies benefitsRemainingFrequencies message { note { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPay { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coInsurance { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } deductible { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsAllowed { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } benefitsRemaining { isSingleMessageDetail isViewDetail messages text subMessages { service status copay msg startDate endDate minCopay minCopayMsg maxCopay maxCopayMsg isPrimaryIndicator } limitationInfo { lmtPeriod lmtType lmtOccurPerPeriod lmtDollarPerPeriod message } isMultipleCopaysFound isMultipleCoinsuranceFound } coPayList coInsuranceList } } } } } } }",
             "variables": {
                 "input": {
                     "memberId": "0001234567",
@@ -141,7 +141,7 @@ class GraphQLQueryBuilder:
         Returns the exact GraphQL query format that works with the Super Connector API.
         This matches the exact format from the successful cURL request.
         """
-        return """query Query($input: EligibilityInput!) {\r\n \r\n  checkEligibility(input: $input) {\r\n    eligibility {\r\n      eligibilityInfo {\r\n        trnId\r\n        member {\r\n          memberId\r\n          firstName\r\n          lastName\r\n          middleName\r\n          suffix\r\n          dateOfBirth\r\n          gender\r\n          relationship\r\n          relationshipCode\r\n          relationshipTypeCode\r\n          individualRelationshipCode\r\n          dependentSequenceNumber\r\n        }\r\n        contact {\r\n          addresses {\r\n            type\r\n            street1\r\n            street2\r\n            city\r\n            state\r\n            country\r\n            zip\r\n            zip4\r\n          }\r\n        }\r\n        insuranceInfo {\r\n          policyNumber\r\n          eligibilityStartDate\r\n          eligibilityEndDate\r\n          planStartDate\r\n          planEndDate\r\n          policyStatus\r\n          planTypeDescription\r\n          planVariation\r\n          reportingCode\r\n          stateOfIssueCode\r\n          productType\r\n          productId\r\n          productCode\r\n          payerId\r\n          lineOfBusiness\r\n          lineOfBusinessCode\r\n          coverageTypes {\r\n            typeCode\r\n            description\r\n          }\r\n        }\r\n        associatedIds {\r\n          alternateId\r\n          medicaidRecipientId\r\n          exchangeMemberId\r\n          alternateSubscriberId\r\n          hicNumber\r\n          mbiNumber\r\n          subscriberMemberFacingIdentifier\r\n          survivingSpouseId\r\n          subscriberId\r\n          memberReplacementId\r\n          legacyMemberId\r\n          customerAccountIdentifier\r\n        }\r\n        planLevels {\r\n          level\r\n          family {\r\n            networkStatus\r\n            planAmount\r\n            planAmountFrequency\r\n            remainingAmount\r\n          }\r\n          individual {\r\n            networkStatus\r\n            planAmount\r\n            planAmountFrequency\r\n            remainingAmount\r\n          }\r\n        }\r\n        delegatedInfo {\r\n          entity\r\n          payerId\r\n          contact {\r\n            phone\r\n            fax\r\n            email\r\n          }\r\n          addresses {\r\n            type\r\n            street1\r\n            street2\r\n            city\r\n            state\r\n            country\r\n            zip\r\n            zip4\r\n          }\r\n        }\r\n        additionalInfo {\r\n          isReferralRequired\r\n        }\r\n      }\r\n      primaryCarePhysician {\r\n        isPcpFound\r\n        lastName\r\n        firstName\r\n        middleName\r\n        phoneNumber\r\n        address {\r\n          type\r\n          street1\r\n          street2\r\n          city\r\n          state\r\n          country\r\n          zip\r\n          zip4\r\n        }\r\n        networkStatusCode\r\n        affiliateHospitalName\r\n        providerGroupName\r\n      }\r\n      coordinationOfBenefit {\r\n        coordinationOfBenefitDetails {\r\n          payer {\r\n            name\r\n            phoneNumber\r\n            address {\r\n              type\r\n              street1\r\n              street2\r\n              city\r\n              state\r\n              country\r\n              zip\r\n              zip4\r\n            }\r\n          }\r\n          cobPrimacy {\r\n            indicator\r\n            description\r\n            message\r\n          }\r\n        }\r\n        uhgPrimacyStatus {\r\n          policyEffectiveDate\r\n          policyTerminationDate\r\n          primacy {\r\n            indicator\r\n            description\r\n            message\r\n          }\r\n        }\r\n      }\r\n      providerNetwork {\r\n        status\r\n        tier\r\n      }\r\n      extendedAttributes {\r\n        fundingCode\r\n        fundingType\r\n        hsa\r\n        cdhp\r\n        governmentProgramCode\r\n        cmsPackageBenefitPlanCode\r\n        cmsSegmentId\r\n        cmsContractId\r\n        marketType\r\n        obligorId\r\n        marketSite\r\n        benefitPlanId\r\n        virtualVisit\r\n        planVariation\r\n        groupNumber\r\n        legacyPanelNumber\r\n        coverageLevel\r\n        sharedArrangement\r\n        productServiceCode\r\n        designatedVirtualClinicNetwork\r\n        medicaidVariableCode\r\n        healthInsuranceExchangeId\r\n        memberDiv\r\n        legalEntityCode\r\n      }\r\n      otherBeneficiaries {\r\n        memberId\r\n        firstName\r\n        lastName\r\n        middleName\r\n        suffix\r\n        dateOfBirth\r\n        gender\r\n        relationship\r\n        relationshipCode\r\n        relationshipTypeCode\r\n        individualRelationshipCode\r\n        dependentSequenceNumber\r\n      }\r\n      serviceLevels {\r\n        family {\r\n          networkStatus\r\n          services {\r\n            isVendorOnly\r\n            service\r\n            serviceCode\r\n            serviceDate\r\n            text\r\n            status\r\n            coPayAmount\r\n            coPayFrequency\r\n            coInsurancePercent\r\n            planAmount\r\n            remainingAmount\r\n            metYearToDateAmount\r\n            isReferralObtainedCopay\r\n            isReferralObtainedCoInsurance\r\n            referralCopayAmount\r\n            referralCoInsurancePercent\r\n            benefitsAllowedFrequencies\r\n            benefitsRemainingFrequencies\r\n            message {\r\n              note {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPay {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coInsurance {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              deductible {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsAllowed {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsRemaining {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPayList\r\n              coInsuranceList\r\n            }\r\n          }\r\n        }\r\n        individual {\r\n          networkStatus\r\n          services {\r\n            isVendorOnly\r\n            service\r\n            serviceCode\r\n            serviceDate\r\n            text\r\n            status\r\n            coPayAmount\r\n            coPayFrequency\r\n            coInsurancePercent\r\n            planAmount\r\n            remainingAmount\r\n            metYearToDateAmount\r\n            isReferralObtainedCopay\r\n            isReferralObtainedCoInsurance\r\n            referralCopayAmount\r\n            referralCoInsurancePercent\r\n            benefitsAllowedFrequencies\r\n            benefitsRemainingFrequencies\r\n            message {\r\n              note {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPay {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coInsurance {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              deductible {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsAllowed {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsRemaining {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPayList\r\n              coInsuranceList\r\n            }\r\n          }\r\n        }\r\n      }\r\n    }\r\n  }\r\n}"""
+        return """query Query($input: EligibilityInput!) {\r\n \r\n  checkEligibility(input: $input) {\r\n    eligibility {\r\n      eligibilityInfo {\r\n        trnId\r\n        member {\r\n          memberId\r\n          firstName\r\n          lastName\r\n          middleName\r\n          suffix\r\n          dateOfBirth\r\n          gender\r\n          relationship\r\n          relationshipCode\r\n          relationshipTypeCode\r\n          individualRelationshipCode\r\n          dependentSequenceNumber\r\n        }\r\n        contact {\r\n          addresses {\r\n            type\r\n            street1\r\n            street2\r\n            city\r\n            state\r\n            country\r\n            zip\r\n            zip4\r\n          }\r\n        }\r\n        insuranceInfo {\r\n          policyNumber\r\n          eligibilityStartDate\r\n          eligibilityEndDate\r\n          planStartDate\r\n          planEndDate\r\n          policyStatus\r\n          planTypeDescription\r\n          planVariation\r\n          reportingCode\r\n          stateOfIssueCode\r\n          productType\r\n          productId\r\n          productCode\r\n          payerId\r\n          lineOfBusiness\r\n          lineOfBusinessCode\r\n          coverageTypes {\r\n            typeCode\r\n            description\r\n          }\r\n        }\r\n        associatedIds {\r\n          alternateId\r\n          medicaidRecipientId\r\n          exchangeMemberId\r\n          alternateSubscriberId\r\n          hicNumber\r\n          mbiNumber\r\n          subscriberMemberFacingIdentifier\r\n          survivingSpouseId\r\n          subscriberId\r\n          memberReplacementId\r\n          legacyMemberId\r\n          customerAccountIdentifier\r\n        }\r\n        planLevels {\r\n          level\r\n          family {\r\n            networkStatus\r\n            planAmount\r\n            planAmountFrequency\r\n            remainingAmount\r\n          }\r\n          individual {\r\n            networkStatus\r\n            planAmount\r\n            planAmountFrequency\r\n            remainingAmount\r\n          }\r\n        }\r\n        delegatedInfo {\r\n          entity\r\n          payerId\r\n          contact {\r\n            phone\r\n            fax\r\n            email\r\n          }\r\n          addresses {\r\n            type\r\n            street1\r\n            street2\r\n            city\r\n            state\r\n            country\r\n            zip\r\n            zip4\r\n          }\r\n        }\r\n        additionalInfo {\r\n          isReferralRequired\r\n        }\r\n      }\r\n      primaryCarePhysician {\r\n        isPcpFound\r\n        lastName\r\n        firstName\r\n        middleName\r\n        phoneNumber\r\n        address {\r\n          type\r\n          street1\r\n          street2\r\n          city\r\n          state\r\n          country\r\n          zip\r\n          zip4\r\n        }\r\n        networkStatusCode\r\n        affiliateHospitalName\r\n        providerGroupName\r\n      }\r\n      coordinationOfBenefit {\r\n        coordinationOfBenefitDetails {\r\n          payer {\r\n            name\r\n            phoneNumber\r\n            address {\r\n              type\r\n              street1\r\n              street2\r\n              city\r\n              state\r\n              country\r\n              zip\r\n              zip4\r\n            }\r\n          }\r\n          cobPrimacy {\r\n            indicator\r\n            description\r\n            message\r\n          }\r\n        }\r\n        uhgPrimacyStatus {\r\n          policyEffectiveDate\r\n          policyTerminationDate\r\n          primacy {\r\n            indicator\r\n            description\r\n            message\r\n          }\r\n        }\r\n      }\r\n      providerNetwork {\r\n        status\r\n        tier\r\n      }\r\n      extendedAttributes {\r\n        fundingCode\r\n        fundingType\r\n        hsa\r\n        cdhp\r\n        governmentProgramCode\r\n        cmsPackageBenefitPlanCode\r\n        cmsSegmentId\r\n        cmsContractId\r\n        marketType\r\n        obligorId\r\n        marketSite\r\n        benefitPlanId\r\n        virtualVisit\r\n        planVariation\r\n        groupNumber\r\n        legacyPanelNumber\r\n        coverageLevel\r\n        sharedArrangement\r\n        productServiceCode\r\n        designatedVirtualClinicNetwork\r\n        medicaidVariableCode\r\n        healthInsuranceExchangeId\r\n        memberDiv\r\n        legalEntityCode\r\n      }\r\n      otherBeneficiaries {\r\n        memberId\r\n        firstName\r\n        lastName\r\n        middleName\r\n        suffix\r\n        dateOfBirth\r\n        gender\r\n        relationship\r\n        relationshipCode\r\n        relationshipTypeCode\r\n        individualRelationshipCode\r\n        dependentSequenceNumber\r\n      }\r\n      serviceLevels {\r\n        family {\r\n          networkStatus\r\n          services {\r\n            isVendorOnly\r\n            service\r\n            serviceCode\r\n            serviceDate\r\n            text\r\n            status\r\n            coPayAmount\r\n            coPayFrequency\r\n            coInsurancePercent\r\n            planAmount\r\n            remainingAmount\r\n            metYearToDateAmount\r\n            isReferralObtainedCopay\r\n            isReferralObtainedCoInsurance\r\n            referralCopayAmount\r\n            referralCoInsurancePercent\r\n            benefitsAllowedFrequencies\r\n            benefitsRemainingFrequencies\r\n            message {\r\n              note {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPay {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coInsurance {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              deductible {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsAllowed {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              benefitsRemaining {\r\n                isSingleMessageDetail\r\n                isViewDetail\r\n                messages\r\n                text\r\n                subMessages {\r\n                  service\r\n                  status\r\n                  copay\r\n                  msg\r\n                  startDate\r\n                  endDate\r\n                  minCopay\r\n                  minCopayMsg\r\n                  maxCopay\r\n                  maxCopayMsg\r\n                  isPrimaryIndicator\r\n                }\r\n                limitationInfo {\r\n                  lmtPeriod\r\n                  lmtType\r\n                  lmtOccurPerPeriod\r\n                  lmtDollarPerPeriod\r\n                  message\r\n                }\r\n                isMultipleCopaysFound\r\n                isMultipleCoinsuranceFound\r\n              }\r\n              coPayList\r\n              coInsuranceList\r\n            }\r\n          }\r\n        }\r\n      }\r\n    }\r\n  }\r\n}"""
 
     @staticmethod
     def build_working_eligibility_request(variables):
@@ -424,6 +424,7 @@ class GraphQLResponseTransformer:
             }
 
 # Convenience functions for easy access
+
 def get_eligibility_query():
     """Get the eligibility GraphQL query (working format)"""
     return GraphQLQueryBuilder.get_eligibility_query()
@@ -433,7 +434,7 @@ def build_eligibility_variables(**kwargs):
     return GraphQLQueryBuilder.build_eligibility_variables(**kwargs)
 
 def build_eligibility_request(variables):
-    """Build complete eligibility request body with working format"""
+    """Build complete GraphQL request body with working format"""
     return GraphQLQueryBuilder.build_eligibility_request(variables)
 
 def transform_eligibility_response(graphql_response):
@@ -442,4 +443,62 @@ def transform_eligibility_response(graphql_response):
 
 def get_sample_eligibility_request():
     """Get the sample GraphQL request from swagger documentation"""
-    return GraphQLQueryBuilder.get_sample_eligibility_request() 
+    return GraphQLQueryBuilder.get_sample_eligibility_request()
+
+# -----------------------------------------------------------------------------
+# Phase 2 scaffolding: centralized direct SBR09 extraction (placeholder)
+# -----------------------------------------------------------------------------
+
+# Placeholder path for future API-provided SBR09 value.
+# Accepts either a top-level key (e.g., 'sbr09Code') or a dotted path
+# (e.g., 'eligibilityInfo.insuranceInfo.sbr09'). Update when contract is finalized.
+FUTURE_SBR09_FIELD_PATH = '<INSERT_SBR09_FIELD_PATH>'
+
+
+def _get_nested_value(data, dotted_path):
+    """Safely get nested value from dict given a dotted path."""
+    try:
+        current = data
+        for part in dotted_path.split('.'):
+            if not isinstance(current, dict) or part not in current:
+                return None
+            current = current[part]
+        return current
+    except Exception:
+        return None
+
+
+def _is_valid_sbr09(code):
+    if not isinstance(code, str):
+        return False
+    c = code.strip().upper()
+    return 1 <= len(c) <= 3 and c.isalnum()
+
+
+def _normalize_sbr09(code):
+    return str(code).strip().upper()
+
+
+def extract_sbr09_direct(response_dict):
+    """
+    Extract SBR09 directly from a transformed GraphQL response or raw GraphQL if the
+    provider API supplies it. Returns None until FUTURE_SBR09_FIELD_PATH is set and value is present.
+
+    - No mapping is performed. Only format checks are applied.
+    - Accepts either top-level key or dotted path.
+    """
+    if not FUTURE_SBR09_FIELD_PATH or FUTURE_SBR09_FIELD_PATH.startswith('<'):
+        return None
+
+    # Try top-level lookup
+    raw_value = response_dict.get(FUTURE_SBR09_FIELD_PATH)
+
+    # If not found, try dotted path
+    if raw_value is None and '.' in FUTURE_SBR09_FIELD_PATH:
+        raw_value = _get_nested_value(response_dict, FUTURE_SBR09_FIELD_PATH)
+
+    if raw_value is None:
+        return None
+
+    candidate = _normalize_sbr09(raw_value)
+    return candidate if _is_valid_sbr09(candidate) else None 

medicafe-0.250812.5/MediCafe/submission_index.py

@@ -0,0 +1,288 @@
+"""
+submission_index.py - Centralized submission index scaffolding (Phase 3)
+
+Purpose:
+- Provide a shared, efficient index of successful claim submissions (and optionally attempts)
+- Avoid repeated scanning of historical receipt files across apps (MediLink, MediBot)
+- Enable fast deconfliction, window validation, and reporting
+
+Design:
+- Backed by a compact JSONL file in receipts_root (one JSON record per line)
+- Claim key: (patient_id, payer_id or primary_insurance, date_of_service, service_hash)
+- Fields: claim_key, patient_id, payer_id, primary_insurance, dos, endpoint, submitted_at,
+          receipt_file, status, checksum, notes, duplicate_override
+
+This is an incremental implementation with JSONL; SQLite can be added later if needed.
+"""
+import os
+import json
+import time
+
+META_FILENAME = 'submission_index_meta.json'
+INDEX_FILENAME = 'submission_index.jsonl'
+LOCK_FILENAME = 'submission_index.lock'
+
+
+def build_initial_index(receipts_root, lookback_days=200):
+    """
+    Initial index builder for legacy receipts.
+    NOTE: Legacy receipts do not include patient_id in the printed table, so we cannot
+    reliably backfill claim-level keys from historical receipts. This builder will:
+    - Create index/meta files if missing
+    - Record meta stats
+    - Return 0 (no historical claim entries)
+    """
+    if not os.path.isdir(receipts_root):
+        return 0
+    _ensure_files_exist(receipts_root)
+    count, max_mtime = _get_receipt_stats(receipts_root)
+    meta = _read_meta(receipts_root)
+    meta['last_indexed_mtime'] = max_mtime
+    meta['last_indexed_count'] = count
+    meta['last_full_build_at'] = time.time()
+    meta['rebuild_state'] = 'none'
+    meta['rebuild_progress'] = 0
+    _write_meta(receipts_root, meta)
+    return 0
+
+
+def append_submission_record(receipts_root, record):
+    """
+    Append a new successful submission record to the index after a claim is submitted.
+    """
+    try:
+        _ensure_files_exist(receipts_root)
+        line = json.dumps(record)
+        path = _index_path(receipts_root)
+        with open(path, 'a') as f:
+            f.write(line)
+            f.write("\n")
+    except Exception:
+        pass
+
+
+def find_by_claim_key(receipts_root, claim_key):
+    """
+    Look up a claim by its stable key to detect potential duplicates.
+    Returns the first matching record or None.
+    """
+    try:
+        path = _index_path(receipts_root)
+        if not os.path.exists(path):
+            return None
+        with open(path, 'r') as f:
+            for line in f:
+                try:
+                    entry = json.loads(line.strip())
+                    if isinstance(entry, dict) and entry.get('claim_key') == claim_key:
+                        return entry
+                except Exception:
+                    continue
+    except Exception:
+        return None
+    return None
+
+
+def reconcile_recent_receipts(receipts_root, since_timestamp, max_seconds):
+    """
+    Incrementally scan receipts newer than 'since_timestamp' and update meta only.
+    JSONL index is built at submission time; this reconcile only updates meta counters.
+    Returns number of new files detected.
+    """
+    start = time.time()
+    count = 0
+    try:
+        for root, dirs, files in os.walk(receipts_root):
+            for name in files:
+                try:
+                    _ = name.encode('ascii')
+                except Exception:
+                    continue
+                try:
+                    mtime = os.path.getmtime(os.path.join(root, name))
+                    if mtime > since_timestamp:
+                        count += 1
+                except Exception:
+                    continue
+                if int(time.time() - start) >= int(max_seconds):
+                    return count
+    except Exception:
+        return count
+    return count
+
+
+def compute_claim_key(patient_id, payer_id, primary_insurance, date_of_service, service_hash):
+    """
+    Compute a deterministic claim key for deconfliction.
+    """
+    return "|".join([
+        (patient_id or ""),
+        (payer_id or primary_insurance or ""),
+        (date_of_service or ""),
+        (service_hash or "")
+    ])
+
+
+# ------------------------- ASCII-safe meta/lock helpers -----------------------
+
+def _meta_path(root_dir):
+    return os.path.join(root_dir, META_FILENAME)
+
+
+def _index_path(root_dir):
+    return os.path.join(root_dir, INDEX_FILENAME)
+
+
+def _lock_path(root_dir):
+    return os.path.join(root_dir, LOCK_FILENAME)
+
+
+def _ensure_files_exist(root_dir):
+    try:
+        meta_path = _meta_path(root_dir)
+        if not os.path.exists(meta_path):
+            _write_meta(root_dir, {
+                'last_indexed_mtime': 0.0,
+                'last_indexed_count': 0,
+                'last_full_build_at': 0.0,
+                'rebuild_state': 'none',
+                'rebuild_progress': 0
+            })
+        index_path = _index_path(root_dir)
+        if not os.path.exists(index_path):
+            with open(index_path, 'w') as f:
+                f.write("")
+    except Exception:
+        pass
+
+
+def _read_meta(root_dir):
+    path = _meta_path(root_dir)
+    if not os.path.exists(path):
+        return {
+            'last_indexed_mtime': 0.0,
+            'last_indexed_count': 0,
+            'last_full_build_at': 0.0,
+            'rebuild_state': 'none',  # 'none' | 'pending' | 'in_progress'
+            'rebuild_progress': 0
+        }
+    try:
+        with open(path, 'r') as f:
+            data = f.read()
+            try:
+                meta = json.loads(data)
+            except Exception:
+                return {
+                    'last_indexed_mtime': 0.0,
+                    'last_indexed_count': 0,
+                    'last_full_build_at': 0.0,
+                    'rebuild_state': 'none',
+                    'rebuild_progress': 0
+                }
+            return meta if isinstance(meta, dict) else {}
+    except Exception:
+        return {
+            'last_indexed_mtime': 0.0,
+            'last_indexed_count': 0,
+            'last_full_build_at': 0.0,
+            'rebuild_state': 'none',
+            'rebuild_progress': 0
+        }
+
+
+def _write_meta(root_dir, meta):
+    try:
+        with open(_meta_path(root_dir), 'w') as f:
+            f.write(json.dumps(meta))
+    except Exception:
+        pass
+
+
+def _try_acquire_lock(root_dir):
+    lock = _lock_path(root_dir)
+    try:
+        fd = os.open(lock, os.O_CREAT | os.O_EXCL | os.O_WRONLY)
+        os.close(fd)
+        return True
+    except Exception:
+        return False
+
+
+def _release_lock(root_dir):
+    try:
+        os.remove(_lock_path(root_dir))
+    except Exception:
+        pass
+
+
+def _get_receipt_stats(receipts_root):
+    count = 0
+    max_mtime = 0.0
+    try:
+        for root, dirs, files in os.walk(receipts_root):
+            for name in files:
+                try:
+                    _ = name.encode('ascii')
+                except Exception:
+                    continue
+                count += 1
+                try:
+                    mtime = os.path.getmtime(os.path.join(root, name))
+                    if mtime > max_mtime:
+                        max_mtime = mtime
+                except Exception:
+                    continue
+    except Exception:
+        pass
+    return count, max_mtime
+
+
+# ------------------------- Public entry point --------------------------------
+
+def ensure_submission_index(receipts_root, lookback_days=200, large_growth_threshold=0.1, max_inline_seconds=2):
+    """
+    XP/ASCII-safe, inline-only upkeep for the submission index.
+    - No background tasks
+    - Bounded work per call
+    - Chunked rebuild across boots
+    """
+    if not receipts_root or not os.path.isdir(receipts_root):
+        return
+
+    # Ensure files exist early
+    _ensure_files_exist(receipts_root)
+
+    if not _try_acquire_lock(receipts_root):
+        return
+
+    try:
+        meta = _read_meta(receipts_root)
+        current_count, current_max_mtime = _get_receipt_stats(receipts_root)
+
+        if meta.get('last_indexed_mtime', 0.0) == 0.0 and meta.get('last_indexed_count', 0) == 0:
+            # First-time or corrupt meta: do bounded initial build
+            build_initial_index(receipts_root, lookback_days)
+            return
+
+        # Incremental reconcile if new files detected by mtime
+        if current_max_mtime > meta.get('last_indexed_mtime', 0.0):
+            added = reconcile_recent_receipts(receipts_root, meta.get('last_indexed_mtime', 0.0), max_inline_seconds)
+            meta['last_indexed_mtime'] = current_max_mtime
+            meta['last_indexed_count'] = meta.get('last_indexed_count', 0) + int(added)
+            _write_meta(receipts_root, meta)
+            return
+
+        # Large growth heuristic -> schedule chunked rebuild (across boots)
+        last_count = meta.get('last_indexed_count', 0)
+        delta = current_count - last_count
+        if delta > 0 and delta >= max(100, int(large_growth_threshold * (last_count or 1))):
+            if meta.get('rebuild_state') == 'none':
+                meta['rebuild_state'] = 'pending'
+                meta['rebuild_progress'] = 0
+                _write_meta(receipts_root, meta)
+            return
+
+        # If rebuild pending, we would process a chunk here in a future implementation
+        return
+    finally:
+        _release_lock(receipts_root)