@nexalink/coding-contracts 0.1.0 → 0.3.0

package/schemas/coding-rule-result.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nexalink.care/contracts/coding-rule-result.schema.json",
+  "title": "CodingRuleResult",
+  "description": "One deterministic rule execution trace attached to a decision. Rules never rely on the model for validity, bundling, sequencing, modifiers, units, or time calculations; each trace records the rule identity, version, inputs, outcome, and explanation needed to replay the decision.",
+  "version": "1.0.0",
+  "x-wire-version": "coding-rule-result-v1",
+  "x-wire-constant": "CODING_RULE_RESULT_SCHEMA_VERSION",
+  "x-code": "rule_result",
+  "x-keys-code": "rule_result_keys",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ruleId", "ruleVersion", "outcome"],
+  "properties": {
+    "ruleId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "x-code": "rule_result_id"
+    },
+    "ruleVersion": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 40,
+      "x-code": "rule_result_version"
+    },
+    "outcome": {
+      "type": "string",
+      "enum": [
+        "satisfied",
+        "failed",
+        "rejected",
+        "escalated",
+        "conflicted",
+        "warning"
+      ],
+      "x-code": "rule_result_outcome"
+    },
+    "severity": {
+      "type": "string",
+      "enum": ["info", "warning", "blocking"],
+      "x-code": "rule_result_severity"
+    },
+    "inputs": {
+      "type": "array",
+      "maxItems": 30,
+      "x-code": "rule_result_inputs",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "value"],
+        "x-code": "rule_result_input",
+        "x-keys-code": "rule_result_input_keys",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80,
+            "x-code": "rule_result_input_name"
+          },
+          "value": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2000,
+            "x-code": "rule_result_input_value"
+          }
+        }
+      }
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "x-code": "rule_result_reason"
+    },
+    "explanation": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000,
+      "x-strip-nonempty": true,
+      "x-code": "rule_result_explanation"
+    },
+    "evidence": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000,
+      "x-code": "rule_result_evidence"
+    }
+  }
+}

package/schemas/coding-service-line.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nexalink.care/contracts/coding-service-line.schema.json",
+  "title": "CodingServiceLine",
+  "description": "One existing (submitted) claim line on a CodingCase. Decisions reference these lines by lineId; the line action is chosen by the decision, never stored here.",
+  "version": "1.0.0",
+  "x-wire-version": "coding-service-line-v1",
+  "x-wire-constant": "CODING_SERVICE_LINE_SCHEMA_VERSION",
+  "x-code": "service_line",
+  "x-keys-code": "service_line_keys",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["lineId", "submittedCode"],
+  "properties": {
+    "lineId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 60,
+      "x-code": "service_line_id"
+    },
+    "submittedCode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "codeSystem"],
+      "x-code": "service_line_submitted_code",
+      "x-keys-code": "service_line_submitted_code_keys",
+      "properties": {
+        "code": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "x-strip-nonempty": true,
+          "x-code": "service_line_code"
+        },
+        "codeSystem": {
+          "type": "string",
+          "enum": [
+            "ICD-10-CM",
+            "ICD-10-PCS",
+            "CPT",
+            "HCPCS",
+            "NDC",
+            "CDT",
+            "OTHER"
+          ],
+          "x-code": "service_line_code_system"
+        },
+        "codeVersion": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40,
+          "x-code": "service_line_code_version"
+        }
+      }
+    },
+    "modifiers": {
+      "type": "array",
+      "maxItems": 8,
+      "x-code": "service_line_modifiers",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 8,
+        "x-code": "service_line_modifiers"
+      }
+    },
+    "units": {
+      "type": "object",
+      "additionalProperties": false,
+      "x-code": "service_line_units",
+      "x-keys-code": "service_line_units_keys",
+      "properties": {
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 999999,
+          "x-code": "service_line_units_count"
+        },
+        "unitOfMeasure": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 20,
+          "x-code": "service_line_units_measure"
+        }
+      }
+    },
+    "linkedDiagnoses": {
+      "type": "array",
+      "maxItems": 20,
+      "x-code": "service_line_linked_diagnoses",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["diagnosisRef"],
+        "x-code": "service_line_linked_diagnosis",
+        "x-keys-code": "service_line_linked_diagnosis_keys",
+        "properties": {
+          "diagnosisRef": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 60,
+            "x-code": "service_line_diagnosis_ref"
+          },
+          "sequence": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 99,
+            "x-code": "service_line_diagnosis_sequence"
+          }
+        }
+      }
+    },
+    "serviceDate": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "format": "date",
+      "x-code": "service_line_service_date"
+    }
+  }
+}

package/versions.json

@@ -1,8 +1,68 @@
 {
-  "$comment": "GENERATED FILE. Schema registry derived from contracts/schemas/*.schema.json.",
+  "$comment": "GENERATED FILE. Schema registry derived from schemas/*.schema.json.",
   "packageName": "@nexalink/coding-contracts",
-  "packageVersion": "0.1.0",
+  "packageVersion": "0.3.0",
   "schemas": {
+    "coding-case-context": {
+      "file": "coding-case-context.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-case-context-v1"
+    },
+    "coding-case-payer": {
+      "file": "coding-case-payer.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-case-payer-v1"
+    },
+    "coding-case-clinical": {
+      "file": "coding-case-clinical.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-case-clinical-v1"
+    },
+    "coding-service-line": {
+      "file": "coding-service-line.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-service-line-v1"
+    },
+    "coding-extension": {
+      "file": "coding-extension.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-extension-v1"
+    },
+    "coding-case": {
+      "file": "coding-case.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-case-v1"
+    },
+    "coding-batch": {
+      "file": "coding-batch.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-batch-v1"
+    },
+    "coding-decision-line": {
+      "file": "coding-decision-line.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-decision-line-v1"
+    },
+    "coding-evidence": {
+      "file": "coding-evidence.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-evidence-v1"
+    },
+    "coding-rule-result": {
+      "file": "coding-rule-result.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-rule-result-v1"
+    },
+    "coding-reviewer-action": {
+      "file": "coding-reviewer-action.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-reviewer-action-v1"
+    },
+    "coding-decision": {
+      "file": "coding-decision.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "coding-decision-v1"
+    },
     "rcm-supporting-reference": {
       "file": "rcm-supporting-reference.schema.json",
       "semver": "1.0.0",

package/workflow-constants.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Single source for workflow identity and policy identifiers shared across nexalink-cloud, carecompass-sdk, and nexalink-webapp. Values are immutable server-side; changes require a breaking major release and a documented compatibility migration.",
+  "$comment": "Single source for workflow identity and policy identifiers. Values are immutable server-side; changes require a breaking major release and a documented compatibility migration.",
   "workflowConstants": {
     "rcmWorkflowId": "rcm-coding-assistance",
     "rcmModelPolicyId": "carecompass-rcm-review-v1",