mirai-graph 1.3.0 → 2.1.0

package/examples/goal-vector-quality-control-minimal/results/goal-vector-quality-control.json

@@ -1,130 +0,0 @@
-{
-  "schema_version": "1.0.0",
-  "id": "goal_vector_quality_control.synthetic_reviewable_onboarding",
-  "profile": "implementation_control",
-  "public_safety": "synthetic_public",
-  "start_state": {
-    "id": "state.synthetic_no_starter_package",
-    "summary": "The project has no reviewed starter graph package or validation evidence."
-  },
-  "final_outcome": {
-    "id": "outcome.synthetic_reviewable_onboarding",
-    "summary": "The project has a reviewable starter graph package with validation evidence and reverse audit."
-  },
-  "work_scale": "goal",
-  "goal_vector": {
-    "id": "goal_vector.synthetic_onboarding",
-    "from": "state.synthetic_no_starter_package",
-    "to": "outcome.synthetic_reviewable_onboarding",
-    "summary": "Move from missing starter package to reviewable package with evidence and reverse audit."
-  },
-  "vector_segments": [
-    {
-      "id": "segment.synthetic_package_created",
-      "from": "state.synthetic_no_starter_package",
-      "to": "state.synthetic_package_review_ready",
-      "advances": "outcome.synthetic_reviewable_onboarding",
-      "evidence_refs": [
-        "evidence.synthetic_package_files",
-        "evidence.synthetic_validation_report"
-      ]
-    }
-  ],
-  "batch_vector_links": [
-    {
-      "batch_ref": "batch.synthetic_prepare_starter_package",
-      "advances": "goal_vector.synthetic_onboarding",
-      "specific_contribution": "Creates the starter package and evidence needed for review.",
-      "evidence_refs": [
-        "evidence.synthetic_package_files",
-        "evidence.synthetic_validation_report"
-      ]
-    }
-  ],
-  "required_qualities": [
-    {
-      "id": "quality.reviewable_package_exists",
-      "summary": "A reviewer can inspect package contents and validation result.",
-      "evidence_required": [
-        "evidence.synthetic_package_files",
-        "evidence.synthetic_validation_report"
-      ]
-    },
-    {
-      "id": "quality.no_false_completion_claim",
-      "summary": "The final answer does not claim completion beyond the evidence.",
-      "evidence_required": [
-        "evidence.synthetic_reverse_audit"
-      ]
-    }
-  ],
-  "quality_evidence": [
-    {
-      "id": "evidence.synthetic_package_files",
-      "supports_quality": "quality.reviewable_package_exists",
-      "summary": "Synthetic package files exist for review."
-    },
-    {
-      "id": "evidence.synthetic_validation_report",
-      "supports_quality": "quality.reviewable_package_exists",
-      "summary": "Synthetic validation result supports review readiness."
-    },
-    {
-      "id": "evidence.synthetic_reverse_audit",
-      "supports_quality": "quality.no_false_completion_claim",
-      "summary": "Reverse audit checks the final outcome against evidence."
-    }
-  ],
-  "reverse_audit": {
-    "performed": true,
-    "from_final_outcome": "outcome.synthetic_reviewable_onboarding",
-    "checked_qualities": [
-      "quality.reviewable_package_exists",
-      "quality.no_false_completion_claim"
-    ],
-    "evidence_refs": [
-      "evidence.synthetic_package_files",
-      "evidence.synthetic_validation_report",
-      "evidence.synthetic_reverse_audit"
-    ],
-    "verdict": "PASS_WITH_NOTES"
-  },
-  "drift_findings": [
-    {
-      "id": "finding.synthetic_followup_docs",
-      "classification": "process_improvement",
-      "severity": "low",
-      "summary": "Future examples should add a shorter reviewer checklist.",
-      "blocking": false,
-      "evidence_refs": [
-        "evidence.synthetic_reverse_audit"
-      ]
-    }
-  ],
-  "correction_routes": [
-    {
-      "finding_ref": "finding.synthetic_followup_docs",
-      "route": "kaizen_improvement",
-      "owner_role": "process_coordinator"
-    }
-  ],
-  "quality_verdict": "PASS_WITH_NOTES",
-  "completion_claim": {
-    "claimed_complete": true,
-    "claim_ref": "claim.synthetic_goal_review_ready",
-    "evidence_refs": [
-      "evidence.synthetic_validation_report",
-      "evidence.synthetic_reverse_audit"
-    ],
-    "accepted": false
-  },
-  "canonical_write_allowed": false,
-  "limitations": [
-    "Goal vector quality control is not authorization.",
-    "Reverse audit is not approval or release permission.",
-    "Evidence does not equal acceptance.",
-    "Tests do not equal semantic acceptance.",
-    "This synthetic example does not prove production readiness.",
-    "The report does not update canonical graph state."
-  ]
-}

package/examples/graph-dna-alignment-minimal/README.md

@@ -1,16 +0,0 @@
-# Graph DNA Alignment Minimal Example
-
-Status: synthetic public example
-
-## Purpose
-
-This example shows how a component DNA can align with parent graph DNA without
-publishing any private project details.
-
-## Validation
-
-Run:
-
-```bash
-npm run validate:dna-alignment
-```

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

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

@@ -1,20 +0,0 @@
-[
-  {
-    "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/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.graph_dna_alignment_minimal",
-  "aliases": [],
-  "title": "Graph DNA Alignment 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",
-  "description": "Synthetic package showing parent/component DNA alignment.",
-  "license": "CC-BY-4.0",
-  "public_safety": "synthetic_public"
-}

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

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

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

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

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

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

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

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