mirai-graph 1.0.0-rc.1

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

@@ -0,0 +1,209 @@
+[
+  {
+    "id": "evidence.skill_runtime_brief",
+    "kind": "evidence",
+    "title": "Synthetic Skill Runtime Brief",
+    "summary": "Public-safe synthetic brief for the minimal skill runtime fixture.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "domain.support_operations",
+    "kind": "owner_domain",
+    "title": "Support Operations Domain",
+    "summary": "Synthetic owner domain responsible for the skill boundary and operational judgement.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "skill.support_triage",
+    "kind": "skill",
+    "title": "Support Triage Skill",
+    "summary": "Synthetic skill that classifies requests and prepares governed next actions.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "capability.request_classification",
+    "kind": "capability",
+    "title": "Request Classification",
+    "summary": "Capability for classifying requests by topic, urgency and required owner.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "activity.triage_request",
+    "kind": "activity",
+    "title": "Triage Request",
+    "summary": "Activity that uses the classification capability to prepare a next-action recommendation.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "rule.no_external_write_without_approval",
+    "kind": "rule",
+    "title": "No External Write Without Approval",
+    "summary": "Rule requiring approval before generated context leads to a user-visible or external write.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "source_boundary.hybrid_sot",
+    "kind": "source_boundary",
+    "title": "Hybrid Source Boundary",
+    "summary": "Boundary that keeps raw source material authoritative for domain meaning and sensitive rules.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "raw_source.skill_manual",
+    "kind": "raw_source",
+    "title": "Synthetic Skill Manual",
+    "summary": "Placeholder raw source that remains authoritative for detailed procedure and judgement.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "projection_view.gate_summary",
+    "kind": "projection_view",
+    "title": "Gate Summary Projection",
+    "summary": "Projection view exposing readiness, required gates, fallback and next action for the skill.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "runtime_context.support_triage_compact",
+    "kind": "runtime_context",
+    "title": "Support Triage Compact Runtime Context",
+    "summary": "Generated compact context for routing and capability orientation in the declared task scope.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "gate.semantic_preservation",
+    "kind": "quality_gate",
+    "title": "Semantic Preservation Gate",
+    "summary": "Gate checking that generated graph context preserves the meaning and safety boundary of the raw source.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "semantic_review.support_triage",
+    "kind": "semantic_review",
+    "title": "Support Triage Semantic Review",
+    "summary": "Synthetic semantic review artifact for the fixture scope.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "effectiveness_report.support_triage",
+    "kind": "effectiveness_report",
+    "title": "Support Triage Effectiveness Report",
+    "summary": "Synthetic effectiveness report comparing baseline and graph-assisted operation.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "runtime_policy.compact_context_allowed",
+    "kind": "runtime_policy",
+    "title": "Compact Context Runtime Policy",
+    "summary": "Policy allowing compact graph context only for measured non-sensitive routing tasks.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "fallback.raw_source_required",
+    "kind": "fallback",
+    "title": "Raw Source Required Fallback",
+    "summary": "Fallback requiring raw source review before sensitive, destructive or external actions.",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "handoff.next_owner",
+    "kind": "handoff",
+    "title": "Next Owner Handoff",
+    "summary": "Handoff object that records the next owner and acceptance expectation after graph-assisted triage.",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "adoption_report.gga7_candidate",
+    "kind": "adoption_report",
+    "title": "GGA7 Candidate Adoption Report",
+    "summary": "Synthetic adoption report showing staged evidence before federation integration.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "federation_contract.support_triage",
+    "kind": "federation_contract",
+    "title": "Support Triage Federation Contract",
+    "summary": "Placeholder federation contract exposing bounded skill capability and fallback requirements.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "learning_proposal.update_gate_summary",
+    "kind": "learning_proposal",
+    "title": "Update Gate Summary Learning Proposal",
+    "summary": "Proposal to improve the projection view after reviewed feedback, without automatic canonical update.",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  }
+]

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

