@nexalink/coding-contracts 0.1.0

package/schemas/rcm-workflow-catalog.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nexalink.care/contracts/rcm-workflow-catalog.schema.json",
+  "title": "RcmWorkflowCatalog",
+  "description": "A single authorized workflow entry. The catalog pins the workflow identifier, model policy, human-review policy, and output schema version that the runtime and portal may offer for the RCM coding-assistance workflow. Customer configuration can never redefine these immutable server-side values.",
+  "version": "1.0.0",
+  "x-wire-version": "rcm-workflow-catalog-v1",
+  "x-code": "workflow_catalog",
+  "x-keys-code": "workflow_catalog_keys",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "name",
+    "description",
+    "environments",
+    "modelPolicy",
+    "humanReviewPolicy",
+    "outputSchemaVersion"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "enum": ["rcm-coding-assistance"],
+      "x-code": "workflow_id"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "x-code": "workflow_name"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 400,
+      "x-code": "workflow_description"
+    },
+    "environments": {
+      "type": "array",
+      "minItems": 1,
+      "x-code": "workflow_environments",
+      "items": {
+        "type": "string",
+        "enum": ["development", "production"],
+        "x-code": "workflow_environment"
+      }
+    },
+    "modelPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "policyId",
+        "inferencePath",
+        "maxNewTokens",
+        "temperature",
+        "outputSchemaVersion",
+        "requireHumanReview"
+      ],
+      "x-code": "model_policy",
+      "x-keys-code": "model_policy_keys",
+      "properties": {
+        "policyId": {
+          "type": "string",
+          "const": "carecompass-rcm-review-v1",
+          "x-code": "model_policy_id"
+        },
+        "inferencePath": {
+          "type": "string",
+          "maxLength": 64,
+          "x-code": "model_policy_inference_path"
+        },
+        "maxNewTokens": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2048,
+          "x-code": "model_policy_max_new_tokens"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 2,
+          "x-code": "model_policy_temperature"
+        },
+        "outputSchemaVersion": {
+          "type": "string",
+          "const": "rcm-grounded-human-review-v2",
+          "x-code": "model_policy_output_schema_version"
+        },
+        "requireHumanReview": {
+          "type": "boolean",
+          "const": true,
+          "x-code": "model_policy_require_human_review"
+        }
+      }
+    },
+    "humanReviewPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policyId", "humanReviewRequired"],
+      "x-code": "human_review_policy",
+      "x-keys-code": "human_review_policy_keys",
+      "properties": {
+        "policyId": {
+          "type": "string",
+          "const": "qualified-coder-review-v1",
+          "x-code": "human_review_policy_id"
+        },
+        "humanReviewRequired": {
+          "type": "boolean",
+          "const": true,
+          "x-code": "human_review_policy_required"
+        }
+      }
+    },
+    "outputSchemaVersion": {
+      "type": "string",
+      "const": "rcm-grounded-human-review-v2",
+      "x-code": "workflow_output_schema_version"
+    }
+  },
+  "x-wire-constant": "RCM_WORKFLOW_CATALOG_SCHEMA_VERSION"
+}

package/versions.json

@@ -0,0 +1,42 @@
+{
+  "$comment": "GENERATED FILE. Schema registry derived from contracts/schemas/*.schema.json.",
+  "packageName": "@nexalink/coding-contracts",
+  "packageVersion": "0.1.0",
+  "schemas": {
+    "rcm-supporting-reference": {
+      "file": "rcm-supporting-reference.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-supporting-reference-v1"
+    },
+    "rcm-coding-input": {
+      "file": "rcm-coding-input.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-coding-input-v1"
+    },
+    "rcm-coding-output": {
+      "file": "rcm-coding-output.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-grounded-human-review-v2"
+    },
+    "rcm-model-prompt": {
+      "file": "rcm-model-prompt.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-model-prompt-v1"
+    },
+    "rcm-retrieval-metadata": {
+      "file": "rcm-retrieval-metadata.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-retrieval-metadata-v1"
+    },
+    "rcm-runtime-event": {
+      "file": "rcm-runtime-event.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-runtime-event-v1"
+    },
+    "rcm-workflow-catalog": {
+      "file": "rcm-workflow-catalog.schema.json",
+      "semver": "1.0.0",
+      "wireVersion": "rcm-workflow-catalog-v1"
+    }
+  }
+}

package/workflow-constants.json

@@ -0,0 +1,10 @@
+{
+  "$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.",
+  "workflowConstants": {
+    "rcmWorkflowId": "rcm-coding-assistance",
+    "rcmModelPolicyId": "carecompass-rcm-review-v1",
+    "rcmHumanReviewPolicyId": "qualified-coder-review-v1",
+    "rcmOutputSchemaName": "carecompass_rcm_grounded_review",
+    "rcmHumanReviewInstruction": "Qualified human coder review is required before billing, coding, or claim submission."
+  }
+}