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.

level: 4
version: "2.0.0"

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

# DMN decisions are evaluated by the runtime itself — no host capability.
provides_decisions:
  - assess-personal-data-risk
  - gdpr-processing-route
  - human-validation-gate

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

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