mirai-graph 1.0.0-rc.1

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

@@ -0,0 +1,38 @@
+[
+  {
+    "id": "evidence.synthetic_dna_brief",
+    "kind": "evidence",
+    "title": "Synthetic DNA Brief",
+    "summary": "Public-safe brief for a parent/component DNA alignment example.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "dna.parent_document_system",
+    "kind": "graph_dna",
+    "title": "Document System DNA",
+    "summary": "Synthetic parent DNA for a governed document system.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_dna_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "dna.component_review_queue",
+    "kind": "component_dna",
+    "title": "Review Queue Component DNA",
+    "summary": "Synthetic component DNA for review queue responsibility.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_dna_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "alignment.review_queue",
+    "kind": "dna_alignment",
+    "title": "Review Queue DNA Alignment",
+    "summary": "Alignment record showing component scope, exclusions, invariants and success criteria.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_dna_brief"],
+    "profile": "implementation_control"
+  }
+]

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

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "relation.dna.component_review_queue.aligns_with.dna.parent_document_system",
+    "type": "aligns_with",
+    "source": "dna.component_review_queue",
+    "target": "dna.parent_document_system",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_dna_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.alignment.review_queue.evidences.dna.component_review_queue",
+    "type": "evidences",
+    "source": "alignment.review_queue",
+    "target": "dna.component_review_queue",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_dna_brief"],
+    "profile": "implementation_control"
+  }
+]

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

