mirai-graph 1.3.0 → 2.1.0

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

@@ -1,147 +0,0 @@
-[
-  {
-    "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/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.organization_governance_minimal",
-  "aliases": [],
-  "title": "Organization Governance Minimal",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "organization_governance"
-  ],
-  "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 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"
-}

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

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

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

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

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

@@ -1,29 +0,0 @@
-[
-  {
-    "id": "relation.evidence.synthetic_process_contract_brief.evidences.contract.synthetic_executable_process",
-    "type": "evidences",
-    "source": "evidence.synthetic_process_contract_brief",
-    "target": "contract.synthetic_executable_process",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_process_contract_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.contract.synthetic_executable_process.defines_boundary.state_machine.synthetic_executable_process",
-    "type": "defines_boundary",
-    "source": "contract.synthetic_executable_process",
-    "target": "state_machine.synthetic_executable_process",
-    "readiness": "review_ready",
-    "evidence": ["evidence.synthetic_process_contract_brief"],
-    "profile": "implementation_control"
-  },
-  {
-    "id": "relation.contract.synthetic_executable_process.controls_risk.risk.terminal_without_kaizen",
-    "type": "controls_risk",
-    "source": "contract.synthetic_executable_process",
-    "target": "risk.terminal_without_kaizen",
-    "readiness": "accepted",
-    "evidence": ["evidence.synthetic_process_contract_brief"],
-    "profile": "implementation_control"
-  }
-]

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

@@ -1,34 +0,0 @@
-{
-  "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
-  "format": "mirai-graph",
-  "schema_version": "2.0.0",
-  "id": "package.process_control_contract_minimal",
-  "aliases": [],
-  "title": "Process Control Contract Minimal",
-  "scope": "package",
-  "kind": "graph_package",
-  "owner": "mirai-graph",
-  "profiles": [
-    "implementation_control"
-  ],
-  "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"
-}

package/examples/process-control-contract-minimal/results/process-control-contract.json

@@ -1,58 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "process_control_contract.synthetic_executable_process",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "cycle_id": "bounded_work_batch",
-  "state_machine_id": "work_state_machine.synthetic_executable_process",
-  "launch_record_policy": {
-    "required_for_states": ["ready_to_execute", "started"],
-    "required_for_transitions": ["planned->ready_to_execute", "ready_to_execute->started"],
-    "approval_required": true
-  },
-  "evidence_requirements": [
-    "launch_record",
-    "scope_check",
-    "test_result",
-    "technology_quality_feedback",
-    "semantic_acceptance",
-    "release_evidence"
-  ],
-  "recovery_behavior": "Resume from durable workflow state, last valid launch record and evidence pack.",
-  "risk_controls": [
-    "terminal_without_kaizen",
-    "sync_proposal_as_update",
-    "tests_without_acceptance",
-    "technology_drift_without_feedback"
-  ],
-  "validators": [
-    "launch-record",
-    "process-transition",
-    "technology-quality-feedback",
-    "work-state-machine"
-  ],
-  "technology_quality_feedback_policy": {
-    "required_for_transitions": [
-      "tests_recorded->review_ready",
-      "review_ready->approved",
-      "approved->release_ready"
-    ],
-    "accepted_verdicts": [
-      "accepted",
-      "accepted_with_deferred_items"
-    ],
-    "blocking_findings_stop_transition": true
-  },
-  "kaizen_policy": {
-    "terminal_state_requires_review_or_skip": true,
-    "accepted_skip_field": "no_reusable_lessons_reason"
-  },
-  "evidence_refs": [
-    "evidence.synthetic_process_contract_brief"
-  ],
-  "limitations": [
-    "Synthetic contract validates executable process shape, not real-world safety.",
-    "The contract does not execute actions or approve canonical updates."
-  ]
-}

package/examples/process-transition-minimal/README.md

@@ -1,25 +0,0 @@
-# Process Transition Minimal Example
-
-Status: synthetic public example
-
-## Purpose
-
-This example demonstrates fail-closed process transition validation.
-
-It checks:
-
-```text
-current state
--> allowed transition
--> required evidence
--> launch record when needed
--> terminal Kaizen closure
-```
-
-## Validation
-
-Run:
-
-```bash
-npm run validate:process-transition
-```

package/examples/process-transition-minimal/invalid-missing-launch-record.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_missing_launch_record",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "planned",
-  "target_state": "ready_to_execute",
-  "evidence_refs": ["launch_record"],
-  "launch_record_ref": "",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: launch-record transition must reference a launch record."]
-}

