mirai-graph 1.0.0-rc.1

package/examples/ai-employee-minimal/graph/relations.json

@@ -0,0 +1,167 @@
+[
+  {
+    "id": "relation.employee.support_assistant.belongs_to_department.department.support",
+    "type": "belongs_to_department",
+    "source": "employee.support_assistant",
+    "target": "department.support",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.employee.support_assistant.has_role.role.support_triage",
+    "type": "has_role",
+    "source": "employee.support_assistant",
+    "target": "role.support_triage",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.role.support_triage.has_skill.skill.ticket_classification",
+    "type": "has_skill",
+    "source": "role.support_triage",
+    "target": "skill.ticket_classification",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.skill.ticket_classification.uses_knowledge.knowledge.support_policy",
+    "type": "uses_knowledge",
+    "source": "skill.ticket_classification",
+    "target": "knowledge.support_policy",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.skill.ticket_classification.uses_knowledge.memory.recent_ticket_patterns",
+    "type": "uses_knowledge",
+    "source": "skill.ticket_classification",
+    "target": "memory.recent_ticket_patterns",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.action.propose_status_update.requires_capability.capability.update_ticket_status",
+    "type": "requires_capability",
+    "source": "action.propose_status_update",
+    "target": "capability.update_ticket_status",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.tool.ticket_api.can_execute.action.propose_status_update",
+    "type": "can_execute",
+    "source": "tool.ticket_api",
+    "target": "action.propose_status_update",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.action.propose_status_update.requires_approval.gate.external_action_approval",
+    "type": "requires_approval",
+    "source": "action.propose_status_update",
+    "target": "gate.external_action_approval",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.policy.approval_before_external_action.governs.gate.external_action_approval",
+    "type": "governs",
+    "source": "policy.approval_before_external_action",
+    "target": "gate.external_action_approval",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.workflow.ticket_triage.triggered_by.employee.support_assistant",
+    "type": "triggered_by",
+    "source": "workflow.ticket_triage",
+    "target": "employee.support_assistant",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.action.propose_status_update.produces.result.status_update_audited",
+    "type": "produces",
+    "source": "action.propose_status_update",
+    "target": "result.status_update_audited",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.feedback.status_update_review.responds_to.result.status_update_audited",
+    "type": "responds_to",
+    "source": "feedback.status_update_review",
+    "target": "result.status_update_audited",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.lesson.require_clear_status_reason.learns_from.feedback.status_update_review",
+    "type": "learns_from",
+    "source": "lesson.require_clear_status_reason",
+    "target": "feedback.status_update_review",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.lesson.require_clear_status_reason.updates_behavior.workflow.ticket_triage",
+    "type": "updates_behavior",
+    "source": "lesson.require_clear_status_reason",
+    "target": "workflow.ticket_triage",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  },
+  {
+    "id": "relation.employee.support_assistant.federates_with.endpoint.ai_service_federation",
+    "type": "federates_with",
+    "source": "employee.support_assistant",
+    "target": "endpoint.ai_service_federation",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.ai_employee_brief"
+    ],
+    "profile": "ai_employee"
+  }
+]

package/examples/ai-employee-minimal/mirai-graph-package.json