@@ -0,0 +1,178 @@
+[
+  {
+    "id": "relation.domain.support_operations.owns_domain.skill.support_triage",
+    "type": "owns_domain",
+    "source": "domain.support_operations",
+    "target": "skill.support_triage",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.skill.support_triage.has_capability.capability.request_classification",
+    "type": "has_capability",
+    "source": "skill.support_triage",
+    "target": "capability.request_classification",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.capability.request_classification.supports_activity.activity.triage_request",
+    "type": "supports_activity",
+    "source": "capability.request_classification",
+    "target": "activity.triage_request",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.activity.triage_request.uses_rule.rule.no_external_write_without_approval",
+    "type": "uses_rule",
+    "source": "activity.triage_request",
+    "target": "rule.no_external_write_without_approval",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.skill.support_triage.reads_source.raw_source.skill_manual",
+    "type": "reads_source",
+    "source": "skill.support_triage",
+    "target": "raw_source.skill_manual",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.source_boundary.hybrid_sot.governs.raw_source.skill_manual",
+    "type": "governs",
+    "source": "source_boundary.hybrid_sot",
+    "target": "raw_source.skill_manual",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.skill.support_triage.projects_view.projection_view.gate_summary",
+    "type": "projects_view",
+    "source": "skill.support_triage",
+    "target": "projection_view.gate_summary",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.projection_view.gate_summary.generates_context.runtime_context.support_triage_compact",
+    "type": "generates_context",
+    "source": "projection_view.gate_summary",
+    "target": "runtime_context.support_triage_compact",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.runtime_context.support_triage_compact.requires_gate.gate.semantic_preservation",
+    "type": "requires_gate",
+    "source": "runtime_context.support_triage_compact",
+    "target": "gate.semantic_preservation",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.semantic_review.support_triage.preserves_semantics.runtime_context.support_triage_compact",
+    "type": "preserves_semantics",
+    "source": "semantic_review.support_triage",
+    "target": "runtime_context.support_triage_compact",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.effectiveness_report.support_triage.measures_effectiveness.skill.support_triage",
+    "type": "measures_effectiveness",
+    "source": "effectiveness_report.support_triage",
+    "target": "skill.support_triage",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.runtime_policy.compact_context_allowed.requires_fallback.fallback.raw_source_required",
+    "type": "requires_fallback",
+    "source": "runtime_policy.compact_context_allowed",
+    "target": "fallback.raw_source_required",
+    "readiness": "accepted",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.fallback.raw_source_required.hands_off_to.handoff.next_owner",
+    "type": "hands_off_to",
+    "source": "fallback.raw_source_required",
+    "target": "handoff.next_owner",
+    "readiness": "review_ready",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.skill.support_triage.exports_contract.federation_contract.support_triage",
+    "type": "exports_contract",
+    "source": "skill.support_triage",
+    "target": "federation_contract.support_triage",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.learning_proposal.update_gate_summary.proposes_learning.projection_view.gate_summary",
+    "type": "proposes_learning",
+    "source": "learning_proposal.update_gate_summary",
+    "target": "projection_view.gate_summary",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  },
+  {
+    "id": "relation.adoption_report.gga7_candidate.evidences.skill.support_triage",
+    "type": "evidences",
+    "source": "adoption_report.gga7_candidate",
+    "target": "skill.support_triage",
+    "readiness": "draft",
+    "evidence": [
+      "evidence.skill_runtime_brief"
+    ],
+    "profile": "skill_runtime"
+  }
+]

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

@@ -0,0 +1,14 @@
+{
+  "id": "package.skill_runtime_minimal",
+  "name": "Minimal Skill Runtime Example",
+  "version": "0.1.0",
+  "profile": "skill_runtime",
+  "conformance_level": "level_1",
+  "description": "A synthetic Mirai Graph package showing a governed skill runtime context with Hybrid Source Of Truth boundaries.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}

package/examples/skill-runtime-minimal/results/profile-conformance-result.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": "0.1.0",
+  "result_id": "profile_conformance.package.skill_runtime_minimal",
+  "checked_at": "2026-05-31",
+  "fixture": "examples/skill-runtime-minimal/",
+  "package_id": "package.skill_runtime_minimal",
+  "profile": "skill_runtime",
+  "conformance_level": "level_1",
+  "validator": "packages/cli/validate-mirai-graph.js",
+  "command": "node packages/cli/validate-mirai-graph.js examples/skill-runtime-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",
+    "skill_runtime 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, operational effectiveness or runtime safety.",
+    "This result does not grant canonical write permission or graph-only runtime permission."
+  ]
+}

package/examples/source-boundary-minimal/README.md

@@ -0,0 +1,16 @@
+# Source Boundary Minimal Example
+
+Status: synthetic public example
+
+## Purpose
+
+This example shows source roles and promotion rules for a graph-governed
+repository or knowledge system.
+
+## Validation
+
+Run:
+
+```bash
+npm run validate:source-boundary
+```

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

@@ -0,0 +1,38 @@
+[
+  {
+    "id": "evidence.synthetic_source_brief",
+    "kind": "evidence",
+    "title": "Synthetic Source Brief",
+    "summary": "Public-safe brief for source boundary roles.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "contract.source_boundary",
+    "kind": "source_boundary_contract",
+    "title": "Synthetic Source Boundary Contract",
+    "summary": "Contract describing canonical, generated, human, evidence and local scratch roles.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_source_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "boundary.canonical",
+    "kind": "source_boundary",
+    "title": "Canonical Boundary",
+    "summary": "Reviewed source-of-truth area.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_source_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "boundary.generated",
+    "kind": "source_boundary",
+    "title": "Generated Boundary",
+    "summary": "Reproducible output that cannot silently override canonical state.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_source_brief"],
+    "profile": "implementation_control"
+  }
+]

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

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "relation.contract.source_boundary.defines_boundary.boundary.canonical",
+    "type": "defines_boundary",
+    "source": "contract.source_boundary",
+    "target": "boundary.canonical",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_source_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.contract.source_boundary.defines_boundary.boundary.generated",
+    "type": "defines_boundary",
+    "source": "contract.source_boundary",
+    "target": "boundary.generated",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_source_brief"],
+    "profile": "implementation_control"
+  }
+]

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

