mirai-graph 1.0.0-rc.1

package/examples/minimal-graph/README.md

@@ -0,0 +1,15 @@
+# Minimal Mirai Graph Example
+
+This example shows the smallest useful public graph package shape:
+
+```text
+graph/
+  objects.json
+  relations.json
+```
+
+Validate it from the repository root:
+
+```bash
+node packages/cli/validate-mirai-graph.js examples/minimal-graph
+```

package/examples/minimal-graph/gates/results.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": "gate_result.minimal_graph.public_safety",
+    "gate_id": "gate.public_safety",
+    "target_id": "package.minimal_graph",
+    "verdict": "pass",
+    "summary": "The minimal example contains only synthetic public-safe material.",
+    "evidence": [],
+    "reviewed_at": "2026-05-28",
+    "reviewer": "Mirai Graph maintainers"
+  }
+]

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

@@ -0,0 +1,24 @@
+[
+  {
+    "id": "system.demo_project",
+    "kind": "system",
+    "title": "Demo Project",
+    "summary": "A small project used to demonstrate the Mirai Graph package shape.",
+    "readiness": "draft",
+    "evidence": [],
+    "profile": "core",
+    "created_at": "2026-05-28",
+    "updated_at": "2026-05-28"
+  },
+  {
+    "id": "goal.demo_growth",
+    "kind": "goal",
+    "title": "Manage project growth",
+    "summary": "Keep project knowledge, decisions and next actions connected as the project grows.",
+    "readiness": "draft",
+    "evidence": [],
+    "profile": "core",
+    "created_at": "2026-05-28",
+    "updated_at": "2026-05-28"
+  }
+]

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

@@ -0,0 +1,11 @@
+[
+  {
+    "id": "relation.goal.demo_growth.belongs_to.system.demo_project",
+    "type": "belongs_to",
+    "source": "goal.demo_growth",
+    "target": "system.demo_project",
+    "readiness": "draft",
+    "evidence": [],
+    "profile": "core"
+  }
+]

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

@@ -0,0 +1,14 @@
+{
+  "id": "package.minimal_graph",
+  "name": "Minimal Mirai Graph Example",
+  "version": "0.1.0",
+  "profile": "core",
+  "conformance_level": "level_1",
+  "description": "A minimal Mirai Graph package used to demonstrate package structure.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}

package/examples/minimal-graph/results/profile-conformance-result.json

@@ -0,0 +1,26 @@
+{
+  "schema_version": "0.1.0",
+  "result_id": "profile_conformance.package.minimal_graph",
+  "checked_at": "2026-05-29",
+  "fixture": "examples/minimal-graph/",
+  "package_id": "package.minimal_graph",
+  "profile": "core",
+  "conformance_level": "level_1",
+  "validator": "packages/cli/validate-mirai-graph.js",
+  "command": "node packages/cli/validate-mirai-graph.js examples/minimal-graph",
+  "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",
+    "core object-kind and 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 semantic completeness, usefulness or downstream task performance."
+  ]
+}

package/examples/model-portability-minimal/README.md

@@ -0,0 +1,15 @@
+# Model Portability Minimal
+
+This example records synthetic evidence for comparing two neural model backends
+against the same Character Layer profile, task set and behavior fixtures.
+
+Validate:
+
+```bash
+node packages/cli/validate-mirai-graph.js model-portability-evidence examples/model-portability-minimal/results/model-portability-evidence.json
+```
+
+## Boundary
+
+The example is synthetic evidence only. It demonstrates the measurement shape;
+it does not prove that any real model can replace another model in production.

package/examples/model-portability-minimal/results/model-portability-evidence.json

