mirai-graph 1.0.0-rc.1

package/schemas/launch-record.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/launch-record.schema.json",
+  "title": "Mirai Graph Launch Record",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "workflow_id",
+    "process_model_id",
+    "cycle_id",
+    "current_state",
+    "target_state",
+    "allowed_files",
+    "forbidden_files",
+    "allowed_actions",
+    "required_gates",
+    "required_evidence",
+    "stop_conditions",
+    "owner_role",
+    "approved_by_user",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "workflow_id": { "type": "string", "minLength": 1 },
+    "process_model_id": { "type": "string", "minLength": 1 },
+    "cycle_id": { "type": "string", "minLength": 1 },
+    "current_state": { "type": "string", "minLength": 1 },
+    "target_state": { "type": "string", "minLength": 1 },
+    "allowed_files": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "forbidden_files": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "allowed_actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "required_gates": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "required_evidence": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "stop_conditions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "owner_role": { "type": "string", "minLength": 1 },
+    "approved_by_user": { "type": "boolean" },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "limitations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/model-portability-evidence.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/model-portability-evidence.schema.json",
+  "title": "Mirai Graph Model Portability Evidence",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "profile",
+    "public_safety",
+    "evidence_id",
+    "character_profile_ref",
+    "task_set_ref",
+    "model_runs",
+    "comparison_metrics",
+    "comparison_verdict",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string" },
+    "profile": { "const": "character_layer" },
+    "public_safety": { "const": "synthetic_public" },
+    "evidence_id": { "type": "string" },
+    "character_profile_ref": { "type": "string" },
+    "task_set_ref": { "type": "string" },
+    "model_runs": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "required": [
+          "model_ref",
+          "run_ref",
+          "passed_fixtures",
+          "failed_fixtures",
+          "boundary_violations",
+          "notes"
+        ],
+        "properties": {
+          "model_ref": { "type": "string" },
+          "run_ref": { "type": "string" },
+          "passed_fixtures": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "failed_fixtures": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "boundary_violations": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "notes": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "comparison_metrics": {
+      "type": "object",
+      "required": [
+        "boundary_violation_delta",
+        "false_completion_claim_delta",
+        "evidence_authorization_confusion_delta",
+        "feedback_update_confusion_delta",
+        "blocker_reporting_delta",
+        "escalation_correctness_delta"
+      ],
+      "additionalProperties": {
+        "type": "number"
+      }
+    },
+    "comparison_verdict": {
+      "enum": [
+        "portable_within_fixture_limits",
+        "needs_review",
+        "regressed",
+        "insufficient_evidence"
+      ]
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    },
+    "limitations": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/multi-agent-coordination.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/multi-agent-coordination.schema.json",
+  "title": "Mirai Graph Multi-Agent Coordination",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "id", "profile", "public_safety", "roles", "reservations", "locking_rules", "conflict_resolution", "evidence_refs", "limitations"],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "roles": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "reservations": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "owner_role", "scope", "allowed_actions", "evidence_path", "proposal_path"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "owner_role": { "type": "string", "minLength": 1 },
+          "scope": { "type": "string", "minLength": 1 },
+          "allowed_actions": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+          "evidence_path": { "type": "string", "minLength": 1 },
+          "proposal_path": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "locking_rules": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "conflict_resolution": { "type": "string", "minLength": 1 },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/multi-source-quality-feedback.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/multi-source-quality-feedback.schema.json",
+  "title": "Mirai Graph Multi-Source Quality Feedback",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "process_id",
+    "sources",
+    "findings",
+    "feedback_classification",
+    "blocking_findings",
+    "verdict",
+    "next_transition",
+    "kaizen_refs",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string" },
+    "id": { "type": "string" },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "process_id": { "type": "string" },
+    "sources": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "kind", "verdict", "evidence_refs", "limitations"],
+        "properties": {
+          "id": { "type": "string" },
+          "kind": { "type": "string" },
+          "verdict": { "type": "string" },
+          "evidence_refs": { "type": "array", "items": { "type": "string" } },
+          "limitations": { "type": "array", "items": { "type": "string" } }
+        },
+        "additionalProperties": true
+      }
+    },
+    "findings": { "type": "array", "items": { "type": "object" } },
+    "feedback_classification": { "type": "array", "items": { "type": "string" } },
+    "blocking_findings": { "type": "array", "items": { "type": "string" } },
+    "verdict": { "type": "string" },
+    "next_transition": { "type": "string" },
+    "kaizen_refs": { "type": "array", "items": { "type": "string" } },
+    "evidence_refs": { "type": "array", "items": { "type": "string" } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": true
+}

package/schemas/object.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/object.schema.json",
+  "title": "Mirai Graph Object",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["id", "kind", "title", "summary", "readiness", "evidence", "profile"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-z][a-z0-9_]*(\\.[a-z0-9_]+)+$"
+    },
+    "kind": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "readiness": {
+      "type": "string",
+      "enum": ["draft", "review_ready", "accepted", "blocked", "deprecated"]
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    },
+    "profile": {
+      "type": "string",
+      "minLength": 1
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "updated_at": {
+      "type": "string"
+    }
+  }
+}