@@ -0,0 +1,14 @@
+{
+  "id": "package.source_boundary_minimal",
+  "name": "Source Boundary Minimal",
+  "version": "0.1.0",
+  "profile": "implementation_control",
+  "conformance_level": "level_1",
+  "description": "Synthetic package showing source roles and promotion rules.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}

package/examples/source-boundary-minimal/results/source-boundary-contract.json

@@ -0,0 +1,37 @@
+{
+  "schema_version": "0.1.0",
+  "id": "source_boundary_contract.synthetic",
+  "profile": "implementation_control",
+  "public_safety": "synthetic_public",
+  "source_roles": [
+    {
+      "role": "canonical",
+      "description": "Reviewed source-of-truth data or rules.",
+      "canonical_write_allowed": true
+    },
+    {
+      "role": "generated",
+      "description": "Reproducible output that may reveal gaps but cannot silently update canonical state.",
+      "canonical_write_allowed": false
+    },
+    {
+      "role": "curated_human",
+      "description": "Reviewed human-readable projection used as a review surface.",
+      "canonical_write_allowed": false
+    },
+    {
+      "role": "workflow",
+      "description": "Process, launch, recovery or coordination record.",
+      "canonical_write_allowed": false
+    },
+    {
+      "role": "local_scratch",
+      "description": "Ignored local intake or temporary workspace.",
+      "canonical_write_allowed": false
+    }
+  ],
+  "promotion_rule": "New facts from generated, human, workflow or evidence layers require an explicit proposal before becoming canonical.",
+  "rejected_promotion_targets": ["direct generated output edit", "hidden legacy note", "unreviewed implementation repository change"],
+  "evidence_refs": ["evidence.synthetic_source_brief"],
+  "limitations": ["Synthetic boundary contract does not define a real repository layout."]
+}

package/examples/technology-quality-feedback-minimal/README.md

@@ -0,0 +1,33 @@
+# Technology Quality Feedback Minimal Example
+
+Status: synthetic public example
+
+## Purpose
+
+This example demonstrates a technology quality feedback report as a gate that
+checks whether work followed the declared process before acceptance or release.
+
+It models:
+
+```text
+technology contract
+-> launch record
+-> work evidence
+-> feedback report
+-> classified findings
+-> transition decision
+-> Kaizen route
+```
+
+Passing tests and complete evidence do not equal accepted work. The feedback
+report supports the next transition, but it does not approve release or update
+canonical state.
+
+## Validation
+
+Run:
+
+```bash
+npm run validate:technology-quality-feedback
+npm run test:technology-quality-feedback-negative
+```

package/examples/technology-quality-feedback-minimal/graph/objects.json

@@ -0,0 +1,56 @@
+[
+  {
+    "id": "evidence.synthetic_quality_feedback_brief",
+    "kind": "evidence",
+    "title": "Synthetic Quality Feedback Brief",
+    "summary": "Public-safe evidence describing a synthetic technology quality feedback gate.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "technology.synthetic_control_loop",
+    "kind": "technology_contract",
+    "title": "Synthetic Control Loop Technology",
+    "summary": "Technology contract requiring launch review, bounded work, evidence, semantic review and classified feedback before acceptance.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_quality_feedback_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "launch_record.synthetic_quality_batch",
+    "kind": "launch_record",
+    "title": "Synthetic Quality Batch Launch Record",
+    "summary": "Launch record bounding a synthetic work batch and its evidence requirements.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_quality_feedback_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "feedback.synthetic_work_batch",
+    "kind": "technology_quality_feedback",
+    "title": "Synthetic Work Batch Technology Feedback",
+    "summary": "Feedback report checking conformance to the declared technology and routing a non-blocking process improvement to Kaizen.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_quality_feedback_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "finding.synthetic_process_improvement",
+    "kind": "quality_finding",
+    "title": "Synthetic Process Improvement Finding",
+    "summary": "Non-blocking finding that improves future validator wording and routes to Kaizen.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_quality_feedback_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "kaizen.synthetic_validator_recipe",
+    "kind": "kaizen_item",
+    "title": "Synthetic Validator Recipe Improvement",
+    "summary": "Kaizen item for improving the reusable validator recipe after the completed cycle.",
+    "readiness": "draft",
+    "evidence": ["evidence.synthetic_quality_feedback_brief"],
+    "profile": "implementation_control"
+  }
+]