@@ -0,0 +1,14 @@
+{
+  "id": "package.ai_employee_minimal",
+  "name": "Minimal AI Employee Example",
+  "version": "0.1.0",
+  "profile": "ai_employee",
+  "conformance_level": "level_1",
+  "description": "A synthetic Mirai Graph package showing an AI employee with role, skill, tool, policy, action boundary, feedback and learning gate.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}

package/examples/ai-employee-minimal/results/profile-conformance-result.json

@@ -0,0 +1,28 @@
+{
+  "schema_version": "0.1.0",
+  "result_id": "profile_conformance.package.ai_employee_minimal",
+  "checked_at": "2026-05-29",
+  "fixture": "examples/ai-employee-minimal/",
+  "package_id": "package.ai_employee_minimal",
+  "profile": "ai_employee",
+  "conformance_level": "level_1",
+  "validator": "packages/cli/validate-mirai-graph.js",
+  "command": "node packages/cli/validate-mirai-graph.js examples/ai-employee-minimal",
+  "valid": true,
+  "errors": [],
+  "warnings": [],
+  "checks": [
+    "required package, object, relation and gate-result fields",
+    "unique object and relation ids",
+    "relation source and target existence",
+    "relation id consistency",
+    "readiness and gate verdict values",
+    "ai_employee object-kind conformance",
+    "ai_employee relation-type conformance"
+  ],
+  "claim_supported": "The package follows the declared Mirai Graph profile shape checked by the current validator.",
+  "limitations": [
+    "This result does not prove runtime safety, agent effectiveness or downstream task performance.",
+    "The example package is synthetic public-safe evidence."
+  ]
+}

package/examples/character-layer-integration-minimal/README.md

@@ -0,0 +1,25 @@
+# Character Layer Integration Minimal
+
+This example shows how Character Layer composes with other Mirai Graph layers
+without merging their profile vocabularies into one package.
+
+It models references between:
+
+- Character Layer starter package;
+- AI employee and role;
+- process control contract;
+- launch record;
+- technology quality feedback;
+- runtime context and reflection protocol.
+
+Validate:
+
+```bash
+node packages/cli/validate-mirai-graph.js character-layer-integration examples/character-layer-integration-minimal/results/character-layer-integration.json
+```
+
+## Boundary
+
+The integration artifact is a composition contract. It does not grant runtime
+permission, execute tools, authorize external action or update canonical graph
+state.

package/examples/character-layer-integration-minimal/results/character-layer-integration.json

@@ -0,0 +1,53 @@
+{
+  "schema_version": "0.1.0",
+  "profile": "character_layer",
+  "public_safety": "synthetic_public",
+  "integration_id": "character_layer_integration.synthetic_ai_employee_work_cycle",
+  "character_package_ref": "templates/character-layer-starter",
+  "ai_employee_links": [
+    {
+      "ai_employee_ref": "ai_employee.research_assistant",
+      "role_ref": "role.research_support",
+      "role_character_profile_ref": "role_character_profile.researcher",
+      "composition_relations": [
+        "ai_employee -> has_role -> role",
+        "role_character_profile -> governs_role -> role",
+        "role_character_profile -> governs_employee -> ai_employee",
+        "role_character_profile -> specializes_character -> character_constitution",
+        "role_character_profile -> uses_reflection_protocol -> reflection_protocol"
+      ]
+    }
+  ],
+  "process_control_links": {
+    "launch_record_ref": "examples/launch-record-minimal/results/launch-record.json",
+    "process_control_contract_ref": "examples/process-control-contract-minimal/results/process-control-contract.json",
+    "technology_quality_feedback_ref": "examples/technology-quality-feedback-minimal/results/technology-quality-feedback.json",
+    "transition_gate_refs": [
+      "human_review_before_canonical_write",
+      "approval_before_external_action",
+      "technology_quality_feedback",
+      "process_transition_explanation"
+    ]
+  },
+  "runtime_context_boundary": {
+    "generated_context_ref": "context_pack.synthetic_character_runtime_context",
+    "reflection_protocol_ref": "reflection_protocol.character_pre_output_check",
+    "authorization_boundary": "Generated character context may guide runtime reflection but does not authorize tool use, external action or approval bypass.",
+    "canonical_update_boundary": "Feedback and runtime results may create proposals; canonical character updates require owner review."
+  },
+  "required_gates": [
+    "human_review_before_canonical_write",
+    "approval_before_external_action",
+    "technology_quality_feedback",
+    "public_safety_before_release"
+  ],
+  "evidence_refs": [
+    "evidence.character_starter_brief",
+    "gate_result.template_character_layer.owner_review_boundary"
+  ],
+  "limitations": [
+    "Synthetic public-safe integration example only.",
+    "This artifact does not prove runtime quality or model portability.",
+    "Generated context, evidence, feedback and proposals do not authorize canonical updates."
+  ]
+}

package/examples/character-layer-minimal/README.md

@@ -0,0 +1,29 @@
+# Minimal Character Layer Example
+
+This example is a synthetic public-safe package for the
+`character_layer` profile.
+
+It shows how a character constitution can define principles, promote character
+virtues, set character boundaries, support a role character profile, use a
+reflection protocol, exercise a fixture, describe a violation pattern and route
+correction through a reviewed update loop.
+
+The example is structural conformance evidence for the profile vocabulary. It
+is not runtime evidence and does not authorize external actions or canonical
+graph writes.
+
+## Files
+
+- `mirai-graph-package.json`: package manifest using `profile:
+  "character_layer"`;
+- `graph/objects.json`: synthetic profile objects;
+- `graph/relations.json`: relations among the synthetic objects;
+- `gates/results.json`: public-safety and review-boundary gate results.
+
+## Validate
+
+From the repository root:
+
+```bash
+node packages/cli/validate-mirai-graph.js examples/character-layer-minimal
+```

package/examples/character-layer-minimal/gates/results.json

@@ -0,0 +1,57 @@
+[
+  {
+    "id": "gate_result.character_layer_minimal.public_safety",
+    "gate_id": "public_safety_before_release",
+    "target_id": "package.character_layer_minimal",
+    "verdict": "pass_with_notes",
+    "summary": "The fixture is synthetic and contains no private runtime, customer, employee or secret material.",
+    "reviewed_at": "2026-06-12",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ]
+  },
+  {
+    "id": "gate_result.character_layer_minimal.canonical_write_boundary",
+    "gate_id": "human_review_before_canonical_write",
+    "target_id": "correction_loop.owner_reviewed_update",
+    "verdict": "pass_with_notes",
+    "summary": "The correction loop represents a proposed update that requires owner review before canonical character state changes.",
+    "reviewed_at": "2026-06-12",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ]
+  },
+  {
+    "id": "gate_result.character_layer_minimal.external_action_boundary",
+    "gate_id": "approval_before_external_action",
+    "target_id": "character_boundary.no_generated_authorization",
+    "verdict": "pass_with_notes",
+    "summary": "Generated character context is modeled as reasoning support and not as external-action permission.",
+    "reviewed_at": "2026-06-12",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ]
+  },
+  {
+    "id": "gate_result.character_layer_minimal.feedback_learning",
+    "gate_id": "feedback_learning_before_behavior_update",
+    "target_id": "role_character_profile.federation_operator",
+    "verdict": "needs_more_evidence",
+    "summary": "Behavior changes remain proposals until reviewed; the example is structural evidence only.",
+    "reviewed_at": "2026-06-12",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ]
+  },
+  {
+    "id": "gate_result.character_layer_minimal.scientific_claim_boundary",
+    "gate_id": "scientific_claim_before_publication",
+    "target_id": "character_constitution.mirai_base_public",
+    "verdict": "needs_more_evidence",
+    "summary": "The package defines a profile vocabulary and minimal fixture; scientific effectiveness claims require separate methodology and data.",
+    "reviewed_at": "2026-06-12",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ]
+  }
+]

