kind: uapf.package
id: dev.uapf.semantic-document-analysis
name: Semantic Document Analysis
description: |
  Level-4 UAPF process for semantic analysis of free-text documents.

  Three BPMN service tasks invoke the UAPF-IP capabilities ai.redact@1,
  ai.extract@1 and event.emit@1. Three DMN decision tables encode the
  deterministic algorithm the host previously hid inside application
  code: assess-personal-data-risk maps PII regex signals to a risk
  level; gdpr-processing-route selects CENTRAL vs LOCAL processing,
  anonymisation and redaction level; human-validation-gate applies the
  confidence thresholds that decide REJECTED / PENDING_REVIEW /
  APPROVED_AUTO.

  Only the semantic extraction is a model step. Risk classification,
  GDPR routing and the validation gate are explicit ranked rules in
  versioned DMN — inspectable, auditable, portable. Extraction output
  validates against the VDVC v1.1 semantic-summary JSON Schema.

  v3.1.0: aligned with UAPF v2.4.0 — Algorithm Card references move
  from resource targets to the BPMN service tasks themselves (via
  uapf24:algorithmCardRef attribute). Each card's io block is also
  denormalised into a <bpmn:ioSpecification> on the task so inputs
  and outputs render as visible data objects on the diagram. The
  cards themselves and the DMN decisions are unchanged from v3.0.0.

level: 4
version: "3.2.0"

# ── UAPF-IP integration (capability needs + profile + guardrails) ──
requires_capabilities:
  - ai.redact@1+
  - ai.extract@1+
  - event.emit@1+

profiles_supported:
  - uapf-ip-orchestrated

guardrails: resources/guardrails.yaml

includes: []
dependencies: {}

cornerstones:
  bpmn: true
  dmn: true
  cmmn: false
  resources: true

paths:
  bpmn: bpmn
  dmn: dmn
  cmmn: cmmn
  resources: resources
  metadata: metadata
  algorithms: algorithms

algorithm_cards: true

exposure:
  mcp:
    enabled: true
    runnable: true
    exposedEntrypoints:
      - "Process_SemanticDocumentAnalysis"
    exposedArtifacts:
      - manifest
      - bpmn
      - dmn
      - docs

owners:
  - type: team
    id: uapf-stewards
    contact: stewards@uapf.dev

lifecycle: draft