package/examples/process-transition-minimal/invalid-ready-to-written.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_ready_to_written",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "ready_to_execute",
-  "target_state": "written",
-  "evidence_refs": ["scope_check"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: ready_to_execute cannot skip started."]
-}

package/examples/process-transition-minimal/invalid-release-missing-evidence.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_release_missing_evidence",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "release_ready",
-  "target_state": "released",
-  "evidence_refs": [],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "kaizen_review.synthetic_release",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: release transition needs release evidence."]
-}

package/examples/process-transition-minimal/invalid-sync-to-update.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_sync_to_update",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "sync_proposed",
-  "target_state": "controlled_update",
-  "evidence_refs": ["sync_proposal"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: sync proposal is not controlled update."]
-}

package/examples/process-transition-minimal/invalid-terminal-missing-kaizen.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_terminal_missing_kaizen",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "release_ready",
-  "target_state": "released",
-  "evidence_refs": ["release_evidence"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: significant terminal state needs Kaizen review or explicit skip reason."]
-}

package/examples/process-transition-minimal/invalid-tests-to-approved.json

@@ -1,14 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "id": "transition_request.invalid_tests_to_approved",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "process_id": "process.synthetic_executable_standard",
-  "current_state": "tests_recorded",
-  "target_state": "approved",
-  "evidence_refs": ["test_result"],
-  "launch_record_ref": "launch_record.synthetic_batch",
-  "kaizen_review_ref": "",
-  "no_reusable_lessons_reason": "",
-  "limitations": ["Invalid fixture: tests alone are not semantic acceptance or approval."]
-}

package/examples/process-transition-minimal/results/transition-explanation-invalid-ready-to-written.json

@@ -1,35 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "fixture_id": "transition_explanation.invalid_ready_to_written",
-  "request_ref": "examples/process-transition-minimal/invalid-ready-to-written.json",
-  "expected_valid": false,
-  "expected_error": "process_transition transition ready_to_execute->written is not allowed",
-  "explanation": {
-    "process_id": "process.synthetic_executable_standard",
-    "current_state": "ready_to_execute",
-    "target_state": "written",
-    "matched_transition": false,
-    "matched_transition_ref": "",
-    "required_evidence": [],
-    "provided_evidence": ["scope_check"],
-    "missing_evidence": [],
-    "requires_launch_record": false,
-    "launch_record_ref": "launch_record.synthetic_batch",
-    "launch_record_satisfied": true,
-    "terminal_transition": false,
-    "terminal_requires_kaizen": false,
-    "kaizen_decision": {
-      "status": "not_required",
-      "kaizen_review_ref": "",
-      "no_reusable_lessons_reason": ""
-    },
-    "false_transition_guard_summary": [
-      "ready_to_execute_is_not_written",
-      "tests_recorded_without_semantic_acceptance_is_not_approved",
-      "sync_proposed_is_not_controlled_update",
-      "released_requires_release_evidence",
-      "terminal_requires_kaizen_or_no_reusable_lessons"
-    ]
-  }
-}
-

package/examples/process-transition-minimal/results/transition-explanation-valid.json

@@ -1,34 +0,0 @@
-{
-  "schema_version": "0.1.0",
-  "fixture_id": "transition_explanation.release_ready_to_released",
-  "request_ref": "examples/process-transition-minimal/transition-request.json",
-  "expected_valid": true,
-  "explanation": {
-    "process_id": "process.synthetic_executable_standard",
-    "current_state": "release_ready",
-    "target_state": "released",
-    "matched_transition": true,
-    "matched_transition_ref": "release_ready->released",
-    "required_evidence": ["release_evidence"],
-    "provided_evidence": ["release_evidence"],
-    "missing_evidence": [],
-    "requires_launch_record": false,
-    "launch_record_ref": "launch_record.synthetic_batch",
-    "launch_record_satisfied": true,
-    "terminal_transition": true,
-    "terminal_requires_kaizen": true,
-    "kaizen_decision": {
-      "status": "satisfied",
-      "kaizen_review_ref": "kaizen_review.synthetic_release",
-      "no_reusable_lessons_reason": ""
-    },
-    "false_transition_guard_summary": [
-      "ready_to_execute_is_not_written",
-      "tests_recorded_without_semantic_acceptance_is_not_approved",
-      "sync_proposed_is_not_controlled_update",
-      "released_requires_release_evidence",
-      "terminal_requires_kaizen_or_no_reusable_lessons"
-    ]
-  }
-}
-