(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
User State Directive (PGM-USD)
- Is produced by A-User Control (PGM-AUC) to guide refinement of the User State.
- Represents a structured instruction to the User State Refinement AIM to update engagement, affective tone, and disposition based on interaction feedback.
- Includes modulation cues, semantic alignment, override flags, and trace metadata to support state refinement.
Functional Requirements
| Function | Description |
| Engagement Cue | Indicates the inferred cognitive engagement level. |
| Affective Tone Cue | Suggests the emotional tone derived from interaction. |
| Disposition Cue | Captures inferred attitude or stance. |
| Semantic Alignment | Confirms whether the Enhanced Response aligns with user expectations. |
| Override Flags | Allows forced modulation or fallback disposition. |
| Trace Metadata | Provides provenance for auditability and control lineage. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/UserStateDirective.json
Semantics
| Label | Description |
| Header | User State Directive Header |
| – Standard-USD | The characters “PGM-USD-V” indicating schema family and type |
| – Version | Major version – 1 or 2 characters |
| – Dot-separator | The character “.” separating version components |
| – Subversion | Minor version – 1 or 2 characters |
| DirectiveID | Unique identifier for this User State Directive instance |
| EngagementCue | Inferred cognitive engagement level (low, moderate, high) |
| AffectiveToneCue | Emotional tone derived from interaction (neutral, positive, negative, mixed) |
| DispositionCue | Inferred attitude or stance |
| SemanticAlignment | Whether Enhanced Response aligns with user expectations |
| OverrideFlags | Modulation override controls |
| – ForceDisposition | Whether to force disposition override |
| – FallbackDisposition | Fallback disposition if override fails |
| Trace | Provenance metadata for User State Directive |
| – Origin | Module or subsystem that issued the directive |
| – Timestamp | Time of directive creation |