@@ -0,0 +1,14 @@
+{
+  "id": "package.graph_dna_alignment_minimal",
+  "name": "Graph DNA Alignment Minimal",
+  "version": "0.1.0",
+  "profile": "implementation_control",
+  "conformance_level": "level_1",
+  "description": "Synthetic package showing parent/component DNA alignment.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}

package/examples/graph-dna-alignment-minimal/results/graph-dna-alignment.json

@@ -0,0 +1,32 @@
+{
+  "schema_version": "0.1.0",
+  "id": "graph_dna_alignment.synthetic_review_queue",
+  "profile": "implementation_control",
+  "public_safety": "synthetic_public",
+  "parent_dna": {
+    "id": "dna.parent_document_system",
+    "mission": "Coordinate document work with traceable review and approval.",
+    "evolution_vector": "Grow from simple review queues to governed document operations.",
+    "non_negotiable_principles": [
+      "review before publication",
+      "evidence before approval"
+    ]
+  },
+  "component_dna": {
+    "id": "dna.component_review_queue",
+    "mission": "Own review queue state and reviewer assignment.",
+    "owns": ["review queue state", "reviewer assignment"],
+    "must_not_own": ["publication approval", "canonical policy changes"],
+    "invariants": ["every queued item has a source evidence ref"],
+    "success_criteria": ["review items move only through approved states"],
+    "anti_patterns": ["component approves its own publication output"]
+  },
+  "alignment": {
+    "verdict": "aligned_with_notes",
+    "aligned_principles": ["review before publication", "evidence before approval"],
+    "gaps": [],
+    "proposal_required": false
+  },
+  "evidence_refs": ["evidence.synthetic_dna_brief"],
+  "limitations": ["Synthetic alignment validates shape, not real product fitness."]
+}

package/examples/graph-seed-minimal/README.md

@@ -0,0 +1,9 @@
+# Minimal Graph Seed Example
+
+This example shows a minimal Mirai Graph seed.
+
+Validate it from the repository root:
+
+```bash
+node packages/cli/validate-mirai-graph.js seed examples/graph-seed-minimal/graph-seed.json
+```

package/examples/graph-seed-minimal/graph-embryo.json

@@ -0,0 +1,63 @@
+{
+  "schema_version": "0.1.0",
+  "embryo_id": "embryo.demo_project",
+  "seed_id": "seed.demo_project",
+  "generated_at": "2026-05-28T16:33:40.453Z",
+  "candidate_objects": [
+    {
+      "id": "goal.candidate_1",
+      "kind": "goal",
+      "title": "Candidate Goal",
+      "summary": "Candidate goal object proposed from seed seed.demo_project.",
+      "readiness": "draft",
+      "evidence": [],
+      "profile": "project_management"
+    },
+    {
+      "id": "task.candidate_2",
+      "kind": "task",
+      "title": "Candidate Task",
+      "summary": "Candidate task object proposed from seed seed.demo_project.",
+      "readiness": "draft",
+      "evidence": [],
+      "profile": "project_management"
+    },
+    {
+      "id": "decision.candidate_3",
+      "kind": "decision",
+      "title": "Candidate Decision",
+      "summary": "Candidate decision object proposed from seed seed.demo_project.",
+      "readiness": "draft",
+      "evidence": [],
+      "profile": "project_management"
+    },
+    {
+      "id": "risk.candidate_4",
+      "kind": "risk",
+      "title": "Candidate Risk",
+      "summary": "Candidate risk object proposed from seed seed.demo_project.",
+      "readiness": "draft",
+      "evidence": [],
+      "profile": "project_management"
+    },
+    {
+      "id": "evidence.candidate_5",
+      "kind": "evidence",
+      "title": "Candidate Evidence",
+      "summary": "Candidate evidence object proposed from seed seed.demo_project.",
+      "readiness": "draft",
+      "evidence": [],
+      "profile": "project_management"
+    }
+  ],
+  "candidate_relations": [],
+  "uncertain_items": [
+    "This is a deterministic seed preview, not extracted canonical graph state."
+  ],
+  "review_questions": [
+    "Do the candidate object families match the graph purpose?",
+    "Are source boundaries sufficient for the first extraction pass?",
+    "Should canonical write remain blocked until human review?"
+  ],
+  "stop_conditions_triggered": []
+}

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

@@ -0,0 +1,60 @@
+{
+  "schema_version": "0.1.0",
+  "seed_id": "seed.demo_project",
+  "target_graph_id": "graph.demo_project",
+  "purpose": "Create a small graph for managing project growth.",
+  "target_profile": "profile.project_management",
+  "target_mode": "discovery",
+  "graph_dna": {
+    "purpose": "Keep project goals, decisions, risks and next actions connected.",
+    "evolution_vector": "Grow from a small project map into reviewed canonical project state.",
+    "non_negotiable_principles": [
+      "Generated candidates do not become canonical without review.",
+      "Private source material must not be published."
+    ]
+  },
+  "source_boundaries": {
+    "allowed_sources": [
+      "public_project_brief.md",
+      "synthetic_notes.md"
+    ],
+    "excluded_sources": [
+      "private_chats",
+      "secrets",
+      "customer_data"
+    ],
+    "canonical_write_allowed": false
+  },
+  "growth_rules": {
+    "allowed_object_families": [
+      "goal",
+      "task",
+      "decision",
+      "risk",
+      "evidence"
+    ],
+    "allowed_relation_families": [
+      "depends_on",
+      "blocks",
+      "supports",
+      "evidences"
+    ],
+    "max_initial_objects": 10,
+    "depth_mode": "light"
+  },
+  "review_gates": [
+    "human_review_before_canonical_write",
+    "validate_before_generated_context"
+  ],
+  "generated_views": [
+    "seed_summary",
+    "candidate_object_list",
+    "candidate_relation_list",
+    "growth_gap_report"
+  ],
+  "stop_conditions": [
+    "source_boundary_unclear",
+    "candidate_count_exceeds_budget",
+    "canonical_write_requested_before_review"
+  ]
+}

package/examples/implementation-control-cycles/README.md

@@ -0,0 +1,47 @@
+# Implementation Control Cycles Example
+
+Status: synthetic public example
+
+## Purpose
+
+This example demonstrates reusable implementation-control cycles for governed
+project movement.
+
+It models:
+
+```text
+human projection feedback
+-> implementation planning
+-> bounded work batch
+-> review and evidence
+-> release or publish
+-> runtime feedback
+-> kaizen improvement
+-> next transition decision
+```
+
+It also models the public-safe continuous-improvement pattern:
+
+```text
+cycle completed
+-> transition decision
+-> kaizen review
+-> classified improvement
+-> blocking/non-blocking decision
+-> next governed cycle
+```
+
+The Kaizen cycle is separate from runtime feedback. Runtime feedback captures
+operational signals; Kaizen reviews the quality of completed work and the
+process that produced it.
+
+The example is synthetic. It does not contain private project data, internal
+paths, private policies, private transfer notes or runtime traces.
+
+## Validation
+
+Run:
+
+```bash
+npm run validate:implementation-control-cycles
+```

package/examples/implementation-control-cycles/gates/results.json

@@ -0,0 +1,22 @@
+[
+  {
+    "id": "gate_result.implementation_control_cycles.public_safety",
+    "gate_id": "gate.public_safety",
+    "target_id": "package.implementation_control_cycles",
+    "verdict": "pass",
+    "summary": "The cycle example uses synthetic public-safe material only.",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "reviewed_at": "2026-06-02",
+    "reviewer": "Mirai Graph maintainers"
+  },
+  {
+    "id": "gate_result.implementation_control_cycles.cycle_validation",
+    "gate_id": "gate.cycle_validation",
+    "target_id": "cycle.bounded_work_batch",
+    "verdict": "pass_with_notes",
+    "summary": "The cycle declares stages, gates, validators, evidence and promotion boundaries.",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "reviewed_at": "2026-06-02",
+    "reviewer": "Synthetic coordinator"
+  }
+]

package/examples/implementation-control-cycles/graph/objects.json

@@ -0,0 +1,119 @@
+[
+  {
+    "id": "evidence.synthetic_cycle_brief",
+    "kind": "evidence",
+    "title": "Synthetic Cycle Brief",
+    "summary": "Public-safe brief for reusable implementation-control cycles.",
+    "readiness": "accepted",
+    "evidence": [],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.human_projection_feedback",
+    "kind": "implementation_cycle",
+    "title": "Human Projection Feedback",
+    "summary": "Cycle for generating a human-readable projection and turning reviewed gaps into proposals.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.implementation_planning",
+    "kind": "implementation_cycle",
+    "title": "Implementation Planning",
+    "summary": "Cycle for converting reviewed scope into bounded implementation planning.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.bounded_work_batch",
+    "kind": "implementation_cycle",
+    "title": "Bounded Work Batch",
+    "summary": "Cycle for executing only work approved by a launch gate.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.review_and_evidence",
+    "kind": "implementation_cycle",
+    "title": "Review And Evidence",
+    "summary": "Cycle for verifying evidence, drift and proposal readiness before approval.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.release_or_publish",
+    "kind": "implementation_cycle",
+    "title": "Release Or Publish",
+    "summary": "Cycle for evaluating release or publication readiness with explicit gates.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.runtime_feedback",
+    "kind": "implementation_cycle",
+    "title": "Runtime Feedback",
+    "summary": "Cycle for converting operational feedback into reviewable improvements or proposals.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "cycle.kaizen_improvement",
+    "kind": "implementation_cycle",
+    "title": "Kaizen Improvement",
+    "summary": "Meta-cycle for classifying completed-cycle lessons, regressions and improvement opportunities before the next governed transition.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "gate.public_safety",
+    "kind": "approval_gate",
+    "title": "Public Safety Gate",
+    "summary": "Gate confirming the cycle example is synthetic and public-safe.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "gate.cycle_validation",
+    "kind": "approval_gate",
+    "title": "Cycle Validation Gate",
+    "summary": "Gate confirming cycles declare stages, gates, validators, evidence and promotion paths.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "validator.cycle_shape",
+    "kind": "validator",
+    "title": "Cycle Shape Validator",
+    "summary": "Validator that checks required public cycle structure and boundary language.",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "risk.implicit_authorization",
+    "kind": "risk",
+    "title": "Implicit Authorization",
+    "summary": "Risk that readiness, evidence or feedback is mistaken for permission to update state.",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "kaizen.cycle_boundaries",
+    "kind": "kaizen_item",
+    "title": "Cycle Boundary Language",
+    "summary": "Improvement item to keep cycle docs explicit about proposal, approval and controlled update boundaries.",
+    "readiness": "draft",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  }
+]

package/examples/implementation-control-cycles/graph/relations.json

@@ -0,0 +1,200 @@
+[
+  {
+    "id": "relation.evidence.synthetic_cycle_brief.evidences.cycle.human_projection_feedback",
+    "type": "evidences",
+    "source": "evidence.synthetic_cycle_brief",
+    "target": "cycle.human_projection_feedback",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.human_projection_feedback.progresses_to.cycle.implementation_planning",
+    "type": "progresses_to",
+    "source": "cycle.human_projection_feedback",
+    "target": "cycle.implementation_planning",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.implementation_planning.progresses_to.cycle.bounded_work_batch",
+    "type": "progresses_to",
+    "source": "cycle.implementation_planning",
+    "target": "cycle.bounded_work_batch",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.bounded_work_batch.progresses_to.cycle.review_and_evidence",
+    "type": "progresses_to",
+    "source": "cycle.bounded_work_batch",
+    "target": "cycle.review_and_evidence",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.review_and_evidence.progresses_to.cycle.release_or_publish",
+    "type": "progresses_to",
+    "source": "cycle.review_and_evidence",
+    "target": "cycle.release_or_publish",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.release_or_publish.progresses_to.cycle.runtime_feedback",
+    "type": "progresses_to",
+    "source": "cycle.release_or_publish",
+    "target": "cycle.runtime_feedback",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.human_projection_feedback.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.human_projection_feedback",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.implementation_planning.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.implementation_planning",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.bounded_work_batch.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.bounded_work_batch",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.review_and_evidence.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.review_and_evidence",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.release_or_publish.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.release_or_publish",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.runtime_feedback.transitions_to.cycle.kaizen_improvement",
+    "type": "transitions_to",
+    "source": "cycle.runtime_feedback",
+    "target": "cycle.kaizen_improvement",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.kaizen_improvement.transitions_to.cycle.human_projection_feedback",
+    "type": "transitions_to",
+    "source": "cycle.kaizen_improvement",
+    "target": "cycle.human_projection_feedback",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.kaizen_improvement.transitions_to.cycle.implementation_planning",
+    "type": "transitions_to",
+    "source": "cycle.kaizen_improvement",
+    "target": "cycle.implementation_planning",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.kaizen_improvement.transitions_to.cycle.bounded_work_batch",
+    "type": "transitions_to",
+    "source": "cycle.kaizen_improvement",
+    "target": "cycle.bounded_work_batch",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.kaizen_improvement.transitions_to.cycle.runtime_feedback",
+    "type": "transitions_to",
+    "source": "cycle.kaizen_improvement",
+    "target": "cycle.runtime_feedback",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.cycle.bounded_work_batch.requires_gate.gate.cycle_validation",
+    "type": "requires_gate",
+    "source": "cycle.bounded_work_batch",
+    "target": "gate.cycle_validation",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.gate.cycle_validation.validates_cycle.cycle.bounded_work_batch",
+    "type": "validates_cycle",
+    "source": "gate.cycle_validation",
+    "target": "cycle.bounded_work_batch",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.validator.cycle_shape.validates_cycle.cycle.human_projection_feedback",
+    "type": "validates_cycle",
+    "source": "validator.cycle_shape",
+    "target": "cycle.human_projection_feedback",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.gate.public_safety.requires_review.evidence.synthetic_cycle_brief",
+    "type": "requires_review",
+    "source": "gate.public_safety",
+    "target": "evidence.synthetic_cycle_brief",
+    "readiness": "accepted",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.risk.implicit_authorization.blocks.cycle.runtime_feedback",
+    "type": "blocks",
+    "source": "risk.implicit_authorization",
+    "target": "cycle.runtime_feedback",
+    "readiness": "review_ready",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  },
+  {
+    "id": "relation.kaizen.cycle_boundaries.improves_process.cycle.review_and_evidence",
+    "type": "improves_process",
+    "source": "kaizen.cycle_boundaries",
+    "target": "cycle.review_and_evidence",
+    "readiness": "draft",
+    "evidence": ["evidence.synthetic_cycle_brief"],
+    "profile": "implementation_control"
+  }
+]

package/examples/implementation-control-cycles/mirai-graph-package.json

@@ -0,0 +1,14 @@
+{
+  "id": "package.implementation_control_cycles",
+  "name": "Implementation Control Cycles Example",
+  "version": "0.1.0",
+  "profile": "implementation_control",
+  "conformance_level": "level_1",
+  "description": "A synthetic Mirai Graph package showing reusable governed implementation-control cycles.",
+  "license": "CC-BY-4.0",
+  "public_safety": "synthetic_public",
+  "graph": {
+    "objects": "graph/objects.json",
+    "relations": "graph/relations.json"
+  }
+}