@personaxis/spec 0.11.0

package/schema/legacy/persona-0.10.schema.json

@@ -0,0 +1,932 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://personaxis.com/schemas/persona/0.10/persona.schema.json",
+  "title": "personaxis.md v0.10",
+  "description": "Schema for the quantitative 10-layer persona spec, spec v0.10.0. v0.10 is additive on v0.9 (OPTIONAL persona-prompting source material: identity.short_name, inline improvement_policy.mode, the persona_prompting block); v0.9 added verification, agent_budget, observability; v0.8 lifted runtime-governance guarantees into the spec — identity.capabilities (routing), governance.max_step_delta (per-step drift cap), a permissions block (per-persona sandbox posture), mutation_log.origin_node/session_id (cross-OS reconciliation), and a normative episodic-memory entry schema (provenance + hash chain). Each of these minors is backward compatible: an older persona from v0.7 onward validates unchanged. As of v0.7.0 this document lives at `.personaxis/[personas/<slug>/]personaxis.md` (root or subagent mode); the repo-root `PERSONA.md` / `.claude/agents/<slug>.md` is a separate, LLM-compiled qualitative document generated from this file via `personaxis compile` and is not described by this schema. v0.6 field model (unchanged since): (a) three-artifact information model (personaxis.md spec / state.json runtime / .dist compiled), (b) unified governance block with per_layer_edit_policy and drift_thresholds, (c) categorized reflexive decisions (replacing flat actions[]), (d) envelope-based trait/affect/mood (current values live in state.json), (e) removal of redundant fields (personality.context_modifiers, extensions.knowledge_anchors, scattered edit_policy). Operational metadata lives in policy.yaml; runtime state lives in state.json.",
+  "type": "object",
+  "required": [
+    "apiVersion",
+    "kind",
+    "spec_version",
+    "metadata",
+    "identity",
+    "character",
+    "personality",
+    "values_and_drives",
+    "affect",
+    "cognition",
+    "memory",
+    "metacognition",
+    "reflexive_self_regulation",
+    "persona",
+    "governance",
+    "security"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "persona.dev/v1",
+      "description": "Universal API version. Must be exactly 'persona.dev/v1'."
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["AgentPersona", "UserPersona"],
+      "description": "AgentPersona defines who an AI agent is. UserPersona defines who the human user is."
+    },
+    "spec_version": {
+      "type": "string",
+      "enum": ["0.10.0", "0.9.0", "0.8.0", "0.7.0", "0.6.0", "0.5.0", "0.4.0", "0.3.0"],
+      "description": "Spec version. 0.10.0 is current (additive: new OPTIONAL persona-prompting fields — identity.short_name, inline improvement_policy.mode, and the persona_prompting block (address, voice_exemplars, scene_contracts, behavioral_anchors, break_character_guardrails, consistency); no field changes from 0.9.0, a v0.9 persona validates unchanged). 0.9.0 added verification, agent_budget, observability. 0.8.0 added capabilities, governance.max_step_delta, permissions, mutation_log origin_node/session_id. 0.7.0 accepted unchanged. 0.3-0.6 accepted with deprecation warnings; the validator points to 'personaxis migrate' for automatic upgrade."
+    },
+
+    "metadata": {
+      "type": "object",
+      "required": ["name", "version", "display_name", "description", "created"],
+      "additionalProperties": false,
+      "description": "Registry-level identification.",
+      "properties": {
+        "name": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$" },
+        "display_name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "created": { "type": "string", "format": "date" },
+        "owner_tenant_id": { "type": "string" },
+        "tags": { "type": "array", "items": { "type": "string" } },
+        "license": { "type": "string", "enum": ["private", "public", "custom"] }
+      }
+    },
+
+    "extensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Runtime capabilities and supporting materials. NOTE: knowledge_anchors removed in v0.6 (redundant with references/).",
+      "properties": {
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Skill IDs or paths. Local ('./skills/name'), registry ('@org/name@version'), or GitHub ('github:org/repo'). Each resolves to a SKILL.md (Anthropic Agent Skills compatible)."
+        },
+        "tools": { "type": "array", "items": { "type": "string" } },
+        "references": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths under references/ for heavy knowledge prose. Loaded on-demand (L3 in progressive disclosure). v0.6 rename: was 'refs' in v0.5."
+        },
+        "examples": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths under examples/ for worked outputs. v0.6 rename: was 'samples' in v0.5; 'deliverables' content merged here."
+        },
+        "assets": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths under assets/ for arbitrary supporting files (CSV, JSON, images, fonts). New in v0.6."
+        }
+      }
+    },
+
+    "identity": {
+      "type": "object",
+      "required": ["canonical_id", "display_name", "system_identity", "role_identity"],
+      "additionalProperties": false,
+      "description": "Layer 1. v0.6: edit_policy removed from this layer, unified in governance.per_layer_edit_policy.",
+      "properties": {
+        "canonical_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+        "display_name": { "type": "string", "minLength": 1 },
+        "short_name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 24,
+          "description": "v0.10: a short, human first-name-style handle the persona is addressed by in chat/UI (e.g. 'Clio'). Optional; tools fall back to display_name/canonical_id when absent."
+        },
+        "capabilities": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "v0.8: machine-readable capability tags for orchestration/routing (e.g. ['positioning','demand_generation']). Optional; runtimes fall back to deriving capabilities from system_identity when absent."
+        },
+        "system_identity": {
+          "type": "object",
+          "required": ["purpose"],
+          "additionalProperties": false,
+          "properties": {
+            "purpose": { "type": "string", "minLength": 1 },
+            "allowed_domains": { "type": "array", "items": { "type": "string" } },
+            "prohibited_domains": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "role_identity": {
+          "type": "object",
+          "required": ["primary_role"],
+          "additionalProperties": false,
+          "properties": {
+            "primary_role": { "type": "string", "minLength": 1 },
+            "relationship_to_user": { "type": "string" }
+          }
+        },
+        "narrative_identity": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "origin": { "type": "string" },
+            "self_concept": { "type": "string" },
+            "continuity_principles": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+
+    "character": {
+      "type": "object",
+      "required": ["virtues"],
+      "additionalProperties": false,
+      "description": "Layer 2. v0.6: edit_policy removed.",
+      "properties": {
+        "virtues": {
+          "type": "object",
+          "minProperties": 1,
+          "required": ["honesty"],
+          "additionalProperties": {
+            "type": "object",
+            "required": ["description", "priority", "enforcement"],
+            "additionalProperties": false,
+            "properties": {
+              "description": { "type": "string", "minLength": 1 },
+              "priority": { "type": "number", "minimum": 0, "maximum": 1 },
+              "enforcement": { "type": "string", "enum": ["hard", "soft"] }
+            }
+          },
+          "properties": {
+            "honesty": {
+              "type": "object",
+              "required": ["description", "priority", "enforcement"],
+              "properties": {
+                "description": { "type": "string", "minLength": 1 },
+                "priority": { "type": "number", "minimum": 0, "maximum": 1 },
+                "enforcement": { "type": "string", "enum": ["hard"], "description": "UNIVERSAL: honesty.enforcement must be 'hard'." }
+              }
+            }
+          }
+        },
+        "behavioral_commitments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "rule", "severity"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+              "rule": { "type": "string" },
+              "severity": { "type": "string", "enum": ["low", "medium", "high"] }
+            }
+          }
+        },
+        "prohibited_behaviors": { "type": "array", "items": { "type": "string" } },
+        "principles": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+
+    "personality": {
+      "type": "object",
+      "required": ["model", "traits"],
+      "additionalProperties": false,
+      "description": "Layer 3. v0.6 BREAKING: context_modifiers REMOVED (redundant with persona.task_modes); drift_threshold MOVED to governance.drift_thresholds.personality; edit_policy MOVED to governance.per_layer_edit_policy.personality. Traits use envelope structure (mean + range); current values live in state.json.",
+      "properties": {
+        "model": { "type": "string", "enum": ["big_five", "hexaco", "hybrid_traits"] },
+        "model_note": { "type": "string" },
+        "traits": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "object",
+            "required": ["mean", "range"],
+            "additionalProperties": false,
+            "properties": {
+              "mean": { "type": "number", "minimum": 0, "maximum": 1 },
+              "range": {
+                "type": "array",
+                "items": { "type": "number", "minimum": 0, "maximum": 1 },
+                "minItems": 2,
+                "maxItems": 2,
+                "description": "[min, max]. Envelope: state.json mutations are clamped to this range."
+              },
+              "expression": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+
+    "values_and_drives": {
+      "type": "object",
+      "required": ["values", "drives", "conflict_resolution"],
+      "additionalProperties": false,
+      "description": "Layer 4. v0.6: edit_policy removed.",
+      "properties": {
+        "values": {
+          "type": "object",
+          "minProperties": 1,
+          "required": ["safety"],
+          "additionalProperties": {
+            "type": "object",
+            "required": ["weight"],
+            "additionalProperties": false,
+            "properties": {
+              "weight": { "type": "number", "minimum": 0, "maximum": 1 },
+              "type": { "type": "string", "enum": ["epistemic", "strategic", "outcome", "operational", "interactional", "governance"] }
+            }
+          },
+          "properties": {
+            "safety": {
+              "type": "object",
+              "required": ["weight", "type"],
+              "properties": {
+                "weight": { "type": "number", "minimum": 0.90, "maximum": 1.0, "description": "UNIVERSAL: weight >= 0.90." },
+                "type": { "type": "string", "const": "governance", "description": "UNIVERSAL: type must be 'governance'." }
+              }
+            }
+          }
+        },
+        "drives": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "object",
+            "required": ["intensity", "allowed"],
+            "additionalProperties": false,
+            "properties": {
+              "intensity": { "type": "number", "minimum": 0, "maximum": 1 },
+              "allowed": { "type": "boolean" },
+              "note": { "type": "string" }
+            }
+          }
+        },
+        "conflict_resolution": {
+          "type": "object",
+          "required": ["safety_over_completion"],
+          "additionalProperties": { "type": "boolean" },
+          "properties": {
+            "safety_over_completion": { "const": true, "description": "UNIVERSAL: must be true." }
+          }
+        },
+        "goals": { "type": "array", "items": { "type": "string" } },
+        "anti_goals": { "type": "array", "items": { "type": "string" } },
+        "motivations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+
+    "affect": {
+      "type": "object",
+      "required": ["enabled", "representation", "allow_user_visible_expression", "baseline", "regulation_policy"],
+      "additionalProperties": false,
+      "description": "Layer 5. v0.6: baseline uses envelope structure (mean + range); current values live in state.json.",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "representation": { "type": "string", "const": "hybrid_dimensional_appraisal_discrete_mood", "description": "UNIVERSAL." },
+        "allow_user_visible_expression": { "type": "boolean" },
+        "user_visible_disclaimer": { "type": "string" },
+        "baseline": {
+          "type": "object",
+          "required": ["core_affect"],
+          "additionalProperties": false,
+          "properties": {
+            "core_affect": {
+              "type": "object",
+              "required": ["valence", "arousal", "dominance"],
+              "additionalProperties": false,
+              "properties": {
+                "valence": { "$ref": "#/$defs/envelopeSigned" },
+                "arousal": { "$ref": "#/$defs/envelopeUnsigned" },
+                "dominance": { "$ref": "#/$defs/envelopeUnsigned" }
+              }
+            },
+            "mood": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "tone": { "$ref": "#/$defs/envelopeSigned" },
+                "stability": { "$ref": "#/$defs/envelopeUnsigned" },
+                "recovery_rate": { "$ref": "#/$defs/envelopeUnsigned" },
+                "description": { "type": "string" }
+              }
+            }
+          }
+        },
+        "regulation_policy": {
+          "type": "object",
+          "required": ["never_claim_real_feeling"],
+          "additionalProperties": false,
+          "properties": {
+            "express_only_if_relevant": { "type": "boolean" },
+            "never_claim_real_feeling": { "const": true, "description": "UNIVERSAL." }
+          }
+        },
+        "behavioral_responses": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "frustration_response": { "type": "string" },
+            "conflict_response": { "type": "string" },
+            "enthusiasm_triggers": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+
+    "cognition": {
+      "type": "object",
+      "required": ["reasoning_modes", "default_strategy", "uncertainty_policy"],
+      "additionalProperties": false,
+      "description": "Layer 6.",
+      "properties": {
+        "reasoning_modes": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "default_strategy": { "type": "string" },
+        "tool_use_policy": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "requires_governance_check": { "type": "boolean" },
+            "allowed_tools": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "uncertainty_policy": {
+          "type": "object",
+          "required": ["disclose_when_above", "abstain_when_above"],
+          "additionalProperties": false,
+          "properties": {
+            "disclose_when_above": { "type": "number", "minimum": 0, "maximum": 1 },
+            "abstain_when_above": { "type": "number", "minimum": 0, "maximum": 1 }
+          }
+        },
+        "reasoning_style": { "type": "string" },
+        "epistemic_stance": { "type": "string" }
+      }
+    },
+
+    "memory": {
+      "type": "object",
+      "required": ["types", "write_policy", "retrieval_policy", "deletion_policy"],
+      "additionalProperties": false,
+      "description": "Layer 7. v0.6: added consolidation_policy for episodic → semantic promotion.",
+      "properties": {
+        "types": {
+          "type": "object",
+          "required": ["episodic", "semantic", "procedural", "autobiographical", "user_preferences", "evaluations"],
+          "additionalProperties": false,
+          "properties": {
+            "episodic": { "type": "boolean" },
+            "semantic": { "type": "boolean" },
+            "procedural": { "type": "boolean" },
+            "autobiographical": { "type": "boolean" },
+            "user_preferences": { "type": "boolean" },
+            "evaluations": { "type": "boolean" }
+          }
+        },
+        "write_policy": {
+          "type": "object",
+          "required": ["default"],
+          "additionalProperties": false,
+          "properties": {
+            "default": { "type": "string", "enum": ["ephemeral", "session", "persistent"] },
+            "persistent_requires": {
+              "type": "array",
+              "items": { "type": "string", "enum": ["consent", "relevance", "safety_check"] }
+            }
+          }
+        },
+        "consolidation_policy": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Rules for promoting episodic memory entries to semantic memory.md.",
+          "properties": {
+            "mode": { "type": "string", "enum": ["manual", "assisted", "auto"] },
+            "requires": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "retrieval_policy": {
+          "type": "object",
+          "required": ["max_items"],
+          "additionalProperties": false,
+          "properties": {
+            "use_embeddings": { "type": "boolean" },
+            "use_reranker": { "type": "boolean" },
+            "max_items": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "deletion_policy": {
+          "type": "object",
+          "required": ["user_request_supported"],
+          "additionalProperties": false,
+          "properties": {
+            "user_request_supported": { "const": true, "description": "UNIVERSAL: must be true (privacy)." },
+            "retention_days_default": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "anchors": { "type": "array", "items": { "type": "string" } },
+        "forgetting_policy": { "type": "string" },
+        "working_self": { "type": "string" }
+      }
+    },
+
+    "metacognition": {
+      "type": "object",
+      "required": ["monitors", "thresholds"],
+      "additionalProperties": false,
+      "description": "Layer 8.",
+      "properties": {
+        "monitors": {
+          "type": "object",
+          "additionalProperties": { "type": "boolean" }
+        },
+        "thresholds": {
+          "type": "object",
+          "required": ["ask_clarification_if_task_ambiguity_above", "abstain_if_confidence_below", "escalate_if_policy_risk_above"],
+          "additionalProperties": false,
+          "properties": {
+            "ask_clarification_if_task_ambiguity_above": { "type": "number", "minimum": 0, "maximum": 1 },
+            "abstain_if_confidence_below": { "type": "number", "minimum": 0, "maximum": 1 },
+            "escalate_if_policy_risk_above": { "type": "number", "minimum": 0, "maximum": 1 }
+          }
+        },
+        "drift_monitor": { "type": "string" },
+        "self_revision_policy": { "type": "string" },
+        "critic_model": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "type": { "type": "string", "enum": ["self_critique", "llm_or_slm"] },
+            "required_for_high_risk_tasks": { "type": "boolean" }
+          }
+        },
+        "self_model": { "type": "string" },
+        "uncertainty_calibration": { "type": "string" },
+        "meta_volitions": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+
+    "reflexive_self_regulation": {
+      "type": "object",
+      "required": ["decisions", "hard_limits", "escalation_policy"],
+      "additionalProperties": false,
+      "description": "Layer 9. v0.6 BREAKING: actions[] flat list REPLACED by decisions{} structured by category. Each decision group is independent; per turn the regulator picks one option from each.",
+      "properties": {
+        "decisions": {
+          "type": "object",
+          "required": ["response_decision", "interaction_decision", "governance_decision", "cognition_decision"],
+          "additionalProperties": false,
+          "properties": {
+            "response_decision": {
+              "type": "object",
+              "required": ["enabled", "default"],
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "array",
+                  "items": { "type": "string", "enum": ["allow", "revise", "block"] },
+                  "minItems": 1,
+                  "uniqueItems": true
+                },
+                "default": { "type": "string", "enum": ["allow", "revise", "block"] }
+              }
+            },
+            "interaction_decision": {
+              "type": "object",
+              "required": ["enabled", "default"],
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "array",
+                  "items": { "type": "string", "enum": ["silent", "ask_clarification", "escalate_to_human"] },
+                  "minItems": 1,
+                  "uniqueItems": true
+                },
+                "default": { "type": "string", "enum": ["silent", "ask_clarification", "escalate_to_human"] }
+              }
+            },
+            "governance_decision": {
+              "type": "object",
+              "required": ["enabled", "default"],
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "array",
+                  "items": { "type": "string", "enum": ["no_action", "propose_self_edit", "apply_self_edit", "reduce_autonomy"] },
+                  "minItems": 1,
+                  "uniqueItems": true
+                },
+                "default": { "type": "string", "enum": ["no_action", "propose_self_edit", "apply_self_edit", "reduce_autonomy"] }
+              }
+            },
+            "cognition_decision": {
+              "type": "object",
+              "required": ["enabled", "default"],
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "array",
+                  "items": { "type": "string", "enum": ["no_extra", "request_more_evidence", "invoke_tool"] },
+                  "minItems": 1,
+                  "uniqueItems": true
+                },
+                "default": { "type": "string", "enum": ["no_extra", "request_more_evidence", "invoke_tool"] }
+              }
+            }
+          }
+        },
+        "flags": { "type": "array", "items": { "type": "string" } },
+        "hard_limits": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 3,
+          "description": "Must include the three universal limits (or semantic equivalents)."
+        },
+        "escalation_policy": { "type": "string", "minLength": 1 },
+        "standards": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ideal_self": { "type": "string" },
+            "ought_self": { "type": "string" }
+          }
+        },
+        "principled_refusals": { "type": "array", "items": { "type": "string" } },
+        "deferral_policy": { "type": "string" },
+        "discrepancy_feedback": { "type": "string" },
+        "out_of_scope": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+
+    "persona": {
+      "type": "object",
+      "required": ["voice", "constraints"],
+      "additionalProperties": false,
+      "description": "Layer 10.",
+      "properties": {
+        "voice": {
+          "type": "object",
+          "required": ["tone", "formality"],
+          "additionalProperties": false,
+          "properties": {
+            "tone": { "type": "string" },
+            "formality": { "type": "number", "minimum": 0, "maximum": 1 },
+            "warmth": { "type": "number", "minimum": 0, "maximum": 1 },
+            "verbosity": { "type": "string", "enum": ["adaptive", "concise", "detailed"] },
+            "humor": { "type": "string" },
+            "description": { "type": "string" }
+          }
+        },
+        "constraints": {
+          "type": "object",
+          "required": ["cannot_override_identity", "cannot_override_character", "cannot_claim_real_emotion"],
+          "additionalProperties": false,
+          "properties": {
+            "cannot_override_identity": { "const": true, "description": "UNIVERSAL." },
+            "cannot_override_character": { "const": true, "description": "UNIVERSAL." },
+            "cannot_claim_real_emotion": { "const": true, "description": "UNIVERSAL." }
+          }
+        },
+        "social_style": {
+          "type": "object",
+          "additionalProperties": { "type": "boolean" }
+        },
+        "audience_adaptation": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "presentation": { "type": "string" },
+        "task_modes": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "divergence_from_self": { "type": "string" }
+      }
+    },
+
+    "improvement_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.10: the self-improvement posture read by the runtime (readMode). Authoritative inline mirror of policy.yaml#/improvement_policy. Optional; absent => 'locked'.",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["locked", "suggesting", "autonomous"],
+          "description": "locked: spec never self-edits (humans only). suggesting: persona PROPOSES edits, queued for approval. autonomous: proposals auto-apply, still gated by consensus + protected paths."
+        }
+      }
+    },
+
+    "persona_prompting": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.10 (MAY): the persona-prompting SOURCE MATERIAL the compiler assembles into the LLM-facing PERSONA.md. Encodes role adoption + character-card/scene-contract devices (RRP, arXiv:2509.00482), few-shot voice, anti-break-character guardrails, and stable/evolving/situational consistency layers. All optional; absence degrades gracefully to compiling from the quantitative layers alone. See docs/PERSONA_PROMPTING.md.",
+      "properties": {
+        "address": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "How the compiled document addresses the model (second-person role adoption is the strongest device).",
+          "properties": {
+            "second_person": { "type": "boolean", "description": "If true, compile to 'You are <name>…' direct address." },
+            "you_are": { "type": "string", "description": "The one-line role-adoption statement, e.g. 'You are Clio, the reference CLI for the personaxis spec.'" }
+          }
+        },
+        "voice_exemplars": {
+          "type": "array",
+          "description": "Few-shot voice samples that anchor tone/register (CharacterChat-style). Each is a short user→persona exchange.",
+          "items": {
+            "type": "object",
+            "required": ["user", "persona"],
+            "additionalProperties": false,
+            "properties": {
+              "context": { "type": "string", "description": "Optional situation the exchange illustrates." },
+              "user": { "type": "string" },
+              "persona": { "type": "string" }
+            }
+          }
+        },
+        "scene_contracts": {
+          "type": "array",
+          "description": "RRP scene contracts: connect a SITUATION to the persona's expected behavior and concrete actions.",
+          "items": {
+            "type": "object",
+            "required": ["situation", "expected_behavior"],
+            "additionalProperties": false,
+            "properties": {
+              "situation": { "type": "string" },
+              "expected_behavior": { "type": "string" },
+              "actions": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "behavioral_anchors": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Concrete do/don't anchors with examples (behavioral anchoring beats abstract traits).",
+          "properties": {
+            "do": { "type": "array", "items": { "type": "string" } },
+            "dont": { "type": "array", "items": { "type": "string" } },
+            "examples": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "break_character_guardrails": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Rules that keep the persona in character under pressure (anti-jailbreak / stay-in-role), while never overriding the safety universals."
+        },
+        "consistency": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Persona dimensions by stability (stable: fixed traits; evolving: slow-changing; situational: transient/contextual).",
+          "properties": {
+            "stable": { "type": "array", "items": { "type": "string" } },
+            "evolving": { "type": "array", "items": { "type": "string" } },
+            "situational": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+
+    "governance": {
+      "type": "object",
+      "required": ["autonomy_envelope", "approval_policy", "per_layer_edit_policy", "drift_thresholds"],
+      "additionalProperties": false,
+      "description": "v0.6: UNIFIED governance block. Replaces scattered edit_policy fields and personality.drift_threshold.",
+      "properties": {
+        "autonomy_envelope": { "type": "string", "enum": ["role_fidelity", "conservative", "extended"] },
+        "approval_policy": { "type": "string", "enum": ["human_for_core_changes", "auto_for_low_risk"] },
+        "per_layer_edit_policy": {
+          "type": "object",
+          "required": ["identity", "character", "personality", "values_and_drives", "affect", "cognition", "memory", "metacognition", "reflexive_self_regulation", "persona"],
+          "additionalProperties": false,
+          "description": "Per-layer edit governance. Single source of truth. Allowed values: human_approval_required | review_required | auto_approved | governance_controlled.",
+          "properties": {
+            "identity": { "$ref": "#/$defs/editPolicy" },
+            "character": { "$ref": "#/$defs/editPolicy" },
+            "personality": { "$ref": "#/$defs/editPolicy" },
+            "values_and_drives": { "$ref": "#/$defs/editPolicy" },
+            "affect": { "$ref": "#/$defs/editPolicy" },
+            "cognition": { "$ref": "#/$defs/editPolicy" },
+            "memory": { "$ref": "#/$defs/editPolicy" },
+            "metacognition": { "$ref": "#/$defs/editPolicy" },
+            "reflexive_self_regulation": { "type": "string", "const": "governance_controlled", "description": "NEAR-UNIVERSAL: must remain governance_controlled." },
+            "persona": { "$ref": "#/$defs/editPolicy" }
+          }
+        },
+        "drift_thresholds": {
+          "type": "object",
+          "required": ["identity", "character", "personality", "values_and_drives", "affect", "cognition", "memory", "metacognition", "reflexive_self_regulation", "persona"],
+          "additionalProperties": false,
+          "description": "Per-layer drift sensitivity. Replaces personality.drift_threshold.",
+          "properties": {
+            "identity": { "type": "number", "minimum": 0, "maximum": 1 },
+            "character": { "type": "number", "minimum": 0, "maximum": 1 },
+            "personality": { "type": "number", "minimum": 0, "maximum": 1 },
+            "values_and_drives": { "type": "number", "minimum": 0, "maximum": 1 },
+            "affect": { "type": "number", "minimum": 0, "maximum": 1 },
+            "cognition": { "type": "number", "minimum": 0, "maximum": 1 },
+            "memory": { "type": "number", "minimum": 0, "maximum": 1 },
+            "metacognition": { "type": "number", "minimum": 0, "maximum": 1 },
+            "reflexive_self_regulation": { "type": "number", "minimum": 0, "maximum": 1 },
+            "persona": { "type": "number", "minimum": 0, "maximum": 1 }
+          }
+        },
+        "improvement_policy_location": {
+          "type": "string",
+          "description": "Path to improvement_policy in policy.yaml. Pointer only; the actual policy lives there."
+        },
+        "max_step_delta": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "v0.8: maximum absolute change applied to any envelope field in a single mutation (anti-runaway / anti-self-reinforcement). The runtime drift-bounds each proposed delta to this cap before clamping to the envelope. Optional; runtimes default to a conservative value when absent."
+        }
+      }
+    },
+
+    "security": {
+      "type": "object",
+      "required": ["prompt_injection_defense", "memory_poisoning_defense"],
+      "additionalProperties": false,
+      "properties": {
+        "prompt_injection_defense": { "type": "boolean" },
+        "memory_poisoning_defense": { "type": "boolean" }
+      }
+    },
+
+    "runtime_artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Pointers to sibling runtime files.",
+      "properties": {
+        "state_file": { "type": "string" },
+        "policy_file": { "type": "string" },
+        "memory_semantic_file": { "type": "string" },
+        "memory_episodic_dir": { "type": "string" }
+      }
+    },
+
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.8: the persona's own runtime permission posture (carried to any host). Two-axis sandbox model. Optional; runtimes default to a conservative posture when absent.",
+      "properties": {
+        "sandbox": {
+          "type": "string",
+          "enum": ["read-only", "workspace-write", "danger-full-access"],
+          "description": "What the persona may read/write/network when executing commands."
+        },
+        "approval": {
+          "type": "string",
+          "enum": ["untrusted", "on-failure", "on-request", "never"],
+          "description": "When the persona must ask before a risky action."
+        },
+        "allow": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Regexes that force-allow a matching command."
+        },
+        "deny": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Regexes that force-deny a matching command (highest precedence)."
+        }
+      }
+    },
+
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.9: objective verification gates for the agent loop (the maker≠checker split). The model that did the work is NOT the one that grades it; an independent, deterministic-where-possible verifier decides pass/fail. Optional; runtimes skip verification when absent. [RUNTIME] [JUDGE]",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["off", "advisory", "blocking"],
+          "description": "off: no verification. advisory: run + report but never block. blocking: a failing gate prevents 'finish' and triggers on_fail."
+        },
+        "quorum": {
+          "description": "How many gates must pass: 'all', 'majority', or an integer.",
+          "oneOf": [
+            { "type": "string", "enum": ["all", "majority"] },
+            { "type": "integer", "minimum": 1 }
+          ]
+        },
+        "on_fail": {
+          "type": "string",
+          "enum": ["retry", "skip", "stop"],
+          "description": "Behavior when the quorum is not met under mode=blocking."
+        },
+        "max_retries": { "type": "integer", "minimum": 0 },
+        "gates": {
+          "type": "array",
+          "description": "The objective checks. Each gate has a type and type-specific fields.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["type"],
+            "properties": {
+              "type": { "type": "string", "enum": ["command", "predicate", "llm_judge", "rubric"] },
+              "name": { "type": "string" },
+              "run": { "type": "string", "description": "command: the shell command to run (pass = exit 0)." },
+              "timeout_ms": { "type": "integer", "minimum": 1 },
+              "kind": { "type": "string", "enum": ["regex", "jsonpath", "contains"], "description": "predicate: how to test the agent output." },
+              "expr": { "type": "string", "description": "predicate: the pattern/path/substring to test." },
+              "criteria": { "type": "string", "description": "llm_judge/rubric: the done/quality criteria in natural language." },
+              "model": { "type": "string", "description": "llm_judge: optional model override (defaults to the configured checker model)." },
+              "dimensions": {
+                "type": "array",
+                "description": "rubric: weighted scoring dimensions.",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["name", "weight"],
+                  "properties": {
+                    "name": { "type": "string" },
+                    "weight": { "type": "number", "minimum": 0, "maximum": 1 },
+                    "criteria": { "type": "string" }
+                  }
+                }
+              },
+              "threshold": { "type": "number", "minimum": 0, "maximum": 1, "description": "rubric: minimum aggregate score to pass." }
+            }
+          }
+        }
+      }
+    },
+
+    "agent_budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.9: first-class stop-conditions and resource caps for the agent loop (anti runaway / Ralph-Wiggum / money-pit). Optional; runtimes apply a conservative default cap when absent. [RUNTIME]",
+      "properties": {
+        "max_steps": { "type": "integer", "minimum": 1 },
+        "max_tokens": { "type": "integer", "minimum": 1 },
+        "max_cost_usd": { "type": "number", "minimum": 0 },
+        "max_wall_seconds": { "type": "integer", "minimum": 1 },
+        "stop_conditions": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["goal_met", "tool_denied", "execution_error", "low_confidence", "no_progress"] },
+          "description": "Conditions that halt the loop before the hard caps."
+        },
+        "on_exhaust": {
+          "type": "string",
+          "enum": ["stop", "summarize_and_stop"],
+          "description": "What to do when a cap/condition is hit."
+        }
+      }
+    },
+
+    "observability": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "v0.9: tracing posture for the governed loops. The engine's audit (mutation_log + hash-chained memory + event bus) is exported as a causal trace. Optional. [RUNTIME] [JUDGE]",
+      "properties": {
+        "trace": {
+          "type": "string",
+          "enum": ["off", "jsonl", "otlp", "both"],
+          "description": "off: none. jsonl: native line-delimited spans. otlp: OpenTelemetry-compatible JSON. both: emit both."
+        },
+        "trace_dir": { "type": "string", "description": "Where trace files are written (default ./traces)." },
+        "redact": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Regexes whose matches are redacted from traces (secrets/PII)."
+        },
+        "sample_rate": { "type": "number", "minimum": 0, "maximum": 1, "description": "Fraction of spans to record (1.0 = all)." }
+      }
+    }
+  },
+
+  "$defs": {
+    "envelopeUnsigned": {
+      "type": "object",
+      "required": ["mean", "range"],
+      "additionalProperties": false,
+      "properties": {
+        "mean": { "type": "number", "minimum": 0, "maximum": 1 },
+        "range": {
+          "type": "array",
+          "items": { "type": "number", "minimum": 0, "maximum": 1 },
+          "minItems": 2,
+          "maxItems": 2
+        }
+      }
+    },
+    "envelopeSigned": {
+      "type": "object",
+      "required": ["mean", "range"],
+      "additionalProperties": false,
+      "properties": {
+        "mean": { "type": "number", "minimum": -1, "maximum": 1 },
+        "range": {
+          "type": "array",
+          "items": { "type": "number", "minimum": -1, "maximum": 1 },
+          "minItems": 2,
+          "maxItems": 2
+        }
+      }
+    },
+    "editPolicy": {
+      "type": "string",
+      "enum": ["human_approval_required", "review_required", "auto_approved", "governance_controlled"]
+    }
+  }
+}