mirai-graph 1.4.0 → 2.1.0

package/examples/ai-employee-minimal/gates/results.json

@@ -1,35 +0,0 @@
-[
-  {
-    "id": "gate_result.ai_employee_minimal.public_safety",
-    "gate_id": "public_safety_before_release",
-    "target_id": "package.ai_employee_minimal",
-    "verdict": "pass_with_notes",
-    "summary": "The fixture is synthetic and contains no private runtime, customer, employee or secret material.",
-    "reviewed_at": "2026-05-29",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ]
-  },
-  {
-    "id": "gate_result.ai_employee_minimal.action_boundary",
-    "gate_id": "approval_before_external_action",
-    "target_id": "action.propose_status_update",
-    "verdict": "pass_with_notes",
-    "summary": "The proposed action is modeled as requiring an approval gate before execution.",
-    "reviewed_at": "2026-05-29",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ]
-  },
-  {
-    "id": "gate_result.ai_employee_minimal.feedback_learning",
-    "gate_id": "feedback_learning_before_behavior_update",
-    "target_id": "lesson.require_clear_status_reason",
-    "verdict": "needs_more_evidence",
-    "summary": "The lesson is represented as a review-ready proposal, not an automatically accepted behavior update.",
-    "reviewed_at": "2026-05-29",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ]
-  }
-]

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

@@ -1,187 +0,0 @@
-[
-  {
-    "id": "evidence.ai_employee_brief",
-    "kind": "evidence",
-    "title": "Synthetic AI Employee Brief",
-    "summary": "Public-safe synthetic brief for the minimal AI employee profile fixture.",
-    "readiness": "accepted",
-    "evidence": [],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "department.support",
-    "kind": "ai_department",
-    "title": "Support Department",
-    "summary": "Synthetic department that owns the AI support employee.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "employee.support_assistant",
-    "kind": "ai_employee",
-    "title": "Support Assistant",
-    "summary": "Synthetic AI employee that helps triage support requests through governed actions.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "role.support_triage",
-    "kind": "role",
-    "title": "Support Triage Role",
-    "summary": "Role responsible for classifying requests, preparing answers and escalating risky cases.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "skill.ticket_classification",
-    "kind": "skill",
-    "title": "Ticket Classification",
-    "summary": "Skill for classifying support requests by topic, urgency and required owner.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "knowledge.support_policy",
-    "kind": "knowledge",
-    "title": "Support Policy Knowledge",
-    "summary": "Knowledge object that references the public-safe support policy used by the AI employee.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "memory.recent_ticket_patterns",
-    "kind": "memory",
-    "title": "Recent Ticket Patterns",
-    "summary": "Memory object for reviewed patterns from recent support work.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "tool.ticket_api",
-    "kind": "tool",
-    "title": "Ticket API",
-    "summary": "Tool adapter used by runtime to read and update support tickets.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "capability.update_ticket_status",
-    "kind": "capability",
-    "title": "Update Ticket Status",
-    "summary": "Capability required before the runtime may update a ticket status through the Ticket API.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "policy.approval_before_external_action",
-    "kind": "policy",
-    "title": "Approval Before External Action",
-    "summary": "Policy requiring approval before the AI employee performs external or user-visible actions.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "gate.external_action_approval",
-    "kind": "governance_gate",
-    "title": "External Action Approval Gate",
-    "summary": "Governance gate that separates proposed actions from executed actions.",
-    "readiness": "accepted",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "workflow.ticket_triage",
-    "kind": "workflow",
-    "title": "Ticket Triage Workflow",
-    "summary": "Workflow for classifying a support ticket, preparing a proposed action and recording the result.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "action.propose_status_update",
-    "kind": "action",
-    "title": "Propose Status Update",
-    "summary": "Proposed runtime action to update a support ticket status after policy and approval checks.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "result.status_update_audited",
-    "kind": "result",
-    "title": "Status Update Audited Result",
-    "summary": "Audited result recording whether the approved status update matched the expected outcome.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "feedback.status_update_review",
-    "kind": "feedback",
-    "title": "Status Update Review Feedback",
-    "summary": "Feedback from reviewing the audited result of the ticket status update.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "lesson.require_clear_status_reason",
-    "kind": "lesson",
-    "title": "Require Clear Status Reason",
-    "summary": "Proposed lesson that future ticket status updates should include a clear user-visible reason.",
-    "readiness": "review_ready",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  },
-  {
-    "id": "endpoint.ai_service_federation",
-    "kind": "federation_endpoint",
-    "title": "AI Service Federation Endpoint",
-    "summary": "Placeholder endpoint showing how this AI employee could federate with another AI service.",
-    "readiness": "draft",
-    "evidence": [
-      "evidence.ai_employee_brief"
-    ],
-    "profile": "ai_employee"
-  }
-]

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

@@ -1,167 +0,0 @@
-[
-  {
-    "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/graph.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "package.ai_employee_minimal",
-  "aliases": [],
-  "title": "Minimal AI Employee Example",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "ai_employee"
-  ],
-  "graph": {
-    "root": "graph",
-    "source_of_truth": [
-      "graph"
-    ],
-    "objects": [
-      "graph/objects.json"
-    ],
-    "relations": [
-      "graph/relations.json"
-    ],
-    "schemas": [],
-    "generated": [],
-    "raw_sources": [
-      "README.md"
-    ]
-  },
-  "imports": [],
-  "version": "0.1.0",
-  "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"
-}

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

@@ -1,28 +0,0 @@
-{
-  "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

@@ -1,25 +0,0 @@
-# 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

@@ -1,53 +0,0 @@
-{
-  "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

@@ -1,29 +0,0 @@
-# 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
-
-- `graph.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

@@ -1,57 +0,0 @@
-[
-  {
-    "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"
-    ]
-  }
-]