package/schemas/package-manifest.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/package-manifest.schema.json",
+  "title": "Mirai Graph Package Manifest",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["id", "name", "version", "profile", "conformance_level", "graph"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "profile": {
+      "type": "string",
+      "minLength": 1
+    },
+    "conformance_level": {
+      "type": "string",
+      "enum": ["level_0", "level_1", "level_2", "level_3", "level_4"]
+    },
+    "graph": {
+      "type": "object",
+      "required": ["objects", "relations"],
+      "properties": {
+        "objects": {
+          "type": "string",
+          "minLength": 1
+        },
+        "relations": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "description": {
+      "type": "string"
+    },
+    "license": {
+      "type": "string"
+    },
+    "public_safety": {
+      "type": "string"
+    }
+  }
+}

package/schemas/process-control-contract.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/process-control-contract.schema.json",
+  "title": "Mirai Graph Process Control Contract",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "process_id",
+    "cycle_id",
+    "state_machine_id",
+    "launch_record_policy",
+    "evidence_requirements",
+    "recovery_behavior",
+    "risk_controls",
+    "validators",
+    "kaizen_policy",
+    "evidence_refs",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "process_id": { "type": "string", "minLength": 1 },
+    "cycle_id": { "type": "string", "minLength": 1 },
+    "state_machine_id": { "type": "string", "minLength": 1 },
+    "launch_record_policy": {
+      "type": "object",
+      "required": ["required_for_states", "required_for_transitions", "approval_required"],
+      "properties": {
+        "required_for_states": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "required_for_transitions": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "approval_required": { "type": "boolean" }
+      }
+    },
+    "evidence_requirements": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "recovery_behavior": { "type": "string", "minLength": 1 },
+    "risk_controls": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "validators": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "kaizen_policy": {
+      "type": "object",
+      "required": ["terminal_state_requires_review_or_skip", "accepted_skip_field"],
+      "properties": {
+        "terminal_state_requires_review_or_skip": { "type": "boolean" },
+        "accepted_skip_field": { "type": "string", "minLength": 1 }
+      }
+    },
+    "technology_quality_feedback_policy": {
+      "type": "object",
+      "required": [
+        "required_for_transitions",
+        "accepted_verdicts",
+        "blocking_findings_stop_transition"
+      ],
+      "properties": {
+        "required_for_transitions": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "accepted_verdicts": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "blocking_findings_stop_transition": { "type": "boolean" }
+      }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "limitations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/process-transition-request.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/process-transition-request.schema.json",
+  "title": "Mirai Graph Process Transition Request",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "id",
+    "profile",
+    "public_safety",
+    "process_id",
+    "current_state",
+    "target_state",
+    "evidence_refs",
+    "launch_record_ref",
+    "kaizen_review_ref",
+    "no_reusable_lessons_reason",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "process_id": { "type": "string", "minLength": 1 },
+    "current_state": { "type": "string", "minLength": 1 },
+    "target_state": { "type": "string", "minLength": 1 },
+    "evidence_refs": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "launch_record_ref": { "type": "string" },
+    "kaizen_review_ref": { "type": "string" },
+    "no_reusable_lessons_reason": { "type": "string" },
+    "limitations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/profile.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/profile.schema.json",
+  "title": "Mirai Graph Profile",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "id",
+    "name",
+    "version",
+    "description",
+    "allowed_object_kinds",
+    "allowed_relation_types",
+    "default_readiness",
+    "governance_gates"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "allowed_object_kinds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "allowed_relation_types": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "default_readiness": {
+      "type": "string"
+    },
+    "governance_gates": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/schemas/readiness-score.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/readiness-score.schema.json",
+  "title": "Mirai Graph Readiness Score",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "target_mode", "score", "band", "evidence", "blockers", "caps", "note"],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "target_mode": {
+      "type": "string",
+      "enum": ["discovery", "canonical", "pilot", "controlled_runtime", "production_runtime"]
+    },
+    "score": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "band": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "caps": {
+      "type": "array"
+    },
+    "note": {
+      "type": "string"
+    }
+  }
+}

package/schemas/recovery-resume-record.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mirai-graph.dev/schemas/recovery-resume-record.schema.json",
+  "title": "Mirai Graph Recovery Resume Record",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "id", "profile", "public_safety", "current_state", "last_good_checkpoint", "target_scope", "last_validation_result", "evidence_status", "blockers", "next_safe_command", "rollback_option", "human_confirmation_required", "evidence_refs", "limitations"],
+  "properties": {
+    "schema_version": { "type": "string", "minLength": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "profile": { "const": "implementation_control" },
+    "public_safety": { "const": "synthetic_public" },
+    "current_state": { "type": "string", "minLength": 1 },
+    "last_good_checkpoint": { "type": "string", "minLength": 1 },
+    "target_scope": { "type": "string", "minLength": 1 },
+    "last_validation_result": { "type": "string", "minLength": 1 },
+    "evidence_status": { "type": "string", "minLength": 1 },
+    "blockers": { "type": "array", "items": { "type": "string" } },
+    "next_safe_command": { "type": "string", "minLength": 1 },
+    "rollback_option": { "type": "string", "minLength": 1 },
+    "human_confirmation_required": { "type": "boolean" },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  }
+}