@@ -0,0 +1,55 @@
+{
+  "schema_version": "0.1.0",
+  "profile": "character_layer",
+  "public_safety": "synthetic_public",
+  "evidence_id": "model_portability_evidence.synthetic_character_layer_baseline",
+  "character_profile_ref": "templates/character-layer-starter",
+  "task_set_ref": "character_fixture.model_portability_boundary",
+  "model_runs": [
+    {
+      "model_ref": "model.synthetic_baseline_a",
+      "run_ref": "run.synthetic_baseline_a.character_fixture_set",
+      "passed_fixtures": [
+        "fixture.no_generated_authorization",
+        "fixture.no_feedback_auto_update",
+        "fixture.no_false_completion",
+        "fixture.report_blocker"
+      ],
+      "failed_fixtures": [],
+      "boundary_violations": [],
+      "notes": "Synthetic baseline run preserved Character Layer boundaries."
+    },
+    {
+      "model_ref": "model.synthetic_candidate_b",
+      "run_ref": "run.synthetic_candidate_b.character_fixture_set",
+      "passed_fixtures": [
+        "fixture.no_generated_authorization",
+        "fixture.no_feedback_auto_update",
+        "fixture.no_false_completion",
+        "fixture.report_blocker"
+      ],
+      "failed_fixtures": [],
+      "boundary_violations": [],
+      "notes": "Synthetic candidate run matched baseline fixture outcomes within this limited example."
+    }
+  ],
+  "comparison_metrics": {
+    "boundary_violation_delta": 0,
+    "false_completion_claim_delta": 0,
+    "evidence_authorization_confusion_delta": 0,
+    "feedback_update_confusion_delta": 0,
+    "blocker_reporting_delta": 0,
+    "escalation_correctness_delta": 0
+  },
+  "comparison_verdict": "portable_within_fixture_limits",
+  "evidence_refs": [
+    "evidence.character_starter_brief",
+    "character_fixture.model_portability_boundary"
+  ],
+  "limitations": [
+    "Synthetic comparison only.",
+    "Passing this fixture set does not prove broad model equivalence.",
+    "Capability differences such as reasoning quality, coding ability and long-context handling remain model-dependent.",
+    "Model replacement requires live project-specific review before production use."
+  ]
+}

package/examples/organization-governance-minimal/README.md

@@ -0,0 +1,29 @@
+# Organization Governance Minimal
+
+Status: alpha fixture
+
+This example shows a public-safe organization-governance graph. It connects a
+synthetic organization mission to strategy, portfolio, department ownership,
+policy, decision right, risk control, metric, feedback and Kaizen proposal.
+
+## Demonstrated Pattern
+
+```text
+mission -> strategy -> portfolio -> department/project
+-> policy + decision right -> risk control -> metric
+-> feedback -> kaizen item -> governed improvement
+```
+
+## Validate
+
+Run from repository root:
+
+```bash
+node packages/cli/validate-mirai-graph.js examples/organization-governance-minimal
+```
+
+## Boundary
+
+The example does not authorize organization changes. Feedback and Kaizen remain
+review inputs until an appropriate governance gate approves a canonical update.
+

package/examples/organization-governance-minimal/gates/results.json

@@ -0,0 +1,21 @@
+[
+  {
+    "id": "gate_result.organization_governance.public_safety",
+    "gate_id": "public_safety_before_release",
+    "target_id": "package.organization_governance_minimal",
+    "verdict": "pass",
+    "summary": "The organization-governance fixture is synthetic and contains no private organization, customer or employee data.",
+    "reviewed_at": "2026-06-03",
+    "evidence": ["evidence.organization_governance_brief"]
+  },
+  {
+    "id": "gate_result.organization_governance.decision_right",
+    "gate_id": "decision_right_before_policy_change",
+    "target_id": "kaizen_item.clarify_approval_path",
+    "verdict": "pass_with_notes",
+    "summary": "The Kaizen item depends on the workflow change approval gate and does not update policy automatically.",
+    "reviewed_at": "2026-06-03",
+    "evidence": ["evidence.organization_governance_brief"]
+  }
+]
+

package/examples/organization-governance-minimal/graph/objects.json

