Task Profile

Canonical	../StructureDefinition/nexus-emr-core-clinical-task
Status	draft · 1.26.0
Base	Task (constraint)
Source	FSH · JSON

A unit of work in the chart: who asked for it, who owns it now, what has been said about it, and which chart element it concerns. Inbox items, to-dos, follow-ups, a result that needs review -- deliberately one kind of work item.

Examples

Chart-Created · Clinical · Document Review Task, Completed · Clinical task ai triage 001 · Clinical task completed 001 · Clinical task lab review 001 · Clinical task nursing pool 001 · Clinical task referral 001 · Suggested-Resource Task - Add a Chart Entry · Suggested-Resource Task - Card Alternative A (empagliflozin) · Suggested-Resource Task - Card Alternative B (dulaglutide) · Suggested-Resource Task - Retire a Chart Entry · Team-Owned Standalone · Unassigned

Suggested-Resource Task - Add a Chart Entry

A suggested chart entry awaiting a decision. The suggested resources ride in a contained transaction Bundle whose single entry is the suggested Condition, carrying the POST that instantiating performs. The Provenance citing the passage it was extracted from is contained alongside the Bundle, not inside it -- it is evidence about the proposal, not part of what would be written

Task/nexus-emr-clinical-task-suggestion-contained — claims conformance to Task Profile

{
  "resourceType": "Task",
  "id": "nexus-emr-clinical-task-suggestion-contained",
  "meta": {
    "profile": [
      "../StructureDefinition/nexus-emr-core-clinical-task"
    ],
    "security": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
        "code": "AIAST",
        "display": "Artificial Intelligence asserted"
      }
    ]
  },
  "contained": [
    {
      "resourceType": "Bundle",
      "id": "suggested",
      "type": "transaction",
      "entry": [
        {
          "fullUrl": "urn:uuid:9f2c8a1e-0000-4000-8000-000000000001",
          "resource": {
            "resourceType": "Condition",
            "clinicalStatus": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
                  "code": "active"
                }
              ]
            },
            "verificationStatus": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
                  "code": "confirmed"
                }
              ]
            },
            "category": [
              {
                "coding": [
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/condition-category",
                    "code": "problem-list-item",
                    "display": "Problem List Item"
                  }
                ]
              }
            ],
            "code": {
              "coding": [
                {
                  "system": "http://snomed.info/sct",
                  "code": "44054006",
                  "display": "Diabetes mellitus type 2"
                }
              ],
              "text": "Type 2 diabetes mellitus"
            },
            "subject": {
              "reference": "Patient/nexus-emr-patient-attachment-example",
              "display": "Avery Linwood"
            }
          },
          "request": {
            "method": "POST",
            "url": "Condition"
          }
        },
        {
          "fullUrl": "urn:uuid:9f2c8a1e-0000-4000-8000-100000000001",
          "resource": {
            "resourceType": "Provenance",
            "extension": [
              {
                "url": "../StructureDefinition/nexus-attributed-fact",
                "extension": [
                  {
                    "url": "statement",
                    "valueString": "The encounter note documents active type 2 diabetes mellitus."
                  },
                  {
                    "url": "citation",
                    "extension": [
                      {
                        "url": "chunk",
                        "valueString": "c4"
                      },
                      {
                        "url": "quote",
                        "valueString": "Longstanding type 2 diabetes, diet-controlled, last A1c 6.9."
                      },
                      {
                        "url": "source",
                        "valueReference": {
                          "reference": "Composition/encounter-note-avery-20260810",
                          "display": "Encounter note, 2026-08-10"
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "target": [
              {
                "reference": "urn:uuid:9f2c8a1e-0000-4000-8000-000000000001",
                "display": "Suggested Condition: Type 2 diabetes mellitus"
              }
            ],
            "occurredDateTime": "2026-08-10T14:22:00-04:00",
            "recorded": "2026-08-10T14:22:03-04:00",
            "activity": {
              "text": "AI clinical extraction suggested a chart entry"
            },
            "agent": [
              {
                "type": {
                  "coding": [
                    {
                      "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                      "code": "author",
                      "display": "Author"
                    }
                  ],
                  "text": "Generating agent (non-human)"
                },
                "who": {
                  "type": "Device",
                  "identifier": {
                    "system": "../NamingSystem/nexus-harness-graph",
                    "value": "chart-update"
                  },
                  "display": "ChartUpdate graph (AI)"
                },
                "onBehalfOf": {
                  "reference": "PractitionerRole/dr-ben-mrp-role",
                  "display": "Dr. Ben"
                }
              }
            ],
            "entity": [
              {
                "role": "source",
                "what": {
                  "reference": "Composition/encounter-note-avery-20260810",
                  "display": "Encounter note, 2026-08-10"
                }
              }
            ]
          },
          "request": {
            "method": "POST",
            "url": "Provenance"
          }
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "../StructureDefinition/nexus-emr-thread-id",
      "valueString": "thread-7f3a2c91-scribe-extraction"
    }
  ],
  "identifier": [
    {
      "use": "official",
      "system": "../NamingSystem/nexus-harness-key",
      "value": "chart-update:Patient/avery-linwood-01:dm2-not-on-problem-list"
    }
  ],
  "status": "ready",
  "intent": "proposal",
  "priority": "routine",
  "code": {
    "coding": [
      {
        "system": "../CodeSystem/nexus-task-code",
        "code": "other",
        "display": "Other"
      }
    ],
    "text": "Chart entry suggested from an encounter note"
  },
  "description": "Clinical extraction found 'type 2 diabetes' in the encounter note; suggested addition to the problem list. Review, then approve (promotes the contained Condition to the chart) or reject (retained as declined).",
  "for": {
    "reference": "Patient/nexus-emr-patient-attachment-example",
    "display": "Avery Linwood"
  },
  "authoredOn": "2026-08-10T14:22:00-04:00",
  "requester": {
    "type": "Device",
    "identifier": {
      "system": "../NamingSystem/nexus-harness-graph",
      "value": "chart-update"
    },
    "display": "ChartUpdate graph (AI)"
  },
  "owner": {
    "reference": "PractitionerRole/dr-ben-mrp-role",
    "display": "Dr. Ben"
  },
  "input": [
    {
      "type": {
        "coding": [
          {
            "system": "../CodeSystem/nexus-task-input-type",
            "code": "suggested-resource",
            "display": "Suggested resource"
          }
        ]
      },
      "valueReference": {
        "reference": "#suggested",
        "display": "Suggested resource Bundle"
      }
    }
  ],
  "note": [
    {
      "authorReference": {
        "identifier": {
          "system": "../NamingSystem/nexus-harness-graph",
          "value": "chart-update"
        },
        "display": "ChartUpdate graph (AI)"
      },
      "time": "2026-08-19T14:05:00Z",
      "text": "Found "type 2 diabetes" stated in today's encounter note, not present on the problem list. Suggested addition attached for review."
    }
  ]
}