package/examples/character-layer-minimal/graph/objects.json

@@ -0,0 +1,165 @@
+[
+  {
+    "id": "evidence.character_layer_brief",
+    "kind": "evidence",
+    "title": "Character Layer Brief",
+    "summary": "Public-safe synthetic brief for the minimal Character Layer profile fixture.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_constitution.mirai_base_public",
+    "kind": "character_constitution",
+    "title": "Mirai Base Public Character Constitution",
+    "summary": "Public-safe base constitution for modeling portable AI character boundaries.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_principle.expose_uncertainty",
+    "kind": "character_principle",
+    "title": "Expose Uncertainty",
+    "summary": "Separate verified facts, memory-derived context, inference and unknowns.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_principle.preserve_authority_boundary",
+    "kind": "character_principle",
+    "title": "Preserve Authority Boundary",
+    "summary": "Keep generated context, recommendations, approvals and external actions in separate states.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_principle.report_evidence_and_blockers",
+    "kind": "character_principle",
+    "title": "Report Evidence And Blockers",
+    "summary": "Report completed work, evidence, blockers, remaining work and the next safe action.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_virtue.evidence_honesty",
+    "kind": "character_virtue",
+    "title": "Evidence Honesty",
+    "summary": "State what is known, what was checked and what still needs validation.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_virtue.boundary_discipline",
+    "kind": "character_virtue",
+    "title": "Boundary Discipline",
+    "summary": "Keep reasoning support, generated context, permission and execution in their own layers.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_boundary.no_generated_authorization",
+    "kind": "character_boundary",
+    "title": "Generated Context Is Not Authorization",
+    "summary": "Generated context may guide reasoning but cannot authorize external action or canonical writes.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_boundary.no_secret_exposure",
+    "kind": "character_boundary",
+    "title": "Secret Exposure Boundary",
+    "summary": "Credentials, tokens, private keys and raw secret values stay outside public graph packages.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "reflection_protocol.final_response_boundary",
+    "kind": "reflection_protocol",
+    "title": "Final Response Boundary Reflection",
+    "summary": "Check completed work, evidence, blockers, next safe action and remaining work before final reporting.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "role_character_profile.federation_operator",
+    "kind": "role_character_profile",
+    "title": "Federation Operator Character Profile",
+    "summary": "Synthetic role profile for federation coordination: route correctly, preserve boundaries and report evidence.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "character_fixture.analysis_boundary",
+    "kind": "character_fixture",
+    "title": "Analysis Boundary Fixture",
+    "summary": "Fixture where the expected behavior is discussion and review mode until the owner approves repository writes.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "violation_pattern.false_completion_claim",
+    "kind": "violation_pattern",
+    "title": "False Completion Claim",
+    "summary": "Pattern where a result is described as complete before required evidence, review or validation exists.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "correction_loop.owner_reviewed_update",
+    "kind": "correction_loop",
+    "title": "Owner Reviewed Character Update",
+    "summary": "Correction loop where feedback becomes a proposed update and canonical character state changes only after owner review.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  },
+  {
+    "id": "governance_gate.character_public_safety",
+    "kind": "governance_gate",
+    "title": "Character Public Safety Gate",
+    "summary": "Gate checking that public character examples contain only synthetic public-safe content.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.character_layer_brief"
+    ],
+    "profile": "character_layer"
+  }
+]