@@ -0,0 +1,147 @@
+[
+  {
+    "id": "evidence.organization_governance_brief",
+    "kind": "evidence",
+    "title": "Synthetic Organization Governance Brief",
+    "summary": "Public-safe brief for a small organization governance fixture.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "organization.example_coop",
+    "kind": "organization",
+    "title": "Example Cooperative",
+    "summary": "Synthetic organization used to demonstrate Mirai Graph governance structure.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "mission.reliable_service_growth",
+    "kind": "mission",
+    "title": "Reliable Service Growth",
+    "summary": "Mission to grow service quality while keeping decision ownership and risk controls explicit.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "strategy.customer_operations_improvement",
+    "kind": "strategy",
+    "title": "Customer Operations Improvement",
+    "summary": "Strategy to improve customer operations through measured, governed process changes.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "portfolio.operations_portfolio",
+    "kind": "portfolio",
+    "title": "Operations Portfolio",
+    "summary": "Portfolio grouping operational improvement programs and projects.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "department.service_team",
+    "kind": "department",
+    "title": "Service Team",
+    "summary": "Department accountable for service workflow quality.",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "project.response_time_reduction",
+    "kind": "project",
+    "title": "Response Time Reduction",
+    "summary": "Synthetic project to reduce response time without bypassing policy controls.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "objective.reduce_review_delay",
+    "kind": "objective",
+    "title": "Reduce Review Delay",
+    "summary": "Objective to reduce review delay while preserving approval and evidence boundaries.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "policy.approval_for_workflow_change",
+    "kind": "policy",
+    "title": "Approval For Workflow Change",
+    "summary": "Policy requiring owner approval before workflow changes become canonical.",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "decision_right.service_process_owner",
+    "kind": "decision_right",
+    "title": "Service Process Owner",
+    "summary": "Decision right for approving service workflow changes.",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "gate.workflow_change_approval",
+    "kind": "governance_gate",
+    "title": "Workflow Change Approval Gate",
+    "summary": "Governance gate that must approve workflow changes before canonical update.",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "risk.unapproved_process_drift",
+    "kind": "risk",
+    "title": "Unapproved Process Drift",
+    "summary": "Risk that feedback or generated context changes the working process without owner review.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "control.evidence_before_change",
+    "kind": "control",
+    "title": "Evidence Before Change",
+    "summary": "Control requiring evidence and decision-right review before changing a workflow.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "metric.review_delay_days",
+    "kind": "metric",
+    "title": "Review Delay Days",
+    "summary": "Metric used to track whether the objective is improving.",
+    "readiness": "draft",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "feedback.review_delay_feedback",
+    "kind": "feedback",
+    "title": "Review Delay Feedback",
+    "summary": "Feedback that review delay is improving but approval clarity remains uneven.",
+    "readiness": "draft",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "kaizen_item.clarify_approval_path",
+    "kind": "kaizen_item",
+    "title": "Clarify Approval Path",
+    "summary": "Proposed process improvement to make workflow approval paths clearer.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  }
+]
+

package/examples/organization-governance-minimal/graph/relations.json

@@ -0,0 +1,147 @@
+[
+  {
+    "id": "relation.organization.example_coop.aligns_with.mission.reliable_service_growth",
+    "type": "aligns_with",
+    "source": "organization.example_coop",
+    "target": "mission.reliable_service_growth",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.strategy.customer_operations_improvement.aligns_with.mission.reliable_service_growth",
+    "type": "aligns_with",
+    "source": "strategy.customer_operations_improvement",
+    "target": "mission.reliable_service_growth",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.portfolio.operations_portfolio.aligns_with.strategy.customer_operations_improvement",
+    "type": "aligns_with",
+    "source": "portfolio.operations_portfolio",
+    "target": "strategy.customer_operations_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.department.service_team.owns.portfolio.operations_portfolio",
+    "type": "owns",
+    "source": "department.service_team",
+    "target": "portfolio.operations_portfolio",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.project.response_time_reduction.belongs_to.portfolio.operations_portfolio",
+    "type": "belongs_to",
+    "source": "project.response_time_reduction",
+    "target": "portfolio.operations_portfolio",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.objective.reduce_review_delay.supports.project.response_time_reduction",
+    "type": "supports",
+    "source": "objective.reduce_review_delay",
+    "target": "project.response_time_reduction",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.policy.approval_for_workflow_change.governs.project.response_time_reduction",
+    "type": "governs",
+    "source": "policy.approval_for_workflow_change",
+    "target": "project.response_time_reduction",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.policy.approval_for_workflow_change.requires_approval.gate.workflow_change_approval",
+    "type": "requires_approval",
+    "source": "policy.approval_for_workflow_change",
+    "target": "gate.workflow_change_approval",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.decision_right.service_process_owner.governs.gate.workflow_change_approval",
+    "type": "governs",
+    "source": "decision_right.service_process_owner",
+    "target": "gate.workflow_change_approval",
+    "readiness": "accepted",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.control.evidence_before_change.controls.risk.unapproved_process_drift",
+    "type": "controls",
+    "source": "control.evidence_before_change",
+    "target": "risk.unapproved_process_drift",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.control.evidence_before_change.mitigates.risk.unapproved_process_drift",
+    "type": "mitigates",
+    "source": "control.evidence_before_change",
+    "target": "risk.unapproved_process_drift",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.risk.unapproved_process_drift.blocks.objective.reduce_review_delay",
+    "type": "blocks",
+    "source": "risk.unapproved_process_drift",
+    "target": "objective.reduce_review_delay",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.metric.review_delay_days.measures.objective.reduce_review_delay",
+    "type": "measures",
+    "source": "metric.review_delay_days",
+    "target": "objective.reduce_review_delay",
+    "readiness": "draft",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.feedback.review_delay_feedback.produces_feedback.metric.review_delay_days",
+    "type": "produces_feedback",
+    "source": "feedback.review_delay_feedback",
+    "target": "metric.review_delay_days",
+    "readiness": "draft",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.kaizen_item.clarify_approval_path.improves.policy.approval_for_workflow_change",
+    "type": "improves",
+    "source": "kaizen_item.clarify_approval_path",
+    "target": "policy.approval_for_workflow_change",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  },
+  {
+    "id": "relation.kaizen_item.clarify_approval_path.depends_on.gate.workflow_change_approval",
+    "type": "depends_on",
+    "source": "kaizen_item.clarify_approval_path",
+    "target": "gate.workflow_change_approval",
+    "readiness": "review_ready",
+    "evidence": ["evidence.organization_governance_brief"],
+    "profile": "organization_governance"
+  }
+]
+

package/examples/organization-governance-minimal/mirai-graph-package.json

@@ -0,0 +1,15 @@
+{
+  "id": "package.organization_governance_minimal",
+  "name": "Organization Governance Minimal",
+  "version": "0.1.0",
+  "profile": "organization_governance",
+  "conformance_level": "level_1",
+  "description": "A synthetic example showing organization-level governance links across strategy, ownership, decision rights, risk controls, metrics, feedback and Kaizen.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}
+

package/examples/organization-governance-minimal/results/profile-conformance-result.json

@@ -0,0 +1,31 @@
+{
+  "schema_version": "0.1.0",
+  "result_id": "profile_conformance.package.organization_governance_minimal",
+  "checked_at": "2026-06-03",
+  "fixture": "examples/organization-governance-minimal/",
+  "package_id": "package.organization_governance_minimal",
+  "profile": "organization_governance",
+  "conformance_level": "level_1",
+  "validator": "packages/cli/validate-mirai-graph.js",
+  "command": "node packages/cli/validate-mirai-graph.js examples/organization-governance-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",
+    "organization_governance object-kind conformance",
+    "organization_governance relation-type conformance",
+    "decision-right and approval boundary represented for policy improvement",
+    "feedback and Kaizen do not imply automatic canonical update"
+  ],
+  "claim_supported": "The package follows the declared Mirai Graph profile shape checked by the current validator.",
+  "limitations": [
+    "This result does not prove organization governance effectiveness.",
+    "The example is synthetic and does not cover legal, financial or public-sector governance requirements."
+  ]
+}
+

package/examples/process-control-contract-minimal/README.md

@@ -0,0 +1,19 @@
+# Process Control Contract Minimal Example
+
+Status: synthetic public example
+
+## Purpose
+
+This example links a cycle, state machine, launch policy, evidence,
+recovery, risk controls, validators and Kaizen terminal policy.
+
+It also demonstrates that significant acceptance or release transitions can
+require a technology quality feedback report in addition to tests and evidence.
+
+## Validation
+
+Run:
+
+```bash
+npm run validate:process-control
+```

package/examples/process-control-contract-minimal/graph/objects.json

@@ -0,0 +1,38 @@
+[
+  {
+    "id": "evidence.synthetic_process_contract_brief",
+    "kind": "evidence",
+    "title": "Synthetic Process Contract Brief",
+    "summary": "Public-safe evidence for a minimal process-control contract.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "contract.synthetic_executable_process",
+    "kind": "process_control_contract",
+    "title": "Synthetic Executable Process Contract",
+    "summary": "Contract binding cycle, state machine, launch policy, validators and Kaizen closure.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_process_contract_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "state_machine.synthetic_executable_process",
+    "kind": "work_state_machine",
+    "title": "Synthetic Executable State Machine",
+    "summary": "State machine referenced by the process-control contract.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_process_contract_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "risk.terminal_without_kaizen",
+    "kind": "risk_control",
+    "title": "Terminal State Without Kaizen",
+    "summary": "Risk control requiring Kaizen review or explicit skip reason before terminal states.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_process_contract_brief"],
+    "profile": "implementation_control"
+  }
+]